@orbit-intelligence/orbit-agent 0.3.12 → 0.3.13

package/dist/prompts/system.js

@@ -56,6 +56,11 @@ ${skillsBlock}
 4. Verify. Run the project's checks yourself before claiming success: \`npm test\`, \`node --test dist/tests/*.test.js\`, \`npm run typecheck\`, \`npm run build\` — as applicable. NEVER assume test commands; find them in package.json.
 5. Reflect. After a tool returns, read the result, note in one line what it tells you and what you're doing next, then decide: more work, or final answer. Keep working and iterating until the task is verifiably done — you decide when it is done, not a fixed number of steps. If a step yields unexpected results, adapt and continue.
 
+# Narration order (output protocol)
+- Every message that calls a tool MUST begin with a short narration BEFORE the first tool call, in the same message — one sentence stating what the imminent call will do and why. Never lead a message with a tool call, and never narrate an action in a way that implies you are about to do something you already did.
+- Say the intent, then act. For example: "I'll list the directory to see the layout." then call list_dir. Do not list the directory first and explain afterwards.
+- Batch: when several calls are truly independent, put them in one message instead of one call per round trip. Fewer round trips = faster for the user.
+
 # Tool discipline
 - Explore with glob/grep before reading whole files. Use absolute paths with file tools.
 - run_shell: one focused command per call. Before commands that modify files or system state, give a brief explanation of purpose and impact. Avoid interactive commands that can hang; use non-interactive flags instead.
@@ -65,7 +70,7 @@ ${skillsBlock}
 
 # Output style
 - Be concise and direct. Keep responses short unless the user asks for detail.
-- Show your working across steps: a one-line intent before a tool call and a one-line finding/next step after each tool result. Do not recap the whole session at the end — just give the final answer.
+- Show your working across steps: after a tool result, give a one-line finding/next step. Do not recap the whole session at the end — just give the final answer.
 - Use Markdown for structure. Quote exact paths (path:line) when referring to code.
 - No emojis unless asked. Do not add code explanations unless asked.
 

package/dist/src/core/agent/agent-loop.js

@@ -149,6 +149,11 @@ export class AgentLoop {
                     return { turns: this.turnCount, error: err?.message ?? String(err) };
                 }
             }
+            // The narration is fully streamed and tools haven't executed yet. Let the
+            // TUI reveal the whole message (snap the typewriter to the end) so the
+            // text sits above the tool rows BEFORE the tools start running — the
+            // user should see "intent first, then action".
+            bus.emit('onAssistantGenerationDone', asstMsg);
             asstMsg.streaming = false;
             asstMsg.reasoningOpen = (asstMsg.reasoning?.length ?? 0) > 0;
             asstMsg.toolCalls = toolCalls;

package/dist/src/core/orchestration/runtime.js

@@ -10,6 +10,7 @@ const FORWARDED_EVENTS = [
     'onToolStart',
     'onToolUpdate',
     'onToolEnd',
+    'onAssistantGenerationDone',
     'onAssistantEnd',
     'onError',
     'onRoute',

package/dist/src/tui/app.js

@@ -126,6 +126,13 @@ export class TuiApp {
         });
         this.bus.on('onToolUpdate', (call) => this.applyToolState(call));
         this.bus.on('onToolEnd', (call) => this.applyToolState(call));
+        // Narration for this message is fully streamed and tools have not run yet.
+        // Flush the reveal so the text is fully visible above the tool rows before
+        // the tools start — users see the intent, then the action.
+        this.bus.on('onAssistantGenerationDone', () => {
+            this.store.revealAll();
+            this.store.refresh();
+        });
         this.bus.on('onAssistantEnd', (msg) => {
             this.store.streaming = false;
             this.store.cancelArmed = false;

package/dist/src/tui/store.js

@@ -22,8 +22,8 @@ const SLASH_COMMANDS = [
 // Word-to-word reveal pacing. Servers stream sentence-sized chunks; the reveal
 // cursor films their contents out at a steady character rate, word-aligned, so
 // output reads "word by word" instead of "sentence by sentence".
-const REVEAL_CPS = 30; // chars/sec baseline (~6-8 words/sec) — brisk typing feel
-const REVEAL_LAG_CAP = 400; // caught-up threshold -> above it, drain 3x faster
+const REVEAL_CPS = 60; // chars/sec baseline (~12 words/sec) — brisk typing feel
+const REVEAL_LAG_CAP = 200; // caught-up threshold -> above it, drain 3x faster
 export class AppStore {
     messages = [];
     streaming = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbit-intelligence/orbit-agent",
-  "version": "0.3.12",
+  "version": "0.3.13",
   "description": "orbit — a premium pure-TypeScript coding agent for Termux and desktop terminals, powered by Orbit X.",
   "type": "module",
   "license": "UNLICENSED",