sdk: readable clients (no Empty wrapper, no unused error module), documented examples with tests

sdk/tests/plugins/consumer/imports/probe.json

@@ -33,10 +33,6 @@
           "text"
         ],
         "type": "object"
-      },
-      "Empty": {
-        "description": "Empty parameters for methods without arguments.",
-        "type": "object"
       }
     }
   },
@@ -56,10 +52,61 @@
           "type": "null"
         }
       },
-      "summary": "Publish a control endpoint until EOF.",
-      "x-sausage-params": {
-        "$ref": "#/components/schemas/Empty"
-      }
+      "summary": "Publish a control endpoint until EOF."
+    },
+    {
+      "description": "Forward detached progress through the real core.",
+      "name": "relay",
+      "paramStructure": "by-name",
+      "params": [],
+      "result": {
+        "name": "result",
+        "schema": {
+          "format": "int32",
+          "type": "integer"
+        }
+      },
+      "summary": "Forward detached progress through the real core."
+    },
+    {
+      "description": "Send progress before the final result.",
+      "name": "progress",
+      "paramStructure": "by-name",
+      "params": [],
+      "result": {
+        "name": "result",
+        "schema": {
+          "format": "int32",
+          "type": "integer"
+        }
+      },
+      "summary": "Send progress before the final result."
+    },
+    {
+      "description": "Start a detached service that survives this caller.",
+      "name": "launch",
+      "paramStructure": "by-name",
+      "params": [],
+      "result": {
+        "name": "result",
+        "schema": {
+          "type": "string"
+        }
+      },
+      "summary": "Start a detached service that survives this caller."
+    },
+    {
+      "description": "Keep the process alive until the core closes stdin.",
+      "name": "service",
+      "paramStructure": "by-name",
+      "params": [],
+      "result": {
+        "name": "result",
+        "schema": {
+          "type": "string"
+        }
+      },
+      "summary": "Keep the process alive until the core closes stdin."
     },
     {
       "description": "Add two numbers.\n\nThe result is their sum.",
@@ -136,10 +183,7 @@
           "type": "string"
         }
       },
-      "summary": "Return an internal serialization error.",
-      "x-sausage-params": {
-        "$ref": "#/components/schemas/Empty"
-      }
+      "summary": "Return an internal serialization error."
     },
     {
       "description": "Return a deliberate error.",
@@ -152,10 +196,7 @@
           "type": "string"
         }
       },
-      "summary": "Return a deliberate error.",
-      "x-sausage-params": {
-        "$ref": "#/components/schemas/Empty"
-      }
+      "summary": "Return a deliberate error."
     },
     {
       "description": "Exercise calls, notifications, and advisory locks.",
@@ -168,10 +209,7 @@
           "type": "string"
         }
       },
-      "summary": "Exercise calls, notifications, and advisory locks.",
-      "x-sausage-params": {
-        "$ref": "#/components/schemas/Empty"
-      }
+      "summary": "Exercise calls, notifications, and advisory locks."
     },
     {
       "description": "Drop an acquisition before the core grants its lock.",
@@ -184,10 +222,7 @@
           "type": "string"
         }
       },
-      "summary": "Drop an acquisition before the core grants its lock.",
-      "x-sausage-params": {
-        "$ref": "#/components/schemas/Empty"
-      }
+      "summary": "Drop an acquisition before the core grants its lock."
     },
     {
       "description": "Wait until EOF, then run the stop hook.",
@@ -200,10 +235,7 @@
           "type": "string"
         }
       },
-      "summary": "Wait until EOF, then run the stop hook.",
-      "x-sausage-params": {
-        "$ref": "#/components/schemas/Empty"
-      }
+      "summary": "Wait until EOF, then run the stop hook."
     },
     {
       "description": "Keep the process alive with a background call.",
@@ -216,10 +248,7 @@
           "type": "string"
         }
       },
-      "summary": "Keep the process alive with a background call.",
-      "x-sausage-params": {
-        "$ref": "#/components/schemas/Empty"
-      }
+      "summary": "Keep the process alive with a background call."
     }
   ],
   "openrpc": "1.2.6",
@@ -239,10 +268,7 @@
               "type": "integer"
             }
           },
-          "summary": "Report progress and return a stable counter.",
-          "x-sausage-params": {
-            "$ref": "#/components/schemas/Empty"
-          }
+          "summary": "Report progress and return a stable counter."
         },
         {
           "description": "End the endpoint process after the response.",
@@ -255,10 +281,7 @@
               "type": "null"
             }
           },
-          "summary": "End the endpoint process after the response.",
-          "x-sausage-params": {
-            "$ref": "#/components/schemas/Empty"
-          }
+          "summary": "End the endpoint process after the response."
         }
       ]
     }