@celigo/api-specs 0.2.139 → 0.2.140

package/dist/tool.yml

@@ -1224,8 +1224,9 @@ paths:
           $ref: '#/components/responses/404-not-found'
         '422':
           description: |-
-            The Tool ran but a step failed. Includes `invocationId` when logging is active, so
-            the failed run can be opened in the run history.
+            A step failed, or the Tool was refused before any step ran because its branches
+            don't all merge back (`tool_dangling_branch`). Either way the response includes
+            `invocationId` when logging is active, so the run can be opened in the run history.
           content:
             application/json:
               schema:
@@ -2398,6 +2399,11 @@ paths:
         `GET /v1/tools/{_id}/test/run/{runId}/{_stepId}` to inspect stage-by-stage
         results. The run id for follow-up calls is the `flowJob._id` value.
 
+        A test run is not free of outside calls: lookups call their sources live. Imports never
+        send; each returns its saved `mockResponse`, or a placeholder response when none is saved
+        (see `mockResponse` on imports). A second test run started while one is still running is
+        refused with `test_run_not_allowed`.
+
         Test runs are a separate, short-lived history from normal runs — capture
         any follow-up step or log details soon after the run completes.
       operationId: testRunTool
@@ -2520,7 +2526,14 @@ paths:
                         status: completed
                         numError: 1
         '400':
-          $ref: '#/components/responses/400-bad-request'
+          description: |-
+            The run was refused before any step ran. A Tool with no steps fails with
+            `tool_empty_router`, and one whose branches don't all merge back with
+            `tool_dangling_branch`; re-running the same document fails the same way.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
         '401':
           $ref: '#/components/responses/401-unauthorized'
         '404':
@@ -19863,7 +19876,7 @@ components:
           without the array); a mapping reshapes the message instead.
         - |-
           Publishing is not limited to flows. Verified surfaces: a flow step; an API step (the API
-          invoked at `POST /apis/{version}/{relativeURI}`); a Tool reached through a `ToolImport`
+          invoked at `POST /apis/{version}{relativeURI}`); a Tool reached through a `ToolImport`
           step in a flow; and `POST /v1/imports/{_id}/invoke` with `{"data": [record, ...]}`. A flow
           or API test run (`/test/run`) publishes nothing — import steps are mocked there.
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.139",
+  "version": "0.2.140",
   "private": false,
   "description": "Public OpenAPI bundles (dist/) and the celigo-cli lint schema pack (schemas.json).",
   "keywords": [