deepline 0.3.407 → 0.3.409

package/dist/cli/{chunk-URWF7NGQ.js → chunk-5MLCBXXU.js}

@@ -2,14 +2,17 @@
 var CONVENTIONS = `
 [[cli:
 Conventions (apply to every command):
-  Output mode: readable text by default. --json prints JSON. tools execute
-    is the exception: it prints JSON; --output-format csv prints a readable
-    summary and writes the rows to a CSV file.
-  Streams: stdout carries only the command result. Progress, update notices,
-    skills-sync notes, and warnings go to stderr.
-  Piping JSON: pass --json only when a program parses the output, and parse
-    stdout alone. 2>&1 puts stderr text in front of the JSON, so the parse
-    fails and the real error is hidden; | head and | tail cut the document.
+  Output mode: readable text by default. Add --json for machine-readable
+    output: stdout is one JSON document, including errors and notices;
+    stderr stays empty. tools execute is the exception: it prints JSON;
+    --output-format csv prints a readable summary and writes the rows to a
+    CSV file.
+  Streams: without --json, stdout carries only the command result. Progress,
+    update notices, skills-sync notes, and warnings go to stderr.
+  Piping JSON: pass --json only when a program parses the output. Under
+    --json, usage errors are {ok:false,error:{code,message,details.help}}
+    and notices (update available, skills, auth) arrive in notices[];
+    | head and | tail cut the document.
   JSON envelope: most payloads include render.sections[].lines (the human
     summary as text), next.* (exact follow-up commands; run commands name
     them actions.*Cmd), and command_context.
@@ -269,13 +272,18 @@ When:
   reports a balance or insufficient-credits error.
 [[cli:
 Input:
-  No arguments. Prints one line, "Balance: N credits". --verbose adds
-  reservations and usage awaiting settlement; --json returns the full record.
+  No arguments. Prints the posted balance, spendable credits and pending
+  spending. --verbose adds exposure details; --json returns the full record.
 ]]
 [[cli:
 Output (JSON):
   balance (Deepline credits), balance_display, rough_usd_balance,
-  balance_status, and render.sections. The balance includes other activity
+  balance_status, posted_balance_credits, pending_spend_credits,
+  spendable_balance_credits, spendable_balance_status and render.sections.
+  The three credit amounts come from the same admission snapshot. Spendable
+  credits subtract pending spending; a partial exposure diagnostic is not
+  spendable capacity. Null/unavailable means complete capacity could not be read.
+  Spending limits can still block a funded call. The balance includes other activity
   in the workspace, so a before and after difference does not isolate one
   command; use billing usage for that.
 ]]
@@ -485,7 +493,8 @@ When:
 [[cli:
 Input:
   The tool id. Prints readable text by default; read that
-  form and pass --json only for a program. --pricing-only, --schema-only,
+  form and pass --json only for a program; stdout is then one JSON
+  document. --pricing-only, --schema-only,
   --examples-only, --getters-only print one section. --out <path> saves the
   output to a file. get is an alias of describe, and deepline describe <id>
   is the same read for a tool, a play, or a monitor type.
@@ -754,7 +763,8 @@ Cost:
     core: `
 Purpose:
   Inventory of saved and prebuilt plays, one bounded page at a time.[[cli: It is
-  the command that carries cost estimates.]]
+  the command that carries cost estimates.]][[mcp: Search returns Play summaries;
+  deepline_describe_play returns input/output schemas and CSV contracts.]]
 When:
 [[cli:
   To price a play before running it: plays list --show-cost, then read the
@@ -778,6 +788,12 @@ Output (JSON):
   next (the next-page command), render.sections with a "cost estimate:"
   line per play.
 ]]
+[[mcp:
+Output:
+  data[] with Play names, references, descriptions, ownership, and revision
+  metadata. Use deepline_describe_play for input/output schemas and CSV
+  contracts before running a Play.
+]]
 Cost:
   Free.
 [[cli:
@@ -815,6 +831,7 @@ When:
 Input:
   The play reference from search (prebuilt/... or <workspace>/...).
   --compact shortens schemas. --json prints JSON.
+  To parse the output, add --json; stdout is then one JSON document.
 ]]
 [[cli:
 Output (JSON):
@@ -943,7 +960,8 @@ Output (JSON, printed when the run ends):
   exact follow-up commands: getRunCmd, getFullRunCmd, getBillingCmd,
   getLogsCmd, exportDatasetCmds[], queryTableSqlCmds[]. Rows are not in this
   payload. Progress lines are printed while it waits; the JSON is the last
-  thing printed.
+  thing printed. To parse it, add --json: progress is suppressed and stdout
+  is one JSON document.
 ]]
 [[mcp:
 Output:
@@ -1168,6 +1186,7 @@ Input:
   billing and timeline (large). --log-failed attaches the failure log window.
   --input prints the original input (may contain customer data). --json
   prints JSON; --json run.status,datasets.name selects fields.
+  To parse the output (also with --full), add --json; stdout is then one JSON document.
 ]]
 [[cli:
 Output (JSON):
@@ -1254,6 +1273,7 @@ Input:
   returned more than one (default: the returned dataset, usually
   result.rows). --metadata-out <path.json> writes the export metadata. --json
   prints the receipt as JSON; it does not change the file format.
+  To parse the receipt, add --json; stdout is then one JSON document.
 ]]
 Output (JSON):
   csv_path or json_path (absolute), source, rowCount, columns[] (the CSV
@@ -1343,7 +1363,8 @@ Input:
 Output:
   Log lines (human) or a JSON envelope; with --out, the file path. Follow
   next.logs for the next page of events, and pass nextCursor to --cursor for
-  older text logs.
+  older text logs. To parse the output, add --json; stdout is then one JSON
+  document.
 ]]
 Cost:
   Free.

package/dist/cli/{chunk-XT6GG3QO.mjs → chunk-7AALNGTA.mjs}

@@ -3,15 +3,15 @@ import {
 } from "./chunk-LJ5747UC.mjs";
 import {
   DeeplineClient
-} from "./chunk-J67NU4MQ.mjs";
+} from "./chunk-PBZYY7VZ.mjs";
 import {
   printCommandEnvelope,
   renderCommandEnvelopeText
-} from "./chunk-BKC6VMYZ.mjs";
+} from "./chunk-JRAVVJ3T.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-ZBCTXQ3P.mjs";
+} from "./chunk-2PRO2JTX.mjs";
 
 // src/cli/commands/search.ts
 import { Option } from "commander";

package/dist/cli/{chunk-WJYPBHTE.js → chunk-ALD4COBH.js}

@@ -1,9 +1,10 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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 _class;// src/cli/progress.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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 _class;
+
+var _chunkYD7B53RWjs = require('./chunk-YD7B53RW.js');
+
+// src/cli/progress.ts
 var _worker_threads = require('worker_threads');
 var CliProgress = (_class = class {
-  constructor(enabled) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);_class.prototype.__init4.call(this);_class.prototype.__init5.call(this);_class.prototype.__init6.call(this);_class.prototype.__init7.call(this);
-    this.enabled = enabled;
-  }
   __init() {this.lastMessage = null}
   __init2() {this.interactive = Boolean(process.stderr.isTTY)}
   __init3() {this.grey = "\x1B[90m"}
@@ -11,6 +12,11 @@ var CliProgress = (_class = class {
   __init5() {this.dim = "\x1B[2m"}
   __init6() {this.reset = "\x1B[0m"}
   __init7() {this.worker = null}
+  
+  // --json output is one JSON document: progress never renders under it.
+  constructor(enabled) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);_class.prototype.__init4.call(this);_class.prototype.__init5.call(this);_class.prototype.__init6.call(this);_class.prototype.__init7.call(this);
+    this.enabled = enabled && !_chunkYD7B53RWjs.isJsonOutputMode.call(void 0, );
+  }
   phase(message) {
     if (!this.enabled || this.lastMessage === message) {
       return;
@@ -34,6 +40,7 @@ var CliProgress = (_class = class {
     this.settle("\u2717");
   }
   writeLogLine(line) {
+    if (_chunkYD7B53RWjs.isJsonOutputMode.call(void 0, )) return;
     if (!this.enabled) {
       process.stderr.write(`${line}
 `);

package/dist/cli/{chunk-RZLXVHNO.js → chunk-AU4OFDFX.js}

@@ -2,10 +2,10 @@
 
 
 
-var _chunkD2ZRMZKFjs = require('./chunk-D2ZRMZKF.js');
+var _chunkYD7B53RWjs = require('./chunk-YD7B53RW.js');
 
 
-var _chunkTHHM4DPEjs = require('./chunk-THHM4DPE.js');
+var _chunkFJCIUF34js = require('./chunk-FJCIUF34.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 } = _chunkD2ZRMZKFjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkYD7B53RWjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     `/api/v2/play-projects${options.all ? "?includeDisabled=1" : ""}`
   );
-  _chunkD2ZRMZKFjs.printCommandEnvelope.call(void 0, 
+  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
     {
       projects: payload.projects,
       count: payload.projects.length,
@@ -73,7 +73,7 @@ function describeInstallationStatus(installation) {
   }
 }
 async function handleStatus(options) {
-  const { http } = _chunkD2ZRMZKFjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkYD7B53RWjs.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) {
       )
     );
   }
-  _chunkD2ZRMZKFjs.printCommandEnvelope.call(void 0, 
+  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
     {
       installation,
       installations: _nullishCoalesce(payload.installations, () => ( [])),
@@ -147,10 +147,10 @@ async function handleStatus(options) {
   );
 }
 async function handleRepos(options) {
-  const { http } = _chunkD2ZRMZKFjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkYD7B53RWjs.getAuthedHttpClient.call(void 0, );
   const query = options.installation ? `?installationId=${encodeURIComponent(options.installation)}` : "";
   const payload = await http.get(`/api/v2/github/repos${query}`);
-  _chunkD2ZRMZKFjs.printCommandEnvelope.call(void 0, 
+  _chunkYD7B53RWjs.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 } = _chunkD2ZRMZKFjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkYD7B53RWjs.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 } = _chunkD2ZRMZKFjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkYD7B53RWjs.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 } : {}
   });
-  _chunkD2ZRMZKFjs.printCommandEnvelope.call(void 0, 
+  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -220,11 +220,11 @@ async function handleLink(repo, options) {
   );
 }
 async function handleGet(id, options) {
-  const { http } = _chunkD2ZRMZKFjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkYD7B53RWjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     `/api/v2/play-projects/${encodeURIComponent(id)}`
   );
-  _chunkD2ZRMZKFjs.printCommandEnvelope.call(void 0, 
+  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -240,7 +240,7 @@ async function handleGet(id, options) {
   );
 }
 async function handleSet(id, options) {
-  const { http } = _chunkD2ZRMZKFjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkYD7B53RWjs.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 } : {}
     }
   );
-  _chunkD2ZRMZKFjs.printCommandEnvelope.call(void 0, 
+  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -264,9 +264,9 @@ async function handleSet(id, options) {
   );
 }
 async function handleUnlink(id, options) {
-  const { http } = _chunkD2ZRMZKFjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkYD7B53RWjs.getAuthedHttpClient.call(void 0, );
   await http.delete(`/api/v2/play-projects/${encodeURIComponent(id)}`);
-  _chunkD2ZRMZKFjs.printCommandEnvelope.call(void 0, 
+  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       id,
@@ -286,10 +286,10 @@ async function handleUnlink(id, options) {
   );
 }
 async function handleConnect(options) {
-  const baseUrl = _chunkTHHM4DPEjs.resolveBaseUrlOnly.call(void 0, );
+  const baseUrl = _chunkFJCIUF34js.resolveBaseUrlOnly.call(void 0, );
   const connectUrl = `${baseUrl.replace(/\/$/, "")}/api/v2/github/connect`;
-  const opened = _chunkD2ZRMZKFjs.openInBrowser.call(void 0, connectUrl);
-  _chunkD2ZRMZKFjs.printCommandEnvelope.call(void 0, 
+  const opened = _chunkYD7B53RWjs.openInBrowser.call(void 0, connectUrl);
+  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
     {
       connectUrl,
       browser: opened,
@@ -311,7 +311,7 @@ async function handleConnect(options) {
   );
 }
 async function handleDeploymentsList(options) {
-  const { http } = _chunkD2ZRMZKFjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkYD7B53RWjs.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}`
   );
-  _chunkD2ZRMZKFjs.printCommandEnvelope.call(void 0, 
+  _chunkYD7B53RWjs.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 } = _chunkD2ZRMZKFjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkYD7B53RWjs.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));
-  _chunkD2ZRMZKFjs.printCommandEnvelope.call(void 0, 
+  _chunkYD7B53RWjs.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 } = _chunkD2ZRMZKFjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkYD7B53RWjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.post(`/api/v2/deployments/${encodeURIComponent(id)}/cancel`, {});
-  _chunkD2ZRMZKFjs.printCommandEnvelope.call(void 0, 
+  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
     {
       cancelled: payload.cancelled,
       deployment: payload.deployment,

package/dist/cli/{chunk-N6OAMAO5.mjs → chunk-BEVLCKXG.mjs}

@@ -1,6 +1,6 @@
 import {
   resolveShellSpawn
-} from "./chunk-4TV43THC.mjs";
+} from "./chunk-IT3XBJQR.mjs";
 
 // src/cli/npm-script-policy.ts
 import { spawnSync } from "child_process";

package/dist/cli/{chunk-7LKYHZVB.js → chunk-DEC3JECC.js}

@@ -49,7 +49,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.407",
+  version: "0.3.409",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1,

package/dist/cli/{chunk-UFFSOV6I.mjs → chunk-FHPCKULR.mjs}

@@ -2,7 +2,7 @@ import {
   argsWantJson,
   openInBrowser,
   printCommandEnvelope
-} from "./chunk-BKC6VMYZ.mjs";
+} from "./chunk-JRAVVJ3T.mjs";
 import {
   ACTIVE_ORG_ID_ENV,
   ACTIVE_ORG_NAME_ENV,
@@ -25,7 +25,7 @@ import {
   saveHostEnvValues,
   saveProjectDeeplineEnvValues,
   storedHostApiKey
-} from "./chunk-ZBCTXQ3P.mjs";
+} from "./chunk-2PRO2JTX.mjs";
 
 // src/cli/commands/auth.ts
 import {

package/dist/cli/{chunk-THHM4DPE.js → chunk-FJCIUF34.js}

@@ -17,7 +17,7 @@ var _chunkXNYIZMNQjs = require('./chunk-XNYIZMNQ.js');
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
 
 
-var _chunk7LKYHZVBjs = require('./chunk-7LKYHZVB.js');
+var _chunkDEC3JECCjs = require('./chunk-DEC3JECC.js');
 
 // src/config.ts
 
@@ -649,9 +649,9 @@ function resolveCliCommandContext(inputConfig, requestedScope) {
 }
 
 // src/version.ts
-var SDK_VERSION = _chunk7LKYHZVBjs.SDK_RELEASE.version;
-var SDK_API_MAJOR = _chunk7LKYHZVBjs.SDK_RELEASE.contracts.api.currentMajor;
-var SDK_API_CONTRACT = _nullishCoalesce(_chunk7LKYHZVBjs.SDK_RELEASE.contracts.api.legacyWireIds[0], () => ( `api-v${SDK_API_MAJOR}`));
+var SDK_VERSION = _chunkDEC3JECCjs.SDK_RELEASE.version;
+var SDK_API_MAJOR = _chunkDEC3JECCjs.SDK_RELEASE.contracts.api.currentMajor;
+var SDK_API_CONTRACT = _nullishCoalesce(_chunkDEC3JECCjs.SDK_RELEASE.contracts.api.legacyWireIds[0], () => ( `api-v${SDK_API_MAJOR}`));
 
 // src/agent-runtime.ts
 

package/dist/cli/{chunk-H6EWQFPQ.js → chunk-GAICVLKL.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 _chunkY6CX4QPRjs = require('./chunk-Y6CX4QPR.js');
+var _chunkWLOCMJWVjs = require('./chunk-WLOCMJWV.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 = _chunkY6CX4QPRjs.resolveShellSpawn.call(void 0, "npm", ["--version"], process.platform, env);
+    const plan = _chunkWLOCMJWVjs.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-4TV43THC.mjs → chunk-IT3XBJQR.mjs}

@@ -1,9 +1,9 @@
 import {
   getActiveCliProgress
-} from "./chunk-GAMFK2ZP.mjs";
+} from "./chunk-44ZTYHMQ.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-BKC6VMYZ.mjs";
+} from "./chunk-JRAVVJ3T.mjs";
 import {
   DEFAULT_SKILL_AGENTS,
   KNOWN_SKILL_AGENTS,
@@ -22,13 +22,13 @@ import {
   sdkCliStateDirPath,
   skillsAgentPathSegment,
   writeSdkSkillsLocalVersion
-} from "./chunk-ZBCTXQ3P.mjs";
+} from "./chunk-2PRO2JTX.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-UPEOEYZ3.mjs";
+} from "./chunk-TQNHMWUR.mjs";
 
 // src/cli/commands/skills.ts
 import { spawn as spawn2 } from "child_process";

package/dist/cli/{chunk-UFS752TU.mjs → chunk-J6DCKJNM.mjs}

@@ -1,3 +1,7 @@
+import {
+  writeRawStderr
+} from "./chunk-JRAVVJ3T.mjs";
+
 // src/cli/trace.ts
 var cliTraceStartedAt = Date.now();
 function isTruthyEnv(value) {
@@ -17,7 +21,7 @@ function recordCliTrace(event) {
     sinceStartMs: now - cliTraceStartedAt,
     ...event
   };
-  process.stderr.write(`[cli-trace] ${JSON.stringify(payload)}
+  writeRawStderr(`[cli-trace] ${JSON.stringify(payload)}
 `);
 }
 async function traceCliSpan(phase, fields, run) {

package/dist/cli/{chunk-AYHLUHE5.js → chunk-JGHG4NBA.js}

@@ -1,4 +1,8 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/cli/trace.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkYD7B53RWjs = require('./chunk-YD7B53RW.js');
+
+// src/cli/trace.ts
 var cliTraceStartedAt = Date.now();
 function isTruthyEnv(value) {
   return value === "1" || value === "true" || value === "yes";
@@ -17,7 +21,7 @@ function recordCliTrace(event) {
     sinceStartMs: now - cliTraceStartedAt,
     ...event
   };
-  process.stderr.write(`[cli-trace] ${JSON.stringify(payload)}
+  _chunkYD7B53RWjs.writeRawStderr.call(void 0, `[cli-trace] ${JSON.stringify(payload)}
 `);
 }
 async function traceCliSpan(phase, fields, run) {

package/dist/cli/{chunk-BKC6VMYZ.mjs → chunk-JRAVVJ3T.mjs}

@@ -3,7 +3,7 @@ import {
   detectAgentRuntime,
   resolveCliCommandContext,
   resolveConfig
-} from "./chunk-ZBCTXQ3P.mjs";
+} from "./chunk-2PRO2JTX.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,