pudu-ai 0.2.22 → 0.2.23

package/dist/cli/chunk-473MNTMS.js

@@ -0,0 +1,24 @@
+// src/shared/format.ts
+function formatNumber(value, digits = 1) {
+  if (value === void 0 || Number.isNaN(value)) return "N/A";
+  return value.toFixed(digits);
+}
+function formatPercent(value, digits = 0) {
+  if (value === void 0 || Number.isNaN(value)) return "N/A";
+  return `${value.toFixed(digits)} %`;
+}
+function formatTokensPerSec(value, digits = 1) {
+  if (value === void 0 || Number.isNaN(value)) return "N/A";
+  return `${value.toFixed(digits)} t/s`;
+}
+function na(value) {
+  if (value === void 0 || value === null || value === "") return "N/A";
+  return String(value);
+}
+
+export {
+  formatNumber,
+  formatPercent,
+  formatTokensPerSec,
+  na
+};

package/dist/cli/chunk-47LK5I2X.js

@@ -0,0 +1,39 @@
+// src/integrations/catalog.ts
+var INTEGRATIONS = {
+  opencode: {
+    id: "opencode",
+    docsUrl: "https://docs.ollama.com/integrations/opencode",
+    ollamaLaunch: "opencode",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A", "B"],
+    useCases: ["code", "chat", "reasoning"]
+  },
+  openclaw: {
+    id: "openclaw",
+    docsUrl: "https://docs.ollama.com/integrations/openclaw",
+    ollamaLaunch: "openclaw",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A", "B"],
+    useCases: ["code", "chat", "reasoning"]
+  },
+  hermes: {
+    id: "hermes",
+    docsUrl: "https://docs.ollama.com/integrations/hermes",
+    ollamaLaunch: "hermes",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A"],
+    useCases: ["code", "chat", "reasoning"]
+  },
+  claude: {
+    id: "claude",
+    docsUrl: "https://docs.ollama.com/integrations/claude-code",
+    ollamaLaunch: "claude",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A", "B"],
+    useCases: ["code", "chat", "reasoning"]
+  }
+};
+
+export {
+  INTEGRATIONS
+};

package/dist/cli/{chunk-6NXOK4OD.js → chunk-4VEDGI4L.js}

@@ -49,6 +49,9 @@ var en = {
   repoHarnessEnter: "Enter = pick local model from effort   Esc = back",
   repoHarnessNoPrompt: "(empty prompt \u2014 effort is still from the graph)",
   repoHarnessModel: "BEST LOCAL MODEL FOR THIS TASK",
+  repoHarnessKeys: "1 OpenCode  2 Hermes  3 OpenClaw  Enter=OpenCode  Esc=back",
+  repoHarnessNoTag: "No Ollama tag for this model. N/A \u2014 will not invent a launch command.",
+  repoHarnessWroteConfig: "Wrote OpenCode config {file} (local model + pudu-ai MCP tools).",
   repoHelp: `Pudu Agent Lab \u2014 repository search, graph, harness
 
 Usage:
@@ -296,6 +299,9 @@ var es = {
   repoHarnessEnter: "Enter = elegir modelo local seg\xFAn esfuerzo   Esc = atr\xE1s",
   repoHarnessNoPrompt: "(prompt vac\xEDo \u2014 el esfuerzo sigue saliendo del grafo)",
   repoHarnessModel: "MEJOR MODELO LOCAL PARA ESTA TAREA",
+  repoHarnessKeys: "1 OpenCode  2 Hermes  3 OpenClaw  Enter=OpenCode  Esc=atr\xE1s",
+  repoHarnessNoTag: "Este modelo no tiene tag Ollama. N/A \u2014 no se inventa el comando de launch.",
+  repoHarnessWroteConfig: "Config OpenCode escrita en {file} (modelo local + tools MCP pudu-ai).",
   repoHelp: `Pudu Agent Lab \u2014 b\xFAsqueda, grafo y harness
 
 Uso:
@@ -513,30 +519,8 @@ function t(id, vars) {
   return text;
 }
 
-// src/shared/format.ts
-function formatNumber(value, digits = 1) {
-  if (value === void 0 || Number.isNaN(value)) return "N/A";
-  return value.toFixed(digits);
-}
-function formatPercent(value, digits = 0) {
-  if (value === void 0 || Number.isNaN(value)) return "N/A";
-  return `${value.toFixed(digits)} %`;
-}
-function formatTokensPerSec(value, digits = 1) {
-  if (value === void 0 || Number.isNaN(value)) return "N/A";
-  return `${value.toFixed(digits)} t/s`;
-}
-function na(value) {
-  if (value === void 0 || value === null || value === "") return "N/A";
-  return String(value);
-}
-
 export {
   resolveLocale,
   setLocale,
-  t,
-  formatNumber,
-  formatPercent,
-  formatTokensPerSec,
-  na
+  t
 };

package/dist/cli/{chunk-PX7BJDD3.js → chunk-6BGYI7XY.js}

@@ -1,9 +1,14 @@
+import {
+  INTEGRATIONS
+} from "./chunk-47LK5I2X.js";
 import {
   formatNumber,
   formatTokensPerSec,
-  na,
+  na
+} from "./chunk-473MNTMS.js";
+import {
   t
-} from "./chunk-6NXOK4OD.js";
+} from "./chunk-4VEDGI4L.js";
 import {
   commandExists,
   runCommand,
@@ -1053,42 +1058,6 @@ function tasksText(plans, answers) {
   return [...header, ...blocks].join("\n\n");
 }
 
-// src/integrations/catalog.ts
-var INTEGRATIONS = {
-  opencode: {
-    id: "opencode",
-    docsUrl: "https://docs.ollama.com/integrations/opencode",
-    ollamaLaunch: "opencode",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A", "B"],
-    useCases: ["code", "chat", "reasoning"]
-  },
-  openclaw: {
-    id: "openclaw",
-    docsUrl: "https://docs.ollama.com/integrations/openclaw",
-    ollamaLaunch: "openclaw",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A", "B"],
-    useCases: ["code", "chat", "reasoning"]
-  },
-  hermes: {
-    id: "hermes",
-    docsUrl: "https://docs.ollama.com/integrations/hermes",
-    ollamaLaunch: "hermes",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A"],
-    useCases: ["code", "chat", "reasoning"]
-  },
-  claude: {
-    id: "claude",
-    docsUrl: "https://docs.ollama.com/integrations/claude-code",
-    ollamaLaunch: "claude",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A", "B"],
-    useCases: ["code", "chat", "reasoning"]
-  }
-};
-
 // src/integrations/ollama-tags.ts
 var RULES = [
   { test: /qwen\s*3\.5\s*[-:]?\s*8b/i, tag: "qwen3.5:8b" },

package/dist/cli/{chunk-LL5FQT7I.js → chunk-7KPNGK6A.js}

@@ -53,26 +53,9 @@ function parseJsonStdout(stdout) {
   return JSON.parse(slice);
 }
 
-// src/agent-lab/graph.ts
-async function buildRepoGraph(repo, timeoutMs = 6e4) {
-  const invoked = await invokePuduAgent({ op: "graph", repo }, timeoutMs);
-  if (invoked.timedOut) throw new Error("Python graph engine timed out");
-  const parsed = parseJsonStdout(invoked.stdout);
-  if (!parsed || parsed.ok === false) {
-    throw new Error(parsed.error ?? "graph failed");
-  }
-  return parsed;
-}
-async function runRepoHarness(repo, task, timeoutMs = 6e4) {
-  const invoked = await invokePuduAgent({ op: "harness", repo, task }, timeoutMs);
-  if (invoked.timedOut) throw new Error("Python harness engine timed out");
-  return parseJsonStdout(invoked.stdout);
-}
-
 export {
+  pythonRoot,
   findPython,
   invokePuduAgent,
-  parseJsonStdout,
-  buildRepoGraph,
-  runRepoHarness
+  parseJsonStdout
 };

package/dist/cli/chunk-XEEGLMVT.js

@@ -0,0 +1,25 @@
+import {
+  invokePuduAgent,
+  parseJsonStdout
+} from "./chunk-7KPNGK6A.js";
+
+// src/agent-lab/graph.ts
+async function buildRepoGraph(repo, timeoutMs = 6e4) {
+  const invoked = await invokePuduAgent({ op: "graph", repo }, timeoutMs);
+  if (invoked.timedOut) throw new Error("Python graph engine timed out");
+  const parsed = parseJsonStdout(invoked.stdout);
+  if (!parsed || parsed.ok === false) {
+    throw new Error(parsed.error ?? "graph failed");
+  }
+  return parsed;
+}
+async function runRepoHarness(repo, task, timeoutMs = 6e4) {
+  const invoked = await invokePuduAgent({ op: "harness", repo, task }, timeoutMs);
+  if (invoked.timedOut) throw new Error("Python harness engine timed out");
+  return parseJsonStdout(invoked.stdout);
+}
+
+export {
+  buildRepoGraph,
+  runRepoHarness
+};

package/dist/cli/harness-launch-KEUKZZXH.js

@@ -0,0 +1,118 @@
+import {
+  INTEGRATIONS
+} from "./chunk-47LK5I2X.js";
+import {
+  findPython,
+  pythonRoot
+} from "./chunk-7KPNGK6A.js";
+import {
+  t
+} from "./chunk-4VEDGI4L.js";
+import {
+  commandExists,
+  runCommand
+} from "./chunk-SS7OXXQQ.js";
+
+// src/integrations/opencode-config.ts
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+function mergeOpenCodeHarness(existing, ollamaTag, pythonBin, engineRoot) {
+  const prev = existing ?? {};
+  const provider = prev.provider ?? {};
+  const ollama = provider.ollama ?? {};
+  const models = ollama.models ?? {};
+  const mcp = prev.mcp ?? {};
+  return {
+    ...prev,
+    $schema: typeof prev.$schema === "string" ? prev.$schema : "https://opencode.ai/config.json",
+    model: `ollama/${ollamaTag}`,
+    provider: {
+      ...provider,
+      ollama: {
+        ...ollama,
+        npm: "@ai-sdk/openai-compatible",
+        name: typeof ollama.name === "string" ? ollama.name : "Ollama (local)",
+        options: {
+          ...ollama.options ?? {},
+          baseURL: "http://127.0.0.1:11434/v1"
+        },
+        models: {
+          ...models,
+          [ollamaTag]: {
+            ...models[ollamaTag] ?? {},
+            name: ollamaTag
+          }
+        }
+      }
+    },
+    mcp: {
+      ...mcp,
+      "pudu-ai": {
+        type: "local",
+        enabled: true,
+        timeout: 12e4,
+        command: [pythonBin, "-m", "pudu_agent", "mcp"],
+        environment: { PYTHONPATH: engineRoot, PYTHONUNBUFFERED: "1" }
+      }
+    }
+  };
+}
+async function writeOpenCodeHarnessConfig(input) {
+  const file = path.join(input.repo, "opencode.json");
+  let existing;
+  try {
+    const raw = await readFile(file, "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      existing = parsed;
+    }
+  } catch {
+    existing = void 0;
+  }
+  const next = mergeOpenCodeHarness(existing, input.ollamaTag, input.pythonBin, pythonRoot());
+  await mkdir(input.repo, { recursive: true });
+  await writeFile(file, `${JSON.stringify(next, null, 2)}
+`, "utf8");
+  return file;
+}
+
+// src/integrations/harness-launch.ts
+async function executeHarnessLaunch(req) {
+  const def = INTEGRATIONS[req.tool];
+  if (!def) return { ok: false, log: t("launchUnknown") };
+  const ollama = await commandExists("ollama");
+  if (!ollama) return { ok: false, log: t("launchNeedOllama") };
+  const lines = [];
+  if (req.tool === "opencode") {
+    const python = await findPython();
+    if (!python) return { ok: false, log: t("repoPythonMissing") };
+    const file = await writeOpenCodeHarnessConfig({
+      repo: req.repo,
+      ollamaTag: req.ollamaTag,
+      pythonBin: python
+    });
+    lines.push(t("repoHarnessWroteConfig", { file }));
+    const bin = await commandExists("opencode");
+    if (bin) {
+      lines.push(`${bin}  (${req.ollamaTag})`);
+      const launched2 = await runCommand(bin, [], { cwd: req.repo, timeout: 0, stdio: "inherit" });
+      if (launched2.exitCode !== 0) {
+        return { ok: false, log: `${lines.join("\n")}
+${launched2.stderr || t("launchExecFail")}` };
+      }
+      return { ok: true, log: lines.join("\n") };
+    }
+  }
+  const args = ["launch", def.ollamaLaunch, "--model", req.ollamaTag];
+  if (def.id === "openclaw" || def.id === "claude") args.push("--yes");
+  lines.push(`ollama ${args.join(" ")}`);
+  const launched = await runCommand("ollama", args, { timeout: 0, stdio: "inherit", cwd: req.repo });
+  if (launched.exitCode !== 0) {
+    return { ok: false, log: `${lines.join("\n")}
+${launched.stderr || t("launchExecFail")}` };
+  }
+  return { ok: true, log: lines.join("\n") };
+}
+export {
+  executeHarnessLaunch
+};

package/dist/cli/index.js

@@ -32,12 +32,14 @@ import {
   runBenchmark,
   runtimesText,
   tasksText
-} from "./chunk-PX7BJDD3.js";
+} from "./chunk-6BGYI7XY.js";
+import "./chunk-47LK5I2X.js";
+import "./chunk-473MNTMS.js";
 import {
   resolveLocale,
   setLocale,
   t
-} from "./chunk-6NXOK4OD.js";
+} from "./chunk-4VEDGI4L.js";
 import {
   commandExists,
   killAll,
@@ -728,8 +730,14 @@ ${modelsText(session)}`)}
     );
     return;
   }
-  const { renderDashboard } = await import("./render-SKZLGUOW.js");
-  await renderDashboard(session, preset, start);
+  const { renderDashboard } = await import("./render-Y4DNH7FW.js");
+  const pending = await renderDashboard(session, preset, start);
+  if (pending) {
+    const { executeHarnessLaunch } = await import("./harness-launch-KEUKZZXH.js");
+    const result = await executeHarnessLaunch(pending);
+    if (!result.ok) process.stderr.write(`${result.log}
+`);
+  }
 }
 async function run(args2) {
   setLocale(resolveLocale(args2.lang));
@@ -741,7 +749,7 @@ async function run(args2) {
   if (args2.verbose) setLogLevel("verbose");
   if (!args2.color) process.env.NO_COLOR = "1";
   if (args2.command === "repo") {
-    const { runRepoCommand } = await import("./repo-cli-TPYCTV5J.js");
+    const { runRepoCommand } = await import("./repo-cli-BK76EVBZ.js");
     return runRepoCommand(args2);
   }
   const cleanup = () => {

package/dist/cli/{render-SKZLGUOW.js → render-Y4DNH7FW.js}

@@ -16,16 +16,20 @@ import {
   resultText,
   runBenchmark,
   tasksText
-} from "./chunk-PX7BJDD3.js";
+} from "./chunk-6BGYI7XY.js";
+import "./chunk-47LK5I2X.js";
 import {
   buildRepoGraph
-} from "./chunk-LL5FQT7I.js";
+} from "./chunk-XEEGLMVT.js";
 import {
   formatNumber,
   formatPercent,
-  formatTokensPerSec,
+  formatTokensPerSec
+} from "./chunk-473MNTMS.js";
+import "./chunk-7KPNGK6A.js";
+import {
   t
-} from "./chunk-6NXOK4OD.js";
+} from "./chunk-4VEDGI4L.js";
 import "./chunk-SS7OXXQQ.js";
 
 // src/tui/render.tsx
@@ -750,6 +754,7 @@ function pickHarnessModel(session, effort) {
     return {
       modelId: null,
       modelName: null,
+      ollamaTag: null,
       grade: null,
       measuredTps: null,
       reason: "No installed models. N/A",
@@ -790,6 +795,7 @@ function pickHarnessModel(session, effort) {
   return {
     modelId: best.row.local.id,
     modelName: best.row.local.name,
+    ollamaTag: resolveOllamaTag(best.row.local.id, best.row.local.name, best.row.catalog?.id, best.row.catalog?.name) ?? (best.row.local.id.includes(":") ? best.row.local.id : null),
     grade: best.grade,
     measuredTps: best.tps,
     reason: reasons[effort.label],
@@ -799,7 +805,12 @@ function pickHarnessModel(session, effort) {
 
 // src/tui/views/Graph.tsx
 import { Fragment as Fragment6, jsx as jsx11, jsxs as jsxs11 } from "react/jsx-runtime";
-function GraphView({ session }) {
+var TOOLS2 = [
+  { key: "1", id: "opencode", label: "OpenCode" },
+  { key: "2", id: "hermes", label: "Hermes" },
+  { key: "3", id: "openclaw", label: "OpenClaw" }
+];
+function GraphView(props) {
   const [phase, setPhase] = useState4("build");
   const [graph, setGraph] = useState4();
   const [error, setError] = useState4("");
@@ -823,21 +834,38 @@ function GraphView({ session }) {
       live = false;
     };
   }, [repo]);
+  const pick = useMemo2(() => graph ? pickHarnessModel(props.session, graph.effort) : void 0, [graph, props.session]);
   useInput4((input, key) => {
-    if (phase !== "prompt") return;
-    if (key.return) {
-      setPhase("done");
+    if (phase === "prompt") {
+      if (key.return) {
+        setPhase("pick");
+        return;
+      }
+      if (key.backspace || key.delete) {
+        setPrompt((value) => value.slice(0, -1));
+        return;
+      }
+      if (input && !key.ctrl && !key.meta && input !== "	") {
+        setPrompt((value) => `${value}${input}`.slice(0, 240));
+      }
       return;
     }
-    if (key.backspace || key.delete) {
-      setPrompt((value) => value.slice(0, -1));
+    if (phase !== "pick" || !pick?.modelId) return;
+    const tool = TOOLS2.find((item) => item.key === input)?.id ?? (key.return ? "opencode" : void 0);
+    if (!tool) return;
+    if (!pick.ollamaTag) {
+      setError(t("repoHarnessNoTag"));
+      setPhase("error");
       return;
     }
-    if (input && !key.ctrl && !key.meta && input !== "	") {
-      setPrompt((value) => `${value}${input}`.slice(0, 240));
-    }
+    props.onLaunch({
+      tool,
+      repo,
+      task: prompt,
+      modelId: pick.modelId,
+      ollamaTag: pick.ollamaTag
+    });
   });
-  const pick = useMemo2(() => graph ? pickHarnessModel(session, graph.effort) : void 0, [graph, session]);
   if (phase === "build") {
     return /* @__PURE__ */ jsxs11(Panel, { title: t("repoGraphTitle"), color: "magenta", children: [
       /* @__PURE__ */ jsx11(Text11, { children: t("repoGraphBuilding") }),
@@ -912,11 +940,14 @@ function GraphView({ session }) {
       pick?.modelName ? /* @__PURE__ */ jsxs11(Text11, { children: [
         pick.modelName,
         "  ",
+        pick.ollamaTag ?? "\u2014",
+        "  ",
         pick.grade ?? "\u2014",
         "  ",
         pick.measuredTps != null ? `${pick.measuredTps} t/s` : t("notTested")
       ] }) : /* @__PURE__ */ jsx11(Text11, { color: "yellow", children: pick?.reason ?? "N/A" }),
-      /* @__PURE__ */ jsx11(Text11, { dimColor: true, children: pick?.reason })
+      /* @__PURE__ */ jsx11(Text11, { dimColor: true, children: pick?.reason }),
+      pick?.ollamaTag ? /* @__PURE__ */ jsx11(Text11, { color: "cyan", children: t("repoHarnessKeys") }) : /* @__PURE__ */ jsx11(Text11, { color: "yellow", children: t("repoHarnessNoTag") })
     ] })
   ] });
 }
@@ -981,7 +1012,16 @@ function App(props) {
     screen === "compare" && /* @__PURE__ */ jsx12(CompareView, { session: props.session }),
     screen === "history" && /* @__PURE__ */ jsx12(HistoryView, { session: props.session }),
     screen === "tasks" && /* @__PURE__ */ jsx12(TasksView, { session: props.session }),
-    screen === "graph" && /* @__PURE__ */ jsx12(GraphView, { session: props.session }),
+    screen === "graph" && /* @__PURE__ */ jsx12(
+      GraphView,
+      {
+        session: props.session,
+        onLaunch: (req) => {
+          props.onLaunch?.(req);
+          exit();
+        }
+      }
+    ),
     screen === "benchmark" && /* @__PURE__ */ jsx12(
       BenchmarkView,
       {
@@ -999,11 +1039,26 @@ function App(props) {
 // src/tui/render.tsx
 import { jsx as jsx13 } from "react/jsx-runtime";
 async function renderDashboard(session, preset, start) {
-  const instance = render(/* @__PURE__ */ jsx13(App, { session, preset, start }), {
-    exitOnCtrlC: true,
-    patchConsole: true
-  });
+  let pending;
+  const instance = render(
+    /* @__PURE__ */ jsx13(
+      App,
+      {
+        session,
+        preset,
+        start,
+        onLaunch: (req) => {
+          pending = req;
+        }
+      }
+    ),
+    {
+      exitOnCtrlC: true,
+      patchConsole: true
+    }
+  );
   await instance.waitUntilExit();
+  return pending;
 }
 export {
   renderDashboard

package/dist/cli/{repo-cli-TPYCTV5J.js → repo-cli-BK76EVBZ.js}

@@ -1,14 +1,18 @@
 import {
   buildRepoGraph,
+  runRepoHarness
+} from "./chunk-XEEGLMVT.js";
+import {
+  na
+} from "./chunk-473MNTMS.js";
+import {
   findPython,
   invokePuduAgent,
-  parseJsonStdout,
-  runRepoHarness
-} from "./chunk-LL5FQT7I.js";
+  parseJsonStdout
+} from "./chunk-7KPNGK6A.js";
 import {
-  na,
   t
-} from "./chunk-6NXOK4OD.js";
+} from "./chunk-4VEDGI4L.js";
 import "./chunk-SS7OXXQQ.js";
 
 // src/agent-lab/repo-cli.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pudu-ai",
-  "version": "0.2.22",
+  "version": "0.2.23",
   "description": "Pudu-AI — local AI hardware & benchmark lab for the terminal",
   "keywords": [
     "ai",

package/python/pudu_agent/__main__.py

@@ -1,4 +1,10 @@
-from pudu_agent.search import main
+import sys
 
 if __name__ == "__main__":
+    if len(sys.argv) > 1 and sys.argv[1] == "mcp":
+        from pudu_agent.mcp_server import main as mcp_main
+
+        raise SystemExit(mcp_main())
+    from pudu_agent.search import main
+
     raise SystemExit(main())

package/python/pudu_agent/mcp_server.py

@@ -0,0 +1,140 @@
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+from typing import Any
+
+from pudu_agent.graph import build_graph
+from pudu_agent.search import handle_search
+
+PROTOCOL = "2024-11-05"
+
+
+def _read() -> dict[str, Any] | None:
+    headers: dict[str, str] = {}
+    while True:
+        line = sys.stdin.buffer.readline()
+        if not line:
+            return None
+        if line in (b"\r\n", b"\n"):
+            break
+        decoded = line.decode("utf-8", errors="replace")
+        if ":" not in decoded:
+            continue
+        key, value = decoded.split(":", 1)
+        headers[key.strip().lower()] = value.strip()
+    length = int(headers.get("content-length") or "0")
+    if length <= 0:
+        return None
+    body = sys.stdin.buffer.read(length)
+    return json.loads(body.decode("utf-8"))
+
+
+def _write(payload: dict[str, Any]) -> None:
+    raw = json.dumps(payload, ensure_ascii=False).encode("utf-8")
+    sys.stdout.buffer.write(f"Content-Length: {len(raw)}\r\n\r\n".encode("ascii"))
+    sys.stdout.buffer.write(raw)
+    sys.stdout.buffer.flush()
+
+
+def _result(req_id: Any, result: Any) -> dict[str, Any]:
+    return {"jsonrpc": "2.0", "id": req_id, "result": result}
+
+
+def _error(req_id: Any, message: str) -> dict[str, Any]:
+    return {"jsonrpc": "2.0", "id": req_id, "error": {"code": -32000, "message": message}}
+
+
+def _tools() -> list[dict[str, Any]]:
+    return [
+        {
+            "name": "pudu_repo_search",
+            "description": "Deterministic repo search via rg/ast-grep/graph. No LLM. Never invents hits.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "repo": {"type": "string"},
+                    "query": {"type": "string"},
+                    "intent": {"type": "string"},
+                    "limit": {"type": "integer"},
+                },
+            },
+        },
+        {
+            "name": "pudu_repo_graph",
+            "description": "Build a Python AST implementation graph. Edges are EXTRACTED or RESOLVED.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {"repo": {"type": "string"}},
+            },
+        },
+    ]
+
+
+def _call(name: str, args: dict[str, Any]) -> str:
+    repo = args.get("repo") or "."
+    if name == "pudu_repo_search":
+        result = handle_search(
+            {
+                "op": "search",
+                "repo": repo,
+                "query": args.get("query"),
+                "intent": args.get("intent"),
+                "limit": args.get("limit") or 50,
+            }
+        )
+        return json.dumps(result, ensure_ascii=False)
+    if name == "pudu_repo_graph":
+        graph = build_graph(Path(str(repo)).expanduser().resolve(), persist=True)
+        slim = {
+            "ok": graph.get("ok"),
+            "repo": graph.get("repo"),
+            "backend": graph.get("backend"),
+            "metrics": graph.get("metrics"),
+            "effort": graph.get("effort"),
+            "writtenTo": graph.get("writtenTo"),
+            "nodeCount": len(graph.get("nodes") or []),
+            "edgeCount": len(graph.get("edges") or []),
+        }
+        return json.dumps(slim, ensure_ascii=False)
+    raise ValueError(f"unknown tool: {name}")
+
+
+def main() -> int:
+    while True:
+        req = _read()
+        if req is None:
+            return 0
+        method = req.get("method")
+        req_id = req.get("id")
+        if method == "initialize":
+            _write(
+                _result(
+                    req_id,
+                    {
+                        "protocolVersion": PROTOCOL,
+                        "capabilities": {"tools": {}},
+                        "serverInfo": {"name": "pudu-ai", "version": "0.2.23"},
+                    },
+                )
+            )
+            continue
+        if method == "notifications/initialized" or method == "initialized":
+            continue
+        if method == "tools/list":
+            _write(_result(req_id, {"tools": _tools()}))
+            continue
+        if method == "tools/call":
+            params = req.get("params") or {}
+            name = params.get("name")
+            arguments = params.get("arguments") or {}
+            try:
+                text = _call(str(name), arguments if isinstance(arguments, dict) else {})
+                _write(_result(req_id, {"content": [{"type": "text", "text": text}]}))
+            except Exception as exc:
+                _write(_error(req_id, str(exc)))
+            continue
+        if req_id is not None:
+            _write(_error(req_id, f"unknown method: {method}"))
+    return 0