deepline 0.3.274 → 0.3.275

package/dist/{client-D6fRwhnE.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. */
@@ -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-2rIHKJiq.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. */
@@ -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-2rIHKJiq.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-2rIHKJiq.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` 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-D6fRwhnE.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-D6fRwhnE.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` 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.js

@@ -1325,7 +1325,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.274",
+  version: "0.3.275",
   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
@@ -3846,6 +3846,28 @@ async function* watchRunEvents(options) {
   }
 }
 
+// src/runs/log-cursor.ts
+var RUN_LOGS_CURSOR_PREFIX = "before:";
+function encodeRunLogsCursor(beforeSequence) {
+  return `${RUN_LOGS_CURSOR_PREFIX}${beforeSequence}`;
+}
+function isRunLogsCursor(value) {
+  return value.startsWith(RUN_LOGS_CURSOR_PREFIX);
+}
+function parseRunLogsCursor(value) {
+  const raw = isRunLogsCursor(value) ? value.slice(RUN_LOGS_CURSOR_PREFIX.length) : "";
+  const parsed = /^[1-9]\d*$/.test(raw) ? Number(raw) : NaN;
+  if (!Number.isSafeInteger(parsed)) {
+    throw Object.assign(
+      new Error(
+        `Invalid run log cursor ${JSON.stringify(value)}. Pass the nextCursor value from a previous deepline runs logs result.`
+      ),
+      { exitCode: 2 }
+    );
+  }
+  return parsed;
+}
+
 // src/types.ts
 function isStopAllPlayRunsDryRunResult(result) {
   return "dryRun" in result && result.dryRun === true;
@@ -4665,6 +4687,7 @@ var DeeplineClient = class _DeeplineClient {
       status: (runId) => this.getRunLifecycleStatus(runId),
       list: (options2) => this.listRuns(options2),
       listPage: (options2) => this.listRunsPage(options2),
+      history: (options2) => this.getRunsHistory(options2),
       watch: (runId, options2) => this.watchRunToTerminal(runId, options2),
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
@@ -5742,11 +5765,21 @@ var DeeplineClient = class _DeeplineClient {
     if (options?.full === true) {
       params.set("full", "true");
     }
+    if (options?.configuration === true) {
+      params.set("include", "configuration");
+    }
     const query = params.size > 0 ? `?${params.toString()}` : "";
     const response = await this.http.get(
       `/api/v2/runs/${encodeURIComponent(runId)}${query}`,
       { headers: { "x-deepline-run-status": "1" } }
     );
+    if (options?.configuration === true && !Object.hasOwn(response, "contract")) {
+      throw new DeeplineError(
+        "This server does not support recorded configuration reads.",
+        void 0,
+        "RUN_CONFIGURATION_UNAVAILABLE"
+      );
+    }
     const status = normalizePlayStatus(response);
     if (options?.failedLogs !== true || status.status !== "failed") {
       return status;
@@ -5834,6 +5867,33 @@ var DeeplineClient = class _DeeplineClient {
   async listRuns(options) {
     return (await this.listRunsPage(options)).runs;
   }
+  /** The same tenant-scoped run history searched by the dashboard and CLI. */
+  async getRunsHistory(options = {}) {
+    const params = new URLSearchParams();
+    const search = options.search?.trim();
+    if (search && search.length > 200) {
+      throw new Error("Run search must be at most 200 characters.");
+    }
+    if (options.type && options.type !== "all" && !search) {
+      throw new Error("runs.history options.type requires options.search.");
+    }
+    if (search) params.set("search", search);
+    if (search && options.type) params.set("type", options.type);
+    if (options.cursor) params.set("cursor", options.cursor);
+    if (options.orgId) params.set("orgId", options.orgId);
+    if (options.limit !== void 0) {
+      if (!Number.isSafeInteger(options.limit) || options.limit < 1) {
+        throw new Error(
+          "runs.history options.limit must be a positive integer."
+        );
+      }
+      params.set("limit", String(options.limit));
+    }
+    return this.http.get(
+      `/api/v2/dashboard/runs-history?${params.toString()}`,
+      { signal: options.signal }
+    );
+  }
   /** Read one run page without discarding server pagination metadata. */
   async listRunsPage(options) {
     const playName = options.play?.trim();
@@ -5940,6 +6000,13 @@ var DeeplineClient = class _DeeplineClient {
         "INVALID_RUN_LOG_VIEW"
       );
     }
+    if (options?.cursor !== void 0 && options.failed === true) {
+      throw new DeeplineError(
+        "runs.logs cannot combine failed with cursor.",
+        void 0,
+        "INVALID_RUN_LOG_VIEW"
+      );
+    }
     if (options?.failed === true) {
       const requestedLimit = typeof options.limit === "number" && Number.isFinite(options.limit) && options.limit > 0 ? Math.trunc(options.limit) : RUNS_FAILED_LOG_LIMIT;
       const failedLimit = Math.min(RUNS_FAILED_LOG_LIMIT, requestedLimit);
@@ -5965,6 +6032,7 @@ var DeeplineClient = class _DeeplineClient {
         ...page.logsTruncated ? { logsTruncated: true } : {}
       };
     }
+    const beforeSequence = options?.cursor !== void 0 ? parseRunLogsCursor(options.cursor) : null;
     const limit = options?.all ? Number.MAX_SAFE_INTEGER : typeof options?.limit === "number" && Number.isFinite(options.limit) && options.limit > 0 ? Math.trunc(options.limit) : 200;
     const fetchPage = (afterSeq2, pageLimit) => this.http.get(
       `/api/v2/runs/${encodeURIComponent(runId)}/logs?afterSeq=${afterSeq2}&limit=${pageLimit}`,
@@ -5972,24 +6040,33 @@ var DeeplineClient = class _DeeplineClient {
     );
     const probe = await fetchPage(0, 1);
     const lastStoredSeq = probe.lastStoredSeq;
-    let afterSeq = options?.all ? 0 : Math.max(0, lastStoredSeq - limit);
+    const oldestStoredSeq = probe.entries[0]?.seq ?? null;
+    const upperSeq = beforeSequence === null ? Number.POSITIVE_INFINITY : Math.min(beforeSequence - 1, lastStoredSeq);
+    const windowEndSeq = Math.min(upperSeq, lastStoredSeq);
+    let afterSeq = options?.all ? 0 : Math.max(0, windowEndSeq - limit);
     const entries = [];
-    while (entries.length < limit) {
+    while (entries.length < limit && afterSeq < upperSeq) {
       const page = await fetchPage(
         afterSeq,
-        Math.min(RUN_LOGS_PAGE_LIMIT, limit - entries.length)
+        Math.min(
+          RUN_LOGS_PAGE_LIMIT,
+          limit - entries.length,
+          upperSeq - afterSeq
+        )
       );
-      if (page.entries.length === 0) {
+      const inWindow = page.entries.filter((entry) => entry.seq <= upperSeq);
+      if (inWindow.length === 0) {
         break;
       }
-      entries.push(...page.entries);
-      afterSeq = page.entries[page.entries.length - 1].seq;
-      if (!page.hasMore) {
+      entries.push(...inWindow);
+      afterSeq = inWindow[inWindow.length - 1].seq;
+      if (!page.hasMore || inWindow.length < page.entries.length) {
         break;
       }
     }
     const firstSequence = entries.length > 0 ? entries[0].seq : null;
     const lastSequence = entries.length > 0 ? entries[entries.length - 1].seq : null;
+    const olderLinesExist = firstSequence !== null && oldestStoredSeq !== null && firstSequence > oldestStoredSeq;
     return {
       runId: probe.runId,
       totalCount: probe.totalLogCount,
@@ -5997,7 +6074,8 @@ var DeeplineClient = class _DeeplineClient {
       firstSequence,
       lastSequence,
       truncated: entries.length < probe.totalLogCount,
-      hasMore: lastSequence !== null && lastSequence < lastStoredSeq,
+      hasMore: olderLinesExist,
+      nextCursor: olderLinesExist ? encodeRunLogsCursor(firstSequence) : null,
       entries: entries.map((entry) => entry.line),
       view: options?.all ? "all" : "tail",
       ...probe.logsTruncated ? { logsTruncated: true } : {}