deepline 0.3.392 → 0.3.394

package/dist/{client-Uxuy-xQ2.d.ts → client-C3O1Ipf3.d.ts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { g as PlayCompilerManifest, ak as ToolResultBilling, Y as BillingEntitlements } from './compiler-manifest-CY2v8ab0.js';
+import { g as PlayCompilerManifest, ak as ToolResultBilling, Y as BillingEntitlements } from './compiler-manifest-DLxUY5kI.js';
 import { z } from 'zod';
 import { MonitorFleetDefinition } from './monitor-fleet-contract.js';
 
@@ -308,6 +308,30 @@ type FixtureBehaviorV3 = {
 };
 type FixtureBehavior = FixtureBehaviorV1 | FixtureBehaviorV2 | FixtureBehaviorV3;
 
+/** Declarative request predicates authored by the server, with no provider knowledge in clients. */
+type ToolRequestCondition = {
+    field: string;
+    operator: 'equals';
+    value: string | number | boolean | null;
+} | {
+    field: string;
+    operator: 'number_equals';
+    value: number;
+} | {
+    field: string;
+    operator: 'present_nonblank';
+} | {
+    all: readonly ToolRequestCondition[];
+} | {
+    any: readonly ToolRequestCondition[];
+};
+type ToolRequestWarningRule = {
+    code: string;
+    /** Customer-safe Deepline billing guidance; never upstream spend. */
+    message: string;
+    when: ToolRequestCondition;
+};
+
 type PlayGrepMatch = {
     field: 'name' | 'description' | 'provider' | 'source';
     terms: string[];
@@ -1710,6 +1734,8 @@ interface ToolDefinition extends ToolExecutionMetadataFields {
         message: string;
         execution?: 'terminal' | 'forward';
     };
+    /** Ordered server-authored request warnings. The CLI prints the first match before dispatch. */
+    requestWarnings?: readonly ToolRequestWarningRule[];
     /**
      * Connection status for discovery: `managed` (Deepline-run credentials),
      * `connected` (your own credential is connected), or `requires_connection`
@@ -3344,6 +3370,12 @@ interface PlayCheckToolGetterHint {
  * ```
  */
 interface StartPlayRunRequest {
+    /** Tenant pin supplied by admission capability discovery; recovery must preserve it. */
+    admissionOrgId?: string;
+    /** Caller-owned canonical run ID. Reuse it to reconcile or replay an ambiguous start. */
+    workflowId?: string;
+    /** Strict total Deepline spend ceiling, including compute. Unbounded workloads are refused before admission. */
+    maxTotalCredits?: number;
     /** Play name for registered revisions. */
     name?: string;
     /** Explicit revision ID when the caller wants a specific saved version. */
@@ -3924,6 +3956,34 @@ interface PlayStagedFileRef {
     bytes: number;
 }
 
+type RuntimeSheetRunRowMembership = {
+    runId: string;
+    datasetId: string;
+    rowKey: string;
+    phase: 'admitted' | 'terminal';
+    /** Durable terminal row version distinguishes repair within an attempt. */
+    generation: string;
+    attemptSeq: number | null;
+    rowVersion: number | null;
+    inputIndex: number | null;
+    inputDigest: string;
+    status: 'pending' | 'enriched' | 'failed' | 'cancelled';
+    data: Record<string, unknown>;
+    source: Record<string, unknown>;
+    recordedAt: string;
+};
+type RuntimeSheetRunRowMembershipPage = {
+    entries: RuntimeSheetRunRowMembership[];
+    nextCursor: string | null;
+    coverage: {
+        complete: boolean;
+        expectedRows: number | null;
+        captureStartedAt: string | null;
+        captureCompletedAt: string | null;
+        reason: 'storage_not_expanded' | 'legacy_or_capture_not_enabled' | 'capture_in_progress' | 'complete';
+    };
+};
+
 /**
  * The one client-side construction of a Play run start.
  *
@@ -3954,6 +4014,7 @@ declare const PLAY_FILES_STAGE_MINT_PATH = "/api/v2/plays/files/stage/mint";
  * responses so the staging fallbacks below classify failures identically.
  */
 interface PlayRunHttp {
+    get?<T = unknown>(path: string): Promise<T>;
     post<T = unknown>(path: string, body: unknown, headers?: Record<string, string>, options?: {
         maxRetries?: number;
         exactUrlOnly?: boolean;
@@ -3976,7 +4037,20 @@ declare function buildPlayRunStartBody(request: ResolvedStartPlayRunRequest): Re
  * or times out, and retrying without an idempotency key can create a second
  * root run, so callers resolve ambiguous failures explicitly.
  */
-declare function startPlayRun(http: PlayRunHttp, request: ResolvedStartPlayRunRequest, headers?: Record<string, string>): Promise<PlayRunStart>;
+declare function preparePlayRunAdmission(http: PlayRunHttp, request: ResolvedStartPlayRunRequest, onSubmission?: (intent: {
+    workflowId: string;
+    orgId: string;
+    request: Record<string, unknown>;
+}) => void | Promise<void>): Promise<{
+    body: Record<string, unknown>;
+    workflowId?: string;
+    supportsCallerIntent: boolean;
+}>;
+declare function startPlayRun(http: PlayRunHttp, request: ResolvedStartPlayRunRequest, headers?: Record<string, string>, onSubmission?: (intent: {
+    workflowId: string;
+    orgId: string;
+    request: Record<string, unknown>;
+}) => void | Promise<void>): Promise<PlayRunStart>;
 declare function isPlayRunPackage(value: unknown): value is PlayRunPackage;
 /** Normalize any run-start response shape to `{ workflowId, … }`. */
 declare function normalizePlayRunStart(raw: Record<string, unknown>): PlayRunStart;
@@ -4644,6 +4718,13 @@ type PlaySheetRowsResult = {
     customerDbUrl?: string;
     deltaCursor?: number;
 };
+type PlayRunRowHistoryOptions = {
+    playName: string;
+    runId: string;
+    tableNamespace: string;
+    limit?: number;
+    cursor?: string;
+};
 type PlaySecretMetadata = {
     _id: string;
     orgId: string;
@@ -4720,6 +4801,8 @@ type RunsNamespace = {
         /** Cancel the page request, including its response body and retry waits. */
         signal?: AbortSignal;
     }) => Promise<PlaySheetRowsResult>;
+    /** One immutable history page; incomplete legacy coverage stays explicit. */
+    rowHistory: (input: PlayRunRowHistoryOptions) => Promise<RuntimeSheetRunRowMembershipPage>;
     /** Stop a running/waiting run. */
     stop: (runId: string, options?: {
         reason?: string;
@@ -5922,6 +6005,8 @@ type BillingUsageResult = {
  * @sdkReference client 030 client.billing
  */
 type BillingNamespace = {
+    /** Read a bounded sandbox-session estimate; excludes tools and Customer DB. */
+    quote: (input: BillingQuoteRequest) => Promise<BillingQuoteResult>;
     /** Current workspace provider benefits; discovery does not authorize a call. */
     entitlements: () => Promise<BillingEntitlements>;
     /** Charge the saved payment method and add Deepline credits to the active workspace. */
@@ -5994,6 +6079,31 @@ type BillingNamespace = {
         url: string;
     }>;
 };
+type BillingQuoteRequest = {
+    quantity: number;
+    sandbox_runtime: {
+        timeout?: string;
+        size?: 'standard';
+    };
+};
+type BillingQuoteResult = {
+    scope: 'sandbox_session';
+    quantity: number;
+    resources: {
+        timeoutSeconds: number;
+        memoryGiB: number;
+        cpu: number;
+        diskGiB: number;
+    };
+    maximum_credits: number;
+    maximum_billing_seconds: number;
+    total_play_credits: null;
+    total_budget_supported: false;
+    unbounded_components: string[];
+    explanation: string;
+    plan_version_id: string;
+    rate_card_id: string;
+};
 /**
  * Low-level typed REST client with authentication, retries, and localhost failover.
  *
@@ -6228,7 +6338,31 @@ declare class DeeplineClient {
      * });
      * ```
      */
-    startPlayRun(request: StartPlayRunRequest): Promise<PlayRunStart>;
+    startPlayRun(request: StartPlayRunRequest, options?: {
+        onSubmission?: (intent: {
+            workflowId: string;
+            orgId: string;
+            request: Record<string, unknown>;
+        }) => void | Promise<void>;
+    }): Promise<PlayRunStart>;
+    /**
+     * Prepare a tenant-scoped start intent without executing it. Its stream
+     * sender retains the exact body and transport selected during preparation.
+     */
+    preparePlayRunAdmission(request: StartPlayRunRequest, options?: {
+        onSubmission?: (intent: {
+            workflowId: string;
+            orgId: string;
+            request: Record<string, unknown>;
+        }) => void | Promise<void>;
+    }): Promise<{
+        startStream(streamOptions?: {
+            signal?: AbortSignal;
+        }): AsyncGenerator<PlayLiveEvent, void, unknown>;
+        body: Record<string, unknown>;
+        workflowId?: string;
+        supportsCallerIntent: boolean;
+    }>;
     /**
      * Submit a play run through the legacy event response.
      *
@@ -6244,6 +6378,11 @@ declare class DeeplineClient {
      */
     startPlayRunStream(request: StartPlayRunRequest, options?: {
         signal?: AbortSignal;
+        onSubmission?: (intent: {
+            workflowId: string;
+            orgId: string;
+            request: Record<string, unknown>;
+        }) => void | Promise<void>;
     }): AsyncGenerator<PlayLiveEvent>;
     /**
      * Register a bundled play artifact.
@@ -6719,6 +6858,11 @@ declare class DeeplineClient {
     private assertRunLogQueryRunId;
     /** Read structured history across the active organization without requiring a run ID. Defaults to the last hour, newest first; use the returned cursor and exact time bounds to continue. See [run logs and events](run-events.md) for all kinds, indexed fields, payloads and SDK/API response types. */
     searchRunEvents(options?: RunsEventSearchOptions): Promise<RunsEventSearchResult>;
+    /**
+     * Read one page of immutable admitted and terminal rows for a Play Run dataset.
+     * Follow nextCursor; coverage explicitly identifies unavailable or incomplete history.
+     */
+    getPlayRunRowHistory(input: PlayRunRowHistoryOptions): Promise<RuntimeSheetRunRowMembershipPage>;
     /**
      * Export persisted runtime-sheet rows for a play dataset/table namespace.
      *
@@ -6803,6 +6947,11 @@ declare class DeeplineClient {
     }>;
     /** Read product-notification destinations, subscriptions, event catalog, and DLQ health. */
     getNotificationSettings(): Promise<ProductNotificationSettings>;
+    /** Save provider-owned credential fields without starting an OAuth browser flow. */
+    setIntegrationCredentials(provider: string, credentials: Record<string, string>): Promise<{
+        ok: boolean;
+        credential_saved?: boolean;
+    }>;
     /** Start the Slack OAuth flow required by product notifications. */
     connectNotificationSlack(options?: {
         successUrl?: string;
@@ -7348,4 +7497,4 @@ declare class DeeplineClient {
     }>;
 }
 
-export { type MonitorFleetGetOptions as $, type CustomerDbQueryPlan as A, type BillingNamespace as B, type ClearPlayHistoryResult as C, type DeeplineClientOptions as D, type ExecuteToolRawOptions as E, type CustomerDbQueryResult as F, DEEPLINE_TOOL_CATEGORIES as G, type DbNamespace as H, type DeeplineToolCategory as I, type IngestionStorageRepairResult as J, type LiveEventEnvelope as K, type LegacyMonitorStatusFilter as L, MONITOR_JOB_PHASES as M, MONITOR_JOB_RECONCILIATION_STATES as N, MONITOR_JOB_STATES as O, type PlayListItem as P, type MonitorBatchNamespace as Q, type ResolvedConfig as R, type StopPlayRunResult as S, type ToolDefinition as T, type MonitorCheckResult as U, type MonitorDefinition as V, type MonitorDeleteResult as W, type MonitorDependents as X, type MonitorDeployResult as Y, type MonitorDetail as Z, type MonitorFleetDeactivateOptions as _, type ToolMetadata as a, type RunEventFieldOperators as a$, type MonitorFleetReactivateOptions as a0, type MonitorFleetResult as a1, type MonitorFleetStatus as a2, type MonitorFleetSyncOptions as a3, type MonitorFleetWaitOptions as a4, type MonitorFleetsNamespace as a5, type MonitorJobDeployOptions as a6, type MonitorJobLogsOptions as a7, type MonitorJobPhase as a8, type MonitorJobReconciliationState as a9, type PlayRunActionPackage as aA, type PlayRunActivityProjection as aB, type PlayRunDatasetActions as aC, type PlayRunPackage as aD, type PlayRunResult as aE, type PlayRunStart as aF, type PlaySettings as aG, type PlaySettingsPatch as aH, type PlaySettingsPathsPage as aI, type PlaySettingsResult as aJ, type PlaySheetRow as aK, type PlaySheetRowsResult as aL, type PlayTriggerConfigUpdate as aM, type PlayTriggerConfigUpdateResult as aN, type PlayTriggerConfigView as aO, type PlayWebhookAuthConfig as aP, type PlayWebhookTriggerConfig as aQ, type PlaysActivityResponse as aR, type PlaysListOptions as aS, type PlaysListPage as aT, type PublishPlayVersionRequest as aU, type RerunOptions as aV, type RerunPlayRunResult as aW, type RunChildrenPage as aX, type RunEventCountResult as aY, type RunEventField as aZ, type RunEventFieldDescriptor as a_, type MonitorJobResult as aa, type MonitorJobState as ab, type MonitorJobWaitOptions as ac, type MonitorJobsNamespace as ad, type MonitorListEntry as ae, type MonitorPayload as af, type MonitorReactivateResult as ag, type MonitorSpec as ah, type MonitorState as ai, type MonitorStateFilter as aj, type MonitorUpdateChangeSummary as ak, type MonitorUpdateResult as al, type MonitorsAccessStatus as am, type MonitorsAvailableOptions as an, type MonitorsAvailableResult as ao, type MonitorsListOptions as ap, type MonitorsListResult as aq, type MonitorsNamespace as ar, type NormalizedRunEventQuery as as, type PlayActivityObservation as at, type PlayActivityState as au, type PlayActivityTarget as av, type PlayCostEstimate as aw, type PlayCronTriggerConfig as ax, type PlayLiveEvent as ay, type PlayPath as az, type ExecutionRecovery as b, planCustomerDbQuery as b$, type RunEventFieldsResult as b0, type RunEventGroupValue as b1, type RunEventMeasure as b2, type RunEventQueryCriteria as b3, type RunEventQueryEvent as b4, RunEventQueryInputError as b5, type RunEventQueryOptions as b6, type RunEventQueryPage as b7, type RunEventQueryRetention as b8, type RunEventScalar as b9, type RunsLogsNamespace as bA, type RunsLogsOptions as bB, type RunsLogsQueryOptions as bC, type RunsLogsQueryResult as bD, type RunsLogsResult as bE, type RunsLogsSummaryOptions as bF, type RunsLogsSummaryResult as bG, type RunsNamespace as bH, type RunsTailOptions as bI, type RunsWatchOptions as bJ, type SearchOptions as bK, type SearchResult as bL, type SearchResultItem as bM, type SearchType as bN, type StartPlayRunRequest as bO, type StopAllCandidate as bP, type StopAllPlayRunsDryRunResult as bQ, type StopAllPlayRunsResult as bR, type StopAllPlayRunsStopResult as bS, type StopAllRunsOptions as bT, type ToolExecution as bU, type ToolSearchOptions as bV, type ToolSearchResult as bW, type WorkspaceCreateResult as bX, type WorkspacesNamespace as bY, defineMonitor as bZ, isStopAllPlayRunsDryRunResult as b_, type RunEventSummaryOptions as ba, type RunEventSummaryResult as bb, type RunEventWhere as bc, type RunLifecycleStatus as bd, type RunToolReceiptResult as be, type RunToolReceiptsResponse as bf, type RunsChildrenOptions as bg, type RunsEventPayload as bh, type RunsEventSearchEntry as bi, type RunsEventSearchOptions as bj, type RunsEventSearchResult as bk, type RunsEventsCountResult as bl, type RunsEventsCriteria as bm, type RunsEventsFieldsOptions as bn, type RunsEventsListOptions as bo, type RunsEventsListResult as bp, type RunsEventsNamespace as bq, type RunsEventsSummaryOptions as br, type RunsEventsSummaryResult as bs, type RunsHistoryItem as bt, type RunsHistoryOptions as bu, type RunsHistoryPage as bv, type RunsListOptions as bw, type RunsListPage as bx, type RunsLogCriteria as by, type RunsLogsCountResult as bz, type ExecutionByKeyResult as c, CSV_DATA_INPUT_KEY as c0, type FileInputBinding as c1, type LocalFileInput as c2, type MintStagedFileUpload as c3, PLAY_FILES_STAGE_MINT_PATH as c4, PLAY_FILES_STAGE_PATH as c5, PLAY_RUN_START_PATH as c6, PLAY_RUN_START_STREAM_PATH as c7, type PlayRunHttp as c8, type ResolvedStartPlayRunRequest as c9, STAGE_LEGACY_MULTIPART_MAX_BYTES as ca, type StagedFileCodec as cb, type StagedFileInputs as cc, type StagedFileUpload as cd, buildNamedPlayRunRequest as ce, buildPlayRunStartBody as cf, createSessionPlayRunHttp as cg, createStagedFileUpload as ch, fileInputBindingsFromPlaySchema as ci, fileInputBindingsFromStaticPipeline as cj, getDottedInputValue as ck, isPlayRunPackage as cl, mintStagedPlayFileUploads as cm, normalizePlayRunStart as cn, playRunFileInputBindings as co, setDottedInputValue as cp, stageFileInputs as cq, stagePlayFiles as cr, stagedFileContentType as cs, startPlayRun as ct, webStagedFileCodec as cu, type PlayDetail as d, type PlayRunListItem as e, type PlayRevisionSummary as f, type PublishPlayVersionResult as g, type PlayStatus as h, DeeplineClient as i, type BillingCreditPool as j, type BillingInvoiceEntry as k, type BillingInvoicesResult as l, type BillingPaymentMethodSummary as m, type BillingRecentUsageEntry as n, type BillingSubscriptionCancelResult as o, type BillingSubscriptionStatus as p, type BillingTopUpReceipt as q, type BillingTopUpResult as r, type BillingUsageEvent as s, type BillingUsageOptions as t, type BillingUsageResult as u, type ChildRunSummary as v, type ClearPlayHistoryRequest as w, type CreateNotificationGroupInput as x, type CreateNotificationGroupResult as y, type CustomerDbQueryOptions as z };
+export { type MonitorDetail as $, type CreateNotificationGroupResult as A, type BillingNamespace as B, type ClearPlayHistoryResult as C, type DeeplineClientOptions as D, type ExecuteToolRawOptions as E, type CustomerDbQueryOptions as F, type CustomerDbQueryPlan as G, type CustomerDbQueryResult as H, DEEPLINE_TOOL_CATEGORIES as I, type DbNamespace as J, type DeeplineToolCategory as K, type IngestionStorageRepairResult as L, type LegacyMonitorStatusFilter as M, type LiveEventEnvelope as N, MONITOR_JOB_PHASES as O, type PlayListItem as P, MONITOR_JOB_RECONCILIATION_STATES as Q, type ResolvedConfig as R, type StopPlayRunResult as S, type ToolDefinition as T, MONITOR_JOB_STATES as U, type MonitorBatchNamespace as V, type MonitorCheckResult as W, type MonitorDefinition as X, type MonitorDeleteResult as Y, type MonitorDependents as Z, type MonitorDeployResult as _, type ToolMetadata as a, type RunEventCountResult as a$, type MonitorFleetDeactivateOptions as a0, type MonitorFleetGetOptions as a1, type MonitorFleetReactivateOptions as a2, type MonitorFleetResult as a3, type MonitorFleetStatus as a4, type MonitorFleetSyncOptions as a5, type MonitorFleetWaitOptions as a6, type MonitorFleetsNamespace as a7, type MonitorJobDeployOptions as a8, type MonitorJobLogsOptions as a9, type PlayLiveEvent as aA, type PlayPath as aB, type PlayRunActionPackage as aC, type PlayRunActivityProjection as aD, type PlayRunDatasetActions as aE, type PlayRunPackage as aF, type PlayRunResult as aG, type PlayRunRowHistoryOptions as aH, type PlayRunStart as aI, type PlaySettings as aJ, type PlaySettingsPatch as aK, type PlaySettingsPathsPage as aL, type PlaySettingsResult as aM, type PlaySheetRow as aN, type PlaySheetRowsResult as aO, type PlayTriggerConfigUpdate as aP, type PlayTriggerConfigUpdateResult as aQ, type PlayTriggerConfigView as aR, type PlayWebhookAuthConfig as aS, type PlayWebhookTriggerConfig as aT, type PlaysActivityResponse as aU, type PlaysListOptions as aV, type PlaysListPage as aW, type PublishPlayVersionRequest as aX, type RerunOptions as aY, type RerunPlayRunResult as aZ, type RunChildrenPage as a_, type MonitorJobPhase as aa, type MonitorJobReconciliationState as ab, type MonitorJobResult as ac, type MonitorJobState as ad, type MonitorJobWaitOptions as ae, type MonitorJobsNamespace as af, type MonitorListEntry as ag, type MonitorPayload as ah, type MonitorReactivateResult as ai, type MonitorSpec as aj, type MonitorState as ak, type MonitorStateFilter as al, type MonitorUpdateChangeSummary as am, type MonitorUpdateResult as an, type MonitorsAccessStatus as ao, type MonitorsAvailableOptions as ap, type MonitorsAvailableResult as aq, type MonitorsListOptions as ar, type MonitorsListResult as as, type MonitorsNamespace as at, type NormalizedRunEventQuery as au, type PlayActivityObservation as av, type PlayActivityState as aw, type PlayActivityTarget as ax, type PlayCostEstimate as ay, type PlayCronTriggerConfig as az, type ExecutionRecovery as b, type ToolSearchResult as b$, type RunEventField as b0, type RunEventFieldDescriptor as b1, type RunEventFieldOperators as b2, type RunEventFieldsResult as b3, type RunEventGroupValue as b4, type RunEventMeasure as b5, type RunEventQueryCriteria as b6, type RunEventQueryEvent as b7, RunEventQueryInputError as b8, type RunEventQueryOptions as b9, type RunsListPage as bA, type RunsLogCriteria as bB, type RunsLogsCountResult as bC, type RunsLogsNamespace as bD, type RunsLogsOptions as bE, type RunsLogsQueryOptions as bF, type RunsLogsQueryResult as bG, type RunsLogsResult as bH, type RunsLogsSummaryOptions as bI, type RunsLogsSummaryResult as bJ, type RunsNamespace as bK, type RunsTailOptions as bL, type RunsWatchOptions as bM, type SearchOptions as bN, type SearchResult as bO, type SearchResultItem as bP, type SearchType as bQ, type StartPlayRunRequest as bR, type StopAllCandidate as bS, type StopAllPlayRunsDryRunResult as bT, type StopAllPlayRunsResult as bU, type StopAllPlayRunsStopResult as bV, type StopAllRunsOptions as bW, type ToolExecution as bX, type ToolRequestCondition as bY, type ToolRequestWarningRule as bZ, type ToolSearchOptions as b_, type RunEventQueryPage as ba, type RunEventQueryRetention as bb, type RunEventScalar as bc, type RunEventSummaryOptions as bd, type RunEventSummaryResult as be, type RunEventWhere as bf, type RunLifecycleStatus as bg, type RunToolReceiptResult as bh, type RunToolReceiptsResponse as bi, type RunsChildrenOptions as bj, type RunsEventPayload as bk, type RunsEventSearchEntry as bl, type RunsEventSearchOptions as bm, type RunsEventSearchResult as bn, type RunsEventsCountResult as bo, type RunsEventsCriteria as bp, type RunsEventsFieldsOptions as bq, type RunsEventsListOptions as br, type RunsEventsListResult as bs, type RunsEventsNamespace as bt, type RunsEventsSummaryOptions as bu, type RunsEventsSummaryResult as bv, type RunsHistoryItem as bw, type RunsHistoryOptions as bx, type RunsHistoryPage as by, type RunsListOptions as bz, type ExecutionByKeyResult as c, type WorkspaceCreateResult as c0, type WorkspacesNamespace as c1, defineMonitor as c2, isStopAllPlayRunsDryRunResult as c3, planCustomerDbQuery as c4, CSV_DATA_INPUT_KEY as c5, type FileInputBinding as c6, type LocalFileInput as c7, type MintStagedFileUpload as c8, PLAY_FILES_STAGE_MINT_PATH as c9, webStagedFileCodec as cA, PLAY_FILES_STAGE_PATH as ca, PLAY_RUN_START_PATH as cb, PLAY_RUN_START_STREAM_PATH as cc, type PlayRunHttp as cd, type ResolvedStartPlayRunRequest as ce, STAGE_LEGACY_MULTIPART_MAX_BYTES as cf, type StagedFileCodec as cg, type StagedFileInputs as ch, type StagedFileUpload as ci, buildNamedPlayRunRequest as cj, buildPlayRunStartBody as ck, createSessionPlayRunHttp as cl, createStagedFileUpload as cm, fileInputBindingsFromPlaySchema as cn, fileInputBindingsFromStaticPipeline as co, getDottedInputValue as cp, isPlayRunPackage as cq, mintStagedPlayFileUploads as cr, normalizePlayRunStart as cs, playRunFileInputBindings as ct, preparePlayRunAdmission as cu, setDottedInputValue as cv, stageFileInputs as cw, stagePlayFiles as cx, stagedFileContentType as cy, startPlayRun as cz, type PlayDetail as d, type PlayRunListItem as e, type PlayRevisionSummary as f, type PublishPlayVersionResult as g, type PlayStatus as h, DeeplineClient as i, type BillingCreditPool as j, type BillingInvoiceEntry as k, type BillingInvoicesResult as l, type BillingPaymentMethodSummary as m, type BillingQuoteRequest as n, type BillingQuoteResult as o, type BillingRecentUsageEntry as p, type BillingSubscriptionCancelResult as q, type BillingSubscriptionStatus as r, type BillingTopUpReceipt as s, type BillingTopUpResult as t, type BillingUsageEvent as u, type BillingUsageOptions as v, type BillingUsageResult as w, type ChildRunSummary as x, type ClearPlayHistoryRequest as y, type CreateNotificationGroupInput as z };

package/dist/{compiler-manifest-CY2v8ab0.d.ts → compiler-manifest-DLxUY5kI.d.mts}

@@ -589,6 +589,14 @@ type PlayDatasetWorkProgressSummary = {
     pending: number;
     failed: number;
     degraded?: boolean;
+    /** Fixed-shape source/output accounting; does not redefine legacy totals. */
+    cardinality?: {
+        sourceRows: number;
+        uniqueInputRows: number;
+        duplicateOccurrences: number;
+        outputRows: number;
+        rowIdentity: 'source_row' | 'key';
+    };
     duplicates?: {
         exact?: number;
         semantic?: number;
@@ -705,6 +713,19 @@ type ToolResultExecutionMetadata = {
     /** Canonical saved result identity; receiptKey may name a transport alias. */
     resultReceiptKey?: string;
     attachedToReceiptKey?: string;
+    /** Freshness and operation recovery are independent of provider idempotency. */
+    freshness?: CallFreshnessMetadata;
+    /** Time the live result completed, retained unchanged through recovery. */
+    completedAt?: number;
+};
+type CallFreshnessMetadata = {
+    requestedStaleAfterSeconds: number | null;
+    effectiveStaleAfterSeconds: number | null;
+    source: 'executed' | 'operation_recovery' | 'reusable_result' | 'live_observation';
+    resultAgeMs: number;
+    completedAt: number;
+    operationReceiptKey?: string;
+    unavailableReason?: string;
 };
 type ToolResultTargetMetadata = {
     value: unknown;
@@ -824,7 +845,7 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
  */
 type ToolExecuteResult<TResult = unknown, TMeta = Record<string, unknown>, TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = ToolExecuteResultBase<TResult, TMeta> & ToolExecuteResultAccessors<TExtracted, TLists>;
 
-declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11];
 type PlayAuthoringContractEdition = (typeof SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS)[number];
 type PlaySqlListenerOperation = 'INSERT' | 'UPDATE' | 'DELETE';
 type PlayStandardWebhookHeaderFamily = 'standard' | 'svix';
@@ -1088,7 +1109,7 @@ type PlayAuthoringStepOptions<Row, Value = unknown> = {
     /** Legacy error-recompute flag accepted for older authored Plays. */
     readonly recomputeOnError?: boolean;
     /** Legacy cell staleness metadata accepted for older authored Plays. */
-    readonly staleAfterSeconds?: number;
+    readonly staleAfterSeconds?: DurableCallStaleAfterSeconds;
 };
 /** Explicitly mark a step program as a provider fallback waterfall. */
 type PlayAuthoringStepProgramOptions = {
@@ -1115,7 +1136,7 @@ type PlayAuthoringStepProgramStep<TContext> = {
     readonly name: string;
     readonly recompute?: boolean;
     readonly recomputeOnError?: boolean;
-    readonly staleAfterSeconds?: number;
+    readonly staleAfterSeconds?: DurableCallStaleAfterSeconds;
     readonly resolver: PlayAuthoringStepResolver<Record<string, unknown>, unknown, TContext> | PlayAuthoringConditionalStepResolver<Record<string, unknown>, unknown, TContext> | PlayAuthoringStepProgramResolver<Record<string, unknown>, unknown, TContext>;
 };
 type PlayAuthoringColumnResolver<Row, Value, TContext> = PlayAuthoringStepResolver<Row, Value, TContext> | PlayAuthoringConditionalStepResolver<Row, Value, TContext> | PlayAuthoringRunnableStepProgram<Value, TContext>;
@@ -1126,6 +1147,8 @@ type PlayAuthoringDatasetDefinitionOptions<InputRow extends object> = {
 type PlayAuthoringDatasetRunOptions<InputRow extends object> = {
     description?: string;
     key?: PlayAuthoringDatasetRowKey<InputRow>;
+    /** Edition 11 CSVs always use source-row identity; key-based deduplication remains for non-CSV inputs and earlier editions. */
+    rowIdentity?: 'source_row' | 'key';
     onRowError?: 'isolate' | 'fail';
     mode?: 'upsert' | 'net_new';
     /**
@@ -1216,8 +1239,10 @@ type PlayAuthoringRuntimeStepOptions = {
 /**
  * Durable freshness for one `ctx.fetch` call. The key identifies the request;
  * `staleAfterSeconds` controls when that completed request may be reused across
- * Play runs. Omit it (or pass `null`) to reuse indefinitely, pass `0` to
- * execute on every new run, or pass a positive number of seconds for a TTL.
+ * Play runs. Edition 11 requires an explicit choice: `null` reuses indefinitely,
+ * `0` executes on every new run, and a positive whole number sets the maximum
+ * result age. Retained results are supported only for read methods (GET, HEAD,
+ * OPTIONS); mutating methods require `0`. Transient calls do not retain results.
  *
  * Use this for polling or periodically refreshing one external resource. It
  * does not change dataset row identity.
@@ -1225,7 +1250,7 @@ type PlayAuthoringRuntimeStepOptions = {
  */
 type PlayAuthoringFetchOptions = {
     staleAfterSeconds?: DurableCallStaleAfterSeconds;
-    /** Run through Deepline's guarded outbound path without retaining a response receipt or checkpoint. Use this for short-lived credential exchanges or other response data that should stay in the running Play only. */
+    /** Run through Deepline's guarded outbound path without retaining a response receipt or checkpoint. Edition 11 permits transient fetches only for GET, HEAD, and OPTIONS. */
     transient?: boolean;
 };
 /**
@@ -1281,6 +1306,8 @@ declare class CtxFetchHttpError extends Error {
     constructor(response: PlayAuthoringFetchResponse);
 }
 type PlayAuthoringCustomerDbQueryOptions = {
+    id?: string;
+    staleAfterSeconds?: 0;
     maxRows?: number;
     timeoutMs?: number;
 };
@@ -1336,6 +1363,7 @@ interface PlayAuthoringRuntimeContext<TListGetter extends 'dataset' | 'array' =
     /** Shorthand for one managed tool call. */
     tool<TOutput = PlayLooseObject>(key: string, toolId: string, input: Record<string, unknown>, options?: {
         description?: string;
+        staleAfterSeconds?: DurableCallStaleAfterSeconds;
     }): Promise<TListGetter extends 'array' ? BasicToolExecuteResult<TOutput> : ToolExecuteResult<TOutput>>;
     /**
      * Execute one reusable step program against a scalar input.
@@ -1350,7 +1378,7 @@ interface PlayAuthoringRuntimeContext<TListGetter extends 'dataset' | 'array' =
      */
     step<T>(id: string, run: () => T | Promise<T>, options?: PlayAuthoringRuntimeStepOptions): Promise<T>;
     /**
-     * Execute a guarded HTTP request. By default, completed responses are durably reused; `staleAfterSeconds` governs only that completed call receipt, never dataset/request identity. Failed requests do not publish completed cache entries. A headers timeout leaves an upstream write's outcome unknown and does not establish whether its body was sent. The transport does not automatically retry that timed-out write, but a later invocation can execute it again. Mutating requests require provider-supported idempotency with the same key retained across retries and replay. Deadlines are platform-controlled; callers may cancel through `init.signal`. Pass `{ transient: true }` for short-lived credential exchanges or other response data that must not be retained in a receipt or checkpoint. Edition 5+ throws `CtxFetchHttpError` for non-2xx; catch it only when the Play intentionally recovers, otherwise let it fail the Play. Editions 1–4 retain their previous response projections.
+     * Execute a guarded HTTP request. Edition 11 requires an explicit freshness choice; only GET, HEAD, and OPTIONS can retain completed responses. Mutating methods must use `staleAfterSeconds: 0`; the choice governs only the completed call receipt, never dataset/request identity. Failed requests do not publish completed cache entries. A headers timeout leaves an upstream write's outcome unknown and does not establish whether its body was sent. The transport does not automatically retry that timed-out write, but a later invocation can execute it again. Mutating requests require provider-supported idempotency with the same key retained across retries and replay. Deadlines are platform-controlled; callers may cancel through `init.signal`. Pass `{ transient: true }` only on GET, HEAD, and OPTIONS when the response must not be retained in a receipt or checkpoint; edition 11 rejects transient writes. Edition 5+ throws `CtxFetchHttpError` for non-2xx; catch it only when the Play intentionally recovers, otherwise let it fail the Play. Editions 1–4 retain their previous response projections.
      *
      * @sdkReference runtime 170 ctx.fetch(key, url, init)
      */
@@ -2025,7 +2053,7 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly required: false;
         readonly resolution: "runtime-allowed";
         readonly issueCode: "play_authoring_durable_policy_invalid";
-        readonly description: "`0` always executes; `null`/omitted never expires; a positive integer is a TTL in seconds.";
+        readonly description: string;
         readonly errorMessage: "staleAfterSeconds must be null, 0 (always execute), or a positive whole number of seconds.";
     };
     readonly 'ctx.tools.execute.id': {
@@ -2296,6 +2324,24 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly description: "Stable field or fields used for durable row identity.";
         readonly errorMessage: "ctx.dataset run key must be a non-empty field, field list, or key function.";
     };
+    readonly 'ctx.dataset.run.rowIdentity': {
+        readonly schema: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"source_row">, _sinclair_typebox.TLiteral<"key">]>;
+        readonly fixtures: {
+            readonly valid: "source_row";
+            readonly invalid: "dedupe";
+            readonly absent: undefined;
+            readonly unresolved: {
+                readonly expression: "rowIdentity";
+            };
+            readonly edition1: "key";
+        };
+        readonly referenceType: "'source_row' | 'key'";
+        readonly required: false;
+        readonly resolution: "static-when-present";
+        readonly issueCode: "play_authoring_dataset_option_invalid";
+        readonly description: "Edition 11 CSV inputs always use source-row occurrence identity, even with rowIdentity: key; key-based deduplication remains available for non-CSV inputs and editions 1–10.";
+        readonly errorMessage: "ctx.dataset run rowIdentity must be \"source_row\" or \"key\".";
+    };
     readonly 'ctx.dataset.run.onRowError': {
         readonly schema: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"isolate">, _sinclair_typebox.TLiteral<"fail">]>;
         readonly fixtures: {
@@ -2401,7 +2447,7 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly required: false;
         readonly resolution: "runtime-dynamic";
         readonly issueCode: "play_authoring_durable_policy_invalid";
-        readonly description: "Checkpoint freshness: null/omitted never expires, 0 always executes.";
+        readonly description: string;
         readonly errorMessage: "staleAfterSeconds must be null, 0 (always execute), or a positive whole number of seconds.";
     };
     readonly 'ctx.fetch.key': {
@@ -2438,7 +2484,7 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly required: false;
         readonly resolution: "runtime-dynamic";
         readonly issueCode: "play_authoring_durable_policy_invalid";
-        readonly description: "Fetch freshness: null/omitted never expires, 0 always executes.";
+        readonly description: string;
         readonly errorMessage: "staleAfterSeconds must be null, 0 (always execute), or a positive whole number of seconds.";
     };
     readonly 'ctx.runPlay.key': {
@@ -2697,6 +2743,42 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly description: "One non-empty Customer DB SQL string; the deprecated SqlQuery object is accepted only without parameter values.";
         readonly errorMessage: "ctx.customerDb.query statement must be a non-empty SQL string. Deprecated SqlQuery objects cannot contain parameter values.";
     };
+    readonly 'ctx.customerDb.query.options.id': {
+        readonly schema: _sinclair_typebox.TString;
+        readonly fixtures: {
+            readonly valid: "customer-report-read";
+            readonly invalid: "";
+            readonly absent: undefined;
+            readonly unresolved: {
+                readonly expression: "operationId";
+            };
+            readonly edition1: "query";
+        };
+        readonly referenceType: "string";
+        readonly required: true;
+        readonly resolution: "runtime-dynamic";
+        readonly issueCode: "play_authoring_tool_request_invalid";
+        readonly description: "Stable operation identity for Customer DB query recovery.";
+        readonly errorMessage: "ctx.customerDb.query options.id must be a non-empty stable string.";
+    };
+    readonly 'ctx.customerDb.query.options.staleAfterSeconds': {
+        readonly schema: _sinclair_typebox.TLiteral<0>;
+        readonly fixtures: {
+            readonly valid: 0;
+            readonly invalid: 1;
+            readonly absent: undefined;
+            readonly unresolved: {
+                readonly expression: "ttl";
+            };
+            readonly edition1: 0;
+        };
+        readonly referenceType: "number | null";
+        readonly required: false;
+        readonly resolution: "runtime-dynamic";
+        readonly issueCode: "play_authoring_durable_policy_invalid";
+        readonly description: "Customer DB queries always execute with freshness 0.";
+        readonly errorMessage: "Customer DB queries must use staleAfterSeconds: 0.";
+    };
     readonly 'ctx.customerDb.query.options.maxRows': {
         readonly schema: _sinclair_typebox.TInteger;
         readonly fixtures: {
@@ -3159,10 +3241,14 @@ interface PlayStaticSourceRange {
     endColumn: number;
 }
 type PlayStaticSubstepMetadata = {
+    /** A source helper received execution context but its work could not be resolved. */
+    unresolvedProviderWork?: boolean;
     /** This call is syntactically inside Promise.all/allSettled/race/any. */
     concurrent?: boolean;
     conditional?: boolean;
     disabled?: boolean;
+    /** Source-bound input-only gate; absent means reachability is unknown. */
+    inputRequirement?: PlayStaticInputCondition;
     /**
      * Where this substep was REACHED FROM, when the extractor resolved it by
      * following a call into another function — the range of the call expression
@@ -3192,9 +3278,37 @@ type PlayStaticControlFlowBranch = {
     label: string;
     /** The arm's condition source text, when it has one (omitted for `else`). */
     condition?: string;
+    inputRequirement?: PlayStaticInputCondition;
     /** Static work in this arm. Empty for log/throw/return-only arms. */
     steps: PlayStaticSubstep[];
 };
+/** Declarative subset of input conditions; never evaluates authored JavaScript. */
+type PlayStaticInputValue = {
+    kind: 'input';
+    path: string[];
+} | {
+    kind: 'literal';
+    value: string | number | boolean | null;
+};
+type PlayStaticInputCondition = {
+    kind: 'truthy';
+    value: PlayStaticInputValue;
+} | {
+    kind: 'not';
+    condition: PlayStaticInputCondition;
+} | {
+    kind: 'and' | 'or';
+    left: PlayStaticInputCondition;
+    right: PlayStaticInputCondition;
+} | {
+    kind: 'equals';
+    left: PlayStaticInputValue;
+    right: PlayStaticInputValue;
+} | {
+    kind: 'includes';
+    value: PlayStaticInputValue;
+    item: PlayStaticInputValue;
+};
 type PlayStaticSubstep = PlayStaticSubstepMetadata & ({
     type: 'csv';
     field: string;