conatus 0.1.0

package/dist/llm/ollama-client.js

@@ -0,0 +1,94 @@
+import { BaseLLMClient, DEFAULT_MAX_TOKENS } from "./base-llm-client.js";
+import { sleep } from "../utils/sleep.js";
+import { LLMError } from "../utils/errors.js";
+// ─── Constants ───
+const DEFAULT_MODEL = "qwen3:4b";
+const DEFAULT_TEMPERATURE = 0;
+const MAX_RETRY_ATTEMPTS = 3;
+/** Exponential backoff delays in milliseconds: 1s, 2s, 4s */
+const RETRY_DELAYS_MS = [1000, 2000, 4000];
+/**
+ * LLM client for Ollama's OpenAI-compatible API.
+ * Uses native fetch (Node 18+) — no extra dependencies.
+ *
+ * Set CONATUS_LLM_PROVIDER=ollama to activate via CLIRunner.
+ * Optionally set OLLAMA_BASE_URL and OLLAMA_MODEL to configure.
+ */
+export class OllamaLLMClient extends BaseLLMClient {
+    baseUrl;
+    model;
+    constructor(config) {
+        super();
+        this.baseUrl = config.baseUrl.replace(/\/$/, ""); // strip trailing slash
+        this.model = config.model ?? DEFAULT_MODEL;
+    }
+    /**
+     * Send a message to Ollama's OpenAI-compatible chat completions endpoint.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff on network errors.
+     */
+    async sendMessage(messages, options) {
+        const model = options?.model ?? this.model;
+        const max_tokens = options?.max_tokens ?? DEFAULT_MAX_TOKENS;
+        const temperature = options?.temperature ?? DEFAULT_TEMPERATURE;
+        const system = options?.system;
+        // Build OpenAI-format messages array
+        const openAiMessages = [];
+        if (system) {
+            openAiMessages.push({ role: "system", content: system });
+        }
+        for (const msg of messages) {
+            openAiMessages.push({ role: msg.role, content: msg.content });
+        }
+        const body = JSON.stringify({
+            model,
+            messages: openAiMessages,
+            max_tokens,
+            temperature,
+            stream: false,
+        });
+        const url = `${this.baseUrl}/v1/chat/completions`;
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRY_ATTEMPTS; attempt++) {
+            try {
+                const response = await fetch(url, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                    },
+                    body,
+                });
+                if (!response.ok) {
+                    const errorText = await response.text().catch(() => "(no body)");
+                    throw new LLMError(`OllamaLLMClient: HTTP ${response.status} ${response.statusText} — ${errorText}`);
+                }
+                const data = (await response.json());
+                const choice = data.choices?.[0];
+                const content = choice?.message?.content ?? "";
+                const stop_reason = choice?.finish_reason ?? "unknown";
+                return {
+                    content,
+                    usage: {
+                        input_tokens: data.usage?.prompt_tokens ?? 0,
+                        output_tokens: data.usage?.completion_tokens ?? 0,
+                    },
+                    stop_reason,
+                };
+            }
+            catch (err) {
+                lastError = err;
+                // Only retry on network/fetch errors, not on HTTP 4xx client errors
+                const isNetworkError = err instanceof TypeError ||
+                    (err instanceof Error &&
+                        !err.message.startsWith("OllamaLLMClient: HTTP 4"));
+                if (attempt < MAX_RETRY_ATTEMPTS - 1 && isNetworkError) {
+                    await sleep(RETRY_DELAYS_MS[attempt] ?? 1000);
+                }
+                else if (!isNetworkError) {
+                    throw err;
+                }
+            }
+        }
+        throw lastError;
+    }
+}
+//# sourceMappingURL=ollama-client.js.map

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

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

package/dist/llm/openai-client.d.ts

@@ -0,0 +1,34 @@
+import { BaseLLMClient } from "./base-llm-client.js";
+import { type ILLMClient, type LLMMessage, type LLMRequestOptions, type LLMResponse } from "./llm-client.js";
+export interface OpenAIClientConfig {
+    /** API key for OpenAI. Required. */
+    apiKey?: string;
+    /** Default: "gpt-4o" */
+    model?: string;
+    /** Optional base URL for Azure OpenAI or proxy endpoints */
+    baseURL?: string;
+}
+/**
+ * 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 CONATUS_LLM_PROVIDER=openai to activate via CLIRunner.
+ * Optionally set OPENAI_API_KEY, OPENAI_MODEL, and OPENAI_BASE_URL to configure.
+ */
+export declare class OpenAILLMClient extends BaseLLMClient implements ILLMClient {
+    private readonly client;
+    private readonly model;
+    constructor(config?: OpenAIClientConfig);
+    /**
+     * 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.
+     */
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+}
+//# sourceMappingURL=openai-client.d.ts.map

package/dist/llm/openai-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-client.d.ts","sourceRoot":"","sources":["../../src/llm/openai-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAsB,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAsB7G,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,aAAc,YAAW,UAAU;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,MAAM,GAAE,kBAAuB;IAc3C;;;;;;OAMG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;CAwGxB"}

package/dist/llm/openai-client.js

@@ -0,0 +1,140 @@
+import OpenAI from "openai";
+import { BaseLLMClient, DEFAULT_MAX_TOKENS } 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;
+const MAX_RETRY_ATTEMPTS = 3;
+/** Exponential backoff delays in milliseconds: 1s, 2s, 4s */
+const RETRY_DELAYS_MS = [1000, 2000, 4000];
+/** 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 CONATUS_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 } : {}),
+        });
+    }
+    /**
+     * 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 = options?.model ?? this.model;
+        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_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);
+                    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;
+                    const resp = await responsesApi.create({
+                        model,
+                        input,
+                        max_output_tokens: max_tokens,
+                        ...(isReasoningModel(model) ? {} : { temperature }),
+                    });
+                    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,55 @@
+export interface ProviderConfig {
+    /** Which provider to use for internal LLM calls (thinking/analysis) */
+    llm_provider: "anthropic" | "openai" | "ollama" | "codex";
+    /** Which adapter to use by default for task execution */
+    default_adapter: "claude_code_cli" | "claude_api" | "openai_codex_cli" | "openai_api";
+    /** Provider-specific settings (optional; env vars take precedence) */
+    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 protocol agent endpoints */
+    a2a?: {
+        /** Map of adapter name -> A2A agent endpoint config */
+        agents?: Record<string, {
+            base_url: string;
+            auth_token?: string;
+            capabilities?: string[];
+            prefer_streaming?: boolean;
+            poll_interval_ms?: number;
+            max_wait_ms?: number;
+        }>;
+    };
+}
+declare const DEFAULT_PROVIDER_CONFIG: ProviderConfig;
+/**
+ * Load provider configuration.
+ *
+ * Priority (highest to lowest):
+ *   1. Environment variables (CONATUS_LLM_PROVIDER, CONATUS_DEFAULT_ADAPTER, etc.)
+ *   2. ~/.conatus/provider.json
+ *   3. Defaults (codex + openai_codex_cli)
+ *
+ * If no provider.json exists, falls back to env vars and defaults (current behavior).
+ */
+export declare function loadProviderConfig(): Promise<ProviderConfig>;
+/**
+ * Save provider configuration to ~/.conatus/provider.json.
+ * Creates the ~/.conatus 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,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,YAAY,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAE1D,yDAAyD;IACzD,eAAe,EAAE,iBAAiB,GAAG,YAAY,GAAG,kBAAkB,GAAG,YAAY,CAAC;IAEtF,sEAAsE;IACtE,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,mCAAmC;IACnC,GAAG,CAAC,EAAE;QACJ,uDAAuD;QACvD,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;CACH;AAMD,QAAA,MAAM,uBAAuB,EAAE,cAG9B,CAAC;AAqCF;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CA8ElE;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,136 @@
+// ─── Provider Configuration ───
+//
+// Pluggable provider configuration system for Conatus.
+// Reads/writes ~/.conatus/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 { getMotivaDirPath } from "../utils/paths.js";
+import { writeJsonFileAtomic } from "../utils/json-io.js";
+// ─── Constants ───
+const PROVIDER_CONFIG_PATH = path.join(getMotivaDirPath(), "provider.json");
+const DEFAULT_PROVIDER_CONFIG = {
+    llm_provider: "codex",
+    default_adapter: "openai_codex_cli",
+};
+// ─── Helpers ───
+/**
+ * Determine LLM provider, with env var taking precedence over config file.
+ */
+function resolveProvider(fileProvider) {
+    const envProvider = process.env["CONATUS_LLM_PROVIDER"];
+    if (envProvider === "anthropic" || envProvider === "openai" || envProvider === "ollama" || envProvider === "codex") {
+        return envProvider;
+    }
+    return fileProvider ?? "codex";
+}
+/**
+ * Determine default adapter, with env var taking precedence over config file.
+ */
+function resolveAdapter(fileAdapter) {
+    const envAdapter = process.env["CONATUS_DEFAULT_ADAPTER"];
+    if (envAdapter === "claude_code_cli" ||
+        envAdapter === "claude_api" ||
+        envAdapter === "openai_codex_cli" ||
+        envAdapter === "openai_api") {
+        return envAdapter;
+    }
+    return fileAdapter ?? "openai_codex_cli";
+}
+// ─── Public API ───
+/**
+ * Load provider configuration.
+ *
+ * Priority (highest to lowest):
+ *   1. Environment variables (CONATUS_LLM_PROVIDER, CONATUS_DEFAULT_ADAPTER, etc.)
+ *   2. ~/.conatus/provider.json
+ *   3. Defaults (codex + openai_codex_cli)
+ *
+ * If no provider.json exists, falls back to env vars and defaults (current behavior).
+ */
+export async function loadProviderConfig() {
+    let fileConfig = {};
+    try {
+        await fsp.access(PROVIDER_CONFIG_PATH);
+        try {
+            const raw = await fsp.readFile(PROVIDER_CONFIG_PATH, "utf-8");
+            fileConfig = JSON.parse(raw);
+        }
+        catch {
+            // If the file is malformed, treat it as empty (fall back to env/defaults)
+            fileConfig = {};
+        }
+    }
+    catch {
+        // File does not exist — use env/defaults
+    }
+    // Build merged config: file values as base, env vars override
+    const config = {
+        llm_provider: resolveProvider(fileConfig.llm_provider),
+        default_adapter: resolveAdapter(fileConfig.default_adapter),
+    };
+    // Merge anthropic section — env vars override file values
+    const anthropicApiKey = process.env["ANTHROPIC_API_KEY"] ?? fileConfig.anthropic?.api_key;
+    const anthropicModel = process.env["ANTHROPIC_MODEL"] ?? fileConfig.anthropic?.model;
+    if (anthropicApiKey !== undefined || anthropicModel !== undefined) {
+        config.anthropic = {
+            ...(fileConfig.anthropic ?? {}),
+            ...(anthropicApiKey !== undefined ? { api_key: anthropicApiKey } : {}),
+            ...(anthropicModel !== undefined ? { model: anthropicModel } : {}),
+        };
+    }
+    else if (fileConfig.anthropic) {
+        config.anthropic = fileConfig.anthropic;
+    }
+    // Merge openai section — env vars override file values
+    const openaiApiKey = process.env["OPENAI_API_KEY"] ?? fileConfig.openai?.api_key;
+    const openaiModel = process.env["OPENAI_MODEL"] ?? fileConfig.openai?.model;
+    const openaiBaseUrl = process.env["OPENAI_BASE_URL"] ?? fileConfig.openai?.base_url;
+    if (openaiApiKey !== undefined || openaiModel !== undefined || openaiBaseUrl !== undefined) {
+        config.openai = {
+            ...(fileConfig.openai ?? {}),
+            ...(openaiApiKey !== undefined ? { api_key: openaiApiKey } : {}),
+            ...(openaiModel !== undefined ? { model: openaiModel } : {}),
+            ...(openaiBaseUrl !== undefined ? { base_url: openaiBaseUrl } : {}),
+        };
+    }
+    else if (fileConfig.openai) {
+        config.openai = fileConfig.openai;
+    }
+    // Merge ollama section — env vars override file values
+    const ollamaBaseUrl = process.env["OLLAMA_BASE_URL"] ?? fileConfig.ollama?.base_url;
+    const ollamaModel = process.env["OLLAMA_MODEL"] ?? fileConfig.ollama?.model;
+    if (ollamaBaseUrl !== undefined || ollamaModel !== undefined) {
+        config.ollama = {
+            ...(fileConfig.ollama ?? {}),
+            ...(ollamaBaseUrl !== undefined ? { base_url: ollamaBaseUrl } : {}),
+            ...(ollamaModel !== undefined ? { model: ollamaModel } : {}),
+        };
+    }
+    else if (fileConfig.ollama) {
+        config.ollama = fileConfig.ollama;
+    }
+    // Merge codex section — env vars override file values
+    const codexModel = process.env["OPENAI_MODEL"] ?? fileConfig.codex?.model;
+    if (fileConfig.codex || codexModel !== undefined) {
+        config.codex = {
+            ...(fileConfig.codex ?? {}),
+            ...(codexModel !== undefined ? { model: codexModel } : {}),
+        };
+    }
+    // Merge a2a section — pass through from file config
+    if (fileConfig.a2a) {
+        config.a2a = fileConfig.a2a;
+    }
+    return config;
+}
+/**
+ * Save provider configuration to ~/.conatus/provider.json.
+ * Creates the ~/.conatus 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,25 @@
+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. CONATUS_LLM_PROVIDER environment variable
+ *   2. ~/.conatus/provider.json llm_provider field
+ *   3. Default: OpenAI
+ *
+ * Providers:
+ *   - "anthropic" → LLMClient (ANTHROPIC_API_KEY required)
+ *   - "openai"    → OpenAILLMClient (OPENAI_API_KEY, OPENAI_MODEL, OPENAI_BASE_URL)
+ *   - "ollama"    → OllamaLLMClient (OLLAMA_BASE_URL, OLLAMA_MODEL)
+ *   - "codex"     → CodexLLMClient (codex CLI required, OPENAI_MODEL optional)
+ */
+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;AAOhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAsD1D;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,UAAU,EACrB,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,eAAe,CAAC,CAkC1B"}

package/dist/llm/provider-factory.js

@@ -0,0 +1,111 @@
+// ─── Provider Factory ───
+//
+// Shared factory helpers for building LLM clients and adapter registries.
+// Used by both CLIRunner and TUI entry to avoid duplicating wiring logic.
+import { LLMClient } from "./llm-client.js";
+import { LLMError } from "../utils/errors.js";
+import { OllamaLLMClient } from "./ollama-client.js";
+import { OpenAILLMClient } from "./openai-client.js";
+import { CodexLLMClient } from "./codex-llm-client.js";
+import { loadProviderConfig } from "./provider-config.js";
+import { AdapterRegistry } from "../execution/adapter-layer.js";
+import { ClaudeCodeCLIAdapter } from "../adapters/claude-code-cli.js";
+import { ClaudeAPIAdapter } from "../adapters/claude-api.js";
+import { OpenAICodexCLIAdapter } from "../adapters/openai-codex.js";
+import { GitHubIssueAdapter } from "../adapters/github-issue.js";
+import { A2AAdapter } from "../adapters/a2a-adapter.js";
+import { BrowserUseCLIAdapter } from "../adapters/browser-use-cli.js";
+/**
+ * Build an LLM client based on provider configuration.
+ *
+ * Configuration priority (highest to lowest):
+ *   1. CONATUS_LLM_PROVIDER environment variable
+ *   2. ~/.conatus/provider.json llm_provider field
+ *   3. Default: OpenAI
+ *
+ * Providers:
+ *   - "anthropic" → LLMClient (ANTHROPIC_API_KEY required)
+ *   - "openai"    → OpenAILLMClient (OPENAI_API_KEY, OPENAI_MODEL, OPENAI_BASE_URL)
+ *   - "ollama"    → OllamaLLMClient (OLLAMA_BASE_URL, OLLAMA_MODEL)
+ *   - "codex"     → CodexLLMClient (codex CLI required, OPENAI_MODEL optional)
+ */
+export async function buildLLMClient() {
+    const config = await loadProviderConfig();
+    switch (config.llm_provider) {
+        case "codex":
+            if (!config.openai?.api_key) {
+                throw new LLMError("OPENAI_API_KEY is not set.\nSet it via: export OPENAI_API_KEY=sk-...");
+            }
+            return new CodexLLMClient({
+                cliPath: config.codex?.cli_path,
+                model: config.codex?.model,
+            });
+        case "openai":
+            if (!config.openai?.api_key) {
+                throw new LLMError("OPENAI_API_KEY is not set.\nSet it via: export OPENAI_API_KEY=sk-...");
+            }
+            return new OpenAILLMClient({
+                apiKey: config.openai.api_key,
+                model: config.openai?.model,
+                baseURL: config.openai?.base_url,
+            });
+        case "ollama":
+            return new OllamaLLMClient({
+                baseUrl: config.ollama?.base_url ?? "http://localhost:11434",
+                model: config.ollama?.model ?? "qwen3:4b",
+            });
+        case "anthropic":
+            if (!config.anthropic?.api_key) {
+                throw new LLMError("ANTHROPIC_API_KEY is not set.\nSet it via: export ANTHROPIC_API_KEY=sk-ant-...");
+            }
+            return new LLMClient(config.anthropic.api_key);
+        default:
+            // Unknown or unset value falls back to OpenAI
+            if (!config.openai?.api_key) {
+                throw new LLMError("OPENAI_API_KEY is not set.\nSet it via: export OPENAI_API_KEY=sk-...");
+            }
+            return new OpenAILLMClient({
+                apiKey: config.openai.api_key,
+                model: config.openai?.model,
+                baseURL: config.openai?.base_url,
+            });
+    }
+}
+/**
+ * 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 async function buildAdapterRegistry(llmClient, providerConfig) {
+    const registry = new AdapterRegistry();
+    registry.register(new ClaudeCodeCLIAdapter());
+    registry.register(new ClaudeAPIAdapter(llmClient));
+    registry.register(new OpenAICodexCLIAdapter());
+    registry.register(new GitHubIssueAdapter());
+    registry.register(new BrowserUseCLIAdapter());
+    // Register A2A agents from config
+    const config = providerConfig ?? await loadProviderConfig();
+    if (config.a2a?.agents) {
+        for (const [name, agentConfig] of Object.entries(config.a2a.agents)) {
+            registry.register(new A2AAdapter({
+                adapterType: name.startsWith("a2a") ? name : `a2a_${name}`,
+                baseUrl: agentConfig.base_url,
+                authToken: agentConfig.auth_token,
+                capabilities: agentConfig.capabilities,
+                preferStreaming: agentConfig.prefer_streaming,
+                pollIntervalMs: agentConfig.poll_interval_ms,
+                maxWaitMs: agentConfig.max_wait_ms,
+            }));
+        }
+    }
+    // Single-agent env var shortcut
+    const envBaseUrl = process.env["CONATUS_A2A_BASE_URL"];
+    if (envBaseUrl && !config.a2a?.agents) {
+        registry.register(new A2AAdapter({
+            baseUrl: envBaseUrl,
+            authToken: process.env["CONATUS_A2A_AUTH_TOKEN"],
+        }));
+    }
+    return registry;
+}
+//# sourceMappingURL=provider-factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.js","sourceRoot":"","sources":["../../src/llm/provider-factory.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,EAAE;AACF,0EAA0E;AAC1E,0EAA0E;AAE1E,OAAO,EAAE,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAGtE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAE1C,QAAQ,MAAM,CAAC,YAAY,EAAE,CAAC;QAC5B,KAAK,OAAO;YACV,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC5B,MAAM,IAAI,QAAQ,CAChB,sEAAsE,CACvE,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,cAAc,CAAC;gBACxB,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ;gBAC/B,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK;aAC3B,CAAC,CAAC;QAEL,KAAK,QAAQ;YACX,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC5B,MAAM,IAAI,QAAQ,CAChB,sEAAsE,CACvE,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,eAAe,CAAC;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;gBAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK;gBAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ;aACjC,CAAC,CAAC;QAEL,KAAK,QAAQ;YACX,OAAO,IAAI,eAAe,CAAC;gBACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,IAAI,wBAAwB;gBAC5D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,UAAU;aAC1C,CAAC,CAAC;QAEL,KAAK,WAAW;YACd,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;gBAC/B,MAAM,IAAI,QAAQ,CAChB,gFAAgF,CACjF,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEjD;YACE,8CAA8C;YAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC5B,MAAM,IAAI,QAAQ,CAChB,sEAAsE,CACvE,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,eAAe,CAAC;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;gBAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK;gBAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ;aACjC,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAqB,EACrB,cAA+B;IAE/B,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAE9C,kCAAkC;IAClC,MAAM,MAAM,GAAG,cAAc,IAAI,MAAM,kBAAkB,EAAE,CAAC;IAC5D,IAAI,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,QAAQ,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC;gBAC/B,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE;gBAC1D,OAAO,EAAE,WAAW,CAAC,QAAQ;gBAC7B,SAAS,EAAE,WAAW,CAAC,UAAU;gBACjC,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,eAAe,EAAE,WAAW,CAAC,gBAAgB;gBAC7C,cAAc,EAAE,WAAW,CAAC,gBAAgB;gBAC5C,SAAS,EAAE,WAAW,CAAC,WAAW;aACnC,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACvD,IAAI,UAAU,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QACtC,QAAQ,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC;YAC/B,OAAO,EAAE,UAAU;YACnB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;SACjD,CAAC,CAAC,CAAC;IACN,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}