deepline 0.3.405 → 0.3.407

package/dist/cli/{chunk-HG5PMETP.mjs → chunk-J67NU4MQ.mjs}

@@ -24,7 +24,7 @@ import {
   RETAINED_PIPELINE_RECEIVERS_HEADER,
   RUNTIME_ENVIRONMENT_TOKEN_HEADER,
   resolveConfig
-} from "./chunk-TPYRDAU7.mjs";
+} from "./chunk-ZBCTXQ3P.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-HYAA3F6U.js → chunk-KUQAU5MG.js}

@@ -24,7 +24,7 @@ var _chunkKXMNM4AQjs = require('./chunk-KXMNM4AQ.js');
 
 
 
-var _chunkCB6AJNHIjs = require('./chunk-CB6AJNHI.js');
+var _chunkTHHM4DPEjs = require('./chunk-THHM4DPE.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 {
-    [_chunkCB6AJNHIjs.RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token,
-    ...receivers ? { [_chunkCB6AJNHIjs.RETAINED_PIPELINE_RECEIVERS_HEADER]: receivers } : {}
+    [_chunkTHHM4DPEjs.RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token,
+    ...receivers ? { [_chunkTHHM4DPEjs.RETAINED_PIPELINE_RECEIVERS_HEADER]: receivers } : {}
   };
 }
 function isolatedCiRuntimeEventReadHeaders(env) {
@@ -2906,7 +2906,7 @@ function isolatedCiRuntimeEventReadHeaders(env) {
       "RUNTIME_EVENT_INTERNAL_TOKEN_REQUIRED"
     );
   }
-  return { [_chunkCB6AJNHIjs.COORDINATOR_INTERNAL_TOKEN_HEADER]: token };
+  return { [_chunkTHHM4DPEjs.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 = _chunkCB6AJNHIjs.resolveConfig.call(void 0, options);
+    this.config = _chunkTHHM4DPEjs.resolveConfig.call(void 0, options);
     this.environment = _nullishCoalesce(this.config.environment, () => ( process.env));
-    this.http = new (0, _chunkCB6AJNHIjs.HttpClient)(this.config);
+    this.http = new (0, _chunkTHHM4DPEjs.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();

package/dist/cli/{chunk-B6ME2XIO.mjs → chunk-L25GBGQU.mjs}

@@ -5,7 +5,7 @@ import {
 import {
   recentSearchRef,
   registerDeprecatedSearchCommand
-} from "./chunk-MPXPTSGJ.mjs";
+} from "./chunk-XT6GG3QO.mjs";
 import {
   arrayField,
   formatModelDescription,
@@ -45,7 +45,7 @@ import {
 import {
   DeeplineClient,
   validateExecutionIdempotencyKey
-} from "./chunk-HG5PMETP.mjs";
+} from "./chunk-J67NU4MQ.mjs";
 import {
   stableStringify
 } from "./chunk-UBKA33KY.mjs";
@@ -62,11 +62,11 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-3DWMYKWU.mjs";
+} from "./chunk-BKC6VMYZ.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-TPYRDAU7.mjs";
+} from "./chunk-ZBCTXQ3P.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -941,7 +941,7 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await import("./describe-INFC5ACQ.mjs");
+      const { describeAnything } = await import("./describe-WERH4TD2.mjs");
       process.exitCode = await describeAnything(
         toolId,
         {

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

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

package/dist/cli/{chunk-EVLCUV64.mjs → chunk-P7HOTKOK.mjs}

@@ -1,17 +1,17 @@
 import {
   npmSupportsAllowScripts,
   readNpmVersion
-} from "./chunk-4ONG2MWB.mjs";
+} from "./chunk-N6OAMAO5.mjs";
 import {
   resolveShellSpawn,
   runSkillsCommand
-} from "./chunk-TECEX3K5.mjs";
+} from "./chunk-4TV43THC.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-3DWMYKWU.mjs";
+} from "./chunk-BKC6VMYZ.mjs";
 import {
   autoDetectBaseUrl
-} from "./chunk-TPYRDAU7.mjs";
+} from "./chunk-ZBCTXQ3P.mjs";
 
 // src/cli/commands/update.ts
 import { spawn, spawnSync } from "child_process";

package/dist/cli/{chunk-YRZIKG47.mjs → chunk-QJAX7QN7.mjs}

@@ -2,10 +2,10 @@ import {
   getAuthedHttpClient,
   openInBrowser,
   printCommandEnvelope
-} from "./chunk-3DWMYKWU.mjs";
+} from "./chunk-BKC6VMYZ.mjs";
 import {
   resolveBaseUrlOnly
-} from "./chunk-TPYRDAU7.mjs";
+} from "./chunk-ZBCTXQ3P.mjs";
 
 // src/cli/commands/git.ts
 function shellQuote(value) {