tuplet 2.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aleksandr Netrebskii
+
+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,136 @@
+# Tuplet
+
+[![npm version](https://img.shields.io/npm/v/tuplet)](https://www.npmjs.com/package/tuplet)
+[![CI](https://img.shields.io/github/actions/workflow/status/anetrebskii/hive-agent/ci.yml)](https://github.com/anetrebskii/hive-agent/actions)
+[![license](https://img.shields.io/github/license/anetrebskii/hive-agent)](https://github.com/anetrebskii/hive-agent/blob/main/LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org/)
+[![Discord](https://img.shields.io/discord/1339330498498080808?logo=discord&label=Discord)](https://discord.gg/WrZhA6wfdr)
+
+**Claude Code-like AI agent for your own application. Add a few lines — get a multi-agent system that asks clarifying questions, plans tasks, and works with your data.**
+
+Claude Code is impressive: you open a terminal, ask it to code something, and it plans, clarifies, executes. But it's locked to the terminal and local filesystem. What if you need that same intelligence inside your SaaS product, web app, or serverless function — working with your database, your blob storage, your users' data?
+
+Tuplet gives you exactly that. A powerful, multi-agent framework you plug into your application. Your users get an AI that feels custom-built. You get a library that handles the hard parts.
+
+## You Need Tuplet If
+
+- You want your own AI agent in your app that codes, manages documents, or works with any workspace you share with it
+- You're building on Firebase, Vercel, AWS Lambda, or any serverless platform — Tuplet is stateless by design
+- You're building a SaaS and want to give users a smart AI chat without building an agent framework from scratch
+- Your data lives in databases, blob storage, or APIs — not just the local filesystem
+- You want Claude Code-level intelligence but inside a web application, without VMs or infrastructure to manage
+- You don't want to spend time teaching AI how to work well — Tuplet handles planning, task tracking, clarifying questions, and tool use out of the box
+
+## Features
+
+### Agent Intelligence
+
+- **Built-in planning & exploration sub-agents** — AI plans its work before executing, just like Claude Code
+- **Task generation & tracking** — AI generates tasks and follows them, showing progress in real time
+- **Clarifying questions** — AI asks one question or a series of questions when it needs more context
+- **Interruption mode** — Correct the AI mid-execution if it goes in the wrong direction, just like Claude Code
+- **Optimized built-in prompts** — Carefully tuned prompts for better results across all providers
+
+### Built-in Capabilities
+
+- **Workspace** — Like projects in Claude Code. Tuplet works with workspace files (virtual or real) the same way Claude Code works with your project
+- **Large file processing** — AI reads files >256KB in chunks, just like Claude Code does
+- **Web browsing** — Navigate websites, extract data, interact with pages
+- **API requests with authentication** — Make HTTP requests to external services
+
+### Multi-Provider
+
+- **Claude** (Anthropic) — First-class support with caching and extended thinking
+- **OpenAI** — GPT-4o and other models
+- **OpenRouter** — Access to 100+ models via [openrouter.ai](https://openrouter.ai), with optimized prompts so non-Claude models use built-in tools effectively
+- **Custom providers** — Implement the `LLMProvider` interface to use any AI model
+
+### Cost & Performance
+
+- **Prompt caching** — Up to 90% cost reduction with Claude's prompt caching
+- **Chat history summarization** — Automatic summarization of long conversations to stay within context limits
+- **Execution tracing** — Full cost breakdown per request, per model, per sub-agent
+
+### Production-Ready
+
+- **Stateless design** — Works in Firebase Functions, AWS Lambda, any serverless environment
+- **Conversation history management** — Automatic load/save with pluggable repository providers
+- **Secrets management** — Keep credentials for external systems outside AI context. AI can use them without seeing actual values
+- **Interruption & cancellation** — AbortController support, Firestore-based stop signals, graceful partial results
+
+### Extensibility
+
+- **Custom tools** — Define any tool with typed parameters and execution logic
+- **Custom sub-agents** — Spawn specialized agents with their own tools, prompts, and even different LLM providers
+- **Pluggable storage** — Bring your own chat history provider (Firestore, Redis, Postgres, anything)
+- **Pluggable logging & tracing** — Integrate with Datadog, custom dashboards, or any observability platform
+- **Pluggable workspaces** — Virtual file systems, database-backed storage, or real file system
+
+## Tuplet vs LangChain.js
+
+| | **Tuplet** | **LangChain.js** |
+|---|---|---|
+| **Runtime dependencies** | 1 | 11+ (core) + per-provider packages |
+| **Setup** | `new Tuplet({ tools, llm })` — one object, done | Chains, Runnables, LCEL, Memory, Agents — multiple abstractions to learn |
+| **Planning & task tracking** | Built-in, works out of the box | Requires separate `@langchain/langgraph` package |
+| **Clarifying questions** | Built-in | Not included — build your own |
+| **Serverless** | Stateless by design — drop into Lambda/Firebase as-is | Requires external state management and architectural changes |
+| **Multi-provider** | Claude, OpenAI, OpenRouter (100+ models), custom | 50+ providers via separate packages |
+| **Prompt caching** | Built-in for Claude (up to 90% cost savings) | Not built-in |
+| **Best for** | Production apps that need an embedded AI agent | Prototyping, RAG pipelines, complex LLM orchestration |
+
+**When to choose LangChain:** You need a massive ecosystem of integrations (vector stores, retrievers, 50+ providers) or are building complex RAG pipelines with many data sources.
+
+**When to choose Tuplet:** You want a production-ready agent in your app without the abstraction overhead. One dependency, stateless, works in serverless — and your users get planning, task tracking, and clarifying questions out of the box.
+
+## Installation
+
+```bash
+npm install tuplet
+```
+
+```bash
+pnpm add tuplet
+```
+
+## Quick Start
+
+```typescript
+import { Tuplet, ClaudeProvider } from 'tuplet'
+
+const agent = new Tuplet({
+  role: 'a helpful assistant',
+  tools: [myTool],
+  llm: new ClaudeProvider({ apiKey: process.env.ANTHROPIC_API_KEY })
+})
+
+const result = await agent.run('Hello!')
+console.log(result.response)
+```
+
+## Examples
+
+- [**Coder**](https://github.com/anetrebskii/hive-agent/tree/main/examples/coder) — AI software developer that creates projects from scratch using built-in shell, workspace, planning, and task tracking. Zero custom tools.
+- [**Eating Consultant**](https://github.com/anetrebskii/hive-agent/tree/main/examples/eating-consultant) — Nutrition assistant with custom tools (OpenFoodFacts API), sub-agents (meal planner), workspace persistence, and run recording.
+
+## Documentation
+
+- [Quick Start](https://github.com/anetrebskii/hive-agent/blob/main/docs/README.md)
+- [Tools](https://github.com/anetrebskii/hive-agent/blob/main/docs/tools.md)
+- [Sub-Agents](https://github.com/anetrebskii/hive-agent/blob/main/docs/sub-agents.md)
+- [Workspace](https://github.com/anetrebskii/hive-agent/blob/main/docs/workspace.md)
+- [Secrets](https://github.com/anetrebskii/hive-agent/blob/main/docs/secrets.md)
+- [Providers](https://github.com/anetrebskii/hive-agent/blob/main/docs/providers.md)
+- [History](https://github.com/anetrebskii/hive-agent/blob/main/docs/history.md)
+- [Interactive Questions](https://github.com/anetrebskii/hive-agent/blob/main/docs/interactive.md)
+- [Interruption](https://github.com/anetrebskii/hive-agent/blob/main/docs/interruption.md)
+- [Plan Mode](https://github.com/anetrebskii/hive-agent/blob/main/docs/plan-mode.md)
+- [Task Management](https://github.com/anetrebskii/hive-agent/blob/main/docs/task-management.md)
+- [Progress Status](https://github.com/anetrebskii/hive-agent/blob/main/docs/progress-status.md)
+- [Logger](https://github.com/anetrebskii/hive-agent/blob/main/docs/logger.md)
+- [Tracing](https://github.com/anetrebskii/hive-agent/blob/main/docs/tracing.md)
+- [Run Recording](https://github.com/anetrebskii/hive-agent/blob/main/docs/run-recording.md)
+
+## License
+
+MIT

package/dist/agent.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Tuplet Agent
+ *
+ * Main agent class that orchestrates tool execution, sub-agents, and workspace management.
+ */
+import type { TupletConfig, RunOptions, AgentResult } from "./types.js";
+import { TraceBuilder } from "./trace.js";
+/** Path where the plan is stored in workspace (relative) */
+export declare const PLAN_PATH = ".tuplet/plan.md";
+export { TASK_SCOPE_INSTRUCTIONS } from "./constants.js";
+/**
+ * Tuplet Agent Class
+ */
+export declare class Tuplet {
+    readonly config: TupletConfig;
+    private contextManager;
+    private tools;
+    /** Auto-generated system prompt */
+    private systemPrompt;
+    /** Current trace builder (set during run, used by __sub_agent__ tool) */
+    private currentTraceBuilder?;
+    constructor(config: TupletConfig);
+    /**
+     * Build system prompt from config.description using MainAgentBuilder.
+     * If _systemPrompt is set (sub-agent internal), use it directly.
+     */
+    private buildSystemPrompt;
+    /**
+     * Get the current trace builder (used by __sub_agent__ tool for sub-agent tracing)
+     */
+    getCurrentTraceBuilder(): TraceBuilder | undefined;
+    /**
+     * Set the current trace builder (called at start of run)
+     */
+    setCurrentTraceBuilder(builder: TraceBuilder | undefined): void;
+    /**
+     * Get tools including internal tools for a specific run.
+     * In plan mode, only a restricted set of tools is returned.
+     */
+    private getRunTools;
+    /**
+     * Run the agent with a user message
+     */
+    run(message: string, options?: RunOptions): Promise<AgentResult>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EAGZ,UAAU,EACV,WAAW,EAEZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAe1C,4DAA4D;AAC5D,eAAO,MAAM,SAAS,oBAAoB,CAAC;AAG3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AA4CzD;;GAEG;AACH,qBAAa,MAAM;IACjB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,KAAK,CAAS;IACtB,mCAAmC;IACnC,OAAO,CAAC,YAAY,CAAS;IAC7B,yEAAyE;IACzE,OAAO,CAAC,mBAAmB,CAAC,CAAe;gBAE/B,MAAM,EAAE,YAAY;IAsDhC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,sBAAsB,IAAI,YAAY,GAAG,SAAS;IAIlD;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI;IAI/D;;;OAGG;IACH,OAAO,CAAC,WAAW;IA6DnB;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,WAAW,CAAC;CAuP3E"}

package/dist/agent.js

@@ -0,0 +1,393 @@
+/**
+ * Tuplet Agent
+ *
+ * Main agent class that orchestrates tool execution, sub-agents, and workspace management.
+ */
+import { ContextManager } from "./context-manager.js";
+import { executeLoop } from "./executor.js";
+import { TraceBuilder } from "./trace.js";
+import { Workspace } from "./workspace.js";
+import { createShellTool } from "./tools/shell.js";
+import { createAskUserTool, createTaskTool as createSubAgentTool, TaskManager, createTaskTools, createTaskGetTool, createTaskListTool, } from "./tools/index.js";
+import { getBuiltInAgents } from "./built-in-agents/index.js";
+import { MainAgentBuilder } from "./prompt/main-agent-builder.js";
+import { TASK_SCOPE_INSTRUCTIONS } from "./constants.js";
+/** Path where the plan is stored in workspace (relative) */
+export const PLAN_PATH = ".tuplet/plan.md";
+// Re-export for public API
+export { TASK_SCOPE_INSTRUCTIONS } from "./constants.js";
+/** System prompt prepended in plan mode */
+const PLAN_MODE_INSTRUCTIONS = `# Plan Mode
+
+You are in **plan mode**. Your job is to understand the current state, then write a plan.
+
+## Workflow
+
+1. **Explore first** — Use the \`explore\` sub-agent to discover what data and state currently exists. This is mandatory before writing a plan.
+2. **Formulate requirements** — Synthesize exploration findings into a structured brief:
+   - Context: current state and exploration findings
+   - Goal: what the user wants to achieve
+   - Affected areas: workspace paths and components involved
+   - Constraints: limitations and dependencies
+   - Success criteria: how to verify completion
+3. **Write the plan** — Using the structured requirements as input, save your plan to \`${PLAN_PATH}\` using the shell.
+
+## Rules
+
+- **Read-only**: The shell is in read-only mode. You cannot create, modify, or delete files except the plan file.
+- **Explore before planning**: Always launch the \`explore\` agent first to understand what exists. Do not skip this step.
+- **Allowed tools**: shell (read-only), \`explore\` and \`plan\` sub-agents, TaskList, TaskGet, __ask_user__.
+- **Write your plan**:
+  \`\`\`
+  cat << 'EOF' > ${PLAN_PATH}
+  # Plan
+  ...your plan here...
+  EOF
+  \`\`\`
+- When your plan is complete, tell the user and summarize it.
+
+`;
+/** User message injected at start of execute mode when a plan exists */
+function planContextMessage(planContent) {
+    return `The following plan was created during the planning phase. Use it as guidance for your implementation. Follow the plan steps and mark tasks as completed as you finish them.
+
+<plan>
+${planContent}
+</plan>`;
+}
+/**
+ * Tuplet Agent Class
+ */
+export class Tuplet {
+    config;
+    contextManager;
+    tools;
+    /** Auto-generated system prompt */
+    systemPrompt;
+    /** Current trace builder (set during run, used by __sub_agent__ tool) */
+    currentTraceBuilder;
+    constructor(config) {
+        this.config = {
+            maxIterations: 50,
+            maxContextTokens: 100000,
+            contextStrategy: "summarize",
+            ...config,
+        };
+        this.contextManager = new ContextManager(this.config.maxContextTokens, this.config.contextStrategy, this.config.llm, this.config.compactBuffer);
+        // Build tools list with internal tools (todo tool added per-run)
+        this.tools = [...config.tools];
+        // Add __ask_user__ tool unless disabled (sub-agents shouldn't use it)
+        if (!config.disableAskUser) {
+            this.tools.push(createAskUserTool());
+        }
+        // Auto-merge built-in agents only when agents is not explicitly set.
+        // If agents is explicitly provided (even as []), respect that — no auto-injection.
+        // This prevents sub-agents from recursively spawning their own sub-agents.
+        if (!('agents' in config)) {
+            const builtIn = getBuiltInAgents();
+            this.config.agents = [...builtIn];
+        }
+        else if (config.agents && config.agents.length > 0) {
+            const builtIn = getBuiltInAgents();
+            const userAgentNames = new Set(config.agents.map((a) => a.name));
+            const newAgents = builtIn.filter((a) => !userAgentNames.has(a.name));
+            this.config.agents = [...config.agents, ...newAgents];
+        }
+        // Build system prompt from description (after agents are merged)
+        this.systemPrompt = this.buildSystemPrompt();
+        // Add __sub_agent__ tool if sub-agents are defined
+        if (this.config.agents && this.config.agents.length > 0) {
+            this.tools.push(createSubAgentTool({
+                config: this.config,
+                getCurrentTraceBuilder: () => this.getCurrentTraceBuilder(),
+            }, this.config.agents, (subConfig) => new Tuplet(subConfig)));
+        }
+    }
+    /**
+     * Build system prompt from config.description using MainAgentBuilder.
+     * If _systemPrompt is set (sub-agent internal), use it directly.
+     */
+    buildSystemPrompt() {
+        if (this.config._systemPrompt) {
+            return this.config._systemPrompt;
+        }
+        const builder = new MainAgentBuilder()
+            .role(this.config.role)
+            .skipBuiltInAgents();
+        if (this.config.agents?.length) {
+            builder.agents(this.config.agents);
+        }
+        if (this.config.tools?.length) {
+            builder.tools(this.config.tools);
+        }
+        return builder.build();
+    }
+    /**
+     * Get the current trace builder (used by __sub_agent__ tool for sub-agent tracing)
+     */
+    getCurrentTraceBuilder() {
+        return this.currentTraceBuilder;
+    }
+    /**
+     * Set the current trace builder (called at start of run)
+     */
+    setCurrentTraceBuilder(builder) {
+        this.currentTraceBuilder = builder;
+    }
+    /**
+     * Get tools including internal tools for a specific run.
+     * In plan mode, only a restricted set of tools is returned.
+     */
+    getRunTools(taskManager, workspace, agentName, mode) {
+        const taskToolOptions = {
+            logger: this.config.logger,
+            agentName,
+            workspace,
+        };
+        if (mode === "plan") {
+            // Plan mode: restricted tool set
+            const planTools = [];
+            // __ask_user__ (if not disabled)
+            const askUser = this.tools.find((t) => t.name === "__ask_user__");
+            if (askUser) {
+                planTools.push(askUser);
+            }
+            // __sub_agent__ restricted to explore + plan agents only
+            const subAgentTool = this.tools.find((t) => t.name === "__sub_agent__");
+            if (subAgentTool) {
+                // Create a wrapper that only allows explore and plan agents
+                planTools.push({
+                    ...subAgentTool,
+                    execute: async (params, context) => {
+                        const agentParam = params.agent;
+                        if (agentParam !== "explore" && agentParam !== "plan") {
+                            return {
+                                success: false,
+                                error: `Plan mode: only 'explore' and 'plan' sub-agents are allowed. Got: '${agentParam}'`,
+                            };
+                        }
+                        return subAgentTool.execute(params, context);
+                    },
+                });
+            }
+            // TaskList and TaskGet only (no TaskCreate, TaskUpdate)
+            planTools.push(createTaskListTool(taskManager, taskToolOptions));
+            planTools.push(createTaskGetTool(taskManager, taskToolOptions));
+            // Shell (already in read-only mode via setReadOnly)
+            planTools.push(createShellTool(workspace.getShell()));
+            return planTools;
+        }
+        // Default / execute mode: all tools
+        return [
+            ...this.tools,
+            ...createTaskTools(taskManager, taskToolOptions),
+            createShellTool(workspace.getShell()),
+        ];
+    }
+    /**
+     * Run the agent with a user message
+     */
+    async run(message, options = {}) {
+        const { conversationId, userId, history: providedHistory, signal, shouldContinue, workspace, mode, } = options;
+        // Load history from repository or use provided
+        let history = [];
+        if (providedHistory) {
+            history = providedHistory;
+        }
+        else if (conversationId && this.config.repository) {
+            history = await this.config.repository.getHistory(conversationId);
+        }
+        // Handle history with pending tool_use blocks (from interrupted executions)
+        const messages = [...history];
+        const lastMessage = messages[messages.length - 1];
+        // Detect if we're resuming from an interrupted execution (__ask_user__ pause etc.)
+        // This is true when the last message is assistant with pending tool_use blocks.
+        let isResuming = false;
+        // Check if last message is assistant with tool_use blocks that need results
+        if (lastMessage?.role === "assistant" &&
+            Array.isArray(lastMessage.content)) {
+            const toolUseBlocks = lastMessage.content.filter((block) => block.type === "tool_use");
+            if (toolUseBlocks.length > 0) {
+                isResuming = true;
+                // Find __ask_user__ tool if present
+                const askUserToolUse = toolUseBlocks.find((block) => block.name === "__ask_user__");
+                // Build tool_results for all tool_use blocks
+                const toolResults = toolUseBlocks.map((toolUse) => {
+                    if (toolUse.name === "__ask_user__") {
+                        // User's message is the answer to __ask_user__
+                        return {
+                            type: "tool_result",
+                            tool_use_id: toolUse.id,
+                            content: JSON.stringify({
+                                success: true,
+                                data: { answer: message },
+                            }),
+                        };
+                    }
+                    else {
+                        // Other tools were interrupted - mark as cancelled
+                        return {
+                            type: "tool_result",
+                            tool_use_id: toolUse.id,
+                            content: JSON.stringify({
+                                success: false,
+                                error: "Operation cancelled - execution was interrupted",
+                            }),
+                            is_error: true,
+                        };
+                    }
+                });
+                // If there was an __ask_user__, the user's message is already the answer
+                // Otherwise, we need to include both the tool_results and the user message
+                if (askUserToolUse) {
+                    messages.push({ role: "user", content: toolResults });
+                }
+                else {
+                    // Combine tool_results and user message in a single user message
+                    // (API doesn't allow consecutive user messages)
+                    messages.push({
+                        role: "user",
+                        content: [...toolResults, { type: "text", text: message }],
+                    });
+                }
+            }
+            else {
+                // No tool_use blocks, normal user message
+                messages.push({ role: "user", content: message });
+            }
+        }
+        else {
+            // Normal user message
+            messages.push({ role: "user", content: message });
+        }
+        // Ensure workspace always exists (create default if not provided)
+        const ws = workspace ?? new Workspace();
+        await ws.init();
+        // Capture existing plan content before cleanup (for prompt injection)
+        const existingPlan = await ws.read(PLAN_PATH);
+        const hasExistingPlan = !!existingPlan && typeof existingPlan === "string";
+        // Always delete old plan file — each run starts clean.
+        // The content is already captured above for prompt injection.
+        if (hasExistingPlan) {
+            await ws.delete(PLAN_PATH);
+        }
+        // Set environment provider if provided
+        if (options.env) {
+            ws.setEnvProvider(options.env);
+        }
+        // Configure shell read-only mode based on mode option
+        const shell = ws.getShell();
+        if (mode === "plan") {
+            // Plan mode: read-only shell, only allow writing to the plan file
+            shell.setReadOnly(true, [PLAN_PATH]);
+        }
+        else {
+            shell.setReadOnly(false);
+        }
+        // Create task manager for this run.
+        // Only restore from workspace when resuming from a pause (e.g., __ask_user__) —
+        // detected by pending tool_use blocks in the last history message.
+        // On a normal run (even with conversation history), start with a clean task list.
+        const taskManager = new TaskManager();
+        if (isResuming) {
+            await taskManager.restoreFromWorkspace(ws);
+        }
+        else {
+            await ws.delete(".tuplet/tasks.json");
+        }
+        // Create tool context
+        const toolContext = {
+            remainingTokens: this.contextManager.getRemainingTokens(),
+            conversationId,
+            userId,
+            workspace: ws,
+        };
+        // Create or use existing trace builder
+        // If _traceBuilder is passed (from parent agent), use it
+        // Otherwise create a new one if trace provider is configured
+        const traceBuilder = options._traceBuilder ||
+            (this.config.trace
+                ? new TraceBuilder(this.config.agentName || "agent", this.config.trace, message // Pass input message to trace
+                )
+                : undefined);
+        // Store trace builder for __sub_agent__ tool to access
+        this.setCurrentTraceBuilder(traceBuilder);
+        // Build system prompt based on mode
+        let systemPrompt = this.systemPrompt;
+        if (mode === "plan") {
+            systemPrompt = PLAN_MODE_INSTRUCTIONS + systemPrompt;
+        }
+        // Inject plan content as a user message (not system prompt) to preserve cache
+        if (mode === "execute" && hasExistingPlan) {
+            messages.unshift({ role: "user", content: planContextMessage(existingPlan) });
+            messages.splice(1, 0, { role: "assistant", content: "I'll follow this plan." });
+        }
+        // Inject task scope + built-in tool guidance into system prompt
+        systemPrompt += `\n\n${TASK_SCOPE_INSTRUCTIONS}
+
+### Asking the User
+When you need information the user hasn't provided and you cannot find it via other tools, call __ask_user__ with 1-4 questions. Each question should include relevant options. Do NOT ask for information already in the conversation or in workspace data.`;
+        // Execute the agent loop — wrapped in try/finally to guarantee history is saved
+        // on any outcome: complete, interrupted, error, or unexpected crash.
+        let result;
+        try {
+            result = await executeLoop({
+                systemPrompt,
+                tools: this.getRunTools(taskManager, ws, this.config.agentName, mode),
+                llm: this.config.llm,
+                logger: this.config.logger,
+                maxIterations: this.config.maxIterations,
+                contextManager: this.contextManager,
+                taskManager,
+                llmOptions: {},
+                signal,
+                shouldContinue,
+                traceBuilder,
+            }, messages, toolContext);
+        }
+        catch (error) {
+            // Unexpected crash — build an error result from current messages
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.config.logger?.error("Execution loop crashed", error);
+            result = {
+                response: '',
+                history: messages,
+                toolCalls: [],
+                status: 'error',
+                error: errorMessage,
+            };
+        }
+        finally {
+            // Always save history — complete, interrupted, error, or crash
+            if (conversationId && this.config.repository) {
+                try {
+                    const historyToSave = result?.history ?? messages;
+                    await this.config.repository.saveHistory(conversationId, historyToSave);
+                }
+                catch (saveError) {
+                    this.config.logger?.warn("Failed to save history", saveError);
+                }
+            }
+        }
+        // End trace and attach to result (only for root agent, not sub-agents)
+        if (traceBuilder && !options._traceBuilder) {
+            const status = result.status === "error"
+                ? "error"
+                : result.status === "interrupted"
+                    ? "interrupted"
+                    : "complete";
+            result.trace = traceBuilder.endTrace(status, result.response);
+        }
+        // Record the run (only for root agent, not sub-agents)
+        if (this.config.recorder && !options._traceBuilder) {
+            try {
+                await this.config.recorder.record(message, history, this.config, result);
+            }
+            catch (error) {
+                this.config.logger?.warn("Failed to record run", error);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/built-in-agents/explore.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Explore Agent
+ *
+ * Fast, read-only agent for investigating workspace data.
+ * Uses shell commands to explore the workspace virtual filesystem.
+ */
+import type { SubAgentConfig } from '../types.js';
+export declare const exploreAgent: SubAgentConfig;
+//# sourceMappingURL=explore.d.ts.map

package/dist/built-in-agents/explore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../src/built-in-agents/explore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGjD,eAAO,MAAM,YAAY,EAAE,cA+B1B,CAAA"}