deepline 0.3.19 → 0.3.21

package/dist/plays/bundle-play-file.mjs

@@ -2747,6 +2747,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: {
@@ -3934,7 +3954,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")} };`,
@@ -4010,6 +4030,23 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
 
 // ../shared_libs/play-runtime/tool-response-contract.ts
 var RAW_V2_TOOL_RESPONSE_CONTRACT = "raw-v2";
+var RAW_V2_TOOL_RESPONSE_RECEIPT_REVISION = "raw-v2-receipt-v1";
+var TOOL_RESPONSE_RECEIPT_REVISION_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,63})$/;
+var InvalidToolResponseReceiptRevisionError = class extends Error {
+  constructor(value) {
+    super(
+      `Tool response receipt revision must be a non-empty static identifier (letters, numbers, '.', '_', or '-'); received ${String(value)}.`
+    );
+    this.name = "InvalidToolResponseReceiptRevisionError";
+  }
+};
+function normalizeToolResponseReceiptRevision(value) {
+  if (value == null) return void 0;
+  if (typeof value === "string" && TOOL_RESPONSE_RECEIPT_REVISION_PATTERN.test(value)) {
+    return value;
+  }
+  throw new InvalidToolResponseReceiptRevisionError(value);
+}
 
 // ../shared_libs/plays/contracts.ts
 var PLAY_PUBLIC_API_VERSION = 1;
@@ -4030,7 +4067,10 @@ function buildPlayContractCompatibility(input) {
     runtimeBackend: input?.runtimeBackend ?? null,
     toolErrorSchemaVersion: input?.toolErrorSchemaVersion ?? TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
     authoringContractEdition: input?.authoringContractEdition ?? PLAY_AUTHORING_CONTRACT_EDITION,
-    toolResponseContract: input?.toolResponseContract ?? RAW_V2_TOOL_RESPONSE_CONTRACT
+    toolResponseContract: input?.toolResponseContract ?? RAW_V2_TOOL_RESPONSE_CONTRACT,
+    toolResponseReceiptRevision: normalizeToolResponseReceiptRevision(
+      input?.toolResponseReceiptRevision ?? RAW_V2_TOOL_RESPONSE_RECEIPT_REVISION
+    )
   };
 }
 
@@ -5339,7 +5379,7 @@ function validatePlaySourceFilesHaveNoInlineSecrets(sourceFiles) {
 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 = join(
   tmpdir(),
   `deepline-play-artifacts-v${PLAY_BUNDLE_CACHE_VERSION}`
@@ -5817,11 +5857,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);
@@ -5922,7 +5985,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 {
@@ -5930,7 +5998,9 @@ function playMetadataFromDefinePlayCall(node, context) {
     description,
     sandboxRuntimeDeclaration,
     toolErrorSchemaVersion: toolErrorSchemaVersion ?? null,
-    toolErrorSchemaVersionUnknown
+    toolErrorSchemaVersionUnknown,
+    toolResponseReceiptRevision: toolResponseReceiptRevision ?? null,
+    toolResponseReceiptRevisionUnknown
   };
 }
 function resolveExportExpression(exportName, context) {
@@ -6525,6 +6595,11 @@ async function analyzeSourceGraph(entryFile, adapter, exportName) {
       "definePlay compatibility.toolErrorSchemaVersion must be the static literal 0 or 1."
     );
   }
+  if (metadata?.toolResponseReceiptRevisionUnknown) {
+    throw new Error(
+      "definePlay compatibility.toolResponseReceiptRevision must be a static non-empty string."
+    );
+  }
   const playName = metadata?.name ?? null;
   const playDescription = metadata?.description ?? null;
   const sandboxRuntimeDeclaration = metadata?.sandboxRuntimeDeclaration ?? null;
@@ -6546,6 +6621,7 @@ async function analyzeSourceGraph(entryFile, adapter, exportName) {
     playDescription,
     sandboxRuntimeDeclaration,
     toolErrorSchemaVersion: metadata?.toolErrorSchemaVersion ?? null,
+    toolResponseReceiptRevision: metadata?.toolResponseReceiptRevision ?? null,
     importedPlayDependencies: [...importedPlayDependencies.values()].sort(
       (left, right) => left.filePath.localeCompare(right.filePath)
     )
@@ -6748,7 +6824,8 @@ authoring-contract-edition:${PLAY_AUTHORING_CONTRACT_EDITION}`
           sourceHash: analysis.sourceHash,
           importPolicy,
           compatibility: buildPlayContractCompatibility({
-            toolErrorSchemaVersion: analysis.toolErrorSchemaVersion ?? void 0
+            toolErrorSchemaVersion: analysis.toolErrorSchemaVersion ?? void 0,
+            toolResponseReceiptRevision: analysis.toolResponseReceiptRevision ?? void 0
           }),
           cacheHit: true
         },
@@ -6812,7 +6889,8 @@ authoring-contract-edition:${PLAY_AUTHORING_CONTRACT_EDITION}`
       sourceMap: normalizedSourceMap,
       importPolicy,
       compatibility: buildPlayContractCompatibility({
-        toolErrorSchemaVersion: analysis.toolErrorSchemaVersion ?? void 0
+        toolErrorSchemaVersion: analysis.toolErrorSchemaVersion ?? void 0,
+        toolResponseReceiptRevision: analysis.toolResponseReceiptRevision ?? void 0
       }),
       generatedAt: Date.now(),
       cacheHit: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",