@vietor/easy-agent 0.3.1 → 0.4.1

package/README.md

@@ -1,10 +1,6 @@
-# Easy Agent
+# @vietor/easy-agent
 
-![](https://img.shields.io/badge/Node.js-22%2B-brightgreen?style=flat-square) [![npm]](https://www.npmjs.com/package/@vietor/easy-agent)
-
-[npm]: https://img.shields.io/npm/v/@vietor/easy-agent.svg?style=flat-square
-
-An autonomous coding agent in the terminal.
+Terminal-based AI agent CLI with a conversational TUI, powered by `@vietor/easy-agent-core`.
 
 ## Requirements
 
@@ -12,7 +8,7 @@ An autonomous coding agent in the terminal.
 
 ## Install
 
-Install globally with npm:
+Install globally:
 
 ```bash
 npm install -g @vietor/easy-agent
@@ -31,18 +27,18 @@ Create `~/.easy-agent.json` in your home directory:
 ```json
 {
   "llm": {
-    "baseUrl": "https://api.example.com/v1",
+    "baseUrl": "https://api.openai.com/v1",
     "apiKey": "your-api-key",
-    "model": "your-model"
+    "model": "gpt-4o"
   }
 }
 ```
 
 `llm.baseUrl`, `llm.apiKey`, and `llm.model` are all required. Point `baseUrl` at any OpenAI-compatible endpoint (OpenAI, Azure OpenAI, local servers, etc.) and set `model` to a model that endpoint serves.
 
-### Optional: MCP servers
+### MCP servers (optional)
 
-Add an `mcpServers` map to expose external tools through the Model Context Protocol. Each entry is either a local process (stdio) or a remote endpoint (SSE / Streamable HTTP):
+Add an `mcpServers` map to expose external tools through the Model Context Protocol. Each entry is either a local process (stdio) or a remote endpoint (Streamable HTTP):
 
 ```json
 {
@@ -52,7 +48,7 @@ Add an `mcpServers` map to expose external tools through the Model Context Proto
       "command": "npx",
       "args": ["chrome-devtools-mcp@latest", "--auto-connect", "--accept-insecure-certs"]
     },
-    "remote-server": {
+    "api-server": {
       "type": "http",
       "url": "https://mcp.example.com/mcp",
       "headers": { "Authorization": "Bearer your-token" }
@@ -61,9 +57,9 @@ Add an `mcpServers` map to expose external tools through the Model Context Proto
 }
 ```
 
-A stdio server omits `type` (or sets `"stdio"`); only `command` is required, `args` and `env` are optional. A remote server sets `type` to `"sse"` or `"http"` with a required `url`; `headers` is optional and sent with every request (use it for static auth tokens). Either entry accepts an optional `enabled` (defaults to `true`); set `false` to keep a server configured but skip starting it. MCP tools become available to the agent as `MCP__<server>__<tool>`. If a server fails to connect within 30s, it is disabled and the error is shown in the TUI — for stdio servers the captured stderr tail is included to help diagnose startup failures — and the rest keep running.
+A stdio server omits `type` (or sets `"stdio"`); only `command` is required, `args` and `env` are optional. A remote server sets `type` to `"http"` with a required `url`; `headers` is optional and sent with every request (use it for static auth tokens). Either entry accepts an optional `enabled` (defaults to `true`); set `false` to keep a server configured but skip starting it. MCP tools become available to the agent as `MCP__<server>__<tool>`. If a server fails to connect within 30s, it is disabled and the error is shown in the TUI — for stdio servers the captured stderr tail is included to help diagnose startup failures — and the rest keep running.
 
-### Optional: Agent instructions
+### Agent instructions (optional)
 
 Easy Agent reads instructions files and appends them to the system prompt, so you can set persistent rules, conventions, or preferences. It looks in two places:
 
@@ -72,7 +68,7 @@ Easy Agent reads instructions files and appends them to the system prompt, so yo
 
 Both global and project files are loaded and concatenated into the system prompt if they exist.
 
-### Optional: Skills
+### Skills (optional)
 
 Skills are reusable prompts that register themselves as slash commands. Create a subdirectory for each skill under `~/.agents/skills/` (or `~/.claude/skills/`) with a `SKILL.md` file:
 
@@ -107,7 +103,7 @@ easy-agent
 
 Type a prompt and press Enter. The agent streams its reply and calls tools as needed, showing each tool call and a one-line preview of its result. It iterates until the task is done (capped at 50 tool rounds per turn).
 
-Built-in tools:
+### Built-in tools
 
 - **Shell** — run shell commands using this platform's native syntax.
 - **FileRead** — read a file with line numbers; supports `offset`/`limit` for paging large files.
@@ -117,11 +113,24 @@ Built-in tools:
 - **Grep** — search file contents by regex with `glob`/`type` filters, context lines, case-insensitive, and `files_with_matches`/`count` output modes.
 - **WebFetch** — fetch a URL as markdown or text.
 - **AskUser** — ask the user a question and wait for their answer.
+- **TodoWrite** — track multi-step work as a task list (pending / in_progress / completed), shown live as a panel in the TUI.
+
+### Slash commands
 
-Slash commands:
+| Command | Description |
+|---------|-------------|
+| `/mcp` | List linked MCP servers, their status, and exposed tools |
+| `/clear` | Reset the conversation |
+| `/compact` | Compress the conversation into a summary to free context |
+| `/export` | Save the current conversation to `conversation-{timestamp}.jsonl` |
+| `/quit` or `/exit` | Leave the app |
 
-- `/mcp` — list linked MCP servers, their status, and exposed tools.
-- `/clear` — reset the conversation.
-- `/compact` — compress the conversation into a summary to free context.
-- `/export` — save the current conversation to `conversation-{timestamp}.jsonl`.
-- `/quit` or `/exit` — leave the app.
+## Build from source
+
+```bash
+git clone <repo-url>
+cd easy-agent
+pnpm install
+pnpm build                 # build core → CLI
+pnpm --filter @vietor/easy-agent dev   # hot-reload dev mode
+```

package/dist/cmds/builtin.js

@@ -66,3 +66,11 @@ export const exportCommand = {
         }
     },
 };
+export const builtinCommands = [
+    exitCommand,
+    { ...exitCommand, name: "quit" },
+    clearCommand,
+    mcpCommand,
+    compactCommand,
+    exportCommand,
+];

package/dist/config.js

@@ -16,7 +16,7 @@ const StdioServerConfig = z.object({
     enabled: z.boolean().optional(),
 });
 const RemoteServerConfig = z.object({
-    type: z.enum(["sse", "http"]),
+    type: z.enum(["http"]),
     url: z.string().url(),
     headers: z.record(z.string(), z.string()).optional(),
     enabled: z.boolean().optional(),

package/dist/main.js

@@ -1,29 +1,11 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { loadConfig } from "./config.js";
-import { LLMClient } from "./llm/client.js";
-import { Session } from "./core/session.js";
-import { ToolRegistry, registerBuiltinTools } from "./tools/registry.js";
-import { CommandRegistry, registerBuiltinCommands } from "./cmds/registry.js";
-import { tryLoadSkills } from "./skills/loader.js";
-import { tryReadFileText, readFirstFileContent } from "./util/fs.js";
-import { MCPServers } from "./mcp/server.js";
+import { tryLoadSkills, tryReadFileText, readFirstFileContent, startSession, } from "@vietor/easy-agent-core";
+import { builtinCommands } from "./cmds/builtin.js";
 import { startApp } from "./tui/App.js";
 const SYSTEM_PROMPT_BASE = [
-    "You are Easy Agent, an autonomous coding assistant running in the terminal. You complete tasks by calling tools, inspecting their results, and iterating until the work is done.",
-    `Environment:
-- Platform: ${process.platform}
-- Working directory: ${process.cwd()}`,
-    [
-        "Tool use:",
-        "- Prefer dedicated tools (FileRead, FileWrite, FileEdit, Glob, Grep, WebFetch) over the Shell tool when they fit the task.",
-        "- Read a file before editing it; make minimal, surgical changes that match the surrounding code style.",
-        "- Reference code as file_path:line_number.",
-        "- When a decision belongs to the user, call AskUser and wait for the answer rather than listing options in prose. Ask when there are multiple reasonable approaches, an irreversible or consequential action, or the request is ambiguous; when you have enough to proceed, act without asking.",
-        ...(process.platform === "linux"
-            ? ["- For privileged shell commands, use `sudo -n` (non-interactive); if it reports a password is required, do not retry - surface the command for the user to run manually."]
-            : []),
-    ].join("\n"),
+    "You are Easy Agent, an autonomous assistant. You complete tasks by calling tools, inspecting their results, and iterating until the work is done.",
     `Output:
 - Be concise and use GitHub-flavored markdown.
 - State what you did and stop once the task is complete; report outcomes faithfully.
@@ -31,31 +13,23 @@ const SYSTEM_PROMPT_BASE = [
 ].join("\n\n");
 export async function main() {
     const config = loadConfig();
-    const llm = new LLMClient(config.llm);
-    const tools = new ToolRegistry();
-    registerBuiltinTools(tools);
-    const commands = new CommandRegistry();
-    registerBuiltinCommands(commands);
-    const mcp = new MCPServers(tools);
-    mcp
-        .connect(config.mcpServers)
-        .catch((e) => mcp.report(`MCP connect failed: ${e.message}`));
     const globalSkills = readFirstFileContent([join(homedir(), ".agents", "skills"), join(homedir(), ".claude", "skills")], tryLoadSkills);
-    if (globalSkills) {
-        globalSkills.forEach((skill) => commands.register({
-            name: skill.name,
-            description: skill.description ?? skill.name,
-            execute: async (_, host) => {
-                await host.runSkill(skill);
-            },
-        }));
-    }
     const globalPrompt = readFirstFileContent([join(homedir(), ".agents", "AGENTS.md"), join(homedir(), ".claude", "CLAUDE.md")], tryReadFileText);
     const projectPrompt = readFirstFileContent([join(process.cwd(), "AGENTS.md"), join(process.cwd(), "CLAUDE.md")], tryReadFileText);
     const systemPrompt = [SYSTEM_PROMPT_BASE, globalPrompt, projectPrompt]
         .filter(Boolean)
         .join("\n\n=================\n\n");
-    const session = new Session(llm, systemPrompt, tools, commands, mcp);
+    const session = await startSession({
+        systemPrompt,
+        llmConfig: config.llm,
+        mcpServers: config.mcpServers,
+        skills: globalSkills,
+        commands: builtinCommands,
+        enableTools: {
+            askUser: true,
+            todoWrite: true
+        }
+    });
     const app = startApp(session);
     await app.waitUntilExit().finally(() => session.dispose());
 }

package/dist/tui/App.js

@@ -2,24 +2,25 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { Box, render, Text, useApp, useInput } from "ink";
 import { Markdown } from "./components/Markdown.js";
-import { LogView } from "./LogView.js";
+import { LogList } from "./LogList.js";
+import { TodoView } from "./TodoView.js";
 import { AppHeader } from "./AppHeader.js";
 import { PromptOrCommandInput } from "./PromptOrCommandInput.js";
 import { QuestionView } from "./QuestionView.js";
 import { Spinner } from "./Spinner.js";
 import { compactDisplay } from "../util/format.js";
-const STREAM_FRAME_MS = 240;
+const STREAM_FRAME_MS = 120;
 export function App({ session }) {
     const { exit } = useApp();
-    useSyncExternalStore(session.subscribe, session.getSnapshot);
+    const version = useSyncExternalStore(session.subscribe, session.getSnapshot);
     const [running, setRunning] = useState(false);
-    const [elapsed, setElapsed] = useState(0);
-    const [usage, setUsage] = useState({ prompt: 0, completion: 0 });
-    const [, setTick] = useState(0);
+    const [runElapsed, setRunElapsed] = useState(0);
+    const [runUsage, setRunUsage] = useState({ prompt: 0, completion: 0 });
+    const [streamingText, setStreamingText] = useState("");
     const streamingRef = useRef("");
     const renderTimerRef = useRef(undefined);
     const allCmds = useMemo(() => session.commandSchemas, [session]);
-    const pendingQuestion = session.logEntries.find((e) => e.kind === "question" && e.answer === null);
+    const pendingQuestion = useMemo(() => session.logEntries.find((e) => e.kind === "question" && e.answer === null), [session, version]);
     useEffect(() => {
         session.setCallbacks({
             onStreaming: (text) => {
@@ -27,8 +28,8 @@ export function App({ session }) {
                 scheduleStreamingRender();
             },
             onRunStateChange: (r) => setRunning(r),
-            onElapsedChange: (s) => setElapsed(s),
-            onUsageChange: (p, c) => setUsage({ prompt: p, completion: c }),
+            onRunElapsedChange: (s) => setRunElapsed(s),
+            onRunUsageChange: (p, c) => setRunUsage({ prompt: p, completion: c }),
         });
     }, []);
     const scheduleStreamingRender = () => {
@@ -36,7 +37,7 @@ export function App({ session }) {
             return;
         renderTimerRef.current = setTimeout(() => {
             renderTimerRef.current = undefined;
-            setTick((t) => t + 1);
+            setStreamingText(streamingRef.current);
         }, STREAM_FRAME_MS);
     };
     useInput((_input, key) => {
@@ -66,9 +67,21 @@ export function App({ session }) {
             await session.startPrompt(text);
         }
     }
-    return (_jsxs(Box, { flexDirection: "column", minWidth: 80, children: [_jsx(AppHeader, {}), _jsxs(Box, { flexDirection: "column", paddingLeft: 1, paddingRight: 1, children: [session.logEntries.length === 0 ? (_jsx(Box, { paddingTop: 2 })) : null, session.logEntries.map((entry, i) => (_jsx(LogView, { entry: entry }, i)))] }), running && pendingQuestion ? (_jsx(QuestionView, { question: pendingQuestion, onAnswer: (ans) => session.submitAnswer(pendingQuestion.id, ans) })) : running && streamingRef.current ? (_jsx(Box, { marginTop: 1, paddingLeft: 1, paddingRight: 1, children: _jsx(Markdown, { color: "green", children: streamingRef.current }) })) : running ? (_jsx(Box, { marginTop: 1, paddingLeft: 1, children: _jsx(Spinner, { label: "thinking", elapsed: elapsed, promptTokens: usage.prompt, completionTokens: usage.completion }) })) : null, !running ? (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { dimColor: true, children: ["[CTX ", compactDisplay(session.contextTokens), "] \u00B7 ESC to stop \u00B7 type / for commands"] }), _jsx(PromptOrCommandInput, { commands: allCmds, onCommand: handleCommand, onPrompt: handlePrompt })] })) : null] }));
+    let runningView = null;
+    if (running) {
+        if (pendingQuestion) {
+            runningView = (_jsx(QuestionView, { question: pendingQuestion, onAnswer: (ans) => session.submitAnswer(pendingQuestion.id, ans) }));
+        }
+        else if (streamingText) {
+            runningView = (_jsx(Box, { marginTop: 1, paddingLeft: 1, paddingRight: 1, children: _jsx(Markdown, { color: "green", children: streamingText }) }));
+        }
+        else {
+            runningView = (_jsx(Box, { marginTop: 1, paddingLeft: 1, children: _jsx(Spinner, { label: "thinking", elapsed: runElapsed, promptTokens: runUsage.prompt, completionTokens: runUsage.completion }) }));
+        }
+    }
+    return (_jsxs(Box, { flexDirection: "column", minWidth: 80, children: [_jsx(AppHeader, {}), _jsx(LogList, { session: session }), session.todos.length > 0 ? _jsx(TodoView, { todos: session.todos }) : null, runningView, !running ? (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { dimColor: true, children: ["[CTX ", compactDisplay(session.contextTokens), "] \u00B7 ESC to stop \u00B7 type / for commands"] }), _jsx(PromptOrCommandInput, { commands: allCmds, onCommand: handleCommand, onPrompt: handlePrompt })] })) : null] }));
 }
 export function startApp(session) {
     process.stdout.write("");
-    return render(_jsx(App, { session: session }), { exitOnCtrlC: false });
+    return render(_jsx(App, { session: session }), { exitOnCtrlC: false, incrementalRendering: true });
 }

package/dist/tui/AppHeader.js

@@ -1,7 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { memo } from "react";
 import { Box, Text } from "ink";
-import { getPackageInfo } from "../util/package.js";
-export function AppHeader() {
+import { getPackageInfo } from "@vietor/easy-agent-core";
+export const AppHeader = memo(function AppHeader() {
     const pkginfo = getPackageInfo();
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "column", paddingLeft: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: "red", bold: true, children: "Easy Agent" }), _jsxs(Text, { dimColor: true, children: [" v", pkginfo.version] })] }), _jsx(Text, { dimColor: true, children: process.cwd() })] }), _jsx(Box, { borderStyle: "single", borderTop: true, borderBottom: false, borderLeft: false, borderRight: false, borderColor: "gray" })] }));
-}
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: "red", bold: true, children: "Easy Agent" }), _jsxs(Text, { dimColor: true, children: [" v", pkginfo.version] })] }), _jsx(Text, { dimColor: true, children: process.cwd() })] }));
+});

package/dist/tui/LogList.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { memo, useSyncExternalStore } from "react";
+import { Box } from "ink";
+import { LogView } from "./LogView.js";
+export const LogList = memo(function LogList({ session }) {
+    useSyncExternalStore(session.subscribe, session.getSnapshot);
+    const entries = session.logEntries;
+    return (_jsx(Box, { flexDirection: "column", paddingLeft: 1, paddingRight: 1, children: entries.map((entry, i) => (_jsx(LogView, { entry: entry }, i))) }));
+});

package/dist/tui/PromptOrCommandInput.js

@@ -16,10 +16,7 @@ export function PromptOrCommandInput({ commands, onCommand, onPrompt }) {
     }, [showMenu, prefix, commands]);
     const [selectedIndex, setSelectedIndex] = useState(0);
     useEffect(() => {
-        if (filtered.length > 0 && selectedIndex === -1)
-            setSelectedIndex(0);
-        else if (selectedIndex >= filtered.length)
-            setSelectedIndex(Math.max(0, filtered.length - 1));
+        setSelectedIndex((prev) => Math.max(0, Math.min(prev, Math.max(0, filtered.length - 1))));
     }, [filtered.length]);
     useInput((_input, key) => {
         if (key.upArrow) {

package/dist/tui/TodoView.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { memo } from "react";
+import { Box, Text } from "ink";
+const ICONS = {
+    pending: "○",
+    in_progress: "◐",
+    completed: "✓",
+};
+const COLORS = {
+    pending: "gray",
+    in_progress: "yellow",
+    completed: "green",
+};
+export const TodoView = memo(function TodoView({ todos }) {
+    if (todos.length === 0)
+        return null;
+    const done = todos.filter((t) => t.status === "completed").length;
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, paddingLeft: 1, paddingRight: 1, children: [_jsx(Text, { dimColor: true, children: `Tasks [${done}/${todos.length}]` }), todos.map((t, i) => (_jsx(Text, { color: COLORS[t.status], strikethrough: t.status === "completed", children: `${ICONS[t.status]} ${t.content}` }, i)))] }));
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vietor/easy-agent",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "type": "module",
   "main": "dist/cli.js",
   "bin": {
@@ -9,40 +9,37 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsc",
-    "start": "tsc && node dist/cli.js",
-    "dev": "tsx src/cli.ts",
-    "prepublishOnly": "tsc"
-  },
-  "keywords": [
-    "ai",
-    "cli"
-  ],
-  "author": "",
+  "description": "Terminal-based AI agent CLI with conversational TUI (Ink/React) powered by easy-agent-core",
   "license": "MIT",
-  "packageManager": "pnpm@10.30.3",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vietor/easy-agent.git"
+  },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "@vscode/ripgrep": "^1.18.0",
-    "htmlparser2": "^12.0.0",
     "ink": "^7.1.0",
     "ink-text-input": "^6.0.0",
     "marked": "^18.0.5",
-    "openai": "^6.45.0",
     "react": "^19.2.7",
     "string-width": "^8.2.1",
-    "turndown": "^7.2.4",
-    "zod": "^4.4.3"
+    "zod": "^4.4.3",
+    "@vietor/easy-agent-core": "0.4.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/react": "^19.2.17",
-    "@types/turndown": "^5.0.6",
     "tsx": "^4.23.0",
     "typescript": "^6.0.3"
   },
   "engines": {
     "node": ">=22.0.0"
+  },
+  "keywords": [
+    "ai",
+    "cli"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js"
   }
-}
+}

package/dist/cmds/registry.js

@@ -1,30 +0,0 @@
-import { exitCommand, clearCommand, mcpCommand, compactCommand, exportCommand } from "./builtin.js";
-export class CommandRegistry {
-    commands = new Map();
-    register(command) {
-        this.commands.set(command.name, command);
-    }
-    schemas() {
-        return [...this.commands.values()].map((t) => ({
-            name: t.name,
-            description: t.description,
-        }));
-    }
-    exists(name) {
-        return this.commands.has(name);
-    }
-    async execute(command, ctx, host) {
-        const cmd = this.commands.get(command);
-        if (!cmd) {
-            host.error(`unknown command: /${command}`);
-            return;
-        }
-        await cmd.execute(ctx, host);
-    }
-}
-export function registerBuiltinCommands(commands) {
-    commands.register(exitCommand);
-    commands.register({ ...exitCommand, name: "quit" });
-    for (const t of [clearCommand, mcpCommand, compactCommand, exportCommand])
-        commands.register(t);
-}

package/dist/cmds/types.js

@@ -1 +0,0 @@
-export {};

package/dist/core/agent.js

@@ -1,134 +0,0 @@
-import { withAbort } from "../util/async.js";
-const STALL_THRESHOLD = 3;
-const MAX_TURNS = 50;
-const COMPACT_PROMPT = "Summarize this conversation into a concise context summary. Preserve the user's goal, decisions made, files touched, and current progress. Write the summary in the same language the user used in the conversation. Begin your reply with \"Summary of conversation so far:\".";
-export class Agent {
-    llm;
-    conversation;
-    tools;
-    ask;
-    constructor(llm, conversation, tools, ask) {
-        this.llm = llm;
-        this.conversation = conversation;
-        this.tools = tools;
-        this.ask = ask;
-    }
-    get contextTokens() {
-        return this.conversation.getEstimatedTokens();
-    }
-    clear() {
-        this.conversation.clear();
-    }
-    export() {
-        return this.conversation.export();
-    }
-    async compact(signal) {
-        const history = this.conversation.toLLM().slice(1);
-        if (history.length === 0)
-            return;
-        const request = [
-            ...history,
-            { role: "user", content: COMPACT_PROMPT },
-        ];
-        const msg = await this.llm.chat({ messages: request, tools: [], signal });
-        this.conversation.compact(msg.content || "");
-    }
-    async run(userInput, onEvent, signal) {
-        await this.runTurn({ role: "user", content: userInput }, onEvent, signal);
-    }
-    async runSkill(skill, onEvent, signal) {
-        await this.runTurn({ role: "skill", name: skill.name, content: skill.prompt }, onEvent, signal);
-    }
-    async runTurn(msg, onEvent, signal) {
-        this.conversation.add(msg);
-        this.conversation.createSnapshot();
-        try {
-            await this.loop(onEvent, signal);
-        }
-        finally {
-            this.conversation.clearSnapshot();
-        }
-    }
-    async loop(onEvent, signal) {
-        await withAbort(async (aborted) => {
-            let lastSig = "";
-            let stall = 0;
-            let turns = 0;
-            while (true) {
-                let msg;
-                try {
-                    msg = await this.llm.chat({
-                        messages: this.conversation.toLLM(),
-                        tools: this.tools.schemas(),
-                        onDelta: (text) => onEvent?.({ type: "delta", text }),
-                        onRetry: (attempt, max) => onEvent?.({ type: "retry", attempt, max }),
-                        onUsage: (promptTokens, completionTokens) => onEvent?.({ type: "usage", promptTokens, completionTokens }),
-                        signal,
-                    });
-                }
-                catch (e) {
-                    if (aborted())
-                        return;
-                    onEvent?.({ type: "error", text: e.message });
-                    return;
-                }
-                this.conversation.add(msg);
-                if (!msg.tool_calls?.length)
-                    return;
-                if (aborted())
-                    return;
-                const sig = msg.tool_calls
-                    .map((c) => `${c.function.name}:${c.function.arguments}`)
-                    .join("|");
-                stall = sig === lastSig ? stall + 1 : 1;
-                lastSig = sig;
-                if (stall >= STALL_THRESHOLD) {
-                    onEvent?.({ type: "error", text: "agent stalled: repeated identical tool calls" });
-                    return;
-                }
-                if (++turns >= MAX_TURNS) {
-                    onEvent?.({ type: "error", text: `agent exceeded max turns (${MAX_TURNS})` });
-                    return;
-                }
-                const results = await Promise.all(msg.tool_calls.map(async (call) => {
-                    let args = {};
-                    let argsError = "";
-                    if (call.function.arguments) {
-                        try {
-                            args = JSON.parse(call.function.arguments);
-                        }
-                        catch (e) {
-                            argsError = `Error: invalid arguments: ${e.message}`;
-                        }
-                    }
-                    const summary = this.tools.summarize(call.function.name, args);
-                    onEvent?.({ type: "tool_start", id: call.id, name: call.function.name, summary });
-                    if (aborted())
-                        return null;
-                    const ctx = { signal, ask: this.ask };
-                    const result = argsError
-                        ? { content: argsError, isError: true }
-                        : await this.tools.execute(call.function.name, args, ctx);
-                    if (aborted())
-                        return null;
-                    onEvent?.({ type: "tool_end", id: call.id, result: result.content, isError: result.isError });
-                    return { id: call.id, content: result.content };
-                }));
-                if (aborted())
-                    return;
-                for (const r of results) {
-                    if (r)
-                        this.conversation.add({ role: "tool", tool_call_id: r.id, content: r.content });
-                }
-                if (aborted())
-                    return;
-            }
-        }, {
-            signal,
-            onAbort: () => {
-                this.conversation.restoreFromSnapshot();
-                onEvent?.({ type: "interrupted" });
-            },
-        });
-    }
-}