@oh-my-pi/pi-coding-agent 15.11.8 → 15.12.1

package/dist/types/collab/crypto.d.ts

@@ -1,11 +1,6 @@
-/**
- * AES-256-GCM sealing for collab frames.
- *
- * The room key lives only in the link fragment; the relay sees opaque bytes.
- * Sealed layout: `[12B IV][ciphertext+tag]`.
- */
 import type { CollabFrame } from "./protocol";
 export declare function generateRoomKey(): Uint8Array;
+export declare function generateWriteToken(): Uint8Array;
 export declare function importRoomKey(raw: Uint8Array): Promise<CryptoKey>;
 export declare function seal(key: CryptoKey, frame: CollabFrame): Promise<Uint8Array>;
 /** Inverse of {@link seal}. Throws on auth failure or malformed input. */

package/dist/types/collab/guest.d.ts

@@ -12,6 +12,8 @@ export declare class CollabGuestLink {
     readonly agentRegistry: AgentRegistry;
     /** Agent Hub actions routed to the host over the wire. */
     get hubRemote(): AgentHubRemote;
+    /** True when this guest joined through a read-only (view) link. */
+    get readOnly(): boolean;
     constructor(ctx: InteractiveModeContext);
     join(link: string): Promise<void>;
     /** User-initiated leave (or post-disconnect cleanup): restore the previous session. */

package/dist/types/collab/host.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Host side of a collab live session.
+ *
+ * Taps the host session's event stream and SessionManager append chokepoint,
+ * broadcasting entries/events/state to guests through the relay. Guests prompt
+ * and abort through us; the host machine runs the agent and tools. The host's
+ * subagent ecosystem is mirrored too: task EventBus traffic (observer HUD),
+ * agent-registry snapshots (Agent Hub table), hub chat/kill/revive commands,
+ * and incremental subagent-transcript reads.
+ */
 import type { InteractiveModeContext } from "../modes/types";
 import { type CollabParticipant } from "./protocol";
 /** Display name for this process's user in collab sessions. */
@@ -6,6 +16,12 @@ export declare class CollabHost {
     #private;
     constructor(ctx: InteractiveModeContext);
     get link(): string;
+    /** Browser deep link (`https://<relay>/#<link>`) — the relay serves the web client at `/`. */
+    get webLink(): string;
+    /** Read-only variant of {@link link}: bare room key, no write token. */
+    get viewLink(): string;
+    /** Read-only variant of {@link webLink}. */
+    get webViewLink(): string;
     get participants(): CollabParticipant[];
     start(relayUrl: string): Promise<void>;
     /** Broadcast a goodbye, detach all taps, and close the socket. */

package/dist/types/collab/protocol.d.ts

@@ -45,6 +45,8 @@ export type CollabFrame = Exclude<GuestFrame, {
     entries: SessionEntry[];
     state: CollabSessionState;
     agents: AgentSnapshot[];
+    /** True when this peer joined through a read-only (view) link. */
+    readOnly?: boolean;
 } | {
     t: "entry";
     entry: SessionEntry;
@@ -93,8 +95,19 @@ export declare function generateRoomId(): string;
  * `<roomId>#<key>`, other wss relays drop the scheme (`host[:port]/r/…`);
  * only localhost ws:// links keep their full URL so parsing cannot
  * mis-infer wss.
+ *
+ * Full links append the write token to the key in the fragment
+ * (`base64url(key ∥ writeToken)`); read-only (view) links carry the bare
+ * 32-byte key, which is also the pre-token link format.
+ */
+export declare function formatCollabLink(relayUrl: string, roomId: string, key: Uint8Array, writeToken?: Uint8Array): string;
+/**
+ * Render the browser deep link: `http(s)://<relay-host>/#<collab-link>`. The
+ * relay serves the web client at `/`, and the whole collab link (including the
+ * room key) rides in the fragment, so it never appears in any HTTP request.
+ * Terminals auto-link the https form, making it click-to-join.
  */
-export declare function formatCollabLink(relayUrl: string, roomId: string, key: Uint8Array): string;
+export declare function formatCollabWebLink(relayUrl: string, roomId: string, key: Uint8Array, writeToken?: Uint8Array): string;
 export declare function parseCollabLink(link: string): ParsedCollabLink | {
     error: string;
 };

package/dist/types/config/settings-schema.d.ts

@@ -1184,7 +1184,7 @@ export declare const SETTINGS_SCHEMA: {
     readonly doubleEscapeAction: {
         readonly type: "enum";
         readonly values: readonly ["branch", "tree", "none"];
-        readonly default: "tree";
+        readonly default: "branch";
         readonly ui: {
             readonly tab: "interaction";
             readonly group: "Input";
@@ -1396,7 +1396,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "collab.relayUrl": {
         readonly type: "string";
-        readonly default: "wss://relay.omp.sh";
+        readonly default: "wss://my.omp.sh";
         readonly ui: {
             readonly tab: "interaction";
             readonly group: "Collab";
@@ -1414,6 +1414,26 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Name shown to other collab participants (default: OS username)";
         };
     };
+    readonly "share.serverUrl": {
+        readonly type: "string";
+        readonly default: "https://my.omp.sh/s";
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Collab";
+            readonly label: "Share Server";
+            readonly description: "Share viewer/upload base used by /share (encrypted blob upload + viewer; links are <base>/<id>#<key>)";
+        };
+    };
+    readonly "share.redactSecrets": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Collab";
+            readonly label: "Share Secret Redaction";
+            readonly description: "Run the secret obfuscator over /share snapshots before upload (uses the secrets.* config)";
+        };
+    };
     readonly "stt.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -1757,6 +1777,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Prune older read results when the same file is read again (cache-aware, runs every turn)";
         };
     };
+    readonly "compaction.dropUseless": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "context";
+            readonly group: "Compaction";
+            readonly label: "Elide Uneventful Results";
+            readonly description: "Prune tool results flagged contextually useless (no matches, timed-out waits) once consumed (cache-aware)";
+        };
+    };
     readonly "snapcompact.systemPrompt": {
         readonly type: "enum";
         readonly values: readonly ["none", "agents-md", "all"];
@@ -4209,13 +4239,27 @@ export declare const SETTINGS_SCHEMA: {
         };
     };
     readonly "codexResets.autoRedeem": {
-        readonly type: "boolean";
-        readonly default: false;
+        readonly type: "enum";
+        readonly values: readonly ["unset", "yes", "no"];
+        readonly default: "unset";
         readonly ui: {
             readonly tab: "providers";
             readonly group: "Services";
             readonly label: "Codex Auto-Redeem Saved Resets";
-            readonly description: "When a turn is blocked by the Codex weekly limit on the active account and no other account is available, automatically spend one saved rate-limit reset (ChatGPT 'save rate limit resets'). Conservative: never fires for 5-hour-only or Spark limits, near a natural reset, or twice for the same block. Requires retries enabled.";
+            readonly description: "When a turn is blocked by the Codex weekly limit on the active account and no other account is available, run the conservative saved-reset check. unset asks before spending the first eligible reset, yes spends eligible resets without prompting, and no disables the check entirely. Requires retries enabled.";
+            readonly options: readonly [{
+                readonly value: "unset";
+                readonly label: "Unset";
+                readonly description: "Check eligibility, then ask before spending the first saved reset.";
+            }, {
+                readonly value: "yes";
+                readonly label: "Yes";
+                readonly description: "Spend eligible saved resets without prompting.";
+            }, {
+                readonly value: "no";
+                readonly label: "No";
+                readonly description: "Do not run the saved-reset auto-redeem check.";
+            }];
         };
     };
     readonly "codexResets.minBlockedMinutes": {
@@ -4475,6 +4519,7 @@ export interface CompactionSettings {
     idleThresholdTokens: number;
     idleTimeoutSeconds: number;
     supersedeReads: boolean;
+    dropUseless: boolean;
 }
 export interface ContextPromotionSettings {
     enabled: boolean;
@@ -4587,8 +4632,9 @@ export interface ShellMinimizerSettings {
     sourceOutlineLevel: "default" | "aggressive";
     legacyFilters: boolean | undefined;
 }
+export type CodexAutoRedeemMode = "unset" | "yes" | "no";
 export interface CodexResetsSettings {
-    autoRedeem: boolean;
+    autoRedeem: CodexAutoRedeemMode;
     minBlockedMinutes: number;
     keepCredits: number;
 }

package/dist/types/export/custom-share.d.ts

@@ -5,7 +5,7 @@ export interface CustomShareResult {
     message?: string;
 }
 export type CustomShareFn = (htmlPath: string) => Promise<CustomShareResult | string | undefined>;
-interface LoadedCustomShare {
+export interface LoadedCustomShare {
     path: string;
     fn: CustomShareFn;
 }
@@ -17,4 +17,3 @@ export declare function getCustomSharePath(): string | null;
  * Load the custom share script if it exists.
  */
 export declare function loadCustomShare(): Promise<LoadedCustomShare | null>;
-export {};

package/dist/types/export/html/index.d.ts

@@ -1,9 +1,47 @@
 import type { AgentState } from "@oh-my-pi/pi-agent-core";
-import { SessionManager } from "../../session/session-manager";
+import { type SessionEntry, type SessionHeader, SessionManager } from "../../session/session-manager";
+/** Compose the standalone export template: minified CSS, tool renderers, and viewer JS inlined. */
+export declare function getTemplate(): string;
 export interface ExportOptions {
     outputPath?: string;
     themeName?: string;
+    /** Embed subagent session transcripts found next to the session file (default true). */
+    includeSubSessions?: boolean;
 }
+/** Generate CSS custom properties for theme. Exported for the share-viewer build script. */
+export declare function generateThemeVars(themeName?: string): Promise<string>;
+/** Embedded subagent session transcript, keyed by slash-joined agent path in `SessionData.subSessions`. */
+export interface SubSession {
+    /** Bare agent id (session file stem), e.g. "ToolAsk". */
+    agentId: string;
+    /** Key of the parent sub-session, or null when spawned by the main session. */
+    parent: string | null;
+    header: SessionHeader | null;
+    entries: SessionEntry[];
+    leafId: string | null;
+}
+export interface SessionData {
+    header: SessionHeader | null;
+    entries: SessionEntry[];
+    leafId: string | null;
+    systemPrompt?: string;
+    tools?: {
+        name: string;
+        description: string;
+    }[];
+    subSessions?: Record<string, SubSession>;
+}
+/** Snapshot the session (plus optional agent state) into the JSON shape the viewer renders. */
+export declare function buildSessionData(sm: SessionManager, state?: AgentState): SessionData;
+/**
+ * Collect subagent session transcripts stored next to a session file.
+ *
+ * A session at `<dir>/<name>.jsonl` keeps its subagent sessions at `<dir>/<name>/<AgentId>.jsonl`;
+ * each subagent's own children nest the same way under `<dir>/<name>/<AgentId>/`. Keys in the
+ * returned record are slash-joined ids relative to the main session ("ToolAsk", "ToolAsk/Helper").
+ * Corrupt or empty files are skipped silently.
+ */
+export declare function collectSubSessions(sessionFile: string): Promise<Record<string, SubSession>>;
 /** Export session to HTML using SessionManager and AgentState. */
 export declare function exportSessionToHtml(sm: SessionManager, state?: AgentState, options?: ExportOptions | string): Promise<string>;
 /** Export session file to HTML (standalone). */

package/dist/types/export/share.d.ts

@@ -0,0 +1,43 @@
+import type { AgentState } from "@oh-my-pi/pi-agent-core";
+import { DEFAULT_SHARE_URL } from "@oh-my-pi/pi-wire";
+import type { SecretObfuscator } from "../secrets/obfuscator";
+import type { SessionManager } from "../session/session-manager";
+import { type SessionData } from "./html";
+export { DEFAULT_SHARE_URL };
+/** Hard cap for blobs accepted by the share server (mirrors relay shareMaxBytes). */
+export declare const SERVER_MAX_SEALED_BYTES = 1000000;
+export interface ShareSessionOptions {
+    /** Share server/viewer base URL; defaults to {@link DEFAULT_SHARE_URL}. */
+    serverUrl?: string;
+    /** Agent state for system prompt + tool descriptions in the snapshot. */
+    state?: AgentState;
+    /**
+     * Redacts the snapshot before sealing: deep-walks every string (entries,
+     * header, system prompt, tool descriptions) through the obfuscator, so
+     * secrets that landed in persisted entries (tool outputs reading .env,
+     * etc.) never leave the machine. Pass undefined to skip.
+     */
+    obfuscator?: SecretObfuscator;
+}
+export interface ShareSessionResult {
+    /** Viewer link: `<serverUrl>/<id>#<key>`. */
+    url: string;
+    method: "gist" | "server";
+    /** Underlying gist URL (gist method only). */
+    gistUrl?: string;
+    /** True when content was trimmed to fit the upload budget. */
+    truncated: boolean;
+    sealedBytes: number;
+}
+/** Build the snapshot that gets sealed and uploaded, redacted when an obfuscator is provided. */
+export declare function buildShareSnapshot(sm: SessionManager, options?: ShareSessionOptions): SessionData;
+/** Share the session; tries a secret gist first, then the share server. */
+export declare function shareSession(sm: SessionManager, options?: ShareSessionOptions): Promise<ShareSessionResult>;
+/** Strip trailing slashes so `<base>/<id>` composes cleanly. */
+export declare function normalizeShareServerUrl(serverUrl?: string): string;
+interface SealedSession {
+    sealed: Uint8Array<ArrayBuffer>;
+    truncated: boolean;
+}
+/** Seal `data`, trimming content until the sealed blob fits `maxBytes`. Exported for tests. */
+export declare function sealToFit(key: CryptoKey, data: SessionData, maxBytes: number): Promise<SealedSession>;

package/dist/types/main.d.ts

@@ -1,5 +1,6 @@
 import type { Args } from "./cli/args";
 import { ModelRegistry } from "./config/model-registry";
+import { type ScopedModel } from "./config/model-resolver";
 import { Settings } from "./config/settings";
 import { InteractiveMode } from "./modes/interactive-mode";
 import type { SubmittedUserInput } from "./modes/types";
@@ -12,6 +13,7 @@ export interface InteractiveModeNotify {
     kind: "warn" | "error" | "info";
     message: string;
 }
+export declare function buildModelScopeNotification(scopedModelsForDisplay: readonly Pick<ScopedModel, "model" | "thinkingLevel" | "explicitThinkingLevel">[], startupQuiet: boolean): InteractiveModeNotify | null;
 export declare function submitInteractiveInput(mode: Pick<InteractiveMode, "markPendingSubmissionStarted" | "finishPendingSubmission" | "showError" | "checkShutdownRequested">, session: Pick<AgentSession, "prompt" | "promptCustomMessage">, input: SubmittedUserInput): Promise<void>;
 type AcpSessionFactory = (cwd: string) => Promise<AgentSession>;
 export interface AcpSessionFactoryOptions {

package/dist/types/modes/components/agent-hub.d.ts

@@ -1,5 +1,7 @@
-import { Container } from "@oh-my-pi/pi-tui";
+import type { AgentTool } from "@oh-my-pi/pi-agent-core";
+import { Container, type TUI } from "@oh-my-pi/pi-tui";
 import type { KeyId } from "../../config/keybindings";
+import type { MessageRenderer } from "../../extensibility/extensions/types";
 import { IrcBus } from "../../irc/bus";
 import { AgentLifecycleManager } from "../../registry/agent-lifecycle";
 import { AgentRegistry } from "../../registry/agent-registry";
@@ -28,6 +30,22 @@ export interface AgentHubDeps {
     lifecycle?: AgentLifecycleManager;
     /** Injectable for tests; defaults to the process-global bus. */
     irc?: IrcBus;
+    /** TUI handle for transcript components; tests omit it and get a render-only stub. */
+    ui?: TUI;
+    /** Tool lookup for transcript renderers (labels, custom render functions). */
+    getTool?: (name: string) => AgentTool | undefined;
+    /** Extension message renderers for custom messages in the transcript. */
+    getMessageRenderer?: (customType: string) => MessageRenderer | undefined;
+    /** Cwd used by tool renderers for path shortening; defaults to the project dir. */
+    cwd?: string;
+    /** Mirrors the main transcript's thinking-block visibility. */
+    hideThinkingBlock?: () => boolean;
+    /** Keys toggling tool output expansion (app.tools.expand). */
+    expandKeys?: KeyId[];
+    /** Focus the main view on this agent's live session (ctx.focusAgentSession). When absent (collab guest, tests), Enter opens the in-hub chat view instead. */
+    focusAgent?: (id: string) => Promise<void>;
+    /** Current main session file; used to seed parked historical subagents after restart. */
+    sessionFile?: string | null;
     /** Collab guest: route actions/transcripts to the host instead of local sessions. */
     remote?: AgentHubRemote;
 }

package/dist/types/modes/components/status-line/component.d.ts

@@ -3,8 +3,13 @@ import type { AgentSession } from "../../../session/agent-session";
 import type { CollabStatus, EffectiveStatusLineSettings, StatusLineSettings } from "./types";
 export declare class StatusLineComponent implements Component {
     #private;
-    private readonly session;
+    private session;
     constructor(session: AgentSession);
+    /**
+     * Re-point the status line at another session (focus proxy). Invalidate: model/context/usage all derive
+     * from it. `focusedAgentId` is the focused subagent id while the view is proxied, undefined for main.
+     */
+    setSession(session: AgentSession, focusedAgentId?: string): void;
     updateSettings(settings: StatusLineSettings): void;
     getEffectiveSettingsForTest(): EffectiveStatusLineSettings;
     setAutoCompactEnabled(enabled: boolean): void;

package/dist/types/modes/components/status-line/types.d.ts

@@ -45,6 +45,8 @@ export type EffectiveStatusLineSettings = Required<Pick<StatusLineSettings, "lef
 export type RGB = readonly [number, number, number];
 export interface SegmentContext {
     session: AgentSession;
+    /** Focused subagent id while the view is proxied at its session, undefined otherwise. */
+    focusedAgentId?: string | undefined;
     width: number;
     options: StatusLineSegmentOptions;
     planMode: {

package/dist/types/modes/controllers/event-controller.d.ts

@@ -23,6 +23,13 @@ export declare class EventController {
      */
     notifyInterrupting(): void;
     subscribeToAgent(): void;
+    /**
+     * Clear every transcript-anchored/turn-scoped piece of state. Used by the
+     * session focus proxy when re-pointing the transcript at another session:
+     * components, timers, and stream-reveal state all reference the previous
+     * session's transcript and must not bleed into the new one.
+     */
+    resetTranscriptAnchors(): void;
     handleEvent(event: AgentSessionEvent): Promise<void>;
     sendCompletionNotification(): void;
 }

package/dist/types/modes/controllers/input-controller.d.ts

@@ -1,4 +1,4 @@
-import type { AutocompleteProvider, SlashCommand } from "@oh-my-pi/pi-tui";
+import { type AutocompleteProvider, type SlashCommand } from "@oh-my-pi/pi-tui";
 import type { InteractiveModeContext } from "../../modes/types";
 import { readImageFromClipboard, readTextFromClipboard } from "../../utils/clipboard";
 export declare class InputController {

package/dist/types/modes/controllers/session-focus-controller.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SessionFocusController - Weak retargeting primitive between the rendering/
+ * input layer and the AgentSession it displays.
+ *
+ * Focusing re-points the transcript, streaming event subscription, status
+ * line, and editor prompt/interrupt at a subagent's live AgentSession (from
+ * AgentRegistry) without touching the main session underneath; unfocusing
+ * re-attaches the main session and rebuilds the transcript from its
+ * authoritative state.
+ */
+import { AgentLifecycleManager } from "../../registry/agent-lifecycle";
+import { AgentRegistry } from "../../registry/agent-registry";
+import type { AgentSession } from "../../session/agent-session";
+import type { InteractiveModeContext } from "../types";
+export declare class SessionFocusController {
+    #private;
+    private ctx;
+    private registry;
+    private lifecycle;
+    constructor(ctx: InteractiveModeContext, registry?: AgentRegistry, lifecycle?: () => AgentLifecycleManager);
+    get focusedAgentId(): string | undefined;
+    /** Focused live session, undefined when unfocused. */
+    get target(): AgentSession | undefined;
+    /** Focus the main view on an agent's live session. Throws an Error with a user-displayable message. */
+    focusAgent(id: string): Promise<void>;
+    /** Focus the focused agent's parent agent, falling back to the main session. No-op when unfocused. */
+    focusParent(): Promise<void>;
+    /** Return to the main session. No-op when unfocused. */
+    unfocus(): Promise<void>;
+    dispose(): void;
+}

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

@@ -50,6 +50,9 @@ export interface InteractiveModeOptions {
  * Build the anchored subagent HUD block: a bold accent "Subagents" header plus
  * one hooked row per running agent in the same `Id: description` shape the
  * inline task rows use (muted task preview when no description was given).
+ * Only detached background spawns are listed: a sync task call blocks the
+ * parent turn and its inline tool block already renders progress live, and
+ * eval `agent()` spawns are rendered by their own eval cell tree.
  * Returns an empty array when nothing is running so the container can clear.
  */
 export declare function renderSubagentHudLines(sessions: ObservableSession[], columns: number): string[];
@@ -128,6 +131,12 @@ export declare class InteractiveMode implements InteractiveModeContext {
     mcpManager?: MCPManager;
     get eventController(): EventController;
     get eventBus(): EventBus | undefined;
+    get viewSession(): AgentSession;
+    get focusedAgentId(): string | undefined;
+    focusAgentSession(id: string): Promise<void>;
+    focusParentSession(): Promise<void>;
+    unfocusSession(): Promise<void>;
+    clearTransientSessionUi(): void;
     constructor(session: AgentSession, version: string, changelogMarkdown?: string | undefined, setToolUIContext?: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers?: LspStartupServerInfo[] | undefined, mcpManager?: MCPManager, eventBus?: EventBus, titleSystemPrompt?: string);
     playWelcomeIntro(): void;
     init(options?: InteractiveModeInitOptions): Promise<void>;

package/dist/types/modes/session-observer-registry.d.ts

@@ -9,6 +9,13 @@ export interface ObservableSession {
     status: "active" | "completed" | "failed" | "aborted";
     sessionFile?: string;
     parentToolCallId?: string;
+    /**
+     * Spawn runs as a detached background job (parent turn not blocked on it).
+     * The anchored subagent HUD only lists detached spawns: sync task spawns
+     * and eval `agent()` spawns are already rendered live by their own inline
+     * tool block / eval cell.
+     */
+    detached?: boolean;
     index?: number;
     lastUpdate: number;
     /** Latest progress snapshot from the subagent executor */

package/dist/types/modes/theme/theme.d.ts

@@ -6,7 +6,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.job" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc";
 export type SpinnerType = "status" | "activity";
 export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
 /** Check if a string is a valid ThemeColor value */
@@ -169,6 +169,7 @@ export declare class Theme {
         cost: string;
         time: string;
         pi: string;
+        ghost: string;
         agents: string;
         job: string;
         cache: string;

package/dist/types/modes/types.d.ts

@@ -81,6 +81,18 @@ export interface InteractiveModeContext {
     statusLine: StatusLineComponent;
     session: AgentSession;
     sessionManager: SessionManager;
+    /** Session the transcript/editor/status are attached to: the focused agent's, else `session`. */
+    readonly viewSession: AgentSession;
+    /** Id of the focused agent, undefined when the main session is attached. */
+    readonly focusedAgentId: string | undefined;
+    /** Focus the main view on an agent's live session (delegates to SessionFocusController.focusAgent). */
+    focusAgentSession(id: string): Promise<void>;
+    /** Focus the focused agent's parent session, falling back to main (delegates to focusParent). */
+    focusParentSession(): Promise<void>;
+    /** Return the view to the main session (delegates to SessionFocusController.unfocus). */
+    unfocusSession(): Promise<void>;
+    /** Clear loader, status/pending containers, streaming state, and pending tools. */
+    clearTransientSessionUi(): void;
     settings: Settings;
     keybindings: KeybindingsManager;
     agent: AgentSession["agent"];

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

@@ -341,6 +341,8 @@ export declare class AgentSession {
     getMnemopiSessionState(): MnemopiSessionState | undefined;
     /** TTSR manager for time-traveling stream rules */
     get ttsrManager(): TtsrManager | undefined;
+    /** Secret obfuscator, when secrets are configured; /share redaction reuses it. */
+    get obfuscator(): SecretObfuscator | undefined;
     /** Whether a TTSR abort is pending (stream was aborted to inject rules) */
     get isTtsrAbortPending(): boolean;
     /** Whether the plan-mode → compaction transition's expected internal abort is

package/dist/types/session/codex-auto-reset.d.ts

@@ -24,8 +24,8 @@
  * eligibility off exact limit ids (`openai-codex:primary` /
  * `openai-codex:secondary`) and `usedFraction`, never off `status`.
  *
- * ANTI-WASTE GATES (in evaluation order): the policy must be OFF unless opted
- * in; the active model must be Codex (not Spark — a Spark block lives on a
+ * ANTI-WASTE GATES (in evaluation order): the policy must not be set to "no";
+ * the active model must be Codex (not Spark — a Spark block lives on a
  * separate meter and it is unknown whether a credit even resets it); a fresh
  * usage report for the active account must confirm `limitReached`; the WEEKLY
  * (secondary) window must be genuinely exhausted — a 5h-only block self-heals
@@ -38,6 +38,7 @@
  * read-only views are passed in so the predicate itself stays deterministic.
  */
 import type { OAuthAccountIdentity, ResetCreditTarget, UsageReport } from "@oh-my-pi/pi-ai";
+import type { CodexAutoRedeemMode } from "../config/settings-schema";
 /** Weekly window counts as exhausted at `usedFraction >= 0.999` (used_percent >= 99.9). */
 export declare const WEEKLY_EXHAUSTED_MIN_FRACTION = 0.999;
 /** A weekly reset can never be more than one window length (7d) away; +1h slack for skew. */
@@ -48,6 +49,8 @@ export declare const REPORT_FRESHNESS_MS: number;
 export declare const ATTEMPT_COOLDOWN_MS = 60000;
 /** Minute bucket for blockKey, absorbing `reset_after_seconds`-derived jitter. */
 export declare const DEBOUNCE_BUCKET_MS = 60000;
+export declare function shouldEvaluateCodexAutoRedeem(mode: CodexAutoRedeemMode): boolean;
+export declare function shouldPromptCodexAutoRedeem(mode: CodexAutoRedeemMode): boolean;
 export type CodexAutoRedeemSkipReason = "disabled" | "wrong-provider" | "spark-model" | "no-identity" | "no-report" | "stale-report" | "not-limit-reached" | "weekly-not-exhausted" | "no-reset-time" | "reset-too-soon" | "reset-implausible" | "credits-unknown" | "reserve" | "already-attempted" | "cooldown";
 export interface CodexAutoRedeemInput {
     nowMs: number;
@@ -67,7 +70,7 @@ export interface CodexAutoRedeemInput {
     attemptedBlockKeys: ReadonlySet<string>;
     lastAttemptAtByAccount: ReadonlyMap<string, number>;
 }
-export type CodexAutoRedeemDecision = {
+export interface CodexAutoRedeemRedeemDecision {
     redeem: true;
     target: ResetCreditTarget;
     accountKey: string;
@@ -75,7 +78,8 @@ export type CodexAutoRedeemDecision = {
     weeklyResetAtMs: number;
     remainingMs: number;
     availableCount: number;
-} | {
+}
+export type CodexAutoRedeemDecision = CodexAutoRedeemRedeemDecision | {
     redeem: false;
     reason: CodexAutoRedeemSkipReason;
 };

package/dist/types/task/executor.d.ts

@@ -54,6 +54,13 @@ export interface ExecutorOptions {
     index: number;
     id: string;
     parentToolCallId?: string;
+    /**
+     * Spawn runs as a detached background job (parent turn not blocked on it).
+     * Rides the subagent lifecycle/progress payloads so HUD-style surfaces can
+     * skip spawns the transcript already renders inline. See
+     * {@link SubagentLifecyclePayload.detached}.
+     */
+    detached?: boolean;
     modelOverride?: string | string[];
     /**
      * Active model selector of the parent session, used as an auth-aware fallback

package/dist/types/task/types.d.ts

@@ -25,6 +25,8 @@ export interface SubagentProgressPayload {
     assignment?: string;
     progress: AgentProgress;
     sessionFile?: string;
+    /** See {@link SubagentLifecyclePayload.detached}. */
+    detached?: boolean;
 }
 /** Payload emitted on TASK_SUBAGENT_EVENT_CHANNEL */
 export interface SubagentEventPayload {
@@ -41,6 +43,13 @@ export interface SubagentLifecyclePayload {
     sessionFile?: string;
     parentToolCallId?: string;
     index: number;
+    /**
+     * Spawn runs as a detached background job: the parent turn keeps working
+     * while this agent runs. Sync task spawns (parent blocked on the call) and
+     * eval `agent()` bridge spawns (rendered inside their eval cell) leave this
+     * unset — surfaces like the subagent HUD only list detached spawns.
+     */
+    detached?: boolean;
 }
 export declare const taskItemSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;

package/dist/types/tools/tool-result.d.ts

@@ -26,6 +26,8 @@ export declare class ToolResultBuilder<TDetails extends DetailsWithMeta> {
     diagnostics(summary: string, messages: string[]): this;
     /** Flag the result as a non-throwing failure (agent-loop surfaces it as a tool error). */
     error(value?: boolean): this;
+    /** Marks the result contextually useless — compaction may elide it once consumed. */
+    useless(value?: boolean): this;
     done(): AgentToolResult<TDetails>;
 }
 export declare function toolResult<TDetails extends DetailsWithMeta>(details?: TDetails): ToolResultBuilder<TDetails>;