Improve few ingress errors

crates/ingress-http/src/handler/error.rs

@@ -22,9 +22,9 @@ use std::string;
 pub(crate) enum HandlerError {
     #[error("not found")]
     NotFound,
-    #[error("service '{0}' not found")]
+    #[error("service '{0}' not found, make sure to register the service before calling it.")]
     ServiceNotFound(String),
-    #[error("service '{0}' handler '{1}' not found")]
+    #[error("the service '{0}' exists, but the handler '{1}' was not found, check that the handler exists in the latest registered service version.")]
     ServiceHandlerNotFound(String, String),
     #[error("invocation not found")]
     InvocationNotFound,

crates/ingress-http/src/handler/invocation.rs

@@ -100,7 +100,7 @@ where
             .await?
         {
             AttachInvocationResponse::NotFound => {
-                return Err(HandlerError::NotFound);
+                return Err(HandlerError::InvocationNotFound);
             }
             AttachInvocationResponse::NotSupported => {
                 return Err(HandlerError::NotImplemented);

crates/ingress-http/src/handler/workflow.rs

@@ -75,7 +75,7 @@ where
             .await?
         {
             AttachInvocationResponse::NotFound => {
-                return Err(HandlerError::NotFound);
+                return Err(HandlerError::InvocationNotFound);
             }
             AttachInvocationResponse::NotSupported => {
                 return Err(HandlerError::NotImplemented);

crates/types/src/schema/openapi.rs

@@ -683,9 +683,9 @@ fn error_response_json_schema() -> Value {
                 "type": "string",
                 "title": "Error message"
             },
-            "description": {
+            "stacktrace": {
                 "type": "string",
-                "title": "Verbose error description"
+                "title": "Stacktrace of the error"
             }
         },
         "required": ["message"],