@scotthuang/agent-knock-knock 0.12.12 → 0.12.14

package/dist/src/callback-outbox-service.d.ts

@@ -1,7 +1,9 @@
 import { type AgentMessage, type Actor, type Conversation } from "./protocol.js";
 import type { TerminalCompletionEvidence, TerminalControlRef } from "./terminal-agent-adapter.js";
 import type { CallbackDeliveryOptions, CallbackDeliveryOutcome, CallbackRetryDisposition, DeliverCallbackInput } from "./callback-outbox-policy.js";
+import { type CallbackOutboxLane } from "./callback-outbox-settlement.js";
 import type { TranscriptEvent } from "./transcript.js";
+import { type CallbackEnvelopeV1, type CallbackRouteV1 } from "./callback-transport.js";
 export interface CallbackPreparationOptions extends CallbackDeliveryOptions {
     statePath: string;
     messageJson?: string;
@@ -16,6 +18,8 @@ export interface CallbackPreparationOptions extends CallbackDeliveryOptions {
     recoverMissingOutbox?: boolean;
     recoverTerminalCompletion?: boolean;
     retryPending?: boolean;
+    /** Internal durable lane; ordinary callbacks use the lifecycle lane. */
+    callbackOutboxLane?: CallbackOutboxLane;
 }
 export interface PrepareCallbackOutboxInput {
     options: CallbackPreparationOptions;
@@ -35,6 +39,9 @@ export interface PreparedCallbackDelivery extends PreparedCallbackBase {
     logPath: string;
     deliveryAttempt: number;
     deliveryAttemptId: string;
+    callbackOutboxLane: CallbackOutboxLane;
+    callbackRoute?: CallbackRouteV1;
+    callbackEnvelope?: CallbackEnvelopeV1;
 }
 export type PreparedCallback = PreparedCallbackWithoutDelivery | PreparedCallbackDelivery;
 export interface CallbackExecutionResult {
@@ -48,10 +55,12 @@ export interface CallbackDeliveryReconciliationInput {
     statePath: string;
     logPath: string;
     delayMs?: unknown;
+    callbackOutboxLane?: CallbackOutboxLane;
 }
 export interface CallbackRetryMonitorInput {
     statePath: string;
     initialDelayMs?: unknown;
+    callbackOutboxLane?: CallbackOutboxLane;
 }
 export interface RetryCallbackInput {
     options: CallbackPreparationOptions;
@@ -89,6 +98,13 @@ export interface ApprovalNotificationPreparationInput {
     metadata: Record<string, unknown>;
     recoverMissingOutbox?: boolean;
 }
+export interface StallNotificationPreparationInput {
+    options: CallbackPreparationOptions;
+    statePath: string;
+    logPath: string;
+    conversation: Conversation;
+    message: AgentMessage;
+}
 export interface CallbackOutboxServicePorts {
     state: {
         load(statePath: string): Conversation;
@@ -98,6 +114,7 @@ export interface CallbackOutboxServicePorts {
         appendMessage(logPath: string, message: AgentMessage): void;
         assertWriterCompatible(storeDir: string): void;
         withTransaction<Result>(statePath: string, operation: () => Result): Result;
+        withWriter<Result>(storeDir: string, operation: () => Result): Result;
         storeDirForStatePath(statePath: string): string;
         logPathForStatePath(statePath: string): string;
     };
@@ -119,6 +136,7 @@ export interface CallbackOutboxServicePorts {
         startMonitor(input: {
             statePath: string;
             delayMs: number;
+            callbackOutboxLane?: CallbackOutboxLane;
         }): {
             pid?: number | null;
         };
@@ -148,7 +166,7 @@ export declare function resolveCallbackGatewayRoute(...candidates: CallbackGatew
     gatewayUrl: string | undefined;
     token: string;
 } | {
-    gatewayUrl: undefined;
+    gatewayUrl: string | undefined;
     token: undefined;
 };
 export declare function createCallbackOutboxService(ports: CallbackOutboxServicePorts): {
@@ -222,6 +240,15 @@ export declare function createCallbackOutboxService(ports: CallbackOutboxService
         callbackMessage: AgentMessage;
         prepared: PreparedCallback;
     };
+    prepareStallNotification: (input: StallNotificationPreparationInput) => {
+        prepared?: undefined;
+        callbackMessage: AgentMessage;
+        delivered: false;
+    } | {
+        delivered?: undefined;
+        callbackMessage: AgentMessage;
+        prepared: PreparedCallback;
+    };
     prepareTerminalCompletion: (input: TerminalCompletionPreparationInput) => {
         claimed: true;
         conversation: Conversation;