aura-code 0.3.0

package/dist/providers/openai-compatible.d.ts

@@ -0,0 +1,24 @@
+import type { LLMProvider, ProviderConfig, ToolDefinition, HistoryMessage, LLMResponse, StreamChunk } from './types.js';
+/**
+ * OpenAI-compatible provider.
+ * Works with: OpenAI, OpenRouter, xAI (Grok), Ollama, LM Studio,
+ * Together AI, Groq, Perplexity, and any server that speaks the OpenAI API spec.
+ *
+ * How to target each:
+ *   OpenAI:      model="gpt-4o"              apiKey=OPENAI_API_KEY
+ *   OpenRouter:  model="anthropic/claude-3.5" baseUrl="https://openrouter.ai/api/v1"  apiKey=OPENROUTER_API_KEY
+ *   xAI/Grok:   model="grok-beta"            baseUrl="https://api.x.ai/v1"           apiKey=XAI_API_KEY
+ *   Ollama:      model="llama3.2"             baseUrl="http://localhost:11434/v1"      apiKey="ollama"
+ *   LM Studio:   model="local-model"          baseUrl="http://localhost:1234/v1"       apiKey="lm-studio"
+ */
+export declare class OpenAICompatibleProvider implements LLMProvider {
+    name: string;
+    supportsTools: boolean;
+    model: string;
+    private client;
+    private maxTokens;
+    private temperature;
+    constructor(config: ProviderConfig, providerName?: string);
+    complete(system: string, history: HistoryMessage[], tools: ToolDefinition[]): Promise<LLMResponse>;
+    stream(system: string, history: HistoryMessage[], tools: ToolDefinition[]): AsyncGenerator<StreamChunk>;
+}

package/dist/providers/openai-compatible.js

@@ -0,0 +1,216 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAICompatibleProvider = void 0;
+const openai_1 = __importDefault(require("openai"));
+const env_js_1 = require("../util/env.js");
+/**
+ * OpenAI-compatible provider.
+ * Works with: OpenAI, OpenRouter, xAI (Grok), Ollama, LM Studio,
+ * Together AI, Groq, Perplexity, and any server that speaks the OpenAI API spec.
+ *
+ * How to target each:
+ *   OpenAI:      model="gpt-4o"              apiKey=OPENAI_API_KEY
+ *   OpenRouter:  model="anthropic/claude-3.5" baseUrl="https://openrouter.ai/api/v1"  apiKey=OPENROUTER_API_KEY
+ *   xAI/Grok:   model="grok-beta"            baseUrl="https://api.x.ai/v1"           apiKey=XAI_API_KEY
+ *   Ollama:      model="llama3.2"             baseUrl="http://localhost:11434/v1"      apiKey="ollama"
+ *   LM Studio:   model="local-model"          baseUrl="http://localhost:1234/v1"       apiKey="lm-studio"
+ */
+class OpenAICompatibleProvider {
+    name;
+    supportsTools = true;
+    model;
+    client;
+    maxTokens;
+    temperature;
+    constructor(config, providerName) {
+        this.model = config.model;
+        this.maxTokens = config.maxTokens ?? 8096;
+        this.temperature = config.temperature ?? 0.2;
+        this.name = providerName ?? deriveProviderName(config);
+        this.client = new openai_1.default({
+            apiKey: config.apiKey ?? resolveApiKey(config),
+            baseURL: config.baseUrl ?? resolveBaseUrl(config),
+        });
+    }
+    async complete(system, history, tools) {
+        const messages = toOpenAIMessages(system, history);
+        const response = await this.client.chat.completions.create({
+            model: this.model,
+            max_tokens: this.maxTokens,
+            temperature: this.temperature,
+            tools: tools.length > 0 ? tools.map(toOpenAITool) : undefined,
+            messages,
+        });
+        return fromOpenAIResponse(response);
+    }
+    async *stream(system, history, tools) {
+        const messages = toOpenAIMessages(system, history);
+        const stream = await this.client.chat.completions.create({
+            model: this.model,
+            max_tokens: this.maxTokens,
+            temperature: this.temperature,
+            tools: tools.length > 0 ? tools.map(toOpenAITool) : undefined,
+            messages,
+            stream: true,
+            stream_options: { include_usage: true },
+        });
+        let textBuffer = '';
+        const toolCallBuilders = new Map();
+        let usage;
+        for await (const chunk of stream) {
+            // OpenAI sends a final usage-only chunk when stream_options.include_usage is set
+            if (chunk.usage) {
+                usage = { inputTokens: chunk.usage.prompt_tokens ?? 0, outputTokens: chunk.usage.completion_tokens ?? 0 };
+            }
+            const delta = chunk.choices[0]?.delta;
+            if (!delta)
+                continue;
+            // Text content
+            if (delta.content) {
+                textBuffer += delta.content;
+                yield { type: 'text', text: delta.content };
+            }
+            // Tool calls (streamed in pieces)
+            for (const tc of delta.tool_calls ?? []) {
+                if (!toolCallBuilders.has(tc.index)) {
+                    const id = tc.id ?? `tc_${tc.index}`;
+                    const name = tc.function?.name ?? '';
+                    toolCallBuilders.set(tc.index, { id, name, args: '' });
+                    yield { type: 'tool_start', id, name };
+                }
+                const builder = toolCallBuilders.get(tc.index);
+                if (tc.function?.arguments) {
+                    builder.args += tc.function.arguments;
+                    yield { type: 'tool_input', id: builder.id, partial: tc.function.arguments };
+                }
+            }
+            // Finish
+            const finishReason = chunk.choices[0]?.finish_reason;
+            if (finishReason === 'tool_calls' || finishReason === 'stop') {
+                // Finalise all tool calls
+                const calls = [];
+                for (const [, b] of toolCallBuilders) {
+                    let input = {};
+                    try {
+                        input = JSON.parse(b.args);
+                    }
+                    catch {
+                        input = { _raw: b.args };
+                    }
+                    const call = { id: b.id, name: b.name, input };
+                    calls.push(call);
+                    yield { type: 'tool_end', call };
+                }
+                yield {
+                    type: 'done',
+                    response: {
+                        text: textBuffer,
+                        toolCalls: calls,
+                        stopReason: finishReason === 'tool_calls' ? 'tools' : 'done',
+                        usage,
+                    },
+                };
+                return;
+            }
+        }
+        yield { type: 'done', response: { text: textBuffer, toolCalls: [], stopReason: 'done', usage } };
+    }
+}
+exports.OpenAICompatibleProvider = OpenAICompatibleProvider;
+// ── Conversion helpers ──────────────────────────────────────────────────────
+function toOpenAITool(t) {
+    return {
+        type: 'function',
+        function: { name: t.name, description: t.description, parameters: t.parameters },
+    };
+}
+function toOpenAIMessages(system, history) {
+    const out = [
+        { role: 'system', content: system },
+    ];
+    for (const msg of history) {
+        if (msg.role === 'user') {
+            out.push({ role: 'user', content: msg.content });
+        }
+        else if (msg.role === 'assistant') {
+            if (msg.toolCalls && msg.toolCalls.length > 0) {
+                out.push({
+                    role: 'assistant',
+                    content: msg.content || null,
+                    tool_calls: msg.toolCalls.map(tc => ({
+                        id: tc.id, type: 'function',
+                        function: { name: tc.name, arguments: JSON.stringify(tc.input) },
+                    })),
+                });
+            }
+            else {
+                out.push({ role: 'assistant', content: msg.content });
+            }
+        }
+        else if (msg.role === 'tool_result') {
+            for (const r of msg.results) {
+                out.push({ role: 'tool', tool_call_id: r.id, content: r.content });
+            }
+        }
+    }
+    return out;
+}
+function fromOpenAIResponse(response) {
+    const choice = response.choices[0];
+    if (!choice)
+        return { text: '', toolCalls: [], stopReason: 'done' };
+    const text = choice.message.content ?? '';
+    const toolCalls = (choice.message.tool_calls ?? []).map(tc => {
+        let input = {};
+        try {
+            input = JSON.parse(tc.function.arguments);
+        }
+        catch {
+            input = { _raw: tc.function.arguments };
+        }
+        return { id: tc.id, name: tc.function.name, input };
+    });
+    const stopReason = choice.finish_reason === 'tool_calls' ? 'tools' :
+        choice.finish_reason === 'length' ? 'limit' : 'done';
+    const u = response.usage;
+    return {
+        text, toolCalls, stopReason,
+        usage: u ? { inputTokens: u.prompt_tokens ?? 0, outputTokens: u.completion_tokens ?? 0 } : undefined,
+    };
+}
+// ── Auto-resolution helpers ─────────────────────────────────────────────────
+function deriveProviderName(config) {
+    const m = config.model.toLowerCase();
+    if (config.baseUrl?.includes('openrouter'))
+        return 'OpenRouter';
+    if (config.baseUrl?.includes('x.ai') || m.includes('grok'))
+        return 'xAI';
+    if (config.baseUrl?.includes('localhost') || config.baseUrl?.includes('127.0.0.1')) {
+        return config.baseUrl?.includes('11434') ? 'Ollama' : 'Local';
+    }
+    if (m.startsWith('gpt-') || m.startsWith('o1') || m.startsWith('o3'))
+        return 'OpenAI';
+    return 'OpenAI-compatible';
+}
+function resolveApiKey(config) {
+    const m = config.model.toLowerCase();
+    if (config.baseUrl?.includes('openrouter'))
+        return (0, env_js_1.getApiKey)('OPENROUTER_API_KEY') ?? '';
+    if (config.baseUrl?.includes('x.ai') || m.includes('grok'))
+        return (0, env_js_1.getApiKey)('XAI_API_KEY') ?? '';
+    if (config.baseUrl?.includes('xiaomimimo') || m.startsWith('mimo-'))
+        return (0, env_js_1.getApiKey)('XIAOMI_API_KEY') ?? '';
+    if (config.baseUrl?.includes('localhost') || config.baseUrl?.includes('127.0.0.1'))
+        return 'local';
+    return (0, env_js_1.getApiKey)('OPENAI_API_KEY') ?? '';
+}
+function resolveBaseUrl(config) {
+    const m = config.model.toLowerCase();
+    if (m.includes('grok'))
+        return 'https://api.x.ai/v1';
+    return undefined; // default OpenAI
+}
+//# sourceMappingURL=openai-compatible.js.map

package/dist/providers/openai-compatible.js.map

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

package/dist/providers/resilient-factory.d.ts

@@ -0,0 +1,24 @@
+import type { LLMProvider, ProviderConfig } from './types.js';
+import type { Display } from '../cli/display.js';
+export interface ResilienceConfig {
+    /** Requests per minute (0 = unlimited). Default 0. */
+    rpm?: number;
+    /** Tokens per minute (0 = unlimited). Default 0. */
+    tpm?: number;
+    /** Burst capacity for the rate limiter. Default rpm/6. */
+    burst?: number;
+    /** Max retry attempts. Default 5. */
+    maxRetries?: number;
+    /** Circuit-breaker failure threshold. Default 5. */
+    circuitFailureThreshold?: number;
+    /** Circuit-breaker cooldown ms. Default 30000. */
+    circuitCooldownMs?: number;
+    /** Fallback model ids tried in order if the primary exhausts retries. */
+    fallbacks?: string[];
+}
+/**
+ * Build a provider wrapped in resilience + optional fallback chain.
+ * The returned object is what the agent loop uses — it doesn't know
+ * whether it's wrapped.
+ */
+export declare function createResilientProvider(config: ProviderConfig, resilience: ResilienceConfig, display?: Display): LLMProvider;

package/dist/providers/resilient-factory.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createResilientProvider = createResilientProvider;
+const factory_js_1 = require("./factory.js");
+const resilient_js_1 = require("./resilient.js");
+const fallback_js_1 = require("./fallback.js");
+/** Sensible defaults per provider family. */
+const DEFAULTS_BY_KIND = {
+    google: { rpm: 30, tpm: 1_000_000, burst: 5, maxRetries: 6 },
+    anthropic: { rpm: 50, burst: 8, maxRetries: 5 },
+    'openai-compatible': { rpm: 60, burst: 10, maxRetries: 5 },
+};
+/**
+ * Build a provider wrapped in resilience + optional fallback chain.
+ * The returned object is what the agent loop uses — it doesn't know
+ * whether it's wrapped.
+ */
+function createResilientProvider(config, resilience, display) {
+    const kind = (0, factory_js_1.detectProviderKind)(config.model);
+    const merged = { ...DEFAULTS_BY_KIND[kind], ...resilience };
+    const resilientOpts = {
+        rpm: merged.rpm,
+        tpm: merged.tpm,
+        burst: merged.burst,
+        maxRetries: merged.maxRetries,
+        circuitFailureThreshold: merged.circuitFailureThreshold,
+        circuitCooldownMs: merged.circuitCooldownMs,
+        onRetry: ({ provider, attempt, delayMs, error }) => {
+            display?.retry?.({
+                provider,
+                attempt,
+                delayMs,
+                reason: error.status === 429 ? 'rate limited' :
+                    error.status === 529 ? 'provider overloaded' :
+                        error.status === 0 ? 'network error' :
+                            `HTTP ${error.status}`,
+            });
+        },
+        onRateLimitWait: (provider, waitMs) => {
+            // Only surface when the wait is meaningful (>100ms)
+            if (waitMs > 100)
+                display?.retry?.({ provider, attempt: 0, delayMs: waitMs, reason: 'pacing' });
+        },
+        onCircuitChange: (provider, state) => display?.circuit?.({ provider, state }),
+    };
+    const primary = new resilient_js_1.ResilientProvider((0, factory_js_1.createProvider)(config), resilientOpts);
+    if (!merged.fallbacks || merged.fallbacks.length === 0)
+        return primary;
+    const fallbackProviders = merged.fallbacks.map(model => {
+        const fc = { ...config, model, baseUrl: undefined };
+        return new resilient_js_1.ResilientProvider((0, factory_js_1.createProvider)(fc), resilientOpts);
+    });
+    return new fallback_js_1.FallbackChainProvider([primary, ...fallbackProviders], {
+        onFailover: ({ from, to, reason }) => display?.failover?.({ from, to, reason }),
+    });
+}
+//# sourceMappingURL=resilient-factory.js.map

package/dist/providers/resilient-factory.js.map

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

package/dist/providers/resilient.d.ts

@@ -0,0 +1,63 @@
+import type { LLMProvider, LLMResponse, StreamChunk, HistoryMessage, ToolDefinition } from '../providers/types.js';
+import { ApiError } from '../util/errors.js';
+export interface ResilientOptions {
+    /** Requests per minute budget. 0 = unlimited. Default 0. */
+    rpm?: number;
+    /** Tokens per minute budget (Gemini-style). 0 = unlimited. */
+    tpm?: number;
+    /** Burst size — max tokens consumable in a quick burst. Default rpm/6. */
+    burst?: number;
+    /** Max retry attempts. Default 5. */
+    maxRetries?: number;
+    /** Cooldown when circuit is open. Default 30s. */
+    circuitCooldownMs?: number;
+    /** Consecutive failures before circuit opens. Default 5. */
+    circuitFailureThreshold?: number;
+    /** Surface retry events (for the CLI display). */
+    onRetry?: (info: {
+        provider: string;
+        attempt: number;
+        delayMs: number;
+        error: ApiError;
+    }) => void;
+    /** Surface circuit-breaker state changes. */
+    onCircuitChange?: (provider: string, state: 'closed' | 'open' | 'half-open') => void;
+    /** Surface rate-limit waits (acquire returned > 0ms). */
+    onRateLimitWait?: (provider: string, waitMs: number) => void;
+    /** Sleep function for testing. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Wrap a provider with rate limiting, circuit breaking, and retries.
+ * The wrapper itself implements LLMProvider, so the agent loop doesn't
+ * need to know whether it's wrapped.
+ */
+export declare class ResilientProvider implements LLMProvider {
+    readonly name: string;
+    readonly model: string;
+    readonly supportsTools: boolean;
+    private readonly inner;
+    private readonly rpmLimiter;
+    private readonly tpm;
+    private readonly breaker;
+    private readonly opts;
+    /** True once we've observed the provider work end-to-end. Used to gate TPM-based throttling. */
+    private tpmObserved;
+    constructor(inner: LLMProvider, opts?: ResilientOptions);
+    /** Non-streaming completion. */
+    complete(system: string, history: HistoryMessage[], tools: ToolDefinition[]): Promise<LLMResponse>;
+    /**
+     * Streaming completion. The wrap covers the `createStream` call (not iteration),
+     * so a transient connection error retries the whole stream. Mid-stream errors
+     * (after the first chunk) are NOT retried — we'd lose partial output.
+     */
+    stream(system: string, history: HistoryMessage[], tools: ToolDefinition[]): AsyncGenerator<StreamChunk>;
+    private firstChunkOrThrow;
+    /** Acquire rate-limit + circuit slot, then call `fn` under retry. */
+    private runResilient;
+    private recordUsage;
+    /** TPM helper used by the Google provider to gate heavy requests. */
+    tpmHasRoomFor(n: number): boolean;
+    /** Force-open the circuit (e.g. when manually disabling a provider). */
+    trip(reason: string): void;
+}

package/dist/providers/resilient.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResilientProvider = void 0;
+const retry_js_1 = require("../util/retry.js");
+const rate_limiter_js_1 = require("../util/rate-limiter.js");
+const circuit_breaker_js_1 = require("../util/circuit-breaker.js");
+const errors_js_1 = require("../util/errors.js");
+/**
+ * Wrap a provider with rate limiting, circuit breaking, and retries.
+ * The wrapper itself implements LLMProvider, so the agent loop doesn't
+ * need to know whether it's wrapped.
+ */
+class ResilientProvider {
+    name;
+    model;
+    supportsTools;
+    inner;
+    rpmLimiter;
+    tpm;
+    breaker;
+    opts;
+    /** True once we've observed the provider work end-to-end. Used to gate TPM-based throttling. */
+    tpmObserved = false;
+    constructor(inner, opts = {}) {
+        this.inner = inner;
+        this.name = inner.name;
+        this.model = inner.model;
+        this.supportsTools = inner.supportsTools;
+        this.opts = opts;
+        const rpm = opts.rpm ?? 0;
+        this.rpmLimiter = new rate_limiter_js_1.RateLimiter({
+            capacity: opts.burst ?? Math.max(1, Math.ceil(rpm / 6)),
+            refillPerMs: rpm > 0 ? rpm / 60_000 : Number.MAX_SAFE_INTEGER,
+            sleep: opts.sleep,
+        });
+        this.tpm = opts.tpm && opts.tpm > 0 ? new rate_limiter_js_1.TpmTracker(opts.tpm) : null;
+        this.breaker = new circuit_breaker_js_1.CircuitBreaker({
+            failureThreshold: opts.circuitFailureThreshold ?? 5,
+            cooldownMs: opts.circuitCooldownMs ?? 30_000,
+            sleep: opts.sleep,
+            onStateChange: (state) => opts.onCircuitChange?.(this.inner.name, state),
+        });
+    }
+    /** Non-streaming completion. */
+    async complete(system, history, tools) {
+        return this.runResilient(async () => {
+            const result = await this.inner.complete(system, history, tools);
+            this.recordUsage(result.usage);
+            return result;
+        });
+    }
+    /**
+     * Streaming completion. The wrap covers the `createStream` call (not iteration),
+     * so a transient connection error retries the whole stream. Mid-stream errors
+     * (after the first chunk) are NOT retried — we'd lose partial output.
+     */
+    async *stream(system, history, tools) {
+        // Collect chunks from the inner stream. Retry covers the call to obtain
+        // the generator and any error before the first yield.
+        const firstIterResult = await this.runResilient(async () => {
+            return await this.firstChunkOrThrow(this.inner.stream(system, history, tools));
+        });
+        // firstIterResult is either { firstChunk, generator } or a thrown error.
+        // After we have the first chunk, any further iteration errors propagate to the caller.
+        let gen;
+        let first;
+        if (firstIterResult.kind === 'done') {
+            // Inner stream finished without yielding anything — emit a synthetic done if needed
+            yield firstIterResult.final;
+            return;
+        }
+        gen = firstIterResult.gen;
+        first = firstIterResult.first;
+        yield first;
+        try {
+            for await (const chunk of gen) {
+                if (chunk.type === 'done') {
+                    this.recordUsage(chunk.response.usage);
+                }
+                yield chunk;
+            }
+        }
+        catch (e) {
+            // Mid-stream error — wrap so the caller can see the cause, but do not retry
+            throw (0, errors_js_1.normaliseError)(e, this.inner.name);
+        }
+    }
+    async firstChunkOrThrow(gen) {
+        const it = gen[Symbol.asyncIterator]();
+        try {
+            const first = await it.next();
+            if (first.done) {
+                // Inner stream finished without yielding — call finalMessage equivalent?
+                // This shouldn't happen for our providers, but guard anyway.
+                return { kind: 'done', final: { type: 'done', response: { text: '', toolCalls: [], stopReason: 'done' } } };
+            }
+            return { kind: 'streaming', gen: gen, first: first.value };
+        }
+        catch (e) {
+            // Re-throw so retry layer sees it
+            throw e;
+        }
+    }
+    /** Acquire rate-limit + circuit slot, then call `fn` under retry. */
+    async runResilient(fn) {
+        // 1. Wait for rate-limit token
+        const waitMs = await this.rpmLimiter.acquire(1);
+        if (waitMs > 0)
+            this.opts.onRateLimitWait?.(this.inner.name, waitMs);
+        // 2. Run under circuit breaker + retry
+        return await this.breaker.call(async () => {
+            return await (0, retry_js_1.withRetry)(fn, {
+                maxAttempts: this.opts.maxRetries ?? 5,
+                baseDelayMs: 1000,
+                maxDelayMs: 60_000,
+                sleep: this.opts.sleep,
+                onRetry: ({ attempt, delayMs, error }) => {
+                    this.opts.onRetry?.({ provider: this.inner.name, attempt, delayMs, error });
+                    // When a request was throttled, we also know its token cost is
+                    // bounded — give the RPM/TPM budget a chance to recover.
+                    if (error.retryAfterMs && this.tpm && error.tokens) {
+                        this.tpm.record(error.tokens.input + error.tokens.output);
+                    }
+                },
+            });
+        });
+    }
+    recordUsage(usage) {
+        if (!usage)
+            return;
+        this.tpmObserved = true;
+        if (this.tpm)
+            this.tpm.record(usage.inputTokens + usage.outputTokens);
+    }
+    /** TPM helper used by the Google provider to gate heavy requests. */
+    tpmHasRoomFor(n) {
+        return this.tpm ? this.tpm.hasRoomFor(n) : true;
+    }
+    /** Force-open the circuit (e.g. when manually disabling a provider). */
+    trip(reason) {
+        this.breaker.call(async () => { throw new Error(reason); }).catch(() => { });
+    }
+}
+exports.ResilientProvider = ResilientProvider;
+//# sourceMappingURL=resilient.js.map

package/dist/providers/resilient.js.map

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

package/dist/providers/types.d.ts

@@ -0,0 +1,84 @@
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, JSONSchemaProperty>;
+        required?: string[];
+    };
+}
+export interface JSONSchemaProperty {
+    type: string;
+    description?: string;
+    enum?: string[];
+    items?: JSONSchemaProperty;
+    default?: unknown;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResult {
+    id: string;
+    name: string;
+    content: string;
+    isError?: boolean;
+}
+export type HistoryMessage = {
+    role: 'user';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string;
+    toolCalls?: ToolCall[];
+} | {
+    role: 'tool_result';
+    results: ToolResult[];
+};
+export interface LLMResponse {
+    text: string;
+    toolCalls: ToolCall[];
+    stopReason: 'done' | 'tools' | 'limit';
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+export type StreamChunk = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'tool_start';
+    name: string;
+    id: string;
+} | {
+    type: 'tool_input';
+    id: string;
+    partial: string;
+} | {
+    type: 'tool_end';
+    call: ToolCall;
+} | {
+    type: 'done';
+    response: LLMResponse;
+};
+export interface LLMProvider {
+    /** Provider name for display (e.g. "Anthropic", "OpenAI") */
+    name: string;
+    /** Model identifier being used */
+    model: string;
+    /** One-shot completion (no streaming) */
+    complete(system: string, history: HistoryMessage[], tools: ToolDefinition[]): Promise<LLMResponse>;
+    /** Streaming completion — yields chunks as the model generates */
+    stream(system: string, history: HistoryMessage[], tools: ToolDefinition[]): AsyncGenerator<StreamChunk>;
+    /** Whether this provider supports tool use */
+    supportsTools: boolean;
+}
+export interface ProviderConfig {
+    model: string;
+    apiKey?: string;
+    baseUrl?: string;
+    maxTokens?: number;
+    temperature?: number;
+}

package/dist/providers/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool definitions  (provider-agnostic JSON Schema)
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oDAAoD;AACpD,gFAAgF"}