deepline 0.3.406 → 0.3.408

package/dist/cli/{chunk-5IGBBYXH.mjs → chunk-4CFULMRB.mjs}

@@ -3,7 +3,7 @@ import {
   detectAgentRuntime,
   resolveCliCommandContext,
   resolveConfig
-} from "./chunk-CGX4NSS3.mjs";
+} from "./chunk-SD7MXAJA.mjs";
 import {
   DeeplineError,
   serializeToolExecutionFailure
@@ -118,6 +118,68 @@ function describeArgs(target, options) {
   ];
 }
 
+// src/cli/json-mode.ts
+var ANSI_PATTERN = /\x1b\[[0-9;?]*[A-Za-z]|\r/g;
+var installed = false;
+var pending = [];
+var rawStderrWrite = null;
+var stdoutWritten = false;
+function isJsonOutputMode() {
+  return process.argv.includes("--json");
+}
+function installJsonStderrGuard() {
+  if (installed || !isJsonOutputMode()) return;
+  installed = true;
+  rawStderrWrite = process.stderr.write.bind(process.stderr);
+  const stdoutWrite = process.stdout.write.bind(process.stdout);
+  process.stdout.write = ((...args) => {
+    stdoutWritten = true;
+    return stdoutWrite(...args);
+  });
+  const capture = (chunk) => {
+    const text = (typeof chunk === "string" ? chunk : chunk instanceof Uint8Array ? Buffer.from(chunk).toString("utf8") : String(chunk)).replace(ANSI_PATTERN, "").trim();
+    if (text) pending.push(text);
+  };
+  process.stderr.write = ((chunk, ...rest) => {
+    capture(chunk);
+    const callback = rest.find((arg) => typeof arg === "function");
+    callback?.();
+    return true;
+  });
+  const toNotice = (...args) => capture(
+    args.map(
+      (arg) => typeof arg === "string" ? arg : arg instanceof Error ? arg.message : JSON.stringify(arg)
+    ).join(" ")
+  );
+  console.error = toNotice;
+  console.warn = toNotice;
+}
+function addJsonNotice(notice) {
+  if (installed) pending.push(notice);
+}
+function writeRawStderr(text) {
+  (rawStderrWrite ?? process.stderr.write.bind(process.stderr))(text);
+}
+function takeSilentJsonFailureMessage(exitCode) {
+  if (!installed || stdoutWritten || !exitCode || Number(exitCode) === 0) {
+    return null;
+  }
+  const index = pending.findIndex((notice) => typeof notice === "string");
+  if (index === -1) return "Command failed without an error message.";
+  const [message] = pending.splice(index, 1);
+  return message;
+}
+function withJsonNotices(value) {
+  if (pending.length === 0 || value === null || typeof value !== "object" || Array.isArray(value)) {
+    return value;
+  }
+  const record = value;
+  const existing = Array.isArray(record.notices) ? record.notices : [];
+  const notices = [...existing, ...pending];
+  pending = [];
+  return { ...record, notices };
+}
+
 // src/cli/utils.ts
 import { createHash } from "crypto";
 import {
@@ -821,13 +883,15 @@ function withAgentCommandContext(value) {
 }
 function printJson(value, fields) {
   process.stdout.write(
-    `${JSON.stringify(selectJsonFields(withAgentCommandContext(value), fields), null, 2)}
+    `${JSON.stringify(withJsonNotices(selectJsonFields(withAgentCommandContext(value), fields)), null, 2)}
 `
   );
 }
 function printCompactJson(value) {
-  process.stdout.write(`${JSON.stringify(withAgentCommandContext(value))}
-`);
+  process.stdout.write(
+    `${JSON.stringify(withJsonNotices(withAgentCommandContext(value)))}
+`
+  );
 }
 function cliToolExecutionFailure(error) {
   const failure = serializeToolExecutionFailure(error);
@@ -976,6 +1040,11 @@ export {
   parseJsonFields,
   jsonFieldArgs,
   describeArgs,
+  isJsonOutputMode,
+  installJsonStderrGuard,
+  addJsonNotice,
+  writeRawStderr,
+  takeSilentJsonFailureMessage,
   getAuthedHttpClient,
   openInBrowser,
   sleep,

package/dist/cli/{chunk-OPHLT4TM.mjs → chunk-4QFT5LGV.mjs}

@@ -1,10 +1,10 @@
 import {
   getAuthedHttpClient,
   printCommandEnvelope
-} from "./chunk-5IGBBYXH.mjs";
+} from "./chunk-4CFULMRB.mjs";
 import {
   agentSessionIdFromEnvironment
-} from "./chunk-CGX4NSS3.mjs";
+} from "./chunk-SD7MXAJA.mjs";
 
 // src/cli/commands/sessions.ts
 import {

package/dist/cli/{chunk-W2BAO4OR.js → chunk-4RNDKFNQ.js}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkKPU53YBBjs = require('./chunk-KPU53YBB.js');
+var _chunk2XXXFPTDjs = require('./chunk-2XXXFPTD.js');
 
 // src/cli/npm-script-policy.ts
 var _child_process = require('child_process');
@@ -13,7 +13,7 @@ function npmSupportsAllowScripts(version) {
 }
 function readNpmVersion(env) {
   try {
-    const plan = _chunkKPU53YBBjs.resolveShellSpawn.call(void 0, "npm", ["--version"], process.platform, env);
+    const plan = _chunk2XXXFPTDjs.resolveShellSpawn.call(void 0, "npm", ["--version"], process.platform, env);
     const result = _child_process.spawnSync.call(void 0, plan.command, plan.args, {
       encoding: "utf8",
       env,

package/dist/cli/{chunk-GAMFK2ZP.mjs → chunk-67RWR34T.mjs}

@@ -1,9 +1,10 @@
+import {
+  isJsonOutputMode
+} from "./chunk-4CFULMRB.mjs";
+
 // src/cli/progress.ts
 import { Worker } from "worker_threads";
 var CliProgress = class {
-  constructor(enabled) {
-    this.enabled = enabled;
-  }
   lastMessage = null;
   interactive = Boolean(process.stderr.isTTY);
   grey = "\x1B[90m";
@@ -11,6 +12,11 @@ var CliProgress = class {
   dim = "\x1B[2m";
   reset = "\x1B[0m";
   worker = null;
+  enabled;
+  // --json output is one JSON document: progress never renders under it.
+  constructor(enabled) {
+    this.enabled = enabled && !isJsonOutputMode();
+  }
   phase(message) {
     if (!this.enabled || this.lastMessage === message) {
       return;
@@ -34,6 +40,7 @@ var CliProgress = class {
     this.settle("\u2717");
   }
   writeLogLine(line) {
+    if (isJsonOutputMode()) return;
     if (!this.enabled) {
       process.stderr.write(`${line}
 `);

package/dist/cli/{chunk-APLRSERF.js → chunk-AUMD2VXP.js}

@@ -24,7 +24,7 @@ var _chunkKXMNM4AQjs = require('./chunk-KXMNM4AQ.js');
 
 
 
-var _chunkYSAZVLJDjs = require('./chunk-YSAZVLJD.js');
+var _chunkQUAQX3FQjs = require('./chunk-QUAQX3FQ.js');
 
 
 var _chunkQ2E4E4FJjs = require('./chunk-Q2E4E4FJ.js');
@@ -2889,8 +2889,8 @@ function runtimeSelectionHeaders(runtime, env) {
   }
   const receivers = _optionalChain([env, 'access', _97 => _97.DEEPLINE_RUNTIME_RETAINED_PIPELINE_RECEIVERS, 'optionalAccess', _98 => _98.trim, 'call', _99 => _99()]);
   return {
-    [_chunkYSAZVLJDjs.RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token,
-    ...receivers ? { [_chunkYSAZVLJDjs.RETAINED_PIPELINE_RECEIVERS_HEADER]: receivers } : {}
+    [_chunkQUAQX3FQjs.RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token,
+    ...receivers ? { [_chunkQUAQX3FQjs.RETAINED_PIPELINE_RECEIVERS_HEADER]: receivers } : {}
   };
 }
 function isolatedCiRuntimeEventReadHeaders(env) {
@@ -2906,7 +2906,7 @@ function isolatedCiRuntimeEventReadHeaders(env) {
       "RUNTIME_EVENT_INTERNAL_TOKEN_REQUIRED"
     );
   }
-  return { [_chunkYSAZVLJDjs.COORDINATOR_INTERNAL_TOKEN_HEADER]: token };
+  return { [_chunkQUAQX3FQjs.COORDINATOR_INTERNAL_TOKEN_HEADER]: token };
 }
 function normalizeTestPolicyOverrides(value, source) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
@@ -3197,9 +3197,9 @@ var DeeplineClient = (_class = class _DeeplineClient {
    * @throws {@link ConfigError} if no API key can be resolved from any source.
    */
   constructor(options) {
-    this.config = _chunkYSAZVLJDjs.resolveConfig.call(void 0, options);
+    this.config = _chunkQUAQX3FQjs.resolveConfig.call(void 0, options);
     this.environment = _nullishCoalesce(this.config.environment, () => ( process.env));
-    this.http = new (0, _chunkYSAZVLJDjs.HttpClient)(this.config);
+    this.http = new (0, _chunkQUAQX3FQjs.HttpClient)(this.config);
     this.toolCalls = new ToolCalls(
       this.http,
       this.config.timeout,
@@ -3432,8 +3432,8 @@ var DeeplineClient = (_class = class _DeeplineClient {
   /**
    * Search available tools using Deepline's ranked backend search.
    *
-   * This is the same discovery surface used by the CLI: it ranks across
-   * tool metadata, categories, agent guidance, and input schema fields.
+   * The CLI uses the same search.
+   * The search ranks tool metadata, categories, agent guidance, and input schema fields.
    */
   async searchTools(options = {}) {
     return this.http.get(
@@ -3498,13 +3498,12 @@ var DeeplineClient = (_class = class _DeeplineClient {
   /**
    * Describe a Deepline Agent model and its provider-specific option surface.
    *
-   * Combines live AI Gateway model metadata with Deepline's generated AI SDK
-   * provider option registry so agents can construct `providerOptions`
-   * payloads before executing `deeplineagent`.
+   * The method combines live AI Gateway model metadata with Deepline's generated registry of AI SDK provider options.
+   * Agents can use this information to construct `providerOptions` payloads before they execute `deeplineagent`.
    *
-   * The returned option schemas describe accepted provider option shapes, not
-   * guaranteed support for every model. Runtime AI SDK/Gateway errors remain
-   * authoritative for model-gated values.
+   * The returned schemas describe accepted shapes for provider options.
+   * These schemas do not guarantee that every model supports each option.
+   * Runtime AI SDK and Gateway errors determine support for model-specific values.
    *
    * @param model - Exact-case Gateway model id such as `"openai/gpt-5.6-luna"`
    * @returns Model metadata, provider option shapes, and runnable examples
@@ -3520,8 +3519,8 @@ var DeeplineClient = (_class = class _DeeplineClient {
   /**
    * Quote dynamic AI inference pricing for a concrete payload.
    *
-   * The result separates a planning estimate from a proven authorization
-   * maximum and contains Deepline credits only.
+   * The result contains a planning estimate and a separate, proven authorization maximum.
+   * Both values use Deepline credits.
    */
   async quoteInferenceTool(toolId, payload) {
     return this.http.post(
@@ -3596,13 +3595,16 @@ var DeeplineClient = (_class = class _DeeplineClient {
    * entrypoints: the CLI, {@link Deepline.connect}, {@link submitPlay},
    * or {@link runPlay}.
    *
-   * Supported invocation surfaces intentionally share this same run contract:
-   * `deepline plays run`, repo scripts such as `bun run deepline -- plays run`,
-   * SDK context calls like `Deepline.connect().play(name).run()`, and direct
-   * `POST /api/v2/plays/run` calls all return a workflow/run id. The completed
-   * output is always retrievable from `getPlayStatus(runId).result` (or from
-   * `PlayJob.get()` for SDK context calls). Execution logs live under
-   * `progress.logs`; they are not part of the user output object.
+   * These interfaces share the run contract and return a workflow or run ID:
+   *
+   * - `deepline plays run`.
+   * - Repository scripts such as `bun run deepline -- plays run`.
+   * - SDK context calls such as `Deepline.connect().play(name).run()`.
+   * - Direct `POST /api/v2/plays/run` calls.
+   *
+   * Read completed output from `getPlayStatus(runId).result`.
+   * For SDK context calls, read output from `PlayJob.get()`.
+   * Execution logs appear under `progress.logs`. The user output object does not contain these logs.
    *
    * @param request - Play run configuration (name, code, input, etc.)
    * @returns Run metadata including the public `workflowId`
@@ -3767,9 +3769,8 @@ var DeeplineClient = (_class = class _DeeplineClient {
   /**
    * Compile a bundled play artifact into the server-side compiler manifest.
    *
-   * The manifest records imports, trigger bindings, static pipeline shape, and
-   * runtime metadata needed before a play artifact can be checked, registered,
-   * or run.
+   * The manifest records imports, trigger bindings, static pipeline shape, and runtime metadata.
+   * The compiler needs these records before it checks, registers, or runs a Play artifact.
    */
   async compilePlayManifest(input) {
     const retryDelays = COMPILE_MANIFEST_RETRY_DELAYS_MS.slice(
@@ -3816,8 +3817,8 @@ var DeeplineClient = (_class = class _DeeplineClient {
   /**
    * Register an already-bundled play artifact and start a run from it.
    *
-   * This is the low-level file-backed run path used by SDK/CLI packaging
-   * wrappers after local bundling has produced the runtime artifact.
+   * SDK and CLI packaging wrappers use this low-level run method for file-based Plays.
+   * Local bundling must produce the runtime artifact first.
    */
   async startPlayRunFromBundle(input) {
     const compilerManifest = await _asyncNullishCoalesce(input.compilerManifest, async () => ( await this.compilePlayManifest({
@@ -3855,15 +3856,15 @@ var DeeplineClient = (_class = class _DeeplineClient {
   /**
    * Register a bundled play artifact and start a run from the live revision.
    *
-   * Convenience wrapper around {@link registerPlayArtifact} plus
-   * {@link startPlayRun}. This is the canonical file-backed path used by wrappers.
-   * The returned id can be passed to {@link getPlayStatus} to retrieve the same
-   * durable `{ result }` object that the CLI prints after `plays run` completes.
+   * This method wraps {@link registerPlayArtifact} and {@link startPlayRun}.
+   * Packaging wrappers use this method for file-based Plays.
+   * Pass the returned ID to {@link getPlayStatus}.
+   * The method returns the same durable `{ result }` object that the CLI prints after `plays run` completes.
    *
-   * @param code - Source string fallback; the bundled artifact should be passed in `options.artifact`
-   * @param csvPath - Path to input CSV file, or `null`
-   * @param name - Play name (extracted from source if omitted)
-   * @param options - Additional submission options
+   * @param code - Fallback source string. Pass the bundled artifact in `options.artifact`.
+   * @param csvPath - Path to the input CSV file, or `null`.
+   * @param name - Play name. The SDK derives it from the source when omitted.
+   * @param options - Additional submission options.
    * @returns Workflow metadata with `workflowId`
    *
    * @example
@@ -3956,9 +3957,8 @@ var DeeplineClient = (_class = class _DeeplineClient {
   /**
    * Mint short-lived presigned upload targets for staged play files.
    *
-   * Internal primitive used by {@link stagePlayFiles}. The server returns an
-   * already-staged ref (no upload needed) for content-addressed files it
-   * already holds, or a presigned PUT URL the caller uploads the body to.
+   * Internal primitive used by {@link stagePlayFiles}. For a content-addressed file already in storage, the server returns a staged reference. That file needs no upload.
+   * For other files, the server returns a presigned PUT URL. Upload the file body to that URL.
    */
   async mintStagedPlayFileUploads(files) {
     return _chunkUHNDVD3Pjs.mintStagedPlayFileUploads.call(void 0, this.http, files);
@@ -3966,8 +3966,7 @@ var DeeplineClient = (_class = class _DeeplineClient {
   /**
    * Resolve staged play files by content hash without uploading bytes.
    *
-   * Missing files are returned so callers can upload only the files the server
-   * does not already have.
+   * The response identifies missing files. Callers need to upload only these files.
    */
   async resolveStagedPlayFiles(files) {
     return this.http.post("/api/v2/plays/files/stage", { files });
@@ -4451,11 +4450,11 @@ var DeeplineClient = (_class = class _DeeplineClient {
   /**
    * Start a fresh run from a prior run's retained input and pinned revision.
    *
-   * Every invocation sends an `Idempotency-Key`. When the caller does not
-   * supply one, a fresh key is generated once per call so the transport's own
-   * network retries converge on a single rerun. Pass the same explicit key
-   * across separate invocations to repeat an ambiguous result safely; a
-   * different key intentionally starts another rerun.
+   * Every invocation sends an `Idempotency-Key`.
+   * When the caller supplies no key, the SDK creates a fresh key once per call.
+   * The transport reuses that key for network retries, so those retries produce one rerun.
+   * Reuse an explicit key across separate invocations when the previous result is uncertain.
+   * A different key starts another rerun.
    */
   async rerun(runId, options) {
     const idempotencyKey = _optionalChain([options, 'optionalAccess', _214 => _214.idempotencyKey, 'optionalAccess', _215 => _215.trim, 'call', _216 => _216()]);
@@ -4795,8 +4794,8 @@ var DeeplineClient = (_class = class _DeeplineClient {
     );
   }
   /**
-   * Stop every active run visible to the current workspace, or with
-   * `dryRun: true` enumerate the exact candidates without cancelling anything.
+   * Stop every active run visible to the current workspace.
+   * With `dryRun: true`, list the exact candidates without cancelling any run.
    *
    * This is the SDK equivalent of:
    *
@@ -4805,8 +4804,8 @@ var DeeplineClient = (_class = class _DeeplineClient {
    * deepline runs stop-all --reason "stale lock"
    * ```
    *
-   * Use this when a failed parent run left child or waiting runs active and you
-   * need to clear the workspace run-slot state without knowing each run id.
+   * Use this method when a failed parent leaves active child or waiting runs.
+   * The method clears workspace run-slot state without requiring each run ID.
    */
   async stopAllRuns(options) {
     const dryRun = _optionalChain([options, 'optionalAccess', _241 => _241.dryRun]) === true;
@@ -4827,8 +4826,8 @@ var DeeplineClient = (_class = class _DeeplineClient {
     return result;
   }
   /**
-   * List one page of callable plays; grep retains exhaustive matching results.
-   * Use listPlaysPage to retain pagination metadata.
+   * List one page of callable Plays. With grep, the method retains all matching results.
+   * Use listPlaysPage for pagination metadata.
    *
    * Pass `origin: "prebuilt"` for Deepline-managed prebuilts or
    * `origin: "owned"` for org-owned plays.
@@ -5265,8 +5264,7 @@ var DeeplineClient = (_class = class _DeeplineClient {
   /**
    * Get the full definition and state of a named play.
    *
-   * Returns the play's revision state (draft, live), recent runs,
-   * sheet processing summary, and database URL.
+   * The response includes revision state (draft or live), recent runs, a summary of sheet processing, and the database URL.
    *
    * @param name - Play name
    * @returns Complete play detail
@@ -5303,10 +5301,10 @@ var DeeplineClient = (_class = class _DeeplineClient {
   /**
    * Get a normalized play description suitable for agents and CLIs.
    *
-   * The description includes runnable examples, input/output summaries, clone
-   * guidance, revision state, and latest run metadata when available. Pass
-   * `{ pipeline: true }` to include the compiled pipeline, which can be
-   * hundreds of kilobytes and is otherwise left out.
+   * The description includes runnable examples, input and output summaries, clone guidance, and revision state.
+   * It also includes metadata for the latest run when available.
+   * Set `{ pipeline: true }` to include the compiled pipeline.
+   * The pipeline can be hundreds of kilobytes. The response omits it by default.
    */
   async describePlay(name, options = {}) {
     if (options.pipeline) {
@@ -5355,8 +5353,7 @@ var DeeplineClient = (_class = class _DeeplineClient {
    * Make a play revision live.
    *
    * When `revisionId` is omitted, the current working revision becomes live.
-   * The live version is what executes when the play is run by name without
-   * specifying an explicit revision.
+   * A call by Play name executes the live revision unless the caller specifies another revision.
    *
    * @param name - Play name
    * @param request - Optional explicit revision to make live
@@ -5615,9 +5612,9 @@ var DeeplineClient = (_class = class _DeeplineClient {
     return event;
   }
   /**
-   * What Deepline has billed each run so far (customer-visible credits, never
-   * provider spend) and whether any of its charges is still settling — the
-   * same read the dashboard's runs grid shows. `GET /api/v2/runs/billing`.
+   * Read Deepline credits billed to each run and whether charges are still settling.
+   * The response never shows provider spend. The dashboard runs grid uses the same read.
+   * HTTP endpoint: `GET /api/v2/runs/billing`.
    */
   async getRunBilling(runIds) {
     const params = new URLSearchParams();