deepline 0.1.181 → 0.1.183

package/dist/cli/index.js

@@ -623,10 +623,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.181",
+  version: "0.1.183",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.181",
+    latest: "0.1.183",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -784,6 +784,10 @@ var WORKER_CALLBACK_URL_OVERRIDE_HEADER = "x-deepline-worker-callback-url";
 var RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER = "x-deepline-runtime-scheduler-schema";
 var SYNTHETIC_RUN_HEADER = "x-deepline-synthetic-run";
 
+// ../shared_libs/play-runtime/test-runtime-seams.ts
+var PLAY_RUNTIME_TEST_FAULT_HEADER = "x-deepline-test-fault";
+var MAX_RUNTIME_TEST_POLICY_MS = 10 * 6e4;
+
 // src/http.ts
 var MAX_DIAGNOSTIC_HEADER_LENGTH = 120;
 var COWORK_NETWORK_HINT = "Claude Cowork appears to be running Deepline in a network-restricted sandbox. In Claude Desktop, open Settings > Capabilities, turn on Allow network egress, and set Domain allowlist to All domains for the Cowork session.";
@@ -898,12 +902,9 @@ var HttpClient = class {
       headers["x-deepline-play-artifact-r2-prefix"] = playArtifactR2Prefix;
     }
     const coordinatorUrl = typeof process !== "undefined" ? process.env?.DEEPLINE_COORDINATOR_URL : void 0;
+    const coordinatorInternalToken = typeof process !== "undefined" ? process.env?.DEEPLINE_INTERNAL_TOKEN : void 0;
     if (coordinatorUrl?.trim()) {
       headers[COORDINATOR_URL_OVERRIDE_HEADER] = coordinatorUrl.trim();
-      const coordinatorInternalToken = typeof process !== "undefined" ? process.env?.DEEPLINE_INTERNAL_TOKEN : void 0;
-      if (coordinatorInternalToken?.trim()) {
-        headers[COORDINATOR_INTERNAL_TOKEN_HEADER] = coordinatorInternalToken.trim();
-      }
     }
     const workerCallbackUrl = typeof process !== "undefined" ? process.env?.DEEPLINE_WORKER_CALLBACK_URL : void 0;
     if (workerCallbackUrl?.trim()) {
@@ -917,6 +918,13 @@ var HttpClient = class {
     if (syntheticRun && syntheticRun.trim() && syntheticRun.trim() !== "0") {
       headers[SYNTHETIC_RUN_HEADER] = "1";
     }
+    const runtimeTestFault = typeof process !== "undefined" ? process.env?.DEEPLINE_TEST_RUNTIME_FAULT : void 0;
+    if (runtimeTestFault?.trim()) {
+      headers[PLAY_RUNTIME_TEST_FAULT_HEADER] = runtimeTestFault.trim();
+    }
+    if (coordinatorInternalToken?.trim() && (coordinatorUrl?.trim() || workerCallbackUrl?.trim() || runtimeTestFault?.trim())) {
+      headers[COORDINATOR_INTERNAL_TOKEN_HEADER] = coordinatorInternalToken.trim();
+    }
     return headers;
   }
   /**
@@ -1330,6 +1338,20 @@ function resolveTimingWindow(input2) {
   };
 }
 
+// ../shared_libs/play-runtime/run-terminal-source.ts
+var PLAY_RUN_LEDGER_EVENT_SOURCES = [
+  "worker",
+  "temporal",
+  "convex",
+  "coordinator",
+  "system"
+];
+function normalizePlayRunLedgerTerminalSource(value) {
+  return PLAY_RUN_LEDGER_EVENT_SOURCES.includes(
+    value
+  ) ? value : null;
+}
+
 // ../shared_libs/play-runtime/run-ledger.ts
 var LOG_TAIL_LIMIT = 100;
 function isRecord(value) {
@@ -1466,7 +1488,8 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
     ),
     resultTableNamespace: optionalNullableString(value.resultTableNamespace),
     resultSummary: value.resultSummary,
-    result: value.result
+    result: value.result,
+    terminalSource: normalizePlayRunLedgerTerminalSource(value.terminalSource)
   };
 }
 function normalizeStepStatus(value) {
@@ -2191,6 +2214,33 @@ function resolvePlayRunIntegrationMode(request) {
     request.integrationMode ?? process.env.DEEPLINE_EVAL_INTEGRATION_MODE
   );
 }
+function normalizeTestPolicyOverrides(value, source) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  throw new DeeplineError(
+    `${source} must be a JSON object.`,
+    void 0,
+    "INVALID_TEST_POLICY_OVERRIDES"
+  );
+}
+function parseEnvTestPolicyOverrides() {
+  const raw = typeof process !== "undefined" ? process.env?.DEEPLINE_TEST_POLICY_OVERRIDES : void 0;
+  const trimmed = raw?.trim();
+  if (!trimmed) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch (error) {
+    const detail = error instanceof Error ? ` ${error.message}` : "";
+    throw new DeeplineError(
+      `DEEPLINE_TEST_POLICY_OVERRIDES must be valid JSON.${detail}`,
+      void 0,
+      "INVALID_TEST_POLICY_OVERRIDES"
+    );
+  }
+  return normalizeTestPolicyOverrides(parsed, "DEEPLINE_TEST_POLICY_OVERRIDES");
+}
 function sleep2(ms) {
   return new Promise((resolve14) => setTimeout(resolve14, ms));
 }
@@ -2742,11 +2792,14 @@ var DeeplineClient = class {
     const headers = {
       [EXECUTE_RESPONSE_CONTRACT_HEADER]: V2_EXECUTE_RESPONSE_CONTRACT,
       ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {},
-      ...options?.responseIntent ? { [EXECUTE_RESPONSE_INTENT_HEADER]: options.responseIntent } : {}
+      [EXECUTE_RESPONSE_INTENT_HEADER]: options?.responseIntent ?? "raw"
     };
     return this.http.post(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
-      { payload: input2 },
+      {
+        payload: input2,
+        ...options?.metadata ? { metadata: options.metadata } : {}
+      },
       headers,
       {
         forbiddenAsApiError: true,
@@ -2830,6 +2883,7 @@ var DeeplineClient = class {
    */
   async startPlayRun(request) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const testPolicyOverrides = request.testPolicyOverrides ?? parseEnvTestPolicyOverrides();
     const forceToolRefresh = request.forceToolRefresh === true;
     const response = await this.http.post(
       "/api/v2/plays/run",
@@ -2857,7 +2911,8 @@ var DeeplineClient = class {
         // defaults to workers_edge; tests and runtime probes that want a
         // different profile pass `request.profile` explicitly.
         ...request.profile ? { profile: request.profile } : {},
-        ...integrationMode ? { integrationMode } : {}
+        ...integrationMode ? { integrationMode } : {},
+        ...testPolicyOverrides ? { testPolicyOverrides } : {}
       }
     );
     return normalizePlayRunStart(response);
@@ -2875,6 +2930,7 @@ var DeeplineClient = class {
    */
   async *startPlayRunStream(request, options) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const testPolicyOverrides = request.testPolicyOverrides ?? parseEnvTestPolicyOverrides();
     const forceToolRefresh = request.forceToolRefresh === true;
     const body = {
       ...request.name ? { name: request.name } : {},
@@ -2897,7 +2953,8 @@ var DeeplineClient = class {
       ...forceToolRefresh ? { forceToolRefresh: true } : {},
       ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
       ...request.profile ? { profile: request.profile } : {},
-      ...integrationMode ? { integrationMode } : {}
+      ...integrationMode ? { integrationMode } : {},
+      ...testPolicyOverrides ? { testPolicyOverrides } : {}
     };
     for await (const event of this.http.streamSse(
       "/api/v2/plays/run?stream=true",
@@ -9745,7 +9802,7 @@ async function traceCliSpan(phase, fields, run) {
 }
 
 // src/cli/play-check-hints.ts
-var EXTRACTED_GETTER_ERROR_HINT = "Deepline hint: extractedValues/extractedLists .get() only works for declared Deepline getters listed by `deepline tools describe <tool> --json`. Use `toolExecutionResult.toolResponse.raw` for provider/tool-specific fields.";
+var EXTRACTED_GETTER_ERROR_HINT = "Deepline hint: extractedValues/extractedLists .get() only works for declared Deepline getters listed by `deepline tools describe <tool> --json`. Use `toolExecutionResult.toolResponse.raw` for provider/tool-specific scalar fields, and `toolExecutionResult.extractedLists.<name>.get()` for declared row/list outputs.";
 var DATASET_API_HINT = "Deepline hint: PlayDataset is lazy and durable. Use `.peek(n)` for a small preview or `.materialize()` when you intentionally need rows in memory; do not use `.rows`, `.toArray()`, or array methods directly on the dataset handle.";
 var ROW_PROPERTY_HINT = "Deepline hint: this row type only contains fields produced by the CSV/schema and previous map steps. Check source column casing and the exact output field names from earlier steps before scaling.";
 var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for logs, metadata, and receipt attachment; provider-call reuse is based on play, tool, semantic input, auth scope, provider action version, and cache policy.";
@@ -9889,9 +9946,9 @@ var PLAY_RUNTIME_PROVIDERS = {
     id: PLAY_RUNTIME_PROVIDER_IDS.hatchet,
     scheduler: PLAY_SCHEDULER_BACKENDS.hatchet,
     runner: PLAY_RUNTIME_BACKENDS.daytona,
-    dedup: PLAY_DEDUP_BACKENDS.durableObject,
+    dedup: PLAY_DEDUP_BACKENDS.inMemory,
     artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
-    label: "Hatchet scheduler + one-shot Daytona runner + DO dedup"
+    label: "Hatchet scheduler + one-shot Daytona runner + receipt-backed in-process dedup"
   },
   local: {
     id: PLAY_RUNTIME_PROVIDER_IDS.local,
@@ -13716,7 +13773,7 @@ async function handleFileBackedRun(options) {
     ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
     ...stagedFileInputs.inputFile ? { inputFile: stagedFileInputs.inputFile } : {},
     ...stagedFileInputs.packagedFiles.length ? { packagedFiles: stagedFileInputs.packagedFiles } : {},
-    ...options.force ? { force: true, forceToolRefresh: true } : {},
+    ...options.force ? { force: true } : {},
     ...options.profile ? { profile: options.profile } : {},
     ...integrationMode ? { integrationMode } : {}
   };
@@ -13875,7 +13932,7 @@ async function handleNamedRun(options) {
     ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
     ...stagedFileInputs.inputFile ? { inputFile: stagedFileInputs.inputFile } : {},
     ...stagedFileInputs.packagedFiles.length ? { packagedFiles: stagedFileInputs.packagedFiles } : {},
-    ...options.force ? { force: true, forceToolRefresh: true } : {},
+    ...options.force ? { force: true } : {},
     ...options.profile ? { profile: options.profile } : {},
     ...integrationMode ? { integrationMode } : {}
   };
@@ -15062,7 +15119,7 @@ Notes:
   The play page opens in your browser as soon as the run starts; use --no-open
   to only print the URL.
   Concurrent runs for the same play are allowed.
-  --force bypasses durable dataset/tool cache reuse for this run.
+  --force starts a fresh run graph without refreshing completed provider calls.
   It does not cancel active sibling runs.
   This command starts cloud work and may spend Deepline credits through tool calls.
 
@@ -15114,7 +15171,7 @@ Examples:
   ).option("--watch", "Compatibility alias; run waits by default").option("--wait", "Compatibility alias; run waits by default").option("--no-wait", "Start the run and return immediately").option(
     "--logs",
     "When output is non-interactive, stream play logs to stderr while waiting"
-  ).option("--tail-timeout-ms <ms>", "Timeout while watching the run stream").option("--force", "Bypass durable dataset/tool cache reuse").option("--no-open", "Print the play page URL without opening a browser").option("--json", "Emit JSON output").option("--full", "Debug only: with --json, emit the raw status payload").addHelpText(
+  ).option("--tail-timeout-ms <ms>", "Timeout while watching the run stream").option("--force", "Start a fresh run graph").option("--no-open", "Print the play page URL without opening a browser").option("--json", "Emit JSON output").option("--full", "Debug only: with --json, emit the raw status payload").addHelpText(
     "afterAll",
     `
 Pass-through input flags:
@@ -22464,7 +22521,7 @@ async function readHiddenLine(prompt, streams = {}) {
       if (typeof inputStream.setRawMode === "function") {
         inputStream.setRawMode(previousRawMode);
       }
-      if (wasPaused) {
+      if (wasPaused || inputStream === import_node_process.stdin) {
         inputStream.pause();
       }
     };
@@ -24026,7 +24083,7 @@ function toolMetadataJsonForDescribe(tool, requestedToolId) {
     runtimeOutputHelp: {
       contract: "tools describe shows declared schema and Deepline getters; it is not an observed provider response.",
       getterScope: "extractedValues/extractedLists .get() only works for declared Deepline getters listed in usageGuidance.toolExecutionResult.",
-      rawToolResponse: "Use toolExecutionResult.toolResponse.raw for provider/tool-specific fields, fields in outputSchema that are not declared getters, and debugging.",
+      rawToolResponse: "Use toolExecutionResult.toolResponse.raw for provider/tool-specific scalar fields, fields in outputSchema that are not declared getters, and debugging. For declared row/list outputs, use extractedLists.<name>.get(); raw row arrays may be inline previews.",
       invalidGetterHint: "If TypeScript says an extractedValues/extractedLists property does not exist, that field is not a declared Deepline getter.",
       observeActualShape: observedOutputCommand,
       observedOutput: observedOutputCommand,
@@ -24052,9 +24109,9 @@ function usageGuidanceWithAccessDefaults(usageGuidance) {
       },
       rawToolResponse: {
         expression: "toolExecutionResult.toolResponse.raw",
-        meaning: "Raw tool response for provider/tool-specific fields and debugging."
+        meaning: "Raw tool response for provider/tool-specific scalar fields and bounded debugging. Declared row/list outputs should use extractedLists.<name>.get(); raw row arrays may be inline previews."
       },
-      invalidGetterHint: "If TypeScript says an extractedValues/extractedLists property does not exist, that field is not a declared Deepline getter; use toolResponse.raw for provider/tool-specific fields.",
+      invalidGetterHint: "If TypeScript says an extractedValues/extractedLists property does not exist, that field is not a declared Deepline getter; use toolResponse.raw for provider/tool-specific scalar fields, and extractedLists.<name>.get() for declared row/list outputs.",
       ...existingAccess
     }
   };
@@ -25597,10 +25654,15 @@ async function syncSdkSkillsIfNeeded(baseUrl, options = {}) {
 }
 
 // src/cli/commands/update.ts
-var NPM_SDK_INSTALL_COMMON_FLAGS = ["--no-audit", "--no-fund"];
+var NPM_SDK_INSTALL_COMMON_FLAGS = [
+  "--no-audit",
+  "--no-fund",
+  "--include=optional"
+];
 var NPM_SDK_GLOBAL_INSTALL_FLAGS = [
   "--no-audit",
   "--no-fund",
+  "--include=optional",
   "--allow-scripts=esbuild"
 ];
 var NPM_SDK_SIDECAR_PACKAGE_JSON = `${JSON.stringify(

package/dist/cli/index.mjs

@@ -608,10 +608,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.181",
+  version: "0.1.183",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.181",
+    latest: "0.1.183",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -769,6 +769,10 @@ var WORKER_CALLBACK_URL_OVERRIDE_HEADER = "x-deepline-worker-callback-url";
 var RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER = "x-deepline-runtime-scheduler-schema";
 var SYNTHETIC_RUN_HEADER = "x-deepline-synthetic-run";
 
+// ../shared_libs/play-runtime/test-runtime-seams.ts
+var PLAY_RUNTIME_TEST_FAULT_HEADER = "x-deepline-test-fault";
+var MAX_RUNTIME_TEST_POLICY_MS = 10 * 6e4;
+
 // src/http.ts
 var MAX_DIAGNOSTIC_HEADER_LENGTH = 120;
 var COWORK_NETWORK_HINT = "Claude Cowork appears to be running Deepline in a network-restricted sandbox. In Claude Desktop, open Settings > Capabilities, turn on Allow network egress, and set Domain allowlist to All domains for the Cowork session.";
@@ -883,12 +887,9 @@ var HttpClient = class {
       headers["x-deepline-play-artifact-r2-prefix"] = playArtifactR2Prefix;
     }
     const coordinatorUrl = typeof process !== "undefined" ? process.env?.DEEPLINE_COORDINATOR_URL : void 0;
+    const coordinatorInternalToken = typeof process !== "undefined" ? process.env?.DEEPLINE_INTERNAL_TOKEN : void 0;
     if (coordinatorUrl?.trim()) {
       headers[COORDINATOR_URL_OVERRIDE_HEADER] = coordinatorUrl.trim();
-      const coordinatorInternalToken = typeof process !== "undefined" ? process.env?.DEEPLINE_INTERNAL_TOKEN : void 0;
-      if (coordinatorInternalToken?.trim()) {
-        headers[COORDINATOR_INTERNAL_TOKEN_HEADER] = coordinatorInternalToken.trim();
-      }
     }
     const workerCallbackUrl = typeof process !== "undefined" ? process.env?.DEEPLINE_WORKER_CALLBACK_URL : void 0;
     if (workerCallbackUrl?.trim()) {
@@ -902,6 +903,13 @@ var HttpClient = class {
     if (syntheticRun && syntheticRun.trim() && syntheticRun.trim() !== "0") {
       headers[SYNTHETIC_RUN_HEADER] = "1";
     }
+    const runtimeTestFault = typeof process !== "undefined" ? process.env?.DEEPLINE_TEST_RUNTIME_FAULT : void 0;
+    if (runtimeTestFault?.trim()) {
+      headers[PLAY_RUNTIME_TEST_FAULT_HEADER] = runtimeTestFault.trim();
+    }
+    if (coordinatorInternalToken?.trim() && (coordinatorUrl?.trim() || workerCallbackUrl?.trim() || runtimeTestFault?.trim())) {
+      headers[COORDINATOR_INTERNAL_TOKEN_HEADER] = coordinatorInternalToken.trim();
+    }
     return headers;
   }
   /**
@@ -1315,6 +1323,20 @@ function resolveTimingWindow(input2) {
   };
 }
 
+// ../shared_libs/play-runtime/run-terminal-source.ts
+var PLAY_RUN_LEDGER_EVENT_SOURCES = [
+  "worker",
+  "temporal",
+  "convex",
+  "coordinator",
+  "system"
+];
+function normalizePlayRunLedgerTerminalSource(value) {
+  return PLAY_RUN_LEDGER_EVENT_SOURCES.includes(
+    value
+  ) ? value : null;
+}
+
 // ../shared_libs/play-runtime/run-ledger.ts
 var LOG_TAIL_LIMIT = 100;
 function isRecord(value) {
@@ -1451,7 +1473,8 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
     ),
     resultTableNamespace: optionalNullableString(value.resultTableNamespace),
     resultSummary: value.resultSummary,
-    result: value.result
+    result: value.result,
+    terminalSource: normalizePlayRunLedgerTerminalSource(value.terminalSource)
   };
 }
 function normalizeStepStatus(value) {
@@ -2176,6 +2199,33 @@ function resolvePlayRunIntegrationMode(request) {
     request.integrationMode ?? process.env.DEEPLINE_EVAL_INTEGRATION_MODE
   );
 }
+function normalizeTestPolicyOverrides(value, source) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  throw new DeeplineError(
+    `${source} must be a JSON object.`,
+    void 0,
+    "INVALID_TEST_POLICY_OVERRIDES"
+  );
+}
+function parseEnvTestPolicyOverrides() {
+  const raw = typeof process !== "undefined" ? process.env?.DEEPLINE_TEST_POLICY_OVERRIDES : void 0;
+  const trimmed = raw?.trim();
+  if (!trimmed) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch (error) {
+    const detail = error instanceof Error ? ` ${error.message}` : "";
+    throw new DeeplineError(
+      `DEEPLINE_TEST_POLICY_OVERRIDES must be valid JSON.${detail}`,
+      void 0,
+      "INVALID_TEST_POLICY_OVERRIDES"
+    );
+  }
+  return normalizeTestPolicyOverrides(parsed, "DEEPLINE_TEST_POLICY_OVERRIDES");
+}
 function sleep2(ms) {
   return new Promise((resolve14) => setTimeout(resolve14, ms));
 }
@@ -2727,11 +2777,14 @@ var DeeplineClient = class {
     const headers = {
       [EXECUTE_RESPONSE_CONTRACT_HEADER]: V2_EXECUTE_RESPONSE_CONTRACT,
       ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {},
-      ...options?.responseIntent ? { [EXECUTE_RESPONSE_INTENT_HEADER]: options.responseIntent } : {}
+      [EXECUTE_RESPONSE_INTENT_HEADER]: options?.responseIntent ?? "raw"
     };
     return this.http.post(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
-      { payload: input2 },
+      {
+        payload: input2,
+        ...options?.metadata ? { metadata: options.metadata } : {}
+      },
       headers,
       {
         forbiddenAsApiError: true,
@@ -2815,6 +2868,7 @@ var DeeplineClient = class {
    */
   async startPlayRun(request) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const testPolicyOverrides = request.testPolicyOverrides ?? parseEnvTestPolicyOverrides();
     const forceToolRefresh = request.forceToolRefresh === true;
     const response = await this.http.post(
       "/api/v2/plays/run",
@@ -2842,7 +2896,8 @@ var DeeplineClient = class {
         // defaults to workers_edge; tests and runtime probes that want a
         // different profile pass `request.profile` explicitly.
         ...request.profile ? { profile: request.profile } : {},
-        ...integrationMode ? { integrationMode } : {}
+        ...integrationMode ? { integrationMode } : {},
+        ...testPolicyOverrides ? { testPolicyOverrides } : {}
       }
     );
     return normalizePlayRunStart(response);
@@ -2860,6 +2915,7 @@ var DeeplineClient = class {
    */
   async *startPlayRunStream(request, options) {
     const integrationMode = resolvePlayRunIntegrationMode(request);
+    const testPolicyOverrides = request.testPolicyOverrides ?? parseEnvTestPolicyOverrides();
     const forceToolRefresh = request.forceToolRefresh === true;
     const body = {
       ...request.name ? { name: request.name } : {},
@@ -2882,7 +2938,8 @@ var DeeplineClient = class {
       ...forceToolRefresh ? { forceToolRefresh: true } : {},
       ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
       ...request.profile ? { profile: request.profile } : {},
-      ...integrationMode ? { integrationMode } : {}
+      ...integrationMode ? { integrationMode } : {},
+      ...testPolicyOverrides ? { testPolicyOverrides } : {}
     };
     for await (const event of this.http.streamSse(
       "/api/v2/plays/run?stream=true",
@@ -9772,7 +9829,7 @@ async function traceCliSpan(phase, fields, run) {
 }
 
 // src/cli/play-check-hints.ts
-var EXTRACTED_GETTER_ERROR_HINT = "Deepline hint: extractedValues/extractedLists .get() only works for declared Deepline getters listed by `deepline tools describe <tool> --json`. Use `toolExecutionResult.toolResponse.raw` for provider/tool-specific fields.";
+var EXTRACTED_GETTER_ERROR_HINT = "Deepline hint: extractedValues/extractedLists .get() only works for declared Deepline getters listed by `deepline tools describe <tool> --json`. Use `toolExecutionResult.toolResponse.raw` for provider/tool-specific scalar fields, and `toolExecutionResult.extractedLists.<name>.get()` for declared row/list outputs.";
 var DATASET_API_HINT = "Deepline hint: PlayDataset is lazy and durable. Use `.peek(n)` for a small preview or `.materialize()` when you intentionally need rows in memory; do not use `.rows`, `.toArray()`, or array methods directly on the dataset handle.";
 var ROW_PROPERTY_HINT = "Deepline hint: this row type only contains fields produced by the CSV/schema and previous map steps. Check source column casing and the exact output field names from earlier steps before scaling.";
 var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for logs, metadata, and receipt attachment; provider-call reuse is based on play, tool, semantic input, auth scope, provider action version, and cache policy.";
@@ -9916,9 +9973,9 @@ var PLAY_RUNTIME_PROVIDERS = {
     id: PLAY_RUNTIME_PROVIDER_IDS.hatchet,
     scheduler: PLAY_SCHEDULER_BACKENDS.hatchet,
     runner: PLAY_RUNTIME_BACKENDS.daytona,
-    dedup: PLAY_DEDUP_BACKENDS.durableObject,
+    dedup: PLAY_DEDUP_BACKENDS.inMemory,
     artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
-    label: "Hatchet scheduler + one-shot Daytona runner + DO dedup"
+    label: "Hatchet scheduler + one-shot Daytona runner + receipt-backed in-process dedup"
   },
   local: {
     id: PLAY_RUNTIME_PROVIDER_IDS.local,
@@ -13743,7 +13800,7 @@ async function handleFileBackedRun(options) {
     ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
     ...stagedFileInputs.inputFile ? { inputFile: stagedFileInputs.inputFile } : {},
     ...stagedFileInputs.packagedFiles.length ? { packagedFiles: stagedFileInputs.packagedFiles } : {},
-    ...options.force ? { force: true, forceToolRefresh: true } : {},
+    ...options.force ? { force: true } : {},
     ...options.profile ? { profile: options.profile } : {},
     ...integrationMode ? { integrationMode } : {}
   };
@@ -13902,7 +13959,7 @@ async function handleNamedRun(options) {
     ...Object.keys(runtimeInput).length > 0 ? { input: runtimeInput } : {},
     ...stagedFileInputs.inputFile ? { inputFile: stagedFileInputs.inputFile } : {},
     ...stagedFileInputs.packagedFiles.length ? { packagedFiles: stagedFileInputs.packagedFiles } : {},
-    ...options.force ? { force: true, forceToolRefresh: true } : {},
+    ...options.force ? { force: true } : {},
     ...options.profile ? { profile: options.profile } : {},
     ...integrationMode ? { integrationMode } : {}
   };
@@ -15089,7 +15146,7 @@ Notes:
   The play page opens in your browser as soon as the run starts; use --no-open
   to only print the URL.
   Concurrent runs for the same play are allowed.
-  --force bypasses durable dataset/tool cache reuse for this run.
+  --force starts a fresh run graph without refreshing completed provider calls.
   It does not cancel active sibling runs.
   This command starts cloud work and may spend Deepline credits through tool calls.
 
@@ -15141,7 +15198,7 @@ Examples:
   ).option("--watch", "Compatibility alias; run waits by default").option("--wait", "Compatibility alias; run waits by default").option("--no-wait", "Start the run and return immediately").option(
     "--logs",
     "When output is non-interactive, stream play logs to stderr while waiting"
-  ).option("--tail-timeout-ms <ms>", "Timeout while watching the run stream").option("--force", "Bypass durable dataset/tool cache reuse").option("--no-open", "Print the play page URL without opening a browser").option("--json", "Emit JSON output").option("--full", "Debug only: with --json, emit the raw status payload").addHelpText(
+  ).option("--tail-timeout-ms <ms>", "Timeout while watching the run stream").option("--force", "Start a fresh run graph").option("--no-open", "Print the play page URL without opening a browser").option("--json", "Emit JSON output").option("--full", "Debug only: with --json, emit the raw status payload").addHelpText(
     "afterAll",
     `
 Pass-through input flags:
@@ -22498,7 +22555,7 @@ async function readHiddenLine(prompt, streams = {}) {
       if (typeof inputStream.setRawMode === "function") {
         inputStream.setRawMode(previousRawMode);
       }
-      if (wasPaused) {
+      if (wasPaused || inputStream === input) {
         inputStream.pause();
       }
     };
@@ -24072,7 +24129,7 @@ function toolMetadataJsonForDescribe(tool, requestedToolId) {
     runtimeOutputHelp: {
       contract: "tools describe shows declared schema and Deepline getters; it is not an observed provider response.",
       getterScope: "extractedValues/extractedLists .get() only works for declared Deepline getters listed in usageGuidance.toolExecutionResult.",
-      rawToolResponse: "Use toolExecutionResult.toolResponse.raw for provider/tool-specific fields, fields in outputSchema that are not declared getters, and debugging.",
+      rawToolResponse: "Use toolExecutionResult.toolResponse.raw for provider/tool-specific scalar fields, fields in outputSchema that are not declared getters, and debugging. For declared row/list outputs, use extractedLists.<name>.get(); raw row arrays may be inline previews.",
       invalidGetterHint: "If TypeScript says an extractedValues/extractedLists property does not exist, that field is not a declared Deepline getter.",
       observeActualShape: observedOutputCommand,
       observedOutput: observedOutputCommand,
@@ -24098,9 +24155,9 @@ function usageGuidanceWithAccessDefaults(usageGuidance) {
       },
       rawToolResponse: {
         expression: "toolExecutionResult.toolResponse.raw",
-        meaning: "Raw tool response for provider/tool-specific fields and debugging."
+        meaning: "Raw tool response for provider/tool-specific scalar fields and bounded debugging. Declared row/list outputs should use extractedLists.<name>.get(); raw row arrays may be inline previews."
       },
-      invalidGetterHint: "If TypeScript says an extractedValues/extractedLists property does not exist, that field is not a declared Deepline getter; use toolResponse.raw for provider/tool-specific fields.",
+      invalidGetterHint: "If TypeScript says an extractedValues/extractedLists property does not exist, that field is not a declared Deepline getter; use toolResponse.raw for provider/tool-specific scalar fields, and extractedLists.<name>.get() for declared row/list outputs.",
       ...existingAccess
     }
   };
@@ -25652,10 +25709,15 @@ async function syncSdkSkillsIfNeeded(baseUrl, options = {}) {
 }
 
 // src/cli/commands/update.ts
-var NPM_SDK_INSTALL_COMMON_FLAGS = ["--no-audit", "--no-fund"];
+var NPM_SDK_INSTALL_COMMON_FLAGS = [
+  "--no-audit",
+  "--no-fund",
+  "--include=optional"
+];
 var NPM_SDK_GLOBAL_INSTALL_FLAGS = [
   "--no-audit",
   "--no-fund",
+  "--include=optional",
   "--allow-scripts=esbuild"
 ];
 var NPM_SDK_SIDECAR_PACKAGE_JSON = `${JSON.stringify(

package/dist/index.d.mts

@@ -952,6 +952,8 @@ interface StartPlayRunRequest {
     profile?: string;
     /** Optional per-run provider execution mode for eval/smoke runs. */
     integrationMode?: 'live' | 'eval_stub' | 'fixture';
+    /** Internal/dev-only runtime policy overrides for black-box durability tests. */
+    testPolicyOverrides?: Record<string, unknown>;
 }
 /**
  * Request body for making a play revision live.
@@ -1088,7 +1090,8 @@ type EnrichCompiledConfig = {
 
 type ExecuteToolRawOptions = {
     includeToolMetadata?: boolean;
-    responseIntent?: 'raw' | 'row_artifact';
+    responseIntent?: 'dataset' | 'raw' | 'row_artifact';
+    metadata?: Record<string, unknown>;
     timeout?: number;
     maxRetries?: number;
 };

package/dist/index.d.ts

@@ -952,6 +952,8 @@ interface StartPlayRunRequest {
     profile?: string;
     /** Optional per-run provider execution mode for eval/smoke runs. */
     integrationMode?: 'live' | 'eval_stub' | 'fixture';
+    /** Internal/dev-only runtime policy overrides for black-box durability tests. */
+    testPolicyOverrides?: Record<string, unknown>;
 }
 /**
  * Request body for making a play revision live.
@@ -1088,7 +1090,8 @@ type EnrichCompiledConfig = {
 
 type ExecuteToolRawOptions = {
     includeToolMetadata?: boolean;
-    responseIntent?: 'raw' | 'row_artifact';
+    responseIntent?: 'dataset' | 'raw' | 'row_artifact';
+    metadata?: Record<string, unknown>;
     timeout?: number;
     maxRetries?: number;
 };