@selesai/code 0.10.2 → 0.12.0

package/dist/extensions/web-agent-onboarding.ts

@@ -1,222 +1,222 @@
-/**
- * Web-Agent first-run onboarding extension.
- *
- * On the first interactive session, ask the user whether they want to use Brave
- * Search. If yes, open the Brave API key dashboard, collect the pasted key, and
- * persist it in ~/.selesai/agent/settings.json under webAgent.braveApiKey, then
- * configure the bundled pi-web-agent backend to use Brave (with DuckDuckGo fallback).
- * If no, the extension falls back to pi-web-agent's default DuckDuckGo backend.
- *
- * Mirrors src/extensions/tokenin-onboarding.ts.
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { getAgentDir, getSettingsPath } from "@selesai/code";
-import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, SessionStartEvent } from "@selesai/code";
-
-export type OnboardingResult =
-	| { kind: "saved" }
-	| { kind: "skipped" }
-	| { kind: "deferred" }
-	| { kind: "error"; message: string };
-
-export const BRAVE_KEYS_URL = "https://api-dashboard.search.brave.com/app/keys";
-export const ONBOARDING_MARKER_NAME = ".webAgentOnboardingComplete";
-export const WEB_AGENT_CONFIG_SUBPATH = join("extensions", "pi-web-agent", "config.json");
-
-// ponytail: duplicated ~15 lines of marker-file + browser-open logic from
-// tokenin-onboarding.ts rather than extracting a shared module nobody asked for.
-// Ceiling: if a third onboarding extension appears, extract a shared helper then.
-
-/** Read and parse the current settings.json, returning a deep-ish mutable object. */
-export function readSettingsJson(settingsPath: string = getSettingsPath()): Record<string, unknown> {
-	try {
-		const raw = readFileSync(settingsPath, "utf-8");
-		return JSON.parse(raw) as Record<string, unknown>;
-	} catch {
-		return {};
-	}
-}
-
-/** Write settings.json back to disk atomically-ish with a trailing newline. */
-export function writeSettingsJson(settings: Record<string, unknown>, settingsPath: string = getSettingsPath()): void {
-	mkdirSync(dirname(settingsPath), { recursive: true });
-	writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`, "utf-8");
-}
-
-/**
- * Return true if the Brave key value is missing, empty. We prompt again for any
- * non-key value.
- */
-export function isPlaceholderKey(apiKey: unknown): boolean {
-	if (apiKey === undefined || apiKey === null) return true;
-	if (typeof apiKey !== "string") return true;
-	return apiKey.trim() === "";
-}
-
-/** Return the current webAgent.braveApiKey value from settings.json. */
-export function getBraveApiKey(settings: Record<string, unknown>): unknown {
-	const webAgent = settings.webAgent;
-	if (!webAgent || typeof webAgent !== "object" || Array.isArray(webAgent)) return undefined;
-	return (webAgent as Record<string, unknown>).braveApiKey;
-}
-
-/** Return a new settings object with webAgent.braveApiKey set to key. */
-export function setBraveApiKey(settings: Record<string, unknown>, key: string): Record<string, unknown> {
-	const next = JSON.parse(JSON.stringify(settings)) as Record<string, unknown>;
-	if (!next.webAgent || typeof next.webAgent !== "object" || Array.isArray(next.webAgent)) {
-		next.webAgent = {};
-	}
-	const webAgent = next.webAgent as Record<string, unknown>;
-	webAgent.braveApiKey = key;
-	return next;
-}
-
-/** Validate a pasted Brave key. Returns normalized key or an error message. */
-export function validateBraveKey(raw: string | undefined): { key?: string; error?: string } {
-	if (raw === undefined || raw === null) return { error: "No key entered." };
-	const trimmed = raw.trim();
-	if (trimmed === "") return { error: "Key cannot be empty." };
-	return { key: trimmed };
-}
-
-/** Path to the pi-web-agent global backend config (matches vendored config-store). */
-export function getWebAgentConfigPath(agentDir: string = getAgentDir()): string {
-	return join(agentDir, WEB_AGENT_CONFIG_SUBPATH);
-}
-
-/** Write pi-web-agent backend config selecting brave (with duckduckgo fallback). */
-export function writeWebAgentBraveBackendConfig(agentDir: string = getAgentDir()): void {
-	const configPath = getWebAgentConfigPath(agentDir);
-	mkdirSync(dirname(configPath), { recursive: true });
-	// Merge into any existing config so we don't clobber presentation settings.
-	let existing: Record<string, unknown> = {};
-	try {
-		existing = JSON.parse(readFileSync(configPath, "utf-8")) as Record<string, unknown>;
-	} catch {
-		// ENOENT or invalid JSON — start fresh.
-	}
-	const next = existing;
-	const backends = (next.backends ?? {}) as Record<string, unknown>;
-	(backends as Record<string, unknown>).search = { provider: "brave", fallback: "duckduckgo" };
-	next.backends = backends;
-	writeFileSync(configPath, `${JSON.stringify(next, null, 2)}\n`, "utf-8");
-}
-
-function getOnboardingMarkerPath(agentDir: string = getAgentDir()): string {
-	return join(agentDir, ONBOARDING_MARKER_NAME);
-}
-
-function markOnboardingComplete(agentDir: string = getAgentDir()): void {
-	writeFileSync(getOnboardingMarkerPath(agentDir), "1", "utf-8");
-}
-
-function isOnboardingComplete(agentDir: string = getAgentDir()): boolean {
-	return existsSync(getOnboardingMarkerPath(agentDir));
-}
-
-async function openBraveKeysUrl(pi: ExtensionAPI): Promise<void> {
-	const url = BRAVE_KEYS_URL;
-	let command: string;
-	let args: string[];
-	if (process.platform === "darwin") {
-		command = "open";
-		args = [url];
-	} else if (process.platform === "win32") {
-		command = "cmd";
-		args = ["/c", "start", "", url];
-	} else {
-		command = "xdg-open";
-		args = [url];
-	}
-	const result = await pi.exec(command, args, { timeout: 10_000 });
-	if (result.code !== 0) {
-		throw new Error(`Failed to open ${url}: ${result.stderr || result.stdout || "unknown error"}`);
-	}
-}
-
-async function promptForKey(ctx: ExtensionContext): Promise<string | undefined> {
-	return ctx.ui.input("Paste your Brave API key", "");
-}
-
-async function runOnboarding(pi: ExtensionAPI, ctx: ExtensionContext): Promise<OnboardingResult> {
-	const settingsPath = getSettingsPath();
-	const settings = readSettingsJson(settingsPath);
-	const currentKey = getBraveApiKey(settings);
-
-	// Already configured? Mark complete and skip.
-	if (!isPlaceholderKey(currentKey)) {
-		markOnboardingComplete();
-		return { kind: "deferred" };
-	}
-
-	// No UI? Defer to a later session.
-	if (!ctx.hasUI) {
-		return { kind: "deferred" };
-	}
-
-	const wantsBrave = await ctx.ui.confirm(
-		"Use Brave Search?",
-		"Brave gives reliable web results for the web_explore tool. You can get an API key at https://api-dashboard.search.brave.com/app/keys. Use Brave now?",
-	);
-
-	if (!wantsBrave) {
-		markOnboardingComplete();
-		ctx.ui.notify("Brave skipped — web search will use the default DuckDuckGo backend.", "info");
-		return { kind: "skipped" };
-	}
-
-	try {
-		await openBraveKeysUrl(pi);
-		ctx.ui.notify("Opened the Brave API key dashboard in your browser.", "info");
-	} catch (err) {
-		const message = err instanceof Error ? err.message : String(err);
-		ctx.ui.notify(`Could not open browser: ${message}`, "warning");
-		ctx.ui.notify(`Open this URL manually: ${BRAVE_KEYS_URL}`, "info");
-	}
-
-	const rawKey = await promptForKey(ctx);
-	const validated = validateBraveKey(rawKey);
-
-	if (validated.error) {
-		ctx.ui.notify(validated.error, "warning");
-		// Do not mark complete so the prompt retries on next launch.
-		return { kind: "deferred" };
-	}
-
-	const updated = setBraveApiKey(settings, validated.key!);
-	writeSettingsJson(updated, settingsPath);
-	// Select Brave as the pi-web-agent search backend (DuckDuckGo fallback).
-	writeWebAgentBraveBackendConfig();
-	markOnboardingComplete();
-
-	ctx.ui.notify("Brave API key saved — web search will use Brave.", "info");
-	return { kind: "saved" };
-}
-
-export default function webAgentOnboardingExtension(pi: ExtensionAPI): void {
-	pi.on("session_start", async (event: SessionStartEvent, ctx: ExtensionContext) => {
-		if (event.reason !== "startup") return;
-		if (isOnboardingComplete()) return;
-
-		// Avoid prompting during tests or non-interactive runs.
-		if (process.env.SELESAI_SKIP_WEB_AGENT_ONBOARDING === "1") return;
-
-		await runOnboarding(pi, ctx);
-	});
-
-	// ponytail: command reuses runOnboarding() instead of duplicating the flow.
-	// On "saved" -> ctx.reload() so pi-web-agent re-applies the Brave backend config.
-	// On skipped/deferred -> no reload (nothing changed). The post-reload session_start
-	// fires with reason "reload" but the auto handler only acts on "startup", so no double prompt.
-	pi.registerCommand("setup-web-search", {
-		description: "Re-run the Brave Search onboarding flow, then reload extensions",
-		handler: async (_args: string, ctx: ExtensionCommandContext) => {
-			const result = await runOnboarding(pi, ctx);
-			if (result.kind === "saved") {
-				ctx.ui.notify("Brave key saved — reloading extensions…", "info");
-				await ctx.reload();
-			}
-		},
-	});
-}
+/**
+ * Web-Agent first-run onboarding extension.
+ *
+ * On the first interactive session, ask the user whether they want to use Brave
+ * Search. If yes, open the Brave API key dashboard, collect the pasted key, and
+ * persist it in ~/.selesai/agent/settings.json under webAgent.braveApiKey, then
+ * configure the bundled pi-web-agent backend to use Brave (with DuckDuckGo fallback).
+ * If no, the extension falls back to pi-web-agent's default DuckDuckGo backend.
+ *
+ * Mirrors src/extensions/tokenin-onboarding.ts.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getAgentDir, getSettingsPath } from "@selesai/code";
+import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, SessionStartEvent } from "@selesai/code";
+
+export type OnboardingResult =
+	| { kind: "saved" }
+	| { kind: "skipped" }
+	| { kind: "deferred" }
+	| { kind: "error"; message: string };
+
+export const BRAVE_KEYS_URL = "https://api-dashboard.search.brave.com/app/keys";
+export const ONBOARDING_MARKER_NAME = ".webAgentOnboardingComplete";
+export const WEB_AGENT_CONFIG_SUBPATH = join("extensions", "pi-web-agent", "config.json");
+
+// ponytail: duplicated ~15 lines of marker-file + browser-open logic from
+// tokenin-onboarding.ts rather than extracting a shared module nobody asked for.
+// Ceiling: if a third onboarding extension appears, extract a shared helper then.
+
+/** Read and parse the current settings.json, returning a deep-ish mutable object. */
+export function readSettingsJson(settingsPath: string = getSettingsPath()): Record<string, unknown> {
+	try {
+		const raw = readFileSync(settingsPath, "utf-8");
+		return JSON.parse(raw) as Record<string, unknown>;
+	} catch {
+		return {};
+	}
+}
+
+/** Write settings.json back to disk atomically-ish with a trailing newline. */
+export function writeSettingsJson(settings: Record<string, unknown>, settingsPath: string = getSettingsPath()): void {
+	mkdirSync(dirname(settingsPath), { recursive: true });
+	writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`, "utf-8");
+}
+
+/**
+ * Return true if the Brave key value is missing, empty. We prompt again for any
+ * non-key value.
+ */
+export function isPlaceholderKey(apiKey: unknown): boolean {
+	if (apiKey === undefined || apiKey === null) return true;
+	if (typeof apiKey !== "string") return true;
+	return apiKey.trim() === "";
+}
+
+/** Return the current webAgent.braveApiKey value from settings.json. */
+export function getBraveApiKey(settings: Record<string, unknown>): unknown {
+	const webAgent = settings.webAgent;
+	if (!webAgent || typeof webAgent !== "object" || Array.isArray(webAgent)) return undefined;
+	return (webAgent as Record<string, unknown>).braveApiKey;
+}
+
+/** Return a new settings object with webAgent.braveApiKey set to key. */
+export function setBraveApiKey(settings: Record<string, unknown>, key: string): Record<string, unknown> {
+	const next = JSON.parse(JSON.stringify(settings)) as Record<string, unknown>;
+	if (!next.webAgent || typeof next.webAgent !== "object" || Array.isArray(next.webAgent)) {
+		next.webAgent = {};
+	}
+	const webAgent = next.webAgent as Record<string, unknown>;
+	webAgent.braveApiKey = key;
+	return next;
+}
+
+/** Validate a pasted Brave key. Returns normalized key or an error message. */
+export function validateBraveKey(raw: string | undefined): { key?: string; error?: string } {
+	if (raw === undefined || raw === null) return { error: "No key entered." };
+	const trimmed = raw.trim();
+	if (trimmed === "") return { error: "Key cannot be empty." };
+	return { key: trimmed };
+}
+
+/** Path to the pi-web-agent global backend config (matches vendored config-store). */
+export function getWebAgentConfigPath(agentDir: string = getAgentDir()): string {
+	return join(agentDir, WEB_AGENT_CONFIG_SUBPATH);
+}
+
+/** Write pi-web-agent backend config selecting brave (with duckduckgo fallback). */
+export function writeWebAgentBraveBackendConfig(agentDir: string = getAgentDir()): void {
+	const configPath = getWebAgentConfigPath(agentDir);
+	mkdirSync(dirname(configPath), { recursive: true });
+	// Merge into any existing config so we don't clobber presentation settings.
+	let existing: Record<string, unknown> = {};
+	try {
+		existing = JSON.parse(readFileSync(configPath, "utf-8")) as Record<string, unknown>;
+	} catch {
+		// ENOENT or invalid JSON — start fresh.
+	}
+	const next = existing;
+	const backends = (next.backends ?? {}) as Record<string, unknown>;
+	(backends as Record<string, unknown>).search = { provider: "brave", fallback: "duckduckgo" };
+	next.backends = backends;
+	writeFileSync(configPath, `${JSON.stringify(next, null, 2)}\n`, "utf-8");
+}
+
+function getOnboardingMarkerPath(agentDir: string = getAgentDir()): string {
+	return join(agentDir, ONBOARDING_MARKER_NAME);
+}
+
+function markOnboardingComplete(agentDir: string = getAgentDir()): void {
+	writeFileSync(getOnboardingMarkerPath(agentDir), "1", "utf-8");
+}
+
+function isOnboardingComplete(agentDir: string = getAgentDir()): boolean {
+	return existsSync(getOnboardingMarkerPath(agentDir));
+}
+
+async function openBraveKeysUrl(pi: ExtensionAPI): Promise<void> {
+	const url = BRAVE_KEYS_URL;
+	let command: string;
+	let args: string[];
+	if (process.platform === "darwin") {
+		command = "open";
+		args = [url];
+	} else if (process.platform === "win32") {
+		command = "cmd";
+		args = ["/c", "start", "", url];
+	} else {
+		command = "xdg-open";
+		args = [url];
+	}
+	const result = await pi.exec(command, args, { timeout: 10_000 });
+	if (result.code !== 0) {
+		throw new Error(`Failed to open ${url}: ${result.stderr || result.stdout || "unknown error"}`);
+	}
+}
+
+async function promptForKey(ctx: ExtensionContext): Promise<string | undefined> {
+	return ctx.ui.input("Paste your Brave API key", "");
+}
+
+async function runOnboarding(pi: ExtensionAPI, ctx: ExtensionContext): Promise<OnboardingResult> {
+	const settingsPath = getSettingsPath();
+	const settings = readSettingsJson(settingsPath);
+	const currentKey = getBraveApiKey(settings);
+
+	// Already configured? Mark complete and skip.
+	if (!isPlaceholderKey(currentKey)) {
+		markOnboardingComplete();
+		return { kind: "deferred" };
+	}
+
+	// No UI? Defer to a later session.
+	if (!ctx.hasUI) {
+		return { kind: "deferred" };
+	}
+
+	const wantsBrave = await ctx.ui.confirm(
+		"Use Brave Search?",
+		"Brave gives reliable web results for the web_explore tool. You can get an API key at https://api-dashboard.search.brave.com/app/keys. Use Brave now?",
+	);
+
+	if (!wantsBrave) {
+		markOnboardingComplete();
+		ctx.ui.notify("Brave skipped — web search will use the default DuckDuckGo backend.", "info");
+		return { kind: "skipped" };
+	}
+
+	try {
+		await openBraveKeysUrl(pi);
+		ctx.ui.notify("Opened the Brave API key dashboard in your browser.", "info");
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		ctx.ui.notify(`Could not open browser: ${message}`, "warning");
+		ctx.ui.notify(`Open this URL manually: ${BRAVE_KEYS_URL}`, "info");
+	}
+
+	const rawKey = await promptForKey(ctx);
+	const validated = validateBraveKey(rawKey);
+
+	if (validated.error) {
+		ctx.ui.notify(validated.error, "warning");
+		// Do not mark complete so the prompt retries on next launch.
+		return { kind: "deferred" };
+	}
+
+	const updated = setBraveApiKey(settings, validated.key!);
+	writeSettingsJson(updated, settingsPath);
+	// Select Brave as the pi-web-agent search backend (DuckDuckGo fallback).
+	writeWebAgentBraveBackendConfig();
+	markOnboardingComplete();
+
+	ctx.ui.notify("Brave API key saved — web search will use Brave.", "info");
+	return { kind: "saved" };
+}
+
+export default function webAgentOnboardingExtension(pi: ExtensionAPI): void {
+	pi.on("session_start", async (event: SessionStartEvent, ctx: ExtensionContext) => {
+		if (event.reason !== "startup") return;
+		if (isOnboardingComplete()) return;
+
+		// Avoid prompting during tests or non-interactive runs.
+		if (process.env.SELESAI_SKIP_WEB_AGENT_ONBOARDING === "1") return;
+
+		await runOnboarding(pi, ctx);
+	});
+
+	// ponytail: command reuses runOnboarding() instead of duplicating the flow.
+	// On "saved" -> ctx.reload() so pi-web-agent re-applies the Brave backend config.
+	// On skipped/deferred -> no reload (nothing changed). The post-reload session_start
+	// fires with reason "reload" but the auto handler only acts on "startup", so no double prompt.
+	pi.registerCommand("setup-web-search", {
+		description: "Re-run the Brave Search onboarding flow, then reload extensions",
+		handler: async (_args: string, ctx: ExtensionCommandContext) => {
+			const result = await runOnboarding(pi, ctx);
+			if (result.kind === "saved") {
+				ctx.ui.notify("Brave key saved — reloading extensions…", "info");
+				await ctx.reload();
+			}
+		},
+	});
+}

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { readStoredCredential } from "./core/auth-storage.ts";
 export { ensureTool, getToolPath, type ManagedTool } from "./utils/tools-manager.ts";
 export { type BranchPreparation, type BranchSummaryResult, type CollectEntriesResult, type CompactionResult, type CutPointResult, calculateContextTokens, collectEntriesForBranchSummary, compact, DEFAULT_COMPACTION_SETTINGS, estimateTokens, type FileOperations, findCutPoint, findTurnStartIndex, type GenerateBranchSummaryOptions, generateBranchSummary, generateSummary, generateSummaryWithUsage, getLastAssistantUsage, prepareBranchEntries, serializeConversation, shouldCompact, } from "./core/compaction/index.ts";
 export { createEventBus, type EventBus, type EventBusController } from "./core/event-bus.ts";
-export type { AgentEndEvent, AgentSettledEvent, AgentStartEvent, AgentToolResult, AgentToolUpdateCallback, AppKeybinding, AutocompleteProviderFactory, BashToolCallEvent, BeforeAgentStartEvent, BeforeAgentStartEventResult, BeforeProviderHeadersEvent, BeforeProviderRequestEvent, BeforeProviderRequestEventResult, BuildSystemPromptOptions, CompactOptions, ContextEvent, ContextUsage, CustomToolCallEvent, EditToolCallEvent, EntryRenderer, EntryRenderOptions, ExecOptions, ExecResult, Extension, ExtensionActions, ExtensionAPI, ExtensionCommandContext, ExtensionCommandContextActions, ExtensionContext, ExtensionContextActions, ExtensionError, ExtensionEvent, ExtensionFactory, ExtensionFlag, ExtensionHandler, ExtensionRuntime, ExtensionShortcut, ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetOptions, FindToolCallEvent, GrepToolCallEvent, InlineExtension, InputEvent, InputEventResult, InputSource, KeybindingsManager, LoadExtensionsResult, LsToolCallEvent, MessageEndEvent, MessageRenderer, MessageRenderOptions, MessageStartEvent, MessageUpdateEvent, ProjectTrustContext, ProjectTrustEvent, ProjectTrustEventDecision, ProjectTrustEventResult, ProjectTrustHandler, ProviderConfig, ProviderModelConfig, ReadToolCallEvent, RegisteredCommand, RegisteredTool, ResolvedCommand, SessionBeforeCompactEvent, SessionBeforeForkEvent, SessionBeforeSwitchEvent, SessionBeforeTreeEvent, SessionCompactEvent, SessionInfoChangedEvent, SessionShutdownEvent, SessionStartEvent, SessionTreeEvent, SlashCommandInfo, SlashCommandSource, SourceInfo, TerminalInputHandler, ToolCallEvent, ToolCallEventResult, ToolDefinition, ToolExecutionEndEvent, ToolExecutionMode, ToolExecutionStartEvent, ToolExecutionUpdateEvent, ToolInfo, ToolRenderResultOptions, ToolResultEvent, TurnEndEvent, TurnStartEvent, UserBashEvent, UserBashEventResult, WidgetPlacement, WorkingIndicatorOptions, WriteToolCallEvent, } from "./core/extensions/index.ts";
+export type { AgentEndEvent, AgentSettledEvent, AgentStartEvent, AgentToolResult, AgentToolUpdateCallback, AppKeybinding, AutocompleteProviderFactory, BashToolCallEvent, BeforeAgentStartEvent, BeforeAgentStartEventResult, BeforeProviderHeadersEvent, BeforeProviderRequestEvent, BeforeProviderRequestEventResult, BuildSystemPromptOptions, CompactOptions, ContextEvent, ContextUsage, CustomToolCallEvent, EditToolCallEvent, EntryRenderer, EntryRenderOptions, ExecOptions, ExecResult, Extension, ExtensionActions, ExtensionAPI, ExtensionCommandContext, ExtensionCommandContextActions, ExtensionContext, ExtensionContextActions, ExtensionError, ExtensionEvent, ExtensionFactory, ExtensionFlag, ExtensionHandler, ExtensionRuntime, ExtensionShortcut, ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetOptions, FindToolCallEvent, GrepToolCallEvent, InlineExtension, InputEvent, InputEventResult, InputSource, KeybindingsManager, LoadExtensionsResult, LsToolCallEvent, MessageEndEvent, MessageRenderer, MessageRenderOptions, MessageStartEvent, MessageUpdateEvent, ProjectTrustContext, ProjectTrustEvent, ProjectTrustEventDecision, ProjectTrustEventResult, ProjectTrustHandler, ProviderConfig, ProviderModelConfig, ReadToolCallEvent, RegisteredCommand, RegisteredTool, ResolvedCommand, SessionBeforeCompactEvent, SessionBeforeForkEvent, SessionBeforeSwitchEvent, SessionBeforeTreeEvent, SessionCompactEvent, SessionInfoChangedEvent, SessionShutdownEvent, SessionStartEvent, SessionTreeEvent, SlashCommandInfo, SlashCommandSource, SourceInfo, TerminalInputHandler, ToolCallEvent, ToolCallEventResult, ToolDefinition, ToolExecutionEndEvent, ToolExecutionMode, ToolExecutionStartEvent, ToolExecutionUpdateEvent, ToolInfo, ToolRenderResultOptions, ToolResultEvent, TurnEndEvent, TurnStartEvent, UIPromptEndEvent, UIPromptKind, UIPromptStartEvent, UserBashEvent, UserBashEventResult, WidgetPlacement, WorkingIndicatorOptions, WriteToolCallEvent, } from "./core/extensions/index.ts";
 export { createExtensionRuntime, defineTool, discoverAndLoadExtensions, ExtensionRunner, isBashToolResult, isEditToolResult, isFindToolResult, isGrepToolResult, isLsToolResult, isReadToolResult, isToolCallEventType, isWriteToolResult, wrapRegisteredTool, wrapRegisteredTools, } from "./core/extensions/index.ts";
 export type { ReadonlyFooterDataProvider } from "./core/footer-data-provider.ts";
 export { convertToLlm } from "./core/messages.ts";
@@ -32,4 +32,5 @@ export { copyToClipboard } from "./utils/clipboard.ts";
 export { parseFrontmatter, stripFrontmatter } from "./utils/frontmatter.ts";
 export { convertToPng } from "./utils/image-convert.ts";
 export { formatDimensionNote, type ResizedImage, resizeImage } from "./utils/image-resize.ts";
+export { detectSupportedImageMimeTypeFromFile } from "./utils/mime.ts";
 export { getShellConfig } from "./utils/shell.ts";

package/dist/index.js

@@ -43,5 +43,6 @@ export { copyToClipboard } from "./utils/clipboard.js";
 export { parseFrontmatter, stripFrontmatter } from "./utils/frontmatter.js";
 export { convertToPng } from "./utils/image-convert.js";
 export { formatDimensionNote, resizeImage } from "./utils/image-resize.js";
+export { detectSupportedImageMimeTypeFromFile } from "./utils/mime.js";
 // Shell utilities
 export { getShellConfig } from "./utils/shell.js";

package/dist/main.js

@@ -6,6 +6,7 @@
  */
 import { createInterface } from "node:readline";
 import { modelsAreEqual } from "@earendil-works/pi-ai";
+import { setCapabilityOverrides } from "@earendil-works/pi-tui";
 import chalk from "chalk";
 import { parseArgs, printHelp } from "./cli/args.js";
 import { CredentialPrintError, isCredentialPrintHelp, parseCredentialPrintCommand, printCredentialPrintHelp, resolveCredentialForPrint, validateCredentialPrintArgs, } from "./cli/credential-print.js";
@@ -659,6 +660,7 @@ export async function main(args, options) {
     time("createAgentSessionRuntime");
     const { services, session, modelFallbackMessage } = runtime;
     const { settingsManager, modelRuntime, resourceLoader } = services;
+    setCapabilityOverrides(settingsManager.getTerminalCapabilityOverrides());
     applyHttpProxySettings(settingsManager.getGlobalSettings().httpProxy);
     configureHttpDispatcher(settingsManager.getHttpIdleTimeoutMs());
     if (parsed.help) {

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

@@ -49,6 +49,7 @@ export interface SettingsConfig {
     tuiMode: TuiMode;
     fullscreenExitOutput: FullscreenExitOutput;
     fullscreenScrollbar: ScrollViewScrollbar;
+    fullscreenCopyOnSelect: boolean;
     warnings: WarningSettings;
     skills: SkillToggleItem[];
 }
@@ -86,6 +87,7 @@ export interface SettingsCallbacks {
     onTuiModeChange: (mode: TuiMode) => void;
     onFullscreenExitOutputChange: (output: FullscreenExitOutput) => void;
     onFullscreenScrollbarChange: (mode: ScrollViewScrollbar) => void;
+    onFullscreenCopyOnSelectChange: (enabled: boolean) => void;
     onWarningsChange: (warnings: WarningSettings) => void;
     onSkillsToggle: (item: SkillToggleItem, enabled: boolean) => void;
     onSkillsReload: () => void;

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

@@ -474,6 +474,13 @@ export class SettingsSelectorComponent extends Container {
                 currentValue: config.fullscreenScrollbar,
                 values: ["auto", "always", "hidden"],
             },
+            {
+                id: "fullscreen-copy-on-select",
+                label: "Fullscreen copy on select",
+                description: "Automatically copy selected text in fullscreen mode; disable to copy selections with Ctrl+X",
+                currentValue: config.fullscreenCopyOnSelect ? "true" : "false",
+                values: ["true", "false"],
+            },
             {
                 id: "theme",
                 label: "Theme",
@@ -697,6 +704,9 @@ export class SettingsSelectorComponent extends Container {
                 case "fullscreen-scrollbar":
                     callbacks.onFullscreenScrollbarChange(newValue);
                     break;
+                case "fullscreen-copy-on-select":
+                    callbacks.onFullscreenCopyOnSelectChange(newValue === "true");
+                    break;
                 case "theme":
                     callbacks.onThemeChange(newValue);
                     break;

package/dist/modes/interactive/interactive-mode.d.ts

@@ -43,6 +43,7 @@ interface InteractiveTuiOptions {
     logDirectory: string;
     terminal?: Terminal;
     onRightClickPaste?: () => void;
+    fullscreenCopyOnSelect?: boolean;
 }
 /** Composition root for selecting the interactive terminal renderer. */
 export declare function createInteractiveTui(options: InteractiveTuiOptions): TuiMainScreen | TuiAltScreen;
@@ -201,6 +202,7 @@ export declare class InteractiveMode {
     private setExtensionStatus;
     private showStatusIndicator;
     private clearStatusIndicator;
+    private showWorkingStatusIndicator;
     private setWorkingVisible;
     private setWorkingIndicator;
     private setHiddenThinkingLabel;
@@ -346,6 +348,8 @@ export declare class InteractiveMode {
     private cycleModel;
     private toggleToolOutputExpansion;
     private setToolsExpanded;
+    /** Update rendered assistant messages without rebuilding live tool components. */
+    private updateThinkingBlockVisibility;
     private toggleThinkingBlockVisibility;
     private handleOpenExternalEditor;
     clearEditor(): void;