@selesai/code 0.13.40 → 0.14.3

package/examples/extensions/jev-router.ts

@@ -0,0 +1,113 @@
+/**
+ * Jev router - a virtual model that plans on a strong model and implements on a cheap one.
+ *
+ * Registers `jev/auto`, which routes between three OpenAI Codex models:
+ *
+ * - Planning: GPT-5.6 Sol for complex work, GPT-5.6 Terra otherwise. The Jev classifier rates the
+ *   first user message; planning stays on the chosen model.
+ * - Implementation: GPT-5.6 Luna.
+ *
+ * The planning model explores, plans, and makes the first edit. After the first successful `edit`
+ * or `write` tool call, the next request of the same turn goes to Luna, and the session stays
+ * there. A session therefore switches models once and accepts a single prompt-cache miss.
+ *
+ * The phase is router state: Selesai stores it on the session branch, so it follows the session tree
+ * and survives compaction. The selected thinking level passes through as the reasoning effort of
+ * the chosen model. Requests outside the agent loop, such as compaction summaries, go to Luna.
+ *
+ * Requires TypeSafe credentials (TYPESAFE_API_KEY) and an OpenAI Codex login.
+ * Usage: selesai -e ./jev-router.ts --model jev/auto
+ */
+
+import type { Message } from "@earendil-works/pi-ai";
+import type { ExtensionAPI, ExtensionContext, ModelRoute, ModelRouteRequest } from "@selesai/code";
+
+const PROVIDER = "openai-codex";
+const SOL = "gpt-5.6-sol";
+const TERRA = "gpt-5.6-terra";
+const LUNA = "gpt-5.6-luna";
+
+/** Tools whose successful result means implementation has started. */
+const EDIT_TOOLS = new Set(["edit", "write"]);
+
+interface JevState {
+	phase: "planning" | "implementation";
+	/** OpenAI Codex model for this phase. */
+	model: string;
+}
+
+type JevRequest = ModelRouteRequest<JevState>;
+
+function routeTo(request: JevRequest, ctx: ExtensionContext, id: string, state?: JevState): ModelRoute<JevState> {
+	const model = ctx.modelRegistry.find(PROVIDER, id);
+	if (!model) throw new Error(`Model ${PROVIDER}/${id} is not in the catalog`);
+	return { model, thinkingLevel: request.thinkingLevel, state };
+}
+
+function lastUserText(messages: readonly Message[]): string {
+	const content = messages.filter((message) => message.role === "user").at(-1)?.content ?? "";
+	if (typeof content === "string") return content;
+	return content.flatMap((block) => (block.type === "text" ? [block.text] : [])).join("\n");
+}
+
+/** Whether a tool call since the last user message edited a file successfully. */
+function editedThisTurn(messages: readonly Message[]): boolean {
+	const lastUser = messages.findLastIndex((message) => message.role === "user");
+	return messages
+		.slice(lastUser + 1)
+		.some((message) => message.role === "toolResult" && EDIT_TOOLS.has(message.toolName) && !message.isError);
+}
+
+/** Planning model for a new session: Sol for complex work, Terra otherwise or when Jev is unavailable. */
+async function choosePlanningModel(request: JevRequest, ctx: ExtensionContext): Promise<string> {
+	// Keep a planning model the session already uses, so switching to jev/auto costs no cache miss.
+	const previous = request.previous?.model;
+	if (previous?.provider === PROVIDER && (previous.id === SOL || previous.id === TERRA)) return previous.id;
+
+	const jev = ctx.modelRegistry.findOfType("classifier", "typesafe", "jev-latest");
+	if (!jev) return TERRA;
+	const result = await ctx.modelRegistry.classify(
+		jev,
+		{
+			state: { prompt: lastUserText(request.messages).slice(0, 16_000) },
+			questions: {
+				complexity: {
+					type: "choice",
+					instructions: "How demanding is the software engineering work requested in `prompt`?",
+					criteria: {
+						standard: "Ordinary features, fixes, reviews, or questions",
+						complex: "Subtle design, cross-cutting changes, or hard debugging",
+					},
+				},
+			},
+		},
+		{ signal: request.signal },
+	);
+	const answer = result.stopReason === "stop" ? result.answers.complexity : undefined;
+	return answer?.type === "choice" && (answer.probabilities.complex ?? 0) >= 0.5 ? SOL : TERRA;
+}
+
+export default function (pi: ExtensionAPI) {
+	pi.registerVirtualModel<JevState>({
+		provider: "jev",
+		id: "auto",
+		name: "Auto (Jev)",
+		thinkingLevels: ["low", "medium", "high", "xhigh"],
+		// Shared by all three models; shown before the first response.
+		contextWindow: 272_000,
+		maxTokens: 128_000,
+		async route(request, ctx) {
+			if (request.reason === "direct") return routeTo(request, ctx, LUNA);
+			const state = request.state;
+			if (!state) {
+				const model = await choosePlanningModel(request, ctx);
+				return routeTo(request, ctx, model, { phase: "planning", model });
+			}
+			// The planning model made the first edit: hand the rest of the work to Luna.
+			if (state.phase === "planning" && editedThisTurn(request.messages)) {
+				return routeTo(request, ctx, LUNA, { phase: "implementation", model: LUNA });
+			}
+			return routeTo(request, ctx, state.model);
+		},
+	});
+}

package/examples/extensions/tokenin-usage-widget.ts

@@ -0,0 +1,124 @@
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+const WIDGET_KEY = "tokenin-usage";
+const REFRESH_MS = 60_000;
+const DEFAULT_BASE_URL = "https://lite.andlet.me/v1";
+
+type Balance = {
+	available_usd: number;
+	fixed_available_usd?: number;
+	payg_available_usd?: number;
+	debt_usd?: number;
+};
+
+type LegacyUsage = {
+	spend: number;
+	max_budget?: number;
+};
+
+function proxyRoot(baseUrl: string): string {
+	return baseUrl.replace(/\/+$/, "").replace(/\/v1$/, "");
+}
+
+function money(value: number): string {
+	return `$${value.toFixed(2)}`;
+}
+
+async function requestJson(url: string, apiKey: string): Promise<{ status: number; body?: unknown }> {
+	const response = await fetch(url, {
+		headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+		signal: AbortSignal.timeout(5_000),
+	});
+	let body: unknown;
+	try {
+		body = await response.json();
+	} catch {
+		// The status still lets the caller distinguish a missing balance route.
+	}
+	return { status: response.status, body };
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+	return !!value && typeof value === "object" && !Array.isArray(value);
+}
+
+function readNumber(record: Record<string, unknown>, key: string): number | undefined {
+	const value = record[key];
+	return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+
+async function getUsageLines(ctx: ExtensionContext): Promise<string[]> {
+	const resolved = await ctx.modelRegistry.getProviderAuth("tokenin");
+	const apiKey = resolved?.auth.apiKey;
+	if (!apiKey) return ["Token-In: not connected (run /tokenin add)"];
+
+	const provider = ctx.modelRegistry.getProvider("tokenin");
+	const baseUrl = resolved.auth.baseUrl ?? provider?.baseUrl ?? DEFAULT_BASE_URL;
+	const root = proxyRoot(baseUrl);
+	const balanceResponse = await requestJson(`${root}/tokenin/account/me/balance`, apiKey);
+
+	if (balanceResponse.status >= 200 && balanceResponse.status < 300 && isRecord(balanceResponse.body)) {
+		const available = readNumber(balanceResponse.body, "available_usd");
+		if (available !== undefined) {
+			const balance: Balance = {
+				available_usd: available,
+				fixed_available_usd: readNumber(balanceResponse.body, "fixed_available_usd"),
+				payg_available_usd: readNumber(balanceResponse.body, "payg_available_usd"),
+				debt_usd: readNumber(balanceResponse.body, "debt_usd"),
+			};
+			const debt = balance.debt_usd && balance.debt_usd > 0 ? ` · debt ${money(balance.debt_usd)}` : "";
+			return [
+				`Token-In available: ${money(balance.available_usd)}`,
+				`Plan ${money(balance.fixed_available_usd ?? 0)} · PAYG ${money(balance.payg_available_usd ?? 0)}${debt}`,
+			];
+		}
+	}
+
+	// Match /tokenin usage: fall back only when the account balance is absent or unusable.
+	if (balanceResponse.status !== 404 && (balanceResponse.status < 200 || balanceResponse.status >= 300)) {
+		throw new Error(`balance endpoint returned HTTP ${balanceResponse.status}`);
+	}
+
+	const usageResponse = await requestJson(`${root}/key/info`, apiKey);
+	if (usageResponse.status < 200 || usageResponse.status >= 300 || !isRecord(usageResponse.body)) {
+		throw new Error(`usage endpoint returned HTTP ${usageResponse.status}`);
+	}
+	const info = isRecord(usageResponse.body.info) ? usageResponse.body.info : usageResponse.body;
+	const spend = readNumber(info, "spend");
+	if (spend === undefined) throw new Error("usage endpoint returned an unexpected payload");
+	const usage: LegacyUsage = { spend, max_budget: readNumber(info, "max_budget") };
+	const remaining = usage.max_budget === undefined ? "no budget limit" : `${money(Math.max(0, usage.max_budget - spend))} remaining`;
+	return [`Token-In spent: ${money(spend)}`, remaining];
+}
+
+export default function tokenInUsageWidget(pi: ExtensionAPI) {
+	let timer: ReturnType<typeof setInterval> | undefined;
+	let refreshing = false;
+
+	pi.on("session_start", async (_event, ctx) => {
+		if (!ctx.hasUI) return;
+		if (timer) clearInterval(timer);
+
+		const refresh = async () => {
+			if (refreshing) return;
+			refreshing = true;
+			try {
+				ctx.ui.setWidget(WIDGET_KEY, await getUsageLines(ctx), { placement: "belowEditor" });
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				ctx.ui.setWidget(WIDGET_KEY, [`Token-In usage unavailable: ${message}`], { placement: "belowEditor" });
+			} finally {
+				refreshing = false;
+			}
+		};
+
+		await refresh();
+		timer = setInterval(() => void refresh(), REFRESH_MS);
+	});
+
+	pi.on("session_shutdown", (_event, ctx) => {
+		if (timer) clearInterval(timer);
+		timer = undefined;
+		if (ctx.hasUI) ctx.ui.setWidget(WIDGET_KEY, undefined);
+	});
+}

package/examples/rpc-client.ts

@@ -0,0 +1,35 @@
+/**
+ * Run one prompt through a Selesai RPC child process.
+ *
+ * Build the coding-agent package first, then run:
+ * node examples/rpc-client.ts "Explain this repository"
+ */
+
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { RpcClient } from "@selesai/code";
+
+const exampleDirectory = dirname(fileURLToPath(import.meta.url));
+const prompt = process.argv.slice(2).join(" ") || "Explain this repository in one paragraph.";
+
+const client = new RpcClient({
+	cliPath: join(exampleDirectory, "../dist/cli.js"),
+	args: ["--no-session"],
+});
+
+const unsubscribe = client.onEvent((event) => {
+	if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+		process.stdout.write(event.assistantMessageEvent.delta);
+	} else if (event.type === "tool_execution_start") {
+		process.stderr.write(`\n[tool: ${event.toolName}]\n`);
+	}
+});
+
+try {
+	await client.start();
+	await client.promptAndWait(prompt);
+	process.stdout.write("\n");
+} finally {
+	unsubscribe();
+	await client.stop();
+}

package/examples/sdk/14-codemode-mcp.ts

@@ -0,0 +1,67 @@
+/**
+ * Codemode, Tool Search, and MCP
+ *
+ * The CLI loads `codemode`, `tool_search`, and MCP as built-in extensions. SDK sessions add
+ * them to the resource loader's extension factories.
+ *
+ * `codemode` and `tool_search` are registered inactive. Enable them through the `defaultTools` setting
+ * (`tools` would also restrict the session to the named tools, which hides MCP tools), or let the
+ * MCP extension activate them: `codemode` for servers with `codemode` exposure, `tool_search` for
+ * servers with `deferred` exposure.
+ */
+
+import {
+	createAgentSession,
+	createCodemodeExtension,
+	createMcpExtension,
+	createToolSearchExtension,
+	DefaultResourceLoader,
+	getAgentDir,
+	SessionManager,
+	SettingsManager,
+} from "@selesai/code";
+
+const cwd = process.cwd();
+
+const resourceLoader = new DefaultResourceLoader({
+	cwd,
+	agentDir: getAgentDir(),
+	extensionFactories: [
+		createCodemodeExtension({ mode: "on" }),
+		createToolSearchExtension(),
+		// Reads mcp.json from the agent directory and the trusted project, like the CLI.
+		createMcpExtension(),
+	],
+});
+await resourceLoader.reload();
+
+const settingsManager = SettingsManager.create(cwd);
+// `+name` adds to the configured default tools instead of replacing them.
+settingsManager.applyOverrides({ defaultTools: ["+codemode", "+tool_search"] });
+
+const { session } = await createAgentSession({
+	resourceLoader,
+	settingsManager,
+	sessionManager: SessionManager.inMemory(),
+});
+
+try {
+	// Emits session_start, which connects the MCP servers in the background.
+	await session.bindExtensions({});
+	console.log("Active tools:", session.getActiveToolNames().join(", "));
+	session.subscribe((event) => {
+		if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+			process.stdout.write(event.assistantMessageEvent.delta);
+		}
+	});
+	await session.prompt("Use codemode to count the TypeScript files in src/ and list the three largest.");
+	console.log();
+} finally {
+	try {
+		// Hosts emit shutdown before disposal; dispose() itself invalidates the runtime,
+		// but does not await session_shutdown handlers that close MCP processes.
+		await session.extensionRunner.emit({ type: "session_shutdown", reason: "quit" });
+	} finally {
+		session.dispose();
+	}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selesai/code",
-  "version": "0.13.40",
+  "version": "0.14.3",
   "description": "Maintained, extension-first Pi coding agent with built-in workflows, subagents, web research, questions, skills, and an enhanced terminal UI.",
   "type": "module",
   "engines": {
@@ -55,8 +55,8 @@
     "clean": "shx rm -rf dist",
     "dev": "tsx src/cli.ts",
     "dev:print": "tsx src/cli.ts --print",
-    "test": "vitest run src/__tests__/model-registry-completion.test.ts src/extensions/jev/decisions.test.ts src/extensions/capability-gateway/routing.test.ts src/core/settings-manager-auto-handoff.test.ts src/core/remote-catalog-provider.test.ts src/extensions/jev-advisory-memory.test.ts src/extensions/jev-advisory-recommendations.test.ts src/extensions/jev-ask-tool.test.ts src/extensions/jev-advisory-lifecycle.test.ts src/extensions/undo.test.ts src/extensions/tps.test.ts src/extensions/pi-graft src/extensions/agent-browser.test.ts src/extensions/auto-session-name.test.ts src/extensions/context-compaction-reminder.test.ts src/extensions/copy-turn.test.ts src/extensions/grep-app/index.test.ts src/extensions/inline-skills.test.ts src/extensions/rtk.test.ts src/extensions/handoff-new.test.ts src/extensions/question/tests src/extensions/ponytail/test src/__tests__/tokenin-search.test.ts src/__tests__/tokenin-onboarding.test.ts src/__tests__/model-registry-defaults.test.ts src/core/system-prompt.test.ts src/core/session-format.test.ts test/settings-manager-compaction.test.ts test/suite/agent-session-runtime.test.ts test/suite/agent-session-prompt.test.ts test/suite/agent-session-queue.test.ts test/suite/agent-session-retry-events.test.ts test/suite/agent-session-compaction.test.ts test/suite/agent-session-compaction-model-overrides.test.ts test/suite/agent-session-bash-persistence.test.ts test/suite/agent-session-model-extension.test.ts test/clipboard.test.ts test/clipboard-command.test.ts test/clipboard-image.test.ts test/clipboard-image-bmp-conversion.test.ts test/clipboard-image-native-errors.test.ts src/cli/args.test.ts",
-    "test:coverage": "vitest run --coverage src/__tests__/model-registry-completion.test.ts src/extensions/jev/decisions.test.ts src/extensions/capability-gateway/routing.test.ts src/core/settings-manager-auto-handoff.test.ts src/core/remote-catalog-provider.test.ts src/extensions/jev-advisory-memory.test.ts src/extensions/jev-advisory-recommendations.test.ts src/extensions/jev-ask-tool.test.ts src/extensions/jev-advisory-lifecycle.test.ts src/extensions/undo.test.ts src/extensions/tps.test.ts src/extensions/agent-browser.test.ts src/extensions/auto-session-name.test.ts src/extensions/context-compaction-reminder.test.ts src/extensions/copy-turn.test.ts src/extensions/grep-app/index.test.ts src/extensions/inline-skills.test.ts src/extensions/rtk.test.ts src/extensions/handoff-new.test.ts src/extensions/question/tests src/extensions/ponytail/test src/__tests__/tokenin-search.test.ts src/__tests__/tokenin-onboarding.test.ts src/__tests__/model-registry-defaults.test.ts src/core/system-prompt.test.ts src/core/session-format.test.ts test/settings-manager-compaction.test.ts test/suite/agent-session-runtime.test.ts test/suite/agent-session-prompt.test.ts test/suite/agent-session-queue.test.ts test/suite/agent-session-retry-events.test.ts test/suite/agent-session-compaction.test.ts test/suite/agent-session-compaction-model-overrides.test.ts test/suite/agent-session-bash-persistence.test.ts test/suite/agent-session-model-extension.test.ts test/clipboard.test.ts test/clipboard-command.test.ts test/clipboard-image.test.ts test/clipboard-image-bmp-conversion.test.ts test/clipboard-image-native-errors.test.ts src/cli/args.test.ts",
+    "test": "vitest run src/__tests__/model-registry-completion.test.ts src/extensions/jev/decisions.test.ts test/auto-handoff-retirement.test.ts src/core/remote-catalog-provider.test.ts src/extensions/jev-advisory-memory.test.ts src/extensions/jev-advisory-recommendations.test.ts src/extensions/jev-ask-tool.test.ts src/extensions/jev-tool-ranker.test.ts src/extensions/tool-search/tool.test.ts src/extensions/jev-advisory-lifecycle.test.ts src/extensions/undo.test.ts src/extensions/tps.test.ts src/extensions/pi-graft src/extensions/agent-browser.test.ts src/extensions/auto-session-name.test.ts src/extensions/context-compaction-reminder.test.ts src/extensions/copy-turn.test.ts src/extensions/grep-app/index.test.ts src/extensions/inline-skills.test.ts src/extensions/rtk.test.ts src/extensions/handoff-new.test.ts src/extensions/question/tests src/extensions/ponytail/test src/__tests__/tokenin-search.test.ts src/__tests__/tokenin-onboarding.test.ts src/__tests__/model-registry-defaults.test.ts src/core/system-prompt.test.ts src/core/session-format.test.ts test/settings-manager-compaction.test.ts test/suite/agent-session-runtime.test.ts test/suite/agent-session-tool-orchestration.test.ts test/suite/agent-session-prompt.test.ts test/suite/agent-session-queue.test.ts test/suite/agent-session-retry-events.test.ts test/suite/agent-session-compaction.test.ts test/suite/agent-session-compaction-model-overrides.test.ts test/suite/agent-session-bash-persistence.test.ts test/suite/agent-session-model-extension.test.ts test/clipboard.test.ts test/clipboard-command.test.ts test/clipboard-image.test.ts test/clipboard-image-bmp-conversion.test.ts test/clipboard-image-native-errors.test.ts src/cli/args.test.ts test/mermaid.test.ts test/settings-manager-mermaid.test.ts test/syntax-highlight.test.ts test/rpc-prompt-response-semantics.test.ts test/rpc-client-clear-queue.test.ts test/rpc-client-process-exit.test.ts test/rpc-client-prompt-disposition.test.ts test/keybindings.test.ts test/user-message.test.ts src/extensions/jev-find-source.test.ts src/extensions/skills-index/index.test.ts test/gateway-retirement.test.ts test/config-selector-builtins.test.ts test/mcp-fork-safety.test.ts test/mcp-cli-real.test.ts test/mcp-prompt-contract.test.ts test/shell-structured-output.test.ts test/rpc-real-bridge.test.ts test/rpc-caption-handoff.test.ts test/native-runtime-packages.test.ts test/rtk-scope-lifecycle.test.ts src/extensions/jev/classifier.test.ts test/tokenin-classifier-registration.test.ts test/program-status-reporter.test.ts test/output-pad.test.ts test/mcp-manager-view.test.ts test/suite/regressions/7187-malformed-package-manifest.test.ts test/suite/regressions/7193-event-bus-lifecycle.test.ts test/suite/regressions/7209-model-selector-filter-resets-selection.test.ts test/suite/regressions/7253-manual-compact-during-response.test.ts test/suite/regressions/7269-cli-end-of-options.test.ts test/suite/regressions/7290-json-stream-linear.test.ts test/suite/regressions/7497-session-discovery-symlink.test.ts test/suite/regressions/7731-tui-method-wrapping.test.ts test/suite/regressions/7829-invalid-settings-warning.test.ts test/suite/regressions/7911-json-stream-usage.test.ts test/suite/regressions/7925-toolcall-start-metadata.test.ts test/suite/regressions/8328-zero-usage-auto-compaction.test.ts test/suite/regressions/8337-utf8-bom-parsing.test.ts test/suite/regressions/8423-extension-factory-failure.test.ts test/suite/regressions/8964-extension-provider-streaming.test.ts test/suite/regressions/8989-fork-compaction-label-boundary.test.ts test/git-update.test.ts test/skills.test.ts test/settings-diagnostics.test.ts test/auth-check.test.ts test/credential-print.test.ts src/core/agent-session-custom-tools.test.ts src/core/agent-session-length-continuation.test.ts src/core/package-manager.test.ts",
+    "test:coverage": "vitest run --coverage src/__tests__/model-registry-completion.test.ts src/extensions/jev/decisions.test.ts test/auto-handoff-retirement.test.ts src/core/remote-catalog-provider.test.ts src/extensions/jev-advisory-memory.test.ts src/extensions/jev-advisory-recommendations.test.ts src/extensions/jev-ask-tool.test.ts src/extensions/jev-tool-ranker.test.ts src/extensions/tool-search/tool.test.ts src/extensions/jev-advisory-lifecycle.test.ts src/extensions/undo.test.ts src/extensions/tps.test.ts src/extensions/pi-graft src/extensions/agent-browser.test.ts src/extensions/auto-session-name.test.ts src/extensions/context-compaction-reminder.test.ts src/extensions/copy-turn.test.ts src/extensions/grep-app/index.test.ts src/extensions/inline-skills.test.ts src/extensions/rtk.test.ts src/extensions/handoff-new.test.ts src/extensions/question/tests src/extensions/ponytail/test src/__tests__/tokenin-search.test.ts src/__tests__/tokenin-onboarding.test.ts src/__tests__/model-registry-defaults.test.ts src/core/system-prompt.test.ts src/core/session-format.test.ts test/settings-manager-compaction.test.ts test/suite/agent-session-runtime.test.ts test/suite/agent-session-tool-orchestration.test.ts test/suite/agent-session-prompt.test.ts test/suite/agent-session-queue.test.ts test/suite/agent-session-retry-events.test.ts test/suite/agent-session-compaction.test.ts test/suite/agent-session-compaction-model-overrides.test.ts test/suite/agent-session-bash-persistence.test.ts test/suite/agent-session-model-extension.test.ts test/clipboard.test.ts test/clipboard-command.test.ts test/clipboard-image.test.ts test/clipboard-image-bmp-conversion.test.ts test/clipboard-image-native-errors.test.ts src/cli/args.test.ts test/mermaid.test.ts test/settings-manager-mermaid.test.ts test/syntax-highlight.test.ts test/rpc-prompt-response-semantics.test.ts test/rpc-client-clear-queue.test.ts test/rpc-client-process-exit.test.ts test/rpc-client-prompt-disposition.test.ts test/keybindings.test.ts test/user-message.test.ts src/extensions/jev-find-source.test.ts src/extensions/skills-index/index.test.ts test/gateway-retirement.test.ts test/config-selector-builtins.test.ts test/mcp-fork-safety.test.ts test/mcp-cli-real.test.ts test/mcp-prompt-contract.test.ts test/shell-structured-output.test.ts test/rpc-real-bridge.test.ts test/rpc-caption-handoff.test.ts test/native-runtime-packages.test.ts test/rtk-scope-lifecycle.test.ts src/extensions/jev/classifier.test.ts test/tokenin-classifier-registration.test.ts test/program-status-reporter.test.ts test/output-pad.test.ts test/mcp-manager-view.test.ts test/suite/regressions/7187-malformed-package-manifest.test.ts test/suite/regressions/7193-event-bus-lifecycle.test.ts test/suite/regressions/7209-model-selector-filter-resets-selection.test.ts test/suite/regressions/7253-manual-compact-during-response.test.ts test/suite/regressions/7269-cli-end-of-options.test.ts test/suite/regressions/7290-json-stream-linear.test.ts test/suite/regressions/7497-session-discovery-symlink.test.ts test/suite/regressions/7731-tui-method-wrapping.test.ts test/suite/regressions/7829-invalid-settings-warning.test.ts test/suite/regressions/7911-json-stream-usage.test.ts test/suite/regressions/7925-toolcall-start-metadata.test.ts test/suite/regressions/8328-zero-usage-auto-compaction.test.ts test/suite/regressions/8337-utf8-bom-parsing.test.ts test/suite/regressions/8423-extension-factory-failure.test.ts test/suite/regressions/8964-extension-provider-streaming.test.ts test/suite/regressions/8989-fork-compaction-label-boundary.test.ts test/git-update.test.ts test/skills.test.ts test/settings-diagnostics.test.ts test/auth-check.test.ts test/credential-print.test.ts src/core/agent-session-custom-tools.test.ts src/core/agent-session-length-continuation.test.ts src/core/package-manager.test.ts",
     "prepare": "npm run build",
     "build:native": "bun scripts/build-native.ts",
     "build": "npm run clean && tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js dist/rpc-entry.js && npm run copy-assets",
@@ -64,18 +64,24 @@
   },
   "dependencies": {
     "@ast-grep/cli": "0.45.0",
-    "@earendil-works/pi-agent-core": "0.86.1",
-    "@earendil-works/pi-ai": "0.86.1",
-    "@earendil-works/pi-tui": "0.86.1",
+    "@earendil-works/chord": "1.1.0",
+    "@earendil-works/pi-agent-core": "1.1.0",
+    "@earendil-works/pi-ai": "1.1.0",
+    "@earendil-works/pi-codemode": "1.1.0",
+    "@earendil-works/pi-mcp": "1.1.0",
+    "@earendil-works/pi-tui": "1.1.0",
+    "@js-temporal/polyfill": "0.5.1",
     "@mozilla/readability": "^0.6.0",
     "@silvia-odwyer/photon-node": "0.3.4",
     "acorn": "8.18.0",
     "better-sqlite3": "^13.0.3",
+    "brace-expansion": "5.0.12",
     "chalk": "5.6.2",
     "cheerio": "^1.1.0",
     "cross-spawn": "7.0.6",
     "diff": "8.0.4",
     "glob": "13.0.6",
+    "grok-mermaid": "0.2.3",
     "highlight.js": "10.7.3",
     "hosted-git-info": "9.0.3",
     "ignore": "7.0.5",
@@ -84,6 +90,7 @@
     "minimatch": "10.2.5",
     "playwright": "^1.60.0",
     "proper-lockfile": "4.1.2",
+    "quickjs-wasi": "3.6.2",
     "semver": "7.8.0",
     "strip-ansi": "7.2.0",
     "tsx": "^4.20.0",
@@ -103,8 +110,8 @@
     "@types/semver": "7.7.1",
     "@typescript/native-preview": "^7.0.0-dev.20260120.1",
     "@vitest/coverage-v8": "4.1.9",
-    "shx": "0.4.0",
-    "typescript": "5.9.3",
+    "shx": "0.3.4",
+    "typescript": "7.0.2",
     "vitest": "4.1.9"
   },
   "overrides": {

package/dist/core/agent-session-auto-handoff.test.js

@@ -1,195 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { Type } from "typebox";
-import { AgentSession } from "./agent-session.js";
-import { AUTO_HANDOFF_GOAL } from "./handoff.js";
-import { SessionManager } from "./session-manager.js";
-import { SettingsManager } from "./settings-manager.js";
-function createMockSession({ enabled, threshold = 128_000, tokens, mode = "tui", command, customTools, allowedToolNames, }) {
-    const settings = SettingsManager.inMemory({
-        autoHandoff: { enabled, thresholdTokens: threshold },
-    });
-    const getCommand = vi.fn(() => command);
-    const handler = command?.handler ?? vi.fn();
-    const createCommandContext = vi.fn(() => ({ mock: "ctx" }));
-    const emitError = vi.fn();
-    const extensionRunner = {
-        getCommand,
-        createCommandContext,
-        emitError,
-        emit: vi.fn(),
-    };
-    const resourceLoader = {
-        getExtensions: () => ({ extensions: [], errors: [], runtime: { flagValues: new Map(), pendingProviderRegistrations: [], pendingNativeProviderRegistrations: [], assertActive: () => { } } }),
-        getSkills: () => ({ skills: [], diagnostics: [] }),
-        getPromptSkills: () => [],
-        setSkillsIndexFilter: () => { },
-        getPrompts: () => ({ prompts: [], diagnostics: [] }),
-        getThemes: () => ({ themes: [], diagnostics: [] }),
-        getAgents: () => ({ agents: [], diagnostics: [] }),
-        getAgentsFiles: () => ({ agentsFiles: [] }),
-        getSystemPrompt: () => undefined,
-        getAppendSystemPrompt: () => [],
-        getExtensionDiagnostics: () => [],
-        extendResources: () => { },
-        reload: vi.fn(),
-    };
-    const modelRegistry = {
-        registerProvider: vi.fn(),
-        unregisterProvider: vi.fn(),
-        getProvider: vi.fn(),
-        getProviders: vi.fn(() => []),
-        getModels: vi.fn(() => []),
-    };
-    const agent = {
-        state: { messages: [], tools: [] },
-        subscribe: vi.fn(() => () => { }),
-    };
-    const session = new AgentSession({
-        agent: agent,
-        sessionManager: SessionManager.inMemory(),
-        settingsManager: settings,
-        cwd: "/tmp",
-        resourceLoader: resourceLoader,
-        customTools,
-        modelRuntime: modelRegistry,
-        allowedToolNames,
-    });
-    session._extensionRunner = extensionRunner;
-    session._extensionMode = mode;
-    session.getContextUsage = () => tokens === null ? null : { tokens, contextWindow: 200_000, percent: tokens / 200_000 };
-    return { session, getCommand, createCommandContext, handler, emitError, settings };
-}
-describe("AgentSession tools", () => {
-    const customTool = {
-        name: "custom",
-        label: "Custom",
-        description: "A custom tool",
-        parameters: Type.Object({}),
-        execute: async () => ({ content: [{ type: "text", text: "ok" }], details: undefined }),
-    };
-    it("keeps custom tools inactive by default but activates explicitly allowed ones", () => {
-        const defaults = createMockSession({ enabled: false, tokens: null, customTools: [customTool] });
-        expect(defaults.session.getActiveToolNames()).not.toContain("custom");
-        const allowed = createMockSession({
-            enabled: false,
-            tokens: null,
-            customTools: [customTool],
-            allowedToolNames: ["custom"],
-        });
-        expect(allowed.session.getActiveToolNames()).toEqual(["custom"]);
-    });
-});
-describe("AgentSession auto handoff", () => {
-    it("uses a goal that preserves the overall objective and continuation details", () => {
-        expect(AUTO_HANDOFF_GOAL).toMatch(/overall objective/i);
-        expect(AUTO_HANDOFF_GOAL).toMatch(/next concrete action/i);
-        expect(AUTO_HANDOFF_GOAL).toMatch(/reference files/i);
-    });
-    it("invokes handoff-new once when enabled and threshold reached in tui mode", async () => {
-        const command = { handler: vi.fn() };
-        const { session, getCommand, createCommandContext, emitError } = createMockSession({
-            enabled: true,
-            tokens: 128_000,
-            command,
-        });
-        await session._checkAutoHandoff();
-        await session._checkAutoHandoff();
-        expect(getCommand).toHaveBeenCalledWith("handoff-new");
-        expect(createCommandContext).toHaveBeenCalled();
-        expect(command.handler).toHaveBeenCalledTimes(1);
-        expect(command.handler).toHaveBeenCalledWith(AUTO_HANDOFF_GOAL, expect.anything());
-        expect(emitError).not.toHaveBeenCalled();
-    });
-    it("dispatches auto handoff via _emitAgentSettled in tui mode", async () => {
-        const command = { handler: vi.fn() };
-        const { session } = createMockSession({ enabled: true, tokens: 200_000, command });
-        const events = [];
-        session.subscribe((event) => {
-            if (event.type === "agent_settled")
-                events.push(event.type);
-        });
-        await session._emitAgentSettled();
-        expect(events).toEqual(["agent_settled"]);
-        expect(command.handler).toHaveBeenCalledTimes(1);
-    });
-    it("_emitAgentSettled does not auto-handoff in non-tui mode", async () => {
-        const command = { handler: vi.fn() };
-        const { session } = createMockSession({
-            enabled: true,
-            tokens: 200_000,
-            mode: "print",
-            command,
-        });
-        const events = [];
-        session.subscribe((event) => {
-            if (event.type === "agent_settled")
-                events.push(event.type);
-        });
-        await session._emitAgentSettled();
-        expect(events).toEqual(["agent_settled"]);
-        expect(command.handler).not.toHaveBeenCalled();
-    });
-    it("does nothing when disabled", async () => {
-        const command = { handler: vi.fn() };
-        const { session, getCommand } = createMockSession({ enabled: false, tokens: 200_000, command });
-        await session._checkAutoHandoff();
-        expect(getCommand).not.toHaveBeenCalled();
-    });
-    it("does nothing when tokens are below threshold", async () => {
-        const command = { handler: vi.fn() };
-        const { session, getCommand } = createMockSession({ enabled: true, tokens: 127_999, command });
-        await session._checkAutoHandoff();
-        expect(getCommand).not.toHaveBeenCalled();
-    });
-    it("does nothing when tokens are null", async () => {
-        const command = { handler: vi.fn() };
-        const { session, getCommand } = createMockSession({ enabled: true, tokens: null, command });
-        await session._checkAutoHandoff();
-        expect(getCommand).not.toHaveBeenCalled();
-    });
-    it("does nothing in non-tui mode", async () => {
-        const command = { handler: vi.fn() };
-        const { session, getCommand } = createMockSession({
-            enabled: true,
-            tokens: 200_000,
-            mode: "rpc",
-            command,
-        });
-        await session._checkAutoHandoff();
-        expect(getCommand).not.toHaveBeenCalled();
-    });
-    it("does nothing when handoff-new command is not registered", async () => {
-        const { session, getCommand } = createMockSession({ enabled: true, tokens: 200_000, command: undefined });
-        await session._checkAutoHandoff();
-        expect(getCommand).toHaveBeenCalledWith("handoff-new");
-    });
-    it("emits an error and retries on the next check when handoff-new fails", async () => {
-        const command = {
-            handler: vi.fn(() => Promise.reject(new Error("boom"))),
-        };
-        const { session, emitError } = createMockSession({ enabled: true, tokens: 200_000, command });
-        await expect(session._checkAutoHandoff()).resolves.toBeUndefined();
-        await expect(session._checkAutoHandoff()).resolves.toBeUndefined();
-        expect(command.handler).toHaveBeenCalledTimes(2);
-        expect(emitError).toHaveBeenCalledTimes(2);
-        expect(emitError).toHaveBeenLastCalledWith({
-            extensionPath: "command:handoff-new",
-            event: "auto-handoff",
-            error: "boom",
-        });
-    });
-    it("resets triggered flag when tokens drop below threshold", async () => {
-        const command = { handler: vi.fn() };
-        const { session, getCommand } = createMockSession({ enabled: true, tokens: 200_000, command });
-        await session._checkAutoHandoff();
-        expect(command.handler).toHaveBeenCalledTimes(1);
-        // Simulate tokens dropping below threshold (e.g. compaction/new session)
-        session.getContextUsage = () => ({ tokens: 1000, contextWindow: 200_000, percent: 0.5 });
-        await session._checkAutoHandoff();
-        expect(command.handler).toHaveBeenCalledTimes(1); // still once
-        // Tokens rise above threshold again
-        session.getContextUsage = () => ({ tokens: 200_000, contextWindow: 200_000, percent: 100 });
-        await session._checkAutoHandoff();
-        expect(command.handler).toHaveBeenCalledTimes(2);
-    });
-});

package/dist/core/built-in-extensions.d.ts

@@ -1,2 +0,0 @@
-import type { InlineExtension } from "./extensions/types.ts";
-export declare const builtInExtensions: InlineExtension[];

package/dist/core/built-in-extensions.js

@@ -1,2 +0,0 @@
-import llamaExtension from "./llama/index.js";
-export const builtInExtensions = [{ name: "llama.cpp", factory: llamaExtension, hidden: true }];