agent-embassy 3.1.0 → 4.1.0

package/dist/src/gateway/native-destinations.js

@@ -0,0 +1,272 @@
+import { BridgeError } from "../errors.js";
+const CLAUDE_CLEAN_RETRY_CODES = new Set([
+    "CLAUDE_PEER_TARGET_UNKNOWN",
+    "CLAUDE_PEER_TARGET_CHANGED",
+    "CLAUDE_PEER_WORKSPACE_UNATTESTED",
+]);
+const CODEX_CLEAN_RETRY_CODES = new Set([
+    "THREAD_NOT_OBSERVED",
+    "ROUTE_BUSY",
+    "APPROVAL_REQUIRED",
+    "MANAGED_CODEX_UNAVAILABLE",
+    "LOCAL_APP_SERVER_NOT_RUNNING",
+    "ENDPOINT_GENERATION_CHANGED",
+    "SPAWN_FAILED",
+    "SPAWN_TIMEOUT",
+    "TRANSPORT_CONNECT_FAILED",
+    "REQUEST_TIMEOUT",
+]);
+function systemCode(error) {
+    return typeof error === "object" && error !== null && "code" in error &&
+        typeof error.code === "string" ? error.code : undefined;
+}
+function claudePrewrite(error) {
+    if (error instanceof BridgeError && error.code === "CLAUDE_PEER_MESSAGE_EXPIRED") {
+        return { outcome: "expired", code: "MESSAGE_EXPIRED", unwritten: true };
+    }
+    if (error instanceof BridgeError && CLAUDE_CLEAN_RETRY_CODES.has(error.code)) {
+        return { outcome: "deferred", code: "ROUTE_BUSY" };
+    }
+    const code = systemCode(error);
+    return {
+        outcome: "failed",
+        code: error instanceof BridgeError ? error.code
+            : code === "ENOENT" ? "CLAUDE_DISPATCH_PREWRITE_PATH_MISSING"
+                : code === "EACCES" || code === "EPERM" ? "CLAUDE_DISPATCH_PREWRITE_ACCESS_DENIED"
+                    : code === "ETIMEDOUT" ? "CLAUDE_DISPATCH_PREWRITE_TIMEOUT"
+                        : "CLAUDE_DISPATCH_PREWRITE_FAILED",
+    };
+}
+function claudePostAuthorization(error) {
+    // perform() re-attests the prepared generation before it invokes authorization.
+    if (error instanceof BridgeError && error.code === "CLAUDE_PEER_TARGET_CHANGED") {
+        return { outcome: "deferred", code: "ROUTE_BUSY" };
+    }
+    if (error instanceof BridgeError && error.code === "WRITE_AUTHORIZATION_DENIED") {
+        return { outcome: "deferred", code: error.code };
+    }
+    if (error instanceof BridgeError && error.recoverable) {
+        if (error.code === "CLAUDE_PEER_MESSAGE_EXPIRED")
+            return { outcome: "expired", code: "MESSAGE_EXPIRED", unwritten: true };
+        return {
+            outcome: "failed",
+            code: error.code === "CLAUDE_PEER_MESSAGE_EXPIRED" ? "MESSAGE_EXPIRED" : error.code,
+        };
+    }
+    return {
+        outcome: "ambiguous",
+        code: error instanceof BridgeError && /^[A-Z][A-Z0-9_]{0,95}$/.test(error.code)
+            ? error.code : "CLAUDE_DISPATCH_OUTCOME_AMBIGUOUS",
+    };
+}
+function localClaudeName(target, host) {
+    if (target.provider !== "claude" || target.host !== host)
+        return undefined;
+    const suffix = `@${host}`;
+    if (!target.alias.endsWith(suffix))
+        return undefined;
+    const name = target.alias.slice(0, -suffix.length);
+    return /^[a-z][a-z0-9_-]{0,31}$/.test(name) ? name : undefined;
+}
+export class ClaudeDestination {
+    options;
+    inFlight = new Set();
+    closing = false;
+    constructor(options) {
+        this.options = options;
+    }
+    async deliver(input) {
+        if (this.closing)
+            return { outcome: "failed", code: "CLAUDE_ROUTE_UNAVAILABLE" };
+        const delivery = this.deliverOnce(input);
+        this.inFlight.add(delivery);
+        try {
+            return await delivery;
+        }
+        finally {
+            this.inFlight.delete(delivery);
+        }
+    }
+    async deliverOnce(input) {
+        const name = localClaudeName(input.target, this.options.host);
+        if (name === undefined)
+            return { outcome: "failed", code: "CLAUDE_ROUTE_UNAVAILABLE" };
+        let discovery;
+        let prepared;
+        try {
+            discovery = await this.options.peer.discover();
+            const exact = discovery.peers.find((candidate) => candidate.targetId === input.target.handle && candidate.alias === name &&
+                (candidate.kind === "interactive" || candidate.kind === "bg"));
+            if (exact === undefined) {
+                throw new BridgeError("CLAUDE_PEER_TARGET_UNKNOWN", "The exact Claude peer target is no longer discoverable.", true);
+            }
+            await this.options.peer.assertTargetWorkspaceDisjoint(input.target.handle, this.options.stateRoot);
+            prepared = await this.options.peer.prepareSend(input.target.handle, input.text, {
+                deadlineAt: input.deadline,
+            });
+        }
+        catch (error) {
+            return claudePrewrite(error);
+        }
+        try {
+            // Final attestation, authorization, and the exact prepared write share
+            // one continuation; retirement during preparation cannot leak a write.
+            const operation = prepared.perform(async () => await input.authorize({
+                bytes: prepared.frameBytes,
+                sha256: prepared.sha256,
+            }));
+            await operation;
+            return { outcome: "delivered", code: "DELIVERED" };
+        }
+        catch (error) {
+            return claudePostAuthorization(error);
+        }
+    }
+    async close() {
+        if (this.closing)
+            return;
+        this.closing = true;
+        await this.options.peer.close();
+        await Promise.allSettled([...this.inFlight]);
+    }
+}
+function mapCodexClean(result) {
+    if (result.safeErrorCode === "MESSAGE_EXPIRED") {
+        return { outcome: "expired", code: "MESSAGE_EXPIRED", unwritten: true };
+    }
+    return CODEX_CLEAN_RETRY_CODES.has(result.safeErrorCode)
+        ? { outcome: "deferred", code: result.safeErrorCode }
+        : { outcome: "failed", code: result.safeErrorCode };
+}
+function mapCodexStart(result) {
+    if (result.phase === "clean")
+        return mapCodexClean(result);
+    if (result.phase === "armed")
+        return { outcome: "ambiguous", code: result.safeErrorCode };
+    if (result.phase === "accepted")
+        return { outcome: "unconfirmed", code: result.safeErrorCode };
+    if (result.outcome === "failed")
+        return { outcome: "failed", code: "CODEX_TURN_FAILED" };
+    if (result.outcome === "interrupted") {
+        return { outcome: "cancelled", code: "CODEX_TURN_INTERRUPTED" };
+    }
+    return { outcome: "delivered", code: "DELIVERED" };
+}
+function mapCodexSteer(result) {
+    if (result.phase === "clean")
+        return mapCodexClean(result);
+    if (result.phase === "armed")
+        return { outcome: "ambiguous", code: result.safeErrorCode };
+    return { outcome: "delivered", code: "DELIVERED" };
+}
+export class CodexDestination {
+    options;
+    active = new Map();
+    starting = new Map();
+    controllers = new Set();
+    inFlight = new Set();
+    closing = false;
+    constructor(options) {
+        this.options = options;
+    }
+    async deliver(input) {
+        if (this.closing || input.target.provider !== "codex" ||
+            input.target.host !== this.options.host) {
+            return { outcome: "failed", code: "CODEX_ROUTE_UNAVAILABLE" };
+        }
+        const delivery = input.steer ? this.deliverSteer(input) : this.deliverStart(input);
+        this.inFlight.add(delivery);
+        try {
+            return await delivery;
+        }
+        finally {
+            this.inFlight.delete(delivery);
+        }
+    }
+    async deliverSteer(input) {
+        const active = this.active.get(input.target.id);
+        if (active === undefined)
+            return await this.deliverStart(input);
+        if (active.target.host !== input.target.host ||
+            active.target.handle !== input.target.handle) {
+            return { outcome: "deferred", code: "ROUTE_BUSY" };
+        }
+        const result = await active.operation.steer({
+            attemptId: input.attempt,
+            deadlineAt: new Date(input.deadline).toISOString(),
+            text: input.text,
+            authorizeWrite: async (evidence) => await input.authorize({
+                bytes: evidence.frameBytes,
+                sha256: evidence.sha256,
+            }),
+        });
+        return mapCodexSteer(result);
+    }
+    async deliverStart(input) {
+        if (this.active.has(input.target.id) || this.starting.has(input.target.id)) {
+            return { outcome: "deferred", code: "ROUTE_BUSY" };
+        }
+        const starting = {
+            attempt: input.attempt,
+            target: { ...input.target },
+        };
+        this.starting.set(input.target.id, starting);
+        const controller = new AbortController();
+        this.controllers.add(controller);
+        let accepted;
+        try {
+            const result = await this.options.operation.execute({
+                attemptId: input.attempt,
+                authorizeWrite: async (evidence) => await input.authorize({
+                    bytes: evidence.frameBytes,
+                    sha256: evidence.sha256,
+                }),
+                deadlineAt: new Date(input.deadline).toISOString(),
+                kind: "start",
+                signal: controller.signal,
+                route: {
+                    alias: input.target.alias,
+                    hostId: input.target.host,
+                    registrationId: input.target.id,
+                    threadId: input.target.handle,
+                },
+                text: input.text,
+                onAccepted: async (operation) => {
+                    if (this.closing || operation.attemptId !== input.attempt ||
+                        this.active.has(input.target.id)) {
+                        throw new BridgeError("ACCEPTANCE_UNCONFIRMED", "The exact Codex attempt cannot acquire its active-turn slot.");
+                    }
+                    await input.accepted("unconfirmed");
+                    accepted = operation;
+                    this.active.set(input.target.id, {
+                        attempt: input.attempt,
+                        target: { ...input.target },
+                        operation,
+                    });
+                },
+            });
+            return mapCodexStart(result);
+        }
+        finally {
+            this.controllers.delete(controller);
+            if (this.starting.get(input.target.id) === starting) {
+                this.starting.delete(input.target.id);
+            }
+            if (accepted !== undefined && this.active.get(input.target.id)?.attempt === input.attempt) {
+                this.active.delete(input.target.id);
+            }
+        }
+    }
+    async close() {
+        if (this.closing)
+            return;
+        this.closing = true;
+        for (const controller of this.controllers)
+            controller.abort();
+        await Promise.allSettled([...this.inFlight]);
+        this.controllers.clear();
+        this.starting.clear();
+        this.active.clear();
+    }
+}
+//# sourceMappingURL=native-destinations.js.map

package/dist/src/gateway/native-destinations.js.map

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

package/dist/src/gateway/owned-state.d.ts

@@ -0,0 +1,57 @@
+export type OwnedStateCommit = Readonly<{
+    sequence: number;
+    id: string;
+}>;
+export type OwnedStateDocument = Readonly<{
+    schemaVersion: number;
+    commit: OwnedStateCommit;
+}>;
+export type OwnedStateCodec<T extends OwnedStateDocument> = Readonly<{
+    schemaVersion: number;
+    maximumBytes: number;
+    decode: (value: unknown) => T | undefined;
+    create: (input: Readonly<{
+        now: Date;
+        commit: OwnedStateCommit;
+    }>) => T;
+    assertBounds?: (value: T) => void;
+}>;
+export type OwnedStateDependencies = Readonly<{
+    assertWritable?: () => void;
+    now?: () => Date;
+    randomId?: () => string;
+    renameStateFile?: (source: string, target: string) => Promise<void>;
+    syncStateDirectory?: (directory: string) => Promise<void>;
+    afterStateFileRename?: () => void | Promise<void>;
+}>;
+/**
+ * One owned, bounded JSON document. The caller's host-wide instance lease is
+ * the process-exclusion boundary; this class deliberately creates no second
+ * PID lock. Domain transitions and restart settlement belong to the ledger.
+ */
+export declare class OwnedStateFile<T extends OwnedStateDocument> {
+    rootDir: string;
+    private readonly codec;
+    private readonly now;
+    private readonly randomId;
+    private readonly renameStateFile;
+    private readonly syncStateDirectory;
+    private readonly afterStateFileRename;
+    private readonly mutex;
+    private state;
+    private poisoned;
+    private readonly assertWritable;
+    constructor(stateDir: string, codec: OwnedStateCodec<T>, dependencies?: OwnedStateDependencies);
+    get stateFilePath(): string;
+    initialize(): Promise<void>;
+    snapshot(): Promise<T>;
+    transact<R>(operation: (draft: T, now: Date) => R): Promise<R>;
+    close(): Promise<void>;
+    private requireState;
+    private assertDocument;
+    private assertOwnedPrivate;
+    private prepareOwnedDirectory;
+    private readPrivateFile;
+    private loadStateFile;
+    private persist;
+}