@matterailab/orbcode 0.3.3 → 0.4.0

package/README.md

@@ -185,10 +185,9 @@ sessions.
 | ------------------------- | ------- | ---------- | ---------------------- |
 | `axon-eido-3-code-pro`    | 400k    | 64k        | $3/M in · $9/M out     |
 | `axon-eido-3-code-mini`   | 400k    | 64k        | $1.5/M in · $4.5/M out |
-| `axon-code-2-5-pro`       | 400k    | 64k        | $2/M in · $6/M out     |
-| `axon-code-2-5-mini`      | 400k    | 64k        | free                   |
+| `axon-eido-3-flash`       | 200k    | 64k        | free                   |
 
-`axon-eido-3-code-mini` is the default. All four support native JSON tool calls
+`axon-eido-3-code-mini` is the default. All three support native JSON tool calls
 and image input. Cost comes from the API's usage chunks (`is_byok`-aware) and is
 shown in the status bar.
 
@@ -298,6 +297,7 @@ MatterAI gateway untouched.
 | `/status`    | version, model, account, gateway, context usage, cost, approval modes                                 |
 | `/usage`     | fetch plan usage                                                                                      |
 | `/init`      | analyze the codebase and create/improve `AGENTS.md` in the repo's `.orb/` directory                   |
+| `/task`      | reference a previous session as context for the current task — opens a picker if no ID is given |
 | `/link`      | link other repos on your machine so changes here are checked against them (enter a folder path) |
 | `/mcp`       | manage MCP servers — enable, disable, reconnect, view status & tool counts                            |
 | `/login`     | start the browser sign-in flow                                                                        |

package/dist/api/models.js

@@ -95,28 +95,17 @@ export const ANTHROPIC_MODELS = {
  * interactive picker for now.
  */
 export const BUILTIN_AXON_MODELS = {
-    "axon-code-2-5-mini": {
-        id: "axon-code-2-5-mini",
-        name: "Axon Code 2.5 Mini (free)",
-        description: "Axon Mini is an general purpose super intelligent LLM coding model for low-effort day-to-day tasks",
-        contextWindow: 400000,
+    "axon-eido-3-flash": {
+        id: "axon-eido-3-flash",
+        name: "Axon Eido 3 Flash (free)",
+        description: "Axon Eido is a fast and low cost general purpose model for low-effort day-to-day tasks",
+        contextWindow: 200000,
         maxOutputTokens: 64000,
         supportsImages: true,
-        inputPrice: 0.0000005,
-        outputPrice: 0.0000015,
+        inputPrice: 0.0,
+        outputPrice: 0.0,
         free: true,
     },
-    "axon-code-2-5-pro": {
-        id: "axon-code-2-5-pro",
-        name: "Axon Code 2.5 Pro",
-        description: "Axon Code 2.5 Pro is the next-generation of Axon Code for coding tasks, currently in experimental stage.",
-        contextWindow: 400000,
-        maxOutputTokens: 64000,
-        supportsImages: true,
-        inputPrice: 0.000002,
-        outputPrice: 0.000006,
-        free: false,
-    },
     "axon-eido-3-code-pro": {
         id: "axon-eido-3-code-pro",
         name: "Axon Eido 3 Pro",

package/dist/core/agent.js

@@ -14,6 +14,42 @@ import { loadSkills } from "../skills/loader.js";
 import { renderLinkedReposSection } from "../config/links.js";
 const MAX_STEPS_PER_TURN = 50;
 const RESULT_PREVIEW_LINES = 6;
+/** How many times to automatically re-establish a model request that fails
+ *  before producing any output (transient/connection errors). */
+const MAX_STREAM_RETRIES = 3;
+/** Transient failures worth auto-retrying: any transport/connection error (no
+ *  usable HTTP status — socket reset, DNS, timeout, TLS drop) plus 5xx/408/429
+ *  server responses. Real 4xx client errors (auth, bad request) are not retried. */
+function isRetryableStreamError(error) {
+    const err = error;
+    const status = Number(err?.status ?? err?.code);
+    if (Number.isFinite(status) && status !== 0) {
+        return status >= 500 || status === 408 || status === 429;
+    }
+    return true;
+}
+function retryBackoffMs(attempt) {
+    return Math.min(500 * 2 ** attempt, 8000);
+}
+/** Sleep that settles early (rejecting with AbortError) if the signal fires, so
+ *  a user interrupt isn't stuck waiting out a retry backoff. */
+function interruptibleDelay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(new DOMException("aborted", "AbortError"));
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new DOMException("aborted", "AbortError"));
+        };
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
 function detectRepo(cwd) {
     try {
         const remote = execSync("git config --get remote.origin.url", {
@@ -422,7 +458,13 @@ User time zone: ${timeZone}, UTC${timeZoneOffsetStr}`;
                 },
             ];
             let summary = "";
-            for await (const chunk of this.client.createMessage(this.systemPrompt, request, [], signal)) {
+            for await (const chunk of this.streamWithRetry(() => this.client.createMessage(this.systemPrompt, request, [], signal), signal, () => {
+                // Compaction only streams text (committed once at the end), so a
+                // mid-stream retry just discards the partial summary.
+                summary = "";
+                onEvent({ type: "stream-reset" });
+                return true;
+            })) {
                 if (signal.aborted)
                     throw new DOMException("aborted", "AbortError");
                 if (chunk.type === "text") {
@@ -468,28 +510,102 @@ User time zone: ${timeZone}, UTC${timeZoneOffsetStr}`;
             onEvent({ type: "turn-end" });
         }
     }
+    /**
+     * Consume a model stream, automatically re-establishing the request up to
+     * MAX_STREAM_RETRIES times on a transient/connection failure. A user abort is
+     * never retried.
+     *
+     * Before the first chunk of an attempt nothing has streamed, so the retry is
+     * always clean. Once chunks have streamed, retrying would duplicate on-screen
+     * output — so we only retry mid-stream when the caller supplies `onRestart` and
+     * it returns true, meaning it rolled the partial output back (cleared buffers,
+     * reset accumulators). If it can't (e.g. a row was already committed), the error
+     * propagates.
+     */
+    async *streamWithRetry(makeStream, signal, onRestart) {
+        for (let attempt = 0;; attempt++) {
+            let produced = false;
+            try {
+                for await (const chunk of makeStream()) {
+                    produced = true;
+                    yield chunk;
+                }
+                return;
+            }
+            catch (error) {
+                if (signal.aborted || error.name === "AbortError")
+                    throw error;
+                if (attempt >= MAX_STREAM_RETRIES || !isRetryableStreamError(error))
+                    throw error;
+                // Output already streamed this attempt: only retry if the caller can
+                // cleanly roll it back, otherwise a restart would duplicate it.
+                if (produced && !(onRestart?.() ?? false))
+                    throw error;
+                const delayMs = retryBackoffMs(attempt);
+                this.options.callbacks.onEvent({
+                    type: "system",
+                    message: `Connection to the model failed (${error.message}). Retrying ${attempt + 1}/${MAX_STREAM_RETRIES} in ${Math.ceil(delayMs / 1000)}s…`,
+                    isError: false,
+                });
+                await interruptibleDelay(delayMs, signal);
+            }
+        }
+    }
     /** Run one model request + tool execution round. Returns true when the turn is over. */
     async runStep() {
         const { onEvent } = this.options.callbacks;
         const signal = this.abortController.signal;
         let assistantText = "";
-        let hadReasoning = false;
+        // A reasoning segment is "open" from its first delta until visible content
+        // (text or a tool call) begins. We emit reasoning-done at that transition so
+        // "Thought for Ns" reflects only the thinking time — not the answer that
+        // follows — and the live "Thinking" block stops before the answer streams.
+        // A fresh segment can re-open if the model interleaves reasoning with content.
+        let reasoningOpen = false;
         let reasoningStart = 0;
         let reasoningDetails;
+        // Once a reasoning-done row is committed to the transcript we can't roll it
+        // back, so a mid-stream retry after that point isn't clean.
+        let reasoningRowCommitted = false;
+        const finalizeReasoning = () => {
+            if (reasoningOpen) {
+                reasoningOpen = false;
+                reasoningRowCommitted = true;
+                onEvent({ type: "reasoning-done", durationMs: Date.now() - reasoningStart });
+            }
+        };
         const toolCallsByIndex = new Map();
         let nextSyntheticIndex = 10000;
-        const stream = this.client.createMessage(this.systemPrompt, this.outgoingMessages(), getActiveTools(this.mcp), signal);
+        // Roll back this step's partial output so streamWithRetry can restart a
+        // dropped stream mid-flight. Tools only run after the stream completes, so
+        // nothing irreversible has happened yet; the one thing we can't undo is an
+        // already-committed reasoning row, so we decline the restart in that case.
+        const rollbackForRetry = () => {
+            if (reasoningRowCommitted)
+                return false;
+            assistantText = "";
+            reasoningOpen = false;
+            reasoningStart = 0;
+            reasoningDetails = undefined;
+            toolCallsByIndex.clear();
+            nextSyntheticIndex = 10000;
+            onEvent({ type: "stream-reset" });
+            return true;
+        };
+        const stream = this.streamWithRetry(() => this.client.createMessage(this.systemPrompt, this.outgoingMessages(), getActiveTools(this.mcp), signal), signal, rollbackForRetry);
         for await (const chunk of stream) {
             if (signal.aborted)
                 throw new DOMException("aborted", "AbortError");
             switch (chunk.type) {
                 case "text":
+                    // Visible content begins — the reasoning phase (if any) is over.
+                    finalizeReasoning();
                     assistantText += chunk.text;
                     onEvent({ type: "text-delta", text: chunk.text });
                     break;
                 case "reasoning":
-                    if (!hadReasoning) {
-                        hadReasoning = true;
+                    if (!reasoningOpen) {
+                        reasoningOpen = true;
                         reasoningStart = Date.now();
                     }
                     onEvent({ type: "reasoning-delta", text: chunk.text });
@@ -499,6 +615,8 @@ User time zone: ${timeZone}, UTC${timeZoneOffsetStr}`;
                     reasoningDetails = chunk.details;
                     break;
                 case "native_tool_calls":
+                    // A tool call also ends the reasoning phase.
+                    finalizeReasoning();
                     for (const tc of chunk.toolCalls) {
                         const index = tc.index ?? nextSyntheticIndex++;
                         let pending = toolCallsByIndex.get(index);
@@ -527,9 +645,8 @@ User time zone: ${timeZone}, UTC${timeZoneOffsetStr}`;
                     break;
             }
         }
-        if (hadReasoning) {
-            onEvent({ type: "reasoning-done", durationMs: Date.now() - reasoningStart });
-        }
+        // A reasoning-only turn (no following text/tool content) still needs closing.
+        finalizeReasoning();
         if (assistantText) {
             onEvent({ type: "text-done" });
         }

package/dist/prompts/system.js

@@ -32,13 +32,13 @@ You have tools at your disposal to solve the coding task. Follow these rules reg
 
 If you intend to call multiple tools and there are no dependencies between the tool calls, make all of the independent tool calls in parallel. Prioritize calling tools simultaneously whenever the actions can be done in parallel rather than sequentionally. For example, when reading 3 files, run 3 tool calls in parallel to read all 3 files into context at the same time. Maximize use of parallel tool calls where possible to increase speed and efficiency. However, if some tool calls depend on previous calls to inform dependent values like the parameters, do NOT call these tools in parallel and instead call them sequentially. Never use placeholders or guess missing parameters in tool calls.
 
-# Maximize Context Understanding
+# Gather Enough Context, Then Act
 
-Be THOROUGH when gathering information. Make sure you have the FULL picture before replying. Use additional tool calls or clarifying questions as needed.
-TRACE every symbol back to its definitions and usages so you fully understand it.
-Look past the first seemingly relevant result. EXPLORE alternative implementations, edge cases, and varied search terms until you have COMPREHENSIVE coverage of the topic.
+Speed matters: your goal is the correct change in the fewest tool calls, not exhaustive coverage. Scale exploration to the task. A small, localized change typically needs about 3-6 calls — locate the code, read the region and its immediate callers, check conventions — while only wide refactors justify long exploration.
 
-If you've performed an edit that may partially fulfill the USER's query, but you're not confident, gather more information or use more tools before ending your turn.
+You have enough context when you know exactly which files and lines to change, you have seen the surrounding code's conventions, and you know how the code you are touching is used. From that point, every further search or read is waste: stop exploring and make the edit. Before each additional call, ask whether its result could change your edit; if not, skip it. Trace only the symbols your change actually depends on, never re-read regions you have already seen, and never re-verify facts you have already established.
+
+Never edit code you have not read. If after an edit you are genuinely unsure it fulfills the USER's request, verify that specific doubt with one targeted check — do not relaunch broad exploration.
 
 Bias towards not asking the user for help if you can find the answer yourself.
 
@@ -65,7 +65,7 @@ Your system prompt may include an "Available Skills" section listing skills by n
 
 Tools whose names start with \`mcp__\` are provided by external MCP servers the user has configured. They work exactly like native tools — call them with the standard tool call format when the task requires their capabilities. Their descriptions and parameter schemas come from the MCP servers.
 
-CRITICAL: For any task, small or big, you will always and always use the update_todo_list tool to create the TODO list, always keep is upto date with updates to the status and updating/editing the list as needed.`;
+Use the update_todo_list tool to create and maintain a TODO list for any multi-step task (3 or more steps), keeping statuses up to date as you work. For trivial tasks that need only one or two steps, skip the todo list and just do the work.`;
 const toolGuide = `
 Common tool calls and explanations
 
@@ -117,20 +117,15 @@ Common tool calls and explanations
 }
 \`\`\`
 
-**Example** (editing across multiple files):
-\`\`\`json
-{
-  "edits": [
-    {"file_path": "/path/to/api.ts", "old_string": "v1", "new_string": "v2"},
-    {"file_path": "/path/to/config.ts", "old_string": "version: 1", "new_string": "version: 2"}
-  ]
-}
-\`\`\`
-
 **Guidance for choosing between file_edit and multi_file_edit**:
 - 1 edit → \`file_edit\`
 - 2+ edits → \`multi_file_edit\` (always)
 
+**Editing discipline (CRITICAL)**:
+- ALWAYS copy \`old_string\` verbatim from a read_file result obtained in the same turn. NEVER reconstruct indentation or whitespace from memory — this is especially important in tab-indented files, where a reconstructed \`old_string\` will silently mismatch.
+- After any successful edit, treat all earlier reads of that file as stale. Re-read the region with read_file before editing the same area of the file again.
+- If one edit in a \`multi_file_edit\` batch fails with a string mismatch, STOP and re-read the file before retrying that edit. Do not guess at a corrected \`old_string\` — guessed corrections compound the mismatch.
+
 ## read_file Tool Usage
 
 The \`read_file\` tool reads file contents with optional offset and limit. Use it to examine code before making changes or to discuss specific sections.
@@ -141,33 +136,9 @@ The \`read_file\` tool reads file contents with optional offset and limit. Use i
 - \`offset\` (optional): Starting line number (1-indexed). Defaults to 1.
 - \`limit\` (optional): Maximum number of lines to read. If not specified, reads the complete file. Default and maximum limit is 1000 lines.
 
-### Parameters Schema
-\`\`\`typescript
-{
-  file_path: string,    // Absolute path to file (required)
-  offset?: number,      // Starting line (1-indexed), defaults to 1
-  limit?: number        // Max lines to read, omit to read entire file
-}
-\`\`\`
-
-### Examples
-
-**Read entire file:**
-\`\`\`json
-{
-  "file_path": "/Users/username/project/src/App.tsx"
-}
-\`\`\`
-
-**Read first 50 lines:**
-\`\`\`json
-{
-  "file_path": "/Users/username/project/src/App.tsx",
-  "limit": 50
-}
-\`\`\`
+### Example
 
-**Read lines 100-150 (50 lines starting at line 100):**
+**Read lines 100-150:**
 \`\`\`json
 {
   "file_path": "/Users/username/project/src/App.tsx",
@@ -176,43 +147,17 @@ The \`read_file\` tool reads file contents with optional offset and limit. Use i
 }
 \`\`\`
 
-### Workflow: When You Don't Know Line Numbers
-
-**Step 1:** Use \`search_files\` to find the code:
-\`\`\`json
-{
-  "path": "src",
-  "regex": "function handleSubmit",
-  "file_pattern": "*.ts"
-}
-\`\`\`
-
-**Step 2:** Note the line number from search results (e.g., line 45)
-
-**Step 3:** Read that section with \`read_file\`:
-\`\`\`json
-{
-  "file_path": "/Users/username/project/src/Form.tsx",
-  "offset": 40,
-  "limit": 50
-}
-\`\`\`
+Parameter rules: \`file_path\` must be an absolute path; \`offset\` and \`limit\` must be >= 1 if specified; omit \`limit\` to read from \`offset\` to the end. Call the tool multiple times to read multiple files.
 
-### Parameter Rules
+CRITICAL: \`offset\` is what targets a region — \`limit\` alone reads the TOP of the file. To inspect line N (e.g. from search results), you MUST pass \`offset\` ≈ N-20 together with \`limit\`. Before sending the call, confirm \`offset\` is present whenever you are aiming at a specific line.
 
-1. \`file_path\` must be an absolute path
-2. \`offset\` must be >= 1 if specified
-3. \`limit\` must be >= 1 if specified
-4. If \`limit\` is omitted, the entire file is read from \`offset\`
+When you don't know line numbers: use \`search_files\` to locate the code, note the line number from the results, then \`read_file\` that region with surrounding context.
 
-### Common Patterns
+### Reading Strategy
 
-| Use Case | Parameters |
-|----------|-----------|
-| Read entire file | \`file_path\` only |
-| Read from start | \`limit: 50\` |
-| Read middle section | \`offset: 100, limit: 50\` |
-| Read from a specific line to end | \`offset: 200\` |
+- When investigating a bug, read whole functions or logical regions in ONE call rather than small slivers. Prefer one 150-line read over five 30-line reads — fragmented reads lose context and waste calls.
+- Budget your re-reads: if you have already read a region and have not edited it since, work from what you have instead of fetching it again. Re-read only when the file has changed or you genuinely lack the detail.
+- After every read, verify the output matches the parameters you sent. If you meant to read around line N but the result starts at line 1, you omitted \`offset\` — re-issue the call with \`offset\` set. NEVER re-read the top of the file expecting a different result.
 
 
 # execute_command
@@ -226,7 +171,9 @@ The tool accepts these parameters:
 - \`command\` (required): The CLI command to execute. Must be valid for the user's operating system.
 - \`cwd\` (optional): The working directory to execute the command in. If not provided, the current working directory is used. Ensure this is always an absolute path (starting with \`/\`, or a drive letter like \`C:\\\` on Windows). If you are running the command in the root directly, skip this parameter. The command executor is defaulted to run in the root directory. You already have the Current Workspace Directory in the Environment Details section.
 
-CRITICAL: If the command is a very long running process, prefer to let the user to that they can run it manually in thier terminal. If the user specifically requests to run a long running command, you may proceed.
+CRITICAL: If the command is a very long running process, prefer to let the user know so they can run it manually in their terminal. If the user specifically requests to run a long running command, you may proceed.
+
+Command validity rules: a command is never empty, never just \`:\`, never a bare single word with no arguments, and never contains tool-call markup tokens or angle-bracket tags of any kind. Commands must be valid for the user's operating system, shell, and current working directory.
 
 ## search_files
 
@@ -262,90 +209,29 @@ The \`search_files\` tool allows you to search for patterns across files in a di
   "file_pattern": null
 }
 
-// Search in JSX/TSX files only
-{
-  "path": "src/components",
-  "regex": "useState",
-  "file_pattern": "*.{jsx,tsx}"
-}
-
-// Search in nested directories
-{
-  "path": ".",
-  "regex": "API_KEY",
-  "file_pattern": "**/*.env*"
-}
-\`\`\`
-
-### ❌ INCORRECT Examples
-\`\`\`json
-// WRONG - Unquoted file_pattern (will cause JSON error)
-{
-  "path": "src",
-  "regex": "import",
-  "file_pattern": *.js
-}
-
-// WRONG - Missing file_pattern entirely
-{
-  "path": "src",
-  "regex": "import"
-}
-
-// WRONG - Empty string instead of null
-{
-  "path": "src",
-  "regex": "import",
-  "file_pattern": ""
-}
 \`\`\`
 
-### Regex Pattern Tips
-
-- Use Rust regex syntax (similar to PCRE)
-- Escape special characters: \`\\.\`, \`\\(\`, \`\\[\`, etc.
-- Common patterns:
-  - \`"word"\` - literal match
-  - \`"\\bword\\b"\` - word boundary match
-  - \`"function\\s+\\w+"\` - function declarations
-  - \`"import.*from\\s+['\\"].*['\\"]"\` - import statements
+The regex uses Rust syntax (similar to PCRE); escape special characters like \`\\.\` and \`\\(\`. \`file_pattern\` uses glob syntax: \`"*.ts"\`, \`"*.{jsx,tsx}"\`, \`"**/*.json"\`. When in doubt, use \`null\` to search all files.
 
-### File Pattern Glob Syntax
+### Search Hygiene
 
-When using a string value for \`file_pattern\`:
-- \`"*.js"\` - All .js files in directory
-- \`"*.{js,ts}"\` - All .js and .ts files
-- \`"**/*.json"\` - All .json files recursively
-- \`"test_*.py"\` - Files starting with test_
-- \`"src/**/*.tsx"\` - All .tsx files under src/
-
-**When in doubt, use \`null\` to search all files.**
-
-### Parameter Validation Checklist
-
-Before submitting, verify:
-- ✅ \`path\` is a string (directory path)
-- ✅ \`regex\` is a string (valid Rust regex)
-- ✅ \`file_pattern\` is EITHER a quoted string OR null
-- ✅ All three parameters are present
-- ✅ No unquoted glob patterns like \`*.js\`
+- Exclude test, spec, and mock paths from discovery searches by default (\`__tests__\`, \`*.spec.*\`, \`*.test.*\`, \`__mocks__\`) unless the task itself is about tests. They pollute results and bury the implementation you are looking for.
+- Scope \`path\` to the narrowest plausible directory instead of searching from the repository root.
+- If a search returns hundreds of hits, tighten the regex or \`file_pattern\` and search again. Do not scan through the dump.
 
 ### Remember
 
 **Always quote the file_pattern value or use null. Never use bare/unquoted glob patterns.**
 
-## execute_command
+## Verifying tool results and avoiding loops
+
+- After EVERY tool call, verify the output actually matches the parameters you sent (correct file, correct line range, correct directory). A result that does not reflect your parameters means the call was malformed — fix the call, do not reason from the bad output.
+- If two consecutive identical tool calls produce identical results, you are in a loop. Change the call or change the strategy. NEVER repeat the same call a third time.
 
-CRITICAL:
-1. A command never starts with \`:\`
-2. A command never contains tool-call markup tokens or angle-bracket tags of any kind
-3. A command is never empty or \`:\`
-4. A command is never a single word or a single word with a space
-5. Commands are always valid for the user's operating system
-6. Commands are always valid for the user's shell
-7. Commands are always valid with executable permissions
-8. Commands are always valid with the user's current working directory
+## Plan before editing
 
+- Investigate first, edit second. Once the root cause is confirmed, write out the full change plan — which files, the exact locations, and the edit order — BEFORE touching anything.
+- Then execute the edits in one pass (batched via \`multi_file_edit\`) and verify with a single typecheck/build at the end, rather than alternating between editing and checking.
 
 ## update_todo_list
 
@@ -353,27 +239,14 @@ CRITICAL:
 Replace the entire TODO list with an updated checklist reflecting the current state. Always provide the full list; the system will overwrite the previous one. This tool is designed for step-by-step task tracking, allowing you to confirm completion of each step before updating, update multiple task statuses at once (e.g., mark one as completed and start the next), and dynamically add new todos discovered during long or complex tasks.
 
 **Checklist Format:**
-- Use a single-level markdown checklist (no nesting or subtasks).
-- List todos in the intended execution order.
-- Status options:
-	 - [ ] Task description (pending)
-	 - [x] Task description (completed)
-	 - [-] Task description (in progress)
-
-**Status Rules:**
-- [ ] = pending (not started)
-- [x] = completed (fully finished, no unresolved issues)
-- [-] = in_progress (currently being worked on)
+- Use a single-level markdown checklist (no nesting or subtasks), in intended execution order.
+- Statuses: \`[ ]\` pending, \`[x]\` completed (fully finished, no unresolved issues), \`[-]\` in progress.
 
 **Core Principles:**
-- Before updating, always confirm which todos have been completed since the last update.
-- You may update multiple statuses in a single update (e.g., mark the previous as completed and the next as in progress).
-- When a new actionable item is discovered during a long or complex task, add it to the todo list immediately.
-- Do not remove any unfinished todos unless explicitly instructed.
-- Always retain all unfinished tasks, updating their status as needed.
-- Only mark a task as completed when it is fully accomplished (no partials, no unresolved dependencies).
-- If a task is blocked, keep it as in_progress and add a new todo describing what needs to be resolved.
-- Remove tasks only if they are no longer relevant or if the user requests deletion.
+- Update multiple statuses in a single call (e.g., mark the previous task completed and the next in progress).
+- Add newly discovered actionable items immediately. Retain all unfinished tasks; remove one only if it is no longer relevant or the user asks.
+- Mark a task completed only when fully accomplished. If blocked, keep it in_progress and add a todo describing what must be resolved.
+- Keep the todo list AHEAD of the work, not behind it: it is a steering tool, not a changelog. Lay out upcoming steps before you start them instead of only recording steps after they are finished.
 
 IMPORTANT: Use attempt_completion tool when you have completed the task. This signals that you are done.
 `;

package/dist/ui/App.js

@@ -40,6 +40,10 @@ const SLASH_COMMANDS = [
         description: "summarize the conversation to free up context",
     },
     { name: "/tasks", description: "show the current task list" },
+    {
+        name: "/task",
+        description: "reference a previous task in the current conversation",
+    },
     {
         name: "/status",
         description: "show session status (model, context, cost, account)",
@@ -178,6 +182,44 @@ Instructions:
 5. Finish with a short summary: all findings ordered by severity, and an overall verdict on whether the changes are safe to merge.
 
 This is a review only — do NOT modify any files. Present the findings to the user.${userInput ? `\n\nThe user provided the following input with the code-review command:\n${userInput}` : ""}`;
+const MAX_TASK_CONVERSATION_CHARS = 8000;
+function extractConversation(session) {
+    const lines = [];
+    for (const message of session.messages) {
+        if (message.role === "user" && typeof message.content === "string") {
+            const match = /<user_query>\n?([\s\S]*?)\n?<\/user_query>/.exec(message.content);
+            if (match)
+                lines.push(`User: ${match[1]}`);
+        }
+        else if (message.role === "assistant" &&
+            typeof message.content === "string" &&
+            message.content.trim()) {
+            lines.push(`Assistant: ${message.content}`);
+        }
+    }
+    return lines.join("\n\n");
+}
+function buildTaskReferencePrompt(session) {
+    const conversation = extractConversation(session);
+    const truncated = conversation.length > MAX_TASK_CONVERSATION_CHARS
+        ? conversation.slice(0, MAX_TASK_CONVERSATION_CHARS) +
+            "\n\n[... conversation truncated ...]"
+        : conversation;
+    return `The user has referenced a previous task. Here is the conversation from that task:
+
+<previous_task title="${session.title || session.id}">
+${truncated}
+</previous_task>
+
+Please summarize this previous task and add it as a reference for the current task. The summary should capture:
+- What the task was about
+- What was accomplished
+- Key decisions made
+- Files that were created or modified
+- Any remaining work
+
+Present the summary in a clear, organized format. This summary will serve as context for the current task.`;
+}
 let rowCounter = 0;
 function rowId() {
     return `row-${rowCounter++}`;
@@ -210,6 +252,7 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
     const [queuedMessages, setQueuedMessages] = useState([]);
     const [modelPickerOpen, setModelPickerOpen] = useState(false);
     const [resumableSessions, setResumableSessions] = useState(null);
+    const [taskPickerSessions, setTaskPickerSessions] = useState(null);
     const [linkManagerOpen, setLinkManagerOpen] = useState(false);
     const [links, setLinks] = useState([]);
     const [linkStatus, setLinkStatus] = useState("");
@@ -344,6 +387,17 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
                 setStreamingText("");
                 setBusyLabel("Working");
                 break;
+            case "stream-reset":
+                // An auto-retry is re-streaming this step from scratch — drop the
+                // partial text/reasoning shown for the failed attempt so it doesn't
+                // duplicate. (Committed rows are untouched; the agent only resets when
+                // nothing has been committed yet.)
+                textBufferRef.current = "";
+                setStreamingText("");
+                reasoningBufferRef.current = "";
+                setStreamingReasoning("");
+                setBusyLabel("Working");
+                break;
             case "tool-start":
                 setBusyLabel("Working");
                 break;
@@ -485,6 +539,16 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
             text: `Resumed session: ${session.title || session.id}`,
         });
     }, [createAgent, pushRow, resetTranscript]);
+    const handleTaskSelect = useCallback((session) => {
+        setTaskPickerSessions(null);
+        pushRow({
+            kind: "user",
+            text: `/task (referencing: ${session.title || session.id})`,
+        });
+        setBusy(true);
+        setBusyLabel("Thinking");
+        void getAgent().runTurn(buildTaskReferencePrompt(session));
+    }, [getAgent, pushRow]);
     const switchModel = useCallback((modelId) => {
         const updated = { ...loadSettings(), model: modelId };
         setSettings(updated);
@@ -607,6 +671,22 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
                 setResumableSessions(sessions);
                 break;
             }
+            case "/task": {
+                if (!getAuthToken(settings)) {
+                    setView("login");
+                    break;
+                }
+                const taskSessions = listSessions(process.cwd()).filter((s) => s.id !== agentRef.current?.taskId);
+                if (taskSessions.length === 0) {
+                    pushRow({
+                        kind: "info",
+                        text: "No previous tasks found for this directory.",
+                    });
+                    break;
+                }
+                setTaskPickerSessions(taskSessions);
+                break;
+            }
             case "/compact":
                 if (!getAuthToken(settings)) {
                     setView("login");
@@ -1021,6 +1101,7 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
         !mcpPickerOpen &&
         !mcpMigrationEntries &&
         !resumableSessions &&
+        !taskPickerSessions &&
         !linkManagerOpen;
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: rows, children: (row) => _jsx(RowView, { row: row }, row.id) }, staticKey), view === "login" ? (_jsx(LoginSection, { onLogin: handleLogin })) : (_jsxs(Box, { flexDirection: "column", children: [updateInfo?.updateAvailable && updateInfo.latest && (_jsxs(Box, { marginTop: 1, flexDirection: "column", borderStyle: "round", borderColor: COLORS.warning, paddingX: 2, alignSelf: "flex-start", children: [_jsxs(Text, { color: COLORS.warning, bold: true, children: ["\u2191 Update available: v", updateInfo.current, " \u2192 v", updateInfo.latest] }), _jsxs(Text, { children: ["Run ", _jsx(Text, { color: COLORS.accent, children: "orbcode update" }), " to install the latest version, then relaunch."] })] })), streamingReasoning && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: COLORS.thinking, italic: true, children: "\u2726 Thinking\u2026" }), _jsx(Box, { paddingLeft: 2, children: _jsx(Text, { dimColor: true, italic: true, children: tail(streamingReasoning, expandReasoningRef.current ? 30 : 3) }) })] })), streamingText && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Text, { color: COLORS.primary, children: "\u25CF " }), streamingText] }) })), taskLines.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, paddingLeft: 1, children: [_jsx(Text, { dimColor: true, bold: true, children: "Tasks" }), taskLines.slice(0, 10).map((line, i) => (_jsx(Text, { dimColor: /^[-*]\s*\[x\]/i.test(line), children: line
                                     .replace(/^[-*]\s*\[x\]/i, "  ■")
@@ -1028,7 +1109,7 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
                                     .replace(/^[-*]\s*\[ \]/, "  □") }, i))), taskLines.length > 10 && (_jsxs(Text, { dimColor: true, children: [" \u2026 ", taskLines.length - 10, " more"] }))] })), modelPickerOpen && (_jsx(Box, { marginTop: 1, children: _jsx(ModelPicker, { currentId: settings.model, onSelect: (modelId) => {
                                 setModelPickerOpen(false);
                                 switchModel(modelId);
-                            }, onCancel: () => setModelPickerOpen(false) }) })), resumableSessions && (_jsx(Box, { marginTop: 1, children: _jsx(SessionPicker, { sessions: resumableSessions, onSelect: handleResume, onCancel: () => setResumableSessions(null) }) })), linkManagerOpen && (_jsx(Box, { marginTop: 1, children: _jsx(LinkManager, { links: links, status: linkStatus, onAdd: (input) => {
+                            }, onCancel: () => setModelPickerOpen(false) }) })), resumableSessions && (_jsx(Box, { marginTop: 1, children: _jsx(SessionPicker, { sessions: resumableSessions, onSelect: handleResume, onCancel: () => setResumableSessions(null) }) })), taskPickerSessions && (_jsx(Box, { marginTop: 1, children: _jsx(SessionPicker, { sessions: taskPickerSessions, title: "Reference a previous task", onSelect: handleTaskSelect, onCancel: () => setTaskPickerSessions(null) }) })), linkManagerOpen && (_jsx(Box, { marginTop: 1, children: _jsx(LinkManager, { links: links, status: linkStatus, onAdd: (input) => {
                                 const result = addLink(process.cwd(), input);
                                 setLinkStatus(result.message);
                                 if (result.ok)

package/dist/ui/components/SessionPicker.js

@@ -16,7 +16,7 @@ function relativeTime(iso) {
     const days = Math.round(hours / 24);
     return `${days}d ago`;
 }
-export function SessionPicker({ sessions, onSelect, onCancel }) {
+export function SessionPicker({ sessions, onSelect, onCancel, title = "Resume a previous session" }) {
     const [selected, setSelected] = useState(0);
     useInput((input, key) => {
         if (key.upArrow) {
@@ -43,7 +43,7 @@ export function SessionPicker({ sessions, onSelect, onCancel }) {
     });
     const windowStart = Math.max(0, Math.min(selected - VISIBLE_ROWS + 1, sessions.length - VISIBLE_ROWS));
     const visible = sessions.slice(windowStart, windowStart + VISIBLE_ROWS);
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: COLORS.primary, paddingX: 1, children: [_jsx(Text, { bold: true, color: COLORS.primary, children: "Resume a previous session" }), windowStart > 0 && _jsxs(Text, { dimColor: true, children: ["  \u2191 ", windowStart, " more"] }), visible.map((session, i) => {
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: COLORS.primary, paddingX: 1, children: [_jsx(Text, { bold: true, color: COLORS.primary, children: title }), windowStart > 0 && _jsxs(Text, { dimColor: true, children: ["  \u2191 ", windowStart, " more"] }), visible.map((session, i) => {
                 const index = windowStart + i;
                 const isSelected = index === selected;
                 const userTurns = session.messages.filter((m) => m.role === "user").length;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterailab/orbcode",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "OrbCode CLI — agentic coding in your terminal, powered by Axon models by MatterAI",
   "type": "module",
   "bin": {