pulseed 0.0.1 → 0.1.1

package/dist/llm/json-sanitizer.js

@@ -0,0 +1,110 @@
+/**
+ * json-sanitizer.ts — Shared LLM JSON response sanitization utilities.
+ *
+ * Centralizes all sanitization logic so it can be applied consistently
+ * before JSON.parse() and Zod validation.
+ */
+// ─── Threshold type sanitizer ───
+const THRESHOLD_TYPE_MAP = {
+    exact: "match",
+    scale: "min",
+    qualitative: "min",
+    boolean: "present",
+    percentage: "min",
+    count: "min",
+};
+const VALID_THRESHOLD_TYPES = new Set(["min", "max", "range", "present", "match"]);
+/**
+ * Sanitizes LLM-returned threshold_type strings to valid enum values.
+ * Handles the union of all known non-standard values from both
+ * GoalRefiner (leaf test) and GoalTreeManager (subgoal decomposition).
+ *
+ * Uses regex replacement so it works on raw JSON strings before parsing.
+ */
+export function sanitizeThresholdTypes(raw) {
+    return raw.replace(/"threshold_type"\s*:\s*"([^"]+)"/g, (_match, val) => {
+        if (VALID_THRESHOLD_TYPES.has(val))
+            return `"threshold_type": "${val}"`;
+        const mapped = THRESHOLD_TYPE_MAP[val] ?? "min";
+        return `"threshold_type": "${mapped}"`;
+    });
+}
+/**
+ * Sanitizes LLM-returned threshold_value when threshold_type is "present".
+ * When the LLM returns an object (e.g. `{"type":"present"}`) as the value for
+ * a present threshold, replace it with null so downstream Zod schemas accept it.
+ *
+ * Operates on the raw JSON string before parsing to avoid any type-safety issues
+ * with the un-parsed LLM output.
+ */
+export function sanitizeThresholdValues(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        const sanitized = sanitizePresentThresholdValues(parsed);
+        return JSON.stringify(sanitized);
+    }
+    catch (err) {
+        // JSON is not yet valid — syntactic fixups haven't fully resolved. This is expected
+        // when sanitizeThresholdValues runs as part of the sanitizeLLMJson pipeline.
+        console.debug("[sanitizeThresholdValues] JSON not yet parseable, skipping threshold cleanup");
+        void err;
+        return raw;
+    }
+}
+function sanitizePresentThresholdValues(value) {
+    if (Array.isArray(value)) {
+        return value.map(sanitizePresentThresholdValues);
+    }
+    if (value !== null && typeof value === "object") {
+        const record = value;
+        const result = {};
+        for (const [k, v] of Object.entries(record)) {
+            result[k] = sanitizePresentThresholdValues(v);
+        }
+        // If this object has threshold_type === "present" and threshold_value is an object, null it out.
+        if (result["threshold_type"] === "present" &&
+            typeof result["threshold_value"] === "object" &&
+            result["threshold_value"] !== null) {
+            result["threshold_value"] = null;
+        }
+        return result;
+    }
+    return value;
+}
+// ─── Common LLM drift pattern sanitizers ───
+/**
+ * Removes trailing commas before `}` or `]` — a common LLM formatting mistake.
+ * e.g. `{"a": 1,}` → `{"a": 1}`
+ */
+function removeTrailingCommas(raw) {
+    return raw.replace(/,\s*([}\]])/g, "$1");
+}
+/**
+ * Replaces JSON-invalid numeric literals produced by LLMs with null.
+ * Handles: NaN, Infinity, -Infinity (all unquoted).
+ */
+function replaceInvalidNumbers(raw) {
+    return raw
+        .replace(/\bNaN\b/g, "null")
+        .replace(/-Infinity\b/g, "null")
+        .replace(/\bInfinity\b/g, "null");
+}
+// ─── Main entry point ───
+/**
+ * Applies all LLM JSON sanitizers in sequence.
+ *
+ * Order:
+ *   1. Remove trailing commas (syntactic fix — must come before JSON.parse attempts)
+ *   2. Replace NaN/Infinity with null (syntactic fix)
+ *   3. Sanitize threshold_type enum values (domain-specific string replacement)
+ *   4. Sanitize threshold_value for "present" thresholds (requires parse+reserialize)
+ */
+export function sanitizeLLMJson(raw) {
+    let result = raw;
+    result = removeTrailingCommas(result);
+    result = replaceInvalidNumbers(result);
+    result = sanitizeThresholdTypes(result);
+    result = sanitizeThresholdValues(result);
+    return result;
+}
+//# sourceMappingURL=json-sanitizer.js.map

package/dist/llm/json-sanitizer.js.map

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

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

@@ -0,0 +1,65 @@
+import type { ZodSchema } from "zod";
+import { BaseLLMClient, DEFAULT_MAX_TOKENS, extractJSON } from "./base-llm-client.js";
+import type { ModelTier, ParseJSONMessage, ParseJSONOptions } from "./base-llm-client.js";
+import { GuardrailRunner } from "../guardrail-runner.js";
+export interface LLMMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+export type { ModelTier };
+export interface LLMRequestOptions {
+    model?: string;
+    max_tokens?: number;
+    system?: string;
+    temperature?: number;
+    /** Route to light model when configured. Defaults to 'main' for backward compat. */
+    model_tier?: ModelTier;
+}
+export interface LLMResponse {
+    content: string;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    stop_reason: string;
+}
+export interface ILLMClient {
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+    parseJSON<T>(content: string, schema: ZodSchema<T>): T;
+    parseJSON<T>(content: string, schema: ZodSchema<T>, options: ParseJSONOptions): Promise<T>;
+}
+export { extractJSON, DEFAULT_MAX_TOKENS };
+/**
+ * Thin wrapper around the Anthropic SDK.
+ * Provides retry logic and JSON extraction/validation.
+ *
+ * Constructor throws if no API key is provided.
+ */
+export declare class LLMClient extends BaseLLMClient implements ILLMClient {
+    private readonly client;
+    private guardrailRunner?;
+    constructor(apiKey: string, guardrailRunner?: GuardrailRunner, lightModel?: string);
+    /**
+     * Send a message to the Anthropic API with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff.
+     */
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+    /**
+     * Low-level LLM call used by parseJSON retry logic.
+     * Sends messages and returns the raw response text.
+     */
+    protected callLLMRaw(messages: ParseJSONMessage[], systemPrompt?: string): Promise<string>;
+}
+/**
+ * Mock implementation for testing.
+ * Returns provided responses in order, tracking call count.
+ */
+export declare class MockLLMClient extends BaseLLMClient implements ILLMClient {
+    private readonly responses;
+    private _callCount;
+    constructor(responses: string[]);
+    get callCount(): number;
+    sendMessage(_messages: LLMMessage[], _options?: LLMRequestOptions): Promise<LLMResponse>;
+    protected callLLMRaw(_messages: ParseJSONMessage[], _systemPrompt?: string): Promise<string>;
+}
+//# sourceMappingURL=llm-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../../src/llm/llm-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAA+D,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnJ,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE1F,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,UAAU;IACzB,WAAW,CACT,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACvD,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5F;AAQD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;AAI3C;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,aAAc,YAAW,UAAU;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,eAAe,CAAC,CAAkB;gBAE9B,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM;IAYlF;;;OAGG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;IAkGvB;;;OAGG;cACa,UAAU,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAOjG;AAID;;;GAGG;AACH,qBAAa,aAAc,SAAQ,aAAc,YAAW,UAAU;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,UAAU,CAAa;gBAEnB,SAAS,EAAE,MAAM,EAAE;IAK/B,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEK,WAAW,CACf,SAAS,EAAE,UAAU,EAAE,EACvB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,WAAW,CAAC;cAsBP,UAAU,CAAC,SAAS,EAAE,gBAAgB,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAInG"}

package/dist/llm/llm-client.js

@@ -0,0 +1,165 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { sleep } from "../utils/sleep.js";
+import { BaseLLMClient, DEFAULT_MAX_TOKENS, DEFAULT_LLM_TIMEOUT_MS, MAX_RETRY_ATTEMPTS, RETRY_DELAYS_MS, extractJSON } from "./base-llm-client.js";
+import { LLMError } from "../utils/errors.js";
+// ─── Constants ───
+const DEFAULT_MODEL = "claude-sonnet-4-20250514";
+const DEFAULT_TEMPERATURE = 0;
+// Re-export shared utilities for consumers that import from this module
+export { extractJSON, DEFAULT_MAX_TOKENS };
+// ─── LLMClient ───
+/**
+ * Thin wrapper around the Anthropic SDK.
+ * Provides retry logic and JSON extraction/validation.
+ *
+ * Constructor throws if no API key is provided.
+ */
+export class LLMClient extends BaseLLMClient {
+    client;
+    guardrailRunner;
+    constructor(apiKey, guardrailRunner, lightModel) {
+        super();
+        if (!apiKey) {
+            throw new LLMError("LLMClient: no API key provided. Pass apiKey to constructor.");
+        }
+        this.client = new Anthropic({ apiKey });
+        this.guardrailRunner = guardrailRunner;
+        this.lightModel = lightModel;
+    }
+    /**
+     * Send a message to the Anthropic API with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff.
+     */
+    async sendMessage(messages, options) {
+        const model = this.resolveEffectiveModel(options?.model ?? DEFAULT_MODEL, options?.model_tier);
+        const max_tokens = options?.max_tokens ?? DEFAULT_MAX_TOKENS;
+        const temperature = options?.temperature ?? DEFAULT_TEMPERATURE;
+        let system = options?.system;
+        // before_model guardrail
+        if (this.guardrailRunner) {
+            const beforeResult = await this.guardrailRunner.run("before_model", {
+                checkpoint: "before_model",
+                input: { messages, options },
+                metadata: {},
+            });
+            if (!beforeResult.allowed) {
+                throw new Error(`Guardrail rejected: ${beforeResult.results.map((r) => r.reason).filter(Boolean).join("; ")}`);
+            }
+            if (beforeResult.modified_input) {
+                const modified = beforeResult.modified_input;
+                if (modified.messages)
+                    messages = modified.messages;
+                if (modified.system)
+                    system = modified.system;
+                if (modified.options)
+                    options = { ...options, ...modified.options };
+            }
+        }
+        let lastError;
+        let result;
+        for (let attempt = 0; attempt < MAX_RETRY_ATTEMPTS; attempt++) {
+            try {
+                const response = await this.client.messages.create({
+                    model,
+                    max_tokens,
+                    temperature,
+                    ...(system ? { system } : {}),
+                    messages: messages.map((m) => ({
+                        role: m.role,
+                        content: m.content,
+                    })),
+                }, { timeout: DEFAULT_LLM_TIMEOUT_MS });
+                const block = response.content[0];
+                const content = block && block.type === "text" ? block.text : "";
+                result = {
+                    content,
+                    usage: {
+                        input_tokens: response.usage.input_tokens,
+                        output_tokens: response.usage.output_tokens,
+                    },
+                    stop_reason: response.stop_reason ?? "unknown",
+                };
+                break;
+            }
+            catch (err) {
+                if (err instanceof Error &&
+                    "status" in err &&
+                    typeof err.status === "number" &&
+                    err.status >= 400 &&
+                    err.status < 500) {
+                    throw err; // client error, no retry
+                }
+                lastError = err;
+                if (attempt < MAX_RETRY_ATTEMPTS - 1) {
+                    await sleep(RETRY_DELAYS_MS[attempt] ?? 1000);
+                }
+            }
+        }
+        if (result === undefined) {
+            throw lastError;
+        }
+        // after_model guardrail
+        if (this.guardrailRunner) {
+            const afterResult = await this.guardrailRunner.run("after_model", {
+                checkpoint: "after_model",
+                input: { response: result, messages, options },
+                metadata: {},
+            });
+            if (!afterResult.allowed) {
+                throw new Error(`Guardrail rejected response: ${afterResult.results.map((r) => r.reason).filter(Boolean).join("; ")}`);
+            }
+            if (afterResult.modified_input !== undefined) {
+                result = afterResult.modified_input;
+            }
+        }
+        return result;
+    }
+    /**
+     * Low-level LLM call used by parseJSON retry logic.
+     * Sends messages and returns the raw response text.
+     */
+    async callLLMRaw(messages, systemPrompt) {
+        const llmMessages = messages
+            .filter((m) => m.role === "user" || m.role === "assistant")
+            .map((m) => ({ role: m.role, content: m.content }));
+        const response = await this.sendMessage(llmMessages, systemPrompt ? { system: systemPrompt } : undefined);
+        return response.content;
+    }
+}
+// ─── MockLLMClient ───
+/**
+ * Mock implementation for testing.
+ * Returns provided responses in order, tracking call count.
+ */
+export class MockLLMClient extends BaseLLMClient {
+    responses;
+    _callCount = 0;
+    constructor(responses) {
+        super();
+        this.responses = responses;
+    }
+    get callCount() {
+        return this._callCount;
+    }
+    async sendMessage(_messages, _options) {
+        const index = this._callCount;
+        this._callCount++;
+        if (index >= this.responses.length) {
+            throw new Error(`MockLLMClient: no response at index ${index} (only ${this.responses.length} responses configured)`);
+        }
+        const content = this.responses[index];
+        return {
+            content,
+            usage: {
+                input_tokens: 10,
+                output_tokens: content.length,
+            },
+            stop_reason: "end_turn",
+        };
+    }
+    async callLLMRaw(_messages, _systemPrompt) {
+        const response = await this.sendMessage([]);
+        return response.content;
+    }
+}
+//# sourceMappingURL=llm-client.js.map

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

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

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

@@ -0,0 +1,26 @@
+import { BaseLLMClient } from "./base-llm-client.js";
+import { type ILLMClient, type LLMMessage, type LLMRequestOptions, type LLMResponse } from "./llm-client.js";
+export interface OllamaClientConfig {
+    baseUrl: string;
+    model?: string;
+    /** Optional lighter model for routine tasks */
+    lightModel?: string;
+}
+/**
+ * LLM client for Ollama's OpenAI-compatible API.
+ * Uses native fetch (Node 18+) — no extra dependencies.
+ *
+ * Set PULSEED_LLM_PROVIDER=ollama to activate via CLIRunner.
+ * Optionally set OLLAMA_BASE_URL and OLLAMA_MODEL to configure.
+ */
+export declare class OllamaLLMClient extends BaseLLMClient implements ILLMClient {
+    private readonly baseUrl;
+    private readonly model;
+    constructor(config: OllamaClientConfig);
+    /**
+     * Send a message to Ollama's OpenAI-compatible chat completions endpoint.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff on network errors.
+     */
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+}
+//# sourceMappingURL=ollama-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-client.d.ts","sourceRoot":"","sources":["../../src/llm/ollama-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAmF,MAAM,sBAAsB,CAAC;AACtI,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAW7G,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,aAAc,YAAW,UAAU;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,MAAM,EAAE,kBAAkB;IAOtC;;;OAGG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;CA4FxB"}

package/dist/llm/ollama-client.js

@@ -0,0 +1,101 @@
+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 = "qwen3:4b";
+const DEFAULT_TEMPERATURE = 0;
+/**
+ * LLM client for Ollama's OpenAI-compatible API.
+ * Uses native fetch (Node 18+) — no extra dependencies.
+ *
+ * Set PULSEED_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;
+        this.lightModel = config.lightModel;
+    }
+    /**
+     * 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 = 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-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 controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), DEFAULT_LLM_TIMEOUT_MS);
+                let response;
+                try {
+                    response = await fetch(url, {
+                        method: "POST",
+                        headers: {
+                            "Content-Type": "application/json",
+                        },
+                        body,
+                        signal: controller.signal,
+                    });
+                }
+                finally {
+                    clearTimeout(timeoutId);
+                }
+                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,36 @@
+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;
+    /** Optional lighter model for routine tasks (observation, verification, etc.) */
+    lightModel?: 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 PULSEED_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,EAAmF,MAAM,sBAAsB,CAAC;AACtI,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAkB7G,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;IACjB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;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;IAe3C;;;;;;OAMG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;CAmHxB"}