deepline 0.3.201 → 0.3.202

package/dist/index.d.mts

@@ -142,11 +142,36 @@ type FixtureResponseSample = {
     httpError?: {
         status: number;
         message: string;
+        /** Omitted preserves the historical one-second 429 response. */
+        retryAfterMs?: number;
+        retryAfterFormat?: 'delta_seconds' | 'http_date';
+        /** Omitted preserves a permanent configured HTTP error. */
+        failuresBeforeSuccess?: number;
     };
 };
 type FixtureBehaviorV2 = {
     version: typeof FIXTURE_BEHAVIOR_RESPONSE_VERSION;
     responseSamples: FixtureResponseSample[];
+    transient429?: FixtureTransient429;
+    sharedRateLimit?: FixtureSharedRateLimit;
+};
+/** Synthetic provider quotas shared by all calls in the fixture workspace. */
+type FixtureSharedRateLimit = {
+    requestsPerSecond?: number;
+    requestsPerMinute?: number;
+    requestsPerHour?: number;
+    /** Test-only target for the next hourly boundary, anchored by the first DB quota attempt. */
+    requestsPerHourBoundaryAfterMs?: number;
+};
+type FixtureTransient429 = {
+    /** Select one of every N stable tool-call identities. */
+    everyNthCall: number;
+    retryAfterMs: number;
+    failuresBeforeSuccess: number;
+    when?: {
+        provider?: string;
+        operation?: string;
+    };
 };
 type FixtureReplayBundle = {
     bundleId: string;
@@ -157,6 +182,8 @@ type FixtureBehaviorV3 = {
     version: typeof FIXTURE_BEHAVIOR_REPLAY_VERSION;
     responseSamples: FixtureResponseSample[];
     replayBundle: FixtureReplayBundle;
+    transient429?: FixtureTransient429;
+    sharedRateLimit?: FixtureSharedRateLimit;
 };
 type FixtureBehavior = FixtureBehaviorV1 | FixtureBehaviorV2 | FixtureBehaviorV3;
 
@@ -1680,6 +1707,14 @@ interface PlayRunPackage {
         path: string;
         tableNamespace?: string;
         rowCount?: number;
+        /** The materialized dataset count is exact only after this lifecycle completes. */
+        lifecycle?: {
+            phase: 'registered' | 'available' | 'failed';
+            complete: boolean;
+            persistedRowsAtLeast: number;
+            succeededRowsAtLeast: number;
+            failedRowsAtLeast: number;
+        };
         sqlTableName?: string;
         sqlQualifiedTableName?: string;
         recovered?: true;
@@ -3013,6 +3048,9 @@ type EnrichCompiledConfig = {
     };
 };
 
+/** The only lifecycle states exposed by the API, SDK, CLI, and UI. */
+type PlayRunPublicStatus = 'queued' | 'running' | 'waiting' | 'completed' | 'failed' | 'cancelled';
+
 type SlackNotificationTarget = {
     channel: string;
     memberId?: never;
@@ -3348,6 +3386,8 @@ type PlaySecretCheck = {
 type RunsNamespace = {
     /** Get current run status by public run id. */
     get: (runId: string, options?: RunsGetOptions) => Promise<PlayStatus>;
+    /** Read bounded scalar lifecycle and confirmed work counts only. */
+    status: (runId: string) => Promise<RunLifecycleStatus>;
     /** Explicitly read the retained original input (may include customer data). */
     input: (runId: string) => Promise<{
         runId: string;
@@ -3374,6 +3414,8 @@ type RunsNamespace = {
         limit?: number;
         offset?: number;
         rowMode?: 'output' | 'all';
+        /** Cancel the page request, including its response body and retry waits. */
+        signal?: AbortSignal;
     }) => Promise<PlaySheetRowsResult>;
     /** Stop a running/waiting run. */
     stop: (runId: string, options?: {
@@ -3393,6 +3435,88 @@ type RunsNamespace = {
         (options?: StopAllRunsOptions): Promise<StopAllPlayRunsResult>;
     };
 };
+/** Result of the bounded `/api/v2/runs/:runId/status` endpoint. */
+type RunLifecycleStatus = {
+    available: false;
+    runId: string;
+} | {
+    available: true;
+    runId: string;
+    lifecycle: {
+        status: PlayRunPublicStatus;
+        updatedAt: number;
+        startedAt: number | null;
+        finishedAt: number | null;
+    };
+    steps: {
+        observed: number;
+        running: number;
+        completed: number;
+        failed: number;
+        skipped: number;
+        confirmed: boolean;
+    };
+    /** Sums across observed step.progress records, not unique output rows. */
+    mapStepWork: {
+        sourceSteps: number;
+        completed: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        total: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        failed: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        startedRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        activeRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        waitingRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        completedRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        supersededRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+    };
+    datasets: {
+        observed: number;
+        persistedRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        succeededRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        failedRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        complete: {
+            value: boolean | null;
+            confirmed: boolean;
+        };
+    };
+    wait: {
+        kind: string | null;
+        until: number | null;
+        confirmed: boolean;
+    };
+};
 /** Options for {@link RunsNamespace.stopAll} / {@link DeeplineClient.stopAllRuns}. */
 type StopAllRunsOptions = {
     /** Enumerate the candidate runs without cancelling or mutating anything. */
@@ -5133,6 +5257,8 @@ declare class DeeplineClient {
      * ```
      */
     getRunStatus(runId: string, options?: RunsGetOptions): Promise<PlayStatus>;
+    /** Read only the bounded scalar projection; does not hydrate the run package. */
+    getRunLifecycleStatus(runId: string): Promise<RunLifecycleStatus>;
     /**
      * List play runs using the public runs resource model.
      *
@@ -5219,6 +5345,8 @@ declare class DeeplineClient {
         limit?: number;
         offset?: number;
         rowMode?: 'output' | 'all';
+        /** Cancel the page request, including its response body and retry waits. */
+        signal?: AbortSignal;
     }): Promise<PlaySheetRowsResult>;
     /**
      * Stop a run by id using the public runs resource model.
@@ -6800,4 +6928,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, type RunLifecycleStatus, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.d.ts

@@ -142,11 +142,36 @@ type FixtureResponseSample = {
     httpError?: {
         status: number;
         message: string;
+        /** Omitted preserves the historical one-second 429 response. */
+        retryAfterMs?: number;
+        retryAfterFormat?: 'delta_seconds' | 'http_date';
+        /** Omitted preserves a permanent configured HTTP error. */
+        failuresBeforeSuccess?: number;
     };
 };
 type FixtureBehaviorV2 = {
     version: typeof FIXTURE_BEHAVIOR_RESPONSE_VERSION;
     responseSamples: FixtureResponseSample[];
+    transient429?: FixtureTransient429;
+    sharedRateLimit?: FixtureSharedRateLimit;
+};
+/** Synthetic provider quotas shared by all calls in the fixture workspace. */
+type FixtureSharedRateLimit = {
+    requestsPerSecond?: number;
+    requestsPerMinute?: number;
+    requestsPerHour?: number;
+    /** Test-only target for the next hourly boundary, anchored by the first DB quota attempt. */
+    requestsPerHourBoundaryAfterMs?: number;
+};
+type FixtureTransient429 = {
+    /** Select one of every N stable tool-call identities. */
+    everyNthCall: number;
+    retryAfterMs: number;
+    failuresBeforeSuccess: number;
+    when?: {
+        provider?: string;
+        operation?: string;
+    };
 };
 type FixtureReplayBundle = {
     bundleId: string;
@@ -157,6 +182,8 @@ type FixtureBehaviorV3 = {
     version: typeof FIXTURE_BEHAVIOR_REPLAY_VERSION;
     responseSamples: FixtureResponseSample[];
     replayBundle: FixtureReplayBundle;
+    transient429?: FixtureTransient429;
+    sharedRateLimit?: FixtureSharedRateLimit;
 };
 type FixtureBehavior = FixtureBehaviorV1 | FixtureBehaviorV2 | FixtureBehaviorV3;
 
@@ -1680,6 +1707,14 @@ interface PlayRunPackage {
         path: string;
         tableNamespace?: string;
         rowCount?: number;
+        /** The materialized dataset count is exact only after this lifecycle completes. */
+        lifecycle?: {
+            phase: 'registered' | 'available' | 'failed';
+            complete: boolean;
+            persistedRowsAtLeast: number;
+            succeededRowsAtLeast: number;
+            failedRowsAtLeast: number;
+        };
         sqlTableName?: string;
         sqlQualifiedTableName?: string;
         recovered?: true;
@@ -3013,6 +3048,9 @@ type EnrichCompiledConfig = {
     };
 };
 
+/** The only lifecycle states exposed by the API, SDK, CLI, and UI. */
+type PlayRunPublicStatus = 'queued' | 'running' | 'waiting' | 'completed' | 'failed' | 'cancelled';
+
 type SlackNotificationTarget = {
     channel: string;
     memberId?: never;
@@ -3348,6 +3386,8 @@ type PlaySecretCheck = {
 type RunsNamespace = {
     /** Get current run status by public run id. */
     get: (runId: string, options?: RunsGetOptions) => Promise<PlayStatus>;
+    /** Read bounded scalar lifecycle and confirmed work counts only. */
+    status: (runId: string) => Promise<RunLifecycleStatus>;
     /** Explicitly read the retained original input (may include customer data). */
     input: (runId: string) => Promise<{
         runId: string;
@@ -3374,6 +3414,8 @@ type RunsNamespace = {
         limit?: number;
         offset?: number;
         rowMode?: 'output' | 'all';
+        /** Cancel the page request, including its response body and retry waits. */
+        signal?: AbortSignal;
     }) => Promise<PlaySheetRowsResult>;
     /** Stop a running/waiting run. */
     stop: (runId: string, options?: {
@@ -3393,6 +3435,88 @@ type RunsNamespace = {
         (options?: StopAllRunsOptions): Promise<StopAllPlayRunsResult>;
     };
 };
+/** Result of the bounded `/api/v2/runs/:runId/status` endpoint. */
+type RunLifecycleStatus = {
+    available: false;
+    runId: string;
+} | {
+    available: true;
+    runId: string;
+    lifecycle: {
+        status: PlayRunPublicStatus;
+        updatedAt: number;
+        startedAt: number | null;
+        finishedAt: number | null;
+    };
+    steps: {
+        observed: number;
+        running: number;
+        completed: number;
+        failed: number;
+        skipped: number;
+        confirmed: boolean;
+    };
+    /** Sums across observed step.progress records, not unique output rows. */
+    mapStepWork: {
+        sourceSteps: number;
+        completed: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        total: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        failed: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        startedRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        activeRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        waitingRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        completedRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        supersededRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+    };
+    datasets: {
+        observed: number;
+        persistedRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        succeededRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        failedRows: {
+            value: number | null;
+            confirmed: boolean;
+        };
+        complete: {
+            value: boolean | null;
+            confirmed: boolean;
+        };
+    };
+    wait: {
+        kind: string | null;
+        until: number | null;
+        confirmed: boolean;
+    };
+};
 /** Options for {@link RunsNamespace.stopAll} / {@link DeeplineClient.stopAllRuns}. */
 type StopAllRunsOptions = {
     /** Enumerate the candidate runs without cancelling or mutating anything. */
@@ -5133,6 +5257,8 @@ declare class DeeplineClient {
      * ```
      */
     getRunStatus(runId: string, options?: RunsGetOptions): Promise<PlayStatus>;
+    /** Read only the bounded scalar projection; does not hydrate the run package. */
+    getRunLifecycleStatus(runId: string): Promise<RunLifecycleStatus>;
     /**
      * List play runs using the public runs resource model.
      *
@@ -5219,6 +5345,8 @@ declare class DeeplineClient {
         limit?: number;
         offset?: number;
         rowMode?: 'output' | 'all';
+        /** Cancel the page request, including its response body and retry waits. */
+        signal?: AbortSignal;
     }): Promise<PlaySheetRowsResult>;
     /**
      * Stop a run by id using the public runs resource model.
@@ -6800,4 +6928,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, type RunLifecycleStatus, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.js

@@ -864,7 +864,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.201",
+  version: "0.3.202",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -1428,6 +1428,11 @@ var MAX_DIAGNOSTIC_HEADER_LENGTH = 120;
 var COWORK_NETWORK_HINT = "Claude Cowork appears to be running Deepline in a network-restricted sandbox. In Claude Desktop, open Settings > Capabilities, turn on Allow network egress, and set Domain allowlist to All domains for the Cowork session.";
 var REQUEST_TIMEOUT_MARKER = Symbol("deeplineRequestTimeout");
 var REQUEST_ABORT_MARKER = Symbol("deeplineRequestAbort");
+function requestCancelledError(signal) {
+  const error = withErrorCause(new Error("Request aborted"), signal.reason);
+  error[REQUEST_ABORT_MARKER] = true;
+  return error;
+}
 function normalizeRequestAbortError(error, input) {
   const normalized = error instanceof Error ? error : new Error(String(error));
   const tagged = normalized;
@@ -1606,14 +1611,27 @@ var HttpClient = class {
     const candidateUrls = options?.exactUrlOnly ? [url] : buildCandidateUrls(url);
     let retryAfterDelayMs = null;
     const maxRetries = options?.maxRetries ?? this.config.maxRetries;
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    requestAttempts: for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      if (options?.signal?.aborted) {
+        lastError = requestCancelledError(options.signal);
+        break;
+      }
       if (attempt > 0) {
         const backoffMs = Math.min(1e3 * Math.pow(2, attempt - 1), 3e4);
         const delayMs = retryAfterDelayMs === null ? backoffMs : Math.max(backoffMs, retryAfterDelayMs);
         retryAfterDelayMs = null;
-        await sleep(delayMs);
+        try {
+          await sleep(delayMs, options?.signal);
+        } catch (error) {
+          lastError = error instanceof Error ? error : new Error(String(error));
+          break;
+        }
       }
       for (const candidateUrl of candidateUrls) {
+        if (options?.signal?.aborted) {
+          lastError = requestCancelledError(options.signal);
+          break requestAttempts;
+        }
         const controller = new AbortController();
         const timeoutMs = options?.timeout ?? this.config.timeout;
         let requestTimedOut = false;
@@ -1621,6 +1639,10 @@ var HttpClient = class {
           requestTimedOut = true;
           controller.abort();
         }, timeoutMs);
+        const abortRequest = () => controller.abort();
+        options?.signal?.addEventListener("abort", abortRequest, {
+          once: true
+        });
         try {
           const response = await fetch(candidateUrl, {
             method,
@@ -1633,8 +1655,8 @@ var HttpClient = class {
             clearTimeout(timeoutId);
             return null;
           }
-          clearTimeout(timeoutId);
           const body = await response.text();
+          clearTimeout(timeoutId);
           const parsed = parseResponseBody(body);
           const structuredToolError = options?.toolId && !response.ok ? deserializeToolExecutionFailure(
             apiErrorMessage(parsed, response.status),
@@ -1729,6 +1751,10 @@ var HttpClient = class {
           return parsed;
         } catch (error) {
           clearTimeout(timeoutId);
+          if (options?.signal?.aborted) {
+            lastError = requestCancelledError(options.signal);
+            break requestAttempts;
+          }
           if (error instanceof AuthError || error instanceof DeeplineError) {
             throw error;
           }
@@ -1740,6 +1766,9 @@ var HttpClient = class {
             timeoutMs,
             timedOut: requestTimedOut
           });
+        } finally {
+          clearTimeout(timeoutId);
+          options?.signal?.removeEventListener("abort", abortRequest);
         }
       }
       if (attempt < maxRetries) continue;
@@ -2068,8 +2097,23 @@ function decodeSseFrame(frame) {
   }
   return parsed;
 }
-function sleep(ms) {
-  return new Promise((resolve2) => setTimeout(resolve2, ms));
+function sleep(ms, signal) {
+  return new Promise((resolve2, reject) => {
+    if (signal?.aborted) {
+      reject(requestCancelledError(signal));
+      return;
+    }
+    const timeoutId = setTimeout(() => {
+      signal?.removeEventListener("abort", abort);
+      resolve2();
+    }, ms);
+    const abort = () => {
+      clearTimeout(timeoutId);
+      signal?.removeEventListener("abort", abort);
+      reject(requestCancelledError(signal));
+    };
+    signal?.addEventListener("abort", abort, { once: true });
+  });
 }
 function withCoworkNetworkHint(message) {
   if (!isCoworkLikeSandbox2() || message.includes(COWORK_NETWORK_HINT)) {
@@ -3231,9 +3275,13 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
       tableNamespace: optionalString(rawDataset.tableNamespace) ?? datasetId,
       phase,
       persistedRows: Math.max(0, finiteNumber(rawDataset.persistedRows) ?? 0),
+      persistedRowsObserved: rawDataset.persistedRowsObserved === true,
       succeededRows: Math.max(0, finiteNumber(rawDataset.succeededRows) ?? 0),
+      succeededRowsObserved: rawDataset.succeededRowsObserved === true,
       failedRows: Math.max(0, finiteNumber(rawDataset.failedRows) ?? 0),
+      failedRowsObserved: rawDataset.failedRowsObserved === true,
       complete: rawDataset.complete === true,
+      completeObserved: rawDataset.completeObserved === true,
       // ADR 0019 birth survives the snapshot round trip. A partial record is
       // dropped rather than half-admitted, so a dataset either states where its
       // rows came from or says nothing.
@@ -4894,6 +4942,7 @@ var DeeplineClient = class _DeeplineClient {
     this.http = new HttpClient(this.config);
     this.runs = {
       get: (runId, options2) => this.getRunStatus(runId, options2),
+      status: (runId) => this.getRunLifecycleStatus(runId),
       list: (options2) => this.listRuns(options2),
       listPage: (options2) => this.listRunsPage(options2),
       tail: (runId, options2) => this.tailRun(runId, options2),
@@ -6306,6 +6355,13 @@ var DeeplineClient = class _DeeplineClient {
       }
     };
   }
+  /** Read only the bounded scalar projection; does not hydrate the run package. */
+  async getRunLifecycleStatus(runId) {
+    const response = await this.http.get(
+      `/api/v2/runs/${encodeURIComponent(runId)}/status`
+    );
+    return response;
+  }
   /**
    * List play runs using the public runs resource model.
    *
@@ -6699,7 +6755,8 @@ var DeeplineClient = class _DeeplineClient {
       params.set("rowMode", "all");
     }
     const result = await this.http.get(
-      `/api/v2/plays/${encodeURIComponent(input.playName)}/sheet?${params.toString()}`
+      `/api/v2/plays/${encodeURIComponent(input.playName)}/sheet?${params.toString()}`,
+      { signal: input.signal }
     );
     const requestedRunId = input.runId?.trim() || "";
     if (requestedRunId) {