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

package/dist/types/cli/args.d.ts

@@ -26,6 +26,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/dist/types/collab/crypto.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 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. */
+export declare function open(key: CryptoKey, data: Uint8Array): Promise<CollabFrame>;

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

@@ -0,0 +1,21 @@
+import type { ImageContent } from "@oh-my-pi/pi-ai";
+import type { AgentHubRemote } from "../modes/components/agent-hub";
+import type { InteractiveModeContext } from "../modes/types";
+import { AgentRegistry } from "../registry/agent-registry";
+import { type CollabSessionState } from "./protocol";
+/** Commands a guest may run locally; everything else is host-only. */
+export declare const COLLAB_GUEST_ALLOWED_COMMANDS: Record<string, true>;
+export declare class CollabGuestLink {
+    #private;
+    state: CollabSessionState | null;
+    /** Local mirror of the host's agent ecosystem (refs carry `session: null`). */
+    readonly agentRegistry: AgentRegistry;
+    /** Agent Hub actions routed to the host over the wire. */
+    get hubRemote(): AgentHubRemote;
+    constructor(ctx: InteractiveModeContext);
+    join(link: string): Promise<void>;
+    /** User-initiated leave (or post-disconnect cleanup): restore the previous session. */
+    leave(_reason: string): Promise<void>;
+    sendPrompt(text: string, images?: ImageContent[]): void;
+    sendAbort(): void;
+}

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

@@ -0,0 +1,13 @@
+import type { InteractiveModeContext } from "../modes/types";
+import { type CollabParticipant } from "./protocol";
+/** Display name for this process's user in collab sessions. */
+export declare function collabDisplayName(ctx: InteractiveModeContext): string;
+export declare class CollabHost {
+    #private;
+    constructor(ctx: InteractiveModeContext);
+    get link(): string;
+    get participants(): CollabParticipant[];
+    start(relayUrl: string): Promise<void>;
+    /** Broadcast a goodbye, detach all taps, and close the socket. */
+    stop(reason: string): Promise<void>;
+}

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

@@ -0,0 +1,100 @@
+/**
+ * Collab live-session wire protocol.
+ *
+ * Hub topology: the host is authoritative, guests never peer. All session
+ * payloads (`CollabFrame`) travel AES-256-GCM sealed; the relay only sees the
+ * plaintext envelope (`[4B uint32 BE peerId][sealed payload]`) plus TEXT JSON
+ * control messages that carry no session data.
+ */
+import type { ImageContent, Model } from "@oh-my-pi/pi-ai";
+import type { BusChannel, GuestFrame, ParsedCollabLink, Participant, SessionState, AgentSnapshot as WireAgentSnapshot } from "@oh-my-pi/pi-wire";
+import { DEFAULT_RELAY_URL, ENVELOPE_HEADER_LENGTH, ROOM_ID_BYTES } from "@oh-my-pi/pi-wire";
+import type { ContextUsage } from "../extensibility/extensions/types";
+import type { AgentSessionEvent } from "../session/agent-session";
+import type { SessionEntry, SessionHeader } from "../session/session-manager";
+export type { CollabPromptDetails, ParsedCollabLink, RelayControlMessage, RelayControlToGuest, RelayControlToHost, } from "@oh-my-pi/pi-wire";
+export { COLLAB_PROMPT_MESSAGE_TYPE, COLLAB_PROTO } from "@oh-my-pi/pi-wire";
+export { DEFAULT_RELAY_URL, ENVELOPE_HEADER_LENGTH, ROOM_ID_BYTES };
+export type CollabParticipant = Participant;
+export type AgentSnapshot = WireAgentSnapshot;
+/** Debounced footer snapshot broadcast by the host. */
+export type CollabSessionState = SessionState & {
+    /**
+     * Host model (full catalog object). Guests apply it to their replica
+     * agent state so model display and context-window math are native.
+     */
+    model?: Model;
+    /** Host status-line context numbers (guest system prompt/tools differ, so local estimates drift). */
+    contextUsage?: ContextUsage;
+};
+/**
+ * Encrypted payload frames (inside AES-GCM, JSON). The wire package pins the
+ * JSON skeleton (`WireFrame`); host-side frames carry the rich session types
+ * that serialize into those shapes.
+ */
+export type CollabFrame = Exclude<GuestFrame, {
+    t: "prompt";
+}> | {
+    t: "prompt";
+    text: string;
+    images?: ImageContent[];
+} | {
+    t: "welcome";
+    proto: number;
+    header: SessionHeader;
+    entries: SessionEntry[];
+    state: CollabSessionState;
+    agents: AgentSnapshot[];
+} | {
+    t: "entry";
+    entry: SessionEntry;
+} | {
+    t: "event";
+    event: AgentSessionEvent;
+} | {
+    t: "state";
+    state: CollabSessionState;
+}
+/** Mirrored EventBus traffic (task subagent lifecycle/progress channels only). */
+ | {
+    t: "bus";
+    channel: BusChannel;
+    data: unknown;
+}
+/** Full agent-registry snapshot (debounced on registry change). */
+ | {
+    t: "agents";
+    agents: AgentSnapshot[];
+}
+/** Targeted reply to fetch-transcript; `text` is decoded JSONL from `fromByte`, `newSize` the next offset base. */
+ | {
+    t: "transcript";
+    reqId: number;
+    text: string;
+    newSize: number;
+    error?: string;
+} | {
+    t: "bye";
+    reason: string;
+} | {
+    t: "error";
+    message: string;
+};
+export declare function packEnvelope(peerId: number, sealed: Uint8Array): Uint8Array;
+export declare function unpackEnvelope(data: Uint8Array): {
+    peerId: number;
+    payload: Uint8Array;
+} | null;
+/** Rewrite the peerId in place without copying the payload. */
+export declare function rewriteEnvelopePeer(data: Uint8Array, peerId: number): void;
+export declare function generateRoomId(): string;
+/**
+ * Render the shareable link. Compact forms: the default relay collapses to
+ * `<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.
+ */
+export declare function formatCollabLink(relayUrl: string, roomId: string, key: Uint8Array): string;
+export declare function parseCollabLink(link: string): ParsedCollabLink | {
+    error: string;
+};

package/dist/types/collab/relay-client.d.ts

@@ -0,0 +1,22 @@
+import type { CollabFrame, RelayControlMessage } from "./protocol";
+export interface CollabSocketOptions {
+    /** wss://host[:port]/r/<roomId> — no query string. */
+    wsUrl: string;
+    role: "host" | "guest";
+    key: CryptoKey;
+}
+export declare class CollabSocket {
+    #private;
+    /** Fires after every successful (re)connect. */
+    onOpen?: () => void;
+    onFrame?: (frame: CollabFrame, fromPeer: number) => void;
+    onControl?: (msg: RelayControlMessage) => void;
+    /** Fires once per terminal close (intentional, fatal code, or bad key). willReconnect=true for transient drops that will retry. */
+    onClose?: (reason: string, willReconnect: boolean) => void;
+    constructor(opts: CollabSocketOptions);
+    get isOpen(): boolean;
+    connect(): void;
+    send(frame: CollabFrame, targetPeer?: number): void;
+    /** Intentional close: clears any retry timer, suppresses reconnect. A later connect() starts fresh. */
+    close(): void;
+}

package/dist/types/commands/join.d.ts

@@ -0,0 +1,12 @@
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Join extends Command {
+    static description: string;
+    static args: {
+        link: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: true;
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

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

@@ -33,7 +33,7 @@ export declare const TAB_METADATA: Record<SettingTab, {
  */
 export declare const TAB_GROUPS: Record<SettingTab, readonly string[]>;
 /** Status line segment identifiers */
-export type StatusLineSegmentId = "pi" | "model" | "mode" | "path" | "git" | "pr" | "subagents" | "token_in" | "token_out" | "token_total" | "token_rate" | "cost" | "context_pct" | "context_total" | "time_spent" | "time" | "session" | "hostname" | "cache_read" | "cache_write" | "cache_hit" | "session_name" | "usage";
+export type StatusLineSegmentId = "pi" | "model" | "mode" | "path" | "git" | "pr" | "subagents" | "token_in" | "token_out" | "token_total" | "token_rate" | "cost" | "context_pct" | "context_total" | "time_spent" | "time" | "session" | "hostname" | "cache_read" | "cache_write" | "cache_hit" | "session_name" | "usage" | "collab";
 /** Submenu choice metadata. */
 export type SubmenuOption<V extends string = string> = {
     value: V;
@@ -1394,6 +1394,26 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Notify when the ask tool is waiting for input";
         };
     };
+    readonly "collab.relayUrl": {
+        readonly type: "string";
+        readonly default: "wss://relay.omp.sh";
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Collab";
+            readonly label: "Relay URL";
+            readonly description: "Relay used by /collab (wss://host[:port]; self-host with the omp-collab-relay service)";
+        };
+    };
+    readonly "collab.displayName": {
+        readonly type: "string";
+        readonly default: "";
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Collab";
+            readonly label: "Display Name";
+            readonly description: "Name shown to other collab participants (default: OS username)";
+        };
+    };
     readonly "stt.enabled": {
         readonly type: "boolean";
         readonly default: false;

package/dist/types/extensibility/slash-commands.d.ts

@@ -1,5 +1,3 @@
-import type { AutocompleteItem } from "@oh-my-pi/pi-tui";
-import { type BuiltinSlashCommand } from "../slash-commands/builtin-registry";
 export type SlashCommandSource = "extension" | "prompt" | "skill";
 export type SlashCommandLocation = "user" | "project" | "path";
 export interface SlashCommandInfo {
@@ -9,15 +7,7 @@ export interface SlashCommandInfo {
     location?: SlashCommandLocation;
     path?: string;
 }
-export type { BuiltinSlashCommand, SubcommandDef } from "../slash-commands/builtin-registry";
-/**
- * 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;
-}>;
+export type { BuiltinSlashCommand, SubcommandDef } from "../slash-commands/types";
 /**
  * Represents a custom slash command loaded from a file
  */

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

@@ -4,6 +4,17 @@ import { IrcBus } from "../../irc/bus";
 import { AgentLifecycleManager } from "../../registry/agent-lifecycle";
 import { AgentRegistry } from "../../registry/agent-registry";
 import type { SessionObserverRegistry } from "../session-observer-registry";
+/** Guest-side proxy for hub actions executed on the collab host. */
+export interface AgentHubRemote {
+    chat(id: string, text: string): void;
+    kill(id: string): void;
+    revive(id: string): void;
+    /** Mirrors readFileIncremental: text from fromByte (complete JSONL lines), newSize = next fromByte base; null = unavailable. */
+    readTranscript(id: string, fromByte: number): Promise<{
+        text: string;
+        newSize: number;
+    } | null>;
+}
 export interface AgentHubDeps {
     /** Progress/status snapshot source (task lifecycle + progress channels). */
     observers: SessionObserverRegistry;
@@ -17,6 +28,8 @@ export interface AgentHubDeps {
     lifecycle?: AgentLifecycleManager;
     /** Injectable for tests; defaults to the process-global bus. */
     irc?: IrcBus;
+    /** Collab guest: route actions/transcripts to the host instead of local sessions. */
+    remote?: AgentHubRemote;
 }
 export declare class AgentHubOverlayComponent extends Container {
     #private;

package/dist/types/modes/components/collab-prompt-message.d.ts

@@ -0,0 +1,10 @@
+import { Container } from "@oh-my-pi/pi-tui";
+import type { CollabPromptDetails } from "../../collab/protocol";
+import type { CustomMessage } from "../../session/messages";
+/**
+ * Renders a collab guest prompt on every participant's transcript: a
+ * user-message-styled bubble prefixed with the author's name.
+ */
+export declare class CollabPromptMessageComponent extends Container {
+    constructor(message: CustomMessage<CollabPromptDetails>);
+}

package/dist/types/modes/components/hook-selector.d.ts

@@ -3,14 +3,12 @@
  * Displays a list of string options with keyboard navigation.
  */
 import { Container, type TUI } from "@oh-my-pi/pi-tui";
-import { type ThemeColor } from "../../modes/theme/theme";
-/** One segment of a {@link HookSelectorSlider} — a label, its accent color, and
- *  an optional detail line (e.g. the resolved model name) shown beneath the
- *  track while the segment is active. */
+/** One segment of a {@link HookSelectorSlider} — a label and an optional
+ *  detail line (e.g. the resolved model name) shown beneath the track while
+ *  the segment is active. Segment colors come from the track's theme palette,
+ *  assigned by position. */
 export interface HookSelectorSliderSegment {
     label: string;
-    /** Theme color for the segment label; defaults to `accent`. */
-    color?: ThemeColor;
     /** Secondary line rendered under the track when this segment is selected. */
     detail?: string;
 }

package/dist/types/modes/components/segment-track.d.ts

@@ -1,9 +1,9 @@
 /**
  * Shared renderer for a horizontal row of colored "segments" styled after the
- * status line: each segment shows in its own accent, the active one is filled
- * as a powerline chip (its accent as the background, a luminance-matched label,
- * flanked by triangle caps) and the rest are plain colored labels joined by a
- * thin separator.
+ * status line: each segment is colored by its track position from the theme's
+ * own palette, the active one is filled as a powerline chip (its color as the
+ * background, a luminance-matched label, flanked by triangle caps) and the
+ * rest are plain colored labels joined by a thin separator.
  *
  * Used by the plan-mode model-tier slider ({@link HookSelectorComponent}) and
  * the ctrl+p role-cycle status so both surfaces read identically.
@@ -11,9 +11,14 @@
 import { type ThemeColor } from "../theme/theme";
 export interface TrackSegment {
     label: string;
-    /** Theme color for the segment; defaults to `accent`. */
-    color?: ThemeColor;
 }
+/**
+ * Resolve up to `count` theme colors that render distinctly under the active
+ * theme, in candidate preference order. May return fewer than `count` when the
+ * theme has fewer distinct hues (e.g. monochrome themes) — callers wrap with
+ * modulo. Never returns an empty array: `accent` always resolves.
+ */
+export declare function resolveSegmentPalette(count: number): ThemeColor[];
 /**
  * Render `segments` as a colored chip track with `activeIndex` filled. Returns
  * a single line of styled text with no surrounding caption or arrows — callers

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

@@ -1,6 +1,6 @@
 import { type Component } from "@oh-my-pi/pi-tui";
 import type { AgentSession } from "../../../session/agent-session";
-import type { EffectiveStatusLineSettings, StatusLineSettings } from "./types";
+import type { CollabStatus, EffectiveStatusLineSettings, StatusLineSettings } from "./types";
 export declare class StatusLineComponent implements Component {
     #private;
     private readonly session;
@@ -9,6 +9,8 @@ export declare class StatusLineComponent implements Component {
     getEffectiveSettingsForTest(): EffectiveStatusLineSettings;
     setAutoCompactEnabled(enabled: boolean): void;
     setSubagentCount(count: number): void;
+    /** Active subagent count as currently displayed (collab state mirroring). */
+    get subagentCount(): number;
     setSessionStartTime(time: number): void;
     setPlanModeStatus(status: {
         enabled: boolean;
@@ -21,6 +23,7 @@ export declare class StatusLineComponent implements Component {
         enabled: boolean;
         paused: boolean;
     } | undefined): void;
+    setCollabStatus(status: CollabStatus | null): void;
     setHookStatus(key: string, text: string | undefined): void;
     watchBranch(onBranchChange: () => void): void;
     dispose(): void;

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

@@ -1,6 +1,14 @@
+import type { CollabSessionState } from "../../../collab/protocol";
 import type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle } from "../../../config/settings-schema";
 import type { AgentSession } from "../../../session/agent-session";
 export type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle };
+/** Collab session indicator + (guest-only) host-state override for segments. */
+export interface CollabStatus {
+    role: "host" | "guest";
+    participantCount: number;
+    /** Guest only: host footer snapshot that overrides locally computed values. */
+    stateOverride?: CollabSessionState | null;
+}
 export interface StatusLineSegmentOptions {
     model?: {
         showThinkingLevel?: boolean;
@@ -50,6 +58,7 @@ export interface SegmentContext {
         enabled: boolean;
         paused: boolean;
     } | null;
+    collab: CollabStatus | null;
     usageStats: {
         input: number;
         output: number;

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";
@@ -119,8 +122,12 @@ 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;
     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/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";
@@ -84,6 +88,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

@@ -385,6 +385,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 +446,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/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/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.11.7",
+	"version": "15.11.8",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -41,22 +41,24 @@
 		"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"
+		"generate-template": "bun scripts/generate-template.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.11.8",
+		"@oh-my-pi/omp-stats": "15.11.8",
+		"@oh-my-pi/pi-agent-core": "15.11.8",
+		"@oh-my-pi/pi-ai": "15.11.8",
+		"@oh-my-pi/pi-catalog": "15.11.8",
+		"@oh-my-pi/pi-mnemopi": "15.11.8",
+		"@oh-my-pi/pi-natives": "15.11.8",
+		"@oh-my-pi/pi-tui": "15.11.8",
+		"@oh-my-pi/pi-utils": "15.11.8",
+		"@oh-my-pi/pi-wire": "15.11.8",
+		"@oh-my-pi/snapcompact": "15.11.8",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",