@agents-eco/reasoning 0.1.0

package/dist/backends/openai.js

@@ -0,0 +1,83 @@
+/**
+ * OpenAI-compatible LLM backend.
+ * Works with OpenAI, Venice, Groq, Ollama, agents.eco, or any compatible API.
+ */
+export class OpenAIBackend {
+    name;
+    apiKey;
+    baseUrl;
+    model;
+    constructor(config) {
+        this.name = config.name ?? "openai";
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl.replace(/\/$/, "");
+        this.model = config.model;
+    }
+    async complete(messages, options) {
+        const body = {
+            model: this.model,
+            messages: messages.map((m) => {
+                const msg = { role: m.role, content: m.content };
+                if (m.name)
+                    msg.name = m.name;
+                if (m.tool_calls)
+                    msg.tool_calls = m.tool_calls;
+                if (m.tool_call_id)
+                    msg.tool_call_id = m.tool_call_id;
+                return msg;
+            }),
+            temperature: options?.temperature ?? 0.3,
+            max_tokens: options?.maxTokens ?? 2048,
+        };
+        if (options?.stop)
+            body.stop = options.stop;
+        const res = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...(this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}),
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            throw new Error(`LLM API error (${res.status}): ${errText}`);
+        }
+        const data = await res.json();
+        const choice = data.choices[0];
+        const toolCalls = choice.message.tool_calls?.map((tc) => ({
+            name: tc.function.name,
+            arguments: JSON.parse(tc.function.arguments),
+        }));
+        return {
+            content: choice.message.content ?? "",
+            toolCalls,
+            tokens: data.usage
+                ? { prompt: data.usage.prompt_tokens, completion: data.usage.completion_tokens }
+                : undefined,
+            finishReason: choice.finish_reason,
+        };
+    }
+}
+// ── Pre-configured backends ─────────────────────────────
+export function openaiBackend(apiKey, model = "gpt-4o") {
+    return new OpenAIBackend({ name: "openai", apiKey, baseUrl: "https://api.openai.com/v1", model });
+}
+export function veniceBackend(apiKey, model = "qwen3-4b") {
+    return new OpenAIBackend({ name: "venice", apiKey, baseUrl: "https://api.venice.ai/api/v1", model });
+}
+export function groqBackend(apiKey, model = "llama-3.3-70b-versatile") {
+    return new OpenAIBackend({ name: "groq", apiKey, baseUrl: "https://api.groq.com/openai/v1", model });
+}
+export function ollamaBackend(model = "llama3.2", baseUrl = "http://localhost:11434/v1") {
+    return new OpenAIBackend({ name: "ollama", apiKey: "", baseUrl, model });
+}
+export function agentsEcoBackend(apiKey, model = "qwen3-4b") {
+    return new OpenAIBackend({
+        name: "agents.eco",
+        apiKey,
+        baseUrl: "https://agents-eco-dfc6baa9f955.herokuapp.com/v1",
+        model,
+    });
+}
+//# sourceMappingURL=openai.js.map

package/dist/backends/openai.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,63 @@
+import type { ReasoningConfig, ReasoningResult, ReasoningStrategy, StrategyType, ToolDef, ToolHandler, LLMBackend, ReasoningHooks, ToTConfig } from "./types.js";
+/**
+ * ReasoningEngine — the main entry point for agent reasoning.
+ *
+ * Supports multiple strategies:
+ * - ReAct: multi-step reason-act loop with tool calling
+ * - CoT: chain-of-thought with optional self-reflection
+ * - ToT: tree-of-thought with beam search and branch scoring
+ *
+ * Usage:
+ * ```ts
+ * const engine = new ReasoningEngine(backend, { strategy: "react", maxSteps: 10 });
+ * engine.tool("search", { name: "search", description: "...", parameters: {} }, handler);
+ * const result = await engine.reason("What is the capital of France?");
+ * ```
+ */
+export declare class ReasoningEngine {
+    private backend;
+    private config;
+    private tools;
+    private strategies;
+    private systemPrompt;
+    constructor(backend: LLMBackend, config?: Partial<ReasoningConfig>, systemPrompt?: string);
+    /** Set the system prompt */
+    setSystemPrompt(prompt: string): this;
+    /** Set the LLM backend */
+    setBackend(backend: LLMBackend): this;
+    /** Update configuration */
+    configure(config: Partial<ReasoningConfig>): this;
+    /** Set event hooks */
+    hooks(hooks: ReasoningHooks): this;
+    /** Register a tool */
+    tool(name: string, def: ToolDef, handler: ToolHandler): this;
+    /** Register multiple tools */
+    addTools(toolMap: Record<string, {
+        def: ToolDef;
+        handler: ToolHandler;
+    }>): this;
+    /** Remove a tool */
+    removeTool(name: string): this;
+    /**
+     * Run reasoning on a task.
+     * Uses the configured strategy (ReAct, CoT, or ToT).
+     */
+    reason(task: string, overrides?: Partial<ReasoningConfig>): Promise<ReasoningResult>;
+    /**
+     * Run ReAct reasoning (convenience method).
+     */
+    react(task: string, overrides?: Partial<ReasoningConfig>): Promise<ReasoningResult>;
+    /**
+     * Run Chain-of-Thought reasoning (convenience method).
+     */
+    chainOfThought(task: string, overrides?: Partial<ReasoningConfig>): Promise<ReasoningResult>;
+    /**
+     * Run Tree-of-Thought reasoning (convenience method).
+     */
+    treeOfThought(task: string, overrides?: Partial<ToTConfig>): Promise<ReasoningResult>;
+    /** Register a custom reasoning strategy */
+    registerStrategy(strategy: ReasoningStrategy): this;
+    /** Get available strategy names */
+    getStrategies(): StrategyType[];
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,WAAW,EACX,UAAU,EACV,cAAc,EACd,SAAS,EACV,MAAM,YAAY,CAAC;AAapB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAkE;IAC/E,OAAO,CAAC,UAAU,CAAmD;IACrE,OAAO,CAAC,YAAY,CAAS;gBAG3B,OAAO,EAAE,UAAU,EACnB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,EACjC,YAAY,CAAC,EAAE,MAAM;IAcvB,4BAA4B;IAC5B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKrC,0BAA0B;IAC1B,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAKrC,2BAA2B;IAC3B,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAKjD,sBAAsB;IACtB,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAOlC,sBAAsB;IACtB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAK5D,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC,GAAG,IAAI;IAO/E,oBAAoB;IACpB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO9B;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAW1F;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzF;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAIlG;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAa3F,2CAA2C;IAC3C,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAKnD,mCAAmC;IACnC,aAAa,IAAI,YAAY,EAAE;CAGhC"}

package/dist/engine.js

@@ -0,0 +1,132 @@
+import { ReActStrategy } from "./strategies/react.js";
+import { ChainOfThoughtStrategy } from "./strategies/cot.js";
+import { TreeOfThoughtStrategy } from "./strategies/tot.js";
+const DEFAULT_CONFIG = {
+    strategy: "react",
+    maxSteps: 10,
+    temperature: 0.3,
+    reflection: false,
+    planning: false,
+    planInterval: 3,
+    minConfidence: 0.5,
+    verbose: false,
+};
+/**
+ * ReasoningEngine — the main entry point for agent reasoning.
+ *
+ * Supports multiple strategies:
+ * - ReAct: multi-step reason-act loop with tool calling
+ * - CoT: chain-of-thought with optional self-reflection
+ * - ToT: tree-of-thought with beam search and branch scoring
+ *
+ * Usage:
+ * ```ts
+ * const engine = new ReasoningEngine(backend, { strategy: "react", maxSteps: 10 });
+ * engine.tool("search", { name: "search", description: "...", parameters: {} }, handler);
+ * const result = await engine.reason("What is the capital of France?");
+ * ```
+ */
+export class ReasoningEngine {
+    backend;
+    config;
+    tools = new Map();
+    strategies = new Map();
+    systemPrompt;
+    constructor(backend, config, systemPrompt) {
+        this.backend = backend;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.systemPrompt = systemPrompt ?? "You are a helpful reasoning agent.";
+        // Register built-in strategies
+        this.strategies.set("react", new ReActStrategy());
+        this.strategies.set("cot", new ChainOfThoughtStrategy());
+        this.strategies.set("tot", new TreeOfThoughtStrategy());
+    }
+    // ── Configuration ───────────────────────────────────
+    /** Set the system prompt */
+    setSystemPrompt(prompt) {
+        this.systemPrompt = prompt;
+        return this;
+    }
+    /** Set the LLM backend */
+    setBackend(backend) {
+        this.backend = backend;
+        return this;
+    }
+    /** Update configuration */
+    configure(config) {
+        this.config = { ...this.config, ...config };
+        return this;
+    }
+    /** Set event hooks */
+    hooks(hooks) {
+        this.config.hooks = hooks;
+        return this;
+    }
+    // ── Tools ───────────────────────────────────────────
+    /** Register a tool */
+    tool(name, def, handler) {
+        this.tools.set(name, { def, handler });
+        return this;
+    }
+    /** Register multiple tools */
+    addTools(toolMap) {
+        for (const [name, entry] of Object.entries(toolMap)) {
+            this.tools.set(name, entry);
+        }
+        return this;
+    }
+    /** Remove a tool */
+    removeTool(name) {
+        this.tools.delete(name);
+        return this;
+    }
+    // ── Reasoning ───────────────────────────────────────
+    /**
+     * Run reasoning on a task.
+     * Uses the configured strategy (ReAct, CoT, or ToT).
+     */
+    async reason(task, overrides) {
+        const config = { ...this.config, ...overrides };
+        const strategy = this.strategies.get(config.strategy);
+        if (!strategy) {
+            throw new Error(`Unknown strategy: ${config.strategy}. Available: ${Array.from(this.strategies.keys()).join(", ")}`);
+        }
+        return strategy.reason(task, this.systemPrompt, this.tools, config, this.backend);
+    }
+    /**
+     * Run ReAct reasoning (convenience method).
+     */
+    async react(task, overrides) {
+        return this.reason(task, { ...overrides, strategy: "react" });
+    }
+    /**
+     * Run Chain-of-Thought reasoning (convenience method).
+     */
+    async chainOfThought(task, overrides) {
+        return this.reason(task, { ...overrides, strategy: "cot" });
+    }
+    /**
+     * Run Tree-of-Thought reasoning (convenience method).
+     */
+    async treeOfThought(task, overrides) {
+        return this.reason(task, {
+            ...overrides,
+            strategy: "tot",
+            branchFactor: overrides?.branchFactor ?? 3,
+            maxDepth: overrides?.maxDepth ?? 4,
+            beamWidth: overrides?.beamWidth ?? 2,
+            scoringMethod: overrides?.scoringMethod ?? "llm",
+        });
+    }
+    // ── Custom Strategies ───────────────────────────────
+    /** Register a custom reasoning strategy */
+    registerStrategy(strategy) {
+        this.strategies.set(strategy.name, strategy);
+        return this;
+    }
+    /** Get available strategy names */
+    getStrategies() {
+        return Array.from(this.strategies.keys());
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { ReasoningEngine } from "./engine.js";
+export { ReActStrategy } from "./strategies/react.js";
+export { ChainOfThoughtStrategy } from "./strategies/cot.js";
+export { TreeOfThoughtStrategy } from "./strategies/tot.js";
+export { OpenAIBackend, openaiBackend, veniceBackend, groqBackend, ollamaBackend, agentsEcoBackend, } from "./backends/openai.js";
+export { HuggingFaceBackend, hfInferenceBackend, hfEndpointBackend, tgiBackend, SMOLAGENTS_MODELS, } from "./backends/huggingface.js";
+export type { ReasoningStep, StepType, ToolCall, ToolResult, ToolDef, ToolHandler, ReasoningConfig, ReasoningHooks, StrategyType, ReasoningResult, ThoughtBranch, ToTConfig, LLMBackend, ChatMessage, CompletionOptions, LLMResponse, ReasoningStrategy, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EACX,aAAa,EACb,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EAEV,aAAa,EACb,QAAQ,EAER,QAAQ,EACR,UAAU,EACV,OAAO,EACP,WAAW,EAEX,eAAe,EACf,cAAc,EACd,YAAY,EAEZ,eAAe,EAEf,aAAa,EACb,SAAS,EAET,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,WAAW,EAEX,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// ── Core ────────────────────────────────────────────────
+export { ReasoningEngine } from "./engine.js";
+// ── Strategies ──────────────────────────────────────────
+export { ReActStrategy } from "./strategies/react.js";
+export { ChainOfThoughtStrategy } from "./strategies/cot.js";
+export { TreeOfThoughtStrategy } from "./strategies/tot.js";
+// ── Backends ────────────────────────────────────────────
+export { OpenAIBackend, openaiBackend, veniceBackend, groqBackend, ollamaBackend, agentsEcoBackend, } from "./backends/openai.js";
+export { HuggingFaceBackend, hfInferenceBackend, hfEndpointBackend, tgiBackend, SMOLAGENTS_MODELS, } from "./backends/huggingface.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,2DAA2D;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,2DAA2D;AAC3D,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EACX,aAAa,EACb,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,iBAAiB,GAClB,MAAM,2BAA2B,CAAC"}

package/dist/strategies/cot.d.ts

@@ -0,0 +1,18 @@
+import type { ReasoningStrategy, ReasoningConfig, ReasoningResult, ToolDef, ToolHandler, LLMBackend } from "../types.js";
+/**
+ * Chain-of-Thought (CoT) strategy.
+ *
+ * Prompts the LLM to break down reasoning into explicit sequential steps.
+ * Supports optional self-reflection where the model reviews its own chain.
+ */
+export declare class ChainOfThoughtStrategy implements ReasoningStrategy {
+    readonly name: "cot";
+    reason(task: string, systemPrompt: string, tools: Map<string, {
+        def: ToolDef;
+        handler: ToolHandler;
+    }>, config: ReasoningConfig, backend: LLMBackend): Promise<ReasoningResult>;
+    private parseChain;
+    private selfReflect;
+    private buildResult;
+}
+//# sourceMappingURL=cot.d.ts.map

package/dist/strategies/cot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cot.d.ts","sourceRoot":"","sources":["../../src/strategies/cot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EAEf,OAAO,EACP,WAAW,EACX,UAAU,EAEX,MAAM,aAAa,CAAC;AAwBrB;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAEzB,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC,EAC1D,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,eAAe,CAAC;IAmG3B,OAAO,CAAC,UAAU;YAyBJ,WAAW;IA4DzB,OAAO,CAAC,WAAW;CAoBpB"}

package/dist/strategies/cot.js

@@ -0,0 +1,198 @@
+import { randomUUID } from "node:crypto";
+const COT_SYSTEM_SUFFIX = `
+
+You are a reasoning agent that solves tasks using Chain-of-Thought reasoning.
+
+Break down the problem into clear, logical steps. Think through each step carefully before moving to the next.
+
+Format your response as a series of numbered reasoning steps:
+
+Step 1: <reasoning>
+Step 2: <reasoning>
+...
+Step N: <reasoning>
+
+Final Answer: <your answer>
+
+Rules:
+- Show your work. Each step should build on the previous one.
+- If you realize a step was wrong, explicitly correct it.
+- Be precise and avoid skipping logical steps.
+- State assumptions clearly.
+`;
+/**
+ * Chain-of-Thought (CoT) strategy.
+ *
+ * Prompts the LLM to break down reasoning into explicit sequential steps.
+ * Supports optional self-reflection where the model reviews its own chain.
+ */
+export class ChainOfThoughtStrategy {
+    name = "cot";
+    async reason(task, systemPrompt, tools, config, backend) {
+        const startTime = Date.now();
+        const steps = [];
+        let totalPromptTokens = 0;
+        let totalCompletionTokens = 0;
+        let llmCalls = 0;
+        const fullSystemPrompt = systemPrompt + COT_SYSTEM_SUFFIX;
+        const messages = [
+            { role: "system", content: fullSystemPrompt },
+            { role: "user", content: task },
+        ];
+        // Initial CoT generation
+        const stepStart = Date.now();
+        let response;
+        try {
+            response = await backend.complete(messages, {
+                temperature: config.temperature ?? 0.3,
+                maxTokens: 4096,
+            });
+        }
+        catch (err) {
+            const errorStep = {
+                id: randomUUID(),
+                index: 0,
+                type: "error",
+                content: `LLM call failed: ${err}`,
+                confidence: 0,
+                durationMs: Date.now() - stepStart,
+                timestamp: new Date().toISOString(),
+                metadata: {},
+            };
+            steps.push(errorStep);
+            return this.buildResult("", steps, startTime, 0, 0, 1, false);
+        }
+        llmCalls++;
+        totalPromptTokens += response.tokens?.prompt ?? 0;
+        totalCompletionTokens += response.tokens?.completion ?? 0;
+        // Parse the chain of thought into individual steps
+        const parsedSteps = this.parseChain(response.content);
+        for (const parsed of parsedSteps) {
+            const step = {
+                id: randomUUID(),
+                index: steps.length,
+                type: parsed.type,
+                content: parsed.content,
+                confidence: parsed.type === "answer" ? 0.85 : 0.7,
+                durationMs: Date.now() - stepStart,
+                timestamp: new Date().toISOString(),
+                metadata: {},
+            };
+            steps.push(step);
+            if (parsed.type === "thought")
+                await config.hooks?.onThought?.(parsed.content);
+            if (parsed.type === "answer")
+                await config.hooks?.onAnswer?.(parsed.content);
+            await config.hooks?.onStep?.(step);
+        }
+        messages.push({ role: "assistant", content: response.content });
+        // Optional self-reflection pass
+        if (config.reflection) {
+            const reflectionResult = await this.selfReflect(messages, backend, config, steps);
+            llmCalls += reflectionResult.llmCalls;
+            totalPromptTokens += reflectionResult.promptTokens;
+            totalCompletionTokens += reflectionResult.completionTokens;
+            // If reflection produced a revised answer, use it
+            if (reflectionResult.revisedAnswer) {
+                const revisionStep = {
+                    id: randomUUID(),
+                    index: steps.length,
+                    type: "revision",
+                    content: reflectionResult.revisedAnswer,
+                    confidence: 0.9,
+                    durationMs: Date.now() - stepStart,
+                    timestamp: new Date().toISOString(),
+                    metadata: { reflectionTriggered: true },
+                };
+                steps.push(revisionStep);
+                await config.hooks?.onStep?.(revisionStep);
+                return this.buildResult(reflectionResult.revisedAnswer, steps, startTime, totalPromptTokens, totalCompletionTokens, llmCalls, true);
+            }
+        }
+        // Extract final answer
+        const answerStep = steps.find((s) => s.type === "answer");
+        const answer = answerStep?.content ?? response.content;
+        return this.buildResult(answer, steps, startTime, totalPromptTokens, totalCompletionTokens, llmCalls, true);
+    }
+    // ── Helpers ─────────────────────────────────────────
+    parseChain(content) {
+        const results = [];
+        // Extract numbered steps
+        const stepPattern = /Step\s+\d+:\s*([\s\S]*?)(?=Step\s+\d+:|Final Answer:|$)/gi;
+        let match;
+        while ((match = stepPattern.exec(content)) !== null) {
+            const text = match[1].trim();
+            if (text)
+                results.push({ type: "thought", content: text });
+        }
+        // Extract final answer
+        const answerMatch = content.match(/Final Answer:\s*([\s\S]*?)$/i);
+        if (answerMatch) {
+            results.push({ type: "answer", content: answerMatch[1].trim() });
+        }
+        // If no structured format found, treat the whole thing as one thought
+        if (results.length === 0) {
+            results.push({ type: "thought", content: content.trim() });
+        }
+        return results;
+    }
+    async selfReflect(messages, backend, config, steps) {
+        const reflectionMessages = [
+            ...messages,
+            {
+                role: "user",
+                content: `Review your reasoning chain above. Check for:
+1. Logical errors or gaps
+2. Incorrect assumptions
+3. Missing considerations
+4. Whether the final answer follows from the reasoning
+
+If you find issues, provide a corrected answer prefixed with "Revised Answer:".
+If the reasoning is sound, respond with "Reasoning verified. No changes needed."`,
+            },
+        ];
+        try {
+            const response = await backend.complete(reflectionMessages, {
+                temperature: 0.2,
+                maxTokens: 1024,
+            });
+            const reflectionStep = {
+                id: randomUUID(),
+                index: steps.length,
+                type: "reflection",
+                content: response.content,
+                confidence: 0.8,
+                durationMs: 0,
+                tokens: response.tokens,
+                timestamp: new Date().toISOString(),
+                metadata: {},
+            };
+            steps.push(reflectionStep);
+            await config.hooks?.onReflection?.(response.content);
+            await config.hooks?.onStep?.(reflectionStep);
+            const revisedMatch = response.content.match(/Revised Answer:\s*([\s\S]*?)$/i);
+            return {
+                revisedAnswer: revisedMatch ? revisedMatch[1].trim() : undefined,
+                llmCalls: 1,
+                promptTokens: response.tokens?.prompt ?? 0,
+                completionTokens: response.tokens?.completion ?? 0,
+            };
+        }
+        catch {
+            return { llmCalls: 0, promptTokens: 0, completionTokens: 0 };
+        }
+    }
+    buildResult(answer, steps, startTime, promptTokens, completionTokens, llmCalls, success) {
+        return {
+            answer,
+            steps,
+            strategy: "cot",
+            durationMs: Date.now() - startTime,
+            tokens: { prompt: promptTokens, completion: completionTokens, total: promptTokens + completionTokens },
+            llmCalls,
+            toolCalls: 0,
+            success,
+        };
+    }
+}
+//# sourceMappingURL=cot.js.map

package/dist/strategies/cot.js.map

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

package/dist/strategies/react.d.ts

@@ -0,0 +1,21 @@
+import type { ReasoningStrategy, ReasoningConfig, ReasoningResult, ToolDef, ToolHandler, LLMBackend } from "../types.js";
+/**
+ * ReAct (Reason + Act) strategy.
+ *
+ * Implements the multi-step reasoning loop from SmolAgents / Yao et al. 2022.
+ * Each step: Thought -> Action -> Observation, with optional reflection and planning.
+ */
+export declare class ReActStrategy implements ReasoningStrategy {
+    readonly name: "react";
+    reason(task: string, systemPrompt: string, tools: Map<string, {
+        def: ToolDef;
+        handler: ToolHandler;
+    }>, config: ReasoningConfig, backend: LLMBackend): Promise<ReasoningResult>;
+    private parseResponse;
+    private buildToolDescriptions;
+    private reflectStep;
+    private planStep;
+    private makeStep;
+    private buildResult;
+}
+//# sourceMappingURL=react.d.ts.map

package/dist/strategies/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/strategies/react.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EAEf,OAAO,EACP,WAAW,EAEX,UAAU,EAEX,MAAM,aAAa,CAAC;AA2CrB;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,iBAAiB;IACrD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAE3B,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC,EAC1D,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,eAAe,CAAC;IAmM3B,OAAO,CAAC,aAAa;IA0CrB,OAAO,CAAC,qBAAqB;YAaf,WAAW;YA6BX,QAAQ;IA6BtB,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,WAAW;CAqBpB"}