deepline 0.3.406 → 0.3.408

package/dist/cli/{chunk-URWF7NGQ.js → chunk-J5PTX66Y.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.
@@ -815,6 +824,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 +953,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 +1179,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 +1266,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 +1356,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-7ZMVAV2B.mjs → chunk-LOYISF7S.mjs}

@@ -24,7 +24,7 @@ import {
   RETAINED_PIPELINE_RECEIVERS_HEADER,
   RUNTIME_ENVIRONMENT_TOKEN_HEADER,
   resolveConfig
-} from "./chunk-CGX4NSS3.mjs";
+} from "./chunk-SD7MXAJA.mjs";
 import {
   CustomerDbQueryOutcomeUnknownError
 } from "./chunk-YHPYUZZX.mjs";
@@ -3432,8 +3432,8 @@ var DeeplineClient = 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 _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 _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 _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 _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 _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 = input.compilerManifest ?? await this.compilePlayManifest({
@@ -3855,15 +3856,15 @@ var DeeplineClient = 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 _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 mintStagedPlayFileUploads(this.http, files);
@@ -3966,8 +3966,7 @@ var DeeplineClient = 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 _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 = options?.idempotencyKey?.trim();
@@ -4795,8 +4794,8 @@ var DeeplineClient = 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 _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 = options?.dryRun === true;
@@ -4827,8 +4826,8 @@ var DeeplineClient = 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 _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 _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 _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 _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();

package/dist/cli/{chunk-T7YF4MQH.mjs → chunk-MJELBQBU.mjs}

@@ -1,9 +1,9 @@
 import {
   getActiveCliProgress
-} from "./chunk-GAMFK2ZP.mjs";
+} from "./chunk-67RWR34T.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-5IGBBYXH.mjs";
+} from "./chunk-4CFULMRB.mjs";
 import {
   DEFAULT_SKILL_AGENTS,
   KNOWN_SKILL_AGENTS,
@@ -22,13 +22,13 @@ import {
   sdkCliStateDirPath,
   skillsAgentPathSegment,
   writeSdkSkillsLocalVersion
-} from "./chunk-CGX4NSS3.mjs";
+} from "./chunk-SD7MXAJA.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-42RUJLQI.mjs";
+} from "./chunk-WTT6CLED.mjs";
 
 // src/cli/commands/skills.ts
 import { spawn as spawn2 } from "child_process";

package/dist/cli/{chunk-WJYPBHTE.js → chunk-OSFWFV72.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 _chunkQ3PUHXOYjs = require('./chunk-Q3PUHXOY.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 && !_chunkQ3PUHXOYjs.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 (_chunkQ3PUHXOYjs.isJsonOutputMode.call(void 0, )) return;
     if (!this.enabled) {
       process.stderr.write(`${line}
 `);

package/dist/cli/{chunk-ZI2ZNDJK.mjs → chunk-PYZZMAJQ.mjs}

@@ -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.
@@ -815,6 +824,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 +953,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 +1179,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 +1266,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 +1356,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-N43PX2CA.js → chunk-Q3LFI3VH.js}

@@ -3,15 +3,15 @@
 var _chunkZM2YPJQJjs = require('./chunk-ZM2YPJQJ.js');
 
 
-var _chunkAPLRSERFjs = require('./chunk-APLRSERF.js');
+var _chunkAUMD2VXPjs = require('./chunk-AUMD2VXP.js');
 
 
 
-var _chunkNYDRX6JJjs = require('./chunk-NYDRX6JJ.js');
+var _chunkQ3PUHXOYjs = require('./chunk-Q3PUHXOY.js');
 
 
 
-var _chunkYSAZVLJDjs = require('./chunk-YSAZVLJD.js');
+var _chunkQUAQX3FQjs = require('./chunk-QUAQX3FQ.js');
 
 // src/cli/commands/search.ts
 var _commander = require('commander');
@@ -21,7 +21,7 @@ var _fs = require('fs');
 var _path = require('path');
 var SEARCH_REF_TTL_MS = 15 * 6e4;
 function lastSearchPath() {
-  return _path.join.call(void 0, _chunkYSAZVLJDjs.sdkCliStateDirPath.call(void 0, _chunkYSAZVLJDjs.resolveConfig.call(void 0, ).baseUrl), "last-search.json");
+  return _path.join.call(void 0, _chunkQUAQX3FQjs.sdkCliStateDirPath.call(void 0, _chunkQUAQX3FQjs.resolveConfig.call(void 0, ).baseUrl), "last-search.json");
 }
 function rememberSearchRef(searchRef) {
   try {
@@ -167,7 +167,7 @@ function searchRow(item) {
 }
 function renderSearchResults(result) {
   if (result.results.length === 0)
-    return _chunkNYDRX6JJjs.renderCommandEnvelopeText.call(void 0, result);
+    return _chunkQ3PUHXOYjs.renderCommandEnvelopeText.call(void 0, result);
   const rows = result.results.map(searchRow);
   const kinds = new Set(rows.map((row) => row.kind));
   const onlyTools = kinds.size === 1 && kinds.has("tool");
@@ -198,7 +198,7 @@ function renderSearchResults(result) {
     actions: _optionalChain([render, 'optionalAccess', _11 => _11.actions])
   };
   const followUps = _optionalChain([remaining, 'access', _12 => _12.sections, 'optionalAccess', _13 => _13.length]) || _optionalChain([remaining, 'access', _14 => _14.actions, 'optionalAccess', _15 => _15.length]) ? `
-${_chunkNYDRX6JJjs.renderCommandEnvelopeText.call(void 0, { render: remaining })}` : "";
+${_chunkQ3PUHXOYjs.renderCommandEnvelopeText.call(void 0, { render: remaining })}` : "";
   const notes = rows.flatMap(
     (row) => row.notes.map((note) => `  ${row.id}: ${note}`)
   );
@@ -275,7 +275,7 @@ async function runSearch(queryInput, options, types, exclude = []) {
     console.error(USAGE);
     return 1;
   }
-  const { search_ref: searchRef, ...result } = await new (0, _chunkAPLRSERFjs.DeeplineClient)().search({
+  const { search_ref: searchRef, ...result } = await new (0, _chunkAUMD2VXPjs.DeeplineClient)().search({
     query,
     types,
     exclude,
@@ -289,7 +289,7 @@ async function runSearch(queryInput, options, types, exclude = []) {
   });
   if (searchRef) rememberSearchRef(searchRef);
   pointAtDescribe(result);
-  _chunkNYDRX6JJjs.printCommandEnvelope.call(void 0, result, {
+  _chunkQ3PUHXOYjs.printCommandEnvelope.call(void 0, result, {
     json: options.json === true,
     text: renderSearchResults(result)
   });