@nanonets/graft 0.4.5 → 0.5.1

package/README.md

@@ -17,8 +17,8 @@
   <img src="https://img.shields.io/badge/telemetry-none-546FFF?style=for-the-badge" />
 </p>
 
-<!-- placeholder: numbers pending a committed benchmark run, see Benchmark below -->
-**31% fewer tool calls · 23% less cost · 17% lower latency.** That is what an agent gets from reading the graph first instead of going in cold.
+<!-- numbers from the committed run in bench/results/ (2026-07-22, 162 agent runs, 2 repos) — see Benchmark below -->
+**32% less cost · 46% fewer tool calls · 60% lower latency** with the graph bundle pushed up front, at equal correctness — or **16% less cost with correctness up 5 points** when the agent pulls from the graph on demand. Measured against the same agent going in cold.
 
 </div>
 
@@ -113,7 +113,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 +171,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).
@@ -192,6 +192,13 @@ graft callers <symbol> [dir]         # who calls/references/imports/implements/e
 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 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
+graft grep "<regex>" -i --fixed      # case-insensitive; treat the pattern as a literal string, not a regex
+
+graft map [dir]                      # token-budgeted repo orientation — dir clusters, hubs, hotspots (no LLM, no key)
+graft map --max-dirs N               # raise/lower the number of directories shown
+
 graft check [dir]                    # fail (exit 1) if graft/ has drifted from the code
 graft check --json                   # print the drift report as JSON
 
@@ -212,6 +219,44 @@ graft --dir <path>                   # use a context dir other than <repo>/graft
 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
+type on method-heavy code, not every method anywhere with that name.
+
+## Search & orient (`graft grep` / `graft map`)
+
+`graft grep "<regex>"` is exhaustive over every indexed file and groups hits
+by enclosing symbol, ranked by the same in-edge coupling `graft map` uses —
+built for "every occurrence of this pattern" tasks where `graft ask`'s
+ranked top-N isn't enough:
+
+```
+"NEEDLE" — 2 hits in 2 symbols across 1 files (searched 1 indexed files)
+
+heavilyCalled · function · src/a.ts:L1-L3 · 3 in-edges
+  L2: console.log("NEEDLE hit in heavilyCalled");
+
+rarelyCalled · function · src/a.ts:L4-L6 · 0 in-edges
+  L5: console.log("NEEDLE hit in rarelyCalled");
+```
+
+`graft map` is a token-budgeted first look at a repo — directory clusters
+with file/symbol counts, each dir's local hubs, and the global hotspots —
+all ranked by in-degree, no LLM, no key:
+
+```
+repo map — 105 files · 582 symbols · 1815 edges · typescript
+
+src/                54 files · 414 symbols   hubs: set (bindings.ts, 38←), contextDirFor (node-file.ts, 11←), wiringPath (write.ts, 10←)
+test/               36 files · 68 symbols   hubs: edge (graph-traverse.test.ts, 4←), graphOf (graph-traverse.test.ts, 4←), nodeStub (graph-traverse.test.ts, 3←)
+viewer/             5 files · 58 symbols   hubs: $ (main.ts, 9←), activeGraph (main.ts, 5←), cvar (data.ts, 5←)
+bench/              8 files · 42 symbols   hubs: makeClient (llm.ts, 3←), buildMarkdown (report.ts, 2←), judge (judge.ts, 2←)
+scripts/            2 files · 0 symbols
+
+hotspots: set · method · src/graph/bindings.ts:L21-L23 · 38←  contextDirFor · function · src/context/node-file.ts:L100-L103 · 11←  wiringPath · function · src/graph/write.ts:L20-L22 · 10←  ...
+```
+
 ## Visualize it (`graft viz`)
 
 `graft viz` opens a local, interactive view of both graphs — no install, no dev
@@ -245,22 +290,23 @@ normalized on load — no regeneration needed.
 
 ## Benchmark
 
-<!-- placeholder: fill from a committed bench/results/ run before launch -->
+The claim Graft has to earn is simple: an agent that gets its context from the graph is cheaper and faster without getting more answers wrong. The harness runs every task through three arms of the same Claude Sonnet 5 agent with the same file tools: **cold** (explores from zero), **graph (push)** (a `graft ask --source` bundle injected up front), and **graft (pull)** (graft_ask/graft_skeleton tools, nothing injected — context paid for only when asked). An Opus 4.8 judge scores correctness with a required-keyword floor so a fast-but-wrong answer cannot win. Cost is cache-aware (reads ≈0.1×, writes 1.25×) — the billing model agents actually run under.
 
-The claim Graft has to earn is simple: an agent that reads the graph first is cheaper and faster without getting more answers wrong. The harness runs every task twice through the same agent with the same file tools. One run is **cold** (it explores from zero) and one is **graph** (it gets the `graft/` bundle up front). A separate model judges correctness, with a required-keyword floor so a fast-but-wrong answer cannot win.
+Committed run: `bench/results/2026-07-22T13-19-14-246Z` — 162 runs across two repos (graft itself and a real Node/Express auth service), 3 trials each, tasks split between localized (single-file) and multi-file questions.
 
-| Metric | Cold | Graph | Change |
+| Metric (mean/task) | Cold | Graph (push) | Graft (pull) |
 |---|---|---|---|
-| Tool calls | _TBD_ | _TBD_ | **−31%** |
-| Cost | _TBD_ | _TBD_ | **−23%** |
-| Latency | _TBD_ | _TBD_ | **−17%** |
-| Correctness | _TBD_ | _TBD_ | _at least as good as cold_ |
+| Cost ($) | 0.0429 | **0.0292 (−32%)** | 0.0362 (−16%) |
+| Uncached input tokens | 8,070 | **4,650 (−42%)** | 5,965 (−26%) |
+| Tool calls | 4.2 | **2.3 (−46%)** | 4.2 (−1%) |
+| Latency (s) | 39.8 | **15.8 (−60%)** | 39.5 (−1%) |
+| Correctness | 93% | 93% | **98% (+5 pts)** |
 
-_The numbers above are placeholders pending a committed run._ Reproduce it yourself:
+Push is the cost/latency win; pull is the correctness win (and never lost to cold anywhere, including single-file tasks). On one corpus push traded 3 correctness points for its savings — the per-corpus and per-locality splits are in the committed results, not averaged away. Reproduce it yourself:
 
 ```bash
-npm run bench -- --smoke   # 1 corpus, 1 task, a quick plumbing check
-npm run bench              # full: all corpora, all tasks
+npm run bench -- --smoke   # 1 corpus, 1 task, all arms — a quick plumbing check
+npm run bench              # full: all corpora, all tasks, 3 arms × 3 trials
 ```
 
 See [`bench/README.md`](bench/README.md) for the method and how to add your own repo.

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"}