@akon-labs/nexus-cli 0.1.0

package/dist/extensions/gitnexus/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/extensions/gitnexus/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACtC,GAAG,EAAE,MAAM,CAAC;CACZ;AA8GD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,mBAAmB,GAAG,cAAc,EAAE,CAwG9E","sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { Type } from \"typebox\";\nimport type { ToolDefinition } from \"../../core/extensions/types.ts\";\nimport { graphRailStore } from \"../../core/graph-rail-store.ts\";\nimport { GitNexusClient } from \"./client.ts\";\nimport { type ImpactData, parseHubJson, type QueryData } from \"./render.ts\";\n\n/**\n * The six model-visible GitNexus tools, wrapping hub MCP tools 1:1.\n * Descriptions are ported near-verbatim from the hub's own MCP tool\n * descriptions — they are battle-tested with Claude/codex; do not rewrite.\n */\n\nexport interface GitNexusToolContext {\n\tclient: GitNexusClient;\n\t/** Default repo for calls that omit `repo` (the resolved current repo). */\n\tcurrentRepo: () => string | undefined;\n\tcwd: string;\n}\n\ninterface HubCallArgs {\n\t[key: string]: unknown;\n}\n\n/** Copy the first present alias onto `canonical` — models fumble param names (t2: target= for name=). */\nfunction aliasParam(args: Record<string, unknown>, canonical: string, aliases: string[]): Record<string, unknown> {\n\tif (args[canonical] !== undefined) return args;\n\tfor (const alias of aliases) {\n\t\tif (args[alias] !== undefined) {\n\t\t\tconst { [alias]: value, ...rest } = args;\n\t\t\treturn { ...rest, [canonical]: value };\n\t\t}\n\t}\n\treturn args;\n}\n\nfunction textResult(text: string) {\n\treturn { content: [{ type: \"text\" as const, text }], details: { source: \"gitnexus\" } };\n}\n\n/** Feed the side rail from successful graph tool results. Never throws. */\nfunction feedRailFromResult(toolName: string, args: Record<string, unknown>, text: string): void {\n\ttry {\n\t\tif (toolName === \"gitnexus_impact\") {\n\t\t\tconst data = parseHubJson<ImpactData>(text);\n\t\t\tif (!data?.target?.name || !data.byDepth) return;\n\t\t\tgraphRailStore.setImpact({\n\t\t\t\ttarget: data.target.name,\n\t\t\t\tfilePath: data.target.filePath,\n\t\t\t\trisk: data.risk ?? \"UNKNOWN\",\n\t\t\t\tbyDepth: data.byDepth,\n\t\t\t\tprocesses: (data.affected_processes ?? [])\n\t\t\t\t\t.map((p) => (typeof p === \"string\" ? p : (p.name ?? \"\")))\n\t\t\t\t\t.filter(Boolean),\n\t\t\t\tmodules: (data.affected_modules ?? [])\n\t\t\t\t\t.filter((m) => m.name)\n\t\t\t\t\t.map((m) => ({ name: m.name ?? \"\", hits: m.hits ?? 0, direct: m.impact === \"direct\" })),\n\t\t\t\tat: Date.now(),\n\t\t\t});\n\t\t} else if (toolName === \"gitnexus_list_repos\") {\n\t\t\t// list_repos returns markdown: `- **owner/name** (12,345 symbols, ...)`\n\t\t\tconst repos: Array<{ name: string; symbols: string }> = [];\n\t\t\tfor (const match of text.matchAll(/^- \\*\\*(.+?)\\*\\* \\((\\d[\\d,]*) symbols/gm)) {\n\t\t\t\trepos.push({ name: match[1] ?? \"\", symbols: match[2] ?? \"\" });\n\t\t\t}\n\t\t\tif (repos.length > 0) graphRailStore.setRepoList(repos);\n\t\t} else if (toolName === \"gitnexus_query\") {\n\t\t\tconst data = parseHubJson<QueryData>(text);\n\t\t\tif (!data?.processes) return;\n\t\t\tgraphRailStore.setQuery({\n\t\t\t\tquery: String(args.query ?? \"\"),\n\t\t\t\tflows: data.processes.slice(0, 4).map((p) => ({\n\t\t\t\t\tsummary: p.summary ?? \"(flow)\",\n\t\t\t\t\t...(p.step_count !== undefined ? { stepCount: p.step_count } : {}),\n\t\t\t\t})),\n\t\t\t\tat: Date.now(),\n\t\t\t});\n\t\t}\n\t} catch {\n\t\t// rail is cosmetic; tool results must never fail because of it\n\t}\n}\n\nfunction makeHubTool(\n\tctx: GitNexusToolContext,\n\toptions: {\n\t\tname: string;\n\t\thubTool: string;\n\t\tlabel: string;\n\t\tdescription: string;\n\t\tpromptSnippet?: string;\n\t\tpromptGuidelines?: string[];\n\t\tparameters: ReturnType<typeof Type.Object>;\n\t\tprepareArguments?: (args: unknown) => Record<string, unknown>;\n\t\tmapArgs?: (params: Record<string, unknown>) => HubCallArgs;\n\t},\n): ToolDefinition {\n\treturn {\n\t\tname: options.name,\n\t\tlabel: options.label,\n\t\tdescription: options.description,\n\t\t...(options.promptSnippet ? { promptSnippet: options.promptSnippet } : {}),\n\t\t...(options.promptGuidelines ? { promptGuidelines: options.promptGuidelines } : {}),\n\t\t...(options.prepareArguments ? { prepareArguments: options.prepareArguments } : {}),\n\t\tparameters: options.parameters,\n\t\texecutionMode: \"parallel\",\n\t\texecute: async (_id, params, signal) => {\n\t\t\tconst raw = (params ?? {}) as Record<string, unknown>;\n\t\t\tconst mapped = options.mapArgs ? options.mapArgs(raw) : { ...raw };\n\t\t\tif (mapped.repo === undefined) {\n\t\t\t\tconst current = ctx.currentRepo();\n\t\t\t\tif (current) mapped.repo = current;\n\t\t\t}\n\t\t\tconst result = await ctx.client.callTool(options.hubTool, mapped, signal);\n\t\t\tconst text = GitNexusClient.text(result);\n\t\t\tgraphRailStore.recordGraphCall();\n\t\t\tfeedRailFromResult(options.name, mapped, text);\n\t\t\treturn textResult(text);\n\t\t},\n\t};\n}\n\nconst repoParam = Type.Optional(\n\tType.String({\n\t\tdescription: \"Indexed repository name or @group. Omit for the current repository.\",\n\t}),\n);\n\nexport function createGitNexusTools(ctx: GitNexusToolContext): ToolDefinition[] {\n\tconst query = makeHubTool(ctx, {\n\t\tname: \"gitnexus_query\",\n\t\thubTool: \"query\",\n\t\tlabel: \"GitNexus query\",\n\t\tdescription:\n\t\t\t\"Query the code knowledge graph for execution flows related to a concept. Returns processes (call chains) ranked by relevance, each with its symbols and file locations. WHEN TO USE: understanding how code works together — execution flows and relationships, not just file matches. Complements grep. AFTER THIS: use gitnexus_context on a specific symbol for its 360-degree view.\",\n\t\tpromptSnippet: \"gitnexus_query: find execution flows by concept in the knowledge graph\",\n\t\tparameters: Type.Object({\n\t\t\tquery: Type.String({ description: \"Natural language or keyword search query\" }),\n\t\t\tgoal: Type.Optional(Type.String({ description: \"What you want to find. Helps ranking.\" })),\n\t\t\ttask_context: Type.Optional(Type.String({ description: \"What you are working on. Helps ranking.\" })),\n\t\t\tlimit: Type.Optional(Type.Number({ description: \"Max processes to return (default 5)\" })),\n\t\t\trepo: repoParam,\n\t\t}),\n\t});\n\n\tconst context = makeHubTool(ctx, {\n\t\tname: \"gitnexus_context\",\n\t\thubTool: \"context\",\n\t\tlabel: \"GitNexus context\",\n\t\tdescription:\n\t\t\t\"360-degree view of a single code symbol: categorized incoming/outgoing references (calls, imports, extends, implements, overrides, field reads/writes), process participation, and file location. WHEN TO USE: after gitnexus_query, or whenever you need all callers/callees of a symbol. AFTER THIS: use gitnexus_impact if you plan to change it.\",\n\t\tpromptSnippet: \"gitnexus_context: all callers/callees/flows of one symbol\",\n\t\tparameters: Type.Object({\n\t\t\tname: Type.String({ description: 'Symbol name (e.g. \"validateUser\", \"AuthService\")' }),\n\t\t\tfile_path: Type.Optional(Type.String({ description: \"File path to disambiguate common names\" })),\n\t\t\tkind: Type.Optional(Type.String({ description: \"Kind filter, e.g. 'Function' | 'Class' | 'Method'\" })),\n\t\t\trepo: repoParam,\n\t\t}),\n\t\tprepareArguments: (args: unknown) =>\n\t\t\taliasParam((args ?? {}) as Record<string, unknown>, \"name\", [\"target\", \"symbol\"]),\n\t});\n\n\tconst impact = makeHubTool(ctx, {\n\t\tname: \"gitnexus_impact\",\n\t\thubTool: \"impact\",\n\t\tlabel: \"GitNexus impact\",\n\t\tdescription:\n\t\t\t\"Blast-radius analysis before changing a symbol: direct callers (d=1 WILL BREAK), indirect dependents (d=2 should test), transitive (d=3), affected processes, and a risk level. WHEN TO USE: BEFORE modifying any function/class/method. Report HIGH/CRITICAL results to the user before proceeding.\",\n\t\tpromptSnippet: \"gitnexus_impact: blast radius + risk before editing a symbol\",\n\t\tpromptGuidelines: [\n\t\t\t\"Before editing a function, class, or method that the graph knows, run gitnexus_impact on it first and surface HIGH/CRITICAL risk to the user.\",\n\t\t],\n\t\tparameters: Type.Object({\n\t\t\ttarget: Type.String({ description: \"Symbol to analyze\" }),\n\t\t\tdirection: Type.Optional(\n\t\t\t\tType.String({ description: '\"upstream\" (callers, default), \"downstream\" (callees), or \"both\"' }),\n\t\t\t),\n\t\t\trepo: repoParam,\n\t\t}),\n\t\tprepareArguments: (args: unknown) =>\n\t\t\taliasParam((args ?? {}) as Record<string, unknown>, \"target\", [\"name\", \"symbol\"]),\n\t\tmapArgs: (params) => ({ direction: \"upstream\", ...params }),\n\t});\n\n\tconst detectChanges = makeHubTool(ctx, {\n\t\tname: \"gitnexus_detect_changes\",\n\t\thubTool: \"detect_changes\",\n\t\tlabel: \"GitNexus detect changes\",\n\t\tdescription:\n\t\t\t\"Map the current git diff to indexed symbols and trace which execution flows are impacted. WHEN TO USE: before committing — to understand what your changes affect and what to test.\",\n\t\tpromptSnippet: \"gitnexus_detect_changes: map local diff to affected flows\",\n\t\tparameters: Type.Object({ repo: repoParam }),\n\t\tmapArgs: (params) => {\n\t\t\tconst diff = spawnSync(\"git\", [\"diff\", \"--name-only\", \"HEAD\"], {\n\t\t\t\tcwd: ctx.cwd,\n\t\t\t\tencoding: \"utf8\",\n\t\t\t\ttimeout: 5000,\n\t\t\t});\n\t\t\tconst changed = (diff.stdout ?? \"\")\n\t\t\t\t.split(\"\\n\")\n\t\t\t\t.map((l) => l.trim())\n\t\t\t\t.filter(Boolean);\n\t\t\treturn { ...params, changed_files: changed };\n\t\t},\n\t});\n\n\tconst cypher = makeHubTool(ctx, {\n\t\tname: \"gitnexus_cypher\",\n\t\thubTool: \"cypher\",\n\t\tlabel: \"GitNexus cypher\",\n\t\tdescription:\n\t\t\t\"Execute a Cypher query against the code knowledge graph. Nodes: File, Function, Class, Method, Interface, Community, Process. All edges via CodeRelation with a `type` property (CALLS, IMPORTS, EXTENDS, IMPLEMENTS, HAS_METHOD, ACCESSES, STEP_IN_PROCESS, ...). WHEN TO USE: precise structural questions the other tools cannot answer.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Prefer gitnexus_query/context/impact; reach for gitnexus_cypher only when they cannot express the question.\",\n\t\t],\n\t\tparameters: Type.Object({\n\t\t\tquery: Type.String({ description: \"Cypher query to execute\" }),\n\t\t\trepo: repoParam,\n\t\t}),\n\t});\n\n\tconst listRepos = makeHubTool(ctx, {\n\t\tname: \"gitnexus_list_repos\",\n\t\thubTool: \"list_repos\",\n\t\tlabel: \"GitNexus repos\",\n\t\tdescription:\n\t\t\t\"List all repositories (and multi-repo @groups) indexed on GitNexus, with symbol/relationship counts and indexed dates. WHEN TO USE: to discover or refresh what you can query across repositories.\",\n\t\tparameters: Type.Object({}),\n\t\tmapArgs: () => ({}),\n\t});\n\n\treturn [query, context, impact, detectChanges, cypher, listRepos];\n}\n"]}

package/dist/extensions/gitnexus/tools.js

@@ -0,0 +1,187 @@
+import { spawnSync } from "node:child_process";
+import { Type } from "typebox";
+import { graphRailStore } from "../../core/graph-rail-store.js";
+import { GitNexusClient } from "./client.js";
+import { parseHubJson } from "./render.js";
+/** Copy the first present alias onto `canonical` — models fumble param names (t2: target= for name=). */
+function aliasParam(args, canonical, aliases) {
+    if (args[canonical] !== undefined)
+        return args;
+    for (const alias of aliases) {
+        if (args[alias] !== undefined) {
+            const { [alias]: value, ...rest } = args;
+            return { ...rest, [canonical]: value };
+        }
+    }
+    return args;
+}
+function textResult(text) {
+    return { content: [{ type: "text", text }], details: { source: "gitnexus" } };
+}
+/** Feed the side rail from successful graph tool results. Never throws. */
+function feedRailFromResult(toolName, args, text) {
+    try {
+        if (toolName === "gitnexus_impact") {
+            const data = parseHubJson(text);
+            if (!data?.target?.name || !data.byDepth)
+                return;
+            graphRailStore.setImpact({
+                target: data.target.name,
+                filePath: data.target.filePath,
+                risk: data.risk ?? "UNKNOWN",
+                byDepth: data.byDepth,
+                processes: (data.affected_processes ?? [])
+                    .map((p) => (typeof p === "string" ? p : (p.name ?? "")))
+                    .filter(Boolean),
+                modules: (data.affected_modules ?? [])
+                    .filter((m) => m.name)
+                    .map((m) => ({ name: m.name ?? "", hits: m.hits ?? 0, direct: m.impact === "direct" })),
+                at: Date.now(),
+            });
+        }
+        else if (toolName === "gitnexus_list_repos") {
+            // list_repos returns markdown: `- **owner/name** (12,345 symbols, ...)`
+            const repos = [];
+            for (const match of text.matchAll(/^- \*\*(.+?)\*\* \((\d[\d,]*) symbols/gm)) {
+                repos.push({ name: match[1] ?? "", symbols: match[2] ?? "" });
+            }
+            if (repos.length > 0)
+                graphRailStore.setRepoList(repos);
+        }
+        else if (toolName === "gitnexus_query") {
+            const data = parseHubJson(text);
+            if (!data?.processes)
+                return;
+            graphRailStore.setQuery({
+                query: String(args.query ?? ""),
+                flows: data.processes.slice(0, 4).map((p) => ({
+                    summary: p.summary ?? "(flow)",
+                    ...(p.step_count !== undefined ? { stepCount: p.step_count } : {}),
+                })),
+                at: Date.now(),
+            });
+        }
+    }
+    catch {
+        // rail is cosmetic; tool results must never fail because of it
+    }
+}
+function makeHubTool(ctx, options) {
+    return {
+        name: options.name,
+        label: options.label,
+        description: options.description,
+        ...(options.promptSnippet ? { promptSnippet: options.promptSnippet } : {}),
+        ...(options.promptGuidelines ? { promptGuidelines: options.promptGuidelines } : {}),
+        ...(options.prepareArguments ? { prepareArguments: options.prepareArguments } : {}),
+        parameters: options.parameters,
+        executionMode: "parallel",
+        execute: async (_id, params, signal) => {
+            const raw = (params ?? {});
+            const mapped = options.mapArgs ? options.mapArgs(raw) : { ...raw };
+            if (mapped.repo === undefined) {
+                const current = ctx.currentRepo();
+                if (current)
+                    mapped.repo = current;
+            }
+            const result = await ctx.client.callTool(options.hubTool, mapped, signal);
+            const text = GitNexusClient.text(result);
+            graphRailStore.recordGraphCall();
+            feedRailFromResult(options.name, mapped, text);
+            return textResult(text);
+        },
+    };
+}
+const repoParam = Type.Optional(Type.String({
+    description: "Indexed repository name or @group. Omit for the current repository.",
+}));
+export function createGitNexusTools(ctx) {
+    const query = makeHubTool(ctx, {
+        name: "gitnexus_query",
+        hubTool: "query",
+        label: "GitNexus query",
+        description: "Query the code knowledge graph for execution flows related to a concept. Returns processes (call chains) ranked by relevance, each with its symbols and file locations. WHEN TO USE: understanding how code works together — execution flows and relationships, not just file matches. Complements grep. AFTER THIS: use gitnexus_context on a specific symbol for its 360-degree view.",
+        promptSnippet: "gitnexus_query: find execution flows by concept in the knowledge graph",
+        parameters: Type.Object({
+            query: Type.String({ description: "Natural language or keyword search query" }),
+            goal: Type.Optional(Type.String({ description: "What you want to find. Helps ranking." })),
+            task_context: Type.Optional(Type.String({ description: "What you are working on. Helps ranking." })),
+            limit: Type.Optional(Type.Number({ description: "Max processes to return (default 5)" })),
+            repo: repoParam,
+        }),
+    });
+    const context = makeHubTool(ctx, {
+        name: "gitnexus_context",
+        hubTool: "context",
+        label: "GitNexus context",
+        description: "360-degree view of a single code symbol: categorized incoming/outgoing references (calls, imports, extends, implements, overrides, field reads/writes), process participation, and file location. WHEN TO USE: after gitnexus_query, or whenever you need all callers/callees of a symbol. AFTER THIS: use gitnexus_impact if you plan to change it.",
+        promptSnippet: "gitnexus_context: all callers/callees/flows of one symbol",
+        parameters: Type.Object({
+            name: Type.String({ description: 'Symbol name (e.g. "validateUser", "AuthService")' }),
+            file_path: Type.Optional(Type.String({ description: "File path to disambiguate common names" })),
+            kind: Type.Optional(Type.String({ description: "Kind filter, e.g. 'Function' | 'Class' | 'Method'" })),
+            repo: repoParam,
+        }),
+        prepareArguments: (args) => aliasParam((args ?? {}), "name", ["target", "symbol"]),
+    });
+    const impact = makeHubTool(ctx, {
+        name: "gitnexus_impact",
+        hubTool: "impact",
+        label: "GitNexus impact",
+        description: "Blast-radius analysis before changing a symbol: direct callers (d=1 WILL BREAK), indirect dependents (d=2 should test), transitive (d=3), affected processes, and a risk level. WHEN TO USE: BEFORE modifying any function/class/method. Report HIGH/CRITICAL results to the user before proceeding.",
+        promptSnippet: "gitnexus_impact: blast radius + risk before editing a symbol",
+        promptGuidelines: [
+            "Before editing a function, class, or method that the graph knows, run gitnexus_impact on it first and surface HIGH/CRITICAL risk to the user.",
+        ],
+        parameters: Type.Object({
+            target: Type.String({ description: "Symbol to analyze" }),
+            direction: Type.Optional(Type.String({ description: '"upstream" (callers, default), "downstream" (callees), or "both"' })),
+            repo: repoParam,
+        }),
+        prepareArguments: (args) => aliasParam((args ?? {}), "target", ["name", "symbol"]),
+        mapArgs: (params) => ({ direction: "upstream", ...params }),
+    });
+    const detectChanges = makeHubTool(ctx, {
+        name: "gitnexus_detect_changes",
+        hubTool: "detect_changes",
+        label: "GitNexus detect changes",
+        description: "Map the current git diff to indexed symbols and trace which execution flows are impacted. WHEN TO USE: before committing — to understand what your changes affect and what to test.",
+        promptSnippet: "gitnexus_detect_changes: map local diff to affected flows",
+        parameters: Type.Object({ repo: repoParam }),
+        mapArgs: (params) => {
+            const diff = spawnSync("git", ["diff", "--name-only", "HEAD"], {
+                cwd: ctx.cwd,
+                encoding: "utf8",
+                timeout: 5000,
+            });
+            const changed = (diff.stdout ?? "")
+                .split("\n")
+                .map((l) => l.trim())
+                .filter(Boolean);
+            return { ...params, changed_files: changed };
+        },
+    });
+    const cypher = makeHubTool(ctx, {
+        name: "gitnexus_cypher",
+        hubTool: "cypher",
+        label: "GitNexus cypher",
+        description: "Execute a Cypher query against the code knowledge graph. Nodes: File, Function, Class, Method, Interface, Community, Process. All edges via CodeRelation with a `type` property (CALLS, IMPORTS, EXTENDS, IMPLEMENTS, HAS_METHOD, ACCESSES, STEP_IN_PROCESS, ...). WHEN TO USE: precise structural questions the other tools cannot answer.",
+        promptGuidelines: [
+            "Prefer gitnexus_query/context/impact; reach for gitnexus_cypher only when they cannot express the question.",
+        ],
+        parameters: Type.Object({
+            query: Type.String({ description: "Cypher query to execute" }),
+            repo: repoParam,
+        }),
+    });
+    const listRepos = makeHubTool(ctx, {
+        name: "gitnexus_list_repos",
+        hubTool: "list_repos",
+        label: "GitNexus repos",
+        description: "List all repositories (and multi-repo @groups) indexed on GitNexus, with symbol/relationship counts and indexed dates. WHEN TO USE: to discover or refresh what you can query across repositories.",
+        parameters: Type.Object({}),
+        mapArgs: () => ({}),
+    });
+    return [query, context, impact, detectChanges, cypher, listRepos];
+}
+//# sourceMappingURL=tools.js.map

package/dist/extensions/gitnexus/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/extensions/gitnexus/tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { Type } from \"typebox\";\nimport type { ToolDefinition } from \"../../core/extensions/types.ts\";\nimport { graphRailStore } from \"../../core/graph-rail-store.ts\";\nimport { GitNexusClient } from \"./client.ts\";\nimport { type ImpactData, parseHubJson, type QueryData } from \"./render.ts\";\n\n/**\n * The six model-visible GitNexus tools, wrapping hub MCP tools 1:1.\n * Descriptions are ported near-verbatim from the hub's own MCP tool\n * descriptions — they are battle-tested with Claude/codex; do not rewrite.\n */\n\nexport interface GitNexusToolContext {\n\tclient: GitNexusClient;\n\t/** Default repo for calls that omit `repo` (the resolved current repo). */\n\tcurrentRepo: () => string | undefined;\n\tcwd: string;\n}\n\ninterface HubCallArgs {\n\t[key: string]: unknown;\n}\n\n/** Copy the first present alias onto `canonical` — models fumble param names (t2: target= for name=). */\nfunction aliasParam(args: Record<string, unknown>, canonical: string, aliases: string[]): Record<string, unknown> {\n\tif (args[canonical] !== undefined) return args;\n\tfor (const alias of aliases) {\n\t\tif (args[alias] !== undefined) {\n\t\t\tconst { [alias]: value, ...rest } = args;\n\t\t\treturn { ...rest, [canonical]: value };\n\t\t}\n\t}\n\treturn args;\n}\n\nfunction textResult(text: string) {\n\treturn { content: [{ type: \"text\" as const, text }], details: { source: \"gitnexus\" } };\n}\n\n/** Feed the side rail from successful graph tool results. Never throws. */\nfunction feedRailFromResult(toolName: string, args: Record<string, unknown>, text: string): void {\n\ttry {\n\t\tif (toolName === \"gitnexus_impact\") {\n\t\t\tconst data = parseHubJson<ImpactData>(text);\n\t\t\tif (!data?.target?.name || !data.byDepth) return;\n\t\t\tgraphRailStore.setImpact({\n\t\t\t\ttarget: data.target.name,\n\t\t\t\tfilePath: data.target.filePath,\n\t\t\t\trisk: data.risk ?? \"UNKNOWN\",\n\t\t\t\tbyDepth: data.byDepth,\n\t\t\t\tprocesses: (data.affected_processes ?? [])\n\t\t\t\t\t.map((p) => (typeof p === \"string\" ? p : (p.name ?? \"\")))\n\t\t\t\t\t.filter(Boolean),\n\t\t\t\tmodules: (data.affected_modules ?? [])\n\t\t\t\t\t.filter((m) => m.name)\n\t\t\t\t\t.map((m) => ({ name: m.name ?? \"\", hits: m.hits ?? 0, direct: m.impact === \"direct\" })),\n\t\t\t\tat: Date.now(),\n\t\t\t});\n\t\t} else if (toolName === \"gitnexus_list_repos\") {\n\t\t\t// list_repos returns markdown: `- **owner/name** (12,345 symbols, ...)`\n\t\t\tconst repos: Array<{ name: string; symbols: string }> = [];\n\t\t\tfor (const match of text.matchAll(/^- \\*\\*(.+?)\\*\\* \\((\\d[\\d,]*) symbols/gm)) {\n\t\t\t\trepos.push({ name: match[1] ?? \"\", symbols: match[2] ?? \"\" });\n\t\t\t}\n\t\t\tif (repos.length > 0) graphRailStore.setRepoList(repos);\n\t\t} else if (toolName === \"gitnexus_query\") {\n\t\t\tconst data = parseHubJson<QueryData>(text);\n\t\t\tif (!data?.processes) return;\n\t\t\tgraphRailStore.setQuery({\n\t\t\t\tquery: String(args.query ?? \"\"),\n\t\t\t\tflows: data.processes.slice(0, 4).map((p) => ({\n\t\t\t\t\tsummary: p.summary ?? \"(flow)\",\n\t\t\t\t\t...(p.step_count !== undefined ? { stepCount: p.step_count } : {}),\n\t\t\t\t})),\n\t\t\t\tat: Date.now(),\n\t\t\t});\n\t\t}\n\t} catch {\n\t\t// rail is cosmetic; tool results must never fail because of it\n\t}\n}\n\nfunction makeHubTool(\n\tctx: GitNexusToolContext,\n\toptions: {\n\t\tname: string;\n\t\thubTool: string;\n\t\tlabel: string;\n\t\tdescription: string;\n\t\tpromptSnippet?: string;\n\t\tpromptGuidelines?: string[];\n\t\tparameters: ReturnType<typeof Type.Object>;\n\t\tprepareArguments?: (args: unknown) => Record<string, unknown>;\n\t\tmapArgs?: (params: Record<string, unknown>) => HubCallArgs;\n\t},\n): ToolDefinition {\n\treturn {\n\t\tname: options.name,\n\t\tlabel: options.label,\n\t\tdescription: options.description,\n\t\t...(options.promptSnippet ? { promptSnippet: options.promptSnippet } : {}),\n\t\t...(options.promptGuidelines ? { promptGuidelines: options.promptGuidelines } : {}),\n\t\t...(options.prepareArguments ? { prepareArguments: options.prepareArguments } : {}),\n\t\tparameters: options.parameters,\n\t\texecutionMode: \"parallel\",\n\t\texecute: async (_id, params, signal) => {\n\t\t\tconst raw = (params ?? {}) as Record<string, unknown>;\n\t\t\tconst mapped = options.mapArgs ? options.mapArgs(raw) : { ...raw };\n\t\t\tif (mapped.repo === undefined) {\n\t\t\t\tconst current = ctx.currentRepo();\n\t\t\t\tif (current) mapped.repo = current;\n\t\t\t}\n\t\t\tconst result = await ctx.client.callTool(options.hubTool, mapped, signal);\n\t\t\tconst text = GitNexusClient.text(result);\n\t\t\tgraphRailStore.recordGraphCall();\n\t\t\tfeedRailFromResult(options.name, mapped, text);\n\t\t\treturn textResult(text);\n\t\t},\n\t};\n}\n\nconst repoParam = Type.Optional(\n\tType.String({\n\t\tdescription: \"Indexed repository name or @group. Omit for the current repository.\",\n\t}),\n);\n\nexport function createGitNexusTools(ctx: GitNexusToolContext): ToolDefinition[] {\n\tconst query = makeHubTool(ctx, {\n\t\tname: \"gitnexus_query\",\n\t\thubTool: \"query\",\n\t\tlabel: \"GitNexus query\",\n\t\tdescription:\n\t\t\t\"Query the code knowledge graph for execution flows related to a concept. Returns processes (call chains) ranked by relevance, each with its symbols and file locations. WHEN TO USE: understanding how code works together — execution flows and relationships, not just file matches. Complements grep. AFTER THIS: use gitnexus_context on a specific symbol for its 360-degree view.\",\n\t\tpromptSnippet: \"gitnexus_query: find execution flows by concept in the knowledge graph\",\n\t\tparameters: Type.Object({\n\t\t\tquery: Type.String({ description: \"Natural language or keyword search query\" }),\n\t\t\tgoal: Type.Optional(Type.String({ description: \"What you want to find. Helps ranking.\" })),\n\t\t\ttask_context: Type.Optional(Type.String({ description: \"What you are working on. Helps ranking.\" })),\n\t\t\tlimit: Type.Optional(Type.Number({ description: \"Max processes to return (default 5)\" })),\n\t\t\trepo: repoParam,\n\t\t}),\n\t});\n\n\tconst context = makeHubTool(ctx, {\n\t\tname: \"gitnexus_context\",\n\t\thubTool: \"context\",\n\t\tlabel: \"GitNexus context\",\n\t\tdescription:\n\t\t\t\"360-degree view of a single code symbol: categorized incoming/outgoing references (calls, imports, extends, implements, overrides, field reads/writes), process participation, and file location. WHEN TO USE: after gitnexus_query, or whenever you need all callers/callees of a symbol. AFTER THIS: use gitnexus_impact if you plan to change it.\",\n\t\tpromptSnippet: \"gitnexus_context: all callers/callees/flows of one symbol\",\n\t\tparameters: Type.Object({\n\t\t\tname: Type.String({ description: 'Symbol name (e.g. \"validateUser\", \"AuthService\")' }),\n\t\t\tfile_path: Type.Optional(Type.String({ description: \"File path to disambiguate common names\" })),\n\t\t\tkind: Type.Optional(Type.String({ description: \"Kind filter, e.g. 'Function' | 'Class' | 'Method'\" })),\n\t\t\trepo: repoParam,\n\t\t}),\n\t\tprepareArguments: (args: unknown) =>\n\t\t\taliasParam((args ?? {}) as Record<string, unknown>, \"name\", [\"target\", \"symbol\"]),\n\t});\n\n\tconst impact = makeHubTool(ctx, {\n\t\tname: \"gitnexus_impact\",\n\t\thubTool: \"impact\",\n\t\tlabel: \"GitNexus impact\",\n\t\tdescription:\n\t\t\t\"Blast-radius analysis before changing a symbol: direct callers (d=1 WILL BREAK), indirect dependents (d=2 should test), transitive (d=3), affected processes, and a risk level. WHEN TO USE: BEFORE modifying any function/class/method. Report HIGH/CRITICAL results to the user before proceeding.\",\n\t\tpromptSnippet: \"gitnexus_impact: blast radius + risk before editing a symbol\",\n\t\tpromptGuidelines: [\n\t\t\t\"Before editing a function, class, or method that the graph knows, run gitnexus_impact on it first and surface HIGH/CRITICAL risk to the user.\",\n\t\t],\n\t\tparameters: Type.Object({\n\t\t\ttarget: Type.String({ description: \"Symbol to analyze\" }),\n\t\t\tdirection: Type.Optional(\n\t\t\t\tType.String({ description: '\"upstream\" (callers, default), \"downstream\" (callees), or \"both\"' }),\n\t\t\t),\n\t\t\trepo: repoParam,\n\t\t}),\n\t\tprepareArguments: (args: unknown) =>\n\t\t\taliasParam((args ?? {}) as Record<string, unknown>, \"target\", [\"name\", \"symbol\"]),\n\t\tmapArgs: (params) => ({ direction: \"upstream\", ...params }),\n\t});\n\n\tconst detectChanges = makeHubTool(ctx, {\n\t\tname: \"gitnexus_detect_changes\",\n\t\thubTool: \"detect_changes\",\n\t\tlabel: \"GitNexus detect changes\",\n\t\tdescription:\n\t\t\t\"Map the current git diff to indexed symbols and trace which execution flows are impacted. WHEN TO USE: before committing — to understand what your changes affect and what to test.\",\n\t\tpromptSnippet: \"gitnexus_detect_changes: map local diff to affected flows\",\n\t\tparameters: Type.Object({ repo: repoParam }),\n\t\tmapArgs: (params) => {\n\t\t\tconst diff = spawnSync(\"git\", [\"diff\", \"--name-only\", \"HEAD\"], {\n\t\t\t\tcwd: ctx.cwd,\n\t\t\t\tencoding: \"utf8\",\n\t\t\t\ttimeout: 5000,\n\t\t\t});\n\t\t\tconst changed = (diff.stdout ?? \"\")\n\t\t\t\t.split(\"\\n\")\n\t\t\t\t.map((l) => l.trim())\n\t\t\t\t.filter(Boolean);\n\t\t\treturn { ...params, changed_files: changed };\n\t\t},\n\t});\n\n\tconst cypher = makeHubTool(ctx, {\n\t\tname: \"gitnexus_cypher\",\n\t\thubTool: \"cypher\",\n\t\tlabel: \"GitNexus cypher\",\n\t\tdescription:\n\t\t\t\"Execute a Cypher query against the code knowledge graph. Nodes: File, Function, Class, Method, Interface, Community, Process. All edges via CodeRelation with a `type` property (CALLS, IMPORTS, EXTENDS, IMPLEMENTS, HAS_METHOD, ACCESSES, STEP_IN_PROCESS, ...). WHEN TO USE: precise structural questions the other tools cannot answer.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Prefer gitnexus_query/context/impact; reach for gitnexus_cypher only when they cannot express the question.\",\n\t\t],\n\t\tparameters: Type.Object({\n\t\t\tquery: Type.String({ description: \"Cypher query to execute\" }),\n\t\t\trepo: repoParam,\n\t\t}),\n\t});\n\n\tconst listRepos = makeHubTool(ctx, {\n\t\tname: \"gitnexus_list_repos\",\n\t\thubTool: \"list_repos\",\n\t\tlabel: \"GitNexus repos\",\n\t\tdescription:\n\t\t\t\"List all repositories (and multi-repo @groups) indexed on GitNexus, with symbol/relationship counts and indexed dates. WHEN TO USE: to discover or refresh what you can query across repositories.\",\n\t\tparameters: Type.Object({}),\n\t\tmapArgs: () => ({}),\n\t});\n\n\treturn [query, context, impact, detectChanges, cypher, listRepos];\n}\n"]}

package/dist/extensions/index.d.ts

@@ -0,0 +1,3 @@
+import type { InlineExtension } from "../core/extensions/types.ts";
+export declare const builtInExtensions: InlineExtension[];
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAMnE,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAI9C,CAAC","sourcesContent":["import type { InlineExtension } from \"../core/extensions/types.ts\";\nimport gitnexusExtension from \"./gitnexus/index.ts\";\nimport mcpExtension from \"./mcp/index.ts\";\n\n// llama.cpp support lives in ./llama and is kept in tree but not registered.\n// Re-add `{ name: \"llama.cpp\", factory: llamaExtension, hidden: true }` to turn it back on.\nexport const builtInExtensions: InlineExtension[] = [\n\t{ name: \"gitnexus\", factory: gitnexusExtension },\n\t// No-op until the user writes an mcp.json; connecting nothing costs nothing.\n\t{ name: \"mcp\", factory: mcpExtension },\n];\n"]}

package/dist/extensions/index.js

@@ -0,0 +1,10 @@
+import gitnexusExtension from "./gitnexus/index.js";
+import mcpExtension from "./mcp/index.js";
+// llama.cpp support lives in ./llama and is kept in tree but not registered.
+// Re-add `{ name: "llama.cpp", factory: llamaExtension, hidden: true }` to turn it back on.
+export const builtInExtensions = [
+    { name: "gitnexus", factory: gitnexusExtension },
+    // No-op until the user writes an mcp.json; connecting nothing costs nothing.
+    { name: "mcp", factory: mcpExtension },
+];
+//# sourceMappingURL=index.js.map

package/dist/extensions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AACA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AACpD,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C,6EAA6E;AAC7E,4FAA4F;AAC5F,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IACnD,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE;IAChD,6EAA6E;IAC7E,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE;CACtC,CAAC","sourcesContent":["import type { InlineExtension } from \"../core/extensions/types.ts\";\nimport gitnexusExtension from \"./gitnexus/index.ts\";\nimport mcpExtension from \"./mcp/index.ts\";\n\n// llama.cpp support lives in ./llama and is kept in tree but not registered.\n// Re-add `{ name: \"llama.cpp\", factory: llamaExtension, hidden: true }` to turn it back on.\nexport const builtInExtensions: InlineExtension[] = [\n\t{ name: \"gitnexus\", factory: gitnexusExtension },\n\t// No-op until the user writes an mcp.json; connecting nothing costs nothing.\n\t{ name: \"mcp\", factory: mcpExtension },\n];\n"]}

package/dist/extensions/llama/client.d.ts

@@ -0,0 +1,61 @@
+export type LlamaModelStatus = "unloaded" | "loading" | "loaded" | "downloading" | "sleeping";
+export interface LlamaModelInfo {
+    id: string;
+    aliases?: string[];
+    status: {
+        value: LlamaModelStatus;
+        args?: string[];
+        failed?: boolean;
+        exit_code?: number;
+        progress?: Record<string, {
+            done: number;
+            total: number;
+        }>;
+    };
+    architecture?: {
+        input_modalities?: string[];
+        output_modalities?: string[];
+    };
+    source?: string;
+    meta?: {
+        n_ctx?: number;
+        n_ctx_train?: number;
+        size?: number;
+        ftype?: string;
+    };
+}
+export interface LlamaModelsResponse {
+    data: LlamaModelInfo[];
+    object?: string;
+}
+export interface LlamaModelEvent {
+    model: string;
+    event: string;
+    data?: unknown;
+}
+export interface LlamaProgress {
+    message: string;
+    ratio?: number;
+    detail?: string;
+}
+export declare function formatBytes(bytes: number): string;
+export declare function normalizeLlamaServerUrl(value: string): string;
+export declare function llamaInferenceUrl(serverUrl: string): string;
+export declare class LlamaClient {
+    readonly serverUrl: string;
+    private readonly apiKey;
+    constructor(serverUrl: string, apiKey?: string);
+    private request;
+    list(options?: {
+        reload?: boolean;
+        signal?: AbortSignal;
+    }): Promise<LlamaModelInfo[]>;
+    load(model: string, signal?: AbortSignal): Promise<void>;
+    unload(model: string, signal?: AbortSignal): Promise<void>;
+    unloadAndWait(model: string, signal?: AbortSignal): Promise<void>;
+    download(model: string, signal?: AbortSignal): Promise<void>;
+    watch(onEvent: (event: LlamaModelEvent) => void, signal?: AbortSignal): Promise<void>;
+    loadAndWait(model: string, onProgress: (progress: LlamaProgress) => void, signal?: AbortSignal): Promise<LlamaModelInfo>;
+    downloadAndWait(model: string, onProgress: (progress: LlamaProgress) => void, signal?: AbortSignal): Promise<LlamaModelInfo[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/extensions/llama/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/extensions/llama/client.ts"],"names":[],"mappings":"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","sourcesContent":["export type LlamaModelStatus = \"unloaded\" | \"loading\" | \"loaded\" | \"downloading\" | \"sleeping\";\n\nexport interface LlamaModelInfo {\n\tid: string;\n\taliases?: string[];\n\tstatus: {\n\t\tvalue: LlamaModelStatus;\n\t\targs?: string[];\n\t\tfailed?: boolean;\n\t\texit_code?: number;\n\t\tprogress?: Record<string, { done: number; total: number }>;\n\t};\n\tarchitecture?: {\n\t\tinput_modalities?: string[];\n\t\toutput_modalities?: string[];\n\t};\n\tsource?: string;\n\tmeta?: {\n\t\tn_ctx?: number;\n\t\tn_ctx_train?: number;\n\t\tsize?: number;\n\t\tftype?: string;\n\t};\n}\n\nexport interface LlamaModelsResponse {\n\tdata: LlamaModelInfo[];\n\tobject?: string;\n}\n\nexport interface LlamaModelEvent {\n\tmodel: string;\n\tevent: string;\n\tdata?: unknown;\n}\n\nexport interface LlamaProgress {\n\tmessage: string;\n\tratio?: number;\n\tdetail?: string;\n}\n\nfunction errorMessage(payload: unknown, fallback: string): string {\n\tif (typeof payload !== \"object\" || payload === null) return fallback;\n\tconst error = (payload as { error?: unknown }).error;\n\tif (typeof error !== \"object\" || error === null) return fallback;\n\tconst message = (error as { message?: unknown }).message;\n\treturn typeof message === \"string\" && message ? message : fallback;\n}\n\nfunction isModelInfo(value: unknown): value is LlamaModelInfo {\n\tif (typeof value !== \"object\" || value === null) return false;\n\tconst candidate = value as { id?: unknown; status?: { value?: unknown } };\n\treturn typeof candidate.id === \"string\" && typeof candidate.status?.value === \"string\";\n}\n\nfunction linkSignal(source: AbortSignal | undefined, target: AbortController): () => void {\n\tif (!source) return () => {};\n\tif (source.aborted) {\n\t\ttarget.abort(source.reason);\n\t\treturn () => {};\n\t}\n\tconst abort = () => target.abort(source.reason);\n\tsource.addEventListener(\"abort\", abort, { once: true });\n\treturn () => source.removeEventListener(\"abort\", abort);\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n\treturn new Promise((resolve, reject) => {\n\t\tif (signal?.aborted) {\n\t\t\treject(signal.reason ?? new Error(\"Cancelled\"));\n\t\t\treturn;\n\t\t}\n\t\tconst abort = () => {\n\t\t\tclearTimeout(timeout);\n\t\t\treject(signal?.reason ?? new Error(\"Cancelled\"));\n\t\t};\n\t\tconst timeout = setTimeout(() => {\n\t\t\tsignal?.removeEventListener(\"abort\", abort);\n\t\t\tresolve();\n\t\t}, ms);\n\t\tsignal?.addEventListener(\"abort\", abort, { once: true });\n\t});\n}\n\nfunction parseLoadProgress(data: unknown): LlamaProgress | undefined {\n\tif (typeof data !== \"object\" || data === null) return undefined;\n\tconst progress = (data as { progress?: unknown }).progress;\n\tif (typeof progress !== \"object\" || progress === null) return undefined;\n\tconst value = progress as { stages?: unknown; current?: unknown; stage?: unknown; value?: unknown };\n\tconst stage =\n\t\ttypeof value.current === \"string\" ? value.current : typeof value.stage === \"string\" ? value.stage : undefined;\n\tconst stages = Array.isArray(value.stages)\n\t\t? value.stages.filter((entry): entry is string => typeof entry === \"string\")\n\t\t: [];\n\tconst stageRatio = typeof value.value === \"number\" ? Math.max(0, Math.min(1, value.value)) : undefined;\n\tlet ratio = stageRatio;\n\tif (stage && stages.length > 0) {\n\t\tconst index = stages.indexOf(stage);\n\t\tif (index >= 0) ratio = (index + (stageRatio ?? 0)) / stages.length;\n\t}\n\treturn {\n\t\tmessage: stage ? `Loading ${stage.replaceAll(\"_\", \" \")}` : \"Loading model\",\n\t\tratio,\n\t};\n}\n\nfunction parseDownloadProgress(data: unknown): LlamaProgress | undefined {\n\tif (typeof data !== \"object\" || data === null) return undefined;\n\tconst nested = (data as { progress?: unknown }).progress;\n\tconst files = typeof nested === \"object\" && nested !== null ? nested : data;\n\tlet done = 0;\n\tlet total = 0;\n\tfor (const value of Object.values(files as Record<string, unknown>)) {\n\t\tif (typeof value !== \"object\" || value === null) continue;\n\t\tconst entry = value as { done?: unknown; total?: unknown };\n\t\tif (typeof entry.done !== \"number\" || typeof entry.total !== \"number\") continue;\n\t\tdone += entry.done;\n\t\ttotal += entry.total;\n\t}\n\tif (total <= 0) return undefined;\n\treturn {\n\t\tmessage: \"Downloading model\",\n\t\tratio: done / total,\n\t\tdetail: `${formatBytes(done)} / ${formatBytes(total)}`,\n\t};\n}\n\nexport function formatBytes(bytes: number): string {\n\tif (bytes < 1024) return `${bytes} B`;\n\tconst units = [\"KiB\", \"MiB\", \"GiB\", \"TiB\"];\n\tlet value = bytes / 1024;\n\tlet unit = units[0]!;\n\tfor (let index = 1; index < units.length && value >= 1024; index++) {\n\t\tvalue /= 1024;\n\t\tunit = units[index]!;\n\t}\n\treturn `${value >= 10 ? value.toFixed(1) : value.toFixed(2)} ${unit}`;\n}\n\nexport function normalizeLlamaServerUrl(value: string): string {\n\tconst url = new URL(value.trim());\n\tif (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n\t\tthrow new Error(\"Server URL must use http or https\");\n\t}\n\turl.hash = \"\";\n\turl.search = \"\";\n\turl.pathname = url.pathname.replace(/\\/+$/u, \"\").replace(/\\/v1$/u, \"\") || \"/\";\n\treturn url.toString().replace(/\\/$/u, \"\");\n}\n\nexport function llamaInferenceUrl(serverUrl: string): string {\n\treturn `${normalizeLlamaServerUrl(serverUrl)}/v1`;\n}\n\nexport class LlamaClient {\n\treadonly serverUrl: string;\n\tprivate readonly apiKey: string | undefined;\n\n\tconstructor(serverUrl: string, apiKey?: string) {\n\t\tthis.serverUrl = normalizeLlamaServerUrl(serverUrl);\n\t\tthis.apiKey = apiKey;\n\t}\n\n\tprivate async request(path: string, init: RequestInit = {}): Promise<unknown> {\n\t\tconst headers = new Headers(init.headers);\n\t\tif (init.body !== undefined) headers.set(\"Content-Type\", \"application/json\");\n\t\tif (this.apiKey) headers.set(\"Authorization\", `Bearer ${this.apiKey}`);\n\t\tconst timeout = AbortSignal.timeout(15_000);\n\t\tconst signal = init.signal ? AbortSignal.any([init.signal, timeout]) : timeout;\n\t\tconst response = await fetch(`${this.serverUrl}${path}`, { ...init, headers, signal });\n\t\tlet payload: unknown;\n\t\ttry {\n\t\t\tpayload = await response.json();\n\t\t} catch {\n\t\t\tpayload = undefined;\n\t\t}\n\t\tif (!response.ok) throw new Error(errorMessage(payload, `llama.cpp returned HTTP ${response.status}`));\n\t\treturn payload;\n\t}\n\n\tasync list(options: { reload?: boolean; signal?: AbortSignal } = {}): Promise<LlamaModelInfo[]> {\n\t\tconst payload = await this.request(`/models${options.reload ? \"?reload=1\" : \"\"}`, { signal: options.signal });\n\t\tif (typeof payload !== \"object\" || payload === null || !Array.isArray((payload as { data?: unknown }).data)) {\n\t\t\tthrow new Error(\"llama.cpp returned an invalid model catalog\");\n\t\t}\n\t\tconst data = (payload as { data: unknown[] }).data;\n\t\tif (!data.every(isModelInfo)) throw new Error(\"Server is not running in llama.cpp router mode\");\n\t\treturn data;\n\t}\n\n\tasync load(model: string, signal?: AbortSignal): Promise<void> {\n\t\tawait this.request(\"/models/load\", { method: \"POST\", body: JSON.stringify({ model }), signal });\n\t}\n\n\tasync unload(model: string, signal?: AbortSignal): Promise<void> {\n\t\tawait this.request(\"/models/unload\", { method: \"POST\", body: JSON.stringify({ model }), signal });\n\t}\n\n\tasync unloadAndWait(model: string, signal?: AbortSignal): Promise<void> {\n\t\tawait this.unload(model, signal);\n\t\twhile (true) {\n\t\t\tconst entry = (await this.list({ signal })).find((candidate) => candidate.id === model);\n\t\t\tif (!entry || entry.status.value === \"unloaded\") return;\n\t\t\tawait sleep(100, signal);\n\t\t}\n\t}\n\n\tasync download(model: string, signal?: AbortSignal): Promise<void> {\n\t\tawait this.request(\"/models\", { method: \"POST\", body: JSON.stringify({ model }), signal });\n\t}\n\n\tasync watch(onEvent: (event: LlamaModelEvent) => void, signal?: AbortSignal): Promise<void> {\n\t\tconst headers = new Headers();\n\t\tif (this.apiKey) headers.set(\"Authorization\", `Bearer ${this.apiKey}`);\n\t\tconst response = await fetch(`${this.serverUrl}/models/sse`, { headers, signal });\n\t\tif (!response.ok || !response.body) throw new Error(`llama.cpp SSE returned HTTP ${response.status}`);\n\t\tconst reader = response.body.getReader();\n\t\tconst decoder = new TextDecoder();\n\t\tlet buffer = \"\";\n\t\twhile (true) {\n\t\t\tconst chunk = await reader.read();\n\t\t\tif (chunk.done) break;\n\t\t\tbuffer += decoder.decode(chunk.value, { stream: true }).replaceAll(\"\\r\\n\", \"\\n\");\n\t\t\tlet boundary = buffer.indexOf(\"\\n\\n\");\n\t\t\twhile (boundary >= 0) {\n\t\t\t\tconst frame = buffer.slice(0, boundary);\n\t\t\t\tbuffer = buffer.slice(boundary + 2);\n\t\t\t\tconst data = frame\n\t\t\t\t\t.split(\"\\n\")\n\t\t\t\t\t.filter((line) => line.startsWith(\"data:\"))\n\t\t\t\t\t.map((line) => line.slice(5).trimStart())\n\t\t\t\t\t.join(\"\\n\");\n\t\t\t\tif (data) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst event = JSON.parse(data) as LlamaModelEvent;\n\t\t\t\t\t\tif (event && typeof event.model === \"string\" && typeof event.event === \"string\") onEvent(event);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Ignore malformed events; catalog polling remains authoritative.\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tboundary = buffer.indexOf(\"\\n\\n\");\n\t\t\t}\n\t\t}\n\t}\n\n\tasync loadAndWait(\n\t\tmodel: string,\n\t\tonProgress: (progress: LlamaProgress) => void,\n\t\tsignal?: AbortSignal,\n\t): Promise<LlamaModelInfo> {\n\t\tconst watcher = new AbortController();\n\t\tconst unlink = linkSignal(signal, watcher);\n\t\tlet eventLoaded = false;\n\t\tlet eventError: string | undefined;\n\t\tvoid this.watch((event) => {\n\t\t\tif (event.model !== model) return;\n\t\t\tif (event.event !== \"model_status\" && event.event !== \"status_change\") return;\n\t\t\tconst data = event.data as { status?: unknown } | undefined;\n\t\t\tif (data?.status === \"loaded\") eventLoaded = true;\n\t\t\tif (data?.status === \"unloaded\") eventError = \"Model failed to load\";\n\t\t\tconst progress = parseLoadProgress(event.data);\n\t\t\tif (progress) onProgress(progress);\n\t\t}, watcher.signal).catch(() => {});\n\t\ttry {\n\t\t\tawait this.load(model, signal);\n\t\t\tonProgress({ message: \"Loading model\" });\n\t\t\twhile (true) {\n\t\t\t\tif (signal?.aborted) throw signal.reason ?? new Error(\"Cancelled\");\n\t\t\t\tconst entry = (await this.list({ signal })).find((candidate) => candidate.id === model);\n\t\t\t\tif (entry?.status.value === \"loaded\") return entry;\n\t\t\t\tif (eventLoaded && !entry) return { id: model, status: { value: \"loaded\" } };\n\t\t\t\tif (entry?.status.failed || eventError) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\tentry?.status.exit_code === undefined\n\t\t\t\t\t\t\t? (eventError ?? \"Model failed to load\")\n\t\t\t\t\t\t\t: `Model exited with code ${entry.status.exit_code}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tawait sleep(250, signal);\n\t\t\t}\n\t\t} finally {\n\t\t\tunlink();\n\t\t\twatcher.abort();\n\t\t}\n\t}\n\n\tasync downloadAndWait(\n\t\tmodel: string,\n\t\tonProgress: (progress: LlamaProgress) => void,\n\t\tsignal?: AbortSignal,\n\t): Promise<LlamaModelInfo[]> {\n\t\tconst watcher = new AbortController();\n\t\tconst unlink = linkSignal(signal, watcher);\n\t\tlet finished = false;\n\t\tlet failure: string | undefined;\n\t\tlet sawDownloading = false;\n\t\tlet polls = 0;\n\t\tvoid this.watch((event) => {\n\t\t\tif (event.model !== model) return;\n\t\t\tif (event.event === \"download_finished\") finished = true;\n\t\t\tif (event.event === \"download_failed\") failure = errorMessage(event.data, \"Download failed\");\n\t\t\tif (event.event === \"download_progress\") {\n\t\t\t\tsawDownloading = true;\n\t\t\t\tconst progress = parseDownloadProgress(event.data);\n\t\t\t\tif (progress) onProgress(progress);\n\t\t\t}\n\t\t}, watcher.signal).catch(() => {});\n\t\ttry {\n\t\t\tawait this.download(model, signal);\n\t\t\tonProgress({ message: \"Downloading model\" });\n\t\t\twhile (true) {\n\t\t\t\tif (signal?.aborted) throw signal.reason ?? new Error(\"Cancelled\");\n\t\t\t\tif (failure) throw new Error(failure);\n\t\t\t\tconst models = await this.list({ signal });\n\t\t\t\tpolls++;\n\t\t\t\tconst entry = models.find((candidate) => candidate.id === model);\n\t\t\t\tif (entry?.status.value === \"downloading\") {\n\t\t\t\t\tsawDownloading = true;\n\t\t\t\t\tconst progress = parseDownloadProgress(entry.status.progress);\n\t\t\t\t\tif (progress) onProgress(progress);\n\t\t\t\t} else if (finished || (entry && (sawDownloading || polls >= 2))) {\n\t\t\t\t\treturn this.list({ reload: true, signal });\n\t\t\t\t}\n\t\t\t\tawait sleep(500, signal);\n\t\t\t}\n\t\t} finally {\n\t\t\tunlink();\n\t\t\twatcher.abort();\n\t\t}\n\t}\n}\n"]}