labre-mcp 0.1.0

package/dist/lib/llm/copilot-sdk-call.mjs

@@ -0,0 +1,211 @@
+// GitHub Copilot SDK call primitives.
+//
+// Mirrors the contract of llm-call.mts (createLLMCall / createStructuredLLMCall)
+// so the registry can treat Copilot SDK strategies identically to Claude Agent
+// SDK ones. Same retry envelope, same interpolation helper, same error handler.
+//
+// Structured output uses "voie B": the prompt carries the JSON Schema, the
+// model replies with free-form text, we strip markdown fences, JSON.parse, and
+// optionally Zod-validate on the caller side. On parse failure a single retry
+// appends a correction instruction before re-asking.
+//
+// The Copilot SDK exposes no logprobs — strategies needing logprobs must route
+// to a provider whose API response includes them (e.g. the `http-api` kind).
+// any: the public preview of @github/copilot-sdk ships without exported types
+// for session event payloads. We touch only the fields we rely on at runtime.
+import { CopilotClient, approveAll } from '@github/copilot-sdk';
+import { classifyAndLogLLMError } from './llm-error-handler.mjs';
+// ─── Retry Configuration (aligned with llm-call.mts) ────────────────────────
+const MAX_RETRIES = 5;
+const INITIAL_BACKOFF_MS = 2000;
+const RETRYABLE_PATTERNS = [
+    'concurrency', 'rate', 'timeout', 'overloaded',
+    'temporarily', 'empty response', 'need retry', 'startup',
+    'unknown error',
+];
+function isRetryableError(err) {
+    const msg = String(err?.message ?? err).toLowerCase();
+    return RETRYABLE_PATTERNS.some(p => msg.includes(p));
+}
+function sleep(ms) {
+    return new Promise(r => setTimeout(r, ms));
+}
+// ─── Template Interpolation (duplicated from llm-call.mts; kept local to  ───
+// keep this file self-contained — extract to a shared module if a third    ───
+// provider ends up needing it) ───────────────────────────────────────────────
+export function interpolate(template, variables) {
+    if (!variables || Object.keys(variables).length === 0)
+        return template;
+    return template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+        return variables[key] !== undefined ? String(variables[key]) : match;
+    });
+}
+// ─── Single-turn session runner ─────────────────────────────────────────────
+async function runSingleTurn(client, model, userPrompt, systemPrompt) {
+    // any: SessionConfig.systemMessage is part of the SDK public preview surface.
+    // When a systemPrompt is provided we use `replace` mode so the caller's
+    // content fully controls the system message — the SDK's default CLI foundation
+    // (code-change rules, tool-efficiency guardrails, etc.) is not meaningful for
+    // pure evaluation calls and would leak into the model's framing.
+    const sessionConfig = {
+        model,
+        onPermissionRequest: approveAll,
+    };
+    if (systemPrompt) {
+        sessionConfig.systemMessage = { mode: 'replace', content: systemPrompt };
+    }
+    const session = await client.createSession(sessionConfig);
+    let fullText = '';
+    let errorFromSession = null;
+    const done = new Promise((resolve) => {
+        // any: event payload shape is `{ data: { content: string, ... } }` at runtime.
+        session.on('assistant.message', (event) => {
+            const chunk = event?.data?.content ?? '';
+            fullText += chunk;
+        });
+        session.on('session.error', (event) => {
+            errorFromSession = new Error(`Copilot session error: ${event?.data?.message ?? 'unknown error'}`);
+            resolve();
+        });
+        session.on('session.idle', () => resolve());
+    });
+    try {
+        await session.send({ prompt: userPrompt });
+        await done;
+    }
+    finally {
+        try {
+            await session.disconnect();
+        }
+        catch {
+            // disconnect errors shouldn't mask the real one
+        }
+    }
+    if (errorFromSession)
+        throw errorFromSession;
+    if (!fullText)
+        throw new Error('Copilot SDK call returned empty response');
+    return fullText;
+}
+async function withClient(githubToken, run) {
+    // any: constructor options shape is part of the SDK's public preview surface.
+    const clientOptions = githubToken
+        ? { githubToken }
+        : { useLoggedInUser: true };
+    const client = new CopilotClient(clientOptions);
+    await client.start();
+    try {
+        return await run(client);
+    }
+    finally {
+        try {
+            await client.stop();
+        }
+        catch {
+            // stop errors shouldn't mask the real one
+        }
+    }
+}
+// ─── Public factories ───────────────────────────────────────────────────────
+export function createCopilotSdkTextCall(config = {}) {
+    const { model = 'gpt-5', githubToken, systemPrompt: factorySystemPrompt, } = config;
+    return async function copilotSdkTextCall(prompt, variables, opts) {
+        const interpolated = interpolate(prompt, variables);
+        const effectiveSystemPrompt = opts?.systemPrompt ?? factorySystemPrompt;
+        const errorContext = { logger: 'copilot-sdk-call', model };
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            try {
+                return await withClient(githubToken, (client) => runSingleTurn(client, model, interpolated, effectiveSystemPrompt));
+            }
+            catch (err) {
+                lastError = err;
+                if (isRetryableError(err) && attempt < MAX_RETRIES - 1) {
+                    const backoff = INITIAL_BACKOFF_MS * (2 ** attempt);
+                    await sleep(backoff);
+                    continue;
+                }
+                classifyAndLogLLMError(err, errorContext);
+                throw err;
+            }
+        }
+        classifyAndLogLLMError(lastError, errorContext);
+        throw lastError;
+    };
+}
+function stripFences(raw) {
+    return raw
+        .replace(/^```(?:json)?\s*/i, '')
+        .replace(/\s*```\s*$/, '')
+        .trim();
+}
+export function createCopilotSdkStructuredCall(config) {
+    const { schema, model = 'gpt-5', githubToken, systemPrompt: factorySystemPrompt, validate, } = config;
+    if (!schema) {
+        throw new Error('createCopilotSdkStructuredCall requires a schema');
+    }
+    const schemaJson = JSON.stringify(schema, null, 2);
+    const outputContract = `Respond ONLY with a single JSON object matching this JSON Schema. ` +
+        `No prose, no markdown, no code fences.\n\n${schemaJson}`;
+    return async function copilotSdkStructuredCall(prompt, variables, opts) {
+        const interpolated = interpolate(prompt, variables);
+        const effectiveSystemPrompt = opts?.systemPrompt ?? factorySystemPrompt;
+        // The output contract is strategy-static (same schema each call) and
+        // belongs in the system message so the user message stays minimal.
+        const systemForCall = effectiveSystemPrompt
+            ? `${effectiveSystemPrompt}\n\n${outputContract}`
+            : outputContract;
+        const errorContext = { logger: 'copilot-sdk-call-structured', model };
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            try {
+                // 1st network attempt of this retry cycle.
+                const raw = await withClient(githubToken, (client) => runSingleTurn(client, model, interpolated, systemForCall));
+                const parsed = tryParseAndValidate(raw, validate);
+                if (parsed.ok)
+                    return parsed.value;
+                // 2nd attempt in the same retry cycle: ask the model to correct itself.
+                const correctionUserPrompt = `${interpolated}\n\n` +
+                    `Your previous response was not a valid JSON object ` +
+                    `matching the schema (reason: ${parsed.reason}). ` +
+                    `Return ONLY the JSON object, no prose, no code fences.`;
+                const rawRetry = await withClient(githubToken, (client) => runSingleTurn(client, model, correctionUserPrompt, systemForCall));
+                const parsedRetry = tryParseAndValidate(rawRetry, validate);
+                if (parsedRetry.ok)
+                    return parsedRetry.value;
+                throw new Error(`Copilot SDK structured call failed after in-cycle correction: ${parsedRetry.reason}`);
+            }
+            catch (err) {
+                lastError = err;
+                if (isRetryableError(err) && attempt < MAX_RETRIES - 1) {
+                    const backoff = INITIAL_BACKOFF_MS * (2 ** attempt);
+                    await sleep(backoff);
+                    continue;
+                }
+                classifyAndLogLLMError(err, errorContext);
+                throw err;
+            }
+        }
+        classifyAndLogLLMError(lastError, errorContext);
+        throw lastError;
+    };
+}
+function tryParseAndValidate(raw, validate) {
+    const cleaned = stripFences(raw);
+    let parsed;
+    try {
+        parsed = JSON.parse(cleaned);
+    }
+    catch (err) {
+        return { ok: false, reason: `JSON.parse: ${err.message}` };
+    }
+    if (!validate)
+        return { ok: true, value: parsed };
+    try {
+        return { ok: true, value: validate(parsed) };
+    }
+    catch (err) {
+        return { ok: false, reason: `validation: ${err.message}` };
+    }
+}
+//# sourceMappingURL=copilot-sdk-call.mjs.map

package/dist/lib/llm/copilot-sdk-call.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-sdk-call.mjs","sourceRoot":"","sources":["../../../src/lib/llm/copilot-sdk-call.mts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,gFAAgF;AAChF,EAAE;AACF,2EAA2E;AAC3E,+EAA+E;AAC/E,8EAA8E;AAC9E,qDAAqD;AACrD,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAE7E,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAOjE,+EAA+E;AAE/E,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,kBAAkB,GAAG;IACzB,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY;IAC9C,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS;IACxD,eAAe;CAChB,CAAC;AAEF,SAAS,gBAAgB,CAAC,GAAY;IACpC,MAAM,GAAG,GAAG,MAAM,CAAE,GAA4B,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAChF,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAE/E,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,SAA6B;IACzE,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvE,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;QAC/D,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC;AAsBD,+EAA+E;AAE/E,KAAK,UAAU,aAAa,CAC1B,MAAqB,EACrB,KAAa,EACb,UAAkB,EAClB,YAAqB;IAErB,8EAA8E;IAC9E,wEAAwE;IACxE,+EAA+E;IAC/E,8EAA8E;IAC9E,iEAAiE;IACjE,MAAM,aAAa,GAAQ;QACzB,KAAK;QACL,mBAAmB,EAAE,UAAU;KAChC,CAAC;IACF,IAAI,YAAY,EAAE,CAAC;QACjB,aAAa,CAAC,aAAa,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAC3E,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAE1D,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,gBAAgB,GAAY,IAAI,CAAC;IAErC,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACzC,+EAA+E;QAC/E,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAU,EAAE,EAAE;YAC7C,MAAM,KAAK,GAAW,KAAK,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;YACjD,QAAQ,IAAI,KAAK,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,KAAU,EAAE,EAAE;YACzC,gBAAgB,GAAG,IAAI,KAAK,CAC1B,0BAA0B,KAAK,EAAE,IAAI,EAAE,OAAO,IAAI,eAAe,EAAE,CACpE,CAAC;YACF,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC;IACb,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,gDAAgD;QAClD,CAAC;IACH,CAAC;IAED,IAAI,gBAAgB;QAAE,MAAM,gBAAgB,CAAC;IAC7C,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC3E,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,WAA+B,EAC/B,GAA0C;IAE1C,8EAA8E;IAC9E,MAAM,aAAa,GAAQ,WAAW;QACpC,CAAC,CAAC,EAAE,WAAW,EAAE;QACjB,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;IAE9B,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;IACH,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,wBAAwB,CAAC,SAA+B,EAAE;IACxE,MAAM,EACJ,KAAK,GAAG,OAAO,EACf,WAAW,EACX,YAAY,EAAE,mBAAmB,GAClC,GAAG,MAAM,CAAC;IAEX,OAAO,KAAK,UAAU,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI;QAC9D,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpD,MAAM,qBAAqB,GAAG,IAAI,EAAE,YAAY,IAAI,mBAAmB,CAAC;QAExE,MAAM,YAAY,GAAG,EAAE,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;QAE3D,IAAI,SAAkB,CAAC;QACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,OAAO,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAC9C,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,qBAAqB,CAAC,CAClE,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,CAAC;gBAChB,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,OAAO,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC;oBACvD,MAAM,OAAO,GAAG,kBAAkB,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC;oBACpD,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;oBACrB,SAAS;gBACX,CAAC;gBACD,sBAAsB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;gBAC1C,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,sBAAsB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAChD,MAAM,SAAS,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG;SACP,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,MAAqC;IAErC,MAAM,EACJ,MAAM,EACN,KAAK,GAAG,OAAO,EACf,WAAW,EACX,YAAY,EAAE,mBAAmB,EACjC,QAAQ,GACT,GAAG,MAAM,CAAC;IAEX,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACnD,MAAM,cAAc,GAClB,oEAAoE;QACpE,6CAA6C,UAAU,EAAE,CAAC;IAE5D,OAAO,KAAK,UAAU,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI;QACpE,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpD,MAAM,qBAAqB,GAAG,IAAI,EAAE,YAAY,IAAI,mBAAmB,CAAC;QACxE,qEAAqE;QACrE,mEAAmE;QACnE,MAAM,aAAa,GAAG,qBAAqB;YACzC,CAAC,CAAC,GAAG,qBAAqB,OAAO,cAAc,EAAE;YACjD,CAAC,CAAC,cAAc,CAAC;QAEnB,MAAM,YAAY,GAAG,EAAE,MAAM,EAAE,6BAA6B,EAAE,KAAK,EAAE,CAAC;QAEtE,IAAI,SAAkB,CAAC;QACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,2CAA2C;gBAC3C,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CACnD,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,CAAC,CAC1D,CAAC;gBAEF,MAAM,MAAM,GAAG,mBAAmB,CAAI,GAAG,EAAE,QAAQ,CAAC,CAAC;gBACrD,IAAI,MAAM,CAAC,EAAE;oBAAE,OAAO,MAAM,CAAC,KAAK,CAAC;gBAEnC,wEAAwE;gBACxE,MAAM,oBAAoB,GACxB,GAAG,YAAY,MAAM;oBACrB,qDAAqD;oBACrD,gCAAgC,MAAM,CAAC,MAAM,KAAK;oBAClD,wDAAwD,CAAC;gBAE3D,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CACxD,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,oBAAoB,EAAE,aAAa,CAAC,CAClE,CAAC;gBAEF,MAAM,WAAW,GAAG,mBAAmB,CAAI,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAC/D,IAAI,WAAW,CAAC,EAAE;oBAAE,OAAO,WAAW,CAAC,KAAK,CAAC;gBAE7C,MAAM,IAAI,KAAK,CACb,iEAAiE,WAAW,CAAC,MAAM,EAAE,CACtF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,CAAC;gBAChB,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,OAAO,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC;oBACvD,MAAM,OAAO,GAAG,kBAAkB,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC;oBACpD,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;oBACrB,SAAS;gBACX,CAAC;gBACD,sBAAsB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;gBAC1C,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,sBAAsB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAChD,MAAM,SAAS,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAMD,SAAS,mBAAmB,CAC1B,GAAW,EACX,QAAgC;IAEhC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAgB,GAAa,CAAC,OAAO,EAAE,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAW,EAAE,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAgB,GAAa,CAAC,OAAO,EAAE,EAAE,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/lib/llm/llm-call.d.mts

@@ -0,0 +1,18 @@
+import type { LLMCall, StructuredLLMCall, LogprobLLMCall, ClaudeLLMConfig, StructuredLLMConfig, OpenCodeConfig, OpenCodeLogprobConfig, TemplateVariables } from '../../types/llm.mjs';
+/** Replace {{variable}} placeholders in a template string. */
+export declare function interpolate(template: string, variables?: TemplateVariables): string;
+/**
+ * Create a reusable LLM call function backed by the Claude Agent SDK.
+ * Uses query() with tools disabled for pure text completion.
+ */
+export declare function createLLMCall(config?: ClaudeLLMConfig): LLMCall;
+/** Create an LLM call that returns structured JSON via the Agent SDK. */
+export declare function createStructuredLLMCall<T = unknown>(config: StructuredLLMConfig): StructuredLLMCall<T>;
+/**
+ * Create an LLM call function backed by the OpenCode API gateway.
+ * Uses standard OpenAI-compatible chat completions endpoint.
+ */
+export declare function createOpenCodeCall(config?: OpenCodeConfig): LLMCall;
+/** Create an LLM call that returns real token logprobs via OpenCode + kimi-k2.5. */
+export declare function createOpenCodeLogprobCall(config?: OpenCodeLogprobConfig): LogprobLLMCall;
+//# sourceMappingURL=llm-call.d.mts.map

package/dist/lib/llm/llm-call.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-call.d.mts","sourceRoot":"","sources":["../../../src/lib/llm/llm-call.mts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EACjB,cAAc,EAEd,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAuB7B,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAKnF;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,eAAoB,GAAG,OAAO,CAkEnE;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,OAAO,EACjD,MAAM,EAAE,mBAAmB,GAC1B,iBAAiB,CAAC,CAAC,CAAC,CAoEtB;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAkEvE;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,qBAA0B,GACjC,cAAc,CA0FhB"}

package/dist/lib/llm/llm-call.mjs

@@ -0,0 +1,286 @@
+// Generic LLM call module — multi-backend support.
+//
+// Two backends:
+//   1. Claude Agent SDK (default) — for text completion, no logprobs
+//   2. OpenCode API gateway — for kimi-k2.5 with real logprobs
+//
+// Usage:
+//   import { createLLMCall, createOpenCodeLogprobCall } from './llm-call.mjs';
+//   const llmCall = createLLMCall();
+//   const text = await llmCall('Analyze {{component}}', { component: 'ERP' });
+//
+//   const logprobCall = createOpenCodeLogprobCall();
+//   const { text, logprobs } = await logprobCall('Classify {{component}}', { component: 'ERP' });
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { classifyAndLogLLMError } from './llm-error-handler.mjs';
+// ─── Retry Configuration (aligned with Ouroboros claude_code_adapter) ───────
+const MAX_RETRIES = 5;
+const INITIAL_BACKOFF_MS = 2000;
+const RETRYABLE_PATTERNS = [
+    'concurrency', 'rate', 'timeout', 'overloaded',
+    'temporarily', 'empty response', 'need retry', 'startup',
+    'unknown error',
+];
+function isRetryableError(err) {
+    const msg = String(err?.message ?? err).toLowerCase();
+    return RETRYABLE_PATTERNS.some(p => msg.includes(p));
+}
+function sleep(ms) {
+    return new Promise(r => setTimeout(r, ms));
+}
+// ─── Template Interpolation ─────────────────────────────────────────────────
+/** Replace {{variable}} placeholders in a template string. */
+export function interpolate(template, variables) {
+    if (!variables || Object.keys(variables).length === 0)
+        return template;
+    return template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+        return variables[key] !== undefined ? String(variables[key]) : match;
+    });
+}
+// ─── Backend 1: Claude Agent SDK ────────────────────────────────────────────
+/**
+ * Create a reusable LLM call function backed by the Claude Agent SDK.
+ * Uses query() with tools disabled for pure text completion.
+ */
+export function createLLMCall(config = {}) {
+    const { model = 'claude-sonnet-4-6', effort = 'high', systemPrompt: factorySystemPrompt, } = config;
+    return async function llmCall(prompt, variables, opts) {
+        const interpolatedPrompt = interpolate(prompt, variables);
+        // Per-call opts.systemPrompt wins over factory-level config.systemPrompt.
+        // This lets split-prompt call-sites carry the .system.md content while
+        // leaving factory-level overrides available for strategies that don't.
+        const effectiveSystemPrompt = opts?.systemPrompt ?? factorySystemPrompt;
+        // Prevent nested session detection that causes silent empty responses
+        if (process.env.CLAUDECODE) {
+            delete process.env.CLAUDECODE;
+        }
+        const options = {
+            model,
+            maxTurns: 1,
+            effort,
+            persistSession: false,
+            disallowedTools: ['Write', 'Edit', 'Bash', 'Glob', 'Grep', 'Read'],
+        };
+        if (effectiveSystemPrompt) {
+            options.systemPrompt = effectiveSystemPrompt;
+        }
+        const errorContext = { logger: 'llm-call', model };
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            try {
+                let resultText = '';
+                for await (const message of query({ prompt: interpolatedPrompt, options })) {
+                    const msg = message;
+                    if (msg.type === 'result') {
+                        if (msg.subtype === 'success') {
+                            resultText = msg.result || '';
+                        }
+                        else {
+                            const errors = msg.errors || [];
+                            throw new Error(`LLM call failed: ${errors.join(', ') || 'unknown error'}`);
+                        }
+                    }
+                }
+                if (!resultText) {
+                    throw new Error('LLM call returned empty response');
+                }
+                return resultText;
+            }
+            catch (err) {
+                lastError = err;
+                if (isRetryableError(err) && attempt < MAX_RETRIES - 1) {
+                    const backoff = INITIAL_BACKOFF_MS * (2 ** attempt);
+                    await sleep(backoff);
+                    continue;
+                }
+                classifyAndLogLLMError(err, errorContext);
+                throw err;
+            }
+        }
+        classifyAndLogLLMError(lastError, errorContext);
+        throw lastError;
+    };
+}
+/** Create an LLM call that returns structured JSON via the Agent SDK. */
+export function createStructuredLLMCall(config) {
+    const { schema, model = 'claude-sonnet-4-6', effort = 'high', systemPrompt: factorySystemPrompt, } = config;
+    if (!schema) {
+        throw new Error('createStructuredLLMCall requires a schema');
+    }
+    return async function structuredLLMCall(prompt, variables, opts) {
+        const interpolatedPrompt = interpolate(prompt, variables);
+        const effectiveSystemPrompt = opts?.systemPrompt ?? factorySystemPrompt;
+        if (process.env.CLAUDECODE) {
+            delete process.env.CLAUDECODE;
+        }
+        const options = {
+            model,
+            maxTurns: 1,
+            effort,
+            persistSession: false,
+            disallowedTools: ['Write', 'Edit', 'Bash', 'Glob', 'Grep', 'Read'],
+            outputFormat: { type: 'json_schema', schema },
+        };
+        if (effectiveSystemPrompt) {
+            options.systemPrompt = effectiveSystemPrompt;
+        }
+        const errorContext = { logger: 'llm-call-structured', model };
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            try {
+                let resultText = '';
+                for await (const message of query({ prompt: interpolatedPrompt, options })) {
+                    const msg = message;
+                    if (msg.type === 'result') {
+                        if (msg.subtype === 'success') {
+                            resultText = msg.result || '';
+                        }
+                        else {
+                            const errors = msg.errors || [];
+                            throw new Error(`Structured LLM call failed: ${errors.join(', ') || 'unknown error'}`);
+                        }
+                    }
+                }
+                if (!resultText) {
+                    throw new Error('Structured LLM call returned empty response');
+                }
+                return JSON.parse(resultText);
+            }
+            catch (err) {
+                lastError = err;
+                if (isRetryableError(err) && attempt < MAX_RETRIES - 1) {
+                    const backoff = INITIAL_BACKOFF_MS * (2 ** attempt);
+                    await sleep(backoff);
+                    continue;
+                }
+                classifyAndLogLLMError(err, errorContext);
+                throw err;
+            }
+        }
+        classifyAndLogLLMError(lastError, errorContext);
+        throw lastError;
+    };
+}
+// ─── Backend 2: OpenCode API Gateway ────────────────────────────────────────
+/**
+ * Create an LLM call function backed by the OpenCode API gateway.
+ * Uses standard OpenAI-compatible chat completions endpoint.
+ */
+export function createOpenCodeCall(config = {}) {
+    const { model = 'kimi-k2.5', baseUrl = 'https://opencode.ai/zen/v1', apiKey = process.env.OPENCODE_API_KEY, temperature = 0, systemPrompt: factorySystemPrompt, } = config;
+    return async function openCodeCall(prompt, variables, opts) {
+        const interpolatedPrompt = interpolate(prompt, variables);
+        const effectiveSystemPrompt = opts?.systemPrompt ?? factorySystemPrompt;
+        const errorContext = { logger: 'opencode-call', model };
+        if (!apiKey) {
+            const authErr = new Error('OpenCode API key not configured. Set OPENCODE_API_KEY in .env');
+            classifyAndLogLLMError(authErr, errorContext);
+            throw authErr;
+        }
+        const messages = [];
+        if (effectiveSystemPrompt) {
+            messages.push({ role: 'system', content: effectiveSystemPrompt });
+        }
+        messages.push({ role: 'user', content: interpolatedPrompt });
+        let response;
+        try {
+            response = await fetch(`${baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    model,
+                    messages,
+                    temperature,
+                }),
+            });
+        }
+        catch (fetchErr) {
+            classifyAndLogLLMError(fetchErr, errorContext);
+            throw fetchErr;
+        }
+        if (!response.ok) {
+            const body = await response.text();
+            const apiErr = new Error(`OpenCode API error ${response.status}: ${body}`);
+            classifyAndLogLLMError(apiErr, errorContext);
+            throw apiErr;
+        }
+        const data = await response.json();
+        const text = data.choices?.[0]?.message?.content;
+        if (!text) {
+            const emptyErr = new Error('OpenCode call returned empty response');
+            classifyAndLogLLMError(emptyErr, errorContext);
+            throw emptyErr;
+        }
+        return text;
+    };
+}
+/** Create an LLM call that returns real token logprobs via OpenCode + kimi-k2.5. */
+export function createOpenCodeLogprobCall(config = {}) {
+    const { model = 'kimi-k2.5', baseUrl = 'https://opencode.ai/zen/v1', apiKey = process.env.OPENCODE_API_KEY, topLogprobs = 5, systemPrompt: factorySystemPrompt, } = config;
+    return async function openCodeLogprobCall(prompt, variables, opts) {
+        const interpolatedPrompt = interpolate(prompt, variables);
+        const effectiveSystemPrompt = opts?.systemPrompt ?? factorySystemPrompt;
+        const errorContext = { logger: 'opencode-logprob', model };
+        if (!apiKey) {
+            const authErr = new Error('OpenCode API key not configured. Set OPENCODE_API_KEY in .env');
+            classifyAndLogLLMError(authErr, errorContext);
+            throw authErr;
+        }
+        const messages = [];
+        if (effectiveSystemPrompt) {
+            messages.push({ role: 'system', content: effectiveSystemPrompt });
+        }
+        messages.push({ role: 'user', content: interpolatedPrompt });
+        let response;
+        try {
+            response = await fetch(`${baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    model,
+                    messages,
+                    temperature: 0,
+                    logprobs: true,
+                    top_logprobs: topLogprobs,
+                    max_tokens: 10,
+                }),
+            });
+        }
+        catch (fetchErr) {
+            classifyAndLogLLMError(fetchErr, errorContext);
+            throw fetchErr;
+        }
+        if (!response.ok) {
+            const body = await response.text();
+            const apiErr = new Error(`OpenCode logprob API error ${response.status}: ${body}`);
+            classifyAndLogLLMError(apiErr, errorContext);
+            throw apiErr;
+        }
+        const data = await response.json();
+        const text = data.choices?.[0]?.message?.content || '';
+        const contentLogprobs = data.choices?.[0]?.logprobs?.content;
+        const logprobs = [];
+        if (contentLogprobs && contentLogprobs.length > 0) {
+            const firstToken = contentLogprobs[0];
+            logprobs.push({
+                token: firstToken.token,
+                logprob: firstToken.logprob,
+            });
+            if (firstToken.top_logprobs) {
+                for (const alt of firstToken.top_logprobs) {
+                    if (alt.token !== firstToken.token) {
+                        logprobs.push({ token: alt.token, logprob: alt.logprob });
+                    }
+                }
+            }
+        }
+        return { text, logprobs };
+    };
+}
+//# sourceMappingURL=llm-call.mjs.map

package/dist/lib/llm/llm-call.mjs.map

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

package/dist/lib/llm/llm-error-handler.d.mts

@@ -0,0 +1,40 @@
+export type LLMErrorType = 'timeout' | 'rate_limit' | 'auth' | 'api_error' | 'empty_response' | 'network' | 'generic';
+export interface ClassifiedError {
+    /** Error category */
+    type: LLMErrorType;
+    /** HTTP status code if available */
+    status: number | null;
+    /** Original error message */
+    message: string;
+    /** Retry-After header value if available */
+    retryAfter: string | null;
+}
+/** Localized message resolver (id + params → string). */
+export type MessageResolver = (id: string, params?: Record<string, unknown>) => string;
+export interface ErrorLoggingOptions {
+    /** Logger name (tool or module name) */
+    logger?: string;
+    /** LLM model name for context */
+    model?: string;
+    /** Message resolver from progress-messages.mjs; falls back to English plain messages */
+    msg?: MessageResolver | null;
+}
+/**
+ * Classify an LLM error into a specific category.
+ * Uses heuristics on the error object properties and message string.
+ */
+export declare function classifyLLMError(error: unknown): ClassifiedError;
+/**
+ * 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 declare function classifyAndLogLLMError(error: unknown, options?: ErrorLoggingOptions): ClassifiedError;
+/**
+ * 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 declare function withLLMErrorLogging<T>(fn: () => Promise<T>, options?: ErrorLoggingOptions): Promise<T>;
+//# sourceMappingURL=llm-error-handler.d.mts.map

package/dist/lib/llm/llm-error-handler.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-error-handler.d.mts","sourceRoot":"","sources":["../../../src/lib/llm/llm-error-handler.mts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,YAAY,GACZ,MAAM,GACN,WAAW,GACX,gBAAgB,GAChB,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,oCAAoC;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,CAC5B,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,MAAM,CAAC;AAEZ,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,GAAG,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC9B;AAWD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CA+EhE;AAID;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,mBAAwB,GAChC,eAAe,CA+DjB;AAID;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,CAAC,CAAC,CAOZ"}