@yjjeong/omg 0.1.0

package/dist/core/mcp/mcpConfig.js

@@ -0,0 +1,148 @@
+// Phase 127: external MCP server config at ~/.omg/mcp.json.
+//
+// omg can act as an MCP *server* (src/mcp/server.ts) so claude/codex/
+// gemini can call omg's tools. This is the other direction: a registry
+// of external MCP *servers* that omg spawns and consumes, so the agent
+// loop can call their tools the same way Claude Code / Codex do.
+//
+// Shape (compatible with the common `mcpServers` convention):
+//   {
+//     "servers": {
+//       "fs":   { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."] },
+//       "mine": { "command": "node", "args": ["./server.js"], "env": { "TOKEN": "x" } }
+//     }
+//   }
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const DEFAULT_HOME = () => process.env.HOME ?? homedir();
+export function mcpConfigFile(home = DEFAULT_HOME()) {
+    return join(home, ".omg", "mcp.json");
+}
+/** Phase 348: project-scoped config at `<projectDir>/.omg/mcp.json`. The
+ *  recommendations scaffold writes here; it overrides the user file by name. */
+export function projectMcpConfigFile(projectDir) {
+    return join(projectDir, ".omg", "mcp.json");
+}
+/** Load + validate ~/.omg/mcp.json. Unknown / malformed entries are
+ *  dropped rather than throwing, so one bad server can't block startup.
+ *  Accepts both `servers` and the `mcpServers` alias. Phase 215: skip
+ *  reasons are returned in `warnings` so a typo (e.g. `cmand` instead
+ *  of `command`) shows up as a user-visible signal instead of a
+ *  silent absence. */
+export function loadMcpConfig(home = DEFAULT_HOME()) {
+    return loadMcpConfigFrom(mcpConfigFile(home));
+}
+/** Parse a specific mcp.json file. Missing file → empty (not an error). */
+export function loadMcpConfigFrom(file) {
+    if (!existsSync(file))
+        return { servers: {}, warnings: [] };
+    const warnings = [];
+    try {
+        const parsed = JSON.parse(readFileSync(file, "utf-8"));
+        const raw = parsed.servers ??
+            parsed.mcpServers ??
+            {};
+        const servers = {};
+        for (const [name, v] of Object.entries(raw)) {
+            if (typeof v !== "object" || v === null) {
+                warnings.push(`skipped '${name}' — entry is not an object`);
+                continue;
+            }
+            const o = v;
+            if (typeof o.command !== "string" || o.command === "") {
+                warnings.push(`skipped '${name}' — missing or empty 'command'`);
+                continue;
+            }
+            const cfg = { command: o.command };
+            if (Array.isArray(o.args)) {
+                cfg.args = o.args.filter((a) => typeof a === "string");
+            }
+            if (o.env && typeof o.env === "object") {
+                const env = {};
+                for (const [k, val] of Object.entries(o.env)) {
+                    if (typeof val === "string")
+                        env[k] = val;
+                }
+                cfg.env = env;
+            }
+            if (typeof o.cwd === "string")
+                cfg.cwd = o.cwd;
+            if (o.enabled === false)
+                cfg.enabled = false;
+            if (Array.isArray(o.providers)) {
+                cfg.providers = o.providers.filter((p) => typeof p === "string");
+            }
+            servers[name] = cfg;
+        }
+        return { servers, warnings };
+    }
+    catch (e) {
+        return {
+            servers: {},
+            warnings: [`failed to parse ${file}: ${e.message}`],
+        };
+    }
+}
+/** Phase 348: merge the user config (`~/.omg/mcp.json`) with a project config
+ *  (`<projectDir>/.omg/mcp.json`). Project entries override user entries of
+ *  the same name (project is the more specific scope). Warnings concatenate. */
+export function loadMergedMcpConfig(opts) {
+    const user = loadMcpConfigFrom(mcpConfigFile(opts.home ?? DEFAULT_HOME()));
+    const project = opts.projectDir
+        ? loadMcpConfigFrom(projectMcpConfigFile(opts.projectDir))
+        : { servers: {}, warnings: [] };
+    return {
+        servers: { ...user.servers, ...project.servers },
+        warnings: [...user.warnings, ...project.warnings],
+    };
+}
+/** Phase 348: flip a server's `enabled` flag in a specific mcp.json file.
+ *  Returns "set" on success, "absent" if the file/server isn't there, "error"
+ *  if the file is unparseable. Preserves the rest of the file (and whichever
+ *  `servers`/`mcpServers` key it uses). */
+export function setServerEnabled(file, name, enabled) {
+    if (!existsSync(file))
+        return "absent";
+    let obj;
+    try {
+        obj = JSON.parse(readFileSync(file, "utf-8"));
+    }
+    catch {
+        return "error";
+    }
+    const key = obj.servers === undefined &&
+        obj.mcpServers !== undefined &&
+        typeof obj.mcpServers === "object"
+        ? "mcpServers"
+        : "servers";
+    const servers = typeof obj[key] === "object" && obj[key] !== null
+        ? obj[key]
+        : undefined;
+    if (!servers || typeof servers[name] !== "object" || servers[name] === null) {
+        return "absent";
+    }
+    servers[name].enabled = enabled;
+    writeFileSync(file, JSON.stringify(obj, null, 2) + "\n");
+    return "set";
+}
+/** Phase 348: the subset of servers that should actually be connected, given
+ *  the disabled flag, an optional role allowlist (server names), and the
+ *  spawning provider. A server with `enabled: false` is always skipped; an
+ *  allowlist (when provided) keeps only named servers; a `providers` tag keeps
+ *  the server only for matching base providers. */
+export function activeServers(servers, opts = {}) {
+    const out = {};
+    const base = opts.provider?.replace(/-cli$/, "");
+    for (const [name, cfg] of Object.entries(servers)) {
+        if (cfg.enabled === false)
+            continue;
+        if (opts.allow && !opts.allow.includes(name))
+            continue;
+        if (cfg.providers && base && !cfg.providers.includes(base))
+            continue;
+        out[name] = cfg;
+    }
+    return out;
+}
+//# sourceMappingURL=mcpConfig.js.map

package/dist/core/mcp/mcpConfig.js.map

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

package/dist/core/mcp/mcpManager.d.ts

@@ -0,0 +1,31 @@
+import type { McpConfig } from "./mcpConfig.js";
+import type { ToolRegistry } from "../tools/tools.js";
+export interface McpConnectResult {
+    connected: string[];
+    failed: Array<{
+        name: string;
+        error: string;
+    }>;
+}
+/** Build the namespaced registry id for a server's tool. */
+export declare function mcpToolId(server: string, tool: string): string;
+export declare class McpManager {
+    private readonly clients;
+    /** Spawn + handshake every configured server in parallel. Servers
+     *  that fail to start are reported in `failed` and skipped. */
+    connectAll(config: McpConfig, opts?: {
+        cwd?: string;
+        stderr?: NodeJS.WritableStream;
+    }): Promise<McpConnectResult>;
+    /** Register every connected server's tools into `registry` under the
+     *  `mcp__<server>__<tool>` namespace. Returns the registered ids.
+     *  A tool whose call fails (isError) throws so the registry reports
+     *  ok:false, matching built-in tool semantics. */
+    registerInto(registry: ToolRegistry): string[];
+    /** Connected server names. */
+    get servers(): string[];
+    /** Tools discovered per connected server. */
+    toolsByServer(): Record<string, string[]>;
+    stopAll(): Promise<void>;
+}
+//# sourceMappingURL=mcpManager.d.ts.map

package/dist/core/mcp/mcpManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpManager.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/mcpManager.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IAExD;mEAC+D;IACzD,UAAU,CACd,MAAM,EAAE,SAAS,EACjB,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;KAAO,GAC1D,OAAO,CAAC,gBAAgB,CAAC;IA6B5B;;;sDAGkD;IAClD,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE;IAiB9C,8BAA8B;IAC9B,IAAI,OAAO,IAAI,MAAM,EAAE,CAEtB;IAED,6CAA6C;IAC7C,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAQnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B"}

package/dist/core/mcp/mcpManager.js

@@ -0,0 +1,83 @@
+// Phase 128: connect the configured external MCP servers and surface
+// their tools through omg's ToolRegistry, so the agentic loop and the
+// `delegate` tool can call them just like built-in tools.
+//
+// Tools are namespaced `mcp__<server>__<tool>` (the Claude Code
+// convention) to avoid collisions between servers and with built-ins.
+// A failed server is skipped, not fatal — its tools simply don't appear.
+import { McpClient } from "./mcpClient.js";
+/** Build the namespaced registry id for a server's tool. */
+export function mcpToolId(server, tool) {
+    return `mcp__${server}__${tool}`;
+}
+export class McpManager {
+    clients = new Map();
+    /** Spawn + handshake every configured server in parallel. Servers
+     *  that fail to start are reported in `failed` and skipped. */
+    async connectAll(config, opts = {}) {
+        const result = { connected: [], failed: [] };
+        const entries = Object.entries(config.servers);
+        await Promise.all(entries.map(async ([name, cfg]) => {
+            const client = new McpClient({
+                command: cfg.command,
+                args: cfg.args,
+                env: cfg.env,
+                cwd: cfg.cwd ?? opts.cwd,
+                stderr: opts.stderr,
+                name,
+            });
+            try {
+                await client.start();
+                this.clients.set(name, client);
+                result.connected.push(name);
+            }
+            catch (e) {
+                await client.stop().catch(() => { });
+                result.failed.push({
+                    name,
+                    error: e instanceof Error ? e.message : String(e),
+                });
+            }
+        }));
+        return result;
+    }
+    /** Register every connected server's tools into `registry` under the
+     *  `mcp__<server>__<tool>` namespace. Returns the registered ids.
+     *  A tool whose call fails (isError) throws so the registry reports
+     *  ok:false, matching built-in tool semantics. */
+    registerInto(registry) {
+        const ids = [];
+        for (const [server, client] of this.clients) {
+            for (const tool of client.listTools()) {
+                const id = mcpToolId(server, tool.name);
+                if (registry.has(id))
+                    continue;
+                registry.register(id, async (args) => {
+                    const r = await client.callTool(tool.name, args);
+                    if (r.isError)
+                        throw new Error(r.text || `${id} failed`);
+                    return r.text;
+                });
+                ids.push(id);
+            }
+        }
+        return ids;
+    }
+    /** Connected server names. */
+    get servers() {
+        return [...this.clients.keys()];
+    }
+    /** Tools discovered per connected server. */
+    toolsByServer() {
+        const out = {};
+        for (const [server, client] of this.clients) {
+            out[server] = client.listTools().map((t) => t.name);
+        }
+        return out;
+    }
+    async stopAll() {
+        await Promise.all([...this.clients.values()].map((c) => c.stop()));
+        this.clients.clear();
+    }
+}
+//# sourceMappingURL=mcpManager.js.map

package/dist/core/mcp/mcpManager.js.map

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

package/dist/core/mcpClient.d.ts

@@ -0,0 +1,42 @@
+export interface McpClientOpts {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    /** Diagnostics sink. Default: process.stderr. */
+    stderr?: NodeJS.WritableStream;
+    /** Logical name (for namespacing / diagnostics). */
+    name?: string;
+}
+export interface McpToolInfo {
+    name: string;
+    description: string;
+    inputSchema: unknown;
+}
+export interface McpCallResult {
+    ok: boolean;
+    text: string;
+    isError: boolean;
+}
+export declare class McpClient {
+    private readonly opts;
+    private child?;
+    private rl?;
+    private nextId;
+    private readonly pending;
+    private tools;
+    private dead;
+    private readonly stderr;
+    constructor(opts: McpClientOpts);
+    /** Spawn, handshake, and fetch the tool list. Rejects (and tears the
+     *  child down) on spawn error or handshake timeout. */
+    start(timeoutMs?: number): Promise<void>;
+    listTools(): McpToolInfo[];
+    callTool(name: string, args: Record<string, unknown>, timeoutMs?: number): Promise<McpCallResult>;
+    stop(): Promise<void>;
+    private fail;
+    private onLine;
+    private request;
+    private notify;
+}
+//# sourceMappingURL=mcpClient.d.ts.map

package/dist/core/mcpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpClient.d.ts","sourceRoot":"","sources":["../../src/core/mcpClient.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAQD,qBAAa,SAAS;IASR,OAAO,CAAC,QAAQ,CAAC,IAAI;IARjC,OAAO,CAAC,KAAK,CAAC,CAAiC;IAC/C,OAAO,CAAC,EAAE,CAAC,CAAY;IACvB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAElB,IAAI,EAAE,aAAa;IAIhD;2DACuD;IACjD,KAAK,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C9C,SAAS,IAAI,WAAW,EAAE;IAIpB,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,SAAS,GACjB,OAAO,CAAC,aAAa,CAAC;IAgBnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,MAAM;IAuBd,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,MAAM;CAKf"}

package/dist/core/mcpClient.js

@@ -0,0 +1,134 @@
+// Phase 127: a minimal stdio MCP *client*.
+//
+// Spawns a configured MCP server and speaks the same small slice of the
+// protocol our server (src/mcp/server.ts) implements: line-delimited
+// JSON-RPC with `initialize` → `notifications/initialized` →
+// `tools/list` → `tools/call`. No dependency on the official SDK; the
+// surface is tiny and our own server is the known-good peer for tests.
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { PROTOCOL_VERSION } from "../mcp/constants.js";
+export class McpClient {
+    opts;
+    child;
+    rl;
+    nextId = 1;
+    pending = new Map();
+    tools = [];
+    dead = false;
+    stderr;
+    constructor(opts) {
+        this.opts = opts;
+        this.stderr = opts.stderr ?? process.stderr;
+    }
+    /** Spawn, handshake, and fetch the tool list. Rejects (and tears the
+     *  child down) on spawn error or handshake timeout. */
+    async start(timeoutMs = 10_000) {
+        const child = spawn(this.opts.command, this.opts.args ?? [], {
+            cwd: this.opts.cwd,
+            env: { ...process.env, ...(this.opts.env ?? {}) },
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.child = child;
+        child.on("error", (e) => this.fail(e));
+        child.on("exit", (code) => {
+            if (!this.dead)
+                this.fail(new Error(`mcp server exited (code ${code})`));
+        });
+        child.stderr.on("data", (d) => {
+            this.stderr.write(`[mcp:${this.opts.name ?? this.opts.command}] ${d}`);
+        });
+        this.rl = createInterface({ input: child.stdout, crlfDelay: Infinity });
+        this.rl.on("line", (line) => this.onLine(line));
+        await this.request("initialize", {
+            protocolVersion: PROTOCOL_VERSION,
+            capabilities: {},
+            clientInfo: { name: "omg", version: "0" },
+        }, timeoutMs);
+        this.notify("notifications/initialized");
+        const listed = (await this.request("tools/list", {}, timeoutMs));
+        this.tools = Array.isArray(listed?.tools)
+            ? listed.tools
+                .filter((t) => typeof t.name === "string")
+                .map((t) => ({
+                name: t.name,
+                description: typeof t.description === "string" ? t.description : "",
+                inputSchema: t.inputSchema ?? {},
+            }))
+            : [];
+    }
+    listTools() {
+        return this.tools;
+    }
+    async callTool(name, args, timeoutMs = 60_000) {
+        const r = (await this.request("tools/call", { name, arguments: args }, timeoutMs));
+        const text = (r.content ?? [])
+            .filter((c) => c.type === "text" && typeof c.text === "string")
+            .map((c) => c.text)
+            .join("\n");
+        return { ok: !r.isError, text, isError: !!r.isError };
+    }
+    async stop() {
+        this.dead = true;
+        for (const p of this.pending.values()) {
+            clearTimeout(p.timer);
+            p.reject(new Error("mcp client stopped"));
+        }
+        this.pending.clear();
+        this.rl?.close();
+        this.child?.kill();
+    }
+    fail(err) {
+        this.dead = true;
+        for (const p of this.pending.values()) {
+            clearTimeout(p.timer);
+            p.reject(err);
+        }
+        this.pending.clear();
+    }
+    onLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(trimmed);
+        }
+        catch {
+            return; // ignore non-JSON server chatter
+        }
+        // Responses carry an id; server-initiated notifications don't —
+        // we have no use for the latter yet, so drop them.
+        if (typeof msg.id !== "number")
+            return;
+        const p = this.pending.get(msg.id);
+        if (!p)
+            return;
+        this.pending.delete(msg.id);
+        clearTimeout(p.timer);
+        if (msg.error) {
+            p.reject(new Error(msg.error.message ?? "mcp error"));
+        }
+        else {
+            p.resolve(msg.result);
+        }
+    }
+    request(method, params, timeoutMs) {
+        if (this.dead || !this.child) {
+            return Promise.reject(new Error("mcp client not running"));
+        }
+        const id = this.nextId++;
+        this.child.stdin.write(JSON.stringify({ jsonrpc: "2.0", id, method, params }) + "\n");
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`mcp ${method} timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+        });
+    }
+    notify(method, params = {}) {
+        this.child?.stdin.write(JSON.stringify({ jsonrpc: "2.0", method, params }) + "\n");
+    }
+}
+//# sourceMappingURL=mcpClient.js.map

package/dist/core/mcpClient.js.map

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

package/dist/core/mcpConfig.d.ts

@@ -0,0 +1,24 @@
+export interface McpServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    /** Working directory for the spawned server. Defaults to the omg cwd. */
+    cwd?: string;
+}
+export interface McpConfig {
+    servers: Record<string, McpServerConfig>;
+    /** Phase 215 (F4.6): non-fatal skip reasons collected during parse.
+     *  The caller surfaces these as one-line warnings so the user can
+     *  see why a typo'd entry (e.g. `cmand` instead of `command`)
+     *  silently produced no server. */
+    warnings: string[];
+}
+export declare function mcpConfigFile(home?: string): string;
+/** Load + validate ~/.omg/mcp.json. Unknown / malformed entries are
+ *  dropped rather than throwing, so one bad server can't block startup.
+ *  Accepts both `servers` and the `mcpServers` alias. Phase 215: skip
+ *  reasons are returned in `warnings` so a typo (e.g. `cmand` instead
+ *  of `command`) shows up as a user-visible signal instead of a
+ *  silent absence. */
+export declare function loadMcpConfig(home?: string): McpConfig;
+//# sourceMappingURL=mcpConfig.d.ts.map

package/dist/core/mcpConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpConfig.d.ts","sourceRoot":"","sources":["../../src/core/mcpConfig.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC;;;uCAGmC;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAuB,GAAG,MAAM,CAEnE;AAED;;;;;sBAKsB;AACtB,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAuB,GAAG,SAAS,CA+CtE"}

package/dist/core/mcpConfig.js

@@ -0,0 +1,74 @@
+// Phase 127: external MCP server config at ~/.omg/mcp.json.
+//
+// omg can act as an MCP *server* (src/mcp/server.ts) so claude/codex/
+// gemini can call omg's tools. This is the other direction: a registry
+// of external MCP *servers* that omg spawns and consumes, so the agent
+// loop can call their tools the same way Claude Code / Codex do.
+//
+// Shape (compatible with the common `mcpServers` convention):
+//   {
+//     "servers": {
+//       "fs":   { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."] },
+//       "mine": { "command": "node", "args": ["./server.js"], "env": { "TOKEN": "x" } }
+//     }
+//   }
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const DEFAULT_HOME = () => process.env.HOME ?? homedir();
+export function mcpConfigFile(home = DEFAULT_HOME()) {
+    return join(home, ".omg", "mcp.json");
+}
+/** Load + validate ~/.omg/mcp.json. Unknown / malformed entries are
+ *  dropped rather than throwing, so one bad server can't block startup.
+ *  Accepts both `servers` and the `mcpServers` alias. Phase 215: skip
+ *  reasons are returned in `warnings` so a typo (e.g. `cmand` instead
+ *  of `command`) shows up as a user-visible signal instead of a
+ *  silent absence. */
+export function loadMcpConfig(home = DEFAULT_HOME()) {
+    const file = mcpConfigFile(home);
+    if (!existsSync(file))
+        return { servers: {}, warnings: [] };
+    const warnings = [];
+    try {
+        const parsed = JSON.parse(readFileSync(file, "utf-8"));
+        const raw = parsed.servers ??
+            parsed.mcpServers ??
+            {};
+        const servers = {};
+        for (const [name, v] of Object.entries(raw)) {
+            if (typeof v !== "object" || v === null) {
+                warnings.push(`skipped '${name}' — entry is not an object`);
+                continue;
+            }
+            const o = v;
+            if (typeof o.command !== "string" || o.command === "") {
+                warnings.push(`skipped '${name}' — missing or empty 'command'`);
+                continue;
+            }
+            const cfg = { command: o.command };
+            if (Array.isArray(o.args)) {
+                cfg.args = o.args.filter((a) => typeof a === "string");
+            }
+            if (o.env && typeof o.env === "object") {
+                const env = {};
+                for (const [k, val] of Object.entries(o.env)) {
+                    if (typeof val === "string")
+                        env[k] = val;
+                }
+                cfg.env = env;
+            }
+            if (typeof o.cwd === "string")
+                cfg.cwd = o.cwd;
+            servers[name] = cfg;
+        }
+        return { servers, warnings };
+    }
+    catch (e) {
+        return {
+            servers: {},
+            warnings: [`failed to parse ${file}: ${e.message}`],
+        };
+    }
+}
+//# sourceMappingURL=mcpConfig.js.map

package/dist/core/mcpConfig.js.map

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

package/dist/core/mcpManager.d.ts

@@ -0,0 +1,31 @@
+import type { McpConfig } from "./mcpConfig.js";
+import type { ToolRegistry } from "./tools.js";
+export interface McpConnectResult {
+    connected: string[];
+    failed: Array<{
+        name: string;
+        error: string;
+    }>;
+}
+/** Build the namespaced registry id for a server's tool. */
+export declare function mcpToolId(server: string, tool: string): string;
+export declare class McpManager {
+    private readonly clients;
+    /** Spawn + handshake every configured server in parallel. Servers
+     *  that fail to start are reported in `failed` and skipped. */
+    connectAll(config: McpConfig, opts?: {
+        cwd?: string;
+        stderr?: NodeJS.WritableStream;
+    }): Promise<McpConnectResult>;
+    /** Register every connected server's tools into `registry` under the
+     *  `mcp__<server>__<tool>` namespace. Returns the registered ids.
+     *  A tool whose call fails (isError) throws so the registry reports
+     *  ok:false, matching built-in tool semantics. */
+    registerInto(registry: ToolRegistry): string[];
+    /** Connected server names. */
+    get servers(): string[];
+    /** Tools discovered per connected server. */
+    toolsByServer(): Record<string, string[]>;
+    stopAll(): Promise<void>;
+}
+//# sourceMappingURL=mcpManager.d.ts.map

package/dist/core/mcpManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpManager.d.ts","sourceRoot":"","sources":["../../src/core/mcpManager.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IAExD;mEAC+D;IACzD,UAAU,CACd,MAAM,EAAE,SAAS,EACjB,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;KAAO,GAC1D,OAAO,CAAC,gBAAgB,CAAC;IA6B5B;;;sDAGkD;IAClD,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE;IAiB9C,8BAA8B;IAC9B,IAAI,OAAO,IAAI,MAAM,EAAE,CAEtB;IAED,6CAA6C;IAC7C,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAQnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B"}