pulseed 0.4.18 → 0.4.20

package/dist/base/llm/openai-client.js

@@ -0,0 +1,246 @@
+import OpenAI from "openai";
+import { BaseLLMClient, DEFAULT_MAX_TOKENS, DEFAULT_LLM_TIMEOUT_MS, MAX_RETRY_ATTEMPTS, RETRY_DELAYS_MS, RATE_LIMIT_RETRY_DELAYS_MS, isRateLimitError, getRateLimitRetryDelay } from "./base-llm-client.js";
+import { sleep } from "../utils/sleep.js";
+import { LLMError } from "../utils/errors.js";
+// ─── Constants ───
+const DEFAULT_MODEL = "gpt-4o";
+const DEFAULT_TEMPERATURE = 0.2;
+/** Model prefixes that do not support the temperature parameter */
+const REASONING_MODEL_PREFIXES = ["o1", "o3", "o4"];
+function isReasoningModel(model) {
+    return REASONING_MODEL_PREFIXES.some((prefix) => model.startsWith(prefix));
+}
+function shouldFallbackToResponses(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return (msg.includes("not a chat model") ||
+        msg.includes("v1/chat/completions") ||
+        msg.includes("Did you mean to use v1/completions"));
+}
+/**
+ * LLM client for OpenAI.
+ *
+ * Primary path: Chat Completions API.
+ * Fallback: Responses API when the selected model is not compatible with
+ * /v1/chat/completions (e.g., some Codex-style models).
+ *
+ * Set PULSEED_LLM_PROVIDER=openai to activate via CLIRunner.
+ * Optionally set OPENAI_API_KEY, OPENAI_MODEL, and OPENAI_BASE_URL to configure.
+ */
+export class OpenAILLMClient extends BaseLLMClient {
+    client;
+    model;
+    constructor(config = {}) {
+        super();
+        if (!config.apiKey) {
+            throw new LLMError("OpenAILLMClient: no API key provided. Pass apiKey to constructor.");
+        }
+        this.model = config.model ?? DEFAULT_MODEL;
+        this.client = new OpenAI({
+            apiKey: config.apiKey,
+            ...(config.baseURL ? { baseURL: config.baseURL } : {}),
+        });
+        this.lightModel = config.lightModel;
+    }
+    /**
+     * Send a message to the OpenAI chat completions API with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff on network errors.
+     * Retries up to RATE_LIMIT_RETRY_DELAYS_MS.length times on HTTP 429 with extended backoff.
+     *
+     * For reasoning models (o1, o3, o4), temperature is omitted as it is not supported.
+     * System prompt is sent as a "developer" role message, prepended to the messages array.
+     */
+    async sendMessage(messages, options) {
+        const model = this.resolveEffectiveModel(options?.model ?? this.model, options?.model_tier);
+        const max_tokens = options?.max_tokens ?? DEFAULT_MAX_TOKENS;
+        const temperature = options?.temperature ?? DEFAULT_TEMPERATURE;
+        const system = options?.system;
+        // Build OpenAI messages array
+        const openAiMessages = [];
+        if (system) {
+            openAiMessages.push({ role: "developer", content: system });
+        }
+        for (const msg of messages) {
+            openAiMessages.push({ role: msg.role, content: msg.content });
+        }
+        // Reasoning models do not accept the temperature parameter
+        const createParams = {
+            model,
+            messages: openAiMessages,
+            max_completion_tokens: max_tokens,
+            ...(options?.tools?.length
+                ? {
+                    tools: options.tools.map((tool) => ({
+                        type: "function",
+                        function: {
+                            name: tool.function.name,
+                            description: tool.function.description,
+                            parameters: tool.function.parameters,
+                        },
+                    })),
+                }
+                : {}),
+            ...(isReasoningModel(model) ? {} : { temperature }),
+        };
+        let lastError;
+        let normalAttempts = 0;
+        let rateLimitAttempts = 0;
+        while (normalAttempts < MAX_RETRY_ATTEMPTS) {
+            try {
+                try {
+                    const response = await this.client.chat.completions.create(createParams, { timeout: DEFAULT_LLM_TIMEOUT_MS });
+                    const choice = response.choices[0];
+                    const content = choice?.message.content ?? "";
+                    const stop_reason = choice?.finish_reason ?? "unknown";
+                    const tool_calls = mapOpenAIToolCalls(choice?.message.tool_calls);
+                    return {
+                        content,
+                        usage: {
+                            input_tokens: response.usage?.prompt_tokens ?? 0,
+                            output_tokens: response.usage?.completion_tokens ?? 0,
+                        },
+                        stop_reason,
+                        ...(tool_calls && tool_calls.length > 0 ? { tool_calls } : {}),
+                    };
+                }
+                catch (err) {
+                    // Some models (notably Codex-style) are not compatible with the
+                    // chat completions endpoint. In that case, fall back to Responses API.
+                    if (!shouldFallbackToResponses(err))
+                        throw err;
+                    return this.sendViaResponsesApi(model, messages, { max_tokens, temperature, system });
+                }
+            }
+            catch (err) {
+                lastError = err;
+                // Rate limit: retry with extended backoff (does not count against normalAttempts)
+                if (isRateLimitError(err) && rateLimitAttempts < RATE_LIMIT_RETRY_DELAYS_MS.length) {
+                    await sleep(getRateLimitRetryDelay(err, rateLimitAttempts));
+                    rateLimitAttempts++;
+                    continue;
+                }
+                // Only retry on network/transient errors, not on HTTP 4xx client errors (excluding 429)
+                const isNetworkError = err instanceof TypeError ||
+                    (err instanceof Error &&
+                        !err.message.startsWith("OpenAILLMClient: HTTP 4"));
+                normalAttempts++;
+                if (normalAttempts < MAX_RETRY_ATTEMPTS && isNetworkError) {
+                    await sleep(RETRY_DELAYS_MS[normalAttempts - 1] ?? 1000);
+                }
+                else if (!isNetworkError) {
+                    throw err;
+                }
+            }
+        }
+        throw lastError;
+    }
+    async sendMessageStream(messages, options, handlers) {
+        const model = this.resolveEffectiveModel(options?.model ?? this.model, options?.model_tier);
+        const max_tokens = options?.max_tokens ?? DEFAULT_MAX_TOKENS;
+        const temperature = options?.temperature ?? DEFAULT_TEMPERATURE;
+        const system = options?.system;
+        const openAiMessages = [];
+        if (system) {
+            openAiMessages.push({ role: "developer", content: system });
+        }
+        for (const msg of messages) {
+            openAiMessages.push({ role: msg.role, content: msg.content });
+        }
+        const createParams = {
+            model,
+            messages: openAiMessages,
+            max_completion_tokens: max_tokens,
+            stream: true,
+            ...(options?.tools?.length
+                ? {
+                    tools: options.tools.map((tool) => ({
+                        type: "function",
+                        function: {
+                            name: tool.function.name,
+                            description: tool.function.description,
+                            parameters: tool.function.parameters,
+                        },
+                    })),
+                }
+                : {}),
+            ...(isReasoningModel(model) ? {} : { temperature }),
+        };
+        try {
+            const stream = this.client.chat.completions.stream(createParams, { timeout: DEFAULT_LLM_TIMEOUT_MS });
+            stream.on("content", (delta) => {
+                handlers.onTextDelta?.(delta);
+            });
+            const [completion, message] = await Promise.all([
+                stream.finalChatCompletion(),
+                stream.finalMessage(),
+            ]);
+            const tool_calls = mapOpenAIToolCalls(message.tool_calls);
+            return {
+                content: message.content ?? "",
+                usage: {
+                    input_tokens: completion.usage?.prompt_tokens ?? 0,
+                    output_tokens: completion.usage?.completion_tokens ?? 0,
+                },
+                stop_reason: completion.choices[0]?.finish_reason ?? "unknown",
+                ...(tool_calls.length > 0 ? { tool_calls } : {}),
+            };
+        }
+        catch (err) {
+            if (!shouldFallbackToResponses(err))
+                throw err;
+            return this.sendViaResponsesApi(model, messages, { max_tokens, temperature, system });
+        }
+    }
+    async sendViaResponsesApi(model, messages, options) {
+        const input = [
+            options.system ? `SYSTEM:\n${options.system}` : null,
+            ...messages.map((m) => `${m.role.toUpperCase()}:\n${m.content}`),
+        ]
+            .filter(Boolean)
+            .join("\n\n");
+        // Use Responses API (SDK supports this as of openai v4+).
+        // The TypeScript types for the Responses API are not yet in the openai
+        // package typings, so we cast through unknown to access this endpoint.
+        const responsesApi = this.client.responses;
+        let timer;
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new LLMError(`OpenAILLMClient: Responses API timed out after ${DEFAULT_LLM_TIMEOUT_MS}ms`)), DEFAULT_LLM_TIMEOUT_MS);
+        });
+        const resp = await Promise.race([
+            responsesApi.create({
+                model,
+                input,
+                max_output_tokens: options.max_tokens,
+                ...(isReasoningModel(model) ? {} : { temperature: options.temperature }),
+            }),
+            timeout,
+        ]);
+        clearTimeout(timer);
+        const content = typeof resp["output_text"] === "string"
+            ? resp["output_text"]
+            : "";
+        const usage = resp["usage"];
+        return {
+            content,
+            usage: {
+                input_tokens: typeof usage?.["input_tokens"] === "number" ? usage["input_tokens"] : 0,
+                output_tokens: typeof usage?.["output_tokens"] === "number" ? usage["output_tokens"] : 0,
+            },
+            stop_reason: typeof resp["status"] === "string" ? resp["status"] : "unknown",
+        };
+    }
+}
+function mapOpenAIToolCalls(toolCalls) {
+    if (!toolCalls?.length)
+        return [];
+    return toolCalls
+        .filter((call) => !("type" in call) || call.type === "function")
+        .map((call) => ({
+        id: call.id,
+        type: "function",
+        function: {
+            name: call.function.name,
+            arguments: call.function.arguments,
+        },
+    }));
+}
+//# sourceMappingURL=openai-client.js.map

package/dist/base/llm/openai-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-client.js","sourceRoot":"","sources":["../../../src/base/llm/openai-client.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,eAAe,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE5M,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,oBAAoB;AAEpB,MAAM,aAAa,GAAG,QAAQ,CAAC;AAC/B,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,mEAAmE;AACnE,MAAM,wBAAwB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEpD,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,yBAAyB,CAAC,GAAY;IAC7C,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,CACL,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAChC,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QACnC,GAAG,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CACnD,CAAC;AACJ,CAAC;AAeD;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAC/B,MAAM,CAAS;IACf,KAAK,CAAS;IAE/B,YAAY,SAA6B,EAAE;QACzC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,QAAQ,CAChB,mEAAmE,CACpE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACtC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,CACf,QAAsB,EACtB,OAA2B;QAE3B,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAC5F,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,kBAAkB,CAAC;QAC7D,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,mBAAmB,CAAC;QAChE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAE/B,8BAA8B;QAC9B,MAAM,cAAc,GAA6C,EAAE,CAAC;QACpE,IAAI,MAAM,EAAE,CAAC;YACX,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,2DAA2D;QAC3D,MAAM,YAAY,GAAuD;YACvE,KAAK;YACL,QAAQ,EAAE,cAAc;YACxB,qBAAqB,EAAE,UAAU;YACjC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM;gBACxB,CAAC,CAAC;oBACE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBAClC,IAAI,EAAE,UAAmB;wBACzB,QAAQ,EAAE;4BACR,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;4BACxB,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW;4BACtC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAuC;yBAClE;qBACF,CAAC,CAAC;iBACJ;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;SACpD,CAAC;QAEF,IAAI,SAAkB,CAAC;QACvB,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAE1B,OAAO,cAAc,GAAG,kBAAkB,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;oBAE9G,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBACnC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;oBAC9C,MAAM,WAAW,GAAG,MAAM,EAAE,aAAa,IAAI,SAAS,CAAC;oBACvD,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;oBAElE,OAAO;wBACL,OAAO;wBACP,KAAK,EAAE;4BACL,YAAY,EAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;4BAChD,aAAa,EAAE,QAAQ,CAAC,KAAK,EAAE,iBAAiB,IAAI,CAAC;yBACtD;wBACD,WAAW;wBACX,GAAG,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC/D,CAAC;gBACJ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,gEAAgE;oBAChE,uEAAuE;oBACvE,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;wBAAE,MAAM,GAAG,CAAC;oBAC/C,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;gBACxF,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,CAAC;gBAChB,kFAAkF;gBAClF,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,iBAAiB,GAAG,0BAA0B,CAAC,MAAM,EAAE,CAAC;oBACnF,MAAM,KAAK,CAAC,sBAAsB,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC;oBAC5D,iBAAiB,EAAE,CAAC;oBACpB,SAAS;gBACX,CAAC;gBACD,wFAAwF;gBACxF,MAAM,cAAc,GAClB,GAAG,YAAY,SAAS;oBACxB,CAAC,GAAG,YAAY,KAAK;wBACnB,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC,CAAC;gBAExD,cAAc,EAAE,CAAC;gBACjB,IAAI,cAAc,GAAG,kBAAkB,IAAI,cAAc,EAAE,CAAC;oBAC1D,MAAM,KAAK,CAAC,eAAe,CAAC,cAAc,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;gBAC3D,CAAC;qBAAM,IAAI,CAAC,cAAc,EAAE,CAAC;oBAC3B,MAAM,GAAG,CAAC;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,QAAsB,EACtB,OAAsC,EACtC,QAA2B;QAE3B,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAC5F,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,kBAAkB,CAAC;QAC7D,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,mBAAmB,CAAC;QAChE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAE/B,MAAM,cAAc,GAA6C,EAAE,CAAC;QACpE,IAAI,MAAM,EAAE,CAAC;YACX,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,YAAY,GAAoD;YACpE,KAAK;YACL,QAAQ,EAAE,cAAc;YACxB,qBAAqB,EAAE,UAAU;YACjC,MAAM,EAAE,IAAI;YACZ,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM;gBACxB,CAAC,CAAC;oBACE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBAClC,IAAI,EAAE,UAAmB;wBACzB,QAAQ,EAAE;4BACR,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;4BACxB,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW;4BACtC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAuC;yBAClE;qBACF,CAAC,CAAC;iBACJ;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;SACpD,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;YACtG,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAa,EAAE,EAAE;gBACrC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC9C,MAAM,CAAC,mBAAmB,EAAE;gBAC5B,MAAM,CAAC,YAAY,EAAE;aACtB,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAE1D,OAAO;gBACL,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;gBAC9B,KAAK,EAAE;oBACL,YAAY,EAAE,UAAU,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;oBAClD,aAAa,EAAE,UAAU,CAAC,KAAK,EAAE,iBAAiB,IAAI,CAAC;iBACxD;gBACD,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,aAAa,IAAI,SAAS;gBAC9D,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjD,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;gBAAE,MAAM,GAAG,CAAC;YAC/C,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,KAAa,EACb,QAAsB,EACtB,OAAqE;QAErE,MAAM,KAAK,GAAG;YACZ,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI;YACpD,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;SACjE;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,0DAA0D;QAC1D,uEAAuE;QACvE,uEAAuE;QACvE,MAAM,YAAY,GAAI,IAAI,CAAC,MAAsG,CAAC,SAAS,CAAC;QAC5I,IAAI,KAAoC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YAC/C,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,kDAAkD,sBAAsB,IAAI,CAAC,CAAC,EACxG,sBAAsB,CACvB,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAC9B,YAAY,CAAC,MAAM,CAAC;gBAClB,KAAK;gBACL,KAAK;gBACL,iBAAiB,EAAE,OAAO,CAAC,UAAU;gBACrC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;aACzE,CAAC;YACF,OAAO;SACR,CAA4B,CAAC;QAC9B,YAAY,CAAC,KAAM,CAAC,CAAC;QAErB,MAAM,OAAO,GACX,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,QAAQ;YACrC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;YACrB,CAAC,CAAC,EAAE,CAAC;QAET,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAwC,CAAC;QACnE,OAAO;YACL,OAAO;YACP,KAAK,EAAE;gBACL,YAAY,EAAE,OAAO,KAAK,EAAE,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrF,aAAa,EAAE,OAAO,KAAK,EAAE,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;aACzF;YACD,WAAW,EAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;SAC7E,CAAC;IACJ,CAAC;CACF;AAED,SAAS,kBAAkB,CACzB,SAAkE;IAElE,IAAI,CAAC,SAAS,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,SAAS;SACb,MAAM,CAAC,CAAC,IAAI,EAA6D,EAAE,CAC1E,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,CAC9C;SACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,UAAmB;QACzB,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YACxB,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS;SACnC;KACF,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/base/llm/provider-config.d.ts

@@ -0,0 +1,130 @@
+import type { AgentLoopSecurityConfig } from "../../orchestrator/execution/agent-loop/execution-policy.js";
+/** Check if a JWT access token is expired. Returns true if malformed or expired. */
+export declare function isJwtExpired(token: string): boolean;
+/** Read the OAuth access_token from ~/.codex/auth.json (written by `codex auth login`). */
+export declare function readCodexOAuthToken(): Promise<string | undefined>;
+/**
+ * Known models and their compatible providers/adapters.
+ * Ollama models are dynamic and not listed here.
+ */
+export declare const MODEL_REGISTRY: Record<string, {
+    provider: string;
+    adapters: string[];
+}>;
+export interface ProviderConfig {
+    /** Which provider to use for internal LLM calls */
+    provider: "openai" | "anthropic" | "ollama";
+    /** Which model to use */
+    model: string;
+    /** Optional lighter model for routine tasks (observation, verification, reflection).
+     *  When not set, all calls use `model`. */
+    light_model?: string;
+    /** Which adapter to use by default for task execution */
+    adapter: "claude_code_cli" | "claude_api" | "openai_codex_cli" | "openai_api" | "agent_loop";
+    /** API key (for openai or anthropic) */
+    api_key?: string;
+    /** Base URL (for ollama or custom endpoints) */
+    base_url?: string;
+    /** CLI path for openai_codex_cli adapter */
+    codex_cli_path?: string;
+    /** Optional terminal backend for CLI execution adapters. */
+    terminal_backend?: {
+        type: "local" | "docker";
+        docker?: {
+            image: string;
+            workdir?: string;
+            network?: "none" | "host" | "bridge";
+            env?: Record<string, string>;
+            volumes?: string[];
+        };
+    };
+    /** A2A protocol agent endpoints */
+    a2a?: {
+        agents?: Record<string, {
+            base_url: string;
+            auth_token?: string;
+            capabilities?: string[];
+            prefer_streaming?: boolean;
+            poll_interval_ms?: number;
+            max_wait_ms?: number;
+        }>;
+    };
+    /** Optional local-only OpenClaw ACP adapter configuration */
+    openclaw?: {
+        cli_path?: string;
+        profile?: string;
+        model?: string;
+        work_dir?: string;
+    };
+    /** Native agentloop runtime settings */
+    agent_loop?: {
+        security?: AgentLoopSecurityConfig;
+        worktree?: {
+            enabled?: boolean;
+            base_dir?: string;
+            keep_for_debug?: boolean;
+            cleanup_policy?: "on_success" | "always" | "never";
+        };
+    };
+}
+/** Old nested provider config format (for migration) */
+interface LegacyProviderConfig {
+    llm_provider: "anthropic" | "openai" | "ollama" | "codex";
+    default_adapter: "claude_code_cli" | "claude_api" | "openai_codex_cli" | "openai_api" | "agent_loop";
+    anthropic?: {
+        api_key?: string;
+        model?: string;
+    };
+    openai?: {
+        api_key?: string;
+        model?: string;
+        base_url?: string;
+    };
+    ollama?: {
+        base_url?: string;
+        model?: string;
+    };
+    codex?: {
+        cli_path?: string;
+        model?: string;
+    };
+    a2a?: ProviderConfig["a2a"];
+}
+declare const DEFAULT_PROVIDER_CONFIG: ProviderConfig;
+/**
+ * Migrate old nested format to new flat format.
+ */
+export declare function migrateProviderConfig(old: LegacyProviderConfig): ProviderConfig;
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate provider config for model/adapter compatibility and required fields.
+ * Logs warnings but does not throw — allows unknown models for flexibility.
+ */
+export declare function validateProviderConfig(config: ProviderConfig): ValidationResult;
+export interface LoadProviderConfigOptions {
+    baseDir?: string;
+    saveMigration?: boolean;
+}
+/**
+ * Load provider configuration.
+ *
+ * Priority (highest to lowest):
+ *   1. Environment variables for provider/adapter selection
+ *   2. ~/.pulseed/provider.json
+ *   3. Defaults (openai + gpt-5.4-mini + openai_codex_cli)
+ *
+ * Auto-migrates old nested format to new flat format.
+ */
+export declare function loadProviderConfig(options?: LoadProviderConfigOptions): Promise<ProviderConfig>;
+export declare function resolveOpenAIApiKey(): Promise<string | undefined>;
+export declare function getProviderRuntimeFingerprint(): Promise<string>;
+/**
+ * Save provider configuration to ~/.pulseed/provider.json.
+ * Creates the ~/.pulseed directory if it does not exist.
+ */
+export declare function saveProviderConfig(config: ProviderConfig): Promise<void>;
+export { DEFAULT_PROVIDER_CONFIG };
+//# sourceMappingURL=provider-config.d.ts.map

package/dist/base/llm/provider-config.d.ts.map

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