deepline 0.3.71 → 0.3.73

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/authoring-contract.ts

@@ -456,9 +456,7 @@ export type PlayAuthoringCronInput<TInput> = TInput extends readonly unknown[]
     : never;
 
 /** The one public type for options accepted by definePlay. */
-export type PlayAuthoringBindings<
-  TInput = Record<string, unknown>,
-> = {
+export type PlayAuthoringBindings<TInput = Record<string, unknown>> = {
   description?: string;
   compatibility?: {
     toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
@@ -1239,7 +1237,14 @@ export interface PlayAuthoringRuntimeContext {
     options: PlayAuthoringCallOptions,
   ): Promise<TOutput>;
 
-  log(message: string): void;
+  /**
+   * Write a customer-safe line to the durable Run Log Stream. Omitting level
+   * preserves the historical info-level behavior.
+   */
+  log(
+    message: string,
+    options?: { level?: 'debug' | 'info' | 'warn' | 'error' },
+  ): void;
   sleep(ms: number): Promise<void>;
 }
 
@@ -2783,7 +2788,7 @@ export const PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "  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 };',
   `  runPlay<TOutput = unknown>(key: string, playRef: ${cloudReferenceType('ctx.runPlay.playRef')}, input: ${cloudReferenceType('ctx.runPlay.input')}, options: PlayCallOptions): Promise<TOutput>;`,
-  '  log(message: string): void;',
+  "  log(message: string, options?: { level?: 'debug' | 'info' | 'warn' | 'error' }): void;",
   `  sleep(ms: ${cloudReferenceType('ctx.sleep.ms')}): Promise<void>;`,
   '}',
   "export type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = { id: string; description?: string; input: PlayInputContract<TInput>; run: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>; bindings?: PlayBindings<TInput>; billing?: PlayBindings<TInput>['billing']; runtime?: PlayBindings<TInput>['runtime']; compatibility?: PlayBindings<TInput>['compatibility'] };",

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,