deepline 0.3.393 → 0.3.394

package/dist/cli/{chunk-Q26LUSQ2.mjs → chunk-JHIJIHFB.mjs}

@@ -21,7 +21,7 @@ import {
   RETAINED_PIPELINE_RECEIVERS_HEADER,
   RUNTIME_ENVIRONMENT_TOKEN_HEADER,
   resolveConfig
-} from "./chunk-LMMEAMA7.mjs";
+} from "./chunk-FJGW5GXU.mjs";
 import {
   DeeplineError,
   TOOL_EXECUTION_ERROR_SCHEMA_HEADER,

package/dist/cli/{chunk-PWSWAN7Q.js → chunk-KB4SDX5S.js}

@@ -2,6 +2,13 @@
 var _typebox = require('@sinclair/typebox');
 var _value = require('@sinclair/typebox/value');
 var PLAY_AUTHORING_CONTRACT_EDITION = 10;
+var EXPLICIT_FRESHNESS_STALE_AFTER_SECONDS_DESCRIPTION = [
+  "Edition 11 requires an explicit choice.",
+  "`0` starts a fresh logical call, though a matching operation receipt may recover that same operation after resume;",
+  "`null` allows indefinite result reuse;",
+  "a positive integer is the maximum result age in seconds.",
+  "Omitted values retain legacy behavior in older editions."
+].join(" ");
 var SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS = [
   1,
   2,
@@ -77,7 +84,7 @@ var PLAY_AUTHORING_CONTRACT_CHANGELOG_DETAILS = [
     readerRemoval: null
   },
   {
-    changed: 'CSV datasets always use source row identity and process every input occurrence, even when key or rowIdentity: "key" is supplied. Editions 1\u201310 retain their admitted row identity and completed receipts; non-CSV datasets retain explicit key deduplication.',
+    changed: 'Requires explicit freshness and semantic identity for supported durable calls, and gives CSV datasets source-row identity so every input occurrence is processed even when key or rowIdentity: "key" is supplied. Edition 10 retains its list-getter behavior and editions 1\u201310 retain their admitted CSV identity and completed receipts; non-CSV datasets keep explicit key deduplication.',
     compatibilityOwner: "Plays Runtime",
     newWritesEnd: null,
     readerRemoval: null
@@ -742,7 +749,7 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
     required: false,
     resolution: "runtime-allowed",
     issueCode: "play_authoring_durable_policy_invalid",
-    description: "`0` always executes; `null`/omitted never expires; a positive integer is a TTL in seconds.",
+    description: EXPLICIT_FRESHNESS_STALE_AFTER_SECONDS_DESCRIPTION,
     errorMessage: "staleAfterSeconds must be null, 0 (always execute), or a positive whole number of seconds."
   },
   "ctx.tools.execute.id": {
@@ -1005,7 +1012,7 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
     required: false,
     resolution: "static-when-present",
     issueCode: "play_authoring_dataset_option_invalid",
-    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.",
+    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\u201310.",
     errorMessage: 'ctx.dataset run rowIdentity must be "source_row" or "key".'
   },
   "ctx.dataset.run.onRowError": {
@@ -1101,7 +1108,7 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
     required: false,
     resolution: "runtime-dynamic",
     issueCode: "play_authoring_durable_policy_invalid",
-    description: "Checkpoint freshness: null/omitted never expires, 0 always executes.",
+    description: EXPLICIT_FRESHNESS_STALE_AFTER_SECONDS_DESCRIPTION,
     errorMessage: "staleAfterSeconds must be null, 0 (always execute), or a positive whole number of seconds."
   },
   "ctx.fetch.key": {
@@ -1134,7 +1141,7 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
     required: false,
     resolution: "runtime-dynamic",
     issueCode: "play_authoring_durable_policy_invalid",
-    description: "Fetch freshness: null/omitted never expires, 0 always executes.",
+    description: EXPLICIT_FRESHNESS_STALE_AFTER_SECONDS_DESCRIPTION,
     errorMessage: "staleAfterSeconds must be null, 0 (always execute), or a positive whole number of seconds."
   },
   "ctx.runPlay.key": {
@@ -1379,6 +1386,38 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
     description: "One non-empty Customer DB SQL string; the deprecated SqlQuery object is accepted only without parameter values.",
     errorMessage: "ctx.customerDb.query statement must be a non-empty SQL string. Deprecated SqlQuery objects cannot contain parameter values."
   },
+  "ctx.customerDb.query.options.id": {
+    schema: _typebox.Type.String({ pattern: "\\S" }),
+    fixtures: {
+      valid: "customer-report-read",
+      invalid: "",
+      absent: void 0,
+      unresolved: { expression: "operationId" },
+      edition1: "query"
+    },
+    referenceType: "string",
+    required: true,
+    resolution: "runtime-dynamic",
+    issueCode: "play_authoring_tool_request_invalid",
+    description: "Stable operation identity for Customer DB query recovery.",
+    errorMessage: "ctx.customerDb.query options.id must be a non-empty stable string."
+  },
+  "ctx.customerDb.query.options.staleAfterSeconds": {
+    schema: _typebox.Type.Literal(0),
+    fixtures: {
+      valid: 0,
+      invalid: 1,
+      absent: void 0,
+      unresolved: { expression: "ttl" },
+      edition1: 0
+    },
+    referenceType: "number | null",
+    required: false,
+    resolution: "runtime-dynamic",
+    issueCode: "play_authoring_durable_policy_invalid",
+    description: "Customer DB queries always execute with freshness 0.",
+    errorMessage: "Customer DB queries must use staleAfterSeconds: 0."
+  },
   "ctx.customerDb.query.options.maxRows": {
     schema: _typebox.Type.Integer({ minimum: 1 }),
     fixtures: {
@@ -1621,13 +1660,13 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "export type DatasetColumnRunInput<Row, Value> = { readonly row: Row; readonly ctx: DeeplinePlayRuntimeContext; readonly index: number; readonly previousCell?: PreviousCell<Value> };",
   "export type DatasetColumnDefinition<Row, Value> = { readonly run: (input: DatasetColumnRunInput<Row, Value>) => Value | Promise<Value>; readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean> };",
   "export type ConditionalStepResolver<Row, Value, Else = null> = { readonly kind: 'conditional'; readonly when: (row: Row, index: number) => boolean | Promise<boolean>; readonly run: StepResolver<Row, Value>; readonly elseValue: Else; else<ValueElse>(value: ValueElse): ConditionalStepResolver<Row, Value, ValueElse>; };",
-  "export type StepOptions<Row, Value = unknown> = { readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>; readonly recompute?: boolean; readonly recomputeOnError?: boolean; readonly staleAfterSeconds?: number };",
+  "export type StepOptions<Row, Value = unknown> = { readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>; readonly recompute?: boolean; readonly recomputeOnError?: boolean; readonly staleAfterSeconds?: DurableCallStaleAfterSeconds };",
   "export type StepProgramOptions = { readonly continueOnProviderUnavailable?: boolean };",
   "export type StepProgram<Input, Output, Return = Output> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<Output, Return>; readonly continueOnProviderUnavailable?: boolean; readonly __inputType?: (input: Input) => void; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | ConditionalStepResolver<Output, Value> | StepProgramResolver<Output, Value>): StepProgram<Input, Output & Record<Name, Value>, Return>; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | StepProgramResolver<Output, Value>, options: StepOptions<Output, Value>): StepProgram<Input, Output & Record<Name, Value | null>, Return>; return<Value>(resolver: StepResolver<Output, Value>): StepProgram<Input, Output, Value>; };",
   "export type StepProgramResolver<Input, Return> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<never, Return>; readonly __inputType?: (input: Input) => void };",
   "export type RunnableStepProgram<Input, Return> = Pick<StepProgram<Input, never, Return>, 'kind' | 'steps' | 'returnResolver' | '__inputType'>;",
   "export type RunnableColumnStepProgram<Return> = Pick<StepProgramResolver<unknown, Return>, 'kind' | 'steps' | 'returnResolver'>;",
-  "export type PlayStepProgramStep = { readonly name: string; readonly recompute?: boolean; readonly recomputeOnError?: boolean; readonly staleAfterSeconds?: number; readonly resolver: StepResolver<Record<string, unknown>, unknown> | ConditionalStepResolver<Record<string, unknown>, unknown> | StepProgramResolver<Record<string, unknown>, unknown> };",
+  "export type PlayStepProgramStep = { readonly name: string; readonly recompute?: boolean; readonly recomputeOnError?: boolean; readonly staleAfterSeconds?: DurableCallStaleAfterSeconds; readonly resolver: StepResolver<Record<string, unknown>, unknown> | ConditionalStepResolver<Record<string, unknown>, unknown> | StepProgramResolver<Record<string, unknown>, unknown> };",
   "export type ColumnResolver<Row, Value> = StepResolver<Row, Value> | ConditionalStepResolver<Row, Value> | RunnableColumnStepProgram<Value>;",
   "export type StepProgramOutput<TProgram> = TProgram extends StepProgram<unknown, infer Output, unknown> ? Output : never;",
   "export type DatasetRowKey<InputRow extends object> = (keyof InputRow & string) | readonly (keyof InputRow & string)[] | ((row: InputRow, index: number) => string | number | readonly unknown[]);",
@@ -1652,8 +1691,8 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "  readonly run: { readonly id: string };",
   `  runSteps<TInput extends Record<string, unknown>, TOutput>(program: RunnableStepProgram<TInput, TOutput>, input: TInput, options?: { description?: ${cloudReferenceType("ctx.runSteps.options.description")} }): Promise<TOutput>;`,
   "  tools: { execute<K extends string>(request: ToolExecutionRequest<K>): Promise<ToolExecutionOutput<K>> };",
-  `  customerDb: { query<TRow extends Record<string, unknown> = Record<string, unknown>>(statement: SqlQuery, options?: { maxRows?: ${cloudReferenceType("ctx.customerDb.query.options.maxRows")}; timeoutMs?: ${cloudReferenceType("ctx.customerDb.query.options.timeoutMs")} }): Promise<TRow[]> };`,
-  `  tool<K extends string>(key: ${cloudReferenceType("ctx.tool.key")}, toolId: K, input: ${cloudReferenceType("ctx.tool.input")}, options?: { description?: ${cloudReferenceType("ctx.tool.options.description")} }): Promise<ToolExecutionOutput<K>>;`,
+  `  customerDb: { query<TRow extends Record<string, unknown> = Record<string, unknown>>(statement: SqlQuery, options?: { id?: ${cloudReferenceType("ctx.customerDb.query.options.id")}; staleAfterSeconds?: ${cloudReferenceType("ctx.customerDb.query.options.staleAfterSeconds")}; maxRows?: ${cloudReferenceType("ctx.customerDb.query.options.maxRows")}; timeoutMs?: ${cloudReferenceType("ctx.customerDb.query.options.timeoutMs")} }): Promise<TRow[]> };`,
+  `  tool<K extends string>(key: ${cloudReferenceType("ctx.tool.key")}, toolId: K, input: ${cloudReferenceType("ctx.tool.input")}, options?: { description?: ${cloudReferenceType("ctx.tool.options.description")}; staleAfterSeconds?: DurableCallStaleAfterSeconds }): Promise<ToolExecutionOutput<K>>;`,
   "  step<T>(id: string, run: () => T | Promise<T>, options?: RuntimeStepOptions): Promise<T>;",
   "  fetch(key: string, url: string | URL, init?: RequestInit & { headers?: HeadersInit & { 'Idempotency-Key'?: string; 'X-Idempotency-Key'?: string }; auth?: SecretAuthInput }, options?: FetchOptions): Promise<PlayFetchResponse>;",
   "  secrets: { get(name: string): SecretPromise; bearer(secret: string | SecretPromise | SecretHandle): SecretAuth; header(header: string, secret: string | SecretPromise | SecretHandle): SecretAuth };",

package/dist/cli/{chunk-M7Y7JYZX.js → chunk-KGNTKMRG.js}

@@ -3,7 +3,7 @@
 
 
 
-var _chunkCDFH2DYLjs = require('./chunk-CDFH2DYL.js');
+var _chunkCS6RAIVYjs = require('./chunk-CS6RAIVY.js');
 
 
 
@@ -226,8 +226,8 @@ var BROWSER_OPEN_COOLDOWN_MS = 3e4;
 var SAME_URL_BROWSER_OPEN_COOLDOWN_MS = 5 * 6e4;
 var defaultBrowserCommandRunner = childProcess;
 function getAuthedHttpClient() {
-  const config = _chunkCDFH2DYLjs.resolveConfig.call(void 0, );
-  return { config, http: new (0, _chunkCDFH2DYLjs.HttpClient)(config) };
+  const config = _chunkCS6RAIVYjs.resolveConfig.call(void 0, );
+  return { config, http: new (0, _chunkCS6RAIVYjs.HttpClient)(config) };
 }
 function stableOsUserId() {
   try {
@@ -567,7 +567,7 @@ function collectLocalEnvInfo() {
     os: `${process.platform} ${process.arch}`,
     node_version: process.version,
     home_dir: homeDir,
-    agent_runtime: _chunkCDFH2DYLjs.detectAgentRuntime.call(void 0, )
+    agent_runtime: _chunkCS6RAIVYjs.detectAgentRuntime.call(void 0, )
   };
   const env = process.env;
   const optional = {
@@ -814,9 +814,9 @@ function markdownTableFromRows(rows, preferredColumns = []) {
 }
 function withAgentCommandContext(value) {
   const valueRecord = value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
-  return _chunkCDFH2DYLjs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
+  return _chunkCS6RAIVYjs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
     ...valueRecord,
-    command_context: _chunkCDFH2DYLjs.resolveCliCommandContext.call(void 0, )
+    command_context: _chunkCS6RAIVYjs.resolveCliCommandContext.call(void 0, )
   } : value;
 }
 function printJson(value, fields) {