agent-embassy 1.4.0 → 1.5.0

package/dist/src/gateway/store.d.ts

@@ -1,20 +1,12 @@
 import { type CompatibilityAttestation, type CompatibilitySurface } from "./compatibility.js";
 import type { GatewayConfig } from "./config.js";
-import { type ProgressWatchMachine, type ProgressWatchOutcome } from "./progress-watch-machine.js";
 import { type DeliveryState, type EnqueueMessageInput, type EnqueueMessageResult, type EnqueueNativeIngressInput, type EnqueueNativeReplyInput, type GatewayPrivateRouteInspection, type GatewayPublicSnapshot, type GatewayStoreDependencies, type InFlightMessageProgressState, type ObserveConnectorInput, type ObserveRouteInput, type PrivateEndpointIdentity, type PrivateRouteBinding, type ReanchorCodexRoutesInput, type ReanchorCodexRoutesResult, type RebindStaleRouteInput, type RegisterRouteInput, type RequeueInFlightMessageResult, type RemoveStaleCodexOrphanInput, type RemoveStaleCodexOrphanResult, type SettleMessageInput, type SettleMessageResult, type StaleCodexOrphanRemovalAuthority, type StaleCodexOrphanRemovalCommitProofInput, type TerminalMessageSettlement, type TransientQueuedMessage } from "./types.js";
 export declare const GATEWAY_MAX_STATE_FILE_BYTES: number;
-export type ProgressWatchAction = Readonly<{
-    type: "send_nudge";
+type ProgressWatchNudge = Readonly<{
     conversationId: string;
     ownerAlias: string;
     workerAlias: string;
     nudgeNumber: 1 | 2;
-}> | Readonly<{
-    type: "settled";
-    conversationId: string;
-    ownerAlias: string;
-    workerAlias: string;
-    outcome: ProgressWatchOutcome;
 }>;
 export type SettleQueuedMessageInput = {
     messageId: string;
@@ -159,7 +151,7 @@ export declare class GatewayStore {
      */
     removeStaleCodexOrphan(input: RemoveStaleCodexOrphanInput): Promise<RemoveStaleCodexOrphanResult>;
     disableRoute(alias: string, ownerLease: string, inFlightSettlements?: readonly RouteInFlightSettlementInput[]): Promise<TerminalMessageSettlement[]>;
-    unregisterRoute(alias: string, ownerLease: string, inFlightSettlements?: readonly RouteInFlightSettlementInput[]): Promise<TerminalMessageSettlement[]>;
+    unregisterRoute(alias: string, ownerLease: string, inFlightSettlements?: readonly RouteInFlightSettlementInput[], progressWatchSettlementActor?: "gateway" | "operator"): Promise<TerminalMessageSettlement[]>;
     /**
      * Move one owned route to its provider's latest live display name without
      * changing the logical provider route binding. Historical normalized events
@@ -233,26 +225,29 @@ export declare class GatewayStore {
     }>;
     /** Bounded metadata-only graph inventory for controller inference. */
     inspectPairs(): Promise<GatewayPairInput[]>;
-    inspectProgressWatches(): Promise<ProgressWatchMachine[]>;
-    /** Bind one restarted route-capability watch to its first exact owner send. */
-    bindProgressWatchConversation(input: Readonly<{
+    /** Resolve only an exact live watch; recovery may substitute its suffix. */
+    resolveProgressWatchDispatch(input: Readonly<{
+        sourceAlias: string;
+        targetAlias: string;
+    }> & (Readonly<{
         conversationId: string;
-        ownerAlias: string;
-        workerAlias: string;
-    }>): Promise<boolean>;
+        recoveredConversationIdSuffix?: never;
+    }> | Readonly<{
+        conversationId?: never;
+        recoveredConversationIdSuffix: string;
+    }>)): Promise<Readonly<{
+        conversationId?: string;
+        markerActive: boolean;
+    }>>;
     inspectCompatibilityAttestation(surface: CompatibilitySurface, version: string): Promise<CompatibilityAttestation | undefined>;
     inspectCompatibilityAttestations(): Promise<CompatibilityAttestation[]>;
     recordCompatibilityAttestation(attestation: CompatibilityAttestation): Promise<void>;
     touchProgressWatchesForAlias(alias: string): Promise<number>;
-    settleProgressWatch(input: Readonly<{
-        conversationId: string;
-        outcome: ProgressWatchOutcome;
-        ownerAlias?: string;
-    }>): Promise<boolean>;
+    endProgressWatch(conversationId: string): Promise<boolean>;
     /** Advance every due watch once under one durable store mutation. */
-    advanceDueProgressWatches(): Promise<ProgressWatchAction[]>;
+    advanceDueProgressWatches(): Promise<ProgressWatchNudge[]>;
     nextProgressWatchActionAt(): Promise<string | undefined>;
-    deferProgressWatchNudge(conversationId: string, retryDelayMs?: number): Promise<boolean>;
+    deferProgressWatchNudge(conversationId: string, nudgeNumber: 1 | 2): Promise<boolean>;
     hasPair(input: GatewayPairInput): Promise<boolean>;
     inspectAffectedPairInFlightMessages(input: GatewayPairInput): Promise<AffectedInFlightMessageInspection[]>;
     /**
@@ -280,7 +275,9 @@ export declare class GatewayStore {
      * capability; the store retains only bounded public-alias metadata.
      */
     enqueueNativeReply(input: EnqueueNativeReplyInput): Promise<EnqueueMessageResult>;
-    dequeueMessage(targetAlias?: string, mode?: "any" | "steer_only"): Promise<TransientQueuedMessage | undefined>;
+    dequeueMessage(targetAlias?: string, mode?: "any" | "steer_only"): Promise<(TransientQueuedMessage & {
+        queuedAhead?: number;
+    }) | undefined>;
     /** Controller-private shutdown inventory; full IDs never cross control output. */
     inspectQueuedMessageIds(): Promise<string[]>;
     /**
@@ -336,14 +333,12 @@ export declare class GatewayStore {
     private appendCodexOrphanRemovalEvent;
     /** Commit watch activity only after every message-admission check succeeds. */
     private applyProgressWatchMessageActivity;
-    private progressWatchDueTransition;
+    private inspectProgressWatchDue;
     private commitProgressWatchNudge;
     private installProgressWatch;
-    private requireProgressWatchJournalCapacity;
-    private appendProgressWatchEvent;
+    private appendProgressWatchEvents;
     private settleProgressWatchesForAliases;
     private settleProgressWatchesForPair;
-    private bindRouteProgressWatchConversation;
     private finishMetadata;
     private validateAffectedInFlightSettlements;
     private validateAffectedPairInFlightSettlements;