pi-ui-extend 1.0.40 → 1.0.42

package/README.md

@@ -95,7 +95,7 @@ On startup, Pix tries to link the bundled suite into the active Pi agent directo
 | Context control | `dcp` | Explicit compression and context pruning for long sessions, including sidecar state. |
 | Local web access | `web-search` | Web search and page extraction through a local Ollama instance. |
 | Providers and quotas | `antigravity-auth`, `opencode-import`, `usage` | Antigravity OAuth/account failover, OpenCode credential import, and multi-provider usage views. |
-| Reusable workflows | `prompt-commands`, `skill-installer`, `session-name` | Prompt-command CRUD, skill installation/export, and session naming. |
+| Reusable workflows | `prompt-commands`, `resource-registry`, `session-name` | Prompt-command CRUD, private Git-backed skill/agent install/update/push/remote-remove/local-uninstall with reload-on-change, project-scoped `.pi/tasks.jsonc` + `.pi/plans/` + `.pi/TODO.md` sync, a Desktop Registry sidebar for status/actions/configuration, and session naming. |
 | Model compatibility | `coding-discipline`, `model-tools`, `codex-reasoning-fix` | Model-specific discipline and vision lookup, compatibility aliases, and a Codex reasoning payload workaround. |
 
 Every module can be disabled. Optional integrations only activate when their requirements are available — for example, repository tools require an index, web tools require local Ollama web search, and LSP servers must be configured and trusted.
@@ -317,7 +317,7 @@ Type `/` for the live, searchable list. Extensions can add more commands than th
 | Status | `/usage` |
 | Process | `/quit`, `/exit` |
 
-Useful suite commands include `/todos`, `/todos-persist`, `/todos-scope`, `/sub-status`, `/sub-stop`, `/ultrawork`, `/hyperplan`, `/subagent-preset`, `/usage`, `/dcp`, `/idx-init`, `/idx-update`, `/opencode-import`, `/antigravity-add-account`, `/install-skill`, and `/export-skill`.
+Useful suite commands include `/todos`, `/todos-persist`, `/todos-scope`, `/sub-status`, `/sub-stop`, `/ultrawork`, `/hyperplan`, `/subagent-preset`, `/usage`, `/dcp`, `/idx-init`, `/idx-update`, `/opencode-import`, `/antigravity-add-account`, and `/registry`.
 
 ### Keyboard and mouse
 
@@ -500,8 +500,16 @@ npm run test:tools-suite
 
 # Build the publishable renderer
 npm run build:pix
+
+# Watch Pix, ACP, the bundled suite, and Desktop
+npm run watch:all
 ```
 
+`watch:all` rebuilds only the affected project parts. It keeps the last working
+Desktop process alive while changes compile, then replaces it only after the
+entire queued build succeeds. A failed build is reported without replacing the
+running Desktop.
+
 Regenerate the README screenshots without accounts or live model traffic:
 
 ```bash

package/dist/app/app.d.ts

@@ -51,6 +51,7 @@ export declare class PiUiExtendApp {
      * for one tab never reaches another tab's extensions.
      */
     private readonly extensionEventBusByRuntime;
+    private readonly subagentCatalogBySessionId;
     private readonly inputEditor;
     private lastInputEditorContentVersion;
     private readonly requestHistory;
@@ -78,6 +79,8 @@ export declare class PiUiExtendApp {
     private awaitCurrentSessionExtensions;
     private activateRuntime;
     private createExtensionEventBus;
+    private subagentTypesForRuntime;
+    private contextInventoryText;
     private handleTerminalBellAttention;
     private afterSessionReplacement;
     private requireRuntime;

package/dist/app/app.js

@@ -47,6 +47,8 @@ import { checkPiUpdate, checkPixUpdate, formatPixStartupUpdateDialog, formatPiSt
 import { checkAndUpdateIdxOnStartup, formatIdxStartupUpdateNotice } from "./cli/startup-checks.js";
 import { AppVoiceController } from "./input/voice-controller.js";
 import { createIsolatedExtensionEventBus } from "./extensions/extension-event-bus.js";
+import { parseSubagentCatalogState, SUBAGENTS_CATALOG_STATE_EVENT, } from "./extensions/subagent-catalog-state.js";
+import { createReloadContextInventory, formatReloadContextInventory } from "./commands/reload-context-inventory.js";
 import { setAppIconTheme } from "./icons.js";
 const TERMINAL_BELL_ATTENTION_EVENT = "pix:terminal-bell:attention";
 function normalizeJumpTargetText(text) {
@@ -123,6 +125,7 @@ export class PiUiExtendApp {
      * for one tab never reaches another tab's extensions.
      */
     extensionEventBusByRuntime = new WeakMap();
+    subagentCatalogBySessionId = new Map();
     inputEditor = new InputEditor();
     lastInputEditorContentVersion = this.inputEditor.contentVersion;
     requestHistory;
@@ -221,6 +224,7 @@ export class PiUiExtendApp {
             restoreAutoUserMessages: (messages) => this.queuedMessages.restoreAutoUserMessages(messages),
             captureDeferredUserMessages: () => this.queuedMessages.captureDeferredUserMessages(),
             restoreDeferredUserMessages: (messages) => this.queuedMessages.restoreDeferredUserMessages(messages),
+            contextInventoryText: (runtime, heading) => this.contextInventoryText(runtime, heading),
             addEntry: (entry) => this.addEntry(entry),
             showToast: (message, kind) => this.showToast(message, kind),
             render: () => this.render(),
@@ -358,6 +362,7 @@ export class PiUiExtendApp {
         this.extensionActions = new AppExtensionActionsController({
             isRunning: () => this.running,
             runtime: () => this.runtime,
+            subagentTypes: (runtime) => this.subagentTypesForRuntime(runtime),
             getInput: () => this.input,
             setInput: (value) => this.setInput(value),
             awaitCurrentSessionExtensions: (runtime) => this.awaitCurrentSessionExtensions(runtime),
@@ -508,6 +513,7 @@ export class PiUiExtendApp {
         this.commandController = new AppCommandController({
             options: this.options,
             runtime: () => this.runtime,
+            subagentTypes: (runtime) => this.subagentTypesForRuntime(runtime),
             requestHistory: () => this.requestHistory,
             getInput: () => this.input,
             setInput: (value) => this.setInput(value),
@@ -800,6 +806,7 @@ export class PiUiExtendApp {
             handleExtensionError: (error) => this.extensionActions.handleExtensionError(error),
             handleSessionEvent: (event) => this.handleSessionEvent(event),
             bindAgentPause: (session) => this.agentPauseController.bind(session),
+            contextInventoryText: (runtime, heading) => this.contextInventoryText(runtime, heading),
             addEntry: (entry) => this.addEntry(entry),
             setStatus: (status) => this.setStatus(status),
             showToast: (message, kind) => this.showToast(message, kind),
@@ -945,10 +952,29 @@ export class PiUiExtendApp {
                 this.handleTerminalBellAttention(data);
             if (channel === SUBAGENTS_LIVE_STATE_EVENT)
                 this.subagentsWidgetController.observeLiveState(data);
+            if (channel === SUBAGENTS_CATALOG_STATE_EVENT) {
+                const catalog = parseSubagentCatalogState(data);
+                if (catalog?.sessionId)
+                    this.subagentCatalogBySessionId.set(catalog.sessionId, catalog);
+            }
             if (channel === TODO_STATE_EVENT)
                 this.todoWidgetController.observeLiveState(data);
         });
     }
+    subagentTypesForRuntime(runtime) {
+        const sessionId = runtime.session.sessionManager.getSessionId();
+        const catalog = this.subagentCatalogBySessionId.get(sessionId);
+        if (!catalog)
+            return undefined;
+        const model = runtime.session.model;
+        const currentModelRef = model ? `${model.provider}/${model.id}` : undefined;
+        if (catalog.model && currentModelRef && catalog.model !== currentModelRef)
+            return undefined;
+        return catalog.types;
+    }
+    contextInventoryText(runtime, heading) {
+        return formatReloadContextInventory(createReloadContextInventory(runtime, this.subagentTypesForRuntime(runtime)), heading);
+    }
     handleTerminalBellAttention(data) {
         const sessionFile = isRecord(data) && typeof data.sessionFile === "string" ? data.sessionFile : undefined;
         this.tabsController.markTerminalBellAttention(sessionFile);

package/dist/app/commands/command-host.d.ts

@@ -7,6 +7,7 @@ export type DirectPopupMenu = Exclude<ActivePopupMenu, "slash">;
 export type CommandControllerHost = {
     readonly options: AppOptions;
     runtime(): AgentSessionRuntime | undefined;
+    subagentTypes?(runtime: AgentSessionRuntime): readonly string[] | undefined;
     awaitCurrentSessionExtensions(runtime?: AgentSessionRuntime): Promise<void>;
     requestHistory(): AppRequestHistory;
     getInput(): string;

package/dist/app/commands/command-model-actions.js

@@ -4,6 +4,7 @@ import { getProjectPixConfigPath, savePixAutocompleteModel, savePixDefaultModel,
 import { createId } from "../id.js";
 import { isThinkingLevel, parseScopedModelRef } from "../model/model-ref.js";
 import { appendPixSystemDisplayEntry } from "../session/pix-system-message.js";
+import { createReloadContextInventory, formatReloadContextInventory } from "./reload-context-inventory.js";
 export class ModelCommandActions {
     host;
     constructor(host) {
@@ -333,10 +334,14 @@ export class ModelCommandActions {
             await session.reload();
             if (!isCommandScopeActive(this.host, scope))
                 return;
+            const runtime = scope.runtime;
+            const text = runtime
+                ? formatReloadContextInventory(createReloadContextInventory(runtime, this.host.subagentTypes?.(runtime)), `Reloaded resources after model change to ${ref}`)
+                : `Reloaded resources after model change to ${ref}`;
             this.host.addEntry({
                 id: createId("system"),
                 kind: "system",
-                text: `Reloaded resources after model change to ${ref}`,
+                text,
             });
             this.host.toast.success("Model changed and resources reloaded");
         }

package/dist/app/commands/command-registry.js

@@ -217,7 +217,7 @@ export function createSlashCommands(actions, host) {
         },
         {
             name: "reload",
-            description: "Reload keybindings, extensions, skills, prompts, and themes",
+            description: "Reload resources and show model-available skills, tools, and agents",
             kind: "builtin",
             keywords: ["restart", "refresh", "resources", "extensions", "skills", "prompts"],
             run: () => actions.runReloadCommand(),
@@ -249,9 +249,9 @@ export function createSlashCommands(actions, host) {
         },
         {
             name: "delete",
-            description: "Delete the current (or specified) session file plus its sidecar DCP state",
+            description: "Delete the current (or specified) session file",
             kind: "builtin",
-            keywords: ["remove", "destroy", "purge", "session", "sidecar", "dcp"],
+            keywords: ["remove", "destroy", "purge", "session", "dcp"],
             allowArguments: true,
             run: (argumentsText) => actions.runDeleteCommand(argumentsText),
         },

package/dist/app/commands/command-session-actions.d.ts

@@ -15,7 +15,6 @@ export declare class SessionCommandActions {
     runHotkeysCommand(): Promise<void>;
     runReloadCommand(): Promise<void>;
     runDeleteCommand(argumentsText: string): Promise<void>;
-    private removeDcpSidecarState;
     runNewSessionCommand(): Promise<void>;
     runCompactCommand(customInstructions?: string): Promise<void>;
     private piPackageRoot;

package/dist/app/commands/command-session-actions.js

@@ -11,6 +11,7 @@ import { copyTextToClipboard } from "../screen/clipboard.js";
 import { formatAccountUsageReport, queryAccountUsageReport } from "../model/model-usage-status.js";
 import { checkGlobalPiInstall, checkPixUpdate, formatGlobalPiCheck, formatPixUpdateCheck, parsePixUpdateArgs, pixUpdateUsage, } from "../cli/update.js";
 import { createStartupInfoMessage } from "../cli/startup-info.js";
+import { createReloadContextInventory, formatReloadContextInventory } from "./reload-context-inventory.js";
 import { getCompleteSessionStats } from "../session/session-stats.js";
 import { loadSessionTitleConfig } from "../../bundled-extensions/session-title/config.js";
 import { fallbackSessionTitleFromInput, firstUserMessageText, generateSessionTitleWithRuntime, sessionTitleModelRefs, } from "../../bundled-extensions/session-title/title-generation.js";
@@ -309,7 +310,8 @@ export class SessionCommandActions {
             if (!isCommandScopeActive(this.host, scope))
                 return;
             this.host.setSessionStatus(runtime.session);
-            this.host.addEntry({ id: createId("system"), kind: "system", text: "Reloaded keybindings, extensions, skills, prompts, themes" });
+            const inventory = createReloadContextInventory(runtime, this.host.subagentTypes?.(runtime));
+            this.host.addEntry({ id: createId("system"), kind: "system", text: formatReloadContextInventory(inventory) });
             this.host.toast.success("Reloaded resources");
         }
         catch (error) {
@@ -342,7 +344,7 @@ export class SessionCommandActions {
             {
                 value: true,
                 label: `Yes, delete ${isCurrent ? "the current session" : basename(targetSessionFile)}`,
-                description: "This permanently removes the session file and any sidecar data. This cannot be undone.",
+                description: "This permanently removes the session file. This cannot be undone.",
                 variant: "error",
             },
             { value: false, label: "Cancel" },
@@ -356,11 +358,28 @@ export class SessionCommandActions {
         }
         this.host.setStatus("deleting session");
         this.host.render();
-        const sidecarRemoved = await this.removeDcpSidecarState(dirname(targetSessionFile), targetSessionId).catch(() => false);
-        await rm(targetSessionFile, { force: true }).catch(() => undefined);
         const deleteCurrent = isCurrent || targetSessionFile === currentSessionFile;
         if (deleteCurrent) {
+            // Do not race a final extension persistence operation with destructive
+            // session cleanup.
             await this.host.awaitCurrentSessionExtensions(runtime);
+            if (!isCommandRuntimeActive(this.host, runtime))
+                return;
+        }
+        try {
+            await rm(targetSessionFile, { force: true });
+        }
+        catch (error) {
+            this.host.addEntry({
+                id: createId("system"),
+                kind: "system",
+                text: `Could not delete session file ${targetSessionFile}: ${error instanceof Error ? error.message : String(error)}`,
+            });
+            this.host.toast.error("Session deletion failed");
+            this.host.setSessionStatus(runtime.session);
+            return;
+        }
+        if (deleteCurrent) {
             const result = await runtime.newSession();
             if (!isCommandRuntimeActive(this.host, runtime))
                 return;
@@ -374,7 +393,7 @@ export class SessionCommandActions {
             this.host.addEntry({
                 id: createId("system"),
                 kind: "system",
-                text: `Deleted session ${targetSessionId}. ${sidecarRemoved ? "Sidecar DCP state removed. " : ""}Started a new session. cwd=${runtime.cwd}`,
+                text: formatReloadContextInventory(createReloadContextInventory(runtime, this.host.subagentTypes?.(runtime)), `Deleted session ${targetSessionId}. Started a new session. cwd=${runtime.cwd}`),
             });
             if (runtime.modelFallbackMessage)
                 this.host.addEntry({ id: createId("system"), kind: "system", text: runtime.modelFallbackMessage });
@@ -386,20 +405,12 @@ export class SessionCommandActions {
             this.host.addEntry({
                 id: createId("system"),
                 kind: "system",
-                text: `Deleted session file ${targetSessionFile}${sidecarRemoved ? " and its sidecar DCP state" : ""}.`,
+                text: `Deleted session file ${targetSessionFile}.`,
             });
             this.host.setSessionStatus(runtime.session);
         }
         this.host.toast.success("Session deleted");
     }
-    async removeDcpSidecarState(sessionDir, sessionId) {
-        if (!sessionId)
-            return false;
-        const safeName = `${sessionId.replace(/[^a-zA-Z0-9._-]/g, "_")}.json`;
-        const statePath = join(sessionDir, "dcp-state", safeName);
-        await rm(statePath, { force: true });
-        return true;
-    }
     async runNewSessionCommand() {
         const runtime = getIdleRuntime(this.host, "new");
         if (!runtime)
@@ -418,7 +429,11 @@ export class SessionCommandActions {
             return;
         }
         this.host.resetSessionView();
-        this.host.addEntry({ id: createId("system"), kind: "system", text: `Started a new session. cwd=${runtime.cwd}` });
+        this.host.addEntry({
+            id: createId("system"),
+            kind: "system",
+            text: formatReloadContextInventory(createReloadContextInventory(runtime, this.host.subagentTypes?.(runtime)), `Started a new session. cwd=${runtime.cwd}`),
+        });
         if (runtime.modelFallbackMessage)
             this.host.addEntry({ id: createId("system"), kind: "system", text: runtime.modelFallbackMessage });
         for (const diag of runtime.diagnostics ?? []) {

package/dist/app/commands/reload-context-inventory.d.ts

@@ -0,0 +1,11 @@
+import type { AgentSessionRuntime } from "@earendil-works/pi-coding-agent";
+export interface ReloadContextInventory {
+    readonly model: string;
+    readonly skills: readonly string[];
+    readonly tools: readonly string[];
+    readonly agents: readonly string[] | undefined;
+    readonly skillsReadable: boolean;
+    readonly subagentsActive: boolean;
+}
+export declare function createReloadContextInventory(runtime: AgentSessionRuntime, agentTypes: readonly string[] | undefined): ReloadContextInventory;
+export declare function formatReloadContextInventory(inventory: ReloadContextInventory, heading?: string): string;

package/dist/app/commands/reload-context-inventory.js

@@ -0,0 +1,59 @@
+export function createReloadContextInventory(runtime, agentTypes) {
+    const session = runtime.session;
+    const tools = unique(session.getActiveToolNames());
+    const skillsReadable = tools.includes("read") || tools.includes("bash");
+    const subagentsActive = tools.includes("subagents");
+    const skills = skillsReadable
+        ? unique(session.resourceLoader.getSkills().skills.map((skill) => skill.name)).sort(compareText)
+        : [];
+    const agents = subagentsActive && agentTypes !== undefined
+        ? unique(agentTypes).sort(compareText)
+        : subagentsActive
+            ? undefined
+            : [];
+    return {
+        model: currentModelLabel(runtime),
+        skills,
+        tools,
+        agents,
+        skillsReadable,
+        subagentsActive,
+    };
+}
+export function formatReloadContextInventory(inventory, heading = "Reloaded keybindings, extensions, skills, prompts, themes") {
+    return [
+        heading,
+        "",
+        `Model: ${inventory.model}`,
+        "",
+        `Skills (in context): ${inventory.skillsReadable ? listOrNone(inventory.skills) : "(none; read/bash inactive)"}`,
+        "",
+        `Tools (active): ${listOrNone(inventory.tools)}`,
+        "",
+        `Agents (available): ${formatAgents(inventory)}`,
+    ].join("\n");
+}
+function currentModelLabel(runtime) {
+    const model = runtime.session.model;
+    if (!model)
+        return "unavailable";
+    const thinking = runtime.session.thinkingLevel;
+    const modelRef = `${model.provider}/${model.id}`;
+    return !thinking || thinking === "off" ? modelRef : `${modelRef}:${thinking}`;
+}
+function formatAgents(inventory) {
+    if (!inventory.subagentsActive)
+        return "(none; subagents tool inactive)";
+    if (inventory.agents === undefined)
+        return "(catalog unavailable)";
+    return listOrNone(inventory.agents);
+}
+function listOrNone(values) {
+    return values.length > 0 ? values.join(", ") : "(none)";
+}
+function unique(values) {
+    return [...new Set(values.map((value) => value.trim()).filter(Boolean))];
+}
+function compareText(left, right) {
+    return left.localeCompare(right);
+}

package/dist/app/extensions/extension-actions-controller.d.ts

@@ -4,6 +4,7 @@ import type { Entry } from "../types.js";
 export type AppExtensionActionsHost = {
     isRunning(): boolean;
     runtime(): AgentSessionRuntime | undefined;
+    subagentTypes?(runtime: AgentSessionRuntime): readonly string[] | undefined;
     getInput(): string;
     setInput(value: string): void;
     awaitCurrentSessionExtensions(runtime?: AgentSessionRuntime): Promise<void>;

package/dist/app/extensions/extension-actions-controller.js

@@ -1,6 +1,7 @@
 import { basename } from "node:path";
 import { createId } from "../id.js";
 import { logPixEvent } from "../logger.js";
+import { createReloadContextInventory, formatReloadContextInventory } from "../commands/reload-context-inventory.js";
 export class AppExtensionActionsController {
     host;
     logExtensionError;
@@ -60,6 +61,11 @@ export class AppExtensionActionsController {
                 if (!this.isSessionActive(runtime, session))
                     return;
                 this.host.setSessionStatus(session);
+                this.host.addEntry({
+                    id: createId("system"),
+                    kind: "system",
+                    text: formatReloadContextInventory(createReloadContextInventory(runtime, this.host.subagentTypes?.(runtime)), "Reloaded resources"),
+                });
                 this.host.showToast("Reloaded resources", "success");
                 this.host.render();
             },

package/dist/app/extensions/subagent-catalog-state.d.ts

@@ -0,0 +1,9 @@
+export declare const SUBAGENTS_CATALOG_STATE_EVENT = "pi-tools-suite:async-subagents:catalog";
+export interface SubagentCatalogState {
+    readonly version: 1;
+    readonly sessionId?: string;
+    readonly sessionFile?: string;
+    readonly model?: string;
+    readonly types: readonly string[];
+}
+export declare function parseSubagentCatalogState(value: unknown): SubagentCatalogState | undefined;

package/dist/app/extensions/subagent-catalog-state.js

@@ -0,0 +1,23 @@
+export const SUBAGENTS_CATALOG_STATE_EVENT = "pi-tools-suite:async-subagents:catalog";
+export function parseSubagentCatalogState(value) {
+    if (!isRecord(value) || value.version !== 1 || !Array.isArray(value.types))
+        return undefined;
+    if (!value.types.every((type) => typeof type === "string" && type.trim().length > 0))
+        return undefined;
+    if (value.sessionId !== undefined && typeof value.sessionId !== "string")
+        return undefined;
+    if (value.sessionFile !== undefined && typeof value.sessionFile !== "string")
+        return undefined;
+    if (value.model !== undefined && typeof value.model !== "string")
+        return undefined;
+    return {
+        version: 1,
+        ...(value.sessionId ? { sessionId: value.sessionId } : {}),
+        ...(value.sessionFile ? { sessionFile: value.sessionFile } : {}),
+        ...(value.model ? { model: value.model } : {}),
+        types: [...new Set(value.types.map((type) => type.trim()))],
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}

package/dist/app/icons.d.ts

@@ -33,6 +33,20 @@ declare const NERD_FONT_ICONS: {
     readonly toolPreviewTruncated: "⊞";
     readonly up: "↑";
     readonly down: "↓";
+    readonly agent: "󰚩";
+    readonly search: "󰍉";
+    readonly code: "󰅴";
+    readonly flask: "󰂓";
+    readonly globe: "󰇧";
+    readonly sparkles: "󰫢";
+    readonly brain: "󰧑";
+    readonly wrench: "󰖷";
+    readonly terminal: "󰆍";
+    readonly bug: "󰃤";
+    readonly book: "󰂺";
+    readonly eye: "󰈈";
+    readonly zap: "󰉁";
+    readonly rocket: "󰑣";
 };
 export type AppIconName = keyof typeof NERD_FONT_ICONS;
 export type AppIconMap = Record<AppIconName, string>;

package/dist/app/icons.js

@@ -44,6 +44,22 @@ const NERD_FONT_ICONS = {
     toolPreviewTruncated: "⊞",
     up: "↑",
     down: "↓",
+    // Sub-agent icons (agent .md frontmatter `icon:` names). Values are shared
+    // with the Pix Desktop lucide mapping in desktop/src/lib/agent-icons.ts.
+    agent: "\u{f06a9}", // nf-md-robot
+    search: "\u{f0349}", // nf-md-magnify
+    code: "\u{f0174}", // nf-md-code_tags
+    flask: "\u{f0093}", // nf-md-flask
+    globe: "\u{f01e7}", // nf-md-earth
+    sparkles: "\u{f0ae2}", // nf-md-star_four_points
+    brain: "\u{f09d1}", // nf-md-brain
+    wrench: "\u{f05b7}", // nf-md-wrench
+    terminal: "\u{f018d}", // nf-md-console
+    bug: "\u{f00e4}", // nf-md-bug
+    book: "\u{f00ba}", // nf-md-book
+    eye: "\u{f0208}", // nf-md-eye
+    zap: "\u{f0241}", // nf-md-flash
+    rocket: "\u{f0463}", // nf-md-rocket
 };
 const FALLBACK_ICONS = {
     alert: "⚠",
@@ -78,6 +94,23 @@ const FALLBACK_ICONS = {
     toolPreviewTruncated: "+",
     up: "↑",
     down: "↓",
+    // Sub-agent icon fallbacks (no icon-font codepoints; readable when the
+    // terminal font lacks Nerd Font glyphs). Emoji follow the existing fallback
+    // precedent (lightbulb, timerSand).
+    agent: "◇",
+    search: "⌕",
+    code: "{}",
+    flask: "∆",
+    globe: "⊕",
+    sparkles: "✦",
+    brain: "∞",
+    wrench: "⚙",
+    terminal: ">_",
+    bug: "🐛",
+    book: "▤",
+    eye: "◉",
+    zap: "↯",
+    rocket: "🚀",
 };
 export const APP_ICON_THEMES = {
     nerdFont: NERD_FONT_ICONS,

package/dist/app/rendering/conversation-tool-renderer.js

@@ -4,7 +4,7 @@ import { renderToolDisplay } from "../../tool-renderers/index.js";
 import { SUBAGENT_STATUSES, THINKING_TOOL_NAME, TODO_TOOL_NAME } from "../constants.js";
 import { attachImageClickTargets } from "../screen/image-click-targets.js";
 import { formatStructuredText } from "./message-content.js";
-import { formatSubagentTimestamp, isSubagentRunRenderDetails, isSubagentsToolName, subagentRunName, subagentStatusIcon, taskPreviewMap, } from "../subagents/subagents-model.js";
+import { formatSubagentTimestamp, isSubagentRunRenderDetails, isSubagentsToolName, subagentIcon, subagentRunName, taskPreviewMap, } from "../subagents/subagents-model.js";
 import { formatTodoTaskLine, isTodoDetails, visibleTodoTasks } from "../todo/todo-model.js";
 import { renderToolBlock } from "./tool-block-renderer.js";
 export function renderConversationToolEntry(entry, width, options) {
@@ -202,7 +202,7 @@ function subagentsDetailsText(details) {
     return lines.join("\n");
 }
 function formatSubagentToolLine(agent, preview) {
-    const parts = [subagentStatusIcon(agent.status), agent.status, agent.id];
+    const parts = [subagentIcon(preview), agent.status, agent.id];
     if (preview?.model)
         parts.push(`model:${preview.model}`);
     if (preview?.task)

package/dist/app/rendering/dcp-stats.d.ts

@@ -1,2 +1,7 @@
 import type { AgentSession } from "@earendil-works/pi-coding-agent";
-export declare function formatDcpStatsToast(session: AgentSession): string;
+type FormatDcpStatsOptions = {
+    manualModeBaseline?: boolean;
+    configPath?: string;
+};
+export declare function formatDcpStatsToast(session: AgentSession, options?: FormatDcpStatsOptions): string;
+export {};