labre-mcp 0.1.0

package/dist/lib/llm/llm-error-handler.mjs

@@ -0,0 +1,159 @@
+// LLM Error Classification and MCP Log Notification Handler
+//
+// Classifies LLM errors into specific categories (timeout, rate limit, API error,
+// empty response, generic) and emits error-level MCP log notifications with
+// localized, context-rich messages visible to the user.
+//
+// Error classification heuristics:
+//   - Timeout: AbortError, ETIMEDOUT, ESOCKETTIMEDOUT, "timeout" in message
+//   - Rate limit: HTTP 429, "rate limit" / "too many requests" in message
+//   - Auth: HTTP 401/403, "unauthorized" / "forbidden" in message
+//   - API error: HTTP 4xx/5xx with status code extractable from message
+//   - Empty response: "empty response" in message
+//   - Generic: anything else
+//
+// Usage:
+//   import { classifyAndLogLLMError } from './llm-error-handler.mjs';
+//   try { await llmCall(prompt); }
+//   catch (err) { classifyAndLogLLMError(err, { logger, model, msg }); throw err; }
+import { logError, logWarning } from '../mcp-notifications.mjs';
+// ─── Error Classification ─────────────────────────────────────────────────
+/**
+ * Classify an LLM error into a specific category.
+ * Uses heuristics on the error object properties and message string.
+ */
+export function classifyLLMError(error) {
+    const err = (error ?? {});
+    const message = err.message || String(error);
+    const lowerMsg = message.toLowerCase();
+    // Extract HTTP status code from error message if present
+    const statusMatch = message.match(/\b(?:error|status)\s*(\d{3})\b/i);
+    const status = statusMatch ? parseInt(statusMatch[1], 10) : null;
+    // ── Timeout ─────────────────────────────────────────────────────────
+    if (err.name === 'AbortError' ||
+        err.code === 'ETIMEDOUT' ||
+        err.code === 'ESOCKETTIMEDOUT' ||
+        err.code === 'UND_ERR_CONNECT_TIMEOUT' ||
+        err.code === 'UND_ERR_HEADERS_TIMEOUT' ||
+        err.code === 'UND_ERR_BODY_TIMEOUT' ||
+        lowerMsg.includes('timeout') ||
+        lowerMsg.includes('timed out') ||
+        lowerMsg.includes('aborted')) {
+        return { type: 'timeout', status, message, retryAfter: null };
+    }
+    // ── Rate limit ──────────────────────────────────────────────────────
+    if (status === 429 ||
+        lowerMsg.includes('rate limit') ||
+        lowerMsg.includes('rate_limit') ||
+        lowerMsg.includes('too many requests') ||
+        lowerMsg.includes('quota exceeded') ||
+        lowerMsg.includes('throttl')) {
+        const retryMatch = message.match(/retry.?after[:\s]*(\d+)/i);
+        const retryAfter = retryMatch ? retryMatch[1] : null;
+        return { type: 'rate_limit', status: status || 429, message, retryAfter };
+    }
+    // ── Auth errors ─────────────────────────────────────────────────────
+    if (status === 401 || status === 403 ||
+        lowerMsg.includes('unauthorized') ||
+        lowerMsg.includes('forbidden') ||
+        lowerMsg.includes('invalid api key') ||
+        lowerMsg.includes('api key not configured')) {
+        return { type: 'auth', status: status || 401, message, retryAfter: null };
+    }
+    // ── Network errors ──────────────────────────────────────────────────
+    if (err.code === 'ECONNREFUSED' ||
+        err.code === 'ECONNRESET' ||
+        err.code === 'ENOTFOUND' ||
+        err.code === 'EAI_AGAIN' ||
+        lowerMsg.includes('fetch failed') ||
+        lowerMsg.includes('network') ||
+        lowerMsg.includes('dns') ||
+        lowerMsg.includes('econnrefused') ||
+        lowerMsg.includes('econnreset')) {
+        return { type: 'network', status: null, message, retryAfter: null };
+    }
+    // ── Empty response ──────────────────────────────────────────────────
+    if (lowerMsg.includes('empty response') ||
+        lowerMsg.includes('returned empty')) {
+        return { type: 'empty_response', status, message, retryAfter: null };
+    }
+    // ── API error with HTTP status ──────────────────────────────────────
+    if (status && status >= 400) {
+        return { type: 'api_error', status, message, retryAfter: null };
+    }
+    // ── Generic / unknown ──────────────────────────────────────────────
+    return { type: 'generic', status, message, retryAfter: null };
+}
+// ─── Localized Error Logging ──────────────────────────────────────────────
+/**
+ * Classify an LLM error and emit an appropriate MCP error-level log notification.
+ *
+ * Emits localized, context-rich error messages using the progress message catalog.
+ * The error is logged but NOT re-thrown — the caller is responsible for propagation.
+ */
+export function classifyAndLogLLMError(error, options = {}) {
+    const { logger = 'llm', model = 'unknown', msg = null, } = options;
+    const classified = classifyLLMError(error);
+    let logMessage;
+    switch (classified.type) {
+        case 'timeout':
+            logMessage = msg
+                ? msg('error.llm.timeout', { duration: 'N/A', model })
+                : `LLM call timed out (model: ${model}): ${classified.message}`;
+            logError(logger, logMessage);
+            break;
+        case 'rate_limit':
+            logMessage = msg
+                ? msg('error.llm.ratelimit', { model, retryAfter: classified.retryAfter || '?' })
+                : `LLM rate limit exceeded (model: ${model})${classified.retryAfter ? `. Retry after ${classified.retryAfter}s` : ''}: ${classified.message}`;
+            logError(logger, logMessage);
+            break;
+        case 'auth':
+            logMessage = msg
+                ? msg('error.llm.auth', { status: classified.status || 401 })
+                : `LLM authentication error (${classified.status || 401}): ${classified.message}`;
+            logError(logger, logMessage);
+            break;
+        case 'network':
+            logMessage = msg
+                ? msg('error.llm.network', { message: classified.message })
+                : `LLM network error: ${classified.message}`;
+            logError(logger, logMessage);
+            break;
+        case 'empty_response':
+            logMessage = msg
+                ? msg('error.llm.empty', { model })
+                : `LLM returned empty response (model: ${model})`;
+            logWarning(logger, logMessage);
+            break;
+        case 'api_error':
+            logMessage = msg
+                ? msg('error.llm.api', { status: classified.status, message: classified.message })
+                : `LLM API error (${classified.status}): ${classified.message}`;
+            logError(logger, logMessage);
+            break;
+        default: // 'generic'
+            logMessage = msg
+                ? msg('error.generic', { tool: logger, error: classified.message })
+                : `LLM error in ${logger}: ${classified.message}`;
+            logError(logger, logMessage);
+            break;
+    }
+    return classified;
+}
+// ─── Convenience: Wrap an async LLM call with error logging ────────────────
+/**
+ * Wrap an async function with LLM error classification and logging.
+ * Calls the function, and if it throws, classifies the error, emits an MCP
+ * error notification, and re-throws the original error.
+ */
+export async function withLLMErrorLogging(fn, options = {}) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        classifyAndLogLLMError(error, options);
+        throw error;
+    }
+}
+//# sourceMappingURL=llm-error-handler.mjs.map

package/dist/lib/llm/llm-error-handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-error-handler.mjs","sourceRoot":"","sources":["../../../src/lib/llm/llm-error-handler.mts"],"names":[],"mappings":"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"}

package/dist/lib/llm/providers/agent-sdk-provider.d.mts

@@ -0,0 +1,3 @@
+import { type LLMProvider } from './provider.types.mjs';
+export declare function createAgentSdkProvider(): LLMProvider;
+//# sourceMappingURL=agent-sdk-provider.d.mts.map

package/dist/lib/llm/providers/agent-sdk-provider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-sdk-provider.d.mts","sourceRoot":"","sources":["../../../../src/lib/llm/providers/agent-sdk-provider.mts"],"names":[],"mappings":"AAMA,OAAO,EAA8B,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEpF,wBAAgB,sBAAsB,IAAI,WAAW,CA6BpD"}

package/dist/lib/llm/providers/agent-sdk-provider.mjs

@@ -0,0 +1,29 @@
+// Agent SDK provider — wraps createLLMCall / createStructuredLLMCall.
+// No logprobs support (subprocess-based runtime does not expose token-level probs).
+import { createLLMCall, createStructuredLLMCall } from '../llm-call.mjs';
+import { UnsupportedCapabilityError } from './provider.types.mjs';
+export function createAgentSdkProvider() {
+    return {
+        kind: 'agent-sdk',
+        supports: { text: true, structured: true, logprobs: false },
+        text(strategy) {
+            return createLLMCall({
+                model: strategy.model,
+                effort: strategy.effort,
+                systemPrompt: strategy.systemPrompt,
+            });
+        },
+        structured(strategy, schema) {
+            return createStructuredLLMCall({
+                schema,
+                model: strategy.model,
+                effort: strategy.effort,
+                systemPrompt: strategy.systemPrompt,
+            });
+        },
+        logprobs(_strategy) {
+            throw new UnsupportedCapabilityError('agent-sdk', 'logprobs');
+        },
+    };
+}
+//# sourceMappingURL=agent-sdk-provider.mjs.map

package/dist/lib/llm/providers/agent-sdk-provider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-sdk-provider.mjs","sourceRoot":"","sources":["../../../../src/lib/llm/providers/agent-sdk-provider.mts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,oFAAoF;AAEpF,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAGzE,OAAO,EAAE,0BAA0B,EAAoB,MAAM,sBAAsB,CAAC;AAEpF,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;QAE3D,IAAI,CAAC,QAAwB;YAC3B,OAAO,aAAa,CAAC;gBACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,YAAY,EAAE,QAAQ,CAAC,YAAY;aACpC,CAAC,CAAC;QACL,CAAC;QAED,UAAU,CACR,QAAwB,EACxB,MAA+B;YAE/B,OAAO,uBAAuB,CAAI;gBAChC,MAAM;gBACN,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,YAAY,EAAE,QAAQ,CAAC,YAAY;aACpC,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,SAAyB;YAChC,MAAM,IAAI,0BAA0B,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/llm/providers/copilot-sdk-provider.d.mts

@@ -0,0 +1,4 @@
+import type { ProviderConfig } from '../config.schema.mjs';
+import { type LLMProvider } from './provider.types.mjs';
+export declare function createCopilotSdkProvider(providerConfig: ProviderConfig): LLMProvider;
+//# sourceMappingURL=copilot-sdk-provider.d.mts.map

package/dist/lib/llm/providers/copilot-sdk-provider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-sdk-provider.d.mts","sourceRoot":"","sources":["../../../../src/lib/llm/providers/copilot-sdk-provider.mts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAA8B,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEpF,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,cAAc,GAAG,WAAW,CAiCpF"}

package/dist/lib/llm/providers/copilot-sdk-provider.mjs

@@ -0,0 +1,37 @@
+// Copilot SDK provider — wraps createCopilotSdkTextCall / createCopilotSdkStructuredCall.
+// No logprobs support (the SDK only emits free-form `assistant.message` events).
+//
+// Auth: the provider reads the GitHub token from the env var named in
+// `providerConfig.authEnv` (typically COPILOT_GITHUB_TOKEN). When unset, the
+// underlying SDK falls back to `gh auth login` credentials or GH_TOKEN /
+// GITHUB_TOKEN.
+import { createCopilotSdkTextCall, createCopilotSdkStructuredCall, } from '../copilot-sdk-call.mjs';
+import { UnsupportedCapabilityError } from './provider.types.mjs';
+export function createCopilotSdkProvider(providerConfig) {
+    const githubToken = providerConfig.authEnv
+        ? process.env[providerConfig.authEnv]
+        : undefined;
+    return {
+        kind: 'copilot-sdk',
+        supports: { text: true, structured: true, logprobs: false },
+        text(strategy) {
+            return createCopilotSdkTextCall({
+                model: strategy.model,
+                githubToken,
+                systemPrompt: strategy.systemPrompt,
+            });
+        },
+        structured(strategy, schema) {
+            return createCopilotSdkStructuredCall({
+                schema,
+                model: strategy.model,
+                githubToken,
+                systemPrompt: strategy.systemPrompt,
+            });
+        },
+        logprobs(_strategy) {
+            throw new UnsupportedCapabilityError('copilot-sdk', 'logprobs');
+        },
+    };
+}
+//# sourceMappingURL=copilot-sdk-provider.mjs.map

package/dist/lib/llm/providers/copilot-sdk-provider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-sdk-provider.mjs","sourceRoot":"","sources":["../../../../src/lib/llm/providers/copilot-sdk-provider.mts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,iFAAiF;AACjF,EAAE;AACF,sEAAsE;AACtE,6EAA6E;AAC7E,yEAAyE;AACzE,gBAAgB;AAEhB,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,0BAA0B,EAAoB,MAAM,sBAAsB,CAAC;AAEpF,MAAM,UAAU,wBAAwB,CAAC,cAA8B;IACrE,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO;QACxC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC;QACrC,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;QAE3D,IAAI,CAAC,QAAwB;YAC3B,OAAO,wBAAwB,CAAC;gBAC9B,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,WAAW;gBACX,YAAY,EAAE,QAAQ,CAAC,YAAY;aACpC,CAAC,CAAC;QACL,CAAC;QAED,UAAU,CACR,QAAwB,EACxB,MAA+B;YAE/B,OAAO,8BAA8B,CAAI;gBACvC,MAAM;gBACN,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,WAAW;gBACX,YAAY,EAAE,QAAQ,CAAC,YAAY;aACpC,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,SAAyB;YAChC,MAAM,IAAI,0BAA0B,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAClE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/llm/providers/http-api-provider.d.mts

@@ -0,0 +1,4 @@
+import type { ProviderConfig } from '../config.schema.mjs';
+import { type LLMProvider } from './provider.types.mjs';
+export declare function createHttpApiProvider(providerConfig: ProviderConfig): LLMProvider;
+//# sourceMappingURL=http-api-provider.d.mts.map

package/dist/lib/llm/providers/http-api-provider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-api-provider.d.mts","sourceRoot":"","sources":["../../../../src/lib/llm/providers/http-api-provider.mts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAA8B,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEpF,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,cAAc,GAAG,WAAW,CAmCjF"}

package/dist/lib/llm/providers/http-api-provider.mjs

@@ -0,0 +1,35 @@
+// HTTP API provider — wraps createOpenCodeCall / createOpenCodeLogprobCall.
+// Supports text + logprobs. Structured output is not implemented yet
+// (no consumer today — would require prompt-engineered JSON enforcement).
+import { createOpenCodeCall, createOpenCodeLogprobCall } from '../llm-call.mjs';
+import { UnsupportedCapabilityError } from './provider.types.mjs';
+export function createHttpApiProvider(providerConfig) {
+    const apiKey = providerConfig.apiKeyEnv ? process.env[providerConfig.apiKeyEnv] : undefined;
+    const baseUrl = providerConfig.baseUrl;
+    return {
+        kind: 'http-api',
+        supports: { text: true, structured: false, logprobs: true },
+        text(strategy) {
+            return createOpenCodeCall({
+                model: strategy.model,
+                baseUrl,
+                apiKey,
+                temperature: strategy.temperature,
+                systemPrompt: strategy.systemPrompt,
+            });
+        },
+        structured(_strategy, _schema) {
+            throw new UnsupportedCapabilityError('http-api', 'structured');
+        },
+        logprobs(strategy) {
+            return createOpenCodeLogprobCall({
+                model: strategy.model,
+                baseUrl,
+                apiKey,
+                topLogprobs: strategy.topLogprobs,
+                systemPrompt: strategy.systemPrompt,
+            });
+        },
+    };
+}
+//# sourceMappingURL=http-api-provider.mjs.map

package/dist/lib/llm/providers/http-api-provider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-api-provider.mjs","sourceRoot":"","sources":["../../../../src/lib/llm/providers/http-api-provider.mts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,qEAAqE;AACrE,0EAA0E;AAE1E,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAGhF,OAAO,EAAE,0BAA0B,EAAoB,MAAM,sBAAsB,CAAC;AAEpF,MAAM,UAAU,qBAAqB,CAAC,cAA8B;IAClE,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5F,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC;IAEvC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;QAE3D,IAAI,CAAC,QAAwB;YAC3B,OAAO,kBAAkB,CAAC;gBACxB,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,OAAO;gBACP,MAAM;gBACN,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;aACpC,CAAC,CAAC;QACL,CAAC;QAED,UAAU,CACR,SAAyB,EACzB,OAAgC;YAEhC,MAAM,IAAI,0BAA0B,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACjE,CAAC;QAED,QAAQ,CAAC,QAAwB;YAC/B,OAAO,yBAAyB,CAAC;gBAC/B,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,OAAO;gBACP,MAAM;gBACN,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;aACpC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/llm/providers/provider.types.d.mts

@@ -0,0 +1,15 @@
+import type { LLMCall, StructuredLLMCall, LogprobLLMCall } from '../../../types/llm.mjs';
+import type { ProviderConfig, StrategyConfig, ProviderKind } from '../config.schema.mjs';
+export type LLMCapability = 'text' | 'structured' | 'logprobs';
+export declare class UnsupportedCapabilityError extends Error {
+    constructor(providerKind: ProviderKind, capability: LLMCapability);
+}
+export interface LLMProvider {
+    readonly kind: ProviderKind;
+    readonly supports: Readonly<Record<LLMCapability, boolean>>;
+    text(strategy: StrategyConfig): LLMCall;
+    structured<T = unknown>(strategy: StrategyConfig, schema: Record<string, unknown>): StructuredLLMCall<T>;
+    logprobs(strategy: StrategyConfig): LogprobLLMCall;
+}
+export type ProviderFactory = (config: ProviderConfig) => LLMProvider;
+//# sourceMappingURL=provider.types.d.mts.map

package/dist/lib/llm/providers/provider.types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.types.d.mts","sourceRoot":"","sources":["../../../../src/lib/llm/providers/provider.types.mts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC;AAE/D,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa;CAIlE;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC;IACxC,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACzG,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAAC;CACpD;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,WAAW,CAAC"}

package/dist/lib/llm/providers/provider.types.mjs

@@ -0,0 +1,11 @@
+// Provider abstraction — every provider declares which capabilities it supports
+// and exposes typed factories for each one. The registry validates at load time
+// that strategies are mapped only to providers that support the required capability,
+// so the `throw UnsupportedCapabilityError` paths below should never fire in prod.
+export class UnsupportedCapabilityError extends Error {
+    constructor(providerKind, capability) {
+        super(`Provider "${providerKind}" does not support capability "${capability}"`);
+        this.name = 'UnsupportedCapabilityError';
+    }
+}
+//# sourceMappingURL=provider.types.mjs.map

package/dist/lib/llm/providers/provider.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.types.mjs","sourceRoot":"","sources":["../../../../src/lib/llm/providers/provider.types.mts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gFAAgF;AAChF,qFAAqF;AACrF,mFAAmF;AAOnF,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,YAA0B,EAAE,UAAyB;QAC/D,KAAK,CAAC,aAAa,YAAY,kCAAkC,UAAU,GAAG,CAAC,CAAC;QAChF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF"}

package/dist/lib/llm/registry.d.mts

@@ -0,0 +1,11 @@
+import type { LLMCapability } from './providers/provider.types.mjs';
+import { type StrategyId } from './strategy-ids.mjs';
+import type { LLMCall, StructuredLLMCall, LogprobLLMCall } from '../../types/llm.mjs';
+export declare function getStrategyLLM(id: StrategyId): LLMCall;
+export declare function getStrategyStructuredLLM<T = unknown>(id: StrategyId, schema: Record<string, unknown>): StructuredLLMCall<T>;
+export declare function getStrategyLogprobLLM(id: StrategyId): LogprobLLMCall;
+/** Test-only: inject a stub for a given (strategy, capability) pair. */
+export declare function setLLMCallForTesting(id: StrategyId, cap: LLMCapability, fn: unknown): void;
+/** Test-only: clear all stubs and cached calls. Usually paired with resetLLMConfigCache. */
+export declare function resetLLMRegistryCache(): void;
+//# sourceMappingURL=registry.d.mts.map

package/dist/lib/llm/registry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.mts","sourceRoot":"","sources":["../../../src/lib/llm/registry.mts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,gCAAgC,CAAC;AACjF,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAqFtF,wBAAgB,cAAc,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAOtD;AAED,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,OAAO,EAClD,EAAE,EAAE,UAAU,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,iBAAiB,CAAC,CAAC,CAAC,CAOtB;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,UAAU,GAAG,cAAc,CAOpE;AAID,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAE1F;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C"}

package/dist/lib/llm/registry.mjs

@@ -0,0 +1,126 @@
+// Registry — single entry point to obtain an LLM call for a given MCP strategy.
+//
+// Lookup path:
+//   1. loadLLMConfig() returns the validated LLMConfig
+//   2. validateCapabilities() (called once) ensures every known strategy is
+//      assigned to a provider that supports the required capability
+//   3. getStrategyLLM / getStrategyStructuredLLM / getStrategyLogprobLLM
+//      resolve the strategy entry (falling back to defaultProvider) and
+//      return a cached call instance
+import { loadLLMConfig } from './config.loader.mjs';
+import { createAgentSdkProvider } from './providers/agent-sdk-provider.mjs';
+import { createHttpApiProvider } from './providers/http-api-provider.mjs';
+import { createCopilotSdkProvider } from './providers/copilot-sdk-provider.mjs';
+import { STRATEGY_CAPABILITIES } from './strategy-ids.mjs';
+const callCache = new Map();
+const providerCache = new Map();
+const testOverrides = new Map();
+let validated = false;
+const PROVIDER_FACTORIES = {
+    'agent-sdk': () => createAgentSdkProvider(),
+    'http-api': (cfg) => createHttpApiProvider(cfg),
+    'copilot-sdk': (cfg) => createCopilotSdkProvider(cfg),
+};
+function instantiateProvider(id, cfg) {
+    const cached = providerCache.get(id);
+    if (cached)
+        return cached;
+    const providerCfg = cfg.providers[id];
+    if (!providerCfg)
+        throw new Error(`Unknown provider "${id}"`);
+    const factory = PROVIDER_FACTORIES[providerCfg.kind];
+    if (!factory) {
+        throw new Error(`No factory registered for provider kind "${providerCfg.kind}"`);
+    }
+    const provider = factory(providerCfg);
+    providerCache.set(id, provider);
+    return provider;
+}
+function validateCapabilities(cfg) {
+    if (validated)
+        return;
+    for (const [stratId, requiredCap] of Object.entries(STRATEGY_CAPABILITIES)) {
+        const strategy = cfg.strategies[stratId];
+        const providerId = strategy?.provider ?? cfg.defaultProvider;
+        const providerCfg = cfg.providers[providerId];
+        if (!providerCfg) {
+            throw new Error(`Strategy "${stratId}" resolves to unknown provider "${providerId}"`);
+        }
+        const provider = instantiateProvider(providerId, cfg);
+        if (!provider.supports[requiredCap]) {
+            throw new Error(`Strategy "${stratId}" requires capability "${requiredCap}" but provider "${providerId}" (${providerCfg.kind}) does not support it`);
+        }
+    }
+    validated = true;
+}
+function resolveStrategy(id, cfg) {
+    const explicit = cfg.strategies[id];
+    if (explicit) {
+        return { strategy: explicit, provider: instantiateProvider(explicit.provider, cfg) };
+    }
+    // Fallback on the default provider. Model must be declared somewhere — we
+    // require the default provider to either have an entry for every strategy
+    // or rely on a strategy-default-model field; for now fall back to the first
+    // declared strategy's model for the default provider, or an explicit default.
+    const fallback = {
+        provider: cfg.defaultProvider,
+        model: findDefaultModelFor(cfg.defaultProvider, cfg),
+    };
+    return { strategy: fallback, provider: instantiateProvider(cfg.defaultProvider, cfg) };
+}
+function findDefaultModelFor(providerId, cfg) {
+    for (const s of Object.values(cfg.strategies)) {
+        if (s.provider === providerId)
+            return s.model;
+    }
+    throw new Error(`No model available for fallback to default provider "${providerId}" — declare at least one strategy using it, or add an explicit entry in llm.config.json`);
+}
+function getOrCreate(id, cap, factory) {
+    const key = `${id}:${cap}`;
+    const override = testOverrides.get(key);
+    if (override !== undefined)
+        return override;
+    const cached = callCache.get(key);
+    if (cached !== undefined)
+        return cached;
+    const created = factory();
+    callCache.set(key, created);
+    return created;
+}
+export function getStrategyLLM(id) {
+    const cfg = loadLLMConfig();
+    validateCapabilities(cfg);
+    return getOrCreate(id, 'text', () => {
+        const { strategy, provider } = resolveStrategy(id, cfg);
+        return provider.text(strategy);
+    });
+}
+export function getStrategyStructuredLLM(id, schema) {
+    const cfg = loadLLMConfig();
+    validateCapabilities(cfg);
+    return getOrCreate(id, 'structured', () => {
+        const { strategy, provider } = resolveStrategy(id, cfg);
+        return provider.structured(strategy, schema);
+    });
+}
+export function getStrategyLogprobLLM(id) {
+    const cfg = loadLLMConfig();
+    validateCapabilities(cfg);
+    return getOrCreate(id, 'logprobs', () => {
+        const { strategy, provider } = resolveStrategy(id, cfg);
+        return provider.logprobs(strategy);
+    });
+}
+// ─── Test helpers ───────────────────────────────────────────────────────────
+/** Test-only: inject a stub for a given (strategy, capability) pair. */
+export function setLLMCallForTesting(id, cap, fn) {
+    testOverrides.set(`${id}:${cap}`, fn);
+}
+/** Test-only: clear all stubs and cached calls. Usually paired with resetLLMConfigCache. */
+export function resetLLMRegistryCache() {
+    callCache.clear();
+    providerCache.clear();
+    testOverrides.clear();
+    validated = false;
+}
+//# sourceMappingURL=registry.mjs.map

package/dist/lib/llm/registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.mjs","sourceRoot":"","sources":["../../../src/lib/llm/registry.mts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,eAAe;AACf,uDAAuD;AACvD,4EAA4E;AAC5E,oEAAoE;AACpE,yEAAyE;AACzE,wEAAwE;AACxE,qCAAqC;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EAAE,qBAAqB,EAAmB,MAAM,oBAAoB,CAAC;AAI5E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;AACnD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;AACrD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAyB,CAAC;AACvD,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,kBAAkB,GAA+D;IACrF,WAAW,EAAI,GAAG,EAAE,CAAC,sBAAsB,EAAE;IAC7C,UAAU,EAAK,CAAC,GAAG,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC;IAClD,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC;CACtD,CAAC;AAEF,SAAS,mBAAmB,CAAC,EAAU,EAAE,GAAc;IACrD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACtC,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,kBAAkB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAc;IAC1C,IAAI,SAAS;QAAE,OAAO;IACtB,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC3E,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,QAAQ,EAAE,QAAQ,IAAI,GAAG,CAAC,eAAe,CAAC;QAC7D,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,aAAa,OAAO,mCAAmC,UAAU,GAAG,CACrE,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,aAAa,OAAO,0BAA0B,WAAW,mBAAmB,UAAU,MAAM,WAAW,CAAC,IAAI,uBAAuB,CACpI,CAAC;QACJ,CAAC;IACH,CAAC;IACD,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,EAAc,EAAE,GAAc;IACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACpC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;IACvF,CAAC;IACD,0EAA0E;IAC1E,0EAA0E;IAC1E,4EAA4E;IAC5E,8EAA8E;IAC9E,MAAM,QAAQ,GAAmB;QAC/B,QAAQ,EAAE,GAAG,CAAC,eAAe;QAC7B,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC;KACrD,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,SAAS,mBAAmB,CAAC,UAAkB,EAAE,GAAc;IAC7D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,CAAC,QAAQ,KAAK,UAAU;YAAE,OAAO,CAAC,CAAC,KAAK,CAAC;IAChD,CAAC;IACD,MAAM,IAAI,KAAK,CACb,wDAAwD,UAAU,yFAAyF,CAC5J,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAI,EAAc,EAAE,GAAkB,EAAE,OAAgB;IAC1E,MAAM,GAAG,GAAiB,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAa,CAAC;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAW,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;IAC1B,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAc;IAC3C,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;QAClC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,EAAc,EACd,MAA+B;IAE/B,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,WAAW,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE;QACxC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,QAAQ,CAAC,UAAU,CAAI,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EAAc;IAClD,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,WAAW,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE;QACtC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAE/E,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,EAAc,EAAE,GAAkB,EAAE,EAAW;IAClF,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,qBAAqB;IACnC,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,aAAa,CAAC,KAAK,EAAE,CAAC;IACtB,aAAa,CAAC,KAAK,EAAE,CAAC;IACtB,SAAS,GAAG,KAAK,CAAC;AACpB,CAAC"}

package/dist/lib/llm/strategy-ids.d.mts

@@ -0,0 +1,17 @@
+export declare const STRATEGY_CAPABILITIES: {
+    readonly 'publication-analysis': "text";
+    readonly 'timeline-benchmark': "text";
+    readonly 'llm-direct': "text";
+    readonly 'cpc-evolution': "text";
+    readonly 'cpc-mapper': "text";
+    readonly 'logprob-distribution': "logprobs";
+    readonly 'properties-strategy': "text";
+    readonly 'anchor-evolution': "text";
+    readonly 'identify-capability': "text";
+    readonly 'dual-verification': "text";
+    readonly 'pipeline-enrichment': "text";
+    readonly 'write-chain': "text";
+};
+export type StrategyId = keyof typeof STRATEGY_CAPABILITIES;
+export declare const STRATEGY_IDS: StrategyId[];
+//# sourceMappingURL=strategy-ids.d.mts.map

package/dist/lib/llm/strategy-ids.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-ids.d.mts","sourceRoot":"","sources":["../../../src/lib/llm/strategy-ids.mts"],"names":[],"mappings":"AAMA,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CAagB,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAE5D,eAAO,MAAM,YAAY,EAAyC,UAAU,EAAE,CAAC"}

package/dist/lib/llm/strategy-ids.mjs

@@ -0,0 +1,19 @@
+// Canonical list of MCP strategies/capabilities that call an LLM, paired with
+// the capability each one requires. Used by the registry to validate at load
+// time that the provider assigned to each strategy actually supports what it needs.
+export const STRATEGY_CAPABILITIES = {
+    'publication-analysis': 'text',
+    'timeline-benchmark': 'text',
+    'llm-direct': 'text',
+    'cpc-evolution': 'text',
+    'cpc-mapper': 'text',
+    'logprob-distribution': 'logprobs',
+    'properties-strategy': 'text',
+    'anchor-evolution': 'text',
+    'identify-capability': 'text',
+    'dual-verification': 'text',
+    'pipeline-enrichment': 'text',
+    'write-chain': 'text',
+};
+export const STRATEGY_IDS = Object.keys(STRATEGY_CAPABILITIES);
+//# sourceMappingURL=strategy-ids.mjs.map

package/dist/lib/llm/strategy-ids.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-ids.mjs","sourceRoot":"","sources":["../../../src/lib/llm/strategy-ids.mts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,oFAAoF;AAIpF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,sBAAsB,EAAE,MAAM;IAC9B,oBAAoB,EAAI,MAAM;IAC9B,YAAY,EAAY,MAAM;IAC9B,eAAe,EAAS,MAAM;IAC9B,YAAY,EAAY,MAAM;IAC9B,sBAAsB,EAAE,UAAU;IAClC,qBAAqB,EAAG,MAAM;IAC9B,kBAAkB,EAAM,MAAM;IAC9B,qBAAqB,EAAG,MAAM;IAC9B,mBAAmB,EAAK,MAAM;IAC9B,qBAAqB,EAAG,MAAM;IAC9B,aAAa,EAAW,MAAM;CACkB,CAAC;AAInD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAiB,CAAC"}

package/dist/lib/mcp-notifications.d.mts

@@ -0,0 +1,63 @@
+/** Valid MCP log levels (subset used by this project). */
+export declare const LOG_LEVELS: string[];
+/**
+ * Enable or disable verbose mode programmatically.
+ * When disabled, debug-level messages are silently dropped.
+ *
+ * @param {boolean} enabled - true to enable debug messages, false to suppress
+ */
+export type LogLevel = 'debug' | 'info' | 'warning' | 'error';
+export declare function setVerbose(enabled: boolean): void;
+/**
+ * Returns the current verbose mode state.
+ *
+ * @returns {boolean} true if debug-level messages will be emitted
+ */
+export declare function isVerbose(): boolean;
+/**
+ * Send an MCP log notification to stdout.
+ *
+ * Emits both:
+ *   - notifications/claude/channel (for Claude Code chat visibility)
+ *   - notifications/message (standard MCP logging, for other clients)
+ *
+ * @param {string} level - Log level: 'debug' | 'info' | 'warning' | 'error'
+ * @param {string} logger - Logger name (typically the tool name)
+ * @param {string} data - Human-readable log message
+ */
+export declare function sendLog(level: LogLevel, logger: string, data: string): void;
+/**
+ * Send an info-level log notification.
+ * Use for start/end of tool invocations.
+ *
+ * @param {string} logger - Logger name (tool name)
+ * @param {string} message - Human-readable message
+ */
+export declare function logInfo(logger: string, message: string): void;
+/**
+ * Send a debug-level log notification.
+ * Use for intermediate steps (parsing, LLM calls, strategy evaluation).
+ *
+ * **Only emitted when verbose mode is enabled** (WARDLEY_VERBOSE=1 or setVerbose(true)).
+ * When verbose mode is off, this function is a no-op.
+ *
+ * @param {string} logger - Logger name (tool name)
+ * @param {string} message - Human-readable message
+ */
+export declare function logDebug(logger: string, message: string): void;
+/**
+ * Send an error-level log notification.
+ * Use for LLM errors, timeouts, rate limits, API failures.
+ *
+ * @param {string} logger - Logger name (tool name)
+ * @param {string} message - Human-readable error description
+ */
+export declare function logError(logger: string, message: string): void;
+/**
+ * Send a warning-level log notification.
+ *
+ * @param {string} logger - Logger name (tool name)
+ * @param {string} message - Human-readable warning
+ */
+export declare function logWarning(logger: string, message: string): void;
+//# sourceMappingURL=mcp-notifications.d.mts.map

package/dist/lib/mcp-notifications.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-notifications.d.mts","sourceRoot":"","sources":["../../src/lib/mcp-notifications.mts"],"names":[],"mappings":"AAwBA,0DAA0D;AAC1D,eAAO,MAAM,UAAU,UAAwC,CAAC;AAgBhE;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9D,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,YAExB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA0B3E;AAID;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAG9D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhE"}