agent-from-zero 0.34.1 → 0.34.2

package/dist/agent.js

@@ -9,7 +9,7 @@ import { buildSystemMessage } from "./prompt.js"; // the constitution + optional
 import { forgetFilesExcept, registerExternalTool } from "./tools.js"; // file-state reset + tool registration
 import { compactHistory, estimateHistoryTokens, COMPACT_AT } from "./context.js"; // for the manual /compact command
 import { newSessionId, saveSession, latestSession, listSessions, loadSession, setSessionTitle } from "./session.js"; // conversation persistence (project-local) + the /resume picker
-import { generateSessionTitle } from "./title.js"; // concise session name, generated after the first message
+import { generateSessionTitle, setTerminalTitle } from "./title.js"; // concise session name, generated after the first message + the terminal tab that shows it
 import { initTelemetry, emit, statsReport } from "./telemetry.js"; // local-only event log + /stats
 import { runHooks } from "./hooks.js"; // SessionStart lifecycle hook
 import { connectMcpServers, listMcpServers, mcpActionsFor, runMcpAction } from "./mcp.js"; // external tool servers (MCP) + /mcp
@@ -139,18 +139,22 @@ async function main() {
     // -r / --resume picks up the most recent one. The system message is NOT
     // restored from disk — it is rebuilt fresh, because AGENT.md may have changed.
     let sessionId = newSessionId(); // this session's identity (and file name)
+    let initialTitle; // only a resumed session has one already
     const sessionStartedAt = Date.now(); // for the status line's elapsed clock
     if (argv.includes("-r") || argv.includes("--resume")) {
         const prev = latestSession(); // newest snapshot in this directory, if any
         if (prev) {
             messages.push(...prev.messages); // the old conversation joins the fresh constitution
             sessionId = prev.id; // keep appending to the same session file
+            initialTitle = prev.title;
             console.log(chalk.dim(`(resumed session ${prev.id} — ${prev.messages.length} messages; files must be re-read before editing)`));
         }
         else {
             console.log(chalk.dim("(no previous session here — starting fresh)")); // resume with nothing to resume is not an error
         }
     }
+    if (printTask === null)
+        setTerminalTitle(initialTitle); // name the terminal tab from the start (a one-shot -p run leaves the tab alone)
     initTelemetry(sessionId); // arm the local event log (no-op under MINI_AGENT_NO_TELEMETRY=1)
     emit("agent_session_start", { mode: printTask !== null ? "print" : "repl" }); // how this session was started
     // Connect to any configured MCP servers and register their tools. This must
@@ -524,6 +528,7 @@ async function main() {
                 sessionId = newSessionId(); // a fresh conversation is a fresh session file
                 titleAttempted = false; // a fresh session gets its own title on its first message
                 pendingTitle = undefined;
+                setTerminalTitle(undefined); // the tab no longer describes the old conversation
                 console.log(chalk.dim("(history cleared)")); // confirm the reset
                 return true;
             case "/todos": {
@@ -647,6 +652,7 @@ async function main() {
                 sessionId = chosen.id; // keep appending to the resumed session's file
                 titleAttempted = false; // a resumed session without a title gets one on its next message
                 pendingTitle = chosen.title;
+                setTerminalTitle(chosen.title ?? sessions[idx].title.slice(0, 40)); // the tab follows the resumed session (raw prompt if never titled)
                 forgetFilesExcept([]); // a resumed conversation must re-read files before editing them
                 clearUndo(); // the previous session's writes are not ours to undo
                 clearTodos(); // the resumed task starts without the old session's stale plan
@@ -782,6 +788,7 @@ async function main() {
                     if (title) {
                         pendingTitle = title;
                         setSessionTitle(sessionId, title);
+                        setTerminalTitle(title); // and rename the terminal tab, like Claude Code does
                     }
                 })
                     .catch(() => { });

package/dist/ink/app.js

@@ -18,7 +18,7 @@ import { expandMentions } from "../mentions.js"; // @file mentions → attach fi
 import { normalizeDroppedPaths } from "../drop.js"; // drag-and-drop a file → its absolute path in the input
 import { cronItemsPending, consumeCronQueue, cronTriggerContent } from "../cron.js"; // cron scheduler (Day s14): fire scheduled jobs autonomously while idle
 import { newSessionId, saveSession, listSessions, loadSession, setSessionTitle } from "../session.js";
-import { generateSessionTitle } from "../title.js"; // concise session name, generated after the first message
+import { generateSessionTitle, setTerminalTitle } from "../title.js"; // concise session name, generated after the first message + the terminal tab that shows it
 import { isPlanMode, setPlanMode } from "../permissions.js";
 import { findSkill, skillInstructions } from "../skills.js";
 import { extractMemories } from "../memory.js";
@@ -125,6 +125,11 @@ export function App({ session, runTurn }) {
         const id = setInterval(() => setTick((t) => t + 1), 1000);
         return () => clearInterval(id);
     }, []);
+    // Name the terminal tab from the first frame: the resumed session's title,
+    // or just "mini-agent" until the first message earns a real one.
+    useEffect(() => {
+        setTerminalTitle(session.initialTitle);
+    }, [session.initialTitle]);
     // Open a one-of-N menu and run `onChoose` with the picked index (-1 = cancel).
     const openSelect = (header, options, onChoose) => {
         setMenuSel(0);
@@ -242,6 +247,7 @@ export function App({ session, runTurn }) {
                     if (title) {
                         pendingTitle.current = title;
                         setSessionTitle(sessionId, title);
+                        setTerminalTitle(title); // and rename the terminal tab, like Claude Code does
                     }
                 })
                     .catch(() => { });
@@ -372,6 +378,7 @@ export function App({ session, runTurn }) {
                 setSessionId(newSessionId());
                 titleAttempted.current = false; // a fresh session gets its own title on its first message
                 pendingTitle.current = undefined;
+                setTerminalTitle(undefined); // the tab no longer describes the old conversation
                 note(chalk.dim("(history cleared)"));
                 return true;
             case "/plan":
@@ -422,6 +429,7 @@ export function App({ session, runTurn }) {
                     setSessionId(chosen.id);
                     titleAttempted.current = false; // a resumed session without a title gets one on its next message
                     pendingTitle.current = chosen.title;
+                    setTerminalTitle(chosen.title ?? sessions[i].title.slice(0, 40)); // the tab follows the resumed session (raw prompt if never titled)
                     forgetFilesExcept([]);
                     clearUndo();
                     clearTodos();

package/dist/ink/setup.js

@@ -34,12 +34,14 @@ export async function buildInkSession(opts = {}) {
     const messages = [{ role: "system", content: systemMessage }];
     const notices = [];
     let sessionId = newSessionId();
+    let initialTitle; // only a resumed session has one already
     const startedAt = Date.now();
     if (opts.resume) {
         const prev = latestSession();
         if (prev) {
             messages.push(...prev.messages);
             sessionId = prev.id; // keep appending to the same file
+            initialTitle = prev.title;
             notices.push(`(resumed session ${prev.id} — ${prev.messages.length} messages; files must be re-read before editing)`);
         }
         else {
@@ -97,6 +99,7 @@ export async function buildInkSession(opts = {}) {
         messages,
         systemMessage,
         initialSessionId: sessionId,
+        initialTitle,
         startedAt,
         costMeter,
         skills,

package/dist/title.js

@@ -3,6 +3,26 @@
 // producing a 3-7 word sentence-case title, stored as the session's aiTitle).
 // It runs once, fire-and-forget, after the first real user message, so it never
 // blocks the turn and a failure silently falls back to the raw first prompt.
+//
+// The title has two consumers: the /resume picker (read from the session file)
+// and the TERMINAL TAB — the same OSC escape Claude Code uses to rename its tab
+// to "✳ <title>", so a row of sessions is tellable apart in the terminal's
+// sidebar/tabs without opening each one.
+const TAB_PREFIX = "✳ "; // the glyph Claude Code puts before its tab titles — familiar to anyone who has both open
+// The OSC 0 sequence that sets a terminal's window/tab title. Pure so the
+// escape framing is unit-testable; newlines and control bytes are stripped so a
+// malicious title can't inject a second escape.
+export function terminalTitleSequence(title) {
+    const safe = title.replace(/[\x00-\x1f\x7f]/g, " ").replace(/\s+/g, " ").trim();
+    return `\x1b]0;${safe}\x07`;
+}
+// Rename the terminal tab. Silent when stdout isn't a terminal (pipes, tests,
+// print mode) — an escape sequence in a log file is just noise.
+export function setTerminalTitle(title) {
+    if (!process.stdout.isTTY)
+        return;
+    process.stdout.write(terminalTitleSequence(title ? `${TAB_PREFIX}${title}` : "mini-agent"));
+}
 // The prompt is quoted inside <prompt> tags and the system message says so
 // explicitly: sent bare, a chat-tuned model reads "有没有app能…?" as a question
 // for IT and answers it — the "title" then becomes the first line of an answer.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-from-zero",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Build a Claude Code-style CLI agent from scratch, with AI as your pair programmer — companion code for a 10-day tutorial (DeepSeek by default, any OpenAI-compatible model)",
   "type": "module",
   "bin": {