@sofer_agent/cli 0.1.0 → 0.2.1

package/dist/bin.js

@@ -9,9 +9,27 @@ function printHelp() {
   sofer            chat with your agent (default)
   sofer init       mint the agent + provision Walrus memory
   sofer info       print on-chain agent state
+  sofer setup      print the .env template to configure
   sofer help       show this help
 
-Reads config + secrets from .env (or the environment).`);
+Reads config + secrets from a .env file or the environment.`);
+}
+function printSetup() {
+    console.log(`# Copy this into a .env file in your project directory, then fill in:
+#  - ANTHROPIC_API_KEY (your Claude API key)
+#  - SOFER_SUI_SECRET_KEY (or let \`sofer init\` generate one)
+#
+# Then run: sofer init
+
+# --- Sui chain ---
+SUI_NETWORK=testnet
+SUI_RPC_URL=https://fullnode.testnet.sui.io:443
+SOFER_PACKAGE_ID=0xd5291ac6fd0de787f9fe0bc16c677ef5bafffd920936a05b14e7a8a142e46434
+SOFER_AGENT_OBJECT_ID=
+
+# --- Brain (Claude) ---
+ANTHROPIC_API_KEY=
+SOFER_MODEL=claude-opus-4-8`);
 }
 async function main() {
     loadDotenv();
@@ -26,6 +44,9 @@ async function main() {
         case "info":
             await infoCommand();
             break;
+        case "setup":
+            printSetup();
+            break;
         case "help":
         case "-h":
         case "--help":
@@ -38,7 +59,11 @@ async function main() {
     }
 }
 main().catch((e) => {
-    console.error(e instanceof Error ? e.message : String(e));
+    const msg = e instanceof Error ? e.message : String(e);
+    console.error(msg);
+    if (msg.includes("SOFER_PACKAGE_ID") || msg.includes("SOFER_SUI_SECRET_KEY") || msg.includes("ANTHROPIC_API_KEY")) {
+        console.error("\nFirst time? Run `sofer setup` for the .env template, then `sofer init`.");
+    }
     process.exit(1);
 });
 //# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CACT;;;;;;;uDAOmD,CACpD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,UAAU,EAAE,CAAC;IACb,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACtC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,MAAM,CAAC;QACZ,KAAK,IAAI,CAAC;QACV,KAAK,QAAQ;YACX,SAAS,EAAE,CAAC;YACZ,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;YAC3C,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CACT;;;;;;;;4DAQwD,CACzD,CAAC;AACJ,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,CAAC,GAAG,CACT;;;;;;;;;;;;;;4BAcwB,CACzB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,UAAU,EAAE,CAAC;IACb,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACtC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,OAAO;YACV,UAAU,EAAE,CAAC;YACb,MAAM;QACR,KAAK,MAAM,CAAC;QACZ,KAAK,IAAI,CAAC;QACV,KAAK,QAAQ;YACX,SAAS,EAAE,CAAC;YACZ,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;YAC3C,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAClH,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/chat.d.ts

@@ -1,3 +1,3 @@
-/** Interactive chat REPL with the agent. */
+/** Interactive chat TUI with a stats sidebar. */
 export declare function chatCommand(): Promise<void>;
 //# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAIA,4CAA4C;AAC5C,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAwCjD"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAIA,iDAAiD;AACjD,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBjD"}

package/dist/chat.js

@@ -1,43 +1,21 @@
-import readline from "node:readline";
-import { loadConfig, SoferAgent } from "@sofer_agent/core";
+import { SoferAgent, loadConfig } from "@sofer_agent/core";
 import { requireSecrets } from "./secrets.js";
-/** Interactive chat REPL with the agent. */
+import { SoferTui } from "./tui.js";
+/** Interactive chat TUI with a stats sidebar. */
 export async function chatCommand() {
     const config = loadConfig();
     const agent = await SoferAgent.create(config, requireSecrets());
-    console.log(`\x1b[1m${agent.name}\x1b[0m ready — ${agent.address}`);
-    console.log(`model: ${config.brain.model}   ·   type a message, or /exit to quit\n`);
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-        prompt: "\x1b[36myou>\x1b[0m ",
-    });
-    const label = `\x1b[32m${agent.name.toLowerCase()}>\x1b[0m`;
-    rl.prompt();
-    rl.on("line", async (line) => {
-        const text = line.trim();
-        if (text === "/exit" || text === "/quit") {
-            rl.close();
-            return;
-        }
-        if (!text) {
-            rl.prompt();
-            return;
-        }
+    const tui = new SoferTui(agent, config);
+    await tui.run(async (line) => {
         try {
-            const reply = await agent.chat(text);
-            console.log(`${label} ${reply}\n`);
+            const { text, turnUsage } = await agent.chat(line);
+            tui.addMessage("agent", text);
+            tui.setUsage(turnUsage.inputTokens, turnUsage.outputTokens);
         }
         catch (e) {
-            console.error(`\x1b[31merror:\x1b[0m ${e instanceof Error ? e.message : String(e)}\n`);
+            tui.addMessage("error", e instanceof Error ? e.message : String(e));
         }
-        rl.prompt();
-    });
-    await new Promise((resolve) => {
-        rl.on("close", () => {
-            console.log("bye.");
-            resolve();
-        });
+        tui.render();
     });
 }
 //# sourceMappingURL=chat.js.map

package/dist/chat.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat.js","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,4CAA4C;AAC5C,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IAEhE,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,mBAAmB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,KAAK,2CAA2C,CAAC,CAAC;IAErF,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,sBAAsB;KAC/B,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,WAAW,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;IAC5D,EAAE,CAAC,MAAM,EAAE,CAAC;IAEZ,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACzC,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,EAAE,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,IAAI,KAAK,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzF,CAAC;QACD,EAAE,CAAC,MAAM,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IAEhE,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAExC,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnD,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC9B,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,GAAG,CAAC,MAAM,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../src/info.ts"],"names":[],"mappings":"AAEA,wCAAwC;AACxC,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA0CjD"}
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../src/info.ts"],"names":[],"mappings":"AAQA,wCAAwC;AACxC,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA0CjD"}

package/dist/info.js

@@ -1,4 +1,4 @@
-import { AgentClient, keypairFromSecret, loadConfig, makeSuiClient, suiBalance } from "@sofer_agent/core";
+import { AgentClient, keypairFromSecret, loadConfig, makeSuiClient, suiBalance, } from "@sofer_agent/core";
 /** Print the agent's on-chain state. */
 export async function infoCommand() {
     const config = loadConfig();

package/dist/info.js.map

@@ -1 +1 @@
-{"version":3,"file":"info.js","sourceRoot":"","sources":["../src/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE1G,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACtD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IAED,IAAI,OAA2B,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAChD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QAC7E,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,CAAC;IAED,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,SAAS;QACzB,aAAa,EAAE,CAAC,CAAC,EAAE;QACnB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,WAAW,EAAE,CAAC,CAAC,KAAK;QACpB,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACnD,OAAO;KACR,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../src/info.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACtD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IAED,IAAI,OAA2B,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAChD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QAC7E,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,CAAC;IAED,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,SAAS;QACzB,aAAa,EAAE,CAAC,CAAC,EAAE;QACnB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,WAAW,EAAE,CAAC,CAAC,KAAK;QACpB,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACnD,OAAO;KACR,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;AACJ,CAAC"}

package/dist/tui.d.ts

@@ -0,0 +1,49 @@
+import type { SoferConfig } from "@sofer_agent/core";
+import type { SoferAgent } from "@sofer_agent/core";
+interface ChatLine {
+    role: "you" | "agent" | "error";
+    text: string;
+}
+export interface TuiState {
+    messages: ChatLine[];
+    lastTurnIn: number;
+    lastTurnOut: number;
+}
+export declare class SoferTui {
+    private readonly agent;
+    private readonly config;
+    private state;
+    private inputBuf;
+    private cursor;
+    private rl;
+    private columns;
+    private rows;
+    private chatH;
+    private chatW;
+    private scrollOff;
+    private resolve;
+    private onLine;
+    constructor(agent: SoferAgent, config: SoferConfig);
+    get width(): number;
+    get height(): number;
+    private measure;
+    addMessage(role: ChatLine["role"], text: string): void;
+    setUsage(lastTurnIn: number, lastTurnOut: number): void;
+    /** Start the interactive TUI loop. Returns when the user exits. */
+    run(onLine: (line: string) => Promise<void>): Promise<void>;
+    private shutdown;
+    private handleInput;
+    private submit;
+    private handleResize;
+    /** Reset cursor, clear, redraw everything. */
+    render(): void;
+    private buildFrame;
+    private wrapLine;
+    private pad;
+    private blank;
+    private sidebarRow;
+    private buildSidebar;
+    private shortModel;
+}
+export {};
+//# sourceMappingURL=tui.d.ts.map

package/dist/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD,UAAU,QAAQ;IAChB,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,QAAQ;IAcjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAdzB,OAAO,CAAC,KAAK,CAA6D;IAC1E,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,EAAE,CAAmC;IAC7C,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAyC;gBAGpC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,WAAW;IAGtC,IAAI,KAAK,WAER;IACD,IAAI,MAAM,WAET;IAED,OAAO,CAAC,OAAO;IAOf,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAItD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAKvD,mEAAmE;IAC7D,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAejE,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,WAAW,CAsCjB;YAEY,MAAM;IAoBpB,OAAO,CAAC,YAAY,CAGlB;IAEF,8CAA8C;IAC9C,MAAM,IAAI,IAAI;IAQd,OAAO,CAAC,UAAU;IA8ClB,OAAO,CAAC,QAAQ;IA0BhB,OAAO,CAAC,GAAG;IAQX,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,UAAU;CAQnB"}

package/dist/tui.js

@@ -0,0 +1,265 @@
+const SIDEBAR_W = 28;
+const MIN_CHAT_W = 30;
+export class SoferTui {
+    agent;
+    config;
+    state = { messages: [], lastTurnIn: 0, lastTurnOut: 0 };
+    inputBuf = "";
+    cursor = 0;
+    rl = null;
+    columns = 80;
+    rows = 24;
+    chatH = 20;
+    chatW = 50;
+    scrollOff = 0;
+    resolve = null;
+    onLine = null;
+    constructor(agent, config) {
+        this.agent = agent;
+        this.config = config;
+    }
+    get width() {
+        return this.columns;
+    }
+    get height() {
+        return this.rows;
+    }
+    measure() {
+        this.columns = process.stdout.columns ?? 80;
+        this.rows = process.stdout.rows ?? 24;
+        this.chatW = Math.max(MIN_CHAT_W, this.columns - SIDEBAR_W - 1);
+        this.chatH = this.rows - 3;
+    }
+    addMessage(role, text) {
+        this.state.messages.push({ role, text });
+    }
+    setUsage(lastTurnIn, lastTurnOut) {
+        this.state.lastTurnIn = lastTurnIn;
+        this.state.lastTurnOut = lastTurnOut;
+    }
+    /** Start the interactive TUI loop. Returns when the user exits. */
+    async run(onLine) {
+        this.onLine = onLine;
+        this.measure();
+        if (process.stdin.isTTY)
+            process.stdin.setRawMode?.(true);
+        process.stdin.on("data", this.handleInput);
+        process.stdout.on("resize", this.handleResize);
+        process.on("SIGWINCH", this.handleResize);
+        this.render();
+        return new Promise((resolve) => {
+            this.resolve = resolve;
+        });
+    }
+    shutdown() {
+        process.stdin.setRawMode?.(false);
+        process.stdin.removeAllListeners("data");
+        process.stdout.removeAllListeners("resize");
+        process.removeAllListeners("SIGWINCH");
+        this.render(); // final render in normal mode
+        process.stdout.write("\n");
+        this.resolve?.();
+    }
+    // ── Input handling ──────────────────────────────────────────────────────
+    handleInput = (data) => {
+        const str = data.toString();
+        for (const ch of str) {
+            const code = ch.charCodeAt(0);
+            if (code === 3) {
+                process.exit(0);
+            } // Ctrl-C
+            if (code === 4 && this.inputBuf.length === 0) {
+                this.shutdown();
+                return;
+            } // Ctrl-D on empty
+            if (code === 13) {
+                this.submit();
+                return;
+            } // Enter
+            if (code === 127) {
+                // Backspace
+                if (this.cursor > 0) {
+                    this.inputBuf =
+                        this.inputBuf.slice(0, this.cursor - 1) + this.inputBuf.slice(this.cursor);
+                    this.cursor--;
+                }
+                this.render();
+                return;
+            }
+            if (code === 27 && this.inputBuf.length > 0) {
+                // Escape clears input
+                this.inputBuf = "";
+                this.cursor = 0;
+                this.render();
+                return;
+            }
+            if (ch >= " ") {
+                this.inputBuf = this.inputBuf.slice(0, this.cursor) + ch + this.inputBuf.slice(this.cursor);
+                this.cursor++;
+                this.render();
+            }
+        }
+    };
+    async submit() {
+        const line = this.inputBuf.trim();
+        this.inputBuf = "";
+        this.cursor = 0;
+        if (!line) {
+            this.render();
+            return;
+        }
+        if (line === "/exit" || line === "/quit") {
+            this.shutdown();
+            return;
+        }
+        this.addMessage("you", line);
+        this.scrollOff = 0; // auto-scroll to latest
+        this.render();
+        await this.onLine?.(line);
+    }
+    // ── Terminal rendering ──────────────────────────────────────────────────
+    handleResize = () => {
+        this.measure();
+        this.render();
+    };
+    /** Reset cursor, clear, redraw everything. */
+    render() {
+        this.measure();
+        const out = process.stdout;
+        out.write("\x1b[?25l"); // hide cursor
+        out.write(this.buildFrame());
+        out.write("\x1b[?25h"); // show cursor
+    }
+    buildFrame() {
+        const { columns, rows, chatW, chatH } = this;
+        const rightW = columns - chatW - 1; // border column
+        let buf = "\x1b[H"; // cursor to top-left
+        // ── Body ──────────────────────────────────────────────────────────────
+        // We draw row by row. Each row: chat area | border | sidebar
+        const msgs = this.state.messages;
+        const wrappedLines = msgs.flatMap((m) => this.wrapLine(m, chatW));
+        const totalLines = wrappedLines.length;
+        const maxScroll = Math.max(0, totalLines - chatH);
+        if (this.scrollOff > maxScroll)
+            this.scrollOff = maxScroll;
+        if (this.scrollOff < 0)
+            this.scrollOff = 0;
+        const visible = wrappedLines.slice(this.scrollOff, this.scrollOff + chatH);
+        for (let r = 0; r < chatH; r++) {
+            const line = visible[r];
+            buf += line ? this.pad(line, chatW) : this.blank(chatW);
+            if (r === 0)
+                buf += "┬";
+            else if (r === chatH - 1)
+                buf += "┴";
+            else
+                buf += "│";
+            buf += this.sidebarRow(r, chatH, rightW);
+            buf += "\n";
+        }
+        // ── Divider ───────────────────────────────────────────────────────────
+        buf += `${"─".repeat(chatW)}┴${"─".repeat(rightW)}\n`;
+        // ── Input line ────────────────────────────────────────────────────────
+        const prefix = "\x1b[36myou>\x1b[0m ";
+        const prefixW = 4;
+        const maxInputW = columns - prefixW - 1;
+        let typed = this.inputBuf;
+        if (typed.length > maxInputW) {
+            const start = typed.length - maxInputW;
+            typed = typed.slice(start);
+        }
+        buf += `${prefix}${typed}\x1b[K`; // clear to end of line
+        // Place cursor at end of input
+        const cursorCol = prefixW + Math.min(this.cursor, maxInputW);
+        buf += `\x1b[${chatH + 2};${cursorCol}H`;
+        return buf;
+    }
+    wrapLine(msg, width) {
+        const label = msg.role === "you"
+            ? "\x1b[36myou>\x1b[0m "
+            : msg.role === "agent"
+                ? `\x1b[32m${this.agent.name.toLowerCase()}>\x1b[0m `
+                : "\x1b[31merror>\x1b[0m ";
+        const content = msg.text;
+        const full = label + content;
+        if (full.length <= width)
+            return [full];
+        // simple word-wrap
+        const lines = [];
+        let current = label;
+        const words = content.split(" ");
+        for (const word of words) {
+            if (current.length + 1 + word.length <= width) {
+                current += (current === label ? "" : " ") + word;
+            }
+            else {
+                if (current.length > label.length)
+                    lines.push(current);
+                current = `  ${word}`; // indent continuation
+            }
+        }
+        if (current.length > label.length)
+            lines.push(current);
+        return lines.length > 0 ? lines : [full];
+    }
+    pad(s, w) {
+        // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape stripping
+        const ansiRe = /\x1b\[\d*;?\d*m/g;
+        const stripped = s.replace(ansiRe, "");
+        const padW = Math.max(0, w - stripped.length);
+        return s + " ".repeat(padW);
+    }
+    blank(w) {
+        return " ".repeat(w);
+    }
+    // ── Sidebar ─────────────────────────────────────────────────────────────
+    sidebarRow(row, total, width) {
+        const innerW = width - 2; // left & right padding
+        const lines = this.buildSidebar(innerW);
+        // center the sidebar content vertically
+        const gap = Math.max(0, total - lines.length);
+        const topPad = Math.floor(gap / 2);
+        const idx = row - topPad;
+        if (idx < 0 || idx >= lines.length)
+            return " ".repeat(width);
+        const line = lines[idx];
+        if (!line)
+            return " ".repeat(width);
+        return ` ${this.pad(line, innerW)} `;
+    }
+    buildSidebar(width) {
+        const { agent, config, state } = this;
+        const addr = `${agent.address.slice(0, 6)}...${agent.address.slice(-4)}`;
+        const totalIn = agent.usage.tokens.inputTokens;
+        const totalOut = agent.usage.tokens.outputTokens;
+        const cost = agent.usage.costUsd.toFixed(4);
+        return [
+            `\x1b[1m${agent.name}\x1b[0m`,
+            "─".repeat(width),
+            `Model: ${this.shortModel(config.brain.model)}`,
+            `Max out:  ${config.brain.maxOutputTokens}`,
+            "",
+            `Turn in:  ${state.lastTurnIn}`,
+            `Turn out: ${state.lastTurnOut}`,
+            `Total in: ${totalIn}`,
+            `Total out:${totalOut}`,
+            `Cost:     \x1b[33m$${cost}\x1b[0m`,
+            "",
+            `Addr: ${addr}`,
+            `Network: ${config.network}`,
+        ];
+    }
+    shortModel(model) {
+        const m = model.toLowerCase();
+        if (m.includes("sonnet"))
+            return "Sonnet 4";
+        if (m.includes("haiku"))
+            return "Haiku 3.5";
+        if (m.includes("opus"))
+            return "Opus 4";
+        if (m.includes("fable"))
+            return "Fable 5";
+        return model;
+    }
+}
+//# sourceMappingURL=tui.js.map

package/dist/tui.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sofer_agent/cli",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "type": "module",
   "bin": {
     "sofer": "./dist/bin.js"
@@ -25,7 +25,7 @@
     "cli"
   ],
   "dependencies": {
-    "@sofer_agent/core": "0.1.0"
+    "@sofer_agent/core": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",

package/src/bin.ts

@@ -11,9 +11,30 @@ function printHelp(): void {
   sofer            chat with your agent (default)
   sofer init       mint the agent + provision Walrus memory
   sofer info       print on-chain agent state
+  sofer setup      print the .env template to configure
   sofer help       show this help
 
-Reads config + secrets from .env (or the environment).`,
+Reads config + secrets from a .env file or the environment.`,
+  );
+}
+
+function printSetup(): void {
+  console.log(
+    `# Copy this into a .env file in your project directory, then fill in:
+#  - ANTHROPIC_API_KEY (your Claude API key)
+#  - SOFER_SUI_SECRET_KEY (or let \`sofer init\` generate one)
+#
+# Then run: sofer init
+
+# --- Sui chain ---
+SUI_NETWORK=testnet
+SUI_RPC_URL=https://fullnode.testnet.sui.io:443
+SOFER_PACKAGE_ID=0xd5291ac6fd0de787f9fe0bc16c677ef5bafffd920936a05b14e7a8a142e46434
+SOFER_AGENT_OBJECT_ID=
+
+# --- Brain (Claude) ---
+ANTHROPIC_API_KEY=
+SOFER_MODEL=claude-opus-4-8`,
   );
 }
 
@@ -30,6 +51,9 @@ async function main(): Promise<void> {
     case "info":
       await infoCommand();
       break;
+    case "setup":
+      printSetup();
+      break;
     case "help":
     case "-h":
     case "--help":
@@ -43,6 +67,10 @@ async function main(): Promise<void> {
 }
 
 main().catch((e) => {
-  console.error(e instanceof Error ? e.message : String(e));
+  const msg = e instanceof Error ? e.message : String(e);
+  console.error(msg);
+  if (msg.includes("SOFER_PACKAGE_ID") || msg.includes("SOFER_SUI_SECRET_KEY") || msg.includes("ANTHROPIC_API_KEY")) {
+    console.error("\nFirst time? Run `sofer setup` for the .env template, then `sofer init`.");
+  }
   process.exit(1);
 });

package/src/chat.ts

@@ -1,46 +1,22 @@
-import readline from "node:readline";
-import { loadConfig, SoferAgent } from "@sofer_agent/core";
+import { SoferAgent, loadConfig } from "@sofer_agent/core";
 import { requireSecrets } from "./secrets.js";
+import { SoferTui } from "./tui.js";
 
-/** Interactive chat REPL with the agent. */
+/** Interactive chat TUI with a stats sidebar. */
 export async function chatCommand(): Promise<void> {
   const config = loadConfig();
   const agent = await SoferAgent.create(config, requireSecrets());
 
-  console.log(`\x1b[1m${agent.name}\x1b[0m ready — ${agent.address}`);
-  console.log(`model: ${config.brain.model}   ·   type a message, or /exit to quit\n`);
+  const tui = new SoferTui(agent, config);
 
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-    prompt: "\x1b[36myou>\x1b[0m ",
-  });
-  const label = `\x1b[32m${agent.name.toLowerCase()}>\x1b[0m`;
-  rl.prompt();
-
-  rl.on("line", async (line) => {
-    const text = line.trim();
-    if (text === "/exit" || text === "/quit") {
-      rl.close();
-      return;
-    }
-    if (!text) {
-      rl.prompt();
-      return;
-    }
+  await tui.run(async (line) => {
     try {
-      const reply = await agent.chat(text);
-      console.log(`${label} ${reply}\n`);
+      const { text, turnUsage } = await agent.chat(line);
+      tui.addMessage("agent", text);
+      tui.setUsage(turnUsage.inputTokens, turnUsage.outputTokens);
     } catch (e) {
-      console.error(`\x1b[31merror:\x1b[0m ${e instanceof Error ? e.message : String(e)}\n`);
+      tui.addMessage("error", e instanceof Error ? e.message : String(e));
     }
-    rl.prompt();
-  });
-
-  await new Promise<void>((resolve) => {
-    rl.on("close", () => {
-      console.log("bye.");
-      resolve();
-    });
+    tui.render();
   });
 }

package/src/info.ts

@@ -1,4 +1,10 @@
-import { AgentClient, keypairFromSecret, loadConfig, makeSuiClient, suiBalance } from "@sofer_agent/core";
+import {
+  AgentClient,
+  keypairFromSecret,
+  loadConfig,
+  makeSuiClient,
+  suiBalance,
+} from "@sofer_agent/core";
 
 /** Print the agent's on-chain state. */
 export async function infoCommand(): Promise<void> {

package/src/tui.ts

@@ -0,0 +1,295 @@
+import type * as readline from "node:readline";
+import type { SoferConfig } from "@sofer_agent/core";
+import type { SoferAgent } from "@sofer_agent/core";
+
+const SIDEBAR_W = 28;
+const MIN_CHAT_W = 30;
+
+interface ChatLine {
+  role: "you" | "agent" | "error";
+  text: string;
+}
+
+export interface TuiState {
+  messages: ChatLine[];
+  lastTurnIn: number;
+  lastTurnOut: number;
+}
+
+export class SoferTui {
+  private state: TuiState = { messages: [], lastTurnIn: 0, lastTurnOut: 0 };
+  private inputBuf = "";
+  private cursor = 0;
+  private rl: readline.Interface | null = null;
+  private columns = 80;
+  private rows = 24;
+  private chatH = 20;
+  private chatW = 50;
+  private scrollOff = 0;
+  private resolve: (() => void) | null = null;
+  private onLine: ((line: string) => void) | null = null;
+
+  constructor(
+    private readonly agent: SoferAgent,
+    private readonly config: SoferConfig,
+  ) {}
+
+  get width() {
+    return this.columns;
+  }
+  get height() {
+    return this.rows;
+  }
+
+  private measure(): void {
+    this.columns = process.stdout.columns ?? 80;
+    this.rows = process.stdout.rows ?? 24;
+    this.chatW = Math.max(MIN_CHAT_W, this.columns - SIDEBAR_W - 1);
+    this.chatH = this.rows - 3;
+  }
+
+  addMessage(role: ChatLine["role"], text: string): void {
+    this.state.messages.push({ role, text });
+  }
+
+  setUsage(lastTurnIn: number, lastTurnOut: number): void {
+    this.state.lastTurnIn = lastTurnIn;
+    this.state.lastTurnOut = lastTurnOut;
+  }
+
+  /** Start the interactive TUI loop. Returns when the user exits. */
+  async run(onLine: (line: string) => Promise<void>): Promise<void> {
+    this.onLine = onLine;
+    this.measure();
+
+    if (process.stdin.isTTY) process.stdin.setRawMode?.(true);
+    process.stdin.on("data", this.handleInput);
+    process.stdout.on("resize", this.handleResize);
+    process.on("SIGWINCH", this.handleResize);
+
+    this.render();
+    return new Promise<void>((resolve) => {
+      this.resolve = resolve;
+    });
+  }
+
+  private shutdown(): void {
+    process.stdin.setRawMode?.(false);
+    process.stdin.removeAllListeners("data");
+    process.stdout.removeAllListeners("resize");
+    process.removeAllListeners("SIGWINCH");
+    this.render(); // final render in normal mode
+    process.stdout.write("\n");
+    this.resolve?.();
+  }
+
+  // ── Input handling ──────────────────────────────────────────────────────
+
+  private handleInput = (data: Buffer): void => {
+    const str = data.toString();
+    for (const ch of str) {
+      const code = ch.charCodeAt(0);
+      if (code === 3) {
+        process.exit(0);
+      } // Ctrl-C
+      if (code === 4 && this.inputBuf.length === 0) {
+        this.shutdown();
+        return;
+      } // Ctrl-D on empty
+      if (code === 13) {
+        this.submit();
+        return;
+      } // Enter
+      if (code === 127) {
+        // Backspace
+        if (this.cursor > 0) {
+          this.inputBuf =
+            this.inputBuf.slice(0, this.cursor - 1) + this.inputBuf.slice(this.cursor);
+          this.cursor--;
+        }
+        this.render();
+        return;
+      }
+      if (code === 27 && this.inputBuf.length > 0) {
+        // Escape clears input
+        this.inputBuf = "";
+        this.cursor = 0;
+        this.render();
+        return;
+      }
+      if (ch >= " ") {
+        this.inputBuf = this.inputBuf.slice(0, this.cursor) + ch + this.inputBuf.slice(this.cursor);
+        this.cursor++;
+        this.render();
+      }
+    }
+  };
+
+  private async submit(): Promise<void> {
+    const line = this.inputBuf.trim();
+    this.inputBuf = "";
+    this.cursor = 0;
+    if (!line) {
+      this.render();
+      return;
+    }
+    if (line === "/exit" || line === "/quit") {
+      this.shutdown();
+      return;
+    }
+    this.addMessage("you", line);
+    this.scrollOff = 0; // auto-scroll to latest
+    this.render();
+    await this.onLine?.(line);
+  }
+
+  // ── Terminal rendering ──────────────────────────────────────────────────
+
+  private handleResize = (): void => {
+    this.measure();
+    this.render();
+  };
+
+  /** Reset cursor, clear, redraw everything. */
+  render(): void {
+    this.measure();
+    const out = process.stdout;
+    out.write("\x1b[?25l"); // hide cursor
+    out.write(this.buildFrame());
+    out.write("\x1b[?25h"); // show cursor
+  }
+
+  private buildFrame(): string {
+    const { columns, rows, chatW, chatH } = this;
+    const rightW = columns - chatW - 1; // border column
+
+    let buf = "\x1b[H"; // cursor to top-left
+
+    // ── Body ──────────────────────────────────────────────────────────────
+    // We draw row by row. Each row: chat area | border | sidebar
+    const msgs = this.state.messages;
+    const wrappedLines = msgs.flatMap((m) => this.wrapLine(m, chatW));
+    const totalLines = wrappedLines.length;
+    const maxScroll = Math.max(0, totalLines - chatH);
+    if (this.scrollOff > maxScroll) this.scrollOff = maxScroll;
+    if (this.scrollOff < 0) this.scrollOff = 0;
+    const visible = wrappedLines.slice(this.scrollOff, this.scrollOff + chatH);
+
+    for (let r = 0; r < chatH; r++) {
+      const line = visible[r];
+      buf += line ? this.pad(line, chatW) : this.blank(chatW);
+      if (r === 0) buf += "┬";
+      else if (r === chatH - 1) buf += "┴";
+      else buf += "│";
+      buf += this.sidebarRow(r, chatH, rightW);
+      buf += "\n";
+    }
+
+    // ── Divider ───────────────────────────────────────────────────────────
+    buf += `${"─".repeat(chatW)}┴${"─".repeat(rightW)}\n`;
+
+    // ── Input line ────────────────────────────────────────────────────────
+    const prefix = "\x1b[36myou>\x1b[0m ";
+    const prefixW = 4;
+    const maxInputW = columns - prefixW - 1;
+    let typed = this.inputBuf;
+    if (typed.length > maxInputW) {
+      const start = typed.length - maxInputW;
+      typed = typed.slice(start);
+    }
+    buf += `${prefix}${typed}\x1b[K`; // clear to end of line
+    // Place cursor at end of input
+    const cursorCol = prefixW + Math.min(this.cursor, maxInputW);
+    buf += `\x1b[${chatH + 2};${cursorCol}H`;
+
+    return buf;
+  }
+
+  private wrapLine(msg: ChatLine, width: number): string[] {
+    const label =
+      msg.role === "you"
+        ? "\x1b[36myou>\x1b[0m "
+        : msg.role === "agent"
+          ? `\x1b[32m${this.agent.name.toLowerCase()}>\x1b[0m `
+          : "\x1b[31merror>\x1b[0m ";
+    const content = msg.text;
+    const full = label + content;
+    if (full.length <= width) return [full];
+    // simple word-wrap
+    const lines: string[] = [];
+    let current = label;
+    const words = content.split(" ");
+    for (const word of words) {
+      if (current.length + 1 + word.length <= width) {
+        current += (current === label ? "" : " ") + word;
+      } else {
+        if (current.length > label.length) lines.push(current);
+        current = `  ${word}`; // indent continuation
+      }
+    }
+    if (current.length > label.length) lines.push(current);
+    return lines.length > 0 ? lines : [full];
+  }
+
+  private pad(s: string, w: number): string {
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape stripping
+    const ansiRe = /\x1b\[\d*;?\d*m/g;
+    const stripped = s.replace(ansiRe, "");
+    const padW = Math.max(0, w - stripped.length);
+    return s + " ".repeat(padW);
+  }
+
+  private blank(w: number): string {
+    return " ".repeat(w);
+  }
+
+  // ── Sidebar ─────────────────────────────────────────────────────────────
+
+  private sidebarRow(row: number, total: number, width: number): string {
+    const innerW = width - 2; // left & right padding
+    const lines = this.buildSidebar(innerW);
+
+    // center the sidebar content vertically
+    const gap = Math.max(0, total - lines.length);
+    const topPad = Math.floor(gap / 2);
+    const idx = row - topPad;
+
+    if (idx < 0 || idx >= lines.length) return " ".repeat(width);
+    const line = lines[idx];
+    if (!line) return " ".repeat(width);
+    return ` ${this.pad(line, innerW)} `;
+  }
+
+  private buildSidebar(width: number): string[] {
+    const { agent, config, state } = this;
+    const addr = `${agent.address.slice(0, 6)}...${agent.address.slice(-4)}`;
+    const totalIn = agent.usage.tokens.inputTokens;
+    const totalOut = agent.usage.tokens.outputTokens;
+    const cost = agent.usage.costUsd.toFixed(4);
+
+    return [
+      `\x1b[1m${agent.name}\x1b[0m`,
+      "─".repeat(width),
+      `Model: ${this.shortModel(config.brain.model)}`,
+      `Max out:  ${config.brain.maxOutputTokens}`,
+      "",
+      `Turn in:  ${state.lastTurnIn}`,
+      `Turn out: ${state.lastTurnOut}`,
+      `Total in: ${totalIn}`,
+      `Total out:${totalOut}`,
+      `Cost:     \x1b[33m$${cost}\x1b[0m`,
+      "",
+      `Addr: ${addr}`,
+      `Network: ${config.network}`,
+    ];
+  }
+
+  private shortModel(model: string): string {
+    const m = model.toLowerCase();
+    if (m.includes("sonnet")) return "Sonnet 4";
+    if (m.includes("haiku")) return "Haiku 3.5";
+    if (m.includes("opus")) return "Opus 4";
+    if (m.includes("fable")) return "Fable 5";
+    return model;
+  }
+}