agent-from-zero 0.35.2 → 0.35.4

package/dist/skills.js

@@ -1,7 +1,7 @@
 import fs from "node:fs"; // discover and read SKILL.md files
 import os from "node:os"; // the global skills dir
 import path from "node:path"; // path resolution
-import { CONFIG } from "./config.js"; // the context window sizes the listing budget
+import { CONFIG, saveGlobalSetting } from "./config.js"; // the listing budget + /skills on/off choices
 import { registerExternalTool, tools, unregisterExternalTool } from "./tools.js"; // a skill is exposed to the model as a tool
 // Project skills win over global ones with the same name.
 function skillDirs() {
@@ -37,6 +37,7 @@ export function parseSkill(raw, fallbackName, filePath = "") {
             .filter(Boolean),
         disableModelInvocation: /^true$/i.test(fm.disableModelInvocation || fm["disable-model-invocation"] || ""),
         argumentHint: fm["argument-hint"] || "",
+        argNames: (fm.arguments || "").replace(/^\[|\]$/g, "").split(/[\s,]+/).map((a) => a.replace(/^["']|["']$/g, "")).filter(Boolean), // "a, b" or "[a, b]"
         body,
         path: filePath,
         dir: filePath ? path.dirname(filePath) : "",
@@ -100,19 +101,111 @@ function fingerprint(dirs) {
     }
     return parts.join("|");
 }
-// The live skill set: reloaded from disk only when a SKILL.md was added,
-// edited, or removed since the last call. `dirs` is injectable for tests.
-export function currentSkills(dirs = skillDirs()) {
+// Every skill on disk, whatever its /skills setting: reloaded only when a
+// SKILL.md was added, edited, or removed since the last call. `dirs` is
+// injectable for tests. The /skills panel lists these.
+export function allSkills(dirs = skillDirs()) {
     const key = dirs.join("\n");
     const fp = fingerprint(dirs);
     if (!cache || cache.key !== key || cache.fingerprint !== fp)
         cache = { key, fingerprint: fp, skills: loadSkills(dirs) };
     return cache.skills;
 }
+// The skills in effect — what the listing, the skill tool and /skill see.
+// The /skills choices apply here: "off" skills vanish entirely, "user-only"
+// ones stay runnable by the user but are hidden from the model.
+export function currentSkills(dirs = skillDirs()) {
+    return allSkills(dirs)
+        .filter((s) => skillMode(s) !== "off")
+        .map((s) => (skillMode(s) === "user-only" && !s.disableModelInvocation ? { ...s, disableModelInvocation: true } : s));
+}
+export const skillLocked = (s) => s.disableModelInvocation;
+export function skillMode(s) {
+    if (skillLocked(s))
+        return "user-only";
+    return CONFIG.skillOverrides[s.name] ?? "on";
+}
+// Enter/space in the panel: on → user-only → off → on.
+export const nextSkillMode = (m) => (m === "on" ? "user-only" : m === "user-only" ? "off" : "on");
+// Apply and persist a choice. "on" is the default, so it removes the entry
+// rather than storing it — the settings file only lists exceptions.
+export function setSkillMode(name, mode, persist = true) {
+    const next = { ...CONFIG.skillOverrides };
+    if (mode === "on")
+        delete next[name];
+    else
+        next[name] = mode;
+    CONFIG.skillOverrides = next;
+    if (persist)
+        saveGlobalSetting("skillOverrides", next);
+}
+// One panel row's facts: where it lives and what it costs the model to know
+// about it (its listing line, ~4 bytes per token — the same estimate as context.ts).
+export function skillSource(s) {
+    return s.path.startsWith(path.resolve(".mini-agent", "skills")) ? "project" : "user";
+}
+export const skillListingTokens = (s) => Math.ceil(Buffer.byteLength(listingEntry(s)) / 4);
+export const nextSkillSort = (s) => (s === "name" ? "tokens" : s === "tokens" ? "source" : "name");
+// The panel's list: filtered by the search box, sorted.
+// Matching is about the NAME: any part of it ("pul" finds co_dev_pulse). The
+// description only counts for a real word — 3+ characters that start one of
+// its words ("standup", "pulse") — and those rows come after the name matches.
+// A plain substring over descriptions matched everything: a single "a" is in
+// almost every sentence.
+export function skillPanelRows(skills, query, sort) {
+    const q = query.trim().toLowerCase();
+    const byName = (a, b) => a.name.localeCompare(b.name);
+    const order = (rows) => sort === "tokens" ? rows.sort((a, b) => skillListingTokens(b) - skillListingTokens(a) || byName(a, b))
+        : sort === "source" ? rows.sort((a, b) => skillSource(a).localeCompare(skillSource(b)) || byName(a, b))
+            : rows.sort(byName);
+    if (!q)
+        return order([...skills]);
+    const inName = skills.filter((s) => s.name.toLowerCase().includes(q));
+    const inWords = q.length >= 3 ? skills.filter((s) => !inName.includes(s) && s.description.toLowerCase().split(/[^a-z0-9]+/).some((w) => w.startsWith(q))) : [];
+    return [...order(inName), ...order(inWords)];
+}
 export function findSkill(skills, name) {
     const n = name.trim().replace(/^\//, "").toLowerCase(); // "/deploy" and "deploy" both work, like Claude Code
     return skills.find((s) => s.name.toLowerCase() === n);
 }
+// ---- usage: what the "/" typeahead puts first -----------------------------------------
+// Claude Code ranks a bare "/" by how much you use each skill: every run you
+// start yourself (/name or /skill name) counts, and old use fades — the score
+// halves every 7 days, never below a tenth. Kept in its own small file (not in
+// settings.json, which is for choices, not counters).
+// MINI_AGENT_SKILL_USAGE relocates it (tests point it at a scratch file).
+const usagePath = () => process.env.MINI_AGENT_SKILL_USAGE || path.join(os.homedir(), ".config", "mini-agent", "skill-usage.json");
+function readUsage() {
+    try {
+        return JSON.parse(fs.readFileSync(usagePath(), "utf8"));
+    }
+    catch {
+        return {}; // none yet, or unreadable — ranking just falls back to groups + names
+    }
+}
+export function recordSkillUsage(name, now = Date.now()) {
+    const usage = readUsage();
+    usage[name] = { usageCount: (usage[name]?.usageCount ?? 0) + 1, lastUsedAt: now };
+    try {
+        fs.mkdirSync(path.dirname(usagePath()), { recursive: true });
+        fs.writeFileSync(usagePath(), JSON.stringify(usage, null, 2) + "\n");
+    }
+    catch {
+        /* a counter is never worth failing a skill run over */
+    }
+}
+// One read of the usage file, scored per name — for the typeahead, which asks about every skill per keystroke.
+export function skillUsageScores(now = Date.now()) {
+    const usage = readUsage();
+    return (name) => skillUsageScore(name, now, usage);
+}
+export function skillUsageScore(name, now = Date.now(), usage = readUsage()) {
+    const u = usage[name];
+    if (!u)
+        return 0;
+    const days = (now - u.lastUsedAt) / 86_400_000;
+    return u.usageCount * Math.max(0.5 ** (days / 7), 0.1);
+}
 // ---- the listing, as a <system-reminder> ------------------------------------------
 export const wrapInSystemReminder = (content) => `<system-reminder>\n${content}\n</system-reminder>`;
 const LISTING_HEADER = "The following skills are available for use with the skill tool:"; // Claude Code's wording, our tool name

package/dist/title.js

@@ -1,3 +1,4 @@
+import { currentSession, nameFromTitle, nameIsPinned, setSessionInfo } from "./peers.js"; // the session name goes on the tab; the title goes to /peers
 // One cheap model call that turns the user's first prompt into a short,
 // pickable session name — the same idea Claude Code uses (a Haiku-tier call
 // producing a 3-7 word sentence-case title, stored as the session's aiTitle).
@@ -18,10 +19,49 @@ export function terminalTitleSequence(title) {
 }
 // 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.
+//
+// With peer sessions the tab must tell windows apart, and it must match what
+// /peers lists. So: the title alone ("✳ Fix login bug" — the session name is
+// derived from it), the name before there is a title ("✳ mini-agent-2"), and
+// "name · title" only when you chose the name yourself with /rename.
+let lastTitle; // remembered so a rename (or the end of a flash) can redraw it
+let flashing = null;
+export function tabTitle(title, name = currentSession()?.name, pinned = nameIsPinned()) {
+    if (title)
+        return `${TAB_PREFIX}${pinned && name ? `${name} · ` : ""}${title}`;
+    return name ? `${TAB_PREFIX}${name}` : "mini-agent";
+}
 export function setTerminalTitle(title) {
+    lastTitle = title;
+    nameFromTitle(title); // the session is called what it's doing (unless you named it)
+    setSessionInfo({ title: title ?? "" }); // other sessions' /peers show it too
+    if (!process.stdout.isTTY || flashing)
+        return;
+    process.stdout.write(terminalTitleSequence(tabTitle(title)));
+}
+export const refreshTerminalTitle = () => setTerminalTitle(lastTitle);
+// "Which window is this?" — another session asked. Ring the bell and blink the
+// tab title for a few seconds, then put the real title back.
+export function flashTerminalTitle(ms = 6000) {
     if (!process.stdout.isTTY)
         return;
-    process.stdout.write(terminalTitleSequence(title ? `${TAB_PREFIX}${title}` : "mini-agent"));
+    process.stdout.write("\x07");
+    const name = currentSession()?.name ?? "mini-agent";
+    let on = false;
+    if (flashing)
+        clearInterval(flashing);
+    const stopAt = Date.now() + ms;
+    flashing = setInterval(() => {
+        on = !on;
+        if (Date.now() >= stopAt) {
+            clearInterval(flashing);
+            flashing = null;
+            process.stdout.write(terminalTitleSequence(tabTitle(lastTitle)));
+            return;
+        }
+        process.stdout.write(terminalTitleSequence(on ? `👋 ${name} — HERE 👋` : tabTitle(lastTitle)));
+    }, 500);
+    flashing.unref();
 }
 // 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

package/dist/ui.js

@@ -117,6 +117,21 @@ export function spinnerText(word, elapsedSec, subAgent, tokens, thinking) {
     bits.push("Ctrl+C to interrupt");
     return `${head}… ${chalk.dim(`(${bits.join(" · ")})`)}`;
 }
+// The compaction progress bar, Claude Code's look:
+//   Compacting conversation…
+//   ▰▰▰▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱ 8%
+// The two lines travel as ONE status text (a spinner carries one string); the
+// Ink spinner draws the part after the newline under the verb, ora prints it as
+// a second line. ▰/▱ are single-width everywhere, so the bar never jitters.
+export function progressBar(pct, width = 40) {
+    const p = Math.max(0, Math.min(100, Math.floor(pct)));
+    const filled = Math.round((p / 100) * width);
+    return chalk.white("▰".repeat(filled)) + chalk.dim("▱".repeat(width - filled)) + chalk.dim(` ${p}%`);
+}
+export const COMPACTING_VERB = "Compacting conversation…";
+export function compactingText(pct, columns = process.stdout.columns || 80) {
+    return `${COMPACTING_VERB}\n${progressBar(pct, Math.max(10, Math.min(40, columns - 10)))}`;
+}
 // The persistent status line — model, project, branch, context use, spend, time.
 // Pure (dir + branch passed in) so it's testable without a filesystem or git.
 export function statusLine(model, dir, branch, ctxPct, costUsd, elapsedMs) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-from-zero",
-  "version": "0.35.2",
+  "version": "0.35.4",
   "type": "module",
   "bin": {
     "mini-agent": "dist/agent.js"
@@ -17,7 +17,7 @@
     "auto:report": "tsx eval/auto-report.ts",
     "build": "tsc -p tsconfig.build.json",
     "prepare": "npm run build",
-    "test": "export MINI_AGENT_REVIEW_DEBUG=0 && tsx tests/tools.test.ts && tsx tests/permissions.test.ts && tsx tests/context.test.ts && tsx tests/hooks.test.ts && tsx tests/mcp.test.ts && tsx tests/judge.test.ts && tsx tests/auto.test.ts && tsx tests/auto-context.test.ts && tsx tests/auto-providers.test.ts && tsx tests/auto-cascade.test.ts && tsx tests/auto-rules.test.ts && tsx tests/auto-rule-cascade.test.ts && tsx tests/auto-debug.test.ts && tsx tests/auto-report.test.ts && tsx tests/auto-clarification.test.ts && tsx tests/memory.test.ts && tsx tests/cost.test.ts && tsx tests/cli.test.ts && tsx tests/print.test.ts && tsx tests/status.test.ts && tsx tests/validate.test.ts && tsx tests/plan.test.ts && tsx tests/diff.test.ts && tsx tests/undo.test.ts && tsx tests/tiering.test.ts && tsx tests/mcp-http.test.ts && tsx tests/mcp-oauth.test.ts && tsx tests/changes.test.ts && tsx tests/mentions.test.ts && tsx tests/session.test.ts && tsx tests/title.test.ts && tsx tests/ui.test.ts && tsx tests/activity.test.ts && tsx tests/follow-up.test.ts && tsx tests/follow-up-ui.test.tsx && tsx tests/agents.test.ts && tsx tests/images.test.ts && tsx tests/approval.test.ts && tsx tests/form.test.ts && tsx tests/model.test.ts && tsx tests/reasoning.test.ts && tsx tests/effort.test.ts && tsx tests/completion.test.ts && tsx tests/pasted-text.test.ts && tsx tests/skills.test.ts && tsx tests/markdown.test.ts && tsx tests/editor.test.ts && tsx tests/todos.test.ts && tsx tests/background.test.ts && tsx tests/team.test.ts && tsx tests/board.test.ts && tsx tests/drop.test.ts && tsx tests/editline.test.ts && tsx tests/cron.test.ts"
+    "test": "export MINI_AGENT_REVIEW_DEBUG=0 && tsx tests/tools.test.ts && tsx tests/permissions.test.ts && tsx tests/context.test.ts && tsx tests/hooks.test.ts && tsx tests/mcp.test.ts && tsx tests/judge.test.ts && tsx tests/auto.test.ts && tsx tests/auto-context.test.ts && tsx tests/auto-providers.test.ts && tsx tests/auto-cascade.test.ts && tsx tests/auto-rules.test.ts && tsx tests/auto-rule-cascade.test.ts && tsx tests/auto-debug.test.ts && tsx tests/auto-report.test.ts && tsx tests/auto-clarification.test.ts && tsx tests/memory.test.ts && tsx tests/cost.test.ts && tsx tests/cli.test.ts && tsx tests/print.test.ts && tsx tests/status.test.ts && tsx tests/validate.test.ts && tsx tests/plan.test.ts && tsx tests/diff.test.ts && tsx tests/undo.test.ts && tsx tests/tiering.test.ts && tsx tests/mcp-http.test.ts && tsx tests/mcp-oauth.test.ts && tsx tests/changes.test.ts && tsx tests/mentions.test.ts && tsx tests/session.test.ts && tsx tests/title.test.ts && tsx tests/ui.test.ts && tsx tests/activity.test.ts && tsx tests/follow-up.test.ts && tsx tests/follow-up-ui.test.tsx && tsx tests/agents.test.ts && tsx tests/images.test.ts && tsx tests/approval.test.ts && tsx tests/form.test.ts && tsx tests/model.test.ts && tsx tests/reasoning.test.ts && tsx tests/effort.test.ts && tsx tests/completion.test.ts && tsx tests/pasted-text.test.ts && tsx tests/skills.test.ts && tsx tests/markdown.test.ts && tsx tests/editor.test.ts && tsx tests/todos.test.ts && tsx tests/background.test.ts && tsx tests/team.test.ts && tsx tests/peers.test.ts && tsx tests/board.test.ts && tsx tests/drop.test.ts && tsx tests/editline.test.ts && tsx tests/cron.test.ts"
   },
   "engines": {
     "node": ">=20.6"
@@ -26,6 +26,7 @@
   "dependencies": {
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
+    "fuse.js": "^7.5.0",
     "ink": "^5.2.1",
     "marked": "^15.0.12",
     "marked-terminal": "^7.3.0",