sherpa-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gastón Parravicini
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/adapters/ollama.js

@@ -0,0 +1,110 @@
+import { BackendTimeoutError, ContextExceededError } from './types.js';
+export class OllamaBackend {
+    opts;
+    cachedCapabilities = null;
+    cachedModel = null;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async fetchWithTimeout(url, init, timeoutMs) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            return await fetch(url, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async generate(prompt, opts) {
+        const start = Date.now();
+        const timeoutMs = this.opts.generateTimeoutMs ?? 300_000;
+        let res;
+        try {
+            res = await this.fetchWithTimeout(`${this.opts.baseUrl}/api/generate`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({
+                    model: this.opts.model,
+                    prompt,
+                    stream: false,
+                    options: { num_predict: opts.maxOutputTokens, temperature: opts.temperature }
+                })
+            }, timeoutMs);
+        }
+        catch (err) {
+            if (err?.name === 'AbortError') {
+                throw new BackendTimeoutError(`Ollama didn't respond in ${timeoutMs}ms`);
+            }
+            throw err;
+        }
+        if (!res.ok) {
+            const body = await res.text();
+            if (res.status === 400 && /context/i.test(body)) {
+                throw new ContextExceededError(body);
+            }
+            throw new Error(`Ollama responded ${res.status}: ${body}`);
+        }
+        const data = (await res.json());
+        return {
+            text: data.response,
+            usage: {
+                tokensIn: data.prompt_eval_count ?? 0,
+                tokensOut: data.eval_count ?? 0,
+                elapsedMs: Date.now() - start
+            }
+        };
+    }
+    async getCapabilities() {
+        const health = await this.checkHealth();
+        if (health.status === 'ok' && this.cachedCapabilities && this.cachedModel === health.model) {
+            return this.cachedCapabilities;
+        }
+        const res = await this.fetchWithTimeout(`${this.opts.baseUrl}/api/show`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ name: this.opts.model })
+        }, this.opts.healthTimeoutMs ?? 10_000);
+        if (!res.ok) {
+            // Do not cache this fallback: /api/show may be transiently failing,
+            // and caching would permanently pin the conservative default for the
+            // process lifetime even after the failure resolves.
+            const fallback = { contextWindow: 4096, maxOutputTokens: 2048 };
+            return fallback;
+        }
+        const data = (await res.json());
+        const contextKey = Object.keys(data.model_info ?? {}).find((k) => k.endsWith('.context_length'));
+        const contextWindow = contextKey ? data.model_info[contextKey] : 4096;
+        const capabilities = {
+            contextWindow,
+            maxOutputTokens: Math.min(4096, Math.floor(contextWindow / 2))
+        };
+        this.cachedCapabilities = capabilities;
+        this.cachedModel = this.opts.model;
+        return capabilities;
+    }
+    async checkHealth() {
+        const timeoutMs = this.opts.healthTimeoutMs ?? 10_000;
+        let tagsRes;
+        try {
+            tagsRes = await this.fetchWithTimeout(`${this.opts.baseUrl}/api/tags`, { method: 'GET' }, timeoutMs);
+        }
+        catch {
+            return { status: 'unreachable', detail: `Could not connect to ${this.opts.baseUrl}` };
+        }
+        if (!tagsRes.ok) {
+            return { status: 'unreachable', detail: `Ollama responded ${tagsRes.status} at ${this.opts.baseUrl}` };
+        }
+        const data = (await tagsRes.json());
+        const availableModels = data.models.map((m) => m.name);
+        if (!this.opts.model || !availableModels.includes(this.opts.model)) {
+            return {
+                status: 'model_not_loaded',
+                detail: `Model "${this.opts.model || '(not set)'}" is not available in Ollama`,
+                availableModels
+            };
+        }
+        return { status: 'ok', model: this.opts.model };
+    }
+}
+//# sourceMappingURL=ollama.js.map

package/dist/adapters/ollama.js.map

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

package/dist/adapters/openai-compatible.js

@@ -0,0 +1,88 @@
+import { BackendTimeoutError, ContextExceededError } from './types.js';
+const FALLBACK_CONTEXT_WINDOW = 4096;
+const FALLBACK_MAX_OUTPUT_TOKENS = 2048;
+export class OpenAICompatibleBackend {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async fetchWithTimeout(url, init, timeoutMs) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            return await fetch(url, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async generate(prompt, opts) {
+        const start = Date.now();
+        const timeoutMs = this.opts.generateTimeoutMs ?? 300_000;
+        let res;
+        try {
+            res = await this.fetchWithTimeout(`${this.opts.baseUrl}/v1/chat/completions`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({
+                    model: this.opts.model,
+                    messages: [{ role: 'user', content: prompt }],
+                    max_tokens: opts.maxOutputTokens,
+                    temperature: opts.temperature
+                })
+            }, timeoutMs);
+        }
+        catch (err) {
+            if (err?.name === 'AbortError') {
+                throw new BackendTimeoutError(`OpenAI-compatible backend didn't respond in ${timeoutMs}ms`);
+            }
+            throw err;
+        }
+        if (!res.ok) {
+            const body = await res.text();
+            if (res.status === 400 && /context|too long/i.test(body)) {
+                throw new ContextExceededError(body);
+            }
+            throw new Error(`Backend responded ${res.status}: ${body}`);
+        }
+        const data = (await res.json());
+        return {
+            text: data.choices[0].message.content,
+            usage: {
+                tokensIn: data.usage?.prompt_tokens ?? 0,
+                tokensOut: data.usage?.completion_tokens ?? 0,
+                elapsedMs: Date.now() - start
+            }
+        };
+    }
+    async getCapabilities() {
+        return {
+            contextWindow: this.opts.contextWindowOverride ?? FALLBACK_CONTEXT_WINDOW,
+            maxOutputTokens: this.opts.maxOutputTokensOverride ?? FALLBACK_MAX_OUTPUT_TOKENS
+        };
+    }
+    async checkHealth() {
+        const timeoutMs = this.opts.healthTimeoutMs ?? 10_000;
+        let res;
+        try {
+            res = await this.fetchWithTimeout(`${this.opts.baseUrl}/v1/models`, { method: 'GET' }, timeoutMs);
+        }
+        catch {
+            return { status: 'unreachable', detail: `Could not connect to ${this.opts.baseUrl}` };
+        }
+        if (!res.ok) {
+            return { status: 'unreachable', detail: `Backend responded ${res.status} at ${this.opts.baseUrl}` };
+        }
+        const data = (await res.json());
+        const availableModels = data.data.map((m) => m.id);
+        if (!this.opts.model || !availableModels.includes(this.opts.model)) {
+            return {
+                status: 'model_not_loaded',
+                detail: `Model "${this.opts.model || '(not set)'}" is not available`,
+                availableModels
+            };
+        }
+        return { status: 'ok', model: this.opts.model };
+    }
+}
+//# sourceMappingURL=openai-compatible.js.map

package/dist/adapters/openai-compatible.js.map

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

package/dist/adapters/types.js

@@ -0,0 +1,13 @@
+export class BackendTimeoutError extends Error {
+    constructor(detail) {
+        super(detail);
+        this.name = 'BackendTimeoutError';
+    }
+}
+export class ContextExceededError extends Error {
+    constructor(detail) {
+        super(detail);
+        this.name = 'ContextExceededError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,MAAc;QACxB,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,MAAc;QACxB,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/backend-factory.js

@@ -0,0 +1,15 @@
+import { OllamaBackend } from './adapters/ollama.js';
+import { OpenAICompatibleBackend } from './adapters/openai-compatible.js';
+export function createBackend(config, modelOverride) {
+    const model = modelOverride ?? config.model ?? '';
+    if (config.backend === 'ollama') {
+        return new OllamaBackend({ baseUrl: config.baseUrl, model });
+    }
+    return new OpenAICompatibleBackend({
+        baseUrl: config.baseUrl,
+        model,
+        contextWindowOverride: config.contextWindowOverride,
+        maxOutputTokensOverride: config.maxOutputTokensOverride
+    });
+}
+//# sourceMappingURL=backend-factory.js.map

package/dist/backend-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-factory.js","sourceRoot":"","sources":["../src/backend-factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,UAAU,aAAa,CAAC,MAAoB,EAAE,aAAsB;IACxE,MAAM,KAAK,GAAG,aAAa,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAClD,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,IAAI,aAAa,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,uBAAuB,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK;QACL,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;QACnD,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;KACxD,CAAC,CAAC;AACL,CAAC"}

package/dist/chunking.js

@@ -0,0 +1,28 @@
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+export function planChunks(files, contextWindow, reserveTokens) {
+    const budget = contextWindow - reserveTokens;
+    const skipped = [];
+    const chunks = [];
+    let current = [];
+    let currentTokens = 0;
+    for (const file of files) {
+        const fileTokens = estimateTokens(file.content);
+        if (fileTokens > budget) {
+            skipped.push({ path: file.path, reason: 'exceeds_context_window' });
+            continue;
+        }
+        if (currentTokens + fileTokens > budget && current.length > 0) {
+            chunks.push(current);
+            current = [];
+            currentTokens = 0;
+        }
+        current.push(file);
+        currentTokens += fileTokens;
+    }
+    if (current.length > 0)
+        chunks.push(current);
+    return { chunks, skipped };
+}
+//# sourceMappingURL=chunking.js.map

package/dist/chunking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.js","sourceRoot":"","sources":["../src/chunking.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAoB,EAAE,aAAqB,EAAE,aAAqB;IAC3F,MAAM,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;IAC7C,MAAM,OAAO,GAAuC,EAAE,CAAC;IACvD,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,IAAI,OAAO,GAAkB,EAAE,CAAC;IAChC,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,UAAU,GAAG,MAAM,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC,CAAC;YACpE,SAAS;QACX,CAAC;QACD,IAAI,aAAa,GAAG,UAAU,GAAG,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,EAAE,CAAC;YACb,aAAa,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,aAAa,IAAI,UAAU,CAAC;IAC9B,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE7C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/config.js

@@ -0,0 +1,62 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+const DEFAULTS = {
+    backend: 'ollama',
+    baseUrl: 'http://localhost:11434',
+    model: undefined,
+    maxFiles: 100,
+    maxChunks: 20,
+    resultsDir: '.sherpa',
+    truncationThreshold: 0.75,
+    contextWindowOverride: undefined,
+    maxOutputTokensOverride: undefined
+};
+function readJsonIfExists(filePath) {
+    if (!fs.existsSync(filePath))
+        return {};
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+}
+function parseNumericEnv(envVarName, rawValue) {
+    const value = Number(rawValue);
+    if (!Number.isFinite(value)) {
+        throw new Error(`sherpa: invalid value for ${envVarName}: "${rawValue}" is not a finite number.`);
+    }
+    return value;
+}
+export function loadConfig(projectRoot, opts = {}) {
+    const env = opts.env ?? process.env;
+    const userConfigPath = opts.userConfigPath ?? path.join(os.homedir(), '.claude', 'sherpa', 'config.json');
+    const projectConfigPath = path.join(projectRoot, 'sherpa.config.json');
+    const userConfig = readJsonIfExists(userConfigPath);
+    const projectConfig = readJsonIfExists(projectConfigPath);
+    const merged = { ...DEFAULTS, ...userConfig, ...projectConfig };
+    if (env.SHERPA_BACKEND) {
+        if (env.SHERPA_BACKEND !== 'ollama' && env.SHERPA_BACKEND !== 'openai-compatible') {
+            throw new Error(`sherpa: invalid value for SHERPA_BACKEND: "${env.SHERPA_BACKEND}". ` +
+                `Valid values are "ollama" or "openai-compatible".`);
+        }
+        merged.backend = env.SHERPA_BACKEND;
+    }
+    if (env.SHERPA_BASE_URL)
+        merged.baseUrl = env.SHERPA_BASE_URL;
+    if (env.SHERPA_MODEL)
+        merged.model = env.SHERPA_MODEL;
+    if (env.SHERPA_MAX_FILES)
+        merged.maxFiles = parseNumericEnv('SHERPA_MAX_FILES', env.SHERPA_MAX_FILES);
+    if (env.SHERPA_MAX_CHUNKS)
+        merged.maxChunks = parseNumericEnv('SHERPA_MAX_CHUNKS', env.SHERPA_MAX_CHUNKS);
+    if (env.SHERPA_RESULTS_DIR)
+        merged.resultsDir = env.SHERPA_RESULTS_DIR;
+    if (env.SHERPA_TRUNCATION_THRESHOLD) {
+        merged.truncationThreshold = parseNumericEnv('SHERPA_TRUNCATION_THRESHOLD', env.SHERPA_TRUNCATION_THRESHOLD);
+    }
+    if (env.SHERPA_CONTEXT_WINDOW) {
+        merged.contextWindowOverride = parseNumericEnv('SHERPA_CONTEXT_WINDOW', env.SHERPA_CONTEXT_WINDOW);
+    }
+    if (env.SHERPA_MAX_OUTPUT_TOKENS) {
+        merged.maxOutputTokensOverride = parseNumericEnv('SHERPA_MAX_OUTPUT_TOKENS', env.SHERPA_MAX_OUTPUT_TOKENS);
+    }
+    return merged;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/file-enumeration.js

@@ -0,0 +1,70 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import * as ignoreModule from 'ignore';
+import { resolveWithinRoot } from './paths.js';
+// Cast works around a TypeScript CJS/ESM interop issue in ignore@5.3.2
+// (CommonJS runtime, but its .d.ts declares an ESM `export default`).
+const ignore = ignoreModule.default;
+function loadIgnoreRules(root, resultsDir) {
+    const ig = ignore();
+    const gitignorePath = path.join(root, '.gitignore');
+    if (fs.existsSync(gitignorePath)) {
+        ig.add(fs.readFileSync(gitignorePath, 'utf8'));
+    }
+    // Always excluded, regardless of .gitignore: sherpa's own results
+    // directory. Without this, a project that hasn't yet added resultsDir
+    // to .gitignore (the README tells you to, but nothing enforces it) will
+    // have delegate_exploration read back its own prior output on the next
+    // run over the same paths — wasted local tokens, and it compounds since
+    // each run adds another file to resultsDir.
+    ig.add(['.git', 'node_modules', resultsDir]);
+    return ig;
+}
+function walk(dir, root, ig, out) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        const rel = path.relative(root, full);
+        if (ig.ignores(rel))
+            continue;
+        if (entry.isDirectory()) {
+            walk(full, root, ig, out);
+        }
+        else if (entry.isFile()) {
+            out.push(full);
+        }
+    }
+}
+export function enumerateFiles(root, inputPaths, maxFiles, resultsDir) {
+    const ig = loadIgnoreRules(root, resultsDir);
+    const filesSkipped = [];
+    const collected = [];
+    for (const inputPath of inputPaths) {
+        const resolved = resolveWithinRoot(root, inputPath);
+        if (!resolved) {
+            filesSkipped.push({ path: inputPath, reason: 'outside_project_root' });
+            continue;
+        }
+        let stat;
+        try {
+            stat = fs.statSync(resolved);
+        }
+        catch {
+            filesSkipped.push({ path: inputPath, reason: 'not_found' });
+            continue;
+        }
+        if (stat.isDirectory()) {
+            walk(resolved, root, ig, collected);
+        }
+        else if (stat.isFile()) {
+            const rel = path.relative(root, resolved);
+            if (!ig.ignores(rel))
+                collected.push(resolved);
+        }
+    }
+    const unique = Array.from(new Set(collected));
+    const truncatedByBudget = unique.length > maxFiles;
+    const files = truncatedByBudget ? unique.slice(0, maxFiles) : unique;
+    return { files, filesSkipped, truncatedByBudget };
+}
+//# sourceMappingURL=file-enumeration.js.map

package/dist/file-enumeration.js.map

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

package/dist/hash.js

@@ -0,0 +1,5 @@
+import crypto from 'node:crypto';
+export function sha256(content) {
+    return crypto.createHash('sha256').update(content, 'utf8').digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,UAAU,MAAM,CAAC,OAAe;IACpC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC"}

package/dist/index.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import path from 'node:path';
+import { resolveProjectRoot } from './paths.js';
+import { loadConfig } from './config.js';
+import { createServer } from './server.js';
+/**
+ * Validates that resultsDir stays confined within root, applying the same
+ * path-confinement rule used everywhere else. Throws a clear error if
+ * resultsDir escapes the project root (e.g. via "../../somewhere" in a
+ * committed sherpa.config.json) instead of silently writing outside the
+ * project.
+ *
+ * Unlike resolveWithinRoot, this check is purely lexical (path.resolve/
+ * path.relative on the strings, no fs.realpathSync). That's deliberate:
+ * SHERPA_RESULTS_DIR is validated at startup, before any tool has run and
+ * created the directory tree (which happens via
+ * mkdirSync(..., {recursive: true})), so requiring the path (or its
+ * parent) to already exist on disk would be too strict — a nested
+ * resultsDir like "nested/.sherpa" is legitimate even though "nested/"
+ * doesn't exist yet. This check offers no symlink-escape protection, but
+ * that's acceptable here: at config-validation time there's nothing yet
+ * to symlink-escape, and once tools write inside resultsDir they do so
+ * via path.join(root, resultsDir, <uuid>) with filenames generated by
+ * crypto.randomUUID() (not user-controlled), so there's no relevant
+ * symlink attack surface.
+ */
+export function validateResultsDir(root, resultsDir) {
+    const resolved = path.resolve(root, resultsDir);
+    const rel = path.relative(root, resolved);
+    if (rel.startsWith(`..${path.sep}`) || rel === '..' || path.isAbsolute(rel)) {
+        throw new Error(`sherpa cannot start: SHERPA_RESULTS_DIR ("${resultsDir}") escapes the project root ` +
+            `(${root}). It must resolve to a path inside the root.`);
+    }
+}
+async function main() {
+    const root = resolveProjectRoot(process.cwd());
+    const config = loadConfig(root);
+    validateResultsDir(root, config.resultsDir);
+    const server = createServer(root, config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,UAAkB;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CACb,6CAA6C,UAAU,8BAA8B;YACrF,IAAI,IAAI,+CAA+C,CACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/map-reduce.js

@@ -0,0 +1,48 @@
+/**
+ * Shared map-reduce runner used by delegate_exploration and delegate_search:
+ * slices `chunks` down to `budgetConfig.maxChunks`, sends one map call per
+ * used chunk, and — only if more than one chunk was used — a final reduce
+ * call over the partial results. Usage (calls/tokens/elapsed) is summed
+ * across every call made.
+ */
+export async function runMapReduce(backend, chunks, budgetConfig, buildMapPrompt, buildReducePrompt, generateOpts, emptyText) {
+    const usedChunks = chunks.slice(0, budgetConfig.maxChunks);
+    const droppedChunks = chunks.slice(budgetConfig.maxChunks);
+    const truncatedByChunkBudget = chunks.length > budgetConfig.maxChunks;
+    let calls = 0;
+    let tokensIn = 0;
+    let tokensOut = 0;
+    let elapsedMs = 0;
+    const partials = [];
+    for (const chunk of usedChunks) {
+        const { text, usage } = await backend.generate(buildMapPrompt(chunk), generateOpts);
+        calls++;
+        tokensIn += usage.tokensIn;
+        tokensOut += usage.tokensOut;
+        elapsedMs += usage.elapsedMs;
+        partials.push(text);
+    }
+    let finalText;
+    if (partials.length === 0) {
+        finalText = emptyText;
+    }
+    else if (partials.length === 1) {
+        finalText = partials[0];
+    }
+    else {
+        const { text, usage } = await backend.generate(buildReducePrompt(partials), generateOpts);
+        calls++;
+        tokensIn += usage.tokensIn;
+        tokensOut += usage.tokensOut;
+        elapsedMs += usage.elapsedMs;
+        finalText = text;
+    }
+    return {
+        finalText,
+        usage: { calls, tokensIn, tokensOut, elapsedMs },
+        usedChunkCount: usedChunks.length,
+        truncatedByChunkBudget,
+        droppedChunks
+    };
+}
+//# sourceMappingURL=map-reduce.js.map

package/dist/map-reduce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-reduce.js","sourceRoot":"","sources":["../src/map-reduce.ts"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAgB,EAChB,MAAuB,EACvB,YAAmC,EACnC,cAAgD,EAChD,iBAAiD,EACjD,YAAyC,EACzC,SAAiB;IAEjB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;IAEtE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC;QACpF,KAAK,EAAE,CAAC;QACR,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC;QAC3B,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC;QAC7B,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,SAAiB,CAAC;IACtB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,SAAS,GAAG,SAAS,CAAC;IACxB,CAAC;SAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC;QAC1F,KAAK,EAAE,CAAC;QACR,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC;QAC3B,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC;QAC7B,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC;QAC7B,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,OAAO;QACL,SAAS;QACT,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE;QAChD,cAAc,EAAE,UAAU,CAAC,MAAM;QACjC,sBAAsB;QACtB,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/paths.js

@@ -0,0 +1,51 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+export function resolveProjectRoot(cwd) {
+    const root = fs.realpathSync(cwd);
+    const home = fs.realpathSync(os.homedir());
+    if (root === '/' || root === home) {
+        throw new Error(`sherpa cannot start with ${root} as the project root — too broad to confine. ` +
+            `Start the server from the project directory.`);
+    }
+    return root;
+}
+export function resolveWithinRoot(root, target) {
+    const candidate = path.resolve(root, target);
+    let real;
+    try {
+        real = fs.realpathSync(candidate);
+    }
+    catch {
+        // The file may not exist yet (a new write target). But it could also
+        // be a dangling symlink (target doesn't exist) — in that case it's
+        // NOT a legitimate new file, it's a symlink that would write through
+        // it to a destination potentially outside the root. We reject it.
+        try {
+            const stat = fs.lstatSync(candidate);
+            if (stat.isSymbolicLink()) {
+                return null;
+            }
+        }
+        catch {
+            // Nothing exists at that path at all (not even a dangling symlink)
+            // — it's a legitimate new write target, keep going.
+        }
+        // Resolve the parent directory and rebuild the final path.
+        const parent = path.dirname(candidate);
+        let realParent;
+        try {
+            realParent = fs.realpathSync(parent);
+        }
+        catch {
+            return null;
+        }
+        real = path.join(realParent, path.basename(candidate));
+    }
+    const rel = path.relative(root, real);
+    if (rel.startsWith(`..${path.sep}`) || rel === '..' || path.isAbsolute(rel)) {
+        return null;
+    }
+    return real;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,4BAA4B,IAAI,+CAA+C;YAC/E,8CAA8C,CAC/C,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAc;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE7C,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;QACrE,mEAAmE;QACnE,qEAAqE;QACrE,kEAAkE;QAClE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;YACnE,oDAAoD;QACtD,CAAC;QACD,2DAA2D;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/server.js

@@ -0,0 +1,60 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { createBackend } from './backend-factory.js';
+import { healthCheck } from './tools/health-check.js';
+import { delegateExploration } from './tools/delegate-exploration.js';
+import { delegateSearch } from './tools/delegate-search.js';
+import { delegateTransform } from './tools/delegate-transform.js';
+import { applyTransform } from './tools/apply-transform.js';
+export function createServer(root, config) {
+    const server = new McpServer({ name: 'sherpa', version: '0.1.0' });
+    // One Backend instance per distinct model override, reused across tool
+    // calls for the life of this process. This is what makes OllamaBackend's
+    // getCapabilities() cache (keyed on the model it last saw) actually do
+    // something — a fresh instance per call would always start with an empty
+    // cache and redo the /api/show round trip every time. Backend instances
+    // hold no other call-scoped state, so reusing them across calls/tools is
+    // safe: checkHealth()/getCapabilities() still hit the network live on
+    // every call, this only skips the now-redundant capability lookup.
+    const backends = new Map();
+    function getBackend(modelOverride) {
+        const key = modelOverride ?? '';
+        let backend = backends.get(key);
+        if (!backend) {
+            backend = createBackend(config, modelOverride);
+            backends.set(key, backend);
+        }
+        return backend;
+    }
+    server.tool('health_check', 'Checks whether the local backend (Ollama/llama.cpp/LM Studio) is available and which model is loaded. ' +
+        "Use it before delegating if you're not sure sherpa is available.", { model: z.string().optional() }, async ({ model }) => {
+        const backend = getBackend(model);
+        const result = await healthCheck(backend);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.tool('delegate_exploration', 'Delegates to a local model the reading and synthesis of findings over a set of project files/directories, ' +
+        "without that content entering the orchestrator's context.", { paths: z.array(z.string()), instruction: z.string(), model: z.string().optional() }, async ({ paths, instruction, model }) => {
+        const backend = getBackend(model);
+        const result = await delegateExploration(backend, root, config.resultsDir, { maxFiles: config.maxFiles, maxChunks: config.maxChunks }, { paths, instruction });
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.tool('delegate_search', 'Runs ripgrep over project paths and delegates to a local model the synthesis of the matches ' +
+        'according to the given instruction.', { pattern: z.string(), paths: z.array(z.string()), instruction: z.string(), model: z.string().optional() }, async ({ pattern, paths, instruction, model }) => {
+        const backend = getBackend(model);
+        const result = await delegateSearch(backend, root, config.resultsDir, { maxFiles: config.maxFiles, maxChunks: config.maxChunks }, { pattern, paths, instruction });
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.tool('delegate_transform', 'Generates, via a local model, a proposed batch transformation over the given files. ' +
+        "Doesn't write to disk — the result is reviewed and applied with apply_transform.", { paths: z.array(z.string()), instruction: z.string(), model: z.string().optional() }, async ({ paths, instruction, model }) => {
+        const backend = getBackend(model);
+        const result = await delegateTransform(backend, root, config.resultsDir, config.truncationThreshold, { paths, instruction });
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.tool('apply_transform', 'Applies to the filesystem the changes proposed by a prior delegate_transform, exactly as they were ' +
+        'reviewed — without regenerating anything.', { resultPath: z.string(), paths: z.array(z.string()).optional() }, async ({ resultPath, paths }) => {
+        const result = applyTransform(root, resultPath, paths);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/summary-truncate.js

@@ -0,0 +1,20 @@
+const DEFAULT_CHAR_BUDGET = 4000;
+export function structuredTruncate(text, resultPath, charBudget = DEFAULT_CHAR_BUDGET) {
+    if (text.length <= charBudget) {
+        return { summary: text };
+    }
+    const items = text.split('\n').filter((line) => line.trim().length > 0);
+    let acc = '';
+    let count = 0;
+    for (const item of items) {
+        const candidate = acc ? `${acc}\n${item}` : item;
+        if (candidate.length > charBudget)
+            break;
+        acc = candidate;
+        count++;
+    }
+    return {
+        summary: `${acc}\n\n(truncated: ${count} of ${items.length} findings, rest in ${resultPath})`
+    };
+}
+//# sourceMappingURL=summary-truncate.js.map

package/dist/summary-truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-truncate.js","sourceRoot":"","sources":["../src/summary-truncate.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,UAAkB,EAClB,aAAqB,mBAAmB;IAExC,IAAI,IAAI,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACxE,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,IAAI,SAAS,CAAC,MAAM,GAAG,UAAU;YAAE,MAAM;QACzC,GAAG,GAAG,SAAS,CAAC;QAChB,KAAK,EAAE,CAAC;IACV,CAAC;IAED,OAAO;QACL,OAAO,EAAE,GAAG,GAAG,mBAAmB,KAAK,OAAO,KAAK,CAAC,MAAM,sBAAsB,UAAU,GAAG;KAC9F,CAAC;AACJ,CAAC"}

package/dist/syntax-validators.js

@@ -0,0 +1,49 @@
+import vm from 'node:vm';
+import path from 'node:path';
+export const SYNTAX_VALIDATORS = {
+    '.json': (content) => {
+        try {
+            JSON.parse(content);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    '.js': (content) => {
+        try {
+            new vm.Script(content);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    '.mjs': (content) => {
+        try {
+            new vm.Script(content);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    '.cjs': (content) => {
+        try {
+            new vm.Script(content);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+};
+/** null = no validator available for this extension; the guard doesn't apply. */
+export function validateSyntax(filePath, content) {
+    const ext = path.extname(filePath);
+    const validator = SYNTAX_VALIDATORS[ext];
+    if (!validator)
+        return null;
+    return validator(content);
+}
+//# sourceMappingURL=syntax-validators.js.map

package/dist/syntax-validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-validators.js","sourceRoot":"","sources":["../src/syntax-validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,CAAC,MAAM,iBAAiB,GAAoC;IAChE,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAClB,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAClB,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAe;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC"}

package/dist/tools/apply-transform.js

@@ -0,0 +1,59 @@
+import fs from 'node:fs';
+import { resolveWithinRoot } from '../paths.js';
+import { sha256 } from '../hash.js';
+import { RESULT_SCHEMA_VERSION } from './delegate-transform.js';
+export class UnsupportedSchemaVersionError extends Error {
+    constructor(found, expected) {
+        super(`resultPath has schemaVersion ${found}, this version of sherpa supports ${expected}. ` +
+            `Re-run delegate_transform.`);
+        this.name = 'UnsupportedSchemaVersionError';
+    }
+}
+export function applyTransform(root, resultPath, paths) {
+    const resolvedResultPath = resolveWithinRoot(root, resultPath);
+    if (!resolvedResultPath) {
+        throw new Error(`resultPath outside the project root: ${resultPath}`);
+    }
+    const raw = fs.readFileSync(resolvedResultPath, 'utf8');
+    const data = JSON.parse(raw);
+    if (data.schemaVersion !== RESULT_SCHEMA_VERSION) {
+        throw new UnsupportedSchemaVersionError(data.schemaVersion, RESULT_SCHEMA_VERSION);
+    }
+    const filter = paths ? new Set(paths) : null;
+    const applied = [];
+    const stale = [];
+    const skipped = [];
+    const failed = [];
+    for (const entry of data.files) {
+        if (filter && !filter.has(entry.path)) {
+            skipped.push(entry.path);
+            continue;
+        }
+        const resolvedTarget = resolveWithinRoot(root, entry.path);
+        if (!resolvedTarget) {
+            failed.push({ path: entry.path, reason: 'outside_project_root' });
+            continue;
+        }
+        let currentContent;
+        try {
+            currentContent = fs.readFileSync(resolvedTarget, 'utf8');
+        }
+        catch {
+            failed.push({ path: entry.path, reason: 'read_error' });
+            continue;
+        }
+        if (sha256(currentContent) !== entry.originalHash) {
+            stale.push(entry.path);
+            continue;
+        }
+        try {
+            fs.writeFileSync(resolvedTarget, entry.proposedContent, 'utf8');
+            applied.push(entry.path);
+        }
+        catch {
+            failed.push({ path: entry.path, reason: 'write_error' });
+        }
+    }
+    return { applied, stale, skipped, failed };
+}
+//# sourceMappingURL=apply-transform.js.map

package/dist/tools/apply-transform.js.map

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

package/dist/tools/delegate-exploration.js

@@ -0,0 +1,70 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { enumerateFiles } from '../file-enumeration.js';
+import { planChunks } from '../chunking.js';
+import { structuredTruncate } from '../summary-truncate.js';
+import { runMapReduce } from '../map-reduce.js';
+function buildMapPrompt(instruction, chunk) {
+    const filesBlock = chunk.map((f) => `--- ${f.path} ---\n${f.content}`).join('\n\n');
+    return (`Instruction: ${instruction}\n\n` +
+        `Analyze the following files and report findings relevant to the instruction, ` +
+        `one per line, format "- <file>: <finding>".\n\n${filesBlock}`);
+}
+function buildReducePrompt(instruction, partials) {
+    return (`Original instruction: ${instruction}\n\n` +
+        `Below are partial findings from different groups of files. Synthesize them into ` +
+        `a final list of unique, relevant findings, same format "- <file>: <finding>", ` +
+        `no duplicates.\n\n${partials.join('\n\n')}`);
+}
+export async function delegateExploration(backend, root, resultsDir, budgetConfig, params) {
+    const health = await backend.checkHealth();
+    if (health.status !== 'ok') {
+        return {
+            status: health.status,
+            detail: health.detail,
+            ...(health.status === 'model_not_loaded' ? { availableModels: health.availableModels } : {})
+        };
+    }
+    const enumeration = enumerateFiles(root, params.paths, budgetConfig.maxFiles, resultsDir);
+    const capabilities = await backend.getCapabilities();
+    const reserve = capabilities.maxOutputTokens + 300;
+    const fileContents = [];
+    const filesSkipped = [...enumeration.filesSkipped];
+    for (const filePath of enumeration.files) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf8');
+            fileContents.push({ path: path.relative(root, filePath), content });
+        }
+        catch {
+            filesSkipped.push({ path: path.relative(root, filePath), reason: 'read_error' });
+        }
+    }
+    const { chunks, skipped: chunkSkipped } = planChunks(fileContents, capabilities.contextWindow, reserve);
+    filesSkipped.push(...chunkSkipped);
+    const { finalText, usage, usedChunkCount, truncatedByChunkBudget, droppedChunks } = await runMapReduce(backend, chunks, budgetConfig, (chunk) => buildMapPrompt(params.instruction, chunk), (partials) => buildReducePrompt(params.instruction, partials), { maxOutputTokens: capabilities.maxOutputTokens }, '(no findings: no processable files)');
+    const truncatedByBudget = enumeration.truncatedByBudget || truncatedByChunkBudget;
+    for (const droppedChunk of droppedChunks) {
+        for (const file of droppedChunk) {
+            filesSkipped.push({ path: file.path, reason: 'chunk_budget_exceeded' });
+        }
+    }
+    fs.mkdirSync(path.join(root, resultsDir), { recursive: true });
+    const resultPath = path.join(resultsDir, `exploration-${crypto.randomUUID()}.md`);
+    fs.writeFileSync(path.join(root, resultPath), finalText, 'utf8');
+    const { summary } = structuredTruncate(finalText, resultPath);
+    return {
+        summary,
+        resultPath,
+        filesProcessed: chunks.slice(0, usedChunkCount).reduce((sum, c) => sum + c.length, 0),
+        filesSkipped,
+        budget: {
+            maxFiles: budgetConfig.maxFiles,
+            maxChunks: budgetConfig.maxChunks,
+            filesConsidered: enumeration.files.length,
+            truncatedByBudget
+        },
+        usage
+    };
+}
+//# sourceMappingURL=delegate-exploration.js.map

package/dist/tools/delegate-exploration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-exploration.js","sourceRoot":"","sources":["../../src/tools/delegate-exploration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAoB,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAwBhD,SAAS,cAAc,CAAC,WAAmB,EAAE,KAAoB;IAC/D,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpF,OAAO,CACL,gBAAgB,WAAW,MAAM;QACjC,+EAA+E;QAC/E,kDAAkD,UAAU,EAAE,CAC/D,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,WAAmB,EAAE,QAAkB;IAChE,OAAO,CACL,yBAAyB,WAAW,MAAM;QAC1C,kFAAkF;QAClF,gFAAgF;QAChF,qBAAqB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAC7C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAgB,EAChB,IAAY,EACZ,UAAkB,EAClB,YAAqD,EACrD,MAAiC;IAEjC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,kBAAkB,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7F,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC1F,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,YAAY,CAAC,eAAe,GAAG,GAAG,CAAC;IAEnD,MAAM,YAAY,GAAkB,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IACnD,KAAK,MAAM,QAAQ,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC;YACP,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,UAAU,CAAC,YAAY,EAAE,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACxG,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;IAEnC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,aAAa,EAAE,GAAG,MAAM,YAAY,CACpG,OAAO,EACP,MAAM,EACN,YAAY,EACZ,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,EACpD,CAAC,QAAQ,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,EAC7D,EAAE,eAAe,EAAE,YAAY,CAAC,eAAe,EAAE,EACjD,qCAAqC,CACtC,CAAC;IAEF,MAAM,iBAAiB,GAAG,WAAW,CAAC,iBAAiB,IAAI,sBAAsB,CAAC;IAElF,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAClF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAEjE,MAAM,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAE9D,OAAO;QACL,OAAO;QACP,UAAU;QACV,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACrF,YAAY;QACZ,MAAM,EAAE;YACN,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC/B,SAAS,EAAE,YAAY,CAAC,SAAS;YACjC,eAAe,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM;YACzC,iBAAiB;SAClB;QACD,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/tools/delegate-search.js

@@ -0,0 +1,117 @@
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { resolveWithinRoot } from '../paths.js';
+import { planChunks } from '../chunking.js';
+import { structuredTruncate } from '../summary-truncate.js';
+import { runMapReduce } from '../map-reduce.js';
+export class RipgrepNotFoundError extends Error {
+    constructor() {
+        super('ripgrep (rg) is not installed or not on PATH. Install it: ' +
+            'macOS: brew install ripgrep · Debian/Ubuntu: apt install ripgrep · ' +
+            'https://github.com/BurntSushi/ripgrep#installation');
+        this.name = 'RipgrepNotFoundError';
+    }
+}
+const RIPGREP_MAX_BUFFER = 64 * 1024 * 1024;
+const defaultSpawnFn = (command, args, options) => spawnSync(command, args, { ...options, maxBuffer: RIPGREP_MAX_BUFFER });
+export function runRipgrep(root, pattern, resolvedPaths, resultsDir, spawnFn = defaultSpawnFn) {
+    const result = spawnFn('rg', ['--json', '-C', '2', '-g', `!/${resultsDir}/**`, '--', pattern, ...resolvedPaths], { cwd: root, encoding: 'utf8' });
+    if (result.error) {
+        const code = result.error.code;
+        if (code === 'ENOENT') {
+            throw new RipgrepNotFoundError();
+        }
+        throw new Error(`ripgrep failed to run (${code ?? 'unknown error'}): ${result.error.message}`);
+    }
+    if (typeof result.status === 'number' && result.status >= 2) {
+        throw new Error(`ripgrep failed (exit ${result.status}): ${result.stderr}`);
+    }
+    const matches = [];
+    const lines = (result.stdout ?? '').split('\n').filter(Boolean);
+    for (const line of lines) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (parsed.type === 'match') {
+            const pathText = parsed.data?.path?.text;
+            if (typeof pathText !== 'string') {
+                continue;
+            }
+            matches.push({
+                path: path.relative(root, pathText),
+                lineNumber: parsed.data.line_number,
+                line: parsed.data.lines.text,
+                context: []
+            });
+        }
+    }
+    return matches;
+}
+function buildMapPrompt(instruction, chunk) {
+    const block = chunk.map((c) => `${c.path}: ${c.content}`).join('\n');
+    return (`Instruction: ${instruction}\n\nMatches found:\n${block}\n\n` +
+        `Synthesize according to the instruction, format "- <file>: <finding>".`);
+}
+function buildReducePrompt(instruction, partials) {
+    return (`Original instruction: ${instruction}\n\n` +
+        `Synthesize these partial findings into a single list:\n\n${partials.join('\n\n')}`);
+}
+export async function delegateSearch(backend, root, resultsDir, budgetConfig, params, deps = {}) {
+    const health = await backend.checkHealth();
+    if (health.status !== 'ok') {
+        return {
+            status: health.status,
+            detail: health.detail,
+            ...(health.status === 'model_not_loaded' ? { availableModels: health.availableModels } : {})
+        };
+    }
+    const filesSkipped = [];
+    const resolvedPaths = [];
+    for (const p of params.paths) {
+        const resolved = resolveWithinRoot(root, p);
+        if (!resolved) {
+            filesSkipped.push({ path: p, reason: 'outside_project_root' });
+            continue;
+        }
+        resolvedPaths.push(resolved);
+    }
+    const matches = resolvedPaths.length > 0 ? runRipgrep(root, params.pattern, resolvedPaths, resultsDir, deps.spawnFn) : [];
+    const capabilities = await backend.getCapabilities();
+    const reserve = capabilities.maxOutputTokens + 300;
+    const matchBlocks = matches.map((m) => ({
+        path: `${m.path}:${m.lineNumber}`,
+        content: m.line
+    }));
+    const { chunks } = planChunks(matchBlocks, capabilities.contextWindow, reserve);
+    const { finalText, usage, usedChunkCount, truncatedByChunkBudget, droppedChunks } = await runMapReduce(backend, chunks, budgetConfig, (chunk) => buildMapPrompt(params.instruction, chunk), (partials) => buildReducePrompt(params.instruction, partials), { maxOutputTokens: capabilities.maxOutputTokens }, '(no matches)');
+    for (const droppedChunk of droppedChunks) {
+        for (const match of droppedChunk) {
+            filesSkipped.push({ path: match.path, reason: 'chunk_budget_exceeded' });
+        }
+    }
+    fs.mkdirSync(path.join(root, resultsDir), { recursive: true });
+    const resultPath = path.join(resultsDir, `search-${crypto.randomUUID()}.md`);
+    fs.writeFileSync(path.join(root, resultPath), finalText, 'utf8');
+    const { summary } = structuredTruncate(finalText, resultPath);
+    return {
+        summary,
+        resultPath,
+        matchCount: matches.length,
+        matchesProcessed: chunks.slice(0, usedChunkCount).reduce((sum, c) => sum + c.length, 0),
+        filesSkipped,
+        budget: {
+            maxFiles: budgetConfig.maxFiles,
+            maxChunks: budgetConfig.maxChunks,
+            filesConsidered: matches.length,
+            truncatedByBudget: truncatedByChunkBudget
+        },
+        usage
+    };
+}
+//# sourceMappingURL=delegate-search.js.map

package/dist/tools/delegate-search.js.map

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

package/dist/tools/delegate-transform.js

@@ -0,0 +1,81 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { createTwoFilesPatch } from 'diff';
+import { resolveWithinRoot } from '../paths.js';
+import { sha256 } from '../hash.js';
+import { validateSyntax } from '../syntax-validators.js';
+export const RESULT_SCHEMA_VERSION = 1;
+const PREVIEW_LINES = 15;
+export async function delegateTransform(backend, root, resultsDir, truncationThreshold, params) {
+    const health = await backend.checkHealth();
+    if (health.status !== 'ok') {
+        return {
+            status: health.status,
+            detail: health.detail,
+            ...(health.status === 'model_not_loaded' ? { availableModels: health.availableModels } : {})
+        };
+    }
+    const capabilities = await backend.getCapabilities();
+    const results = [];
+    const proposals = [];
+    let calls = 0;
+    let tokensIn = 0;
+    let tokensOut = 0;
+    let elapsedMs = 0;
+    for (const inputPath of params.paths) {
+        const resolved = resolveWithinRoot(root, inputPath);
+        if (!resolved) {
+            results.push({ path: inputPath, status: 'rejected', reason: 'outside_project_root' });
+            continue;
+        }
+        const relPath = path.relative(root, resolved);
+        let original;
+        try {
+            original = fs.readFileSync(resolved, 'utf8');
+        }
+        catch {
+            results.push({ path: relPath, status: 'skipped', reason: 'read_error' });
+            continue;
+        }
+        const estimatedInputTokens = Math.ceil(original.length / 4);
+        const marginTokens = 200;
+        if (estimatedInputTokens + marginTokens > capabilities.maxOutputTokens) {
+            results.push({ path: relPath, status: 'skipped', reason: 'exceeds_model_output_budget' });
+            continue;
+        }
+        const prompt = `Instruction: ${params.instruction}\n\nFile (${relPath}):\n${original}\n\n` +
+            `Return the complete transformed file according to the instruction, with no extra explanation.`;
+        const { text: proposedContent, usage } = await backend.generate(prompt, {
+            maxOutputTokens: capabilities.maxOutputTokens
+        });
+        calls++;
+        tokensIn += usage.tokensIn;
+        tokensOut += usage.tokensOut;
+        elapsedMs += usage.elapsedMs;
+        const originalLines = original.split('\n').length;
+        const proposedLines = proposedContent.split('\n').length;
+        if (proposedLines < truncationThreshold * originalLines) {
+            results.push({ path: relPath, status: 'rejected', reason: 'output_possibly_truncated' });
+            continue;
+        }
+        const syntaxOk = validateSyntax(relPath, proposedContent);
+        if (syntaxOk === false) {
+            results.push({ path: relPath, status: 'rejected', reason: 'syntax_validation_failed' });
+            continue;
+        }
+        if (proposedContent === original) {
+            results.push({ path: relPath, status: 'unchanged' });
+            continue;
+        }
+        const diff = createTwoFilesPatch(relPath, relPath, original, proposedContent);
+        proposals.push({ path: relPath, originalHash: sha256(original), proposedContent, diff });
+        const diffPreview = diff.split('\n').slice(0, PREVIEW_LINES).join('\n');
+        results.push({ path: relPath, status: 'would_change', diffPreview });
+    }
+    fs.mkdirSync(path.join(root, resultsDir), { recursive: true });
+    const resultPath = path.join(resultsDir, `transform-${crypto.randomUUID()}.json`);
+    fs.writeFileSync(path.join(root, resultPath), JSON.stringify({ schemaVersion: RESULT_SCHEMA_VERSION, files: proposals }, null, 2), 'utf8');
+    return { results, resultPath, usage: { calls, tokensIn, tokensOut, elapsedMs } };
+}
+//# sourceMappingURL=delegate-transform.js.map

package/dist/tools/delegate-transform.js.map

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

package/dist/tools/health-check.js

@@ -0,0 +1,14 @@
+export async function healthCheck(backend) {
+    const health = await backend.checkHealth();
+    if (health.status !== 'ok') {
+        return health;
+    }
+    const capabilities = await backend.getCapabilities();
+    return {
+        status: 'ok',
+        model: health.model,
+        contextWindow: capabilities.contextWindow,
+        maxOutputTokens: capabilities.maxOutputTokens
+    };
+}
+//# sourceMappingURL=health-check.js.map

package/dist/tools/health-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.js","sourceRoot":"","sources":["../../src/tools/health-check.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAgB;IAChD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;IACrD,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,aAAa,EAAE,YAAY,CAAC,aAAa;QACzC,eAAe,EAAE,YAAY,CAAC,eAAe;KAC9C,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "sherpa-mcp",
+  "version": "0.1.0",
+  "description": "MCP server that delegates high-volume file exploration, search, and transformation to a local LLM backend",
+  "author": "Gastón Parravicini",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Tongas/sherpa-mcp.git",
+    "directory": "mcp-server"
+  },
+  "homepage": "https://github.com/Tongas/sherpa-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/Tongas/sherpa-mcp/issues"
+  },
+  "type": "module",
+  "bin": {
+    "sherpa-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0",
+    "diff": "^5.2.0",
+    "ignore": "^5.3.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "@types/node": "^20.14.0",
+    "@types/diff": "^5.2.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}