@oh-my-pi/pi-coding-agent 15.11.0 → 15.11.2

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

@@ -5,7 +5,10 @@
  * Unlike markdown commands which expand to prompts, custom commands can execute
  * arbitrary logic with full access to the hook context.
  */
+import type * as Zod from "zod/v4";
 import type { ExecOptions, ExecResult, HookCommandContext } from "../../extensibility/hooks/types";
+import type * as PiCodingAgent from "../../index";
+import type * as TypeBox from "../typebox";
 export type { ExecOptions, ExecResult, HookCommandContext };
 /**
  * API passed to custom command factory.
@@ -17,11 +20,11 @@ export interface CustomCommandAPI {
     /** Execute a shell command */
     exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
     /** Injected zod-backed typebox shim (legacy/compat). */
-    typebox: typeof import("../typebox");
+    typebox: typeof TypeBox;
     /** Injected zod module for Zod-authored custom commands. */
-    zod: typeof import("zod/v4");
+    zod: typeof Zod;
     /** Injected pi-coding-agent exports */
-    pi: typeof import("../..");
+    pi: typeof PiCodingAgent;
 }
 /**
  * Custom command definition.

package/dist/types/extensibility/custom-tools/loader.d.ts

@@ -1,5 +1,6 @@
 import type { AgentToolResult } from "@oh-my-pi/pi-agent-core";
 import type { HookUIContext } from "../../extensibility/hooks/types";
+import * as PiCodingAgent from "../../index";
 import type { LoadedCustomTool, ToolLoadError } from "./types";
 /** Tool path with optional source metadata, suitable for forwarding from a
  * parent session to a subagent so the subagent can re-bind tools to its own
@@ -23,7 +24,7 @@ export declare class CustomToolLoader {
     #private;
     tools: LoadedCustomTool[];
     errors: ToolLoadError[];
-    constructor(pi: typeof import("@oh-my-pi/pi-coding-agent"), cwd: string, builtInToolNames: string[], pushPendingAction?: (action: {
+    constructor(pi: typeof PiCodingAgent, cwd: string, builtInToolNames: string[], pushPendingAction?: (action: {
         label: string;
         sourceToolName: string;
         apply(reason: string): Promise<AgentToolResult<unknown>>;

package/dist/types/extensibility/custom-tools/types.d.ts

@@ -8,14 +8,18 @@ import type { AgentToolResult, AgentToolUpdateCallback, ToolApproval, ToolApprov
 import type { CompactionResult } from "@oh-my-pi/pi-agent-core/compaction";
 import type { FetchImpl, Model, Static, TSchema } from "@oh-my-pi/pi-ai";
 import type { Component } from "@oh-my-pi/pi-tui";
+import type { logger as PiLogger } from "@oh-my-pi/pi-utils";
+import type * as Zod from "zod/v4";
 import type { Rule } from "../../capability/rule";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { Settings } from "../../config/settings";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
 import type { HookUIContext } from "../../extensibility/hooks/types";
+import type * as PiCodingAgent from "../../index";
 import type { Theme } from "../../modes/theme/theme";
 import type { ReadonlySessionManager } from "../../session/session-manager";
 import type { TodoItem } from "../../tools/todo";
+import type * as TypeBox from "../typebox";
 /** Alias for clarity */
 export type CustomToolUIContext = HookUIContext;
 export type { ExecOptions, ExecResult } from "../../exec/exec";
@@ -45,13 +49,13 @@ export interface CustomToolAPI {
     /** Whether UI is available (false in print/RPC mode) */
     hasUI: boolean;
     /** File logger for error/warning/debug messages */
-    logger: typeof import("@oh-my-pi/pi-utils").logger;
+    logger: typeof PiLogger;
     /** Injected zod-backed typebox shim (legacy/compat — Zod-authored tools are preferred). */
-    typebox: typeof import("../typebox");
+    typebox: typeof TypeBox;
     /** Injected zod module for Zod-authored custom tools. */
-    zod: typeof import("zod/v4");
+    zod: typeof Zod;
     /** Injected pi-coding-agent exports */
-    pi: typeof import("../..");
+    pi: typeof PiCodingAgent;
     /** Push a preview action that can later be resolved with the hidden resolve tool */
     pushPendingAction(action: CustomToolPendingAction): void;
 }

package/dist/types/extensibility/extensions/types.d.ts

@@ -11,7 +11,6 @@ import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLe
 import type { CompactionResult } from "@oh-my-pi/pi-agent-core/compaction";
 import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context, ImageContent, Model, ModelSpec, ProviderResponseMetadata, SimpleStreamOptions, Static, TextContent, TSchema } from "@oh-my-pi/pi-ai";
 import type { OAuthCredentials, OAuthLoginCallbacks } from "@oh-my-pi/pi-ai/oauth/types";
-import type * as piCodingAgent from "@oh-my-pi/pi-coding-agent";
 import type { AutocompleteItem, Component, EditorTheme, KeyId, TUI } from "@oh-my-pi/pi-tui";
 import type { logger as PiLogger } from "@oh-my-pi/pi-utils";
 import type * as Zod from "zod/v4";
@@ -21,6 +20,7 @@ import type { EditToolDetails } from "../../edit";
 import type { PythonResult } from "../../eval/py/executor";
 import type { BashResult } from "../../exec/bash-executor";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
+import type * as PiCodingAgent from "../../index";
 import type { MemoryRuntimeContext } from "../../memory-backend";
 import type { CustomEditor } from "../../modes/components/custom-editor";
 import type { Theme } from "../../modes/theme/theme";
@@ -560,7 +560,7 @@ export interface ExtensionAPI {
     /** Injected zod module for Zod-authored extension tools (canonical going forward). */
     zod: typeof Zod;
     /** Injected pi-coding-agent exports for accessing SDK utilities */
-    pi: typeof piCodingAgent;
+    pi: typeof PiCodingAgent;
     on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
     on(event: "session_start", handler: ExtensionHandler<SessionStartEvent>): void;
     on(event: "session_before_switch", handler: ExtensionHandler<SessionBeforeSwitchEvent, SessionBeforeSwitchResult>): void;

package/dist/types/extensibility/hooks/types.d.ts

@@ -1,13 +1,17 @@
 import type { ImageContent, Message, Model, TextContent } from "@oh-my-pi/pi-ai";
 import type { Component, TUI } from "@oh-my-pi/pi-tui";
+import type { logger as PiLogger } from "@oh-my-pi/pi-utils";
+import type * as Zod from "zod/v4";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { EditToolDetails } from "../../edit";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
+import type * as PiCodingAgent from "../../index";
 import type { Theme } from "../../modes/theme/theme";
 import type { HookMessage } from "../../session/messages";
 import type { ReadonlySessionManager, SessionManager } from "../../session/session-manager";
 import type { BashToolDetails, FindToolDetails, ReadToolDetails, SearchToolDetails } from "../../tools";
 import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
+import type * as TypeBox from "../typebox";
 export type { ExecOptions, ExecResult } from "../../exec/exec";
 /**
  * UI context for hooks to request interactive UI from the harness.
@@ -412,13 +416,13 @@ export interface HookAPI {
      */
     exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
     /** File logger for error/warning/debug messages */
-    logger: typeof import("@oh-my-pi/pi-utils").logger;
+    logger: typeof PiLogger;
     /** Injected zod-backed typebox shim (legacy/compat — prefer `zod`). */
-    typebox: typeof import("../typebox");
+    typebox: typeof TypeBox;
     /** Injected zod module for Zod-authored hooks. */
-    zod: typeof import("zod/v4");
+    zod: typeof Zod;
     /** Injected pi-coding-agent exports */
-    pi: typeof import("../..");
+    pi: typeof PiCodingAgent;
 }
 /**
  * Hook factory function type.

package/dist/types/irc/bus.d.ts

@@ -7,7 +7,11 @@
  * AgentLifecycleManager, idle agents are woken with a real turn, and busy
  * agents receive the message as a non-interrupting aside at the next step
  * boundary (see AgentSession.deliverIrcMessage). Replies are real turns by
- * the recipient, observed via `wait`.
+ * the recipient, observed via `wait` — with one exception: when the sender
+ * awaits a reply and the recipient is mid-turn with async execution
+ * disabled, the recipient session generates an ephemeral side-channel
+ * auto-reply (it may be blocked in a synchronous task spawn whose batch
+ * includes the sender, so a real turn could never happen in time).
  */
 import { AgentLifecycleManager } from "../registry/agent-lifecycle";
 import { AgentRegistry } from "../registry/agent-registry";
@@ -44,8 +48,17 @@ export declare class IrcBus {
      * context, so buffering it too would double-deliver via a later
      * `wait`/`inbox` and inflate unread counts. Only a failed live hand-off
      * is buffered for the recipient to drain later.
+     *
+     * `opts.expectsReply` marks sends whose caller is blocked on an answer
+     * (`send await:true`). It is forwarded to the recipient session so a
+     * mid-turn recipient that cannot reach a step boundary (async execution
+     * disabled — e.g. blocked in a synchronous task spawn awaiting the
+     * sender's own batch) can generate an ephemeral side-channel auto-reply
+     * instead of stranding the sender until timeout.
      */
-    send(msg: Omit<IrcMessage, "id" | "ts">): Promise<IrcDeliveryReceipt>;
+    send(msg: Omit<IrcMessage, "id" | "ts">, opts?: {
+        expectsReply?: boolean;
+    }): Promise<IrcDeliveryReceipt>;
     /**
      * Block until a message for `agentId` (optionally from `filter.from`)
      * arrives; consume + return it. Null on timeout (`timeoutMs <= 0` waits

package/dist/types/mcp/oauth-discovery.d.ts

@@ -10,6 +10,7 @@ export interface OAuthEndpoints {
     tokenUrl: string;
     clientId?: string;
     scopes?: string;
+    resource?: string;
 }
 export interface AuthDetectionResult {
     requiresAuth: boolean;
@@ -41,4 +42,5 @@ export declare function analyzeAuthError(error: Error, serverUrl?: string): Auth
  */
 export declare function discoverOAuthEndpoints(serverUrl: string, authServerUrl?: string, resourceMetadataUrl?: string, opts?: {
     fetch?: FetchImpl;
+    protectedResource?: string;
 }): Promise<OAuthEndpoints | null>;

package/dist/types/mcp/oauth-flow.d.ts

@@ -24,6 +24,8 @@ export interface MCPOAuthConfig {
     callbackPort?: number;
     /** Custom callback path (default: /callback or redirectUri pathname) */
     callbackPath?: string;
+    /** MCP resource URI for RFC 8707 resource indicators */
+    resource?: string;
     /** Fetch implementation for token exchange and discovery requests. */
     fetch?: FetchImpl;
 }
@@ -49,6 +51,7 @@ export declare class MCPOAuthFlow extends OAuthCallbackFlow {
      * client id via config.
      */
     get registeredClientSecret(): string | undefined;
+    get resource(): string | undefined;
     generateAuthUrl(state: string, redirectUri: string): Promise<{
         url: string;
         instructions?: string;
@@ -59,6 +62,8 @@ export declare class MCPOAuthFlow extends OAuthCallbackFlow {
  * Refresh an MCP OAuth token using the standard refresh_token grant.
  * Returns updated credentials; preserves the old refresh token if the server doesn't rotate it.
  */
-export declare function refreshMCPOAuthToken(tokenUrl: string, refreshToken: string, clientId?: string, clientSecret?: string, opts?: {
+export declare function refreshMCPOAuthToken(tokenUrl: string, refreshToken: string, clientId?: string, clientSecret?: string, resourceOrOpts?: string | {
+    fetch?: FetchImpl;
+}, opts?: {
     fetch?: FetchImpl;
 }): Promise<OAuthCredentials>;

package/dist/types/mcp/transports/stdio.d.ts

@@ -8,6 +8,7 @@ import type { MCPRequestOptions, MCPStdioServerConfig, MCPTransport } from "../.
 /** Subprocess argv for launching an MCP stdio server. */
 export interface StdioSpawnCommand {
     cmd: string[];
+    windowsHide?: boolean;
 }
 /** Inputs used to resolve platform-specific stdio spawn behavior. */
 export interface ResolveStdioSpawnOptions {

package/dist/types/mcp/types.d.ts

@@ -40,6 +40,8 @@ export interface MCPAuthConfig {
     clientId?: string;
     /** Client secret — persisted for token refresh */
     clientSecret?: string;
+    /** MCP resource URI — persisted for OAuth resource indicators during refresh */
+    resource?: string;
 }
 /** Base server config with shared options */
 interface MCPServerConfigBase {

package/dist/types/modes/components/assistant-message.d.ts

@@ -19,6 +19,7 @@ export declare class AssistantMessageComponent extends Container {
      */
     setErrorPinned(pinned: boolean): void;
     isTranscriptBlockFinalized(): boolean;
+    getTranscriptBlockVersion(): number;
     markTranscriptBlockFinalized(): void;
     setToolResultImages(toolCallId: string, images: ImageContent[]): void;
     setUsageInfo(usage: Usage): void;

package/dist/types/modes/components/mcp-add-wizard.d.ts

@@ -16,10 +16,11 @@ export interface MCPAddWizardOAuthResult {
     credentialId: string;
     clientId?: string;
     clientSecret?: string;
+    resource?: string;
 }
 export declare class MCPAddWizard extends Container {
     #private;
-    constructor(onComplete: (name: string, config: MCPServerConfig, scope: Scope) => void, onCancel: () => void, onOAuth?: (authUrl: string, tokenUrl: string, clientId: string, clientSecret: string, scopes: string) => Promise<MCPAddWizardOAuthResult>, onTestConnection?: (config: MCPServerConfig) => Promise<void>, onRender?: () => void, initialName?: string);
+    constructor(onComplete: (name: string, config: MCPServerConfig, scope: Scope) => void, onCancel: () => void, onOAuth?: (authUrl: string, tokenUrl: string, clientId: string, clientSecret: string, scopes: string, resource?: string) => Promise<MCPAddWizardOAuthResult>, onTestConnection?: (config: MCPServerConfig) => Promise<void>, onRender?: () => void, initialName?: string);
     handleInput(keyData: string): void;
 }
 export {};

package/dist/types/modes/components/plan-review-overlay.d.ts

@@ -25,6 +25,8 @@ export interface PlanReviewOverlayCallbacks {
     onCancel: () => void;
     /** Invoked when the external-editor key is pressed (overlay stays open). */
     onExternalEditor?: () => void;
+    /** Invoked when the external-editor key edits the active annotation draft. */
+    onAnnotationExternalEditor?: (draft: string, commit: (text: string | null) => void) => void;
     /** Invoked with the new full plan text after an in-overlay delete/undo. */
     onPlanEdited?: (content: string) => void;
     /** Invoked with the Refine feedback markdown whenever annotations change. */

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

@@ -25,6 +25,7 @@ export interface StatusLinePreviewSettings {
     rightSegments?: StatusLineSegmentId[];
     separator?: StatusLineSeparatorStyle;
     sessionAccent?: boolean;
+    transparent?: boolean;
 }
 export interface SettingsCallbacks {
     /** Called when any setting value changes */

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

@@ -29,6 +29,9 @@ export interface StatusLineSettings {
     segmentOptions?: StatusLineSegmentOptions;
     showHookStatus?: boolean;
     sessionAccent?: boolean;
+    /** Drop the theme's `statusLineBg` fill and powerline caps so the bar
+     *  inherits the terminal's default background. */
+    transparent?: boolean;
 }
 export type EffectiveStatusLineSettings = Required<Pick<StatusLineSettings, "leftSegments" | "rightSegments" | "separator" | "segmentOptions">> & StatusLineSettings;
 export type RGB = readonly [number, number, number];

package/dist/types/modes/components/transcript-container.d.ts

@@ -1,4 +1,4 @@
-import { type Component, Container, type NativeScrollbackLiveRegion, type RenderStablePrefix } from "@oh-my-pi/pi-tui";
+import { type Component, Container, type NativeScrollbackCommittedRows, type NativeScrollbackLiveRegion, type RenderStablePrefix } from "@oh-my-pi/pi-tui";
 /**
  * Transcript container that renders every block's current content each frame
  * and reports the live-region seam (`NativeScrollbackLiveRegion`) that gates
@@ -22,10 +22,11 @@ import { type Component, Container, type NativeScrollbackLiveRegion, type Render
  * through {@link RenderStablePrefix} so the engine can skip marker scanning,
  * line preparation, and the committed-prefix audit for those rows.
  */
-export declare class TranscriptContainer extends Container implements NativeScrollbackLiveRegion, RenderStablePrefix {
+export declare class TranscriptContainer extends Container implements NativeScrollbackLiveRegion, NativeScrollbackCommittedRows, RenderStablePrefix {
     #private;
     invalidate(): void;
     clear(): void;
+    setNativeScrollbackCommittedRows(rows: number): void;
     getRenderStablePrefixRows(): number;
     getNativeScrollbackLiveRegionStart(): number | undefined;
     getNativeScrollbackCommitSafeEnd(): number | undefined;

package/dist/types/modes/controllers/tool-args-reveal.d.ts

@@ -0,0 +1,43 @@
+/** Minimal component surface the reveal pushes frames into. */
+type ToolArgsRevealComponent = {
+    updateArgs(args: unknown, toolCallId?: string): void;
+};
+type ToolArgsRevealControllerOptions = {
+    getSmoothStreaming(): boolean;
+    requestRender(): void;
+};
+/**
+ * Paces streamed tool-call arguments the same way StreamingRevealController
+ * paces assistant text: providers that deliver `partialJson` in large batches
+ * (or throttle their partial parses) would otherwise make write/edit/bash
+ * streaming previews jump in chunks. Each pending tool call reveals its raw
+ * argument stream at the shared 30fps cadence with the same adaptive
+ * catch-up step, re-parsing the revealed prefix per frame.
+ *
+ * Reveal units are UTF-16 code units of the raw stream, not graphemes —
+ * the prefix goes through a JSON parser rather than straight to the screen,
+ * so only surrogate-pair integrity matters (see {@link clampSliceEnd}).
+ */
+export declare class ToolArgsRevealController {
+    #private;
+    constructor(options: ToolArgsRevealControllerOptions);
+    /**
+     * Record the latest streamed argument text for a tool call and return the
+     * args to render right now. With smoothing disabled the full target passes
+     * through in the caller's legacy shape (`{ ...args, __partialJson }`).
+     */
+    setTarget(id: string, partialJson: string, rawInput: boolean, fullArgs: Record<string, unknown>): Record<string, unknown>;
+    /** Attach the component future ticks push frames into. */
+    bind(id: string, component: ToolArgsRevealComponent): void;
+    /** Final arguments arrived (the JSON closed): drop the reveal so the
+     *  caller's final-args render wins immediately, mirroring how assistant
+     *  text snaps to the full message at message_end. */
+    finish(id: string): void;
+    /** Snap every live entry to its full received stream and clear. Used at
+     *  message_end (abort/error mid-stream) so sealed components freeze showing
+     *  everything that arrived rather than a mid-reveal prefix. */
+    flushAll(): void;
+    /** Clear without pushing (teardown). */
+    stop(): void;
+}
+export {};

package/dist/types/modes/rpc/rpc-client.d.ts

@@ -8,7 +8,7 @@ import type { CompactionResult } from "@oh-my-pi/pi-agent-core/compaction";
 import type { ImageContent, Model } from "@oh-my-pi/pi-ai";
 import type { BashResult } from "../../exec/bash-executor";
 import type { AgentSessionEvent, SessionStats } from "../../session/agent-session";
-import type { RpcHandoffResult, RpcHostToolDefinition, RpcSessionState, RpcSubagentEventFrame, RpcSubagentLifecycleFrame, RpcSubagentMessagesResult, RpcSubagentProgressFrame, RpcSubagentSnapshot, RpcSubagentSubscriptionLevel } from "./rpc-types";
+import type { RpcAvailableSlashCommand, RpcHandoffResult, RpcHostToolDefinition, RpcSessionState, RpcSubagentEventFrame, RpcSubagentLifecycleFrame, RpcSubagentMessagesResult, RpcSubagentProgressFrame, RpcSubagentSnapshot, RpcSubagentSubscriptionLevel } from "./rpc-types";
 export interface RpcClientOptions {
     /** Path to the CLI entry point (default: searches for dist/cli.js) */
     cliPath?: string;
@@ -33,6 +33,7 @@ export type RpcSessionEventListener = (event: AgentSessionEvent) => void;
 export type RpcSubagentLifecycleListener = (payload: RpcSubagentLifecycleFrame["payload"]) => void;
 export type RpcSubagentProgressListener = (payload: RpcSubagentProgressFrame["payload"]) => void;
 export type RpcSubagentEventListener = (payload: RpcSubagentEventFrame["payload"]) => void;
+export type RpcAvailableCommandsUpdateListener = (commands: RpcAvailableSlashCommand[]) => void;
 export interface RpcClientToolContext<TDetails = unknown> {
     toolCallId: string;
     signal: AbortSignal;
@@ -80,6 +81,10 @@ export declare class RpcClient {
      * Subscribe to raw subagent session events. Call setSubagentSubscription(\"events\") to enable them server-side.
      */
     onSubagentEvent(listener: RpcSubagentEventListener): () => void;
+    /**
+     * Subscribe to slash-command availability updates emitted by the RPC server.
+     */
+    onAvailableCommandsUpdate(listener: RpcAvailableCommandsUpdateListener): () => void;
     /**
      * Get collected stderr output (useful for debugging).
      */
@@ -157,6 +162,10 @@ export declare class RpcClient {
      * Get list of available models.
      */
     getAvailableModels(): Promise<ModelInfo[]>;
+    /**
+     * Get list of available slash commands.
+     */
+    getAvailableCommands(): Promise<RpcAvailableSlashCommand[]>;
     /**
      * Set thinking level.
      */

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

@@ -34,6 +34,8 @@ export type RpcSessionChangeResult = {
     };
 };
 export type RpcSessionChangeSession = Pick<AgentSession, "newSession" | "switchSession" | "branch">;
+export type RpcSkillCommandSession = Pick<AgentSession, "promptCustomMessage" | "skills" | "skillsSettings">;
+export declare function tryRunRpcSkillCommand(session: RpcSkillCommandSession, text: string): Promise<boolean>;
 export type RpcSubagentResetRegistry = Pick<RpcSubagentRegistry, "clear">;
 export declare function handleRpcSessionChange(session: RpcSessionChangeSession, command: RpcSessionChangeCommand, subagentRegistry?: RpcSubagentResetRegistry): Promise<RpcSessionChangeResult>;
 export declare function requestRpcEditor(pendingRequests: Map<string, PendingExtensionRequest>, output: RpcOutput, title: string, prefill?: string, dialogOptions?: ExtensionUIDialogOptions, editorOptions?: {

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

@@ -11,6 +11,7 @@ import type { BashResult } from "../../exec/bash-executor";
 import type { ContextUsage } from "../../extensibility/extensions/types";
 import type { AgentSessionEvent, SessionStats } from "../../session/agent-session";
 import type { FileEntry } from "../../session/session-manager";
+import type { AvailableSlashCommandSource } from "../../slash-commands/available-commands";
 import type { AgentProgress, SubagentEventPayload, SubagentLifecyclePayload, SubagentProgressPayload } from "../../task";
 import type { TodoPhase } from "../../tools/todo";
 export type RpcCommand = {
@@ -44,6 +45,9 @@ export type RpcCommand = {
 } | {
     id?: string;
     type: "get_state";
+} | {
+    id?: string;
+    type: "get_available_commands";
 } | {
     id?: string;
     type: "set_todos";
@@ -186,6 +190,24 @@ export interface RpcSessionState {
     /** Current context window usage. Null tokens/percent when unknown (e.g. right after compaction). */
     contextUsage?: ContextUsage;
 }
+export interface RpcAvailableSlashCommand {
+    name: string;
+    aliases?: string[];
+    description?: string;
+    input?: {
+        hint?: string;
+    };
+    subcommands?: Array<{
+        name: string;
+        description?: string;
+        usage?: string;
+    }>;
+    source: AvailableSlashCommandSource;
+}
+export interface RpcAvailableCommandsUpdateFrame {
+    type: "available_commands_update";
+    commands: RpcAvailableSlashCommand[];
+}
 export interface RpcHandoffResult {
     savedPath?: string;
 }
@@ -251,6 +273,14 @@ export type RpcResponse = {
     command: "get_state";
     success: true;
     data: RpcSessionState;
+} | {
+    id?: string;
+    type: "response";
+    command: "get_available_commands";
+    success: true;
+    data: {
+        commands: RpcAvailableSlashCommand[];
+    };
 } | {
     id?: string;
     type: "response";

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.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.editing" | "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.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.editing" | "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 */
@@ -150,6 +150,7 @@ export declare class Theme {
         time: string;
         pi: string;
         agents: string;
+        job: string;
         cache: string;
         input: string;
         output: string;
@@ -299,7 +300,7 @@ export declare function getThemeExportColors(themeName?: string): Promise<{
  * Highlight code with syntax coloring based on file extension or language.
  * Returns array of highlighted lines.
  */
-export declare function highlightCode(code: string, lang?: string): string[];
+export declare function highlightCode(code: string, lang?: string, highlightTheme?: Theme): string[];
 export declare function getSymbolTheme(): SymbolTheme;
 export declare function getMarkdownTheme(): MarkdownTheme;
 export declare function getSelectListTheme(): SelectListTheme;

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

@@ -36,7 +36,7 @@ import { type FileSlashCommand } from "../extensibility/slash-commands";
 import { GoalRuntime } from "../goals/runtime";
 import type { Goal, GoalModeState } from "../goals/state";
 import type { HindsightSessionState } from "../hindsight/state";
-import type { IrcMessage } from "../irc/bus";
+import { type IrcMessage } from "../irc/bus";
 import { type MnemopiSessionState } from "../mnemopi/state";
 import type { PlanModeState } from "../plan-mode/state";
 import { type SecretObfuscator } from "../secrets/obfuscator";
@@ -116,6 +116,7 @@ export type AgentSessionEvent = AgentEvent | {
 };
 /** Listener function for agent session events */
 export type AgentSessionEventListener = (event: AgentSessionEvent) => void;
+export type CommandMetadataChangedListener = () => void | Promise<void>;
 export type AsyncJobSnapshotItem = Pick<AsyncJob, "id" | "type" | "status" | "label" | "startTime">;
 export interface AsyncJobSnapshot {
     running: AsyncJobSnapshotItem[];
@@ -378,6 +379,7 @@ export declare class AgentSession {
      * Multiple listeners can be added. Returns unsubscribe function for this listener.
      */
     subscribe(listener: AgentSessionEventListener): () => void;
+    subscribeCommandMetadataChanged(listener: CommandMetadataChangedListener): () => void;
     /**
      * Synchronously mark the session as disposing so new work is rejected
      * immediately: Python/eval starts throw, queued asides are dropped, and the
@@ -554,6 +556,8 @@ export declare class AgentSession {
     setSlashCommands(slashCommands: FileSlashCommand[]): void;
     /** Custom commands (TypeScript slash commands and MCP prompts) */
     get customCommands(): ReadonlyArray<LoadedCustomCommand>;
+    /** MCP prompt commands only, for command-list metadata. */
+    get mcpPromptCommands(): ReadonlyArray<LoadedCustomCommand>;
     /** Update the MCP prompt commands list. Called when server prompts are (re)loaded. */
     setMCPPromptCommands(commands: LoadedCustomCommand[]): void;
     /**
@@ -936,8 +940,18 @@ export declare class AgentSession {
      *   → "woken".
      *
      * Never blocks on the recipient's turn: the wake turn is fire-and-forget.
-     */
-    deliverIrcMessage(msg: IrcMessage): Promise<"injected" | "woken">;
+     *
+     * When the sender expects a reply (`send await:true`) and this session is
+     * mid-turn with async execution disabled, the next step boundary may be
+     * gated on the sender's own batch finishing (blocking task spawns), so a
+     * real reply turn can never happen in time. In that case an ephemeral
+     * side-channel auto-reply is generated from the current context (the old
+     * `respondAsBackground` path) and sent back over the bus on this agent's
+     * behalf.
+     */
+    deliverIrcMessage(msg: IrcMessage, opts?: {
+        expectsReply?: boolean;
+    }): Promise<"injected" | "woken">;
     /**
      * Emit an IRC relay observation event on this session for UI rendering only.
      * Does not persist the record to history. Called by the IrcBus to surface

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

@@ -0,0 +1,34 @@
+import type { AvailableCommand } from "@agentclientprotocol/sdk";
+import type { SkillsSettings } from "../config/settings";
+import type { LoadedCustomCommand } from "../extensibility/custom-commands";
+import type { ExtensionRunner } from "../extensibility/extensions";
+import { type Skill } from "../extensibility/skills";
+import { type FileSlashCommand } from "../extensibility/slash-commands";
+export type AvailableSlashCommandSource = "builtin" | "skill" | "extension" | "custom" | "mcp_prompt" | "file";
+export interface InternalAvailableSlashCommand {
+    name: string;
+    aliases?: string[];
+    description?: string;
+    input?: {
+        hint: string;
+    };
+    subcommands?: Array<{
+        name: string;
+        description?: string;
+        usage?: string;
+    }>;
+    source: AvailableSlashCommandSource;
+}
+export interface AvailableCommandsSession {
+    readonly extensionRunner?: ExtensionRunner;
+    readonly customCommands: ReadonlyArray<LoadedCustomCommand>;
+    readonly mcpPromptCommands?: ReadonlyArray<LoadedCustomCommand>;
+    readonly skills: ReadonlyArray<Skill>;
+    readonly skillsSettings?: SkillsSettings;
+    setSlashCommands(slashCommands: FileSlashCommand[]): void;
+    sessionManager: {
+        getCwd(): string;
+    };
+}
+export declare function buildAvailableSlashCommands(session: AvailableCommandsSession, loadFileCommands?: (cwd: string) => Promise<FileSlashCommand[]>): Promise<InternalAvailableSlashCommand[]>;
+export declare function toAcpAvailableCommands(commands: readonly InternalAvailableSlashCommand[]): AvailableCommand[];

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

@@ -22,8 +22,8 @@ export declare function formatResultOutputFallback(result: Pick<SingleResult, "o
  * Task tool - Delegate tasks to specialized agents.
  *
  * Each call spawns one subagent — or, with `task.batch`, one per `tasks[]`
- * item. Spawning is non-blocking: the call registers AsyncJobManager jobs and
- * returns immediately; each result is delivered when that agent yields.
+ * item. When `async.enabled` is on, spawns run as AsyncJobManager jobs; when
+ * disabled, the tool blocks until every spawn finishes.
  */
 export declare class TaskTool implements AgentTool<TaskToolSchemaInstance, TaskToolDetails, Theme> {
     #private;
@@ -32,7 +32,7 @@ export declare class TaskTool implements AgentTool<TaskToolSchemaInstance, TaskT
     readonly approval: "exec";
     readonly formatApprovalDetails: (args: unknown) => string[];
     readonly label = "Task";
-    readonly summary = "Spawn a subagent to complete a task in the background";
+    readonly summary = "Spawn subagents to complete delegated tasks";
     readonly strict = true;
     readonly loadMode = "discoverable";
     readonly renderResult: typeof renderResult;

package/dist/types/tools/bash.d.ts

@@ -69,7 +69,7 @@ export declare class BashTool implements AgentTool<BashToolSchema, BashToolDetai
     readonly loadMode = "essential";
     readonly description: string;
     readonly parameters: BashToolSchema;
-    readonly concurrency = "exclusive";
+    readonly concurrency: (args: Partial<BashToolInput>) => "shared" | "exclusive";
     readonly strict = true;
     constructor(session: ToolSession);
     execute(_toolCallId: string, { command: rawCommand, env: rawEnv, timeout: rawTimeout, cwd, async: asyncRequested, pty, }: BashToolInput, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<BashToolDetails>, ctx?: AgentToolContext): Promise<AgentToolResult<BashToolDetails>>;