agent-embassy 3.1.0 → 4.1.0

package/dist/src/gateway/broker.js

@@ -0,0 +1,186 @@
+import { randomBytes, randomUUID } from "node:crypto";
+import { BridgeError } from "../errors.js";
+import { Ledger } from "./ledger.js";
+const publicEndpoint = ({ id, alias, provider, host }) => ({ id, alias, provider, host });
+const admissionRefusals = new Set(["INVALID_PEER_HANDOFF", "ROUTE_UNREGISTERED", "INVALID_MESSAGE_BODY",
+    "MESSAGE_EXPIRED", "QUEUE_FULL", "RATE_LIMITED"]);
+class PreEnqueueRefusal extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+    }
+}
+/** Application commands over the directory and the single delivery ledger. */
+export class MessagingBroker {
+    options;
+    timer;
+    stopped = false;
+    started = false;
+    pumping;
+    requested = false;
+    fault;
+    now;
+    constructor(options) {
+        this.options = options;
+        this.now = options.now ?? Date.now;
+    }
+    change(operation) {
+        return this.options.store.transact((state) => operation(new Ledger(state, this.options.host, this.options.limits, this.now())));
+    }
+    async start() {
+        await this.change((ledger) => ledger.restart());
+        this.started = true;
+        this.kick();
+    }
+    async register(caller, alias, succeeds) {
+        if (caller.kind !== "codex")
+            throw new BridgeError("ROUTE_BINDING_MISMATCH", "Codex registration requires its inherited task identity.");
+        const endpoint = await this.options.directory.registerCodex(caller.handle, alias, succeeds);
+        return publicEndpoint(endpoint);
+    }
+    async send(caller, address, body) {
+        if (this.stopped)
+            throw new BridgeError("GATEWAY_SHUTDOWN", "The gateway is stopping.");
+        const source = await this.options.directory.caller(caller);
+        const target = "to" in address ? await this.options.directory.named(address.to)
+            : await this.options.directory.exact(new Ledger(await this.options.store.snapshot(), this.options.host, this.options.limits, this.now()).replyTarget(address.conversation, source));
+        if (!target)
+            throw new BridgeError("ROUTE_UNREGISTERED", "The exact destination is unavailable.");
+        const deadline = this.now() + this.options.limits.deadlineMs;
+        const admitted = await this.change((ledger) => ledger.admit({
+            id: `msg_${randomUUID()}`, token: `dlv_${randomBytes(18).toString("base64url")}`,
+            reply: `conv_${randomBytes(24).toString("base64url")}`, source, target, body,
+            deadline,
+            steer: this.options.steeringEnabled !== false && source.provider === "claude" && target.provider === "codex" && body.startsWith("STEER:"),
+        }));
+        this.kick();
+        return { accepted: true, conversationId: admitted.delivery.reply, deliveryToken: admitted.delivery.token };
+    }
+    async retire(selector) {
+        if (typeof selector === "string" && !selector.endsWith(`@${this.options.host}`))
+            throw new BridgeError("FEDERATED_ROUTE_READ_ONLY", "Retire a remote route on its owning host.");
+        // Retirement acts on owned state, not discovery: an exited session must remain removable.
+        const counts = await this.change((ledger) => {
+            const endpoint = typeof selector === "string" ? ledger.resolve(selector)
+                : ledger.state.endpoints.find((row) => row.id === selector.endpoint);
+            if (!endpoint)
+                throw new BridgeError("ROUTE_UNREGISTERED", "The local route is absent.");
+            return ledger.retire(endpoint);
+        });
+        this.kick();
+        return counts;
+    }
+    async handoff(peerHost, input) {
+        if (this.stopped)
+            throw new BridgeError("GATEWAY_SHUTDOWN", "The gateway is stopping.");
+        if (!this.options.nodes?.includes(peerHost) || input.target.host !== this.options.host ||
+            input.messages.some((m) => m.source.host !== peerHost))
+            return { accepted: false, code: "INVALID_PEER_HANDOFF" };
+        try {
+            await this.change((ledger) => {
+                try {
+                    for (const message of input.messages)
+                        ledger.admit({
+                            id: message.id, reply: message.reply, token: `dlv_${randomBytes(18).toString("base64url")}`,
+                            source: message.source, sourceAlias: message.source.alias, target: input.target,
+                            body: message.body, deadline: message.deadline, steer: message.steer && this.options.steeringEnabled !== false,
+                        });
+                }
+                catch (error) {
+                    // The sentinel is created ONLY inside the transition, before any persist.
+                    // A later I/O throw carrying the same text is not a proven refusal.
+                    if (error instanceof BridgeError && admissionRefusals.has(error.code))
+                        throw new PreEnqueueRefusal(error.code);
+                    throw error;
+                }
+            });
+        }
+        catch (error) {
+            if (error instanceof PreEnqueueRefusal)
+                return { accepted: false, code: error.code };
+            throw error;
+        }
+        this.kick();
+        return { accepted: true };
+    }
+    async delivery(token) {
+        await this.change((ledger) => ledger.expire());
+        const d = (await this.options.store.snapshot()).deliveries.find((d) => d.token === token);
+        if (!d)
+            return { found: false };
+        return { found: true, state: d.state.phase === "terminal" ? d.state.outcome : d.state.phase,
+            terminal: d.state.phase === "terminal", deadlineAt: new Date(d.deadline).toISOString(),
+            ...(d.state.phase === "terminal" ? { safeErrorCode: d.state.code } : { pendingForMs: Math.max(0, this.now() - d.admittedAt) }) };
+    }
+    async refresh() {
+        const [endpoints] = await Promise.all([
+            this.options.directory.refresh(), this.options.federation?.catalog(),
+        ]);
+        this.kick();
+        return { routes: endpoints.map(publicEndpoint) };
+    }
+    async status() {
+        await this.change((ledger) => ledger.expire());
+        const state = await this.options.store.snapshot();
+        const alias = (ref) => state.endpoints.find((e) => e.id === ref.id && e.host === ref.host)?.alias;
+        return {
+            health: this.fault ? "degraded" : "healthy", ...(this.fault ? { safeErrorCode: this.fault } : {}),
+            revision: state.commit.sequence,
+            ...(this.options.federation ? { federation: this.options.federation.snapshot() } : {}),
+            routes: state.endpoints.map((e) => ({ ...publicEndpoint(e),
+                ...(this.options.coordinator.observation(e) === undefined ? {} : { lastOperation: this.options.coordinator.observation(e) }),
+                queueDepth: state.deliveries.filter((d) => d.target.id === e.id && d.target.host === e.host && d.state.phase !== "terminal").length })),
+            messages: state.deliveries.map((d) => ({ source: alias(d.source) ?? d.sourceAlias, target: alias(d.target),
+                state: d.state.phase === "terminal" ? d.state.outcome : d.state.phase,
+                ageMs: Math.max(0, this.now() - d.admittedAt),
+                ...(d.state.phase === "terminal" ? { safeErrorCode: d.state.code } : {}) })),
+            retirements: state.retirements.map(({ alias, at }) => ({ alias, at: new Date(at).toISOString() })),
+        };
+    }
+    kick() {
+        if (this.stopped)
+            return;
+        this.requested = true;
+        if (this.pumping)
+            return;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        this.pumping = this.pump().catch((error) => {
+            this.fault = error instanceof BridgeError ? error.code : "DISPATCH_OUTCOME_AMBIGUOUS";
+        }).finally(() => {
+            this.pumping = undefined;
+            if (this.requested)
+                this.kick();
+        });
+    }
+    async pump() {
+        this.requested = false;
+        const state = await this.options.store.snapshot();
+        const targets = new Map();
+        for (const d of state.deliveries) {
+            if (d.state.phase === "queued")
+                targets.set(JSON.stringify([d.target, d.steer]), d);
+        }
+        for (const d of targets.values()) {
+            // Do not await an agent's turn: another target or a STEER must remain dispatchable.
+            void this.options.coordinator.wake(d.target, d.steer).catch((error) => {
+                this.fault = error instanceof BridgeError ? error.code : "DISPATCH_OUTCOME_AMBIGUOUS";
+            });
+        }
+        if (!this.stopped && state.deliveries.some((d) => d.state.phase !== "terminal")) {
+            this.timer = setTimeout(() => { this.timer = undefined; this.kick(); }, 500);
+            this.timer.unref();
+        }
+    }
+    async close() {
+        this.stopped = true;
+        if (this.timer)
+            clearTimeout(this.timer);
+        await this.pumping;
+        await this.options.coordinator.close(this.started);
+    }
+}
+//# sourceMappingURL=broker.js.map

package/dist/src/gateway/broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.js","sourceRoot":"","sources":["../../../src/gateway/broker.ts"],"names":[],"mappings":"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"}

package/dist/src/gateway/claude-peer.d.ts

@@ -1,5 +1,4 @@
 import { type Socket } from "node:net";
-import type { GatewayDeliveryNoticeMode } from "./config.js";
 export declare const CLAUDE_PEER_COMPATIBILITY: Readonly<{
     peerProtocol: 1;
 }>;
@@ -23,31 +22,6 @@ export type ClaudePeerDiscovery = {
     entriesScanned: number;
     parseableRecords: number;
 };
-export type ClaudePeerDeliveryDiagnostic = {
-    code: string;
-};
-export declare const claudePeerInboundStallReasons: readonly ["ROUTE_BUSY", "ROUTE_UNAVAILABLE", "AWAITING_EXTERNAL_APPROVAL"];
-export type ClaudePeerInboundStallReason = (typeof claudePeerInboundStallReasons)[number];
-export type ClaudePeerInboundProgress = {
-    kind: "stall";
-    reason: ClaudePeerInboundStallReason;
-    queuedForMs: number;
-};
-export type ClaudePeerAcknowledgmentResult = {
-    transportStatus: "transport_written" | "suppressed";
-};
-export type ClaudePeerInboundMessage = {
-    inboundId: string;
-    content: string;
-    sourceTargetId?: string;
-    sourceAlias?: string;
-    receiptHandle?: string;
-    replySupported: boolean;
-    trust: "untrusted_same_uid_peer" | "untrusted_anonymous_local_peer";
-};
-export type ClaudePeerProtocolNotice = {
-    code: "FRAME_TOO_LARGE" | "INVALID_UTF8" | "INVALID_FRAME" | "UNSUPPORTED_FRAME" | "UNREGISTERED_REPLY_ADDRESS" | "RECEIPT_LIMIT" | "CONNECTION_LIMIT" | "CONNECTION_TIMEOUT" | "CALLBACK_ERROR";
-};
 export type ClaudeProcessIdentity = {
     uid: number;
     generation: string;
@@ -57,15 +31,10 @@ export type ClaudePeerConnect = (socketPath: string) => Socket;
 export type ClaudePeerAdapterOptions = {
     sessionsDir: string;
     socketDir: string;
-    deliveryNotices?: GatewayDeliveryNoticeMode;
     maxRegistryEntries?: number;
     maxRegistryBytes?: number;
     maxFrameBytes?: number;
     connectTimeoutMs?: number;
-    maxPendingReceipts?: number;
-    maxConnections?: number;
-    connectionIdleMs?: number;
-    maxFramesPerConnection?: number;
 };
 export type ClaudePeerAdapterTestOverrides = {
     expectedUid?: number;
@@ -73,20 +42,8 @@ export type ClaudePeerAdapterTestOverrides = {
     connect?: ClaudePeerConnect;
     now?: () => number;
     createId?: () => string;
-    createArtifactToken?: () => string;
-    registryRename?: (source: string, destination: string) => Promise<void>;
-    registryOperationHook?: (event: {
-        operation: "advertise" | "status" | "unadvertise";
-        phase: "entered" | "exited";
-        generation: string;
-    }) => void | Promise<void>;
     userHome?: string;
     tempRoots?: readonly string[];
-    postBindHook?: (socketPath: string) => void | Promise<void>;
-};
-export type ClaudePeerListenerOptions = {
-    onMessage: (message: ClaudePeerInboundMessage) => void | Promise<void>;
-    onProtocolNotice?: (notice: ClaudePeerProtocolNotice) => void | Promise<void>;
 };
 export type ClaudePeerPreparedSendResult = {
     messageId: string;
@@ -96,38 +53,12 @@ export type ClaudePeerPreparedSend = Readonly<{
     messageId: string;
     frameBytes: number;
     sha256: string;
-    perform: () => Promise<ClaudePeerPreparedSendResult>;
+    perform: (authorize: () => Promise<boolean>) => Promise<ClaudePeerPreparedSendResult>;
     cancel: () => void;
 }>;
-type ParsedRegistryRecord = {
-    pid: number;
-    sessionId: string;
-    cwd: string;
-    kind: ClaudePeerKind;
-    messagingSocketPath: string;
-    name: string;
-    status: ClaudePeerStatus;
-    embassyAdvertisement: boolean;
-};
-type TargetBinding = Readonly<{
-    targetId: string;
-    alias: string;
-    record: ParsedRegistryRecord;
-}>;
-type AdapterLimits = {
-    maxRegistryEntries: number;
-    maxRegistryBytes: number;
-    maxFrameBytes: number;
-    connectTimeoutMs: number;
-    maxPendingReceipts: number;
-    maxConnections: number;
-    connectionIdleMs: number;
-    maxFramesPerConnection: number;
-};
 export declare function encodeClaudePeerUserFrame(input: {
     messageId: string;
     content: string;
-    from?: string;
     maxFrameBytes?: number;
 }): Buffer;
 export declare class ClaudePeerAdapter {
@@ -145,62 +76,8 @@ export declare class ClaudePeerAdapter {
      * every later delivery resolves the UUID to fresh transport coordinates.
      */
     resolveReplyAddress(address: string): Promise<ClaudePeerDescriptor>;
-    listen(options: ClaudePeerListenerOptions): Promise<ClaudePeerListener>;
     prepareSend(targetId: string, content: string, options: Readonly<{
         deadlineAt: number;
-        /** Owned reply address only; no outbound receipt is tracked. */
-        replyListener?: ClaudePeerListener;
     }>): Promise<ClaudePeerPreparedSend>;
     close(): Promise<void>;
 }
-type ListenerCreateOptions = {
-    sessionsDir: string;
-    socketDir: string;
-    expectedUid: number;
-    limits: AdapterLimits;
-    createId: () => string;
-    connect: ClaudePeerConnect;
-    deliveryNotices: GatewayDeliveryNoticeMode;
-    resolveReplyAddress: (address: string) => Promise<TargetBinding>;
-    resolveSessionBinding: (sessionId: string) => Promise<TargetBinding>;
-    options: ClaudePeerListenerOptions;
-    generation: string;
-    registryRename: (source: string, destination: string) => Promise<void>;
-    registryOperationHook?: ClaudePeerAdapterTestOverrides["registryOperationHook"];
-    runRegistryMutation: <T>(operation: () => Promise<T>) => Promise<T>;
-    postBindHook: ClaudePeerAdapterTestOverrides["postBindHook"];
-    onClosed: () => void;
-};
-export declare class ClaudePeerListener {
-    #private;
-    readonly address: string;
-    readonly generation: string;
-    private constructor();
-    static create(options: ListenerCreateOptions): Promise<ClaudePeerListener>;
-    get closed(): boolean;
-    advertise(name: string, cwd: string): Promise<void>;
-    updateAdvertisedStatus(status: ClaudePeerStatus): Promise<void>;
-    unadvertise(name?: string): Promise<void>;
-    acknowledge(receiptHandle: string, status: "held" | "delivered" | "denied" | "expired", diagnostic?: ClaudePeerDeliveryDiagnostic): Promise<ClaudePeerAcknowledgmentResult>;
-    /**
-     * Writes one nonterminal gateway progress frame without synthesizing a
-     * native peer_message_status transition. The receipt remains available for
-     * its later exact terminal acknowledgement or explicit release.
-     */
-    notifyInboundProgress(receiptHandle: string, progress: ClaudePeerInboundProgress): Promise<ClaudePeerAcknowledgmentResult>;
-    /**
-     * Releases a listener-owned native receipt capability without writing to the
-     * peer. The service uses this after a terminal notification becomes
-     * definitively undeliverable so bounded receipt capacity cannot leak.
-     */
-    releaseInboundReceipt(receiptHandle: string): boolean;
-    /**
-     * Stop admitting new user-message frames while keeping the listener alive
-     * for terminal receipt writes. The promise joins every frame already
-     * admitted, so controller shutdown can drain service receipt work before
-     * closing the provider socket.
-     */
-    quiesceInbound(): Promise<void>;
-    close(): Promise<void>;
-}
-export {};