deepline 0.3.325 → 0.3.327

package/dist/cli/{chunk-H5TJBRSC.mjs → chunk-HOWQKN6J.mjs}

@@ -3,11 +3,14 @@ import {
   rateLimitSummary,
   schemaField,
   schemaFields
-} from "./chunk-76VKBPOC.mjs";
+} from "./chunk-JOA6IKDE.mjs";
+import {
+  shellQuote
+} from "./chunk-OVDNJAJN.mjs";
 import {
   recentSearchRef,
   registerDeprecatedSearchCommand
-} from "./chunk-OPERWJR6.mjs";
+} from "./chunk-D6GD5AVN.mjs";
 import {
   extractSummaryFields,
   projectRowOutput,
@@ -17,8 +20,9 @@ import {
   writeJsonOutputFile
 } from "./chunk-MIMASXO4.mjs";
 import {
-  DeeplineClient
-} from "./chunk-XIVUB36F.mjs";
+  DeeplineClient,
+  validateExecutionIdempotencyKey
+} from "./chunk-QZAP5VOS.mjs";
 import {
   beginToolExecuteCommand,
   getToolExecuteInvocationId,
@@ -26,18 +30,17 @@ import {
   runToolExecuteStage
 } from "./chunk-WXLOW623.mjs";
 import {
-  argsWantJson,
   printCommandEnvelope,
   printCompactJson,
   printJson,
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-AQUNQJ5Y.mjs";
+} from "./chunk-F45425TB.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-YE3O2UHM.mjs";
+} from "./chunk-CCRQ2VGJ.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -1010,7 +1013,7 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await import("./describe-26OMF3A4.mjs");
+      const { describeAnything } = await import("./describe-KJWOHMKC.mjs");
       process.exitCode = await describeAnything(
         toolId,
         { ...options, kinds: ["tools", "monitors"], fetchedTool: metadata },
@@ -1025,7 +1028,7 @@ Examples:
       { json: false }
     )
   );
-  tools.command("execute <toolId>").description("Execute a tool by id.").addHelpText(
+  tools.command("execute <toolId>").alias("call").description("Execute a tool by id.").addHelpText(
     "after",
     `
 Notes:
@@ -1084,22 +1087,7 @@ Examples:
     "--recovery-timeout-ms <milliseconds>",
     "Maximum wait for a keyed execution to finish (default: 900000)"
   ).action(async (toolId, options) => {
-    const args = [
-      toolId,
-      ...options.param.flatMap((value) => ["--param", value]),
-      ...options.json === true ? ["--json"] : [],
-      ...typeof options.json === "string" ? ["--json", options.json] : [],
-      ...options.input ? ["--input", options.input] : [],
-      ...options.payload ? ["--payload", options.payload] : [],
-      ...options.timeout ? ["--timeout", options.timeout] : [],
-      ...options.outputFormat ? ["--output-format", options.outputFormat] : [],
-      ...options.out ? ["--out", options.out] : [],
-      ...options.preview === false ? ["--no-preview"] : [],
-      ...options.idempotencyKey ? ["--idempotency-key", options.idempotencyKey] : [],
-      ...options.recover ? ["--recover"] : [],
-      ...options.recoveryTimeoutMs ? ["--recovery-timeout-ms", options.recoveryTimeoutMs] : []
-    ];
-    process.exitCode = await executeTool(args);
+    process.exitCode = await executeTool(toolId, options);
   });
 }
 async function getTool(toolId, options = {}, compatibilityMetadata) {
@@ -1808,6 +1796,7 @@ function printToolExamplesOnly(tool, requestedToolId) {
   console.log(`Use in a play:`);
   console.log("```ts");
   console.log("const result = await ctx.tools.execute({");
+  console.log("  staleAfterSeconds: 0,");
   console.log(`  id: '${stableStepIdForTool(toolId)}',`);
   console.log(`  tool: '${toolId}',`);
   console.log(
@@ -2545,87 +2534,63 @@ function parseJsonObjectArgument(raw, flagName) {
   }
   return parsed;
 }
-function parseExecuteOptions(args) {
-  const toolId = args[0];
+function toolExecuteJsonOption(value) {
+  const legacyInput = typeof value === "string" ? value : void 0;
+  return {
+    requested: value === true || legacyInput !== void 0,
+    legacyInput
+  };
+}
+function parseExecuteOptions(toolId, options, output) {
   if (!toolId) {
     throw new Error(
       `Usage: deepline tools execute <toolId> [--param key=value ...] [--input '{"k":"v"}'] [--timeout <duration>] [--recover | --idempotency-key <key>] [--recovery-timeout-ms <ms>] [--out rows.csv] [--output-format auto|csv|csv_file|json|json_file] [--no-preview]`
     );
   }
   const params = {};
-  let outputFormat = "auto";
-  let noPreview = false;
-  let outPath = null;
-  let timeoutMs;
-  let idempotencyKey;
-  let recover = false;
+  let outputFormat = output.requested ? "json" : "auto";
   let recoveryTimeoutMs;
-  for (let index = 1; index < args.length; index += 1) {
-    const arg = args[index];
-    if ((arg === "--param" || arg === "-p") && args[index + 1]) {
-      const kv = args[++index];
-      const eqIdx = kv.indexOf("=");
-      if (eqIdx > 0) params[kv.slice(0, eqIdx)] = kv.slice(eqIdx + 1);
-      continue;
-    }
-    if (arg === "--json") {
-      const next = args[index + 1];
-      outputFormat = "json";
-      if (next && !next.startsWith("--")) {
-        Object.assign(
-          params,
-          parseJsonObjectArgument(args[++index], "--json")
-        );
-      }
-      continue;
-    }
-    if ((arg === "--input" || arg === "--payload") && args[index + 1]) {
-      Object.assign(params, parseJsonObjectArgument(args[++index], arg));
-      continue;
-    }
-    if (arg === "--timeout" && args[index + 1]) {
-      timeoutMs = parseToolExecuteTimeout(args[++index]);
-      continue;
-    }
-    if (arg === "--output-format" && args[index + 1]) {
-      outputFormat = normalizeOutputFormat(args[++index]);
-      continue;
-    }
-    if (arg === "--no-preview") {
-      noPreview = true;
-      continue;
-    }
-    if (arg === "--idempotency-key" && args[index + 1]) {
-      idempotencyKey = args[++index];
-      continue;
-    }
-    if (arg === "--recover") {
-      recover = true;
-      continue;
-    }
-    if (arg === "--recovery-timeout-ms" && args[index + 1]) {
-      const parsed = Number(args[++index]);
-      if (!Number.isFinite(parsed) || parsed < 0) {
-        throw new Error("--recovery-timeout-ms must be a non-negative number.");
-      }
-      recoveryTimeoutMs = parsed;
-      continue;
-    }
-    if ((arg === "--out" || arg === "-o") && args[index + 1]) {
-      outPath = resolve(args[++index]);
-      continue;
+  for (const kv of options.param ?? []) {
+    const eqIdx = kv.indexOf("=");
+    if (eqIdx > 0) params[kv.slice(0, eqIdx)] = kv.slice(eqIdx + 1);
+  }
+  if (output.legacyInput !== void 0) {
+    Object.assign(
+      params,
+      parseJsonObjectArgument(output.legacyInput, "--json")
+    );
+  }
+  if (options.input !== void 0) {
+    Object.assign(params, parseJsonObjectArgument(options.input, "--input"));
+  }
+  if (options.payload !== void 0) {
+    Object.assign(
+      params,
+      parseJsonObjectArgument(options.payload, "--payload")
+    );
+  }
+  if (options.outputFormat !== void 0) {
+    outputFormat = normalizeOutputFormat(options.outputFormat);
+  }
+  if (options.idempotencyKey !== void 0) {
+    validateExecutionIdempotencyKey(options.idempotencyKey);
+  }
+  if (options.recoveryTimeoutMs !== void 0) {
+    const parsed = Number(options.recoveryTimeoutMs);
+    if (!options.recoveryTimeoutMs.trim() || !Number.isFinite(parsed) || parsed < 0) {
+      throw new Error("--recovery-timeout-ms must be a non-negative number.");
     }
-    throw new Error(`Unknown option: ${arg}`);
+    recoveryTimeoutMs = parsed;
   }
   return {
     toolId,
     params,
     outputFormat,
-    noPreview,
-    outPath,
-    timeoutMs,
-    idempotencyKey,
-    recover,
+    noPreview: options.preview === false,
+    outPath: options.out !== void 0 ? resolve(options.out) : null,
+    timeoutMs: options.timeout !== void 0 ? parseToolExecuteTimeout(options.timeout) : void 0,
+    idempotencyKey: options.idempotencyKey,
+    recover: options.recover === true,
     recoveryTimeoutMs
   };
 }
@@ -2650,9 +2615,6 @@ function parseToolExecuteTimeout(raw) {
 function safeFileStem(value) {
   return value.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "tool";
 }
-function shellQuote(value) {
-  return `'${value.replace(/'/g, `'\\''`)}'`;
-}
 function powerShellQuote(value) {
   return `'${value.replace(/'/g, "''")}'`;
 }
@@ -2682,6 +2644,7 @@ function seedToolListScript(input) {
 
 export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
   const result = await ctx.tools.execute({
+    staleAfterSeconds: 0,
     id: ${JSON.stringify(input.toolId)},
     tool: ${JSON.stringify(input.toolId)},
     input: ${JSON.stringify(input.payload)},
@@ -2699,7 +2662,7 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
   // Pass it to ctx.dataset; use rows.peek/count/materialize only for deliberate bounded inspection.
   // .withColumn('email_waterfall', (row, rowCtx) => rowCtx.runPlay('name_domain_email', 'name-and-domain-to-email', { first_name: String(row.first_name ?? ''), last_name: String(row.last_name ?? ''), domain: String(row.domain ?? '') }, { description: 'Resolve email.' }))
   // .withColumn('phone_waterfall', (row, rowCtx) => rowCtx.runPlay('contact_phone', 'contact-to-phone', { first_name: String(row.first_name ?? ''), last_name: String(row.last_name ?? ''), email: String(row.email ?? '') }, { description: 'Resolve phone.' }))
-  // ctx.dataset is idempotent by dataset key + row key; reruns reuse completed rows.
+  // ctx.dataset is idempotent for completed rows during same-run recovery. New runs follow each call's freshness.
   const enrichedData = await ctx
     .dataset('enriched_data', rows)
     .run({
@@ -2724,6 +2687,12 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
     windowsCopyCommand: `New-Item -ItemType Directory -Force -Path ${powerShellQuote(projectDir.replace(/\//g, "\\"))} | Out-Null; Copy-Item -LiteralPath ${powerShellQuote(scriptPath)} -Destination ${powerShellQuote(`${projectDir.replace(/\//g, "\\")}\\${fileName}`)}`
   };
 }
+function toolExecutionInspection(input) {
+  return {
+    inspect: input.idempotencyKey !== void 0 ? `deepline executions get --idempotency-key ${shellQuote(input.idempotencyKey)} --json` : `deepline describe ${shellQuote(input.toolId)} --json`,
+    inspectDescription: input.idempotencyKey !== void 0 ? "Read the saved execution without starting new work." : "Read the tool contract; this unkeyed call has no saved recovery identity."
+  };
+}
 function buildToolExecuteBaseEnvelope(input) {
   const envelope = commandEnvelopeFromRawResponse(input.rawResponse);
   const guidanceLines = toolExecuteExitCode(envelope) !== 0 || input.listExpected === true && !input.listConversion ? toolGuidanceLines(input.guidance) : [];
@@ -2749,7 +2718,7 @@ function buildToolExecuteBaseEnvelope(input) {
     "output"
   );
   const billingLookup = typeof envelope.job_id === "string" && envelope.job_id.trim() ? `deepline billing usage --request-id ${shellQuote(envelope.job_id)} --json` : null;
-  const inspectCommand = `deepline tools execute ${input.toolId} --input ${shellQuote(JSON.stringify(input.params))} --json`;
+  const inspection = toolExecutionInspection(input);
   const actions = input.listConversion ? [
     {
       label: "next",
@@ -2767,6 +2736,7 @@ function buildToolExecuteBaseEnvelope(input) {
   if (billingLookup) {
     actions.push({ label: "charge", command: billingLookup });
   }
+  actions.unshift({ label: "inspect", command: inspection.inspect });
   return {
     ...envelope,
     ...input.idempotencyKey ? { idempotency_key: input.idempotencyKey } : {},
@@ -2775,13 +2745,13 @@ function buildToolExecuteBaseEnvelope(input) {
     ...summaryEntries.length > 0 ? { summary: input.summary } : {},
     ...warningMessages.length > 0 ? { warnings: warningMessages } : {},
     next: {
-      inspect: inspectCommand,
+      ...inspection,
       ...billingLookup ? { billing: billingLookup } : {},
       ...apifyRecovery ?? {},
       ...guidanceLines.length > 0 ? { guidance: input.guidance } : {},
       playDebugging: "When fixing a play getter, inspect returned dataset handles with runs get and export rows with runs export; do not copy CLI preview paths blindly.",
       ...input.listConversion ? {
-        expandToPlay: "Use stable map and step keys so reruns are idempotent: completed rows are reused, and only missing or stale work runs again.",
+        expandToPlay: "Use stable map and step keys for recovery within a run. New runs follow each call's explicit freshness.",
         listSourcePath: input.listConversion.sourcePath ?? "auto-detected list in the CLI response preview"
       } : {}
     },
@@ -2832,6 +2802,7 @@ function buildToolExecuteRowArtifactEnvelope(input) {
   void _next;
   void _local;
   const billingLookup = isRecord(input.baseEnvelope.next) && typeof input.baseEnvelope.next.billing === "string" ? input.baseEnvelope.next.billing : null;
+  const inspection = toolExecutionInspection(input);
   return {
     ...base,
     status: typeof base.status === "string" ? base.status : "completed",
@@ -2873,10 +2844,10 @@ function buildToolExecuteRowArtifactEnvelope(input) {
       windows_powershell: input.seededScript.windowsCopyCommand
     },
     next: {
-      inspect: "Re-run with --json only when you need the raw provider/tool response.",
+      ...inspection,
       ...billingLookup ? { billing: billingLookup } : {},
       listSourcePath: input.rowOutput.sourcePath,
-      expandToPlay: "Use stable map and step keys so reruns are idempotent: completed rows are reused, and only missing or stale work runs again."
+      expandToPlay: "Use stable map and step keys for recovery within a run. New runs follow each call's explicit freshness."
     },
     render: {
       sections: [
@@ -2893,10 +2864,11 @@ function buildToolExecuteRowArtifactEnvelope(input) {
         }
       ],
       actions: [
+        { label: "inspect", command: inspection.inspect },
         ...billingLookup ? [{ label: "charge", command: billingLookup }] : [],
         {
           label: "next",
-          command: "Move the script into a project folder and expand it into a Deepline play. Use stable map and step keys so reruns are idempotent: completed rows are reused, and only missing or stale work runs again."
+          command: "Move the script into a project folder and expand it into a Deepline play. Use stable map and step keys for same-run recovery; choose explicit freshness for calls in new runs."
         },
         {
           label: "macOS/Linux",
@@ -2910,17 +2882,19 @@ function buildToolExecuteRowArtifactEnvelope(input) {
     }
   };
 }
-async function executeTool(args) {
+async function executeTool(toolId, options) {
+  const output = toolExecuteJsonOption(options.json);
+  const wantsJson = shouldEmitJson(output.requested);
   let parsed;
   try {
-    parsed = parseExecuteOptions(args);
+    parsed = parseExecuteOptions(toolId, options, output);
   } catch (error) {
-    if (argsWantJson(args)) {
+    if (wantsJson) {
       printJsonError(error);
     } else {
       console.error(error instanceof Error ? error.message : String(error));
     }
-    return 1;
+    return error instanceof DeeplineError && error.code === "IDEMPOTENCY_KEY_INVALID" ? 2 : 1;
   }
   const cliInvocationId = getToolExecuteInvocationId() ?? beginToolExecuteCommand();
   const client = new DeeplineClient();
@@ -2937,7 +2911,7 @@ async function executeTool(args) {
         () => findPlayForToolId(client, parsed.toolId, cliInvocationId)
       );
       if (play) {
-        if (argsWantJson(args)) {
+        if (wantsJson) {
           printJsonError(
             new Error(playAliasToolErrorMessage(parsed.toolId, play))
           );
@@ -2950,7 +2924,7 @@ async function executeTool(args) {
     throw error;
   }
   if (isPlayLikeTool(metadata)) {
-    if (argsWantJson(args)) {
+    if (wantsJson) {
       printJsonError(
         new Error(
           playLikeToolExecuteErrorMessage(
@@ -2992,7 +2966,7 @@ async function executeTool(args) {
     }).catch((error) => {
       const guidanceLines = toolGuidanceLines(metadata.guidance);
       if (guidanceLines.length > 0) {
-        if (args.includes("--json") && error instanceof Error) {
+        if (wantsJson && error instanceof Error) {
           Object.assign(error, { guidance: metadata.guidance });
         } else {
           console.error(
@@ -3049,10 +3023,14 @@ async function executeTool(args) {
     }
     if (!listConversion) {
       if (parsed.outPath) {
+        const inspection = toolExecutionInspection({
+          toolId: parsed.toolId,
+          idempotencyKey
+        });
         const error = new Error(
-          `${parsed.toolId} did not expose row-shaped output to write as CSV. Re-run with --json to inspect the raw tool response.`
+          `${parsed.toolId} did not expose row-shaped output to write as CSV. ${inspection.inspectDescription} Run: ${inspection.inspect}`
         );
-        if (argsWantJson(args)) {
+        if (wantsJson) {
           printJsonError(error);
         } else {
           console.error(error.message);
@@ -3090,6 +3068,8 @@ async function executeTool(args) {
       rows: listConversion.rows
     });
     const materializedEnvelope = buildToolExecuteRowArtifactEnvelope({
+      toolId: parsed.toolId,
+      idempotencyKey,
       baseEnvelope,
       csv,
       rowOutput,
@@ -3101,9 +3081,14 @@ async function executeTool(args) {
       return true;
     }
     if (parsed.outPath) {
+      const inspection = toolExecutionInspection({
+        toolId: parsed.toolId,
+        idempotencyKey
+      });
       printCommandEnvelope(materializedEnvelope, {
-        json: argsWantJson(args) || shouldEmitJson(),
+        json: wantsJson,
         text: `Wrote ${csv.rowCount} row(s) to ${csv.path}
+inspect: ${inspection.inspect}
 `
       });
       return true;

package/dist/cli/{chunk-UYFWTIKF.js → chunk-HZZJR2GV.js}

@@ -2,10 +2,10 @@
 
 
 
-var _chunkQQ2FG5W3js = require('./chunk-QQ2FG5W3.js');
+var _chunkUROXKPNDjs = require('./chunk-UROXKPND.js');
 
 
-var _chunkPVDQ55PSjs = require('./chunk-PVDQ55PS.js');
+var _chunkDM3SHV6Ujs = require('./chunk-DM3SHV6U.js');
 
 // src/cli/commands/git.ts
 function shellQuote(value) {
@@ -32,11 +32,11 @@ function renderDeployment(deployment) {
   return `${deployment.id}  ${source} (${kind}) - ${deployment.status}${suffix}`;
 }
 async function handleList(options) {
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     `/api/v2/play-projects${options.all ? "?includeDisabled=1" : ""}`
   );
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       projects: payload.projects,
       count: payload.projects.length,
@@ -73,7 +73,7 @@ function describeInstallationStatus(installation) {
   }
 }
 async function handleStatus(options) {
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get("/api/v2/github/installation");
   const installation = payload.installation;
   const others = (_nullishCoalesce(payload.installations, () => ( []))).filter(
@@ -136,7 +136,7 @@ async function handleStatus(options) {
       )
     );
   }
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       installation,
       installations: _nullishCoalesce(payload.installations, () => ( [])),
@@ -147,10 +147,10 @@ async function handleStatus(options) {
   );
 }
 async function handleRepos(options) {
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   const query = options.installation ? `?installationId=${encodeURIComponent(options.installation)}` : "";
   const payload = await http.get(`/api/v2/github/repos${query}`);
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       installation: payload.installation,
       repositories: payload.repositories,
@@ -171,7 +171,7 @@ async function handleRepos(options) {
 }
 async function resolveRepoId(repo, installation) {
   if (/^\d+$/.test(repo)) return Number(repo);
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   const query = installation ? `?installationId=${encodeURIComponent(installation)}` : "";
   const payload = await http.get(
     `/api/v2/github/repos${query}`
@@ -188,7 +188,7 @@ async function resolveRepoId(repo, installation) {
 }
 async function handleLink(repo, options) {
   const repoId = await resolveRepoId(repo, options.installation);
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.post("/api/v2/play-projects", {
     repoId,
     ...options.installation !== void 0 ? { installationId: options.installation } : {},
@@ -197,7 +197,7 @@ async function handleLink(repo, options) {
     ...options.branch !== void 0 ? { productionBranch: options.branch } : {},
     ...options.prChecks !== void 0 ? { checkOnPullRequest: options.prChecks } : {}
   });
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -220,11 +220,11 @@ async function handleLink(repo, options) {
   );
 }
 async function handleGet(id, options) {
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     `/api/v2/play-projects/${encodeURIComponent(id)}`
   );
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -240,7 +240,7 @@ async function handleGet(id, options) {
   );
 }
 async function handleSet(id, options) {
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.patch(
     `/api/v2/play-projects/${encodeURIComponent(id)}`,
     {
@@ -251,7 +251,7 @@ async function handleSet(id, options) {
       ...options.disabled !== void 0 ? { disabled: options.disabled } : {}
     }
   );
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -264,9 +264,9 @@ async function handleSet(id, options) {
   );
 }
 async function handleUnlink(id, options) {
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   await http.delete(`/api/v2/play-projects/${encodeURIComponent(id)}`);
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       id,
@@ -286,10 +286,10 @@ async function handleUnlink(id, options) {
   );
 }
 async function handleConnect(options) {
-  const baseUrl = _chunkPVDQ55PSjs.resolveBaseUrlOnly.call(void 0, );
+  const baseUrl = _chunkDM3SHV6Ujs.resolveBaseUrlOnly.call(void 0, );
   const connectUrl = `${baseUrl.replace(/\/$/, "")}/api/v2/github/connect`;
-  const opened = _chunkQQ2FG5W3js.openInBrowser.call(void 0, connectUrl);
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  const opened = _chunkUROXKPNDjs.openInBrowser.call(void 0, connectUrl);
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       connectUrl,
       browser: opened,
@@ -311,7 +311,7 @@ async function handleConnect(options) {
   );
 }
 async function handleDeploymentsList(options) {
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   const query = new URLSearchParams();
   if (options.repo) query.set("projectId", options.repo);
   if (options.limit) query.set("limit", options.limit);
@@ -319,7 +319,7 @@ async function handleDeploymentsList(options) {
   const payload = await http.get(
     `/api/v2/deployments${suffix}`
   );
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       deployments: payload.deployments,
       count: payload.deployments.length,
@@ -363,12 +363,12 @@ function renderDeploymentMonitorLines(results) {
   ]);
 }
 async function handleDeploymentGet(id, options) {
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(`/api/v2/deployments/${encodeURIComponent(id)}`);
   const playLines = renderDeploymentPlayLines(payload.deployment.results);
   const monitorLines = renderDeploymentMonitorLines(payload.deployment.results);
   const repository = _nullishCoalesce(_optionalChain([payload, 'access', _10 => _10.project, 'optionalAccess', _11 => _11.repoFullName]), () => ( payload.deployment.repoFullName));
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       deployment: payload.deployment,
       project: payload.project,
@@ -387,9 +387,9 @@ async function handleDeploymentGet(id, options) {
   );
 }
 async function handleDeploymentCancel(id, options) {
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.post(`/api/v2/deployments/${encodeURIComponent(id)}/cancel`, {});
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       cancelled: payload.cancelled,
       deployment: payload.deployment,

package/dist/cli/{chunk-76VKBPOC.mjs → chunk-JOA6IKDE.mjs}

@@ -1,3 +1,7 @@
+import {
+  shellQuote
+} from "./chunk-OVDNJAJN.mjs";
+
 // src/cli/described.ts
 var SHAPE = "{}";
 var SCHEMA_LINE_LIMIT = 100;
@@ -288,9 +292,10 @@ function examples(described, options) {
   if (runner.via === "monitor") return { cli: runner.deploy, play: null };
   if (runner.via === "tool") {
     return {
-      cli: `deepline tools execute ${runner.toolId} --input '${input}'`,
+      cli: `deepline tools execute ${runner.toolId} --input ${shellQuote(input)}`,
       play: [
         "const result = await ctx.tools.execute({",
+        "  staleAfterSeconds: 0,",
         `  id: '${safeIdentifier(runner.toolId)}',`,
         `  tool: '${runner.toolId}',`,
         `  input: ${input},`,
@@ -300,7 +305,7 @@ function examples(described, options) {
     };
   }
   return {
-    cli: runner.cli ?? `deepline plays run ${runner.reference} --input '${input}'`,
+    cli: runner.cli ?? `deepline plays run ${runner.reference} --input ${shellQuote(input)}`,
     play: [
       `const output = await ctx.runPlay('${safeIdentifier(runner.reference.replace(/^.*\//, ""))}', '${runner.reference}', ${input});`,
       ...reads((field) => `output.${field.name}`)