deepline 0.3.72 → 0.3.74

package/dist/bundling-sources/shared_libs/play-runtime/tool-call/runtime-step-receipts-adapter.ts

@@ -48,6 +48,8 @@ export type RuntimeStepToolResultReceiptsInput = {
    */
   executionLock?: {
     required?: boolean;
+    /** Provider-operation identity; defaults to the result-cache receipt. */
+    key?: string;
     ttlMs?: number;
     waitMs?: number;
     pollMs?: number;
@@ -88,6 +90,7 @@ type OwnedReceipt = {
   ownerRunId: string;
   force: boolean;
   executionLockOwnerId: string | null;
+  executionLockKey: string | null;
   lockLost: boolean;
   completedByAnotherOwner: ToolExecuteResult | null;
   heartbeatTimer: ReturnType<typeof setTimeout> | null;
@@ -99,9 +102,9 @@ type OwnedReceipt = {
  *
  * Tool results deliberately use the store's immutable completed-cache mode:
  * a cache hit is reused, execution does not publish a `running` row, and the
- * winner inserts one serialized ToolExecuteResult. That is what lets a V2
- * receipt key be distinct from a legacy one without creating another provider
- * invocation fence. The provider fence remains the dispatcher's Operation.
+ * winner inserts one canonical serialized ToolExecuteResult. Response
+ * presentation is materialized after cache recovery; only actions that
+ * explicitly require an execution fence acquire the optional lock below.
  */
 export function createRuntimeStepToolResultReceipts(
   input: RuntimeStepToolResultReceiptsInput,
@@ -164,7 +167,7 @@ export function createRuntimeStepToolResultReceipts(
       return;
     }
     await input.store.releaseExecutionLock({
-      receiptKey: record.resultReceiptKey,
+      receiptKey: record.executionLockKey ?? record.resultReceiptKey,
       ownerExecutionId: record.executionLockOwnerId,
     });
     record.executionLockOwnerId = null;
@@ -177,7 +180,7 @@ export function createRuntimeStepToolResultReceipts(
       return 'active';
     }
     const renewed = await input.store.acquireExecutionLock({
-      receiptKey: record.resultReceiptKey,
+      receiptKey: record.executionLockKey ?? record.resultReceiptKey,
       ownerExecutionId: record.executionLockOwnerId,
       ttlMs: lock.ttlMs,
     });
@@ -238,7 +241,7 @@ export function createRuntimeStepToolResultReceipts(
   const acquireExecutionLock = async (
     resultReceiptKey: string,
     force: boolean,
-  ): Promise<string | null> => {
+  ): Promise<{ ownerId: string; key: string } | null> => {
     if (!lock.required || !input.store.enabled) return null;
     if (
       !input.store.acquireExecutionLock ||
@@ -249,11 +252,12 @@ export function createRuntimeStepToolResultReceipts(
       );
     }
 
+    const executionLockKey = lock.key || resultReceiptKey;
     const ownerExecutionId = `tool-result:${crypto.randomUUID()}`;
     const deadline = Date.now() + lock.waitMs;
     while (true) {
       const acquired = await input.store.acquireExecutionLock({
-        receiptKey: resultReceiptKey,
+        receiptKey: executionLockKey,
         ownerExecutionId,
         ttlMs: lock.ttlMs,
       });
@@ -265,13 +269,13 @@ export function createRuntimeStepToolResultReceipts(
           const cached = await readCompleted(resultReceiptKey, 'in_flight');
           if (cached) {
             await input.store.releaseExecutionLock({
-              receiptKey: resultReceiptKey,
+              receiptKey: executionLockKey,
               ownerExecutionId,
             });
             return null;
           }
         }
-        return ownerExecutionId;
+        return { ownerId: ownerExecutionId, key: executionLockKey };
       }
 
       if (!force) {
@@ -299,11 +303,11 @@ export function createRuntimeStepToolResultReceipts(
         if (cached) return { kind: 'completed', result: cached };
       }
 
-      const executionLockOwnerId = await acquireExecutionLock(
+      const executionLock = await acquireExecutionLock(
         resultReceiptKey,
         candidate.force,
       );
-      if (input.store.enabled && !candidate.force && !executionLockOwnerId) {
+      if (input.store.enabled && !candidate.force && !executionLock) {
         const cached = await readCompleted(resultReceiptKey, 'cache');
         if (cached) return { kind: 'completed', result: cached };
         // The only non-lock reason to get here is a store without a lock
@@ -311,12 +315,13 @@ export function createRuntimeStepToolResultReceipts(
       }
 
       const leaseId =
-        executionLockOwnerId ?? `tool-result:${crypto.randomUUID()}`;
+        executionLock?.ownerId ?? `tool-result:${crypto.randomUUID()}`;
       owned.set(leaseId, {
         resultReceiptKey,
         ownerRunId,
         force: candidate.force,
-        executionLockOwnerId,
+        executionLockOwnerId: executionLock?.ownerId ?? null,
+        executionLockKey: executionLock?.key ?? null,
         lockLost: false,
         completedByAnotherOwner: null,
         heartbeatTimer: null,
@@ -505,6 +510,7 @@ function normalizeExecutionLock(
   }
   return {
     required: input?.required === true,
+    key: input?.key?.trim() ?? '',
     ttlMs: Math.floor(ttlMs),
     waitMs: Math.floor(waitMs),
     pollMs: Math.floor(pollMs),

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

@@ -50,10 +50,7 @@ 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.
-   */
+  /** Legacy response metadata; it does not change completed-result caching. */
   toolResponseReceiptRevision?: string;
 };
 

package/dist/bundling-sources/shared_libs/plays/tool-response-contract.ts

@@ -10,9 +10,8 @@ export const V2_TOOL_RESPONSE_CONTRACT = 'v2-tool-response' as const;
 export const RAW_V2_TOOL_RESPONSE_CONTRACT = 'raw-v2' as const;
 
 /**
- * Deliberate durable-receipt boundary for the raw-v2 response transformation.
- * Bump only when that transformation changes serialized tool output. Do not
- * bump for ordinary protocol, authoring, or transport contract changes.
+ * Legacy artifact compatibility metadata. It is carried through published
+ * artifacts but does not partition completed-result cache entries.
  */
 export const RAW_V2_TOOL_RESPONSE_RECEIPT_REVISION = 'raw-v2-receipt-v1';
 const TOOL_RESPONSE_RECEIPT_REVISION_PATTERN =
@@ -36,7 +35,6 @@ export function isToolResponseContract(
 /**
  * Preserves the distinction between an old artifact with no declared response
  * contract and an artifact that explicitly selected the legacy V2 contract.
- * Receipt reuse is controlled separately by `toolResponseReceiptRevision`.
  */
 export function declaredToolResponseContract(
   value: unknown,

package/dist/cli/index.js

@@ -1214,7 +1214,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.72",
+  version: "0.3.74",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -31595,7 +31595,7 @@ var MONITOR_FLEET_REMOVAL_GRACE_MS = 7 * 24 * 60 * 6e4;
 var MONITOR_FLEET_DOCUMENTATION = {
   summary: "A Monitor Fleet keeps one bounded, sticky set of ordinary monitors aligned with Customer DB rows.",
   authoredFields: {
-    id: "Stable lowercase fleet id used by sync, pause, resume, and deactivate.",
+    id: "Stable lowercase fleet id used by sync, get, and deactivate.",
     source: "Customer DB table, unique row key, and optional equality filters that select candidate rows.",
     member: "Ordinary monitor tool, stable key template, and payload evaluated for each selected source row.",
     selection: "Deterministic ranking and an active-member limit between 1 and 1,000."

package/dist/cli/index.mjs

@@ -1199,7 +1199,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.72",
+  version: "0.3.74",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -31664,7 +31664,7 @@ var MONITOR_FLEET_REMOVAL_GRACE_MS = 7 * 24 * 60 * 6e4;
 var MONITOR_FLEET_DOCUMENTATION = {
   summary: "A Monitor Fleet keeps one bounded, sticky set of ordinary monitors aligned with Customer DB rows.",
   authoredFields: {
-    id: "Stable lowercase fleet id used by sync, pause, resume, and deactivate.",
+    id: "Stable lowercase fleet id used by sync, get, and deactivate.",
     source: "Customer DB table, unique row key, and optional equality filters that select candidate rows.",
     member: "Ordinary monitor tool, stable key template, and payload evaluated for each selected source row.",
     selection: "Deterministic ranking and an active-member limit between 1 and 1,000."

package/dist/index.d.mts

@@ -1956,7 +1956,7 @@ declare const MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG: readonly [{
 declare const MONITOR_FLEET_DOCUMENTATION: {
     readonly summary: "A Monitor Fleet keeps one bounded, sticky set of ordinary monitors aligned with Customer DB rows.";
     readonly authoredFields: {
-        readonly id: "Stable lowercase fleet id used by sync, pause, resume, and deactivate.";
+        readonly id: "Stable lowercase fleet id used by sync, get, and deactivate.";
         readonly source: "Customer DB table, unique row key, and optional equality filters that select candidate rows.";
         readonly member: "Ordinary monitor tool, stable key template, and payload evaluated for each selected source row.";
         readonly selection: "Deterministic ranking and an active-member limit between 1 and 1,000.";

package/dist/index.d.ts

@@ -1956,7 +1956,7 @@ declare const MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG: readonly [{
 declare const MONITOR_FLEET_DOCUMENTATION: {
     readonly summary: "A Monitor Fleet keeps one bounded, sticky set of ordinary monitors aligned with Customer DB rows.";
     readonly authoredFields: {
-        readonly id: "Stable lowercase fleet id used by sync, pause, resume, and deactivate.";
+        readonly id: "Stable lowercase fleet id used by sync, get, and deactivate.";
         readonly source: "Customer DB table, unique row key, and optional equality filters that select candidate rows.";
         readonly member: "Ordinary monitor tool, stable key template, and payload evaluated for each selected source row.";
         readonly selection: "Deterministic ranking and an active-member limit between 1 and 1,000.";

package/dist/index.js

@@ -832,7 +832,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.72",
+  version: "0.3.74",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -10629,7 +10629,7 @@ var MONITOR_FLEET_REMOVAL_GRACE_MS = 7 * 24 * 60 * 6e4;
 var MONITOR_FLEET_DOCUMENTATION = {
   summary: "A Monitor Fleet keeps one bounded, sticky set of ordinary monitors aligned with Customer DB rows.",
   authoredFields: {
-    id: "Stable lowercase fleet id used by sync, pause, resume, and deactivate.",
+    id: "Stable lowercase fleet id used by sync, get, and deactivate.",
     source: "Customer DB table, unique row key, and optional equality filters that select candidate rows.",
     member: "Ordinary monitor tool, stable key template, and payload evaluated for each selected source row.",
     selection: "Deterministic ranking and an active-member limit between 1 and 1,000."

package/dist/index.mjs

@@ -744,7 +744,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.72",
+  version: "0.3.74",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -10541,7 +10541,7 @@ var MONITOR_FLEET_REMOVAL_GRACE_MS = 7 * 24 * 60 * 6e4;
 var MONITOR_FLEET_DOCUMENTATION = {
   summary: "A Monitor Fleet keeps one bounded, sticky set of ordinary monitors aligned with Customer DB rows.",
   authoredFields: {
-    id: "Stable lowercase fleet id used by sync, pause, resume, and deactivate.",
+    id: "Stable lowercase fleet id used by sync, get, and deactivate.",
     source: "Customer DB table, unique row key, and optional equality filters that select candidate rows.",
     member: "Ordinary monitor tool, stable key template, and payload evaluated for each selected source row.",
     selection: "Deterministic ranking and an active-member limit between 1 and 1,000."

package/dist/install-integrity.json

@@ -106,12 +106,14 @@
     "dist/bundling-sources/shared_libs/play-runtime/output-size-limits.ts",
     "dist/bundling-sources/shared_libs/play-runtime/pacing.ts",
     "dist/bundling-sources/shared_libs/play-runtime/persistence-latch.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/play-artifact-runtime-contract.ts",
     "dist/bundling-sources/shared_libs/play-runtime/play-call-execution.ts",
     "dist/bundling-sources/shared_libs/play-runtime/play-input.ts",
     "dist/bundling-sources/shared_libs/play-runtime/play-latency-trace.ts",
     "dist/bundling-sources/shared_libs/play-runtime/play-node-scope.ts",
     "dist/bundling-sources/shared_libs/play-runtime/play-run-recovery-policy.ts",
     "dist/bundling-sources/shared_libs/play-runtime/play-runtime-batching-registry.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/play-runtime-semantics.ts",
     "dist/bundling-sources/shared_libs/play-runtime/postgres-json.ts",
     "dist/bundling-sources/shared_libs/play-runtime/profiles.ts",
     "dist/bundling-sources/shared_libs/play-runtime/projection.ts",

package/package.json

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