@selesai/code 0.14.0 → 0.14.3

package/dist/extensions/pi-graft/lifecycle.test.ts

@@ -85,17 +85,17 @@ afterEach(() => {
 });
 
 describe("session start", () => {
-	it("resolves the Git working tree, probes the executable, and publishes a status line", async () => {
+	it("resolves the Git working tree, probes the executable, and writes no status line", async () => {
 		const session = await bootSession();
 		expect(session.commandsRun()).toEqual(["git rev-parse --show-toplevel", "graft --version"]);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1");
+		expect(session.ctx.ui.setStatus).not.toHaveBeenCalled();
 		await session.reset();
 	});
 
 	it("does nothing at all when the extension is disabled by settings", async () => {
 		const session = await bootSession({ settings: { enabled: false } });
 		expect(session.exec).not.toHaveBeenCalled();
-		expect(session.ctx.statuses.get("graft")).toBeUndefined();
+		expect(session.ctx.ui.setStatus).not.toHaveBeenCalled();
 		await session.reset();
 	});
 
@@ -133,7 +133,9 @@ describe("session start", () => {
 		const session = await bootSession({
 			branch: [{ type: "custom", customType: MODE_ENTRY_TYPE, data: { mode: "hybrid" } }],
 		});
-		expect(session.ctx.statuses.get("graft-mode")).toBe("graft mode: hybrid");
+		const status = session.commands.get("graft")!.handler as (args: string, ctx: unknown) => Promise<void>;
+		await status("status", session.ctx);
+		expect(notified(session.ctx)).toContain("hybrid —");
 		await session.reset();
 	});
 
@@ -171,8 +173,8 @@ describe("session start", () => {
 		const ctx = makeCtx({ cwd: repo });
 		const start = handlerFor(harness, "session_start") as (e: unknown, c: unknown) => Promise<void>;
 		await start({ type: "session_start", reason: "startup" }, ctx);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
-		expect(harness.commandsRun()).toContain("npm install -g @nanonets/graft@^0.21");
+		await vi.waitFor(() => expect(harness.commandsRun()).toContain("npm install -g @nanonets/graft@^0.21"));
+		await vi.waitFor(() => expect(harness.commandsRun().filter((c) => c.includes("--version"))).toHaveLength(2));
 
 		await start({ type: "session_start", reason: "reload" }, ctx);
 		expect(harness.commandsRun().filter((command) => command.startsWith("npm install"))).toHaveLength(1);
@@ -194,7 +196,7 @@ describe("session start", () => {
 			ctx,
 		);
 		await vi.waitFor(() => expect(notified(ctx)).toContain("npm access denied"));
-		expect(ctx.statuses.get("graft")).toBe("graft: ✕ no cli");
+		expect(ctx.ui.setStatus).not.toHaveBeenCalled();
 	});
 
 	it("reports that Graft needs a Git working tree without probing anything else", async () => {
@@ -210,7 +212,7 @@ describe("session start", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		expect(ctx.statuses.get("graft")).toBe("graft: ✕ n/a");
+		expect(ctx.ui.setStatus).not.toHaveBeenCalled();
 		expect(ctx.ui.notify).not.toHaveBeenCalled();
 	});
 });
@@ -224,6 +226,12 @@ describe("mutation awareness", () => {
 		content: [],
 		isError,
 	});
+	/** Whether the graph counts as changed shows up as a rebuild when the turn ends. */
+	const expectRefreshOnAgentEnd = async (session: Booted, expected: boolean) => {
+		await (handlerFor(session, "agent_end") as (e: unknown, c: unknown) => Promise<void>)({}, session.ctx);
+		if (expected) await vi.waitFor(() => expect(session.commandsRun()).toContain("graft build"));
+		else expect(session.commandsRun()).not.toContain("graft build");
+	};
 	const onToolResult = (session: Booted, toolName: string, input: Record<string, unknown>, isError = false) =>
 		(handlerFor(session, "tool_result") as (e: unknown, c: unknown) => Promise<void>)(
 			toolResultEvent(toolName, input, isError),
@@ -233,14 +241,14 @@ describe("mutation awareness", () => {
 	it("marks the graph changed after a successful edit", async () => {
 		const session = await bootSession();
 		await onToolResult(session, "edit", { path: "src/a.ts" });
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.21.1");
+		await expectRefreshOnAgentEnd(session, true);
 		await session.reset();
 	});
 
 	it("marks the graph changed after a clearly mutating bash command", async () => {
 		const session = await bootSession();
 		await onToolResult(session, "bash", { command: "rm -rf dist" });
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.21.1");
+		await expectRefreshOnAgentEnd(session, true);
 		await session.reset();
 	});
 
@@ -249,7 +257,7 @@ describe("mutation awareness", () => {
 		await onToolResult(session, "read", { path: "src/a.ts" });
 		await onToolResult(session, "bash", { command: "git status" });
 		await onToolResult(session, "edit", { path: "src/a.ts" }, true);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1");
+		await expectRefreshOnAgentEnd(session, false);
 		await session.reset();
 	});
 });
@@ -283,8 +291,7 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
-		expect(harness.commandsRun()).toContain("graft build");
+		await vi.waitFor(() => expect(harness.commandsRun()).toContain("graft build"));
 	});
 
 	it("uses the active TokenIn model for the default deep build", async () => {
@@ -314,7 +321,7 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● deep v0.21.1"));
+		await vi.waitFor(() => expect(harness.commandsRun().some((c) => c.startsWith("graft build"))).toBe(true));
 		const build = harness.exec.mock.calls.find((call) => (call[1] as string[]).includes("build"))!;
 		expect(build[1]).toEqual(["build", "--deep"]);
 		expect(build[2]).toMatchObject({
@@ -359,7 +366,8 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● deep v0.21.1"));
+		await vi.waitFor(() => expect(notified(ctx)).toContain("retrying the deep pass"));
+		await vi.waitFor(() => expect(models).toEqual(["deepseek-v4.1-flash", "glm-5.3-flash"]));
 		expect(models).toEqual(["deepseek-v4.1-flash", "glm-5.3-flash"]);
 		expect(notified(ctx)).toContain("retrying the deep pass");
 	});
@@ -388,12 +396,12 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
+		await vi.waitFor(() => expect(harness.commandsRun().some((c) => c.startsWith("graft build"))).toBe(true));
 		const build = harness.exec.mock.calls.find((call) => (call[1] as string[]).includes("build"))!;
 		expect(build[1]).toEqual(["build"]);
 	});
 
-	it("re-indexes after edits, shows the sync phase, and returns to fresh", async () => {
+	it("re-indexes after edits without touching the status line", async () => {
 		const session = await bootSession({ settings: { refreshDebounceSeconds: 0 } });
 		await (handlerFor(session, "tool_result") as (e: unknown, c: unknown) => Promise<void>)(
 			{ type: "tool_result", toolName: "read", toolCallId: "c", input: {}, content: [], isError: false },
@@ -403,12 +411,10 @@ describe("proactive refresh", () => {
 			{ type: "tool_result", toolName: "write", toolCallId: "c1", input: {}, content: [], isError: false },
 			session.ctx,
 		);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.21.1");
 
 		await (handlerFor(session, "agent_end") as (e: unknown, c: unknown) => Promise<void>)({}, session.ctx);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ⚙ syncing v0.21.1");
-		await vi.waitFor(() => expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
-		expect(session.commandsRun()).toContain("graft build");
+		await vi.waitFor(() => expect(session.commandsRun()).toContain("graft build"));
+		expect(session.ctx.ui.setStatus).not.toHaveBeenCalled();
 		await session.reset();
 	});
 
@@ -449,7 +455,8 @@ describe("proactive refresh", () => {
 			ctx,
 		);
 		await (handlerFor(harness, "agent_end") as (e: unknown, c: unknown) => Promise<void>)({}, ctx);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ✕ failed v0.21.1"));
+		await vi.waitFor(() => expect(harness.commandsRun()).toContain("graft build"));
+		expect(ctx.ui.setStatus).not.toHaveBeenCalled();
 	});
 });
 
@@ -592,8 +599,7 @@ describe("session shutdown", () => {
 		const session = await bootSession({ settings: { mode: "push" } });
 		await session.reset();
 
-		expect(session.ctx.statuses.get("graft")).toBeUndefined();
-		expect(session.ctx.statuses.get("graft-mode")).toBeUndefined();
+		expect(session.ctx.ui.setStatus).not.toHaveBeenCalled();
 		expect(process.env[TELEMETRY_ENV]).toBeUndefined();
 
 		const before = session.exec.mock.calls.length;
@@ -714,7 +720,8 @@ describe("mode selection through commands", () => {
 		const handler = session.commands.get("graft")!.handler as (args: string, ctx: unknown) => Promise<void>;
 		await handler("mode hybrid", session.ctx);
 		expect(session.entries).toContainEqual({ customType: MODE_ENTRY_TYPE, data: { mode: "hybrid" as RetrievalMode } });
-		expect(session.ctx.statuses.get("graft-mode")).toBe("graft mode: hybrid");
+		await handler("status", session.ctx);
+		expect(notified(session.ctx)).toContain("hybrid —");
 
 		const result = await (handlerFor(session, "before_agent_start") as (e: unknown, c: unknown) => Promise<unknown>)(
 			{ type: "before_agent_start", prompt: "Refactor src/auth.ts" },

package/dist/extensions/pi-graft/tools.ts

@@ -282,7 +282,7 @@ export function registerGraftTools(pi: ExtensionAPI, runtime: GraftToolRuntime):
 	});
 
 	pi.registerTool({
-		exposure: "direct",
+		exposure: "deferred",
 		name: "graft_repo_map",
 		label: "Graft: repo map",
 		description:
@@ -308,7 +308,7 @@ export function registerGraftTools(pi: ExtensionAPI, runtime: GraftToolRuntime):
 	});
 
 	pi.registerTool({
-		exposure: "direct",
+		exposure: "deferred",
 		name: "graft_check_freshness",
 		label: "Graft: check freshness",
 		description:

package/dist/extensions/pi-hermes-memory/src/tools/skill-tool.ts

@@ -95,7 +95,7 @@ export function registerSkillTool(pi: ExtensionAPI, store: SkillStore): void {
     label: "Skill Manager",
     description: SKILL_TOOL_DESCRIPTION,
     promptSnippet: "Create, inspect, and update reusable procedures and patterns",
-    exposure: "direct",
+    exposure: "deferred",
     promptGuidelines: [
       "Use the skill_manage tool after completing complex tasks that required trial and error or multiple tool calls.",
       "Use 'create' to save a new reusable procedure, 'patch' to update a section of an existing skill by skill_id, and 'update' for a full rewrite.",

package/dist/extensions/question/index.ts

@@ -616,7 +616,7 @@ export default function questionExtension(pi: ExtensionAPI) {
 		description:
 			"Ask one or more typed questions in a terminal wizard. Supports select, multiselect, text, stable option values, Other answers, and partial atomic submission.",
 		promptSnippet: "Ask the user one or more typed questions when a decision is required.",
-		exposure: "direct",
+		exposure: "model-only",
 		promptGuidelines: [
 			"Use question only for decisions the user must make; inspect facts yourself.",
 			"Send one questions array containing independent decisions that can be answered together.",

package/dist/extensions/tokenin-onboarding.ts

@@ -24,7 +24,7 @@ import {
 } from "@earendil-works/pi-ai";
 import { getApiProvider } from "@earendil-works/pi-ai/compat";
 import { normalizeContext } from "@earendil-works/pi-ai/utils/transcript";
-import { classifyTokenIn, TOKENIN_JEV_CLASSIFIER } from "./jev/classifier.ts";
+import { classifyTokenIn, TOKENIN_CLASSIFIERS } from "./jev/classifier.ts";
 
 type TokenInCredentialStore = ExtensionContext["modelRegistry"]["authStorage"];
 
@@ -1000,8 +1000,8 @@ export default function tokenInOnboardingExtension(pi: ExtensionAPI): void {
 			...ctx.modelRegistry.getModelsOfType("image", "tokenin"),
 			...ctx.modelRegistry.getModelsOfType("classifier", "tokenin"),
 		];
-		if (!models.some((model) => model.type === "classifier" && model.id === TOKENIN_JEV_CLASSIFIER.id)) {
-			models.push(TOKENIN_JEV_CLASSIFIER);
+		for (const classifier of TOKENIN_CLASSIFIERS) {
+			if (!models.some((model) => model.type === "classifier" && model.id === classifier.id)) models.push(classifier);
 		}
 		pi.registerProvider("tokenin", { ...provider, models });
 		if (event.reason !== "startup") return;

package/dist/extensions/tool-search/tool.d.ts

@@ -8,21 +8,33 @@
  * like any other tool change and survives `/tree`, resume, and fork on that branch.
  */
 import { type Static, Type } from "typebox";
-import type { ExtensionAPI, ToolDefinition, ToolInfo, ToolNamespace } from "../../core/extensions/types.ts";
+import type { ExtensionAPI, ExtensionContext, ToolDefinition, ToolInfo, ToolNamespace } from "../../core/extensions/types.ts";
 export declare const TOOL_SEARCH_TOOL_NAME = "tool_search";
 export declare const DEFAULT_TOOL_SEARCH_LIMIT = 8;
 /** A tool as the ranker sees it: its name and the text built by {@link createToolSearchDocument}. */
 export interface ToolSearchDocument {
     name: string;
     text: string;
+    /** Short human-readable form for rankers that read tools as text (name, first paragraph of the description). */
+    summary?: string;
 }
 export interface ToolSearchMatch {
     name: string;
     score: number;
 }
-/** Ranks tools for a query. BM25 today; a hybrid ranker with embeddings can replace it. */
+/** What a ranker may use besides the query: the caller's cancellation and session (model access). */
+export interface ToolRankOptions {
+    signal?: AbortSignal;
+    /** Absent when the caller has no session. A ranker that needs one falls back to its own default. */
+    ctx?: ExtensionContext;
+}
+/**
+ * Ranks tools for a query. BM25 is the built-in; an extension can replace it with
+ * {@link registerToolRanker}, for example a model-backed ranker. Rankers may be asynchronous and
+ * should degrade to a local ranking rather than throw.
+ */
 export interface ToolRanker {
-    rank(query: string, documents: readonly ToolSearchDocument[], limit: number): ToolSearchMatch[];
+    rank(query: string, documents: readonly ToolSearchDocument[], limit: number, options?: ToolRankOptions): ToolSearchMatch[] | Promise<ToolSearchMatch[]>;
 }
 /** Lowercase terms, split at camelCase boundaries and non-alphanumerics, without stop words. */
 export declare function tokenize(text: string): string[];
@@ -42,6 +54,13 @@ export declare class Bm25Ranker implements ToolRanker {
     });
     rank(query: string, documents: readonly ToolSearchDocument[], limit: number): ToolSearchMatch[];
 }
+/**
+ * Make `ranker` the one `tool_search` and codemode's `searchTools()` use, until the returned function
+ * is called. Kept on `globalThis` so every copy of this module sees the same ranker.
+ */
+export declare function registerToolRanker(ranker: ToolRanker): () => void;
+/** The registered ranker, or BM25. */
+export declare function getToolRanker(): ToolRanker;
 export declare const toolSearchSchema: Type.TObject<{
     query: Type.TString;
     limit: Type.TOptional<Type.TNumber>;
@@ -68,5 +87,5 @@ export interface ToolSearchToolOptions {
  * The `tool_search` description. It does not list the searchable tools or their namespaces, so it
  * stays the same while tools are registered, for example when MCP servers connect.
  */
-export declare const TOOL_SEARCH_DESCRIPTION = "# Tool discovery\n\nSearches over deferred tool metadata with BM25 and exposes matching tools for the next model call.\n\nSome of the tools, such as tools of MCP servers, may not have been provided to you upfront, and you should use this tool (`tool_search`) to search for the required tools. For MCP tool discovery, always use `tool_search`.";
+export declare const TOOL_SEARCH_DESCRIPTION = "# Tool discovery\n\nSearches over deferred tool metadata and exposes matching tools for the next model call.\n\nSome of the tools, such as tools of MCP servers, may not have been provided to you upfront, and you should use this tool (`tool_search`) to search for the required tools. For MCP tool discovery, always use `tool_search`.";
 export declare function createToolSearchToolDefinition(options?: ToolSearchToolOptions): ToolDefinition<typeof toolSearchSchema, ToolSearchToolDetails>;

package/dist/extensions/tool-search/tool.js

@@ -86,7 +86,9 @@ export function createToolSearchDocument(tool, namespace) {
     schemaText(tool.parameters, parts);
     if (namespace)
         parts.push(namespace.name, namespace.description ?? "", namespace.instructions ?? "");
-    return { name: tool.name, text: parts.filter((part) => part.trim()).join(" ") };
+    const lead = tool.description.trim().split(/\n\s*\n/)[0] ?? "";
+    const summary = [`${tool.name}: ${lead}`, namespace?.description].filter((part) => part?.trim()).join(" - ");
+    return { name: tool.name, text: parts.filter((part) => part.trim()).join(" "), summary };
 }
 /** Okapi BM25 with the usual parameters. Ties keep document order. */
 export class Bm25Ranker {
@@ -128,6 +130,24 @@ export class Bm25Ranker {
         return matches.sort((a, b) => b.score - a.score).slice(0, limit);
     }
 }
+const TOOL_RANKER_SLOT = Symbol.for("selesai.toolRanker");
+const bm25Ranker = new Bm25Ranker();
+/**
+ * Make `ranker` the one `tool_search` and codemode's `searchTools()` use, until the returned function
+ * is called. Kept on `globalThis` so every copy of this module sees the same ranker.
+ */
+export function registerToolRanker(ranker) {
+    globalThis[TOOL_RANKER_SLOT] = ranker;
+    return () => {
+        if (globalThis[TOOL_RANKER_SLOT] === ranker) {
+            delete globalThis[TOOL_RANKER_SLOT];
+        }
+    };
+}
+/** The registered ranker, or BM25. */
+export function getToolRanker() {
+    return globalThis[TOOL_RANKER_SLOT] ?? bm25Ranker;
+}
 export const toolSearchSchema = Type.Object({
     query: Type.String({ description: "Search query for deferred tools." }),
     limit: Type.Optional(Type.Number({ description: `Maximum number of tools to return. Defaults to ${DEFAULT_TOOL_SEARCH_LIMIT}.` })),
@@ -144,13 +164,19 @@ function isSearchable(exposure) {
  * Rank the searchable tools that are not active yet and activate the matches, so the next model
  * call declares them. Activation is recorded in the transcript like any tool change.
  */
-function searchAndLoad(tools, query, limit) {
-    const active = tools.getActiveTools();
-    const candidates = tools.getAllTools().filter((tool) => isSearchable(tool.exposure) && !active.includes(tool.name));
+async function searchAndLoad(tools, query, limit, rankOptions) {
+    const candidates = tools
+        .getAllTools()
+        .filter((tool) => isSearchable(tool.exposure) && !tools.getActiveTools().includes(tool.name));
     const documents = candidates.map((tool) => createToolSearchDocument(tool, tool.namespace));
-    const matches = new Bm25Ranker().rank(query, documents, limit);
+    const ranked = await getToolRanker().rank(query, documents, limit, rankOptions);
+    // A registered ranker is third-party code: keep only known, distinct candidates, within the limit.
+    const known = new Set(candidates.map((tool) => tool.name));
+    const matches = [...new Map(ranked.filter((match) => known.has(match.name)).map((match) => [match.name, match])).values()].slice(0, limit);
+    // Read the active set after the await: it may have changed while the ranker ran.
+    const active = tools.getActiveTools();
     if (matches.length > 0)
-        tools.setActiveTools([...active, ...matches.map((match) => match.name)]);
+        tools.setActiveTools([...new Set([...active, ...matches.map((match) => match.name)])]);
     return matches.map((match) => ({
         name: match.name,
         description: candidates.find((tool) => tool.name === match.name)?.description ?? "",
@@ -160,7 +186,7 @@ function searchAndLoad(tools, query, limit) {
  * The `tool_search` description. It does not list the searchable tools or their namespaces, so it
  * stays the same while tools are registered, for example when MCP servers connect.
  */
-export const TOOL_SEARCH_DESCRIPTION = `# Tool discovery\n\nSearches over deferred tool metadata with BM25 and exposes matching tools for the next model call.\n\nSome of the tools, such as tools of MCP servers, may not have been provided to you upfront, and you should use this tool (\`${TOOL_SEARCH_TOOL_NAME}\`) to search for the required tools. For MCP tool discovery, always use \`${TOOL_SEARCH_TOOL_NAME}\`.`;
+export const TOOL_SEARCH_DESCRIPTION = `# Tool discovery\n\nSearches over deferred tool metadata and exposes matching tools for the next model call.\n\nSome of the tools, such as tools of MCP servers, may not have been provided to you upfront, and you should use this tool (\`${TOOL_SEARCH_TOOL_NAME}\`) to search for the required tools. For MCP tool discovery, always use \`${TOOL_SEARCH_TOOL_NAME}\`.`;
 export function createToolSearchToolDefinition(options = {}) {
     return {
         name: TOOL_SEARCH_TOOL_NAME,
@@ -170,13 +196,13 @@ export function createToolSearchToolDefinition(options = {}) {
         parameters: toolSearchSchema,
         // Searching is not something scripts need; it changes what the model sees.
         exposure: "model-only",
-        async execute(_toolCallId, { query, limit }) {
+        async execute(_toolCallId, { query, limit }, signal, _onUpdate, ctx) {
             if (query.trim() === "")
                 throw new Error("query must not be empty");
             const max = limit ?? DEFAULT_TOOL_SEARCH_LIMIT;
             if (!Number.isInteger(max) || max <= 0)
                 throw new Error("limit must be a positive integer");
-            const tools = options.tools ? searchAndLoad(options.tools, query, max) : [];
+            const tools = options.tools ? await searchAndLoad(options.tools, query, max, { signal, ctx }) : [];
             const text = tools.length === 0
                 ? "No matching tools found."
                 : `Loaded ${tools.length} tool${tools.length === 1 ? "" : "s"}. They are available from your next call:\n${tools

package/dist/index.d.ts

@@ -32,6 +32,7 @@ export type { CodemodeStoreEntryData, CodemodeToolDetails } from "./extensions/c
 export type { LoadedMcpConfig, McpExposure, McpServerConfig, McpServerEntry } from "./extensions/mcp/config.ts";
 export { createMcpExtension, type McpExtensionOptions, type McpTransportFactory } from "./extensions/mcp/index.ts";
 export { createToolSearchExtension } from "./extensions/tool-search/index.ts";
+export { Bm25Ranker, getToolRanker, registerToolRanker, type ToolRankOptions, type ToolRanker, type ToolSearchDocument, type ToolSearchMatch, } from "./extensions/tool-search/tool.ts";
 export { type MainOptions, main } from "./main.ts";
 export { InteractiveMode, type InteractiveModeOptions, type JsonAgentSessionEvent, type ModelInfo, type PrintModeOptions, RpcClient, type RpcClientOptions, type RpcCommand, type RpcEvent, type SubagentRpcCommand, type SubagentRpcEvent, type SubagentRpcResponse, type SubagentRpcSnapshot, type SubagentRpcNode, type SubagentRpcFleet, type SubagentRpcTokens, type SubagentRpcLifecycle, type RpcObservationScope, type ReleaseCommand, type ReleaseResponse, type ReleaseResult, type ReleaseReadinessCommand, type ReleaseReadinessResponse, type ReleaseReadiness, type StopAllBackgroundCommand, type StopAllBackgroundResponse, type StopAllBackgroundResult, type StopAllBackgroundItem, type IntercomRpcCommand, type IntercomRpcResponse, type IntercomRpcEvent, type IntercomRpcStatus, type IntercomRpcDelivery, type IntercomRpcMessageOptions, type IntercomRpcDataMap, type RpcEventListener, type RpcExtensionUIRequest, type RpcExtensionUIResponse, type RpcResponse, type RpcSessionState, runPrintMode, runRpcMode, } from "./modes/index.ts";
 export { ArminComponent, AssistantMessageComponent, BashExecutionComponent, BorderedLoader, BranchSummaryMessageComponent, CompactionSummaryMessageComponent, CustomEditor, type CustomEditorOptions, CustomMessageComponent, DynamicBorder, ExtensionEditorComponent, ExtensionInputComponent, ExtensionSelectorComponent, FooterComponent, keyHint, keyText, LoginDialogComponent, ModelSelectorComponent, OAuthSelectorComponent, type RenderDiffOptions, rawKeyHint, renderDiff, SessionSelectorComponent, type SettingsCallbacks, type SettingsConfig, SettingsSelectorComponent, ShowImagesSelectorComponent, SkillInvocationMessageComponent, ThemeSelectorComponent, ThinkingSelectorComponent, ToolExecutionComponent, type ToolExecutionOptions, TreeSelectorComponent, truncateToVisualLines, UserMessageComponent, UserMessageSelectorComponent, type VisualTruncateResult, } from "./modes/interactive/components/index.ts";

package/dist/index.js

@@ -35,6 +35,7 @@ export { VIRTUAL_MODEL_STATE_ENTRY, } from "./core/virtual-models.js";
 export { createCodemodeExtension } from "./extensions/codemode/index.js";
 export { createMcpExtension } from "./extensions/mcp/index.js";
 export { createToolSearchExtension } from "./extensions/tool-search/index.js";
+export { Bm25Ranker, getToolRanker, registerToolRanker, } from "./extensions/tool-search/tool.js";
 // Main entry point
 export { main } from "./main.js";
 // Run modes for programmatic SDK usage

package/docs/codemode.md

@@ -29,7 +29,7 @@ The result starts with `Script completed` or `Script failed`, the wall time, and
 | `exit()` | End the script successfully. |
 | `store(key, value)` / `load(key)` | Keep small JSON values across `codemode` calls. See [Store values](#store-values). |
 | `ALL_TOOLS` | Every callable tool as `{ name, description }`, including tools the description does not list. |
-| `searchTools(query, { limit?, namespace? })` | Rank callable tools by relevance (BM25, default limit 8). Resolves to `{ name, description }[]`. |
+| `searchTools(query, { limit?, namespace? })` | Rank callable tools by relevance (default limit 8). Asks Jev (`jevAdvisory.routes.toolSearch`) when a Token-In account is available, for the first 8 searches of a script; otherwise BM25. Resolves to `{ name, description }[]`. |
 | `describeTool(name)` | Resolves to a tool's description and TypeScript declaration, or `undefined`. |
 | `describeNamespace(name)` | Resolves to `{ name, description?, instructions?, tools }` for a namespace such as an MCP server, or `undefined`. |
 | `models` | List and run non-LLM models. See [Models](#models). |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selesai/code",
-  "version": "0.14.0",
+  "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 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-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-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": "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",