agent-embassy 3.1.0 → 4.1.0

package/dist/src/gateway/runtime.js

@@ -0,0 +1,175 @@
+import { userInfo } from "node:os";
+import path from "node:path";
+import { BridgeError } from "../errors.js";
+import { LoopbackDestination } from "./broker-check.js";
+import { handleBrokerCommand } from "./broker-control.js";
+import { MessagingBroker } from "./broker.js";
+import { ClaudePeerAdapter } from "./claude-peer.js";
+import { attestClaudePeerRuntime } from "./claude-runtime.js";
+import { createStatelessCodexOperationTransport } from "./codex-stateless-transport.js";
+import { loadGatewayConfig, defaultGatewayStateDir } from "./config.js";
+import { Coordinator } from "./coordinator.js";
+import { EndpointDirectory } from "./endpoint-directory.js";
+import { ensureGatewayNodeInventoryFile, loadGatewayNodeInventory } from "./federation-nodes.js";
+import { Federation, isFederatedHandoff } from "./federation.js";
+import { acquireGatewayInstanceLease } from "./instance-lease.js";
+import { createLedgerCodec } from "./ledger-codec.js";
+import { serveLocalControl } from "./local-control.js";
+import { ClaudeDestination, CodexDestination } from "./native-destinations.js";
+import { OwnedStateFile } from "./owned-state.js";
+const leaseLost = () => new BridgeError("GATEWAY_INSTANCE_LEASE_LOST", "Embassy lost its host-wide gateway lease and shut down.", true);
+const cancelled = () => new BridgeError("GATEWAY_START_CANCELLED", "Gateway startup was cancelled before it became ready.", true);
+const codexEnvironment = (env) => Object.fromEntries(["HOME", "USER", "LOGNAME"].flatMap((key) => env[key] === undefined ? [] : [[key, env[key]]]));
+/** Assemble the schema-6 broker. Construction is inert: provider and SSH I/O starts
+ * only when an addressed operation reaches its destination. */
+export async function runCoreRuntime(options, dependencies = {}) {
+    const env = options.env ?? process.env;
+    const d = {
+        loginHome: dependencies.loginHome ?? (() => userInfo().homedir),
+        loadInventory: dependencies.loadInventory ?? loadGatewayNodeInventory,
+        ensureInventory: dependencies.ensureInventory ?? ensureGatewayNodeInventoryFile,
+        loadConfig: dependencies.loadConfig ?? loadGatewayConfig,
+        acquireLease: dependencies.acquireLease ?? acquireGatewayInstanceLease,
+        attestClaudeRuntime: dependencies.attestClaudeRuntime ?? attestClaudePeerRuntime,
+        createClaudePeer: dependencies.createClaudePeer ?? ((runtime, config) => new ClaudePeerAdapter({ ...runtime })),
+        createCodexOperation: dependencies.createCodexOperation ?? ((source) => createStatelessCodexOperationTransport({ local: { environment: codexEnvironment(source) } })),
+        createFederation: dependencies.createFederation ?? ((host, nodes) => new Federation({ host, nodes })),
+        serveControl: dependencies.serveControl ?? serveLocalControl,
+        add: dependencies.addSignalListener ?? ((signal, listener) => process.on(signal, listener)),
+        remove: dependencies.removeSignalListener ?? ((signal, listener) => process.off(signal, listener)),
+    };
+    const controller = new AbortController();
+    let ready = false;
+    const stop = () => { ready = false; controller.abort(); };
+    const stopped = new Promise((resolve) => controller.signal.addEventListener("abort", () => resolve(), { once: true }));
+    d.add("SIGINT", stop);
+    try {
+        d.add("SIGTERM", stop);
+    }
+    catch (error) {
+        d.remove("SIGINT", stop);
+        throw error;
+    }
+    options.signal?.addEventListener("abort", stop, { once: true });
+    if (options.signal?.aborted)
+        stop();
+    let lease, store;
+    let control, broker;
+    let claude, loopback;
+    let federation;
+    let primary;
+    try {
+        if (controller.signal.aborted)
+            throw cancelled();
+        let inventory = await d.loadInventory(path.resolve(defaultGatewayStateDir(env)));
+        if (controller.signal.aborted)
+            throw cancelled();
+        const config = d.loadConfig(env, inventory), ledgerLimits = config.limits;
+        const acquiring = d.acquireLease(d.loginHome()).then((value) => ({ kind: "lease", value }), (error) => ({ kind: "error", error }));
+        const acquired = await Promise.race([acquiring, stopped.then(() => ({ kind: "stopped" }))]);
+        if (acquired.kind === "stopped") {
+            void acquiring.then((late) => late.kind === "lease" ? late.value.close().catch(() => undefined) : undefined);
+            throw cancelled();
+        }
+        if (acquired.kind === "error")
+            throw acquired.error;
+        lease = acquired.value;
+        const assertLease = () => { if (lease.isLost())
+            throw leaseLost(); };
+        const assertStarting = () => { assertLease(); if (controller.signal.aborted)
+            throw cancelled(); };
+        const assertWrite = () => {
+            assertLease();
+            if (controller.signal.aborted)
+                throw new BridgeError("GATEWAY_SHUTDOWN", "The gateway is stopping.");
+        };
+        const awaitInertStartup = async (operation) => {
+            const outcome = await Promise.race([
+                operation.then((value) => ({ kind: "result", value }), (error) => ({ kind: "error", error })),
+                stopped.then(() => ({ kind: "stopped" })),
+                lease.lost.then(() => ({ kind: "lost" })),
+            ]);
+            if (outcome.kind === "result")
+                return outcome.value;
+            if (outcome.kind === "error")
+                throw outcome.error;
+            throw outcome.kind === "lost" ? leaseLost() : cancelled();
+        };
+        assertStarting();
+        // Validate the installed ledger before any first-boot inventory write. An
+        // unsupported or corrupt state refusal must leave every directory byte intact.
+        store = new OwnedStateFile(config.stateDir, createLedgerCodec(config.hostId, ledgerLimits), { assertWritable: assertLease });
+        await store.initialize();
+        assertStarting();
+        inventory = await d.ensureInventory(config.stateDir, inventory.host);
+        assertStarting();
+        if (inventory.host !== config.hostId || inventory.nodes.length !== config.peerNodes.length ||
+            inventory.nodes.some((node, index) => node !== config.peerNodes[index])) {
+            throw new BridgeError("GATEWAY_NODE_INVENTORY_CHANGED", "nodes.json changed while the broker was starting.");
+        }
+        assertStarting();
+        // Attestation owns no resource and performs no writes, so shutdown may stop
+        // waiting for a stuck filesystem read without leaving a late cleanup burden.
+        const runtime = await awaitInertStartup(Promise.resolve().then(() => d.attestClaudeRuntime()));
+        assertStarting();
+        const peer = d.createClaudePeer(runtime, config);
+        claude = new ClaudeDestination({ host: config.hostId, stateRoot: config.stateDir, peer });
+        const codex = new CodexDestination({ host: config.hostId, operation: d.createCodexOperation(env) });
+        loopback = new LoopbackDestination(codex);
+        federation = d.createFederation(config.hostId, config.peerNodes);
+        const directory = new EndpointDirectory({ host: config.hostId, limits: ledgerLimits, store, claude: peer, remote: federation });
+        const coordinator = new Coordinator({ host: config.hostId, limits: ledgerLimits, store, claude,
+            codex: loopback, ssh: federation, resolve: (identity) => directory.exact(identity), assertWritable: assertWrite });
+        broker = new MessagingBroker({ host: config.hostId, limits: ledgerLimits, store, directory, coordinator,
+            nodes: config.peerNodes, steeringEnabled: config.steeringEnabled, federation });
+        control = await d.serveControl({ stateDir: config.stateDir, socketPath: config.controlSocketPath,
+            handle: (input) => {
+                if (!ready || controller.signal.aborted)
+                    throw new Error("CONTROL_NOT_READY");
+                assertLease();
+                return handleBrokerCommand(input, { broker: broker, validateHandoff: isFederatedHandoff,
+                    check: () => loopback.check({ host: config.hostId, limits: ledgerLimits, store: store, coordinator }) });
+            } });
+        assertStarting();
+        await loopback.cleanup({ host: config.hostId, limits: ledgerLimits, store });
+        assertStarting();
+        await broker.start();
+        assertStarting();
+        ready = true;
+        const announced = Promise.resolve(options.onReady({ status: "ready", hostId: config.hostId,
+            codexMode: "native_messaging" })).then(() => ({ kind: "ready" }), (error) => ({ kind: "error", error }));
+        const publication = await Promise.race([announced, stopped.then(() => ({ kind: "stopped" })),
+            lease.lost.then(() => ({ kind: "lost" }))]);
+        if (publication.kind === "error")
+            throw publication.error;
+        if (publication.kind === "lost" || lease.isLost())
+            throw leaseLost();
+        if (publication.kind === "ready" && !controller.signal.aborted)
+            await Promise.race([stopped, lease.lost]);
+        if (lease.isLost())
+            throw leaseLost();
+    }
+    catch (error) {
+        primary = error;
+    }
+    options.signal?.removeEventListener("abort", stop);
+    d.remove("SIGINT", stop);
+    d.remove("SIGTERM", stop);
+    const failures = [];
+    for (const resource of [control, broker, ...(broker === undefined ? [loopback, claude, federation] : []), store]) {
+        if (resource !== undefined)
+            await resource.close().catch((error) => failures.push(error));
+    }
+    // If any owned resource did not confirm cleanup, retain a still-held host-wide lease.
+    // Releasing it could admit a second broker while the first still owns a socket,
+    // provider operation, or state handle. A lease already lost cannot fence anything;
+    // close its helper so that failure does not leak another process.
+    if (lease !== undefined && (failures.length === 0 || lease.isLost())) {
+        await lease.close().catch((error) => failures.push(error));
+    }
+    if (failures.length)
+        throw new AggregateError(primary === undefined ? failures : [primary, ...failures], "Gateway execution and cleanup failures are preserved independently.");
+    if (primary !== undefined)
+        throw primary;
+}
+//# sourceMappingURL=runtime.js.map

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

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

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

@@ -0,0 +1,67 @@
+import { type Readable, type Writable } from "node:stream";
+import type { BrokerCommand } from "./broker-control.js";
+type Input = Pick<Readable, "on" | "off"> & {
+    isTTY?: boolean;
+    isRaw?: boolean;
+    readableFlowing?: boolean | null;
+    pause?: Readable["pause"];
+    resume?: Readable["resume"];
+    setRawMode?: (enabled: boolean) => unknown;
+};
+type Output = Pick<Writable, "write"> & {
+    isTTY?: boolean;
+    columns?: number;
+    rows?: number;
+    on?: Writable["on"];
+    off?: Writable["off"];
+};
+export type TuiDependencies = Readonly<{
+    input: Input;
+    output: Output;
+    call: (command: BrokerCommand) => Promise<unknown>;
+    renderStatus: (snapshot: unknown) => string;
+    host?: string;
+    hint?: (code: string) => string;
+    signal?: AbortSignal;
+}>;
+type Obj = Record<string, unknown>;
+type Section = "endpoints" | "deliveries" | "retirements" | "result";
+type Mode = "browse" | "token" | "confirm";
+type EndpointRow = Readonly<{
+    id: string;
+    alias: string;
+    provider: string;
+    host: string;
+    local: boolean;
+    queueDepth?: number;
+    lastOperation?: Obj;
+    observedAt?: string;
+    safeErrorCode?: string;
+    placeholder?: boolean;
+}>;
+export type TuiModel = {
+    snapshot?: Obj;
+    snapshotAt?: number;
+    staleSince?: number;
+    error?: string;
+    action?: string;
+    actionRunning?: boolean;
+    host?: string;
+    restarted?: boolean;
+    section: Section;
+    previousSection?: Exclude<Section, "result">;
+    selected: Record<Exclude<Section, "result">, number> & Partial<Record<"result", number>>;
+    selectedEndpoint?: string;
+    mode: Mode;
+    token: string;
+    retiring?: EndpointRow;
+    result?: Readonly<{
+        label: string;
+        value: string;
+    }>;
+};
+/** Pure screen renderer. It emits no ANSI so all dynamic values remain inert. */
+export declare function renderTui(model: Readonly<TuiModel>, columns?: number, rows?: number, now?: number): string;
+/** Interactive, dependency-free client over the existing broker commands. */
+export declare function runTui(dependencies: TuiDependencies): Promise<void>;
+export {};