@selesai/code 0.8.7 → 0.8.8

package/CHANGELOG.md

@@ -2,7 +2,21 @@
 
 All notable changes to `@selesai/code` will be documented in this file.
 
-## [Unreleased]
+## [0.8.8] - 2026-08-18
+
+### Added
+- **`--use-theme <name>` CLI flag.** Sets the initial interactive theme for a run; the fullscreen theme controller applies an invocation-level theme before settings load, so the flag wins until you change the theme in `/settings`.
+- **Transcript search highlighting.** The fullscreen TUI now highlights search matches live in the transcript, themeable via new optional `searchMatchBg`/`searchMatchText` colors (falling back to `selectedBg`/`text`).
+- **Fullscreen exit output option.** `/settings` gained a **Fullscreen exit output** entry: exiting fullscreen can print the transcript as before (`"transcript"`) or only a session resume hint (`"resume-hint"`) via the new `fullscreenExitOutput` setting.
+- **`defaultTools` setting.** Seeds the initial built-in tool selection for `createAgentSession`; when set, new sessions start with only the listed tools instead of the `read`/`bash`/`edit`/`write` default.
+- **`sendUserMessage` template expansion.** Extensions can pass `expandPromptTemplates: true` to dispatch extension commands and expand skill commands/prompt templates from a sent user message.
+- **Experimental strict tool sampling.** Under `PI_EXPERIMENTAL=1`, the built-in read/edit/write/bash tools request `json_schema` tool output with `strict: "prefer"`.
+
+### Changed
+- **Managed-tool downloads moved off the startup path.** The TUI mounts and stays responsive while `fd`/`rg` install; download progress and warnings are reported as chat status lines (with an `app.tools.expand` hint) instead of raw `console.log` output, and the interactive startup accepts input (with interrupt/exit/submit feedback) while it completes.
+- **Collapsed large tool output.** Tool components now preview only the first 10 lines with an inline `... (N more lines)` expand hint instead of dumping the whole block.
+- **Shared model-catalog refreshes.** Concurrent interactive all-catalog refreshes reuse one in-flight refresh while keeping each caller's cancellation independent, and refreshes are bounded by a short timeout.
+- **Runtime dependencies updated to Pi 0.84.2.** `@earendil-works/pi-ai`, `@earendil-works/pi-tui`, and `@earendil-works/pi-agent-core` moved to 0.84.2; `openAIResponses` model config gained an optional `supportsAdditionalTools` flag; `exportToHtml` accepts a `themeName` option.
 
 ## [0.8.7] - 2026-08-17
 

package/dist/cli/args.d.ts

@@ -37,6 +37,7 @@ export interface Args {
     promptTemplates?: string[];
     noPromptTemplates?: boolean;
     themes?: string[];
+    useTheme?: string;
     noThemes?: boolean;
     noContextFiles?: boolean;
     listModels?: string | true;

package/dist/cli/args.js

@@ -142,6 +142,16 @@ export function parseArgs(args) {
         else if (arg === "--no-prompt-templates" || arg === "-np") {
             result.noPromptTemplates = true;
         }
+        else if (arg === "--use-theme") {
+            const themeName = args[i + 1];
+            if (themeName === undefined || themeName.startsWith("-")) {
+                result.diagnostics.push({ type: "error", message: "--use-theme requires a theme name" });
+            }
+            else {
+                result.useTheme = themeName;
+                i++;
+            }
+        }
         else if (arg === "--no-themes") {
             result.noThemes = true;
         }
@@ -272,6 +282,7 @@ ${chalk.bold("Options:")}
   --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)
   --no-prompt-templates, -np     Disable prompt template discovery and loading
   --theme <path>                 Load a theme file or directory (can be used multiple times)
+  --use-theme <name[/name]>      Set the initial interactive theme for this run
   --no-themes                    Disable theme discovery and loading
   --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading
   --export <file>                Export session file to HTML and exit

package/dist/cli/args.test.d.ts

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

package/dist/cli/args.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, test } from "vitest";
+import { parseArgs } from "./args.js";
+describe("parseArgs --use-theme", () => {
+    test("parses --use-theme with a theme name", () => {
+        const result = parseArgs(["--use-theme", "nord-border", "hello"]);
+        expect(result.useTheme).toBe("nord-border");
+        expect(result.messages).toEqual(["hello"]);
+    });
+    test("accepts light/dark slash form", () => {
+        const result = parseArgs(["--use-theme", "light/dark"]);
+        expect(result.useTheme).toBe("light/dark");
+    });
+    test("reports an error when --use-theme is missing a theme name", () => {
+        const result = parseArgs(["--use-theme"]);
+        expect(result.useTheme).toBeUndefined();
+        expect(result.diagnostics.some((d) => d.type === "error")).toBe(true);
+    });
+    test("reports an error when --use-theme precedes a flag", () => {
+        const result = parseArgs(["--use-theme", "--no-session"]);
+        expect(result.useTheme).toBeUndefined();
+        expect(result.noSession).toBe(true);
+        expect(result.diagnostics.some((d) => d.type === "error")).toBe(true);
+    });
+});

package/dist/core/agent-session.d.ts

@@ -423,6 +423,7 @@ export declare class AgentSession {
      */
     sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
         deliverAs?: "steer" | "followUp";
+        expandPromptTemplates?: boolean;
     }): Promise<void>;
     /**
      * Clear all queued messages and return them.
@@ -634,7 +635,9 @@ export declare class AgentSession {
      * @param outputPath Optional output path (defaults to session directory)
      * @returns Path to exported file
      */
-    exportToHtml(outputPath?: string): Promise<string>;
+    exportToHtml(outputPath?: string, options?: {
+        themeName?: string;
+    }): Promise<string>;
     /**
      * Export the current session branch to a JSONL file.
      * Writes the session header followed by all entries on the current branch path.

package/dist/core/agent-session.js

@@ -1133,7 +1133,7 @@ export class AgentSession {
         if (options?.deliverAs === "nextTurn") {
             this._pendingNextTurnMessages.push(appMessage);
         }
-        else if (this.isStreaming) {
+        else if (this.isStreaming && options?.triggerTurn !== false) {
             if (options?.deliverAs === "followUp") {
                 this.agent.followUp(appMessage);
             }
@@ -1180,9 +1180,9 @@ export class AgentSession {
             if (images.length === 0)
                 images = undefined;
         }
-        // Use prompt() with expandPromptTemplates: false to skip command handling and template expansion
+        // Use prompt() with expandPromptTemplates to control command handling and template expansion
         await this.prompt(text, {
-            expandPromptTemplates: false,
+            expandPromptTemplates: options?.expandPromptTemplates ?? false,
             streamingBehavior: options?.deliverAs,
             images,
             source: "extension",
@@ -2659,9 +2659,8 @@ export class AgentSession {
      * @param outputPath Optional output path (defaults to session directory)
      * @returns Path to exported file
      */
-    async exportToHtml(outputPath) {
-        const configuredThemeName = this.settingsManager.getTheme();
-        const themeName = configuredThemeName && getThemeByName(configuredThemeName) ? configuredThemeName : undefined;
+    async exportToHtml(outputPath, options = {}) {
+        const themeName = [options.themeName, this.settingsManager.getTheme()].find((candidate) => candidate !== undefined && getThemeByName(candidate) !== undefined);
         // Create tool renderer if we have an extension runner (for custom tool HTML rendering)
         const toolRenderer = createToolHtmlRenderer({
             getToolDefinition: (name) => this.getToolDefinition(name),

package/dist/core/experimental.d.ts

@@ -1 +1,5 @@
 export declare function areExperimentalFeaturesEnabled(): boolean;
+export declare function getExperimentalToolSampling(): {
+    readonly type: "json_schema";
+    readonly strict: "prefer";
+} | undefined;

package/dist/core/experimental.js

@@ -1,3 +1,7 @@
+const PREFER_STRICT_TOOL_SAMPLING = { type: "json_schema", strict: "prefer" };
 export function areExperimentalFeaturesEnabled() {
     return process.env.PI_EXPERIMENTAL === "1";
 }
+export function getExperimentalToolSampling() {
+    return areExperimentalFeaturesEnabled() ? PREFER_STRICT_TOOL_SAMPLING : undefined;
+}

package/dist/core/extensions/types.d.ts

@@ -301,6 +301,7 @@ export interface ReplacedSessionContext extends ExtensionCommandContext {
     }): Promise<void>;
     sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
         deliverAs?: "steer" | "followUp";
+        expandPromptTemplates?: boolean;
     }): Promise<void>;
 }
 /** Rendering options for tool results */
@@ -926,9 +927,11 @@ export interface ExtensionAPI {
     /**
      * Send a user message to the agent. Always triggers a turn.
      * When the agent is streaming, use deliverAs to specify how to queue the message.
+     * Set expandPromptTemplates to dispatch extension commands and expand skill commands and prompt templates.
      */
     sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
         deliverAs?: "steer" | "followUp";
+        expandPromptTemplates?: boolean;
     }): void;
     /** Append a custom entry to the session for state persistence (not sent to LLM). */
     appendEntry<T = unknown>(customType: string, data?: T): void;
@@ -1124,6 +1127,7 @@ export type SendMessageHandler = <T = unknown>(message: Pick<CustomMessage<T>, "
 }) => void;
 export type SendUserMessageHandler = (content: string | (TextContent | ImageContent)[], options?: {
     deliverAs?: "steer" | "followUp";
+    expandPromptTemplates?: boolean;
 }) => void;
 export type AppendEntryHandler = <T = unknown>(customType: string, data?: T) => void;
 export type SetSessionNameHandler = (name: string) => void;

package/dist/core/keybindings.d.ts

@@ -197,6 +197,14 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: [];
         readonly description: "Scroll viewport down half a page";
     };
+    readonly "tui.altScreen.lineUp": {
+        readonly defaultKeys: [];
+        readonly description: "Scroll viewport up one line";
+    };
+    readonly "tui.altScreen.lineDown": {
+        readonly defaultKeys: [];
+        readonly description: "Scroll viewport down one line";
+    };
     readonly "tui.altScreen.previousPrompt": {
         readonly defaultKeys: "ctrl+shift+up";
         readonly description: "Jump to previous semantic prompt";
@@ -205,6 +213,22 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+shift+down";
         readonly description: "Jump to next semantic prompt";
     };
+    readonly "tui.altScreen.search": {
+        readonly defaultKeys: "ctrl+shift+f";
+        readonly description: "Search the primary scroll view";
+    };
+    readonly "tui.altScreen.searchNext": {
+        readonly defaultKeys: ["enter", "ctrl+g"];
+        readonly description: "Select the next search match";
+    };
+    readonly "tui.altScreen.searchPrevious": {
+        readonly defaultKeys: ["shift+enter", "ctrl+shift+g"];
+        readonly description: "Select the previous search match";
+    };
+    readonly "tui.altScreen.searchClose": {
+        readonly defaultKeys: "escape";
+        readonly description: "Close transcript search";
+    };
     readonly "tui.altScreen.top": {
         readonly defaultKeys: "home";
         readonly description: "Scroll viewport to top";

package/dist/core/model-config.d.ts

@@ -98,6 +98,7 @@ declare const ModelDefinitionSchema: Type.TObject<{
         supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
         supportsStrictMode: Type.TOptional<Type.TBoolean>;
         supportsOpenAIGrammarTools: Type.TOptional<Type.TBoolean>;
+        supportsAdditionalTools: Type.TOptional<Type.TBoolean>;
         supportsToolSearch: Type.TOptional<Type.TBoolean>;
     }>, Type.TObject<{
         supportsEagerToolInputStreaming: Type.TOptional<Type.TBoolean>;
@@ -206,6 +207,7 @@ declare const ModelOverrideSchema: Type.TObject<{
         supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
         supportsStrictMode: Type.TOptional<Type.TBoolean>;
         supportsOpenAIGrammarTools: Type.TOptional<Type.TBoolean>;
+        supportsAdditionalTools: Type.TOptional<Type.TBoolean>;
         supportsToolSearch: Type.TOptional<Type.TBoolean>;
     }>, Type.TObject<{
         supportsEagerToolInputStreaming: Type.TOptional<Type.TBoolean>;
@@ -292,6 +294,7 @@ declare const ProviderConfigSchema: Type.TObject<{
         supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
         supportsStrictMode: Type.TOptional<Type.TBoolean>;
         supportsOpenAIGrammarTools: Type.TOptional<Type.TBoolean>;
+        supportsAdditionalTools: Type.TOptional<Type.TBoolean>;
         supportsToolSearch: Type.TOptional<Type.TBoolean>;
     }>, Type.TObject<{
         supportsEagerToolInputStreaming: Type.TOptional<Type.TBoolean>;
@@ -403,6 +406,7 @@ declare const ProviderConfigSchema: Type.TObject<{
             supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
             supportsStrictMode: Type.TOptional<Type.TBoolean>;
             supportsOpenAIGrammarTools: Type.TOptional<Type.TBoolean>;
+            supportsAdditionalTools: Type.TOptional<Type.TBoolean>;
             supportsToolSearch: Type.TOptional<Type.TBoolean>;
         }>, Type.TObject<{
             supportsEagerToolInputStreaming: Type.TOptional<Type.TBoolean>;
@@ -511,6 +515,7 @@ declare const ProviderConfigSchema: Type.TObject<{
             supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
             supportsStrictMode: Type.TOptional<Type.TBoolean>;
             supportsOpenAIGrammarTools: Type.TOptional<Type.TBoolean>;
+            supportsAdditionalTools: Type.TOptional<Type.TBoolean>;
             supportsToolSearch: Type.TOptional<Type.TBoolean>;
         }>, Type.TObject<{
             supportsEagerToolInputStreaming: Type.TOptional<Type.TBoolean>;

package/dist/core/model-config.js

@@ -96,6 +96,7 @@ const OpenAIResponsesCompatSchema = Type.Object({
     supportsLongCacheRetention: Type.Optional(Type.Boolean()),
     supportsStrictMode: Type.Optional(Type.Boolean()),
     supportsOpenAIGrammarTools: Type.Optional(Type.Boolean()),
+    supportsAdditionalTools: Type.Optional(Type.Boolean()),
     supportsToolSearch: Type.Optional(Type.Boolean()),
 });
 const AnthropicMessagesCompatSchema = Type.Object({

package/dist/core/project-trust.js

@@ -1,8 +1,8 @@
-import { CONFIG_DIR_NAME } from "../config.js";
+import { APP_NAME, CONFIG_DIR_NAME } from "../config.js";
 import { emitProjectTrustEvent } from "./extensions/runner.js";
 import { getProjectTrustOptions, hasTrustRequiringProjectResources, } from "./trust-manager.js";
 function formatProjectTrustPrompt(cwd) {
-    return `Trust project folder?\n${cwd}\n\nThis allows selesai to load ${CONFIG_DIR_NAME} settings and resources, install missing project packages, and execute project extensions.`;
+    return `Trust project folder?\n${cwd}\n\nThis allows ${APP_NAME} to load ${CONFIG_DIR_NAME} settings and resources, install missing project packages, and execute project extensions.`;
 }
 async function selectProjectTrustOption(cwd, ctx) {
     const options = getProjectTrustOptions(cwd, { includeSessionOnly: true });

package/dist/core/sdk.d.ts

@@ -34,9 +34,11 @@ export interface CreateAgentSessionOptions {
     /**
      * Optional allowlist of tool names.
      *
-     * When omitted, pi enables the default built-in tools (read, bash, edit, write)
-     * and leaves extension/custom tools enabled unless `noTools` changes that default.
-     * When provided, only the listed tool names are enabled.
+     * When omitted, pi uses the `defaultTools` setting for the initial built-in
+     * selection when configured. Otherwise it enables the default built-in tools
+     * (read, bash, edit, write). Extension/custom tools remain enabled unless
+     * `noTools` changes that default. When provided, only the listed tool names are
+     * enabled.
      */
     tools?: string[];
     /** Optional denylist of tool names to disable. Applies after `tools` when both are provided. */

package/dist/core/sdk.js

@@ -130,10 +130,11 @@ export async function createAgentSession(options = {}) {
         thinkingLevel = clampThinkingLevel(model, thinkingLevel);
     }
     const defaultActiveToolNames = ["read", "bash", "edit", "write"];
+    const configuredDefaultToolNames = settingsManager.getDefaultTools();
     const allowedToolNames = options.tools ?? (options.noTools === "all" ? [] : undefined);
     const excludedToolNames = options.excludeTools;
     const excludedToolNameSet = excludedToolNames ? new Set(excludedToolNames) : undefined;
-    const initialActiveToolNames = (options.tools ? [...options.tools] : options.noTools ? [] : defaultActiveToolNames).filter((name) => !excludedToolNameSet?.has(name));
+    const initialActiveToolNames = (options.tools ?? (options.noTools ? [] : (configuredDefaultToolNames ?? defaultActiveToolNames))).filter((name) => !excludedToolNameSet?.has(name));
     let agent;
     // Create convertToLlm wrapper that filters images if blockImages is enabled (defense-in-depth)
     const convertToLlmWithBlockImages = (messages) => {

package/dist/core/session-manager.js

@@ -5,7 +5,7 @@ import { readdir, stat } from "fs/promises";
 import { join, resolve } from "path";
 import { createInterface } from "readline";
 import { StringDecoder } from "string_decoder";
-import { getAgentDir as getDefaultAgentDir, getSessionsDir } from "../config.js";
+import { APP_NAME, getAgentDir as getDefaultAgentDir, getSessionsDir } from "../config.js";
 import { normalizePath, resolvePath } from "../utils/paths.js";
 import { createBranchSummaryMessage, createCompactionSummaryMessage, createCustomMessage, } from "./messages.js";
 export const CURRENT_SESSION_VERSION = 3;
@@ -620,7 +620,7 @@ export class SessionManager {
             if (this.fileEntries.length === 0) {
                 const explicitPath = this.sessionFile;
                 if (statSync(explicitPath).size > 0) {
-                    throw new Error(`Session file is not a valid pi session: ${explicitPath}`);
+                    throw new Error(`Session file is not a valid ${APP_NAME} session: ${explicitPath}`);
                 }
                 this.newSession();
                 this.sessionFile = explicitPath;

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

@@ -22,6 +22,7 @@ export interface RetrySettings {
     provider?: ProviderRetrySettings;
 }
 export type TuiMode = RendererTuiMode;
+export type FullscreenExitOutput = "transcript" | "resume-hint";
 export interface TerminalSettings {
     showImages?: boolean;
     imageWidthCells?: number;
@@ -97,6 +98,8 @@ export interface Settings {
     agents?: string[];
     terminal?: TerminalSettings;
     tuiMode?: TuiMode;
+    defaultTools?: string[];
+    fullscreenExitOutput?: FullscreenExitOutput;
     fullscreenScrollbar?: ScrollViewScrollbar;
     images?: ImageSettings;
     enabledModels?: string[];
@@ -288,11 +291,14 @@ export declare class SettingsManager {
     setTuiMode(mode: TuiMode): void;
     getFullscreenScrollbar(): ScrollViewScrollbar;
     setFullscreenScrollbar(mode: ScrollViewScrollbar): void;
+    getFullscreenExitOutput(): FullscreenExitOutput;
+    setFullscreenExitOutput(output: FullscreenExitOutput): void;
     getImageAutoResize(): boolean;
     setImageAutoResize(enabled: boolean): void;
     getBlockImages(): boolean;
     setBlockImages(blocked: boolean): void;
     getEnabledModels(): string[] | undefined;
+    getDefaultTools(): string[] | undefined;
     setEnabledModels(patterns: string[] | undefined): void;
     getDoubleEscapeAction(): "fork" | "tree" | "none";
     setDoubleEscapeAction(action: "fork" | "tree" | "none"): void;

package/dist/core/settings-manager.js

@@ -837,6 +837,14 @@ export class SettingsManager {
         this.markModified("fullscreenScrollbar");
         this.save();
     }
+    getFullscreenExitOutput() {
+        return this.settings.fullscreenExitOutput === "resume-hint" ? "resume-hint" : "transcript";
+    }
+    setFullscreenExitOutput(output) {
+        this.globalSettings.fullscreenExitOutput = output;
+        this.markModified("fullscreenExitOutput");
+        this.save();
+    }
     getImageAutoResize() {
         return this.settings.images?.autoResize ?? true;
     }
@@ -862,6 +870,10 @@ export class SettingsManager {
     getEnabledModels() {
         return this.settings.enabledModels;
     }
+    getDefaultTools() {
+        const tools = this.settings.defaultTools;
+        return tools ? [...tools] : undefined;
+    }
     setEnabledModels(patterns) {
         this.globalSettings.enabledModels = patterns;
         this.markModified("enabledModels");

package/dist/core/system-prompt.js

@@ -51,7 +51,7 @@ export function buildSystemPrompt(options) {
         if (activeGuidelines.length > 0) {
             prompt += `\n\nActive tool guidelines:\n${activeGuidelines.map((guideline) => `- ${guideline}`).join("\n")}`;
         }
-        prompt += `\nCurrent working directory: ${promptCwd}`;
+        prompt += `\nCurrent working directory: ${promptCwd}\n`;
         return prompt;
     }
     // Get absolute paths to documentation and examples

package/dist/core/tools/bash.js

@@ -7,6 +7,7 @@ import { keyHint } from "../../modes/interactive/components/keybinding-hints.js"
 import { truncateToVisualLines } from "../../modes/interactive/components/visual-truncate.js";
 import { theme } from "../../modes/interactive/theme/theme.js";
 import { waitForChildProcess } from "../../utils/child-process.js";
+import { getExperimentalToolSampling } from "../experimental.js";
 import { getShellConfig, getShellEnv, killProcessTree, trackDetachedChildPid, untrackDetachedChildPid, } from "../../utils/shell.js";
 import { OutputAccumulator } from "./output-accumulator.js";
 import { getTextOutput, invalidArgText, str } from "./render-utils.js";
@@ -232,6 +233,7 @@ export function createBashToolDefinition(cwd, options) {
             ? ["Inspect PI_* environment variables for current model and session details."]
             : undefined,
         parameters: bashSchema,
+        constrainedSampling: getExperimentalToolSampling(),
         async execute(_toolCallId, { command, timeout }, signal, onUpdate, ctx) {
             const resolvedCommand = commandPrefix ? `${commandPrefix}\n${command}` : command;
             const spawnContext = resolveSpawnContext(resolvedCommand, cwd, spawnHook, exposeSessionEnvironment, ctx);

package/dist/core/tools/edit.js

@@ -3,6 +3,7 @@ import { constants } from "fs";
 import { access as fsAccess, readFile as fsReadFile, writeFile as fsWriteFile } from "fs/promises";
 import { Type } from "typebox";
 import { renderDiff } from "../../modes/interactive/components/diff.js";
+import { getExperimentalToolSampling } from "../experimental.js";
 import { applyEditsToNormalizedContent, computeEditsDiff, detectLineEnding, generateDiffString, generateUnifiedPatch, normalizeToLF, restoreLineEndings, stripBom, } from "./edit-diff.js";
 import { withFileMutationQueue } from "./file-mutation-queue.js";
 import { resolveToCwd } from "./path-utils.js";
@@ -169,6 +170,7 @@ export function createEditToolDefinition(cwd, options) {
             "Keep edits[].oldText as small as possible while still being unique in the file. Do not pad with large unchanged regions.",
         ],
         parameters: editSchema,
+        constrainedSampling: getExperimentalToolSampling(),
         renderShell: "self",
         prepareArguments: prepareEditArguments,
         async execute(_toolCallId, input, signal, _onUpdate, _ctx) {

package/dist/core/tools/find.js

@@ -154,7 +154,7 @@ export function createFindToolDefinition(cwd, options) {
                             return;
                         }
                         // Default implementation uses fd.
-                        const fdPath = await ensureTool("fd", true);
+                        const fdPath = await ensureTool("fd");
                         if (signal?.aborted) {
                             settle(() => reject(new Error("Operation aborted")));
                             return;

package/dist/core/tools/grep.js

@@ -92,7 +92,7 @@ export function createGrepToolDefinition(cwd, options) {
                 };
                 (async () => {
                     try {
-                        const rgPath = await ensureTool("rg", true);
+                        const rgPath = await ensureTool("rg");
                         if (!rgPath) {
                             settle(() => reject(new Error("ripgrep (rg) is not available and could not be downloaded")));
                             return;

package/dist/core/tools/read.js

@@ -9,6 +9,7 @@ import { getLanguageFromPath, highlightCode } from "../../modes/interactive/them
 import { processImage } from "../../utils/image-process.js";
 import { detectSupportedImageMimeTypeFromFile } from "../../utils/mime.js";
 import { formatPathRelativeToCwdOrAbsolute } from "../../utils/paths.js";
+import { getExperimentalToolSampling } from "../experimental.js";
 import { resolveReadPathAsync, resolveToCwd } from "./path-utils.js";
 import { getTextOutput, renderToolPath, replaceTabs, str } from "./render-utils.js";
 import { wrapToolDefinition } from "./tool-definition-wrapper.js";
@@ -137,6 +138,7 @@ export function createReadToolDefinition(cwd, options) {
         promptSnippet: "Read file contents",
         promptGuidelines: ["Use read to examine files instead of cat or sed."],
         parameters: readSchema,
+        constrainedSampling: getExperimentalToolSampling(),
         async execute(_toolCallId, { path, offset, limit }, signal, _onUpdate, ctx) {
             return new Promise((resolve, reject) => {
                 if (signal?.aborted) {

package/dist/core/tools/write.js

@@ -4,6 +4,7 @@ import { dirname } from "path";
 import { Type } from "typebox";
 import { keyHint } from "../../modes/interactive/components/keybinding-hints.js";
 import { getLanguageFromPath, highlightCode } from "../../modes/interactive/theme/theme.js";
+import { getExperimentalToolSampling } from "../experimental.js";
 import { withFileMutationQueue } from "./file-mutation-queue.js";
 import { resolveToCwd } from "./path-utils.js";
 import { normalizeDisplayText, renderToolPath, replaceTabs, str } from "./render-utils.js";
@@ -137,6 +138,7 @@ export function createWriteToolDefinition(cwd, options) {
         promptSnippet: "Create or overwrite files",
         promptGuidelines: ["Use write only for new files or complete rewrites."],
         parameters: writeSchema,
+        constrainedSampling: getExperimentalToolSampling(),
         async execute(_toolCallId, { path, content }, signal, _onUpdate, _ctx) {
             const absolutePath = resolveToCwd(path, cwd);
             const dir = dirname(absolutePath);

package/dist/extensions/pi-subagents/src/runs/background/result-watcher.ts

@@ -29,7 +29,6 @@ const WATCHER_RESTART_DELAY_MS = 3000;
 const POLL_INTERVAL_MS = 3000;
 const HEALTHY_SCAN_INTERVAL_MS = 60_000;
 const RETRY_DELAY_MS = 100;
-const SLOW_RESULT_SCAN_MS = 500;
 
 type ResultWatcherFs = Pick<typeof fs, "existsSync" | "readFileSync" | "unlinkSync" | "readdirSync" | "mkdirSync" | "realpathSync" | "statSync" | "watch">;
 
@@ -92,12 +91,6 @@ type ResultFileIdentity = {
 	asyncDir?: string;
 };
 
-interface ResultScanStats {
-	files: number;
-	scheduled: number;
-	startedAt: number;
-}
-
 function jsonStringProperty(raw: string, property: string): string | undefined {
 	const matches = raw.matchAll(new RegExp(`"${property}"\\s*:\\s*("(?:\\\\.|[^"\\\\])*")`, "g"));
 	let encoded: string | undefined;
@@ -547,11 +540,6 @@ export function createResultWatcher(
 		void handleResult(file, triggerTurn);
 	}, deps.coalesceDelayMs ?? 50);
 
-	const logScanStats = (stats: ResultScanStats) => {
-		const elapsed = Date.now() - stats.startedAt;
-		if (elapsed < SLOW_RESULT_SCAN_MS) return;
-		console.error(`Subagent result scan inspected ${stats.files} indexed result file(s), scheduled ${stats.scheduled} in ${elapsed}ms (${resultsDir}).`);
-	};
 	const indexedResultCandidates = (observed: ReadonlySet<string>): string[] => {
 		const files = new Set<string>();
 		if (state.currentSessionId) {
@@ -565,14 +553,11 @@ export function createResultWatcher(
 	const primeExistingResults = (options: { triggerTurn?: boolean } = {}) => {
 		try {
 			const triggerTurn = options.triggerTurn !== false;
-			const stats: ResultScanStats = { files: 0, scheduled: 0, startedAt: Date.now() };
 			const observed = observedRunIds();
 			for (const file of indexedResultCandidates(observed)) {
-				stats.files += 1;
 				const signature = resultSignature(file, observed);
 				if (!signature) continue;
 				if (!shouldProcessResult(file, observed, signature)) continue;
-				stats.scheduled += 1;
 				scheduleResult(file, triggerTurn);
 			}
 			// Selesai fork: during the lineage adoption window, also scan flat
@@ -584,15 +569,12 @@ export function createResultWatcher(
 				const indexed = indexedResultCandidates(observed);
 				for (const file of fsApi.readdirSync(resultsDir)) {
 					if (!file.endsWith(".json") || indexed.includes(file)) continue;
-					stats.files += 1;
 					const signature = resultSignature(file, observed);
 					if (!signature) continue;
 					if (!shouldProcessResult(file, observed, signature)) continue;
-					stats.scheduled += 1;
 					scheduleResult(file, triggerTurn);
 				}
 			}
-			logScanStats(stats);
 		} catch (error) {
 			if (!isNotFound(error)) console.error(`Failed to scan subagent result index in '${resultsDir}':`, error);
 		}

package/dist/extensions/pi-subagents/test/integration/result-watcher.test.ts

@@ -126,6 +126,32 @@ describe("result watcher", () => {
 		}
 	});
 
+	it("keeps slow indexed result scans silent", () => {
+		const resultsDir = fs.mkdtempSync(path.join(os.tmpdir(), "pi-result-watcher-slow-scan-"));
+		const originalNow = Date.now;
+		const originalError = console.error;
+		const logged: unknown[][] = [];
+		try {
+			const state = createState();
+			state.currentSessionId = "session-current";
+			state.asyncJobs.set("slow-scan", { asyncId: "slow-scan", asyncDir: path.join(resultsDir, "slow-scan"), status: "running", startedAt: 0, updatedAt: 0 });
+			let nowCalls = 0;
+			Date.now = () => nowCalls++ === 0 ? 0 : 501;
+			console.error = (...args: unknown[]) => { logged.push(args); };
+			const watcher = createResultWatcher({ events: { on: () => () => {}, emit() {} } }, state, resultsDir, 60_000);
+			try {
+				watcher.primeExistingResults();
+			} finally {
+				watcher.stopResultWatcher();
+			}
+			assert.deepEqual(logged, []);
+		} finally {
+			Date.now = originalNow;
+			console.error = originalError;
+			fs.rmSync(resultsDir, { recursive: true, force: true });
+		}
+	});
+
 	it("skips full parsing for unrelated sessions during priming, safety scans, and native watch events", async () => {
 		const resultsDir = fs.mkdtempSync(path.join(os.tmpdir(), "pi-result-watcher-filter-"));
 		try {

package/dist/extensions/tokenin-onboarding.ts

@@ -15,7 +15,7 @@ import { getAgentDir, getModelsPath } from "@selesai/code";
 import type { AuthStorage, ExtensionAPI, ExtensionCommandContext, ExtensionContext, SessionStartEvent } from "@selesai/code";
 
 export const TOKEN_IN_PROVIDER = "tokenin";
-export const TOKEN_IN_DASHBOARD_URL = "https://token-in.selesai.in/dashboard/tokens";
+export const TOKEN_IN_DASHBOARD_URL = "https://token.selesai.in/dashboard/tokens";
 export const ONBOARDING_MARKER_NAME = ".tokenInOnboardingComplete";
 export const PLACEHOLDER_API_KEY = "sk-xxx";
 

package/dist/index.d.ts

@@ -18,7 +18,7 @@ export type { ResourceCollision, ResourceDiagnostic, ResourceLoader } from "./co
 export { DefaultResourceLoader, loadProjectContextFiles } from "./core/resource-loader.ts";
 export { AgentSessionRuntime, type AgentSessionRuntimeDiagnostic, type AgentSessionServices, type CreateAgentSessionFromServicesOptions, type CreateAgentSessionOptions, type CreateAgentSessionResult, type CreateAgentSessionRuntimeFactory, type CreateAgentSessionRuntimeResult, type CreateAgentSessionServicesOptions, createAgentSession, createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, createBashTool, createCodingTools, createEditTool, createFindTool, createGrepTool, createLsTool, createReadOnlyTools, createReadTool, createWriteTool, type PromptTemplate, } from "./core/sdk.ts";
 export { type BranchSummaryEntry, buildContextEntries, buildSessionContext, type CompactionEntry, CURRENT_SESSION_VERSION, type CustomEntry, type CustomMessageEntry, type FileEntry, getLatestCompactionEntry, type ModelChangeEntry, migrateSessionEntries, type NewSessionOptions, parseSessionEntries, type SessionContext, type SessionEntry, type SessionEntryBase, type SessionHeader, type SessionInfo, type SessionInfoEntry, SessionManager, type SessionMessageEntry, type SessionTreeNode, sessionEntryToContextMessages, type ThinkingLevelChangeEntry, } from "./core/session-manager.ts";
-export { type AutoHandoffSettings, type CompactionSettings, type DefaultProjectTrust, type ImageSettings, type PackageSource, type RetrySettings, SettingsManager, type SettingsManagerCreateOptions, type TuiMode, } from "./core/settings-manager.ts";
+export { type AutoHandoffSettings, type CompactionSettings, type DefaultProjectTrust, type FullscreenExitOutput, type ImageSettings, type PackageSource, type RetrySettings, SettingsManager, type SettingsManagerCreateOptions, type TuiMode, } from "./core/settings-manager.ts";
 export { formatSkillsForPrompt, type LoadSkillsFromDirOptions, type LoadSkillsResult, loadSkills, loadSkillsFromDir, type Skill, type SkillFrontmatter, } from "./core/skills.ts";
 export { createSyntheticSourceInfo } from "./core/source-info.ts";
 export { type EditDiffResult, generateDiffString, generateUnifiedPatch } from "./core/tools/edit-diff.ts";

package/dist/main.js

@@ -491,6 +491,9 @@ export async function main(args, options) {
         await showFirstTimeSetup(startupSettingsManager);
         time("firstTimeSetup");
     }
+    if (appMode === "interactive" && parsed.useTheme !== undefined) {
+        startupSettingsManager.applyOverrides({ theme: parsed.useTheme });
+    }
     // Decide the final runtime cwd before creating cwd-bound runtime services.
     // --session and --resume may select a session from another project, so project-local
     // settings, resources, provider registrations, and models must be resolved only after
@@ -723,6 +726,7 @@ export async function main(args, options) {
             initialMessages: parsed.messages,
             verbose: parsed.verbose,
             tuiMode: parsed.tuiMode,
+            initialThemeSetting: parsed.useTheme,
         });
         if (startupBenchmark) {
             await interactiveMode.init();