@calliopelabs/cli 2.5.0 → 3.0.0

package/dist/local-model.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Calliope CLI - Local Model Excellence
+ *
+ * A single home for the behaviours that make Calliope a good harness for
+ * self-hosted 7-70B models (Ollama, or an OpenAI-compatible/LiteLLM server
+ * pointed at localhost / a private box running vLLM etc.). Cloud providers are
+ * untouched — every helper here is a no-op or "cloud" answer unless the active
+ * backend is detected as local.
+ *
+ * Responsibilities:
+ *  - Detect whether a provider/baseUrl pair is a local backend.
+ *  - Simplify tool JSON-schemas before they are sent to a local model (lossless
+ *    for execution — tools.ts still validates the real args).
+ *  - Compute and verify content anchor hashes for stale-view-protected edits.
+ *  - Detect malformed tool calls and describe how to repair them.
+ *  - Build the JSON-schema envelope used to grammar-constrain a repair reply.
+ *  - Probe a local model's capabilities (context length, native tool calls,
+ *    JSON-schema `format` support) and cache the result per session.
+ *  - Pick the compact vs full system prompt for a provider.
+ */
+import type { LLMProvider, Tool, ToolCall } from './types.js';
+/**
+ * True when a URL points at the local machine (loopback host, `*.local`, or the
+ * docker host bridge). Used to decide whether an openai-compat / LiteLLM server
+ * is a self-hosted backend rather than a hosted proxy.
+ */
+export declare function isLoopbackUrl(url: string | undefined): boolean;
+/**
+ * Whether the active backend is a locally-hosted model.
+ *
+ *  - `ollama` is always local.
+ *  - `openai-compat` / `litellm` are local when their base URL is loopback
+ *    (LM Studio, vLLM, llama.cpp, a local LiteLLM proxy, ...).
+ *  - Everything else (Anthropic, OpenAI, Bedrock, hosted OpenAI-compat, and the
+ *    `auto` sentinel) is treated as cloud.
+ *
+ * `baseUrl` defaults to the configured base URL for the provider.
+ */
+export declare function isLocalBackend(provider: LLMProvider, baseUrl?: string): boolean;
+/**
+ * The `anchor_hash` property injected into `edit_file`'s SIMPLIFIED schema only
+ * (feature 4). tools.ts accepts it from any caller, but it is only advertised to
+ * local models — cloud schemas stay inert.
+ */
+export declare const ANCHOR_HASH_PROPERTY: {
+    readonly type: "string";
+    readonly description: "Optional 8-char hash from the last read_file of this file (stale-edit guard); echo it to confirm your view is current.";
+};
+/** The property key models echo back on an anchored edit. */
+export declare const ANCHOR_HASH_KEY = "anchor_hash";
+/**
+ * Reduce a verbose description to its first sentence, single-line and capped.
+ * Multi-paragraph tool descriptions (e.g. `configure`) collapse to their lede.
+ */
+export declare function firstSentence(text: string | undefined, cap: number): string;
+/**
+ * Simplify a tool schema for a local model: first-sentence descriptions, capped
+ * enum listings, and (for `edit_file`) the optional `anchor_hash` param.
+ *
+ * LOSSLESS FOR EXECUTION: the returned schema only changes what the model is
+ * shown. tools.ts validates the real arguments independently, so trimming a
+ * description or truncating an enum listing cannot break a valid call.
+ *
+ * Calliope's tool schemas are already flat (no nested object properties), so the
+ * "flatten nested objects" goal is a structural no-op here; the real token win
+ * is in the descriptions and enums.
+ */
+export declare function simplifyToolForLocal(tool: Tool): Tool;
+/** Simplify a whole tool set for a local backend. Empty in → empty out. */
+export declare function simplifyToolsForLocal(tools: Tool[]): Tool[];
+/** 8-char sha256 prefix of file content — the stable "view id" a model echoes. */
+export declare function computeAnchorHash(content: string): string;
+/** Footer appended to read_file output for local backends so the model can echo the hash. */
+export declare function anchorHashFooter(hash: string): string;
+/** Classic Levenshtein edit distance (iterative, two-row). */
+export declare function levenshtein(a: string, b: string): number;
+export interface MalformedToolCall {
+    /** Human-readable reason, embedded verbatim in the corrective message. */
+    reason: string;
+    /** Suggested correct tool name, when the fault is a close-miss name. */
+    suggestion?: string;
+}
+/**
+ * Detect whether a parsed tool call is malformed in a way worth one repair
+ * round-trip. Returns null for a well-formed call OR for an unknown tool with no
+ * close match (there is nothing to correct — let it surface naturally).
+ *
+ *  - unknown tool name with a close Levenshtein match → suggest the neighbour
+ *  - missing a required parameter (also how unparseable-args `{}` presents)
+ */
+export declare function detectMalformedToolCall(call: ToolCall, tools: Tool[]): MalformedToolCall | null;
+/** The compact corrective message sent on a repair round-trip. */
+export declare function buildRepairMessage(call: ToolCall, fault: MalformedToolCall): string;
+/**
+ * JSON-schema envelope for a single tool call, used to grammar-constrain a
+ * repair reply via Ollama's `format` parameter. Constraining every response
+ * would break prose, so this is only ever applied on the repair round-trip.
+ */
+export declare function buildToolCallEnvelopeSchema(toolNames: string[]): Record<string, unknown>;
+/**
+ * Extract a corrected tool call from a repair response. Accepts either a native
+ * tool call (Ollama returned `tool_calls`) or a grammar-constrained JSON
+ * envelope in the text content (`{"name":...,"arguments":{...}}`). Returns null
+ * when neither yields a usable call. `id` is preserved so the assistant/tool
+ * message threading stays intact.
+ */
+export declare function extractRepairedToolCall(content: string, nativeToolCalls: ToolCall[] | undefined, id: string): ToolCall | null;
+export interface LocalModelProfile {
+    provider: LLMProvider;
+    model: string;
+    baseUrl?: string;
+    contextLength: number;
+    supportsNativeToolCalls: boolean;
+    supportsJsonSchemaFormat: boolean;
+    /** Raw Ollama capability list when available (e.g. ['completion','tools',...]). */
+    capabilities?: string[];
+}
+/**
+ * Heuristic native-tool-call support by model family. Only consulted when the
+ * backend does not report capabilities directly (older Ollama, non-Ollama local
+ * servers). Errs toward the families known to emit reliable tool calls.
+ */
+export declare function familySupportsNativeTools(model: string): boolean;
+/** Clear the per-session capability cache (tests only). */
+export declare function clearLocalModelProfileCache(): void;
+/**
+ * Resolve a local model's capability profile, caching per session.
+ *
+ *  - contextLength: Ollama /api/show model_info, else the family default.
+ *  - supportsNativeToolCalls: Ollama `capabilities` includes 'tools' when
+ *    reported, else a family heuristic.
+ *  - supportsJsonSchemaFormat: true only for native Ollama (the /api/chat
+ *    `format` path); other local servers don't share that parameter.
+ *
+ * Never throws: a failed probe degrades to heuristics.
+ */
+export declare function getLocalModelProfile(provider: LLMProvider, model: string, baseUrl?: string): Promise<LocalModelProfile>;
+/**
+ * Pick the system prompt for a provider: the compact variant for a local
+ * backend, the full prompt for cloud. The single seam every prompt-building call
+ * site routes through, so provider checks are not scattered.
+ *
+ * The `auto` sentinel resolves to the full prompt (auto only selects a local
+ * backend when no cloud provider is configured, an edge the request-time schema
+ * simplification and repair loop still cover).
+ */
+export declare function getSystemPromptForProvider(provider: LLMProvider, baseUrl?: string): string;
+/** Rough token estimate for a raw string (~4 chars/token). */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=local-model.d.ts.map

package/dist/local-model.d.ts.map

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

package/dist/local-model.js

@@ -0,0 +1,408 @@
+/**
+ * Calliope CLI - Local Model Excellence
+ *
+ * A single home for the behaviours that make Calliope a good harness for
+ * self-hosted 7-70B models (Ollama, or an OpenAI-compatible/LiteLLM server
+ * pointed at localhost / a private box running vLLM etc.). Cloud providers are
+ * untouched — every helper here is a no-op or "cloud" answer unless the active
+ * backend is detected as local.
+ *
+ * Responsibilities:
+ *  - Detect whether a provider/baseUrl pair is a local backend.
+ *  - Simplify tool JSON-schemas before they are sent to a local model (lossless
+ *    for execution — tools.ts still validates the real args).
+ *  - Compute and verify content anchor hashes for stale-view-protected edits.
+ *  - Detect malformed tool calls and describe how to repair them.
+ *  - Build the JSON-schema envelope used to grammar-constrain a repair reply.
+ *  - Probe a local model's capabilities (context length, native tool calls,
+ *    JSON-schema `format` support) and cache the result per session.
+ *  - Pick the compact vs full system prompt for a provider.
+ */
+import { createHash } from 'node:crypto';
+import * as config from './config.js';
+import { getSystemPrompt } from './types.js';
+import { getModelContextLimit } from './model-detection.js';
+// ============================================================================
+// Backend detection
+// ============================================================================
+const LOOPBACK_HOSTS = new Set(['localhost', '127.0.0.1', '0.0.0.0', '::1', '[::1]', 'host.docker.internal']);
+/**
+ * True when a URL points at the local machine (loopback host, `*.local`, or the
+ * docker host bridge). Used to decide whether an openai-compat / LiteLLM server
+ * is a self-hosted backend rather than a hosted proxy.
+ */
+export function isLoopbackUrl(url) {
+    if (!url)
+        return false;
+    let host;
+    try {
+        host = new URL(url).hostname.toLowerCase();
+    }
+    catch {
+        // Not a parseable URL — fall back to a substring check on the raw value.
+        const lower = url.toLowerCase();
+        return [...LOOPBACK_HOSTS].some(h => lower.includes(h)) || lower.includes('.local');
+    }
+    if (LOOPBACK_HOSTS.has(host))
+        return true;
+    if (host.endsWith('.local'))
+        return true;
+    return false;
+}
+/**
+ * Whether the active backend is a locally-hosted model.
+ *
+ *  - `ollama` is always local.
+ *  - `openai-compat` / `litellm` are local when their base URL is loopback
+ *    (LM Studio, vLLM, llama.cpp, a local LiteLLM proxy, ...).
+ *  - Everything else (Anthropic, OpenAI, Bedrock, hosted OpenAI-compat, and the
+ *    `auto` sentinel) is treated as cloud.
+ *
+ * `baseUrl` defaults to the configured base URL for the provider.
+ */
+export function isLocalBackend(provider, baseUrl) {
+    if (provider === 'ollama')
+        return true;
+    if (provider === 'litellm' || provider === 'openai-compat') {
+        const url = baseUrl ?? config.getBaseUrl(provider);
+        return isLoopbackUrl(url);
+    }
+    return false;
+}
+// ============================================================================
+// Schema simplification (feature 1)
+// ============================================================================
+/** Maximum enum values kept in a simplified schema (execution still accepts any). */
+const ENUM_CAP = 12;
+/** Maximum characters kept for a tool description in a simplified schema. */
+const TOOL_DESC_CAP = 200;
+/** Maximum characters kept for a property description in a simplified schema. */
+const PROP_DESC_CAP = 80;
+/**
+ * The `anchor_hash` property injected into `edit_file`'s SIMPLIFIED schema only
+ * (feature 4). tools.ts accepts it from any caller, but it is only advertised to
+ * local models — cloud schemas stay inert.
+ */
+export const ANCHOR_HASH_PROPERTY = {
+    type: 'string',
+    description: 'Optional 8-char hash from the last read_file of this file (stale-edit guard); echo it to confirm your view is current.',
+};
+/** The property key models echo back on an anchored edit. */
+export const ANCHOR_HASH_KEY = 'anchor_hash';
+/**
+ * Reduce a verbose description to its first sentence, single-line and capped.
+ * Multi-paragraph tool descriptions (e.g. `configure`) collapse to their lede.
+ */
+export function firstSentence(text, cap) {
+    if (!text)
+        return text ?? '';
+    let s = text.trim();
+    // Drop everything after the first newline — verbose schemas put reference
+    // material on subsequent lines.
+    const nl = s.search(/\r?\n/);
+    if (nl !== -1)
+        s = s.slice(0, nl).trim();
+    // Keep only the first sentence within that line.
+    const m = s.match(/^.*?[.!?](?=\s|$)/);
+    if (m)
+        s = m[0].trim();
+    if (s.length > cap)
+        s = s.slice(0, cap - 1).trimEnd() + '…';
+    return s;
+}
+function simplifyProperty(prop) {
+    const out = { type: prop.type };
+    if (prop.description)
+        out.description = firstSentence(prop.description, PROP_DESC_CAP);
+    if (prop.enum)
+        out.enum = prop.enum.length > ENUM_CAP ? prop.enum.slice(0, ENUM_CAP) : prop.enum;
+    if (prop.items)
+        out.items = prop.items;
+    return out;
+}
+/**
+ * Simplify a tool schema for a local model: first-sentence descriptions, capped
+ * enum listings, and (for `edit_file`) the optional `anchor_hash` param.
+ *
+ * LOSSLESS FOR EXECUTION: the returned schema only changes what the model is
+ * shown. tools.ts validates the real arguments independently, so trimming a
+ * description or truncating an enum listing cannot break a valid call.
+ *
+ * Calliope's tool schemas are already flat (no nested object properties), so the
+ * "flatten nested objects" goal is a structural no-op here; the real token win
+ * is in the descriptions and enums.
+ */
+export function simplifyToolForLocal(tool) {
+    const properties = {};
+    for (const [key, prop] of Object.entries(tool.parameters.properties)) {
+        properties[key] = simplifyProperty(prop);
+    }
+    // Advertise the stale-view guard to local models on edit_file only.
+    if (tool.name === 'edit_file') {
+        properties[ANCHOR_HASH_KEY] = { ...ANCHOR_HASH_PROPERTY };
+    }
+    return {
+        name: tool.name,
+        description: firstSentence(tool.description, TOOL_DESC_CAP),
+        parameters: {
+            type: 'object',
+            properties: properties,
+            ...(tool.parameters.required ? { required: tool.parameters.required } : {}),
+        },
+    };
+}
+/** Simplify a whole tool set for a local backend. Empty in → empty out. */
+export function simplifyToolsForLocal(tools) {
+    return tools.map(simplifyToolForLocal);
+}
+// ============================================================================
+// Anchor hashes (feature 4)
+// ============================================================================
+/** 8-char sha256 prefix of file content — the stable "view id" a model echoes. */
+export function computeAnchorHash(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex').slice(0, 8);
+}
+/** Footer appended to read_file output for local backends so the model can echo the hash. */
+export function anchorHashFooter(hash) {
+    return `\n[anchor_hash: ${hash} — pass as anchor_hash to edit_file to confirm this view is current]`;
+}
+// ============================================================================
+// Malformed tool-call detection + repair (features 2 & 3)
+// ============================================================================
+/** Classic Levenshtein edit distance (iterative, two-row). */
+export function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+    let curr = new Array(b.length + 1);
+    for (let i = 1; i <= a.length; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
+        }
+        [prev, curr] = [curr, prev];
+    }
+    return prev[b.length];
+}
+/** Max edit distance for an unknown tool name to count as a repairable typo. */
+const NAME_MATCH_THRESHOLD = 2;
+/**
+ * Detect whether a parsed tool call is malformed in a way worth one repair
+ * round-trip. Returns null for a well-formed call OR for an unknown tool with no
+ * close match (there is nothing to correct — let it surface naturally).
+ *
+ *  - unknown tool name with a close Levenshtein match → suggest the neighbour
+ *  - missing a required parameter (also how unparseable-args `{}` presents)
+ */
+export function detectMalformedToolCall(call, tools) {
+    const known = tools.find(t => t.name === call.name);
+    if (!known) {
+        let best;
+        let bestDist = Infinity;
+        for (const t of tools) {
+            const d = levenshtein(call.name.toLowerCase(), t.name.toLowerCase());
+            if (d < bestDist) {
+                bestDist = d;
+                best = t.name;
+            }
+        }
+        if (best && bestDist <= NAME_MATCH_THRESHOLD && bestDist < best.length) {
+            return { reason: `unknown tool "${call.name}"; did you mean "${best}"?`, suggestion: best };
+        }
+        return null;
+    }
+    const args = (call.arguments ?? {});
+    for (const req of known.parameters.required ?? []) {
+        const value = args[req];
+        if (value === undefined || value === null) {
+            return { reason: `missing required parameter "${req}"` };
+        }
+    }
+    return null;
+}
+/** The compact corrective message sent on a repair round-trip. */
+export function buildRepairMessage(call, fault) {
+    return `Your tool call to "${call.name}" was malformed: ${fault.reason}. Reply with ONLY the corrected tool call, nothing else.`;
+}
+/**
+ * JSON-schema envelope for a single tool call, used to grammar-constrain a
+ * repair reply via Ollama's `format` parameter. Constraining every response
+ * would break prose, so this is only ever applied on the repair round-trip.
+ */
+export function buildToolCallEnvelopeSchema(toolNames) {
+    return {
+        type: 'object',
+        properties: {
+            name: toolNames.length > 0 ? { type: 'string', enum: toolNames } : { type: 'string' },
+            arguments: { type: 'object' },
+        },
+        required: ['name', 'arguments'],
+    };
+}
+/**
+ * Extract a corrected tool call from a repair response. Accepts either a native
+ * tool call (Ollama returned `tool_calls`) or a grammar-constrained JSON
+ * envelope in the text content (`{"name":...,"arguments":{...}}`). Returns null
+ * when neither yields a usable call. `id` is preserved so the assistant/tool
+ * message threading stays intact.
+ */
+export function extractRepairedToolCall(content, nativeToolCalls, id) {
+    if (nativeToolCalls && nativeToolCalls.length > 0) {
+        const first = nativeToolCalls[0];
+        return { id, name: first.name, arguments: first.arguments ?? {} };
+    }
+    const text = content.trim();
+    if (!text)
+        return null;
+    // Pull the first balanced JSON object out of the reply (models often wrap it
+    // in prose or a code fence despite the "ONLY" instruction).
+    const start = text.indexOf('{');
+    if (start === -1)
+        return null;
+    let depth = 0;
+    let end = -1;
+    for (let i = start; i < text.length; i++) {
+        if (text[i] === '{')
+            depth++;
+        else if (text[i] === '}' && --depth === 0) {
+            end = i;
+            break;
+        }
+    }
+    if (end === -1)
+        return null;
+    try {
+        const parsed = JSON.parse(text.slice(start, end + 1));
+        if (typeof parsed.name !== 'string' || !parsed.name)
+            return null;
+        const args = (parsed.arguments && typeof parsed.arguments === 'object')
+            ? parsed.arguments
+            : {};
+        return { id, name: parsed.name, arguments: args };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Heuristic native-tool-call support by model family. Only consulted when the
+ * backend does not report capabilities directly (older Ollama, non-Ollama local
+ * servers). Errs toward the families known to emit reliable tool calls.
+ */
+export function familySupportsNativeTools(model) {
+    const m = model.toLowerCase();
+    const families = [
+        'llama3.1', 'llama-3.1', 'llama3.2', 'llama-3.2', 'llama3.3', 'llama-3.3', 'llama4', 'llama-4',
+        'qwen2.5', 'qwen3', 'mistral', 'mixtral', 'devstral', 'command-r',
+        'hermes', 'firefunction', 'functionary', 'gemma4', 'gpt-oss',
+    ];
+    return families.some(f => m.includes(f));
+}
+function normalizeOllamaBase(url) {
+    let base = url || 'http://localhost:11434';
+    if (base.endsWith('/v1'))
+        base = base.slice(0, -3);
+    return base;
+}
+async function probeOllama(baseUrl, model) {
+    const response = await fetch(`${baseUrl}/api/show`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name: model }),
+    });
+    if (!response.ok)
+        throw new Error(`Ollama /api/show returned ${response.status}`);
+    const data = await response.json();
+    let contextLength;
+    if (data.model_info) {
+        const ctxKey = Object.keys(data.model_info).find(k => k.includes('context_length') || k.includes('context_window'));
+        if (ctxKey && typeof data.model_info[ctxKey] === 'number') {
+            contextLength = data.model_info[ctxKey];
+        }
+    }
+    if (data.parameters) {
+        const numCtx = data.parameters.match(/num_ctx\s+(\d+)/);
+        if (numCtx)
+            contextLength = parseInt(numCtx[1], 10);
+    }
+    return { capabilities: data.capabilities, contextLength };
+}
+// Per-session cache: a CLI process is one session, so a module-level map is the
+// right lifetime. Keyed by provider|model|baseUrl.
+const profileCache = new Map();
+/** Clear the per-session capability cache (tests only). */
+export function clearLocalModelProfileCache() {
+    profileCache.clear();
+}
+/**
+ * Resolve a local model's capability profile, caching per session.
+ *
+ *  - contextLength: Ollama /api/show model_info, else the family default.
+ *  - supportsNativeToolCalls: Ollama `capabilities` includes 'tools' when
+ *    reported, else a family heuristic.
+ *  - supportsJsonSchemaFormat: true only for native Ollama (the /api/chat
+ *    `format` path); other local servers don't share that parameter.
+ *
+ * Never throws: a failed probe degrades to heuristics.
+ */
+export async function getLocalModelProfile(provider, model, baseUrl) {
+    const url = baseUrl ?? config.getBaseUrl(provider);
+    const key = `${provider}|${model}|${url ?? ''}`;
+    const cached = profileCache.get(key);
+    if (cached)
+        return cached;
+    let capabilities;
+    let contextLength = getModelContextLimit(provider, model);
+    let supportsNativeToolCalls = familySupportsNativeTools(model);
+    const supportsJsonSchemaFormat = provider === 'ollama';
+    if (provider === 'ollama') {
+        try {
+            const probe = await probeOllama(normalizeOllamaBase(url), model);
+            if (probe.capabilities) {
+                capabilities = probe.capabilities;
+                supportsNativeToolCalls = probe.capabilities.includes('tools');
+            }
+            if (probe.contextLength && probe.contextLength > 0)
+                contextLength = probe.contextLength;
+        }
+        catch {
+            // Keep heuristic values.
+        }
+    }
+    const profile = {
+        provider,
+        model,
+        baseUrl: url,
+        contextLength,
+        supportsNativeToolCalls,
+        supportsJsonSchemaFormat,
+        capabilities,
+    };
+    profileCache.set(key, profile);
+    return profile;
+}
+// ============================================================================
+// System prompt selection (feature 5)
+// ============================================================================
+/**
+ * Pick the system prompt for a provider: the compact variant for a local
+ * backend, the full prompt for cloud. The single seam every prompt-building call
+ * site routes through, so provider checks are not scattered.
+ *
+ * The `auto` sentinel resolves to the full prompt (auto only selects a local
+ * backend when no cloud provider is configured, an edge the request-time schema
+ * simplification and repair loop still cover).
+ */
+export function getSystemPromptForProvider(provider, baseUrl) {
+    return getSystemPrompt({ compact: isLocalBackend(provider, baseUrl) });
+}
+/** Rough token estimate for a raw string (~4 chars/token). */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=local-model.js.map

package/dist/local-model.js.map

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

package/dist/mcp.d.ts.map

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

package/dist/mcp.js

@@ -106,7 +106,9 @@ function isBlockedAddress(ip) {
     const type = net.isIP(ip);
     if (type === 4) {
         const parts = ip.split('.').map((n) => parseInt(n, 10));
-        const [a, b] = parts;
+        // net.isIP(ip) === 4 guarantees exactly four numeric octets.
+        const a = parts[0];
+        const b = parts[1];
         // Loopback (127/8) is allowed by default — see assertUrlAllowed.
         if (a === 10)
             return true; // private 10.0.0.0/8
@@ -373,7 +375,8 @@ export async function executeMCPTool(toolName, args) {
     if (!match) {
         return `Error: Invalid MCP tool name: ${toolName}`;
     }
-    const [, serverId, mcpToolName] = match;
+    const serverId = match[1];
+    const mcpToolName = match[2];
     const servers = loadServers();
     const server = servers.find(s => s.id.endsWith(serverId));
     if (!server) {