@oh-my-pi/pi-coding-agent 16.2.2 → 16.2.3

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

@@ -109,11 +109,16 @@ export declare class InteractiveMode implements InteractiveModeContext {
     loopLimit: LoopLimitRuntime | undefined;
     todoPhases: TodoPhase[];
     hideThinkingBlock: boolean;
+    /** Whether the visible session has produced thinking content the user can reveal. */
+    get hasDisplayableThinkingContent(): boolean;
+    /** Record received reasoning content so Ctrl+T can reveal it even when model metadata says thinking is off. */
+    noteDisplayableThinkingContent(message: AgentMessage): boolean;
     /**
-     * Effective thinking-block visibility: hidden when the user's setting is on
-     * OR the session thinking level is "off". Some providers (MiniMax, GLM,
-     * DeepSeek) return thinking blocks even with reasoning disabled; this
-     * respects the user's intent when they set thinking to "off" (#626).
+     * Effective thinking-block visibility: hidden when the user's setting is on,
+     * or while thinking is "off" before the session has actually produced
+     * displayable thinking content. Some providers return thinking blocks without
+     * advertising reasoning support, so observed content unlocks the visibility
+     * toggle.
      */
     get effectiveHideThinkingBlock(): boolean;
     proseOnlyThinking: boolean;
@@ -319,6 +324,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     openInBrowser(urlOrPath: string): void;
     showSettingsSelector(): void;
+    showAdvisorConfigure(): void;
     showHistorySearch(): void;
     showExtensionsDashboard(): void;
     showAgentsDashboard(): void;

package/dist/types/modes/skill-command.d.ts

@@ -0,0 +1,32 @@
+import type { ImageContent, TextContent } from "@oh-my-pi/pi-ai";
+import { type CustomMessage, SKILL_PROMPT_MESSAGE_TYPE, type SkillPromptDetails } from "../session/messages";
+import type { InteractiveModeContext } from "./types";
+type SkillCommandHost = Pick<InteractiveModeContext, "skillCommands" | "session" | "showError">;
+type SkillPromptMessage = Pick<CustomMessage<SkillPromptDetails>, "customType" | "content" | "display" | "details" | "attribution"> & {
+    customType: typeof SKILL_PROMPT_MESSAGE_TYPE;
+    content: string | (TextContent | ImageContent)[];
+    display: true;
+    details: SkillPromptDetails;
+    attribution: "user";
+};
+type SkillPromptOptions = {
+    streamingBehavior: "steer" | "followUp";
+    queueChipText: string;
+};
+interface InvokeSkillCommandOptions {
+    propagateErrors?: boolean;
+    queueOnly?: boolean;
+    images?: ImageContent[];
+}
+/** Built custom-message payload and delivery options for a `/skill:` command. */
+export interface BuiltSkillCommandPrompt {
+    message: SkillPromptMessage;
+    options: SkillPromptOptions;
+}
+/** Return true when `text` names a registered `/skill:<name>` command. */
+export declare function isKnownSkillCommand(ctx: SkillCommandHost, text: string): boolean;
+/** Build the user-attributed custom message for a registered `/skill:<name>` command. */
+export declare function buildSkillCommandPrompt(ctx: SkillCommandHost, text: string, streamingBehavior: "steer" | "followUp", images?: ImageContent[]): Promise<BuiltSkillCommandPrompt | undefined>;
+/** Invoke a registered `/skill:<name>` command as a user-attributed custom message. */
+export declare function invokeSkillCommandFromText(ctx: SkillCommandHost, text: string, streamingBehavior: "steer" | "followUp", options?: InvokeSkillCommandOptions): Promise<boolean>;
+export {};

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

@@ -142,10 +142,14 @@ export interface InteractiveModeContext {
     hideThinkingBlock: boolean;
     /**
      * Effective thinking-block visibility: true when hidden by user setting OR
-     * thinking level is "off". Read this in render paths instead of
-     * {@link hideThinkingBlock} so blocks are auto-hidden when thinking is off.
+     * thinking level is "off" before the session has produced displayable
+     * thinking content.
      */
     readonly effectiveHideThinkingBlock: boolean;
+    /** Whether this visible session has produced thinking content the user can reveal. */
+    readonly hasDisplayableThinkingContent: boolean;
+    /** Record a message whose thinking content makes Ctrl+T meaningful even at thinking level "off"; returns true on first observation. */
+    noteDisplayableThinkingContent(message: AgentMessage): boolean;
     proseOnlyThinking: boolean;
     compactionQueuedMessages: CompactionQueuedMessage[];
     pendingTools: Map<string, ToolExecutionHandle>;
@@ -316,6 +320,7 @@ export interface InteractiveModeContext {
     refreshSlashCommandState(cwd?: string): Promise<void>;
     applyCwdChange(newCwd: string): Promise<void>;
     showSettingsSelector(): void;
+    showAdvisorConfigure(): void;
     showHistorySearch(): void;
     showExtensionsDashboard(): void;
     showAgentsDashboard(): void;

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

@@ -17,6 +17,7 @@ import { Agent, type AgentEvent, type AgentMessage, type AgentState, type AgentT
 import { type CompactionResult, type ShakeConfig } from "@oh-my-pi/pi-agent-core/compaction";
 import type { AssistantMessage, Context, ImageContent, Message, MessageAttribution, Model, ProviderSessionState, ResetCreditAccountStatus, ResetCreditRedeemOutcome, ResetCreditTarget, ServiceTier, SimpleStreamOptions, TextContent, ToolChoice, UsageReport } from "@oh-my-pi/pi-ai";
 import { Effort } from "@oh-my-pi/pi-ai";
+import { type AdvisorConfig } from "../advisor";
 import { type AsyncJob, type AsyncJobDeliveryState, AsyncJobManager } from "../async";
 import type { Rule } from "../capability/rule";
 import type { ModelRegistry } from "../config/model-registry";
@@ -247,20 +248,29 @@ export interface AgentSessionConfig {
      */
     providerSessionId?: string;
     /**
-     * Hard-isolated read-only tools (read/search/find) for the advisor agent,
-     * pre-built in `createAgentSession` against a distinct `ToolSession` so the
-     * advisor's reads never share the primary's snapshot/seen-lines/conflict
-     * caches. Undefined when the advisor is disabled.
+     * Full advisor toolset, pre-built in `createAgentSession` against a distinct,
+     * advisor-scoped `ToolSession` (its own `-advisor` session/agent id) so the
+     * advisor's tool state stays isolated from the primary. The advisor is a full
+     * agent; its config `tools` selects a subset (default read/grep/glob). Undefined
+     * when the advisor is disabled.
      */
-    advisorReadOnlyTools?: AgentTool[];
+    advisorTools?: AgentTool[];
     /** Preloaded watchdog prompt content for the advisor. */
     advisorWatchdogPrompt?: string;
+    /** Preloaded YAML top-level `instructions` shared baseline, kept separate from
+     *  `advisorWatchdogPrompt` so `/advisor configure` can swap it live. */
+    advisorSharedInstructions?: string;
     /**
      * Preloaded project context files (AGENTS.md, etc.) rendered as a system-prompt
      * block for the advisor — the same standing instructions the primary agent
      * receives, so the reviewer holds the agent to them.
      */
     advisorContextPrompt?: string;
+    /**
+     * Advisors discovered from `WATCHDOG.yml`. Empty/undefined runs a single
+     * legacy advisor on the `advisor` role (byte-for-byte the pre-config path).
+     */
+    advisorConfigs?: AdvisorConfig[];
     /**
      * Strip tool descriptions from provider-bound tool specs on side requests
      * (handoff). Must match the session-start value used to build the system
@@ -356,6 +366,7 @@ export interface SessionStats {
     tokens: {
         input: number;
         output: number;
+        reasoning: number;
         cacheRead: number;
         cacheWrite: number;
         total: number;
@@ -373,6 +384,7 @@ export interface AdvisorStats {
     tokens: {
         input: number;
         output: number;
+        reasoning: number;
         cacheRead: number;
         cacheWrite: number;
         total: number;
@@ -383,6 +395,18 @@ export interface AdvisorStats {
         assistant: number;
         total: number;
     };
+    /** Per-advisor breakdown; one entry per active advisor (single-advisor sessions have one). */
+    advisors: PerAdvisorStat[];
+}
+/** One advisor's slice of {@link AdvisorStats}, surfaced for the multi-advisor status panel. */
+export interface PerAdvisorStat {
+    name: string;
+    model: Model;
+    contextWindow: number;
+    contextTokens: number;
+    tokens: AdvisorStats["tokens"];
+    cost: number;
+    messages: AdvisorStats["messages"];
 }
 export interface FreshSessionResult {
     previousSessionId: string;
@@ -394,6 +418,7 @@ export type RestoredQueuedMessage = {
     text: string;
     images?: ImageContent[];
 };
+type SessionNameTrigger = "replan";
 export declare class AgentSession {
     #private;
     readonly agent: Agent;
@@ -698,6 +723,7 @@ export declare class AgentSession {
     prompt(text: string, options?: PromptOptions): Promise<boolean>;
     promptCustomMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details" | "attribution">, options?: Pick<PromptOptions, "streamingBehavior" | "toolChoice"> & {
         queueChipText?: string;
+        queueOnly?: boolean;
     }): Promise<void>;
     /**
      * Queue a steering message to interrupt the agent mid-run.
@@ -797,7 +823,7 @@ export declare class AgentSession {
     /**
      * Set a display name for the current session.
      */
-    setSessionName(name: string, source?: "auto" | "user"): Promise<boolean>;
+    setSessionName(name: string, source?: "auto" | "user", trigger?: SessionNameTrigger): Promise<boolean>;
     /**
      * Fork the current session, creating a new session file with the exact same state.
      * Copies all entries and artifacts to the new session.
@@ -808,16 +834,22 @@ export declare class AgentSession {
     /**
      * Set model directly.
      * Validates that a credential source is configured (synchronously, without
-     * refreshing OAuth or running command-backed key programs) and saves to the
-     * active session. Persists settings only when requested. The concrete key is
-     * resolved lazily per request, so switching never blocks the event loop.
+     * refreshing OAuth or running command-backed key programs). The active
+     * session switches by default; when `currentContextTokens` is provided and
+     * exceeds the refreshed candidate's context window, the live switch is
+     * skipped while role persistence still runs. Returns whether the active
+     * model actually switched, computed against the refreshed metadata so
+     * dynamic providers (e.g. llama.cpp) honor their post-load contextWindow.
      * @throws Error if no API key available for the model
      */
     setModel(model: Model, role?: string, options?: {
         selector?: string;
         thinkingLevel?: ThinkingLevel;
         persist?: boolean;
-    }): Promise<void>;
+        currentContextTokens?: number;
+    }): Promise<{
+        switched: boolean;
+    }>;
     /**
      * Set model temporarily (for this session only).
      * Validates that a credential source is configured (synchronously, without
@@ -1258,6 +1290,15 @@ export declare class AgentSession {
      * @returns true when the advisor is actively running after the call.
      */
     toggleAdvisorEnabled(): boolean;
+    /**
+     * Replace the live advisor roster from an edited `WATCHDOG.yml` (the `/advisor
+     * configure` save path). Swaps the configs + shared baseline, then rebuilds the
+     * runtimes in place so the change applies without a restart. When the advisor is
+     * disabled the new configs are simply stored for the next enable.
+     *
+     * @returns the number of advisors active after the rebuild.
+     */
+    applyAdvisorConfigs(advisors: AdvisorConfig[], sharedInstructions: string | undefined): number;
     /**
      * Whether the advisor setting is enabled for this session.
      */
@@ -1269,6 +1310,13 @@ export declare class AgentSession {
      * not merely the setting. Drives the status-line badge and `/dump advisor`.
      */
     isAdvisorActive(): boolean;
+    /**
+     * The names of the tools available to advisors this session (the pool a
+     * `/advisor configure` editor lists). The advisor is a full agent, so this is the
+     * full built tool set; a tool whose optional factory returns null (e.g. lsp with
+     * no servers) is absent.
+     */
+    getAdvisorAvailableToolNames(): string[];
     /**
      * The live advisor `Agent`, or `undefined` when no advisor runtime is
      * attached. Surfaced for diagnostics (`/dump advisor` already serializes

package/dist/types/session/indexed-session-storage.d.ts

@@ -1,16 +1,21 @@
 import type { SessionStorage, SessionStorageStat, SessionStorageWriter } from "./session-storage";
+import { type SessionTitleUpdate } from "./session-title-slot";
 export interface SessionStorageIndexEntry {
     path: string;
     size: number;
     mtimeMs: number;
+    title?: string;
+    titleSource?: SessionTitleUpdate["source"];
+    titleUpdatedAt?: string;
 }
 export interface SessionStorageBackend {
     init(): Promise<void>;
     loadIndex(): Promise<Iterable<SessionStorageIndexEntry>>;
     readFull(path: string): Promise<string | null>;
     readSlices(path: string, prefixBytes: number, suffixBytes: number): Promise<[string, string]>;
-    writeFull(path: string, content: string, mtimeMs: number): Promise<void>;
+    writeFull(path: string, content: string, mtimeMs: number, title?: SessionTitleUpdate): Promise<void>;
     append(path: string, line: string, mtimeMs: number): Promise<void>;
+    updateSessionTitle(path: string, title: SessionTitleUpdate, mtimeMs: number): Promise<void>;
     truncate(path: string, mtimeMs: number): Promise<void>;
     remove(paths: string[]): Promise<void>;
     move(src: string, dst: string, mtimeMs: number): Promise<void>;
@@ -24,6 +29,7 @@ export declare class IndexedSessionStorage implements SessionStorage {
     ensureDirSync(_dir: string): void;
     existsSync(path: string): boolean;
     writeTextSync(path: string, content: string): void;
+    updateSessionTitle(path: string, title: SessionTitleUpdate): Promise<void>;
     statSync(path: string): SessionStorageStat;
     listFilesSync(dir: string, pattern: string): string[];
     exists(path: string): Promise<boolean>;

package/dist/types/session/messages.d.ts

@@ -12,6 +12,32 @@ import type { OutputMeta } from "../tools/output-meta";
 export declare const SKILL_PROMPT_MESSAGE_TYPE = "skill-prompt";
 export declare const LSP_LATE_DIAGNOSTIC_MESSAGE_TYPE = "lsp-late-diagnostic";
 export declare const BACKGROUND_TAN_DISPATCH_MESSAGE_TYPE = "background-tan-dispatch";
+/** Custom message type for hidden interrupted-thinking continuity context. */
+export declare const INTERRUPTED_THINKING_MESSAGE_TYPE = "interrupted-thinking";
+/** Metadata persisted with a hidden interrupted-thinking continuity message. */
+export interface InterruptedThinkingDetails {
+    interruptedAt: number;
+    provider: AssistantMessage["provider"];
+    model: string;
+    blockCount: number;
+}
+/** Pure helper result for persisting interrupted thinking outside the assistant turn. */
+export interface DemotedInterruptedThinking {
+    reasoning: string;
+    strippedContent: AssistantMessage["content"];
+    blockCount: number;
+}
+/**
+ * Demote a trailing run of *incomplete* interrupted-thinking from an assistant
+ * message — reasoning that was still streaming when the user aborted.
+ *
+ * A block joins the run only when it is a non-empty `thinking` block with no
+ * `thinkingSignature`. A signed/complete thinking block (Anthropic signature,
+ * OpenAI reasoning item id) is safely replayable, so it ends the run and stays
+ * in place — as do `redactedThinking` encrypted blobs, text, tool calls,
+ * empty-thinking blocks, and trailing empty text placeholders.
+ */
+export declare function demoteInterruptedThinking(message: Pick<AssistantMessage, "content">): DemotedInterruptedThinking | undefined;
 /** Details persisted on a `/tan` background-dispatch breadcrumb. */
 export interface BackgroundTanDispatchDetails {
     jobId: string;

package/dist/types/session/messages.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -1,13 +1,26 @@
 import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import type { ImageContent, MessageAttribution, ServiceTier, TextContent } from "@oh-my-pi/pi-ai";
 export declare const CURRENT_SESSION_VERSION = 3;
+export declare const SESSION_TITLE_SLOT_BYTES = 256;
+export declare const SESSION_TITLE_SLOT_ENTRY_TYPE = "title";
+export declare const TITLE_CHANGE_ENTRY_TYPE = "title_change";
+export type SessionTitleSource = "auto" | "user";
+/** Fixed-width first-line slot carrying the mutable current session title. */
+export interface SessionTitleSlotEntry {
+    type: typeof SESSION_TITLE_SLOT_ENTRY_TYPE;
+    v: 1;
+    title: string;
+    source?: SessionTitleSource;
+    updatedAt: string;
+    pad: string;
+}
 export declare const EPHEMERAL_MODEL_CHANGE_ROLE = "fallback";
 export interface SessionHeader {
     type: "session";
     version?: number;
     id: string;
     title?: string;
-    titleSource?: "auto" | "user";
+    titleSource?: SessionTitleSource;
     timestamp: string;
     cwd: string;
     parentSession?: string;
@@ -91,6 +104,19 @@ export interface LabelEntry extends SessionEntryBase {
     targetId: string;
     label: string | undefined;
 }
+/** Append-only audit entry recording a session title change. */
+export interface TitleChangeEntry extends SessionEntryBase {
+    type: typeof TITLE_CHANGE_ENTRY_TYPE;
+    title: string;
+    previousTitle?: string;
+    source: SessionTitleSource;
+    trigger?: string;
+}
+declare module "@oh-my-pi/pi-agent-core/compaction/entries" {
+    interface CustomCompactionSessionEntries {
+        titleChange: TitleChangeEntry;
+    }
+}
 /** TTSR injection entry - tracks which time-traveling rules have been injected this session. */
 export interface TtsrInjectionEntry extends SessionEntryBase {
     type: "ttsr_injection";
@@ -149,9 +175,11 @@ export interface CustomMessageEntry<T = unknown> extends SessionEntryBase {
     attribution?: MessageAttribution;
 }
 /** Session entry - has id/parentId for tree structure (returned by "read" methods in SessionManager) */
-export type SessionEntry = SessionMessageEntry | ThinkingLevelChangeEntry | ModelChangeEntry | ServiceTierChangeEntry | CompactionEntry | BranchSummaryEntry | CustomEntry | CustomMessageEntry | LabelEntry | TtsrInjectionEntry | MCPToolSelectionEntry | SessionInitEntry | ModeChangeEntry;
-/** Raw file entry (includes header) */
+export type SessionEntry = SessionMessageEntry | ThinkingLevelChangeEntry | ModelChangeEntry | ServiceTierChangeEntry | CompactionEntry | BranchSummaryEntry | CustomEntry | CustomMessageEntry | LabelEntry | TitleChangeEntry | TtsrInjectionEntry | MCPToolSelectionEntry | SessionInitEntry | ModeChangeEntry;
+/** Raw logical file entry after loaders strip any fixed-width title slot. */
 export type FileEntry = SessionHeader | SessionEntry;
+/** Physical JSONL entry before slot-aware loaders fold the title slot. */
+export type RawFileEntry = SessionTitleSlotEntry | FileEntry;
 /** Tree node for getTree() - defensive copy of session structure */
 export interface SessionTreeNode {
     entry: SessionEntry;

package/dist/types/session/session-history-format.d.ts

@@ -18,6 +18,12 @@ export interface HistoryFormatOptions {
      * still collapse to a one-liner.
      */
     expandPrimaryContext?: boolean;
+    /**
+     * Append the full unified diff (from a tool result's `details.diff`) below
+     * edit/apply_patch tool lines, instead of just the path. The advisor sets
+     * this so it sees what changed without re-reading the file.
+     */
+    expandEditDiffs?: boolean;
 }
 /**
  * Hidden custom messages that inject the primary agent's operative *constraints*

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

@@ -1,7 +1,15 @@
 import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import { BlobStore } from "./blob-store";
-import type { FileEntry } from "./session-entries";
+import { type FileEntry, type SessionTitleSlotEntry } from "./session-entries";
 import { type SessionStorage } from "./session-storage";
+import { type SessionTitleUpdate } from "./session-title-slot";
+/** Parse session JSONL while stripping and folding the optional fixed title slot. */
+export declare function parseSessionContent(content: string): {
+    entries: FileEntry[];
+    titleSlot: SessionTitleUpdate | undefined;
+};
+/** Read only the fixed-size head window to detect a physical title slot. */
+export declare function readTitleSlotFromFile(filePath: string, storage?: SessionStorage): Promise<SessionTitleSlotEntry | undefined>;
 /** Exported for compaction.test.ts */
 export declare function parseSessionEntries(content: string): FileEntry[];
 /** Exported for testing */

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

@@ -3,7 +3,7 @@ import { ArtifactManager } from "./artifacts";
 import { type BlobPutOptions, type BlobPutResult } from "./blob-store";
 import { type BashExecutionMessage, type CustomMessage, type FileMentionMessage, type HookMessage, type PythonExecutionMessage } from "./messages";
 import { type BuildSessionContextOptions, type SessionContext } from "./session-context";
-import { type NewSessionOptions, type SessionEntry, type SessionHeader, type SessionTreeNode, type UsageStatistics } from "./session-entries";
+import { type NewSessionOptions, type SessionEntry, type SessionHeader, type SessionTitleSource, type SessionTreeNode, type UsageStatistics } from "./session-entries";
 import { type SessionInfo } from "./session-listing";
 import { type SessionStorage } from "./session-storage";
 export type ReadonlySessionManager = Pick<SessionManager, "getCwd" | "getSessionDir" | "getSessionId" | "getSessionFile" | "getSessionName" | "getArtifactsDir" | "getArtifactManager" | "allocateArtifactPath" | "saveArtifact" | "getArtifactPath" | "getLeafId" | "getLeafEntry" | "getEntry" | "getLabel" | "getBranch" | "getHeader" | "getEntries" | "getTree" | "getUsageStatistics" | "putBlob" | "putBlobSync">;
@@ -12,8 +12,10 @@ interface SessionManagerStateSnapshot {
     sessionDir: string;
     sessionId: string;
     sessionName: string | undefined;
-    titleSource: "auto" | "user" | undefined;
+    titleSource: SessionTitleSource | undefined;
     sessionFile: string | undefined;
+    titleUpdatedAt: string;
+    hasTitleSlot: boolean;
     onDisk: boolean;
     needsRewrite: boolean;
     header: SessionHeader;
@@ -109,7 +111,7 @@ export declare class SessionManager {
     saveDraft(text: string): Promise<void>;
     consumeDraft(): Promise<string | null>;
     /** The source that set the session name: "user" (manual/RPC) or "auto" (generated title). */
-    get titleSource(): "auto" | "user" | undefined;
+    get titleSource(): SessionTitleSource | undefined;
     getSessionName(): string | undefined;
     onSessionNameChanged(cb: () => void): () => void;
     /**
@@ -117,7 +119,7 @@ export declare class SessionManager {
      * @param source "user" for explicit renames; "auto" for generated titles.
      *   Auto titles are ignored once the user has set a name.
      */
-    setSessionName(name: string, source?: "auto" | "user"): Promise<boolean>;
+    setSessionName(name: string, source?: SessionTitleSource, trigger?: string): Promise<boolean>;
     /**
      * Append a foreign (host-authored) entry verbatim, preserving its
      * `id`/`parentId`. Used by collab guests to mirror the host session.

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

@@ -1,3 +1,4 @@
+import { type SessionTitleUpdate } from "./session-title-slot";
 export interface SessionStorageStat {
     size: number;
     mtimeMs: number;
@@ -22,6 +23,14 @@ export interface SessionStorage {
     ensureDirSync(dir: string): void;
     existsSync(path: string): boolean;
     writeTextSync(path: string, content: string): void;
+    /**
+     * Update the current session title through the storage backend.
+     *
+     * File-like backends rewrite the fixed-width JSONL title slot; indexed
+     * backends can store the semantic title fields and synthesize the slot when
+     * reading.
+     */
+    updateSessionTitle(path: string, update: SessionTitleUpdate): Promise<void>;
     statSync(path: string): SessionStorageStat;
     listFilesSync(dir: string, pattern: string): string[];
     exists(path: string): Promise<boolean>;
@@ -43,6 +52,7 @@ export declare class FileSessionStorage implements SessionStorage {
     ensureDirSync(dir: string): void;
     existsSync(path: string): boolean;
     writeTextSync(fpath: string, content: string): void;
+    updateSessionTitle(fpath: string, update: SessionTitleUpdate): Promise<void>;
     statSync(path: string): SessionStorageStat;
     listFilesSync(dir: string, pattern: string): string[];
     exists(path: string): Promise<boolean>;
@@ -67,6 +77,7 @@ export declare class MemorySessionStorage implements SessionStorage {
     ensureDirSync(_dir: string): void;
     existsSync(path: string): boolean;
     writeTextSync(path: string, content: string): void;
+    updateSessionTitle(path: string, update: SessionTitleUpdate): Promise<void>;
     /**
      * Internal O(1) append used by {@link MemorySessionStorageWriter}. Lazily
      * creates the entry. External callers should go through `openWriter()`

package/dist/types/session/session-title-slot.d.ts

@@ -0,0 +1,19 @@
+import { type SessionTitleSlotEntry, type SessionTitleSource } from "./session-entries";
+/** Semantic title update persisted by session storage backends. */
+export interface SessionTitleUpdate {
+    title?: string;
+    source?: SessionTitleSource;
+    updatedAt: string;
+}
+/** Parse a physical title slot JSONL line. Returns undefined for legacy headers. */
+export declare function parseTitleSlotLine(line: string): SessionTitleSlotEntry | undefined;
+/** Parse the fixed-width title slot from a physical session body. */
+export declare function parseTitleSlotFromContent(content: string): SessionTitleSlotEntry | undefined;
+/** Convert a parsed title slot to the semantic storage update shape. */
+export declare function titleUpdateFromSlot(slot: SessionTitleSlotEntry | undefined): SessionTitleUpdate | undefined;
+/** Serialize the fixed-width first-line title slot, exactly 256 UTF-8 bytes including newline. */
+export declare function serializeTitleSlot(options: SessionTitleUpdate): string;
+/** Replace the physical fixed-width title slot in a full session body. */
+export declare function overlayTitleSlotContent(content: string, update: SessionTitleUpdate): string;
+/** Replace the physical fixed-width title slot in a prefix byte window. */
+export declare function overlayTitleSlotPrefix(prefix: string, prefixBytes: number, update: SessionTitleUpdate): string;

package/dist/types/ssh/connection-manager.d.ts

@@ -14,6 +14,15 @@ export interface SSHHostInfo {
     version: number;
     os: SSHHostOs;
     shell: SSHHostShell;
+    /**
+     * Shell name OMP verified can execute the POSIX transfer snippets
+     * (`head`/`cat`/`mv`/`test`/`ls`) `ssh://` uses. Probed by running
+     * `sh -lc` / `bash -lc` / `zsh -lc` against the remote and keeping the
+     * first one that round-trips a known marker. Independent of `shell`
+     * (the self-reported login shell), which may be noisy, exotic, or simply
+     * mis-classified — only `transferShell` gates ssh:// transfers.
+     */
+    transferShell?: "sh" | "bash" | "zsh";
     compatShell?: "bash" | "sh";
     compatEnabled: boolean;
 }
@@ -22,6 +31,44 @@ interface SSHArgsOptions {
     /** When true, omit `-n` so the remote command can read from our piped stdin. */
     allowStdin?: boolean;
 }
+/**
+ * Parse a raw cache-file value (or any unknown) into a normalized
+ * {@link SSHHostInfo}, dropping fields that don't pass the per-field guards.
+ * Exported so cache-layer round-tripping (incl. the new `transferShell`
+ * field, #3719) is testable without touching disk.
+ */
+export declare function parseHostInfo(value: unknown): SSHHostInfo | null;
+/**
+ * Frame marker emitted by the remote OS/shell probe. The probe wraps its
+ * payload in this prefix so the parser can ignore startup-file noise (banners,
+ * `motd`, login messages, `Last login: …`) instead of trusting only the first
+ * line of stdout. See #3719.
+ */
+export declare const HOST_PROBE_MARKER = "PI_HOST_PROBE=";
+/** Marker for the transfer-shell capability probe. */
+export declare const TRANSFER_PROBE_MARKER = "PI_TRANSFER_OK|";
+/**
+ * Find the first line of `stdout`/`stderr` that begins with `marker` and
+ * return everything after it. Used by the SSH host probe so noisy login
+ * dotfiles can't corrupt OS/shell classification by emitting text on the
+ * first line of `ssh` output.
+ *
+ * Returns `null` when no marker line is found in either stream.
+ */
+export declare function extractProbePayload(stdout: string, stderr: string, marker?: string): string | null;
+/**
+ * Find `marker` anywhere in `stdout` or `stderr` and return everything that
+ * follows it, scanning stdout first. Returns `null` when the marker is in
+ * neither stream.
+ *
+ * Used by the transfer-shell capability probe. Some remotes have broken
+ * login dotfiles that swap fd 1/2, so the marker can land on stderr even
+ * though the probe ran the printf successfully (matches the host-info
+ * probe's stderr fallback). See #3719.
+ */
+export declare function findProbeMarker(stdout: string, stderr: string, marker: string): string | null;
+/** Classify a POSIX-ish `uname -s` payload from the transfer-shell probe. */
+export declare function osFromUname(value: string): SSHHostOs | undefined;
 export declare function getHostInfo(hostName: string): Promise<SSHHostInfo | undefined>;
 export declare function getHostInfoForHost(host: SSHConnectionTarget): Promise<SSHHostInfo | undefined>;
 /**

package/dist/types/ssh/utils.d.ts

@@ -6,3 +6,19 @@ export declare function buildSshTarget(username: string | undefined, host: strin
  * `ssh://` file-transfer helpers.
  */
 export declare function quotePosixPath(value: string): string;
+/**
+ * Wrap a POSIX command in `<shell> -c '<command>'` so it runs under the
+ * named shell rather than whatever `$SHELL` happens to be on the remote.
+ *
+ * Used by the `ssh://` transfer helpers and the Windows compat dispatch:
+ * OpenSSH passes our snippets to `<login-shell> -c`, so a remote whose
+ * login shell is fish/csh/tcsh (or cmd/powershell on Windows compat)
+ * can't parse `if [ … ]; then …`. Wrapping forces parsing under the
+ * shell OMP actually verified can run the snippet.
+ *
+ * `-c` (not `-lc`): the transfer snippets only call absolute POSIX
+ * builtins (`head`/`cat`/`mv`/`test`/`ls`/`mkdir`/`rm`/`dirname`) and
+ * don't need login-profile setup. Capability *probing* still uses
+ * `-lc` to mirror the user's real environment.
+ */
+export declare function wrapInPosixShell(shell: "sh" | "bash" | "zsh", command: string): string;

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

@@ -23,7 +23,8 @@ import type { AuthStorage } from "../session/auth-storage";
 import type { ContextFileEntry } from "../tools";
 import type { EventBus } from "../utils/event-bus";
 import type { WorkspaceTree } from "../workspace-tree";
-import { type AgentDefinition, type AgentProgress, type ReviewFinding, type SingleResult } from "./types";
+import { type AgentDefinition, type AgentProgress, type ReviewFinding, type SingleResult, type YieldItem } from "./types";
+export type { YieldItem } from "./types";
 /**
  * Soft per-agent request budgets (assistant requests per run). When a subagent
  * crosses its budget it receives ONE steering notice asking it to wrap up; at
@@ -164,20 +165,6 @@ export interface ExecutorOptions {
      */
     keepAlive?: boolean;
 }
-export interface YieldItem {
-    data?: unknown;
-    status?: "success" | "aborted";
-    error?: string;
-    /**
-     * Set by the in-tool yield validator when it exhausted its retry budget
-     * (MAX_SCHEMA_RETRIES) and accepted a schema-invalid payload anyway.
-     * `finalizeSubprocessOutput` honors this by serializing the payload and
-     * surfacing a stderr warning, instead of re-emitting `schema_violation`
-     * — which would silently swap the subagent's "accepted" view for a
-     * different, opaque error blob in the parent's view of the result.
-     */
-    schemaOverridden?: boolean;
-}
 interface FinalizeSubprocessOutputArgs {
     rawOutput: string;
     exitCode: number;
@@ -187,6 +174,7 @@ interface FinalizeSubprocessOutputArgs {
     yieldItems?: YieldItem[];
     reportFindings?: ReviewFinding[];
     outputSchema: unknown;
+    lastAssistantText?: string;
 }
 interface FinalizeSubprocessOutputResult {
     rawOutput: string;
@@ -217,4 +205,3 @@ export declare function finalizeSubagentLifecycle(args: {
  * Run a single agent in-process.
  */
 export declare function runSubprocess(options: ExecutorOptions): Promise<SingleResult>;
-export {};

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

@@ -31,9 +31,4 @@ export declare function renderResult(result: {
     details?: TaskToolDetails;
     isError?: boolean;
 }, options: TaskRenderOptions, theme: Theme, args?: TaskParams): Component;
-export declare const taskToolRenderer: {
-    renderCall: typeof renderCall;
-    renderResult: typeof renderResult;
-    mergeCallAndResult: boolean;
-};
 export {};