agent-embassy 3.0.0 → 4.0.0

package/dist/src/gateway/owned-state.js

@@ -0,0 +1,398 @@
+import { randomUUID } from "node:crypto";
+import { constants } from "node:fs";
+import { chmod, lstat, mkdir, open, readdir, realpath, rename, unlink, } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { BridgeError } from "../errors.js";
+import { KeyedMutex } from "../mutex.js";
+const STATE_MARKER = ".agent-embassy-state";
+const STATE_MARKER_CONTENT = "agent-embassy-state-v1\n";
+const STATE_FILE = "gateway-state.json";
+const MAX_MARKER_FILE_BYTES = 128;
+const MAX_DOCUMENT_BYTES = 8 * 1024 * 1024;
+class PostRenamePersistenceError extends BridgeError {
+    constructor() {
+        super("GATEWAY_STATE_COMMIT_OUTCOME_UNKNOWN", "The installed state commit could not be verified. The controller was disabled and requires recovery.");
+        this.name = "PostRenamePersistenceError";
+    }
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isErrno(error, code) {
+    return error instanceof Error && "code" in error && error.code === code;
+}
+function sameCommit(left, right) {
+    return left === undefined || right === undefined
+        ? left === right
+        : left.commit.sequence === right.commit.sequence && left.commit.id === right.commit.id;
+}
+async function assertNoSymlinkComponents(candidate) {
+    let cursor = path.resolve(candidate);
+    while (true) {
+        try {
+            const info = await lstat(cursor);
+            if (info.isSymbolicLink()) {
+                throw new BridgeError("UNSAFE_GATEWAY_STATE_DIRECTORY", "The gateway state path cannot contain symbolic links.");
+            }
+        }
+        catch (error) {
+            if (!isErrno(error, "ENOENT"))
+                throw error;
+        }
+        const parent = path.dirname(cursor);
+        if (parent === cursor)
+            break;
+        cursor = parent;
+    }
+}
+async function canonicalFuturePath(candidate) {
+    const absolute = path.resolve(candidate);
+    const parsed = path.parse(absolute);
+    const parts = absolute.slice(parsed.root.length).split(path.sep).filter(Boolean);
+    let cursor = parsed.root;
+    for (let index = 0; index < parts.length; index += 1) {
+        const next = path.join(cursor, parts[index]);
+        try {
+            cursor = await realpath(next);
+        }
+        catch (error) {
+            if (isErrno(error, "ENOENT"))
+                return path.join(cursor, ...parts.slice(index));
+            throw error;
+        }
+    }
+    return cursor;
+}
+/**
+ * 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 class OwnedStateFile {
+    rootDir;
+    codec;
+    now;
+    randomId;
+    renameStateFile;
+    syncStateDirectory;
+    afterStateFileRename;
+    mutex = new KeyedMutex();
+    state;
+    poisoned = false;
+    assertWritable;
+    constructor(stateDir, codec, dependencies = {}) {
+        if (!Number.isSafeInteger(codec.schemaVersion) || codec.schemaVersion < 1 ||
+            !Number.isSafeInteger(codec.maximumBytes) || codec.maximumBytes < 1 ||
+            codec.maximumBytes > MAX_DOCUMENT_BYTES) {
+            throw new BridgeError("INVALID_GATEWAY_CONFIGURATION", "The owned state document limits are invalid.");
+        }
+        this.rootDir = path.resolve(stateDir);
+        this.assertWritable = dependencies.assertWritable ?? (() => { });
+        this.codec = codec;
+        this.now = dependencies.now ?? (() => new Date());
+        this.randomId = dependencies.randomId ?? randomUUID;
+        this.renameStateFile = dependencies.renameStateFile ?? rename;
+        this.syncStateDirectory = dependencies.syncStateDirectory ?? (async (directoryPath) => {
+            const directory = await open(directoryPath, constants.O_RDONLY);
+            try {
+                await directory.sync();
+            }
+            finally {
+                await directory.close();
+            }
+        });
+        this.afterStateFileRename = dependencies.afterStateFileRename;
+    }
+    get stateFilePath() {
+        return path.join(this.rootDir, STATE_FILE);
+    }
+    async initialize() {
+        await this.mutex.run("owned-state", async () => {
+            if (this.poisoned)
+                throw new PostRenamePersistenceError();
+            if (this.state !== undefined)
+                return;
+            this.rootDir = await this.prepareOwnedDirectory();
+            const loaded = await this.loadStateFile();
+            if (loaded !== undefined) {
+                this.state = loaded;
+                return;
+            }
+            const initial = this.codec.create({
+                now: this.now(),
+                commit: { sequence: 0, id: this.randomId() },
+            });
+            this.assertDocument(initial);
+            await this.persist(initial, undefined);
+            this.state = initial;
+        });
+    }
+    async snapshot() {
+        return this.mutex.run("owned-state", async () => structuredClone(this.requireState()));
+    }
+    async transact(operation) {
+        return this.mutex.run("owned-state", async () => {
+            const current = this.requireState();
+            this.assertWritable();
+            const draft = structuredClone(current);
+            const result = operation(draft, this.now());
+            if ((typeof result === "object" || typeof result === "function") &&
+                result !== null && "then" in result) {
+                throw new TypeError("Owned state transactions must be synchronous.");
+            }
+            if (JSON.stringify(draft) === JSON.stringify(current)) {
+                return structuredClone(result);
+            }
+            const mutable = draft;
+            mutable.commit = {
+                sequence: current.commit.sequence + 1,
+                id: this.randomId(),
+            };
+            this.assertDocument(draft);
+            const isolatedResult = structuredClone(result);
+            await this.persist(draft, current);
+            this.state = draft;
+            return isolatedResult;
+        });
+    }
+    async close() {
+        await this.mutex.run("owned-state", async () => {
+            this.state = undefined;
+        });
+    }
+    requireState() {
+        if (this.poisoned)
+            throw new PostRenamePersistenceError();
+        if (this.state === undefined) {
+            throw new BridgeError("GATEWAY_NOT_INITIALIZED", "The owned state document has not been initialized.");
+        }
+        return this.state;
+    }
+    assertDocument(value) {
+        if (value.schemaVersion !== this.codec.schemaVersion ||
+            this.codec.decode(structuredClone(value)) === undefined) {
+            throw new BridgeError("CORRUPT_GATEWAY_STATE", "The gateway controller state failed strict schema validation.");
+        }
+        this.codec.assertBounds?.(value);
+    }
+    assertOwnedPrivate(uid, mode, kind) {
+        if (typeof process.getuid === "function" && uid !== process.getuid()) {
+            throw new BridgeError("UNSAFE_GATEWAY_STATE_DIRECTORY", `The gateway state ${kind} is not owned by the current process user.`);
+        }
+        const expected = kind === "directory" ? 0o700 : 0o600;
+        if ((mode & 0o777) !== expected) {
+            throw new BridgeError("UNSAFE_GATEWAY_STATE_DIRECTORY", `The gateway state ${kind} must use exact mode ${expected.toString(8)}.`);
+        }
+    }
+    async prepareOwnedDirectory() {
+        const requested = path.resolve(this.rootDir);
+        await assertNoSymlinkComponents(requested);
+        const canonical = await canonicalFuturePath(requested);
+        const home = await realpath(os.homedir()).catch(() => path.resolve(os.homedir()));
+        const temporaryRoot = await realpath(os.tmpdir()).catch(() => path.resolve(os.tmpdir()));
+        if (canonical === path.parse(canonical).root || canonical === home ||
+            canonical === temporaryRoot) {
+            throw new BridgeError("UNSAFE_GATEWAY_STATE_DIRECTORY", "The gateway state directory must be a dedicated private leaf.");
+        }
+        let existed = true;
+        try {
+            const info = await lstat(canonical);
+            if (info.isSymbolicLink() || !info.isDirectory()) {
+                throw new BridgeError("UNSAFE_GATEWAY_STATE_DIRECTORY", "The gateway state path must be a real directory.");
+            }
+            this.assertOwnedPrivate(info.uid, info.mode, "directory");
+        }
+        catch (error) {
+            if (isErrno(error, "ENOENT"))
+                existed = false;
+            else
+                throw error;
+        }
+        if (!existed) {
+            await mkdir(canonical, { recursive: true, mode: 0o700 });
+            await chmod(canonical, 0o700);
+        }
+        const root = await realpath(canonical);
+        if (root !== canonical) {
+            throw new BridgeError("UNSAFE_GATEWAY_STATE_DIRECTORY", "The gateway state path changed while it was prepared.");
+        }
+        const markerPath = path.join(root, STATE_MARKER);
+        let markerExists = true;
+        try {
+            await this.readPrivateFile(markerPath, MAX_MARKER_FILE_BYTES, STATE_MARKER_CONTENT);
+        }
+        catch (error) {
+            if (isErrno(error, "ENOENT"))
+                markerExists = false;
+            else
+                throw error;
+        }
+        if (!markerExists) {
+            const entries = await readdir(root);
+            if (existed && entries.some((entry) => entry !== "nodes.json")) {
+                throw new BridgeError("GATEWAY_STATE_DIRECTORY_NOT_OWNED", "The existing state directory is non-empty and lacks the ownership marker.");
+            }
+            const marker = await open(markerPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY |
+                (constants.O_NOFOLLOW ?? 0), 0o600);
+            try {
+                await marker.writeFile(STATE_MARKER_CONTENT, "utf8");
+                await marker.sync();
+            }
+            finally {
+                await marker.close();
+            }
+        }
+        return root;
+    }
+    async readPrivateFile(filePath, maximumBytes, expectedBody) {
+        const info = await lstat(filePath);
+        if (info.isSymbolicLink() || !info.isFile()) {
+            throw new BridgeError("UNSAFE_GATEWAY_STATE_FILE", "A gateway controller file is not a regular file.");
+        }
+        this.assertOwnedPrivate(info.uid, info.mode, "file");
+        if (info.size > maximumBytes) {
+            throw new BridgeError("GATEWAY_STATE_FILE_TOO_LARGE", "A gateway controller file exceeds its strict byte limit.");
+        }
+        const handle = await open(filePath, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+        try {
+            const opened = await handle.stat();
+            if (!opened.isFile() || opened.dev !== info.dev || opened.ino !== info.ino ||
+                opened.size > maximumBytes) {
+                throw new BridgeError("UNSAFE_GATEWAY_STATE_FILE", "A gateway controller file changed during its bounded read.");
+            }
+            this.assertOwnedPrivate(opened.uid, opened.mode, "file");
+            const buffer = Buffer.alloc(maximumBytes + 1);
+            let offset = 0;
+            while (offset < buffer.length) {
+                const read = await handle.read(buffer, offset, buffer.length - offset, offset);
+                if (read.bytesRead === 0)
+                    break;
+                offset += read.bytesRead;
+            }
+            if (offset > maximumBytes) {
+                throw new BridgeError("GATEWAY_STATE_FILE_TOO_LARGE", "A gateway controller file exceeds its strict byte limit.");
+            }
+            const body = buffer.subarray(0, offset).toString("utf8");
+            if (expectedBody !== undefined && body !== expectedBody) {
+                throw new BridgeError("GATEWAY_STATE_DIRECTORY_NOT_OWNED", "The gateway ownership marker is not recognized.");
+            }
+            return body;
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    async loadStateFile() {
+        let body;
+        try {
+            body = await this.readPrivateFile(this.stateFilePath, this.codec.maximumBytes);
+        }
+        catch (error) {
+            if (isErrno(error, "ENOENT"))
+                return undefined;
+            throw error;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch {
+            throw new BridgeError("CORRUPT_GATEWAY_STATE", "The gateway controller state is not valid JSON.");
+        }
+        if (isObject(parsed) && Object.hasOwn(parsed, "schemaVersion") &&
+            parsed.schemaVersion !== this.codec.schemaVersion) {
+            throw new BridgeError("GATEWAY_STATE_SCHEMA_UNSUPPORTED", "The gateway state schema is unsupported. Stop Embassy, move gateway-state.json aside, then restart.");
+        }
+        const decoded = this.codec.decode(parsed);
+        if (decoded === undefined) {
+            throw new BridgeError("CORRUPT_GATEWAY_STATE", "The gateway controller state failed strict schema validation.");
+        }
+        this.codec.assertBounds?.(decoded);
+        return decoded;
+    }
+    async persist(next, prior) {
+        this.assertWritable();
+        const temporary = path.join(this.rootDir, `.gateway-state-${randomUUID()}.tmp`);
+        const body = `${JSON.stringify(next, null, 2)}\n`;
+        if (Buffer.byteLength(body, "utf8") > this.codec.maximumBytes) {
+            throw new BridgeError("GATEWAY_STATE_FILE_TOO_LARGE", "The bounded gateway state exceeds its durable byte limit.");
+        }
+        const observedPrior = await this.loadStateFile();
+        if (!sameCommit(observedPrior, prior)) {
+            this.poisoned = true;
+            this.state = undefined;
+            throw new PostRenamePersistenceError();
+        }
+        let handle;
+        let renameAttempted = false;
+        let directorySyncAttempted = false;
+        try {
+            try {
+                handle = await open(temporary, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY |
+                    (constants.O_NOFOLLOW ?? 0), 0o600);
+                await handle.writeFile(body, "utf8");
+                await handle.chmod(0o600);
+                await handle.sync();
+                await handle.close();
+                handle = undefined;
+                try {
+                    const existing = await lstat(this.stateFilePath);
+                    if (existing.isSymbolicLink() || !existing.isFile()) {
+                        throw new BridgeError("UNSAFE_GATEWAY_STATE_FILE", "The gateway state target is not a regular file.");
+                    }
+                    this.assertOwnedPrivate(existing.uid, existing.mode, "file");
+                }
+                catch (error) {
+                    if (!isErrno(error, "ENOENT"))
+                        throw error;
+                }
+                this.assertWritable();
+                renameAttempted = true;
+                await this.renameStateFile(temporary, this.stateFilePath);
+                await this.afterStateFileRename?.();
+                directorySyncAttempted = true;
+                await this.syncStateDirectory(this.rootDir);
+            }
+            catch (error) {
+                if (!renameAttempted)
+                    throw error;
+                let installed;
+                let readbackFailed = false;
+                try {
+                    installed = await this.loadStateFile();
+                }
+                catch {
+                    readbackFailed = true;
+                }
+                if (sameCommit(installed, next)) {
+                    // A readback identifies the installed value, but only a confirmed
+                    // directory sync makes that rename durable across process failure.
+                    if (!directorySyncAttempted) {
+                        try {
+                            directorySyncAttempted = true;
+                            await this.syncStateDirectory(this.rootDir);
+                            return;
+                        }
+                        catch {
+                            // Fall through to the unknown-outcome poison below.
+                        }
+                    }
+                    this.poisoned = true;
+                    this.state = undefined;
+                    throw new PostRenamePersistenceError();
+                }
+                if (!readbackFailed && sameCommit(installed, prior))
+                    throw error;
+                this.poisoned = true;
+                this.state = undefined;
+                throw new PostRenamePersistenceError();
+            }
+        }
+        finally {
+            await handle?.close().catch(() => undefined);
+            await unlink(temporary).catch(() => undefined);
+        }
+    }
+}
+//# sourceMappingURL=owned-state.js.map

package/dist/src/gateway/owned-state.js.map

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

package/dist/src/gateway/provenance-envelope.d.ts

@@ -1,4 +1,5 @@
-import type { GatewayProvider } from "./types.js";
+import type { EndpointRef } from "./ledger.js";
+type GatewayProvider = EndpointRef["provider"];
 export declare const PROVENANCE_RAW_BODY_MAX_BYTES: number;
 export declare const PROVENANCE_ENVELOPE_MAX_BYTES: number;
 export type ComposeProvenanceEnvelopeInput = Readonly<{
@@ -8,8 +9,6 @@ export type ComposeProvenanceEnvelopeInput = Readonly<{
     targetAlias: string;
     conversationId: string;
     body: string;
-    /** Older accepted rows on this exact route when a STEER is injected. */
-    queuedAhead?: number;
 }>;
 /**
  * Adds broker-owned, Claude-compatible textual framing at the provider write
@@ -17,3 +16,4 @@ export type ComposeProvenanceEnvelopeInput = Readonly<{
  * signature; the wrapper is a structural provenance marker for the recipient.
  */
 export declare function composeProvenanceEnvelope(input: ComposeProvenanceEnvelopeInput): string;
+export {};

package/dist/src/gateway/provenance-envelope.js

@@ -11,15 +11,9 @@ const PROVENANCE_RECIPIENT_PROFILE_VALUES = {
     claude: Object.freeze({
         fromNameMaxCodepoints: CLAUDE_FROM_NAME_MAX_CODEPOINTS,
         emitConversationAttribute: false,
-        allowQueuedAhead: false,
     }),
     codex: Object.freeze({
         emitConversationAttribute: true,
-        allowQueuedAhead: true,
-    }),
-    peer: Object.freeze({
-        emitConversationAttribute: true,
-        allowQueuedAhead: false,
     }),
 };
 const PROVENANCE_RECIPIENT_PROFILES = Object.freeze(PROVENANCE_RECIPIENT_PROFILE_VALUES);
@@ -38,20 +32,13 @@ function validateInput(input) {
         input === null ||
         !isGatewayProvider(input.sourceProvider) ||
         !isGatewayProvider(input.recipientProvider) ||
-        (input.sourceProvider === input.recipientProvider &&
-            input.sourceProvider !== "peer") ||
         typeof input.sourceAlias !== "string" ||
         !ALIAS_PATTERN.test(input.sourceAlias) ||
         typeof input.targetAlias !== "string" ||
         !ALIAS_PATTERN.test(input.targetAlias) ||
         typeof input.conversationId !== "string" ||
         !CONVERSATION_ID_PATTERN.test(input.conversationId) ||
-        typeof input.body !== "string" ||
-        (input.queuedAhead !== undefined &&
-            (!PROVENANCE_RECIPIENT_PROFILES[input.recipientProvider]
-                .allowQueuedAhead ||
-                !Number.isSafeInteger(input.queuedAhead) ||
-                input.queuedAhead < 1))) {
+        typeof input.body !== "string") {
         invalidEnvelope();
     }
     if (Buffer.byteLength(input.body, "utf8") > PROVENANCE_RAW_BODY_MAX_BYTES) {
@@ -96,22 +83,15 @@ export function composeProvenanceEnvelope(input) {
     const exactSourceAttribute = profile.fromNameMaxCodepoints !== undefined && display.shortened
         ? ` from-alias="${input.sourceAlias}"`
         : "";
-    const replyCommand = `embassy send --conversation ${input.conversationId}` +
-        ` --from ${input.targetAlias}`;
+    const replyCommand = `embassy send --conversation ${input.conversationId}`;
     const hint = `<embassy-reply-hint conversation="${input.conversationId}"` +
         ` reply-as="${input.targetAlias}"${exactSourceAttribute}` +
         ` from-provider="${input.sourceProvider}">` +
         `Reply by running \`${replyCommand}\` with the reply body on stdin. ` +
         "Caller, conversation, and route policy are rechecked.</embassy-reply-hint>";
-    const queuedAheadMarker = input.queuedAhead === undefined
-        ? ""
-        : `\n<embassy-queued-ahead count="${input.queuedAhead}">` +
-            `${input.queuedAhead} earlier ${input.queuedAhead === 1 ? "message is" : "messages are"} ` +
-            "queued for this route and will arrive at your next turn " +
-            "boundaries.</embassy-queued-ahead>";
     const body = neutralizeReservedTags(input.body);
     const envelope = `<cross-session-message from-name="${fromName}"${conversationAttribute}>\n` +
-        `${hint}${queuedAheadMarker}\n${body}\n</cross-session-message>`;
+        `${hint}\n${body}\n</cross-session-message>`;
     if (Buffer.byteLength(envelope, "utf8") > PROVENANCE_ENVELOPE_MAX_BYTES) {
         envelopeTooLarge();
     }

package/dist/src/gateway/provenance-envelope.js.map

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

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

@@ -0,0 +1,41 @@
+import { ClaudePeerAdapter } from "./claude-peer.js";
+import { type AttestedClaudePeerRuntime } from "./claude-runtime.js";
+import { type StatelessCodexOperationTransport } from "./codex-stateless-transport.js";
+import { type GatewayConfig } from "./config.js";
+import { type Destination } from "./coordinator.js";
+import { type ClaudeDirectoryAdapter, type RemoteEndpointResolver } from "./endpoint-directory.js";
+import { type GatewayNodeInventory } from "./federation-nodes.js";
+import { Federation } from "./federation.js";
+import { type GatewayInstanceLease } from "./instance-lease.js";
+import { serveLocalControl } from "./local-control.js";
+export type CoreRuntimeReady = Readonly<{
+    status: "ready";
+    hostId: string;
+    codexMode: "native_messaging";
+}>;
+export type CoreRuntimeOptions = Readonly<{
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    onReady: (result: CoreRuntimeReady) => void | Promise<void>;
+}>;
+type RuntimeClaudePeer = ClaudeDirectoryAdapter & Pick<ClaudePeerAdapter, "prepareSend" | "close">;
+type RuntimeFederation = Destination & RemoteEndpointResolver & Pick<Federation, "catalog" | "snapshot">;
+type SignalName = "SIGINT" | "SIGTERM";
+export type CoreRuntimeDependencies = Readonly<{
+    loginHome?: () => string;
+    loadInventory?: (stateDir: string) => Promise<GatewayNodeInventory>;
+    ensureInventory?: (stateDir: string, host: string) => Promise<GatewayNodeInventory>;
+    loadConfig?: (env: NodeJS.ProcessEnv, inventory: GatewayNodeInventory) => GatewayConfig;
+    acquireLease?: (home: string) => Promise<GatewayInstanceLease>;
+    attestClaudeRuntime?: () => Promise<AttestedClaudePeerRuntime>;
+    createClaudePeer?: (runtime: AttestedClaudePeerRuntime, config: GatewayConfig) => RuntimeClaudePeer;
+    createCodexOperation?: (env: NodeJS.ProcessEnv) => StatelessCodexOperationTransport;
+    createFederation?: (host: string, nodes: readonly string[]) => RuntimeFederation;
+    serveControl?: typeof serveLocalControl;
+    addSignalListener?: (signal: SignalName, listener: () => void) => void;
+    removeSignalListener?: (signal: SignalName, listener: () => void) => void;
+}>;
+/** Assemble the schema-6 broker. Construction is inert: provider and SSH I/O starts
+ * only when an addressed operation reaches its destination. */
+export declare function runCoreRuntime(options: CoreRuntimeOptions, dependencies?: CoreRuntimeDependencies): Promise<void>;
+export {};