pulseed 0.0.1 → 0.1.1

package/dist/llm/openai-client.js

@@ -0,0 +1,146 @@
+import OpenAI from "openai";
+import { BaseLLMClient, DEFAULT_MAX_TOKENS, DEFAULT_LLM_TIMEOUT_MS, MAX_RETRY_ATTEMPTS, RETRY_DELAYS_MS } 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));
+}
+/**
+ * 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.
+     *
+     * 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,
+            ...(isReasoningModel(model) ? {} : { temperature }),
+        };
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRY_ATTEMPTS; attempt++) {
+            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";
+                    return {
+                        content,
+                        usage: {
+                            input_tokens: response.usage?.prompt_tokens ?? 0,
+                            output_tokens: response.usage?.completion_tokens ?? 0,
+                        },
+                        stop_reason,
+                    };
+                }
+                catch (err) {
+                    // Some models (notably Codex-style) are not compatible with the
+                    // chat completions endpoint. In that case, fall back to Responses API.
+                    const msg = err instanceof Error ? err.message : String(err);
+                    const shouldFallback = msg.includes("not a chat model") ||
+                        msg.includes("v1/chat/completions") ||
+                        msg.includes("Did you mean to use v1/completions");
+                    if (!shouldFallback)
+                        throw err;
+                    const input = [
+                        system ? `SYSTEM:\n${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: max_tokens,
+                            ...(isReasoningModel(model) ? {} : { 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",
+                    };
+                }
+            }
+            catch (err) {
+                lastError = err;
+                // Only retry on network/transient errors, not on HTTP 4xx client errors
+                const isNetworkError = err instanceof TypeError ||
+                    (err instanceof Error &&
+                        !err.message.startsWith("OpenAILLMClient: HTTP 4"));
+                if (attempt < MAX_RETRY_ATTEMPTS - 1 && isNetworkError) {
+                    await sleep(RETRY_DELAYS_MS[attempt] ?? 1000);
+                }
+                else if (!isNetworkError) {
+                    throw err;
+                }
+            }
+        }
+        throw lastError;
+    }
+}
+//# sourceMappingURL=openai-client.js.map

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

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

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

@@ -0,0 +1,98 @@
+/**
+ * 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";
+    /** 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;
+    /** 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;
+        }>;
+    };
+    /** OpenClaw ACP adapter configuration */
+    openclaw?: {
+        cli_path?: string;
+        profile?: string;
+        model?: string;
+        work_dir?: string;
+    };
+}
+/** 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";
+    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;
+/**
+ * Load provider configuration.
+ *
+ * Priority (highest to lowest):
+ *   1. Environment variables (PULSEED_PROVIDER, PULSEED_ADAPTER, PULSEED_MODEL, etc.)
+ *   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(): Promise<ProviderConfig>;
+/**
+ * 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/llm/provider-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-config.d.ts","sourceRoot":"","sources":["../../src/llm/provider-config.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAOnF,CAAC;AAIF,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAE5C,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IAEd;+CAC2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,yDAAyD;IACzD,OAAO,EAAE,iBAAiB,GAAG,YAAY,GAAG,kBAAkB,GAAG,YAAY,CAAC;IAE9E,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,mCAAmC;IACnC,GAAG,CAAC,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YACtB,QAAQ,EAAE,MAAM,CAAC;YACjB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;YACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;YAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;YAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC,CAAC;KACJ,CAAC;IAEF,yCAAyC;IACzC,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,wDAAwD;AACxD,UAAU,oBAAoB;IAC5B,YAAY,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC1D,eAAe,EAAE,iBAAiB,GAAG,YAAY,GAAG,kBAAkB,GAAG,YAAY,CAAC;IACtF,SAAS,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,GAAG,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;CAC7B;AAMD,QAAA,MAAM,uBAAuB,EAAE,cAI9B,CAAC;AAyBF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,oBAAoB,GAAG,cAAc,CA0C/E;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAyB/E;AAuFD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CA4ElE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E;AAGD,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/llm/provider-config.js

@@ -0,0 +1,280 @@
+// ─── Provider Configuration ───
+//
+// Pluggable provider configuration system for PulSeed.
+// Reads/writes ~/.pulseed/provider.json to configure which LLM provider
+// and default adapter to use. Env vars always take precedence over config file.
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { getPulseedDirPath } from "../utils/paths.js";
+import { writeJsonFileAtomic } from "../utils/json-io.js";
+// ─── Model Registry ───
+/**
+ * Known models and their compatible providers/adapters.
+ * Ollama models are dynamic and not listed here.
+ */
+export const MODEL_REGISTRY = {
+    "gpt-5.4-mini": { provider: "openai", adapters: ["openai_codex_cli", "openai_api"] },
+    "gpt-4.1": { provider: "openai", adapters: ["openai_codex_cli", "openai_api"] },
+    "gpt-4o-mini": { provider: "openai", adapters: ["openai_api"] },
+    "o3-mini": { provider: "openai", adapters: ["openai_api"] },
+    "claude-sonnet-4-6": { provider: "anthropic", adapters: ["claude_code_cli", "claude_api"] },
+    "claude-haiku-4-5": { provider: "anthropic", adapters: ["claude_code_cli", "claude_api"] },
+};
+// ─── Constants ───
+const PROVIDER_CONFIG_PATH = path.join(getPulseedDirPath(), "provider.json");
+const DEFAULT_PROVIDER_CONFIG = {
+    provider: "openai",
+    model: "gpt-5.4-mini",
+    adapter: "openai_codex_cli",
+};
+// Track whether we've already warned about provider config issues in this process
+let _warnedOnce = false;
+// ─── Helpers ───
+/** Default model for a given provider. Single source of truth. */
+function defaultModelForProvider(provider) {
+    switch (provider) {
+        case "anthropic": return "claude-sonnet-4-6";
+        case "ollama": return "qwen3:4b";
+        default: return "gpt-5.4-mini";
+    }
+}
+// ─── Migration ───
+/**
+ * Detect whether a config object is in the old nested format.
+ */
+function isLegacyConfig(config) {
+    return "llm_provider" in config || "default_adapter" in config;
+}
+/**
+ * Migrate old nested format to new flat format.
+ */
+export function migrateProviderConfig(old) {
+    const provider = old.llm_provider === "codex" ? "openai" : (old.llm_provider ?? "openai");
+    // Resolve model from the provider-specific section
+    let model;
+    switch (old.llm_provider) {
+        case "codex":
+            model = old.codex?.model ?? old.openai?.model ?? defaultModelForProvider(provider);
+            break;
+        case "openai":
+            model = old.openai?.model ?? defaultModelForProvider(provider);
+            break;
+        case "anthropic":
+            model = old.anthropic?.model ?? defaultModelForProvider(provider);
+            break;
+        case "ollama":
+            model = old.ollama?.model ?? defaultModelForProvider(provider);
+            break;
+        default:
+            model = defaultModelForProvider(provider);
+    }
+    const adapter = old.default_adapter ?? "openai_codex_cli";
+    // Resolve api_key from the active provider section
+    const api_key = old.llm_provider === "anthropic"
+        ? old.anthropic?.api_key
+        : (old.openai?.api_key);
+    // Resolve base_url
+    const base_url = old.llm_provider === "ollama"
+        ? old.ollama?.base_url
+        : old.openai?.base_url;
+    const result = { provider, model, adapter };
+    if (api_key !== undefined)
+        result.api_key = api_key;
+    if (base_url !== undefined)
+        result.base_url = base_url;
+    if (old.codex?.cli_path !== undefined)
+        result.codex_cli_path = old.codex.cli_path;
+    if (old.a2a !== undefined)
+        result.a2a = old.a2a;
+    return result;
+}
+/**
+ * Validate provider config for model/adapter compatibility and required fields.
+ * Logs warnings but does not throw — allows unknown models for flexibility.
+ */
+export function validateProviderConfig(config) {
+    const errors = [];
+    // Check model-adapter compatibility (skip for ollama or unknown models)
+    const registryEntry = MODEL_REGISTRY[config.model];
+    if (registryEntry) {
+        if (registryEntry.provider !== config.provider) {
+            errors.push(`Model "${config.model}" requires provider "${registryEntry.provider}" but got "${config.provider}"`);
+        }
+        if (!registryEntry.adapters.includes(config.adapter)) {
+            errors.push(`Model "${config.model}" is not compatible with adapter "${config.adapter}". Compatible: ${registryEntry.adapters.join(", ")}`);
+        }
+    }
+    // Check required api_key
+    if ((config.provider === "openai" || config.provider === "anthropic") && !config.api_key) {
+        const envName = config.provider === "openai" ? "OPENAI_API_KEY" : "ANTHROPIC_API_KEY";
+        errors.push(`API key required for provider "${config.provider}". Set ${envName} or add api_key to config.`);
+    }
+    return { valid: errors.length === 0, errors };
+}
+// ─── Env Var Resolution ───
+function resolveProvider(fileProvider) {
+    const envProvider = process.env["PULSEED_PROVIDER"] ?? process.env["PULSEED_LLM_PROVIDER"];
+    if (envProvider === "anthropic" || envProvider === "openai" || envProvider === "ollama") {
+        return envProvider;
+    }
+    // "codex" env var maps to "openai"
+    if (envProvider === "codex") {
+        return "openai";
+    }
+    return fileProvider ?? "openai";
+}
+function resolveAdapter(fileAdapter) {
+    const envAdapter = process.env["PULSEED_ADAPTER"] ?? process.env["PULSEED_DEFAULT_ADAPTER"];
+    if (envAdapter === "claude_code_cli" ||
+        envAdapter === "claude_api" ||
+        envAdapter === "openai_codex_cli" ||
+        envAdapter === "openai_api") {
+        return envAdapter;
+    }
+    return fileAdapter ?? "openai_codex_cli";
+}
+function resolveModel(fileModel, provider) {
+    const envModel = process.env["PULSEED_MODEL"];
+    if (envModel)
+        return envModel;
+    // provider.json explicit value takes priority over generic env vars
+    if (fileModel)
+        return fileModel;
+    // Provider-specific env vars apply only as fallback when model is not set in provider.json
+    if (provider === "openai") {
+        const m = process.env["OPENAI_MODEL"];
+        if (m)
+            return m;
+    }
+    else if (provider === "anthropic") {
+        const m = process.env["ANTHROPIC_MODEL"];
+        if (m)
+            return m;
+    }
+    else if (provider === "ollama") {
+        const m = process.env["OLLAMA_MODEL"];
+        if (m)
+            return m;
+    }
+    return defaultModelForProvider(provider);
+}
+function resolveApiKey(fileKey, provider) {
+    if (provider === "anthropic") {
+        return process.env["ANTHROPIC_API_KEY"] ?? fileKey;
+    }
+    // openai (and codex) both use OPENAI_API_KEY
+    if (provider === "openai") {
+        return process.env["OPENAI_API_KEY"] ?? fileKey;
+    }
+    return fileKey;
+}
+function resolveBaseUrl(fileUrl, provider) {
+    if (provider === "ollama") {
+        return process.env["OLLAMA_BASE_URL"] ?? fileUrl;
+    }
+    if (provider === "openai") {
+        return process.env["OPENAI_BASE_URL"] ?? fileUrl;
+    }
+    return fileUrl;
+}
+// ─── Public API ───
+/**
+ * Load provider configuration.
+ *
+ * Priority (highest to lowest):
+ *   1. Environment variables (PULSEED_PROVIDER, PULSEED_ADAPTER, PULSEED_MODEL, etc.)
+ *   2. ~/.pulseed/provider.json
+ *   3. Defaults (openai + gpt-5.4-mini + openai_codex_cli)
+ *
+ * Auto-migrates old nested format to new flat format.
+ */
+export async function loadProviderConfig() {
+    let fileConfig = {};
+    let needsMigrationSave = false;
+    try {
+        await fsp.access(PROVIDER_CONFIG_PATH);
+        try {
+            const raw = await fsp.readFile(PROVIDER_CONFIG_PATH, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (isLegacyConfig(parsed)) {
+                fileConfig = migrateProviderConfig(parsed);
+                needsMigrationSave = true;
+            }
+            else {
+                fileConfig = parsed;
+            }
+        }
+        catch {
+            fileConfig = {};
+        }
+    }
+    catch {
+        // File does not exist
+    }
+    const provider = resolveProvider(fileConfig.provider);
+    let model = resolveModel(fileConfig.model, provider);
+    const adapter = resolveAdapter(fileConfig.adapter);
+    // Auto-correct model-adapter incompatibility (e.g. OPENAI_MODEL=gpt-4o-mini with openai_codex_cli)
+    const registryEntry = MODEL_REGISTRY[model];
+    if (registryEntry && !registryEntry.adapters.includes(adapter)) {
+        const fallback = defaultModelForProvider(provider);
+        console.warn(`[provider-config] Model "${model}" is not compatible with adapter "${adapter}". Falling back to "${fallback}".`);
+        model = fallback;
+    }
+    const api_key = resolveApiKey(fileConfig.api_key, provider);
+    const base_url = resolveBaseUrl(fileConfig.base_url, provider);
+    const config = { provider, model, adapter };
+    if (api_key !== undefined)
+        config.api_key = api_key;
+    if (base_url !== undefined)
+        config.base_url = base_url;
+    if (fileConfig.codex_cli_path !== undefined)
+        config.codex_cli_path = fileConfig.codex_cli_path;
+    if (fileConfig.a2a !== undefined)
+        config.a2a = fileConfig.a2a;
+    if (fileConfig.light_model !== undefined)
+        config.light_model = fileConfig.light_model;
+    if (fileConfig.openclaw !== undefined)
+        config.openclaw = fileConfig.openclaw;
+    // Validate and log warnings (only once per process)
+    const validation = validateProviderConfig(config);
+    if (!validation.valid && !_warnedOnce) {
+        for (const err of validation.errors) {
+            console.warn(`[provider-config] Warning: ${err}`);
+        }
+        _warnedOnce = true;
+    }
+    // Auto-save migrated config (save file-only values, not env-var-resolved ones)
+    if (needsMigrationSave) {
+        try {
+            const fileOnly = {
+                provider: fileConfig.provider ?? "openai",
+                model: fileConfig.model ?? "gpt-5.4-mini",
+                adapter: fileConfig.adapter ?? "openai_codex_cli",
+            };
+            if (fileConfig.api_key !== undefined)
+                fileOnly.api_key = fileConfig.api_key;
+            if (fileConfig.base_url !== undefined)
+                fileOnly.base_url = fileConfig.base_url;
+            if (fileConfig.codex_cli_path !== undefined)
+                fileOnly.codex_cli_path = fileConfig.codex_cli_path;
+            if (fileConfig.a2a !== undefined)
+                fileOnly.a2a = fileConfig.a2a;
+            await saveProviderConfig(fileOnly);
+        }
+        catch {
+            // Best-effort — don't fail if we can't save
+        }
+    }
+    return config;
+}
+/**
+ * Save provider configuration to ~/.pulseed/provider.json.
+ * Creates the ~/.pulseed directory if it does not exist.
+ */
+export async function saveProviderConfig(config) {
+    await writeJsonFileAtomic(PROVIDER_CONFIG_PATH, config);
+}
+// Re-export default for tests that need it
+export { DEFAULT_PROVIDER_CONFIG };
+//# sourceMappingURL=provider-config.js.map

package/dist/llm/provider-config.js.map

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

package/dist/llm/provider-factory.d.ts

@@ -0,0 +1,24 @@
+import { type ILLMClient } from "./llm-client.js";
+import { AdapterRegistry } from "../execution/adapter-layer.js";
+import type { ProviderConfig } from "./provider-config.js";
+/**
+ * Build an LLM client based on provider configuration.
+ *
+ * Configuration priority (highest to lowest):
+ *   1. PULSEED_PROVIDER environment variable
+ *   2. ~/.pulseed/provider.json provider field
+ *   3. Default: OpenAI
+ *
+ * Providers:
+ *   - "anthropic" → LLMClient (api_key required)
+ *   - "openai"    → OpenAILLMClient or CodexLLMClient depending on adapter
+ *   - "ollama"    → OllamaLLMClient
+ */
+export declare function buildLLMClient(): Promise<ILLMClient>;
+/**
+ * Build an AdapterRegistry pre-populated with the standard adapters.
+ * Registers ClaudeCodeCLIAdapter, ClaudeAPIAdapter, OpenAICodexCLIAdapter, GitHubIssueAdapter,
+ * and any A2A agents configured in provider config or environment variables.
+ */
+export declare function buildAdapterRegistry(llmClient: ILLMClient, providerConfig?: ProviderConfig): Promise<AdapterRegistry>;
+//# sourceMappingURL=provider-factory.d.ts.map

package/dist/llm/provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.d.ts","sourceRoot":"","sources":["../../src/llm/provider-factory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAQhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CA6D1D;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,UAAU,EACrB,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,eAAe,CAAC,CAoD1B"}