deepline 0.3.273 → 0.3.275

package/dist/{client-5xpuGpRn.d.ts → client-5zY7LsId.d.ts}

@@ -2216,6 +2216,12 @@ type PlayLiveEvent = LiveEventEnvelope<unknown> & {
 interface StopPlayRunResult {
     /** Public play-run identifier the stop request targeted. */
     runId: string;
+    /**
+     * Typed stop outcome: `stopped` (terminal), `cancelling` (cancellation
+     * durably queued; cleanup and the final run update are pending, not an
+     * error), or `failed` (the stop was not confirmed). Absent on older servers.
+     */
+    state?: 'stopped' | 'cancelling' | 'failed';
     /** Whether the server confirmed the run was stopped. */
     stopped: boolean;
     /** True when the durable cancellation lane accepted the request and is draining. */
@@ -2225,11 +2231,12 @@ interface StopPlayRunResult {
     /** True if HITL state or its same-message Slack card still needs retrying. */
     hitlCancellationPending?: boolean;
     /**
-     * True when the scheduler state for the run was stale and the stop could
-     * not be confirmed. Absent on older servers (treated as confirmed).
+     * 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.
      */
     staleSchedulerState?: boolean;
-    /** Server-side error detail when the stop was not confirmed. */
+    /** Server-side error detail when the stop failed (`state: 'failed'`). */
     error?: string;
 }
 /**
@@ -3715,6 +3722,46 @@ type RunsListPage = {
     limit?: number;
     hasMore?: boolean;
 };
+/** Cursor-paged workspace run history, including runs of removed Plays. */
+type RunsHistoryOptions = {
+    /** Case-insensitive Play/workflow name, run ID, or status substring. */
+    search?: string;
+    /** Search classification from recorded trigger metadata; requires search. */
+    type?: 'all' | 'plays' | 'monitors';
+    cursor?: string;
+    limit?: number;
+    /** Must match the workspace authorized by the credential. */
+    orgId?: string;
+    signal?: AbortSignal;
+};
+type RunsHistoryItem = {
+    runId: string;
+    workflowId: string;
+    workflowName: string;
+    playScope: 'org' | 'system' | null;
+    status: string;
+    createdAt: number;
+    updatedAt: number;
+    callerName: string | null;
+    callerEmail: string | null;
+    authorName: string | null;
+    authorEmail: string | null;
+    callerAgent: string | null;
+    executionMode: string | null;
+    bindingId: string | null;
+    parentWorkflowName: string | null;
+    outputRowCount: number | null;
+    hasOutput: boolean;
+    billingTotalCredits?: number;
+    triggerSource?: string;
+};
+/** An empty search page is incomplete while hasMore is true. */
+type RunsHistoryPage = {
+    runs: RunsHistoryItem[];
+    nextCursor: string | null;
+    hasMore: boolean;
+    avatarsByName?: Record<string, string>;
+};
 type PlaysListOptions = {
     origin?: 'prebuilt' | 'owned';
     grep?: string;
@@ -3744,6 +3791,8 @@ type PlaysListPage = {
 type RunsGetOptions = {
     /** Return the raw status payload instead of the compact package. */
     full?: boolean;
+    /** Explicitly read this run's recorded graph and source, without full results. */
+    configuration?: boolean;
     /** Attach a bounded end-of-stream window for a failed run. */
     failedLogs?: boolean;
     /** Requested failed-log lines to attach (default 20, hard-capped at 20). */
@@ -3834,6 +3883,12 @@ type RunsLogsOptions = {
     all?: boolean;
     /** Read a terminal-failed run's last 20 retained lines, or fewer with `limit`. Retention loss returns an explicit association and warning. */
     failed?: boolean;
+    /**
+     * Continue with the next OLDER page: pass a prior result's `nextCursor`.
+     * The page holds the last `limit` stored lines before that cursor (with
+     * `all`, every stored line before it).
+     */
+    cursor?: string;
 };
 /** Retained text for one run. Counts and retention flags describe the stored stream, not every original console call. */
 type RunsLogsResult = {
@@ -3849,8 +3904,14 @@ type RunsLogsResult = {
     lastSequence: number | null;
     /** Tail/all: returned count is below total count. Failed: the stream lost bodies to retention. Check `logsTruncated` to distinguish retention loss from a selected tail. */
     truncated: boolean;
-    /** More retained lines exist after `lastSequence`; always false for the designed failure window. */
+    /** Older stored lines exist before this page; `nextCursor` reads them. */
     hasMore: boolean;
+    /**
+     * Opaque cursor for the next older page (`runs.logs(id, { cursor })`),
+     * null when this page reaches the oldest stored line. Absent for the failed
+     * view, which is a complete designed window rather than a pageable slice.
+     */
+    nextCursor?: string | null;
     /** Formatted text lines in stored sequence order; structured context is available through event search. */
     entries: string[];
     /** Selected public log view. */
@@ -4023,6 +4084,8 @@ type RunsNamespace = {
     list: (options: RunsListOptions) => Promise<PlayRunListItem[]>;
     /** Read one run page with total, offset, limit and completeness metadata. */
     listPage: (options: RunsListOptions) => Promise<RunsListPage>;
+    /** Search/page workspace run history newest first; follow empty continuing pages. */
+    history: (options?: RunsHistoryOptions) => Promise<RunsHistoryPage>;
     /** Poll run snapshots every two seconds until terminal status. */
     watch: (runId: string, options?: RunsWatchOptions) => Promise<PlayStatus>;
     /** @deprecated Use `watch`; retained as a source-compatible alias. */
@@ -5698,7 +5761,7 @@ declare class DeeplineClient {
      * 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 `--watch` completes.
+     * 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`
@@ -5794,7 +5857,7 @@ declare class DeeplineClient {
      * Get the current status of a play execution.
      *
      * Internal/advanced primitive. Public callers should usually prefer
-     * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run --watch`.
+     * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run`.
      *
      * @param workflowId - Play-run id from {@link startPlayRun}
      * @returns Current status with progress logs and partial results
@@ -5971,6 +6034,8 @@ declare class DeeplineClient {
      * ```
      */
     listRuns(options: RunsListOptions): Promise<PlayRunListItem[]>;
+    /** The same tenant-scoped run history searched by the dashboard and CLI. */
+    getRunsHistory(options?: RunsHistoryOptions): Promise<RunsHistoryPage>;
     /** Read one run page without discarding server pagination metadata. */
     listRunsPage(options: RunsListOptions): Promise<RunsListPage>;
     /** Read retained tool results without executing tools, preserving supplied key order and batching 100 keys per request. Obtain keys from exported evidence or execution metadata; each key must be nonempty, at most 2,048 characters and contain no CR, LF or NUL. Missing/expired results have an explicit per-key error. */
@@ -6626,4 +6691,4 @@ declare class DeeplineClient {
     }>;
 }
 
-export { type MonitorFleetStatus as $, DeeplineClient as A, type BillingNamespace as B, type ClearPlayHistoryResult as C, type DeeplineClientOptions as D, type ExecutionRecovery as E, type DeeplineToolCategory as F, type LiveEventEnvelope as G, MONITOR_JOB_RECONCILIATION_STATES as H, type IngestionStorageRepairResult as I, MONITOR_JOB_STATES as J, type MonitorBatchNamespace as K, type LegacyMonitorStatusFilter as L, MONITOR_JOB_PHASES as M, type MonitorCheckResult as N, type MonitorDefinition as O, type PlayListItem as P, type MonitorDeleteResult as Q, type ResolvedConfig as R, type StopPlayRunResult as S, type ToolDefinition as T, type MonitorDependents as U, type MonitorDeployResult as V, type MonitorDetail as W, type MonitorFleetDeactivateOptions as X, type MonitorFleetGetOptions as Y, type MonitorFleetReactivateOptions as Z, type MonitorFleetResult as _, type ToolMetadata as a, type PlaysListPage as a$, type MonitorFleetSyncOptions as a0, type MonitorFleetWaitOptions as a1, type MonitorFleetsNamespace as a2, type MonitorJobDeployOptions as a3, type MonitorJobLogsOptions as a4, type MonitorJobPhase as a5, type MonitorJobReconciliationState as a6, type MonitorJobResult as a7, type MonitorJobState as a8, type MonitorJobWaitOptions as a9, type PlayActivityState as aA, type PlayActivityTarget as aB, type PlayBootstrapEntityKind as aC, type PlayBootstrapFinderKind as aD, type PlayCostEstimate as aE, type PlayCronTriggerConfig as aF, type PlayLiveEvent as aG, type PlayPath as aH, type PlayRunActionPackage as aI, type PlayRunActivityProjection as aJ, type PlayRunDatasetActions as aK, type PlayRunPackage as aL, type PlayRunResult as aM, type PlayRunStart as aN, type PlaySettings as aO, type PlaySettingsPatch as aP, type PlaySettingsPathsPage as aQ, type PlaySettingsResult as aR, type PlaySheetRow as aS, type PlaySheetRowsResult as aT, type PlayTriggerConfigUpdate as aU, type PlayTriggerConfigUpdateResult as aV, type PlayTriggerConfigView as aW, type PlayWebhookAuthConfig as aX, type PlayWebhookTriggerConfig as aY, type PlaysActivityResponse as aZ, type PlaysListOptions as a_, type MonitorJobsNamespace as aa, type MonitorListEntry as ab, type MonitorPayload as ac, type MonitorReactivateResult as ad, type MonitorSpec as ae, type MonitorState as af, type MonitorStateFilter as ag, type MonitorUpdateChangeSummary as ah, type MonitorUpdateResult as ai, type MonitorsAccessStatus as aj, type MonitorsAvailableOptions as ak, type MonitorsAvailableResult as al, type MonitorsListOptions as am, type MonitorsListResult as an, type MonitorsNamespace as ao, PLAY_BOOTSTRAP_COMPANY_FIELDS as ap, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY as aq, PLAY_BOOTSTRAP_CONTACT_FIELDS as ar, PLAY_BOOTSTRAP_FINDER_KINDS as as, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER as at, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY as au, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER as av, PLAY_BOOTSTRAP_SOURCE_KINDS as aw, PLAY_BOOTSTRAP_STAGE_KINDS as ax, PLAY_BOOTSTRAP_TEMPLATES as ay, type PlayActivityObservation as az, type ExecutionByKeyResult as b, stageFileInputs as b$, type PublishPlayVersionRequest as b0, type RerunOptions as b1, type RerunPlayRunResult as b2, type RunChildrenPage as b3, type RunLifecycleStatus as b4, type RunToolReceiptResult as b5, type RunToolReceiptsResponse as b6, type RunsChildrenOptions as b7, type RunsEventPayload as b8, type RunsEventSearchEntry as b9, isStopAllPlayRunsDryRunResult as bA, CSV_DATA_INPUT_KEY as bB, type FileInputBinding as bC, type LocalFileInput as bD, type MintStagedFileUpload as bE, PLAY_FILES_STAGE_MINT_PATH as bF, PLAY_FILES_STAGE_PATH as bG, PLAY_RUN_START_PATH as bH, PLAY_RUN_START_STREAM_PATH as bI, type PlayRunHttp as bJ, type ResolvedStartPlayRunRequest as bK, STAGE_LEGACY_MULTIPART_MAX_BYTES as bL, type StagedFileCodec as bM, type StagedFileInputs as bN, type StagedFileUpload as bO, buildNamedPlayRunRequest as bP, buildPlayRunStartBody as bQ, createSessionPlayRunHttp as bR, createStagedFileUpload as bS, fileInputBindingsFromPlaySchema as bT, fileInputBindingsFromStaticPipeline as bU, getDottedInputValue as bV, isPlayRunPackage as bW, mintStagedPlayFileUploads as bX, normalizePlayRunStart as bY, playRunFileInputBindings as bZ, setDottedInputValue as b_, type RunsEventSearchOptions as ba, type RunsEventSearchResult as bb, type RunsListOptions as bc, type RunsListPage as bd, type RunsLogsOptions as be, type RunsLogsResult as bf, type RunsNamespace as bg, type RunsTailOptions as bh, type RunsWatchOptions as bi, type StartPlayRunRequest as bj, type StopAllCandidate as bk, type StopAllPlayRunsDryRunResult as bl, type StopAllPlayRunsResult as bm, type StopAllPlayRunsStopResult as bn, type StopAllRunsOptions as bo, type ToolExecution as bp, type ToolSearchOptions as bq, type ToolSearchResult as br, type WorkspaceCreateResult as bs, type WorkspacesNamespace as bt, defineMonitor as bu, formatPlayBootstrapFinderKinds as bv, formatPlayBootstrapFinderKindsForSentence as bw, formatPlayBootstrapTemplates as bx, isPlayBootstrapFinderKind as by, isPlayBootstrapTemplate as bz, type PlayDetail as c, stagePlayFiles as c0, stagedFileContentType as c1, startPlayRun as c2, webStagedFileCodec as c3, type PlayRunListItem as d, type PlayRevisionSummary as e, type PublishPlayVersionResult as f, type PlayStatus as g, type BillingCreditPool as h, type BillingInvoiceEntry as i, type BillingInvoicesResult as j, type BillingPaymentMethodSummary as k, type BillingRecentUsageEntry as l, type BillingSubscriptionCancelResult as m, type BillingSubscriptionStatus as n, type BillingTopUpReceipt as o, type BillingTopUpResult as p, type BillingUsageEvent as q, type BillingUsageOptions as r, type BillingUsageResult as s, type ChildRunSummary as t, type ClearPlayHistoryRequest as u, type CreateNotificationGroupInput as v, type CreateNotificationGroupResult as w, type CustomerDbQueryResult as x, DEEPLINE_TOOL_CATEGORIES as y, type DbNamespace as z };
+export { type MonitorFleetStatus as $, DeeplineClient as A, type BillingNamespace as B, type ClearPlayHistoryResult as C, type DeeplineClientOptions as D, type ExecutionRecovery as E, type DeeplineToolCategory as F, type LiveEventEnvelope as G, MONITOR_JOB_RECONCILIATION_STATES as H, type IngestionStorageRepairResult as I, MONITOR_JOB_STATES as J, type MonitorBatchNamespace as K, type LegacyMonitorStatusFilter as L, MONITOR_JOB_PHASES as M, type MonitorCheckResult as N, type MonitorDefinition as O, type PlayListItem as P, type MonitorDeleteResult as Q, type ResolvedConfig as R, type StopPlayRunResult as S, type ToolDefinition as T, type MonitorDependents as U, type MonitorDeployResult as V, type MonitorDetail as W, type MonitorFleetDeactivateOptions as X, type MonitorFleetGetOptions as Y, type MonitorFleetReactivateOptions as Z, type MonitorFleetResult as _, type ToolMetadata as a, type PlaysListPage as a$, type MonitorFleetSyncOptions as a0, type MonitorFleetWaitOptions as a1, type MonitorFleetsNamespace as a2, type MonitorJobDeployOptions as a3, type MonitorJobLogsOptions as a4, type MonitorJobPhase as a5, type MonitorJobReconciliationState as a6, type MonitorJobResult as a7, type MonitorJobState as a8, type MonitorJobWaitOptions as a9, type PlayActivityState as aA, type PlayActivityTarget as aB, type PlayBootstrapEntityKind as aC, type PlayBootstrapFinderKind as aD, type PlayCostEstimate as aE, type PlayCronTriggerConfig as aF, type PlayLiveEvent as aG, type PlayPath as aH, type PlayRunActionPackage as aI, type PlayRunActivityProjection as aJ, type PlayRunDatasetActions as aK, type PlayRunPackage as aL, type PlayRunResult as aM, type PlayRunStart as aN, type PlaySettings as aO, type PlaySettingsPatch as aP, type PlaySettingsPathsPage as aQ, type PlaySettingsResult as aR, type PlaySheetRow as aS, type PlaySheetRowsResult as aT, type PlayTriggerConfigUpdate as aU, type PlayTriggerConfigUpdateResult as aV, type PlayTriggerConfigView as aW, type PlayWebhookAuthConfig as aX, type PlayWebhookTriggerConfig as aY, type PlaysActivityResponse as aZ, type PlaysListOptions as a_, type MonitorJobsNamespace as aa, type MonitorListEntry as ab, type MonitorPayload as ac, type MonitorReactivateResult as ad, type MonitorSpec as ae, type MonitorState as af, type MonitorStateFilter as ag, type MonitorUpdateChangeSummary as ah, type MonitorUpdateResult as ai, type MonitorsAccessStatus as aj, type MonitorsAvailableOptions as ak, type MonitorsAvailableResult as al, type MonitorsListOptions as am, type MonitorsListResult as an, type MonitorsNamespace as ao, PLAY_BOOTSTRAP_COMPANY_FIELDS as ap, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY as aq, PLAY_BOOTSTRAP_CONTACT_FIELDS as ar, PLAY_BOOTSTRAP_FINDER_KINDS as as, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER as at, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY as au, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER as av, PLAY_BOOTSTRAP_SOURCE_KINDS as aw, PLAY_BOOTSTRAP_STAGE_KINDS as ax, PLAY_BOOTSTRAP_TEMPLATES as ay, type PlayActivityObservation as az, type ExecutionByKeyResult as b, normalizePlayRunStart as b$, type PublishPlayVersionRequest as b0, type RerunOptions as b1, type RerunPlayRunResult as b2, type RunChildrenPage as b3, type RunLifecycleStatus as b4, type RunToolReceiptResult as b5, type RunToolReceiptsResponse as b6, type RunsChildrenOptions as b7, type RunsEventPayload as b8, type RunsEventSearchEntry as b9, formatPlayBootstrapTemplates as bA, isPlayBootstrapFinderKind as bB, isPlayBootstrapTemplate as bC, isStopAllPlayRunsDryRunResult as bD, CSV_DATA_INPUT_KEY as bE, type FileInputBinding as bF, type LocalFileInput as bG, type MintStagedFileUpload as bH, PLAY_FILES_STAGE_MINT_PATH as bI, PLAY_FILES_STAGE_PATH as bJ, PLAY_RUN_START_PATH as bK, PLAY_RUN_START_STREAM_PATH as bL, type PlayRunHttp as bM, type ResolvedStartPlayRunRequest as bN, STAGE_LEGACY_MULTIPART_MAX_BYTES as bO, type StagedFileCodec as bP, type StagedFileInputs as bQ, type StagedFileUpload as bR, buildNamedPlayRunRequest as bS, buildPlayRunStartBody as bT, createSessionPlayRunHttp as bU, createStagedFileUpload as bV, fileInputBindingsFromPlaySchema as bW, fileInputBindingsFromStaticPipeline as bX, getDottedInputValue as bY, isPlayRunPackage as bZ, mintStagedPlayFileUploads as b_, type RunsEventSearchOptions as ba, type RunsEventSearchResult as bb, type RunsHistoryItem as bc, type RunsHistoryOptions as bd, type RunsHistoryPage as be, type RunsListOptions as bf, type RunsListPage as bg, type RunsLogsOptions as bh, type RunsLogsResult as bi, type RunsNamespace as bj, type RunsTailOptions as bk, type RunsWatchOptions as bl, type StartPlayRunRequest as bm, type StopAllCandidate as bn, type StopAllPlayRunsDryRunResult as bo, type StopAllPlayRunsResult as bp, type StopAllPlayRunsStopResult as bq, type StopAllRunsOptions as br, type ToolExecution as bs, type ToolSearchOptions as bt, type ToolSearchResult as bu, type WorkspaceCreateResult as bv, type WorkspacesNamespace as bw, defineMonitor as bx, formatPlayBootstrapFinderKinds as by, formatPlayBootstrapFinderKindsForSentence as bz, type PlayDetail as c, playRunFileInputBindings as c0, setDottedInputValue as c1, stageFileInputs as c2, stagePlayFiles as c3, stagedFileContentType as c4, startPlayRun as c5, webStagedFileCodec as c6, type PlayRunListItem as d, type PlayRevisionSummary as e, type PublishPlayVersionResult as f, type PlayStatus as g, type BillingCreditPool as h, type BillingInvoiceEntry as i, type BillingInvoicesResult as j, type BillingPaymentMethodSummary as k, type BillingRecentUsageEntry as l, type BillingSubscriptionCancelResult as m, type BillingSubscriptionStatus as n, type BillingTopUpReceipt as o, type BillingTopUpResult as p, type BillingUsageEvent as q, type BillingUsageOptions as r, type BillingUsageResult as s, type ChildRunSummary as t, type ClearPlayHistoryRequest as u, type CreateNotificationGroupInput as v, type CreateNotificationGroupResult as w, type CustomerDbQueryResult as x, DEEPLINE_TOOL_CATEGORIES as y, type DbNamespace as z };

package/dist/{client-D9annc6K.d.mts → client-CbNvJLgV.d.mts}

@@ -2216,6 +2216,12 @@ type PlayLiveEvent = LiveEventEnvelope<unknown> & {
 interface StopPlayRunResult {
     /** Public play-run identifier the stop request targeted. */
     runId: string;
+    /**
+     * Typed stop outcome: `stopped` (terminal), `cancelling` (cancellation
+     * durably queued; cleanup and the final run update are pending, not an
+     * error), or `failed` (the stop was not confirmed). Absent on older servers.
+     */
+    state?: 'stopped' | 'cancelling' | 'failed';
     /** Whether the server confirmed the run was stopped. */
     stopped: boolean;
     /** True when the durable cancellation lane accepted the request and is draining. */
@@ -2225,11 +2231,12 @@ interface StopPlayRunResult {
     /** True if HITL state or its same-message Slack card still needs retrying. */
     hitlCancellationPending?: boolean;
     /**
-     * True when the scheduler state for the run was stale and the stop could
-     * not be confirmed. Absent on older servers (treated as confirmed).
+     * 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.
      */
     staleSchedulerState?: boolean;
-    /** Server-side error detail when the stop was not confirmed. */
+    /** Server-side error detail when the stop failed (`state: 'failed'`). */
     error?: string;
 }
 /**
@@ -3715,6 +3722,46 @@ type RunsListPage = {
     limit?: number;
     hasMore?: boolean;
 };
+/** Cursor-paged workspace run history, including runs of removed Plays. */
+type RunsHistoryOptions = {
+    /** Case-insensitive Play/workflow name, run ID, or status substring. */
+    search?: string;
+    /** Search classification from recorded trigger metadata; requires search. */
+    type?: 'all' | 'plays' | 'monitors';
+    cursor?: string;
+    limit?: number;
+    /** Must match the workspace authorized by the credential. */
+    orgId?: string;
+    signal?: AbortSignal;
+};
+type RunsHistoryItem = {
+    runId: string;
+    workflowId: string;
+    workflowName: string;
+    playScope: 'org' | 'system' | null;
+    status: string;
+    createdAt: number;
+    updatedAt: number;
+    callerName: string | null;
+    callerEmail: string | null;
+    authorName: string | null;
+    authorEmail: string | null;
+    callerAgent: string | null;
+    executionMode: string | null;
+    bindingId: string | null;
+    parentWorkflowName: string | null;
+    outputRowCount: number | null;
+    hasOutput: boolean;
+    billingTotalCredits?: number;
+    triggerSource?: string;
+};
+/** An empty search page is incomplete while hasMore is true. */
+type RunsHistoryPage = {
+    runs: RunsHistoryItem[];
+    nextCursor: string | null;
+    hasMore: boolean;
+    avatarsByName?: Record<string, string>;
+};
 type PlaysListOptions = {
     origin?: 'prebuilt' | 'owned';
     grep?: string;
@@ -3744,6 +3791,8 @@ type PlaysListPage = {
 type RunsGetOptions = {
     /** Return the raw status payload instead of the compact package. */
     full?: boolean;
+    /** Explicitly read this run's recorded graph and source, without full results. */
+    configuration?: boolean;
     /** Attach a bounded end-of-stream window for a failed run. */
     failedLogs?: boolean;
     /** Requested failed-log lines to attach (default 20, hard-capped at 20). */
@@ -3834,6 +3883,12 @@ type RunsLogsOptions = {
     all?: boolean;
     /** Read a terminal-failed run's last 20 retained lines, or fewer with `limit`. Retention loss returns an explicit association and warning. */
     failed?: boolean;
+    /**
+     * Continue with the next OLDER page: pass a prior result's `nextCursor`.
+     * The page holds the last `limit` stored lines before that cursor (with
+     * `all`, every stored line before it).
+     */
+    cursor?: string;
 };
 /** Retained text for one run. Counts and retention flags describe the stored stream, not every original console call. */
 type RunsLogsResult = {
@@ -3849,8 +3904,14 @@ type RunsLogsResult = {
     lastSequence: number | null;
     /** Tail/all: returned count is below total count. Failed: the stream lost bodies to retention. Check `logsTruncated` to distinguish retention loss from a selected tail. */
     truncated: boolean;
-    /** More retained lines exist after `lastSequence`; always false for the designed failure window. */
+    /** Older stored lines exist before this page; `nextCursor` reads them. */
     hasMore: boolean;
+    /**
+     * Opaque cursor for the next older page (`runs.logs(id, { cursor })`),
+     * null when this page reaches the oldest stored line. Absent for the failed
+     * view, which is a complete designed window rather than a pageable slice.
+     */
+    nextCursor?: string | null;
     /** Formatted text lines in stored sequence order; structured context is available through event search. */
     entries: string[];
     /** Selected public log view. */
@@ -4023,6 +4084,8 @@ type RunsNamespace = {
     list: (options: RunsListOptions) => Promise<PlayRunListItem[]>;
     /** Read one run page with total, offset, limit and completeness metadata. */
     listPage: (options: RunsListOptions) => Promise<RunsListPage>;
+    /** Search/page workspace run history newest first; follow empty continuing pages. */
+    history: (options?: RunsHistoryOptions) => Promise<RunsHistoryPage>;
     /** Poll run snapshots every two seconds until terminal status. */
     watch: (runId: string, options?: RunsWatchOptions) => Promise<PlayStatus>;
     /** @deprecated Use `watch`; retained as a source-compatible alias. */
@@ -5698,7 +5761,7 @@ declare class DeeplineClient {
      * 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 `--watch` completes.
+     * 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`
@@ -5794,7 +5857,7 @@ declare class DeeplineClient {
      * Get the current status of a play execution.
      *
      * Internal/advanced primitive. Public callers should usually prefer
-     * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run --watch`.
+     * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run`.
      *
      * @param workflowId - Play-run id from {@link startPlayRun}
      * @returns Current status with progress logs and partial results
@@ -5971,6 +6034,8 @@ declare class DeeplineClient {
      * ```
      */
     listRuns(options: RunsListOptions): Promise<PlayRunListItem[]>;
+    /** The same tenant-scoped run history searched by the dashboard and CLI. */
+    getRunsHistory(options?: RunsHistoryOptions): Promise<RunsHistoryPage>;
     /** Read one run page without discarding server pagination metadata. */
     listRunsPage(options: RunsListOptions): Promise<RunsListPage>;
     /** Read retained tool results without executing tools, preserving supplied key order and batching 100 keys per request. Obtain keys from exported evidence or execution metadata; each key must be nonempty, at most 2,048 characters and contain no CR, LF or NUL. Missing/expired results have an explicit per-key error. */
@@ -6626,4 +6691,4 @@ declare class DeeplineClient {
     }>;
 }
 
-export { type MonitorFleetStatus as $, DeeplineClient as A, type BillingNamespace as B, type ClearPlayHistoryResult as C, type DeeplineClientOptions as D, type ExecutionRecovery as E, type DeeplineToolCategory as F, type LiveEventEnvelope as G, MONITOR_JOB_RECONCILIATION_STATES as H, type IngestionStorageRepairResult as I, MONITOR_JOB_STATES as J, type MonitorBatchNamespace as K, type LegacyMonitorStatusFilter as L, MONITOR_JOB_PHASES as M, type MonitorCheckResult as N, type MonitorDefinition as O, type PlayListItem as P, type MonitorDeleteResult as Q, type ResolvedConfig as R, type StopPlayRunResult as S, type ToolDefinition as T, type MonitorDependents as U, type MonitorDeployResult as V, type MonitorDetail as W, type MonitorFleetDeactivateOptions as X, type MonitorFleetGetOptions as Y, type MonitorFleetReactivateOptions as Z, type MonitorFleetResult as _, type ToolMetadata as a, type PlaysListPage as a$, type MonitorFleetSyncOptions as a0, type MonitorFleetWaitOptions as a1, type MonitorFleetsNamespace as a2, type MonitorJobDeployOptions as a3, type MonitorJobLogsOptions as a4, type MonitorJobPhase as a5, type MonitorJobReconciliationState as a6, type MonitorJobResult as a7, type MonitorJobState as a8, type MonitorJobWaitOptions as a9, type PlayActivityState as aA, type PlayActivityTarget as aB, type PlayBootstrapEntityKind as aC, type PlayBootstrapFinderKind as aD, type PlayCostEstimate as aE, type PlayCronTriggerConfig as aF, type PlayLiveEvent as aG, type PlayPath as aH, type PlayRunActionPackage as aI, type PlayRunActivityProjection as aJ, type PlayRunDatasetActions as aK, type PlayRunPackage as aL, type PlayRunResult as aM, type PlayRunStart as aN, type PlaySettings as aO, type PlaySettingsPatch as aP, type PlaySettingsPathsPage as aQ, type PlaySettingsResult as aR, type PlaySheetRow as aS, type PlaySheetRowsResult as aT, type PlayTriggerConfigUpdate as aU, type PlayTriggerConfigUpdateResult as aV, type PlayTriggerConfigView as aW, type PlayWebhookAuthConfig as aX, type PlayWebhookTriggerConfig as aY, type PlaysActivityResponse as aZ, type PlaysListOptions as a_, type MonitorJobsNamespace as aa, type MonitorListEntry as ab, type MonitorPayload as ac, type MonitorReactivateResult as ad, type MonitorSpec as ae, type MonitorState as af, type MonitorStateFilter as ag, type MonitorUpdateChangeSummary as ah, type MonitorUpdateResult as ai, type MonitorsAccessStatus as aj, type MonitorsAvailableOptions as ak, type MonitorsAvailableResult as al, type MonitorsListOptions as am, type MonitorsListResult as an, type MonitorsNamespace as ao, PLAY_BOOTSTRAP_COMPANY_FIELDS as ap, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY as aq, PLAY_BOOTSTRAP_CONTACT_FIELDS as ar, PLAY_BOOTSTRAP_FINDER_KINDS as as, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER as at, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY as au, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER as av, PLAY_BOOTSTRAP_SOURCE_KINDS as aw, PLAY_BOOTSTRAP_STAGE_KINDS as ax, PLAY_BOOTSTRAP_TEMPLATES as ay, type PlayActivityObservation as az, type ExecutionByKeyResult as b, stageFileInputs as b$, type PublishPlayVersionRequest as b0, type RerunOptions as b1, type RerunPlayRunResult as b2, type RunChildrenPage as b3, type RunLifecycleStatus as b4, type RunToolReceiptResult as b5, type RunToolReceiptsResponse as b6, type RunsChildrenOptions as b7, type RunsEventPayload as b8, type RunsEventSearchEntry as b9, isStopAllPlayRunsDryRunResult as bA, CSV_DATA_INPUT_KEY as bB, type FileInputBinding as bC, type LocalFileInput as bD, type MintStagedFileUpload as bE, PLAY_FILES_STAGE_MINT_PATH as bF, PLAY_FILES_STAGE_PATH as bG, PLAY_RUN_START_PATH as bH, PLAY_RUN_START_STREAM_PATH as bI, type PlayRunHttp as bJ, type ResolvedStartPlayRunRequest as bK, STAGE_LEGACY_MULTIPART_MAX_BYTES as bL, type StagedFileCodec as bM, type StagedFileInputs as bN, type StagedFileUpload as bO, buildNamedPlayRunRequest as bP, buildPlayRunStartBody as bQ, createSessionPlayRunHttp as bR, createStagedFileUpload as bS, fileInputBindingsFromPlaySchema as bT, fileInputBindingsFromStaticPipeline as bU, getDottedInputValue as bV, isPlayRunPackage as bW, mintStagedPlayFileUploads as bX, normalizePlayRunStart as bY, playRunFileInputBindings as bZ, setDottedInputValue as b_, type RunsEventSearchOptions as ba, type RunsEventSearchResult as bb, type RunsListOptions as bc, type RunsListPage as bd, type RunsLogsOptions as be, type RunsLogsResult as bf, type RunsNamespace as bg, type RunsTailOptions as bh, type RunsWatchOptions as bi, type StartPlayRunRequest as bj, type StopAllCandidate as bk, type StopAllPlayRunsDryRunResult as bl, type StopAllPlayRunsResult as bm, type StopAllPlayRunsStopResult as bn, type StopAllRunsOptions as bo, type ToolExecution as bp, type ToolSearchOptions as bq, type ToolSearchResult as br, type WorkspaceCreateResult as bs, type WorkspacesNamespace as bt, defineMonitor as bu, formatPlayBootstrapFinderKinds as bv, formatPlayBootstrapFinderKindsForSentence as bw, formatPlayBootstrapTemplates as bx, isPlayBootstrapFinderKind as by, isPlayBootstrapTemplate as bz, type PlayDetail as c, stagePlayFiles as c0, stagedFileContentType as c1, startPlayRun as c2, webStagedFileCodec as c3, type PlayRunListItem as d, type PlayRevisionSummary as e, type PublishPlayVersionResult as f, type PlayStatus as g, type BillingCreditPool as h, type BillingInvoiceEntry as i, type BillingInvoicesResult as j, type BillingPaymentMethodSummary as k, type BillingRecentUsageEntry as l, type BillingSubscriptionCancelResult as m, type BillingSubscriptionStatus as n, type BillingTopUpReceipt as o, type BillingTopUpResult as p, type BillingUsageEvent as q, type BillingUsageOptions as r, type BillingUsageResult as s, type ChildRunSummary as t, type ClearPlayHistoryRequest as u, type CreateNotificationGroupInput as v, type CreateNotificationGroupResult as w, type CustomerDbQueryResult as x, DEEPLINE_TOOL_CATEGORIES as y, type DbNamespace as z };
+export { type MonitorFleetStatus as $, DeeplineClient as A, type BillingNamespace as B, type ClearPlayHistoryResult as C, type DeeplineClientOptions as D, type ExecutionRecovery as E, type DeeplineToolCategory as F, type LiveEventEnvelope as G, MONITOR_JOB_RECONCILIATION_STATES as H, type IngestionStorageRepairResult as I, MONITOR_JOB_STATES as J, type MonitorBatchNamespace as K, type LegacyMonitorStatusFilter as L, MONITOR_JOB_PHASES as M, type MonitorCheckResult as N, type MonitorDefinition as O, type PlayListItem as P, type MonitorDeleteResult as Q, type ResolvedConfig as R, type StopPlayRunResult as S, type ToolDefinition as T, type MonitorDependents as U, type MonitorDeployResult as V, type MonitorDetail as W, type MonitorFleetDeactivateOptions as X, type MonitorFleetGetOptions as Y, type MonitorFleetReactivateOptions as Z, type MonitorFleetResult as _, type ToolMetadata as a, type PlaysListPage as a$, type MonitorFleetSyncOptions as a0, type MonitorFleetWaitOptions as a1, type MonitorFleetsNamespace as a2, type MonitorJobDeployOptions as a3, type MonitorJobLogsOptions as a4, type MonitorJobPhase as a5, type MonitorJobReconciliationState as a6, type MonitorJobResult as a7, type MonitorJobState as a8, type MonitorJobWaitOptions as a9, type PlayActivityState as aA, type PlayActivityTarget as aB, type PlayBootstrapEntityKind as aC, type PlayBootstrapFinderKind as aD, type PlayCostEstimate as aE, type PlayCronTriggerConfig as aF, type PlayLiveEvent as aG, type PlayPath as aH, type PlayRunActionPackage as aI, type PlayRunActivityProjection as aJ, type PlayRunDatasetActions as aK, type PlayRunPackage as aL, type PlayRunResult as aM, type PlayRunStart as aN, type PlaySettings as aO, type PlaySettingsPatch as aP, type PlaySettingsPathsPage as aQ, type PlaySettingsResult as aR, type PlaySheetRow as aS, type PlaySheetRowsResult as aT, type PlayTriggerConfigUpdate as aU, type PlayTriggerConfigUpdateResult as aV, type PlayTriggerConfigView as aW, type PlayWebhookAuthConfig as aX, type PlayWebhookTriggerConfig as aY, type PlaysActivityResponse as aZ, type PlaysListOptions as a_, type MonitorJobsNamespace as aa, type MonitorListEntry as ab, type MonitorPayload as ac, type MonitorReactivateResult as ad, type MonitorSpec as ae, type MonitorState as af, type MonitorStateFilter as ag, type MonitorUpdateChangeSummary as ah, type MonitorUpdateResult as ai, type MonitorsAccessStatus as aj, type MonitorsAvailableOptions as ak, type MonitorsAvailableResult as al, type MonitorsListOptions as am, type MonitorsListResult as an, type MonitorsNamespace as ao, PLAY_BOOTSTRAP_COMPANY_FIELDS as ap, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY as aq, PLAY_BOOTSTRAP_CONTACT_FIELDS as ar, PLAY_BOOTSTRAP_FINDER_KINDS as as, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER as at, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY as au, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER as av, PLAY_BOOTSTRAP_SOURCE_KINDS as aw, PLAY_BOOTSTRAP_STAGE_KINDS as ax, PLAY_BOOTSTRAP_TEMPLATES as ay, type PlayActivityObservation as az, type ExecutionByKeyResult as b, normalizePlayRunStart as b$, type PublishPlayVersionRequest as b0, type RerunOptions as b1, type RerunPlayRunResult as b2, type RunChildrenPage as b3, type RunLifecycleStatus as b4, type RunToolReceiptResult as b5, type RunToolReceiptsResponse as b6, type RunsChildrenOptions as b7, type RunsEventPayload as b8, type RunsEventSearchEntry as b9, formatPlayBootstrapTemplates as bA, isPlayBootstrapFinderKind as bB, isPlayBootstrapTemplate as bC, isStopAllPlayRunsDryRunResult as bD, CSV_DATA_INPUT_KEY as bE, type FileInputBinding as bF, type LocalFileInput as bG, type MintStagedFileUpload as bH, PLAY_FILES_STAGE_MINT_PATH as bI, PLAY_FILES_STAGE_PATH as bJ, PLAY_RUN_START_PATH as bK, PLAY_RUN_START_STREAM_PATH as bL, type PlayRunHttp as bM, type ResolvedStartPlayRunRequest as bN, STAGE_LEGACY_MULTIPART_MAX_BYTES as bO, type StagedFileCodec as bP, type StagedFileInputs as bQ, type StagedFileUpload as bR, buildNamedPlayRunRequest as bS, buildPlayRunStartBody as bT, createSessionPlayRunHttp as bU, createStagedFileUpload as bV, fileInputBindingsFromPlaySchema as bW, fileInputBindingsFromStaticPipeline as bX, getDottedInputValue as bY, isPlayRunPackage as bZ, mintStagedPlayFileUploads as b_, type RunsEventSearchOptions as ba, type RunsEventSearchResult as bb, type RunsHistoryItem as bc, type RunsHistoryOptions as bd, type RunsHistoryPage as be, type RunsListOptions as bf, type RunsListPage as bg, type RunsLogsOptions as bh, type RunsLogsResult as bi, type RunsNamespace as bj, type RunsTailOptions as bk, type RunsWatchOptions as bl, type StartPlayRunRequest as bm, type StopAllCandidate as bn, type StopAllPlayRunsDryRunResult as bo, type StopAllPlayRunsResult as bp, type StopAllPlayRunsStopResult as bq, type StopAllRunsOptions as br, type ToolExecution as bs, type ToolSearchOptions as bt, type ToolSearchResult as bu, type WorkspaceCreateResult as bv, type WorkspacesNamespace as bw, defineMonitor as bx, formatPlayBootstrapFinderKinds as by, formatPlayBootstrapFinderKindsForSentence as bz, type PlayDetail as c, playRunFileInputBindings as c0, setDottedInputValue as c1, stageFileInputs as c2, stagePlayFiles as c3, stagedFileContentType as c4, startPlayRun as c5, webStagedFileCodec as c6, type PlayRunListItem as d, type PlayRevisionSummary as e, type PublishPlayVersionResult as f, type PlayStatus as g, type BillingCreditPool as h, type BillingInvoiceEntry as i, type BillingInvoicesResult as j, type BillingPaymentMethodSummary as k, type BillingRecentUsageEntry as l, type BillingSubscriptionCancelResult as m, type BillingSubscriptionStatus as n, type BillingTopUpReceipt as o, type BillingTopUpResult as p, type BillingUsageEvent as q, type BillingUsageOptions as r, type BillingUsageResult as s, type ChildRunSummary as t, type ClearPlayHistoryRequest as u, type CreateNotificationGroupInput as v, type CreateNotificationGroupResult as w, type CustomerDbQueryResult as x, DEEPLINE_TOOL_CATEGORIES as y, type DbNamespace as z };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { D as DeeplineClientOptions, B as BillingNamespace, T as ToolDefinition, a as ToolMetadata, E as ExecutionRecovery, b as ExecutionByKeyResult, P as PlayListItem, c as PlayDetail, d as PlayRunListItem, e as PlayRevisionSummary, f as PublishPlayVersionResult, C as ClearPlayHistoryResult, g as PlayStatus, S as StopPlayRunResult, R as ResolvedConfig } from './client-D9annc6K.mjs';
-export { h as BillingCreditPool, i as BillingInvoiceEntry, j as BillingInvoicesResult, k as BillingPaymentMethodSummary, l as BillingRecentUsageEntry, m as BillingSubscriptionCancelResult, n as BillingSubscriptionStatus, o as BillingTopUpReceipt, p as BillingTopUpResult, q as BillingUsageEvent, r as BillingUsageOptions, s as BillingUsageResult, t as ChildRunSummary, u as ClearPlayHistoryRequest, v as CreateNotificationGroupInput, w as CreateNotificationGroupResult, x as CustomerDbQueryResult, y as DEEPLINE_TOOL_CATEGORIES, z as DbNamespace, A as DeeplineClient, F as DeeplineToolCategory, I as IngestionStorageRepairResult, L as LegacyMonitorStatusFilter, G as LiveEventEnvelope, M as MONITOR_JOB_PHASES, H as MONITOR_JOB_RECONCILIATION_STATES, J as MONITOR_JOB_STATES, K as MonitorBatchNamespace, N as MonitorCheckResult, O as MonitorDefinition, Q as MonitorDeleteResult, U as MonitorDependents, V as MonitorDeployResult, W as MonitorDetail, X as MonitorFleetDeactivateOptions, Y as MonitorFleetGetOptions, Z as MonitorFleetReactivateOptions, _ as MonitorFleetResult, $ as MonitorFleetStatus, a0 as MonitorFleetSyncOptions, a1 as MonitorFleetWaitOptions, a2 as MonitorFleetsNamespace, a3 as MonitorJobDeployOptions, a4 as MonitorJobLogsOptions, a5 as MonitorJobPhase, a6 as MonitorJobReconciliationState, a7 as MonitorJobResult, a8 as MonitorJobState, a9 as MonitorJobWaitOptions, aa as MonitorJobsNamespace, ab as MonitorListEntry, ac as MonitorPayload, ad as MonitorReactivateResult, ae as MonitorSpec, af as MonitorState, ag as MonitorStateFilter, ah as MonitorUpdateChangeSummary, ai as MonitorUpdateResult, aj as MonitorsAccessStatus, ak as MonitorsAvailableOptions, al as MonitorsAvailableResult, am as MonitorsListOptions, an as MonitorsListResult, ao as MonitorsNamespace, ap as PLAY_BOOTSTRAP_COMPANY_FIELDS, aq as PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, ar as PLAY_BOOTSTRAP_CONTACT_FIELDS, as as PLAY_BOOTSTRAP_FINDER_KINDS, at as PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, au as PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, av as PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, aw as PLAY_BOOTSTRAP_SOURCE_KINDS, ax as PLAY_BOOTSTRAP_STAGE_KINDS, ay as PLAY_BOOTSTRAP_TEMPLATES, az as PlayActivityObservation, aA as PlayActivityState, aB as PlayActivityTarget, aC as PlayBootstrapEntityKind, aD as PlayBootstrapFinderKind, aE as PlayCostEstimate, aF as PlayCronTriggerConfig, aG as PlayLiveEvent, aH as PlayPath, aI as PlayRunActionPackage, aJ as PlayRunActivityProjection, aK as PlayRunDatasetActions, aL as PlayRunPackage, aM as PlayRunResult, aN as PlayRunStart, aO as PlaySettings, aP as PlaySettingsPatch, aQ as PlaySettingsPathsPage, aR as PlaySettingsResult, aS as PlaySheetRow, aT as PlaySheetRowsResult, aU as PlayTriggerConfigUpdate, aV as PlayTriggerConfigUpdateResult, aW as PlayTriggerConfigView, aX as PlayWebhookAuthConfig, aY as PlayWebhookTriggerConfig, aZ as PlaysActivityResponse, a_ as PlaysListOptions, a$ as PlaysListPage, b0 as PublishPlayVersionRequest, b1 as RerunOptions, b2 as RerunPlayRunResult, b3 as RunChildrenPage, b4 as RunLifecycleStatus, b5 as RunToolReceiptResult, b6 as RunToolReceiptsResponse, b7 as RunsChildrenOptions, b8 as RunsEventPayload, b9 as RunsEventSearchEntry, ba as RunsEventSearchOptions, bb as RunsEventSearchResult, bc as RunsListOptions, bd as RunsListPage, be as RunsLogsOptions, bf as RunsLogsResult, bg as RunsNamespace, bh as RunsTailOptions, bi as RunsWatchOptions, bj as StartPlayRunRequest, bk as StopAllCandidate, bl as StopAllPlayRunsDryRunResult, bm as StopAllPlayRunsResult, bn as StopAllPlayRunsStopResult, bo as StopAllRunsOptions, bp as ToolExecution, bq as ToolSearchOptions, br as ToolSearchResult, bs as WorkspaceCreateResult, bt as WorkspacesNamespace, bu as defineMonitor, bv as formatPlayBootstrapFinderKinds, bw as formatPlayBootstrapFinderKindsForSentence, bx as formatPlayBootstrapTemplates, by as isPlayBootstrapFinderKind, bz as isPlayBootstrapTemplate, bA as isStopAllPlayRunsDryRunResult } from './client-D9annc6K.mjs';
+import { D as DeeplineClientOptions, B as BillingNamespace, T as ToolDefinition, a as ToolMetadata, E as ExecutionRecovery, b as ExecutionByKeyResult, P as PlayListItem, c as PlayDetail, d as PlayRunListItem, e as PlayRevisionSummary, f as PublishPlayVersionResult, C as ClearPlayHistoryResult, g as PlayStatus, S as StopPlayRunResult, R as ResolvedConfig } from './client-CbNvJLgV.mjs';
+export { h as BillingCreditPool, i as BillingInvoiceEntry, j as BillingInvoicesResult, k as BillingPaymentMethodSummary, l as BillingRecentUsageEntry, m as BillingSubscriptionCancelResult, n as BillingSubscriptionStatus, o as BillingTopUpReceipt, p as BillingTopUpResult, q as BillingUsageEvent, r as BillingUsageOptions, s as BillingUsageResult, t as ChildRunSummary, u as ClearPlayHistoryRequest, v as CreateNotificationGroupInput, w as CreateNotificationGroupResult, x as CustomerDbQueryResult, y as DEEPLINE_TOOL_CATEGORIES, z as DbNamespace, A as DeeplineClient, F as DeeplineToolCategory, I as IngestionStorageRepairResult, L as LegacyMonitorStatusFilter, G as LiveEventEnvelope, M as MONITOR_JOB_PHASES, H as MONITOR_JOB_RECONCILIATION_STATES, J as MONITOR_JOB_STATES, K as MonitorBatchNamespace, N as MonitorCheckResult, O as MonitorDefinition, Q as MonitorDeleteResult, U as MonitorDependents, V as MonitorDeployResult, W as MonitorDetail, X as MonitorFleetDeactivateOptions, Y as MonitorFleetGetOptions, Z as MonitorFleetReactivateOptions, _ as MonitorFleetResult, $ as MonitorFleetStatus, a0 as MonitorFleetSyncOptions, a1 as MonitorFleetWaitOptions, a2 as MonitorFleetsNamespace, a3 as MonitorJobDeployOptions, a4 as MonitorJobLogsOptions, a5 as MonitorJobPhase, a6 as MonitorJobReconciliationState, a7 as MonitorJobResult, a8 as MonitorJobState, a9 as MonitorJobWaitOptions, aa as MonitorJobsNamespace, ab as MonitorListEntry, ac as MonitorPayload, ad as MonitorReactivateResult, ae as MonitorSpec, af as MonitorState, ag as MonitorStateFilter, ah as MonitorUpdateChangeSummary, ai as MonitorUpdateResult, aj as MonitorsAccessStatus, ak as MonitorsAvailableOptions, al as MonitorsAvailableResult, am as MonitorsListOptions, an as MonitorsListResult, ao as MonitorsNamespace, ap as PLAY_BOOTSTRAP_COMPANY_FIELDS, aq as PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, ar as PLAY_BOOTSTRAP_CONTACT_FIELDS, as as PLAY_BOOTSTRAP_FINDER_KINDS, at as PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, au as PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, av as PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, aw as PLAY_BOOTSTRAP_SOURCE_KINDS, ax as PLAY_BOOTSTRAP_STAGE_KINDS, ay as PLAY_BOOTSTRAP_TEMPLATES, az as PlayActivityObservation, aA as PlayActivityState, aB as PlayActivityTarget, aC as PlayBootstrapEntityKind, aD as PlayBootstrapFinderKind, aE as PlayCostEstimate, aF as PlayCronTriggerConfig, aG as PlayLiveEvent, aH as PlayPath, aI as PlayRunActionPackage, aJ as PlayRunActivityProjection, aK as PlayRunDatasetActions, aL as PlayRunPackage, aM as PlayRunResult, aN as PlayRunStart, aO as PlaySettings, aP as PlaySettingsPatch, aQ as PlaySettingsPathsPage, aR as PlaySettingsResult, aS as PlaySheetRow, aT as PlaySheetRowsResult, aU as PlayTriggerConfigUpdate, aV as PlayTriggerConfigUpdateResult, aW as PlayTriggerConfigView, aX as PlayWebhookAuthConfig, aY as PlayWebhookTriggerConfig, aZ as PlaysActivityResponse, a_ as PlaysListOptions, a$ as PlaysListPage, b0 as PublishPlayVersionRequest, b1 as RerunOptions, b2 as RerunPlayRunResult, b3 as RunChildrenPage, b4 as RunLifecycleStatus, b5 as RunToolReceiptResult, b6 as RunToolReceiptsResponse, b7 as RunsChildrenOptions, b8 as RunsEventPayload, b9 as RunsEventSearchEntry, ba as RunsEventSearchOptions, bb as RunsEventSearchResult, bc as RunsHistoryItem, bd as RunsHistoryOptions, be as RunsHistoryPage, bf as RunsListOptions, bg as RunsListPage, bh as RunsLogsOptions, bi as RunsLogsResult, bj as RunsNamespace, bk as RunsTailOptions, bl as RunsWatchOptions, bm as StartPlayRunRequest, bn as StopAllCandidate, bo as StopAllPlayRunsDryRunResult, bp as StopAllPlayRunsResult, bq as StopAllPlayRunsStopResult, br as StopAllRunsOptions, bs as ToolExecution, bt as ToolSearchOptions, bu as ToolSearchResult, bv as WorkspaceCreateResult, bw as WorkspacesNamespace, bx as defineMonitor, by as formatPlayBootstrapFinderKinds, bz as formatPlayBootstrapFinderKindsForSentence, bA as formatPlayBootstrapTemplates, bB as isPlayBootstrapFinderKind, bC as isPlayBootstrapTemplate, bD as isStopAllPlayRunsDryRunResult } from './client-CbNvJLgV.mjs';
 import { A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringAsyncCallOptions, y as PlayAuthoringBindings, z as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, D as PlayAuthoringInputContract, E as PlayRunId$1, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions, S as DeeplineError, U as ToolExecutionError, V as ToolExecutionErrorOptions } from './compiler-manifest-C1bKB9bY.mjs';
 export { W as CtxFetchHttpError, X as DEEPLINE_EXTRACTOR_TARGETS, Y as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, Z as DeeplineEmailStatusGetterValue, _ as DeeplineExtractorTarget, $ as DeeplineGetterValue, a0 as DeeplineGetterValueMap, a1 as JOB_CHANGE_STATUS_VALUES, a2 as JobChangeStatus, a3 as PHONE_STATUS_VALUES, a4 as PhoneStatus, a5 as PlayDataset, a6 as PlayDatasetInput, a7 as PreviousCell, a8 as ProviderTransientError, a9 as ProviderTransientErrorCategory, aa as ProviderUnavailableError, ab as ProviderUnavailableReason, ac as ToolExecutionErrorCategory, ad as ToolExecutionErrorOrigin, ae as ToolExecutionFailureV1, af as ToolExecutionNetworkKind, ag as ToolExecutionNetworkScope, ah as ToolExecutionPublicDetails, ai as ToolResultBilling, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-C1bKB9bY.mjs';
 export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.mjs';
@@ -203,16 +203,10 @@ type CsvOptions = PlayAuthoringCsvOptions;
  */
 type DeeplinePlayRuntimeContext = PlayAuthoringRuntimeContext;
 /**
- * Handle to a running play execution.
- *
- * Provides methods to check status, stream logs, wait for completion,
- * or cancel the execution.
- *
- * This handle is the SDK-context equivalent of `deepline plays run --watch` and
- * `POST /api/v2/plays/run`: every surface returns a run id first, then exposes
- * the completed user output through `PlayJob.get()` or the status endpoint's
- * `result` field. Runtime logs are available from `status().progress.logs` and
- * are intentionally separate from the returned output object.
+ * Handle to a Play execution: inspect status, stream logs, await output, or cancel.
+ * Like `deepline plays run` and `POST /api/v2/plays/run`, it returns a run id first.
+ * Read completed output through `PlayJob.get()` or the status endpoint's `result` field;
+ * runtime logs in `status().progress.logs` are separate from that output.
  *
  * @typeParam TOutput - The play's return type
  *

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { D as DeeplineClientOptions, B as BillingNamespace, T as ToolDefinition, a as ToolMetadata, E as ExecutionRecovery, b as ExecutionByKeyResult, P as PlayListItem, c as PlayDetail, d as PlayRunListItem, e as PlayRevisionSummary, f as PublishPlayVersionResult, C as ClearPlayHistoryResult, g as PlayStatus, S as StopPlayRunResult, R as ResolvedConfig } from './client-5xpuGpRn.js';
-export { h as BillingCreditPool, i as BillingInvoiceEntry, j as BillingInvoicesResult, k as BillingPaymentMethodSummary, l as BillingRecentUsageEntry, m as BillingSubscriptionCancelResult, n as BillingSubscriptionStatus, o as BillingTopUpReceipt, p as BillingTopUpResult, q as BillingUsageEvent, r as BillingUsageOptions, s as BillingUsageResult, t as ChildRunSummary, u as ClearPlayHistoryRequest, v as CreateNotificationGroupInput, w as CreateNotificationGroupResult, x as CustomerDbQueryResult, y as DEEPLINE_TOOL_CATEGORIES, z as DbNamespace, A as DeeplineClient, F as DeeplineToolCategory, I as IngestionStorageRepairResult, L as LegacyMonitorStatusFilter, G as LiveEventEnvelope, M as MONITOR_JOB_PHASES, H as MONITOR_JOB_RECONCILIATION_STATES, J as MONITOR_JOB_STATES, K as MonitorBatchNamespace, N as MonitorCheckResult, O as MonitorDefinition, Q as MonitorDeleteResult, U as MonitorDependents, V as MonitorDeployResult, W as MonitorDetail, X as MonitorFleetDeactivateOptions, Y as MonitorFleetGetOptions, Z as MonitorFleetReactivateOptions, _ as MonitorFleetResult, $ as MonitorFleetStatus, a0 as MonitorFleetSyncOptions, a1 as MonitorFleetWaitOptions, a2 as MonitorFleetsNamespace, a3 as MonitorJobDeployOptions, a4 as MonitorJobLogsOptions, a5 as MonitorJobPhase, a6 as MonitorJobReconciliationState, a7 as MonitorJobResult, a8 as MonitorJobState, a9 as MonitorJobWaitOptions, aa as MonitorJobsNamespace, ab as MonitorListEntry, ac as MonitorPayload, ad as MonitorReactivateResult, ae as MonitorSpec, af as MonitorState, ag as MonitorStateFilter, ah as MonitorUpdateChangeSummary, ai as MonitorUpdateResult, aj as MonitorsAccessStatus, ak as MonitorsAvailableOptions, al as MonitorsAvailableResult, am as MonitorsListOptions, an as MonitorsListResult, ao as MonitorsNamespace, ap as PLAY_BOOTSTRAP_COMPANY_FIELDS, aq as PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, ar as PLAY_BOOTSTRAP_CONTACT_FIELDS, as as PLAY_BOOTSTRAP_FINDER_KINDS, at as PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, au as PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, av as PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, aw as PLAY_BOOTSTRAP_SOURCE_KINDS, ax as PLAY_BOOTSTRAP_STAGE_KINDS, ay as PLAY_BOOTSTRAP_TEMPLATES, az as PlayActivityObservation, aA as PlayActivityState, aB as PlayActivityTarget, aC as PlayBootstrapEntityKind, aD as PlayBootstrapFinderKind, aE as PlayCostEstimate, aF as PlayCronTriggerConfig, aG as PlayLiveEvent, aH as PlayPath, aI as PlayRunActionPackage, aJ as PlayRunActivityProjection, aK as PlayRunDatasetActions, aL as PlayRunPackage, aM as PlayRunResult, aN as PlayRunStart, aO as PlaySettings, aP as PlaySettingsPatch, aQ as PlaySettingsPathsPage, aR as PlaySettingsResult, aS as PlaySheetRow, aT as PlaySheetRowsResult, aU as PlayTriggerConfigUpdate, aV as PlayTriggerConfigUpdateResult, aW as PlayTriggerConfigView, aX as PlayWebhookAuthConfig, aY as PlayWebhookTriggerConfig, aZ as PlaysActivityResponse, a_ as PlaysListOptions, a$ as PlaysListPage, b0 as PublishPlayVersionRequest, b1 as RerunOptions, b2 as RerunPlayRunResult, b3 as RunChildrenPage, b4 as RunLifecycleStatus, b5 as RunToolReceiptResult, b6 as RunToolReceiptsResponse, b7 as RunsChildrenOptions, b8 as RunsEventPayload, b9 as RunsEventSearchEntry, ba as RunsEventSearchOptions, bb as RunsEventSearchResult, bc as RunsListOptions, bd as RunsListPage, be as RunsLogsOptions, bf as RunsLogsResult, bg as RunsNamespace, bh as RunsTailOptions, bi as RunsWatchOptions, bj as StartPlayRunRequest, bk as StopAllCandidate, bl as StopAllPlayRunsDryRunResult, bm as StopAllPlayRunsResult, bn as StopAllPlayRunsStopResult, bo as StopAllRunsOptions, bp as ToolExecution, bq as ToolSearchOptions, br as ToolSearchResult, bs as WorkspaceCreateResult, bt as WorkspacesNamespace, bu as defineMonitor, bv as formatPlayBootstrapFinderKinds, bw as formatPlayBootstrapFinderKindsForSentence, bx as formatPlayBootstrapTemplates, by as isPlayBootstrapFinderKind, bz as isPlayBootstrapTemplate, bA as isStopAllPlayRunsDryRunResult } from './client-5xpuGpRn.js';
+import { D as DeeplineClientOptions, B as BillingNamespace, T as ToolDefinition, a as ToolMetadata, E as ExecutionRecovery, b as ExecutionByKeyResult, P as PlayListItem, c as PlayDetail, d as PlayRunListItem, e as PlayRevisionSummary, f as PublishPlayVersionResult, C as ClearPlayHistoryResult, g as PlayStatus, S as StopPlayRunResult, R as ResolvedConfig } from './client-5zY7LsId.js';
+export { h as BillingCreditPool, i as BillingInvoiceEntry, j as BillingInvoicesResult, k as BillingPaymentMethodSummary, l as BillingRecentUsageEntry, m as BillingSubscriptionCancelResult, n as BillingSubscriptionStatus, o as BillingTopUpReceipt, p as BillingTopUpResult, q as BillingUsageEvent, r as BillingUsageOptions, s as BillingUsageResult, t as ChildRunSummary, u as ClearPlayHistoryRequest, v as CreateNotificationGroupInput, w as CreateNotificationGroupResult, x as CustomerDbQueryResult, y as DEEPLINE_TOOL_CATEGORIES, z as DbNamespace, A as DeeplineClient, F as DeeplineToolCategory, I as IngestionStorageRepairResult, L as LegacyMonitorStatusFilter, G as LiveEventEnvelope, M as MONITOR_JOB_PHASES, H as MONITOR_JOB_RECONCILIATION_STATES, J as MONITOR_JOB_STATES, K as MonitorBatchNamespace, N as MonitorCheckResult, O as MonitorDefinition, Q as MonitorDeleteResult, U as MonitorDependents, V as MonitorDeployResult, W as MonitorDetail, X as MonitorFleetDeactivateOptions, Y as MonitorFleetGetOptions, Z as MonitorFleetReactivateOptions, _ as MonitorFleetResult, $ as MonitorFleetStatus, a0 as MonitorFleetSyncOptions, a1 as MonitorFleetWaitOptions, a2 as MonitorFleetsNamespace, a3 as MonitorJobDeployOptions, a4 as MonitorJobLogsOptions, a5 as MonitorJobPhase, a6 as MonitorJobReconciliationState, a7 as MonitorJobResult, a8 as MonitorJobState, a9 as MonitorJobWaitOptions, aa as MonitorJobsNamespace, ab as MonitorListEntry, ac as MonitorPayload, ad as MonitorReactivateResult, ae as MonitorSpec, af as MonitorState, ag as MonitorStateFilter, ah as MonitorUpdateChangeSummary, ai as MonitorUpdateResult, aj as MonitorsAccessStatus, ak as MonitorsAvailableOptions, al as MonitorsAvailableResult, am as MonitorsListOptions, an as MonitorsListResult, ao as MonitorsNamespace, ap as PLAY_BOOTSTRAP_COMPANY_FIELDS, aq as PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, ar as PLAY_BOOTSTRAP_CONTACT_FIELDS, as as PLAY_BOOTSTRAP_FINDER_KINDS, at as PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, au as PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, av as PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, aw as PLAY_BOOTSTRAP_SOURCE_KINDS, ax as PLAY_BOOTSTRAP_STAGE_KINDS, ay as PLAY_BOOTSTRAP_TEMPLATES, az as PlayActivityObservation, aA as PlayActivityState, aB as PlayActivityTarget, aC as PlayBootstrapEntityKind, aD as PlayBootstrapFinderKind, aE as PlayCostEstimate, aF as PlayCronTriggerConfig, aG as PlayLiveEvent, aH as PlayPath, aI as PlayRunActionPackage, aJ as PlayRunActivityProjection, aK as PlayRunDatasetActions, aL as PlayRunPackage, aM as PlayRunResult, aN as PlayRunStart, aO as PlaySettings, aP as PlaySettingsPatch, aQ as PlaySettingsPathsPage, aR as PlaySettingsResult, aS as PlaySheetRow, aT as PlaySheetRowsResult, aU as PlayTriggerConfigUpdate, aV as PlayTriggerConfigUpdateResult, aW as PlayTriggerConfigView, aX as PlayWebhookAuthConfig, aY as PlayWebhookTriggerConfig, aZ as PlaysActivityResponse, a_ as PlaysListOptions, a$ as PlaysListPage, b0 as PublishPlayVersionRequest, b1 as RerunOptions, b2 as RerunPlayRunResult, b3 as RunChildrenPage, b4 as RunLifecycleStatus, b5 as RunToolReceiptResult, b6 as RunToolReceiptsResponse, b7 as RunsChildrenOptions, b8 as RunsEventPayload, b9 as RunsEventSearchEntry, ba as RunsEventSearchOptions, bb as RunsEventSearchResult, bc as RunsHistoryItem, bd as RunsHistoryOptions, be as RunsHistoryPage, bf as RunsListOptions, bg as RunsListPage, bh as RunsLogsOptions, bi as RunsLogsResult, bj as RunsNamespace, bk as RunsTailOptions, bl as RunsWatchOptions, bm as StartPlayRunRequest, bn as StopAllCandidate, bo as StopAllPlayRunsDryRunResult, bp as StopAllPlayRunsResult, bq as StopAllPlayRunsStopResult, br as StopAllRunsOptions, bs as ToolExecution, bt as ToolSearchOptions, bu as ToolSearchResult, bv as WorkspaceCreateResult, bw as WorkspacesNamespace, bx as defineMonitor, by as formatPlayBootstrapFinderKinds, bz as formatPlayBootstrapFinderKindsForSentence, bA as formatPlayBootstrapTemplates, bB as isPlayBootstrapFinderKind, bC as isPlayBootstrapTemplate, bD as isStopAllPlayRunsDryRunResult } from './client-5zY7LsId.js';
 import { A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringAsyncCallOptions, y as PlayAuthoringBindings, z as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, D as PlayAuthoringInputContract, E as PlayRunId$1, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions, S as DeeplineError, U as ToolExecutionError, V as ToolExecutionErrorOptions } from './compiler-manifest-C1bKB9bY.js';
 export { W as CtxFetchHttpError, X as DEEPLINE_EXTRACTOR_TARGETS, Y as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, Z as DeeplineEmailStatusGetterValue, _ as DeeplineExtractorTarget, $ as DeeplineGetterValue, a0 as DeeplineGetterValueMap, a1 as JOB_CHANGE_STATUS_VALUES, a2 as JobChangeStatus, a3 as PHONE_STATUS_VALUES, a4 as PhoneStatus, a5 as PlayDataset, a6 as PlayDatasetInput, a7 as PreviousCell, a8 as ProviderTransientError, a9 as ProviderTransientErrorCategory, aa as ProviderUnavailableError, ab as ProviderUnavailableReason, ac as ToolExecutionErrorCategory, ad as ToolExecutionErrorOrigin, ae as ToolExecutionFailureV1, af as ToolExecutionNetworkKind, ag as ToolExecutionNetworkScope, ah as ToolExecutionPublicDetails, ai as ToolResultBilling, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-C1bKB9bY.js';
 export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.js';
@@ -203,16 +203,10 @@ type CsvOptions = PlayAuthoringCsvOptions;
  */
 type DeeplinePlayRuntimeContext = PlayAuthoringRuntimeContext;
 /**
- * Handle to a running play execution.
- *
- * Provides methods to check status, stream logs, wait for completion,
- * or cancel the execution.
- *
- * This handle is the SDK-context equivalent of `deepline plays run --watch` and
- * `POST /api/v2/plays/run`: every surface returns a run id first, then exposes
- * the completed user output through `PlayJob.get()` or the status endpoint's
- * `result` field. Runtime logs are available from `status().progress.logs` and
- * are intentionally separate from the returned output object.
+ * Handle to a Play execution: inspect status, stream logs, await output, or cancel.
+ * Like `deepline plays run` and `POST /api/v2/plays/run`, it returns a run id first.
+ * Read completed output through `PlayJob.get()` or the status endpoint's `result` field;
+ * runtime logs in `status().progress.logs` are separate from that output.
  *
  * @typeParam TOutput - The play's return type
  *