pulseed 0.4.18 → 0.4.19

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

@@ -0,0 +1,281 @@
+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, RATE_LIMIT_RETRY_DELAYS_MS, isRateLimitError, getRateLimitRetryDelay, 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;
+    defaultModel;
+    constructor(apiKey, guardrailRunner, lightModel, model) {
+        super();
+        const resolvedApiKey = apiKey ?? process.env["ANTHROPIC_API_KEY"];
+        if (!resolvedApiKey) {
+            throw new LLMError("LLMClient: no API key provided. Pass apiKey to constructor.");
+        }
+        this.client = new Anthropic({ apiKey: resolvedApiKey });
+        this.guardrailRunner = guardrailRunner;
+        this.lightModel = lightModel;
+        this.defaultModel = model ?? DEFAULT_MODEL;
+    }
+    parseJSON(content, schema, options) {
+        return super.parseJSON(content, schema, options);
+    }
+    /**
+     * Send a message to the Anthropic API with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff.
+     * Retries up to RATE_LIMIT_RETRY_DELAYS_MS.length times on HTTP 429 with extended backoff.
+     */
+    async sendMessage(messages, options) {
+        const model = this.resolveEffectiveModel(options?.model ?? this.defaultModel, 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;
+        let normalAttempts = 0;
+        let rateLimitAttempts = 0;
+        while (normalAttempts < MAX_RETRY_ATTEMPTS) {
+            try {
+                // Convert ToolDefinition[] to Anthropic SDK tool format
+                const anthropicTools = options?.tools?.map((t) => ({
+                    name: t.function.name,
+                    description: t.function.description,
+                    input_schema: {
+                        type: "object",
+                        ...t.function.parameters,
+                    },
+                }));
+                const response = await this.client.messages.create({
+                    model,
+                    max_tokens,
+                    temperature,
+                    ...(system ? { system } : {}),
+                    ...(anthropicTools?.length ? { tools: anthropicTools } : {}),
+                    messages: messages.map((m) => ({
+                        role: m.role,
+                        content: m.content,
+                    })),
+                }, { timeout: DEFAULT_LLM_TIMEOUT_MS });
+                // Extract text content from response
+                const textBlock = response.content.find((b) => b.type === "text");
+                const content = textBlock && "text" in textBlock ? textBlock.text : "";
+                // Extract tool_use blocks into ToolCallResult[]
+                const toolUseBlocks = response.content.filter((b) => b.type === "tool_use" && "id" in b && "name" in b && "input" in b);
+                const tool_calls = toolUseBlocks.length > 0
+                    ? toolUseBlocks.map((b) => ({
+                        id: b.id,
+                        function: {
+                            name: b.name,
+                            arguments: JSON.stringify(b.input),
+                        },
+                    }))
+                    : undefined;
+                result = {
+                    content,
+                    usage: {
+                        input_tokens: response.usage.input_tokens,
+                        output_tokens: response.usage.output_tokens,
+                    },
+                    stop_reason: response.stop_reason ?? "unknown",
+                    ...(tool_calls ? { tool_calls } : {}),
+                };
+                break;
+            }
+            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;
+                }
+                // Other 4xx client errors: throw immediately
+                if (err instanceof Error &&
+                    "status" in err &&
+                    typeof err.status === "number" &&
+                    err.status >= 400 &&
+                    err.status < 500) {
+                    throw err;
+                }
+                normalAttempts++;
+                if (normalAttempts < MAX_RETRY_ATTEMPTS) {
+                    await sleep(RETRY_DELAYS_MS[normalAttempts - 1] ?? 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;
+    }
+    async sendMessageStream(messages, options, handlers) {
+        if (this.guardrailRunner) {
+            const response = await this.sendMessage(messages, options);
+            if (response.content) {
+                handlers.onTextDelta?.(response.content);
+            }
+            return response;
+        }
+        const model = this.resolveEffectiveModel(options?.model ?? this.defaultModel, options?.model_tier);
+        const max_tokens = options?.max_tokens ?? DEFAULT_MAX_TOKENS;
+        const temperature = options?.temperature ?? DEFAULT_TEMPERATURE;
+        const system = options?.system;
+        const anthropicTools = options?.tools?.map((t) => ({
+            name: t.function.name,
+            description: t.function.description,
+            input_schema: {
+                type: "object",
+                ...t.function.parameters,
+            },
+        }));
+        const stream = this.client.messages.stream({
+            model,
+            max_tokens,
+            temperature,
+            ...(system ? { system } : {}),
+            ...(anthropicTools?.length ? { tools: anthropicTools } : {}),
+            messages: messages.map((m) => ({
+                role: m.role,
+                content: m.content,
+            })),
+        }, { timeout: DEFAULT_LLM_TIMEOUT_MS });
+        stream.on("text", (delta) => {
+            handlers.onTextDelta?.(delta);
+        });
+        const finalMessage = await stream.finalMessage();
+        const content = finalMessage.content
+            .filter((block) => block.type === "text")
+            .map((block) => block.text)
+            .join("");
+        const tool_calls = extractAnthropicToolCalls(finalMessage);
+        return {
+            content,
+            usage: {
+                input_tokens: finalMessage.usage.input_tokens,
+                output_tokens: finalMessage.usage.output_tokens,
+            },
+            stop_reason: finalMessage.stop_reason ?? "unknown",
+            ...(tool_calls.length > 0 ? { tool_calls } : {}),
+        };
+    }
+    /**
+     * 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 entry = this.responses[index];
+        // If the entry is already an LLMResponse, return it directly
+        if (typeof entry === "object") {
+            return entry;
+        }
+        return {
+            content: entry,
+            usage: {
+                input_tokens: 10,
+                output_tokens: entry.length,
+            },
+            stop_reason: "end_turn",
+        };
+    }
+    async callLLMRaw(_messages, _systemPrompt) {
+        const response = await this.sendMessage([]);
+        return response.content;
+    }
+    async sendMessageStream(messages, options, handlers) {
+        const response = await this.sendMessage(messages, options);
+        if (response.content) {
+            handlers.onTextDelta?.(response.content);
+        }
+        return response;
+    }
+    parseJSON(content, schema, options) {
+        return super.parseJSON(content, schema, options);
+    }
+}
+function extractAnthropicToolCalls(message) {
+    return message.content
+        .filter((block) => block.type === "tool_use")
+        .map((block) => ({
+        id: block.id,
+        type: "function",
+        function: {
+            name: block.name,
+            arguments: JSON.stringify(block.input),
+        },
+    }));
+}
+//# sourceMappingURL=llm-client.js.map

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

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

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

@@ -0,0 +1,28 @@
+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.
+     * Retries up to RATE_LIMIT_RETRY_DELAYS_MS.length times on HTTP 429 with extended backoff.
+     */
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+    supportsToolCalling(): boolean;
+}
+//# sourceMappingURL=ollama-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-client.d.ts","sourceRoot":"","sources":["../../../src/base/llm/ollama-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyJ,MAAM,sBAAsB,CAAC;AAC5M,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;;;;OAIG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;IAsGvB,mBAAmB,IAAI,OAAO;CAC/B"}

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

@@ -0,0 +1,112 @@
+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 = "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.
+     * Retries up to RATE_LIMIT_RETRY_DELAYS_MS.length times on HTTP 429 with extended backoff.
+     */
+    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;
+        let normalAttempts = 0;
+        let rateLimitAttempts = 0;
+        while (normalAttempts < MAX_RETRY_ATTEMPTS) {
+            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;
+                // 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/fetch errors, not on HTTP 4xx client errors (excluding 429)
+                const isNetworkError = err instanceof TypeError ||
+                    (err instanceof Error &&
+                        !err.message.startsWith("OllamaLLMClient: HTTP 4"));
+                normalAttempts++;
+                if (normalAttempts < MAX_RETRY_ATTEMPTS && isNetworkError) {
+                    await sleep(RETRY_DELAYS_MS[normalAttempts - 1] ?? 1000);
+                }
+                else if (!isNetworkError) {
+                    throw err;
+                }
+            }
+        }
+        throw lastError;
+    }
+    supportsToolCalling() { return false; }
+}
+//# sourceMappingURL=ollama-client.js.map

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

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

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

@@ -0,0 +1,39 @@
+import { BaseLLMClient } from "./base-llm-client.js";
+import { type ILLMClient, type LLMMessage, type LLMRequestOptions, type LLMResponse, type LLMStreamHandlers } 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.
+     * 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.
+     */
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+    sendMessageStream(messages: LLMMessage[], options: LLMRequestOptions | undefined, handlers: LLMStreamHandlers): Promise<LLMResponse>;
+    private sendViaResponsesApi;
+}
+//# sourceMappingURL=openai-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai-client.d.ts","sourceRoot":"","sources":["../../../src/base/llm/openai-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAyJ,MAAM,sBAAsB,CAAC;AAC5M,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAuB,MAAM,iBAAiB,CAAC;AA2B1J,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;;;;;;;OAOG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;IA0FjB,iBAAiB,CACrB,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;YA8DT,mBAAmB;CAiDlC"}