deepline 0.3.64 → 0.3.66

package/dist/cli/index.mjs

@@ -1199,7 +1199,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.64",
+  version: "0.3.66",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -16820,9 +16820,7 @@ function readProvenanceTag(line) {
     return { provenance: null, line };
   }
   const candidate = line.slice(PROVENANCE_PREFIX.length, end);
-  const provenance = LOG_PROVENANCE_CLASSES.includes(
-    candidate
-  ) ? candidate : null;
+  const provenance = LOG_PROVENANCE_CLASSES.includes(candidate) ? candidate : null;
   return { provenance, line: line.slice(end + 1) };
 }
 function classifyLegacyLogLine(line) {
@@ -17156,12 +17154,16 @@ var PLAY_RUN_RESERVED_BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "--watch",
   "--no-wait",
   "--logs",
+  "--debug",
   "--full",
   "--force",
   "--force-tool-refresh",
   "--open",
   "--debug-map-latency"
 ]);
+function isBarePlayRunDebugFlag(args, index) {
+  return args[index] === "--debug" && (args[index + 1] === void 0 || args[index + 1].startsWith("--"));
+}
 async function pathExistsIncludingSymlink(path) {
   try {
     await lstat(path);
@@ -21119,12 +21121,13 @@ function parsePlayRunOptions(args) {
   const watch = !args.includes("--no-wait");
   let jsonOutput = watch ? args.includes("--json") : argsWantJson(args);
   const fullJson = args.includes("--full");
-  const emitLogs = !jsonOutput || args.includes("--logs");
+  const explicitDebugLogs = args.includes("--logs") || args.some((_, index) => isBarePlayRunDebugFlag(args, index));
+  const emitLogs = !jsonOutput || explicitDebugLogs;
   const force = args.includes("--force");
   const forceToolRefresh = args.includes("--force-tool-refresh");
   const open2 = args.includes("--open");
   const debugMapLatency = args.includes("--debug-map-latency");
-  const verboseLogs = args.includes("--logs") || debugMapLatency;
+  const verboseLogs = explicitDebugLogs || debugMapLatency;
   let waitTimeoutMs = null;
   let maxConcurrentExternalCalls = null;
   let maxConcurrentRows = null;
@@ -21255,6 +21258,20 @@ function parsePlayRunOptions(args) {
       waitTimeoutMs = parsePositiveInteger3(args[++index], arg);
       continue;
     }
+    if (arg === "--debug" && args[index + 1] && !args[index + 1].startsWith("--")) {
+      input2 ??= {};
+      setDottedInputValue(input2, "debug", parseInputFlagValue(args[++index]));
+      continue;
+    }
+    if (arg.startsWith("--debug=")) {
+      input2 ??= {};
+      setDottedInputValue(
+        input2,
+        "debug",
+        parseInputFlagValue(arg.slice("--debug=".length))
+      );
+      continue;
+    }
     if (PLAY_RUN_RESERVED_BOOLEAN_FLAGS.has(arg)) {
       if (arg === "--watch") {
         continue;
@@ -22513,7 +22530,7 @@ async function handlePlayRun(args, hooks) {
 function parseRunIdPositional(args, usage) {
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
-    if (arg === "--json" || arg === "--full" || arg === "--input" || arg === "--logs" || arg === "--compact" || arg === "--log-failed" || arg === "--failed" || arg === "--limit") {
+    if (arg === "--json" || arg === "--full" || arg === "--input" || arg === "--logs" || arg === "--debug" || arg === "--compact" || arg === "--log-failed" || arg === "--failed" || arg === "--limit") {
       if (arg === "--limit" && args[index + 1]) {
         index += 1;
       }
@@ -22661,7 +22678,7 @@ async function handleRunsList(args) {
   return 0;
 }
 async function handleRunTail(args) {
-  const usage = "Usage: deepline runs tail <run-id> [--json | --jsonl] [--compact]";
+  const usage = "Usage: deepline runs tail <run-id> [--json | --jsonl] [--compact] [--debug]";
   let runId;
   try {
     runId = parseRunIdPositional(args, usage);
@@ -22677,7 +22694,7 @@ async function handleRunTail(args) {
       );
       return 1;
     }
-    if (arg.startsWith("--") && arg !== "--json" && arg !== "--jsonl" && arg !== "--compact") {
+    if (arg.startsWith("--") && arg !== "--json" && arg !== "--jsonl" && arg !== "--compact" && arg !== "--logs" && arg !== "--debug") {
       console.error(`${arg} is not supported by deepline runs tail.`);
       return 1;
     }
@@ -22686,6 +22703,13 @@ async function handleRunTail(args) {
     console.error("--json and --jsonl cannot be used together.");
     return 1;
   }
+  const debug = args.includes("--logs") || args.includes("--debug");
+  if (args.includes("--jsonl") && debug) {
+    console.error(
+      "--debug is redundant with --jsonl: JSON Lines already includes every canonical live event."
+    );
+    return 1;
+  }
   const client2 = new DeeplineClient();
   const jsonLines = args.includes("--jsonl");
   const jsonOutput = !jsonLines && argsWantJson(args);
@@ -22695,7 +22719,8 @@ async function handleRunTail(args) {
     emittedRunnerStarted: false,
     lastProgressSignature: null,
     lastProgressHeartbeatAt: 0,
-    lastStatusHeartbeatAt: 0
+    lastStatusHeartbeatAt: 0,
+    verbose: debug
   };
   const status = await client2.runs.tail(runId, {
     onEvent: jsonLines ? (event) => {
@@ -22707,7 +22732,20 @@ async function handleRunTail(args) {
         })}
 `
       );
-    } : compact && !jsonOutput ? (event) => {
+    } : compact || debug ? (event) => {
+      if (debug) {
+        for (const line of getLogLinesFromLiveEvent(event)) {
+          const formatted = formatPlayLogLine(
+            line,
+            void 0,
+            compactState
+          );
+          if (formatted) process.stderr.write(`${formatted}
+`);
+          compactState.lastLogIndex += 1;
+        }
+      }
+      if (!compact || jsonOutput) return;
       const transition = getStepTransitionLineFromLiveEvent(
         event,
         compactState
@@ -22730,7 +22768,7 @@ async function handleRunTail(args) {
       }
     } : void 0,
     // Human mode only: in --json mode emit nothing non-protocol.
-    onReconnect: jsonOutput ? void 0 : ({ reason }) => {
+    onReconnect: jsonOutput && !debug ? void 0 : ({ reason }) => {
       process.stderr.write(
         `[runs tail] stream ended without a terminal status; reconnecting to run ${runId} (${reason})
 `
@@ -22746,7 +22784,7 @@ async function handleRunTail(args) {
   return status.status === "failed" ? 1 : 0;
 }
 async function handleRunLogs(args) {
-  const usage = "Usage: deepline runs logs <run-id> [--limit 200] [--failed] [--out run.log] [--json]";
+  const usage = "Usage: deepline runs logs <run-id> [--limit 200] [--failed] [--out run.log] [--json] [--debug]";
   let runId;
   try {
     runId = parseRunIdPositional(args, usage);
@@ -22759,12 +22797,20 @@ async function handleRunLogs(args) {
   const failed = args.includes("--failed");
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
+    if (arg === "--debug" || arg === "--logs" || arg === "--json" || arg === "--failed") {
+      continue;
+    }
     if (arg === "--limit" && args[index + 1]) {
       limit = parsePositiveInteger3(args[++index], "--limit");
       continue;
     }
     if (arg === "--out" && args[index + 1]) {
       outPath = resolve11(args[++index]);
+      continue;
+    }
+    if (arg.startsWith("--")) {
+      console.error(`${arg} is not supported by deepline runs logs.`);
+      return 1;
     }
   }
   if (failed && outPath) {
@@ -24237,9 +24283,9 @@ 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(
     "--run-id-file <path>",
     "Atomically write the accepted run id to a new JSON file"
-  ).option(
-    "--logs",
-    "When output is non-interactive, stream play logs to stderr while waiting"
+  ).option("--logs", "Compatibility alias for --debug").option(
+    "--debug [value]",
+    "Stream complete customer-safe runtime logs when passed without a value; otherwise pass input.debug"
   ).option("--tail-timeout-ms <ms>", "Timeout while watching the run stream").option("--force", "Start a fresh run graph").option(
     "--force-tool-refresh",
     "Refresh completed tool receipts; may repeat billed provider calls"
@@ -24288,6 +24334,7 @@ Pass-through input flags:
       ...options.runIdFile ? ["--run-id-file", options.runIdFile] : [],
       ...options.watch || options.wait ? ["--watch"] : [],
       ...options.logs ? ["--logs"] : [],
+      ...options.debug === true ? ["--debug"] : typeof options.debug === "string" ? ["--debug", options.debug] : [],
       ...options.tailTimeoutMs ? ["--tail-timeout-ms", options.tailTimeoutMs] : [],
       ...options.force ? ["--force"] : [],
       ...options.forceToolRefresh ? ["--force-tool-refresh"] : [],
@@ -24705,11 +24752,13 @@ Notes:
   logs for persisted log history. In human output, --compact prints deduplicated
   step transitions and progress instead of the full event stream. --json emits
   one terminal package. --jsonl emits canonical live events as JSON Lines and
-  ends with the same compact package shape as runs get --json.
+  ends with the same compact package shape as runs get --json. Use --debug
+  (or legacy --logs) to also print customer-safe runtime log lines to stderr.
 
 Examples:
   deepline runs tail play/my-play/run/20260501t000000-000
   deepline runs tail play/my-play/run/20260501t000000-000 --compact
+  deepline runs tail play/my-play/run/20260501t000000-000 --debug
   deepline runs tail play/my-play/run/20260501t000000-000 --jsonl
 `
   ).option("--json", "Emit one terminal JSON package after the run completes").option(
@@ -24718,12 +24767,17 @@ Examples:
   ).option(
     "--compact",
     "Show deduplicated human step transitions and progress"
+  ).option("--logs", "Compatibility alias for --debug").option(
+    "--debug",
+    "Print customer-safe runtime log lines to stderr while tailing"
   ).action(async (runId, options) => {
     process.exitCode = await handleRunTail([
       runId,
       ...options.json ? ["--json"] : [],
       ...options.jsonl ? ["--jsonl"] : [],
-      ...options.compact ? ["--compact"] : []
+      ...options.compact ? ["--compact"] : [],
+      ...options.logs ? ["--logs"] : [],
+      ...options.debug ? ["--debug"] : []
     ]);
   });
   runs.command("logs <runId>").description("Fetch persisted logs for a play run.").addHelpText(
@@ -24731,24 +24785,31 @@ Examples:
     `
 Notes:
   Prints a bounded recent log preview by default. Use --out to write the full
-  persisted log stream to a local file.
+  persisted log stream to a local file. --debug (or legacy --logs) is accepted
+  for script parity; this command already returns the unfiltered durable stream.
 
 Examples:
   deepline runs logs play/my-play/run/20260501t000000-000
   deepline runs logs play/my-play/run/20260501t000000-000 --limit 500
   deepline runs logs play/my-play/run/20260501t000000-000 --failed --json
+  deepline runs logs play/my-play/run/20260501t000000-000 --debug
   deepline runs logs play/my-play/run/20260501t000000-000 --out run.log --json
 `
   ).option(
     "--limit <count>",
     "Maximum recent log lines to print without --out",
     "200"
-  ).option("--out <path>", "Write the full persisted log stream to a file").option("--failed", "Show the bounded terminal-failure log window").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (runId, options) => {
+  ).option("--out <path>", "Write the full persisted log stream to a file").option("--failed", "Show the bounded terminal-failure log window").option("--logs", "Compatibility alias for --debug").option(
+    "--debug",
+    "Explicitly request the same persisted log view (no provenance filtering)"
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (runId, options) => {
     process.exitCode = await handleRunLogs([
       runId,
       ...options.limit ? ["--limit", options.limit] : [],
       ...options.out ? ["--out", options.out] : [],
       ...options.failed ? ["--failed"] : [],
+      ...options.logs ? ["--logs"] : [],
+      ...options.debug ? ["--debug"] : [],
       ...options.json ? ["--json"] : []
     ]);
   });

package/dist/index.js

@@ -832,7 +832,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.64",
+  version: "0.3.66",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/index.mjs

@@ -744,7 +744,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.64",
+  version: "0.3.66",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/install-integrity.json

@@ -41,6 +41,7 @@
     "dist/bundling-sources/shared_libs/play-data-plane/sheet-contract.ts",
     "dist/bundling-sources/shared_libs/play-runtime/activity-observation.ts",
     "dist/bundling-sources/shared_libs/play-runtime/app-runtime-api.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/async-operation.ts",
     "dist/bundling-sources/shared_libs/play-runtime/auth-scope-resolver.ts",
     "dist/bundling-sources/shared_libs/play-runtime/backend.ts",
     "dist/bundling-sources/shared_libs/play-runtime/batch-runtime.ts",
@@ -187,6 +188,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/step-program-dataset-builder.ts",
     "dist/bundling-sources/shared_libs/play-runtime/submit-limits.ts",
     "dist/bundling-sources/shared_libs/play-runtime/suspension.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/test-async-batching.ts",
     "dist/bundling-sources/shared_libs/play-runtime/test-runtime-seams.ts",
     "dist/bundling-sources/shared_libs/play-runtime/tool-batch-executor.ts",
     "dist/bundling-sources/shared_libs/play-runtime/tool-cache-policy.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.64",
+  "version": "0.3.66",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",