forage-mcp 0.1.0

package/dist/server.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { forage_search } from "./tools/search.js";
+import { forage_evaluate } from "./tools/evaluate.js";
+import { forage_install } from "./tools/install.js";
+import { forage_learn } from "./tools/learn.js";
+import { forage_status } from "./tools/status.js";
+import { forage_uninstall } from "./tools/uninstall.js";
+import { callTool, startServer, stopAll, getRunningServers } from "./proxy/manager.js";
+import { listTools } from "./persistence/manifest.js";
+const server = new McpServer({
+    name: "forage",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: { listChanged: true },
+    },
+});
+// Track dynamically registered proxied tools so we can remove them
+const proxiedToolHandles = new Map();
+// ── forage_search ──────────────────────────────────────────────
+server.tool("forage_search", "Search for MCP servers and tools across registries (Official MCP Registry, Smithery, npm). Describe what capability you need and get ranked results.", {
+    query: z.string().describe("Natural language description of the capability you need (e.g. 'query postgres database', 'search slack messages', 'manage github issues')"),
+    sources: z
+        .array(z.enum(["official-registry", "npm", "smithery"]))
+        .optional()
+        .describe("Which registries to search. Defaults to all."),
+}, async ({ query, sources }) => {
+    const result = await forage_search({ query, sources });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ── forage_evaluate ────────────────────────────────────────────
+server.tool("forage_evaluate", "Get detailed information about a specific package — version, downloads, README summary, install command. Use this before installing to verify quality.", {
+    packageName: z.string().describe("npm package name to evaluate (e.g. '@modelcontextprotocol/server-postgres')"),
+}, async ({ packageName }) => {
+    const result = await forage_evaluate({ packageName });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ── forage_install ─────────────────────────────────────────────
+server.tool("forage_install", "Install an MCP server and start it as a proxied subprocess. The server's tools become available immediately via Forage — no restart needed. IMPORTANT: Set confirm=true to proceed with installation (user will be prompted to approve the tool call).", {
+    packageName: z.string().describe("npm package name to install (e.g. '@modelcontextprotocol/server-filesystem')"),
+    command: z.string().optional().describe("Command to run the server. Defaults to 'npx'."),
+    args: z.array(z.string()).optional().describe("Arguments for the command. Defaults to ['-y', packageName]."),
+    env: z.record(z.string(), z.string()).optional().describe("Environment variables to pass to the server process."),
+    confirm: z.boolean().describe("Must be true to proceed with installation. This is a safety gate — the user will see and approve the tool call."),
+}, async ({ packageName, command, args, env, confirm }) => {
+    const result = await forage_install({ packageName, command, args, env, confirm });
+    // If installation was successful, register proxied tools and notify
+    if (result.success) {
+        registerProxiedTools(result.name);
+        server.sendToolListChanged();
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ── forage_learn ───────────────────────────────────────────────
+server.tool("forage_learn", "Write usage instructions for an installed tool to agent rule files (CLAUDE.md, AGENTS.md, .cursor/rules/). This persists knowledge across sessions so the agent remembers how to use the tool next time.", {
+    toolName: z.string().describe("Name of the tool (as shown in forage_status)"),
+    rules: z.string().describe("Markdown-formatted usage instructions for the agent. Include: when to use the tool, key commands/patterns, any required env vars or config."),
+    target: z.string().optional().describe("Specific file path to write to. If omitted, auto-detects based on which agent is in use."),
+}, async ({ toolName, rules, target }) => {
+    const result = await forage_learn({ toolName, rules, target });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ── forage_status ──────────────────────────────────────────────
+server.tool("forage_status", "List all tools that Forage has installed and is currently proxying. Shows which servers are running, what tools they provide, and their install status.", {}, async () => {
+    const result = await forage_status();
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ── forage_uninstall ───────────────────────────────────────────
+server.tool("forage_uninstall", "Remove a previously installed tool. Stops the server, removes from manifest, and cleans up agent rules. Set confirm=true to proceed.", {
+    name: z.string().describe("Name of the installed tool to remove (as shown in forage_status)"),
+    confirm: z.boolean().optional().describe("Must be true to proceed with uninstallation."),
+}, async ({ name, confirm }) => {
+    const result = await forage_uninstall({ name, confirm });
+    if (result.success) {
+        unregisterProxiedTools(name);
+        server.sendToolListChanged();
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ── Dynamic tool registration for proxied servers ──────────────
+function sanitizeName(name) {
+    return name.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+function registerProxiedTools(serverName) {
+    const servers = getRunningServers();
+    const managed = servers.get(serverName);
+    if (!managed)
+        return;
+    const handles = [];
+    for (const tool of managed.tools) {
+        const wrappedName = `foraged__${sanitizeName(serverName)}__${tool.name}`;
+        const description = `[via ${serverName}] ${tool.description ?? ""}`.trim();
+        // Register a dynamic tool that proxies to the child server
+        const handle = server.tool(wrappedName, description, {}, // Accept any args — the child server validates
+        async (args) => {
+            const result = await callTool(serverName, tool.name, args);
+            // The result from callTool is already in MCP format
+            return result;
+        });
+        handles.push(handle);
+    }
+    proxiedToolHandles.set(serverName, handles);
+}
+function unregisterProxiedTools(serverName) {
+    const handles = proxiedToolHandles.get(serverName);
+    if (!handles)
+        return;
+    for (const handle of handles) {
+        handle.remove();
+    }
+    proxiedToolHandles.delete(serverName);
+}
+// ── Startup ────────────────────────────────────────────────────
+async function autoStartFromManifest() {
+    const tools = await listTools();
+    const autoStartTools = tools.filter((t) => t.autoStart);
+    if (autoStartTools.length > 0) {
+        process.stderr.write(`[forage] Auto-starting ${autoStartTools.length} tool(s) from manifest...\n`);
+    }
+    for (const tool of autoStartTools) {
+        try {
+            const managed = await startServer(tool);
+            registerProxiedTools(tool.name);
+            process.stderr.write(`[forage] Started ${tool.name} (${managed.tools.length} tools)\n`);
+        }
+        catch (error) {
+            process.stderr.write(`[forage] Failed to start ${tool.name}: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    }
+}
+async function main() {
+    // Auto-start previously installed tools
+    await autoStartFromManifest();
+    // Connect to the MCP transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write("[forage] MCP server running on stdio\n");
+    // Clean up on exit
+    process.on("SIGINT", async () => {
+        await stopAll();
+        process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+        await stopAll();
+        process.exit(0);
+    });
+}
+main().catch((error) => {
+    process.stderr.write(`[forage] Fatal error: ${error}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/evaluate.d.ts

@@ -0,0 +1,17 @@
+export interface EvaluateInput {
+    packageName: string;
+}
+export interface EvaluateResult {
+    name: string;
+    description: string;
+    version: string;
+    repository?: string;
+    weeklyDownloads?: number;
+    readme?: string;
+    installCommand?: string;
+    source: string;
+}
+export declare function forage_evaluate(input: EvaluateInput): Promise<EvaluateResult | {
+    error: string;
+}>;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/tools/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/tools/evaluate.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B7C"}

package/dist/tools/evaluate.js

@@ -0,0 +1,31 @@
+import { getServerDetails } from "../registries/official.js";
+import { getPackageDetails } from "../registries/npm.js";
+export async function forage_evaluate(input) {
+    // Try official registry first
+    const official = await getServerDetails(input.packageName);
+    const npm = await getPackageDetails(input.packageName);
+    if (!official && !npm) {
+        return { error: `Package "${input.packageName}" not found in any registry` };
+    }
+    const npmPkg = official?.packages?.find((p) => p.registryType === "npm");
+    // Truncate README to something reasonable for an LLM
+    let readme = npm?.readme;
+    if (readme && readme.length > 3000) {
+        readme = readme.slice(0, 3000) + "\n\n... (truncated)";
+    }
+    return {
+        name: official?.name ?? input.packageName,
+        description: official?.description ?? npm?.description ?? "",
+        version: npm?.version ?? npmPkg?.version ?? official?.version ?? "unknown",
+        repository: npm?.repository ?? official?.repository?.url,
+        weeklyDownloads: npm?.weeklyDownloads,
+        readme,
+        installCommand: npmPkg
+            ? `npx -y ${npmPkg.identifier}`
+            : npm
+                ? `npx -y ${input.packageName}`
+                : undefined,
+        source: official ? "official-registry" : "npm",
+    };
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/tools/evaluate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../src/tools/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAiBzD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAoB;IAEpB,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAEvD,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,YAAY,KAAK,CAAC,WAAW,6BAA6B,EAAE,CAAC;IAC/E,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC;IAEzE,qDAAqD;IACrD,IAAI,MAAM,GAAG,GAAG,EAAE,MAAM,CAAC;IACzB,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QACnC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,qBAAqB,CAAC;IACzD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAC,WAAW;QACzC,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,GAAG,EAAE,WAAW,IAAI,EAAE;QAC5D,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,MAAM,EAAE,OAAO,IAAI,QAAQ,EAAE,OAAO,IAAI,SAAS;QAC1E,UAAU,EAAE,GAAG,EAAE,UAAU,IAAI,QAAQ,EAAE,UAAU,EAAE,GAAG;QACxD,eAAe,EAAE,GAAG,EAAE,eAAe;QACrC,MAAM;QACN,cAAc,EAAE,MAAM;YACpB,CAAC,CAAC,UAAU,MAAM,CAAC,UAAU,EAAE;YAC/B,CAAC,CAAC,GAAG;gBACH,CAAC,CAAC,UAAU,KAAK,CAAC,WAAW,EAAE;gBAC/B,CAAC,CAAC,SAAS;QACf,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK;KAC/C,CAAC;AACJ,CAAC"}

package/dist/tools/install.d.ts

@@ -0,0 +1,18 @@
+export interface InstallInput {
+    packageName: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    confirm?: boolean;
+}
+export interface InstallResult {
+    success: boolean;
+    name: string;
+    tools: Array<{
+        name: string;
+        description?: string;
+    }>;
+    message: string;
+}
+export declare function forage_install(input: InstallInput): Promise<InstallResult>;
+//# sourceMappingURL=install.d.ts.map

package/dist/tools/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/tools/install.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,aAAa,CAAC,CA6FxB"}

package/dist/tools/install.js

@@ -0,0 +1,91 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { startServer } from "../proxy/manager.js";
+import { addTool } from "../persistence/manifest.js";
+import { appendLog } from "../persistence/log.js";
+const execAsync = promisify(exec);
+export async function forage_install(input) {
+    if (!input.confirm) {
+        return {
+            success: false,
+            name: input.packageName,
+            tools: [],
+            message: `⚠️  Install requires confirmation. Call forage_install again with confirm: true to install "${input.packageName}". The user will be prompted to approve.`,
+        };
+    }
+    const command = input.command ?? "npx";
+    const args = input.args ?? ["-y", input.packageName];
+    // Verify the package exists on npm before installing
+    try {
+        const { stdout } = await execAsync(`npm view ${input.packageName} name version --json`, { timeout: 15000 });
+        JSON.parse(stdout); // validates it's real
+    }
+    catch {
+        await appendLog({
+            timestamp: new Date().toISOString(),
+            action: "install",
+            packageName: input.packageName,
+            success: false,
+            error: "Package not found on npm",
+        });
+        return {
+            success: false,
+            name: input.packageName,
+            tools: [],
+            message: `Package "${input.packageName}" not found on npm.`,
+        };
+    }
+    // Create the tool record
+    const tool = {
+        name: input.packageName.replace(/^@/, "").replace(/\//g, "__"),
+        packageName: input.packageName,
+        version: "latest",
+        source: "npm",
+        command,
+        args,
+        env: input.env,
+        autoStart: true,
+        installedAt: new Date().toISOString(),
+    };
+    try {
+        // Start the server as a child process
+        const managed = await startServer(tool);
+        // Save to manifest
+        await addTool(tool);
+        // Log the install
+        await appendLog({
+            timestamp: new Date().toISOString(),
+            action: "install",
+            packageName: input.packageName,
+            version: tool.version,
+            source: tool.source,
+            success: true,
+        });
+        return {
+            success: true,
+            name: tool.name,
+            tools: managed.tools.map((t) => ({
+                name: t.name,
+                description: t.description,
+            })),
+            message: `Installed and started "${input.packageName}". ${managed.tools.length} tools now available. Use forage_learn to save usage instructions for future sessions.`,
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        await appendLog({
+            timestamp: new Date().toISOString(),
+            action: "install",
+            packageName: input.packageName,
+            success: false,
+            error: errorMsg,
+        });
+        return {
+            success: false,
+            name: input.packageName,
+            tools: [],
+            message: `Failed to start "${input.packageName}": ${errorMsg}`,
+        };
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/tools/install.js.map

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

package/dist/tools/learn.d.ts

@@ -0,0 +1,12 @@
+export interface LearnToolInput {
+    toolName: string;
+    rules: string;
+    target?: string;
+}
+export interface LearnResult {
+    success: boolean;
+    updatedFiles: string[];
+    message: string;
+}
+export declare function forage_learn(input: LearnToolInput): Promise<LearnResult>;
+//# sourceMappingURL=learn.d.ts.map

package/dist/tools/learn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn.d.ts","sourceRoot":"","sources":["../../src/tools/learn.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CA4B9E"}

package/dist/tools/learn.js

@@ -0,0 +1,31 @@
+import { writeRules } from "../rules/writer.js";
+import { readManifest, writeManifest } from "../persistence/manifest.js";
+export async function forage_learn(input) {
+    try {
+        const updatedFiles = await writeRules({
+            toolName: input.toolName,
+            rules: input.rules,
+            target: input.target,
+        });
+        // Also persist rules in manifest for cross-session recall
+        const manifest = await readManifest();
+        const tool = manifest.tools[input.toolName];
+        if (tool) {
+            tool.rules = input.rules;
+            await writeManifest(manifest);
+        }
+        return {
+            success: true,
+            updatedFiles,
+            message: `Updated ${updatedFiles.length} file(s) with usage instructions for "${input.toolName}": ${updatedFiles.join(", ")}`,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            updatedFiles: [],
+            message: `Failed to write rules: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+//# sourceMappingURL=learn.js.map

package/dist/tools/learn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn.js","sourceRoot":"","sources":["../../src/tools/learn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAmB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAczE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAqB;IACtD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC;YACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;QAEH,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YACzB,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY;YACZ,OAAO,EAAE,WAAW,YAAY,CAAC,MAAM,yCAAyC,KAAK,CAAC,QAAQ,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC9H,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,EAAE;YAChB,OAAO,EAAE,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SAC5F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/search.d.ts

@@ -0,0 +1,10 @@
+import type { SearchResult } from "../registries/types.js";
+export interface SearchInput {
+    query: string;
+    sources?: Array<"official-registry" | "npm" | "smithery">;
+}
+export declare function forage_search(input: SearchInput): Promise<{
+    results: SearchResult[];
+    query: string;
+}>;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC,mBAAmB,GAAG,KAAK,GAAG,UAAU,CAAC,CAAC;CAC3D;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAC/D,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAoCD"}

package/dist/tools/search.js

@@ -0,0 +1,50 @@
+import { searchOfficial } from "../registries/official.js";
+import { searchNpm } from "../registries/npm.js";
+import { searchSmithery } from "../registries/smithery.js";
+export async function forage_search(input) {
+    const sources = input.sources ?? ["official-registry", "npm", "smithery"];
+    const searches = [];
+    if (sources.includes("official-registry")) {
+        searches.push(searchOfficial(input.query));
+    }
+    if (sources.includes("npm")) {
+        searches.push(searchNpm(input.query));
+    }
+    if (sources.includes("smithery")) {
+        searches.push(searchSmithery(input.query));
+    }
+    const allResults = await Promise.all(searches);
+    const flat = allResults.flat();
+    // Deduplicate by package name, preferring official registry results
+    const seen = new Map();
+    for (const result of flat) {
+        if (!result.packageName)
+            continue;
+        const key = result.packageName.toLowerCase();
+        const existing = seen.get(key);
+        if (!existing || sourceRank(result.source) < sourceRank(existing.source)) {
+            seen.set(key, result);
+        }
+    }
+    const results = [...seen.values()].sort((a, b) => {
+        // Sort by source priority first, then by name
+        const rankDiff = sourceRank(a.source) - sourceRank(b.source);
+        if (rankDiff !== 0)
+            return rankDiff;
+        return a.name.localeCompare(b.name);
+    });
+    return { results, query: input.query };
+}
+function sourceRank(source) {
+    switch (source) {
+        case "official-registry":
+            return 0;
+        case "smithery":
+            return 1;
+        case "npm":
+            return 2;
+        default:
+            return 3;
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQ3D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAkB;IAIpD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,mBAAmB,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAE1E,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAE/B,oEAAoE;IACpE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC7C,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,SAAS;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC/C,8CAA8C;QAC9C,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QACpC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,UAAU,CAAC,MAAc;IAChC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,mBAAmB;YACtB,OAAO,CAAC,CAAC;QACX,KAAK,UAAU;YACb,OAAO,CAAC,CAAC;QACX,KAAK,KAAK;YACR,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/tools/status.d.ts

@@ -0,0 +1,20 @@
+export interface StatusResult {
+    running: Array<{
+        name: string;
+        packageName: string;
+        tools: Array<{
+            name: string;
+            description?: string;
+        }>;
+        installedAt: string;
+    }>;
+    installed: Array<{
+        name: string;
+        packageName: string;
+        autoStart: boolean;
+        installedAt: string;
+        running: boolean;
+    }>;
+}
+export declare function forage_status(): Promise<StatusResult>;
+//# sourceMappingURL=status.d.ts.map

package/dist/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACrD,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC,CAyB3D"}

package/dist/tools/status.js

@@ -0,0 +1,24 @@
+import { getRunningServers } from "../proxy/manager.js";
+import { listTools } from "../persistence/manifest.js";
+export async function forage_status() {
+    const allInstalled = await listTools();
+    const runningServers = getRunningServers();
+    const running = [...runningServers.entries()].map(([name, server]) => ({
+        name,
+        packageName: allInstalled.find((t) => t.name === name)?.packageName ?? name,
+        tools: server.tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+        })),
+        installedAt: allInstalled.find((t) => t.name === name)?.installedAt ?? "unknown",
+    }));
+    const installed = allInstalled.map((tool) => ({
+        name: tool.name,
+        packageName: tool.packageName,
+        autoStart: tool.autoStart,
+        installedAt: tool.installedAt,
+        running: runningServers.has(tool.name),
+    }));
+    return { running, installed };
+}
+//# sourceMappingURL=status.js.map

package/dist/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAkBvD,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,YAAY,GAAG,MAAM,SAAS,EAAE,CAAC;IACvC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,MAAM,OAAO,GAAG,CAAC,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,IAAI;QACJ,WAAW,EACT,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,WAAW,IAAI,IAAI;QAChE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;QACH,WAAW,EACT,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,WAAW,IAAI,SAAS;KACtE,CAAC,CAAC,CAAC;IAEJ,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5C,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;KACvC,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC"}

package/dist/tools/uninstall.d.ts

@@ -0,0 +1,11 @@
+export interface UninstallInput {
+    name: string;
+    confirm?: boolean;
+}
+export interface UninstallResult {
+    success: boolean;
+    message: string;
+    cleanedFiles: string[];
+}
+export declare function forage_uninstall(input: UninstallInput): Promise<UninstallResult>;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/tools/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../src/tools/uninstall.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,eAAe,CAAC,CAqD1B"}

package/dist/tools/uninstall.js

@@ -0,0 +1,55 @@
+import { stopServer } from "../proxy/manager.js";
+import { removeTool, getTool } from "../persistence/manifest.js";
+import { removeRules } from "../rules/writer.js";
+import { appendLog } from "../persistence/log.js";
+export async function forage_uninstall(input) {
+    if (!input.confirm) {
+        const tool = await getTool(input.name);
+        if (!tool) {
+            return {
+                success: false,
+                message: `Tool "${input.name}" is not installed.`,
+                cleanedFiles: [],
+            };
+        }
+        return {
+            success: false,
+            message: `⚠️  Uninstall requires confirmation. Call forage_uninstall again with confirm: true to remove "${input.name}" (${tool.packageName}).`,
+            cleanedFiles: [],
+        };
+    }
+    try {
+        // Stop the running server
+        await stopServer(input.name);
+        // Remove from manifest
+        const tool = await removeTool(input.name);
+        if (!tool) {
+            return {
+                success: false,
+                message: `Tool "${input.name}" is not installed.`,
+                cleanedFiles: [],
+            };
+        }
+        // Clean up rules from agent files
+        const cleanedFiles = await removeRules(input.name);
+        await appendLog({
+            timestamp: new Date().toISOString(),
+            action: "uninstall",
+            packageName: tool.packageName,
+            success: true,
+        });
+        return {
+            success: true,
+            message: `Uninstalled "${input.name}" (${tool.packageName}). Stopped server and cleaned up rules.`,
+            cleanedFiles,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Failed to uninstall: ${error instanceof Error ? error.message : String(error)}`,
+            cleanedFiles: [],
+        };
+    }
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/tools/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../src/tools/uninstall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAalD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAqB;IAErB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,SAAS,KAAK,CAAC,IAAI,qBAAqB;gBACjD,YAAY,EAAE,EAAE;aACjB,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,kGAAkG,KAAK,CAAC,IAAI,MAAM,IAAI,CAAC,WAAW,IAAI;YAC/I,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7B,uBAAuB;QACvB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,SAAS,KAAK,CAAC,IAAI,qBAAqB;gBACjD,YAAY,EAAE,EAAE;aACjB,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEnD,MAAM,SAAS,CAAC;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,WAAW;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,gBAAgB,KAAK,CAAC,IAAI,MAAM,IAAI,CAAC,WAAW,yCAAyC;YAClG,YAAY;SACb,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YACzF,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;AACH,CAAC"}