@matterailab/orbcode 0.1.3 → 0.1.5

package/README.md

@@ -7,6 +7,8 @@ models, the same native tool schemas, the same MatterAI auth backend — rebuilt
 scratch as an interactive TUI with streaming chat, live thinking display, tool
 activity rows, edit/command approvals, and todo tracking.
 
+![OrbCode CLI screenshot](assets/orbcode-screenshot.webp)
+
 ---
 
 ## Table of contents
@@ -144,12 +146,13 @@ The two Axon models are built in; `/model` opens a scroll-and-select picker
 (`/model <id>` still selects directly). Additional models can be declared via
 `customModels` in settings.json. The choice persists across sessions.
 
-| id                  | context | max output | pricing                  |
-|---------------------|---------|------------|--------------------------|
-| `axon-code-2-5-pro` | 400k    | 64k        | $2/M in · $6/M out       |
-| `axon-code-2-5-mini`| 400k    | 64k        | free                     |
+| id                     | context | max output | pricing            |
+| ---------------------- | ------- | ---------- | ------------------ |
+| `axon-eido-3-code-pro` | 400k    | 64k        | $3/M in · $9/M out |
+| `axon-code-2-5-pro`    | 400k    | 64k        | $2/M in · $6/M out |
+| `axon-code-2-5-mini`   | 400k    | 64k        | free               |
 
-`axon-code-2-5-pro` is the default. Both support native JSON tool calls and
+`axon-code-2-5-pro` 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.
 
@@ -196,35 +199,35 @@ shown in the status bar.
 
 ## Slash commands
 
-| command    | action |
-|------------|--------|
-| `/help`    | list commands |
-| `/model`   | scrollable model picker (`/model pro` / `/model mini` / full id selects directly) |
-| `/clear`   | clear the screen only, like the terminal's `clear` — the conversation and context continue |
-| `/new`     | start a fresh conversation/session with a clean slate |
-| `/resume`  | pick a previous session for this directory and continue it (screen is cleared, conversation replayed) |
-| `/analytics` | open the MatterAI analytics dashboard (app.matterai.so/orbital) in the browser |
-| `/compact` | summarize the conversation and replace history with the summary |
-| `/tasks`   | print the current task list |
-| `/status`  | version, model, account, gateway, context usage, cost, approval modes |
-| `/cost`    | show session cost and fetch account balance |
-| `/init`    | analyze the codebase and create/improve `AGENTS.md` |
-| `/login`   | start the browser sign-in flow |
-| `/logout`  | remove the saved token |
-| `/version` | print the CLI version |
-| `/exit`    | quit |
+| command      | action                                                                                                |
+| ------------ | ----------------------------------------------------------------------------------------------------- |
+| `/help`      | list commands                                                                                         |
+| `/model`     | scrollable model picker (`/model pro` / `/model mini` / full id selects directly)                     |
+| `/clear`     | clear the screen only, like the terminal's `clear` — the conversation and context continue            |
+| `/new`       | start a fresh conversation/session with a clean slate                                                 |
+| `/resume`    | pick a previous session for this directory and continue it (screen is cleared, conversation replayed) |
+| `/analytics` | open the MatterAI analytics dashboard (app.matterai.so/orbital) in the browser                        |
+| `/compact`   | summarize the conversation and replace history with the summary                                       |
+| `/tasks`     | print the current task list                                                                           |
+| `/status`    | version, model, account, gateway, context usage, cost, approval modes                                 |
+| `/cost`      | show session cost and fetch account balance                                                           |
+| `/init`      | analyze the codebase and create/improve `AGENTS.md`                                                   |
+| `/login`     | start the browser sign-in flow                                                                        |
+| `/logout`    | remove the saved token                                                                                |
+| `/version`   | print the CLI version                                                                                 |
+| `/exit`      | quit                                                                                                  |
 
 ## Keyboard shortcuts
 
-| key | action |
-|-----|--------|
-| `Esc` | interrupt the running turn (or cancel login polling / close a menu) |
-| `Ctrl+C` | quit |
-| `Ctrl+O` | toggle thinking display for the whole transcript (past turns included) |
-| `Shift+Tab` | cycle approval mode: ask → accept edits → auto-approve |
-| `↑` / `↓` | input history, or navigate any open menu |
-| `Ctrl+A` / `Ctrl+E` | start / end of line |
-| `Ctrl+U` | clear the input line |
+| key                 | action                                                                 |
+| ------------------- | ---------------------------------------------------------------------- |
+| `Esc`               | interrupt the running turn (or cancel login polling / close a menu)    |
+| `Ctrl+C`            | quit                                                                   |
+| `Ctrl+O`            | toggle thinking display for the whole transcript (past turns included) |
+| `Shift+Tab`         | cycle approval mode: ask → accept edits → auto-approve                 |
+| `↑` / `↓`           | input history, or navigate any open menu                               |
+| `Ctrl+A` / `Ctrl+E` | start / end of line                                                    |
+| `Ctrl+U`            | clear the input line                                                   |
 
 ## Approvals & safety
 
@@ -267,22 +270,22 @@ Two kinds of files under `~/.orbcode/`:
 
 ```json
 {
-	"apiKey": "<token used instead of logging in>",
-	"baseUrl": "https://my-gateway.example.com/v1",
-	"model": "my-custom-model",
-	"autoApproveEdits": false,
-	"autoApproveSafeCommands": false,
-	"customModels": [
-		{
-			"id": "my-custom-model",
-			"name": "My Custom Model",
-			"contextWindow": 128000,
-			"maxOutputTokens": 32000,
-			"inputPrice": 0.000001,
-			"outputPrice": 0.000002
-		}
-	],
-	"env": { "MY_VAR": "value" }
+  "apiKey": "<token used instead of logging in>",
+  "baseUrl": "https://my-gateway.example.com/v1",
+  "model": "my-custom-model",
+  "autoApproveEdits": false,
+  "autoApproveSafeCommands": false,
+  "customModels": [
+    {
+      "id": "my-custom-model",
+      "name": "My Custom Model",
+      "contextWindow": 128000,
+      "maxOutputTokens": 32000,
+      "inputPrice": 0.000001,
+      "outputPrice": 0.000002
+    }
+  ],
+  "env": { "MY_VAR": "value" }
 }
 ```
 
@@ -295,15 +298,15 @@ config.json.
 Sessions are stored in `~/.orbcode/sessions/<id>.json` and power `/resume`
 and `--resume <id>`.
 
-| env var | effect |
-|---------|--------|
-| `ORBCODE_TOKEN` | auth token (overrides everything) |
-| `ORBCODE_API_KEY` | same as `apiKey` in settings.json |
-| `ORBCODE_BASE_URL` | same as `baseUrl` in settings.json |
-| `ORBCODE_MODEL` | model override (what `--model` sets internally) |
-| `ORBCODE_CONFIG_DIR` | config directory (default `~/.orbcode`) |
-| `ORBCODE_BACKEND_URL` | device-auth backend (default `https://api.matterai.so`) |
-| `ORBCODE_APP_URL` | webapp for the authorize page (default `https://app.matterai.so`) |
+| env var               | effect                                                            |
+| --------------------- | ----------------------------------------------------------------- |
+| `ORBCODE_TOKEN`       | auth token (overrides everything)                                 |
+| `ORBCODE_API_KEY`     | same as `apiKey` in settings.json                                 |
+| `ORBCODE_BASE_URL`    | same as `baseUrl` in settings.json                                |
+| `ORBCODE_MODEL`       | model override (what `--model` sets internally)                   |
+| `ORBCODE_CONFIG_DIR`  | config directory (default `~/.orbcode`)                           |
+| `ORBCODE_BACKEND_URL` | device-auth backend (default `https://api.matterai.so`)           |
+| `ORBCODE_APP_URL`     | webapp for the authorize page (default `https://app.matterai.so`) |
 
 `autoApproveEdits` / `autoApproveSafeCommands` set the session defaults for the
 approval prompts (dangerous commands still always prompt); shift+tab cycles
@@ -365,19 +368,19 @@ reset date — the same data as the extension's profile view.
 
 Active in the CLI (schemas byte-identical to the extension's `native-tools`):
 
-| tool | executor notes |
-|------|----------------|
-| `read_file` | line-numbered output (`LINE\|content`, 6-char pad), 1000-line cap, offset/limit |
-| `file_edit` | single replacement; unique-match enforcement; `replace_all`; empty `old_string` = whole file |
-| `multi_file_edit` | batched edits grouped per file, per-edit OK/FAILED results |
-| `file_write` | creates parent dirs, full-content writes |
-| `list_files` | optional recursive, ignores node_modules/.git/build dirs, 800-entry cap |
-| `search_files` | JS regex search with glob `file_pattern` (picomatch), 300-match cap, binary skip |
-| `execute_command` | user's shell, 120s timeout, 30k output cap, optional cwd |
-| `web_search` / `web_fetch` | proxied through the MatterAI backend with your token |
-| `update_todo_list` | drives the TUI todo panel |
-| `ask_followup_question` | interactive menu in the TUI |
-| `attempt_completion` | ends the turn with a completion card |
+| tool                       | executor notes                                                                               |
+| -------------------------- | -------------------------------------------------------------------------------------------- |
+| `read_file`                | line-numbered output (`LINE\|content`, 6-char pad), 1000-line cap, offset/limit              |
+| `file_edit`                | single replacement; unique-match enforcement; `replace_all`; empty `old_string` = whole file |
+| `multi_file_edit`          | batched edits grouped per file, per-edit OK/FAILED results                                   |
+| `file_write`               | creates parent dirs, full-content writes                                                     |
+| `list_files`               | optional recursive, ignores node_modules/.git/build dirs, 800-entry cap                      |
+| `search_files`             | JS regex search with glob `file_pattern` (picomatch), 300-match cap, binary skip             |
+| `execute_command`          | user's shell, 120s timeout, 30k output cap, optional cwd                                     |
+| `web_search` / `web_fetch` | proxied through the MatterAI backend with your token                                         |
+| `update_todo_list`         | drives the TUI todo panel                                                                    |
+| `ask_followup_question`    | interactive menu in the TUI                                                                  |
+| `attempt_completion`       | ends the turn with a completion card                                                         |
 
 Present in `tools/schemas/` but **inactive** (need IDE services): `codebase_search`,
 `lsp`, `list_code_definition_names`, `use_skill`, `check_past_chat_memories`,
@@ -417,6 +420,7 @@ Source-of-truth rule: behavior is **ported from the Orbital extension repo**
 schemas byte-identical rather than editing them here.
 
 Backend/web pieces of the device-auth flow live in:
+
 - `gravity-console-backend` → `src/controller/orbcodeAuthController.ts`
   (+ OAuth state in `router.ts`, callbacks in `authController.ts`)
 - `gravity-console-webapp` → authorize dialog in `src/App.js`, sign-in q-p

package/dist/api/models.js

@@ -21,6 +21,17 @@ export const AXON_MODELS = {
         outputPrice: 0.000006,
         free: false,
     },
+    "axon-eido-3-code-pro": {
+        id: "axon-eido-3-code-pro",
+        name: "Axon Eido 3 Pro",
+        description: "Axon Eido 3 Pro is the frontier Axon Code model for coding tasks, long running agents and general intelligence, fine-tuned on open source models.",
+        contextWindow: 400000,
+        maxOutputTokens: 64000,
+        supportsImages: true,
+        inputPrice: 0.000003,
+        outputPrice: 0.000009,
+        free: false,
+    },
 };
 export const DEFAULT_MODEL_ID = "axon-code-2-5-pro";
 /** Add user-defined models (from settings.json) to the registry. */

package/dist/auth/auth.js

@@ -78,7 +78,10 @@ export async function pollDeviceAuth(devicecode) {
 export async function fetchProfile(token) {
     const url = getUrlFromToken("https://api.matterai.so/axoncode/profile", token);
     const response = await fetch(url, {
-        headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
     });
     if (!response.ok) {
         throw new Error(`Profile request failed (${response.status}). Your token may be invalid or expired.`);
@@ -150,7 +153,9 @@ export async function fetchTaskTitle(taskId, token, maxRetries = 3, retryDelayMs
 export async function fetchBalance(token, organizationId) {
     try {
         const url = getUrlFromToken("https://api.matterai.so/api/profile/balance", token);
-        const headers = { Authorization: `Bearer ${token}` };
+        const headers = {
+            Authorization: `Bearer ${token}`,
+        };
         if (organizationId)
             headers["X-KiloCode-OrganizationId"] = organizationId;
         const response = await fetch(url, { headers });

package/dist/index.js

@@ -4,6 +4,8 @@ import { PRODUCT_NAME, VERSION } from "./branding.js";
 import { App } from "./ui/App.js";
 import { runHeadless } from "./headless.js";
 import { loadSessionById } from "./core/sessions.js";
+import { clearUpdateCache, compareVersions, fetchLatestNpmVersion, getGlobalInstallRoot, getUpdateInfo, isGlobalInstall, runNpmUpdate, } from "./utils/updateCheck.js";
+const PACKAGE_NAME = "@matterailab/orbcode";
 function printHelp() {
     console.log(`${PRODUCT_NAME} v${VERSION}
 
@@ -11,6 +13,7 @@ Usage:
   orbcode                 start an interactive session
   orbcode "<prompt>"      start an interactive session with an initial prompt
   orbcode login           sign in to MatterAI
+  orbcode update          install the latest version from npm
   orbcode -p "<prompt>"   run a single prompt non-interactively (prints only the final response)
   orbcode -p "…" --yolo   non-interactive with auto-approved edits/commands
   orbcode --model <id>    use a specific model for this run
@@ -19,6 +22,32 @@ Usage:
   orbcode --help          show this help
 `);
 }
+async function runUpdate() {
+    const latest = await fetchLatestNpmVersion(PACKAGE_NAME);
+    if (latest === null) {
+        console.error("Could not reach the npm registry. Check your network connection and try again.");
+        return 1;
+    }
+    if (compareVersions(VERSION, latest) >= 0) {
+        console.log(`${PRODUCT_NAME} v${VERSION} is already up to date (latest: v${latest}).`);
+        return 0;
+    }
+    console.log(`Updating ${PRODUCT_NAME} v${VERSION} → v${latest}…`);
+    const global = isGlobalInstall();
+    if (!global) {
+        const root = await getGlobalInstallRoot();
+        console.error(`This CLI was not installed globally (argv[1] = ${process.argv[1] || "<unknown>"}).\n` +
+            `To update a local/dev install, run \`npm install -g ${PACKAGE_NAME}@latest\` manually, or \`npm install\` inside the source checkout.` +
+            (root ? `\nGlobal install root detected at: ${root}` : ""));
+        return 1;
+    }
+    clearUpdateCache();
+    const code = await runNpmUpdate(PACKAGE_NAME);
+    if (code === 0) {
+        console.log(`Updated to v${latest}. Run \`${PRODUCT_NAME.split(" ")[0].toLowerCase()}\` again to use it.`);
+    }
+    return code;
+}
 /** Pop `flag <value>` (accepting -flag and --flag) out of args; returns the value. */
 function takeFlagValue(args, name) {
     const index = args.findIndex((a) => a === `--${name}` || a === `-${name}`);
@@ -42,6 +71,10 @@ async function main() {
         printHelp();
         return;
     }
+    if (args[0] === "update") {
+        const code = await runUpdate();
+        process.exit(code);
+    }
     const model = takeFlagValue(args, "model") ?? takeFlagValue(args, "m");
     if (model) {
         // loadSettings() treats ORBCODE_MODEL as the highest-precedence override,
@@ -76,7 +109,10 @@ async function main() {
         process.stdout.write("\x1b[2J\x1b[H");
         process.stdout.write("\x1b]0;orbcode\x07");
     }
-    render(_jsx(App, { initialView: initialView, initialPrompt: initialPrompt, initialSession: initialSession }));
+    // Fire-and-forget: a stale or no-network state just means the header shows
+    // the "current version" line instead of an upgrade prompt.
+    const updateCheckPromise = getUpdateInfo(PACKAGE_NAME, VERSION);
+    render(_jsx(App, { initialView: initialView, initialPrompt: initialPrompt, initialSession: initialSession, updateCheck: updateCheckPromise }));
 }
 main().catch((error) => {
     console.error(error);

package/dist/ui/App.js

@@ -41,6 +41,28 @@ function setTerminalTitle(title) {
         process.stdout.write(`\x1b]0;${title}\x07`);
     }
 }
+function formatRelativeTime(isoStr) {
+    if (!isoStr)
+        return "???";
+    const now = Date.now();
+    const target = new Date(isoStr).getTime();
+    if (Number.isNaN(target))
+        return "???";
+    const diff = target - now;
+    if (diff <= 0)
+        return "now";
+    const sec = Math.floor(diff / 1000);
+    const min = Math.floor(sec / 60);
+    const hrs = Math.floor(min / 60);
+    const days = Math.floor(hrs / 24);
+    if (days >= 1)
+        return `in ${days} day${days > 1 ? "s" : ""}`;
+    if (hrs >= 1)
+        return `in ${hrs}h ${min % 60}m`;
+    if (min >= 1)
+        return `in ${min}m`;
+    return "soon";
+}
 /** Human lines for the /status and /cost usage block (extension profile data). */
 function usageLines(profile) {
     const lines = [];
@@ -52,8 +74,22 @@ function usageLines(profile) {
     if (typeof profile.remainingReviews === "number") {
         lines.push(`Reviews     ${profile.remainingReviews} remaining`);
     }
-    if (profile.creditsResetDate)
+    if (profile.tieredUsage) {
+        const ws = [
+            ["5hr", "5-Hour", profile.tieredUsage.fiveHour],
+            ["wk", "Weekly", profile.tieredUsage.weekly],
+            ["mo", "Monthly", profile.tieredUsage.monthly],
+        ];
+        for (const [short, label, w] of ws) {
+            const remaining = Math.max(0, w.remaining || 0);
+            const pct = Math.max(0, Math.min(100, w.percentage || 0));
+            const reset = formatRelativeTime(w.resetsAt);
+            lines.push(`${label.padEnd(12)} ${remaining.toFixed(1)}/${w.limit.toFixed(1)} left (${pct}% used) · Resets ${reset}`);
+        }
+    }
+    else if (profile.creditsResetDate) {
         lines.push(`Resets      ${profile.creditsResetDate}`);
+    }
     return lines;
 }
 const INIT_PROMPT = `Analyze this codebase and create an AGENTS.md file containing:
@@ -106,10 +142,11 @@ let rowCounter = 0;
 function rowId() {
     return `row-${rowCounter++}`;
 }
-export function App({ initialView, initialPrompt, initialSession, }) {
+export function App({ initialView, initialPrompt, initialSession, updateCheck, }) {
     const { exit } = useApp();
     const [settings, setSettings] = useState(() => loadSettings());
     const [view, setView] = useState(initialView ?? (getAuthToken(settings) ? "chat" : "login"));
+    const [updateInfo, setUpdateInfo] = useState(null);
     const [rows, setRows] = useState(() => [
         { kind: "header", id: "header", cwd: process.cwd(), modelName: getModel(loadSettings().model).name },
     ]);
@@ -120,6 +157,10 @@ export function App({ initialView, initialPrompt, initialSession, }) {
     const [runningTool, setRunningTool] = useState(null);
     const [pendingApproval, setPendingApproval] = useState(null);
     const [pendingFollowup, setPendingFollowup] = useState(null);
+    // FIFO queue of messages the user typed while the LLM was still streaming.
+    // Drained one-per-turn on each `turn-end` event so multi-step work can
+    // keep flowing without making the user wait for the previous response.
+    const [queuedMessages, setQueuedMessages] = useState([]);
     const [modelPickerOpen, setModelPickerOpen] = useState(false);
     const [resumableSessions, setResumableSessions] = useState(null);
     const [staticKey, setStaticKey] = useState(0);
@@ -139,7 +180,7 @@ export function App({ initialView, initialPrompt, initialSession, }) {
         if (!token)
             return;
         fetchProfile(token)
-            .then((profile) => setUsage({ plan: profile.plan, usagePercentage: profile.usagePercentage }))
+            .then((profile) => setUsage({ plan: profile.plan, usagePercentage: profile.usagePercentage, tieredUsage: profile.tieredUsage }))
             .catch(() => { });
     }, []);
     const agentRef = useRef(null);
@@ -148,6 +189,26 @@ export function App({ initialView, initialPrompt, initialSession, }) {
     const textBufferRef = useRef("");
     // taskId for which a title fetch has already been started (once per task).
     const titleTaskRef = useRef(null);
+    // Mirror of `queuedMessages` for the agent event handler (kept on a ref so
+    // we can drain it inside `handleEvent` without re-creating that callback
+    // on every keystroke).
+    const queueRef = useRef([]);
+    const enqueueMessage = useCallback((text) => {
+        queueRef.current = [...queueRef.current, text];
+        setQueuedMessages(queueRef.current);
+    }, []);
+    const drainQueue = useCallback(() => {
+        if (queueRef.current.length === 0)
+            return null;
+        const [next, ...rest] = queueRef.current;
+        queueRef.current = rest;
+        setQueuedMessages(rest);
+        return next;
+    }, []);
+    const clearQueue = useCallback(() => {
+        queueRef.current = [];
+        setQueuedMessages([]);
+    }, []);
     const maybeFetchTitle = useCallback(() => {
         const agent = agentRef.current;
         if (!agent || titleTaskRef.current === agent.taskId)
@@ -227,6 +288,10 @@ export function App({ initialView, initialPrompt, initialSession, }) {
             case "usage":
                 setContextTokens(event.inputTokens + event.outputTokens);
                 setTotalCost(event.totalCost);
+                // A usage chunk arrives once per LLM response, so the plan/usage
+                // shown below the chat box stays current mid-turn, not only
+                // after the turn finishes.
+                refreshUsage();
                 break;
             case "completion":
                 pushRow({ kind: "completion", text: event.result });
@@ -249,9 +314,25 @@ export function App({ initialView, initialPrompt, initialSession, }) {
                 setBusy(false);
                 maybeFetchTitle();
                 refreshUsage();
+                // Pop the next queued message and immediately start a new
+                // turn on top of the one that just ended. The agent's
+                // `runTurn` is fully resolved at this point (its
+                // `finally` emitted this event), so the new turn picks
+                // up the up-to-date conversation history. We use
+                // `agentRef` directly here to avoid a circular
+                // `handleEvent` ↔ `getAgent` reference; the ref is
+                // guaranteed populated because `runTurn` set it
+                // synchronously before emitting this event.
+                const nextQueued = drainQueue();
+                if (nextQueued !== null && agentRef.current) {
+                    pushRow({ kind: "user", text: nextQueued });
+                    setBusy(true);
+                    setBusyLabel("Thinking");
+                    void agentRef.current.runTurn(nextQueued);
+                }
                 break;
         }
-    }, [pushRow, maybeFetchTitle, refreshUsage]);
+    }, [pushRow, maybeFetchTitle, refreshUsage, drainQueue]);
     const createAgent = useCallback((resume) => {
         const current = loadSettings();
         return new Agent({
@@ -324,11 +405,20 @@ export function App({ initialView, initialPrompt, initialSession, }) {
                 if (arg && isValidAxonModel(arg)) {
                     switchModel(arg);
                 }
-                else if (arg && isValidAxonModel(`axon-code-2-5-${arg}`)) {
-                    switchModel(`axon-code-2-5-${arg}`);
-                }
                 else if (arg) {
-                    pushRow({ kind: "error", text: `Unknown model "${arg}". Available: ${ids.join(", ")}` });
+                    // Allow short suffixes like "pro" or "mini" to resolve to the
+                    // latest matching registered id, so /model pro keeps working
+                    // as new model generations are added.
+                    const matches = ids
+                        .filter((id) => id.endsWith(`-${arg}`))
+                        .sort()
+                        .reverse();
+                    if (matches.length > 0) {
+                        switchModel(matches[0]);
+                    }
+                    else {
+                        pushRow({ kind: "error", text: `Unknown model "${arg}". Available: ${ids.join(", ")}` });
+                    }
                 }
                 else {
                     setModelPickerOpen(true);
@@ -342,6 +432,7 @@ export function App({ initialView, initialPrompt, initialSession, }) {
                 break;
             case "/new":
                 // Drop the agent entirely so the next message starts a fresh session.
+                clearQueue();
                 agentRef.current = null;
                 titleTaskRef.current = null;
                 setSessionTitle("");
@@ -465,6 +556,7 @@ export function App({ initialView, initialPrompt, initialSession, }) {
                 setView("login");
                 break;
             case "/logout": {
+                clearQueue();
                 const updated = { ...settings, token: undefined };
                 setSettings(updated);
                 saveSettings(updated);
@@ -478,7 +570,7 @@ export function App({ initialView, initialPrompt, initialSession, }) {
             default:
                 pushRow({ kind: "error", text: `Unknown command: ${name}. Try /help.` });
         }
-    }, [settings, tasks, contextTokens, totalCost, sessionTitle, exit, pushRow, getAgent, switchModel, resetTranscript]);
+    }, [settings, tasks, contextTokens, totalCost, sessionTitle, exit, pushRow, getAgent, switchModel, resetTranscript, clearQueue]);
     const handleSubmit = useCallback((value) => {
         if (value.startsWith("/")) {
             handleCommand(value);
@@ -488,11 +580,18 @@ export function App({ initialView, initialPrompt, initialSession, }) {
             setView("login");
             return;
         }
+        // While the LLM is still streaming, hold the message in a FIFO
+        // queue instead of dropping it on the floor. `handleEvent`'s
+        // `turn-end` case drains the queue and starts the next turn.
+        if (busy) {
+            enqueueMessage(value);
+            return;
+        }
         pushRow({ kind: "user", text: value });
         setBusy(true);
         setBusyLabel("Thinking");
         void getAgent().runTurn(value);
-    }, [settings.token, handleCommand, getAgent, pushRow]);
+    }, [settings, busy, handleCommand, enqueueMessage, getAgent, pushRow]);
     // Apply --resume and an initial prompt (`orbcode "do something"`) on startup.
     const bootedRef = useRef(false);
     useEffect(() => {
@@ -505,7 +604,29 @@ export function App({ initialView, initialPrompt, initialSession, }) {
             handleSubmit(initialPrompt);
         refreshUsage();
     }, [initialSession, initialPrompt, handleResume, handleSubmit, refreshUsage]);
+    // Resolve the npm version check after first paint so the TUI shows up
+    // immediately and the upgrade banner fades in once we know the answer.
+    useEffect(() => {
+        if (!updateCheck)
+            return;
+        let cancelled = false;
+        updateCheck.then((info) => {
+            if (!cancelled)
+                setUpdateInfo(info);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [updateCheck]);
     useInput((input, key) => {
+        // Ctrl+D quits from any view (chat, login, busy, picker, approval,
+        // followup). InputBox swallows other Ctrl-combos, but this hook is a
+        // sibling of InputBox's hook, so it still sees the key.
+        if (key.ctrl && input === "d") {
+            agentRef.current?.abort();
+            exit();
+            return;
+        }
         if (key.escape && busy && !pendingApproval && !pendingFollowup) {
             agentRef.current?.abort();
         }
@@ -539,13 +660,13 @@ export function App({ initialView, initialPrompt, initialSession, }) {
         saveSettings(updated);
         agentRef.current = null;
         setView("chat");
-        setUsage({ plan: profile.plan, usagePercentage: profile.usagePercentage });
+        setUsage({ plan: profile.plan, usagePercentage: profile.usagePercentage, tieredUsage: profile.tieredUsage });
         const who = profile.user?.name || profile.user?.email;
         pushRow({ kind: "info", text: `Signed in${who ? ` as ${who}` : ""}. Ready when you are.` });
     }, [pushRow]);
     const taskLines = useMemo(() => tasks.split("\n").map((l) => l.trim()).filter(Boolean), [tasks]);
-    const inputActive = view === "chat" && !busy && !pendingApproval && !pendingFollowup && !modelPickerOpen && !resumableSessions;
-    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: [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] }) })), runningTool && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: COLORS.warning, children: [formatToolName(runningTool.name), " ", _jsx(Text, { dimColor: true, children: runningTool.summary })] }) })), 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
+    const inputActive = view === "chat" && !pendingApproval && !pendingFollowup && !modelPickerOpen && !resumableSessions;
+    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] }) })), runningTool && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: COLORS.warning, children: [formatToolName(runningTool.name), " ", _jsx(Text, { dimColor: true, children: runningTool.summary })] }) })), 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, "  ■")
                                     .replace(/^[-*]\s*\[-\]/, "  ◧")
                                     .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) => {
@@ -558,12 +679,18 @@ export function App({ initialView, initialPrompt, initialSession, }) {
                                 pushRow({ kind: "user", text: answer });
                                 pendingFollowup.resolve(answer);
                                 setPendingFollowup(null);
-                            } }) })), busy && !pendingApproval && !pendingFollowup && !streamingText && (_jsx(Box, { marginTop: 1, children: _jsx(Spinner, { label: busyLabel }) })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(InputBox, { active: inputActive, slashCommands: SLASH_COMMANDS, onSubmit: handleSubmit }), _jsx(StatusBar, { modelId: settings.model, contextTokens: contextTokens, totalCost: totalCost, state: busy ? busyLabel : "", approvalMode: approvalMode, busy: busy, title: sessionTitle, plan: usage?.plan, usagePercentage: usage?.usagePercentage })] })] }))] }));
+                            } }) })), busy && !pendingApproval && !pendingFollowup && !streamingText && (_jsx(Box, { marginTop: 1, children: _jsx(Spinner, { label: busyLabel }) })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [queuedMessages.length > 0 && (_jsxs(Box, { flexDirection: "column", paddingLeft: 1, marginBottom: 1, children: [_jsxs(Text, { dimColor: true, bold: true, children: ["Queue (", queuedMessages.length, ")"] }), queuedMessages.slice(0, 5).map((msg, i) => (_jsxs(Text, { dimColor: true, children: [i + 1, ". ", truncateForQueue(msg).replace(/\n/g, "↵")] }, i))), queuedMessages.length > 5 && (_jsxs(Text, { dimColor: true, children: [" \u2026 ", queuedMessages.length - 5, " more"] }))] })), _jsx(InputBox, { active: inputActive, slashCommands: SLASH_COMMANDS, onSubmit: handleSubmit }), _jsx(StatusBar, { modelId: settings.model, contextTokens: contextTokens, totalCost: totalCost, state: busy ? busyLabel : "", approvalMode: approvalMode, busy: busy, title: sessionTitle, plan: usage?.plan, usagePercentage: usage?.usagePercentage, tieredUsage: usage?.tieredUsage })] })] }))] }));
 }
 function tail(text, lines) {
     const all = text.split("\n").filter((l) => l.trim());
     return all.slice(-lines).join("\n");
 }
+const QUEUE_PREVIEW_LIMIT = 80;
+function truncateForQueue(text) {
+    if (text.length <= QUEUE_PREVIEW_LIMIT)
+        return text;
+    return text.slice(0, QUEUE_PREVIEW_LIMIT - 1) + "…";
+}
 function LoginSection({ onLogin }) {
     return _jsx(LoginView, { onLogin: onLogin });
 }

package/dist/ui/components/InputBox.js

@@ -147,6 +147,14 @@ export function InputBox({ active, slashCommands, onSubmit }) {
                 return;
             }
         }
+        if (key.shift && key.return) {
+            // Shift+Enter inserts a literal newline without submitting.
+            setHistoryIndex(-1);
+            const next = value.slice(0, cursor) + "\n" + value.slice(cursor);
+            setValue(next);
+            setCursor((c) => c + 1);
+            return;
+        }
         if (key.return) {
             submit(value);
             return;
@@ -198,15 +206,11 @@ export function InputBox({ active, slashCommands, onSubmit }) {
             return;
         }
         if (input) {
-            // Multi-char chunks (paste) can carry an embedded trailing newline,
-            // which should submit like pressing Enter.
-            const endsWithNewline = /[\r\n]$/.test(input);
-            const clean = input.replace(/[\r\n]+$/, "").replace(/\r/g, "\n");
+            // Multi-char chunks (paste) are inserted as-is. Newlines inside
+            // the chunk are literal newlines, not a submit signal — press
+            // Enter when you're ready to send.
+            const clean = input.replace(/\r\n?/g, "\n");
             const next = value.slice(0, cursor) + clean + value.slice(cursor);
-            if (endsWithNewline) {
-                submit(next);
-                return;
-            }
             setHistoryIndex(-1);
             setValue(next);
             setCursor((c) => c + clean.length);

package/dist/ui/components/StatusBar.js

@@ -7,12 +7,51 @@ const MODE_LABELS = {
     edits: "⏵⏵ accept edits on",
     auto: "⏵⏵⏵ auto-approve on",
 };
+function formatRelativeTime(isoStr) {
+    if (!isoStr)
+        return "???";
+    const now = Date.now();
+    const target = new Date(isoStr).getTime();
+    if (Number.isNaN(target))
+        return "???";
+    const diff = target - now;
+    if (diff <= 0)
+        return "now";
+    const sec = Math.floor(diff / 1000);
+    const min = Math.floor(sec / 60);
+    const hrs = Math.floor(min / 60);
+    const days = Math.floor(hrs / 24);
+    if (days >= 1)
+        return `${days}d`;
+    if (hrs >= 1)
+        return `${hrs}h${min % 60 > 0 ? ` ${min % 60}m` : ""}`;
+    if (min >= 1)
+        return `${min}m`;
+    return "soon";
+}
 function truncate(text, max) {
     return text.length > max ? text.slice(0, max - 1) + "…" : text;
 }
-export function StatusBar({ modelId, contextTokens, totalCost, state, approvalMode, busy, title, plan, usagePercentage, }) {
+/**
+ * Picks the most constrained window (highest percentage used) and returns a
+ * compact string like "5hr 12% · resets in 3h 15m".
+ */
+function mostConstrainedSummary(tu) {
+    const windows = [
+        ["5hr", tu.fiveHour.percentage, tu.fiveHour.resetsAt],
+        ["wk", tu.weekly.percentage, tu.weekly.resetsAt],
+        ["mo", tu.monthly.percentage, tu.monthly.resetsAt],
+    ];
+    const [label, pct, resetsAt] = windows.reduce((best, cur) => cur[1] >= best[1] ? cur : best);
+    return `${label} ${Math.round(pct)}% · resets ${formatRelativeTime(resetsAt)}`;
+}
+export function StatusBar({ modelId, contextTokens, totalCost, state, approvalMode, busy, title, plan, usagePercentage, tieredUsage, }) {
     const model = getModel(modelId);
     const contextPct = Math.min(100, Math.round((contextTokens / model.contextWindow) * 100));
-    const remaining = typeof usagePercentage === "number" ? Math.max(0, Math.round(100 - usagePercentage)) : undefined;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { justifyContent: "space-between", children: [_jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: approvalMode === "ask" ? undefined : COLORS.warning, children: MODE_LABELS[approvalMode] }), " (shift+tab to cycle)", busy && " · esc to interrupt", state ? _jsxs(Text, { color: COLORS.thinking, children: [" \u00B7 ", state] }) : null] }), _jsxs(Text, { dimColor: true, children: [title ? `${truncate(title, 32)} · ` : "", model.name, " \u00B7 ctx ", contextTokens.toLocaleString(), " (", contextPct, "%)", model.free ? " · free" : ` · $${totalCost.toFixed(4)}`] })] }), (plan || remaining !== undefined) && (_jsx(Box, { justifyContent: "flex-end", children: _jsxs(Text, { dimColor: true, children: [plan ? `${plan} plan` : "", plan && remaining !== undefined ? " · " : "", remaining !== undefined ? (_jsxs(Text, { color: remaining <= 10 ? COLORS.error : undefined, children: [remaining, "% usage remaining"] })) : null] }) }))] }));
+    const constrainedLine = tieredUsage
+        ? mostConstrainedSummary(tieredUsage)
+        : typeof usagePercentage === "number"
+            ? `${Math.round(usagePercentage)}% used`
+            : null;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { justifyContent: "space-between", children: [_jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: approvalMode === "ask" ? undefined : COLORS.warning, children: MODE_LABELS[approvalMode] }), " (shift+tab to cycle)", busy && " · esc to interrupt", state ? _jsxs(Text, { color: COLORS.thinking, children: [" \u00B7 ", state] }) : null] }), _jsxs(Text, { dimColor: true, children: [title ? `${truncate(title, 32)} · ` : "", model.name, " \u00B7 ctx ", contextTokens.toLocaleString(), " (", contextPct, "%)", model.free ? " · free" : ` · $${totalCost.toFixed(4)}`] })] }), (plan || constrainedLine) && (_jsx(Box, { justifyContent: "flex-end", children: _jsxs(Text, { dimColor: true, children: [plan && constrainedLine ? " · " : "", constrainedLine] }) }))] }));
 }

package/dist/utils/updateCheck.js

@@ -0,0 +1,162 @@
+import { execFile, spawn } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { promisify } from "node:util";
+import { getConfigDir } from "../config/settings.js";
+const execFileAsync = promisify(execFile);
+/** Network timeout when hitting the npm registry. Kept short so it never blocks startup. */
+const REGISTRY_TIMEOUT_MS = 3_000;
+/** Don't re-hit npm more than once per TTL window. */
+const CACHE_TTL_MS = 60 * 60 * 1_000; // 1 hour
+/** Hit the npm registry to learn what the latest published version is. */
+export async function fetchLatestNpmVersion(pkg, timeoutMs = REGISTRY_TIMEOUT_MS) {
+    // encodeURIComponent turns "@matterailab/orbcode" into "@matterailab%2Forbcode",
+    // which is the form the registry URL expects for scoped packages.
+    const url = `https://registry.npmjs.org/${encodeURIComponent(pkg)}/latest`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, {
+            signal: controller.signal,
+            headers: { accept: "application/json" },
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return typeof data.version === "string" ? data.version : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Compare two semver strings (X.Y.Z, optionally with a pre-release suffix).
+ * Returns -1 if a < b, 0 if equal, 1 if a > b. Non-numeric segments fall back
+ * to lexicographic compare so "0.1.4-beta" sorts before "0.1.4".
+ */
+export function compareVersions(a, b) {
+    const [aMain, aPre] = splitVersion(a);
+    const [bMain, bPre] = splitVersion(b);
+    for (let i = 0; i < 3; i++) {
+        const ai = aMain[i] ?? 0;
+        const bi = bMain[i] ?? 0;
+        if (ai !== bi)
+            return ai < bi ? -1 : 1;
+    }
+    // A version with no pre-release is greater than one with one.
+    if (aPre === bPre)
+        return 0;
+    if (aPre === "")
+        return 1;
+    if (bPre === "")
+        return -1;
+    return aPre < bPre ? -1 : 1;
+}
+function splitVersion(v) {
+    const [main, pre = ""] = v.split("-", 2);
+    const parts = main.split(".").map((p) => {
+        const n = Number.parseInt(p, 10);
+        return Number.isFinite(n) ? n : 0;
+    });
+    while (parts.length < 3)
+        parts.push(0);
+    return [parts, pre];
+}
+function getCachePath() {
+    return path.join(getConfigDir(), "update-check.json");
+}
+function readCache() {
+    try {
+        const raw = fs.readFileSync(getCachePath(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.checkedAt !== "number")
+            return null;
+        return { checkedAt: parsed.checkedAt, latest: parsed.latest ?? null };
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(latest) {
+    try {
+        const dir = getConfigDir();
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(getCachePath(), JSON.stringify({ checkedAt: Date.now(), latest }), { mode: 0o600 });
+    }
+    catch {
+        // best-effort; a missing cache just means we'll hit the registry again next launch
+    }
+}
+/**
+ * Resolve whether a newer version is available, using a short-lived cache so
+ * we don't hammer the npm registry on every launch.
+ */
+export async function getUpdateInfo(pkg, current) {
+    const cached = readCache();
+    if (cached && Date.now() - cached.checkedAt < CACHE_TTL_MS) {
+        return makeResult(current, cached.latest);
+    }
+    const latest = await fetchLatestNpmVersion(pkg);
+    if (latest !== null)
+        writeCache(latest);
+    return makeResult(current, latest);
+}
+function makeResult(current, latest) {
+    if (latest === null) {
+        return { current, latest: null, updateAvailable: false, unknown: true };
+    }
+    return {
+        current,
+        latest,
+        updateAvailable: compareVersions(current, latest) < 0,
+        unknown: false,
+    };
+}
+/** Invalidate the cached "latest" so the next launch re-checks. */
+export function clearUpdateCache() {
+    try {
+        fs.unlinkSync(getCachePath());
+    }
+    catch {
+        // ignore
+    }
+}
+/** Run `npm install -g <pkg>@latest` and return the exit code (0 = success). */
+export function runNpmUpdate(pkg) {
+    return new Promise((resolve) => {
+        // On Windows, npm is a .cmd shim; spawning it directly fails without shell:true.
+        const isWin = process.platform === "win32";
+        const child = spawn("npm", ["install", "-g", `${pkg}@latest`], {
+            stdio: "inherit",
+            shell: isWin,
+        });
+        child.on("error", () => resolve(1));
+        child.on("close", (code) => resolve(typeof code === "number" ? code : 1));
+    });
+}
+/**
+ * Detect whether the running CLI is inside a global npm install, so the
+ * update command can surface a friendlier message for local/dev installs.
+ */
+export function isGlobalInstall() {
+    // When installed via `npm i -g @matterailab/orbcode`, the entrypoint lives
+    // somewhere like <global root>/node_modules/@matterailab/orbcode/...
+    const here = process.argv[1] || "";
+    return /node_modules[\\/]@matterailab[\\/]orbcode/.test(here);
+}
+/** Best-effort: run `npm root -g` so we can show the install location. */
+export async function getGlobalInstallRoot() {
+    try {
+        const { stdout } = await execFileAsync("npm", ["root", "-g"], {
+            shell: process.platform === "win32",
+        });
+        const trimmed = stdout.trim();
+        return trimmed ? trimmed : null;
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterailab/orbcode",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "OrbCode CLI — agentic coding in your terminal, powered by Axon models by MatterAI",
   "type": "module",
   "bin": {
@@ -40,7 +40,7 @@
     "ink": "^5.2.1",
     "open": "^10.1.0",
     "openai": "^4.78.0",
-    "picomatch": "^4.0.2",
+    "picomatch": "^4.0.4",
     "react": "^18.3.1"
   },
   "devDependencies": {