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

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

@@ -1210,6 +1210,42 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Show condensed changelog after updates";
         };
     };
+    readonly "magicKeywords.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly label: "Magic Keywords";
+            readonly description: "Enable hidden notices for standalone ultrathink, orchestrate, and workflowz keywords";
+        };
+    };
+    readonly "magicKeywords.ultrathink": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly label: "Ultrathink Keyword";
+            readonly description: "Let standalone ultrathink request maximum automatic thinking and append its hidden notice";
+        };
+    };
+    readonly "magicKeywords.orchestrate": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly label: "Orchestrate Keyword";
+            readonly description: "Let standalone orchestrate append its hidden multi-agent orchestration notice";
+        };
+    };
+    readonly "magicKeywords.workflow": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly label: "Workflow Keyword";
+            readonly description: "Let standalone workflowz append its hidden eval workflow notice";
+        };
+    };
     readonly "completion.notify": {
         readonly type: "enum";
         readonly values: readonly ["on", "off"];

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/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/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

@@ -300,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/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>>;

package/dist/types/tools/browser/attach.d.ts

@@ -1,4 +1,4 @@
-import type { Browser, Page } from "puppeteer-core";
+import { type Browser, type Page } from "puppeteer-core";
 /**
  * Allocate an unused TCP port on 127.0.0.1 by binding to port 0 and reading
  * back the kernel-assigned port. There's a small race between close and the
@@ -17,9 +17,9 @@ export declare function findReusableCdp(exe: string, signal?: AbortSignal): Prom
     pid: number;
 } | null>;
 /**
- * Pick the best page target on an attached browser. Without a matcher, prefer
- * a page that doesn't look like a helper window (devtools, request handler,
- * background pages); with a matcher, return the first url+title substring hit.
+ * Pick the best page target on an attached browser. Prefer discoverable page
+ * targets first so Chromium/Edge attach flows that hide pages from
+ * `browser.pages()` can still return a usable tab.
  */
 export declare function pickElectronTarget(browser: Browser, matcher?: string): Promise<Page>;
 /**

package/dist/types/tools/browser/registry.d.ts

@@ -36,6 +36,7 @@ export interface AcquireBrowserOptions {
     signal?: AbortSignal;
 }
 export declare function acquireBrowser(kind: BrowserKind, opts: AcquireBrowserOptions): Promise<BrowserHandle>;
+export declare function normalizeConnectedCdpUrl(rawCdpUrl: string): string;
 export declare function holdBrowser(handle: BrowserHandle): void;
 export declare function releaseBrowser(handle: BrowserHandle, opts: {
     kill: boolean;

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

@@ -90,12 +90,13 @@ export declare class IrcTool implements AgentTool<typeof ircSchema, IrcDetails>
 type IrcRenderArgs = Partial<IrcParams>;
 /**
  * Display-only transcript card for live IRC traffic: `irc:incoming` DMs
- * delivered to this session and `irc:relay` observations of agent↔agent
+ * delivered to this session, `irc:autoreply` side-channel replies sent on
+ * this session's behalf, and `irc:relay` observations of agent↔agent
  * traffic. Shares the tool renderer's glyph + quote-border conventions so
  * cards and `irc` tool output look identical in the transcript.
  */
 export declare function createIrcMessageCard(card: {
-    kind: "incoming" | "relay";
+    kind: "incoming" | "autoreply" | "relay";
     from?: string;
     to?: string;
     body?: string;

package/dist/types/tools/path-utils.d.ts

@@ -124,10 +124,6 @@ export interface ResolvedMultiFindPattern {
     targets: ResolvedFindTarget[];
     scopePath: string;
 }
-/**
- * Split a user path into a base path + glob pattern for tools that delegate to
- * APIs accepting separate `path` and `glob` arguments.
- */
 export declare function parseSearchPath(filePath: string): ParsedSearchPath;
 /**
  * Async sibling of {@link parseSearchPath} that prefers literal interpretation

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.11.1",
+	"version": "15.11.2",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -47,16 +47,16 @@
 		"@agentclientprotocol/sdk": "0.22.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "15.11.1",
-		"@oh-my-pi/omp-stats": "15.11.1",
-		"@oh-my-pi/pi-agent-core": "15.11.1",
-		"@oh-my-pi/pi-ai": "15.11.1",
-		"@oh-my-pi/pi-catalog": "15.11.1",
-		"@oh-my-pi/pi-mnemopi": "15.11.1",
-		"@oh-my-pi/pi-natives": "15.11.1",
-		"@oh-my-pi/pi-tui": "15.11.1",
-		"@oh-my-pi/pi-utils": "15.11.1",
-		"@oh-my-pi/snapcompact": "15.11.1",
+		"@oh-my-pi/hashline": "15.11.2",
+		"@oh-my-pi/omp-stats": "15.11.2",
+		"@oh-my-pi/pi-agent-core": "15.11.2",
+		"@oh-my-pi/pi-ai": "15.11.2",
+		"@oh-my-pi/pi-catalog": "15.11.2",
+		"@oh-my-pi/pi-mnemopi": "15.11.2",
+		"@oh-my-pi/pi-natives": "15.11.2",
+		"@oh-my-pi/pi-tui": "15.11.2",
+		"@oh-my-pi/pi-utils": "15.11.2",
+		"@oh-my-pi/snapcompact": "15.11.2",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",

package/src/config/settings-schema.ts

@@ -1093,6 +1093,46 @@ export const SETTINGS_SCHEMA = {
 		ui: { tab: "interaction", label: "Collapse Changelog", description: "Show condensed changelog after updates" },
 	},
 
+	"magicKeywords.enabled": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			label: "Magic Keywords",
+			description: "Enable hidden notices for standalone ultrathink, orchestrate, and workflowz keywords",
+		},
+	},
+
+	"magicKeywords.ultrathink": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			label: "Ultrathink Keyword",
+			description: "Let standalone ultrathink request maximum automatic thinking and append its hidden notice",
+		},
+	},
+
+	"magicKeywords.orchestrate": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			label: "Orchestrate Keyword",
+			description: "Let standalone orchestrate append its hidden multi-agent orchestration notice",
+		},
+	},
+
+	"magicKeywords.workflow": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			label: "Workflow Keyword",
+			description: "Let standalone workflowz append its hidden eval workflow notice",
+		},
+	},
+
 	// Notifications
 	"completion.notify": {
 		type: "enum",

package/src/exec/bash-executor.ts

@@ -56,6 +56,8 @@ export interface BashResult {
 const shellSessions = new Map<string, Shell>();
 const brokenShellSessions = new Set<string>();
 const shellSessionQuarantines = new Map<string, Promise<unknown>>();
+/** Session keys with a command currently in flight on the persistent Shell. */
+const shellSessionsInUse = new Set<string>();
 
 function quarantineShellSession(
 	sessionKey: string,
@@ -223,8 +225,14 @@ export async function executeBash(command: string, options?: BashExecutorOptions
 		shellSessions.delete(sessionKey);
 	}
 
-	let shellSession = persistentSessionBroken ? undefined : shellSessions.get(sessionKey);
-	if (!shellSession && !persistentSessionBroken) {
+	// A persistent Shell runs one command at a time (the native session is a
+	// mutex-guarded queue and `abort()` kills every in-flight run on it). When
+	// parallel bash calls overlap on the same key, the first one owns the
+	// persistent session; the rest degrade to isolated one-shot shells — the
+	// same path quarantined sessions take.
+	const sessionBusy = shellSessionsInUse.has(sessionKey);
+	let shellSession = persistentSessionBroken || sessionBusy ? undefined : shellSessions.get(sessionKey);
+	if (!shellSession && !persistentSessionBroken && !sessionBusy) {
 		shellSession = new Shell({
 			sessionEnv: shellEnv,
 			snapshotPath: snapshotPath ?? undefined,
@@ -232,6 +240,10 @@ export async function executeBash(command: string, options?: BashExecutorOptions
 		});
 		shellSessions.set(sessionKey, shellSession);
 	}
+	const ownsPersistentSession = shellSession !== undefined;
+	if (ownsPersistentSession) {
+		shellSessionsInUse.add(sessionKey);
+	}
 	const userSignal = options?.signal;
 	const runAbortController = new AbortController();
 	let abortCleanupPromise: Promise<void> | undefined;
@@ -393,10 +405,13 @@ export async function executeBash(command: string, options?: BashExecutorOptions
 		if (userSignal) {
 			userSignal.removeEventListener("abort", abortHandler);
 		}
-		if (resetSession || options?.sessionKey?.includes(":async:")) {
-			// `:async:` keys are per-job (jobId is unique), so the Shell would
-			// otherwise stay in the process-global map forever after completion.
-			shellSessions.delete(sessionKey);
+		if (ownsPersistentSession) {
+			shellSessionsInUse.delete(sessionKey);
+			if (resetSession || options?.sessionKey?.includes(":async:")) {
+				// `:async:` keys are per-job (jobId is unique), so the Shell would
+				// otherwise stay in the process-global map forever after completion.
+				shellSessions.delete(sessionKey);
+			}
 		}
 	}
 }