@soat/cli 0.41.0 → 0.42.0

package/dist/index.mjs

@@ -13,7 +13,7 @@ import * as os from "node:os";
 import { createHmac, timingSafeEqual } from "node:crypto";
 
 //#region package.json
-var version = "0.41.0";
+var version = "0.42.0";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -5770,6 +5770,28 @@ var routes = {
       "in": "path"
     }]
   },
+  "pause-orchestration-run": {
+    serviceClass: "Orchestrations",
+    operationId: "pauseOrchestrationRun",
+    description: "Parks a run in flight as `awaiting_input` at its next checkpoint, with a `required_action` of type `paused` naming the pause as operator-initiated rather than a node's. Unlike cancel, the run keeps its last checkpoint and resume-orchestration-run re-drives it from there — so work already done is deferred rather than discarded. A `queued` or `sleeping` run is parked immediately (a sleeping run keeps the wake it was due, and resuming hands it back to the scheduler at that instant). A `running` run keeps running until the round in flight reaches its checkpoint, so the response may still read `running` while `pause_requested_at` is set. A run already parked on a human, webhook or approval node keeps that node's `required_action`; the pause is still recorded, which is what makes submit-human-input refuse until the run is resumed. The pause fans out to the run's `loop` / `sub_orchestration` descendants — each parks at its own next checkpoint — because otherwise a parent's pause would bound nothing. Resuming does not fan out: each parked descendant is resumed by its own id. Idempotent: pausing an already-paused run answers with it unchanged.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "post",
+    pathParams: ["orchestration_run_id"],
+    queryParams: [],
+    flags: [{
+      "name": "orchestration_run_id",
+      "description": "Public ID of the run (run_...)",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "reason",
+      "description": "Why the run is being paused, surfaced on the parked run's `required_action.reason` and on `pause_reason`.",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }]
+  },
   "submit-human-input": {
     serviceClass: "Orchestrations",
     operationId: "submitHumanInput",
@@ -5801,7 +5823,7 @@ var routes = {
   "resume-orchestration-run": {
     serviceClass: "Orchestrations",
     operationId: "resumeOrchestrationRun",
-    description: "Re-drives an awaiting_input orchestration run from its last checkpoint. This does not satisfy the pause itself — it carries no node_id or payload, so a run parked on a human or webhook-receive node re-parks on the same node. Use submit-human-input to supply the awaited payload and advance the run.",
+    description: "Re-drives an awaiting_input orchestration run from its last checkpoint. This does not satisfy the pause itself — it carries no node_id or payload, so a run parked on a human or webhook-receive node re-parks on the same node. Use submit-human-input to supply the awaited payload and advance the run. It is also the only thing that lifts an operator pause (pause-orchestration-run): a run parked with `required_action.type` of `paused` re-drives the frontier that had not run yet, and one paused mid-timer goes back to `sleeping` for the wake it was already due.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
     httpMethod: "post",
     pathParams: ["orchestration_run_id"],
@@ -7014,6 +7036,44 @@ var routes = {
       "in": "body"
     }]
   },
+  "pause-task": {
+    serviceClass: "Tasks",
+    operationId: "pauseTask",
+    description: "Pauses a task's automation. While a pause is in force no state's `on_enter` dispatches and no retry chain continues — an agent generation, a tool call and a sub-orchestration alike — so the task stops spending without losing its place. A workflow has no run object, so this is the workflow half of pause-orchestration-run: the pause lands on the instance, which is the task. Transitions are deliberately still allowed — a move costs nothing while every dispatch it would start is suppressed — so a board stays usable under a pause. Entering a state whose dispatch is suppressed records `automation_status: paused`, which resume-task reads to know that state still owes its work. A dispatch already in flight is left to finish, and its outcome still routes; only what would start after it is suppressed. Idempotent: pausing an already-paused task answers with it unchanged.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tasks",
+    httpMethod: "post",
+    pathParams: ["task_id"],
+    queryParams: [],
+    flags: [{
+      "name": "task_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "reason",
+      "description": "Why the task is being paused, surfaced on `pause_reason`.",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }]
+  },
+  "resume-task": {
+    serviceClass: "Tasks",
+    operationId: "resumeTask",
+    description: "Lifts a task's pause. When the pause suppressed the current state's `on_enter` — `automation_status: paused` — that dispatch is started now, as the caller resuming rather than as whoever last moved the task. A state whose dispatch had already completed, or that declares none, is left alone, so a resume never re-spends work the pause did not stop. This is the only way a pause is lifted; a task that is merely idle is advanced by firing a transition instead.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tasks",
+    httpMethod: "post",
+    pathParams: ["task_id"],
+    queryParams: [],
+    flags: [{
+      "name": "task_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
   "get-task-history": {
     serviceClass: "Tasks",
     operationId: "getTaskHistory",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "description": "CLI for SOAT — open-source infrastructure for production-ready AI agents.",
   "keywords": [
     "ai-agents",
@@ -22,7 +22,7 @@
   "dependencies": {
     "@inquirer/input": "^5.1.2",
     "@inquirer/password": "^5.1.1",
-    "@soat/sdk": "0.41.0",
+    "@soat/sdk": "0.42.0",
     "@ttoss/logger": "^0.8.19",
     "commander": "^15.0.0",
     "js-yaml": "^5.2.1"