kagent-ts 0.1.0

package/dist/core/plan-solve-agent.js

@@ -0,0 +1,450 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanSolveAgent = void 0;
+const agent_1 = require("./agent");
+const message_1 = require("../messages/message");
+const response_schema_1 = require("./response-schema");
+const openai_provider_1 = require("../llm/openai-provider");
+const preference_manager_1 = require("../preferences/preference-manager");
+/**
+ * Default system prompt for the Plan-and-Solve paradigm.
+ *
+ * The LLM is instructed to separate planning from execution:
+ * 1. Phase 1 — PLAN:   Analyze and create a detailed numbered plan.
+ * 2. Phase 2 — RESOLVE: Work through each step, using tools as needed.
+ *    The plan can be revised mid-execution when new information emerges.
+ * 3. FINAL: When all steps are complete, output the full answer.
+ */
+const DEFAULT_PLAN_SOLVE_SYSTEM_PROMPT = `You are a helpful AI assistant powered by the Plan-and-Resolve paradigm.
+You have access to a set of tools you can use to answer the user's question.
+
+Process:
+1. First, analyze the user's request and create a detailed plan.
+2. Then, work through each step of the plan using tools as needed.
+3. If you encounter unexpected information or tool failures, revise the remaining steps.
+4. When all steps are complete, provide the final answer.
+
+If no tools are needed, respond with the final answer directly.
+
+=== Tool Error Recovery ===
+When a tool returns an error:
+1. READ the error message carefully — understand WHY it failed.
+2. ANALYZE whether the parameters were correct. Common issues:
+   - Wrong file path (check spelling, use absolute paths)
+   - Missing or incorrect arguments
+   - The tool may need different input formats
+3. RETRY with corrected parameters if you can fix the issue.
+4. If the same tool fails repeatedly, try a COMPLETELY DIFFERENT approach.
+5. If a tool fails 2+ times in a row, consider whether your PLAN needs revision.
+   The approach may be fundamentally wrong — output a "revised_plan".
+6. If a tool is disabled after too many failures, DO NOT try to use it again.
+   Find another way to accomplish the task.${response_schema_1.PLAN_SOLVE_INSTRUCTIONS}`;
+/**
+ * Plan-and-Solve Agent implementing a structured Plan → Resolve → Final Answer loop.
+ *
+ * This paradigm separates high-level planning from step-by-step execution:
+ * - **Phase 1 (Plan):**  The LLM analyzes the request and creates a numbered plan.
+ * - **Phase 2 (Resolve):** The LLM executes each step, using tools. The plan is
+ *   injected into the system prompt to keep the LLM focused. If obstacles arise,
+ *   the LLM can output a `revised_plan` to adjust remaining steps.
+ * - **Final:** When all steps are complete, the LLM provides the final answer.
+ *
+ * Compared to ReAct, Plan-and-Solve encourages more deliberate decomposition
+ * up front, reducing the chance of the agent getting lost mid-task.
+ *
+ * Session persistence:
+ * When `enableCheckpointing` is set, the agent auto-saves checkpoints that
+ * include full plan state (current plan, completed steps, replan info) so the
+ * session can be resumed after a network interruption.
+ */
+class PlanSolveAgent extends agent_1.Agent {
+    maxIterations;
+    maxPlanSteps;
+    enableSkillAutoDetect;
+    /** The current plan steps (empty until the plan is created). */
+    currentPlan = [];
+    /** Whether a plan has been created in this run. */
+    hasPlan = false;
+    /**
+     * How many consecutive tool failures before a replan hint is injected.
+     * 0 = disabled (no auto-replanning hints).
+     */
+    replanThreshold;
+    /** Consecutive tool failures in the current run (resets on success). */
+    consecutiveFailures = 0;
+    /** How many plan steps have been completed (used for plan display). */
+    completedSteps = 0;
+    /** Internal flag: when true, run() skips plan state reset (used by resume()). */
+    _skipPlanReset = false;
+    constructor(config) {
+        // Set default Plan-Solve system prompt if none provided
+        const mergedConfig = {
+            ...config,
+            systemPrompt: config.systemPrompt ?? DEFAULT_PLAN_SOLVE_SYSTEM_PROMPT,
+        };
+        super(mergedConfig);
+        this.maxIterations = config.maxIterations ?? 15;
+        this.maxPlanSteps = config.maxPlanSteps ?? 12;
+        this.enableSkillAutoDetect = config.enableSkillAutoDetect ?? true;
+        this.replanThreshold = config.replanThreshold ?? 2;
+        // If skills are registered, rebuild the system prompt so the
+        // available-skills hint is included in the initial prompt.
+        if (this.skillManager.activeCount > 0) {
+            this.rebuildSystemPrompt();
+        }
+    }
+    async run(input) {
+        // ── Phase 0: Progressive disclosure ──────────────────────────────
+        if (this.enableSkillAutoDetect && this.skillManager.activeCount >= 0) {
+            const activated = this.skillManager.detectAndActivate(input);
+            if (activated.length > 0) {
+                this.rebuildSystemPrompt();
+                console.log(`[Skills] Auto-activated: ${activated.join(", ")}`);
+            }
+        }
+        // ── Create user message ─────────────────────────────────────────
+        const userMessage = message_1.Message.user(input);
+        this.contextManager.addMessage(userMessage.toDict());
+        // Reset plan state for this run (skip when resuming a session)
+        if (!this._skipPlanReset) {
+            this.currentPlan = [];
+            this.hasPlan = false;
+            this.consecutiveFailures = 0;
+            this.completedSteps = 0;
+        }
+        this._skipPlanReset = false;
+        // Save initial checkpoint (captures user input before any LLM call)
+        if (this.checkpointingEnabled) {
+            this.saveCheckpoint("active");
+        }
+        // Track consecutive unproductive iterations (no tool calls, no answer)
+        let consecutiveEmptyIterations = 0;
+        const EMPTY_ITERATION_LIMIT = 5;
+        // ── Main Plan-Solve loop ────────────────────────────────────────
+        for (let iteration = 0; iteration < this.maxIterations; iteration++) {
+            // Check if user cancelled (SIGINT)
+            if (this.isCancelled) {
+                this.sessionManager?.deleteSession(this.sessionManager.getSessionId());
+                return "Execution cancelled by user. Session discarded.";
+            }
+            this.checkAndCompress();
+            // Rebuild the system prompt to inject current plan progress
+            // and any replan hint if consecutive failures are detected
+            const replanHint = this.computeReplanHint();
+            this.rebuildContextWithPlan(replanHint);
+            const contextMessages = this.contextManager.getContextMessages();
+            // Call the LLM — with network error handling
+            this.hooks.onLLMStart?.();
+            let response;
+            try {
+                response = await this.llm.chat(contextMessages, this.toolRegistry.getTools());
+            }
+            catch (err) {
+                if (err instanceof openai_provider_1.LLMNetworkError) {
+                    this.hooks.onLLMError?.(err);
+                    return this.handleNetworkError(err, iteration + 1);
+                }
+                throw err;
+            }
+            this.hooks.onLLMEnd?.(response);
+            const parsed = (0, response_schema_1.parsePlanSolveResponse)(response.content);
+            // Create assistant message from the response
+            const assistantMessage = message_1.Message.assistant(response.content, response.tool_calls);
+            this.contextManager.addMessage(assistantMessage.toDict());
+            // ── Handle tool calls (execution phase) ─────────────────────
+            if (response.tool_calls && response.tool_calls.length > 0) {
+                consecutiveEmptyIterations = 0;
+                if (parsed.thought) {
+                    console.log(`[Thought] ${parsed.thought}`);
+                    this.hooks.onThought?.(parsed.thought);
+                    this.captureAnalysisFromThought(parsed.thought);
+                }
+                // Track whether ANY tool in this round failed
+                let roundHadFailure = false;
+                for (const toolCall of response.tool_calls) {
+                    let args;
+                    try {
+                        args = JSON.parse(toolCall.function.arguments);
+                    }
+                    catch {
+                        args = {};
+                    }
+                    this.hooks.onToolStart?.(toolCall.function.name, args);
+                    let result;
+                    try {
+                        result = await this.toolRegistry.execute(toolCall.function.name, args);
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        result = `Error executing tool "${toolCall.function.name}": ${message}`;
+                    }
+                    // Track failure/success for replan detection and hooks
+                    if (result.startsWith("Error")) {
+                        roundHadFailure = true;
+                        this.hooks.onToolError?.(toolCall.function.name, result);
+                    }
+                    else {
+                        this.hooks.onToolEnd?.(toolCall.function.name, result);
+                    }
+                    // Track this result for error analysis if it indicates a failure
+                    this.trackToolErrorForAnalysis(toolCall.function.name, result);
+                    const toolMessage = message_1.Message.tool(result, toolCall.id, toolCall.function.name);
+                    this.contextManager.addMessage(toolMessage.toDict());
+                }
+                // Update consecutive failure count and step progress
+                if (roundHadFailure) {
+                    this.consecutiveFailures++;
+                    console.log(`[Replan] Consecutive failures: ${this.consecutiveFailures}` +
+                        (this.replanThreshold > 0 &&
+                            this.consecutiveFailures >= this.replanThreshold
+                            ? ` — threshold reached (${this.replanThreshold}), will prompt replan`
+                            : ""));
+                }
+                else {
+                    // Reset failure counter on success
+                    this.consecutiveFailures = 0;
+                    // Advance completed steps based on LLM-reported progress
+                    if (parsed.currentStep && this.hasPlan) {
+                        this.completedSteps = Math.max(this.completedSteps, Math.min(parsed.currentStep - 1, this.currentPlan.length));
+                    }
+                    else if (this.hasPlan) {
+                        this.completedSteps = Math.min(this.completedSteps + 1, this.currentPlan.length);
+                    }
+                    if (this.hasPlan) {
+                        console.log(`[Progress] Step ${this.completedSteps}/${this.currentPlan.length} completed`);
+                    }
+                }
+                // Save checkpoint after complete tool execution round
+                if (this.checkpointingEnabled) {
+                    this.saveCheckpoint("active");
+                }
+                // Continue the loop for the next thought
+                continue;
+            }
+            // ── Final answer ────────────────────────────────────────────
+            if (parsed.answer) {
+                if (parsed.thought) {
+                    console.log(`[Thought] ${parsed.thought}`);
+                    this.hooks.onThought?.(parsed.thought);
+                }
+                console.log(`[Plan-Solve] Task complete — returning final answer.`);
+                // Save final checkpoint as completed
+                if (this.checkpointingEnabled) {
+                    this.saveCheckpoint("completed");
+                }
+                this.hooks.onFinish?.(parsed.answer);
+                return parsed.answer;
+            }
+            // ── Initial plan creation ───────────────────────────────────
+            if (!this.hasPlan &&
+                parsed.plan &&
+                Array.isArray(parsed.plan) &&
+                parsed.plan.length > 0) {
+                consecutiveEmptyIterations = 0;
+                this.currentPlan = parsed.plan.slice(0, this.maxPlanSteps);
+                this.hasPlan = true;
+                console.log(`[Plan] Created ${this.currentPlan.length}-step plan:`);
+                for (let i = 0; i < this.currentPlan.length; i++) {
+                    console.log(`  ${i + 1}. ${this.currentPlan[i]}`);
+                }
+                this.hooks.onPlanCreated?.(this.currentPlan);
+                if (parsed.thought) {
+                    console.log(`[Thought] ${parsed.thought}`);
+                    this.hooks.onThought?.(parsed.thought);
+                }
+                continue;
+            }
+            // ── Plan revision ───────────────────────────────────────────
+            if (parsed.revised_plan &&
+                Array.isArray(parsed.revised_plan) &&
+                parsed.revised_plan.length > 0) {
+                consecutiveEmptyIterations = 0;
+                this.currentPlan = parsed.revised_plan.slice(0, this.maxPlanSteps);
+                this.completedSteps = 0; // Remaining steps are now new
+                console.log(`[Plan] Revised — ${this.currentPlan.length} steps remaining:`);
+                for (let i = 0; i < this.currentPlan.length; i++) {
+                    console.log(`  ${i + 1}. ${this.currentPlan[i]}`);
+                }
+                this.hooks.onPlanRevised?.(this.currentPlan);
+                if (parsed.thought) {
+                    console.log(`[Thought] ${parsed.thought}`);
+                    this.hooks.onThought?.(parsed.thought);
+                }
+                continue;
+            }
+            // ── Default: log thought and continue loop ──────────────────
+            if (parsed.thought) {
+                consecutiveEmptyIterations++;
+                console.log(`[Thought] ${parsed.thought}`);
+                this.hooks.onThought?.(parsed.thought);
+                this.captureAnalysisFromThought(parsed.thought);
+                // If stuck in thought-only loop, bail out
+                if (consecutiveEmptyIterations >= EMPTY_ITERATION_LIMIT) {
+                    const stuckMsg = "I apologize, but I'm having difficulty making progress on your request. " +
+                        "Please try rephrasing or breaking it down into smaller, more specific steps.";
+                    const stuckAssistantMessage = message_1.Message.assistant(stuckMsg);
+                    this.contextManager.addMessage(stuckAssistantMessage.toDict());
+                    this.hooks.onFinish?.(stuckMsg);
+                    return stuckMsg;
+                }
+                continue;
+            }
+            // Empty response (no thought, no answer, no tool calls, no plan)
+            consecutiveEmptyIterations++;
+            if (consecutiveEmptyIterations >= EMPTY_ITERATION_LIMIT) {
+                const stuckMsg = "I apologize, but I'm having difficulty making progress on your request. " +
+                    "Please try rephrasing or breaking it down into smaller, more specific steps.";
+                const stuckAssistantMessage = message_1.Message.assistant(stuckMsg);
+                this.contextManager.addMessage(stuckAssistantMessage.toDict());
+                this.hooks.onFinish?.(stuckMsg);
+                return stuckMsg;
+            }
+        }
+        // ── Max iterations reached without final answer ──────────────
+        const timeoutMsg = `I apologize, but I was unable to complete the task within ${this.maxIterations} iterations. ` +
+            `Please try breaking your request into smaller steps.`;
+        const timeoutAssistantMessage = message_1.Message.assistant(timeoutMsg);
+        this.contextManager.addMessage(timeoutAssistantMessage.toDict());
+        return timeoutMsg;
+    }
+    // ─── Session Persistence Overrides ───────────────────────────────────
+    /**
+     * Agent type identifier for session metadata.
+     */
+    getAgentType() {
+        return "plan-solve";
+    }
+    /**
+     * Include plan state in session checkpoints.
+     */
+    buildBaseSessionState(status) {
+        const base = super.buildBaseSessionState(status);
+        return {
+            ...base,
+            planState: {
+                currentPlan: this.currentPlan,
+                hasPlan: this.hasPlan,
+                completedSteps: this.completedSteps,
+                consecutiveFailures: this.consecutiveFailures,
+            },
+        };
+    }
+    /**
+     * Restore plan state from a saved session.
+     */
+    loadAndRestoreSession(sessionId) {
+        const state = super.loadAndRestoreSession(sessionId);
+        if (state.planState) {
+            this.currentPlan = state.planState.currentPlan;
+            this.hasPlan = state.planState.hasPlan;
+            this.completedSteps = state.planState.completedSteps;
+            this.consecutiveFailures = state.planState.consecutiveFailures;
+        }
+        return state;
+    }
+    // ─── Resume ──────────────────────────────────────────────────────────
+    /**
+     * Resume a previously interrupted session.
+     *
+     * Restores messages, system prompt, and plan state so the agent can
+     * continue from where it left off.
+     *
+     * @param sessionId The session ID to resume.
+     * @param input     New user input to continue the conversation.
+     */
+    async resume(sessionId, input) {
+        this.loadAndRestoreSession(sessionId);
+        // Signal run() to preserve the restored plan state
+        this._skipPlanReset = true;
+        return this.run(input);
+    }
+    // ─── Private Helpers ─────────────────────────────────────────────────
+    /**
+     * Handle an LLMNetworkError: save an interrupted checkpoint if
+     * checkpointing is enabled, and return a user-facing message with
+     * resume instructions.
+     */
+    handleNetworkError(err, iteration) {
+        if (this.checkpointingEnabled) {
+            this.saveCheckpoint("interrupted");
+        }
+        const sid = this.sessionManager?.getSessionId() ?? "unknown";
+        console.error(`\n[Network Error] ${err.cause}: ${err.message}`);
+        if (this.checkpointingEnabled && this.sessionManager) {
+            return (`[Network Error] ${err.message}\n\n` +
+                `Your session "${sid}" has been saved (iteration ${iteration}).\n` +
+                `After your network is restored, resume with:\n` +
+                `  agent.resume("${sid}", "continue with what you were doing")\n\n` +
+                `Or start a new session by calling agent.run() again.`);
+        }
+        return (`[Network Error] ${err.message}\n\n` +
+            `Please check your network connection and try again.`);
+    }
+    // ─── Plan Context Injection ─────────────────────────────────────────────
+    /**
+     * Rebuild the system prompt to include the current plan context
+     * alongside the core prompt and active skill prompts.
+     *
+     * Called each iteration so the LLM always sees the up-to-date plan.
+     *
+     * @param replanHint Optional hint injected when consecutive tool
+     *                   failures exceed the threshold, nudging the LLM
+     *                   to consider revising its plan.
+     */
+    rebuildContextWithPlan(replanHint) {
+        let prompt = this.coreSystemPrompt;
+        // User preferences — injected as a system-prompt section
+        prompt += preference_manager_1.PreferenceManager.toPrompt(this.preferences);
+        // Available skills hint (progressive disclosure — names only)
+        prompt += this.skillManager.buildAvailableSkillsHint();
+        // Plan context — injected when a plan exists
+        if (this.hasPlan && this.currentPlan.length > 0) {
+            prompt += `\n\n=== Current Plan (${this.completedSteps}/${this.currentPlan.length} completed) ===\n`;
+            for (let i = 0; i < this.currentPlan.length; i++) {
+                const marker = i < this.completedSteps
+                    ? "✅"
+                    : i === this.completedSteps
+                        ? "➡️"
+                        : "  ";
+                prompt += `  ${marker} ${i + 1}. ${this.currentPlan[i]}\n`;
+            }
+            prompt +=
+                `\nWork through the plan step by step. ` +
+                    `When you complete a step, move to the next one. ` +
+                    `If you need to revise remaining steps, output a "revised_plan".`;
+        }
+        // Replan hint — injected when consecutive failures are detected
+        if (replanHint) {
+            prompt += `\n\n${replanHint}`;
+        }
+        // Active skill instructions
+        prompt += this.skillManager.buildSkillsPrompt();
+        this.contextManager.setSystemMessage(prompt);
+    }
+    /**
+     * Compute a replan hint based on the current consecutive failure count.
+     *
+     * When consecutive failures reach the configured threshold, a message is
+     * returned that will be appended to the system prompt, nudging the LLM
+     * to consider revising its plan rather than continuing with a failing approach.
+     *
+     * Returns undefined when no hint is needed (failures below threshold
+     * or auto-replan is disabled).
+     */
+    computeReplanHint() {
+        if (this.replanThreshold <= 0)
+            return undefined;
+        if (!this.hasPlan)
+            return undefined;
+        if (this.consecutiveFailures >= this.replanThreshold) {
+            return (`⚠️ REPLAN SUGGESTED: Multiple consecutive tool failures detected (${this.consecutiveFailures}).\n` +
+                `The current approach may be fundamentally wrong.\n` +
+                `Please consider whether your plan needs revision. If so, output a "revised_plan" ` +
+                `with a new strategy for the remaining steps. Only the REMAINING steps — ` +
+                `do NOT re-list already completed steps.`);
+        }
+        return undefined;
+    }
+}
+exports.PlanSolveAgent = PlanSolveAgent;
+//# sourceMappingURL=plan-solve-agent.js.map

package/dist/core/plan-solve-agent.js.map

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

package/dist/core/react-agent.d.ts

@@ -0,0 +1,52 @@
+import { Agent, AgentConfig } from "./agent";
+/**
+ * Configuration specific to the ReAct Agent.
+ */
+export interface ReActAgentConfig extends AgentConfig {
+    /** Maximum iterations for the ReAct loop (default: 10). */
+    maxIterations?: number;
+    /**
+     * Enable progressive skill disclosure.
+     * When true, skills are auto-detected from user input and loaded
+     * into the system prompt on demand (default: true).
+     */
+    enableSkillAutoDetect?: boolean;
+}
+/**
+ * ReAct Agent implementing a structured Thought → Action → Observation → Final Answer loop.
+ *
+ * The agent uses structured JSON output from the LLM:
+ * - Intermediate steps:  {"thought": "..."}
+ * - Final answer:        {"thought": "...", "answer": "..."}
+ * - Tool calls via native function calling (OpenAI tool_calls)
+ *
+ * Session persistence:
+ * When `enableCheckpointing` is set, the agent auto-saves checkpoints after
+ * each LLM+tools cycle. On network error, an `interrupted` checkpoint is
+ * saved so the user can resume later via `agent.resume(sessionId, input)`.
+ */
+export declare class ReActAgent extends Agent {
+    private maxIterations;
+    private enableSkillAutoDetect;
+    constructor(config: ReActAgentConfig);
+    run(input: string): Promise<string>;
+    /**
+     * Resume a previously interrupted session.
+     *
+     * Loads the saved session state (messages, system prompt) so the agent
+     * can continue from where it left off. The `input` is treated as a new
+     * user message appended to the restored conversation.
+     *
+     * @param sessionId The session ID to resume.
+     * @param input     New user input to continue the conversation.
+     * @returns The agent's final response.
+     */
+    resume(sessionId: string, input: string): Promise<string>;
+    /**
+     * Handle an LLMNetworkError: save an interrupted checkpoint if
+     * checkpointing is enabled, and return a user-facing message with
+     * resume instructions.
+     */
+    private handleNetworkError;
+}
+//# sourceMappingURL=react-agent.d.ts.map

package/dist/core/react-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-agent.d.ts","sourceRoot":"","sources":["../../src/core/react-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAyC7C;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,qBAAqB,CAAU;gBAE3B,MAAM,EAAE,gBAAgB;IAkB9B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2MzC;;;;;;;;;;OAUG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO/D;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;CA2B3B"}