ineedcodes 0.1.0

package/packages/core/dist/tools/git.js

@@ -0,0 +1,251 @@
+import { execShell } from '../shell/process.js';
+import { shellQuote } from '../util/shell-quote.js';
+import { str, num, bool, resolvePath, fail, guardPath } from './fs.js';
+/**
+ * First-class Git tools. These are structured wrappers: the model does not
+ * need to build raw Git command lines for common operations. Raw Git still
+ * works through shell_exec when needed.
+ */
+export function createGitTools() {
+    const git_status = {
+        name: 'git_status',
+        description: 'Show the current Git branch, staged/unstaged changes, and untracked files.',
+        permissions: ['read'],
+        readonly: true,
+        inputSchema: { type: 'object', properties: {} },
+        async execute(_input, ctx) {
+            const guard = await guardRepo(ctx);
+            if (guard)
+                return guard;
+            const branch = await execShell('git rev-parse --abbrev-ref HEAD', ctx.cwd);
+            const status = await execShell('git status --porcelain', ctx.cwd);
+            return {
+                ok: branch.exitCode === 0,
+                summary: branch.exitCode === 0 ? `Git status for branch ${branch.stdout.trim()}.` : 'Not a Git repository.',
+                data: {
+                    branch: branch.stdout.trim() || null,
+                    changes: status.stdout || '(clean)'
+                }
+            };
+        }
+    };
+    const git_diff = {
+        name: 'git_diff',
+        description: 'Show the diff of changes. Use staged=true to diff the index.',
+        permissions: ['read'],
+        readonly: true,
+        inputSchema: {
+            type: 'object',
+            properties: { staged: { type: 'boolean' }, path: { type: 'string' } }
+        },
+        async execute(input, ctx) {
+            const guard = await guardRepo(ctx);
+            if (guard)
+                return guard;
+            const args = ['git', 'diff', '--stat'];
+            if (bool(input, 'staged'))
+                args.push('--cached');
+            const target = str(input, 'path');
+            if (target)
+                args.push('--', target);
+            const result = await execShell(args.join(' '), ctx.cwd);
+            const full = await execShell(args.join(' ').replace('--stat', ''), ctx.cwd);
+            return {
+                ok: result.exitCode === 0,
+                summary: result.stdout.trim() ? 'Diff produced.' : 'No changes to diff.',
+                data: { stat: result.stdout, patch: full.stdout.slice(0, 32_000) }
+            };
+        }
+    };
+    const git_log = {
+        name: 'git_log',
+        description: 'Show recent commit history.',
+        permissions: ['read'],
+        readonly: true,
+        inputSchema: { type: 'object', properties: { count: { type: 'number' } } },
+        async execute(input, ctx) {
+            const guard = await guardRepo(ctx);
+            if (guard)
+                return guard;
+            const count = num(input, 'count', 10);
+            const result = await execShell(`git log --oneline -${Math.min(100, Math.max(1, count))}`, ctx.cwd);
+            return {
+                ok: result.exitCode === 0,
+                summary: result.exitCode === 0 ? `${result.stdout.split('\n').filter(Boolean).length} recent commit(s).` : 'No commits yet.',
+                data: result.stdout
+            };
+        }
+    };
+    const git_branch = {
+        name: 'git_branch',
+        description: 'Create, list, or switch branches. mode: list | create | checkout.',
+        permissions: ['write'],
+        readonly: false,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                mode: { type: 'string', enum: ['list', 'create', 'checkout'] },
+                name: { type: 'string' }
+            },
+            required: ['mode']
+        },
+        async execute(input, ctx) {
+            const guard = await guardRepo(ctx);
+            if (guard)
+                return guard;
+            const mode = str(input, 'mode', 'list');
+            const name = str(input, 'name');
+            if (mode === 'list') {
+                const result = await execShell('git branch -a', ctx.cwd);
+                return { ok: result.exitCode === 0, summary: 'Branches listed.', data: result.stdout };
+            }
+            if (!name)
+                return fail(`Branch name is required for mode "${mode}".`, 'missing_name');
+            const cmd = mode === 'create' ? `git checkout -b ${shellQuote(name)}` : `git checkout ${shellQuote(name)}`;
+            const result = await execShell(cmd, ctx.cwd);
+            return {
+                ok: result.exitCode === 0,
+                summary: result.exitCode === 0 ? `${mode === 'create' ? 'Created and switched to' : 'Switched to'} branch ${name}.` : `Branch operation failed: ${result.stderr.trim()}`,
+                data: result.stderr
+            };
+        }
+    };
+    const git_worktree = {
+        name: 'git_worktree',
+        description: 'Manage Git worktrees. mode: list | add | remove. Used for isolated experimental work (e.g. Boost runs).',
+        permissions: ['write'],
+        readonly: false,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                mode: { type: 'string', enum: ['list', 'add', 'remove'] },
+                path: { type: 'string' },
+                branch: { type: 'string' }
+            },
+            required: ['mode']
+        },
+        async execute(input, ctx) {
+            const guard = await guardRepo(ctx);
+            if (guard)
+                return guard;
+            const mode = str(input, 'mode', 'list');
+            if (mode === 'list') {
+                const result = await execShell('git worktree list', ctx.cwd);
+                return { ok: result.exitCode === 0, summary: 'Worktrees listed.', data: result.stdout };
+            }
+            const wPath = str(input, 'path');
+            if (!wPath)
+                return fail('path is required for add/remove.', 'missing_path');
+            if (mode === 'add') {
+                const branch = str(input, 'branch') || `ineedcodes-${Date.now()}`;
+                const result = await execShell(`git worktree add -b ${shellQuote(branch)} ${shellQuote(wPath)}`, ctx.cwd);
+                return {
+                    ok: result.exitCode === 0,
+                    summary: result.exitCode === 0 ? `Created worktree ${wPath} on branch ${branch}.` : `Worktree add failed: ${result.stderr.trim()}`,
+                    data: { path: wPath, branch }
+                };
+            }
+            const result = await execShell(`git worktree remove ${shellQuote(wPath)} --force`, ctx.cwd);
+            return {
+                ok: result.exitCode === 0,
+                summary: result.exitCode === 0 ? `Removed worktree ${wPath}.` : `Worktree remove failed: ${result.stderr.trim()}`
+            };
+        }
+    };
+    const git_add = {
+        name: 'git_add',
+        description: 'Stage files for commit. Pass "*" to stage everything.',
+        permissions: ['write'],
+        readonly: false,
+        inputSchema: { type: 'object', properties: { paths: { type: 'string' } }, required: ['paths'] },
+        async execute(input, ctx) {
+            const guard = await guardRepo(ctx);
+            if (guard)
+                return guard;
+            const paths = str(input, 'paths', '.');
+            const result = await execShell(`git add ${paths === '*' ? '.' : shellQuote(paths)}`, ctx.cwd);
+            return {
+                ok: result.exitCode === 0,
+                summary: result.exitCode === 0 ? `Staged ${paths}.` : `git add failed: ${result.stderr.trim()}`
+            };
+        }
+    };
+    const git_commit = {
+        name: 'git_commit',
+        description: 'Create a commit from staged changes with the given message.',
+        permissions: ['write'],
+        readonly: false,
+        inputSchema: { type: 'object', properties: { message: { type: 'string' } }, required: ['message'] },
+        async execute(input, ctx) {
+            const guard = await guardRepo(ctx);
+            if (guard)
+                return guard;
+            const message = str(input, 'message');
+            if (!message.trim())
+                return fail('Commit message must not be empty.', 'empty_message');
+            const result = await execShell(`git commit -m ${shellQuote(message)}`, ctx.cwd);
+            return {
+                ok: result.exitCode === 0,
+                summary: result.exitCode === 0 ? `Committed: ${result.stdout.trim().split('\n')[0]}` : `Commit failed: ${result.stderr.trim()}`,
+                data: { stdout: result.stdout, stderr: result.stderr }
+            };
+        }
+    };
+    const git_restore = {
+        name: 'git_restore',
+        description: 'Discard unstaged changes in a file (git restore). Destructive: needs approval.',
+        permissions: ['write', 'destructive'],
+        readonly: false,
+        inputSchema: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] },
+        async execute(input, ctx) {
+            const guard = await guardRepo(ctx);
+            if (guard)
+                return guard;
+            const target = str(input, 'path');
+            const decision = await ctx.permissions.check(['destructive'], `discard changes in ${target}`);
+            if (!decision.allowed)
+                return fail(decision.reason, 'destructive_denied');
+            const result = await execShell(`git restore ${shellQuote(target)}`, ctx.cwd);
+            return {
+                ok: result.exitCode === 0,
+                summary: result.exitCode === 0 ? `Restored ${target} to last committed state.` : `git restore failed: ${result.stderr.trim()}`
+            };
+        }
+    };
+    const git_push = {
+        name: 'git_push',
+        description: 'Push commits to a remote. Requires git_remote permission; never runs automatically.',
+        permissions: ['git_remote'],
+        readonly: false,
+        inputSchema: {
+            type: 'object',
+            properties: { remote: { type: 'string' }, branch: { type: 'string' } }
+        },
+        async execute(input, ctx) {
+            const guard = await guardRepo(ctx);
+            if (guard)
+                return guard;
+            const remote = str(input, 'remote', 'origin');
+            const branch = str(input, 'branch');
+            const cmd = branch ? `git push ${shellQuote(remote)} ${shellQuote(branch)}` : `git push ${shellQuote(remote)}`;
+            const result = await execShell(cmd, ctx.cwd);
+            return {
+                ok: result.exitCode === 0,
+                summary: result.exitCode === 0 ? 'Pushed to remote.' : `Push failed: ${result.stderr.trim()}`,
+                data: { stdout: result.stdout, stderr: result.stderr }
+            };
+        }
+    };
+    return [
+        git_status, git_diff, git_log, git_branch, git_worktree,
+        git_add, git_commit, git_restore, git_push
+    ];
+}
+async function guardRepo(ctx) {
+    const cwd = resolvePath(ctx, '.');
+    const guard = await guardPath(ctx, cwd, false);
+    if (guard)
+        return guard;
+    return null;
+}
+//# sourceMappingURL=git.js.map

package/packages/core/dist/tools/git.js.map

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

package/packages/core/dist/tools/mcp.d.ts

@@ -0,0 +1,42 @@
+import { randomUUID } from 'node:crypto';
+import type { Tool } from '../types.js';
+/**
+ * Native MCP (Model Context Protocol) client over stdio.
+ * Connects to configured MCP servers, discovers their tools, and adapts
+ * them into the normal iNeedCodes tool registry (plan §28).
+ * Protocol: JSON-RPC 2.0, one JSON message per line.
+ */
+export interface MCPServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+interface MCPToolDef {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export declare class MCPConnection {
+    private readonly serverName;
+    private readonly config;
+    private child?;
+    private pending;
+    private buffer;
+    private nextId;
+    constructor(serverName: string, config: MCPServerConfig);
+    connect(timeoutMs?: number): Promise<void>;
+    private handleLine;
+    private request;
+    private notify;
+    listTools(): Promise<MCPToolDef[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    close(): void;
+}
+/** Adapt MCP tools into the iNeedCodes Tool interface. */
+export declare function connectMCPServer(serverName: string, config: MCPServerConfig): Promise<Tool[]>;
+/** Connect every configured MCP server; failures are reported, never fatal. */
+export declare function connectAllMCPServers(servers: Record<string, MCPServerConfig> | undefined): Promise<{
+    tools: Tool[];
+    errors: string[];
+}>;
+export { randomUUID };

package/packages/core/dist/tools/mcp.js

@@ -0,0 +1,158 @@
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+export class MCPConnection {
+    serverName;
+    config;
+    child;
+    pending = new Map();
+    buffer = '';
+    nextId = 1;
+    constructor(serverName, config) {
+        this.serverName = serverName;
+        this.config = config;
+    }
+    async connect(timeoutMs = 10_000) {
+        this.child = spawn(this.config.command, this.config.args ?? [], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env, ...this.config.env }
+        });
+        this.child.stdout?.on('data', (chunk) => {
+            this.buffer += chunk.toString('utf8');
+            let newline;
+            while ((newline = this.buffer.indexOf('\n')) >= 0) {
+                const line = this.buffer.slice(0, newline).trim();
+                this.buffer = this.buffer.slice(newline + 1);
+                if (line)
+                    this.handleLine(line);
+            }
+        });
+        this.child.stderr?.on('data', (chunk) => {
+            // Server logs go to our stderr for debugging; never into model context.
+            process.stderr.write(`[mcp:${this.serverName}] ${chunk.toString('utf8')}`);
+        });
+        this.child.on('exit', () => {
+            for (const pending of this.pending.values()) {
+                clearTimeout(pending.timer);
+                pending.reject(new Error(`MCP server "${this.serverName}" exited.`));
+            }
+            this.pending.clear();
+        });
+        await this.request('initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: 'ineedcodes', version: '0.1.0' }
+        }, timeoutMs);
+        this.notify('notifications/initialized', {});
+    }
+    handleLine(line) {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        if (msg.id !== undefined && this.pending.has(String(msg.id))) {
+            const pending = this.pending.get(String(msg.id));
+            this.pending.delete(String(msg.id));
+            clearTimeout(pending.timer);
+            if (msg.error) {
+                pending.reject(new Error(msg.error.message ?? 'MCP request failed'));
+            }
+            else {
+                pending.resolve(msg.result);
+            }
+        }
+    }
+    request(method, params, timeoutMs = 30_000) {
+        return new Promise((resolve, reject) => {
+            if (!this.child?.stdin?.writable) {
+                reject(new Error(`MCP server "${this.serverName}" is not connected.`));
+                return;
+            }
+            const id = String(this.nextId++);
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`MCP request ${method} timed out.`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            const msg = JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n';
+            this.child.stdin.write(msg);
+        });
+    }
+    notify(method, params) {
+        if (!this.child?.stdin?.writable)
+            return;
+        this.child.stdin.write(JSON.stringify({ jsonrpc: '2.0', method, params }) + '\n');
+    }
+    async listTools() {
+        const result = await this.request('tools/list', {});
+        return result.tools ?? [];
+    }
+    async callTool(name, args) {
+        return this.request('tools/call', { name, arguments: args }, 120_000);
+    }
+    close() {
+        try {
+            this.child?.kill('SIGTERM');
+        }
+        catch {
+            // best effort
+        }
+    }
+}
+/** Adapt MCP tools into the iNeedCodes Tool interface. */
+export async function connectMCPServer(serverName, config) {
+    const conn = new MCPConnection(serverName, config);
+    await conn.connect();
+    const defs = await conn.listTools();
+    const tools = defs.map((def) => {
+        const mcpName = `mcp_${serverName}_${def.name}`;
+        const tool = {
+            name: mcpName,
+            description: `[MCP:${serverName}] ${def.description ?? def.name}`,
+            inputSchema: def.inputSchema ?? { type: 'object', properties: {} },
+            permissions: ['read', 'execute'],
+            readonly: false,
+            async execute(input, ctx) {
+                void ctx;
+                try {
+                    const result = await conn.callTool(def.name, (input ?? {}));
+                    const text = (result.content ?? [])
+                        .map((c) => c.text ?? '')
+                        .filter(Boolean)
+                        .join('\n');
+                    return {
+                        ok: !result.isError,
+                        summary: text.split('\n')[0]?.slice(0, 200) ?? `MCP tool ${def.name} completed.`,
+                        data: text
+                    };
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    return { ok: false, summary: `MCP tool ${def.name} failed: ${message}`, error: 'mcp_error' };
+                }
+            }
+        };
+        return tool;
+    });
+    return tools;
+}
+/** Connect every configured MCP server; failures are reported, never fatal. */
+export async function connectAllMCPServers(servers) {
+    const tools = [];
+    const errors = [];
+    if (!servers)
+        return { tools, errors };
+    for (const [name, config] of Object.entries(servers)) {
+        try {
+            tools.push(...await connectMCPServer(name, config));
+        }
+        catch (err) {
+            errors.push(`MCP server "${name}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return { tools, errors };
+}
+export { randomUUID };
+//# sourceMappingURL=mcp.js.map

package/packages/core/dist/tools/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/tools/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA4BzC,MAAM,OAAO,aAAa;IAOL;IACA;IAPX,KAAK,CAAgB;IACrB,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,MAAM,GAAG,EAAE,CAAC;IACZ,MAAM,GAAG,CAAC,CAAC;IAEnB,YACmB,UAAkB,EAClB,MAAuB;QADvB,eAAU,GAAV,UAAU,CAAQ;QAClB,WAAM,GAAN,MAAM,CAAiB;IACvC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,SAAS,GAAG,MAAM;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE;YAC9D,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;SAC5C,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAC9C,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,OAAe,CAAC;YACpB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;gBAClD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBAC7C,IAAI,IAAI;oBAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAC9C,wEAAwE;YACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACzB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC5C,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC5B,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,UAAU,WAAW,CAAC,CAAC,CAAC;YACvE,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;YAC/B,eAAe,EAAE,YAAY;YAC7B,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE;SACrD,EAAE,SAAS,CAAC,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IAEO,UAAU,CAAC,IAAY;QAC7B,IAAI,GAA8F,CAAC;QACnG,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAE,CAAC;YAClD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACpC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,oBAAoB,CAAC,CAAC,CAAC;YACvE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,MAAc,EAAE,MAA+B,EAAE,SAAS,GAAG,MAAM;QACjF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,UAAU,qBAAqB,CAAC,CAAC,CAAC;gBACvE,OAAO;YACT,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACjC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,MAAM,aAAa,CAAC,CAAC,CAAC;YACxD,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACjD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;YAC1E,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,MAAc,EAAE,MAA+B;QAC5D,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ;YAAE,OAAO;QACzC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAA6B,CAAC;QAChF,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,IAA6B;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAED,KAAK;QACH,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;CACF;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,MAAuB;IAEvB,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACrB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;IAEpC,MAAM,KAAK,GAAW,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,OAAO,UAAU,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,GAAS;YACjB,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,QAAQ,UAAU,KAAK,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,EAAE;YACjE,WAAW,EAAG,GAAG,CAAC,WAAmC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;YAC3F,WAAW,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;YAChC,QAAQ,EAAE,KAAK;YACf,KAAK,CAAC,OAAO,CAAC,KAAgB,EAAE,GAAgB;gBAC9C,KAAK,GAAG,CAAC;gBACT,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAA4B,CAGpF,CAAC;oBACF,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;yBAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;yBACxB,MAAM,CAAC,OAAO,CAAC;yBACf,IAAI,CAAC,IAAI,CAAC,CAAC;oBACd,OAAO;wBACL,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO;wBACnB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,IAAI,aAAa;wBAChF,IAAI,EAAE,IAAI;qBACX,CAAC;gBACJ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,GAAG,CAAC,IAAI,YAAY,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;gBAC/F,CAAC;YACH,CAAC;SACF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAoD;IAEpD,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/packages/core/dist/tools/registry.d.ts

@@ -0,0 +1,21 @@
+import type { JsonValue, Tool, ToolContext, ToolResult } from '../types.js';
+/**
+ * The tool registry is the single source of truth for what the agent can do.
+ * Tools are model-independent: they receive JSON, return JSON.
+ */
+export declare class ToolRegistry {
+    private tools;
+    register(tool: Tool): void;
+    get(name: string): Tool | undefined;
+    has(name: string): boolean;
+    list(): Tool[];
+    names(): string[];
+    unregister(name: string): boolean;
+    /** JSON-schema list for the LLM provider. */
+    schemas(): {
+        name: string;
+        description: string;
+        inputSchema: Tool['inputSchema'];
+    }[];
+    execute(name: string, input: JsonValue, ctx: ToolContext): Promise<ToolResult>;
+}

package/packages/core/dist/tools/registry.js

@@ -0,0 +1,50 @@
+/**
+ * The tool registry is the single source of truth for what the agent can do.
+ * Tools are model-independent: they receive JSON, return JSON.
+ */
+export class ToolRegistry {
+    tools = new Map();
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool "${tool.name}" is already registered.`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    has(name) {
+        return this.tools.has(name);
+    }
+    list() {
+        return [...this.tools.values()];
+    }
+    names() {
+        return [...this.tools.keys()];
+    }
+    unregister(name) {
+        return this.tools.delete(name);
+    }
+    /** JSON-schema list for the LLM provider. */
+    schemas() {
+        return this.list().map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema
+        }));
+    }
+    async execute(name, input, ctx) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return { ok: false, summary: `Unknown tool: ${name}`, error: `unknown_tool:${name}` };
+        }
+        try {
+            return await tool.execute(input, ctx);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { ok: false, summary: `Tool "${name}" failed: ${message}`, error: message };
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/packages/core/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAExC,QAAQ,CAAC,IAAU;QACjB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,0BAA0B,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,6CAA6C;IAC7C,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,KAAgB,EAAE,GAAgB;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,IAAI,EAAE,EAAE,KAAK,EAAE,gBAAgB,IAAI,EAAE,EAAE,CAAC;QACxF,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,IAAI,aAAa,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACrF,CAAC;IACH,CAAC;CACF"}

package/packages/core/dist/tools/search.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '../types.js';
+export declare function createSearchTools(): Tool[];