@thoughtflow/core 0.1.2

package/dist/adapters/llm/anthropic.adapter.js

@@ -0,0 +1,295 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicAdapter = void 0;
+const llm_retry_1 = require("../../libs/llm-retry");
+/** Default Anthropic API endpoint. */
+const ANTHROPIC_API_URL = "https://api.anthropic.com";
+const ANTHROPIC_VERSION = "2023-06-01";
+/** Budget tokens for extended thinking (used when thinking=true). */
+const THINKING_BUDGET_TOKENS = 10_000;
+class AnthropicAdapter {
+    config;
+    headers;
+    defaultModel;
+    constructor(config) {
+        this.config = config;
+        this.defaultModel = config.defaultModel ?? "claude-3-5-sonnet-20241022";
+        this.headers = {
+            "Content-Type": "application/json",
+            "x-api-key": config.apiKey,
+            "anthropic-version": ANTHROPIC_VERSION,
+        };
+    }
+    async listModels() {
+        const res = await fetch(`${ANTHROPIC_API_URL}/v1/models`, {
+            headers: this.headers,
+        });
+        if (!res.ok) {
+            throw new Error(`Anthropic listModels failed: ${res.status} ${await res.text()}`);
+        }
+        const json = await res.json();
+        const data = Array.isArray(json.data) ? json.data : [];
+        return data.flatMap((m) => {
+            if (!m || typeof m !== "object")
+                return [];
+            const id = m["id"];
+            if (typeof id !== "string")
+                return [];
+            return [{ name: id }];
+        });
+    }
+    async preflight(request) {
+        const warnings = [];
+        let availableModels = [];
+        let modelFound = false;
+        try {
+            availableModels = await this.listModels();
+            modelFound = availableModels.some(m => m.name === request.model);
+            if (!modelFound) {
+                warnings.push(`Model '${request.model}' not found via Anthropic models API.`);
+            }
+        }
+        catch {
+            warnings.push("Could not fetch model list from Anthropic API.");
+        }
+        const supportsThinking = request.model.includes("claude-3-7");
+        if (request.thinking && !supportsThinking) {
+            warnings.push(`Extended thinking requires claude-3-7-* models. Got: ${request.model}`);
+        }
+        const modelLower = request.model.toLowerCase();
+        const supportsVision = modelLower.includes("claude-3") ||
+            modelLower.includes("claude-sonnet") ||
+            modelLower.includes("claude-haiku") ||
+            modelLower.includes("claude-opus");
+        return {
+            model: request.model,
+            modelFound,
+            availableModels,
+            capabilities: {
+                supportsThinking,
+                supportsTools: true,
+                supportsStreaming: true,
+                supportsNativeStructuredOutput: false,
+                supportsVision,
+            },
+            warnings,
+        };
+    }
+    async chat(request) {
+        const body = this.buildBody(request);
+        const extraHeaders = request.thinking
+            ? { "anthropic-beta": "interleaved-thinking-2025-05-14" }
+            : {};
+        const res = await (0, llm_retry_1.fetchWithLlmRetry)(() => fetch(`${ANTHROPIC_API_URL}/v1/messages`, {
+            method: "POST",
+            headers: { ...this.headers, ...extraHeaders },
+            body: JSON.stringify(body),
+            signal: request.signal,
+        }), this.config.retry, request.signal);
+        const json = await res.json();
+        let textContent = "";
+        let thinkingContent;
+        const toolCalls = [];
+        for (const block of json.content ?? []) {
+            if (block.type === "text")
+                textContent += block.text ?? "";
+            else if (block.type === "thinking")
+                thinkingContent = (thinkingContent ?? "") + (block.thinking ?? "");
+            else if (block.type === "tool_use") {
+                toolCalls.push({ id: block.id, name: block.name ?? "", arguments: block.input ?? {} });
+            }
+        }
+        return {
+            message: {
+                content: textContent,
+                toolCalls: toolCalls.length ? toolCalls : undefined,
+                thinking: thinkingContent,
+            },
+            tokensInput: json.usage?.input_tokens,
+            tokensOutput: json.usage?.output_tokens,
+        };
+    }
+    async streamChat(request, onChunk) {
+        const body = { ...this.buildBody(request), stream: true };
+        const extraHeaders = request.thinking
+            ? { "anthropic-beta": "interleaved-thinking-2025-05-14" }
+            : {};
+        const res = await (0, llm_retry_1.fetchWithLlmRetry)(() => fetch(`${ANTHROPIC_API_URL}/v1/messages`, {
+            method: "POST",
+            headers: { ...this.headers, ...extraHeaders },
+            body: JSON.stringify(body),
+            signal: request.signal,
+        }), this.config.retry, request.signal);
+        const reader = res.body?.getReader();
+        if (!reader)
+            throw new Error("No response body");
+        let fullContent = "";
+        let fullThinking = "";
+        const decoder = new TextDecoder();
+        const toolCallAccums = new Map();
+        const accumulatedToolCalls = [];
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const lines = decoder.decode(value).split("\n");
+            for (const line of lines) {
+                if (!line.startsWith("data: "))
+                    continue;
+                const data = line.slice(6).trim();
+                try {
+                    const parsed = JSON.parse(data);
+                    if (parsed.type === "content_block_start") {
+                        const cb = parsed.content_block;
+                        if (cb?.type === "tool_use") {
+                            toolCallAccums.set(parsed.index, {
+                                id: cb.id ?? "",
+                                name: cb.name ?? "",
+                                partialJson: "",
+                            });
+                        }
+                    }
+                    else if (parsed.type === "content_block_delta") {
+                        const delta = parsed.delta;
+                        const idx = parsed.index;
+                        if (delta?.type === "input_json_delta" && delta.partial_json) {
+                            const acc = toolCallAccums.get(idx);
+                            if (acc)
+                                acc.partialJson += delta.partial_json;
+                        }
+                        else if (delta?.type === "text_delta" && delta.text) {
+                            fullContent += delta.text;
+                            onChunk({ contentDelta: delta.text, fullContent, fullThinking: fullThinking || undefined, done: false });
+                        }
+                        else if (delta?.type === "thinking_delta" && delta.thinking) {
+                            fullThinking += delta.thinking;
+                            onChunk({ thinkingDelta: delta.thinking, fullContent, fullThinking, done: false });
+                        }
+                    }
+                    else if (parsed.type === "content_block_stop") {
+                        const acc = toolCallAccums.get(parsed.index);
+                        if (acc) {
+                            let parsedArgs = {};
+                            try {
+                                parsedArgs = JSON.parse(acc.partialJson || "{}");
+                            }
+                            catch { /* use empty */ }
+                            const toolCall = { id: acc.id, name: acc.name, arguments: parsedArgs };
+                            accumulatedToolCalls.push(toolCall);
+                            toolCallAccums.delete(parsed.index);
+                            onChunk({
+                                contentDelta: "",
+                                fullContent,
+                                fullThinking: fullThinking || undefined,
+                                done: false,
+                                metadata: { toolCallDelta: toolCall },
+                            });
+                        }
+                    }
+                }
+                catch {
+                    // Non-JSON SSE line — skip
+                }
+            }
+        }
+        onChunk({ contentDelta: "", fullContent, fullThinking: fullThinking || undefined, done: true });
+        return {
+            message: {
+                content: fullContent,
+                toolCalls: accumulatedToolCalls.length ? accumulatedToolCalls : undefined,
+                thinking: fullThinking || undefined,
+            },
+        };
+    }
+    // ── Helpers ────────────────────────────────────────────────────────────────
+    toAnthropicMessage(msg) {
+        if (msg.role === "tool") {
+            return {
+                role: "user",
+                content: [
+                    {
+                        type: "tool_result",
+                        tool_use_id: msg.toolCallId ?? "",
+                        content: msg.content,
+                    },
+                ],
+            };
+        }
+        if (msg.role === "assistant" && msg.toolCalls?.length) {
+            const blocks = [];
+            if (msg.content) {
+                blocks.push({ type: "text", text: msg.content });
+            }
+            for (const tc of msg.toolCalls) {
+                blocks.push({
+                    type: "tool_use",
+                    id: tc.id,
+                    name: tc.name,
+                    input: tc.arguments,
+                });
+            }
+            return { role: "assistant", content: blocks };
+        }
+        // Vision: use contentParts as Anthropic content blocks
+        if (msg.contentParts && msg.contentParts.length > 0) {
+            const blocks = msg.contentParts.map(part => {
+                if (part.type === "text")
+                    return { type: "text", text: part.text };
+                if (part.type === "image_url") {
+                    const url = part.image_url.url;
+                    let mediaType = "image/png";
+                    let data = url;
+                    const dataUrlMatch = url.match(/^data:(image\/\w+);base64,(.+)$/);
+                    if (dataUrlMatch) {
+                        mediaType = dataUrlMatch[1];
+                        data = dataUrlMatch[2];
+                    }
+                    return { type: "image", source: { type: "base64", media_type: mediaType, data } };
+                }
+                return null;
+            }).filter(Boolean);
+            return { role: msg.role, content: blocks };
+        }
+        return { role: msg.role, content: msg.content };
+    }
+    buildBody(request) {
+        // Separate system prompt (first system message) from the rest
+        const systemMsg = request.messages.find(m => m.role === "system");
+        const otherMessages = request.messages
+            .filter(m => m.role !== "system")
+            .map(m => this.toAnthropicMessage(m));
+        const structuredInstruction = request.responseFormat === "json"
+            ? [
+                "Return ONLY valid JSON.",
+                "Do not include markdown code fences.",
+                "Do not include explanations outside JSON.",
+                request.responseSchema ? `JSON schema hint: ${JSON.stringify(request.responseSchema)}` : undefined,
+            ]
+                .filter(Boolean)
+                .join(" ")
+            : undefined;
+        const body = {
+            model: request.model ?? this.defaultModel,
+            max_tokens: request.maxTokens ?? 8192,
+            messages: otherMessages,
+        };
+        const systemParts = [systemMsg?.content, structuredInstruction].filter(Boolean);
+        if (systemParts.length > 0)
+            body["system"] = systemParts.join("\n\n");
+        if (request.temperature !== undefined)
+            body["temperature"] = request.temperature;
+        if (request.thinking) {
+            body["thinking"] = { type: "enabled", budget_tokens: THINKING_BUDGET_TOKENS };
+        }
+        if (request.tools && request.tools.length > 0) {
+            body["tools"] = request.tools.map(t => ({
+                name: t.name,
+                description: t.description,
+                input_schema: t.inputJsonSchema ?? { type: "object", properties: {} },
+            }));
+        }
+        return body;
+    }
+}
+exports.AnthropicAdapter = AnthropicAdapter;
+//# sourceMappingURL=anthropic.adapter.js.map

package/dist/adapters/llm/anthropic.adapter.js.map

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

package/dist/adapters/llm/llm-adapter.interface.d.ts

@@ -0,0 +1,2 @@
+export type { LlmAdapter } from "../../contracts";
+//# sourceMappingURL=llm-adapter.interface.d.ts.map

package/dist/adapters/llm/llm-adapter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-adapter.interface.d.ts","sourceRoot":"","sources":["../../../src/adapters/llm/llm-adapter.interface.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/adapters/llm/llm-adapter.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=llm-adapter.interface.js.map

package/dist/adapters/llm/llm-adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-adapter.interface.js","sourceRoot":"","sources":["../../../src/adapters/llm/llm-adapter.interface.ts"],"names":[],"mappings":""}

package/dist/adapters/llm/mock.adapter.d.ts

@@ -0,0 +1,60 @@
+import { LlmAdapter, LlmChatRequest, LlmChatResponse, LlmModelInfo, LlmPreflightRequest, LlmPreflightResult, LlmStreamChunk } from "../../contracts";
+export interface MockResponse {
+    content: string;
+    thinking?: string;
+    /** Optional tool calls to include in the response (native function-calling path). */
+    toolCalls?: Array<{
+        id?: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+    tokensInput?: number;
+    tokensOutput?: number;
+    /** Optional function to assert on the incoming request during tests. */
+    onRequest?: (request: LlmChatRequest) => void;
+}
+export interface MockAdapterConfig {
+    /**
+     * Responses returned in sequence.
+     * If the list is exhausted, the last entry repeats.
+     */
+    responses?: MockResponse[];
+    /**
+     * Static text returned for every call when `responses` is not set.
+     * Defaults to "Mock response."
+     */
+    defaultContent?: string;
+    /** Models reported by listModels(). Defaults to [{ name: "mock-model" }]. */
+    models?: LlmModelInfo[];
+}
+/**
+ * Deterministic LLM adapter for unit/integration tests.
+ * No network calls — all responses are provided at construction time.
+ *
+ * @example
+ * ```ts
+ * const adapter = new MockAdapter({
+ *   responses: [
+ *     { content: 'Hello!' },
+ *     { content: 'Goodbye!' },
+ *   ]
+ * });
+ * ```
+ */
+export declare class MockAdapter implements LlmAdapter {
+    private readonly config;
+    private callCount;
+    private readonly responses;
+    private readonly models;
+    constructor(config?: MockAdapterConfig);
+    /** Total number of chat calls made so far (useful in assertions). */
+    get callsMade(): number;
+    /** Reset the call counter (useful between test cases). */
+    reset(): void;
+    listModels(): Promise<LlmModelInfo[]>;
+    preflight(_request: LlmPreflightRequest): Promise<LlmPreflightResult>;
+    chat(request: LlmChatRequest): Promise<LlmChatResponse>;
+    streamChat(request: LlmChatRequest, onChunk: (chunk: LlmStreamChunk) => void): Promise<LlmChatResponse>;
+    private nextResponse;
+}
+//# sourceMappingURL=mock.adapter.d.ts.map

package/dist/adapters/llm/mock.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/llm/mock.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAY,YAAW,UAAU;IAKhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAEX,MAAM,GAAE,iBAAsB;IAK3D,qEAAqE;IACrE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,0DAA0D;IAC1D,KAAK,IAAI,IAAI;IAIP,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIrC,SAAS,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAerE,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAiBvD,UAAU,CACd,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GACvC,OAAO,CAAC,eAAe,CAAC;IAyC3B,OAAO,CAAC,YAAY;CAOrB"}

package/dist/adapters/llm/mock.adapter.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockAdapter = void 0;
+/**
+ * Deterministic LLM adapter for unit/integration tests.
+ * No network calls — all responses are provided at construction time.
+ *
+ * @example
+ * ```ts
+ * const adapter = new MockAdapter({
+ *   responses: [
+ *     { content: 'Hello!' },
+ *     { content: 'Goodbye!' },
+ *   ]
+ * });
+ * ```
+ */
+class MockAdapter {
+    config;
+    callCount = 0;
+    responses;
+    models;
+    constructor(config = {}) {
+        this.config = config;
+        this.responses = config.responses ?? [{ content: config.defaultContent ?? "Mock response." }];
+        this.models = config.models ?? [{ name: "mock-model" }];
+    }
+    /** Total number of chat calls made so far (useful in assertions). */
+    get callsMade() {
+        return this.callCount;
+    }
+    /** Reset the call counter (useful between test cases). */
+    reset() {
+        this.callCount = 0;
+    }
+    async listModels() {
+        return this.models;
+    }
+    async preflight(_request) {
+        return {
+            model: _request.model,
+            modelFound: true,
+            availableModels: this.models,
+            capabilities: {
+                supportsThinking: true,
+                supportsTools: true,
+                supportsStreaming: true,
+                supportsNativeStructuredOutput: true,
+            },
+            warnings: [],
+        };
+    }
+    async chat(request) {
+        const response = this.nextResponse(request);
+        return {
+            message: {
+                content: response.content,
+                toolCalls: response.toolCalls?.map((tc, i) => ({
+                    id: tc.id ?? `call_mock_${Date.now()}_${i}`,
+                    name: tc.name,
+                    arguments: tc.arguments,
+                })),
+                thinking: response.thinking,
+            },
+            tokensInput: response.tokensInput ?? 0,
+            tokensOutput: response.tokensOutput ?? 0,
+        };
+    }
+    async streamChat(request, onChunk) {
+        const response = this.nextResponse(request);
+        // Emit thinking first if present
+        if (response.thinking) {
+            onChunk({
+                thinkingDelta: response.thinking,
+                fullThinking: response.thinking,
+                fullContent: "",
+                done: false,
+            });
+        }
+        // Stream content word by word to exercise streaming paths in tests
+        const words = response.content.split(" ");
+        let fullContent = "";
+        for (const word of words) {
+            const delta = fullContent.length === 0 ? word : ` ${word}`;
+            fullContent += delta;
+            onChunk({ contentDelta: delta, fullContent, done: false });
+        }
+        onChunk({ contentDelta: "", fullContent, done: true });
+        return {
+            message: {
+                content: response.content,
+                toolCalls: response.toolCalls?.map((tc, i) => ({
+                    id: tc.id ?? `call_mock_${Date.now()}_${i}`,
+                    name: tc.name,
+                    arguments: tc.arguments,
+                })),
+                thinking: response.thinking,
+            },
+            tokensInput: response.tokensInput ?? 0,
+            tokensOutput: response.tokensOutput ?? 0,
+        };
+    }
+    // ── Private ────────────────────────────────────────────────────────────────
+    nextResponse(request) {
+        const idx = Math.min(this.callCount, this.responses.length - 1);
+        const response = this.responses[idx];
+        response.onRequest?.(request);
+        this.callCount++;
+        return response;
+    }
+}
+exports.MockAdapter = MockAdapter;
+//# sourceMappingURL=mock.adapter.js.map

package/dist/adapters/llm/mock.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.adapter.js","sourceRoot":"","sources":["../../../src/adapters/llm/mock.adapter.ts"],"names":[],"mappings":";;;AAoCA;;;;;;;;;;;;;GAaG;AACH,MAAa,WAAW;IAKO;IAJrB,SAAS,GAAG,CAAC,CAAC;IACL,SAAS,CAAiB;IAC1B,MAAM,CAAiB;IAExC,YAA6B,SAA4B,EAAE;QAA9B,WAAM,GAAN,MAAM,CAAwB;QACzD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,IAAI,gBAAgB,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,qEAAqE;IACrE,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,0DAA0D;IAC1D,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAA6B;QAC3C,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,UAAU,EAAE,IAAI;YAChB,eAAe,EAAE,IAAI,CAAC,MAAM;YAC5B,YAAY,EAAE;gBACZ,gBAAgB,EAAE,IAAI;gBACtB,aAAa,EAAE,IAAI;gBACnB,iBAAiB,EAAE,IAAI;gBACvB,8BAA8B,EAAE,IAAI;aACrC;YACD,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAuB;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO;YACL,OAAO,EAAE;gBACP,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7C,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,aAAa,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE;oBAC3C,IAAI,EAAE,EAAE,CAAC,IAAI;oBACb,SAAS,EAAE,EAAE,CAAC,SAAS;iBACxB,CAAC,CAAC;gBACH,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B;YACD,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,CAAC;YACtC,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,CAAC;SACzC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CACd,OAAuB,EACvB,OAAwC;QAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAE5C,iCAAiC;QACjC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC;gBACN,aAAa,EAAE,QAAQ,CAAC,QAAQ;gBAChC,YAAY,EAAE,QAAQ,CAAC,QAAQ;gBAC/B,WAAW,EAAE,EAAE;gBACf,IAAI,EAAE,KAAK;aACZ,CAAC,CAAC;QACL,CAAC;QAED,mEAAmE;QACnE,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YAC3D,WAAW,IAAI,KAAK,CAAC;YACrB,OAAO,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvD,OAAO;YACL,OAAO,EAAE;gBACP,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7C,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,aAAa,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE;oBAC3C,IAAI,EAAE,EAAE,CAAC,IAAI;oBACb,SAAS,EAAE,EAAE,CAAC,SAAS;iBACxB,CAAC,CAAC;gBACH,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B;YACD,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,CAAC;YACtC,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,CAAC;SACzC,CAAC;IACJ,CAAC;IAED,8EAA8E;IAEtE,YAAY,CAAC,OAAuB;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAE,CAAC;QACtC,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AA3GD,kCA2GC"}

package/dist/adapters/llm/model-profiles.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Model profile registry.
+ *
+ * Centralises per-model-family behaviour so the OpenAI adapter doesn't need
+ * scattered `includes("deepseek")` / `includes("qwen")` / `startsWith("o1")`
+ * checks.  Add a new entry here when you add a new model family.
+ *
+ * ## Thinking/CoT strategies
+ *
+ * | `thinkingMode`           | API parameter sent                                |
+ * |-------------------------|---------------------------------------------------|
+ * | `"reasoning-boolean"`   | `{ "reasoning": true }`  (only when thinking=on)  |
+ * | `"reasoning-effort"`    | `{ "reasoning_effort": "medium" }`                |
+ * | `"deepseek-thinking"`   | `{ "thinking": { "type": "enabled"/"disabled" } }`|
+ * | `null`                  | Nothing sent — vLLM models use default behaviour  |
+ *
+ * ## reasoning_content passthrough
+ *
+ * DeepSeek's thinking mode requires `reasoning_content` to be round-tripped
+ * in assistant messages when tool calls are present.  The adapter sets
+ * `preservesReasoningContent: true` for families that need this.
+ */
+export interface ModelProfile {
+    /** Human-readable family name for logging / debugging */
+    family: string;
+    /** How to signal thinking/reasoning in the API request body.
+     *  null = model handles it by default (vLLM), don't send any param. */
+    thinkingMode: null | "reasoning-boolean" | "reasoning-effort" | "deepseek-thinking";
+    /** True when the model is served via vLLM and breaks with `reasoning` param. */
+    vllm?: boolean;
+    /** True when vision / multimodal inputs are supported. */
+    vision?: boolean;
+    /** True when the model requires `reasoning_content` to be preserved and
+     *  passed back in subsequent assistant messages (DeepSeek thinking mode). */
+    preservesReasoningContent?: boolean;
+}
+/**
+ * Resolve the profile for a model by name.
+ * Falls back to {@link DEFAULT_PROFILE} when no pattern matches.
+ */
+export declare function resolveModelProfile(modelName: string): ModelProfile;
+//# sourceMappingURL=model-profiles.d.ts.map

package/dist/adapters/llm/model-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-profiles.d.ts","sourceRoot":"","sources":["../../../src/adapters/llm/model-profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IAEf;2EACuE;IACvE,YAAY,EAAE,IAAI,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;IAEpF,gFAAgF;IAChF,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;iFAC6E;IAC7E,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAsFD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAMnE"}