@oh-my-pi/pi-coding-agent 15.11.7 → 15.12.0

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

@@ -3,6 +3,8 @@ import type { CompactionOutcome } from "@oh-my-pi/pi-agent-core/compaction";
 import type { AssistantMessage, ImageContent, Message, UsageReport } from "@oh-my-pi/pi-ai";
 import type { Component, EditorTheme } from "@oh-my-pi/pi-tui";
 import { Container, Loader, Spacer, Text, TUI } from "@oh-my-pi/pi-tui";
+import type { CollabGuestLink } from "../collab/guest";
+import type { CollabHost } from "../collab/host";
 import { KeybindingsManager } from "../config/keybindings";
 import { Settings } from "../config/settings";
 import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
@@ -25,6 +27,7 @@ import type { HookSelectorComponent, HookSelectorSlider } from "./components/hoo
 import { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
 import { TranscriptContainer } from "./components/transcript-container";
+import { EventController } from "./controllers/event-controller";
 import { type LoopLimitRuntime } from "./loop-limit";
 import { OAuthManualInputManager } from "./oauth-manual-input";
 import type { ObservableSession } from "./session-observer-registry";
@@ -47,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[];
@@ -119,8 +125,18 @@ export declare class InteractiveMode implements InteractiveModeContext {
     fileSlashCommands: Set<string>;
     skillCommands: Map<string, string>;
     oauthManualInput: OAuthManualInputManager;
+    collabHost?: CollabHost;
+    collabGuest?: CollabGuestLink;
     readonly lspServers: LspStartupServerInfo[] | undefined;
     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

@@ -2,6 +2,8 @@ import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import type { CompactionOutcome } from "@oh-my-pi/pi-agent-core/compaction";
 import type { AssistantMessage, ImageContent, Message, UsageReport } from "@oh-my-pi/pi-ai";
 import type { Component, Container, EditorTheme, Loader, Spacer, Text, TUI } from "@oh-my-pi/pi-tui";
+import type { CollabGuestLink } from "../collab/guest";
+import type { CollabHost } from "../collab/host";
 import type { KeybindingsManager } from "../config/keybindings";
 import type { Settings } from "../config/settings";
 import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
@@ -13,6 +15,7 @@ import type { HistoryStorage } from "../session/history-storage";
 import type { SessionContext, SessionManager } from "../session/session-manager";
 import type { ShakeMode } from "../session/shake-types";
 import type { LspStartupServerInfo } from "../tools";
+import type { EventBus } from "../utils/event-bus";
 import type { AssistantMessageComponent } from "./components/assistant-message";
 import type { BashExecutionComponent } from "./components/bash-execution";
 import type { CustomEditor } from "./components/custom-editor";
@@ -23,6 +26,7 @@ import type { HookSelectorComponent, HookSelectorOptions } from "./components/ho
 import type { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
 import type { TranscriptContainer } from "./components/transcript-container";
+import type { EventController } from "./controllers/event-controller";
 import type { LoopLimitRuntime } from "./loop-limit";
 import type { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
@@ -77,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"];
@@ -84,6 +100,10 @@ export interface InteractiveModeContext {
     mcpManager?: MCPManager;
     lspServers?: LspStartupServerInfo[];
     titleSystemPrompt?: string;
+    collabHost?: CollabHost;
+    collabGuest?: CollabGuestLink;
+    eventController: EventController;
+    eventBus?: EventBus;
     isInitialized: boolean;
     isBashMode: boolean;
     toolOutputExpanded: boolean;

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
@@ -385,6 +387,9 @@ export declare class AgentSession {
      */
     subscribe(listener: AgentSessionEventListener): () => void;
     subscribeCommandMetadataChanged(listener: CommandMetadataChangedListener): () => void;
+    /** True once dispose() has begun; deferred background work (e.g. the deferred
+     *  MCP discovery task in sdk.ts) must not touch the session past this point. */
+    get isDisposed(): boolean;
     /**
      * Synchronously mark the session as disposing so new work is rejected
      * immediately: Python/eval starts throw, queued asides are dropped, and the
@@ -443,6 +448,14 @@ export declare class AgentSession {
      */
     getAllToolNames(): string[];
     isMCPDiscoveryEnabled(): boolean;
+    /**
+     * Flip MCP discovery on after deferred discovery learns the real tool count.
+     * UI sessions resolve `tools.discoveryMode: "auto"` before MCP servers
+     * connect, so a large MCP toolset discovered later must be able to upgrade
+     * the session from the force-activate path to the discovery path. One-way:
+     * discovery is never downgraded mid-session.
+     */
+    enableMCPDiscovery(): void;
     getSelectedMCPToolNames(): string[];
     activateDiscoveredMCPTools(toolNames: string[]): Promise<string[]>;
     isToolDiscoveryEnabled(): boolean;

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/session/session-manager.d.ts

@@ -309,6 +309,12 @@ export declare class SessionManager {
     private sessionDir;
     private readonly persist;
     private readonly storage;
+    /**
+     * Collab replication tap: invoked for every appended entry with the
+     * in-memory (pre-blob-externalization) entry, so inline images survive.
+     * Failures are swallowed — a broadcast error must never break persistence.
+     */
+    onEntryAppended?: (entry: SessionEntry) => void;
     private constructor();
     /** Puts a binary blob into the blob store and returns the blob reference */
     putBlob(data: Buffer, options?: BlobPutOptions): Promise<BlobPutResult>;
@@ -434,6 +440,21 @@ export declare class SessionManager {
      */
     setSessionName(name: string, source?: "auto" | "user"): Promise<boolean>;
     _persist(entry: SessionEntry): void;
+    /**
+     * Append a foreign (host-authored) entry verbatim, preserving its
+     * `id`/`parentId` — no id minting. Used by collab guests to mirror the
+     * host session into the local replica file.
+     */
+    ingestReplicatedEntry(entry: SessionEntry): void;
+    /**
+     * Snapshot the session for collab replication: the live header plus a deep
+     * copy of every entry (the host mutates entries in place on
+     * truncation/rewrite paths, so guests must not share references).
+     */
+    snapshotForReplication(): {
+        header: SessionHeader;
+        entries: SessionEntry[];
+    };
     /** Append a message as child of current leaf, then advance leaf. Returns entry id.
      * Does not allow writing CompactionSummaryMessage and BranchSummaryMessage directly.
      * Reason: we want these to be top-level entries in the session, not message session entries,

package/dist/types/session/snapcompact-inline.d.ts

@@ -24,14 +24,16 @@ export interface SnapcompactInlineOptions {
 }
 /** Tool-result swap candidate, in context order. */
 export interface InlineToolResultCandidate {
-    /** toolCallId — stable identity for render caching and application. */
+    /** Stable identifier for rendering cache key and applying the swap. */
     id: string;
-    /** Token count of the joined text blocks (0 when empty or image-carrying). */
+    /** Token count of the joined text blocks (0 for empty or image-carrying). */
     textTokens: number;
-    /** Frames needed to render the text (0 = empty or below the token floor). */
+    /** Frames needed to render the text (0 = empty, below floor, image-carrying, or error). */
     frames: number;
     /** Already carries an image (screenshot etc.) — never re-imaged. */
     hasImage: boolean;
+    /** Error tool results must stay text-only for provider API validation. */
+    isError?: boolean;
 }
 export interface InlineSystemPromptCandidate {
     textTokens: number;
@@ -73,6 +75,7 @@ export interface InlineMessageView {
     role: string;
     toolCallId?: string;
     content?: unknown;
+    isError?: boolean;
 }
 export interface SnapcompactSavingsEstimate {
     /** Frames only ship on models that accept image input. */

package/dist/types/slash-commands/builtin-registry.d.ts

@@ -1,3 +1,4 @@
+import type { AutocompleteItem } from "@oh-my-pi/pi-tui";
 import type { BuiltinSlashCommand, ParsedSlashCommand, SlashCommandResult, SlashCommandRuntime, SlashCommandSpec, TuiSlashCommandRuntime } from "./types";
 export type { BuiltinSlashCommand, SubcommandDef } from "./types";
 /** TUI-specific runtime accepted by `executeBuiltinSlashCommand`. */
@@ -5,6 +6,14 @@ export type BuiltinSlashCommandRuntime = TuiSlashCommandRuntime;
 export declare const BUILTIN_SLASH_COMMAND_RESERVED_NAMES: ReadonlySet<string>;
 /** Builtin command metadata used for slash-command autocomplete and help text. */
 export declare const BUILTIN_SLASH_COMMAND_DEFS: ReadonlyArray<BuiltinSlashCommand>;
+/**
+ * Materialized builtin slash commands with completion functions derived from
+ * declarative subcommand/hint definitions.
+ */
+export declare const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand & {
+    getArgumentCompletions?: (prefix: string) => AutocompleteItem[] | null;
+    getInlineHint?: (argumentText: string) => string | null;
+}>;
 /**
  * Unified registry exposed for cross-mode tooling. Each spec carries at least
  * one of `handle` / `handleTui`. The TUI dispatcher prefers `handleTui`; the

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/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.11.7",
+	"version": "15.12.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -40,23 +40,24 @@
 		"fmt": "biome format --write . && bun run format-prompts",
 		"format-prompts": "bun scripts/format-prompts.ts",
 		"generate-docs-index": "bun scripts/generate-docs-index.ts",
-		"prepack": "bun scripts/generate-docs-index.ts && bun scripts/bundle-dist.ts",
-		"generate-template": "bun scripts/generate-template.ts"
+		"prepack": "bun scripts/generate-docs-index.ts && bun --cwd=../collab-web run build:tool-views && bun scripts/bundle-dist.ts",
+		"bench:guard": "bun scripts/bench-guard.ts"
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.22.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "15.11.7",
-		"@oh-my-pi/omp-stats": "15.11.7",
-		"@oh-my-pi/pi-agent-core": "15.11.7",
-		"@oh-my-pi/pi-ai": "15.11.7",
-		"@oh-my-pi/pi-catalog": "15.11.7",
-		"@oh-my-pi/pi-mnemopi": "15.11.7",
-		"@oh-my-pi/pi-natives": "15.11.7",
-		"@oh-my-pi/pi-tui": "15.11.7",
-		"@oh-my-pi/pi-utils": "15.11.7",
-		"@oh-my-pi/snapcompact": "15.11.7",
+		"@oh-my-pi/hashline": "15.12.0",
+		"@oh-my-pi/omp-stats": "15.12.0",
+		"@oh-my-pi/pi-agent-core": "15.12.0",
+		"@oh-my-pi/pi-ai": "15.12.0",
+		"@oh-my-pi/pi-catalog": "15.12.0",
+		"@oh-my-pi/pi-mnemopi": "15.12.0",
+		"@oh-my-pi/pi-natives": "15.12.0",
+		"@oh-my-pi/pi-tui": "15.12.0",
+		"@oh-my-pi/pi-utils": "15.12.0",
+		"@oh-my-pi/pi-wire": "15.12.0",
+		"@oh-my-pi/snapcompact": "15.12.0",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",

package/scripts/bench-guard.ts

@@ -0,0 +1,71 @@
+#!/usr/bin/env bun
+/**
+ * Boot-time regression guard (Phase A1 of the boot/TUI perf work).
+ *
+ * Re-runs the `PI_TIMING=x` cold-boot benchmark under hyperfine and fails when
+ * the median regresses past `baseline * THRESHOLD`. `PI_TIMING=x` runs the full
+ * pre-paint chain in `runRootCommand` and then `process.exit(0)`, so the
+ * never-exiting interactive launch becomes a terminating, benchmarkable boot.
+ *
+ * Boot wall-clock is MACHINE-RELATIVE: a baseline captured on one machine is
+ * meaningless on another (and on CI). This is a LOCAL guard — regenerate the
+ * baseline on the machine you measure on, then compare on that same machine.
+ * It is intentionally NOT wired into CI for that reason.
+ *
+ *   bun scripts/bench-guard.ts --update   # capture/refresh the baseline
+ *   bun scripts/bench-guard.ts            # measure + compare; exit 1 on regression
+ *
+ * Requires `hyperfine` on PATH.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+const THRESHOLD = 1.05; // 5% regression budget
+const BASELINE_PATH = path.join(import.meta.dir, "..", "bench", "boot-baseline.json");
+const BENCH_COMMAND = "PI_TIMING=x bun src/cli.ts";
+const cwd = path.join(import.meta.dir, "..");
+
+function medianOf(hyperfineJson: string): number {
+	const parsed = JSON.parse(hyperfineJson) as { results: Array<{ mean: number; median?: number }> };
+	const result = parsed.results[0];
+	if (!result) throw new Error("hyperfine produced no result");
+	return result.median ?? result.mean;
+}
+
+async function measure(): Promise<{ seconds: number; raw: string }> {
+	const tmp = path.join(import.meta.dir, "..", "bench", `.boot-run-${Date.now()}.json`);
+	const proc = Bun.spawn(["hyperfine", "--warmup", "3", "--min-runs", "10", "--export-json", tmp, BENCH_COMMAND], {
+		cwd,
+		stdout: "inherit",
+		stderr: "inherit",
+	});
+	const code = await proc.exited;
+	if (code !== 0) throw new Error(`hyperfine exited ${code}`);
+	const raw = await Bun.file(tmp).text();
+	fs.rmSync(tmp, { force: true });
+	return { seconds: medianOf(raw), raw };
+}
+
+const update = process.argv.includes("--update");
+const { seconds, raw } = await measure();
+
+if (update) {
+	fs.mkdirSync(path.dirname(BASELINE_PATH), { recursive: true });
+	await Bun.write(BASELINE_PATH, raw);
+	console.log(`Baseline updated: ${(seconds * 1000).toFixed(0)}ms median -> ${BASELINE_PATH}`);
+	process.exit(0);
+}
+
+if (!fs.existsSync(BASELINE_PATH)) {
+	console.error("No baseline found. Run `bun scripts/bench-guard.ts --update` on this machine first.");
+	process.exit(2);
+}
+
+const baseline = medianOf(await Bun.file(BASELINE_PATH).text());
+const ratio = seconds / baseline;
+const verdict = ratio > THRESHOLD ? "REGRESSION" : "ok";
+console.log(
+	`boot median: ${(seconds * 1000).toFixed(0)}ms vs baseline ${(baseline * 1000).toFixed(0)}ms ` +
+		`(${((ratio - 1) * 100).toFixed(1)}%, budget ${((THRESHOLD - 1) * 100).toFixed(0)}%) -> ${verdict}`,
+);
+process.exit(ratio > THRESHOLD ? 1 : 0);

package/scripts/build-binary.ts

@@ -59,6 +59,10 @@ async function main(): Promise<void> {
 					`process.env.PI_TINY_TRANSFORMERS_VERSION=${JSON.stringify(transformersVersion)}`,
 					"--external",
 					"mupdf",
+					"--external",
+					"fastembed",
+					"--external",
+					"onnxruntime-node",
 					"--root",
 					".",
 					"./packages/coding-agent/src/cli.ts",

package/scripts/bundle-dist.ts

@@ -72,6 +72,10 @@ async function main(): Promise<void> {
 			"@oh-my-pi/pi-natives",
 			"--external",
 			"@huggingface/transformers",
+			"--external",
+			"fastembed",
+			"--external",
+			"onnxruntime-node",
 			"--define",
 			'process.env.PI_BUNDLED="true"',
 			"./src/cli.ts",

package/scripts/generate-share-viewer.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+/**
+ * Build the standalone share-viewer page the omp relay serves at `GET /s/<id>`.
+ *
+ * Same template as HTML exports, but with no embedded session: share-loader.js
+ * (injected right after the empty #session-data tag) fetches the sealed blob
+ * (gist or relay store), decrypts it with the `#<key>` fragment in-browser, and
+ * hands the JSON to template.js via `window.__OMP_SESSION_DATA__`.
+ *
+ * The relay repo's build script runs this and embeds the output via go:embed.
+ */
+import * as path from "node:path";
+import { generateThemeVars, getTemplate } from "../src/export/html";
+
+const outPath = process.argv[2];
+if (!outPath) {
+	console.error("usage: bun scripts/generate-share-viewer.ts <output.html>");
+	process.exit(2);
+}
+
+const loaderJs = await Bun.file(new URL("../src/export/html/share-loader.js", import.meta.url).pathname).text();
+// Pin a built-in theme: the viewer is a public artifact, not a per-user export.
+const themeVars = await generateThemeVars("dark");
+
+const html = getTemplate()
+	.replace("<theme-vars/>", () => `<style>:root { ${themeVars} }</style>`)
+	.replace("<title>Session Export</title>", () => "<title>omp session</title>")
+	.replace("{{SESSION_DATA}}</script>", () => `</script>\n  <script>${loaderJs}</script>`);
+
+if (html.includes("{{SESSION_DATA}}")) throw new Error("session-data placeholder survived substitution");
+if (!html.includes("__OMP_SESSION_DATA__")) throw new Error("share loader not injected");
+
+await Bun.write(outPath, html);
+console.log(`Generated ${path.resolve(outPath)} (${(html.length / 1024).toFixed(0)} KB)`);

package/src/cli/args.ts

@@ -32,6 +32,8 @@ export interface Args {
 	sessionDir?: string;
 	providerSessionId?: string;
 	fork?: string;
+	/** Collab link to join at startup (set by the `join` subcommand; no CLI flag). */
+	join?: string;
 	models?: string[];
 	tools?: string[];
 	noTools?: boolean;

package/src/cli-commands.ts

@@ -26,6 +26,7 @@ export const commands: CommandEntry[] = [
 	{ name: "gallery", load: () => import("./commands/gallery").then(m => m.default) },
 	{ name: "grievances", load: () => import("./commands/grievances").then(m => m.default) },
 	{ name: "install", load: () => import("./commands/install").then(m => m.default) },
+	{ name: "join", load: () => import("./commands/join").then(m => m.default) },
 	{ name: "plugin", load: () => import("./commands/plugin").then(m => m.default) },
 	{ name: "setup", load: () => import("./commands/setup").then(m => m.default) },
 	{ name: "shell", load: () => import("./commands/shell").then(m => m.default) },