@ai-agent-forge/agent-forge 0.88.2 → 0.88.3

package/examples/extensions/mcp-stdio/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * MCP-like JSON-RPC 2.0 stdio bridge.
+ *
+ * This is intentionally an external capability plugin. It discovers tools
+ * from one explicitly configured process and exposes them through the public
+ * CapabilityAPI; policy, approval, and server selection remain host-owned.
+ */
+import type { CapabilityAPI, CapabilityPluginFactory } from "@agent-forge/coding-agent";
+export type McpErrorReason = "spawn" | "exit" | "malformed" | "protocol" | "remote" | "aborted" | "timed_out";
+export interface McpErrorDetails {
+    method?: string;
+    requestId?: number;
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number | null;
+    data?: unknown;
+}
+export declare class McpStdioError extends Error {
+    readonly reason: McpErrorReason;
+    readonly details: McpErrorDetails;
+    constructor(message: string, reason: McpErrorReason, details?: McpErrorDetails);
+}
+export interface McpRequestOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+export interface McpStdioTransport {
+    request(method: string, params?: unknown, options?: McpRequestOptions): Promise<unknown>;
+    notify(method: string, params?: unknown): Promise<void> | void;
+    close(): Promise<void> | void;
+    readonly stderr?: string;
+}
+export interface McpStdioTransportConfig {
+    command: string;
+    args: readonly string[];
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    onStderr?: (text: string) => void;
+}
+export type McpStdioTransportFactory = (config: McpStdioTransportConfig) => McpStdioTransport | Promise<McpStdioTransport>;
+export interface McpStdioPluginOptions {
+    command: string;
+    args?: readonly string[];
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+    transportFactory?: McpStdioTransportFactory;
+    onStderr?: (text: string) => void;
+    protocolVersion?: string;
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+}
+/** Default line-delimited stdio transport. The command is never passed to a shell. */
+export declare function spawnMcpTransport(config: McpStdioTransportConfig): McpStdioTransport;
+/** Create an asynchronously discovering MCP stdio capability plugin. */
+export declare function createMcpStdioPlugin(options: McpStdioPluginOptions): CapabilityPluginFactory;
+/**
+ * Template entry only. A working MCP transport needs a user-selected command,
+ * arguments, and timeout; never launch an unconfigured child process.
+ */
+export default function mcpStdioExample(_api: CapabilityAPI): never;
+//# sourceMappingURL=index.d.ts.map

package/examples/extensions/mcp-stdio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EACX,aAAa,EACb,uBAAuB,EAGvB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAE9G,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED,qBAAa,aAAc,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,eAAoB,EAKjF;CACD;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,wBAAwB,GAAG,CACtC,MAAM,EAAE,uBAAuB,KAC3B,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AA+CD,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAQpF;AAmLD,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,uBAAuB,CA0D5F;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,KAAK,CAIlE","sourcesContent":["/**\n * MCP-like JSON-RPC 2.0 stdio bridge.\n *\n * This is intentionally an external capability plugin. It discovers tools\n * from one explicitly configured process and exposes them through the public\n * CapabilityAPI; policy, approval, and server selection remain host-owned.\n */\n\nimport type { ChildProcessWithoutNullStreams } from \"node:child_process\";\nimport { spawn } from \"node:child_process\";\nimport type { AgentToolResult } from \"@agent-forge/agent-core\";\nimport type {\n\tCapabilityAPI,\n\tCapabilityPluginFactory,\n\tExtensionContext,\n\tToolDefinition,\n} from \"@agent-forge/coding-agent\";\nimport { Type } from \"typebox\";\n\nexport type McpErrorReason = \"spawn\" | \"exit\" | \"malformed\" | \"protocol\" | \"remote\" | \"aborted\" | \"timed_out\";\n\nexport interface McpErrorDetails {\n\tmethod?: string;\n\trequestId?: number;\n\tstdout?: string;\n\tstderr?: string;\n\texitCode?: number | null;\n\tdata?: unknown;\n}\n\nexport class McpStdioError extends Error {\n\treadonly reason: McpErrorReason;\n\treadonly details: McpErrorDetails;\n\n\tconstructor(message: string, reason: McpErrorReason, details: McpErrorDetails = {}) {\n\t\tsuper(message);\n\t\tthis.name = \"McpStdioError\";\n\t\tthis.reason = reason;\n\t\tthis.details = details;\n\t}\n}\n\nexport interface McpRequestOptions {\n\tsignal?: AbortSignal;\n\ttimeoutMs?: number;\n}\n\nexport interface McpStdioTransport {\n\trequest(method: string, params?: unknown, options?: McpRequestOptions): Promise<unknown>;\n\tnotify(method: string, params?: unknown): Promise<void> | void;\n\tclose(): Promise<void> | void;\n\treadonly stderr?: string;\n}\n\nexport interface McpStdioTransportConfig {\n\tcommand: string;\n\targs: readonly string[];\n\tcwd?: string;\n\tenv?: NodeJS.ProcessEnv;\n\tonStderr?: (text: string) => void;\n}\n\nexport type McpStdioTransportFactory = (\n\tconfig: McpStdioTransportConfig,\n) => McpStdioTransport | Promise<McpStdioTransport>;\n\nexport interface McpStdioPluginOptions {\n\tcommand: string;\n\targs?: readonly string[];\n\tcwd?: string;\n\tenv?: NodeJS.ProcessEnv;\n\ttimeoutMs?: number;\n\ttransportFactory?: McpStdioTransportFactory;\n\tonStderr?: (text: string) => void;\n\tprotocolVersion?: string;\n\tclientInfo?: { name: string; version: string };\n}\n\ninterface JsonRpcResponse {\n\tjsonrpc?: unknown;\n\tid?: unknown;\n\tmethod?: unknown;\n\tresult?: unknown;\n\terror?: { code?: unknown; message?: unknown; data?: unknown };\n}\n\nconst noResult = (): AgentToolResult<unknown> => ({ content: [{ type: \"text\", text: \"\" }], details: undefined });\n\nfunction asRecord(value: unknown, label: string): Record<string, unknown> {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) {\n\t\tthrow new McpStdioError(`${label} must be an object`, \"malformed\", { data: value });\n\t}\n\treturn value as Record<string, unknown>;\n}\n\nfunction validateToolList(value: unknown): readonly Record<string, unknown>[] {\n\tconst object = asRecord(value, \"MCP tools/list result\");\n\tif (!Array.isArray(object.tools)) {\n\t\tthrow new McpStdioError(\"MCP tools/list result must contain tools[]\", \"malformed\", { data: value });\n\t}\n\treturn object.tools.map((tool, index) => {\n\t\tconst record = asRecord(tool, `MCP tool at index ${index}`);\n\t\tif (typeof record.name !== \"string\" || !record.name.trim()) {\n\t\t\tthrow new McpStdioError(`MCP tool at index ${index} requires a non-empty name`, \"malformed\", { data: tool });\n\t\t}\n\t\tif (record.inputSchema !== undefined && (typeof record.inputSchema !== \"object\" || record.inputSchema === null)) {\n\t\t\tthrow new McpStdioError(`MCP tool has an invalid inputSchema: ${record.name}`, \"malformed\", { data: tool });\n\t\t}\n\t\treturn record;\n\t});\n}\n\nfunction normalizeToolResult(value: unknown): AgentToolResult<unknown> {\n\tif (value && typeof value === \"object\" && Array.isArray((value as { content?: unknown }).content)) {\n\t\treturn value as AgentToolResult<unknown>;\n\t}\n\tif (value === undefined) return noResult();\n\treturn {\n\t\tcontent: [{ type: \"text\", text: typeof value === \"string\" ? value : JSON.stringify(value) }],\n\t\tdetails: undefined,\n\t};\n}\n\n/** Default line-delimited stdio transport. The command is never passed to a shell. */\nexport function spawnMcpTransport(config: McpStdioTransportConfig): McpStdioTransport {\n\tconst child = spawn(config.command, [...config.args], {\n\t\tcwd: config.cwd,\n\t\tenv: config.env,\n\t\tshell: false,\n\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t});\n\treturn createJsonRpcTransport(child, config.onStderr);\n}\n\nfunction createJsonRpcTransport(\n\tchild: ChildProcessWithoutNullStreams,\n\tonStderr?: (text: string) => void,\n): McpStdioTransport {\n\tlet nextId = 1;\n\tlet closed = false;\n\tlet stdout = \"\";\n\tlet stderr = \"\";\n\tlet closeRequested = false;\n\tconst pending = new Map<\n\t\tnumber,\n\t\t{ method: string; resolve: (value: unknown) => void; reject: (error: unknown) => void }\n\t>();\n\tconst ignored = new Set<number>();\n\tlet fatalError: McpStdioError | undefined;\n\n\tconst failAll = (error: McpStdioError): void => {\n\t\tif (fatalError) return;\n\t\tfatalError = error;\n\t\tclosed = true;\n\t\tfor (const request of pending.values()) request.reject(error);\n\t\tpending.clear();\n\t};\n\n\tchild.stdout.setEncoding(\"utf8\");\n\tchild.stdout.on(\"data\", (chunk: string) => {\n\t\tstdout += chunk;\n\t\tconst lines = stdout.split(/\\r?\\n/);\n\t\tstdout = lines.pop() ?? \"\";\n\t\tfor (const line of lines) {\n\t\t\tif (!line.trim()) continue;\n\t\t\tlet parsed: JsonRpcResponse;\n\t\t\ttry {\n\t\t\t\tparsed = JSON.parse(line) as JsonRpcResponse;\n\t\t\t} catch {\n\t\t\t\tfailAll(new McpStdioError(\"Malformed JSON-RPC response\", \"malformed\", { stdout: line, stderr }));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (parsed.jsonrpc !== \"2.0\") {\n\t\t\t\tfailAll(new McpStdioError(\"Invalid JSON-RPC response envelope\", \"protocol\", { data: parsed, stderr }));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (parsed.id === undefined) {\n\t\t\t\tif (typeof parsed.method === \"string\") continue;\n\t\t\t\tfailAll(new McpStdioError(\"JSON-RPC response is missing an id\", \"protocol\", { data: parsed, stderr }));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (typeof parsed.id !== \"number\" && parsed.id !== null) {\n\t\t\t\tfailAll(new McpStdioError(\"Invalid JSON-RPC response id\", \"protocol\", { data: parsed, stderr }));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (parsed.id === null) continue;\n\t\t\tconst responseId = parsed.id as number;\n\t\t\tif (ignored.delete(responseId)) continue;\n\t\t\tconst request = pending.get(responseId);\n\t\t\tif (!request) {\n\t\t\t\tfailAll(\n\t\t\t\t\tnew McpStdioError(`Unknown JSON-RPC response id: ${responseId}`, \"protocol\", { data: parsed, stderr }),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tpending.delete(responseId);\n\t\t\tif (parsed.error) {\n\t\t\t\tconst message = typeof parsed.error.message === \"string\" ? parsed.error.message : \"MCP request failed\";\n\t\t\t\trequest.reject(\n\t\t\t\t\tnew McpStdioError(message, \"remote\", {\n\t\t\t\t\t\tmethod: request.method,\n\t\t\t\t\t\trequestId: responseId,\n\t\t\t\t\t\tdata: parsed.error,\n\t\t\t\t\t\tstderr,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t} else if (!(\"result\" in parsed)) {\n\t\t\t\trequest.reject(\n\t\t\t\t\tnew McpStdioError(\"JSON-RPC response has neither result nor error\", \"protocol\", {\n\t\t\t\t\t\tmethod: request.method,\n\t\t\t\t\t\trequestId: responseId,\n\t\t\t\t\t\tdata: parsed,\n\t\t\t\t\t\tstderr,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t} else {\n\t\t\t\trequest.resolve(parsed.result);\n\t\t\t}\n\t\t}\n\t});\n\tchild.stderr.setEncoding(\"utf8\");\n\tchild.stderr.on(\"data\", (chunk: string) => {\n\t\tstderr += chunk;\n\t\tonStderr?.(chunk);\n\t});\n\tchild.once(\"error\", (error) => {\n\t\tfailAll(new McpStdioError(`Failed to spawn MCP process: ${error.message}`, \"spawn\", { stdout, stderr }));\n\t});\n\tchild.once(\"close\", (exitCode) => {\n\t\tif (closed) return;\n\t\tfailAll(\n\t\t\tnew McpStdioError(`MCP process exited with code ${exitCode ?? \"unknown\"}`, \"exit\", {\n\t\t\t\tstdout,\n\t\t\t\tstderr,\n\t\t\t\texitCode,\n\t\t\t}),\n\t\t);\n\t});\n\n\tconst request = (method: string, params?: unknown, options: McpRequestOptions = {}): Promise<unknown> => {\n\t\tif (fatalError || closed)\n\t\t\treturn Promise.reject(fatalError ?? new McpStdioError(\"MCP transport is closed\", \"exit\", { stderr }));\n\t\tif (options.signal?.aborted)\n\t\t\treturn Promise.reject(new McpStdioError(\"MCP request aborted\", \"aborted\", { method, stderr }));\n\t\tconst id = nextId++;\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tlet timeout: NodeJS.Timeout | undefined;\n\t\t\tconst abort = (): void => {\n\t\t\t\tif (!pending.delete(id)) return;\n\t\t\t\tignored.add(id);\n\t\t\t\tif (timeout) clearTimeout(timeout);\n\t\t\t\treject(new McpStdioError(\"MCP request aborted\", \"aborted\", { method, requestId: id, stderr }));\n\t\t\t};\n\t\t\tpending.set(id, {\n\t\t\t\tmethod,\n\t\t\t\tresolve: (result) => {\n\t\t\t\t\tif (timeout) clearTimeout(timeout);\n\t\t\t\t\toptions.signal?.removeEventListener(\"abort\", abort);\n\t\t\t\t\tresolve(result);\n\t\t\t\t},\n\t\t\t\treject: (error) => {\n\t\t\t\t\tif (timeout) clearTimeout(timeout);\n\t\t\t\t\toptions.signal?.removeEventListener(\"abort\", abort);\n\t\t\t\t\treject(error);\n\t\t\t\t},\n\t\t\t});\n\t\t\toptions.signal?.addEventListener(\"abort\", abort, { once: true });\n\t\t\tif (options.timeoutMs !== undefined) {\n\t\t\t\ttimeout = setTimeout(() => {\n\t\t\t\t\tif (!pending.delete(id)) return;\n\t\t\t\t\tignored.add(id);\n\t\t\t\t\toptions.signal?.removeEventListener(\"abort\", abort);\n\t\t\t\t\treject(new McpStdioError(\"MCP request timed out\", \"timed_out\", { method, requestId: id, stderr }));\n\t\t\t\t}, options.timeoutMs);\n\t\t\t}\n\t\t\tchild.stdin.write(\n\t\t\t\t`${JSON.stringify({ jsonrpc: \"2.0\", id, method, ...(params === undefined ? {} : { params }) })}\\n`,\n\t\t\t);\n\t\t});\n\t};\n\treturn {\n\t\trequest,\n\t\tnotify(method, params) {\n\t\t\tif (fatalError || closed) throw fatalError ?? new McpStdioError(\"MCP transport is closed\", \"exit\", { stderr });\n\t\t\tchild.stdin.write(\n\t\t\t\t`${JSON.stringify({ jsonrpc: \"2.0\", method, ...(params === undefined ? {} : { params }) })}\\n`,\n\t\t\t);\n\t\t},\n\t\tclose() {\n\t\t\tif (closeRequested) return;\n\t\t\tcloseRequested = true;\n\t\t\tclosed = true;\n\t\t\tfor (const request of pending.values())\n\t\t\t\trequest.reject(new McpStdioError(\"MCP transport closed\", \"exit\", { stdout, stderr }));\n\t\t\tpending.clear();\n\t\t\tchild.stdin.end();\n\t\t\tif (!child.killed) child.kill();\n\t\t},\n\t\tget stderr() {\n\t\t\treturn stderr;\n\t\t},\n\t};\n}\n\nfunction validateOptions(options: McpStdioPluginOptions): void {\n\tif (!options.command.trim()) throw new Error(\"MCP stdio command requires a non-empty command\");\n\tif (options.timeoutMs !== undefined && (!Number.isFinite(options.timeoutMs) || options.timeoutMs <= 0)) {\n\t\tthrow new Error(\"MCP stdio timeoutMs must be a positive number\");\n\t}\n}\n\n/** Create an asynchronously discovering MCP stdio capability plugin. */\nexport function createMcpStdioPlugin(options: McpStdioPluginOptions): CapabilityPluginFactory {\n\tvalidateOptions(options);\n\tconst factory = options.transportFactory ?? spawnMcpTransport;\n\treturn async (api: CapabilityAPI) => {\n\t\tconst transport = await factory({\n\t\t\tcommand: options.command,\n\t\t\targs: options.args ?? [],\n\t\t\tcwd: options.cwd,\n\t\t\tenv: options.env,\n\t\t\tonStderr: options.onStderr,\n\t\t});\n\t\ttry {\n\t\t\tasRecord(\n\t\t\t\tawait transport.request(\n\t\t\t\t\t\"initialize\",\n\t\t\t\t\t{\n\t\t\t\t\t\tprotocolVersion: options.protocolVersion ?? \"2024-11-05\",\n\t\t\t\t\t\tcapabilities: {},\n\t\t\t\t\t\tclientInfo: options.clientInfo ?? { name: \"agent-forge-mcp-stdio\", version: \"0.1.0\" },\n\t\t\t\t\t},\n\t\t\t\t\t{ timeoutMs: options.timeoutMs },\n\t\t\t\t),\n\t\t\t\t\"MCP initialize result\",\n\t\t\t);\n\t\t\tawait transport.notify(\"notifications/initialized\");\n\t\t\tconst discovered = validateToolList(\n\t\t\t\tawait transport.request(\"tools/list\", undefined, { timeoutMs: options.timeoutMs }),\n\t\t\t);\n\t\t\tfor (const remote of discovered) {\n\t\t\t\tconst name = remote.name as string;\n\t\t\t\tconst schema = (remote.inputSchema ?? Type.Object({})) as ToolDefinition[\"parameters\"];\n\t\t\t\tconst definition: ToolDefinition = {\n\t\t\t\t\tname,\n\t\t\t\t\tlabel: name,\n\t\t\t\t\tdescription: typeof remote.description === \"string\" ? remote.description : `MCP tool: ${name}`,\n\t\t\t\t\tparameters: schema,\n\t\t\t\t\tasync execute(toolCallId, params, signal, _onUpdate, _ctx: ExtensionContext) {\n\t\t\t\t\t\tconst input = params === undefined && typeof toolCallId !== \"string\" ? toolCallId : params;\n\t\t\t\t\t\tconst result = await transport.request(\n\t\t\t\t\t\t\t\"tools/call\",\n\t\t\t\t\t\t\t{ name, arguments: input ?? {} },\n\t\t\t\t\t\t\t{ signal, timeoutMs: options.timeoutMs },\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn normalizeToolResult(result);\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\tapi.registerTool(definition);\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tdispose: async () => {\n\t\t\t\t\tawait transport.close();\n\t\t\t\t},\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tawait transport.close();\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n\n/**\n * Template entry only. A working MCP transport needs a user-selected command,\n * arguments, and timeout; never launch an unconfigured child process.\n */\nexport default function mcpStdioExample(_api: CapabilityAPI): never {\n\tthrow new Error(\n\t\t\"Configure createMcpStdioPlugin({ command, args, timeoutMs }) before installing this MCP stdio example.\",\n\t);\n}\n"]}

package/examples/extensions/mcp-stdio/index.js

@@ -0,0 +1,292 @@
+/**
+ * MCP-like JSON-RPC 2.0 stdio bridge.
+ *
+ * This is intentionally an external capability plugin. It discovers tools
+ * from one explicitly configured process and exposes them through the public
+ * CapabilityAPI; policy, approval, and server selection remain host-owned.
+ */
+import { spawn } from "node:child_process";
+import { Type } from "typebox";
+export class McpStdioError extends Error {
+    reason;
+    details;
+    constructor(message, reason, details = {}) {
+        super(message);
+        this.name = "McpStdioError";
+        this.reason = reason;
+        this.details = details;
+    }
+}
+const noResult = () => ({ content: [{ type: "text", text: "" }], details: undefined });
+function asRecord(value, label) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new McpStdioError(`${label} must be an object`, "malformed", { data: value });
+    }
+    return value;
+}
+function validateToolList(value) {
+    const object = asRecord(value, "MCP tools/list result");
+    if (!Array.isArray(object.tools)) {
+        throw new McpStdioError("MCP tools/list result must contain tools[]", "malformed", { data: value });
+    }
+    return object.tools.map((tool, index) => {
+        const record = asRecord(tool, `MCP tool at index ${index}`);
+        if (typeof record.name !== "string" || !record.name.trim()) {
+            throw new McpStdioError(`MCP tool at index ${index} requires a non-empty name`, "malformed", { data: tool });
+        }
+        if (record.inputSchema !== undefined && (typeof record.inputSchema !== "object" || record.inputSchema === null)) {
+            throw new McpStdioError(`MCP tool has an invalid inputSchema: ${record.name}`, "malformed", { data: tool });
+        }
+        return record;
+    });
+}
+function normalizeToolResult(value) {
+    if (value && typeof value === "object" && Array.isArray(value.content)) {
+        return value;
+    }
+    if (value === undefined)
+        return noResult();
+    return {
+        content: [{ type: "text", text: typeof value === "string" ? value : JSON.stringify(value) }],
+        details: undefined,
+    };
+}
+/** Default line-delimited stdio transport. The command is never passed to a shell. */
+export function spawnMcpTransport(config) {
+    const child = spawn(config.command, [...config.args], {
+        cwd: config.cwd,
+        env: config.env,
+        shell: false,
+        stdio: ["pipe", "pipe", "pipe"],
+    });
+    return createJsonRpcTransport(child, config.onStderr);
+}
+function createJsonRpcTransport(child, onStderr) {
+    let nextId = 1;
+    let closed = false;
+    let stdout = "";
+    let stderr = "";
+    let closeRequested = false;
+    const pending = new Map();
+    const ignored = new Set();
+    let fatalError;
+    const failAll = (error) => {
+        if (fatalError)
+            return;
+        fatalError = error;
+        closed = true;
+        for (const request of pending.values())
+            request.reject(error);
+        pending.clear();
+    };
+    child.stdout.setEncoding("utf8");
+    child.stdout.on("data", (chunk) => {
+        stdout += chunk;
+        const lines = stdout.split(/\r?\n/);
+        stdout = lines.pop() ?? "";
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                failAll(new McpStdioError("Malformed JSON-RPC response", "malformed", { stdout: line, stderr }));
+                return;
+            }
+            if (parsed.jsonrpc !== "2.0") {
+                failAll(new McpStdioError("Invalid JSON-RPC response envelope", "protocol", { data: parsed, stderr }));
+                return;
+            }
+            if (parsed.id === undefined) {
+                if (typeof parsed.method === "string")
+                    continue;
+                failAll(new McpStdioError("JSON-RPC response is missing an id", "protocol", { data: parsed, stderr }));
+                return;
+            }
+            if (typeof parsed.id !== "number" && parsed.id !== null) {
+                failAll(new McpStdioError("Invalid JSON-RPC response id", "protocol", { data: parsed, stderr }));
+                return;
+            }
+            if (parsed.id === null)
+                continue;
+            const responseId = parsed.id;
+            if (ignored.delete(responseId))
+                continue;
+            const request = pending.get(responseId);
+            if (!request) {
+                failAll(new McpStdioError(`Unknown JSON-RPC response id: ${responseId}`, "protocol", { data: parsed, stderr }));
+                return;
+            }
+            pending.delete(responseId);
+            if (parsed.error) {
+                const message = typeof parsed.error.message === "string" ? parsed.error.message : "MCP request failed";
+                request.reject(new McpStdioError(message, "remote", {
+                    method: request.method,
+                    requestId: responseId,
+                    data: parsed.error,
+                    stderr,
+                }));
+            }
+            else if (!("result" in parsed)) {
+                request.reject(new McpStdioError("JSON-RPC response has neither result nor error", "protocol", {
+                    method: request.method,
+                    requestId: responseId,
+                    data: parsed,
+                    stderr,
+                }));
+            }
+            else {
+                request.resolve(parsed.result);
+            }
+        }
+    });
+    child.stderr.setEncoding("utf8");
+    child.stderr.on("data", (chunk) => {
+        stderr += chunk;
+        onStderr?.(chunk);
+    });
+    child.once("error", (error) => {
+        failAll(new McpStdioError(`Failed to spawn MCP process: ${error.message}`, "spawn", { stdout, stderr }));
+    });
+    child.once("close", (exitCode) => {
+        if (closed)
+            return;
+        failAll(new McpStdioError(`MCP process exited with code ${exitCode ?? "unknown"}`, "exit", {
+            stdout,
+            stderr,
+            exitCode,
+        }));
+    });
+    const request = (method, params, options = {}) => {
+        if (fatalError || closed)
+            return Promise.reject(fatalError ?? new McpStdioError("MCP transport is closed", "exit", { stderr }));
+        if (options.signal?.aborted)
+            return Promise.reject(new McpStdioError("MCP request aborted", "aborted", { method, stderr }));
+        const id = nextId++;
+        return new Promise((resolve, reject) => {
+            let timeout;
+            const abort = () => {
+                if (!pending.delete(id))
+                    return;
+                ignored.add(id);
+                if (timeout)
+                    clearTimeout(timeout);
+                reject(new McpStdioError("MCP request aborted", "aborted", { method, requestId: id, stderr }));
+            };
+            pending.set(id, {
+                method,
+                resolve: (result) => {
+                    if (timeout)
+                        clearTimeout(timeout);
+                    options.signal?.removeEventListener("abort", abort);
+                    resolve(result);
+                },
+                reject: (error) => {
+                    if (timeout)
+                        clearTimeout(timeout);
+                    options.signal?.removeEventListener("abort", abort);
+                    reject(error);
+                },
+            });
+            options.signal?.addEventListener("abort", abort, { once: true });
+            if (options.timeoutMs !== undefined) {
+                timeout = setTimeout(() => {
+                    if (!pending.delete(id))
+                        return;
+                    ignored.add(id);
+                    options.signal?.removeEventListener("abort", abort);
+                    reject(new McpStdioError("MCP request timed out", "timed_out", { method, requestId: id, stderr }));
+                }, options.timeoutMs);
+            }
+            child.stdin.write(`${JSON.stringify({ jsonrpc: "2.0", id, method, ...(params === undefined ? {} : { params }) })}\n`);
+        });
+    };
+    return {
+        request,
+        notify(method, params) {
+            if (fatalError || closed)
+                throw fatalError ?? new McpStdioError("MCP transport is closed", "exit", { stderr });
+            child.stdin.write(`${JSON.stringify({ jsonrpc: "2.0", method, ...(params === undefined ? {} : { params }) })}\n`);
+        },
+        close() {
+            if (closeRequested)
+                return;
+            closeRequested = true;
+            closed = true;
+            for (const request of pending.values())
+                request.reject(new McpStdioError("MCP transport closed", "exit", { stdout, stderr }));
+            pending.clear();
+            child.stdin.end();
+            if (!child.killed)
+                child.kill();
+        },
+        get stderr() {
+            return stderr;
+        },
+    };
+}
+function validateOptions(options) {
+    if (!options.command.trim())
+        throw new Error("MCP stdio command requires a non-empty command");
+    if (options.timeoutMs !== undefined && (!Number.isFinite(options.timeoutMs) || options.timeoutMs <= 0)) {
+        throw new Error("MCP stdio timeoutMs must be a positive number");
+    }
+}
+/** Create an asynchronously discovering MCP stdio capability plugin. */
+export function createMcpStdioPlugin(options) {
+    validateOptions(options);
+    const factory = options.transportFactory ?? spawnMcpTransport;
+    return async (api) => {
+        const transport = await factory({
+            command: options.command,
+            args: options.args ?? [],
+            cwd: options.cwd,
+            env: options.env,
+            onStderr: options.onStderr,
+        });
+        try {
+            asRecord(await transport.request("initialize", {
+                protocolVersion: options.protocolVersion ?? "2024-11-05",
+                capabilities: {},
+                clientInfo: options.clientInfo ?? { name: "agent-forge-mcp-stdio", version: "0.1.0" },
+            }, { timeoutMs: options.timeoutMs }), "MCP initialize result");
+            await transport.notify("notifications/initialized");
+            const discovered = validateToolList(await transport.request("tools/list", undefined, { timeoutMs: options.timeoutMs }));
+            for (const remote of discovered) {
+                const name = remote.name;
+                const schema = (remote.inputSchema ?? Type.Object({}));
+                const definition = {
+                    name,
+                    label: name,
+                    description: typeof remote.description === "string" ? remote.description : `MCP tool: ${name}`,
+                    parameters: schema,
+                    async execute(toolCallId, params, signal, _onUpdate, _ctx) {
+                        const input = params === undefined && typeof toolCallId !== "string" ? toolCallId : params;
+                        const result = await transport.request("tools/call", { name, arguments: input ?? {} }, { signal, timeoutMs: options.timeoutMs });
+                        return normalizeToolResult(result);
+                    },
+                };
+                api.registerTool(definition);
+            }
+            return {
+                dispose: async () => {
+                    await transport.close();
+                },
+            };
+        }
+        catch (error) {
+            await transport.close();
+            throw error;
+        }
+    };
+}
+/**
+ * Template entry only. A working MCP transport needs a user-selected command,
+ * arguments, and timeout; never launch an unconfigured child process.
+ */
+export default function mcpStdioExample(_api) {
+    throw new Error("Configure createMcpStdioPlugin({ command, args, timeoutMs }) before installing this MCP stdio example.");
+}
+//# sourceMappingURL=index.js.map

package/examples/extensions/mcp-stdio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCP-like JSON-RPC 2.0 stdio bridge.\n *\n * This is intentionally an external capability plugin. It discovers tools\n * from one explicitly configured process and exposes them through the public\n * CapabilityAPI; policy, approval, and server selection remain host-owned.\n */\n\nimport type { ChildProcessWithoutNullStreams } from \"node:child_process\";\nimport { spawn } from \"node:child_process\";\nimport type { AgentToolResult } from \"@agent-forge/agent-core\";\nimport type {\n\tCapabilityAPI,\n\tCapabilityPluginFactory,\n\tExtensionContext,\n\tToolDefinition,\n} from \"@agent-forge/coding-agent\";\nimport { Type } from \"typebox\";\n\nexport type McpErrorReason = \"spawn\" | \"exit\" | \"malformed\" | \"protocol\" | \"remote\" | \"aborted\" | \"timed_out\";\n\nexport interface McpErrorDetails {\n\tmethod?: string;\n\trequestId?: number;\n\tstdout?: string;\n\tstderr?: string;\n\texitCode?: number | null;\n\tdata?: unknown;\n}\n\nexport class McpStdioError extends Error {\n\treadonly reason: McpErrorReason;\n\treadonly details: McpErrorDetails;\n\n\tconstructor(message: string, reason: McpErrorReason, details: McpErrorDetails = {}) {\n\t\tsuper(message);\n\t\tthis.name = \"McpStdioError\";\n\t\tthis.reason = reason;\n\t\tthis.details = details;\n\t}\n}\n\nexport interface McpRequestOptions {\n\tsignal?: AbortSignal;\n\ttimeoutMs?: number;\n}\n\nexport interface McpStdioTransport {\n\trequest(method: string, params?: unknown, options?: McpRequestOptions): Promise<unknown>;\n\tnotify(method: string, params?: unknown): Promise<void> | void;\n\tclose(): Promise<void> | void;\n\treadonly stderr?: string;\n}\n\nexport interface McpStdioTransportConfig {\n\tcommand: string;\n\targs: readonly string[];\n\tcwd?: string;\n\tenv?: NodeJS.ProcessEnv;\n\tonStderr?: (text: string) => void;\n}\n\nexport type McpStdioTransportFactory = (\n\tconfig: McpStdioTransportConfig,\n) => McpStdioTransport | Promise<McpStdioTransport>;\n\nexport interface McpStdioPluginOptions {\n\tcommand: string;\n\targs?: readonly string[];\n\tcwd?: string;\n\tenv?: NodeJS.ProcessEnv;\n\ttimeoutMs?: number;\n\ttransportFactory?: McpStdioTransportFactory;\n\tonStderr?: (text: string) => void;\n\tprotocolVersion?: string;\n\tclientInfo?: { name: string; version: string };\n}\n\ninterface JsonRpcResponse {\n\tjsonrpc?: unknown;\n\tid?: unknown;\n\tmethod?: unknown;\n\tresult?: unknown;\n\terror?: { code?: unknown; message?: unknown; data?: unknown };\n}\n\nconst noResult = (): AgentToolResult<unknown> => ({ content: [{ type: \"text\", text: \"\" }], details: undefined });\n\nfunction asRecord(value: unknown, label: string): Record<string, unknown> {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) {\n\t\tthrow new McpStdioError(`${label} must be an object`, \"malformed\", { data: value });\n\t}\n\treturn value as Record<string, unknown>;\n}\n\nfunction validateToolList(value: unknown): readonly Record<string, unknown>[] {\n\tconst object = asRecord(value, \"MCP tools/list result\");\n\tif (!Array.isArray(object.tools)) {\n\t\tthrow new McpStdioError(\"MCP tools/list result must contain tools[]\", \"malformed\", { data: value });\n\t}\n\treturn object.tools.map((tool, index) => {\n\t\tconst record = asRecord(tool, `MCP tool at index ${index}`);\n\t\tif (typeof record.name !== \"string\" || !record.name.trim()) {\n\t\t\tthrow new McpStdioError(`MCP tool at index ${index} requires a non-empty name`, \"malformed\", { data: tool });\n\t\t}\n\t\tif (record.inputSchema !== undefined && (typeof record.inputSchema !== \"object\" || record.inputSchema === null)) {\n\t\t\tthrow new McpStdioError(`MCP tool has an invalid inputSchema: ${record.name}`, \"malformed\", { data: tool });\n\t\t}\n\t\treturn record;\n\t});\n}\n\nfunction normalizeToolResult(value: unknown): AgentToolResult<unknown> {\n\tif (value && typeof value === \"object\" && Array.isArray((value as { content?: unknown }).content)) {\n\t\treturn value as AgentToolResult<unknown>;\n\t}\n\tif (value === undefined) return noResult();\n\treturn {\n\t\tcontent: [{ type: \"text\", text: typeof value === \"string\" ? value : JSON.stringify(value) }],\n\t\tdetails: undefined,\n\t};\n}\n\n/** Default line-delimited stdio transport. The command is never passed to a shell. */\nexport function spawnMcpTransport(config: McpStdioTransportConfig): McpStdioTransport {\n\tconst child = spawn(config.command, [...config.args], {\n\t\tcwd: config.cwd,\n\t\tenv: config.env,\n\t\tshell: false,\n\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t});\n\treturn createJsonRpcTransport(child, config.onStderr);\n}\n\nfunction createJsonRpcTransport(\n\tchild: ChildProcessWithoutNullStreams,\n\tonStderr?: (text: string) => void,\n): McpStdioTransport {\n\tlet nextId = 1;\n\tlet closed = false;\n\tlet stdout = \"\";\n\tlet stderr = \"\";\n\tlet closeRequested = false;\n\tconst pending = new Map<\n\t\tnumber,\n\t\t{ method: string; resolve: (value: unknown) => void; reject: (error: unknown) => void }\n\t>();\n\tconst ignored = new Set<number>();\n\tlet fatalError: McpStdioError | undefined;\n\n\tconst failAll = (error: McpStdioError): void => {\n\t\tif (fatalError) return;\n\t\tfatalError = error;\n\t\tclosed = true;\n\t\tfor (const request of pending.values()) request.reject(error);\n\t\tpending.clear();\n\t};\n\n\tchild.stdout.setEncoding(\"utf8\");\n\tchild.stdout.on(\"data\", (chunk: string) => {\n\t\tstdout += chunk;\n\t\tconst lines = stdout.split(/\\r?\\n/);\n\t\tstdout = lines.pop() ?? \"\";\n\t\tfor (const line of lines) {\n\t\t\tif (!line.trim()) continue;\n\t\t\tlet parsed: JsonRpcResponse;\n\t\t\ttry {\n\t\t\t\tparsed = JSON.parse(line) as JsonRpcResponse;\n\t\t\t} catch {\n\t\t\t\tfailAll(new McpStdioError(\"Malformed JSON-RPC response\", \"malformed\", { stdout: line, stderr }));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (parsed.jsonrpc !== \"2.0\") {\n\t\t\t\tfailAll(new McpStdioError(\"Invalid JSON-RPC response envelope\", \"protocol\", { data: parsed, stderr }));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (parsed.id === undefined) {\n\t\t\t\tif (typeof parsed.method === \"string\") continue;\n\t\t\t\tfailAll(new McpStdioError(\"JSON-RPC response is missing an id\", \"protocol\", { data: parsed, stderr }));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (typeof parsed.id !== \"number\" && parsed.id !== null) {\n\t\t\t\tfailAll(new McpStdioError(\"Invalid JSON-RPC response id\", \"protocol\", { data: parsed, stderr }));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (parsed.id === null) continue;\n\t\t\tconst responseId = parsed.id as number;\n\t\t\tif (ignored.delete(responseId)) continue;\n\t\t\tconst request = pending.get(responseId);\n\t\t\tif (!request) {\n\t\t\t\tfailAll(\n\t\t\t\t\tnew McpStdioError(`Unknown JSON-RPC response id: ${responseId}`, \"protocol\", { data: parsed, stderr }),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tpending.delete(responseId);\n\t\t\tif (parsed.error) {\n\t\t\t\tconst message = typeof parsed.error.message === \"string\" ? parsed.error.message : \"MCP request failed\";\n\t\t\t\trequest.reject(\n\t\t\t\t\tnew McpStdioError(message, \"remote\", {\n\t\t\t\t\t\tmethod: request.method,\n\t\t\t\t\t\trequestId: responseId,\n\t\t\t\t\t\tdata: parsed.error,\n\t\t\t\t\t\tstderr,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t} else if (!(\"result\" in parsed)) {\n\t\t\t\trequest.reject(\n\t\t\t\t\tnew McpStdioError(\"JSON-RPC response has neither result nor error\", \"protocol\", {\n\t\t\t\t\t\tmethod: request.method,\n\t\t\t\t\t\trequestId: responseId,\n\t\t\t\t\t\tdata: parsed,\n\t\t\t\t\t\tstderr,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t} else {\n\t\t\t\trequest.resolve(parsed.result);\n\t\t\t}\n\t\t}\n\t});\n\tchild.stderr.setEncoding(\"utf8\");\n\tchild.stderr.on(\"data\", (chunk: string) => {\n\t\tstderr += chunk;\n\t\tonStderr?.(chunk);\n\t});\n\tchild.once(\"error\", (error) => {\n\t\tfailAll(new McpStdioError(`Failed to spawn MCP process: ${error.message}`, \"spawn\", { stdout, stderr }));\n\t});\n\tchild.once(\"close\", (exitCode) => {\n\t\tif (closed) return;\n\t\tfailAll(\n\t\t\tnew McpStdioError(`MCP process exited with code ${exitCode ?? \"unknown\"}`, \"exit\", {\n\t\t\t\tstdout,\n\t\t\t\tstderr,\n\t\t\t\texitCode,\n\t\t\t}),\n\t\t);\n\t});\n\n\tconst request = (method: string, params?: unknown, options: McpRequestOptions = {}): Promise<unknown> => {\n\t\tif (fatalError || closed)\n\t\t\treturn Promise.reject(fatalError ?? new McpStdioError(\"MCP transport is closed\", \"exit\", { stderr }));\n\t\tif (options.signal?.aborted)\n\t\t\treturn Promise.reject(new McpStdioError(\"MCP request aborted\", \"aborted\", { method, stderr }));\n\t\tconst id = nextId++;\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tlet timeout: NodeJS.Timeout | undefined;\n\t\t\tconst abort = (): void => {\n\t\t\t\tif (!pending.delete(id)) return;\n\t\t\t\tignored.add(id);\n\t\t\t\tif (timeout) clearTimeout(timeout);\n\t\t\t\treject(new McpStdioError(\"MCP request aborted\", \"aborted\", { method, requestId: id, stderr }));\n\t\t\t};\n\t\t\tpending.set(id, {\n\t\t\t\tmethod,\n\t\t\t\tresolve: (result) => {\n\t\t\t\t\tif (timeout) clearTimeout(timeout);\n\t\t\t\t\toptions.signal?.removeEventListener(\"abort\", abort);\n\t\t\t\t\tresolve(result);\n\t\t\t\t},\n\t\t\t\treject: (error) => {\n\t\t\t\t\tif (timeout) clearTimeout(timeout);\n\t\t\t\t\toptions.signal?.removeEventListener(\"abort\", abort);\n\t\t\t\t\treject(error);\n\t\t\t\t},\n\t\t\t});\n\t\t\toptions.signal?.addEventListener(\"abort\", abort, { once: true });\n\t\t\tif (options.timeoutMs !== undefined) {\n\t\t\t\ttimeout = setTimeout(() => {\n\t\t\t\t\tif (!pending.delete(id)) return;\n\t\t\t\t\tignored.add(id);\n\t\t\t\t\toptions.signal?.removeEventListener(\"abort\", abort);\n\t\t\t\t\treject(new McpStdioError(\"MCP request timed out\", \"timed_out\", { method, requestId: id, stderr }));\n\t\t\t\t}, options.timeoutMs);\n\t\t\t}\n\t\t\tchild.stdin.write(\n\t\t\t\t`${JSON.stringify({ jsonrpc: \"2.0\", id, method, ...(params === undefined ? {} : { params }) })}\\n`,\n\t\t\t);\n\t\t});\n\t};\n\treturn {\n\t\trequest,\n\t\tnotify(method, params) {\n\t\t\tif (fatalError || closed) throw fatalError ?? new McpStdioError(\"MCP transport is closed\", \"exit\", { stderr });\n\t\t\tchild.stdin.write(\n\t\t\t\t`${JSON.stringify({ jsonrpc: \"2.0\", method, ...(params === undefined ? {} : { params }) })}\\n`,\n\t\t\t);\n\t\t},\n\t\tclose() {\n\t\t\tif (closeRequested) return;\n\t\t\tcloseRequested = true;\n\t\t\tclosed = true;\n\t\t\tfor (const request of pending.values())\n\t\t\t\trequest.reject(new McpStdioError(\"MCP transport closed\", \"exit\", { stdout, stderr }));\n\t\t\tpending.clear();\n\t\t\tchild.stdin.end();\n\t\t\tif (!child.killed) child.kill();\n\t\t},\n\t\tget stderr() {\n\t\t\treturn stderr;\n\t\t},\n\t};\n}\n\nfunction validateOptions(options: McpStdioPluginOptions): void {\n\tif (!options.command.trim()) throw new Error(\"MCP stdio command requires a non-empty command\");\n\tif (options.timeoutMs !== undefined && (!Number.isFinite(options.timeoutMs) || options.timeoutMs <= 0)) {\n\t\tthrow new Error(\"MCP stdio timeoutMs must be a positive number\");\n\t}\n}\n\n/** Create an asynchronously discovering MCP stdio capability plugin. */\nexport function createMcpStdioPlugin(options: McpStdioPluginOptions): CapabilityPluginFactory {\n\tvalidateOptions(options);\n\tconst factory = options.transportFactory ?? spawnMcpTransport;\n\treturn async (api: CapabilityAPI) => {\n\t\tconst transport = await factory({\n\t\t\tcommand: options.command,\n\t\t\targs: options.args ?? [],\n\t\t\tcwd: options.cwd,\n\t\t\tenv: options.env,\n\t\t\tonStderr: options.onStderr,\n\t\t});\n\t\ttry {\n\t\t\tasRecord(\n\t\t\t\tawait transport.request(\n\t\t\t\t\t\"initialize\",\n\t\t\t\t\t{\n\t\t\t\t\t\tprotocolVersion: options.protocolVersion ?? \"2024-11-05\",\n\t\t\t\t\t\tcapabilities: {},\n\t\t\t\t\t\tclientInfo: options.clientInfo ?? { name: \"agent-forge-mcp-stdio\", version: \"0.1.0\" },\n\t\t\t\t\t},\n\t\t\t\t\t{ timeoutMs: options.timeoutMs },\n\t\t\t\t),\n\t\t\t\t\"MCP initialize result\",\n\t\t\t);\n\t\t\tawait transport.notify(\"notifications/initialized\");\n\t\t\tconst discovered = validateToolList(\n\t\t\t\tawait transport.request(\"tools/list\", undefined, { timeoutMs: options.timeoutMs }),\n\t\t\t);\n\t\t\tfor (const remote of discovered) {\n\t\t\t\tconst name = remote.name as string;\n\t\t\t\tconst schema = (remote.inputSchema ?? Type.Object({})) as ToolDefinition[\"parameters\"];\n\t\t\t\tconst definition: ToolDefinition = {\n\t\t\t\t\tname,\n\t\t\t\t\tlabel: name,\n\t\t\t\t\tdescription: typeof remote.description === \"string\" ? remote.description : `MCP tool: ${name}`,\n\t\t\t\t\tparameters: schema,\n\t\t\t\t\tasync execute(toolCallId, params, signal, _onUpdate, _ctx: ExtensionContext) {\n\t\t\t\t\t\tconst input = params === undefined && typeof toolCallId !== \"string\" ? toolCallId : params;\n\t\t\t\t\t\tconst result = await transport.request(\n\t\t\t\t\t\t\t\"tools/call\",\n\t\t\t\t\t\t\t{ name, arguments: input ?? {} },\n\t\t\t\t\t\t\t{ signal, timeoutMs: options.timeoutMs },\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn normalizeToolResult(result);\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t\tapi.registerTool(definition);\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tdispose: async () => {\n\t\t\t\t\tawait transport.close();\n\t\t\t\t},\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tawait transport.close();\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n\n/**\n * Template entry only. A working MCP transport needs a user-selected command,\n * arguments, and timeout; never launch an unconfigured child process.\n */\nexport default function mcpStdioExample(_api: CapabilityAPI): never {\n\tthrow new Error(\n\t\t\"Configure createMcpStdioPlugin({ command, args, timeoutMs }) before installing this MCP stdio example.\",\n\t);\n}\n"]}

package/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "agent-forge-extension-with-deps",
-  "version": "0.87.2",
+  "version": "0.88.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "agent-forge-extension-with-deps",
-      "version": "0.87.2",
+      "version": "0.88.3",
       "dependencies": {
         "ms": "^2.1.3"
       },

package/examples/extensions/with-deps/package.json

@@ -1,18 +1,13 @@
 {
   "name": "agent-forge-extension-with-deps",
   "private": true,
-  "version": "0.87.2",
+  "version": "0.88.3",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",
     "build": "echo 'nothing to build'",
     "check": "echo 'nothing to check'"
   },
-  "pi": {
-    "extensions": [
-      "./index.ts"
-    ]
-  },
   "dependencies": {
     "ms": "2.1.3"
   },

package/examples/extensions/with-deps/plugin.json

@@ -1,6 +1,6 @@
 {
 	"id": "agent-forge.example.with-deps",
-	"version": "0.87.2",
+	"version": "0.88.3",
 	"hostVersion": ">=0.84.0",
 	"apiVersion": "1-draft",
 	"entry": "./index.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ai-agent-forge/agent-forge",
-	"version": "0.88.2",
+	"version": "0.88.3",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"agentForgeConfig": {
@@ -41,7 +41,7 @@
 		"clean": "shx rm -rf dist",
 		"build": "npm run build:unbundled && node ../../scripts/build-agent-forge-bundle.mjs",
 		"build:unbundled": "npm run clean && tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js dist/rpc-entry.js && npm run copy-assets",
-		"copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/",
+		"copy-assets": "shx mkdir -p dist/theme && shx cp src/theme/*.json dist/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/export-html/vendor && shx cp src/export-html/template.html src/export-html/template.css src/export-html/template.js dist/export-html/ && shx cp src/export-html/vendor/*.js dist/export-html/vendor/",
 		"test": "vitest --run",
 		"shrinkwrap": "node ../../scripts/generate-agent-forge-shrinkwrap.mjs",
 		"prepublishOnly": "npm run clean && npm run build && npm run shrinkwrap",

package/dist/bundle/chunks/openai-responses-AUJQ3NWT.js

@@ -1,2 +0,0 @@
-import { createRequire as __piCreateRequire } from "node:module"; const require = __piCreateRequire(import.meta.url);
-import{convertResponsesMessages,convertResponsesTools,processResponsesStream}from"./chunk-HTEVUY7F.js";import{clampOpenAIPromptCacheKey}from"./chunk-PRRNXB7S.js";import{OpenAI}from"./chunk-OO6DJ3CL.js";import{formatProviderError,normalizeProviderError}from"./chunk-TEPMHNKQ.js";import"./chunk-PJACZCIR.js";import{splitDeferredTools}from"./chunk-GMWCTUPB.js";import{buildCopilotDynamicHeaders,hasCopilotVisionInput}from"./chunk-PGXDEOVV.js";import{retryProviderRequest}from"./chunk-WW3LMV3F.js";import"./chunk-EWXX34QG.js";import{buildBaseOptions,createGrammarToolInputProperties,getPiUserAgent}from"./chunk-TBPTHASB.js";import"./chunk-L2ZPNLYD.js";import{headersToRecord}from"./chunk-6R7UI4IY.js";import{getProviderEnvValue}from"./chunk-DRQDKNXA.js";import"./chunk-TRDNDS6A.js";import{clampThinkingLevel}from"./chunk-HV64ASMT.js";import{AssistantMessageEventStream}from"./chunk-A3JYRWB6.js";import"./chunk-4L3WN2XY.js";var OPENAI_TOOL_CALL_PROVIDERS=new Set(["openai","openai-codex","opencode"]),OPENAI_RESPONSES_MIN_OUTPUT_TOKENS=16;function hasHeader(headers,name){if(!headers)return!1;let expected=name.toLowerCase();for(let[key,value]of Object.entries(headers))if(key.toLowerCase()===expected&&value!==null&&value.trim().length>0)return!0;return!1}function getClientApiKey(provider,apiKey,headers){if(apiKey)return apiKey;if(hasHeader(headers,"authorization")||hasHeader(headers,"cf-aig-authorization"))return"unused";throw new Error(`No API key for provider: ${provider}`)}function detectSessionAffinityFormat(model){return model.provider==="openrouter"||model.baseUrl.includes("openrouter.ai")?"openrouter":"openai"}function resolveCacheRetention(cacheRetention,env){return cacheRetention||(getProviderEnvValue("AGENT_FORGE_CACHE_RETENTION",env)==="long"?"long":"short")}function getCompat(model){return{supportsDeveloperRole:model.compat?.supportsDeveloperRole??!0,sessionAffinityFormat:model.compat?.sessionAffinityFormat??detectSessionAffinityFormat(model),supportsLongCacheRetention:model.compat?.supportsLongCacheRetention??!0,supportsStrictMode:model.compat?.supportsStrictMode??!1,supportsOpenAIGrammarTools:model.compat?.supportsOpenAIGrammarTools??!1,supportsAdditionalTools:model.compat?.supportsAdditionalTools??!1,supportsToolSearch:model.compat?.supportsToolSearch??!1,supportsExplicitPromptCacheMode:model.compat?.supportsExplicitPromptCacheMode??!1,supportsMaxOutputTokens:model.compat?.supportsMaxOutputTokens??!0}}function getPromptCacheRetention(compat,cacheRetention){return cacheRetention==="long"&&compat.supportsLongCacheRetention&&!compat.supportsExplicitPromptCacheMode?"24h":void 0}function getPromptCacheOptions(compat,cacheRetention){if(compat.supportsExplicitPromptCacheMode){if(cacheRetention==="none")return{mode:"explicit"};if(cacheRetention==="long"&&compat.supportsLongCacheRetention)return{ttl:"30m"}}}var stream=(model,context,options)=>{let stream2=new AssistantMessageEventStream;return(async()=>{let output={role:"assistant",content:[],api:model.api,provider:model.provider,model:model.id,usage:{input:0,output:0,cacheRead:0,cacheWrite:0,totalTokens:0,cost:{input:0,output:0,cacheRead:0,cacheWrite:0,total:0}},stopReason:"pending",timestamp:Date.now()};try{let apiKey=getClientApiKey(model.provider,options?.apiKey,options?.headers),cacheSessionId=resolveCacheRetention(options?.cacheRetention,options?.env)==="none"?void 0:options?.sessionId,compat=getCompat(model),grammarToolInputProperties=createGrammarToolInputProperties(context.tools,compat.supportsOpenAIGrammarTools),client=createClient(model,context,apiKey,options?.headers,options?.fetch,cacheSessionId),params=buildParams(model,context,options,compat,grammarToolInputProperties),nextParams=await options?.onPayload?.(params,model);nextParams!==void 0&&(params=nextParams);let requestOptions={...options?.signal?{signal:options.signal}:{},...options?.timeoutMs!==void 0?{timeout:options.timeoutMs}:{},maxRetries:0},{data:openaiStream,response}=await retryProviderRequest(()=>client.responses.create(params,requestOptions).withResponse(),{maxRetries:options?.maxRetries,maxRetryDelayMs:options?.maxRetryDelayMs,signal:options?.signal});if(await options?.onResponse?.({status:response.status,headers:headersToRecord(response.headers)},model),stream2.push({type:"start",partial:output}),await processResponsesStream(openaiStream,output,stream2,model,{serviceTier:options?.serviceTier,grammarToolInputProperties,applyServiceTierPricing:(usage,serviceTier)=>applyServiceTierPricing(usage,serviceTier,model)}),options?.signal?.aborted)throw new Error("Request was aborted");if(output.stopReason==="pending")throw new Error("OpenAI Responses stream ended without a stop reason");if(output.stopReason==="aborted"||output.stopReason==="error")throw new Error(output.errorMessage||"An unknown error occurred");stream2.push({type:"done",reason:output.stopReason,message:output}),stream2.end()}catch(error){for(let block of output.content)delete block.index,delete block.partialJson,delete block.customInput;output.stopReason=options?.signal?.aborted?"aborted":"error",output.errorMessage=formatProviderError(normalizeProviderError(error),`${model.provider==="openai"?"OpenAI":model.provider} API error`),stream2.push({type:"error",reason:output.stopReason,error:output}),stream2.end()}})(),stream2},streamSimple=(model,context,options)=>{getClientApiKey(model.provider,options?.apiKey,options?.headers);let base={...buildBaseOptions(model,context,options,options?.apiKey),toolChoice:options?.toolChoice},clampedReasoning=options?.reasoning?clampThinkingLevel(model,options.reasoning):void 0;return stream(model,context,{...base,reasoningEffort:clampedReasoning==="off"?void 0:clampedReasoning})};function createClient(model,context,apiKey,optionsHeaders,fetch,sessionId){let compat=getCompat(model),headers={"User-Agent":getPiUserAgent(),...model.headers};if(model.provider==="github-copilot"){let hasImages=hasCopilotVisionInput(context.messages),copilotHeaders=buildCopilotDynamicHeaders({messages:context.messages,hasImages});Object.assign(headers,copilotHeaders)}return sessionId&&(compat.sessionAffinityFormat==="openrouter"?headers["x-session-id"]=sessionId:(compat.sessionAffinityFormat==="openai"&&(headers.session_id=sessionId),headers["x-client-request-id"]=sessionId)),optionsHeaders&&Object.assign(headers,optionsHeaders),new OpenAI({apiKey,baseURL:model.baseUrl,dangerouslyAllowBrowser:!0,fetch,defaultHeaders:headers})}function buildParams(model,context,options,compat=getCompat(model),grammarToolInputProperties=createGrammarToolInputProperties(context.tools,compat.supportsOpenAIGrammarTools)){let deferredToolsMode=compat.supportsAdditionalTools?"additional-tools":compat.supportsToolSearch?"tool-search":void 0,toolPlacement=splitDeferredTools(context,deferredToolsMode!==void 0),messages=convertResponsesMessages(model,context,OPENAI_TOOL_CALL_PROVIDERS,{grammarToolInputProperties,deferredTools:toolPlacement.deferred,deferredToolsMode,toolOptions:{supportsStrictMode:compat.supportsStrictMode,supportsOpenAIGrammarTools:compat.supportsOpenAIGrammarTools}}),cacheRetention=resolveCacheRetention(options?.cacheRetention,options?.env),params={model:model.id,input:messages,stream:!0,prompt_cache_key:cacheRetention==="none"?void 0:clampOpenAIPromptCacheKey(options?.sessionId),prompt_cache_retention:getPromptCacheRetention(compat,cacheRetention),prompt_cache_options:getPromptCacheOptions(compat,cacheRetention),store:!1};if(options?.maxTokens&&compat.supportsMaxOutputTokens&&(params.max_output_tokens=Math.max(options.maxTokens,OPENAI_RESPONSES_MIN_OUTPUT_TOKENS)),options?.temperature!==void 0&&(params.temperature=options?.temperature),options?.serviceTier!==void 0&&(params.service_tier=options.serviceTier),toolPlacement.immediate.length>0&&(params.tools=convertResponsesTools(toolPlacement.immediate,{supportsStrictMode:compat.supportsStrictMode,supportsOpenAIGrammarTools:compat.supportsOpenAIGrammarTools})),options?.toolChoice!==void 0&&(params.tool_choice=options.toolChoice),model.reasoning){if(options?.reasoningEffort||options?.reasoningSummary){let effort=options?.reasoningEffort?model.thinkingLevelMap?.[options.reasoningEffort]??options.reasoningEffort:"medium";params.reasoning={effort,summary:options?.reasoningSummary||"auto"},params.include=["reasoning.encrypted_content"]}else model.provider!=="github-copilot"&&model.thinkingLevelMap?.off!==null&&(params.reasoning={effort:model.thinkingLevelMap?.off??"none"});model.provider==="xai"&&(params.include=["reasoning.encrypted_content"])}return Object.assign(params,model.samplingParams,options?.samplingParams),params}function getServiceTierCostMultiplier(model,serviceTier){switch(serviceTier){case"flex":return .5;case"priority":case"fast":return model.id==="gpt-5.5"?2.5:2;default:return 1}}function applyServiceTierPricing(usage,serviceTier,model){let multiplier=getServiceTierCostMultiplier(model,serviceTier);multiplier!==1&&(usage.cost.input*=multiplier,usage.cost.output*=multiplier,usage.cost.cacheRead*=multiplier,usage.cost.cacheWrite*=multiplier,usage.cost.total=usage.cost.input+usage.cost.output+usage.cost.cacheRead+usage.cost.cacheWrite)}export{stream,streamSimple};

package/dist/bundle/chunks/virtual-modules-MRXD3RWG.js

@@ -1,5 +0,0 @@
-import { createRequire as __piCreateRequire } from "node:module"; const require = __piCreateRequire(import.meta.url);
-import{diff_exports}from"./chunk-6F5JWGKE.js";import{DEFAULT_MAX_BYTES,DEFAULT_MAX_LINES,ansi_exports,bash_operations_exports,build_exports,child_process_exports,compaction_exports,compat_exports,dist_exports,dist_exports2,edit_diff_exports,file_mutation_queue_exports,image_process_exports,keybinding_hints_exports,mime_exports,path_utils_exports,paths_exports,readme_path_exports,render_utils_exports,require_undici,session_lineage_exports,shell_exports,subagent_exports,text_exports,theme_exports,tool_definition_exports,tools_manager_exports,truncateTail,truncate_exports,value_exports,visual_truncate_exports}from"./chunk-LSP24WNH.js";import"./chunk-JUUC5AZY.js";import"./chunk-XDUWOHPL.js";import{i18n_exports,t}from"./chunk-44I47ACN.js";import"./chunk-DRQDKNXA.js";import"./chunk-TRDNDS6A.js";import"./chunk-HV64ASMT.js";import"./chunk-A3JYRWB6.js";import{__export,__toESM}from"./chunk-4L3WN2XY.js";var undici=__toESM(require_undici(),1);var output_accumulator_exports={};__export(output_accumulator_exports,{OutputAccumulator:()=>OutputAccumulator});import{randomBytes}from"node:crypto";import{createWriteStream}from"node:fs";import{tmpdir}from"node:os";import{join}from"node:path";function defaultTempFilePath(prefix){let id=randomBytes(8).toString("hex");return join(tmpdir(),`${prefix}-${id}.log`)}function byteLength(text){return Buffer.byteLength(text,"utf-8")}var OutputAccumulator=class{maxLines;maxBytes;maxRollingBytes;tempFilePrefix;decoder=new TextDecoder;rawChunks=[];tailText="";tailBytes=0;tailStartsAtLineBoundary=!0;totalRawBytes=0;totalDecodedBytes=0;completedLines=0;totalLines=0;currentLineBytes=0;hasOpenLine=!1;finished=!1;tempFilePath;tempFileStream;constructor(options={}){this.maxLines=options.maxLines??2e3,this.maxBytes=options.maxBytes??51200,this.maxRollingBytes=Math.max(this.maxBytes*2,1),this.tempFilePrefix=options.tempFilePrefix??"agent-forge-output"}append(data){if(this.finished)throw new Error(t("Cannot append to a finished output accumulator"));this.totalRawBytes+=data.length,this.appendDecodedText(this.decoder.decode(data,{stream:!0})),this.tempFileStream||this.shouldUseTempFile()?(this.ensureTempFile(),this.tempFileStream?.write(data)):data.length>0&&this.rawChunks.push(data)}finish(){this.finished||(this.finished=!0,this.appendDecodedText(this.decoder.decode()),this.shouldUseTempFile()&&this.ensureTempFile())}snapshot(options={}){let tailTruncation=truncateTail(this.getSnapshotText(),{maxLines:this.maxLines,maxBytes:this.maxBytes}),truncated=this.totalLines>this.maxLines||this.totalDecodedBytes>this.maxBytes,truncatedBy=truncated?tailTruncation.truncatedBy??(this.totalDecodedBytes>this.maxBytes?"bytes":"lines"):null,truncation={...tailTruncation,truncated,truncatedBy,totalLines:this.totalLines,totalBytes:this.totalDecodedBytes,maxLines:this.maxLines,maxBytes:this.maxBytes};return options.persistIfTruncated&&truncation.truncated&&this.ensureTempFile(),{content:truncation.content,truncation,fullOutputPath:this.tempFilePath}}async closeTempFile(){if(!this.tempFileStream)return;let stream=this.tempFileStream;this.tempFileStream=void 0,await new Promise((resolve,reject)=>{let onError=error=>{stream.off("finish",onFinish),reject(error)},onFinish=()=>{stream.off("error",onError),resolve()};stream.once("error",onError),stream.once("finish",onFinish),stream.end()})}getLastLineBytes(){return this.currentLineBytes}appendDecodedText(text){if(text.length===0)return;let bytes=byteLength(text);this.totalDecodedBytes+=bytes,this.tailText+=text,this.tailBytes+=bytes,this.tailBytes>this.maxRollingBytes*2&&this.trimTail();let newlines=0,lastNewline=-1;for(let i=text.indexOf(`
-`);i!==-1;i=text.indexOf(`
-`,i+1))newlines++,lastNewline=i;if(newlines===0)this.currentLineBytes+=bytes,this.hasOpenLine=!0;else{this.completedLines+=newlines;let tail=text.slice(lastNewline+1);this.currentLineBytes=byteLength(tail),this.hasOpenLine=tail.length>0}this.totalLines=this.completedLines+(this.hasOpenLine?1:0)}trimTail(){let buffer=Buffer.from(this.tailText,"utf-8");if(buffer.length<=this.maxRollingBytes){this.tailBytes=buffer.length;return}let start=buffer.length-this.maxRollingBytes;for(;start<buffer.length&&(buffer[start]&192)===128;)start++;this.tailStartsAtLineBoundary=start===0?this.tailStartsAtLineBoundary:buffer[start-1]===10,this.tailText=buffer.subarray(start).toString("utf-8"),this.tailBytes=byteLength(this.tailText)}getSnapshotText(){if(this.tailStartsAtLineBoundary)return this.tailText;let firstNewline=this.tailText.indexOf(`
-`);return firstNewline===-1?this.tailText:this.tailText.slice(firstNewline+1)}shouldUseTempFile(){return this.totalRawBytes>this.maxBytes||this.totalDecodedBytes>this.maxBytes||this.totalLines>this.maxLines}ensureTempFile(){if(!this.tempFilePath){this.tempFilePath=defaultTempFilePath(this.tempFilePrefix),this.tempFileStream=createWriteStream(this.tempFilePath);for(let chunk of this.rawChunks)this.tempFileStream.write(chunk);this.rawChunks=[]}}};var VIRTUAL_MODULES={"@agent-forge/plugin-sdk":dist_exports2,"@agent-forge/plugin-sdk/session-lineage":session_lineage_exports,"@agent-forge/protocol/subagent":subagent_exports,typebox:build_exports,"typebox/value":value_exports,undici,"@agent-forge/tui":{...dist_exports},"@agent-forge/ai/compat":{...compat_exports},"@agent-forge/host/compaction":{...compaction_exports},"@agent-forge/host/i18n":{...i18n_exports},"@agent-forge/host/theme":{...theme_exports},"@agent-forge/host/keybinding-hints":{...keybinding_hints_exports},"@agent-forge/host/visual-truncate":{...visual_truncate_exports},"@agent-forge/host/diff":{...diff_exports},"@agent-forge/host/render-utils":{...render_utils_exports},"@agent-forge/host/tool-definition":{...tool_definition_exports},"@agent-forge/host/truncate":{...truncate_exports},"@agent-forge/host/edit-diff":{...edit_diff_exports},"@agent-forge/host/file-mutation-queue":{...file_mutation_queue_exports},"@agent-forge/host/output-accumulator":{...output_accumulator_exports},"@agent-forge/host/path-utils":{...path_utils_exports},"@agent-forge/host/readme-path":{...readme_path_exports},"@agent-forge/host/paths":{...paths_exports},"@agent-forge/host/shell":{...shell_exports},"@agent-forge/host/text":{...text_exports},"@agent-forge/host/ansi":{...ansi_exports},"@agent-forge/host/mime":{...mime_exports},"@agent-forge/host/image-process":{...image_process_exports},"@agent-forge/host/child-process":{...child_process_exports},"@agent-forge/host/tools-manager":{...tools_manager_exports},"@agent-forge/host/bash-operations":{...bash_operations_exports}};export{VIRTUAL_MODULES};

package/dist/cli/experimental/commands/pi.d.ts

@@ -1,15 +0,0 @@
-import type { Args } from "../../args.ts";
-import type { AuthInput } from "../auth.ts";
-import { Command } from "../command.ts";
-import type { TransportAddress } from "../transport-address.ts";
-export interface PiCommand {
-    readonly command: "pi";
-    readonly auth?: AuthInput;
-    readonly options: Args;
-    readonly listen?: readonly TransportAddress[];
-}
-export interface PiCommandContext {
-    runPi(command: PiCommand): void | Promise<void>;
-}
-export declare const piCommand: Command<PiCommand, PiCommandContext, PiCommand>;
-//# sourceMappingURL=pi.d.ts.map

package/dist/cli/experimental/commands/pi.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pi.d.ts","sourceRoot":"","sources":["../../../../src/cli/experimental/commands/pi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAQxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAID,eAAO,MAAM,SAAS,iDAoBgC,CAAC","sourcesContent":["import type { Args } from \"../../args.ts\";\nimport type { AuthInput } from \"../auth.ts\";\nimport { Command } from \"../command.ts\";\nimport {\n\tauthTokenFileOption,\n\tauthTokenOption,\n\tparseAuth,\n\tparseLegacyOptions,\n\ttransportOption,\n} from \"../command-options.ts\";\nimport type { TransportAddress } from \"../transport-address.ts\";\n\nexport interface PiCommand {\n\treadonly command: \"pi\";\n\treadonly auth?: AuthInput;\n\treadonly options: Args;\n\treadonly listen?: readonly TransportAddress[];\n}\n\nexport interface PiCommandContext {\n\trunPi(command: PiCommand): void | Promise<void>;\n}\n\nconst listenOption = transportOption(\"--listen\");\n\nexport const piCommand = new Command<PiCommand, PiCommandContext>(\"pi\")\n\t.option(listenOption)\n\t.option(authTokenOption)\n\t.option(authTokenFileOption)\n\t.build((input) => {\n\t\tconst { auth, errors: authErrors } = parseAuth(input);\n\t\tconst listen = input.values(listenOption);\n\t\tconst { options, errors: optionErrors } = parseLegacyOptions(input);\n\t\tconst errors = [...authErrors, ...optionErrors];\n\t\tif (errors.length > 0) return { ok: false, errors };\n\t\treturn {\n\t\t\tok: true,\n\t\t\tcommand: {\n\t\t\t\tcommand: \"pi\",\n\t\t\t\toptions,\n\t\t\t\t...(auth === undefined ? {} : { auth }),\n\t\t\t\t...(listen.length === 0 ? {} : { listen }),\n\t\t\t},\n\t\t};\n\t})\n\t.action((command, context) => context.runPi(command));\n"]}

package/dist/cli/experimental/commands/pi.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pi.js","sourceRoot":"","sources":["../../../../src/cli/experimental/commands/pi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EACN,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,eAAe,GACf,MAAM,uBAAuB,CAAC;AAc/B,MAAM,YAAY,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,OAAO,CAA8B,IAAI,CAAC;KACrE,MAAM,CAAC,YAAY,CAAC;KACpB,MAAM,CAAC,eAAe,CAAC;KACvB,MAAM,CAAC,mBAAmB,CAAC;KAC3B,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IACjB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,EAAE,GAAG,YAAY,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACpD,OAAO;QACN,EAAE,EAAE,IAAI;QACR,OAAO,EAAE;YACR,OAAO,EAAE,IAAI;YACb,OAAO;YACP,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YACvC,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;SAC1C;KACD,CAAC;AAAA,CACF,CAAC;KACD,MAAM,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC","sourcesContent":["import type { Args } from \"../../args.ts\";\nimport type { AuthInput } from \"../auth.ts\";\nimport { Command } from \"../command.ts\";\nimport {\n\tauthTokenFileOption,\n\tauthTokenOption,\n\tparseAuth,\n\tparseLegacyOptions,\n\ttransportOption,\n} from \"../command-options.ts\";\nimport type { TransportAddress } from \"../transport-address.ts\";\n\nexport interface PiCommand {\n\treadonly command: \"pi\";\n\treadonly auth?: AuthInput;\n\treadonly options: Args;\n\treadonly listen?: readonly TransportAddress[];\n}\n\nexport interface PiCommandContext {\n\trunPi(command: PiCommand): void | Promise<void>;\n}\n\nconst listenOption = transportOption(\"--listen\");\n\nexport const piCommand = new Command<PiCommand, PiCommandContext>(\"pi\")\n\t.option(listenOption)\n\t.option(authTokenOption)\n\t.option(authTokenFileOption)\n\t.build((input) => {\n\t\tconst { auth, errors: authErrors } = parseAuth(input);\n\t\tconst listen = input.values(listenOption);\n\t\tconst { options, errors: optionErrors } = parseLegacyOptions(input);\n\t\tconst errors = [...authErrors, ...optionErrors];\n\t\tif (errors.length > 0) return { ok: false, errors };\n\t\treturn {\n\t\t\tok: true,\n\t\t\tcommand: {\n\t\t\t\tcommand: \"pi\",\n\t\t\t\toptions,\n\t\t\t\t...(auth === undefined ? {} : { auth }),\n\t\t\t\t...(listen.length === 0 ? {} : { listen }),\n\t\t\t},\n\t\t};\n\t})\n\t.action((command, context) => context.runPi(command));\n"]}

package/dist/core/export-html/ansi-to-html.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ansi-to-html.d.ts","sourceRoot":"","sources":["../../../src/core/export-html/ansi-to-html.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuLH;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoD/C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvD","sourcesContent":["/**\n * ANSI escape code to HTML converter.\n *\n * Converts terminal ANSI color/style codes to HTML with inline styles.\n * Supports:\n * - Standard foreground colors (30-37) and bright variants (90-97)\n * - Standard background colors (40-47) and bright variants (100-107)\n * - 256-color palette (38;5;N and 48;5;N)\n * - RGB true color (38;2;R;G;B and 48;2;R;G;B)\n * - Text styles: bold (1), dim (2), italic (3), underline (4)\n * - Reset (0)\n */\n\n// Standard ANSI color palette (0-15)\nconst ANSI_COLORS = [\n\t\"#000000\", // 0: black\n\t\"#800000\", // 1: red\n\t\"#008000\", // 2: green\n\t\"#808000\", // 3: yellow\n\t\"#000080\", // 4: blue\n\t\"#800080\", // 5: magenta\n\t\"#008080\", // 6: cyan\n\t\"#c0c0c0\", // 7: white\n\t\"#808080\", // 8: bright black\n\t\"#ff0000\", // 9: bright red\n\t\"#00ff00\", // 10: bright green\n\t\"#ffff00\", // 11: bright yellow\n\t\"#0000ff\", // 12: bright blue\n\t\"#ff00ff\", // 13: bright magenta\n\t\"#00ffff\", // 14: bright cyan\n\t\"#ffffff\", // 15: bright white\n];\n\n/**\n * Convert 256-color index to hex.\n */\nfunction color256ToHex(index: number): string {\n\t// Standard colors (0-15)\n\tif (index < 16) {\n\t\treturn ANSI_COLORS[index];\n\t}\n\n\t// Color cube (16-231): 6x6x6 = 216 colors\n\tif (index < 232) {\n\t\tconst cubeIndex = index - 16;\n\t\tconst r = Math.floor(cubeIndex / 36);\n\t\tconst g = Math.floor((cubeIndex % 36) / 6);\n\t\tconst b = cubeIndex % 6;\n\t\tconst toComponent = (n: number) => (n === 0 ? 0 : 55 + n * 40);\n\t\tconst toHex = (n: number) => toComponent(n).toString(16).padStart(2, \"0\");\n\t\treturn `#${toHex(r)}${toHex(g)}${toHex(b)}`;\n\t}\n\n\t// Grayscale (232-255): 24 shades\n\tconst gray = 8 + (index - 232) * 10;\n\tconst grayHex = gray.toString(16).padStart(2, \"0\");\n\treturn `#${grayHex}${grayHex}${grayHex}`;\n}\n\n/**\n * Escape HTML special characters.\n */\nfunction escapeHtml(text: string): string {\n\treturn text\n\t\t.replace(/&/g, \"&amp;\")\n\t\t.replace(/</g, \"&lt;\")\n\t\t.replace(/>/g, \"&gt;\")\n\t\t.replace(/\"/g, \"&quot;\")\n\t\t.replace(/'/g, \"&#039;\");\n}\n\ninterface TextStyle {\n\tfg: string | null;\n\tbg: string | null;\n\tbold: boolean;\n\tdim: boolean;\n\titalic: boolean;\n\tunderline: boolean;\n}\n\nfunction createEmptyStyle(): TextStyle {\n\treturn {\n\t\tfg: null,\n\t\tbg: null,\n\t\tbold: false,\n\t\tdim: false,\n\t\titalic: false,\n\t\tunderline: false,\n\t};\n}\n\nfunction styleToInlineCSS(style: TextStyle): string {\n\tconst parts: string[] = [];\n\tif (style.fg) parts.push(`color:${style.fg}`);\n\tif (style.bg) parts.push(`background-color:${style.bg}`);\n\tif (style.bold) parts.push(\"font-weight:bold\");\n\tif (style.dim) parts.push(\"opacity:0.6\");\n\tif (style.italic) parts.push(\"font-style:italic\");\n\tif (style.underline) parts.push(\"text-decoration:underline\");\n\treturn parts.join(\";\");\n}\n\nfunction hasStyle(style: TextStyle): boolean {\n\treturn style.fg !== null || style.bg !== null || style.bold || style.dim || style.italic || style.underline;\n}\n\n/**\n * Parse ANSI SGR (Select Graphic Rendition) codes and update style.\n */\nfunction applySgrCode(params: number[], style: TextStyle): void {\n\tlet i = 0;\n\twhile (i < params.length) {\n\t\tconst code = params[i];\n\n\t\tif (code === 0) {\n\t\t\t// Reset all\n\t\t\tstyle.fg = null;\n\t\t\tstyle.bg = null;\n\t\t\tstyle.bold = false;\n\t\t\tstyle.dim = false;\n\t\t\tstyle.italic = false;\n\t\t\tstyle.underline = false;\n\t\t} else if (code === 1) {\n\t\t\tstyle.bold = true;\n\t\t} else if (code === 2) {\n\t\t\tstyle.dim = true;\n\t\t} else if (code === 3) {\n\t\t\tstyle.italic = true;\n\t\t} else if (code === 4) {\n\t\t\tstyle.underline = true;\n\t\t} else if (code === 22) {\n\t\t\t// Reset bold/dim\n\t\t\tstyle.bold = false;\n\t\t\tstyle.dim = false;\n\t\t} else if (code === 23) {\n\t\t\tstyle.italic = false;\n\t\t} else if (code === 24) {\n\t\t\tstyle.underline = false;\n\t\t} else if (code >= 30 && code <= 37) {\n\t\t\t// Standard foreground colors\n\t\t\tstyle.fg = ANSI_COLORS[code - 30];\n\t\t} else if (code === 38) {\n\t\t\t// Extended foreground color\n\t\t\tif (params[i + 1] === 5 && params.length > i + 2) {\n\t\t\t\t// 256-color: 38;5;N\n\t\t\t\tstyle.fg = color256ToHex(params[i + 2]);\n\t\t\t\ti += 2;\n\t\t\t} else if (params[i + 1] === 2 && params.length > i + 4) {\n\t\t\t\t// RGB: 38;2;R;G;B\n\t\t\t\tconst r = params[i + 2];\n\t\t\t\tconst g = params[i + 3];\n\t\t\t\tconst b = params[i + 4];\n\t\t\t\tstyle.fg = `rgb(${r},${g},${b})`;\n\t\t\t\ti += 4;\n\t\t\t}\n\t\t} else if (code === 39) {\n\t\t\t// Default foreground\n\t\t\tstyle.fg = null;\n\t\t} else if (code >= 40 && code <= 47) {\n\t\t\t// Standard background colors\n\t\t\tstyle.bg = ANSI_COLORS[code - 40];\n\t\t} else if (code === 48) {\n\t\t\t// Extended background color\n\t\t\tif (params[i + 1] === 5 && params.length > i + 2) {\n\t\t\t\t// 256-color: 48;5;N\n\t\t\t\tstyle.bg = color256ToHex(params[i + 2]);\n\t\t\t\ti += 2;\n\t\t\t} else if (params[i + 1] === 2 && params.length > i + 4) {\n\t\t\t\t// RGB: 48;2;R;G;B\n\t\t\t\tconst r = params[i + 2];\n\t\t\t\tconst g = params[i + 3];\n\t\t\t\tconst b = params[i + 4];\n\t\t\t\tstyle.bg = `rgb(${r},${g},${b})`;\n\t\t\t\ti += 4;\n\t\t\t}\n\t\t} else if (code === 49) {\n\t\t\t// Default background\n\t\t\tstyle.bg = null;\n\t\t} else if (code >= 90 && code <= 97) {\n\t\t\t// Bright foreground colors\n\t\t\tstyle.fg = ANSI_COLORS[code - 90 + 8];\n\t\t} else if (code >= 100 && code <= 107) {\n\t\t\t// Bright background colors\n\t\t\tstyle.bg = ANSI_COLORS[code - 100 + 8];\n\t\t}\n\t\t// Ignore unrecognized codes\n\n\t\ti++;\n\t}\n}\n\n// Match ANSI escape sequences: ESC[ followed by params and ending with 'm'\nconst ANSI_REGEX = /\\x1b\\[([\\d;]*)m/g;\n\n/**\n * Convert ANSI-escaped text to HTML with inline styles.\n */\nexport function ansiToHtml(text: string): string {\n\tconst style = createEmptyStyle();\n\tlet result = \"\";\n\tlet lastIndex = 0;\n\tlet inSpan = false;\n\n\t// Reset regex state\n\tANSI_REGEX.lastIndex = 0;\n\n\tlet match = ANSI_REGEX.exec(text);\n\twhile (match !== null) {\n\t\t// Add text before this escape sequence\n\t\tconst beforeText = text.slice(lastIndex, match.index);\n\t\tif (beforeText) {\n\t\t\tresult += escapeHtml(beforeText);\n\t\t}\n\n\t\t// Parse SGR parameters\n\t\tconst paramStr = match[1];\n\t\tconst params = paramStr ? paramStr.split(\";\").map((p) => parseInt(p, 10) || 0) : [0];\n\n\t\t// Close existing span if we have one\n\t\tif (inSpan) {\n\t\t\tresult += \"</span>\";\n\t\t\tinSpan = false;\n\t\t}\n\n\t\t// Apply the codes\n\t\tapplySgrCode(params, style);\n\n\t\t// Open new span if we have any styling\n\t\tif (hasStyle(style)) {\n\t\t\tresult += `<span style=\"${styleToInlineCSS(style)}\">`;\n\t\t\tinSpan = true;\n\t\t}\n\n\t\tlastIndex = match.index + match[0].length;\n\t\tmatch = ANSI_REGEX.exec(text);\n\t}\n\n\t// Add remaining text\n\tconst remainingText = text.slice(lastIndex);\n\tif (remainingText) {\n\t\tresult += escapeHtml(remainingText);\n\t}\n\n\t// Close any open span\n\tif (inSpan) {\n\t\tresult += \"</span>\";\n\t}\n\n\treturn result;\n}\n\n/**\n * Convert array of ANSI-escaped lines to HTML.\n * Each line is wrapped in a div element.\n */\nexport function ansiLinesToHtml(lines: string[]): string {\n\treturn lines.map((line) => `<div class=\"ansi-line\">${ansiToHtml(line) || \"&nbsp;\"}</div>`).join(\"\");\n}\n"]}