subharness 0.0.1

package/dist/adapters/fx-tools.js

@@ -0,0 +1,119 @@
+import { randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
+import { createServer } from "node:http";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { AgentError } from "../errors.js";
+import { executeTool, toolJsonSchema } from "../sdk/tools.js";
+import { mcpToolContent } from "./mcp-tool-content.js";
+export async function startFxTools(agent) {
+    const definitions = Object.entries(agent.tools ?? {});
+    if (definitions.length === 0)
+        return emptyEndpoint();
+    for (const [, definition] of definitions)
+        toolJsonSchema(definition);
+    const token = randomBytes(32).toString("base64url");
+    const namespace = `subharness_${randomUUID().replaceAll("-", "")}`;
+    const pending = new Set();
+    let accepting = false;
+    let endpointFailure;
+    let failureHandler;
+    const mcp = new McpServer({ name: namespace, version: "1.0.0" });
+    for (const [name, definition] of definitions) {
+        mcp.registerTool(name, { description: definition.description, inputSchema: definition.inputSchema }, async (input) => {
+            if (!accepting)
+                return toolError("The task is not accepting tool calls.");
+            const execution = executeTool(definition, input);
+            pending.add(execution);
+            try {
+                return { content: mcpToolContent(await execution) };
+            }
+            catch (error) {
+                return toolError(error instanceof AgentError ? `Tool failed (${error.code}).` : "The custom tool failed.");
+            }
+            finally {
+                pending.delete(execution);
+            }
+        });
+    }
+    const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: randomUUID, enableJsonResponse: true });
+    await mcp.connect(transport);
+    let http;
+    let closing;
+    const closeEndpoint = () => closing ??= (async () => {
+        accepting = false;
+        await Promise.allSettled([...pending]);
+        await mcp.close().catch(() => { });
+        if (http)
+            await closeHttp(http);
+    })();
+    const failEndpoint = () => {
+        if (endpointFailure)
+            return;
+        endpointFailure = new AgentError("HARNESS_FAILED", "The private fx tool endpoint failed.");
+        accepting = false;
+        failureHandler?.(endpointFailure);
+        void closeEndpoint();
+    };
+    try {
+        http = createServer((request, response) => {
+            if (request.url !== "/mcp" || !authorized(request.headers.authorization, token)) {
+                response.writeHead(401, { "content-type": "application/json" });
+                response.end(JSON.stringify({ error: "unauthorized" }));
+                return;
+            }
+            void transport.handleRequest(request, response).catch(() => {
+                if (!response.headersSent)
+                    response.writeHead(500);
+                response.end();
+            });
+        });
+        await new Promise((resolve, reject) => {
+            http.once("error", reject);
+            http.listen(0, "127.0.0.1", () => {
+                http.off("error", reject);
+                http.on("error", failEndpoint);
+                resolve();
+            });
+        });
+    }
+    catch (error) {
+        await closeEndpoint();
+        throw new AgentError("HARNESS_FAILED", "The private fx tool endpoint could not start.");
+    }
+    const address = http.address();
+    if (!address || typeof address === "string") {
+        await closeEndpoint();
+        throw new AgentError("HARNESS_FAILED", "The private fx tool endpoint did not bind to loopback.");
+    }
+    return {
+        descriptor: { type: "http", name: namespace, url: `http://127.0.0.1:${address.port}/mcp`, headers: [{ name: "Authorization", value: `Bearer ${token}` }] },
+        onFailure(handler) { failureHandler = handler; if (endpointFailure)
+            handler(endpointFailure); },
+        beginTurn() { accepting = true; },
+        stopAdmission() { accepting = false; },
+        async drain() { accepting = false; await Promise.allSettled([...pending]); },
+        close: closeEndpoint,
+    };
+}
+function authorized(header, token) {
+    if (typeof header !== "string")
+        return false;
+    const expected = Buffer.from(`Bearer ${token}`);
+    const actual = Buffer.from(header);
+    return actual.length === expected.length && timingSafeEqual(actual, expected);
+}
+function toolError(text) {
+    return { isError: true, content: [{ type: "text", text }] };
+}
+function emptyEndpoint() {
+    return { onFailure() { }, beginTurn() { }, stopAdmission() { }, async drain() { }, async close() { } };
+}
+async function closeHttp(server) {
+    if (!server.listening)
+        return;
+    await new Promise(resolve => {
+        server.close(() => resolve());
+        server.closeAllConnections();
+    });
+}
+//# sourceMappingURL=fx-tools.js.map

package/dist/adapters/fx-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-tools.js","sourceRoot":"","sources":["../../src/adapters/fx-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomBytes, randomUUID, timingSafeEqual } from \"node:crypto\";\nimport { createServer, type Server as HttpServer } from \"node:http\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\nimport { AgentError } from \"../errors.js\";\nimport { executeTool, toolJsonSchema } from \"../sdk/tools.js\";\nimport type { ExecutionDefinition } from \"./types.js\";\nimport { mcpToolContent } from \"./mcp-tool-content.js\";\n\nexport type FxToolEndpoint = {\n  descriptor?: { type: \"http\"; name: string; url: string; headers: { name: string; value: string }[] };\n  onFailure(handler: (error: AgentError) => void): void;\n  beginTurn(): void;\n  stopAdmission(): void;\n  drain(): Promise<void>;\n  close(): Promise<void>;\n};\n\nexport async function startFxTools(agent: Pick<ExecutionDefinition, \"tools\">): Promise<FxToolEndpoint> {\n  const definitions = Object.entries(agent.tools ?? {});\n  if (definitions.length === 0) return emptyEndpoint();\n  for (const [, definition] of definitions) toolJsonSchema(definition);\n\n  const token = randomBytes(32).toString(\"base64url\");\n  const namespace = `subharness_${randomUUID().replaceAll(\"-\", \"\")}`;\n  const pending = new Set<Promise<unknown>>();\n  let accepting = false;\n  let endpointFailure: AgentError | undefined;\n  let failureHandler: ((error: AgentError) => void) | undefined;\n  const mcp = new McpServer({ name: namespace, version: \"1.0.0\" });\n  for (const [name, definition] of definitions) {\n    mcp.registerTool(name, { description: definition.description, inputSchema: definition.inputSchema }, async (input: unknown) => {\n      if (!accepting) return toolError(\"The task is not accepting tool calls.\");\n      const execution = executeTool(definition, input);\n      pending.add(execution);\n      try {\n        return { content: mcpToolContent(await execution) };\n      } catch (error) {\n        return toolError(error instanceof AgentError ? `Tool failed (${error.code}).` : \"The custom tool failed.\");\n      } finally {\n        pending.delete(execution);\n      }\n    });\n  }\n\n  const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: randomUUID, enableJsonResponse: true });\n  await mcp.connect(transport);\n  let http: HttpServer | undefined;\n  let closing: Promise<void> | undefined;\n  const closeEndpoint = (): Promise<void> => closing ??= (async () => {\n    accepting = false;\n    await Promise.allSettled([...pending]);\n    await mcp.close().catch(() => {});\n    if (http) await closeHttp(http);\n  })();\n  const failEndpoint = () => {\n    if (endpointFailure) return;\n    endpointFailure = new AgentError(\"HARNESS_FAILED\", \"The private fx tool endpoint failed.\");\n    accepting = false;\n    failureHandler?.(endpointFailure);\n    void closeEndpoint();\n  };\n  try {\n    http = createServer((request, response) => {\n      if (request.url !== \"/mcp\" || !authorized(request.headers.authorization, token)) {\n        response.writeHead(401, { \"content-type\": \"application/json\" });\n        response.end(JSON.stringify({ error: \"unauthorized\" }));\n        return;\n      }\n      void transport.handleRequest(request, response).catch(() => {\n        if (!response.headersSent) response.writeHead(500);\n        response.end();\n      });\n    });\n    await new Promise<void>((resolve, reject) => {\n      http!.once(\"error\", reject);\n      http!.listen(0, \"127.0.0.1\", () => {\n        http!.off(\"error\", reject);\n        http!.on(\"error\", failEndpoint);\n        resolve();\n      });\n    });\n  } catch (error) {\n    await closeEndpoint();\n    throw new AgentError(\"HARNESS_FAILED\", \"The private fx tool endpoint could not start.\");\n  }\n  const address = http.address();\n  if (!address || typeof address === \"string\") {\n    await closeEndpoint();\n    throw new AgentError(\"HARNESS_FAILED\", \"The private fx tool endpoint did not bind to loopback.\");\n  }\n\n  return {\n    descriptor: { type: \"http\", name: namespace, url: `http://127.0.0.1:${address.port}/mcp`, headers: [{ name: \"Authorization\", value: `Bearer ${token}` }] },\n    onFailure(handler) { failureHandler = handler; if (endpointFailure) handler(endpointFailure); },\n    beginTurn() { accepting = true; },\n    stopAdmission() { accepting = false; },\n    async drain() { accepting = false; await Promise.allSettled([...pending]); },\n    close: closeEndpoint,\n  };\n}\n\nfunction authorized(header: string | undefined, token: string): boolean {\n  if (typeof header !== \"string\") return false;\n  const expected = Buffer.from(`Bearer ${token}`);\n  const actual = Buffer.from(header);\n  return actual.length === expected.length && timingSafeEqual(actual, expected);\n}\n\nfunction toolError(text: string) {\n  return { isError: true, content: [{ type: \"text\" as const, text }] };\n}\n\nfunction emptyEndpoint(): FxToolEndpoint {\n  return { onFailure() {}, beginTurn() {}, stopAdmission() {}, async drain() {}, async close() {} };\n}\n\nasync function closeHttp(server: HttpServer): Promise<void> {\n  if (!server.listening) return;\n  await new Promise<void>(resolve => {\n    server.close(() => resolve());\n    server.closeAllConnections();\n  });\n}\n"]}

package/dist/adapters/fx.d.ts

@@ -0,0 +1,3 @@
+import { FxRpc } from "./fx-rpc.js";
+import type { AdapterOptions, NativeSession } from "./types.js";
+export declare function openFx(options: AdapterOptions, createRpc?: (cwd: string, env: NodeJS.ProcessEnv, model?: string) => FxRpc): Promise<NativeSession>;

package/dist/adapters/fx.js

@@ -0,0 +1,302 @@
+import { AgentError } from "../errors.js";
+import { fxEnvironment, fxSettingsFingerprint, verifyFxAccess } from "./fx-auth.js";
+import { FxRpc } from "./fx-rpc.js";
+import { startFxTools } from "./fx-tools.js";
+export async function openFx(options, createRpc = (cwd, env, model) => new FxRpc(cwd, env, model)) {
+    const env = fxEnvironment(options);
+    const baseline = await fxSettingsFingerprint(env);
+    await verifyFxAccess(options.cwd, env, options.access.type);
+    const tools = await startFxTools(options.agent);
+    let rpc;
+    try {
+        const startedRpc = createRpc(options.cwd, env, options.harness.model);
+        rpc = startedRpc;
+        let startupFailure;
+        startedRpc.setFailureHandler(error => { startupFailure ??= error; });
+        tools.onFailure(error => startedRpc.abort(error));
+        startedRpc.onMessage = message => startupRequest(startedRpc, message);
+        const initialized = await startedRpc.request("initialize", { protocolVersion: 1, clientInfo: { name: "subharness", version: "0.1.0" }, clientCapabilities: {} });
+        if (!initialized || typeof initialized !== "object" || Array.isArray(initialized) || typeof initialized.protocolVersion !== "number") {
+            throw new AgentError("PROTOCOL_ERROR", "fx returned an invalid ACP initialization response.");
+        }
+        if (initialized.protocolVersion !== 1)
+            throw new AgentError("HARNESS_UNAVAILABLE", "The installed fx ACP protocol is not compatible with version 1.");
+        const created = await startedRpc.request("session/new", {
+            cwd: options.cwd,
+            mcpServers: tools.descriptor ? [tools.descriptor] : [],
+        });
+        if (typeof created?.sessionId !== "string" || created.sessionId.length === 0)
+            throw new AgentError("PROTOCOL_ERROR", "fx did not return a native session identifier.");
+        const selectedModel = verifySelection(created.configOptions, options.harness.model);
+        if (options.harness.effort !== undefined) {
+            verifyEffortAvailable(created.configOptions, options.harness.effort);
+            const configured = await startedRpc.request("session/set_config_option", { sessionId: created.sessionId, configId: "effort", value: options.harness.effort });
+            verifySelection(configured?.configOptions, selectedModel, options.harness.effort);
+        }
+        if (await fxSettingsFingerprint(env) !== baseline)
+            throw new AgentError("INVALID_CONFIG", "fx native settings changed during session startup. Start a new session.");
+        if (startupFailure)
+            throw startupFailure;
+        return new FxSession(startedRpc, created.sessionId, options, env, baseline, tools);
+    }
+    catch (error) {
+        await rpc?.close();
+        await tools.close();
+        if (error instanceof AgentError)
+            throw error;
+        throw new AgentError("HARNESS_UNAVAILABLE", "Cannot start fx. Check the native executable and session configuration.");
+    }
+}
+function startupRequest(rpc, message) {
+    if (message.id === undefined)
+        return;
+    try {
+        rpc.send({ id: message.id, result: { outcome: { outcome: "cancelled" } } });
+    }
+    catch { /* process may already be closing */ }
+    rpc.abort(new AgentError("INPUT_REQUIRED", "fx requested interactive input during startup. Complete its native setup before running an agent."));
+}
+function option(options, id) {
+    if (!Array.isArray(options))
+        throw new AgentError("PROTOCOL_ERROR", "fx returned invalid native session options.");
+    return options.find(value => value && typeof value === "object" && value.id === id);
+}
+function verifySelection(configOptions, requestedModel, effort) {
+    const provider = option(configOptions, "provider");
+    const selectedModel = option(configOptions, "model");
+    if (!provider || !selectedModel) {
+        throw new AgentError("PROTOCOL_ERROR", "fx did not expose compatible native provider and model selectors.");
+    }
+    if (provider.currentValue !== "gateway") {
+        throw new AgentError("INVALID_CONFIG", "fx selected a provider outside the authorized Gateway route.");
+    }
+    const model = selectedModel.currentValue;
+    if (typeof model !== "string" || model.length === 0) {
+        throw new AgentError("INVALID_CONFIG", "fx could not select a verifiable native default for this connection. Supply --model <model>.");
+    }
+    if (requestedModel && model !== requestedModel) {
+        throw new AgentError("INVALID_CONFIG", "fx changed the explicitly selected Gateway model.");
+    }
+    if (effort !== undefined && option(configOptions, "effort")?.currentValue !== effort) {
+        throw new AgentError("INVALID_CONFIG", "fx did not apply the explicitly selected effort.");
+    }
+    return model;
+}
+function verifyEffortAvailable(configOptions, effort) {
+    const configured = option(configOptions, "effort");
+    if (!configured || !Array.isArray(configured.options) || !configured.options.some((value) => value?.value === effort)) {
+        throw new AgentError("UNSUPPORTED_OPTION", "The requested fx effort is not supported by the selected model.");
+    }
+}
+class FxSession {
+    rpc;
+    sessionId;
+    options;
+    env;
+    settingsFingerprint;
+    tools;
+    active;
+    failure;
+    retirement;
+    first = true;
+    closed = false;
+    constructor(rpc, sessionId, options, env, settingsFingerprint, tools) {
+        this.rpc = rpc;
+        this.sessionId = sessionId;
+        this.options = options;
+        this.env = env;
+        this.settingsFingerprint = settingsFingerprint;
+        this.tools = tools;
+        rpc.setFailureHandler(error => {
+            this.failure ??= error;
+            const active = this.active;
+            this.retirement ??= this.rpc.close();
+            if (active)
+                void this.retirement.then(() => this.finish(active, undefined, error));
+        });
+        rpc.onMessage = message => this.message(message);
+    }
+    message(message) {
+        const active = this.active;
+        const params = message.params;
+        if (message.id !== undefined) {
+            try {
+                this.rpc.send({ id: message.id, result: { outcome: { outcome: "cancelled" } } });
+            }
+            catch { /* cancellation will surface the transport failure */ }
+            if (!active) {
+                this.rpc.abort(new AgentError("INPUT_REQUIRED", "fx requested interactive input outside an active task."));
+            }
+            else if (!active.failure) {
+                active.failure = new AgentError("INPUT_REQUIRED", "fx requested interactive input or approval. Configure native permissions before retrying; no approval was granted.");
+                this.tools.stopAdmission();
+                try {
+                    this.rpc.send({ method: "session/cancel", params: { sessionId: this.sessionId } });
+                }
+                catch { /* onFailure settles the turn */ }
+                active.cancellationTimer = setTimeout(() => {
+                    if (this.active === active && !active.terminal)
+                        this.rpc.abort(new AgentError("CANCELLATION_FAILED", "fx did not stop after requesting interactive input."));
+                }, 2_000);
+                active.cancellationTimer.unref();
+            }
+            return;
+        }
+        if (params?.sessionId !== this.sessionId)
+            return;
+        if (!active || message.method !== "session/update")
+            return;
+        const update = params.update;
+        if (!update || typeof update !== "object" || typeof update.sessionUpdate !== "string") {
+            this.rpc.abort(new AgentError("PROTOCOL_ERROR", "fx returned an invalid ACP session update."));
+            return;
+        }
+        if (update.sessionUpdate !== "agent_message_chunk")
+            return;
+        if (typeof update.messageId !== "string" || update.content?.type !== "text" || typeof update.content.text !== "string") {
+            this.rpc.abort(new AgentError("PROTOCOL_ERROR", "fx returned an invalid agent message chunk."));
+            return;
+        }
+        if (active.lastMessageId !== update.messageId) {
+            active.lastMessageId = update.messageId;
+            active.text = "";
+            active.responseBytes = 0;
+            active.responseTooLarge = false;
+        }
+        active.responseBytes += Buffer.byteLength(update.content.text, "utf8");
+        if (active.responseBytes > 1024 * 1024)
+            active.responseTooLarge = true;
+        else
+            active.text += update.content.text;
+    }
+    async finish(active, result, failure) {
+        if (active.terminal)
+            return;
+        active.terminal = true;
+        active.resolveNativeStopped();
+        if (active.cancellationTimer)
+            clearTimeout(active.cancellationTimer);
+        this.tools.stopAdmission();
+        await this.tools.drain();
+        if (this.active === active)
+            this.active = undefined;
+        if (failure)
+            return active.reject(failure);
+        if (active.failure)
+            return active.reject(active.failure);
+        if (active.responseTooLarge)
+            return active.reject(new AgentError("RESPONSE_TOO_LARGE", "fx response exceeds 1 MiB."));
+        if (result?.stopReason === "end_turn")
+            active.resolve(active.text);
+        else
+            active.reject(new AgentError(result?.stopReason === "cancelled" ? "INTERRUPTED" : "HARNESS_FAILED", "fx did not complete the turn successfully."));
+    }
+    async turn(prompt) {
+        if (this.closed)
+            throw new AgentError("HARNESS_FAILED", "The fx session is closed.");
+        if (this.failure)
+            throw this.failure;
+        if (this.active)
+            throw new AgentError("SESSION_BUSY", "fx already has an active turn.");
+        let resolve, reject;
+        let releaseAdmission;
+        let resolveNativeStopped;
+        const completion = new Promise((a, b) => { resolve = a; reject = b; });
+        const admission = new Promise(resolveAdmission => { releaseAdmission = resolveAdmission; });
+        const nativeStopped = new Promise(resolveStopped => { resolveNativeStopped = resolveStopped; });
+        const active = { text: "", responseBytes: 0, responseTooLarge: false, completion, resolve, reject, terminal: false, submitted: false, cancelRequested: false, admission, releaseAdmission, nativeStopped, resolveNativeStopped };
+        this.active = active;
+        void completion.catch(() => { });
+        try {
+            if (await fxSettingsFingerprint(this.env) !== this.settingsFingerprint) {
+                throw new AgentError("INVALID_CONFIG", "fx native settings changed while the session was active. Start a new session.");
+            }
+            if (this.failure)
+                throw this.failure;
+            if (active.terminal || this.active !== active)
+                throw new AgentError("HARNESS_FAILED", "fx stopped while preparing the native prompt.");
+            if (active.cancelRequested || this.closed)
+                throw new AgentError("INTERRUPTED", "The fx turn was interrupted before submission.");
+            this.tools.beginTurn();
+            const includeInstructions = this.first;
+            const text = includeInstructions && this.options.agent.instructions ? firstPrompt(this.options.agent.instructions, prompt) : prompt;
+            active.submitted = true;
+            active.releaseAdmission();
+            const result = await this.rpc.request("session/prompt", { sessionId: this.sessionId, prompt: [{ type: "text", text }] });
+            if (includeInstructions)
+                this.first = false;
+            await this.finish(active, result);
+            return await completion;
+        }
+        catch (error) {
+            active.releaseAdmission();
+            if (this.failure && this.retirement)
+                await this.retirement;
+            await this.finish(active, undefined, error instanceof AgentError ? error : new AgentError("HARNESS_FAILED", "fx could not complete the native prompt."));
+            return await completion;
+        }
+    }
+    async steer(_prompt) {
+        throw new AgentError("UNSUPPORTED_DELIVERY", "fx does not expose verified active steering.");
+    }
+    async interrupt() {
+        const active = this.active;
+        if (!active)
+            return;
+        active.cancelRequested = true;
+        this.tools.stopAdmission();
+        await bounded(active.admission, 2_000);
+        const admittedTools = this.tools.drain();
+        let cancellationFailure;
+        try {
+            if (active.submitted && !active.terminal)
+                this.rpc.send({ method: "session/cancel", params: { sessionId: this.sessionId } });
+        }
+        catch (error) {
+            cancellationFailure = error;
+        }
+        await admittedTools;
+        if (cancellationFailure && !this.failure)
+            throw cancellationFailure;
+        await bounded(active.nativeStopped, 3_000);
+        await active.completion.catch(() => { });
+    }
+    async resume() {
+        throw new AgentError("RECOVERY_UNSUPPORTED", "fx recovery without a new prompt is unavailable.");
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.tools.stopAdmission();
+        try {
+            if (this.active) {
+                this.active.cancelRequested = true;
+                await bounded(this.active.admission, 2_000);
+                if (this.active.submitted && !this.active.terminal)
+                    this.rpc.send({ method: "session/cancel", params: { sessionId: this.sessionId } });
+            }
+            await bounded(this.rpc.request("session/close", { sessionId: this.sessionId }), 2_000);
+        }
+        catch { /* process termination below still retires the session */ }
+        await this.rpc.close();
+        await this.tools.close();
+    }
+}
+function firstPrompt(instructions, prompt) {
+    return `<subharness-instructions>\n${instructions}\n</subharness-instructions>\n\n${prompt}`;
+}
+async function bounded(promise, milliseconds) {
+    let timer;
+    const timeout = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => reject(new AgentError("CANCELLATION_FAILED", "fx did not confirm that native execution stopped.")), milliseconds);
+        timer.unref();
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=fx.js.map

package/dist/adapters/fx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx.js","sourceRoot":"","sources":["../../src/adapters/fx.ts"],"names":[],"mappings":"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","sourcesContent":["import { AgentError } from \"../errors.js\";\nimport { fxEnvironment, fxSettingsFingerprint, verifyFxAccess } from \"./fx-auth.js\";\nimport { FxRpc, type AcpEnvelope } from \"./fx-rpc.js\";\nimport { startFxTools, type FxToolEndpoint } from \"./fx-tools.js\";\nimport type { AdapterOptions, NativeSession } from \"./types.js\";\n\ntype ActiveTurn = {\n  lastMessageId?: string;\n  text: string;\n  responseBytes: number;\n  responseTooLarge: boolean;\n  completion: Promise<string>;\n  resolve(text: string): void;\n  reject(error: Error): void;\n  terminal: boolean;\n  submitted: boolean;\n  cancelRequested: boolean;\n  admission: Promise<void>;\n  releaseAdmission(): void;\n  nativeStopped: Promise<void>;\n  resolveNativeStopped(): void;\n  cancellationTimer?: NodeJS.Timeout;\n  failure?: AgentError;\n};\n\nexport async function openFx(\n  options: AdapterOptions,\n  createRpc: (cwd: string, env: NodeJS.ProcessEnv, model?: string) => FxRpc = (cwd, env, model) => new FxRpc(cwd, env, model),\n): Promise<NativeSession> {\n  const env = fxEnvironment(options);\n  const baseline = await fxSettingsFingerprint(env);\n  await verifyFxAccess(options.cwd, env, options.access.type);\n  const tools = await startFxTools(options.agent);\n  let rpc: FxRpc | undefined;\n  try {\n    const startedRpc = createRpc(options.cwd, env, options.harness.model);\n    rpc = startedRpc;\n    let startupFailure: AgentError | undefined;\n    startedRpc.setFailureHandler(error => { startupFailure ??= error; });\n    tools.onFailure(error => startedRpc.abort(error));\n    startedRpc.onMessage = message => startupRequest(startedRpc, message);\n    const initialized = await startedRpc.request(\"initialize\", { protocolVersion: 1, clientInfo: { name: \"subharness\", version: \"0.1.0\" }, clientCapabilities: {} });\n    if (!initialized || typeof initialized !== \"object\" || Array.isArray(initialized) || typeof initialized.protocolVersion !== \"number\") {\n      throw new AgentError(\"PROTOCOL_ERROR\", \"fx returned an invalid ACP initialization response.\");\n    }\n    if (initialized.protocolVersion !== 1) throw new AgentError(\"HARNESS_UNAVAILABLE\", \"The installed fx ACP protocol is not compatible with version 1.\");\n    const created = await startedRpc.request(\"session/new\", {\n      cwd: options.cwd,\n      mcpServers: tools.descriptor ? [tools.descriptor] : [],\n    });\n    if (typeof created?.sessionId !== \"string\" || created.sessionId.length === 0) throw new AgentError(\"PROTOCOL_ERROR\", \"fx did not return a native session identifier.\");\n    const selectedModel = verifySelection(created.configOptions, options.harness.model);\n    if (options.harness.effort !== undefined) {\n      verifyEffortAvailable(created.configOptions, options.harness.effort);\n      const configured = await startedRpc.request(\"session/set_config_option\", { sessionId: created.sessionId, configId: \"effort\", value: options.harness.effort });\n      verifySelection(configured?.configOptions, selectedModel, options.harness.effort);\n    }\n    if (await fxSettingsFingerprint(env) !== baseline) throw new AgentError(\"INVALID_CONFIG\", \"fx native settings changed during session startup. Start a new session.\");\n    if (startupFailure) throw startupFailure;\n    return new FxSession(startedRpc, created.sessionId, options, env, baseline, tools);\n  } catch (error) {\n    await rpc?.close();\n    await tools.close();\n    if (error instanceof AgentError) throw error;\n    throw new AgentError(\"HARNESS_UNAVAILABLE\", \"Cannot start fx. Check the native executable and session configuration.\");\n  }\n}\n\nfunction startupRequest(rpc: FxRpc, message: AcpEnvelope): void {\n  if (message.id === undefined) return;\n  try { rpc.send({ id: message.id, result: { outcome: { outcome: \"cancelled\" } } }); } catch { /* process may already be closing */ }\n  rpc.abort(new AgentError(\"INPUT_REQUIRED\", \"fx requested interactive input during startup. Complete its native setup before running an agent.\"));\n}\n\nfunction option(options: unknown, id: string): any {\n  if (!Array.isArray(options)) throw new AgentError(\"PROTOCOL_ERROR\", \"fx returned invalid native session options.\");\n  return options.find(value => value && typeof value === \"object\" && (value as any).id === id);\n}\n\nfunction verifySelection(configOptions: unknown, requestedModel?: string, effort?: string): string {\n  const provider = option(configOptions, \"provider\");\n  const selectedModel = option(configOptions, \"model\");\n  if (!provider || !selectedModel) {\n    throw new AgentError(\"PROTOCOL_ERROR\", \"fx did not expose compatible native provider and model selectors.\");\n  }\n  if (provider.currentValue !== \"gateway\") {\n    throw new AgentError(\"INVALID_CONFIG\", \"fx selected a provider outside the authorized Gateway route.\");\n  }\n  const model = selectedModel.currentValue;\n  if (typeof model !== \"string\" || model.length === 0) {\n    throw new AgentError(\"INVALID_CONFIG\", \"fx could not select a verifiable native default for this connection. Supply --model <model>.\");\n  }\n  if (requestedModel && model !== requestedModel) {\n    throw new AgentError(\"INVALID_CONFIG\", \"fx changed the explicitly selected Gateway model.\");\n  }\n  if (effort !== undefined && option(configOptions, \"effort\")?.currentValue !== effort) {\n    throw new AgentError(\"INVALID_CONFIG\", \"fx did not apply the explicitly selected effort.\");\n  }\n  return model;\n}\n\nfunction verifyEffortAvailable(configOptions: unknown, effort: string): void {\n  const configured = option(configOptions, \"effort\");\n  if (!configured || !Array.isArray(configured.options) || !configured.options.some((value: any) => value?.value === effort)) {\n    throw new AgentError(\"UNSUPPORTED_OPTION\", \"The requested fx effort is not supported by the selected model.\");\n  }\n}\n\nclass FxSession implements NativeSession {\n  private active?: ActiveTurn;\n  private failure?: AgentError;\n  private retirement?: Promise<void>;\n  private first = true;\n  private closed = false;\n\n  constructor(\n    private readonly rpc: FxRpc,\n    private readonly sessionId: string,\n    private readonly options: AdapterOptions,\n    private readonly env: NodeJS.ProcessEnv,\n    private readonly settingsFingerprint: string,\n    private readonly tools: FxToolEndpoint,\n  ) {\n    rpc.setFailureHandler(error => {\n      this.failure ??= error;\n      const active = this.active;\n      this.retirement ??= this.rpc.close();\n      if (active) void this.retirement.then(() => this.finish(active, undefined, error));\n    });\n    rpc.onMessage = message => this.message(message);\n  }\n\n  private message(message: AcpEnvelope): void {\n    const active = this.active;\n    const params = message.params;\n    if (message.id !== undefined) {\n      try { this.rpc.send({ id: message.id, result: { outcome: { outcome: \"cancelled\" } } }); } catch { /* cancellation will surface the transport failure */ }\n      if (!active) {\n        this.rpc.abort(new AgentError(\"INPUT_REQUIRED\", \"fx requested interactive input outside an active task.\"));\n      } else if (!active.failure) {\n        active.failure = new AgentError(\"INPUT_REQUIRED\", \"fx requested interactive input or approval. Configure native permissions before retrying; no approval was granted.\");\n        this.tools.stopAdmission();\n        try { this.rpc.send({ method: \"session/cancel\", params: { sessionId: this.sessionId } }); } catch { /* onFailure settles the turn */ }\n        active.cancellationTimer = setTimeout(() => {\n          if (this.active === active && !active.terminal) this.rpc.abort(new AgentError(\"CANCELLATION_FAILED\", \"fx did not stop after requesting interactive input.\"));\n        }, 2_000);\n        active.cancellationTimer.unref();\n      }\n      return;\n    }\n    if (params?.sessionId !== this.sessionId) return;\n    if (!active || message.method !== \"session/update\") return;\n    const update = params.update;\n    if (!update || typeof update !== \"object\" || typeof update.sessionUpdate !== \"string\") {\n      this.rpc.abort(new AgentError(\"PROTOCOL_ERROR\", \"fx returned an invalid ACP session update.\"));\n      return;\n    }\n    if (update.sessionUpdate !== \"agent_message_chunk\") return;\n    if (typeof update.messageId !== \"string\" || update.content?.type !== \"text\" || typeof update.content.text !== \"string\") {\n      this.rpc.abort(new AgentError(\"PROTOCOL_ERROR\", \"fx returned an invalid agent message chunk.\"));\n      return;\n    }\n    if (active.lastMessageId !== update.messageId) {\n      active.lastMessageId = update.messageId;\n      active.text = \"\";\n      active.responseBytes = 0;\n      active.responseTooLarge = false;\n    }\n    active.responseBytes += Buffer.byteLength(update.content.text, \"utf8\");\n    if (active.responseBytes > 1024 * 1024) active.responseTooLarge = true;\n    else active.text += update.content.text;\n  }\n\n  private async finish(active: ActiveTurn, result?: any, failure?: AgentError): Promise<void> {\n    if (active.terminal) return;\n    active.terminal = true;\n    active.resolveNativeStopped();\n    if (active.cancellationTimer) clearTimeout(active.cancellationTimer);\n    this.tools.stopAdmission();\n    await this.tools.drain();\n    if (this.active === active) this.active = undefined;\n    if (failure) return active.reject(failure);\n    if (active.failure) return active.reject(active.failure);\n    if (active.responseTooLarge) return active.reject(new AgentError(\"RESPONSE_TOO_LARGE\", \"fx response exceeds 1 MiB.\"));\n    if (result?.stopReason === \"end_turn\") active.resolve(active.text);\n    else active.reject(new AgentError(result?.stopReason === \"cancelled\" ? \"INTERRUPTED\" : \"HARNESS_FAILED\", \"fx did not complete the turn successfully.\"));\n  }\n\n  async turn(prompt: string): Promise<string> {\n    if (this.closed) throw new AgentError(\"HARNESS_FAILED\", \"The fx session is closed.\");\n    if (this.failure) throw this.failure;\n    if (this.active) throw new AgentError(\"SESSION_BUSY\", \"fx already has an active turn.\");\n    let resolve!: (text: string) => void, reject!: (error: Error) => void;\n    let releaseAdmission!: () => void;\n    let resolveNativeStopped!: () => void;\n    const completion = new Promise<string>((a, b) => { resolve = a; reject = b; });\n    const admission = new Promise<void>(resolveAdmission => { releaseAdmission = resolveAdmission; });\n    const nativeStopped = new Promise<void>(resolveStopped => { resolveNativeStopped = resolveStopped; });\n    const active: ActiveTurn = { text: \"\", responseBytes: 0, responseTooLarge: false, completion, resolve, reject, terminal: false, submitted: false, cancelRequested: false, admission, releaseAdmission, nativeStopped, resolveNativeStopped };\n    this.active = active;\n    void completion.catch(() => {});\n    try {\n      if (await fxSettingsFingerprint(this.env) !== this.settingsFingerprint) {\n        throw new AgentError(\"INVALID_CONFIG\", \"fx native settings changed while the session was active. Start a new session.\");\n      }\n      if (this.failure) throw this.failure;\n      if (active.terminal || this.active !== active) throw new AgentError(\"HARNESS_FAILED\", \"fx stopped while preparing the native prompt.\");\n      if (active.cancelRequested || this.closed) throw new AgentError(\"INTERRUPTED\", \"The fx turn was interrupted before submission.\");\n      this.tools.beginTurn();\n      const includeInstructions = this.first;\n      const text = includeInstructions && this.options.agent.instructions ? firstPrompt(this.options.agent.instructions, prompt) : prompt;\n      active.submitted = true;\n      active.releaseAdmission();\n      const result = await this.rpc.request(\"session/prompt\", { sessionId: this.sessionId, prompt: [{ type: \"text\", text }] });\n      if (includeInstructions) this.first = false;\n      await this.finish(active, result);\n      return await completion;\n    } catch (error) {\n      active.releaseAdmission();\n      if (this.failure && this.retirement) await this.retirement;\n      await this.finish(active, undefined, error instanceof AgentError ? error : new AgentError(\"HARNESS_FAILED\", \"fx could not complete the native prompt.\"));\n      return await completion;\n    }\n  }\n\n  async steer(_prompt: string): Promise<void> {\n    throw new AgentError(\"UNSUPPORTED_DELIVERY\", \"fx does not expose verified active steering.\");\n  }\n\n  async interrupt(): Promise<void> {\n    const active = this.active;\n    if (!active) return;\n    active.cancelRequested = true;\n    this.tools.stopAdmission();\n    await bounded(active.admission, 2_000);\n    const admittedTools = this.tools.drain();\n    let cancellationFailure: unknown;\n    try {\n      if (active.submitted && !active.terminal) this.rpc.send({ method: \"session/cancel\", params: { sessionId: this.sessionId } });\n    } catch (error) {\n      cancellationFailure = error;\n    }\n    await admittedTools;\n    if (cancellationFailure && !this.failure) throw cancellationFailure;\n    await bounded(active.nativeStopped, 3_000);\n    await active.completion.catch(() => {});\n  }\n\n  async resume(): Promise<string> {\n    throw new AgentError(\"RECOVERY_UNSUPPORTED\", \"fx recovery without a new prompt is unavailable.\");\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) return;\n    this.closed = true;\n    this.tools.stopAdmission();\n    try {\n      if (this.active) {\n        this.active.cancelRequested = true;\n        await bounded(this.active.admission, 2_000);\n        if (this.active.submitted && !this.active.terminal) this.rpc.send({ method: \"session/cancel\", params: { sessionId: this.sessionId } });\n      }\n      await bounded(this.rpc.request(\"session/close\", { sessionId: this.sessionId }), 2_000);\n    } catch { /* process termination below still retires the session */ }\n    await this.rpc.close();\n    await this.tools.close();\n  }\n}\n\nfunction firstPrompt(instructions: string, prompt: string): string {\n  return `<subharness-instructions>\\n${instructions}\\n</subharness-instructions>\\n\\n${prompt}`;\n}\n\nasync function bounded<T>(promise: Promise<T>, milliseconds: number): Promise<T> {\n  let timer!: NodeJS.Timeout;\n  const timeout = new Promise<never>((_resolve, reject) => {\n    timer = setTimeout(() => reject(new AgentError(\"CANCELLATION_FAILED\", \"fx did not confirm that native execution stopped.\")), milliseconds);\n    timer.unref();\n  });\n  try { return await Promise.race([promise, timeout]); }\n  finally { clearTimeout(timer); }\n}\n"]}

package/dist/adapters/mcp-tool-content.d.ts

@@ -0,0 +1,12 @@
+import type { ExecutedToolResult } from "../sdk/tool-result.js";
+export declare function mcpToolContent(result: ExecutedToolResult): ({
+    type: "text";
+    text: string;
+    data?: undefined;
+    mimeType?: undefined;
+} | {
+    text?: undefined;
+    type: "image";
+    data: string;
+    mimeType: "image/gif" | "image/jpeg" | "image/png" | "image/webp";
+})[];

package/dist/adapters/mcp-tool-content.js

@@ -0,0 +1,8 @@
+export function mcpToolContent(result) {
+    if (typeof result === "string")
+        return [{ type: "text", text: result }];
+    return result.content.map(block => block.type === "text"
+        ? { type: "text", text: block.text }
+        : { type: "image", data: block.data, mimeType: block.mimeType });
+}
+//# sourceMappingURL=mcp-tool-content.js.map

package/dist/adapters/mcp-tool-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-content.js","sourceRoot":"","sources":["../../src/adapters/mcp-tool-content.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,MAA0B;IACvD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjF,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM;QACtD,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;QAC7C,CAAC,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["import type { ExecutedToolResult } from \"../sdk/tool-result.js\";\n\nexport function mcpToolContent(result: ExecutedToolResult) {\n  if (typeof result === \"string\") return [{ type: \"text\" as const, text: result }];\n  return result.content.map(block => block.type === \"text\"\n    ? { type: \"text\" as const, text: block.text }\n    : { type: \"image\" as const, data: block.data, mimeType: block.mimeType });\n}\n"]}

package/dist/adapters/rpc.d.ts

@@ -0,0 +1,28 @@
+import { AgentError } from "../errors.js";
+type Envelope = {
+    id?: string | number;
+    method?: string;
+    params?: any;
+    result?: any;
+    error?: unknown;
+};
+/** A bidirectional JSON-lines connection to an external native process. */
+export declare class NativeRpc {
+    private readonly process;
+    private readonly pending;
+    private sequence;
+    private buffer;
+    private failure?;
+    private readonly exited;
+    onMessage: (message: Envelope) => void;
+    onFailure: (error: AgentError) => void;
+    constructor(command: string, args: string[], cwd: string, env: NodeJS.ProcessEnv);
+    request(method: string, params: unknown): Promise<any>;
+    send(message: Envelope): void;
+    abort(error: AgentError): void;
+    close(): Promise<void>;
+    private read;
+    private invalid;
+    private fail;
+}
+export {};