@ikyyofc/gemini-cli 1.0.0

package/README.md

@@ -0,0 +1,140 @@
+# Gemini CLI 🤖
+
+> AI Agent CLI — native function calling · GEMINI.md context · extension system
+
+```
+   ██████╗ ███████╗███╗   ███╗██╗███╗   ██╗██╗
+  ██╔════╝ ██╔════╝████╗ ████║██║████╗  ██║██║
+  ██║  ███╗█████╗  ██╔████╔██║██║██╔██╗ ██║██║
+  ██║   ██║██╔══╝  ██║╚██╔╝██║██║██║╚██╗██║██║
+  ╚██████╔╝███████╗██║ ╚═╝ ██║██║██║ ╚████║██║
+   ╚═════╝ ╚══════╝╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚═╝
+```
+
+---
+
+## Instalasi
+
+```bash
+npm install
+chmod +x index.js
+npm link    # optional: pakai sebagai `gemini` di terminal
+```
+
+---
+
+## Penggunaan
+
+```bash
+gemini                                    # interactive agent
+gemini "buatkan REST API di ./api"        # one-shot
+gemini --system "Kamu senior backend engineer"
+gemini --file ./app.js "jelaskan kode ini"
+gemini --yolo "refactor semua file di src/"
+gemini --chat                             # plain chat tanpa tools
+```
+
+---
+
+## GEMINI.md — Context Files
+
+Buat `GEMINI.md` di lokasi berikut (dimuat hierarki, seperti Gemini CLI asli):
+
+| Lokasi | Scope |
+|--------|-------|
+| `~/.gemini/GEMINI.md` | Global semua project |
+| `./GEMINI.md` | Project root (sampai `.git`) |
+
+Support import antar file:
+```md
+@./components/style.md
+@../shared/conventions.md
+```
+
+**Commands:**
+```
+/memory show          → tampilkan semua context yang dimuat
+/memory reload        → reload dari disk
+/memory add <text>    → append ke ~/.gemini/GEMINI.md
+```
+
+---
+
+## Extensions
+
+Manifest: `~/.gemini/extensions/<name>/gemini-extension.json`
+
+```json
+{
+  "name": "my-ext",
+  "version": "1.0.0",
+  "description": "...",
+  "contextFileName": "GEMINI.md",
+  "enabled": true,
+  "commands": {
+    "do-thing": {
+      "description": "Does a thing",
+      "prompt": "Do this: {{args}}"
+    }
+  }
+}
+```
+
+**Commands:**
+```
+/ext list
+/ext install /path/to/ext
+/ext install https://github.com/user/repo
+/ext uninstall <name>
+/ext enable / disable <name>
+/ext update <name>
+```
+
+Custom commands dipanggil: `/code-reviewer:review ./src/app.js`
+
+---
+
+## Tools (Native Function Calling)
+
+| Tool | Aksi |
+|------|------|
+| `read_file` | Baca file |
+| `write_file` | Tulis/overwrite file |
+| `patch_file` | Edit bagian spesifik |
+| `append_file` | Append ke file |
+| `list_dir` | List direktori |
+| `find_files` | Cari file (glob) |
+| `search_in_files` | Grep dalam file |
+| `run_shell` | Jalankan shell command |
+| `create_dir` | Buat direktori |
+| `delete_file` | Hapus file |
+| `move_file` | Pindah/rename |
+| `get_env` | Info environment |
+| `read_url` | Fetch URL / API |
+
+---
+
+## Struktur
+
+```
+gemini-cli/
+├── index.js                   ← CLI entry + REPL + commands
+├── GEMINI.md                  ← Project context (auto-loaded)
+├── package.json
+├── src/
+│   ├── gemini.js              ← API client (native function calling)
+│   ├── tools.js               ← functionDeclarations + executor
+│   ├── agent.js               ← ReAct loop
+│   ├── memory.js              ← GEMINI.md hierarchy loader
+│   ├── extensions.js          ← Extension manager
+│   └── renderer.js            ← Terminal UI + markdown
+└── extensions/
+    └── code-reviewer/
+        ├── gemini-extension.json
+        └── GEMINI.md
+
+~/.gemini/                     ← Global config dir
+├── GEMINI.md
+├── extensions/
+└── commands/
+```

package/index.js

@@ -0,0 +1,362 @@
+#!/usr/bin/env node
+// ═══════════════════════════════════════════════════════════════
+//  Gemini CLI v2  — AI Agent
+//  Native function calling · GEMINI.md context hierarchy
+//  Extension system · Custom commands · /memory · /ext
+// ═══════════════════════════════════════════════════════════════
+import readline from "readline";
+import fs       from "fs";
+import path     from "path";
+import chalk    from "chalk";
+
+import { chat }         from "./src/gemini.js";
+import { runAgentLoop } from "./src/agent.js";
+import {
+    loadMemory, buildContextString, memoryShow, memoryAdd, ensureGlobalDir, GLOBAL_DIR
+} from "./src/memory.js";
+import {
+    loadExtensions, loadCustomCommands, getExtensionContextDirs,
+    installExtension, uninstallExtension, enableExtension, listExtensions, updateExtension
+} from "./src/extensions.js";
+import {
+    renderWelcome, renderHelp,
+    printUser, printAssistant,
+    printError, printInfo, printSuccess, printWarning
+} from "./src/renderer.js";
+
+// ─────────────────────────────────────────────────────────────────
+//  Bootstrap
+// ─────────────────────────────────────────────────────────────────
+ensureGlobalDir();
+
+let extensions     = loadExtensions();
+let customCommands = {};   // populated after extensions load
+let memoryLoaded   = [];   // { file, content }[]
+let memoryContext  = null; // concatenated string
+
+function reloadAll() {
+    extensions     = loadExtensions();
+    customCommands = {}; // TODO: loadCustomCommands(extensions) — needs top-level await
+    const extraDirs = getExtensionContextDirs(extensions);
+    memoryLoaded   = loadMemory(extraDirs);
+    memoryContext  = buildContextString(memoryLoaded);
+}
+reloadAll();
+
+// ─────────────────────────────────────────────────────────────────
+//  State
+// ─────────────────────────────────────────────────────────────────
+let conversationHistory = [];
+let sessionSystem       = null;   // from /system command or --system flag
+let pendingFile         = null;
+let pendingFilePath     = null;
+let isProcessing        = false;
+let agentMode           = true;
+let autoApprove         = false;
+
+/** Full system instruction: memory context + session system */
+function buildSystemInstruction() {
+    const parts = [memoryContext, sessionSystem].filter(Boolean);
+    return parts.length ? parts.join("\n\n") : null;
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Readline
+// ─────────────────────────────────────────────────────────────────
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true, historySize: 200 });
+
+function setPrompt() {
+    const mode  = agentMode ? chalk.hex("#4EC9B0")(" ⚡agent") : chalk.hex("#858585")(" 💬chat");
+    const yolo  = autoApprove ? chalk.hex("#F44747")(" YOLO")  : "";
+    const fTag  = pendingFile  ? chalk.hex("#DCDCAA")(` 📎 ${path.basename(pendingFilePath)}`) : "";
+    const turns = conversationHistory.length > 0 ? chalk.hex("#858585")(` [${Math.ceil(conversationHistory.length/2)}t]`) : "";
+    const mem   = memoryLoaded.length ? chalk.hex("#C586C0")(` [mem:${memoryLoaded.length}]`) : "";
+    rl.setPrompt("\n  " + chalk.hex("#569CD6").bold("❯") + mode + yolo + fTag + turns + mem + chalk.hex("#D4D4D4")(" "));
+    rl.prompt();
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  File attachment
+// ─────────────────────────────────────────────────────────────────
+function loadFile(filePath) {
+    const p = path.resolve(filePath.trim().replace(/^['"]|['"]$/g, ""));
+    if (!fs.existsSync(p))              { printError(`File not found: ${p}`); return; }
+    if (fs.statSync(p).size > 20*1024*1024) { printError("File too large (max 20 MB)"); return; }
+    pendingFile     = fs.readFileSync(p);
+    pendingFilePath = p;
+    printSuccess(`Attached: ${path.basename(p)} (${(fs.statSync(p).size/1024).toFixed(1)} KB)`);
+    printInfo("Will be sent with your next message.");
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Command router
+// ─────────────────────────────────────────────────────────────────
+async function handleCommand(input) {
+    const tokens = input.trim().split(/\s+/);
+    const cmd    = tokens[0].toLowerCase();
+    const arg    = tokens.slice(1).join(" ").trim();
+
+    // ── /memory ─────────────────────────────────────────────────
+    if (cmd === "/memory") {
+        const sub = tokens[1]?.toLowerCase();
+        if (sub === "show") {
+            console.log(memoryShow(memoryLoaded));
+        } else if (sub === "reload") {
+            reloadAll();
+            printSuccess(`Reloaded. ${memoryLoaded.length} context file(s) loaded.`);
+        } else if (sub === "add") {
+            const text = tokens.slice(2).join(" ");
+            if (!text) { printError("Usage: /memory add <text>"); return; }
+            const result = memoryAdd(text);
+            printSuccess(result);
+            reloadAll();
+        } else {
+            printInfo("Usage: /memory [show|reload|add <text>]");
+        }
+        return;
+    }
+
+    // ── /ext ────────────────────────────────────────────────────
+    if (cmd === "/ext") {
+        const sub = tokens[1]?.toLowerCase();
+        const name = tokens[2];
+
+        if (sub === "list") {
+            const list = listExtensions();
+            if (!list.length) { printInfo("No extensions installed. Use /ext install <source>"); return; }
+            console.log("");
+            list.forEach(e => {
+                const status = e.enabled ? chalk.hex("#4EC9B0")("✔ enabled") : chalk.hex("#858585")("○ disabled");
+                console.log(
+                    `  ${status}  ` +
+                    chalk.hex("#DCDCAA").bold(e.name) +
+                    chalk.hex("#858585")(` v${e.version}`) +
+                    (e.description ? chalk.hex("#858585")(`  — ${e.description}`) : "")
+                );
+            });
+            console.log("");
+
+        } else if (sub === "install") {
+            if (!arg.slice(arg.indexOf(" ")+1).trim() && !name) { printError("Usage: /ext install <path-or-git-url>"); return; }
+            const src = tokens.slice(2).join(" ");
+            printInfo(`Installing: ${src} …`);
+            const res = await installExtension(src);
+            if (res.error) printError(res.error);
+            else { printSuccess(`Installed: ${res.name}  (${res.path})`); reloadAll(); }
+
+        } else if (sub === "uninstall") {
+            if (!name) { printError("Usage: /ext uninstall <name>"); return; }
+            const res = await uninstallExtension(name);
+            if (res.error) printError(res.error);
+            else { printSuccess(`Uninstalled: ${name}`); reloadAll(); }
+
+        } else if (sub === "enable") {
+            if (!name) { printError("Usage: /ext enable <name>"); return; }
+            const res = enableExtension(name, true);
+            if (res.error) printError(res.error); else { printSuccess(`Enabled: ${name}`); reloadAll(); }
+
+        } else if (sub === "disable") {
+            if (!name) { printError("Usage: /ext disable <name>"); return; }
+            const res = enableExtension(name, false);
+            if (res.error) printError(res.error); else { printSuccess(`Disabled: ${name}`); reloadAll(); }
+
+        } else if (sub === "update") {
+            if (!name) { printError("Usage: /ext update <name>"); return; }
+            printInfo(`Updating ${name}…`);
+            const res = await updateExtension(name);
+            if (res.error) printError(res.error); else { printSuccess(`Updated: ${name}`); reloadAll(); }
+
+        } else {
+            printInfo("Usage: /ext [list|install|uninstall|enable|disable|update] [name]");
+        }
+        return;
+    }
+
+    // ── Built-in commands ────────────────────────────────────────
+    switch (cmd) {
+        case "/help":
+            console.log(renderHelp(customCommands));
+            break;
+
+        case "/new": case "/clear":
+            conversationHistory = [];
+            pendingFile = null; pendingFilePath = null;
+            printInfo("Conversation cleared.");
+            break;
+
+        case "/file":
+            if (!arg) { printError("Usage: /file <path>"); break; }
+            loadFile(arg);
+            break;
+
+        case "/system":
+            if (!arg) { printInfo(`System: ${sessionSystem ?? "(none)"}`); break; }
+            sessionSystem = arg;
+            printSuccess("Session system instruction set.");
+            break;
+
+        case "/agent":
+            agentMode = !agentMode;
+            printSuccess(`Mode: ${agentMode ? chalk.hex("#4EC9B0").bold("AGENT") + " (native function calling loop)" : chalk.hex("#858585").bold("CHAT") + " (plain conversation)"}`);
+            break;
+
+        case "/yolo":
+            autoApprove = !autoApprove;
+            autoApprove ? printWarning("YOLO ON — all tool actions auto-approved.") : printSuccess("YOLO OFF — confirmations restored.");
+            break;
+
+        case "/history":
+            if (!conversationHistory.length) { printInfo("No history."); break; }
+            console.log("");
+            conversationHistory.forEach((m, i) => {
+                const who   = m.role === "user" ? chalk.hex("#569CD6")("You") : chalk.hex("#4EC9B0")("Gemini");
+                const body  = typeof m.content === "string" ? m.content : JSON.stringify(m.content);
+                const short = body.slice(0, 100).replace(/\n/g, " ");
+                console.log(chalk.hex("#858585")(`  [${i+1}] `) + who + chalk.hex("#858585")(": ") + chalk.hex("#D4D4D4")(short));
+            });
+            console.log("");
+            break;
+
+        case "/export":
+            if (!arg) { printError("Usage: /export <file.json>"); break; }
+            fs.writeFileSync(path.resolve(arg), JSON.stringify({ exported_at: new Date().toISOString(), mode: agentMode ? "agent":"chat", system: buildSystemInstruction(), messages: conversationHistory }, null, 2));
+            printSuccess(`Exported to ${arg}`);
+            break;
+
+        case "/cwd":
+            printInfo(`Working directory: ${process.cwd()}`);
+            break;
+
+        case "/cd":
+            if (!arg) { printError("Usage: /cd <path>"); break; }
+            try { process.chdir(path.resolve(arg)); printSuccess(`Changed to: ${process.cwd()}`); } catch (e) { printError(e.message); }
+            break;
+
+        case "/model":
+            printInfo("Model        : gemini-pro-latest");
+            printInfo("Provider     : Gemini (Firebase Cloud Function)");
+            printInfo("Tool calling : NATIVE (functionDeclarations / functionCall / functionResponse)");
+            printInfo("Thinking     : HIGH  |  Temperature: 0  |  Safety: BLOCK_NONE");
+            printInfo(`Agent mode   : ${agentMode ? "ON" : "OFF"}`);
+            printInfo(`Auto-approve : ${autoApprove ? "ON (YOLO)" : "OFF"}`);
+            printInfo(`Memory files : ${memoryLoaded.length}  |  Extensions: ${extensions.length}`);
+            printInfo(`Global config: ${GLOBAL_DIR}`);
+            break;
+
+        case "/exit": case "/quit":
+            printInfo("Goodbye! 👋");
+            rl.close(); process.exit(0);
+            break;
+
+        default: {
+            // Check if it's a custom command: /namespace:cmd [args]
+            const customKey = cmd.slice(1); // strip leading /
+            if (customKey.includes(":") && customCommands[customKey]) {
+                const c   = customCommands[customKey];
+                const msg = (c.prompt ?? "").replace("{{args}}", arg);
+                if (msg) await sendMessage(msg);
+                else printError(`Command "${customKey}" has no prompt defined.`);
+            } else {
+                printError(`Unknown command: ${cmd}  (type /help)`);
+            }
+        }
+    }
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Send message
+// ─────────────────────────────────────────────────────────────────
+async function sendMessage(userText) {
+    if (!userText.trim()) return;
+    printUser(userText + (pendingFile ? chalk.hex("#DCDCAA")(` [📎 ${path.basename(pendingFilePath)}]`) : ""));
+
+    const sysInstruction = buildSystemInstruction();
+
+    if (agentMode) {
+        const result = await runAgentLoop(userText, conversationHistory, {
+            systemInstruction: sysInstruction,
+            autoApprove,
+            maxIterations: 40,
+        });
+        if (result?.finalResponse) {
+            conversationHistory.push({ role: "user",      content: userText });
+            conversationHistory.push({ role: "assistant", content: result.finalResponse });
+        }
+    } else {
+        const { default: ora } = await import("ora");
+        const spinner = ora({ text: chalk.hex("#858585")(" Thinking…"), spinner: "dots12", color: "cyan", prefixText: " " }).start();
+        const msgs = [];
+        if (sysInstruction) msgs.push({ role: "system", content: sysInstruction });
+        msgs.push(...conversationHistory, { role: "user", content: userText });
+        try {
+            const t0 = Date.now();
+            const reply = await chat(msgs, pendingFile || null);
+            spinner.succeed(chalk.hex("#4EC9B0")("Done") + chalk.hex("#858585")(` (${((Date.now()-t0)/1000).toFixed(1)}s)`));
+            conversationHistory.push({ role: "user", content: userText }, { role: "assistant", content: reply });
+            printAssistant(reply);
+        } catch (err) {
+            spinner.fail(chalk.hex("#F44747")("Failed"));
+            printError(err.message);
+        }
+    }
+
+    pendingFile = null; pendingFilePath = null;
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Main
+// ─────────────────────────────────────────────────────────────────
+async function main() {
+    process.stdout.write("\x1Bc");
+    console.log(renderWelcome(memoryLoaded.length, extensions.length, Object.keys(customCommands).length));
+
+    // Parse flags
+    const argv = process.argv.slice(2);
+    const positional = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if      (a === "--system" && argv[i+1]) { sessionSystem = argv[++i]; printSuccess(`System: "${sessionSystem}"`); }
+        else if (a === "--file"   && argv[i+1]) { loadFile(argv[++i]); }
+        else if (a === "--yolo")                { autoApprove = true; printWarning("YOLO mode ON."); }
+        else if (a === "--chat")                { agentMode   = false; }
+        else if (!a.startsWith("--"))           { positional.push(a); }
+    }
+
+    // One-shot
+    if (positional.length > 0) {
+        await sendMessage(positional.join(" "));
+        process.exit(0);
+    }
+
+    // Print mode info
+    printInfo(
+        `Mode: ${agentMode
+            ? chalk.hex("#4EC9B0").bold("AGENT") + chalk.hex("#858585")(" (native function calling · filesystem · shell · web)")
+            : chalk.hex("#858585").bold("CHAT")
+        }  |  ${chalk.hex("#CE9178")("/agent")} toggle  |  ${chalk.hex("#CE9178")("/yolo")} skip confirms  |  ${chalk.hex("#CE9178")("/help")} commands`
+    );
+    if (memoryContext) {
+        printInfo(`Context: ${chalk.hex("#C586C0")(memoryLoaded.length + " GEMINI.md file(s) loaded")} — use ${chalk.hex("#CE9178")("/memory show")} to inspect`);
+    }
+    console.log("");
+
+    setPrompt();
+
+    rl.on("line", async line => {
+        const input = line.trim();
+        if (!input) { setPrompt(); return; }
+        if (isProcessing) { printWarning("Still processing…"); setPrompt(); return; }
+        isProcessing = true; rl.pause();
+        try {
+            if (input.startsWith("/")) await handleCommand(input);
+            else                       await sendMessage(input);
+        } finally {
+            isProcessing = false; rl.resume(); setPrompt();
+        }
+    });
+
+    rl.on("close", () => { console.log("\n" + chalk.hex("#858585")("  Session ended.\n")); process.exit(0); });
+    rl.on("SIGINT", () => { if (isProcessing) { printWarning("Ctrl+C again to force quit."); return; } rl.close(); });
+}
+
+main().catch(err => { console.error(chalk.red("\n  Fatal:"), err.message); process.exit(1); });

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@ikyyofc/gemini-cli",
+  "version": "1.0.0",
+  "description": "AI CLI Agent powered by Gemini — your own terminal assistant",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "gemini": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "dev": "node --watch index.js"
+  },
+  "dependencies": {
+    "axios": "^1.7.9",
+    "chalk": "^5.3.0",
+    "cli-spinners": "^2.9.2",
+    "file-type": "^19.6.0",
+    "ora": "^8.1.1",
+    "readline": "^1.3.0",
+    "marked": "^12.0.0",
+    "marked-terminal": "^7.1.0",
+    "minimist": "^1.2.8"
+  }
+}

package/src/agent.js

@@ -0,0 +1,141 @@
+// src/agent.js — ReAct agent loop using NATIVE Gemini function calling
+import chalk from "chalk";
+import ora   from "ora";
+import { callGemini }   from "./gemini.js";
+import { GEMINI_TOOLS, executeTool } from "./tools.js";
+import { printAssistant, printError, printWarning } from "./renderer.js";
+
+/**
+ * Run the agent loop until the model gives a final text answer (no more tool calls).
+ *
+ * Native function calling flow:
+ *   1. Send contents + tools (functionDeclarations) to Gemini
+ *   2. Response parts may contain: { functionCall: { name, args } }
+ *   3. Execute the tool → get result
+ *   4. Append model turn (with functionCall) + user turn (with functionResponse)
+ *   5. Repeat until response has only text parts → done
+ */
+export async function runAgentLoop(userMessage, history, {
+    systemInstruction = null,
+    autoApprove       = false,
+    maxIterations     = 40,
+} = {}) {
+
+    // Build initial message list
+    const messages = [
+        ...history,
+        { role: "user", content: userMessage }
+    ];
+
+    let iteration = 0;
+
+    while (iteration < maxIterations) {
+        iteration++;
+
+        // ── Call Gemini API with tools ──────────────────────────
+        const spinner = ora({
+            text:       chalk.hex("#858585")(iteration === 1 ? " Thinking…" : ` Step ${iteration}…`),
+            spinner:    "dots12",
+            color:      "cyan",
+            prefixText: " "
+        }).start();
+
+        let parts;
+        try {
+            const res = await callGemini({ messages, tools: GEMINI_TOOLS, systemInstruction });
+            parts = res.parts;
+            spinner.stop();
+            clearLine();
+        } catch (err) {
+            spinner.fail(chalk.hex("#F44747")("API error"));
+            printError(err.message);
+            return null;
+        }
+
+        // ── Separate text parts from functionCall parts ─────────
+        const textParts = parts.filter(p => p.text != null);
+        const callParts = parts.filter(p => p.functionCall != null);
+
+        // Print any accompanying text (model thinking aloud)
+        const textContent = textParts.map(p => p.text).join("").trim();
+        if (textContent && callParts.length > 0) {
+            process.stdout.write(
+                "\n" + chalk.hex("#858585").italic(
+                    "  💭 " + textContent.replace(/\n/g, "\n     ")
+                ) + "\n\n"
+            );
+        }
+
+        // ── No tool calls → final answer ────────────────────────
+        if (callParts.length === 0) {
+            const final = textParts.map(p => p.text).join("").trim();
+            if (final) printAssistant(final);
+            return { finalResponse: final, iterations: iteration };
+        }
+
+        // ── Execute each tool call ───────────────────────────────
+        // Append the model's turn (contains functionCall parts) to history
+        messages.push({ role: "model", parts });
+
+        // Build the functionResponse turn
+        const responseParts = [];
+
+        for (const part of callParts) {
+            const { name, args } = part.functionCall;
+            printToolCall(name, args);
+
+            const result = await executeTool(name, args ?? {}, { autoApprove });
+            printToolResult(result, name);
+
+            responseParts.push({
+                functionResponse: {
+                    name,
+                    response: result  // the entire result object goes here
+                }
+            });
+        }
+
+        // Append user turn with all function responses
+        messages.push({ role: "user", parts: responseParts });
+    }
+
+    printWarning(`Max iterations (${maxIterations}) reached.`);
+    return { finalResponse: null, iterations: iteration };
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Terminal rendering helpers for tool calls
+// ─────────────────────────────────────────────────────────────────
+function printToolCall(name, args = {}) {
+    const preview = Object.entries(args)
+        .map(([k, v]) => {
+            const s = String(v);
+            return chalk.hex("#9CDCFE")(k) + chalk.hex("#858585")(":") +
+                   chalk.hex("#CE9178")(s.length > 60 ? s.slice(0, 60) + "…" : s);
+        })
+        .join("  ");
+
+    process.stdout.write(
+        chalk.hex("#DCDCAA")("  ⚙ ") +
+        chalk.hex("#569CD6").bold(name) +
+        (preview ? chalk.hex("#858585")("  (" + preview + ")") : "") + "\n"
+    );
+}
+
+function printToolResult(result, name) {
+    const text  = typeof result === "object" ? (result.result ?? result.error ?? JSON.stringify(result)) : String(result);
+    const isErr = typeof result === "object" && result.error;
+    const color = isErr ? chalk.hex("#F44747") : chalk.hex("#6A9955");
+    const lines = text.split("\n").slice(0, 15);
+    const more  = text.split("\n").length > 15 ? `\n    … (+${text.split("\n").length - 15} lines)` : "";
+
+    process.stdout.write(
+        color("  └ ") +
+        chalk.hex("#858585")(lines.join("\n    ")) +
+        more + "\n\n"
+    );
+}
+
+function clearLine() {
+    if (process.stdout.clearLine) { process.stdout.clearLine(0); process.stdout.cursorTo(0); }
+}