@selesai/code 0.13.16 → 0.13.19

package/dist/extensions/pi-web-agent/README.md

@@ -16,18 +16,18 @@ One public tool, `web_explore`, that does bounded web research for Pi: search, f
 
 - **One tool.** `web_explore` handles direct links, discovery, HTTP reads, targeted headless rendering, source ranking, source-quality checks, and caveats internally.
 - **Reads the real content behind links.** Paste a GitHub, PDF, or YouTube URL and it pulls the actual thing (GitHub files/issues/PRs from the API, PDF text, YouTube transcripts), keyless. So "summarize this PDF" or "what does this repo do" works off the source, not the page shell.
-- **Six search backends.** DuckDuckGo (keyless default), SearXNG, Brave, You.com, Exa, Tavily.
+- **Seven search backends.** TokenIn (default with an active account), DuckDuckGo (keyless otherwise), SearXNG, Brave, You.com, Exa, Tavily.
 - **Optional search fanout.** Query several backends at once, dedupe, and rank pages that more than one provider agreed on to the top. Off by default; flip it to `on` or `auto`.
 - **Honest by default.** Weak, narrow, blocked, or cautionary evidence gets flagged instead of dressed up as confidence.
 - **Bounded output.** `compact` / `preview` / `verbose` transcript modes.
-- **Zero-config to start.** Runs keyless out of the box (DuckDuckGo search, local browser, the built-in readers). Opt into hosted backends, fallback, search fanout, and per-tool output modes through config when you want more control.
+- **Zero-config to start.** Without an active TokenIn account, runs keyless out of the box (DuckDuckGo search, local browser, the built-in readers). Opt into hosted backends, fallback, search fanout, and per-tool output modes through config when you want more control.
 
 ## Why pi-web-agent
 
 Compared to other web tooling for agents:
 
 - **Hands-off.** No curator, no browser windows to approve, no step that pops you out of your session. Ask `web_explore` once and the answer comes back with caveats. Nothing to babysit.
-- **Keyless by default.** Search, page reads, and the GitHub/PDF/YouTube readers all work with no API keys. Add hosted providers only when you want them.
+- **Keyless without TokenIn.** Search, page reads, and the GitHub/PDF/YouTube readers all work with no API keys when TokenIn is not configured. Add hosted providers only when you want them.
 - **Bounded and honest.** Compact output by default, and it says when a read was not good enough instead of returning fake confidence.
 
 ## Install
@@ -63,11 +63,12 @@ If a pass comes back thin, call `web_explore` again with a narrower query.
 
 ## Backends
 
-Defaults are DuckDuckGo search, plain HTTP fetch, and local-browser headless. Switch providers from `/web-agent settings → Backends`. API keys stay in environment variables, never in config files.
+Defaults are TokenIn search when an active TokenIn account exists, otherwise DuckDuckGo search; fetch remains plain HTTP and headless remains local-browser. Switch providers from `/web-agent settings → Backends`. API keys stay in environment variables, never in config files.
 
 | Backend | Role | Enable with |
 | --- | --- | --- |
-| DuckDuckGo | search (default) | nothing, keyless |
+| TokenIn | search (default with an active account) | `/tokenin add` |
+| DuckDuckGo | search (default without TokenIn) | nothing, keyless |
 | SearXNG | search (self-hosted) | base URL |
 | Brave | search (hosted) | `PI_WEB_AGENT_BRAVE_API_KEY` |
 | You.com | search (hosted) | `YDC_API_KEY` |

package/dist/extensions/pi-web-agent/src/backends/config.ts

@@ -54,11 +54,17 @@ export type BackendConfigFile = {
   };
 };
 
-export const DEFAULT_BACKEND_CONFIG: BackendConfig = {
-  search: { provider: 'tokenin', fallback: 'duckduckgo' },
-  fetch: { provider: 'http' },
-  headless: { provider: 'local-browser' }
-};
+export function getDefaultBackendConfig(
+  hasActiveAccount: () => boolean = hasActiveTokenInAccount
+): BackendConfig {
+  return {
+    search: hasActiveAccount()
+      ? { provider: 'tokenin', fallback: 'duckduckgo' }
+      : { provider: 'duckduckgo' },
+    fetch: { provider: 'http' },
+    headless: { provider: 'local-browser' }
+  };
+}
 
 function extractStringArray(value: unknown): string[] | undefined {
   if (!Array.isArray(value)) return undefined;
@@ -260,6 +266,6 @@ export function mergeBackendConfigLayers(
       fetch: mergeFetchConfig(merged.fetch, layer?.fetch),
       headless: { ...merged.headless, ...layer?.headless }
     }),
-    DEFAULT_BACKEND_CONFIG
+    getDefaultBackendConfig()
   );
 }

package/dist/extensions/pi-web-agent/src/backends/factory.ts

@@ -13,7 +13,7 @@ import { createWebFetchTool } from '../tools/web-fetch.js';
 import { createWebSearchTool } from '../tools/web-search.js';
 import { readBraveKeyFromSettings } from './settings-reader.js';
 import type { SearchProviderName, WebFetchHeadlessResponse, WebFetchResponse, WebSearchResponse } from '../types.js';
-import { DEFAULT_BACKEND_CONFIG, type BackendConfig, usableSearchProviders } from './config.js';
+import { getDefaultBackendConfig, type BackendConfig, usableSearchProviders } from './config.js';
 import { createSpecialContentResolver } from '../readers/resolver.js';
 import { createGithubReader } from '../readers/github-reader.js';
 import { createPdfReader } from '../readers/pdf-reader.js';
@@ -117,7 +117,7 @@ function withFetchFallback(
 }
 
 export function createBackendSet(
-  config: BackendConfig = DEFAULT_BACKEND_CONFIG,
+  config: BackendConfig = getDefaultBackendConfig(),
   deps: BackendFactoryDeps = {}
 ): BackendSet {
   const createDuckDuckGoSearch = deps.createDuckDuckGoSearch ?? createWebSearchTool;

package/dist/extensions/pi-web-agent/src/backends/settings-reader.ts

@@ -1,8 +1,7 @@
-// ponytail: selesai stores the Brave API key in settings.json (webAgent.braveApiKey),
-// set by the bundled web-agent-onboarding extension. Upstream pi-web-agent reads the
-// key only from PI_WEB_AGENT_BRAVE_API_KEY env var. This helper bridges that gap with a
-// minimal settings.json read. Ceiling: if selesai moves web search config elsewhere, this
-// helper needs updating; upgrade path = upstream pi-web-agent adopting a settings hook.
+// ponytail: preserve existing manually configured Brave keys in settings.json
+// (webAgent.braveApiKey). Upstream pi-web-agent reads only PI_WEB_AGENT_BRAVE_API_KEY.
+// Ceiling: if selesai moves web search config elsewhere, update this helper; upgrade path =
+// upstream pi-web-agent adopting a settings hook.
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { getAgentDir, getSettingsPath } from '@selesai/code';

package/dist/extensions/pi-web-agent/src/commands/web-agent-config.ts

@@ -1,5 +1,5 @@
 import {
-  DEFAULT_BACKEND_CONFIG,
+  getDefaultBackendConfig,
   mergeBackendConfigLayers,
   validateBackendConfig,
   usableSearchProviders,
@@ -150,7 +150,7 @@ function formatFetchOptions(config: BackendConfig['fetch']) {
   ].filter(Boolean).join(' ');
 }
 
-function formatBackendSummary(config: BackendConfig = DEFAULT_BACKEND_CONFIG) {
+function formatBackendSummary(config: BackendConfig = getDefaultBackendConfig()) {
   const searchSuffix = formatSearchOptions(config.search);
   const fetchSuffix = formatFetchOptions(config.fetch);
   const searchBase = config.search.baseUrl
@@ -394,10 +394,10 @@ export function getInheritedBackendsForScope(
   scope: PresentationScope
 ): BackendConfig {
   if (scope === 'global') {
-    return DEFAULT_BACKEND_CONFIG;
+    return getDefaultBackendConfig();
   }
 
-  return mergeBackendConfigLayers(DEFAULT_BACKEND_CONFIG, loaded.global.rawBackends);
+  return mergeBackendConfigLayers(getDefaultBackendConfig(), loaded.global.rawBackends);
 }
 
 export function getScopeDisplayBackends(
@@ -405,11 +405,11 @@ export function getScopeDisplayBackends(
   scope: PresentationScope
 ): BackendConfig {
   if (scope === 'global') {
-    return mergeBackendConfigLayers(DEFAULT_BACKEND_CONFIG, loaded.global.rawBackends);
+    return mergeBackendConfigLayers(getDefaultBackendConfig(), loaded.global.rawBackends);
   }
 
   return mergeBackendConfigLayers(
-    DEFAULT_BACKEND_CONFIG,
+    getDefaultBackendConfig(),
     loaded.global.rawBackends,
     loaded.project.rawBackends
   );
@@ -942,7 +942,7 @@ export function registerWebAgentConfigCommands(pi: ExtensionAPI, deps: CommandDe
 
       if (action === 'doctor') {
         const [typeboxOk, browser, loaded] = await Promise.all([checkTypebox(), resolveBrowser(), load()]);
-        const backendConfig = loaded.effectiveBackends ?? DEFAULT_BACKEND_CONFIG;
+        const backendConfig = loaded.effectiveBackends ?? getDefaultBackendConfig();
         const backendIssues = validateBackendConfig(backendConfig);
         const backendHealth = await checkBackends(backendConfig);
         const lines = [
@@ -971,7 +971,7 @@ export function registerWebAgentConfigCommands(pi: ExtensionAPI, deps: CommandDe
         ctx.ui.notify(
           [
             formatConfigSummary(loaded.effectiveConfig),
-            formatBackendSummary(loaded.effectiveBackends ?? DEFAULT_BACKEND_CONFIG),
+            formatBackendSummary(loaded.effectiveBackends ?? getDefaultBackendConfig()),
             `global: ${loaded.global.path}${loaded.global.exists ? '' : ' (missing)'}`,
             `project: ${loaded.project.path}${loaded.project.exists ? '' : ' (missing)'}`
           ].join('\n'),

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

@@ -1,5 +1,5 @@
 import type { ExtensionAPI } from '@selesai/code';
-import { DEFAULT_BACKEND_CONFIG, type BackendConfig } from './backends/config.js';
+import { getDefaultBackendConfig, type BackendConfig } from './backends/config.js';
 import { Type } from 'typebox';
 import { registerWebAgentConfigCommands } from './commands/web-agent-config.js';
 import { DEFAULT_PRESENTATION_CONFIG, resolvePresentationMode } from './presentation/config.js';
@@ -60,9 +60,9 @@ async function getEffectivePresentationConfig(pi: ExtensionAPI): Promise<Present
 async function getEffectiveBackendConfig(pi: ExtensionAPI): Promise<BackendConfig> {
   try {
     const loaded = await loadWebAgentConfig(pi);
-    return loaded.effectiveBackends ?? DEFAULT_BACKEND_CONFIG;
+    return loaded.effectiveBackends ?? getDefaultBackendConfig();
   } catch {
-    return DEFAULT_BACKEND_CONFIG;
+    return getDefaultBackendConfig();
   }
 }
 

package/dist/extensions/pi-web-agent/src/presentation/config-store.ts

@@ -2,7 +2,7 @@ import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { CONFIG_DIR_NAME, getAgentDir } from '@selesai/code';
 import {
-  DEFAULT_BACKEND_CONFIG,
+  getDefaultBackendConfig,
   extractBackendConfigOverride,
   mergeBackendConfigLayers,
   type BackendConfig,
@@ -162,7 +162,7 @@ export async function loadPresentationConfigLayers(
       project.rawConfig
     ),
     effectiveBackends: mergeBackendConfigLayers(
-      DEFAULT_BACKEND_CONFIG,
+      getDefaultBackendConfig(),
       global.rawBackends,
       project.rawBackends
     )

package/dist/extensions/pi-web-agent/src/search/tokenin.ts

@@ -6,6 +6,7 @@ import type { SearchResult, WebSearchResponse } from '../types.js';
 
 export const TOKENIN_SEARCH_TOOL_NAME = 'firecrawl';
 export const TOKENIN_DEFAULT_BASE_URL = 'https://lite.andlet.me/v1';
+const TOKENIN_SEARCH_TIMEOUT_MS = 10_000;
 
 type TokenInAccount = { id: string; label: string; apiKey: string; baseUrl?: string };
 type TokenInAuth = { accounts: TokenInAccount[]; activeId: string | null };
@@ -54,10 +55,12 @@ function normalizeResults(response: LiteLLMSearchResponse): SearchResult[] {
 
 export function createTokenInSearchTool({
   readAccount = readActiveTokenInAccount,
-  fetchImpl = fetch
+  fetchImpl = fetch,
+  timeoutMs = TOKENIN_SEARCH_TIMEOUT_MS
 }: {
   readAccount?: () => TokenInAccount | undefined;
   fetchImpl?: typeof fetch;
+  timeoutMs?: number;
 } = {}) {
   return async function tokenInSearch({ query }: { query: string }): Promise<WebSearchResponse> {
     const normalizedQuery = query.trim();
@@ -89,6 +92,9 @@ export function createTokenInSearchTool({
       .replace(/\/v1$/, '');
     const url = `${rootUrl}/v1/search/${TOKENIN_SEARCH_TOOL_NAME}`;
 
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+
     try {
       const response = await fetchImpl(url, {
         method: 'POST',
@@ -97,7 +103,8 @@ export function createTokenInSearchTool({
           'Content-Type': 'application/json',
           Authorization: `Bearer ${account.apiKey}`
         },
-        body: JSON.stringify({ query: normalizedQuery, max_results: 10 })
+        body: JSON.stringify({ query: normalizedQuery, max_results: 10 }),
+        signal: controller.signal
       });
 
       if (!response.ok) {
@@ -122,13 +129,17 @@ export function createTokenInSearchTool({
         metadata: { backend: 'tokenin', cacheHit: false }
       });
     } catch (error) {
-      const rawMessage = error instanceof Error ? error.message : String(error);
+      const rawMessage = controller.signal.aborted
+        ? `Token-In search timed out after ${timeoutMs}ms.`
+        : error instanceof Error ? error.message : String(error);
       return resultWithPresentation({
         status: 'error',
         results: [],
         metadata: { backend: 'tokenin', cacheHit: false },
         error: { code: 'FETCH_FAILED', message: `Token-In search request failed: ${rawMessage}` }
       });
+    } finally {
+      clearTimeout(timeout);
     }
   };
 }

package/dist/extensions/pi-zentui/README.md

@@ -37,6 +37,8 @@ Editor, User messages, Thinking (Experimental), Working line, and selector borde
 
 The Starship Footer shows directory, Git, runtime, context, tokens, and cost. Optional segments include model/provider, package version, session duration, `user@host`, time, OS, Git commit, Git metrics, and third-party extension statuses. The layout is segment-driven by default and supports a complete Starship-style format template.
 
+When the Working line is enabled, third-party extensions can publish keyed text segments through Pi's shared event bus. Zentui composes those segments into the owned row so Classic and KITT animate across them with the built-in content. See the [Working-line extension integration](https://github.com/lmilojevicc/pi-zentui/blob/main/docs/configuration.md#working-line-extension-integration) reference.
+
 Zentui detects a broad set of runtime and language modules, preserves Nerd Font icons with an ASCII mode, and can source colors from the active Pi theme or directly from the terminal palette.
 
 ## Screenshots
@@ -95,6 +97,21 @@ Run `/zentui` inside Pi to configure Appearance, Editor, User messages, Thinking
 ~/.pi/agent/zentui.json
 ```
 
+### Component presets
+
+Choose **Appearance → Preset** in `/zentui`, or run `/zentui preset <id>`:
+
+| ID | Editor (enabled) | Footer | User messages |
+| --- | --- | --- | --- |
+| `opencode` | Opencode | Starship | Framed |
+| `opencode-copy-friendly` | Opencode (copy-friendly) | Starship | Framed (copy-friendly) |
+| `rail` | Accent Rail | Starship | Compact (accent rail) |
+| `minimalist` | Minimalist | Hidden (zero rows) | Zentui styling disabled |
+
+Presets apply once, saving only these component selections. Colors, color sources, style options, icons, Footer segments/formats, selector borders, Working line, and Thinking remain unchanged. Minimalist preserves the dormant message style and leaves Pi's native message presentation alone. Hidden suppresses the Footer; it is not Native.
+
+The displayed preset is derived from your current selections: individual changes may show **Custom**, and returning to a matching combination restores its name. No `preset` config key is saved or reapplied at startup. Defaults are unchanged and match Opencode. Selecting a preset keeps settings open for further adjustments. Editor installation waits until the panel closes; if editor ownership prevents application, the saved choice may require reloading Pi.
+
 A small starter config:
 
 ```json

package/dist/extensions/pi-zentui/docs/configuration.md

@@ -8,7 +8,7 @@ Zentui reads optional user configuration from `~/.pi/agent/zentui.json`. Missing
 
 The interactive `/zentui` menu is split into nine component-oriented sections. Use `Tab` and `Shift+Tab` to switch sections:
 
-1. **Appearance** — selector-border enablement, style, and colors; icon mode.
+1. **Appearance** — component Preset; selector-border enablement, style, and colors; icon mode.
 2. **Editor** — enablement, style, colors, model label, border behavior, viewport indicators, settings for the selected editor style, and a static synthetic preview.
 3. **User messages** — enablement, style, colors, and a static synthetic Markdown preview.
 4. **Thinking (Experimental)** — private Rail, Tree, or Streaming rendering; active Streaming can switch live to Rail or Tree, Rail and Tree can switch live between each other, and the private renderer may break after Pi updates.
@@ -45,6 +45,44 @@ Useful slash-command shortcuts:
 
 `footer`, `statusline`, `status`, and `status line` are aliases. Enable selects Starship, disable selects Native, and toggle selects Native only from Starship; Native or Hidden toggle to Starship.
 
+### Component presets
+
+Use the first **Appearance → Preset** row, or one of these exact commands:
+
+```text
+/zentui preset opencode
+/zentui preset opencode-copy-friendly
+/zentui preset rail
+/zentui preset minimalist
+```
+
+| Preset ID | `components.editor` | `components.footer.style` | `components.userMessages` |
+| --- | --- | --- | --- |
+| `opencode` | `enabled: true`, `style: "opencode"` | `"starship"` | `enabled: true`, `style: "framed"` |
+| `opencode-copy-friendly` | `enabled: true`, `style: "opencode-copy-friendly"` | `"starship"` | `enabled: true`, `style: "framed-copy-friendly"` |
+| `rail` | `enabled: true`, `style: "accent-rail"` | `"starship"` | `enabled: true`, `style: "compact"` |
+| `minimalist` | `enabled: true`, `style: "minimalist"` | `"hidden"` | `enabled: false` (style preserved) |
+
+These are one-time, atomic selection patches, not ongoing profiles. Only the listed leaves are written, with the existing obsolete copy-friendly/Footer-enabled migration flags removed when their styles are explicitly selected. Colors and color sources, per-style options, icons, Footer segments/templates/path settings, all other components, and unknown fields remain untouched. Unsupported future style IDs are preserved unless the preset explicitly replaces that style; Minimalist even preserves an unsupported dormant message style. Existing legacy option resolution continues to work.
+
+**Custom** is a derived display state, not a selectable preset or a saved key. Matching checks only the listed selection leaves, not colors/options or current runtime ownership; Minimalist ignores dormant message style. Unsupported active selected styles do not match. Hand-editing or individually changing a selection can show Custom; returning to a matching combination restores the preset label. No `preset` config key is used, and nothing is automatically reapplied on startup. New-install defaults remain unchanged and match Opencode.
+
+The existing Minimalist editor stays enabled with its saved metadata/options. Disabled User messages releases only Zentui styling, leaving native or predecessor rendering intact. Hidden installs an owned zero-row Footer, whereas Native releases Zentui's Footer to Pi or a predecessor; `/zentui statusline disable` still selects Native, not Hidden.
+
+Selecting presets keeps the settings panel open and preserves its focus. Config, Footer, and User messages update immediately; editor installation waits until the panel closes and Pi restores the draft. Only the latest editor settings are reconciled on exit, and shutdown cancels pending installation. With public editor-text APIs available, opening settings expands nonempty drafts before Pi snapshots them, preserving collapsed paste contents; this can move the cursor to the end and add an undo step. Empty drafts are untouched. Older hosts without these APIs retain Pi's existing draft-restoration behavior. Saves fail without changing active settings or overwriting corrupt/unreadable JSON. Live application reconciles only Editor, User messages, Footer, and dependent timers. Editor ownership restrictions are reported as saved-but-not-applied/reload-required; Footer host failures retain existing fail-open behavior. Direct preset commands also save in non-TUI modes without installing TUI components. Unknown IDs, missing IDs, and extra arguments do not change settings.
+
+### Extension-status hyperlinks
+
+An extension's **Original** color mode preserves SGR styling and HTTP/HTTPS
+OSC 8 hyperlinks supplied by that extension. For example, set
+`components.footer.styles.starship.extensionStatuses.colorModes.github-pr` to
+`"original"` to retain a PR link from a GitHub status extension. Open it with
+your terminal's link-opening gesture. Other URL schemes and unrelated terminal
+controls (including clipboard, title, and cursor commands) are removed.
+
+Zentui color mode continues to show plain status text. Zentui does not infer a
+URL when an extension supplies only a label.
+
 ## Complete default configuration
 
 Copy this example and change only the values you need. Optional editor source-aware overrides such as `editorRail`, `editorGitBranch`, and `editorThinkingMax` are intentionally omitted.
@@ -428,7 +466,38 @@ Classic and KITT move color across message and segments. **Animate spinner color
 
 Both speeds accept `30..1000` ms. Classic/KITT combine both cadences through one Pi Loader interval; exact cycles are used within 1024-frame/512-KiB limits. Pathological custom pairs use a bounded evenly distributed schedule with at most half a spinner-cycle and half a text-step rounding. Legacy `intervalMs` is accepted only as migration input for `spinnerIntervalMs` when the canonical field is absent.
 
-Content reserves the complete Tokens label first, then Message, Thought, Elapsed, and Tool allocation, while preserving visual order **Message · Tool · Elapsed · Thought · Tokens** within the 80-column Loader-row contract. Active thought starts as `thinking 0s`; completed positive thought becomes `thought for Ns`. Rebuilds preserve spinner and visible color phase. Pi's working-row APIs are global and unkeyed, so another extension may win by writing last.
+Content reserves the complete Tokens label and active extension segments first, then Message, Thought, Elapsed, and Tool allocation, while preserving visual order **Message · Tool · Elapsed · Thought · Tokens · Extensions** within the 80-column Loader-row contract. Active thought starts as `thinking 0s`; completed positive thought becomes `thought for Ns`. Rebuilds preserve spinner and visible color phase. Pi's working-row APIs are global and unkeyed, so another extension may win by writing last.
+
+### Working-line extension integration
+
+Third-party extensions can add dynamic text to Zentui's owned Working line through Pi's shared event bus. Protocol version 1 uses keyed segments that are sanitized, ordered by key, width-bounded, and included in the same Classic/KITT animation frames as Zentui's built-in content.
+
+Probe the capability when an interaction starts so an extension can fall back to Pi's public `setWorkingMessage()` slot when Zentui's Working line is unavailable:
+
+```typescript
+const capability = { supported: false, active: false };
+pi.events.emit("zentui:working-line-segment-capability", capability);
+
+if (capability.active) {
+  pi.events.emit("zentui:working-line-segment", {
+    key: "@scope/my-extension:throughput",
+    text: "24.3 tok/s · TTFT 820ms",
+  });
+}
+```
+
+Update a segment by emitting the same key with new text. Remove it when the interaction settles or the publishing extension shuts down:
+
+```typescript
+pi.events.emit("zentui:working-line-segment", {
+  key: "@scope/my-extension:throughput",
+  text: undefined,
+});
+```
+
+All publishers share one global key namespace. Collisions are last-update-wins, and removal by either publisher removes the value for that key. Publishers must therefore use stable, package-qualified keys such as `@scope/package:segment`; each publisher owns removal and lifecycle cleanup for its keys. `text: ""` also removes a segment. Published state is scoped to the current session and Working-row ownership: Zentui discards it on a new session, disable, shutdown, or ownership release. Positive updates while capability is inactive are ignored rather than retained, so publishers must probe again and republish their current value after capability becomes active.
+
+Zentui accepts at most 16 unique keys, keys up to 64 code units, and values up to 256 code units. Extra segments are omitted or truncated when the complete row reaches its fixed width. `supported` reports whether this Zentui version understands the protocol. Zentui also adds `version: 1` to the mutable capability response; probes that initialize only `supported` and `active`, as above, remain compatible. `active` additionally requires an enabled Working line in an active TUI session where Zentui successfully installed and still claims both required Pi working-row surfaces. Pi's unkeyed, last-writer-wins APIs provide no way to prove that another extension has not overwritten a surface after installation, so publishers should probe at each interaction and retain their normal fallback.
 
 ## Git status icons
 

package/dist/extensions/pi-zentui/extensions/zentui/config.ts

@@ -24,6 +24,7 @@ import {
 	type ResolvedIcons,
 	resolveConfiguredIcons,
 } from "./icons";
+import type { ComponentPreset } from "./presets";
 import { isSupportedColorSpec } from "./style";
 import { normalizeWorkingLineMessages } from "./working-line";
 import { PI_WORKING_LINE_MESSAGES } from "./working-line-messages";
@@ -1651,6 +1652,16 @@ function deleteLegacyMessageCopyFriendly(record: ConfigRecord): void {
 	if (isRecord(framed)) delete framed.copyFriendly;
 }
 
+/** A preset is a one-time, selection-only transaction; do not normalize unrelated leaves. */
+export function saveComponentPreset(preset: ComponentPreset, path = configPath): PolishedTuiConfig {
+	return mutateConfig(path, (record) => {
+		record.components = overlayKnown(record.components, preset.components);
+		deleteLegacyEditorCopyFriendly(record);
+		deleteLegacyFooterEnabled(record);
+		if (preset.components.userMessages.style !== undefined) deleteLegacyMessageCopyFriendly(record);
+	});
+}
+
 function applyEditorComponentPatch(
 	component: EditorComponentConfig,
 	patch: Partial<

package/dist/extensions/pi-zentui/extensions/zentui/editor-transfer.ts

@@ -19,6 +19,20 @@ export type EditorTransferResult =
 	| { ok: true }
 	| { ok: false; reason: EditorTransferFailureReason };
 
+/**
+ * Pi custom UI saves raw editor text and restores it with setText(), which clears
+ * collapsed paste storage. Expand nonempty drafts before that snapshot is taken.
+ * Hosts without public text APIs retain their existing custom-UI behavior.
+ */
+export function prepareEditorTextForCustomUi(
+	ui: Pick<EditorTransferUi, "getEditorText" | "setEditorText">,
+): void {
+	if (typeof ui.getEditorText !== "function" || typeof ui.setEditorText !== "function") return;
+	const text = ui.getEditorText();
+	if (typeof text !== "string") throw new Error("expanded editor text could not be read safely");
+	if (text) ui.setEditorText(text);
+}
+
 /**
  * Prepare the active editor's public expanded text before Pi replaces its factory.
  * This intentionally transfers prompt contents only; editor-private state is never inspected.

package/dist/extensions/pi-zentui/extensions/zentui/extension-status.ts

@@ -1,3 +1,4 @@
+import { randomUUID } from "node:crypto";
 import { stripVTControlCharacters } from "node:util";
 import type { ExtensionStatusColorMode, ExtensionStatusPlacement, ZentuiConfig } from "./config";
 import {
@@ -19,9 +20,6 @@ export type ExtensionStatusSegmentsByPlacement = {
 	right: ExtensionStatusSegment[];
 };
 
-const safeSgrPattern = /\x1b\[[0-9;:]*m/g;
-const sgrPlaceholderPattern = /__ZENTUI_SGR_(\d+)__/g;
-
 function compareKeys(a: ExtensionStatusSegment, b: ExtensionStatusSegment): number {
 	return a.key < b.key ? -1 : a.key > b.key ? 1 : 0;
 }
@@ -43,18 +41,36 @@ function hasVisibleStatusText(value: string): boolean {
 }
 
 export function sanitizeExtensionStatusOriginalText(value: string): string {
-	const safeSequences: string[] = [];
-	const protectedValue = value.replace(safeSgrPattern, (sequence) => {
-		const index = safeSequences.push(sequence) - 1;
-		return `__ZENTUI_SGR_${index}__`;
-	});
+	// Preserve only SGR and HTTP(S) OSC 8 links. Never pass title/clipboard/cursor controls.
+	const marker = `__ZENTUI_${randomUUID()}_`;
+	const sequences: Array<{ sequence: string; url: string | undefined }> = [];
+	const protectedValue = value.replace(
+		/\x1b\[[0-9;:]*m|\x1b\]8;[^;\x07\x1b]*;([^\x07\x1b]*)(?:\x07|\x1b\\)/g,
+		(sequence, url: string | undefined) => `${marker}${sequences.push({ sequence, url }) - 1}__`,
+	);
 	const cleaned = normalizeStatusWhitespace(stripVTControlCharacters(protectedValue));
-	const restored = cleaned.replace(sgrPlaceholderPattern, (_match, indexText: string) => {
-		const index = Number.parseInt(indexText, 10);
-		return safeSequences[index] ?? "";
+	// Other controls can swallow placeholders. Track only sequences that survive
+	// stripping, including invalid targets that must end any surviving link.
+	let activeLink = false;
+	const restored = cleaned.replace(new RegExp(`${marker}(\\d+)__`, "g"), (_match, index) => {
+		const entry = sequences[Number(index)];
+		if (!entry) return "";
+		const { sequence, url } = entry;
+		if (url === undefined) return sequence;
+		const close = activeLink ? "\x1b]8;;\x07" : "";
+		activeLink = false;
+		if (!url || /[\s\x00-\x1f\x7f-\x9f]/.test(url)) return close;
+		try {
+			const parsed = new URL(url);
+			if (parsed.protocol !== "https:" && parsed.protocol !== "http:") return close;
+			activeLink = true;
+			return `${close}\x1b]8;;${parsed.href}\x07`;
+		} catch {
+			return close;
+		}
 	});
-
-	return hasVisibleStatusText(restored) ? restored : "";
+	const result = restored + (activeLink ? "\x1b]8;;\x07" : "");
+	return hasVisibleStatusText(result) ? result : "";
 }
 
 export function collectExtensionStatusSegments(

package/dist/extensions/pi-zentui/extensions/zentui/footer-layout.ts

@@ -1,6 +1,7 @@
-import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { visibleWidth } from "@earendil-works/pi-tui";
 import type { CompactFooterMaxLines } from "./config";
 import type { CompactBoundaryKind } from "./footer-format";
+import { truncateFooterText } from "./footer-text";
 
 export type FooterZones = {
 	left: string;
@@ -59,7 +60,7 @@ function fitChunk(chunk: string, innerWidth: number): PackedRow {
 		return { text: chunk, endsWithRendererEllipsis: false };
 	}
 	return {
-		text: truncateToWidth(chunk, innerWidth, "…"),
+		text: truncateFooterText(chunk, innerWidth, "…"),
 		endsWithRendererEllipsis: true,
 	};
 }
@@ -68,7 +69,7 @@ function appendOmissionMarker(row: PackedRow, innerWidth: number): PackedRow {
 	if (row.endsWithRendererEllipsis) return row;
 	if (innerWidth <= 1) return { text: "…", endsWithRendererEllipsis: true };
 	return {
-		text: `${truncateToWidth(row.text, innerWidth - 1, "")}…`,
+		text: `${truncateFooterText(row.text, innerWidth - 1, "")}…`,
 		endsWithRendererEllipsis: true,
 	};
 }
@@ -118,5 +119,5 @@ export function packCompactChunks(
 	}
 
 	if (current) rows.push(omitted ? appendOmissionMarker(current, innerWidth) : current);
-	return rows.map((row) => truncateToWidth(row.text, innerWidth, ""));
+	return rows.map((row) => truncateFooterText(row.text, innerWidth, ""));
 }

package/dist/extensions/pi-zentui/extensions/zentui/footer-text.ts

@@ -0,0 +1,11 @@
+import { truncateToWidth } from "@earendil-works/pi-tui";
+
+/** Close retained links before joining/padding footer fragments, even on Pi < 0.84.0. */
+export function truncateFooterText(text: string, width: number, ellipsis: string): string {
+	const truncated = truncateToWidth(text, width, ellipsis);
+	let activeLink = false;
+	for (const match of truncated.matchAll(/\x1b\]8;[^;\x07\x1b]*;([^\x07\x1b]*)(?:\x07|\x1b\\)/g)) {
+		activeLink = Boolean(match[1]);
+	}
+	return truncated + (activeLink ? "\x1b]8;;\x07" : "");
+}

package/dist/extensions/pi-zentui/extensions/zentui/footer.ts

@@ -1,5 +1,5 @@
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { visibleWidth } from "@earendil-works/pi-tui";
 import type { SeparatorStyle, ZentuiConfig } from "./config";
 import { FOOTER_FORMAT_ALIASES } from "./config";
 import { sanitizeEditorMetadataText } from "./editor-metadata-format";
@@ -22,6 +22,7 @@ import {
 	packCompactChunks,
 	reflowFullFooter,
 } from "./footer-layout";
+import { truncateFooterText } from "./footer-text";
 import {
 	buildContextDisplayLabel,
 	buildSessionDurationLabel,
@@ -77,7 +78,7 @@ function fitStatusTexts(statusTexts: string[], maxWidth: number, separator: stri
 		}
 
 		if (fitted.length === 0) {
-			return maxWidth > 1 ? truncateToWidth(text, maxWidth, "…") : "";
+			return maxWidth > 1 ? truncateFooterText(text, maxWidth, "…") : "";
 		}
 		break;
 	}
@@ -101,10 +102,10 @@ function composeBuiltInFooterContent(left: string, right: string, innerWidth: nu
 	const leftWidth = visibleWidth(left);
 	const rightWidth = visibleWidth(right);
 	return leftWidth >= innerWidth
-		? truncateToWidth(left, innerWidth, "")
+		? truncateFooterText(left, innerWidth, "")
 		: leftWidth + 1 + rightWidth <= innerWidth
 			? `${left}${" ".repeat(innerWidth - leftWidth - rightWidth)}${right}`
-			: truncateToWidth(left, innerWidth, "");
+			: truncateFooterText(left, innerWidth, "");
 }
 
 function composeFooterContent(
@@ -700,8 +701,8 @@ export function installFooter(
 					);
 				const frameRows = (rows: string[]) =>
 					rows.map((row) => {
-						const framed = width > 2 ? ` ${truncateToWidth(row, width - 2, "")} ` : row;
-						return truncateToWidth(framed, width, "");
+						const framed = width > 2 ? ` ${truncateFooterText(row, width - 2, "")} ` : row;
+						return truncateFooterText(framed, width, "");
 					});
 
 				if (!config.components.footer.styles.starship.responsive)
@@ -732,8 +733,8 @@ export function installFooter(
 				if (reflowed) return frameRows(reflowed);
 
 				const chunkBudget = compactChunkBudget(innerWidth);
-				const compactCwdLabel = truncateToWidth(cwdLabel, chunkBudget, "…");
-				const compactSessionNameLabel = truncateToWidth(
+				const compactCwdLabel = truncateFooterText(cwdLabel, chunkBudget, "…");
+				const compactSessionNameLabel = truncateFooterText(
 					sessionNameLabel,
 					Math.max(1, chunkBudget - visibleWidth("in ")),
 					"…",
@@ -742,7 +743,7 @@ export function installFooter(
 					1,
 					chunkBudget - visibleWidth("on ") - (statusBlock ? visibleWidth(statusBlock) + 1 : 0),
 				);
-				const compactBranchLabel = truncateToWidth(
+				const compactBranchLabel = truncateFooterText(
 					renderVariable("git_branch"),
 					compactBranchBudget,
 					"…",
@@ -784,7 +785,7 @@ export function installFooter(
 					);
 					const references = collectFooterFormatReferences(chunk.tokens, FOOTER_FORMAT_ALIASES);
 					if (["cwd", "session_name", "git_branch"].some((name) => references.has(name))) {
-						rendered = truncateToWidth(rendered, chunkBudget, "…");
+						rendered = truncateFooterText(rendered, chunkBudget, "…");
 					}
 					if (rendered) compactChunks.push({ text: rendered, boundary: chunk.boundary });
 				}