aura-code 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dušan Milosavljević
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+<p align="center">
+  <img src="./README-hero.jpg" alt="Aura">
+</p>
+
+
+<h1 align="center">Aura Code — Autonomous Coding Agent</h1>
+
+<p align="center">
+  <em>I don't try. I verify.</em>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/aura-code"><img src="https://img.shields.io/npm/v/aura-code?color=cc0000&label=npm&logo=npm" alt="npm version"></a>
+  <a href="https://github.com/milodule3-debug/aura-code/actions/workflows/ci.yml"><img src="https://github.com/milodule3-debug/aura-code/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <img src="https://img.shields.io/badge/tests-734%2B-brightgreen" alt="734+ tests">
+  <a href="https://github.com/milodule3-debug/aura-code/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D18-339933?logo=node.js&logoColor=white" alt="Node.js 18+">
+  <a href="https://github.com/milodule3-debug/aura-code"><img src="https://img.shields.io/github/stars/milodule3-debug/aura-code?style=social" alt="GitHub Stars"></a>
+</p>
+
+<p align="center">
+  <a href="./docs/ARCHITECTURE.md">
+    <img src="./assets/architecture-diagram.png" alt="Architecture Diagram" width="800">
+  </a>
+  <br>
+  <em><a href="./docs/ARCHITECTURE.md">View full architecture documentation →</a></em>
+</p>
+
+<p align="center">
+  <img src="./assets/demo.gif" alt="Aura Code CLI Demo" width="800">
+  <br>
+  <em>CLI demo — help, models, and version overview</em>
+</p>
+
+---
+
+## What is Aura Code?
+
+Aura Code was developed using AI-assisted engineering workflows, with multiple AI agents contributing to design, implementation, testing, and verification. Written in TypeScript — not related to the Ruby programming language.
+
+Built on the **Praktess** framework — from Ancient Greek: *she who acts and executes*.
+
+---
+
+## Quick Start
+
+```bash
+npm install -g aura-code
+aura 'your task here'
+```
+
+Set at least one API key before running:
+
+```bash
+export ANTHROPIC_API_KEY="sk-ant-..."   # Claude
+export OPENAI_API_KEY="sk-..."          # GPT
+export GOOGLE_API_KEY="..."             # Gemini
+export XIAOMI_API_KEY="tp-..."          # MiMo
+# Local — no API key needed:
+# ollama pull qwen2.5-coder:1.5b
+```
+
+---
+
+## What Aura Does
+
+1. **Reads** your codebase — files, structure, dependencies
+2. **Plans** a strategy — decides what to change and how
+3. **Executes** — writes code, runs commands, makes edits
+4. **Verifies** — runs tests, checks file integrity, confirms changes
+5. **Reports** — summarizes what was done and what passed
+
+---
+
+## Modes
+
+| Mode | What it does |
+|------|-------------|
+| `normal` | Single-agent loop: read → plan → execute → verify |
+| `orchestrate` | Multi-agent: Researcher → Coder → Reviewer |
+| `architect` | High-level design and planning before implementation |
+| `verify` | Post-task checks with automatic retry on failure |
+| `analyze` | Scan session history for failure patterns |
+
+```bash
+aura 'fix the bug'                                      # normal
+aura --orchestrate 'add error handling to all endpoints' # orchestrate
+aura --architect 'design the new auth system'            # architect
+aura --verify --test-command "npm test" 'fix the tests'  # verify
+aura --analyze                                           # analyze
+```
+
+---
+
+## Providers
+
+| Provider | Models |
+|----------|--------|
+| **Claude** (Anthropic) | Opus, Sonnet, Haiku |
+| **GPT** (OpenAI) | gpt-4o, gpt-4o-mini |
+| **Gemini** (Google) | gemini-2.5-pro, gemini-2.5-flash |
+| **MiMo** (Xiaomi) | mimo-v2.5-pro, mimo-v2.5 |
+| **DeepSeek** (OpenRouter) | deepseek-v4-pro, deepseek-v4-flash:free |
+| **Ollama** (Local) | Any local model — no API key needed |
+
+Any OpenAI-compatible endpoint also works via `openrouter/<model>`.
+
+---
+
+## Stats
+
+| Metric | Value |
+|--------|-------|
+| Tests | 734+ passing, 0 failures |
+| Version | v0.3.0 |
+| Language | TypeScript (strict) |
+| License | MIT |
+
+---
+
+## Repository
+
+GitHub: https://github.com/milodule3-debug/aura-code
+(Repo renamed from milodule3-debug/rubyness — existing clone URLs redirect automatically)
+
+---
+
+## Links
+
+- [Lean Progress IQ](https://lean-progress-iq-site.vercel.app)
+- [Aura Manifesto](her-rubyness-manifesto.html)
+
+---
+
+<p align="center">
+  Built by <a href="https://lean-progress-iq-site.vercel.app">Lean Progress IQ</a>
+</p>

package/dist/agent/context.d.ts

@@ -0,0 +1,13 @@
+export interface ProjectContext {
+    root: string;
+    name: string;
+    language: string;
+    framework: string;
+    readme: string;
+    tree: string;
+    config: string;
+    recentCommits: string;
+    graphSummary?: string;
+}
+export declare function loadProjectContext(cwd: string): Promise<ProjectContext>;
+export declare function loadGraphSummary(root: string): string | undefined;

package/dist/agent/context.js

@@ -0,0 +1,183 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadProjectContext = loadProjectContext;
+exports.loadGraphSummary = loadGraphSummary;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const defaults_js_1 = require("../config/defaults.js");
+async function loadProjectContext(cwd) {
+    const root = path.resolve(cwd);
+    const name = detectProjectName(root);
+    const { language, framework } = detectStack(root);
+    return {
+        root,
+        name,
+        language,
+        framework,
+        readme: readTruncated(root, ['README.md', 'README.txt', 'README.rst'], 2000),
+        tree: buildTree(root),
+        config: readConfig(root),
+        recentCommits: readGitLog(root),
+        graphSummary: loadGraphSummary(root),
+    };
+}
+function loadGraphSummary(root) {
+    const graphPath = path.join(root, 'graphify-out', 'graph.json');
+    if (!fs.existsSync(graphPath))
+        return undefined;
+    try {
+        const raw = fs.readFileSync(graphPath, 'utf8');
+        const graph = JSON.parse(raw);
+        if (!Array.isArray(graph.nodes) || graph.nodes.length === 0)
+            return undefined;
+        const top = graph.nodes.slice(0, 40);
+        const lines = top.map(n => {
+            const loc = n.file ? ` (${n.file})` : '';
+            const summary = n.summary ? `: ${n.summary.slice(0, 120)}` : '';
+            return `  ${n.type ?? 'node'} ${n.label ?? n.id}${loc}${summary}`;
+        });
+        return `Top ${top.length} of ${graph.nodes.length} nodes:\n${lines.join('\n')}`;
+    }
+    catch {
+        return undefined;
+    }
+}
+function detectProjectName(root) {
+    // Try package.json
+    const pkg = path.join(root, 'package.json');
+    if (fs.existsSync(pkg)) {
+        try {
+            return JSON.parse(fs.readFileSync(pkg, 'utf8')).name ?? path.basename(root);
+        }
+        catch { /* fallthrough */ }
+    }
+    return path.basename(root);
+}
+function detectStack(root) {
+    if (fs.existsSync(path.join(root, 'package.json'))) {
+        try {
+            const p = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
+            const deps = { ...(p.dependencies ?? {}), ...(p.devDependencies ?? {}) };
+            const fw = deps.next ? 'Next.js' :
+                deps.react ? 'React' :
+                    deps.vue ? 'Vue' :
+                        deps.express || deps.fastify ? 'Node.js API' :
+                            deps.electron ? 'Electron' :
+                                deps['@tauri-apps/cli'] ? 'Tauri' : 'Node.js';
+            const lang = deps.typescript || p.scripts?.build?.includes('tsc') ? 'TypeScript' : 'JavaScript';
+            return { language: lang, framework: fw };
+        }
+        catch { /* fallthrough */ }
+    }
+    if (fs.existsSync(path.join(root, 'requirements.txt')) || fs.existsSync(path.join(root, 'pyproject.toml'))) {
+        return { language: 'Python', framework: 'Python' };
+    }
+    if (fs.existsSync(path.join(root, 'Cargo.toml'))) {
+        return { language: 'Rust', framework: 'Rust' };
+    }
+    if (fs.existsSync(path.join(root, 'go.mod'))) {
+        return { language: 'Go', framework: 'Go' };
+    }
+    return { language: 'Unknown', framework: 'Unknown' };
+}
+function readTruncated(root, names, maxChars) {
+    for (const name of names) {
+        const p = path.join(root, name);
+        if (fs.existsSync(p)) {
+            try {
+                const content = fs.readFileSync(p, 'utf8');
+                return content.length > maxChars
+                    ? content.slice(0, maxChars) + '\n\n[...truncated]'
+                    : content;
+            }
+            catch { /* next */ }
+        }
+    }
+    return '(no README found)';
+}
+function buildTree(root) {
+    const lines = [path.basename(root) + '/'];
+    function walk(dir, prefix, depth) {
+        if (depth > 3)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        const filtered = entries.filter(e => !defaults_js_1.IGNORE_PATTERNS.some(p => e.name === p || (p.startsWith('*') && e.name.endsWith(p.slice(1))))
+            && !e.name.startsWith('.'));
+        filtered.sort((a, b) => {
+            if (a.isDirectory() !== b.isDirectory())
+                return a.isDirectory() ? -1 : 1;
+            return a.name.localeCompare(b.name);
+        });
+        for (let i = 0; i < filtered.length; i++) {
+            const e = filtered[i];
+            const last = i === filtered.length - 1;
+            lines.push(`${prefix}${last ? '└── ' : '├── '}${e.name}${e.isDirectory() ? '/' : ''}`);
+            if (e.isDirectory())
+                walk(path.join(dir, e.name), prefix + (last ? '    ' : '│   '), depth + 1);
+        }
+    }
+    walk(root, '', 1);
+    return lines.join('\n');
+}
+function readConfig(root) {
+    for (const name of ['package.json', 'requirements.txt', 'Cargo.toml', 'go.mod', 'pyproject.toml']) {
+        const p = path.join(root, name);
+        if (fs.existsSync(p)) {
+            try {
+                const content = fs.readFileSync(p, 'utf8');
+                return `${name}:\n${content.slice(0, 1500)}${content.length > 1500 ? '\n[...truncated]' : ''}`;
+            }
+            catch { /* next */ }
+        }
+    }
+    return '(no config file found)';
+}
+function readGitLog(root) {
+    try {
+        return (0, child_process_1.execSync)('git log --oneline -10', { cwd: root, encoding: 'utf8' }).trim();
+    }
+    catch {
+        return '(not a git repository)';
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/agent/context.js.map

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

package/dist/agent/loop.d.ts

@@ -0,0 +1,60 @@
+import type { LLMProvider, HistoryMessage } from '../providers/types.js';
+import { PermissionSystem } from '../safety/permissions.js';
+import type { ProjectContext } from './context.js';
+import type { Display } from '../cli/display.js';
+import type { VerificationConfig } from '../verify/types.js';
+export interface LoopOptions {
+    provider: LLMProvider;
+    task: string;
+    context: ProjectContext;
+    permissions: PermissionSystem;
+    display: Display;
+    maxTurns?: number;
+    /** Optional model id for token pricing — falls back to provider.model */
+    pricingModel?: string;
+    /** Path to a session file to persist history to; undefined = ephemeral */
+    sessionPath?: string;
+    /** Pre-existing conversation history to resume from (e.g. loaded session). */
+    initialHistory?: HistoryMessage[];
+    /** Base config passed to spawned sub-agents. If undefined, spawn_task returns an error. */
+    spawnConfig?: {
+        apiKey?: string;
+        baseUrl?: string;
+    };
+    /** Disables subagent tool entirely (e.g. for tests) */
+    disableSpawn?: boolean;
+    /** Internal: skip post-task verification (used by runWithVerification wrapper). */
+    verify?: boolean;
+    /**
+     * Custom confirmation function for destructive operations.
+     * Defaults to terminal-based confirm() from permissions.
+     * Telegram bot overrides this to send approval requests via Telegram messages.
+     */
+    confirmFn?: (message: string) => Promise<boolean>;
+}
+export interface LoopResult {
+    success: boolean;
+    summary: string;
+    turns: number;
+    toolCallCount: number;
+    usage: TokenUsage;
+    costUsd: number;
+    /** Full conversation history after the loop (including prior turns if resumed). */
+    history: HistoryMessage[];
+    /** Every tool call made during this loop run — used by the verify layer. */
+    toolCallLog: Array<{
+        name: string;
+        input: Record<string, unknown>;
+    }>;
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+export declare function runAgentLoop(opts: LoopOptions): Promise<LoopResult>;
+export declare function runAgentLoopVerified(opts: LoopOptions, config: VerificationConfig, projectRoot: string): Promise<{
+    loopResult: LoopResult;
+    verifyResult: import('../verify/types.js').VerificationResult;
+    totalAttempts: number;
+}>;

package/dist/agent/loop.js

@@ -0,0 +1,228 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAgentLoop = runAgentLoop;
+exports.runAgentLoopVerified = runAgentLoopVerified;
+const path = __importStar(require("path"));
+const index_js_1 = require("../tools/index.js");
+const permissions_js_1 = require("../safety/permissions.js");
+const system_prompt_js_1 = require("./system-prompt.js");
+const defaults_js_1 = require("../config/defaults.js");
+const session_store_js_1 = require("./session-store.js");
+const spawner_js_1 = require("./spawner.js");
+const PRICING_USD_PER_MTOK = {
+    'claude-opus-4-5-20251001': { in: 15, out: 75 },
+    'claude-sonnet-4-5-20251001': { in: 3, out: 15 },
+    'claude-haiku-4-5-20251001': { in: 0.8, out: 4 },
+    'gpt-4o': { in: 2.5, out: 10 },
+    'gpt-4o-mini': { in: 0.15, out: 0.6 },
+    'gemini-2.5-pro': { in: 1.25, out: 10 },
+    'gemini-2.5-flash': { in: 0.075, out: 0.3 },
+    'grok-beta': { in: 5, out: 15 },
+    'mimo-v2.5-pro': { in: 1, out: 4 },
+    'mimo-v2.5': { in: 0.5, out: 2 },
+    'mimo-v2-flash': { in: 0.1, out: 0.4 },
+};
+function costFor(model, input, output) {
+    const p = PRICING_USD_PER_MTOK[model] ?? PRICING_USD_PER_MTOK[Object.keys(PRICING_USD_PER_MTOK).find(k => model.includes(k.split('-')[1] ?? '') && k.startsWith(model.split('-')[0] ?? '')) ?? ''] ?? { in: 0, out: 0 };
+    return (input / 1_000_000) * p.in + (output / 1_000_000) * p.out;
+}
+async function runAgentLoop(opts) {
+    const { provider, task, context, permissions, display } = opts;
+    const maxTurns = opts.maxTurns ?? defaults_js_1.DEFAULTS.maxTurns;
+    const pricingModel = opts.pricingModel ?? provider.model;
+    const system = (0, system_prompt_js_1.buildSystemPrompt)(context, provider.name);
+    const history = [
+        ...(opts.initialHistory ?? []),
+        { role: 'user', content: task },
+    ];
+    let turns = 0;
+    let toolCallCount = 0;
+    const usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+    if (!opts.disableSpawn) {
+        (0, spawner_js_1.registerSpawner)((0, spawner_js_1.makeDefaultSpawner)(context, opts.spawnConfig ?? {}, display));
+    }
+    display.agentThinking();
+    try {
+        return await runLoopBody({ opts, provider, system, history, maxTurns, pricingModel, display, permissions, turns, toolCallCount, usage });
+    }
+    finally {
+        (0, spawner_js_1.clearSpawner)();
+    }
+}
+async function runLoopBody(args) {
+    const { opts, provider, system, history, maxTurns, pricingModel, display, permissions } = args;
+    let { turns, toolCallCount, usage } = args;
+    const toolCallLog = [];
+    while (turns < maxTurns) {
+        turns++;
+        let responseText = '';
+        const responseToolCalls = [];
+        let finalResponse = null;
+        try {
+            const stream = provider.stream(system, history, index_js_1.TOOL_DEFINITIONS);
+            for await (const chunk of stream) {
+                switch (chunk.type) {
+                    case 'text':
+                        display.streamText(chunk.text);
+                        responseText += chunk.text;
+                        break;
+                    case 'tool_start':
+                        display.toolStart(chunk.name, chunk.id);
+                        break;
+                    case 'tool_input':
+                        break;
+                    case 'tool_end':
+                        responseToolCalls.push(chunk.call);
+                        break;
+                    case 'done':
+                        finalResponse = { stopReason: chunk.response.stopReason };
+                        if (chunk.response.toolCalls.length > 0 && responseToolCalls.length === 0) {
+                            responseToolCalls.push(...chunk.response.toolCalls);
+                        }
+                        const u = chunk.response.usage;
+                        if (u) {
+                            const inT = u.inputTokens ?? 0;
+                            const outT = u.outputTokens ?? 0;
+                            usage.inputTokens += inT;
+                            usage.outputTokens += outT;
+                            usage.totalTokens += inT + outT;
+                        }
+                        break;
+                }
+            }
+        }
+        catch (e) {
+            display.error(`Provider error: ${String(e)}`);
+            await persist(opts.sessionPath, history);
+            return {
+                success: false,
+                summary: `Provider error on turn ${turns}: ${String(e)}`,
+                turns, toolCallCount, usage, history, toolCallLog,
+                costUsd: costFor(pricingModel, usage.inputTokens, usage.outputTokens),
+            };
+        }
+        if (responseText)
+            display.streamEnd();
+        const noProgress = !responseText && responseToolCalls.length === 0;
+        if (noProgress || finalResponse?.stopReason === 'done') {
+            history.push({ role: 'assistant', content: responseText });
+            await persist(opts.sessionPath, history);
+            return {
+                success: true,
+                summary: responseText || '(Task completed with no output)',
+                turns, toolCallCount, usage, history, toolCallLog,
+                costUsd: costFor(pricingModel, usage.inputTokens, usage.outputTokens),
+            };
+        }
+        if (finalResponse?.stopReason === 'limit') {
+            display.warning('Hit token limit — stopping loop');
+            break;
+        }
+        history.push({
+            role: 'assistant',
+            content: responseText,
+            toolCalls: responseToolCalls,
+        });
+        const toolResults = [];
+        for (const call of responseToolCalls) {
+            toolCallCount++;
+            display.toolCall(call.name, call.input);
+            let result;
+            let isError = false;
+            try {
+                const perm = permissions.check(call.name, call.input);
+                if (!perm.allowed) {
+                    display.toolBlocked(call.name, perm.reason ?? 'not permitted');
+                    toolResults.push({ id: call.id, name: call.name, content: `Blocked: ${perm.reason}`, isError: true });
+                    continue;
+                }
+                if (perm.needsConfirm) {
+                    const desc = formatCallForConfirmation(call);
+                    const doConfirm = opts.confirmFn ?? permissions_js_1.confirm;
+                    const approved = await doConfirm(`Allow: ${desc}?`);
+                    if (!approved) {
+                        display.toolBlocked(call.name, 'denied by user');
+                        toolResults.push({ id: call.id, name: call.name, content: 'User denied this action.', isError: true });
+                        continue;
+                    }
+                }
+                const startMs = Date.now();
+                result = await (0, index_js_1.executeTool)(call.name, call.input, opts.context.root);
+                const elapsed = Date.now() - startMs;
+                display.toolResult(call.name, result, elapsed);
+                isError = result.startsWith('Error:') || result.startsWith('Tool error');
+                toolCallLog.push({ name: call.name, input: call.input });
+            }
+            catch (e) {
+                result = `Tool error (${call.name}): ${String(e)}`;
+                isError = true;
+                display.error(result);
+            }
+            toolResults.push({ id: call.id, name: call.name, content: result, isError });
+        }
+        history.push({ role: 'tool_result', results: toolResults });
+        display.agentThinking();
+    }
+    await persist(opts.sessionPath, history);
+    const sessionId = opts.sessionPath ? path.basename(opts.sessionPath, '.json') : undefined;
+    const resumeHint = sessionId ? ` Type /continue to resume session ${sessionId}` : '';
+    return {
+        success: false,
+        summary: `Loop ended after ${turns} turns.${resumeHint}`,
+        turns, toolCallCount, usage, history, toolCallLog,
+        costUsd: costFor(pricingModel, usage.inputTokens, usage.outputTokens),
+    };
+}
+async function runAgentLoopVerified(opts, config, projectRoot) {
+    const { runWithVerification } = await Promise.resolve().then(() => __importStar(require('../verify/index.js')));
+    return runWithVerification({ loopOpts: opts, config, projectRoot, display: opts.display });
+}
+async function persist(path, history) {
+    if (!path)
+        return;
+    try {
+        await session_store_js_1.sessionStore.save(path, history);
+    }
+    catch { /* persistence is best-effort */ }
+}
+function formatCallForConfirmation(call) {
+    if (call.name === 'run_shell')
+        return `$ ${call.input.command}`;
+    if (call.name === 'write_file')
+        return `overwrite ${call.input.path}`;
+    return `${call.name}(${JSON.stringify(call.input).slice(0, 80)})`;
+}
+//# sourceMappingURL=loop.js.map