@quatcode/agent 0.2.8 → 0.2.10

package/dist/tui.js

@@ -12,10 +12,11 @@ import { TurnController, fmtCost, fmtDuration, fmtTokens, toolArg, toolResultBlo
 import { renderBanner } from "./logo.js";
 import { renderMarkdown, wrapSegments } from "./markdown.js";
 import { ADD_PROVIDER, allProviders, buildProvider, defaultModelFor, effortsForModel, hasKey, keyEnvFor, probeProviderModels, providerEnvKey, providerHasModel, providerMeta, providerSlug, registerCustomProvider, removeCustomProvider, resolveProviderForModel, } from "./models.js";
-import { activeThemeId, bg, bold, buildColorRemap, clipAnsi, fg, getThemes, glyphs, padEndTo, palette, remapColors, setTheme, stringWidth, stripAnsi, tone, toolGlyph, } from "./theme.js";
+import { ASCII_MODE, activeThemeId, bg, bold, buildColorRemap, clipAnsi, fg, getThemes, glyphs, mix, padEndTo, palette, pulse, remapColors, setTheme, shimmer, stringWidth, stripAnsi, tone, toolGlyph, } from "./theme.js";
 import { listSessions, listSessionsForDir, loadConfig, makeSessionId, saveConfig, saveSession, deleteSession } from "./store.js";
-import { configFile, conversationKey, deleteConversation, displayTitle, latestPerConversation, messagesForStorage, sameDir, sortConversations, updateConversation } from "./store.js";
+import { appendAudit, auditInput, configFile, conversationKey, deleteConversation, displayTitle, latestPerConversation, messagesForStorage, sameDir, sortConversations, updateConversation } from "./store.js";
 import { MCP_USAGE, isMcpUrl, mcpInstructionsSection, parseMcpAdd } from "./mcp.js";
+import { AUTO, PERSONA_SETTINGS, personaSection, personaSummary, } from "./persona.js";
 import { copyToClipboard, readClipboardImage, readClipboardText, } from "./clipboard.js";
 import { createLoadSkillTool, fetchSkillFromUrl, importSkillFile, listSkills, parseSkill, removeSkill, saveSkill, skillsRoot, skillsSystemSection, } from "./skills.js";
 import { VERSION } from "./version.js";
@@ -34,6 +35,7 @@ const COMMAND_INFO = [
     { name: "/timeline", desc: "jump to a sent message" },
     { name: "/undo", desc: "take back the last message" },
     { name: "/verbose", desc: "toggle full tool output" },
+    { name: "/settings", desc: "tune the agent's persona: character, tone, verbosity…" },
     { name: "/skills", args: "[add|remove|list]", desc: "manage agent skills" },
     { name: "/mcp", args: "[list|add|remove]", desc: "manage MCP servers" },
     { name: "/theme", args: "[id]", desc: "change the color theme" },
@@ -75,6 +77,7 @@ class TuiApp {
     model = "";
     effort = null;
     config = {};
+    persona = {};
     summary = null;
     skills = [];
     system = "";
@@ -185,6 +188,7 @@ class TuiApp {
             process.exit(143);
         });
         this.config = await loadConfig().catch(() => ({}));
+        this.persona = this.config.persona ? { ...this.config.persona } : {};
         for (const [name, value] of Object.entries(this.config.keys ?? {})) {
             if (value && process.env[name] === undefined)
                 process.env[name] = value;
@@ -751,9 +755,15 @@ class TuiApp {
         try {
             const response = await provider.complete({
                 model: this.model,
-                system: `${this.system ? `${this.system}\n\n` : ""}# side channel\nThe user is asking a quick side question while the main task runs. Answer briefly and directly. Do not use tools, do not change the main task, and do not ask to run anything.`,
+                system: [
+                    this.system,
+                    personaSection(this.persona),
+                    "# side channel\nThe user is asking a quick side question while the main task runs. Answer briefly and directly. Do not use tools, do not change the main task, and do not ask to run anything.",
+                ]
+                    .filter(Boolean)
+                    .join("\n\n"),
                 messages: [
-                    ...this.session.getMessages(),
+                    ...sideChannelMessages(this.session.getMessages()),
                     { role: "user", content: [{ type: "text", text }] },
                 ],
                 maxTokens: 2048,
@@ -998,6 +1008,10 @@ class TuiApp {
             return;
         }
         if (this.mode === "picker" && this.picker) {
+            if (this.picker.backAt(row - this.lastHeaderRows)) {
+                this.closePicker(null);
+                return;
+            }
             const value = this.picker.pickAt(row - this.lastHeaderRows);
             if (value !== null)
                 this.closePicker(value);
@@ -1351,8 +1365,9 @@ class TuiApp {
         return [rule, "", bottom];
     }
     statusLine() {
-        const spin = tone.accent(glyphs.spinner[this.spinnerFrame % glyphs.spinner.length] ?? "-");
-        const elapsed = ((performance.now() - this.statusStartedAt) / 1000).toFixed(1);
+        const now = performance.now();
+        const elapsedMs = now - this.statusStartedAt;
+        const elapsed = (elapsedMs / 1000).toFixed(1);
         const meta = [
             this.status?.meta,
             `${elapsed}s`,
@@ -1360,7 +1375,19 @@ class TuiApp {
         ]
             .filter(Boolean)
             .join(" · ");
-        return `  ${spin} ${this.status?.label ?? ""}  ${tone.mist(meta)}`;
+        const frames = glyphs.spinner;
+        const glyph = frames[this.spinnerFrame % frames.length] ?? glyphs.diamond;
+        const icon = fg(mix(palette.accent, palette.bone, pulse(now, 900)), glyph);
+        const base = mix(palette.silver, palette.mist, 0.35);
+        let label;
+        if (this.status?.phase === "tool") {
+            const name = this.status.label;
+            label = `${tone.accent(toolGlyph(name))} ${shimmer(name, now / 55, { base, highlight: palette.bone })}`;
+        }
+        else {
+            label = shimmer(this.status?.label ?? "", now / 55, { base, highlight: palette.bone });
+        }
+        return `  ${icon} ${label}  ${tone.mist(meta)}`;
     }
     visibleTranscript(viewport) {
         let contentEnd = this.transcript.length;
@@ -1423,7 +1450,7 @@ class TuiApp {
         this.spinnerTimer = setInterval(() => {
             this.spinnerFrame += 1;
             this.scheduleRender();
-        }, 90);
+        }, 75);
         if (typeof this.spinnerTimer.unref === "function")
             this.spinnerTimer.unref();
     }
@@ -1569,7 +1596,7 @@ class TuiApp {
         this.agentMode = this.agentMode === "build" ? "plan" : "build";
         this.rebuildTools();
         this.append([
-            `  ${tone.accent(glyphs.diamond)} ${tone.mist(`// MODE → ${this.agentMode.toUpperCase()}`)}${this.agentMode === "plan" ? `  ${tone.amber("no edits · run_command allowed (with approval)")}` : ""}`,
+            `  ${tone.accent(glyphs.diamond)} ${tone.mist(`// MODE → ${this.agentMode.toUpperCase()}`)}${this.agentMode === "plan" ? ` ${tone.amber("· no edits")}` : ""}`,
         ]);
     }
     ensureProvider() {
@@ -1955,21 +1982,50 @@ class TuiApp {
                     this.append([
                         `  ${tone.amber(glyphs.diamondOpen)} ${tone.mist(`// ${req.tool} blocked in PLAN mode (Tab switches to BUILD)`)}`,
                     ]);
+                    this.audit(req, "denied", "plan");
                     return { allowed: false };
                 }
                 if (this.agentMode === "plan" && READ_ONLY_TOOLS.has(req.tool))
                     return { allowed: true };
-                if (this.gateMode === "always")
+                const analysis = req.tool === "run_command" ? this.commandAnalysis(req) : null;
+                const dangerous = analysis?.dangerous === true;
+                if (this.opts.allowAll) {
+                    this.audit(req, "allowed", "allow-all", analysis);
                     return { allowed: true };
-                const choice = await this.permissionCard(req);
-                if (choice === "always") {
-                    this.gateMode = "always";
+                }
+                // "always" never covers dangerous commands — those are confirmed each time.
+                if (this.gateMode === "always" && !dangerous) {
+                    this.audit(req, "allowed", "always", analysis);
                     return { allowed: true };
                 }
-                return { allowed: choice === "allow" };
+                const choice = await this.permissionCard(req);
+                const granted = choice === "allow" || choice === "always";
+                if (choice === "always" && !dangerous)
+                    this.gateMode = "always";
+                this.audit(req, granted ? "allowed" : "denied", choice, analysis);
+                return { allowed: granted };
             },
         };
     }
+    commandAnalysis(req) {
+        const command = req.input && typeof req.input === "object" && "command" in req.input
+            ? String(req.input.command)
+            : "";
+        return command ? analyzeCommand(command) : null;
+    }
+    audit(req, decision, via, analysis) {
+        void appendAudit({
+            ts: new Date().toISOString(),
+            dir: this.dir,
+            tool: req.tool,
+            decision,
+            via,
+            danger: analysis
+                ? { dangerous: analysis.dangerous, sensitive: analysis.sensitive, reasons: analysis.reasons }
+                : undefined,
+            input: auditInput(req.input),
+        }).catch(() => undefined);
+    }
     async promptForKey(keyEnv) {
         this.append([`  ${tone.mist(`// ${keyEnv} IS NOT SET`)}`]);
         const result = await this.readLine({
@@ -2017,6 +2073,9 @@ class TuiApp {
         const mcpSection = mcpInstructionsSection(this.mcp.instructions());
         if (mcpSection)
             system = system ? `${system}\n\n${mcpSection}` : mcpSection;
+        const persona = personaSection(this.persona);
+        if (persona)
+            system = system ? `${system}\n\n${persona}` : persona;
         if (this.agentMode === "plan") {
             system = `${system ? `${system}\n\n` : ""}# mode\nYou are in PLAN mode: analyze the codebase and propose a plan. You may run read-only commands with run_command to inspect the project (each command is approved by the user), but never modify files, install packages or run mutating commands. When the plan is ready, present it and tell the user to press Tab to switch to BUILD mode.`;
         }
@@ -2186,6 +2245,9 @@ class TuiApp {
                     `  ${tone.mist(`// VERBOSE ${this.verbose ? "ON — FULL TOOL OUTPUT" : "OFF"}`)}`,
                 ]);
                 return false;
+            case "settings":
+                await this.openSettings();
+                return false;
             case "theme":
                 await this.changeTheme(arg);
                 return false;
@@ -2206,6 +2268,45 @@ class TuiApp {
                 return false;
         }
     }
+    async openSettings() {
+        const before = JSON.stringify(this.persona);
+        for (;;) {
+            const entries = PERSONA_SETTINGS.map((setting) => ({
+                kind: "item",
+                value: setting.id,
+                label: `${ASCII_MODE ? setting.asciiIcon : setting.icon} ${setting.label}`,
+                hint: this.persona[setting.id] ?? AUTO,
+            }));
+            const id = await this.openPicker(new Picker({ title: "settings", entries, filterable: false }));
+            if (!id)
+                break;
+            const setting = PERSONA_SETTINGS.find((entry) => entry.id === id);
+            if (!setting)
+                break;
+            const current = this.persona[setting.id] ?? AUTO;
+            const valueEntries = setting.options.map((option) => ({
+                kind: "item",
+                value: option.value,
+                label: option.value === current ? `${glyphs.check} ${option.label}` : `  ${option.label}`,
+                hint: option.description,
+            }));
+            const value = await this.openPicker(new Picker({ title: setting.label, entries: valueEntries, filterable: false }));
+            if (value === null)
+                continue;
+            if (value === AUTO)
+                delete this.persona[setting.id];
+            else
+                this.persona[setting.id] = value;
+        }
+        if (JSON.stringify(this.persona) !== before) {
+            this.config.persona = this.persona;
+            void saveConfig({ ...this.config }).catch(() => undefined);
+            this.append([
+                `  ${tone.accent(glyphs.diamond)} ${tone.mist(`// SETTINGS → ${personaSummary(this.persona)}`)}`,
+                "",
+            ]);
+        }
+    }
     async changeTheme(arg) {
         const current = activeThemeId();
         if (arg) {
@@ -2947,6 +3048,7 @@ class TuiApp {
             ["mouse drag", "select text · ctrl+c copies"],
             ["click in input", "place the cursor"],
             ["permission card", "← → select · enter confirm · mouse click"],
+            ["pickers", "↑↓ move · enter select · ← or esc back · click rows and the ← back button"],
             ["sessions picker", "ctrl+r rename · ctrl+p pin · ctrl+d delete"],
             ["↑ ↓", "input history — previous / next message"],
             ["wheel", "scroll the conversation"],
@@ -3099,6 +3201,29 @@ const IMAGE_EXTENSIONS = {
     ".bmp": "image/bmp",
 };
 const IMAGE_MARKER_RE = /\[Image (\d+)\]/g;
+/**
+ * A side-channel (/btw) request can run while a tool call is still in flight,
+ * so the transcript may end with an assistant tool_call that has no tool result
+ * yet. Providers reject such a sequence (400), so drop unanswered tool_calls.
+ */
+export function sideChannelMessages(messages) {
+    const answered = new Set();
+    for (const message of messages) {
+        if (message.role === "tool")
+            answered.add(message.toolCallId);
+    }
+    const out = [];
+    for (const message of messages) {
+        if (message.role !== "assistant" || !message.content.some((part) => part.type === "tool_call")) {
+            out.push(message);
+            continue;
+        }
+        const content = message.content.filter((part) => part.type !== "tool_call" || answered.has(part.id));
+        if (content.length > 0)
+            out.push({ ...message, content });
+    }
+    return out;
+}
 export function nextImageIndex(text) {
     const used = new Set();
     for (const match of text.matchAll(IMAGE_MARKER_RE)) {