deepline 0.3.393 → 0.3.395

package/dist/cli/{chunk-OXNOAD6Y.js → chunk-K5T3EN6D.js}

@@ -2,10 +2,10 @@
 
 
 
-var _chunkM7Y7JYZXjs = require('./chunk-M7Y7JYZX.js');
+var _chunkHRWUQJ4Kjs = require('./chunk-HRWUQJ4K.js');
 
 
-var _chunkCDFH2DYLjs = require('./chunk-CDFH2DYL.js');
+var _chunk56IFFVIBjs = require('./chunk-56IFFVIB.js');
 
 // src/cli/commands/git.ts
 function shellQuote(value) {
@@ -32,11 +32,11 @@ function renderDeployment(deployment) {
   return `${deployment.id}  ${source} (${kind}) - ${deployment.status}${suffix}`;
 }
 async function handleList(options) {
-  const { http } = _chunkM7Y7JYZXjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkHRWUQJ4Kjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     `/api/v2/play-projects${options.all ? "?includeDisabled=1" : ""}`
   );
-  _chunkM7Y7JYZXjs.printCommandEnvelope.call(void 0, 
+  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
     {
       projects: payload.projects,
       count: payload.projects.length,
@@ -73,7 +73,7 @@ function describeInstallationStatus(installation) {
   }
 }
 async function handleStatus(options) {
-  const { http } = _chunkM7Y7JYZXjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkHRWUQJ4Kjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get("/api/v2/github/installation");
   const installation = payload.installation;
   const others = (_nullishCoalesce(payload.installations, () => ( []))).filter(
@@ -136,7 +136,7 @@ async function handleStatus(options) {
       )
     );
   }
-  _chunkM7Y7JYZXjs.printCommandEnvelope.call(void 0, 
+  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
     {
       installation,
       installations: _nullishCoalesce(payload.installations, () => ( [])),
@@ -147,10 +147,10 @@ async function handleStatus(options) {
   );
 }
 async function handleRepos(options) {
-  const { http } = _chunkM7Y7JYZXjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkHRWUQJ4Kjs.getAuthedHttpClient.call(void 0, );
   const query = options.installation ? `?installationId=${encodeURIComponent(options.installation)}` : "";
   const payload = await http.get(`/api/v2/github/repos${query}`);
-  _chunkM7Y7JYZXjs.printCommandEnvelope.call(void 0, 
+  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
     {
       installation: payload.installation,
       repositories: payload.repositories,
@@ -171,7 +171,7 @@ async function handleRepos(options) {
 }
 async function resolveRepoId(repo, installation) {
   if (/^\d+$/.test(repo)) return Number(repo);
-  const { http } = _chunkM7Y7JYZXjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkHRWUQJ4Kjs.getAuthedHttpClient.call(void 0, );
   const query = installation ? `?installationId=${encodeURIComponent(installation)}` : "";
   const payload = await http.get(
     `/api/v2/github/repos${query}`
@@ -188,7 +188,7 @@ async function resolveRepoId(repo, installation) {
 }
 async function handleLink(repo, options) {
   const repoId = await resolveRepoId(repo, options.installation);
-  const { http } = _chunkM7Y7JYZXjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkHRWUQJ4Kjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.post("/api/v2/play-projects", {
     repoId,
     ...options.installation !== void 0 ? { installationId: options.installation } : {},
@@ -197,7 +197,7 @@ async function handleLink(repo, options) {
     ...options.branch !== void 0 ? { productionBranch: options.branch } : {},
     ...options.prChecks !== void 0 ? { checkOnPullRequest: options.prChecks } : {}
   });
-  _chunkM7Y7JYZXjs.printCommandEnvelope.call(void 0, 
+  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -220,11 +220,11 @@ async function handleLink(repo, options) {
   );
 }
 async function handleGet(id, options) {
-  const { http } = _chunkM7Y7JYZXjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkHRWUQJ4Kjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     `/api/v2/play-projects/${encodeURIComponent(id)}`
   );
-  _chunkM7Y7JYZXjs.printCommandEnvelope.call(void 0, 
+  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -240,7 +240,7 @@ async function handleGet(id, options) {
   );
 }
 async function handleSet(id, options) {
-  const { http } = _chunkM7Y7JYZXjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkHRWUQJ4Kjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.patch(
     `/api/v2/play-projects/${encodeURIComponent(id)}`,
     {
@@ -251,7 +251,7 @@ async function handleSet(id, options) {
       ...options.disabled !== void 0 ? { disabled: options.disabled } : {}
     }
   );
-  _chunkM7Y7JYZXjs.printCommandEnvelope.call(void 0, 
+  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -264,9 +264,9 @@ async function handleSet(id, options) {
   );
 }
 async function handleUnlink(id, options) {
-  const { http } = _chunkM7Y7JYZXjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkHRWUQJ4Kjs.getAuthedHttpClient.call(void 0, );
   await http.delete(`/api/v2/play-projects/${encodeURIComponent(id)}`);
-  _chunkM7Y7JYZXjs.printCommandEnvelope.call(void 0, 
+  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       id,
@@ -286,10 +286,10 @@ async function handleUnlink(id, options) {
   );
 }
 async function handleConnect(options) {
-  const baseUrl = _chunkCDFH2DYLjs.resolveBaseUrlOnly.call(void 0, );
+  const baseUrl = _chunk56IFFVIBjs.resolveBaseUrlOnly.call(void 0, );
   const connectUrl = `${baseUrl.replace(/\/$/, "")}/api/v2/github/connect`;
-  const opened = _chunkM7Y7JYZXjs.openInBrowser.call(void 0, connectUrl);
-  _chunkM7Y7JYZXjs.printCommandEnvelope.call(void 0, 
+  const opened = _chunkHRWUQJ4Kjs.openInBrowser.call(void 0, connectUrl);
+  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
     {
       connectUrl,
       browser: opened,
@@ -311,7 +311,7 @@ async function handleConnect(options) {
   );
 }
 async function handleDeploymentsList(options) {
-  const { http } = _chunkM7Y7JYZXjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkHRWUQJ4Kjs.getAuthedHttpClient.call(void 0, );
   const query = new URLSearchParams();
   if (options.repo) query.set("projectId", options.repo);
   if (options.limit) query.set("limit", options.limit);
@@ -319,7 +319,7 @@ async function handleDeploymentsList(options) {
   const payload = await http.get(
     `/api/v2/deployments${suffix}`
   );
-  _chunkM7Y7JYZXjs.printCommandEnvelope.call(void 0, 
+  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
     {
       deployments: payload.deployments,
       count: payload.deployments.length,
@@ -363,12 +363,12 @@ function renderDeploymentMonitorLines(results) {
   ]);
 }
 async function handleDeploymentGet(id, options) {
-  const { http } = _chunkM7Y7JYZXjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkHRWUQJ4Kjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(`/api/v2/deployments/${encodeURIComponent(id)}`);
   const playLines = renderDeploymentPlayLines(payload.deployment.results);
   const monitorLines = renderDeploymentMonitorLines(payload.deployment.results);
   const repository = _nullishCoalesce(_optionalChain([payload, 'access', _10 => _10.project, 'optionalAccess', _11 => _11.repoFullName]), () => ( payload.deployment.repoFullName));
-  _chunkM7Y7JYZXjs.printCommandEnvelope.call(void 0, 
+  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
     {
       deployment: payload.deployment,
       project: payload.project,
@@ -387,9 +387,9 @@ async function handleDeploymentGet(id, options) {
   );
 }
 async function handleDeploymentCancel(id, options) {
-  const { http } = _chunkM7Y7JYZXjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkHRWUQJ4Kjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.post(`/api/v2/deployments/${encodeURIComponent(id)}/cancel`, {});
-  _chunkM7Y7JYZXjs.printCommandEnvelope.call(void 0, 
+  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
     {
       cancelled: payload.cancelled,
       deployment: payload.deployment,

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 };",