deepline 0.3.406 → 0.3.408

package/dist/{client-Db1jFLpF.d.ts → client-BcvhDfJJ.d.ts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { g as PlayCompilerManifest, ak as ToolResultBilling, Y as BillingEntitlements, ap as BillingBenefitValues } from './compiler-manifest-N77W75Py.js';
+import { g as PlayCompilerManifest, ak as ToolResultBilling, Y as BillingEntitlements, ap as BillingBenefitValues } from './compiler-manifest-Ycx-hoAr.js';
 import { z } from 'zod';
 import { MonitorFleetDefinition } from './monitor-fleet-contract.js';
 
@@ -2492,9 +2492,10 @@ interface StopPlayRunResult {
     /** True if HITL state or its same-message Slack card still needs retrying. */
     hitlCancellationPending?: boolean;
     /**
-     * True only when the scheduler and the canonical run ledger disagree (for
-     * example a terminal scheduler run whose ledger projection is pending), so
-     * the stop could not be confirmed. Never set for a queued cancellation.
+     * True only when the scheduler and the canonical run ledger disagree and
+     * the server could not confirm the stop.
+     * For example, the scheduler can report a terminal run while the ledger
+     * projection is pending. This field is never true for a queued cancellation.
      */
     staleSchedulerState?: boolean;
     /** Server-side error detail when the stop failed (`state: 'failed'`). */
@@ -2868,11 +2869,33 @@ type PlayCostEstimate = {
     sampleRunCount: number;
     basedOnRunId: string | null;
     modelVersion: string;
+    compute?: {
+        scope: 'sandbox_session';
+        maximumCredits: number;
+        maximumBillingSeconds: number;
+        maximumBackend: 'daytona' | 'modal';
+        pricedBackends: Array<'daytona' | 'modal'>;
+        totalPlayCredits: null;
+        totalPlayCreditsSupported: false;
+        actualUsageBased: true;
+        totalSandboxSessions: 'unbounded';
+    };
 } | {
     status: 'unavailable';
-    reason: 'ambiguous_output_unit' | 'unbounded_loop' | 'unresolved_tool' | 'mixed_run_and_row_costs';
+    reason: 'ambiguous_output_unit' | 'unbounded_loop' | 'unresolved_tool' | 'unresolved_call_graph' | 'mixed_run_and_row_costs';
     message: string;
     modelVersion: string;
+    compute?: {
+        scope: 'sandbox_session';
+        maximumCredits: number;
+        maximumBillingSeconds: number;
+        maximumBackend: 'daytona' | 'modal';
+        pricedBackends: Array<'daytona' | 'modal'>;
+        totalPlayCredits: null;
+        totalPlayCreditsSupported: false;
+        actualUsageBased: true;
+        totalSandboxSessions: 'unbounded';
+    };
 };
 interface PlayListItem {
     settings?: PlaySettings;
@@ -6114,6 +6137,8 @@ type BillingQuoteResult = {
         cpu: number;
         diskGiB: number;
     };
+    maximum_backend?: 'daytona' | 'modal';
+    priced_backends?: Array<'daytona' | 'modal'>;
     maximum_credits: number;
     maximum_billing_seconds: number;
     total_play_credits: null;
@@ -6217,8 +6242,8 @@ declare 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.
      */
     searchTools(options?: ToolSearchOptions): Promise<ToolSearchResult>;
     /**
@@ -6256,13 +6281,12 @@ declare 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
@@ -6271,8 +6295,8 @@ declare 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.
      */
     quoteInferenceTool(toolId: 'ai_evaluate' | 'ai_inference' | 'deeplineagent', payload: Record<string, unknown>): Promise<InferenceQuote>;
     /**
@@ -6324,13 +6348,16 @@ declare 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`
@@ -6464,9 +6491,8 @@ declare 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.
      */
     compilePlayManifest(input: {
         name: string;
@@ -6518,8 +6544,8 @@ declare 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.
      */
     startPlayRunFromBundle(input: {
         name: string;
@@ -6537,15 +6563,15 @@ declare 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
@@ -6604,9 +6630,8 @@ declare 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.
      */
     mintStagedPlayFileUploads(files: Array<{
         logicalPath: string;
@@ -6617,8 +6642,7 @@ declare 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.
      */
     resolveStagedPlayFiles(files: Array<{
         logicalPath: string;
@@ -6832,11 +6856,11 @@ declare 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.
      */
     rerun(runId: string, options?: RerunOptions): Promise<RerunPlayRunResult>;
     /**
@@ -6914,8 +6938,8 @@ declare class DeeplineClient {
     /** Stop, or with `dryRun: true` only enumerate, active workspace runs. */
     stopAllRuns(options?: StopAllRunsOptions): Promise<StopAllPlayRunsResult>;
     /**
-     * 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.
@@ -7056,8 +7080,7 @@ declare 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
@@ -7108,10 +7131,10 @@ declare 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.
      */
     describePlay(name: string, options?: PlayDescriptionOptions): Promise<PlayDescription>;
     /**
@@ -7135,8 +7158,7 @@ declare 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
@@ -7262,9 +7284,9 @@ declare class DeeplineClient {
      */
     getBillingUsageEvent(requestId: string): Promise<BillingUsageEvent>;
     /**
-     * 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`.
      */
     getRunBilling(runIds: readonly string[]): Promise<RunBillingResult>;
     /**

package/dist/{client-Buv1_ktG.d.mts → client-Z9Pye1Wm.d.mts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { g as PlayCompilerManifest, ak as ToolResultBilling, Y as BillingEntitlements, ap as BillingBenefitValues } from './compiler-manifest-N77W75Py.mjs';
+import { g as PlayCompilerManifest, ak as ToolResultBilling, Y as BillingEntitlements, ap as BillingBenefitValues } from './compiler-manifest-Ycx-hoAr.mjs';
 import { z } from 'zod';
 import { MonitorFleetDefinition } from './monitor-fleet-contract.mjs';
 
@@ -2492,9 +2492,10 @@ interface StopPlayRunResult {
     /** True if HITL state or its same-message Slack card still needs retrying. */
     hitlCancellationPending?: boolean;
     /**
-     * True only when the scheduler and the canonical run ledger disagree (for
-     * example a terminal scheduler run whose ledger projection is pending), so
-     * the stop could not be confirmed. Never set for a queued cancellation.
+     * True only when the scheduler and the canonical run ledger disagree and
+     * the server could not confirm the stop.
+     * For example, the scheduler can report a terminal run while the ledger
+     * projection is pending. This field is never true for a queued cancellation.
      */
     staleSchedulerState?: boolean;
     /** Server-side error detail when the stop failed (`state: 'failed'`). */
@@ -2868,11 +2869,33 @@ type PlayCostEstimate = {
     sampleRunCount: number;
     basedOnRunId: string | null;
     modelVersion: string;
+    compute?: {
+        scope: 'sandbox_session';
+        maximumCredits: number;
+        maximumBillingSeconds: number;
+        maximumBackend: 'daytona' | 'modal';
+        pricedBackends: Array<'daytona' | 'modal'>;
+        totalPlayCredits: null;
+        totalPlayCreditsSupported: false;
+        actualUsageBased: true;
+        totalSandboxSessions: 'unbounded';
+    };
 } | {
     status: 'unavailable';
-    reason: 'ambiguous_output_unit' | 'unbounded_loop' | 'unresolved_tool' | 'mixed_run_and_row_costs';
+    reason: 'ambiguous_output_unit' | 'unbounded_loop' | 'unresolved_tool' | 'unresolved_call_graph' | 'mixed_run_and_row_costs';
     message: string;
     modelVersion: string;
+    compute?: {
+        scope: 'sandbox_session';
+        maximumCredits: number;
+        maximumBillingSeconds: number;
+        maximumBackend: 'daytona' | 'modal';
+        pricedBackends: Array<'daytona' | 'modal'>;
+        totalPlayCredits: null;
+        totalPlayCreditsSupported: false;
+        actualUsageBased: true;
+        totalSandboxSessions: 'unbounded';
+    };
 };
 interface PlayListItem {
     settings?: PlaySettings;
@@ -6114,6 +6137,8 @@ type BillingQuoteResult = {
         cpu: number;
         diskGiB: number;
     };
+    maximum_backend?: 'daytona' | 'modal';
+    priced_backends?: Array<'daytona' | 'modal'>;
     maximum_credits: number;
     maximum_billing_seconds: number;
     total_play_credits: null;
@@ -6217,8 +6242,8 @@ declare 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.
      */
     searchTools(options?: ToolSearchOptions): Promise<ToolSearchResult>;
     /**
@@ -6256,13 +6281,12 @@ declare 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
@@ -6271,8 +6295,8 @@ declare 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.
      */
     quoteInferenceTool(toolId: 'ai_evaluate' | 'ai_inference' | 'deeplineagent', payload: Record<string, unknown>): Promise<InferenceQuote>;
     /**
@@ -6324,13 +6348,16 @@ declare 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`
@@ -6464,9 +6491,8 @@ declare 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.
      */
     compilePlayManifest(input: {
         name: string;
@@ -6518,8 +6544,8 @@ declare 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.
      */
     startPlayRunFromBundle(input: {
         name: string;
@@ -6537,15 +6563,15 @@ declare 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
@@ -6604,9 +6630,8 @@ declare 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.
      */
     mintStagedPlayFileUploads(files: Array<{
         logicalPath: string;
@@ -6617,8 +6642,7 @@ declare 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.
      */
     resolveStagedPlayFiles(files: Array<{
         logicalPath: string;
@@ -6832,11 +6856,11 @@ declare 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.
      */
     rerun(runId: string, options?: RerunOptions): Promise<RerunPlayRunResult>;
     /**
@@ -6914,8 +6938,8 @@ declare class DeeplineClient {
     /** Stop, or with `dryRun: true` only enumerate, active workspace runs. */
     stopAllRuns(options?: StopAllRunsOptions): Promise<StopAllPlayRunsResult>;
     /**
-     * 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.
@@ -7056,8 +7080,7 @@ declare 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
@@ -7108,10 +7131,10 @@ declare 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.
      */
     describePlay(name: string, options?: PlayDescriptionOptions): Promise<PlayDescription>;
     /**
@@ -7135,8 +7158,7 @@ declare 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
@@ -7262,9 +7284,9 @@ declare class DeeplineClient {
      */
     getBillingUsageEvent(requestId: string): Promise<BillingUsageEvent>;
     /**
-     * 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`.
      */
     getRunBilling(runIds: readonly string[]): Promise<RunBillingResult>;
     /**

package/dist/{compiler-manifest-N77W75Py.d.ts → compiler-manifest-Ycx-hoAr.d.mts}

@@ -821,6 +821,8 @@ type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> =
         }>;
         /** Original declarations preserve semantic accessor names across replay. */
         listExtractorPaths?: readonly string[];
+        /** Additional semantic names for another declared list; original names win. */
+        listExtractorAliases?: Readonly<Record<string, string>>;
     };
 };
 type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = {
@@ -1276,7 +1278,12 @@ type PlayAuthoringFetchResponse = {
     /** Full response body as text, with any known secret values redacted. */
     bodyText: string;
     /**
-     * The parsed body, eagerly decoded at request time. Read it as a property — `const body = res.json`, never `await res.json()`. Null when the body is empty AND when it is not valid JSON: a malformed payload is reported as null rather than thrown, so check `res.ok` and fall back to `res.bodyText` before treating null as an empty result.
+     * The runtime parses the body at request time.
+     * Read the property with `const body = res.json`. Do not call `await res.json()`.
+     * The value is null when the body is empty or is not valid JSON.
+     * Malformed JSON produces null instead of an error.
+     *
+     * Check `res.ok`. Check `res.bodyText` before you interpret null as an empty response.
      */
     json: unknown | null;
 };

package/dist/{compiler-manifest-N77W75Py.d.mts → compiler-manifest-Ycx-hoAr.d.ts}

@@ -821,6 +821,8 @@ type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> =
         }>;
         /** Original declarations preserve semantic accessor names across replay. */
         listExtractorPaths?: readonly string[];
+        /** Additional semantic names for another declared list; original names win. */
+        listExtractorAliases?: Readonly<Record<string, string>>;
     };
 };
 type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = {
@@ -1276,7 +1278,12 @@ type PlayAuthoringFetchResponse = {
     /** Full response body as text, with any known secret values redacted. */
     bodyText: string;
     /**
-     * The parsed body, eagerly decoded at request time. Read it as a property — `const body = res.json`, never `await res.json()`. Null when the body is empty AND when it is not valid JSON: a malformed payload is reported as null rather than thrown, so check `res.ok` and fall back to `res.bodyText` before treating null as an empty result.
+     * The runtime parses the body at request time.
+     * Read the property with `const body = res.json`. Do not call `await res.json()`.
+     * The value is null when the body is empty or is not valid JSON.
+     * Malformed JSON produces null instead of an error.
+     *
+     * Check `res.ok`. Check `res.bodyText` before you interpret null as an empty response.
      */
     json: unknown | null;
 };

package/dist/{index-3WOfyVhW.d.mts → index-CZXgiN3E.d.mts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind } from './compiler-manifest-N77W75Py.mjs';
+import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind } from './compiler-manifest-Ycx-hoAr.mjs';
 
 type ImportedPlayDependency = {
     filePath: string;

package/dist/{index-CtIJFTCl.d.ts → index-NPG5pqxQ.d.ts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind } from './compiler-manifest-N77W75Py.js';
+import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind } from './compiler-manifest-Ycx-hoAr.js';
 
 type ImportedPlayDependency = {
     filePath: string;