deepline 0.3.19 → 0.3.21

package/dist/bundling-sources/shared_libs/plays/contracts.ts

@@ -11,8 +11,12 @@ import {
   type AdmittedPlayAuthoringContract,
 } from './authoring-contract';
 import {
+  InvalidToolResponseReceiptRevisionError,
   normalizeToolResponseContract,
+  normalizeToolResponseReceiptRevision,
   RAW_V2_TOOL_RESPONSE_CONTRACT,
+  RAW_V2_TOOL_RESPONSE_RECEIPT_REVISION,
+  UnsupportedToolResponseContractError,
   type ToolResponseContract,
 } from '../play-runtime/tool-response-contract';
 
@@ -46,6 +50,11 @@ export type PlayContractCompatibilitySnapshot = {
   authoringContractEdition?: PlayAuthoringContractEdition;
   /** Immutable execute-result transport selected when the artifact is built. */
   toolResponseContract?: ToolResponseContract;
+  /**
+   * Deliberate receipt-cache boundary for a response transformation. Missing
+   * preserves the original namespace of artifacts written before this field.
+   */
+  toolResponseReceiptRevision?: string;
 };
 
 export type NormalizedPlayContractCompatibilitySnapshot =
@@ -65,8 +74,8 @@ export class UnsupportedPlayToolErrorSchemaVersionError extends Error {
 }
 
 export class InvalidPlayContractCompatibilityError extends Error {
-  constructor() {
-    super('Play artifact compatibility must be an object.');
+  constructor(message = 'Play artifact compatibility must be an object.') {
+    super(message);
     this.name = 'InvalidPlayContractCompatibilityError';
   }
 }
@@ -99,12 +108,29 @@ export function normalizePlayContractCompatibility(
       requestedToolErrorSchemaVersion,
     );
   }
+  let toolResponseContract: ToolResponseContract;
+  let toolResponseReceiptRevision: string | undefined;
+  try {
+    toolResponseContract = normalizeToolResponseContract(
+      compatibility.toolResponseContract,
+    );
+    toolResponseReceiptRevision = normalizeToolResponseReceiptRevision(
+      compatibility.toolResponseReceiptRevision,
+    );
+  } catch (error) {
+    if (
+      error instanceof UnsupportedToolResponseContractError ||
+      error instanceof InvalidToolResponseReceiptRevisionError
+    ) {
+      throw new InvalidPlayContractCompatibilityError(error.message);
+    }
+    throw error;
+  }
   return {
     ...compatibility,
     toolErrorSchemaVersion: TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
-    toolResponseContract: normalizeToolResponseContract(
-      compatibility.toolResponseContract,
-    ),
+    toolResponseContract,
+    ...(toolResponseReceiptRevision ? { toolResponseReceiptRevision } : {}),
     authoringContractEdition: normalizePlayAuthoringContractEdition(
       compatibility.authoringContractEdition,
     ),
@@ -116,6 +142,7 @@ export function buildPlayContractCompatibility(input?: {
   toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
   authoringContractEdition?: PlayAuthoringContractEdition;
   toolResponseContract?: ToolResponseContract;
+  toolResponseReceiptRevision?: string;
 }): PlayContractCompatibilitySnapshot {
   return {
     apiVersion: PLAY_PUBLIC_API_VERSION,
@@ -129,6 +156,10 @@ export function buildPlayContractCompatibility(input?: {
       input?.authoringContractEdition ?? PLAY_AUTHORING_CONTRACT_EDITION,
     toolResponseContract:
       input?.toolResponseContract ?? RAW_V2_TOOL_RESPONSE_CONTRACT,
+    toolResponseReceiptRevision: normalizeToolResponseReceiptRevision(
+      input?.toolResponseReceiptRevision ??
+        RAW_V2_TOOL_RESPONSE_RECEIPT_REVISION,
+    ),
   };
 }
 

package/dist/cli/index.js

@@ -1047,7 +1047,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.19",
+  version: "0.3.21",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {
@@ -15817,6 +15817,26 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
     description: "Artifact-pinned tool error behavior, either 0 or 1.",
     errorMessage: "compatibility.toolErrorSchemaVersion must be the static literal 0 or 1."
   },
+  "compatibility.toolResponseReceiptRevision": {
+    schema: Type.String({
+      minLength: 1,
+      maxLength: 64,
+      pattern: "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
+    }),
+    fixtures: {
+      valid: "raw-v2-receipt-v1",
+      invalid: "has spaces",
+      absent: void 0,
+      unresolved: { expression: "revision" },
+      edition1: void 0
+    },
+    referenceType: "string",
+    required: false,
+    resolution: "static-required",
+    issueCode: "play_authoring_binding_invalid",
+    description: "Explicit durable-receipt revision for a response transformation; bump only when serialized tool output changes.",
+    errorMessage: "compatibility.toolResponseReceiptRevision must be a non-empty static identifier using letters, numbers, dots, underscores, or hyphens."
+  },
   inline: {
     schema: Type.Boolean(),
     fixtures: {
@@ -17004,7 +17024,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "};",
   "export type PlayBindings = {",
   `  description?: ${cloudReferenceType("description")};`,
-  `  compatibility?: { toolErrorSchemaVersion: ${cloudReferenceType("compatibility.toolErrorSchemaVersion")} };`,
+  `  compatibility?: { toolErrorSchemaVersion?: ${cloudReferenceType("compatibility.toolErrorSchemaVersion")}; toolResponseReceiptRevision?: ${cloudReferenceType("compatibility.toolResponseReceiptRevision")} };`,
   `  inline?: ${cloudReferenceType("inline")};`,
   `  billing?: { maxCreditsPerRun?: ${cloudReferenceType("billing.maxCreditsPerRun")} };`,
   `  runtime?: { timeout?: ${cloudReferenceType("runtime.timeout")}; size?: ${cloudReferenceType("runtime.size")} };`,
@@ -17343,7 +17363,7 @@ function collectInlineSecretFindings(sourceCode) {
 var MAX_PLAY_BUNDLE_BYTES = 30 * 1024 * 1024;
 
 // ../shared_libs/plays/bundling/index.ts
-var PLAY_BUNDLE_CACHE_VERSION = 35;
+var PLAY_BUNDLE_CACHE_VERSION = 36;
 var PLAY_ARTIFACT_CACHE_DIR = (0, import_node_path11.join)(
   (0, import_node_os8.tmpdir)(),
   `deepline-play-artifacts-v${PLAY_BUNDLE_CACHE_VERSION}`
@@ -17664,11 +17684,34 @@ function toolErrorSchemaVersionFromOptions(node, context) {
     "toolErrorSchemaVersion",
     context
   );
+  if (schema.kind === "absent") return void 0;
   if (schema.kind !== "found") return null;
   const schemaVersion = staticNumberFromExpression(schema.value, context);
   if (schemaVersion === 0 || schemaVersion === 1) return schemaVersion;
   return null;
 }
+function toolResponseReceiptRevisionFromOptions(node, context) {
+  const directCompatibility = resolveStaticProperty(
+    node,
+    "compatibility",
+    context
+  );
+  if (directCompatibility.kind === "unknown") return null;
+  const bindings = resolveStaticProperty(node, "bindings", context);
+  if (bindings.kind === "unknown") return null;
+  const bindingCompatibility = bindings.kind === "found" ? resolveStaticProperty(bindings.value, "compatibility", context) : { kind: "absent" };
+  if (bindingCompatibility.kind === "unknown") return null;
+  const compatibility = directCompatibility.kind === "found" ? directCompatibility : bindingCompatibility;
+  if (compatibility.kind === "absent") return void 0;
+  const revision = resolveStaticProperty(
+    compatibility.value,
+    "toolResponseReceiptRevision",
+    context
+  );
+  if (revision.kind === "absent") return void 0;
+  if (revision.kind !== "found") return null;
+  return staticStringFromExpression(revision.value, context);
+}
 function sandboxRuntimeDeclarationFromOptions(node, context) {
   const directRuntime = resolveStaticProperty(node, "runtime", context);
   const bindings = resolveStaticProperty(node, "bindings", context);
@@ -17769,7 +17812,12 @@ function playMetadataFromDefinePlayCall(node, context) {
     context
   );
   const toolErrorSchemaVersionUnknown = toolErrorSchemaVersion === null;
-  if (!name && !description && toolErrorSchemaVersion === void 0 && !toolErrorSchemaVersionUnknown) {
+  const toolResponseReceiptRevision = toolResponseReceiptRevisionFromOptions(
+    options,
+    context
+  );
+  const toolResponseReceiptRevisionUnknown = toolResponseReceiptRevision === null;
+  if (!name && !description && toolErrorSchemaVersion === void 0 && !toolErrorSchemaVersionUnknown && toolResponseReceiptRevision === void 0 && !toolResponseReceiptRevisionUnknown) {
     return null;
   }
   return {
@@ -17777,7 +17825,9 @@ function playMetadataFromDefinePlayCall(node, context) {
     description,
     sandboxRuntimeDeclaration,
     toolErrorSchemaVersion: toolErrorSchemaVersion ?? null,
-    toolErrorSchemaVersionUnknown
+    toolErrorSchemaVersionUnknown,
+    toolResponseReceiptRevision: toolResponseReceiptRevision ?? null,
+    toolResponseReceiptRevisionUnknown
   };
 }
 function resolveExportExpression(exportName, context) {

package/dist/cli/index.mjs

@@ -1033,7 +1033,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.19",
+  version: "0.3.21",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {
@@ -15873,6 +15873,26 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
     description: "Artifact-pinned tool error behavior, either 0 or 1.",
     errorMessage: "compatibility.toolErrorSchemaVersion must be the static literal 0 or 1."
   },
+  "compatibility.toolResponseReceiptRevision": {
+    schema: Type.String({
+      minLength: 1,
+      maxLength: 64,
+      pattern: "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
+    }),
+    fixtures: {
+      valid: "raw-v2-receipt-v1",
+      invalid: "has spaces",
+      absent: void 0,
+      unresolved: { expression: "revision" },
+      edition1: void 0
+    },
+    referenceType: "string",
+    required: false,
+    resolution: "static-required",
+    issueCode: "play_authoring_binding_invalid",
+    description: "Explicit durable-receipt revision for a response transformation; bump only when serialized tool output changes.",
+    errorMessage: "compatibility.toolResponseReceiptRevision must be a non-empty static identifier using letters, numbers, dots, underscores, or hyphens."
+  },
   inline: {
     schema: Type.Boolean(),
     fixtures: {
@@ -17060,7 +17080,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "};",
   "export type PlayBindings = {",
   `  description?: ${cloudReferenceType("description")};`,
-  `  compatibility?: { toolErrorSchemaVersion: ${cloudReferenceType("compatibility.toolErrorSchemaVersion")} };`,
+  `  compatibility?: { toolErrorSchemaVersion?: ${cloudReferenceType("compatibility.toolErrorSchemaVersion")}; toolResponseReceiptRevision?: ${cloudReferenceType("compatibility.toolResponseReceiptRevision")} };`,
   `  inline?: ${cloudReferenceType("inline")};`,
   `  billing?: { maxCreditsPerRun?: ${cloudReferenceType("billing.maxCreditsPerRun")} };`,
   `  runtime?: { timeout?: ${cloudReferenceType("runtime.timeout")}; size?: ${cloudReferenceType("runtime.size")} };`,
@@ -17399,7 +17419,7 @@ function collectInlineSecretFindings(sourceCode) {
 var MAX_PLAY_BUNDLE_BYTES = 30 * 1024 * 1024;
 
 // ../shared_libs/plays/bundling/index.ts
-var PLAY_BUNDLE_CACHE_VERSION = 35;
+var PLAY_BUNDLE_CACHE_VERSION = 36;
 var PLAY_ARTIFACT_CACHE_DIR = join7(
   tmpdir2(),
   `deepline-play-artifacts-v${PLAY_BUNDLE_CACHE_VERSION}`
@@ -17720,11 +17740,34 @@ function toolErrorSchemaVersionFromOptions(node, context) {
     "toolErrorSchemaVersion",
     context
   );
+  if (schema.kind === "absent") return void 0;
   if (schema.kind !== "found") return null;
   const schemaVersion = staticNumberFromExpression(schema.value, context);
   if (schemaVersion === 0 || schemaVersion === 1) return schemaVersion;
   return null;
 }
+function toolResponseReceiptRevisionFromOptions(node, context) {
+  const directCompatibility = resolveStaticProperty(
+    node,
+    "compatibility",
+    context
+  );
+  if (directCompatibility.kind === "unknown") return null;
+  const bindings = resolveStaticProperty(node, "bindings", context);
+  if (bindings.kind === "unknown") return null;
+  const bindingCompatibility = bindings.kind === "found" ? resolveStaticProperty(bindings.value, "compatibility", context) : { kind: "absent" };
+  if (bindingCompatibility.kind === "unknown") return null;
+  const compatibility = directCompatibility.kind === "found" ? directCompatibility : bindingCompatibility;
+  if (compatibility.kind === "absent") return void 0;
+  const revision = resolveStaticProperty(
+    compatibility.value,
+    "toolResponseReceiptRevision",
+    context
+  );
+  if (revision.kind === "absent") return void 0;
+  if (revision.kind !== "found") return null;
+  return staticStringFromExpression(revision.value, context);
+}
 function sandboxRuntimeDeclarationFromOptions(node, context) {
   const directRuntime = resolveStaticProperty(node, "runtime", context);
   const bindings = resolveStaticProperty(node, "bindings", context);
@@ -17825,7 +17868,12 @@ function playMetadataFromDefinePlayCall(node, context) {
     context
   );
   const toolErrorSchemaVersionUnknown = toolErrorSchemaVersion === null;
-  if (!name && !description && toolErrorSchemaVersion === void 0 && !toolErrorSchemaVersionUnknown) {
+  const toolResponseReceiptRevision = toolResponseReceiptRevisionFromOptions(
+    options,
+    context
+  );
+  const toolResponseReceiptRevisionUnknown = toolResponseReceiptRevision === null;
+  if (!name && !description && toolErrorSchemaVersion === void 0 && !toolErrorSchemaVersionUnknown && toolResponseReceiptRevision === void 0 && !toolResponseReceiptRevisionUnknown) {
     return null;
   }
   return {
@@ -17833,7 +17881,9 @@ function playMetadataFromDefinePlayCall(node, context) {
     description,
     sandboxRuntimeDeclaration,
     toolErrorSchemaVersion: toolErrorSchemaVersion ?? null,
-    toolErrorSchemaVersionUnknown
+    toolErrorSchemaVersionUnknown,
+    toolResponseReceiptRevision: toolResponseReceiptRevision ?? null,
+    toolResponseReceiptRevisionUnknown
   };
 }
 function resolveExportExpression(exportName, context) {

package/dist/{compiler-manifest-Bd0O94yZ.d.mts → compiler-manifest-DwYe2C2S.d.mts}

@@ -1098,7 +1098,12 @@ type PlayAuthoringAstBindings = {
 type PlayAuthoringBindings = {
     description?: string;
     compatibility?: {
-        toolErrorSchemaVersion: ToolExecutionErrorSchemaVersion;
+        toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
+        /**
+         * Bump only when a Play's response transformation changes serialized tool
+         * output and requires fresh durable tool receipts.
+         */
+        toolResponseReceiptRevision?: string;
     };
     inline?: boolean;
     billing?: {
@@ -1528,6 +1533,24 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly description: "Artifact-pinned tool error behavior, either 0 or 1.";
         readonly errorMessage: "compatibility.toolErrorSchemaVersion must be the static literal 0 or 1.";
     };
+    readonly 'compatibility.toolResponseReceiptRevision': {
+        readonly schema: _sinclair_typebox.TString;
+        readonly fixtures: {
+            readonly valid: "raw-v2-receipt-v1";
+            readonly invalid: "has spaces";
+            readonly absent: undefined;
+            readonly unresolved: {
+                readonly expression: "revision";
+            };
+            readonly edition1: undefined;
+        };
+        readonly referenceType: "string";
+        readonly required: false;
+        readonly resolution: "static-required";
+        readonly issueCode: "play_authoring_binding_invalid";
+        readonly description: "Explicit durable-receipt revision for a response transformation; bump only when serialized tool output changes.";
+        readonly errorMessage: "compatibility.toolResponseReceiptRevision must be a non-empty static identifier using letters, numbers, dots, underscores, or hyphens.";
+    };
     readonly inline: {
         readonly schema: _sinclair_typebox.TBoolean;
         readonly fixtures: {

package/dist/{compiler-manifest-Bd0O94yZ.d.ts → compiler-manifest-DwYe2C2S.d.ts}

@@ -1098,7 +1098,12 @@ type PlayAuthoringAstBindings = {
 type PlayAuthoringBindings = {
     description?: string;
     compatibility?: {
-        toolErrorSchemaVersion: ToolExecutionErrorSchemaVersion;
+        toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
+        /**
+         * Bump only when a Play's response transformation changes serialized tool
+         * output and requires fresh durable tool receipts.
+         */
+        toolResponseReceiptRevision?: string;
     };
     inline?: boolean;
     billing?: {
@@ -1528,6 +1533,24 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly description: "Artifact-pinned tool error behavior, either 0 or 1.";
         readonly errorMessage: "compatibility.toolErrorSchemaVersion must be the static literal 0 or 1.";
     };
+    readonly 'compatibility.toolResponseReceiptRevision': {
+        readonly schema: _sinclair_typebox.TString;
+        readonly fixtures: {
+            readonly valid: "raw-v2-receipt-v1";
+            readonly invalid: "has spaces";
+            readonly absent: undefined;
+            readonly unresolved: {
+                readonly expression: "revision";
+            };
+            readonly edition1: undefined;
+        };
+        readonly referenceType: "string";
+        readonly required: false;
+        readonly resolution: "static-required";
+        readonly issueCode: "play_authoring_binding_invalid";
+        readonly description: "Explicit durable-receipt revision for a response transformation; bump only when serialized tool output changes.";
+        readonly errorMessage: "compatibility.toolResponseReceiptRevision must be a non-empty static identifier using letters, numbers, dots, underscores, or hyphens.";
+    };
     readonly inline: {
         readonly schema: _sinclair_typebox.TBoolean;
         readonly fixtures: {

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest, O as PlayAuthoringStepProgramOptions } from './compiler-manifest-Bd0O94yZ.mjs';
-export { Q as DEEPLINE_EXTRACTOR_TARGETS, R as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, S as DeeplineEmailStatusGetterValue, U as DeeplineExtractorTarget, V as DeeplineGetterValue, W as DeeplineGetterValueMap, X as JOB_CHANGE_STATUS_VALUES, Y as JobChangeStatus, Z as PHONE_STATUS_VALUES, _ as PhoneStatus, $ as PlayDataset, a0 as PlayDatasetInput, a1 as PreviousCell, a2 as ProviderTransientError, a3 as ProviderTransientErrorCategory, a4 as ProviderUnavailableError, a5 as ProviderUnavailableReason, a6 as ToolExecutionErrorCategory, a7 as ToolExecutionErrorOrigin, a8 as ToolExecutionFailureV1, a9 as ToolExecutionNetworkKind, aa as ToolExecutionNetworkScope, ab as getProviderUnavailableReason, ac as isDeeplineExtractorTarget, ad as isProviderUnavailable, ae as isProviderWaterfallUnavailableError } from './compiler-manifest-Bd0O94yZ.mjs';
+import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest, O as PlayAuthoringStepProgramOptions } from './compiler-manifest-DwYe2C2S.mjs';
+export { Q as DEEPLINE_EXTRACTOR_TARGETS, R as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, S as DeeplineEmailStatusGetterValue, U as DeeplineExtractorTarget, V as DeeplineGetterValue, W as DeeplineGetterValueMap, X as JOB_CHANGE_STATUS_VALUES, Y as JobChangeStatus, Z as PHONE_STATUS_VALUES, _ as PhoneStatus, $ as PlayDataset, a0 as PlayDatasetInput, a1 as PreviousCell, a2 as ProviderTransientError, a3 as ProviderTransientErrorCategory, a4 as ProviderUnavailableError, a5 as ProviderUnavailableReason, a6 as ToolExecutionErrorCategory, a7 as ToolExecutionErrorOrigin, a8 as ToolExecutionFailureV1, a9 as ToolExecutionNetworkKind, aa as ToolExecutionNetworkScope, ab as getProviderUnavailableReason, ac as isDeeplineExtractorTarget, ad as isProviderUnavailable, ae as isProviderWaterfallUnavailableError } from './compiler-manifest-DwYe2C2S.mjs';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest, O as PlayAuthoringStepProgramOptions } from './compiler-manifest-Bd0O94yZ.js';
-export { Q as DEEPLINE_EXTRACTOR_TARGETS, R as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, S as DeeplineEmailStatusGetterValue, U as DeeplineExtractorTarget, V as DeeplineGetterValue, W as DeeplineGetterValueMap, X as JOB_CHANGE_STATUS_VALUES, Y as JobChangeStatus, Z as PHONE_STATUS_VALUES, _ as PhoneStatus, $ as PlayDataset, a0 as PlayDatasetInput, a1 as PreviousCell, a2 as ProviderTransientError, a3 as ProviderTransientErrorCategory, a4 as ProviderUnavailableError, a5 as ProviderUnavailableReason, a6 as ToolExecutionErrorCategory, a7 as ToolExecutionErrorOrigin, a8 as ToolExecutionFailureV1, a9 as ToolExecutionNetworkKind, aa as ToolExecutionNetworkScope, ab as getProviderUnavailableReason, ac as isDeeplineExtractorTarget, ad as isProviderUnavailable, ae as isProviderWaterfallUnavailableError } from './compiler-manifest-Bd0O94yZ.js';
+import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest, O as PlayAuthoringStepProgramOptions } from './compiler-manifest-DwYe2C2S.js';
+export { Q as DEEPLINE_EXTRACTOR_TARGETS, R as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, S as DeeplineEmailStatusGetterValue, U as DeeplineExtractorTarget, V as DeeplineGetterValue, W as DeeplineGetterValueMap, X as JOB_CHANGE_STATUS_VALUES, Y as JobChangeStatus, Z as PHONE_STATUS_VALUES, _ as PhoneStatus, $ as PlayDataset, a0 as PlayDatasetInput, a1 as PreviousCell, a2 as ProviderTransientError, a3 as ProviderTransientErrorCategory, a4 as ProviderUnavailableError, a5 as ProviderUnavailableReason, a6 as ToolExecutionErrorCategory, a7 as ToolExecutionErrorOrigin, a8 as ToolExecutionFailureV1, a9 as ToolExecutionNetworkKind, aa as ToolExecutionNetworkScope, ab as getProviderUnavailableReason, ac as isDeeplineExtractorTarget, ad as isProviderUnavailable, ae as isProviderWaterfallUnavailableError } from './compiler-manifest-DwYe2C2S.js';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;

package/dist/index.js

@@ -783,7 +783,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.19",
+  version: "0.3.21",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {

package/dist/index.mjs

@@ -706,7 +706,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.19",
+  version: "0.3.21",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {

package/dist/install-integrity.json

@@ -233,8 +233,8 @@
     "dist/cli/index.js",
     "dist/cli/index.mjs",
     "dist/cli/text-imports.d.ts",
-    "dist/compiler-manifest-Bd0O94yZ.d.mts",
-    "dist/compiler-manifest-Bd0O94yZ.d.ts",
+    "dist/compiler-manifest-DwYe2C2S.d.mts",
+    "dist/compiler-manifest-DwYe2C2S.d.ts",
     "dist/helpers.d.mts",
     "dist/helpers.d.ts",
     "dist/helpers.js",

package/dist/plays/bundle-play-file.d.mts

@@ -1,11 +1,15 @@
 /// <reference path="./text-imports.d.ts" />
-import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-Bd0O94yZ.mjs';
-export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-Bd0O94yZ.mjs';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-DwYe2C2S.mjs';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-DwYe2C2S.mjs';
 import '@sinclair/typebox';
 
 /**
  * Public tool-response contracts shared by the API, SDK, Play bundler, and
- * runtime. A response contract is transport behavior, never Play authoring.
+ * runtime. This is a versioned response transformation contract: a change to
+ * the persisted public tool-result shape must introduce a new value here and
+ * have newly built Play artifacts select it. Receipt-cache revisions are
+ * intentionally separate: ordinary response-contract changes do not refresh
+ * durable receipts unless the response transformation changed as well.
  */
 declare const V2_TOOL_RESPONSE_CONTRACT: "v2-tool-response";
 declare const RAW_V2_TOOL_RESPONSE_CONTRACT: "raw-v2";
@@ -33,6 +37,8 @@ type PlayArtifactCompatibility = {
     authoringContractEdition?: PlayAuthoringContractEdition;
     /** Missing preserves the raw-only V2 execute response contract. */
     toolResponseContract?: ToolResponseContract;
+    /** Missing preserves the receipt namespace of artifacts created before this revision existed. */
+    toolResponseReceiptRevision?: string;
 };
 /** The only executable Play artifact contract. */
 type PlayArtifactKind = 'cjs_node20';

package/dist/plays/bundle-play-file.d.ts

@@ -1,11 +1,15 @@
 /// <reference path="./text-imports.d.ts" />
-import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-Bd0O94yZ.js';
-export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-Bd0O94yZ.js';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-DwYe2C2S.js';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-DwYe2C2S.js';
 import '@sinclair/typebox';
 
 /**
  * Public tool-response contracts shared by the API, SDK, Play bundler, and
- * runtime. A response contract is transport behavior, never Play authoring.
+ * runtime. This is a versioned response transformation contract: a change to
+ * the persisted public tool-result shape must introduce a new value here and
+ * have newly built Play artifacts select it. Receipt-cache revisions are
+ * intentionally separate: ordinary response-contract changes do not refresh
+ * durable receipts unless the response transformation changed as well.
  */
 declare const V2_TOOL_RESPONSE_CONTRACT: "v2-tool-response";
 declare const RAW_V2_TOOL_RESPONSE_CONTRACT: "raw-v2";
@@ -33,6 +37,8 @@ type PlayArtifactCompatibility = {
     authoringContractEdition?: PlayAuthoringContractEdition;
     /** Missing preserves the raw-only V2 execute response contract. */
     toolResponseContract?: ToolResponseContract;
+    /** Missing preserves the receipt namespace of artifacts created before this revision existed. */
+    toolResponseReceiptRevision?: string;
 };
 /** The only executable Play artifact contract. */
 type PlayArtifactKind = 'cjs_node20';