@pella-labs/pinakes 0.1.10 → 0.3.0

package/dist/llm/provider.js

@@ -0,0 +1,235 @@
+import { execFile } from 'node:child_process';
+import { logger } from '../observability/logger.js';
+/**
+ * Create the best available LLM provider by probing the environment.
+ * First available provider in the cascade wins.
+ */
+export function createLlmProvider(mcpServer) {
+    // 1. MCP Sampling
+    if (mcpServer) {
+        const sampling = mcpServer.getClientCapabilities?.()?.sampling;
+        if (sampling && mcpServer.createMessage) {
+            return new McpSamplingProvider(mcpServer);
+        }
+    }
+    // 2. Ollama
+    const ollamaUrl = process.env['PINAKES_OLLAMA_URL'];
+    if (ollamaUrl) {
+        return new OllamaProvider(ollamaUrl);
+    }
+    // 3. API key (Anthropic or OpenAI)
+    const anthropicKey = process.env['ANTHROPIC_API_KEY'];
+    if (anthropicKey) {
+        return new AnthropicApiProvider(anthropicKey);
+    }
+    const openaiKey = process.env['OPENAI_API_KEY'];
+    if (openaiKey) {
+        return new OpenAiApiProvider(openaiKey);
+    }
+    // 4. claude -p subprocess
+    if (whichSync('claude')) {
+        return new ClaudeSubprocessProvider();
+    }
+    // 5. codex exec subprocess
+    if (whichSync('codex')) {
+        return new CodexSubprocessProvider();
+    }
+    // 6. Disabled
+    return new DisabledProvider();
+}
+// ---------------------------------------------------------------------------
+// Provider implementations
+// ---------------------------------------------------------------------------
+class McpSamplingProvider {
+    server;
+    name = 'mcp-sampling';
+    constructor(server) {
+        this.server = server;
+    }
+    available() {
+        return true;
+    }
+    async complete(opts) {
+        const result = await this.server.createMessage({
+            messages: [{ role: 'user', content: { type: 'text', text: opts.prompt } }],
+            systemPrompt: opts.system,
+            maxTokens: opts.maxTokens,
+            modelPreferences: {
+                hints: [{ name: 'haiku' }],
+                costPriority: 0.8,
+            },
+        });
+        return result.content.text ?? '';
+    }
+}
+class OllamaProvider {
+    baseUrl;
+    name = 'ollama';
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    available() {
+        return true;
+    }
+    async complete(opts) {
+        const model = process.env['PINAKES_OLLAMA_MODEL'] ?? 'llama3.2';
+        const url = `${this.baseUrl.replace(/\/$/, '')}/api/chat`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model,
+                messages: [
+                    { role: 'system', content: opts.system },
+                    { role: 'user', content: opts.prompt },
+                ],
+                stream: false,
+                options: { num_predict: opts.maxTokens },
+            }),
+        });
+        if (!res.ok)
+            throw new Error(`Ollama ${res.status}: ${await res.text()}`);
+        const data = (await res.json());
+        return data.message?.content ?? '';
+    }
+}
+class AnthropicApiProvider {
+    apiKey;
+    name = 'anthropic-api';
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    available() {
+        return true;
+    }
+    async complete(opts) {
+        const res = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': this.apiKey,
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify({
+                model: 'claude-haiku-4-5-20251001',
+                max_tokens: opts.maxTokens,
+                system: opts.system,
+                messages: [{ role: 'user', content: opts.prompt }],
+            }),
+        });
+        if (!res.ok)
+            throw new Error(`Anthropic API ${res.status}: ${await res.text()}`);
+        const data = (await res.json());
+        return data.content?.[0]?.text ?? '';
+    }
+}
+class OpenAiApiProvider {
+    apiKey;
+    name = 'openai-api';
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    available() {
+        return true;
+    }
+    async complete(opts) {
+        const res = await fetch('https://api.openai.com/v1/chat/completions', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: 'gpt-4o-mini',
+                max_tokens: opts.maxTokens,
+                messages: [
+                    { role: 'system', content: opts.system },
+                    { role: 'user', content: opts.prompt },
+                ],
+            }),
+        });
+        if (!res.ok)
+            throw new Error(`OpenAI API ${res.status}: ${await res.text()}`);
+        const data = (await res.json());
+        return data.choices?.[0]?.message?.content ?? '';
+    }
+}
+class ClaudeSubprocessProvider {
+    name = 'claude-subprocess';
+    available() {
+        return true;
+    }
+    async complete(opts) {
+        return runSubprocess('claude', [
+            '-p', opts.prompt,
+            '--bare',
+            '--tools', '',
+            '--model', 'haiku',
+            '--system-prompt', opts.system,
+            '--output-format', 'text',
+            '--max-tokens', String(opts.maxTokens),
+        ]);
+    }
+}
+class CodexSubprocessProvider {
+    name = 'codex-subprocess';
+    available() {
+        return true;
+    }
+    async complete(opts) {
+        return runSubprocess('codex', [
+            'exec',
+            `${opts.system}\n\n${opts.prompt}`,
+            '--ephemeral',
+            '--skip-git-repo-check',
+            '--sandbox', 'read-only',
+        ]);
+    }
+}
+class DisabledProvider {
+    name = 'disabled';
+    available() {
+        return false;
+    }
+    async complete() {
+        throw new Error('No LLM provider available. Set PINAKES_OLLAMA_URL, ANTHROPIC_API_KEY, or ' +
+            'OPENAI_API_KEY, or install claude/codex CLI.');
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Check if a binary exists in PATH (synchronous, cached). */
+const binaryCache = new Map();
+function whichSync(name) {
+    const cached = binaryCache.get(name);
+    if (cached !== undefined)
+        return cached;
+    try {
+        const { execFileSync } = require('node:child_process');
+        execFileSync('which', [name], { stdio: 'ignore' });
+        binaryCache.set(name, true);
+        return true;
+    }
+    catch {
+        binaryCache.set(name, false);
+        return false;
+    }
+}
+/** Run a CLI tool and return its stdout. Timeout: 30s. */
+function runSubprocess(cmd, args) {
+    return new Promise((resolve, reject) => {
+        execFile(cmd, args, { timeout: 30_000, maxBuffer: 1024 * 1024 }, (err, stdout, stderr) => {
+            if (err) {
+                logger.warn({ err, cmd, stderr: stderr?.slice(0, 200) }, 'subprocess LLM call failed');
+                reject(new Error(`${cmd} failed: ${err.message}`));
+                return;
+            }
+            resolve(stdout.trim());
+        });
+    });
+}
+// Export for testing
+export { DisabledProvider as _DisabledProvider };
+export { whichSync as _whichSync };
+//# sourceMappingURL=provider.js.map

package/dist/llm/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/llm/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AA2CpD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAyB;IACzD,kBAAkB;IAClB,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,SAAS,CAAC,qBAAqB,EAAE,EAAE,EAAE,QAAQ,CAAC;QAC/D,IAAI,QAAQ,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;YACxC,OAAO,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,YAAY;IACZ,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,mCAAmC;IACnC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACtD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAChD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,0BAA0B;IAC1B,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,wBAAwB,EAAE,CAAC;IACxC,CAAC;IAED,2BAA2B;IAC3B,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,uBAAuB,EAAE,CAAC;IACvC,CAAC;IAED,cAAc;IACd,OAAO,IAAI,gBAAgB,EAAE,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,MAAM,mBAAmB;IAEM;IADpB,IAAI,GAAG,cAAc,CAAC;IAC/B,YAA6B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAEtD,SAAS;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAA2D;QACxE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAc,CAAC;YAC9C,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1E,YAAY,EAAE,IAAI,CAAC,MAAM;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,gBAAgB,EAAE;gBAChB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC1B,YAAY,EAAE,GAAG;aAClB;SACF,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IACnC,CAAC;CACF;AAED,MAAM,cAAc;IAEW;IADpB,IAAI,GAAG,QAAQ,CAAC;IACzB,YAA6B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEhD,SAAS;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAA2D;QACxE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,UAAU,CAAC;QAChE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK;gBACL,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;oBACxC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;iBACvC;gBACD,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,EAAE;aACzC,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuC,CAAC;QACtE,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IACrC,CAAC;CACF;AAED,MAAM,oBAAoB;IAEK;IADpB,IAAI,GAAG,eAAe,CAAC;IAChC,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,SAAS;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAA2D;QACxE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,uCAAuC,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,IAAI,CAAC,MAAM;gBACxB,mBAAmB,EAAE,YAAY;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,2BAA2B;gBAClC,UAAU,EAAE,IAAI,CAAC,SAAS;gBAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;aACnD,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2C,CAAC;QAC1E,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACvC,CAAC;CACF;AAED,MAAM,iBAAiB;IAEQ;IADpB,IAAI,GAAG,YAAY,CAAC;IAC7B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,SAAS;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAA2D;QACxE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,4CAA4C,EAAE;YACpE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,aAAa;gBACpB,UAAU,EAAE,IAAI,CAAC,SAAS;gBAC1B,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;oBACxC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;iBACvC;aACF,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4D,CAAC;QAC3F,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IACnD,CAAC;CACF;AAED,MAAM,wBAAwB;IACnB,IAAI,GAAG,mBAAmB,CAAC;IAEpC,SAAS;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAA2D;QACxE,OAAO,aAAa,CAAC,QAAQ,EAAE;YAC7B,IAAI,EAAE,IAAI,CAAC,MAAM;YACjB,QAAQ;YACR,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,OAAO;YAClB,iBAAiB,EAAE,IAAI,CAAC,MAAM;YAC9B,iBAAiB,EAAE,MAAM;YACzB,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,uBAAuB;IAClB,IAAI,GAAG,kBAAkB,CAAC;IAEnC,SAAS;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAA2D;QACxE,OAAO,aAAa,CAAC,OAAO,EAAE;YAC5B,MAAM;YACN,GAAG,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,MAAM,EAAE;YAClC,aAAa;YACb,uBAAuB;YACvB,WAAW,EAAE,WAAW;SACzB,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,gBAAgB;IACX,IAAI,GAAG,UAAU,CAAC;IAE3B,SAAS;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,KAAK,CACb,2EAA2E;YACzE,8CAA8C,CACjD,CAAC;IACJ,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,8DAA8D;AAC9D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE/C,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAwC,CAAC;QAC9F,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,SAAS,aAAa,CAAC,GAAW,EAAE,IAAc;IAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACvF,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,4BAA4B,CAAC,CAAC;gBACvF,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,YAAY,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qBAAqB;AACrB,OAAO,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,CAAC;AACjD,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,CAAC"}

package/dist/mcp/envelope.d.ts

@@ -25,7 +25,7 @@ export interface EnvelopeMeta {
     stale_files: string[];
 }
 /**
- * The canonical response wrapper for both `kg_search` and `kg_execute`.
+ * The canonical response wrapper for both `search` and `execute`.
  *
  * `result` is the tool-specific payload. `meta` is always present and
  * always has every field populated. `logs` is optional — present when the

package/dist/mcp/tools/execute.d.ts

@@ -3,7 +3,7 @@ import type { Repository } from '../../db/repository.js';
 import type { DbBundle } from '../../db/client.js';
 import type { QuickJSExecutor } from '../../sandbox/executor.js';
 import type { Embedder } from '../../retrieval/embedder.js';
-export declare const kgExecuteInputShape: {
+export declare const executeInputShape: {
     code: z.ZodString;
     max_tokens: z.ZodOptional<z.ZodNumber>;
     timeout_ms: z.ZodOptional<z.ZodNumber>;
@@ -13,8 +13,8 @@ export declare const kgExecuteInputShape: {
         both: "both";
     }>>;
 };
-export declare const kgExecuteToolConfig: {
-    readonly title: "Run JS in the knowledge-graph sandbox";
+export declare const executeToolConfig: {
+    readonly title: "Query or update the project knowledge base";
     readonly description: string;
     readonly inputSchema: {
         code: z.ZodString;
@@ -27,7 +27,7 @@ export declare const kgExecuteToolConfig: {
         }>>;
     };
 };
-export interface KgExecuteDeps {
+export interface ExecuteDeps {
     repository: Repository;
     executor: QuickJSExecutor;
     bundle: DbBundle;
@@ -37,10 +37,10 @@ export interface KgExecuteDeps {
     personalWikiRoot?: string;
 }
 /**
- * Build the `kg_execute` handler. Phase 3 path: uses `executeWithBindings`
- * with the full `kg.project.*` surface via the warm pool.
+ * Build the `execute` handler. Phase 3 path: uses `executeWithBindings`
+ * with the full `pinakes.project.*` surface via the warm pool.
  */
-export declare function makeKgExecuteHandler(deps: KgExecuteDeps): (args: {
+export declare function makeExecuteHandler(deps: ExecuteDeps): (args: {
     code: string;
     max_tokens?: number;
     timeout_ms?: number;

package/dist/mcp/tools/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAmD5D,eAAO,MAAM,mBAAmB;;;;;;;;;CAuC/B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;CAmBtB,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,QAAQ,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,IACxC,MAAM;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CACzC,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA8F9E"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAwC5D,eAAO,MAAM,iBAAiB;;;;;;;;;CAuC7B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAYpB,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,QAAQ,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,IACpC,MAAM;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CACzC,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA8F9E"}

package/dist/mcp/tools/execute.js

@@ -2,60 +2,49 @@ import { z } from 'zod';
 import { countEnvelopeTokens, countTokens, computeInternalBudget, fitResults } from '../../gate/budget.js';
 import { buildEnvelope, QueryTimer } from '../envelope.js';
 /**
- * `kg_execute` — code-mode tool. The LLM writes a short JS snippet, we run
- * it inside the QuickJS sandbox against the `kg` bindings, and return the
+ * `execute` — code-mode tool. The LLM writes a short JS snippet, we run
+ * it inside the QuickJS sandbox against the `pinakes` bindings, and return the
  * (budget-shaped) result.
  *
- * Phase 3: full `kg.project.*` binding surface via warm pool. Backward-compat
- * `kg.search()`/`kg.get()` aliases remain.
+ * Phase 3: full `pinakes.project.*` binding surface via warm pool. Backward-compat
+ * `pinakes.search()`/`pinakes.get()` aliases remain.
  */
-const KG_EXECUTE_TYPES = `
-declare const kg: {
-  /** Substring search (backward compat). */
-  search(query: string): Array<{ id: string; text: string; source_uri: string }>;
-  /** Chunk lookup by id (backward compat). */
-  get(id: string): { id: string; text: string; source_uri: string } | null;
+const EXECUTE_TYPES = `
+type Node = { id: string; source_uri: string; title: string | null; section_path: string };
+type Chunk = Node & { text: string; node_id: string };
+declare const pinakes: {
+  search(query: string): Chunk[];
+  get(id: string): Chunk | null;
   project: {
-    /** FTS5 full-text search with bm25 ranking. */
-    fts(query: string, opts?: { limit?: number }): Array<{ id: string; text: string; source_uri: string; node_id: string; rank: number; title: string | null; section_path: string }>;
-    /** Vector similarity search. Returns [] if no pre-computed embedding available. */
-    vec(query: string, opts?: { limit?: number }): Array<{ id: string; text: string; source_uri: string; node_id: string; distance: number; title: string | null; section_path: string }>;
-    /** Hybrid FTS + vector search with RRF fusion. Falls back to FTS-only if no embedding cached. */
-    hybrid(query: string, opts?: { limit?: number; rrf_k?: number }): Array<{ id: string; text: string; source_uri: string; node_id: string; score: number; snippet?: string; title: string | null; section_path: string }>;
-    /** Table of contents — list all nodes for LLM-driven browsing. Use this to scan titles, then get(id) to read specific sections. */
-    index(opts?: { kind?: string; source_uri?: string; limit?: number }): Array<{ id: string; title: string | null; source_uri: string; section_path: string; kind: string; token_count: number }>;
-    /** Node lookup by id — full section content. */
-    get(id: string): { id: string; source_uri: string; section_path: string; kind: string; title: string | null; content: string; token_count: number } | null;
-    /** K-hop graph traversal. */
-    neighbors(id: string, opts?: { depth?: number; edge_kinds?: string[] }): Array<{ id: string; source_uri: string; kind: string; title: string | null; depth: number }>;
-    log: {
-      /** Recent log entries. */
-      recent(n?: number, opts?: { kind?: string }): Array<{ id: number; ts: number; kind: string; source_uri: string | null; payload: unknown }>;
-    };
-    /** Concept gaps — topics mentioned ≥3 times with no dedicated wiki page. Check these to find what the wiki is missing, then write() to fill them. */
-    gaps(opts?: { resolved?: boolean }): Array<{ id: number; topic: string; first_seen_at: number; mentions_count: number; resolved_at: number | null }>;
-    /** Create or overwrite a wiki page. Path is relative to wiki root, .md extension enforced. */
+    fts(query: string, opts?: { limit?: number }): (Chunk & { rank: number })[];
+    vec(query: string, opts?: { limit?: number }): (Chunk & { distance: number })[];
+    hybrid(query: string, opts?: { limit?: number; rrf_k?: number }): (Chunk & { score: number; snippet?: string })[];
+    index(opts?: { kind?: string; source_uri?: string; limit?: number }): (Node & { kind: string; token_count: number })[];
+    get(id: string): (Node & { kind: string; content: string; token_count: number }) | null;
+    neighbors(id: string, opts?: { depth?: number; edge_kinds?: string[] }): (Node & { depth: number })[];
+    log: { recent(n?: number, opts?: { kind?: string }): Array<{ id: number; ts: number; kind: string; source_uri: string | null; payload: unknown }> };
+    gaps(opts?: { resolved?: boolean }): Array<{ id: number; topic: string; mentions_count: number; resolved_at: number | null }>;
     write(path: string, content: string): { path: string; bytes: number };
-    /** Append a timestamped entry to log.md. */
     append(entry: string): { path: string; bytes: number };
-    /** Delete a wiki page. Path is relative to wiki root. */
     remove(path: string): { path: string; removed: true };
+    pagerank(opts?: { limit?: number }): (Node & { score: number })[];
+    components(): Array<{ component_id: number; nodes: Node[] }>;
   };
 };
 declare const budget: { fit(items: unknown[], maxTokens?: number): unknown[] };
 declare const logger: { log(...args: unknown[]): void };
 `.trim();
-export const kgExecuteInputShape = {
+export const executeInputShape = {
     code: z
         .string()
         .min(1)
         .describe('JavaScript to run inside the sandbox. The sandbox is QuickJS with ' +
         '`eval`, `Function`, `fetch`, `require`, `process`, and `constructor` ' +
-        'removed. You have `kg.project.*` for FTS, graph traversal, log ' +
+        'removed. You have `pinakes.project.*` for FTS, graph traversal, log ' +
         'queries, and wiki writes (write/append/remove), plus `budget.fit()` ' +
         'for token-aware truncation and `logger.log()` captured into ' +
         '`response.logs`. Return a value.\n' +
-        KG_EXECUTE_TYPES),
+        EXECUTE_TYPES),
     max_tokens: z
         .number()
         .int()
@@ -74,33 +63,26 @@ export const kgExecuteInputShape = {
     scope: z
         .enum(['project', 'personal', 'both'])
         .optional()
-        .describe('Which KG bindings to inject. "project" (default) installs kg.project, ' +
-        '"personal" installs kg.personal, "both" installs both namespaces.'),
+        .describe('Which bindings to inject. "project" (default) installs pinakes.project, ' +
+        '"personal" installs pinakes.personal, "both" installs both namespaces.'),
 };
-export const kgExecuteToolConfig = {
-    title: 'Run JS in the knowledge-graph sandbox',
-    description: 'Run a short JavaScript snippet inside the KG sandbox. The KG indexes a ' +
-        'curated markdown wiki of project knowledge (architecture decisions, ' +
-        'conventions, concepts) — not the source code. Use grep/read for source ' +
-        'files; use this for wiki content.\n\n' +
-        'Read: `kg.project.index()` to browse the wiki TOC, `kg.project.get(id)` for ' +
-        'full content, `kg.project.hybrid()` for search, `kg.project.neighbors()` ' +
-        'for graph traversal, `kg.project.log.recent()` for event log.\n\n' +
-        'Write: `kg.project.write(path, content)` to create/update wiki pages, ' +
-        '`kg.project.append(entry)` to add log entries, `kg.project.remove(path)` ' +
-        'to delete.\n\n' +
-        'Gaps: `kg.project.gaps()` returns concepts mentioned ≥3 times in the wiki ' +
-        'that have no dedicated page — use this to discover what knowledge is missing ' +
-        'and fill it with write().\n\n' +
-        '64MB memory cap, 2s default timeout. No network, no eval.\n\n' +
-        KG_EXECUTE_TYPES,
-    inputSchema: kgExecuteInputShape,
+export const executeToolConfig = {
+    title: 'Query or update the project knowledge base',
+    description: 'Run JS against the project knowledge base for advanced operations.\n\n' +
+        'Read: index() for TOC, get(id) for full content, hybrid() for semantic search, ' +
+        'neighbors() for related topics, pagerank() for key concepts, components() for topic clusters.\n' +
+        'Write: write(path, content), append(entry), remove(path) to capture new knowledge.\n' +
+        'Gaps: gaps() finds under-documented areas.\n\n' +
+        'Use this over `search` when you need to chain queries, browse the knowledge graph, ' +
+        'or write back what you learn. 64MB memory, 2s timeout. No network/eval.\n\n' +
+        EXECUTE_TYPES,
+    inputSchema: executeInputShape,
 };
 /**
- * Build the `kg_execute` handler. Phase 3 path: uses `executeWithBindings`
- * with the full `kg.project.*` surface via the warm pool.
+ * Build the `execute` handler. Phase 3 path: uses `executeWithBindings`
+ * with the full `pinakes.project.*` surface via the warm pool.
  */
-export function makeKgExecuteHandler(deps) {
+export function makeExecuteHandler(deps) {
     return async (args) => {
         const timer = new QueryTimer();
         const maxTokens = args.max_tokens ?? 5000;
@@ -109,8 +91,8 @@ export function makeKgExecuteHandler(deps) {
         if ((scope === 'personal' || scope === 'both') && !deps.personalBundle) {
             const envelope = buildEnvelope({
                 result: {
-                    error: 'personal scope requested but no personal KG is configured — ' +
-                        'set KG_PROFILE_PATH or pass --profile-path',
+                    error: 'personal scope requested but no personal wiki is configured — ' +
+                        'create a personal wiki at ~/.pinakes/wiki/ or pass --profile-path',
                 },
                 tokensBudgeted: maxTokens,
                 tokensUsed: 0,

package/dist/mcp/tools/execute.js.map

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

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

@@ -2,13 +2,14 @@ import { z } from 'zod';
 import type { Repository } from '../../db/repository.js';
 import type { DbBundle } from '../../db/client.js';
 import type { Embedder } from '../../retrieval/embedder.js';
+import type { LlmProvider } from '../../llm/provider.js';
 /**
- * `kg_search` — fast-path hybrid search against the knowledge graph.
+ * `search` — fast-path hybrid search against the project knowledge base.
  *
  * Phase 5: supports all three scopes. For `scope='both'`, results from
- * both KGs are merged and tagged with `source_scope`.
+ * both knowledge bases are merged and tagged with `source_scope`.
  */
-export declare const kgSearchInputShape: {
+export declare const searchInputShape: {
     query: z.ZodString;
     max_tokens: z.ZodOptional<z.ZodNumber>;
     scope: z.ZodOptional<z.ZodEnum<{
@@ -16,9 +17,10 @@ export declare const kgSearchInputShape: {
         personal: "personal";
         both: "both";
     }>>;
+    expand: z.ZodOptional<z.ZodBoolean>;
 };
-export declare const kgSearchToolConfig: {
-    readonly title: "Search the knowledge graph";
+export declare const searchToolConfig: {
+    readonly title: "Search project knowledge base";
     readonly description: string;
     readonly inputSchema: {
         query: z.ZodString;
@@ -28,21 +30,24 @@ export declare const kgSearchToolConfig: {
             personal: "personal";
             both: "both";
         }>>;
+        expand: z.ZodOptional<z.ZodBoolean>;
     };
 };
-export interface KgSearchDeps {
+export interface SearchDeps {
     repository: Repository;
     embedder: Embedder;
     bundle: DbBundle;
     personalBundle?: DbBundle;
+    llmProvider?: LlmProvider;
 }
 /**
- * Build the `kg_search` handler. Supports project, personal, and both scopes.
+ * Build the `search` handler. Supports project, personal, and both scopes.
  */
-export declare function makeKgSearchHandler(deps: KgSearchDeps): (args: {
+export declare function makeSearchHandler(deps: SearchDeps): (args: {
     query: string;
     max_tokens?: number;
     scope?: "project" | "personal" | "both";
+    expand?: boolean;
 }) => Promise<{
     content: [{
         type: "text";

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAM5D;;;;;GAKG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;CA6B9B,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;CAUrB,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,QAAQ,CAAC;IACjB,cAAc,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAaD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,IACtC,MAAM;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CACzC,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA4E9E"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAQzD;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;CAqC5B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAYnB,CAAC;AAEX,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,QAAQ,CAAC;IACjB,cAAc,CAAC,EAAE,QAAQ,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAaD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,IAClC,MAAM;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAgG9E"}