agent-embassy 1.6.0 → 1.7.0

package/dist/src/gateway/acp-client.js

@@ -0,0 +1,382 @@
+import { spawn as nodeSpawn, } from "node:child_process";
+import readline from "node:readline";
+const ACP_PROTOCOL_VERSION = 1;
+const METHOD_NOT_FOUND = -32601;
+export const ACP_MAX_REPLY_BYTES = 64 * 1024;
+export class AcpRequestError extends Error {
+    detail;
+    constructor(detail) {
+        super(detail.message);
+        this.name = "AcpRequestError";
+        this.detail = detail;
+    }
+}
+class AcpProcessExitedError extends Error {
+    constructor() {
+        super("ACP subprocess exited");
+        this.name = "AcpProcessExitedError";
+    }
+}
+export class AcpClient {
+    child;
+    pending = new Map();
+    disabledMethods = new Map();
+    activePrompts = new Map();
+    lines;
+    nextRequestId = 1;
+    writeChain = Promise.resolve();
+    exited = false;
+    infoValue;
+    constructor(child) {
+        this.child = child;
+        child.stderr.resume();
+        this.lines = readline.createInterface({ input: child.stdout });
+        this.lines.on("line", (line) => this.handleLine(line));
+        child.once("error", () => this.handleProcessExit());
+        child.once("exit", () => this.handleProcessExit());
+    }
+    static async spawn(launch, options = {}) {
+        const { command, args } = resolveLaunch(launch);
+        let child;
+        try {
+            child = (options.spawn ?? nodeSpawn)(command, args, {
+                ...(launch.cwd === undefined ? {} : { cwd: launch.cwd }),
+                shell: false,
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+        }
+        catch {
+            throw new AcpProcessExitedError();
+        }
+        const client = new AcpClient(child);
+        try {
+            await client.initialize();
+            return client;
+        }
+        catch (error) {
+            client.close();
+            throw error;
+        }
+    }
+    get connectionInfo() {
+        return this.infoValue;
+    }
+    async newSession(cwd, mcpServers = []) {
+        const result = asObject(await this.request("session/new", { cwd, mcpServers: [...mcpServers] }), "session/new");
+        if (typeof result.sessionId !== "string" || result.sessionId.length === 0) {
+            throw new Error("ACP session/new returned an invalid sessionId");
+        }
+        return { sessionId: result.sessionId };
+    }
+    async prompt(sessionId, text) {
+        if (this.activePrompts.has(sessionId)) {
+            throw new Error("ACP session already has an outstanding prompt");
+        }
+        const active = { bytes: 0, text: "", truncated: false };
+        this.activePrompts.set(sessionId, active);
+        try {
+            const result = asObject(await this.request("session/prompt", {
+                sessionId,
+                prompt: [{ type: "text", text }],
+            }), "session/prompt");
+            return mapPromptResult(result.stopReason, active);
+        }
+        catch (error) {
+            if (error instanceof AcpProcessExitedError) {
+                return {
+                    terminalState: "unknown",
+                    text: active.text,
+                    textTruncated: active.truncated,
+                };
+            }
+            if (error instanceof AcpRequestError) {
+                return {
+                    terminalState: "failed",
+                    error: error.detail,
+                    reportOnly: error.detail.code === -32000,
+                    text: active.text,
+                    textTruncated: active.truncated,
+                };
+            }
+            throw error;
+        }
+        finally {
+            this.activePrompts.delete(sessionId);
+        }
+    }
+    cancel(sessionId) {
+        return this.notify("session/cancel", { sessionId });
+    }
+    async authenticate(methodId) {
+        await this.request("authenticate", { methodId });
+    }
+    listSessions(params = {}) {
+        return this.optionalRequest("session/list", hasObjectCapability(this.infoValue.agentCapabilities, [
+            "sessionCapabilities",
+            "list",
+        ]), params);
+    }
+    resumeSession(options) {
+        return this.optionalRequest("session/resume", hasObjectCapability(this.infoValue.agentCapabilities, [
+            "sessionCapabilities",
+            "resume",
+        ]), sessionLifecycleParams(options));
+    }
+    loadSession(options) {
+        return this.optionalRequest("session/load", this.infoValue.agentCapabilities.loadSession === true, sessionLifecycleParams(options));
+    }
+    close() {
+        if (this.exited)
+            return;
+        this.handleProcessExit();
+        this.child.kill();
+    }
+    async initialize() {
+        const result = asObject(await this.request("initialize", {
+            protocolVersion: ACP_PROTOCOL_VERSION,
+            clientCapabilities: {
+                fs: { readTextFile: false, writeTextFile: false },
+                terminal: false,
+            },
+        }), "initialize");
+        if (!Number.isInteger(result.protocolVersion)) {
+            throw new Error("ACP initialize returned an invalid protocolVersion");
+        }
+        if (result.protocolVersion !== ACP_PROTOCOL_VERSION) {
+            throw new Error(`ACP protocol version mismatch: client supports ${ACP_PROTOCOL_VERSION}, agent selected ${String(result.protocolVersion)}`);
+        }
+        const agentCapabilities = result.agentCapabilities === undefined
+            ? {}
+            : asObject(result.agentCapabilities, "initialize.agentCapabilities");
+        const authMethods = Array.isArray(result.authMethods)
+            ? [...result.authMethods]
+            : [];
+        this.infoValue = Object.freeze({
+            protocolVersion: result.protocolVersion,
+            agentCapabilities: Object.freeze({ ...agentCapabilities }),
+            authMethods: Object.freeze(authMethods),
+        });
+    }
+    async optionalRequest(method, advertised, params) {
+        if (!advertised)
+            return { available: false, reason: "not_advertised" };
+        if (this.disabledMethods.has(method)) {
+            return { available: false, reason: "method_not_found" };
+        }
+        try {
+            return { available: true, value: await this.request(method, params) };
+        }
+        catch (error) {
+            if (error instanceof AcpRequestError &&
+                error.detail.code === METHOD_NOT_FOUND) {
+                return { available: false, reason: "method_not_found" };
+            }
+            throw error;
+        }
+    }
+    request(method, params) {
+        const disabled = this.disabledMethods.get(method);
+        if (disabled)
+            return Promise.reject(new AcpRequestError(disabled));
+        if (this.exited)
+            return Promise.reject(new AcpProcessExitedError());
+        const id = this.nextRequestId++;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { method, resolve, reject });
+            void this.write({ jsonrpc: "2.0", id, method, params }).catch((error) => {
+                this.pending.delete(id);
+                reject(error);
+            });
+        });
+    }
+    notify(method, params) {
+        return this.write({ jsonrpc: "2.0", method, params });
+    }
+    write(message) {
+        if (this.exited)
+            return Promise.reject(new AcpProcessExitedError());
+        const operation = this.writeChain.then(() => new Promise((resolve, reject) => {
+            this.child.stdin.write(`${JSON.stringify(message)}\n`, (error) => {
+                if (error) {
+                    this.handleProcessExit();
+                    reject(new AcpProcessExitedError());
+                }
+                else
+                    resolve();
+            });
+        }));
+        this.writeChain = operation.catch(() => undefined);
+        return operation;
+    }
+    handleLine(line) {
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        if (!isObject(message))
+            return;
+        if (typeof message.method === "string") {
+            this.handleInbound(message);
+            return;
+        }
+        if ((typeof message.id !== "string" && typeof message.id !== "number") ||
+            (!Object.hasOwn(message, "result") && !Object.hasOwn(message, "error"))) {
+            return;
+        }
+        const pending = this.pending.get(message.id);
+        if (!pending)
+            return;
+        this.pending.delete(message.id);
+        if (Object.hasOwn(message, "error")) {
+            const detail = rpcErrorDetail(message.error);
+            if (detail.code === METHOD_NOT_FOUND) {
+                this.disabledMethods.set(pending.method, detail);
+            }
+            pending.reject(new AcpRequestError(detail));
+        }
+        else {
+            pending.resolve(message.result);
+        }
+    }
+    handleInbound(message) {
+        const hasId = typeof message.id === "string" || typeof message.id === "number";
+        if (message.method === "session/update" && !hasId) {
+            this.consumeSessionUpdate(message.params);
+            return;
+        }
+        if (message.method === "session/request_permission" && hasId) {
+            void this.write({
+                jsonrpc: "2.0",
+                id: message.id,
+                result: { outcome: { outcome: "cancelled" } },
+            }).catch(() => undefined);
+            return;
+        }
+        if (hasId) {
+            void this.write({
+                jsonrpc: "2.0",
+                id: message.id,
+                error: { code: METHOD_NOT_FOUND, message: "Method not found" },
+            }).catch(() => undefined);
+        }
+    }
+    consumeSessionUpdate(params) {
+        if (!isObject(params) || typeof params.sessionId !== "string")
+            return;
+        const update = params.update;
+        if (!isObject(update) ||
+            update.sessionUpdate !== "agent_message_chunk" ||
+            !isObject(update.content) ||
+            update.content.type !== "text" ||
+            typeof update.content.text !== "string") {
+            return;
+        }
+        const active = this.activePrompts.get(params.sessionId);
+        if (active)
+            appendPromptText(active, update.content.text);
+    }
+    handleProcessExit() {
+        if (this.exited)
+            return;
+        this.exited = true;
+        this.lines.close();
+        const error = new AcpProcessExitedError();
+        for (const pending of this.pending.values())
+            pending.reject(error);
+        this.pending.clear();
+    }
+}
+function resolveLaunch(launch) {
+    const args = launch.args ?? [];
+    if (launch.kind === "npx") {
+        return { command: "npx", args: ["--yes", launch.package, ...args] };
+    }
+    if (launch.kind === "binary") {
+        return { command: launch.path, args };
+    }
+    return { command: launch.command, args };
+}
+function sessionLifecycleParams(options) {
+    return {
+        sessionId: options.sessionId,
+        cwd: options.cwd,
+        mcpServers: [...(options.mcpServers ?? [])],
+    };
+}
+function mapPromptResult(stopReason, active) {
+    const textResult = {
+        text: active.text,
+        textTruncated: active.truncated,
+    };
+    if (stopReason === "end_turn") {
+        return { terminalState: "delivered", stopReason, ...textResult };
+    }
+    if (stopReason === "max_tokens" ||
+        stopReason === "max_turn_requests" ||
+        stopReason === "refusal") {
+        return { terminalState: "failed", stopReason, ...textResult };
+    }
+    if (stopReason === "cancelled") {
+        return { terminalState: "cancelled", stopReason, ...textResult };
+    }
+    throw new AcpRequestError({
+        code: -32603,
+        message: "ACP session/prompt returned an invalid stopReason",
+    });
+}
+function appendPromptText(active, text) {
+    if (active.truncated)
+        return;
+    const bytes = Buffer.from(text, "utf8");
+    const remaining = ACP_MAX_REPLY_BYTES - active.bytes;
+    if (bytes.length <= remaining) {
+        active.text += text;
+        active.bytes += bytes.length;
+        return;
+    }
+    let end = remaining;
+    while (end > 0 && (bytes[end] & 0xc0) === 0x80)
+        end--;
+    active.text += bytes.subarray(0, end).toString("utf8");
+    active.bytes += end;
+    active.truncated = true;
+}
+function hasObjectCapability(value, path) {
+    let current = value;
+    for (const segment of path) {
+        if (!isObject(current))
+            return false;
+        current = current[segment];
+    }
+    return isObject(current);
+}
+function rpcErrorDetail(value) {
+    if (!isObject(value) || typeof value.code !== "number" ||
+        typeof value.message !== "string") {
+        return { code: -32603, message: "Invalid JSON-RPC error response" };
+    }
+    return {
+        code: value.code,
+        message: value.message,
+        ...(Object.hasOwn(value, "data") ? { data: value.data } : {}),
+    };
+}
+function asObject(value, method) {
+    if (!isObject(value)) {
+        throw new AcpRequestError({
+            code: -32603,
+            message: `ACP ${method} returned an invalid response`,
+        });
+    }
+    return value;
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function spawnAcpClient(launch, options = {}) {
+    return AcpClient.spawn(launch, options);
+}
+//# sourceMappingURL=acp-client.js.map

package/dist/src/gateway/acp-client.js.map

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

package/dist/src/gateway/acp-provider.d.ts

@@ -0,0 +1,65 @@
+import { type AcpClient, type AcpLaunchSpec } from "./acp-client.js";
+import type { GatewayAdapterCallbacks, GatewayAdapterDispatchInput, GatewayAdapterDispatchResult, GatewayProviderAdapter } from "./service.js";
+import type { GatewayProvider } from "./types.js";
+type AcpOwnedProvider = Extract<GatewayProvider, "deepseek" | "grok">;
+type Client = Pick<AcpClient, "close" | "connectionInfo" | "newSession" | "prompt">;
+export type AcpGatewayProviderOptions = Readonly<{
+    provider: AcpOwnedProvider;
+    alias: string;
+    hostId: string;
+    launch?: AcpLaunchSpec;
+    unavailableCode?: string;
+    workspace?: string;
+    endpointGeneration?: string;
+    spawnClient?: (launch: AcpLaunchSpec) => Promise<Client>;
+    now?: () => number;
+    setTimeout?: typeof setTimeout;
+    clearTimeout?: typeof clearTimeout;
+}>;
+export declare class AcpGatewayProvider implements GatewayProviderAdapter {
+    private readonly options;
+    readonly identity: Readonly<{
+        provider: AcpOwnedProvider;
+        hostId: string;
+        endpointGeneration: string;
+    }>;
+    readonly protocol = "acp";
+    readonly protocolVersion = "1";
+    private readonly routeHandle;
+    private readonly spawnClient;
+    private readonly now;
+    private readonly setTimer;
+    private readonly clearTimer;
+    private callbacks?;
+    private client;
+    private sessionId;
+    private retryAt;
+    private failures;
+    private recoveryTimer;
+    private closed;
+    constructor(options: AcpGatewayProviderOptions);
+    activateEndpointGeneration(generation: string): void;
+    initialize(callbacks: GatewayAdapterCallbacks): Promise<{
+        ownedRoute: {
+            alias: string;
+            routeHandle: string;
+            state: "idle";
+        };
+        safeErrorCode?: string;
+        health: "healthy" | "degraded";
+    }>;
+    selectRoute(input: {
+        alias: string;
+        routeHandle: string;
+    }): Promise<{
+        routeHandle: string;
+        state: "idle";
+    }>;
+    dispatch(input: GatewayAdapterDispatchInput): Promise<GatewayAdapterDispatchResult>;
+    close(): Promise<void>;
+    private connect;
+    private markStale;
+    private emitState;
+}
+export declare const createAcpGatewayProvider: (options: AcpGatewayProviderOptions) => GatewayProviderAdapter;
+export {};

package/dist/src/gateway/acp-provider.js

@@ -0,0 +1,163 @@
+import { createHash, randomUUID } from "node:crypto";
+import { spawnAcpClient, } from "./acp-client.js";
+import { composeProvenanceEnvelope } from "./provenance-envelope.js";
+const BACKOFF_MS = [250, 500, 1_000, 2_000, 5_000];
+export class AcpGatewayProvider {
+    options;
+    identity;
+    protocol = "acp";
+    protocolVersion = "1";
+    routeHandle;
+    spawnClient;
+    now;
+    setTimer;
+    clearTimer;
+    callbacks;
+    client;
+    sessionId;
+    retryAt = 0;
+    failures = 0;
+    recoveryTimer;
+    closed = false;
+    constructor(options) {
+        this.options = options;
+        this.identity = Object.freeze({
+            provider: options.provider,
+            hostId: options.hostId,
+            endpointGeneration: options.endpointGeneration ?? `acp_${randomUUID()}`,
+        });
+        this.routeHandle = `acp_${createHash("sha256").update(options.alias).digest("base64url").slice(0, 24)}`;
+        this.spawnClient = options.spawnClient ?? ((launch) => spawnAcpClient(launch));
+        this.now = options.now ?? Date.now;
+        this.setTimer = options.setTimeout ?? setTimeout;
+        this.clearTimer = options.clearTimeout ?? clearTimeout;
+    }
+    activateEndpointGeneration(generation) {
+        if (generation !== this.identity.endpointGeneration) {
+            throw new Error("ACP endpoint generation changed");
+        }
+    }
+    async initialize(callbacks) {
+        this.callbacks = callbacks;
+        return {
+            health: this.options.launch === undefined ? "degraded" : "healthy",
+            ...(this.options.launch === undefined
+                ? { safeErrorCode: this.options.unavailableCode ?? "ACP_LAUNCH_UNAVAILABLE" }
+                : {}),
+            ownedRoute: { alias: this.options.alias, routeHandle: this.routeHandle, state: "idle" },
+        };
+    }
+    async selectRoute(input) {
+        if (input.alias !== this.options.alias || input.routeHandle !== this.routeHandle) {
+            throw new Error("ACP route identity mismatch");
+        }
+        return { routeHandle: this.routeHandle, state: "idle" };
+    }
+    async dispatch(input) {
+        if (this.closed || input.targetAlias !== this.options.alias ||
+            input.binding.provider !== this.options.provider ||
+            input.binding.hostId !== this.options.hostId ||
+            input.binding.endpointGeneration !== this.identity.endpointGeneration ||
+            input.binding.routeHandle !== this.routeHandle) {
+            return { state: "failed", safeErrorCode: "ACP_ROUTE_MISMATCH" };
+        }
+        const client = await this.connect();
+        if (client === undefined || this.sessionId === undefined) {
+            return { state: "deferred", safeErrorCode: this.options.launch === undefined
+                    ? this.options.unavailableCode ?? "ACP_LAUNCH_UNAVAILABLE"
+                    : "ACP_RESTART_BACKOFF" };
+        }
+        let receipt;
+        try {
+            receipt = await client.prompt(this.sessionId, composeProvenanceEnvelope({
+                sourceProvider: input.sourceProvider,
+                recipientProvider: this.options.provider,
+                sourceAlias: input.sourceAlias,
+                targetAlias: input.targetAlias,
+                conversationId: input.conversationId,
+                body: input.text,
+                ...(input.progressWatchActive ? { progressWatchActive: true } : {}),
+            }));
+        }
+        catch {
+            this.markStale("ACP_DISPATCH_OUTCOME_UNKNOWN");
+            return { state: "ambiguous", safeErrorCode: "ACP_DISPATCH_OUTCOME_UNKNOWN" };
+        }
+        if (receipt.terminalState === "unknown") {
+            this.markStale("ACP_SUBPROCESS_EXITED");
+            return result("ambiguous", "ACP_SUBPROCESS_EXITED", receipt.text);
+        }
+        this.emitState("idle");
+        if (receipt.terminalState === "cancelled") {
+            return result("cancelled", undefined, receipt.text);
+        }
+        if (receipt.terminalState === "failed") {
+            return result("failed", "error" in receipt ? "ACP_REQUEST_FAILED" : `ACP_${receipt.stopReason.toUpperCase()}`, receipt.text);
+        }
+        return result(this.options.provider === "deepseek" ? "unconfirmed" : "delivered", this.options.provider === "deepseek" ? "ACP_OUTCOME_COARSE" : undefined, receipt.text);
+    }
+    async close() {
+        this.closed = true;
+        if (this.recoveryTimer !== undefined)
+            this.clearTimer(this.recoveryTimer);
+        this.client?.close();
+        this.client = undefined;
+        this.sessionId = undefined;
+    }
+    async connect() {
+        if (this.client !== undefined)
+            return this.client;
+        if (this.options.launch === undefined || this.now() < this.retryAt) {
+            if (this.recoveryTimer === undefined)
+                this.markStale(this.options.unavailableCode ?? "ACP_LAUNCH_UNAVAILABLE");
+            return undefined;
+        }
+        let client;
+        try {
+            client = await this.spawnClient(this.options.launch);
+            const session = await client.newSession(this.options.workspace ?? this.options.launch.cwd ?? process.cwd());
+            this.client = client;
+            this.sessionId = session.sessionId;
+            this.failures = 0;
+            this.retryAt = 0;
+            return client;
+        }
+        catch {
+            client?.close();
+            this.markStale("ACP_SUBPROCESS_UNAVAILABLE");
+            return undefined;
+        }
+    }
+    markStale(code) {
+        this.client?.close();
+        this.client = undefined;
+        this.sessionId = undefined;
+        const delay = BACKOFF_MS[Math.min(this.failures++, BACKOFF_MS.length - 1)];
+        this.retryAt = this.now() + delay;
+        this.emitState("stale", code);
+        if (this.recoveryTimer !== undefined)
+            this.clearTimer(this.recoveryTimer);
+        this.recoveryTimer = this.setTimer(() => {
+            this.recoveryTimer = undefined;
+            if (!this.closed)
+                this.emitState("idle");
+        }, delay);
+        this.recoveryTimer.unref?.();
+    }
+    emitState(state, safeErrorCode) {
+        this.callbacks?.onRouteState({
+            endpoint: { ...this.identity, routeHandle: this.routeHandle },
+            state,
+            ...(safeErrorCode === undefined ? {} : { safeErrorCode }),
+        });
+    }
+}
+function result(state, safeErrorCode, replyText) {
+    return {
+        state,
+        ...(safeErrorCode === undefined ? {} : { safeErrorCode }),
+        ...(replyText === undefined || replyText.length === 0 ? {} : { replyText }),
+    };
+}
+export const createAcpGatewayProvider = (options) => new AcpGatewayProvider(options);
+//# sourceMappingURL=acp-provider.js.map

package/dist/src/gateway/acp-provider.js.map

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

package/dist/src/gateway/claude-helper-protocol.d.ts

@@ -3,12 +3,13 @@ import type { AttestedClaudePeerRuntime } from "./claude-runtime.js";
 import type { GatewayDeliveryNoticeMode } from "./config.js";
 import type { DashboardLocale } from "./locale.js";
 import type { GatewayAdapterDelivery, GatewayAdapterDispatchResult } from "./service.js";
-import type { PrivateRouteBinding } from "./types.js";
+import { type GatewayProvider, type PrivateRouteBinding } from "./types.js";
 export declare const CLAUDE_NATIVE_HELPER_PROTOCOL_VERSION: 1;
 export declare const CLAUDE_NATIVE_HELPER_MAX_IPC_BYTES: number;
 export declare const CLAUDE_NATIVE_HELPER_MAX_REQUESTS = 64;
 export type ClaudeNativeHelperRegistration = Readonly<{
     alias: string;
+    sourceProvider: GatewayProvider;
     cwd: string;
 }>;
 export type ClaudeNativeHelperInitialization = Readonly<{
@@ -39,6 +40,7 @@ export type ClaudeNativeHelperCommand = Readonly<{
     authorization: "selected_route" | "native_reply";
     messageId: string;
     sourceAlias: string;
+    sourceProvider: GatewayProvider;
     targetAlias: string;
     conversationId: string;
     text: string;