deepline 0.3.393 → 0.3.395

package/dist/{client-mCE88hC4.d.ts → client-CivP-PAI.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-DE4RdAiY.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';
 
@@ -3010,6 +3010,7 @@ interface PlayDescription {
     aliases: string[];
     inputSchema?: Record<string, unknown> | null;
     outputSchema?: Record<string, unknown> | null;
+    /** The compiled pipeline; only when `describePlay(name, { pipeline: true })` asks. */
     staticPipeline?: Record<string, unknown> | null;
     csvInput?: Record<string, unknown> | null;
     rowOutputSchema?: Record<string, unknown> | null;
@@ -3535,6 +3536,21 @@ interface UpdateSharePageRequest {
     seoIndexing?: 'index' | 'noindex';
 }
 
+/**
+ * The description `deepline describe` and `plays describe` show for a Play,
+ * derived from its definition. The server computes it (`?view=description`)
+ * so a describe reads kilobytes; the SDK computes the same thing from a full
+ * definition when it asks for the compiled pipeline or talks to an older API.
+ */
+type PlayDescriptionOptions = {
+    /** Field names only, in place of the full input and output schemas. */
+    compact?: boolean;
+    /** Include the compiled pipeline. It can be hundreds of kilobytes. */
+    pipeline?: boolean;
+};
+declare function describePlayListItem(play: PlayListItem, options?: PlayDescriptionOptions): PlayDescription;
+declare function describePlayDetail(detail: PlayDetail, options?: PlayDescriptionOptions): PlayDescription;
+
 type CustomerDbQueryOptions = {
     sql: string;
     maxRows?: number;
@@ -6150,13 +6166,6 @@ declare class DeeplineClient {
     constructor(options?: DeeplineClientOptions);
     /** The resolved base URL this client is targeting (e.g. `"http://localhost:3000"`). */
     get baseUrl(): string;
-    private compactSchema;
-    private schemaMetadata;
-    private playRunCommand;
-    private starterPlayPath;
-    private playCloneEditStarter;
-    private summarizePlayListItem;
-    private summarizePlayDetail;
     /** List secret metadata visible to the current workspace. */
     listSecrets(): Promise<PlaySecretMetadata[]>;
     /**
@@ -7097,11 +7106,11 @@ declare class DeeplineClient {
      * Get a normalized play description suitable for agents and CLIs.
      *
      * The description includes runnable examples, input/output summaries, clone
-     * guidance, revision state, and latest run metadata when available.
+     * guidance, revision state, and latest run metadata when available. Pass
+     * `{ pipeline: true }` to include the compiled pipeline, which can be
+     * hundreds of kilobytes and is otherwise left out.
      */
-    describePlay(name: string, options?: {
-        compact?: boolean;
-    }): Promise<PlayDescription>;
+    describePlay(name: string, options?: PlayDescriptionOptions): Promise<PlayDescription>;
     /**
      * Clear run history and durable sheet/result data for a play without deleting
      * the play definition or revisions.
@@ -7497,4 +7506,4 @@ declare class DeeplineClient {
     }>;
 }
 
-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 };
+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 RunChildrenPage 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 PlayDescriptionOptions as aA, type PlayLiveEvent as aB, type PlayPath as aC, type PlayRunActionPackage as aD, type PlayRunActivityProjection as aE, type PlayRunDatasetActions as aF, type PlayRunPackage as aG, type PlayRunResult as aH, type PlayRunRowHistoryOptions as aI, type PlayRunStart as aJ, type PlaySettings as aK, type PlaySettingsPatch as aL, type PlaySettingsPathsPage as aM, type PlaySettingsResult as aN, type PlaySheetRow as aO, type PlaySheetRowsResult as aP, type PlayTriggerConfigUpdate as aQ, type PlayTriggerConfigUpdateResult as aR, type PlayTriggerConfigView as aS, type PlayWebhookAuthConfig as aT, type PlayWebhookTriggerConfig as aU, type PlaysActivityResponse as aV, type PlaysListOptions as aW, type PlaysListPage as aX, type PublishPlayVersionRequest as aY, type RerunOptions as aZ, type RerunPlayRunResult 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 ToolSearchOptions as b$, type RunEventCountResult as b0, type RunEventField as b1, type RunEventFieldDescriptor as b2, type RunEventFieldOperators as b3, type RunEventFieldsResult as b4, type RunEventGroupValue as b5, type RunEventMeasure as b6, type RunEventQueryCriteria as b7, type RunEventQueryEvent as b8, RunEventQueryInputError as b9, type RunsListOptions as bA, type RunsListPage as bB, type RunsLogCriteria as bC, type RunsLogsCountResult as bD, type RunsLogsNamespace as bE, type RunsLogsOptions as bF, type RunsLogsQueryOptions as bG, type RunsLogsQueryResult as bH, type RunsLogsResult as bI, type RunsLogsSummaryOptions as bJ, type RunsLogsSummaryResult as bK, type RunsNamespace as bL, type RunsTailOptions as bM, type RunsWatchOptions as bN, type SearchOptions as bO, type SearchResult as bP, type SearchResultItem as bQ, type SearchType as bR, type StartPlayRunRequest as bS, type StopAllCandidate as bT, type StopAllPlayRunsDryRunResult as bU, type StopAllPlayRunsResult as bV, type StopAllPlayRunsStopResult as bW, type StopAllRunsOptions as bX, type ToolExecution as bY, type ToolRequestCondition as bZ, type ToolRequestWarningRule as b_, type RunEventQueryOptions as ba, type RunEventQueryPage as bb, type RunEventQueryRetention as bc, type RunEventScalar as bd, type RunEventSummaryOptions as be, type RunEventSummaryResult as bf, type RunEventWhere as bg, type RunLifecycleStatus as bh, type RunToolReceiptResult as bi, type RunToolReceiptsResponse as bj, type RunsChildrenOptions as bk, type RunsEventPayload as bl, type RunsEventSearchEntry as bm, type RunsEventSearchOptions as bn, type RunsEventSearchResult as bo, type RunsEventsCountResult as bp, type RunsEventsCriteria as bq, type RunsEventsFieldsOptions as br, type RunsEventsListOptions as bs, type RunsEventsListResult as bt, type RunsEventsNamespace as bu, type RunsEventsSummaryOptions as bv, type RunsEventsSummaryResult as bw, type RunsHistoryItem as bx, type RunsHistoryOptions as by, type RunsHistoryPage as bz, type ExecutionByKeyResult as c, type ToolSearchResult as c0, type WorkspaceCreateResult as c1, type WorkspacesNamespace as c2, defineMonitor as c3, isStopAllPlayRunsDryRunResult as c4, planCustomerDbQuery as c5, type PlayDescription as c6, describePlayDetail as c7, describePlayListItem as c8, CSV_DATA_INPUT_KEY as c9, stageFileInputs as cA, stagePlayFiles as cB, stagedFileContentType as cC, startPlayRun as cD, webStagedFileCodec as cE, type FileInputBinding as ca, type LocalFileInput as cb, type MintStagedFileUpload as cc, PLAY_FILES_STAGE_MINT_PATH as cd, PLAY_FILES_STAGE_PATH as ce, PLAY_RUN_START_PATH as cf, PLAY_RUN_START_STREAM_PATH as cg, type PlayRunHttp as ch, type ResolvedStartPlayRunRequest as ci, STAGE_LEGACY_MULTIPART_MAX_BYTES as cj, type StagedFileCodec as ck, type StagedFileInputs as cl, type StagedFileUpload as cm, buildNamedPlayRunRequest as cn, buildPlayRunStartBody as co, createSessionPlayRunHttp as cp, createStagedFileUpload as cq, fileInputBindingsFromPlaySchema as cr, fileInputBindingsFromStaticPipeline as cs, getDottedInputValue as ct, isPlayRunPackage as cu, mintStagedPlayFileUploads as cv, normalizePlayRunStart as cw, playRunFileInputBindings as cx, preparePlayRunAdmission as cy, setDottedInputValue 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/{client-DU5dtHDy.d.mts → client-hdFtwhTm.d.mts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { g as PlayCompilerManifest, ak as ToolResultBilling, Y as BillingEntitlements } from './compiler-manifest-DE4RdAiY.mjs';
+import { g as PlayCompilerManifest, ak as ToolResultBilling, Y as BillingEntitlements } from './compiler-manifest-DLxUY5kI.mjs';
 import { z } from 'zod';
 import { MonitorFleetDefinition } from './monitor-fleet-contract.mjs';
 
@@ -3010,6 +3010,7 @@ interface PlayDescription {
     aliases: string[];
     inputSchema?: Record<string, unknown> | null;
     outputSchema?: Record<string, unknown> | null;
+    /** The compiled pipeline; only when `describePlay(name, { pipeline: true })` asks. */
     staticPipeline?: Record<string, unknown> | null;
     csvInput?: Record<string, unknown> | null;
     rowOutputSchema?: Record<string, unknown> | null;
@@ -3535,6 +3536,21 @@ interface UpdateSharePageRequest {
     seoIndexing?: 'index' | 'noindex';
 }
 
+/**
+ * The description `deepline describe` and `plays describe` show for a Play,
+ * derived from its definition. The server computes it (`?view=description`)
+ * so a describe reads kilobytes; the SDK computes the same thing from a full
+ * definition when it asks for the compiled pipeline or talks to an older API.
+ */
+type PlayDescriptionOptions = {
+    /** Field names only, in place of the full input and output schemas. */
+    compact?: boolean;
+    /** Include the compiled pipeline. It can be hundreds of kilobytes. */
+    pipeline?: boolean;
+};
+declare function describePlayListItem(play: PlayListItem, options?: PlayDescriptionOptions): PlayDescription;
+declare function describePlayDetail(detail: PlayDetail, options?: PlayDescriptionOptions): PlayDescription;
+
 type CustomerDbQueryOptions = {
     sql: string;
     maxRows?: number;
@@ -6150,13 +6166,6 @@ declare class DeeplineClient {
     constructor(options?: DeeplineClientOptions);
     /** The resolved base URL this client is targeting (e.g. `"http://localhost:3000"`). */
     get baseUrl(): string;
-    private compactSchema;
-    private schemaMetadata;
-    private playRunCommand;
-    private starterPlayPath;
-    private playCloneEditStarter;
-    private summarizePlayListItem;
-    private summarizePlayDetail;
     /** List secret metadata visible to the current workspace. */
     listSecrets(): Promise<PlaySecretMetadata[]>;
     /**
@@ -7097,11 +7106,11 @@ declare class DeeplineClient {
      * Get a normalized play description suitable for agents and CLIs.
      *
      * The description includes runnable examples, input/output summaries, clone
-     * guidance, revision state, and latest run metadata when available.
+     * guidance, revision state, and latest run metadata when available. Pass
+     * `{ pipeline: true }` to include the compiled pipeline, which can be
+     * hundreds of kilobytes and is otherwise left out.
      */
-    describePlay(name: string, options?: {
-        compact?: boolean;
-    }): Promise<PlayDescription>;
+    describePlay(name: string, options?: PlayDescriptionOptions): Promise<PlayDescription>;
     /**
      * Clear run history and durable sheet/result data for a play without deleting
      * the play definition or revisions.
@@ -7497,4 +7506,4 @@ declare class DeeplineClient {
     }>;
 }
 
-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 };
+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 RunChildrenPage 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 PlayDescriptionOptions as aA, type PlayLiveEvent as aB, type PlayPath as aC, type PlayRunActionPackage as aD, type PlayRunActivityProjection as aE, type PlayRunDatasetActions as aF, type PlayRunPackage as aG, type PlayRunResult as aH, type PlayRunRowHistoryOptions as aI, type PlayRunStart as aJ, type PlaySettings as aK, type PlaySettingsPatch as aL, type PlaySettingsPathsPage as aM, type PlaySettingsResult as aN, type PlaySheetRow as aO, type PlaySheetRowsResult as aP, type PlayTriggerConfigUpdate as aQ, type PlayTriggerConfigUpdateResult as aR, type PlayTriggerConfigView as aS, type PlayWebhookAuthConfig as aT, type PlayWebhookTriggerConfig as aU, type PlaysActivityResponse as aV, type PlaysListOptions as aW, type PlaysListPage as aX, type PublishPlayVersionRequest as aY, type RerunOptions as aZ, type RerunPlayRunResult 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 ToolSearchOptions as b$, type RunEventCountResult as b0, type RunEventField as b1, type RunEventFieldDescriptor as b2, type RunEventFieldOperators as b3, type RunEventFieldsResult as b4, type RunEventGroupValue as b5, type RunEventMeasure as b6, type RunEventQueryCriteria as b7, type RunEventQueryEvent as b8, RunEventQueryInputError as b9, type RunsListOptions as bA, type RunsListPage as bB, type RunsLogCriteria as bC, type RunsLogsCountResult as bD, type RunsLogsNamespace as bE, type RunsLogsOptions as bF, type RunsLogsQueryOptions as bG, type RunsLogsQueryResult as bH, type RunsLogsResult as bI, type RunsLogsSummaryOptions as bJ, type RunsLogsSummaryResult as bK, type RunsNamespace as bL, type RunsTailOptions as bM, type RunsWatchOptions as bN, type SearchOptions as bO, type SearchResult as bP, type SearchResultItem as bQ, type SearchType as bR, type StartPlayRunRequest as bS, type StopAllCandidate as bT, type StopAllPlayRunsDryRunResult as bU, type StopAllPlayRunsResult as bV, type StopAllPlayRunsStopResult as bW, type StopAllRunsOptions as bX, type ToolExecution as bY, type ToolRequestCondition as bZ, type ToolRequestWarningRule as b_, type RunEventQueryOptions as ba, type RunEventQueryPage as bb, type RunEventQueryRetention as bc, type RunEventScalar as bd, type RunEventSummaryOptions as be, type RunEventSummaryResult as bf, type RunEventWhere as bg, type RunLifecycleStatus as bh, type RunToolReceiptResult as bi, type RunToolReceiptsResponse as bj, type RunsChildrenOptions as bk, type RunsEventPayload as bl, type RunsEventSearchEntry as bm, type RunsEventSearchOptions as bn, type RunsEventSearchResult as bo, type RunsEventsCountResult as bp, type RunsEventsCriteria as bq, type RunsEventsFieldsOptions as br, type RunsEventsListOptions as bs, type RunsEventsListResult as bt, type RunsEventsNamespace as bu, type RunsEventsSummaryOptions as bv, type RunsEventsSummaryResult as bw, type RunsHistoryItem as bx, type RunsHistoryOptions as by, type RunsHistoryPage as bz, type ExecutionByKeyResult as c, type ToolSearchResult as c0, type WorkspaceCreateResult as c1, type WorkspacesNamespace as c2, defineMonitor as c3, isStopAllPlayRunsDryRunResult as c4, planCustomerDbQuery as c5, type PlayDescription as c6, describePlayDetail as c7, describePlayListItem as c8, CSV_DATA_INPUT_KEY as c9, stageFileInputs as cA, stagePlayFiles as cB, stagedFileContentType as cC, startPlayRun as cD, webStagedFileCodec as cE, type FileInputBinding as ca, type LocalFileInput as cb, type MintStagedFileUpload as cc, PLAY_FILES_STAGE_MINT_PATH as cd, PLAY_FILES_STAGE_PATH as ce, PLAY_RUN_START_PATH as cf, PLAY_RUN_START_STREAM_PATH as cg, type PlayRunHttp as ch, type ResolvedStartPlayRunRequest as ci, STAGE_LEGACY_MULTIPART_MAX_BYTES as cj, type StagedFileCodec as ck, type StagedFileInputs as cl, type StagedFileUpload as cm, buildNamedPlayRunRequest as cn, buildPlayRunStartBody as co, createSessionPlayRunHttp as cp, createStagedFileUpload as cq, fileInputBindingsFromPlaySchema as cr, fileInputBindingsFromStaticPipeline as cs, getDottedInputValue as ct, isPlayRunPackage as cu, mintStagedPlayFileUploads as cv, normalizePlayRunStart as cw, playRunFileInputBindings as cx, preparePlayRunAdmission as cy, setDottedInputValue 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-DE4RdAiY.d.ts → compiler-manifest-DLxUY5kI.d.mts}

@@ -713,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;
@@ -1096,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 = {
@@ -1123,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>;
@@ -1134,7 +1147,7 @@ type PlayAuthoringDatasetDefinitionOptions<InputRow extends object> = {
 type PlayAuthoringDatasetRunOptions<InputRow extends object> = {
     description?: string;
     key?: PlayAuthoringDatasetRowKey<InputRow>;
-    /** CSV defaults to source row identity. Use key only for intentional deduplication. */
+    /** 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';
@@ -1226,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.
@@ -1235,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;
 };
 /**
@@ -1291,6 +1306,8 @@ declare class CtxFetchHttpError extends Error {
     constructor(response: PlayAuthoringFetchResponse);
 }
 type PlayAuthoringCustomerDbQueryOptions = {
+    id?: string;
+    staleAfterSeconds?: 0;
     maxRows?: number;
     timeoutMs?: number;
 };
@@ -1346,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.
@@ -1360,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)
      */
@@ -2035,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': {
@@ -2321,7 +2339,7 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly required: false;
         readonly resolution: "static-when-present";
         readonly issueCode: "play_authoring_dataset_option_invalid";
-        readonly description: "Select source_row to process every input occurrence. CSV datasets default to source_row in edition 11; earlier editions retain key identity. Select key only to intentionally deduplicate business keys.";
+        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': {
@@ -2429,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': {
@@ -2466,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': {
@@ -2725,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: {

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

@@ -713,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;
@@ -1096,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 = {
@@ -1123,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>;
@@ -1134,7 +1147,7 @@ type PlayAuthoringDatasetDefinitionOptions<InputRow extends object> = {
 type PlayAuthoringDatasetRunOptions<InputRow extends object> = {
     description?: string;
     key?: PlayAuthoringDatasetRowKey<InputRow>;
-    /** CSV defaults to source row identity. Use key only for intentional deduplication. */
+    /** 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';
@@ -1226,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.
@@ -1235,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;
 };
 /**
@@ -1291,6 +1306,8 @@ declare class CtxFetchHttpError extends Error {
     constructor(response: PlayAuthoringFetchResponse);
 }
 type PlayAuthoringCustomerDbQueryOptions = {
+    id?: string;
+    staleAfterSeconds?: 0;
     maxRows?: number;
     timeoutMs?: number;
 };
@@ -1346,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.
@@ -1360,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)
      */
@@ -2035,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': {
@@ -2321,7 +2339,7 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly required: false;
         readonly resolution: "static-when-present";
         readonly issueCode: "play_authoring_dataset_option_invalid";
-        readonly description: "Select source_row to process every input occurrence. CSV datasets default to source_row in edition 11; earlier editions retain key identity. Select key only to intentionally deduplicate business keys.";
+        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': {
@@ -2429,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': {
@@ -2466,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': {
@@ -2725,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: {

package/dist/{index-Bi-f7HFT.d.ts → index-B_GM9E3q.d.ts}

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

package/dist/{index-BI6nWgaV.d.mts → index-SCb0NvDb.d.mts}

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