@nanonets/graft 0.5.0 → 0.6.0

package/README.md

@@ -71,9 +71,11 @@ npx @nanonets/graft init
 ### MCP server
 
 `graft init` also registers Graft's MCP server with agents that support it, so
-`graft_ask`, `graft_check`, and `graft_blast_radius` appear as native tools —
-no shell required. Skip with `--no-mcp`. Run it manually with `graft mcp [dir]`,
-or register it by hand:
+`graft_ask`, `graft_callers`, `graft_grep`, `graft_skeleton`, `graft_map`, and
+`graft_check` appear as native tools — no shell required. Claude Code now gets
+this too: `graft init` writes the server into the project's `.mcp.json` (restart
+Claude Code to load it). Skip with `--no-mcp`. Run it manually with
+`graft mcp [dir]`, or register it by hand:
 
 ```json
 { "mcpServers": { "graft": { "command": "npx", "args": ["-y", "@nanonets/graft", "mcp"] } } }
@@ -113,7 +115,7 @@ Graft builds that understanding **once** and writes it into your repo as a folde
 - **A real graph you can read.** No embeddings, no similarity search, no index to keep warm. The graph is a set of linked files your agent opens, greps, and follows, exactly the way it reads any other file in the repo.
 - **Grafted into git.** The graph is just files in `graft/`. Commit it, and anyone who clones the repo has it. No database, no server, no setup. Git does the syncing, and a stale graph shows up as a diff in review instead of rotting in some external store.
 - **The diff lives with the code.** When a change moves things around, you see it in the graph diff in the same pull request, right next to the code that caused it.
-- **Your key, your model.** Summaries are written by a model you pick on [OpenRouter](https://openrouter.ai), under your own key. The structural code graph (`graft build`, `graft check`) is deterministic tree-sitter and never calls a model at all.
+- **Your provider, your key, your model.** Summaries are written by any provider you choose — OpenAI, Anthropic (native), OpenRouter, Fireworks, Groq, a LiteLLM proxy, or a local model — under your own key. The structural code graph (`graft build`, `graft check`) is deterministic tree-sitter and never calls a model at all.
 
 ---
 
@@ -171,7 +173,7 @@ When the wiring graph exists, `graft check` validates it too — structural drif
 ## What runs where
 
 - **On your machine, no key, no network:** the structural code graph. `graft build` (wiring graph + per-file cards), `graft check`, and `graft ask` are deterministic tree-sitter — they never call a model.
-- **Through your OpenRouter key:** the LLM-written parts — `graft build --deep` adds the concept nodes (file summaries + node synthesis) and the per-symbol summaries and cruxes. Set `OPENROUTER_API_KEY` and optionally pick the model with `GRAFT_OPENROUTER_MODEL` (default: `openai/gpt-4o-mini`).
+- **Through your provider key:** the LLM-written parts — `graft build --deep` adds the concept nodes (file summaries + node synthesis) and the per-symbol summaries and cruxes. graft is vendor-neutral: set `GRAFT_PROVIDER` (`openai` for any OpenAI-compatible endpoint, or `anthropic` for the native API), your `GRAFT_API_KEY`, `GRAFT_MODEL`, and — for the `openai` wire format — `GRAFT_BASE_URL` to point at OpenRouter, Fireworks, Groq, a LiteLLM proxy, a local server, or OpenAI itself. Or pass `--provider/--model/--api-key/--base-url` on the command line. (`OPENROUTER_API_KEY` still works as a deprecated fallback.)
 - **No telemetry** and no analytics — the only network calls are the LLM requests you configured.
 
 See [`.env.example`](.env.example) for the full list of settings (model, base URL, graph directory).
@@ -189,8 +191,8 @@ graft ask "<task>" [dir]             # query the graph — ranked nodes + exact
 graft ask "<task>" --json            # machine-readable result
 
 graft callers <symbol> [dir]         # who calls/references/imports/implements/extends a symbol (no LLM, no key)
-graft callees <symbol> [dir]         # what a symbol calls/references/imports/implements/extends (no LLM, no key)
-graft impact <symbol> [dir] -d N     # BFS over incoming edges — who breaks if this symbol changes (no LLM, no key)
+graft callers <symbol> --direction out  # the reverse: what the symbol itself calls/references (was `graft callees`)
+graft callers <symbol> -d N          # walk transitively out to depth N — full blast radius (was `graft impact`)
 
 graft grep "<regex>" [dir]           # exhaustive regex search over indexed files, grouped by enclosing symbol (no LLM, no key)
 graft grep "<regex>" --in <path>     # narrow to files whose path contains this substring
@@ -205,7 +207,7 @@ graft check --json                   # print the drift report as JSON
 graft viz [dir]                      # see the graph: serves an interactive viewer on localhost
 graft viz --port 5000 --no-open      # pick a port; don't auto-open the browser
 
-graft init [dir]                     # wire Graft into the coding agents detected in this repo (Claude Code always gets full hooks + statusline)
+graft init [dir]                     # wire Graft into the coding agents detected in this repo (Claude Code always gets full hooks + statusline + MCP)
 graft init --no-build                # wire the files only; don't build the graph
 graft init --agents cursor kiro      # wire only these agents (ids: agents, cursor, gemini, copilot, kiro, windsurf, claude)
 graft init --all-agents              # wire every known agent, detected or not
@@ -221,7 +223,7 @@ graft --version, -v                  # print the installed version and exit
 
 Method calls resolve through the receiver's type — constructor assignments
 (`self.router = APIRouter()`) and type annotations, not just the call-site
-name — so `callers`/`impact`/`grep --in` return calls bound to the right
+name — so `callers`/`grep --in` return calls bound to the right
 type on method-heavy code, not every method anywhere with that name.
 
 ## Search & orient (`graft grep` / `graft map`)

package/dist/ai/crux.d.ts

@@ -1,3 +1,20 @@
+/**
+ * Tier-2 "meaning" call for the code graph — batched one request per file.
+ *
+ * Given a source file (with 1-based line numbers) and the list of definitions in
+ * it, one call returns, for each definition:
+ *   1. `summary` — one plain-English sentence: what the symbol is *for*, at the
+ *      business-logic level, not a restatement of its signature.
+ *   2. `crux_start`/`crux_end` — the smallest contiguous range of FILE line
+ *      numbers (inside that symbol's own span) that a reviewer must read to see
+ *      the decision or rule the code encodes. `0/0` means there is no single
+ *      crux (a trivial getter, a plain data holder).
+ *
+ * Batching per file means N definitions cost one request, not N — and the model
+ * sees each symbol's neighbours, which sharpens the summaries. Line numbers are
+ * consumed once, at write time, to slice the crux text verbatim from source.
+ */
+import type { ChatModel } from "./llm/types.js";
 import type { Kind } from "../graph/types.js";
 /** One definition we want described, located by its line span within the file. */
 export interface NodeRef {
@@ -21,11 +38,10 @@ export interface NodeCrux {
 export interface CruxSummarizer {
     describeFile(input: FileCruxInput): Promise<NodeCrux[]>;
 }
-/** Crux summarizer backed by OpenRouter's OpenAI-compatible chat API. */
-export declare class OpenRouterCruxSummarizer implements CruxSummarizer {
-    private client;
+/** Crux summarizer backed by any {@link ChatModel} via forced tool calling. */
+export declare class ChatCruxSummarizer implements CruxSummarizer {
     private model;
-    constructor(apiKey: string, model: string, baseUrl?: string);
+    constructor(model: ChatModel);
     describeFile(input: FileCruxInput): Promise<NodeCrux[]>;
 }
 //# sourceMappingURL=crux.d.ts.map

package/dist/ai/crux.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crux.d.ts","sourceRoot":"","sources":["../../src/ai/crux.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,kFAAkF;AAClF,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CACzD;AAwDD,yEAAyE;AACzE,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,SAAiC;IAS7E,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAa9D"}
+{"version":3,"file":"crux.d.ts","sourceRoot":"","sources":["../../src/ai/crux.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,kFAAkF;AAClF,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CACzD;AAwED,+EAA+E;AAC/E,qBAAa,kBAAmB,YAAW,cAAc;IAC3C,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS;IAE9B,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAoB9D"}

package/dist/ai/crux.js

@@ -1,33 +1,32 @@
-/**
- * Tier-2 "meaning" call for the code graph — batched one request per file.
- *
- * Given a source file (with 1-based line numbers) and the list of definitions in
- * it, one call returns, for each definition:
- *   1. `summary` — one plain-English sentence: what the symbol is *for*, at the
- *      business-logic level, not a restatement of its signature.
- *   2. `crux_start`/`crux_end` — the smallest contiguous range of FILE line
- *      numbers (inside that symbol's own span) that a reviewer must read to see
- *      the decision or rule the code encodes. `0/0` means there is no single
- *      crux (a trivial getter, a plain data holder).
- *
- * Batching per file means N definitions cost one request, not N — and the model
- * sees each symbol's neighbours, which sharpens the summaries. Line numbers are
- * consumed once, at write time, to slice the crux text verbatim from source.
- */
-import OpenAI from "openai";
 const SYSTEM_PROMPT = `You explain code definitions for a code graph that helps engineers navigate a codebase.
 
-You are given ONE source file with 1-based line numbers, and a list of TARGET definitions in it. For every target, return its purpose and the line range of its core logic.
-
-Return STRICT JSON, exactly:
-{ "symbols": [ { "id": string, "summary": string, "crux_start": number, "crux_end": number }, ... ] }
+You are given ONE source file with 1-based line numbers, and a list of TARGET definitions in it. For every target, record its purpose and the line range of its core logic via the record_symbols tool.
 
 Rules:
 - Emit exactly one entry per target id given, using that id verbatim.
 - summary: ONE sentence — what the symbol is FOR at the business-logic level. Say what problem it solves or rule it enforces, not what its signature already says.
 - crux_start / crux_end: FILE line numbers (as shown), inside that symbol's own line range. Pick the SINGLE most important contiguous span — the core branch, formula, guard, or state change. Keep it TIGHT: at most ~8 lines, and NEVER the whole function. If you can't narrow it below that, the symbol has no distinct crux — use 0/0.
-- Skip boilerplate, logging, and plumbing. If a symbol has no meaningful crux (trivial getter, data holder, one-line delegation, or logic spread evenly with no focal point), use "crux_start": 0 and "crux_end": 0.
-- Output ONLY the JSON object. No prose, no code fences.`;
+- Skip boilerplate, logging, and plumbing. If a symbol has no meaningful crux (trivial getter, data holder, one-line delegation, or logic spread evenly with no focal point), use "crux_start": 0 and "crux_end": 0.`;
+const RECORD_TOOL = "record_symbols";
+const SYMBOLS_SCHEMA = {
+    type: "object",
+    properties: {
+        symbols: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    id: { type: "string" },
+                    summary: { type: "string" },
+                    crux_start: { type: "number" },
+                    crux_end: { type: "number" },
+                },
+                required: ["id", "summary", "crux_start", "crux_end"],
+            },
+        },
+    },
+    required: ["symbols"],
+};
 /** Cap the file text sent per request so one huge file can't blow the context. */
 const MAX_CODE_CHARS = 18_000;
 function numberLines(source) {
@@ -44,11 +43,9 @@ function userContent(input) {
         .join("\n");
     return `FILE: ${input.path}\n\n${numberLines(input.source)}\n\nTARGETS:\n${targets}`;
 }
-/** Best-effort parse of a model's JSON reply into a {@link NodeCrux} list. */
-function parseResults(raw) {
-    const text = raw.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/, "");
-    const obj = JSON.parse(text);
-    if (!Array.isArray(obj.symbols))
+/** Normalize the tool's parsed argument object into a {@link NodeCrux} list. */
+function parseResults(obj) {
+    if (!obj || !Array.isArray(obj.symbols))
         return [];
     const num = (v) => (typeof v === "number" && Number.isFinite(v) ? Math.trunc(v) : 0);
     return obj.symbols
@@ -61,31 +58,32 @@ function parseResults(raw) {
         crux_end: num(s.crux_end),
     }));
 }
-/** Crux summarizer backed by OpenRouter's OpenAI-compatible chat API. */
-export class OpenRouterCruxSummarizer {
-    client;
+/** Crux summarizer backed by any {@link ChatModel} via forced tool calling. */
+export class ChatCruxSummarizer {
     model;
-    constructor(apiKey, model, baseUrl = "https://openrouter.ai/api/v1") {
-        this.client = new OpenAI({
-            apiKey,
-            baseURL: baseUrl,
-            defaultHeaders: { "X-Title": "Context Graph Engine" },
-        });
+    constructor(model) {
         this.model = model;
     }
     async describeFile(input) {
         if (input.nodes.length === 0)
             return [];
-        const response = await this.client.chat.completions.create({
-            model: this.model,
+        const res = await this.model.create({
             temperature: 0,
-            response_format: { type: "json_object" },
+            maxTokens: 8192,
+            tools: [
+                {
+                    name: RECORD_TOOL,
+                    description: "Record each target definition's purpose and crux line range.",
+                    parameters: SYMBOLS_SCHEMA,
+                },
+            ],
+            responseFormat: { kind: "tool", name: RECORD_TOOL },
             messages: [
                 { role: "system", content: SYSTEM_PROMPT },
                 { role: "user", content: userContent(input) },
             ],
         });
-        return parseResults(response.choices[0]?.message?.content ?? "");
+        return parseResults(res.toolCalls[0]?.args);
     }
 }
 //# sourceMappingURL=crux.js.map

package/dist/ai/crux.js.map

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

package/dist/ai/llm/anthropic.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Native Anthropic transport. Wraps `@anthropic-ai/sdk` (the Messages API), so
+ * Claude is a first-class provider rather than something tunneled through an
+ * OpenAI-compatible endpoint.
+ *
+ * The Messages API differs from Chat Completions in ways this adapter absorbs so
+ * the rest of graft never sees them:
+ *   - `system` is a top-level parameter, not a message.
+ *   - tool results ride inside a USER turn, and all results answering one
+ *     assistant turn must be coalesced into a single user message.
+ *   - `max_tokens` is required (callers get a default).
+ *   - `temperature` is rejected by current models, so it is never forwarded.
+ *   - structured output is a forced tool (there is no `response_format`).
+ *   - assistant turns are replayed verbatim (via `providerRaw`) so thinking-block
+ *     signatures survive a multi-turn loop.
+ */
+import Anthropic from "@anthropic-ai/sdk";
+import type { ChatModel, ChatRequest, ChatResponse } from "./types.js";
+export interface AnthropicChatModelOptions {
+    apiKey: string;
+    model: string;
+    baseUrl?: string;
+    label?: string;
+    /** Inject a pre-built client (tests pass a stub; production omits it). */
+    client?: Anthropic;
+}
+export declare class AnthropicChatModel implements ChatModel {
+    readonly label: string;
+    private client;
+    private model;
+    constructor(opts: AnthropicChatModelOptions);
+    create(req: ChatRequest): Promise<ChatResponse>;
+    /** Reconstruct an assistant turn, replaying the original blocks when we made them. */
+    private assistantParam;
+    private fromResponse;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/ai/llm/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/ai/llm/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAsC,MAAM,YAAY,CAAC;AAM3G,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAKD,qBAAa,kBAAmB,YAAW,SAAS;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAS;gBAEV,IAAI,EAAE,yBAAyB;IAMrC,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAuDrD,sFAAsF;IACtF,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,YAAY;CA4BrB"}

package/dist/ai/llm/anthropic.js

@@ -0,0 +1,141 @@
+/**
+ * Native Anthropic transport. Wraps `@anthropic-ai/sdk` (the Messages API), so
+ * Claude is a first-class provider rather than something tunneled through an
+ * OpenAI-compatible endpoint.
+ *
+ * The Messages API differs from Chat Completions in ways this adapter absorbs so
+ * the rest of graft never sees them:
+ *   - `system` is a top-level parameter, not a message.
+ *   - tool results ride inside a USER turn, and all results answering one
+ *     assistant turn must be coalesced into a single user message.
+ *   - `max_tokens` is required (callers get a default).
+ *   - `temperature` is rejected by current models, so it is never forwarded.
+ *   - structured output is a forced tool (there is no `response_format`).
+ *   - assistant turns are replayed verbatim (via `providerRaw`) so thinking-block
+ *     signatures survive a multi-turn loop.
+ */
+import Anthropic from "@anthropic-ai/sdk";
+const PROVIDER = "anthropic";
+const JSON_TOOL = "emit_json";
+const DEFAULT_MAX_TOKENS = 4096;
+const cc = (on) => (on ? { cache_control: { type: "ephemeral" } } : {});
+export class AnthropicChatModel {
+    label;
+    client;
+    model;
+    constructor(opts) {
+        this.model = opts.model;
+        this.label = opts.label ?? `${PROVIDER}:${opts.model}`;
+        this.client = opts.client ?? new Anthropic({ apiKey: opts.apiKey, baseURL: opts.baseUrl });
+    }
+    async create(req) {
+        const system = [];
+        const messages = [];
+        for (const m of req.messages) {
+            if (m.role === "system") {
+                system.push({ type: "text", text: m.content, ...cc(m.cacheBreakpoint) });
+            }
+            else if (m.role === "user") {
+                messages.push({ role: "user", content: [{ type: "text", text: m.content, ...cc(m.cacheBreakpoint) }] });
+            }
+            else if (m.role === "tool") {
+                // Tool results live in a user turn; coalesce consecutive results together.
+                const block = {
+                    type: "tool_result",
+                    tool_use_id: m.toolCallId ?? "",
+                    content: [{ type: "text", text: m.content }],
+                    ...cc(m.cacheBreakpoint),
+                };
+                const last = messages[messages.length - 1];
+                if (last?.role === "user" && Array.isArray(last.content)) {
+                    last.content.push(block);
+                }
+                else {
+                    messages.push({ role: "user", content: [block] });
+                }
+            }
+            else {
+                messages.push(this.assistantParam(m));
+            }
+        }
+        const tools = req.tools?.map(toAnthropicTool);
+        const params = {
+            model: this.model,
+            max_tokens: req.maxTokens ?? DEFAULT_MAX_TOKENS,
+            messages,
+            ...(system.length ? { system } : {}),
+        };
+        // temperature is intentionally NOT forwarded — current models reject it.
+        const fmt = req.responseFormat ?? { kind: "text" };
+        if (fmt.kind === "json") {
+            params.tools = [
+                ...(tools ?? []),
+                { name: JSON_TOOL, description: "Return the answer as a JSON object.", input_schema: { type: "object" } },
+            ];
+            params.tool_choice = { type: "tool", name: JSON_TOOL };
+        }
+        else if (fmt.kind === "tool") {
+            params.tools = tools;
+            params.tool_choice = { type: "tool", name: fmt.name };
+        }
+        else if (tools) {
+            params.tools = tools;
+        }
+        const resp = await this.client.messages.create(params);
+        return this.fromResponse(resp, fmt.kind);
+    }
+    /** Reconstruct an assistant turn, replaying the original blocks when we made them. */
+    assistantParam(m) {
+        if (m.providerRaw?.provider === PROVIDER)
+            return m.providerRaw.raw;
+        const content = [];
+        if (m.content)
+            content.push({ type: "text", text: m.content });
+        for (const tc of m.toolCalls ?? []) {
+            content.push({ type: "tool_use", id: tc.id, name: tc.name, input: tc.args });
+        }
+        return { role: "assistant", content };
+    }
+    fromResponse(resp, format) {
+        let text = "";
+        let toolCalls = [];
+        for (const block of resp.content) {
+            if (block.type === "text")
+                text += block.text;
+            else if (block.type === "tool_use")
+                toolCalls.push({ id: block.id, name: block.name, args: block.input });
+        }
+        if (format === "json") {
+            const jsonCall = toolCalls.find((c) => c.name === JSON_TOOL);
+            if (jsonCall)
+                text = JSON.stringify(jsonCall.args);
+            toolCalls = toolCalls.filter((c) => c.name !== JSON_TOOL);
+        }
+        return {
+            text,
+            toolCalls,
+            usage: normalizeUsage(resp.usage),
+            stopReason: resp.stop_reason ?? null,
+            // Replay the raw content verbatim so thinking-block signatures survive.
+            assistant: {
+                role: "assistant",
+                content: text,
+                toolCalls: toolCalls.length ? toolCalls : undefined,
+                providerRaw: { provider: PROVIDER, raw: { role: "assistant", content: resp.content } },
+            },
+        };
+    }
+}
+function toAnthropicTool(t) {
+    return { name: t.name, description: t.description, input_schema: t.parameters };
+}
+/** Anthropic reports uncached input in `input_tokens` and cache tokens separately. */
+function normalizeUsage(u) {
+    return {
+        input: u.input_tokens ?? 0,
+        output: u.output_tokens ?? 0,
+        cacheRead: u.cache_read_input_tokens ?? 0,
+        cacheCreate: u.cache_creation_input_tokens ?? 0,
+    };
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/ai/llm/anthropic.js.map

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

package/dist/ai/llm/factory.d.ts

@@ -0,0 +1,19 @@
+/**
+ * One place that turns resolved config into a {@link ChatModel}. `provider` names
+ * the WIRE FORMAT, not a vendor: `openai` speaks the OpenAI-compatible API (point
+ * `baseUrl` at OpenRouter, Fireworks, a LiteLLM proxy, Groq, a local server, …),
+ * `anthropic` speaks the native Messages API. Adding a vendor is a base URL, not
+ * a code change; adding a wire format is one new adapter here.
+ */
+import type { ChatModel } from "./types.js";
+export type ProviderKind = "openai" | "anthropic";
+export interface ChatModelConfig {
+    provider: ProviderKind;
+    apiKey: string;
+    model: string;
+    baseUrl?: string;
+    /** Extra default headers for OpenAI-compatible endpoints (e.g. OpenRouter `X-Title`). */
+    headers?: Record<string, string>;
+}
+export declare function createChatModel(cfg: ChatModelConfig): ChatModel;
+//# sourceMappingURL=factory.d.ts.map

package/dist/ai/llm/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/ai/llm/factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,SAAS,CAgB/D"}

package/dist/ai/llm/factory.js

@@ -0,0 +1,20 @@
+import { OpenAIChatModel } from "./openai.js";
+import { AnthropicChatModel } from "./anthropic.js";
+export function createChatModel(cfg) {
+    switch (cfg.provider) {
+        case "anthropic":
+            return new AnthropicChatModel({ apiKey: cfg.apiKey, model: cfg.model, baseUrl: cfg.baseUrl });
+        case "openai":
+            return new OpenAIChatModel({
+                apiKey: cfg.apiKey,
+                model: cfg.model,
+                baseUrl: cfg.baseUrl,
+                headers: cfg.headers,
+            });
+        default: {
+            const _exhaustive = cfg.provider;
+            throw new Error(`unknown provider: ${String(_exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/ai/llm/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/ai/llm/factory.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAapD,MAAM,UAAU,eAAe,CAAC,GAAoB;IAClD,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,WAAW;YACd,OAAO,IAAI,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAChG,KAAK,QAAQ;YACX,OAAO,IAAI,eAAe,CAAC;gBACzB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB,CAAC,CAAC;QACL,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,GAAG,CAAC,QAAQ,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/ai/llm/openai.d.ts

@@ -0,0 +1,33 @@
+/**
+ * OpenAI-compatible transport. Wraps the `openai` SDK pointed at any
+ * OpenAI-compatible endpoint (OpenAI, OpenRouter, Fireworks, a LiteLLM proxy,
+ * Groq, Together, DeepSeek, a local server, …) — the user picks the endpoint
+ * with `baseUrl` and authenticates with their own key.
+ *
+ * This adapter reproduces graft's historical wire behavior exactly: temperature
+ * is forwarded, cache breakpoints become `cache_control` content parts (which
+ * OpenRouter forwards to Anthropic), and cached tokens are subtracted out of the
+ * input count so {@link Usage.input} is uncached-only.
+ */
+import OpenAI from "openai";
+import type { ChatModel, ChatRequest, ChatResponse } from "./types.js";
+export interface OpenAIChatModelOptions {
+    apiKey: string;
+    model: string;
+    baseUrl?: string;
+    /** Stable manifest label; defaults to `openai:<model>`. */
+    label?: string;
+    /** Extra default headers (e.g. OpenRouter's `X-Title`). */
+    headers?: Record<string, string>;
+    /** Inject a pre-built client (tests pass a stub; production omits it). */
+    client?: OpenAI;
+}
+export declare class OpenAIChatModel implements ChatModel {
+    readonly label: string;
+    private client;
+    private model;
+    constructor(opts: OpenAIChatModelOptions);
+    create(req: ChatRequest): Promise<ChatResponse>;
+    private fromResponse;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/ai/llm/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/ai/llm/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAsC,MAAM,YAAY,CAAC;AAM3G,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4CD,qBAAa,eAAgB,YAAW,SAAS;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;gBAEV,IAAI,EAAE,sBAAsB;IAYlC,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA2BrD,OAAO,CAAC,YAAY;CA6CrB"}