@selesai/code 0.13.30 → 0.13.32

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to `@selesai/code` will be documented in this file.
 
+## [0.13.32] - 2026-09-24
+
+### Fixed
+- **Cached provider model catalogs are no longer discarded when `Last-Modified` is missing.** Models such as `openai-codex/gpt-6-sol` and `openai-codex/gpt-6-luna` remain available after a catalog refresh when the cached catalog is newer than the bundled metadata.
+
+## [0.13.31] - 2026-09-23
+
+### Changed
+- **Jev capability tie-breaking is now on by default.** Toggle ambiguous-tool tie-breaking in `/settings`. It requires Token-In credentials; without them, Jev is not called and Selesai prompts you to run `/tokenin add`. Deterministic routing remains the fallback.
+
 ## [0.13.30] - 2026-09-23
 
 ### Added

package/dist/core/remote-catalog-provider.js

@@ -30,7 +30,11 @@ function parseCatalog(providerId, value) {
 function remoteModels(entry, localGeneratedAt) {
     if (!entry)
         return [];
-    if (localGeneratedAt !== undefined && (entry.lastModified === undefined || entry.lastModified <= localGeneratedAt)) {
+    // Some catalog responses (and the 404/501 fallback) have no usable
+    // Last-Modified value. Use the completed check time instead so a cached
+    // catalog is not discarded merely because that header was absent.
+    const remoteGeneratedAt = entry.lastModified && entry.lastModified > 0 ? entry.lastModified : entry.checkedAt;
+    if (localGeneratedAt !== undefined && (remoteGeneratedAt === undefined || remoteGeneratedAt <= localGeneratedAt)) {
         return [];
     }
     return entry.models;

package/dist/core/remote-catalog-provider.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/remote-catalog-provider.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from "vitest";
+import { withRemoteCatalog } from "./remote-catalog-provider.js";
+const cachedModel = {
+    id: "gpt-6-sol",
+    provider: "openai-codex",
+};
+function refreshContext(stored) {
+    return {
+        stored,
+        allowNetwork: false,
+        signal: new AbortController().signal,
+        publish: async ({ update }) => {
+            update?.();
+            return true;
+        },
+    };
+}
+describe("remote model catalog cache", () => {
+    it("keeps a newer cached catalog when Last-Modified is unavailable", async () => {
+        const localGeneratedAt = 100;
+        const provider = {
+            id: "openai-codex",
+            getModels: () => [],
+        };
+        const wrapped = withRemoteCatalog(provider, "https://example.test", localGeneratedAt);
+        await wrapped.refreshModels?.(refreshContext({ models: [cachedModel], checkedAt: localGeneratedAt + 1, lastModified: 0 }));
+        expect(wrapped.getModels().map((model) => model.id)).toEqual(["gpt-6-sol"]);
+    });
+});

package/dist/core/settings-manager-auto-handoff.test.js

@@ -39,4 +39,15 @@ describe("auto handoff settings", () => {
         await manager.flush();
         expect(manager.getAutoHandoffThresholdTokens()).toBe(128_500);
     });
+    it("defaults Jev capability routing on and persists the /settings toggle", async () => {
+        const manager = SettingsManager.inMemory();
+        expect(manager.getCapabilityGatewayJevEnabled()).toBe(true);
+        manager.setCapabilityGatewayJevEnabled(false);
+        await manager.flush();
+        expect(manager.getCapabilityGatewayJevEnabled()).toBe(false);
+        expect(manager.getGlobalSettings().capabilityGateway?.routing?.jev?.enabled).toBe(false);
+        manager.setCapabilityGatewayJevEnabled(true);
+        await manager.flush();
+        expect(manager.getCapabilityGatewayJevEnabled()).toBe(true);
+    });
 });

package/dist/core/settings-manager.d.ts

@@ -64,6 +64,13 @@ export interface AutoHandoffSettings {
     enabled?: boolean;
     thresholdTokens?: number;
 }
+export interface CapabilityGatewaySettings {
+    routing?: {
+        jev?: {
+            enabled?: boolean;
+        };
+    };
+}
 export type DefaultProjectTrust = "ask" | "always" | "never";
 export type TransportSetting = Transport;
 /**
@@ -130,6 +137,7 @@ export interface Settings {
     markdown?: MarkdownSettings;
     warnings?: WarningSettings;
     autoHandoff?: AutoHandoffSettings;
+    capabilityGateway?: CapabilityGatewaySettings;
     sessionDir?: string;
     extensionHost?: Record<string, "selesai" | "pi">;
     httpProxy?: string;
@@ -361,6 +369,8 @@ export declare class SettingsManager {
     getWarnings(): WarningSettings;
     setWarnings(warnings: WarningSettings): void;
     getAutoHandoffEnabled(): boolean;
+    getCapabilityGatewayJevEnabled(): boolean;
+    setCapabilityGatewayJevEnabled(enabled: boolean): void;
     setAutoHandoffEnabled(enabled: boolean): void;
     getAutoHandoffThresholdTokens(): number;
     setAutoHandoffThresholdTokens(tokens: number): void;

package/dist/core/settings-manager.js

@@ -1087,6 +1087,12 @@ export class SettingsManager {
     getAutoHandoffEnabled() {
         return this.settings.autoHandoff?.enabled ?? DEFAULT_AUTO_HANDOFF_SETTINGS.enabled;
     }
+    getCapabilityGatewayJevEnabled() {
+        return this.settings.capabilityGateway?.routing?.jev?.enabled ?? true;
+    }
+    setCapabilityGatewayJevEnabled(enabled) {
+        this.setGlobalSettings({ capabilityGateway: { routing: { jev: { enabled } } } });
+    }
     setAutoHandoffEnabled(enabled) {
         if (!this.globalSettings.autoHandoff) {
             this.globalSettings.autoHandoff = {};

package/dist/defaults/settings.json

@@ -11,6 +11,11 @@
       "recommendations": { "enabled": false }
     }
   },
+  "capabilityGateway": {
+    "routing": {
+      "jev": { "enabled": true }
+    }
+  },
   "collapseChangelog": true,
   "compaction": {
     "enabled": true,

package/dist/extensions/capability-gateway/index.ts

@@ -16,7 +16,7 @@
  * - A deterministic router activates a uniquely matched tool before the run.
  *   Skills and ambiguous matches remain discoverable through the catalog
  *   without injecting fuzzy hints into the model context.
- * - Opt-in Jev-assisted routing (capabilityGateway.routing.jev in settings.json)
+ * - Default-on Jev-assisted routing (capabilityGateway.routing.jev in settings.json)
  *   is only a bounded tie-breaker: when the deterministic router returns an
  *   ambiguous lexical hint among optional tools, the gateway offers just those
  *   hinted tools (two or three) and the current prompt to the Jev decisions
@@ -24,8 +24,9 @@
  *   hinted canonical tool name; the gateway revalidates the choice against the
  *   live catalog and activates it for the current run only. No hint, a unique
  *   activation, a skill match, or an already-activated tool never reaches Jev.
- *   Every Jev failure is an ordinary abstention that leaves the deterministic
- *   behavior in place, so a missing Token-In subscription is invisible.
+ *   Every Jev failure is an ordinary abstention that leaves deterministic
+ *   behavior in place. Without Token-In credentials, no Jev request is sent and
+ *   the user is prompted to add an account with `/tokenin add`.
  * - Temporary activations reset at agent_settled, restoring the baseline
  *   active-tool set; a tool_execution_start for one of them records whether the
  *   activation was actually used (content-free tool name + source only).
@@ -93,14 +94,19 @@ function catalogEntries(pi: ExtensionAPI): CatalogEntry[] {
 }
 
 const EMBEDDED_SKILL_BLOCK = /<skill\s+name="([^"]+)"[^>]*>[\s\S]*?<\/skill>/gi;
+const GITHUB_OR_OPEN_SOURCE_QUERY = /\b(?:github|open[\s-]*source)\b/i;
 
 function routePrompt(prompt: string, entries: CatalogEntry[]): ReturnType<typeof route> {
 	const loadedSkills = new Set([...prompt.matchAll(EMBEDDED_SKILL_BLOCK)].map((match) => match[1]!.toLowerCase()));
 	const query = prompt.replace(EMBEDDED_SKILL_BLOCK, " ");
-	return route(
-		query,
-		entries.filter((entry) => entry.kind !== "skill" || !loadedSkills.has(entry.name.toLowerCase())),
-	);
+	const candidates = entries.filter((entry) => entry.kind !== "skill" || !loadedSkills.has(entry.name.toLowerCase()));
+	if (GITHUB_OR_OPEN_SOURCE_QUERY.test(query)) {
+		const grepAppSearch = candidates.find(
+			(entry) => entry.kind === "tool" && entry.eligible && entry.name === "grep_app_search",
+		);
+		if (grepAppSearch) return { action: "activate", entry: grepAppSearch };
+	}
+	return route(query, candidates);
 }
 
 function formatCatalog(entries: CatalogEntry[]): string {
@@ -146,6 +152,7 @@ export default function capabilityGatewayExtension(pi: ExtensionAPI): void {
 	// Tools this gateway activated for the current run, and whether they were invoked.
 	// Cleared at agent_settled with the activations themselves.
 	const activations = new Map<string, { source: ActivationSource; used: boolean }>();
+	let tokenInSetupPrompted = false;
 
 	/** Activate one tool for the current run, keeping the rest of the loadout untouched. */
 	function activateTool(name: string, source: ActivationSource): void {
@@ -313,7 +320,7 @@ export default function capabilityGatewayExtension(pi: ExtensionAPI): void {
 	});
 
 	// ------------------------------------------------------------------
-	// Routing: the deterministic catalog router first; opt-in Jev routing is
+	// Routing: the deterministic catalog router first; default-on Jev routing is
 	// only a bounded tie-breaker for its ambiguous/hint result.
 	// ------------------------------------------------------------------
 	pi.on("before_agent_start", async (event, ctx) => {
@@ -344,6 +351,17 @@ export default function capabilityGatewayExtension(pi: ExtensionAPI): void {
 		emitTelemetry(pi, "route", { source: "jev", outcome: "attempt", candidates: candidates.length });
 		const jevRoute = await routeToJevTool(candidates, event.prompt, ctx, config);
 		if (!jevRoute.selected) {
+			if (
+				!tokenInSetupPrompted &&
+				config.provider === "tokenin" &&
+				(jevRoute.reason === "no-credential" || jevRoute.reason === "no-template")
+			) {
+				tokenInSetupPrompted = true;
+				ctx.ui.notify(
+					"Jev tool tie-breaking needs a Token-In account. Add one with /tokenin add; deterministic routing will keep working meanwhile.",
+					"warning",
+				);
+			}
 			emitTelemetry(pi, "route", {
 				source: "jev",
 				outcome: JEV_UNAVAILABLE_REASONS.has(jevRoute.reason) ? "unavailable" : "abstained",

package/dist/extensions/capability-gateway/integration.test.ts

@@ -19,6 +19,7 @@ import { allowNetwork } from "../../../test/test-network-env.ts";
 const EXTENSIONS_DIR = fileURLToPath(new URL("../../", import.meta.url));
 const GATEWAY_DIR = fileURLToPath(new URL(".", import.meta.url));
 const GREP_APP_DIR = fileURLToPath(new URL("../grep-app", import.meta.url));
+const WEB_AGENT_DIR = fileURLToPath(new URL("../pi-web-agent", import.meta.url));
 const GRAFT_DIR = fileURLToPath(new URL("../pi-graft", import.meta.url));
 const INLINE_SKILLS_FILE = fileURLToPath(new URL("../inline-skills.ts", import.meta.url));
 
@@ -333,13 +334,13 @@ describe("capability gateway integration", () => {
 });
 
 // ---------------------------------------------------------------------------
-// Jev-assisted routing (opt-in): capabilityGateway.routing.jev.
+// Default-on Jev-assisted routing: capabilityGateway.routing.jev.
 // ---------------------------------------------------------------------------
 
 describe("capability gateway Jev routing", () => {
-	// "...github..." only weakly suggests both grep-app tools: the deterministic router returns a
-	// two-candidate hint, which is the only Jev trigger.
-	const HINT_PROMPT = "look at this github repo";
+	// "search fetch" weakly suggests both grep-app tools: the deterministic router returns a
+	// two-candidate hint, which is the only Jev trigger. GitHub/open-source mentions route directly.
+	const HINT_PROMPT = "search fetch";
 	// No tool name, alias, or summary token matches: the router has no lexical signal and Jev
 	// must never be consulted.
 	const NO_SIGNAL_PROMPT = "continue where we left off last time";
@@ -393,6 +394,35 @@ describe("capability gateway Jev routing", () => {
 		return h.telemetry.filter((event) => event.event === "route");
 	}
 
+	it("routes only GitHub/open-source mentions to grep.app; other web searches stay on web_explore", async () => {
+		allowNetwork();
+		const { fetchMock } = stubJev("none", 1);
+		const h = await createGatewaySession({
+			enabled: true,
+			extensions: [GATEWAY_DIR, GREP_APP_DIR, WEB_AGENT_DIR],
+			jev: jevSettings(),
+		});
+		harnesses.push(h);
+
+		for (const prompt of [
+			"search GitHub code",
+			"find open-source implementations",
+			"find open source implementations",
+			"find opensource examples",
+		]) {
+			await route(h, prompt);
+			expect(h.session.getActiveToolNames()).toContain("grep_app_search");
+			expect(h.session.getActiveToolNames()).not.toContain("web_explore");
+			expect(fetchMock).not.toHaveBeenCalled();
+			await h.session.extensionRunner.emit({ type: "agent_settled" });
+		}
+
+		await route(h, "web search for release notes");
+		expect(h.session.getActiveToolNames()).toContain("web_explore");
+		expect(h.session.getActiveToolNames()).not.toContain("grep_app_search");
+		expect(fetchMock).not.toHaveBeenCalled();
+	});
+
 	// Telemetry may carry route metadata and canonical tool names, never prompt
 	// text, conversation turns, credentials, raw Jev output, or tool arguments.
 	const TELEMETRY_KEYS = new Set([
@@ -518,14 +548,37 @@ describe("capability gateway Jev routing", () => {
 		);
 	});
 
-	it("leaves routing deterministic when the Jev route is not configured", async () => {
+	it("tries Jev by default but abstains safely without Token-In", async () => {
 		allowNetwork();
-		const disabled = stubJev("grep_app_search");
+		const unavailable = stubJev("grep_app_search");
 		const h = await createGatewaySession({ enabled: true, extensions: [GATEWAY_DIR, GREP_APP_DIR] });
 		harnesses.push(h);
 
 		await route(h, HINT_PROMPT);
 
+		expect(unavailable.fetchMock).not.toHaveBeenCalled();
+		expect(h.session.getActiveToolNames()).not.toContain("grep_app_search");
+		expect(routeEvents(h)).toContainEqual(expect.objectContaining({ source: "jev", outcome: "attempt" }));
+		expect(routeEvents(h)).toContainEqual(
+			expect.objectContaining({
+				source: "jev",
+				outcome: "unavailable",
+				reason: expect.stringMatching(/^no-(template|credential)$/),
+			}),
+		);
+	});
+
+	it("does not attempt Jev when explicitly disabled", async () => {
+		const disabled = stubJev("grep_app_search");
+		const h = await createGatewaySession({
+			enabled: true,
+			extensions: [GATEWAY_DIR, GREP_APP_DIR],
+			jev: { enabled: false },
+		});
+		harnesses.push(h);
+
+		await route(h, HINT_PROMPT);
+
 		expect(disabled.fetchMock).not.toHaveBeenCalled();
 		expect(h.session.getActiveToolNames()).not.toContain("grep_app_search");
 		expect(routeEvents(h)).toEqual([]);

package/dist/extensions/capability-gateway/routing.test.ts

@@ -115,10 +115,10 @@ describe("gateway Jev configuration", () => {
 		return path;
 	}
 
-	it("stays disabled with its own short pre-turn defaults when settings are missing or malformed", () => {
+	it("defaults Jev routing on with short pre-turn settings when settings are missing or malformed", () => {
 		expect(readGatewayJevConfig(join(settingsDir, "absent.json"))).toEqual(DEFAULT_GATEWAY_JEV_CONFIG);
 		expect(DEFAULT_GATEWAY_JEV_CONFIG).toMatchObject({
-			enabled: false,
+			enabled: true,
 			provider: "tokenin",
 			model: "jev-1.13",
 			timeoutMs: DEFAULT_GATEWAY_JEV_TIMEOUT_MS,
@@ -133,7 +133,7 @@ describe("gateway Jev configuration", () => {
 		);
 	});
 
-	it("reads the opt-in route settings over the gateway defaults", () => {
+	it("reads explicit route settings over the default-on gateway config", () => {
 		const path = write({
 			capabilityGateway: {
 				routing: {
@@ -174,7 +174,7 @@ describe("gateway Jev configuration", () => {
 		expect(read).not.toHaveProperty("contextChars");
 	});
 
-	it("rejects wrong types and never enables the route implicitly", () => {
+	it("rejects wrong types while allowing an omitted enabled flag to inherit true", () => {
 		const path = write({
 			capabilityGateway: {
 				routing: {
@@ -190,7 +190,13 @@ describe("gateway Jev configuration", () => {
 				},
 			},
 		});
-		expect(readGatewayJevConfig(path)).toEqual(DEFAULT_GATEWAY_JEV_CONFIG);
+		expect(readGatewayJevConfig(path)).toEqual({ ...DEFAULT_GATEWAY_JEV_CONFIG, enabled: false });
+
+		const omittedEnabled = write({ capabilityGateway: { routing: { jev: { timeoutMs: 500 } } } });
+		expect(readGatewayJevConfig(omittedEnabled).enabled).toBe(true);
+
+		const disabled = write({ capabilityGateway: { routing: { jev: { enabled: false } } } });
+		expect(readGatewayJevConfig(disabled).enabled).toBe(false);
 	});
 
 	it("derives the shared connection settings and hard-caps the pre-turn timeout", () => {

package/dist/extensions/capability-gateway/routing.ts

@@ -12,9 +12,9 @@
  * an abstention that leaves the deterministic behavior in place. The transport and validation half
  * lives in the shared `../jev/decisions.ts` client.
  *
- * Configuration (opt-in, disabled by default). The gateway reads its own settings area — it does
- * not inherit `jevAdvisory` route policy; only the Jev provider/model identity is shared so every
- * Jev consumer defaults to the same deployment:
+ * Configuration (enabled by default, but requires Token-In credentials). The gateway reads its
+ * own settings area — it does not inherit `jevAdvisory` route policy; only the Jev provider/model
+ * identity is shared so every Jev consumer defaults to the same deployment:
  *
  *   "capabilityGateway": {
  *     "routing": { "jev": { "enabled": true, "timeoutMs": 1000, "minConfidence": 0.6 } }
@@ -68,7 +68,7 @@ export interface GatewayJevConfig {
 }
 
 export const DEFAULT_GATEWAY_JEV_CONFIG: GatewayJevConfig = {
-	enabled: false,
+	enabled: true,
 	// The Jev deployment identity, shared with every other Jev consumer.
 	provider: DEFAULT_JEV_ADVISORY_CONFIG.provider,
 	model: DEFAULT_JEV_ADVISORY_CONFIG.model,
@@ -99,13 +99,13 @@ export function readGatewayJevConfig(settingsPath: string = getSettingsPath()):
 			if (isRecord(jev)) raw = jev;
 		}
 	} catch {
-		// Missing or malformed settings: the feature stays disabled.
+		// Missing or malformed settings: use the default-on route preference.
 	}
 	if (!raw) return DEFAULT_GATEWAY_JEV_CONFIG;
 
 	const baseUrl = raw.baseUrl;
 	return {
-		enabled: raw.enabled === true,
+		enabled: raw.enabled === undefined ? DEFAULT_GATEWAY_JEV_CONFIG.enabled : raw.enabled === true,
 		provider: stringOr(raw.provider, DEFAULT_GATEWAY_JEV_CONFIG.provider),
 		model: stringOr(raw.model, DEFAULT_GATEWAY_JEV_CONFIG.model),
 		baseUrl: typeof baseUrl === "string" && baseUrl.trim() !== "" ? baseUrl : undefined,

package/dist/extensions/pi-web-agent/src/extension.ts

@@ -104,7 +104,8 @@ export default function extension(pi: ExtensionAPI) {
   pi.on('before_agent_start', async (event) => ({
     systemPrompt:
       `${event.systemPrompt}\n\n` +
-      'For web research questions that require finding and comparing sources, use web_explore. ' +
+      'For requests explicitly mentioning GitHub or open source, use grep_app_search instead of web_explore. ' +
+      'For all other web research questions that require finding and comparing sources, use web_explore. ' +
       'web_explore handles search, fetch, source ranking, and headless escalation internally. ' +
       'If more web evidence is needed after web_explore, call web_explore again with a narrower query; do not use shell/network commands such as curl, Invoke-WebRequest, npm view/search/pack, or direct HTTP URLs for web research.'
   }));

package/dist/modes/interactive/components/settings-selector.d.ts

@@ -15,6 +15,7 @@ export interface SettingsConfig {
     autoCompact: boolean;
     autoHandoffEnabled: boolean;
     autoHandoffThresholdTokens: number;
+    capabilityGatewayJevEnabled: boolean;
     showImages: boolean;
     imageWidthCells: number;
     autoResizeImages: boolean;
@@ -62,6 +63,7 @@ export interface SettingsCallbacks {
     onAutoCompactChange: (enabled: boolean) => void;
     onAutoHandoffEnabledChange: (enabled: boolean) => void;
     onAutoHandoffThresholdTokensChange: (tokens: number) => void;
+    onCapabilityGatewayJevChange: (enabled: boolean) => boolean;
     onShowImagesChange: (enabled: boolean) => void;
     onImageWidthCellsChange: (width: number) => void;
     onAutoResizeImagesChange: (enabled: boolean) => void;

package/dist/modes/interactive/components/settings-selector.js

@@ -363,6 +363,13 @@ export class SettingsSelectorComponent extends Container {
                 currentValue: String(config.autoHandoffThresholdTokens),
                 values: ["64000", "96000", "128000", "160000", "192000", "256000", "512000"],
             },
+            {
+                id: "capability-gateway-jev",
+                label: "Jev tool tie-breaking",
+                description: "Use Token-In Jev only for ambiguous optional-tool matches. Requires Token-In credentials; add one with /tokenin add.",
+                currentValue: config.capabilityGatewayJevEnabled ? "true" : "false",
+                values: ["true", "false"],
+            },
             {
                 id: "steering-mode",
                 label: "Steering mode",
@@ -731,6 +738,11 @@ export class SettingsSelectorComponent extends Container {
                 case "auto-handoff-threshold":
                     callbacks.onAutoHandoffThresholdTokensChange(parseInt(newValue, 10));
                     break;
+                case "capability-gateway-jev":
+                    if (!callbacks.onCapabilityGatewayJevChange(newValue === "true")) {
+                        this.settingsList.updateValue(id, config.capabilityGatewayJevEnabled ? "true" : "false");
+                    }
+                    break;
                 case "show-images":
                     callbacks.onShowImagesChange(newValue === "true");
                     break;

package/dist/modes/interactive/interactive-mode.js

@@ -3785,6 +3785,7 @@ export class InteractiveMode {
                 autoCompact: this.session.autoCompactionEnabled,
                 autoHandoffEnabled: this.settingsManager.getAutoHandoffEnabled(),
                 autoHandoffThresholdTokens: this.settingsManager.getAutoHandoffThresholdTokens(),
+                capabilityGatewayJevEnabled: this.settingsManager.getCapabilityGatewayJevEnabled(),
                 defaultModel: (() => {
                     const defaultProvider = this.settingsManager.getDefaultProvider();
                     const defaultModelId = this.settingsManager.getDefaultModel();
@@ -3850,6 +3851,23 @@ export class InteractiveMode {
                 onAutoHandoffThresholdTokensChange: (tokens) => {
                     this.settingsManager.setAutoHandoffThresholdTokens(tokens);
                 },
+                onCapabilityGatewayJevChange: (enabled) => {
+                    if (enabled && !this.session.modelRuntime.getProviderAuthStatus("tokenin").configured) {
+                        this.showStatus("Token-In is required for Jev routing; starting /tokenin add");
+                        done();
+                        void this.session
+                            .prompt("/tokenin add")
+                            .then(() => {
+                            if (this.session.modelRuntime.getProviderAuthStatus("tokenin").configured) {
+                                this.settingsManager.setCapabilityGatewayJevEnabled(true);
+                            }
+                        })
+                            .catch((error) => this.showError(`Could not start Token-In setup: ${String(error)}`));
+                        return false;
+                    }
+                    this.settingsManager.setCapabilityGatewayJevEnabled(enabled);
+                    return true;
+                },
                 onShowImagesChange: (enabled) => {
                     this.settingsManager.setShowImages(enabled);
                     for (const child of this.chatContainer.children) {

package/docs/settings.md

@@ -103,15 +103,16 @@ Routing has two rungs:
 
 1. A deterministic router activates a tool when the prompt uniquely matches its name, alias, or
    discovery summary. Skills are never auto-loaded or auto-selected.
-2. Opt-in Jev tie-breaking: when the deterministic router returns an ambiguous lexical hint among
-   optional tools, the Jev decisions model is asked which of two or three hinted tools (or `none`)
-   should be exposed. Jev sees only the bounded current prompt and each hinted tool's compact
+2. Default-on Jev tie-breaking: when the deterministic router returns an ambiguous lexical hint
+   among optional tools, the Jev decisions model is asked which of two or three hinted tools (or
+   `none`) should be exposed. Jev sees only the bounded current prompt and each hinted tool's compact
    discovery line — never conversation history, tool schemas, or the full catalog. A prompt with no
-   lexical signal, a unique activation, and a skill-only match never reach Jev.
+   lexical signal, a unique activation, and a skill-only match never reach Jev. Token-In credentials
+   are required; without them, no Jev request is sent and Selesai prompts you to run `/tokenin add`.
 
 | Setting | Type | Default | Description |
 |---------|------|---------|-------------|
-| `capabilityGateway.routing.jev.enabled` | boolean | `false` | Enable Jev tie-breaking for ambiguous tool hints |
+| `capabilityGateway.routing.jev.enabled` | boolean | `true` | Enable Jev tie-breaking for ambiguous tool hints; toggle it in `/settings` (requires Token-In credentials) |
 | `capabilityGateway.routing.jev.provider` | string | `"tokenin"` | Provider serving the Jev decisions deployment |
 | `capabilityGateway.routing.jev.model` | string | `"jev-1.13"` | Decisions model the tie-breaker calls |
 | `capabilityGateway.routing.jev.baseUrl` | string | inherited | Base URL override; defaults to any registered model of `provider` |
@@ -121,8 +122,8 @@ Routing has two rungs:
 
 This area is independent of `jevAdvisory`: gateway routing reads only
 `capabilityGateway.routing.jev` and shares just the Jev provider/model deployment identity. A
-failure, timeout, invalid answer, low confidence, or `none` is an ordinary abstention that leaves
-the deterministic behavior in place. Temporary activations reset when the run settles, and
+failure, timeout, invalid answer, low confidence, missing Token-In credentials, or `none` is an
+ordinary abstention that leaves deterministic behavior in place. Temporary activations reset when the run settles, and
 content-free telemetry on the `capability-gateway` event channel records the route outcome and
 whether an activated tool was actually invoked.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selesai/code",
-  "version": "0.13.30",
+  "version": "0.13.32",
   "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/extensions/jev-advisory-memory.test.ts src/extensions/jev-advisory-recommendations.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/extensions/jev-advisory-memory.test.ts src/extensions/jev-advisory-recommendations.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 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-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-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",
     "prepare": "npm run build",
     "build": "npm run clean && tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js dist/rpc-entry.js && npm run copy-assets",
     "copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/ && shx mkdir -p dist/defaults && shx cp src/defaults/* dist/defaults/ && shx mkdir -p dist/extensions && node scripts/copy-extensions.mjs && shx mkdir -p dist/themes && shx cp -r src/themes/. dist/themes/ && shx mkdir -p dist/skills && shx cp -r src/skills/. dist/skills/"