sim 2.1.4-preview.61.1 → 2.1.4-preview.68.1

package/dist/index.js

@@ -8263,6 +8263,37 @@ var V2_OPERATIONS = {
       }
     }
   },
+  executeTool: {
+    method: "POST",
+    path: "/api/v2/tools/[toolId]/execute",
+    pathParams: ["toolId"],
+    pathParamDocs: {
+      toolId: "Tool identifier. An unversioned name resolves to the newest version, and the response echoes the resolved id."
+    },
+    responseMode: "json",
+    summary: "Run Tool",
+    personalKeyOnly: true,
+    body: {
+      workspaceId: {
+        kind: "string",
+        required: true,
+        describe: "Workspace whose integration allowlist, credentials, and environment variables govern this call."
+      },
+      input: {
+        kind: "object",
+        default: {},
+        describe: "Arguments for the tool, keyed by the parameter ids the tool catalog publishes for it. A parameter whose visibility is `user-only` also accepts an environment-variable reference written as the whole value, `{{VAR_NAME}}`, resolved server-side against the workspace environment; any other value is sent verbatim."
+      },
+      credentialId: {
+        kind: "string",
+        describe: "Credential to authenticate with. Required when the tool declares an OAuth requirement; the workspace credentials list names the candidates."
+      },
+      timeoutSeconds: {
+        kind: "integer",
+        describe: "How long to wait for the tool before abandoning the call."
+      }
+    }
+  },
   executeWorkflow: {
     method: "POST",
     path: "/api/v2/workflows/[workflowId]/execute",
@@ -8295,7 +8326,7 @@ var V2_OPERATIONS = {
       },
       selectedOutputs: {
         kind: "array",
-        describe: "Block output references to include in a streamed response, as `blockId`, `blockId.path`, or `BlockName.path` (resolved against the live workflow). Requires `stream: true` — it shapes the streamed envelope only, so it is rejected on a sync request and when `async` is true. To narrow a finished run, pass `selectedOutputs` to the run resource instead."
+        describe: "Block output references to include in a streamed response. Use `<blockName>.<outputPath>` for the executed workflow or `<childWorkflowId>.<blockName>.<outputPath>` for a child workflow; block names are normalized workflow reference names. Selecting a child workflow applies to every invocation of it. Requires `stream: true` — it shapes the streamed envelope only, so it is rejected on a sync request and when `async` is true. To narrow a finished run, pass `selectedOutputs` to the run resource instead."
       },
       includeThinking: {
         kind: "boolean",
@@ -8947,7 +8978,8 @@ var V2_OPERATIONS = {
           "knowledge-base",
           "voice-input",
           "enrichment",
-          "voice-output"
+          "voice-output",
+          "api-tool"
         ],
         describe: "Restrict results to one usage source."
       },
@@ -13025,6 +13057,24 @@ var CLI_CONTRACT = {
     describe: "Print a workflow as a portable JSON document",
     document: true
   },
+  executeTool: {
+    command: "tools execute",
+    describe: "Run one built-in tool and print what it produced",
+    flags: {
+      input: {
+        json: true,
+        describe: "Tool arguments as JSON, keyed by the parameter ids `sim tools get <toolId>` lists"
+      },
+      credentialId: { describe: "Credential to authenticate with, required for OAuth tools" },
+      timeoutSeconds: { name: "timeout", describe: "Seconds to wait before abandoning the call" }
+    },
+    fields: [
+      { path: "toolId", header: "Tool" },
+      { path: "status", header: "Status" },
+      { path: "output", header: "Output" },
+      { path: "error.message", header: "Error" }
+    ]
+  },
   executeWorkflow: {
     command: "workflows run",
     describe: "Run a deployed workflow or execute saved state manually",
@@ -13038,7 +13088,7 @@ var CLI_CONTRACT = {
       selectedOutputs: {
         name: "select-output",
         list: true,
-        describe: "Return blockName.field values from the streamed result (e.g. agent_1.content), requires --follow; missing fields are omitted"
+        describe: "Return streamed outputs as blockName.path or childWorkflowId.blockName.path; selecting a child workflow applies to every invocation, requires --follow"
       },
       stream: { omit: true },
       includeThinking: { omit: true },
@@ -13939,20 +13989,25 @@ function renderResult(operation, format, raw, spec, options = {}, envelope) {
 }
 
 // src/runtime/execute.ts
-var RUN_OUTCOME_OPERATIONS = new Set(["executeWorkflow"]);
-var FAILED_RUN_STATUS_MESSAGES = {
-  failed: "The workflow run failed.",
-  cancelled: "The workflow run was cancelled."
+var RUN_OUTCOME_OPERATIONS = {
+  executeWorkflow: {
+    failed: "The workflow run failed.",
+    cancelled: "The workflow run was cancelled."
+  },
+  executeTool: {
+    failed: "The tool call failed."
+  }
 };
 function runFailureMessage(operation, payload) {
-  if (!RUN_OUTCOME_OPERATIONS.has(operation))
+  const failureMessages = RUN_OUTCOME_OPERATIONS[operation];
+  if (!failureMessages)
     return null;
   if (!payload || typeof payload !== "object" || Array.isArray(payload))
     return null;
   const { status, error } = payload;
   if (typeof status !== "string")
     return null;
-  const fallback = FAILED_RUN_STATUS_MESSAGES[status];
+  const fallback = failureMessages[status];
   if (!fallback)
     return null;
   const reported2 = error?.message;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sim",
-  "version": "2.1.4-preview.61.1",
+  "version": "2.1.4-preview.68.1",
   "description": "Sim CLI - talk to the Sim API from your terminal",
   "type": "module",
   "bin": {