@selesai/code 0.10.1 → 0.11.0

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to `@selesai/code` will be documented in this file.
 
+## [0.11.0] - 2026-08-29
+
+### Added
+- **Auto session naming.** The new `auto-session-name` extension names the session on every user message using the currently selected model. It sends only user-message history (no tool results, assistant replies, or thinking) with a 10-token output cap and a 5-word name limit, and runs in the background so it never delays your message. Thinking is explicitly disabled via `reasoning_effort: "none"` for gateways that ignore the standard `thinking: {type:"disabled"}` field.
+- **Cost reconciliation.** The new `cost-reconcile` extension records the real billed cost reported by gateways (LiteLLM `x-litellm-response-cost` header, OpenRouter `usage.cost`/`total_cost`) as session entries; the zentui footer prefers these authoritative amounts over rate-card estimates.
+- **Tool display.** The `pi-tool-display` extension is now bundled: compact OpenCode-style tool rendering, diff visualization, output truncation, a native user message box, and the `/tool-display` command with presets.
+
+### Changed
+- **Read-only tool bootstrap.** `grep`, `find`, and `ls` are registered only when not already owned by another extension (e.g. `pi-tool-display`), so boxed renderers are no longer discarded on startup.
+- **Zentui user messages.** The user-message markdown theme now uses the `accent` color instead of `userMessageText`.
+- **Zentui cost totals.** The footer refreshes once ~12s after settle so late gateway cost reconciliation is picked up.
+- **Bundled extensions.** `pi-tool-display`'s user-owned `config.json` is excluded from the shipped package; the default `packages` list no longer installs it from git.
+
+## [0.10.2] - 2026-08-28
+
+### Added
+- **Startup brand banner.** The interactive TUI now shows an ASCII logo banner on startup, followed by boxed listings of loaded skills (grouped by category) and active tools. The banner dismisses automatically on the first user message.
+- **Skill categories.** Skills can declare a `category` frontmatter field; the startup skills box labels each skill with its category (e.g. `[design] brandkit`).
+
+### Changed
+- **`quietStartup` no longer hides the brand banner.** It now only suppresses the keybinding help and the loaded-resources listing; the logo banner always appears and is dismissed on the first user message.
+- **Theme seeding.** Bundled themes now load directly from the installed package instead of being copied into `~/.selesai/agent/themes`. Copies left by older releases are removed at startup only when they are byte-identical to the bundled files, so user-edited themes survive. This also fixes the duplicate-theme name collisions on startup.
+
 ## [0.10.1] - 2026-08-28
 
 ### Fixed

package/dist/config.d.ts

@@ -163,9 +163,11 @@ export declare function seedDefaultExtensions(agentDir: string, bundledExtension
  */
 export declare function seedDefaultSkills(agentDir: string, bundledSkillsDir?: string): string[];
 /**
- * Seed bundled built-in themes into the user's agent dir/themes.
- * Skips existing files (user edits survive). Never overwrites.
- * Returns the list of destination paths that were written.
+ * Bundled themes load directly from the installed package via
+ * additionalThemePaths. Do not copy them into the user's agent dir, otherwise
+ * startup discovers both copies and every theme reports a name collision.
+ * Remove files copied by older releases only when they are byte-identical to
+ * bundled files, so user-edited themes survive.
  */
 export declare function seedDefaultThemes(agentDir: string, bundledThemesDir?: string): string[];
 /**

package/dist/config.js

@@ -761,12 +761,14 @@ export function seedDefaultSkills(agentDir, bundledSkillsDir = getBundledSkillsD
     return seedBundledDir(join(agentDir, "skills"), bundledSkillsDir);
 }
 /**
- * Seed bundled built-in themes into the user's agent dir/themes.
- * Skips existing files (user edits survive). Never overwrites.
- * Returns the list of destination paths that were written.
+ * Bundled themes load directly from the installed package via
+ * additionalThemePaths. Do not copy them into the user's agent dir, otherwise
+ * startup discovers both copies and every theme reports a name collision.
+ * Remove files copied by older releases only when they are byte-identical to
+ * bundled files, so user-edited themes survive.
  */
 export function seedDefaultThemes(agentDir, bundledThemesDir = getBundledThemesDir()) {
-    return seedBundledDir(join(agentDir, "themes"), bundledThemesDir);
+    return removeIdenticalBundledFiles(join(agentDir, "themes"), bundledThemesDir);
 }
 /**
  * Run bootstrap for the agent dir: ensure directories, seed a missing

package/dist/core/skills.d.ts

@@ -3,12 +3,14 @@ import { type SourceInfo } from "./source-info.ts";
 export interface SkillFrontmatter {
     name?: string;
     description?: string;
+    category?: string;
     "disable-model-invocation"?: boolean;
     [key: string]: unknown;
 }
 export interface Skill {
     name: string;
     description: string;
+    category?: string;
     filePath: string;
     baseDir: string;
     sourceInfo: SourceInfo;

package/dist/core/skills.js

@@ -232,6 +232,7 @@ function loadSkillFromFile(filePath, source) {
             skill: {
                 name,
                 description: frontmatter.description,
+                category: frontmatter.category?.trim() || undefined,
                 filePath,
                 baseDir: skillDir,
                 sourceInfo: createSkillSourceInfo(filePath, skillDir, source),

package/dist/defaults/settings.json

@@ -23,9 +23,6 @@
     "imageCaptionModel": "tokenin/qwen3.8-27b",
     "imageCaptionContextTokens": 16384
   },
-  "packages": [
-    "git:github.com/MasuRii/pi-tool-display"
-  ],
   "quietStartup": true,
   "retry": {
     "enabled": true,

package/dist/extensions/auto-session-name.test.ts

@@ -0,0 +1,157 @@
+import { describe, expect, it, vi } from "vitest";
+import type { ExtensionAPI, ExtensionContext, SessionEntry } from "@selesai/code";
+import autoSessionNameExtension, {
+	MAX_MESSAGE_CHARS,
+	MAX_NAME_WORDS,
+	MAX_PREVIOUS_MESSAGES,
+	NAMING_MAX_TOKENS,
+	NAMING_SYSTEM_PROMPT,
+	previousUserMessages,
+} from "./auto-session-name.ts";
+
+vi.mock("@earendil-works/pi-ai/compat", async (importOriginal) => {
+	const actual = await importOriginal<typeof import("@earendil-works/pi-ai/compat")>();
+	return {
+		...actual,
+		complete: vi.fn(),
+	};
+});
+
+import { complete } from "@earendil-works/pi-ai/compat";
+const completeMock = vi.mocked(complete);
+
+type Handler = (event: unknown, ctx: ExtensionContext) => void | Promise<void>;
+
+function userEntry(text: string, id: string): SessionEntry {
+	return {
+		id,
+		type: "message",
+		message: { role: "user", content: [{ type: "text", text }], timestamp: 100 },
+		parentId: "root",
+		timestamp: "2025-01-01T00:00:00.000Z",
+	} as unknown as SessionEntry;
+}
+
+function createHarness(branch: SessionEntry[] = []) {
+	const handlers = new Map<string, Handler>();
+	const setSessionName = vi.fn();
+	const pi = {
+		on: vi.fn((event: string, handler: Handler) => handlers.set(event, handler)),
+		setSessionName,
+	} as unknown as ExtensionAPI;
+	const model = { provider: "openai", id: "gpt-5", name: "GPT-5" };
+	const ctx = {
+		model,
+		modelRegistry: {
+			getApiKeyAndHeaders: vi.fn().mockResolvedValue({ ok: true, apiKey: "key", headers: {} }),
+		},
+		sessionManager: { getBranch: () => branch },
+	} as unknown as ExtensionContext;
+
+	autoSessionNameExtension(pi);
+	return { handlers, setSessionName, ctx };
+}
+
+function textResponse(text: string) {
+	return {
+		content: [{ type: "text", text }],
+		stopReason: "stop",
+		usage: { input: 0, output: 0 },
+	} as never;
+}
+
+describe("auto-session-name", () => {
+	beforeEach(() => {
+		vi.clearAllMocks();
+	});
+
+	it("registers an input handler", () => {
+		const { handlers } = createHarness();
+		expect(handlers.has("input")).toBe(true);
+	});
+
+	it("names the session from the user prompt with a small system prompt and 10-token cap", async () => {
+		const { handlers, setSessionName, ctx } = createHarness();
+		completeMock.mockResolvedValue(textResponse("Refactor auth"));
+
+		await handlers.get("input")!({ type: "input", text: "refactor the auth module", source: "interactive" }, ctx);
+		await vi.waitFor(() => expect(setSessionName).toHaveBeenCalledWith("Refactor auth"));
+
+		expect(completeMock).toHaveBeenCalledTimes(1);
+		const [model, context, options] = completeMock.mock.calls[0];
+		expect(model).toBe(ctx.model);
+		expect(context.systemPrompt).toBe(NAMING_SYSTEM_PROMPT);
+		expect(context.messages).toHaveLength(1);
+		expect(context.messages[0].role).toBe("user");
+		expect(context.messages[0].content).toBe("refactor the auth module");
+		expect(options?.maxTokens).toBe(NAMING_MAX_TOKENS);
+		expect(options?.samplingParams).toEqual({ reasoning_effort: "none" });
+		expect(setSessionName).toHaveBeenCalledWith("Refactor auth");
+	});
+
+	it("caps the name at 5 words even if the model returns more", async () => {
+		const { handlers, setSessionName, ctx } = createHarness();
+		completeMock.mockResolvedValue(textResponse("one two three four five six seven"));
+
+		await handlers.get("input")!({ type: "input", text: "hello", source: "interactive" }, ctx);
+		await vi.waitFor(() => expect(setSessionName).toHaveBeenCalledWith("one two three four five"));
+
+		expect(setSessionName.mock.calls[0][0].split(/\s+/)).toHaveLength(MAX_NAME_WORDS);
+	});
+
+	it("includes previous user messages (newest first) for context", async () => {
+		const branch = [userEntry("first message", "u1"), userEntry("second message", "u2")];
+		const { handlers, ctx } = createHarness(branch);
+		completeMock.mockResolvedValue(textResponse("Auth refactor"));
+
+		await handlers.get("input")!({ type: "input", text: "now fix the tests", source: "interactive" }, ctx);
+
+		const [, context] = completeMock.mock.calls[0];
+		expect(context.messages[0].content).toBe("second message\nfirst message\nnow fix the tests");
+	});
+
+	it("truncates long previous messages and caps the count", () => {
+		const long = "x".repeat(MAX_MESSAGE_CHARS + 50);
+		const branch = Array.from({ length: MAX_PREVIOUS_MESSAGES + 5 }, (_, i) =>
+			userEntry(i === MAX_PREVIOUS_MESSAGES + 4 ? long : `msg ${i}`, `u${i}`),
+		);
+		const texts = previousUserMessages({ getBranch: () => branch });
+
+		expect(texts).toHaveLength(MAX_PREVIOUS_MESSAGES);
+		expect(texts[0]).toBe(`${"x".repeat(MAX_MESSAGE_CHARS)}…`);
+		expect(texts[1]).toBe("msg 23");
+	});
+
+	it("skips extension-sourced input, commands, and empty text", async () => {
+		const { handlers, setSessionName, ctx } = createHarness();
+
+		await handlers.get("input")!({ type: "input", text: "hi", source: "extension" }, ctx);
+		await handlers.get("input")!({ type: "input", text: "/name foo", source: "interactive" }, ctx);
+		await handlers.get("input")!({ type: "input", text: "   ", source: "interactive" }, ctx);
+
+		expect(completeMock).not.toHaveBeenCalled();
+		expect(setSessionName).not.toHaveBeenCalled();
+	});
+
+	it("does not set a name when the model returns no text", async () => {
+		const { handlers, setSessionName, ctx } = createHarness();
+		completeMock.mockResolvedValue({ content: [], stopReason: "stop" } as never);
+
+		await handlers.get("input")!({ type: "input", text: "hello", source: "interactive" }, ctx);
+
+		expect(setSessionName).not.toHaveBeenCalled();
+	});
+
+	it("swallows auth and completion errors without breaking the message flow", async () => {
+		const { handlers, setSessionName, ctx } = createHarness();
+		ctx.modelRegistry.getApiKeyAndHeaders = vi.fn().mockResolvedValue({ ok: false, error: "no key" });
+		await handlers.get("input")!({ type: "input", text: "hello", source: "interactive" }, ctx);
+		expect(setSessionName).not.toHaveBeenCalled();
+
+		ctx.modelRegistry.getApiKeyAndHeaders = vi.fn().mockResolvedValue({ ok: true, apiKey: "key" });
+		completeMock.mockRejectedValue(new Error("boom"));
+		await handlers.get("input")!({ type: "input", text: "hello", source: "interactive" }, ctx);
+		await vi.waitFor(() => expect(completeMock).toHaveBeenCalled());
+		expect(setSessionName).not.toHaveBeenCalled();
+	});
+});

package/dist/extensions/auto-session-name.ts

@@ -0,0 +1,96 @@
+/**
+ * auto-session-name
+ *
+ * Names the session on every user message using the currently selected model.
+ * Sends only user messages (current prompt plus previous user messages,
+ * truncated) for context, capped at 10 output tokens (1-5 word name).
+ * Thinking is never enabled. Equivalent to running /name automatically.
+ */
+
+import { complete } from "@earendil-works/pi-ai/compat";
+import type { ExtensionAPI, SessionEntry } from "@selesai/code";
+
+export const NAMING_SYSTEM_PROMPT =
+	"Reply with only a short session name (1-5 words) for this conversation based on the user's messages. No punctuation, no quotes, no explanation.";
+
+export const NAMING_MAX_TOKENS = 10;
+/** Hard cap on the name itself: at most 5 words (≈5 tokens). */
+export const MAX_NAME_WORDS = 5;
+/** How many previous user messages to include, newest first. */
+export const MAX_PREVIOUS_MESSAGES = 20;
+/** Per-message character cap when truncating. */
+export const MAX_MESSAGE_CHARS = 200;
+
+function truncate(text: string): string {
+	return text.length > MAX_MESSAGE_CHARS ? `${text.slice(0, MAX_MESSAGE_CHARS)}…` : text;
+}
+
+/** Collect previous user message texts from the session branch, newest first, truncated. */
+export function previousUserMessages(sessionManager: { getBranch(): SessionEntry[] }): string[] {
+	const branch = sessionManager.getBranch();
+	const texts: string[] = [];
+	for (let i = branch.length - 1; i >= 0 && texts.length < MAX_PREVIOUS_MESSAGES; i--) {
+		const entry = branch[i];
+		if (entry.type !== "message" || entry.message.role !== "user") continue;
+		const content = entry.message.content;
+		const text = typeof content === "string" ? content : content
+			.filter((c): c is { type: "text"; text: string } => c.type === "text")
+			.map((c) => c.text)
+			.join("\n");
+		if (text.trim()) texts.push(truncate(text.trim()));
+	}
+	return texts;
+}
+
+export default function autoSessionNameExtension(pi: ExtensionAPI): void {
+	// Guards run synchronously; the naming call itself is fire-and-forget so it
+	// never blocks the user's message from being sent.
+	let namingSeq = 0;
+	pi.on("input", (event, ctx) => {
+		// Only real user messages; skip extension-sourced messages and commands.
+		if (event.source === "extension") return;
+		const text = event.text.trim();
+		if (!text || text.startsWith("/")) return;
+		if (!ctx.model) return;
+
+		const seq = ++namingSeq;
+		void (async () => {
+			try {
+				const auth = await ctx.modelRegistry.getApiKeyAndHeaders(ctx.model);
+				if (!auth.ok || !auth.apiKey) return;
+
+				const previous = previousUserMessages(ctx.sessionManager);
+				const conversation = [...previous, text].join("\n");
+
+				const response = await complete(
+					ctx.model,
+					{
+						systemPrompt: NAMING_SYSTEM_PROMPT,
+						messages: [{ role: "user", content: conversation, timestamp: Date.now() }],
+					},
+					{
+						apiKey: auth.apiKey,
+						headers: auth.headers,
+						maxTokens: NAMING_MAX_TOKENS,
+						cacheRetention: "none",
+						// The tokenin gateway ignores `thinking: {type:"disabled"}` and burns the
+						// whole budget on reasoning; `reasoning_effort: "none"` is what disables it.
+						samplingParams: { reasoning_effort: "none" },
+					},
+				);
+				const name = response.content
+					.filter((c): c is { type: "text"; text: string } => c.type === "text")
+					.map((c) => c.text)
+					.join("")
+					.trim()
+					.split(/\s+/)
+					.slice(0, MAX_NAME_WORDS)
+					.join(" ");
+				// Only the latest request may set the name; slower older responses lose.
+				if (name && seq === namingSeq) pi.setSessionName(name);
+			} catch {
+				// Best-effort naming; never break the user's message flow.
+			}
+		})();
+	});
+}

package/dist/extensions/cost-reconcile.test.ts

@@ -0,0 +1,76 @@
+import { describe, expect, it } from "vitest";
+import { extractCosts, parseCostHeader } from "./cost-reconcile.ts";
+
+describe("parseCostHeader", () => {
+	it("parses LiteLLM scientific-notation cost", () => {
+		expect(parseCostHeader("4.45284e-06")).toBe(4.45284e-6);
+	});
+
+	it("parses plain decimal cost", () => {
+		expect(parseCostHeader("0.00123")).toBe(0.00123);
+	});
+
+	it("rejects null, garbage, and negatives", () => {
+		expect(parseCostHeader(null)).toBeUndefined();
+		expect(parseCostHeader("abc")).toBeUndefined();
+		expect(parseCostHeader("-1")).toBeUndefined();
+	});
+});
+
+describe("extractCosts", () => {
+	it("reads OpenRouter chat-completions usage cost from a final SSE chunk", () => {
+		const body =
+			'Data: {"id":"gen-abc","provider":"OpenAI"}\n\n' +
+			'data: {"id":"gen-abc","usage":{"prompt_tokens":10,"cost":0.0123},"choices":[]}\n\n' +
+			"data: [DONE]\n\n";
+		const { ids, cost } = extractCosts(body);
+		expect(ids).toContain("gen-abc");
+		expect(cost).toBe(0.0123);
+	});
+
+	it("reads OpenRouter native total_cost from a JSON body", () => {
+		const { ids, cost } = extractCosts(
+			'{"id":"gen-xyz","total_cost":0.05152,"usage":{"total_tokens":330}}',
+		);
+		expect(ids).toEqual(["gen-xyz"]);
+		expect(cost).toBe(0.05152);
+	});
+
+	it("reads object-shaped cost {total} payloads", () => {
+		const { cost } = extractCosts('{"id":"gen-obj","cost":{"input":0.01,"total":0.0456}}');
+		expect(cost).toBe(0.0456);
+	});
+
+	it("keeps the last cost when multiple chunks carry usage", () => {
+		const body =
+			'data: {"id":"gen-1","usage":{"cost":0.01}}\n\ndata: {"id":"gen-1","usage":{"cost":0.02}}\n\n';
+		const { cost } = extractCosts(body);
+		expect(cost).toBe(0.02);
+	});
+
+	it("returns no cost when the payload has none", () => {
+		const { ids, cost } = extractCosts('data: {"id":"resp-1","delta":"hi"}\n\n');
+		expect(ids).toContain("resp-1");
+		expect(cost).toBeUndefined();
+	});
+
+	it("ignores negative or non-finite costs", () => {
+		const { cost } = extractCosts('{"id":"gen-neg","cost":-1}');
+		expect(cost).toBeUndefined();
+	});
+
+	it("extracts ids from anthropic-style message_start without cost", () => {
+		const body =
+			'event: message_start\ndata: {"type":"message_start","message":{"id":"msg_01ABC","usage":{}}}\n\n' +
+			'event: message_delta\ndata: {"type":"message_delta","usage":{"output_tokens":15}}\n\n';
+		const { ids, cost } = extractCosts(body);
+		expect(ids).toContain("msg_01ABC");
+		expect(cost).toBeUndefined();
+	});
+
+	it("caps captured ids", () => {
+		const body = Array.from({ length: 100 }, (_, i) => `{"id":"id-${i}"}`).join("\n");
+		const { ids } = extractCosts(body);
+		expect(ids.length).toBe(50);
+	});
+});