@oh-my-pi/pi-coding-agent 16.3.11 → 16.3.13

package/dist/types/advisor/runtime.d.ts

@@ -45,6 +45,17 @@ export interface AdvisorRuntimeHost {
      * one that routes `advise()` results back to the primary.
      */
     beginAdvisorUpdate?(): void;
+    /**
+     * Called with the error of every failed advisor turn, before the retry sleep
+     * or the dropped-after-3 path. Lets the host apply credential-level remedies
+     * the advisor loop lacks: the in-stream a/b/c auth retry rotates through
+     * sibling credentials within one request but never blocks the LAST failing
+     * one — the primary agent's retry pipeline does that via
+     * `markUsageLimitReached`, so without this hook the advisor re-picks the
+     * same usage-limited account on every retry. Errors thrown here are logged
+     * and swallowed.
+     */
+    onTurnError?(error: unknown): Promise<void> | void;
     /** Surface a non-recovering advisor failure to the host UI without adding model-visible context. */
     notifyFailure?(error: unknown): void;
 }

package/dist/types/config/keybindings.d.ts

@@ -323,6 +323,11 @@ export declare const KEYBINDINGS: {
         readonly description: "Toggle speech-to-text (default gesture: hold Space)";
     };
 };
+/** Controls inherited keybinding lookup when creating a manager for a named profile. */
+export interface KeybindingsCreateOptions {
+    /** Default-profile agent directory whose keybindings are merged before profile-specific bindings. */
+    inheritedAgentDir?: string;
+}
 declare function migrateKeybindingsConfigFile(agentDir: string): void;
 /**
  * Manages all keybindings (app + TUI).
@@ -330,18 +335,18 @@ declare function migrateKeybindingsConfigFile(agentDir: string): void;
  */
 export declare class KeybindingsManager extends TuiKeybindingsManager {
     #private;
-    constructor(userBindings?: KeybindingsConfig, configPath?: string);
+    constructor(userBindings?: KeybindingsConfig, configPath?: string, inheritedConfigPath?: string);
     /**
-     * Create from config file at agentDir/keybindings.yml.
+     * Create from config files at agentDir/keybindings.yml and the default profile.
      * Legacy keybindings.json is migrated to keybindings.yml on load.
      */
-    static create(agentDir?: string): KeybindingsManager;
+    static create(agentDir?: string, options?: KeybindingsCreateOptions): KeybindingsManager;
     /**
      * Create an in-memory keybindings manager without file persistence.
      */
     static inMemory(userBindings?: KeybindingsConfig): KeybindingsManager;
     /**
-     * Reload keybindings from the config file.
+     * Reload keybindings from the config files.
      */
     reload(): void;
     setUserBindings(userBindings: KeybindingsConfig): void;

package/dist/types/config/model-registry.d.ts

@@ -189,6 +189,10 @@ export declare class ModelRegistry {
      * Check if a model selector is currently suppressed due to rate limits.
      */
     isSelectorSuppressed(selector: string): boolean;
+    /**
+     * Clear the cooldown suppression for one selector after an explicit user selection.
+     */
+    clearSuppressedSelector(selector: string): void;
     /**
      * Clear all cooldown suppressions recorded via {@link suppressSelector}.
      * Used to reset retry-fallback cooldown state without a full {@link refresh}.

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

@@ -1380,6 +1380,12 @@ export declare const SETTINGS_SCHEMA: {
     readonly "retry.fallbackChains": {
         readonly type: "record";
         readonly default: Record<string, string[]>;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Retry & Fallback";
+            readonly label: "Retry Fallback Chains";
+            readonly description: 'JSON object mapping model roles to ordered fallback model selectors, e.g. {"default":["openai/gpt-4o-mini"]}.';
+        };
     };
     readonly "retry.fallbackRevertPolicy": {
         readonly type: "enum";

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

@@ -24,7 +24,7 @@ export interface RawSettings {
 export interface SettingsOptions {
     /** Current working directory for project settings discovery */
     cwd?: string;
-    /** Agent directory for config.yml storage */
+    /** Agent directory for config.yml/config.yaml storage */
     agentDir?: string;
     /** Don't persist to disk (for tests) */
     inMemory?: boolean;
@@ -152,6 +152,8 @@ export declare class Settings {
  * can register independently without overwriting each other.
  */
 export declare const onAppendOnlyModeChanged: (cb: (value: string) => void) => () => void;
+/** Subscribe to model role changes. Returns an unsubscribe function. */
+export declare const onModelRolesChanged: (cb: () => void) => () => void;
 /**
  * Subscribe to session-accent setting changes.
  * Returns an unsubscribe function. Callers should re-read settings in the callback.

package/dist/types/discovery/helpers.d.ts

@@ -122,6 +122,15 @@ export interface ScanSkillsFromDirOptions {
     providerId: string;
     level: "user" | "project";
     requireDescription?: boolean;
+    /**
+     * When true, treat a `SKILL.md` sitting directly under `dir` as a single skill in addition to
+     * scanning `<dir>/<name>/SKILL.md` children. Matches the Claude plugin manifest convention
+     * that lets a skill path point at a directory containing `SKILL.md` directly (e.g.
+     * `"skills": ["./"]`), where the frontmatter `name` determines the invocation name and the
+     * directory basename is the fallback. Default `false` preserves the strict child-scan
+     * semantic every non-Claude provider relies on.
+     */
+    includeSelf?: boolean;
 }
 export declare function compareSkillOrder(aName: string, aPath: string, bName: string, bPath: string): number;
 export declare function scanSkillsFromDir(_ctx: LoadContext, options: ScanSkillsFromDirOptions): Promise<LoadResult<Skill>>;

package/dist/types/exec/bash-executor.d.ts

@@ -2,6 +2,7 @@ import { type MinimizerOptions } from "@oh-my-pi/pi-natives";
 import { type ShellMinimizerSettings } from "../config/settings.js";
 export interface BashExecutorOptions {
     cwd?: string;
+    /** Milliseconds before aborting the command; 0 disables the executor deadline. */
     timeout?: number;
     onChunk?: (chunk: string) => void;
     chunkThrottleMs?: number;

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

@@ -11,7 +11,7 @@ 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 { AutocompleteItem, Component, EditorTheme, KeyId, TUI } from "@oh-my-pi/pi-tui";
+import type { AutocompleteItem, AutocompleteProvider, Component, EditorTheme, KeyId, TUI } from "@oh-my-pi/pi-tui";
 import type { logger as PiLogger } from "@oh-my-pi/pi-utils";
 import type { Type as arktype } from "arktype";
 import type * as zod from "zod/v4";
@@ -89,6 +89,8 @@ export type ExtensionUiComponent = Component & {
 };
 export type ExtensionUiComponentFactory = (tui: TUI, theme: Theme) => ExtensionUiComponent;
 export type ExtensionWidgetContent = string[] | ExtensionUiComponentFactory | undefined;
+/** Wrap the current autocomplete provider with additional behavior (pi-compatible). */
+export type AutocompleteProviderFactory = (current: AutocompleteProvider) => AutocompleteProvider;
 /**
  * UI context for extensions to request interactive UI.
  * Each mode (interactive, RPC, print) provides its own implementation.
@@ -135,6 +137,13 @@ export interface ExtensionUIContext {
     editor(title: string, prefill?: string, dialogOptions?: ExtensionUIDialogOptions, editorOptions?: {
         promptStyle?: boolean;
     }): Promise<string | undefined>;
+    /**
+     * Stack additional autocomplete behavior on top of the built-in provider
+     * (pi-compatible). Interactive mode rebuilds the editor's provider through
+     * every registered factory, in registration order; headless modes (print,
+     * RPC, ACP, subagents) accept and ignore the factory.
+     */
+    addAutocompleteProvider(factory: AutocompleteProviderFactory): void;
     /**
      * Set a custom editor component via factory function, or `undefined` to restore the default editor.
      *
@@ -707,7 +716,7 @@ export interface ExtensionAPI {
         triggerTurn?: boolean;
         deliverAs?: "steer" | "followUp" | "nextTurn";
     }): void;
-    /** Send a user message to the agent, or queue it when deliverAs is set. */
+    /** Send a user prompt: idle starts a turn; streaming queues as steer unless deliverAs is set. */
     sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
         deliverAs?: "steer" | "followUp";
     }): void;

package/dist/types/extensibility/shared-events.d.ts

@@ -27,7 +27,7 @@ export interface SessionStartEvent {
 export interface SessionBeforeSwitchEvent {
     type: "session_before_switch";
     /** Reason for the switch */
-    reason: "new" | "resume" | "fork";
+    reason: "new" | "resume" | "fork" | "handoff";
     /** Session file we're switching to (only for "resume") */
     targetSessionFile?: string;
 }
@@ -35,7 +35,7 @@ export interface SessionBeforeSwitchEvent {
 export interface SessionSwitchEvent {
     type: "session_switch";
     /** Reason for the switch */
-    reason: "new" | "resume" | "fork";
+    reason: "new" | "resume" | "fork" | "handoff";
     /** Session file we came from */
     previousSessionFile: string | undefined;
 }

package/dist/types/internal-urls/__tests__/agent-protocol-nested.test.d.ts

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

package/dist/types/internal-urls/registry-helpers.d.ts

@@ -3,10 +3,12 @@ export declare function resetRegisteredArtifactDirsForTests(): void;
 /**
  * Snapshot of artifacts dirs for every registered session, deduped.
  *
- * Prefers `sessionManager.getArtifactsDir()` because subagents adopt their
- * parent's `ArtifactManager` and report the parent's dir there; dedup then
- * collapses parent + N subagents (the whole agent tree) to one entry. Falls
- * back to the raw session file (with the `.jsonl` suffix stripped) when no
- * live session reference is attached.
+ * Collects TWO candidate dirs per ref, because a subagent reads from its
+ * adopted (root-wide) `ArtifactManager.dir` but its own children are written
+ * one level deeper, under `sessionFile.slice(0, -6)` (`task/index.ts`). A
+ * depth-2+ subagent's output therefore lives in the write-time dir, not the
+ * adopted one, so `agent://` must scan both or it 404s a live nested peer.
+ * `addDir` dedup collapses the depth-0 case (both formulas agree) back to a
+ * single entry.
  */
 export declare function artifactsDirsFromRegistry(): string[];

package/dist/types/mnemopi/state.d.ts

@@ -33,10 +33,14 @@ export interface MnemopiMemoryEditOptions {
     replacementId?: string;
 }
 export interface MnemopiMemoryEditResult {
-    status: "updated" | "deleted" | "invalidated" | "not_found";
+    status: "updated" | "deleted" | "invalidated" | "not_found" | "not_editable";
     bank?: string;
-    store?: "working" | "episodic";
+    store?: MnemopiMemoryStore;
 }
+/** Which mnemopi table a resolved memory id lives in. `fact` rows are
+ * read-only projections of fact extraction (issue #4725): resolvable for
+ * reads, never editable. */
+export type MnemopiMemoryStore = "working" | "episodic" | "fact";
 /**
  * Full-row lookup result produced by {@link MnemopiSessionState.getScopedMemory}.
  * Mirrors the shape stored in mnemopi's working/episodic tables, tagged with
@@ -45,7 +49,7 @@ export interface MnemopiMemoryEditResult {
  */
 export interface MnemopiScopedMemoryHit {
     bank: string;
-    store: "working" | "episodic";
+    store: MnemopiMemoryStore;
     row: {
         id: string;
         content: string;

package/dist/types/modes/acp/acp-event-mapper.d.ts

@@ -30,4 +30,5 @@ export declare function buildToolCallStartUpdate(input: {
 export declare function normalizeReplayToolArguments(value: unknown): {
     args: unknown;
 };
+export declare function extractAssistantMessageText(value: unknown): string;
 export {};

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

@@ -7,7 +7,8 @@ interface ScopedModelItem {
     model: Model;
     thinkingLevel?: string;
 }
-type RoleSelectCallback = (model: Model, role: string | null, thinkingLevel?: ConfiguredThinkingLevel, selector?: string) => void;
+type ModelSelectorAction = "modelRole" | "retryFallback";
+type RoleSelectCallback = (model: Model, role: string | null, thinkingLevel?: ConfiguredThinkingLevel, selector?: string, action?: ModelSelectorAction) => void;
 /**
  * Component that renders a model selector with provider tabs and context menu.
  * - Tab/Arrow Left/Right: Switch between provider tabs

package/dist/types/modes/components/read-tool-group.d.ts

@@ -6,6 +6,7 @@ export declare function readArgsTargetInternalUrl(args: unknown): boolean;
 type ReadRenderArgs = {
     path?: string;
     file_path?: string;
+    selector?: string;
     sel?: string;
 };
 type ReadToolGroupOptions = {

package/dist/types/modes/github-ref-autocomplete.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Autocomplete for GitHub issue/PR references typed as `#<number>` (e.g. `#3164`).
+ *
+ * Mirrors the `@` file-reference and `scheme://` internal-url conventions: the
+ * token is rewritten to an internal URL (`pr://3164` or `issue://3164`) plus a
+ * trailing space, and the existing tool-mediated pipeline (the `read` tool →
+ * InternalUrlRouter → `gh`) resolves it from the session cwd's git remote.
+ *
+ * No network at suggestion time — candidates are generated locally. GitHub
+ * shares the issue/PR number space and there is no cheap way to tell which a
+ * given number is while typing, so both a PR and an Issue candidate are offered
+ * by default. Naming the type first (`pr #3164` / `issue #3164`) constrains the
+ * candidates to that kind. Anything that is not a standalone `#<number>` token
+ * keeps falling through to the existing prompt-action menu.
+ */
+import type { AutocompleteItem } from "@oh-my-pi/pi-tui";
+export interface GithubRefContext {
+    /** Text to replace on accept: `#3164`, or `pr #3164` when a qualifier precedes it. */
+    prefix: string;
+    /** Type the user named (`pr`/`pull` → `pr`, `issue` → `issue`), or null to offer both. */
+    qualifier: "pr" | "issue" | null;
+    /** The numeric reference, e.g. `3164`. */
+    number: string;
+}
+export declare function getGithubRefContext(textBeforeCursor: string): GithubRefContext | null;
+/**
+ * Suggestions for a `#<number>` token. Both kinds are offered unless the user
+ * named a type (`pr #3164` / `issue #3164`), in which case only that kind is
+ * offered. Returns `null` when the text before the cursor is not a standalone
+ * `#<number>` token.
+ */
+export declare function getGithubRefSuggestions(textBeforeCursor: string): {
+    items: AutocompleteItem[];
+    prefix: string;
+} | null;

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

@@ -7,7 +7,7 @@ import type { CollabGuestLink } from "../collab/guest.js";
 import type { CollabHost } from "../collab/host.js";
 import { KeybindingsManager } from "../config/keybindings.js";
 import { Settings } from "../config/settings.js";
-import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions/index.js";
+import type { AutocompleteProviderFactory, ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions/index.js";
 import type { CompactOptions } from "../extensibility/extensions/types.js";
 import type { Skill } from "../extensibility/skills.js";
 import type { MCPManager } from "../mcp/index.js";
@@ -180,6 +180,8 @@ export declare class InteractiveMode implements InteractiveModeContext {
     refreshTitleSystemPrompt(cwd?: string): Promise<void>;
     /** Reload slash commands and autocomplete for the provided working directory. */
     refreshSlashCommandState(cwd?: string): Promise<void>;
+    /** Stack extension autocomplete behavior on top of the built-in editor provider (#4919). */
+    addAutocompleteProvider(factory: AutocompleteProviderFactory): void;
     /**
      * Re-point the process and every cwd-derived cache at `newCwd` after the
      * active session's working directory changed (`/move` relocation or resuming

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

@@ -269,17 +269,23 @@ export declare class RpcClient {
     /**
      * Trigger OAuth login for the given provider.
      * The server will emit an `open_url` extension_ui_request for the auth URL.
+     * Providers that require pasted-code completion may then emit an `input`
+     * extension_ui_request; pass `onManualCodeInput` to satisfy it.
      * Resolves when login completes or rejects on failure.
      *
      * @param onOpenUrl Called when the server emits the auth URL. The host must
-     *   open `url` in a browser for the callback-server OAuth flow to complete.
-     *   When the flow's callback server hosts a `/launch` redirect, `launchUrl`
-     *   is a short loopback URL that 302s to `url` — hosts SHOULD surface it as
-     *   the truncation-safe copy target so terminal viewport clipping cannot
-     *   corrupt trailing OAuth query parameters (e.g. `code_challenge_method=S256`).
+     *   open `url` in a browser. When the flow's callback server hosts a
+     *   `/launch` redirect, `launchUrl` is a short loopback URL that 302s to
+     *   `url` — hosts SHOULD surface it as the truncation-safe copy target so
+     *   terminal viewport clipping cannot corrupt trailing OAuth query
+     *   parameters (e.g. `code_challenge_method=S256`).
      */
     login(providerId: string, options?: {
         onOpenUrl?: (url: string, instructions?: string, launchUrl?: string) => void;
+        onManualCodeInput?: (prompt: {
+            title: string;
+            placeholder?: string;
+        }) => string | Promise<string>;
     }): Promise<{
         providerId: string;
     }>;

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

@@ -38,7 +38,7 @@ export type RpcSkillCommandSession = Pick<AgentSession, "promptCustomMessage" |
 export type RpcSkillCommandResult = {
     agentInvoked: true;
 };
-export declare function tryRunRpcSkillCommand(session: RpcSkillCommandSession, text: string): Promise<RpcSkillCommandResult | false>;
+export declare function tryRunRpcSkillCommand(session: RpcSkillCommandSession, text: string, streamingBehavior?: "steer" | "followUp"): Promise<RpcSkillCommandResult | false>;
 export declare function reportLocalOnlyPromptResult(input: {
     id: string | undefined;
     prompt: Promise<boolean>;

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

@@ -6,7 +6,7 @@ import type { CollabGuestLink } from "../collab/guest.js";
 import type { CollabHost } from "../collab/host.js";
 import type { KeybindingsManager } from "../config/keybindings.js";
 import type { Settings } from "../config/settings.js";
-import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions/index.js";
+import type { AutocompleteProviderFactory, ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions/index.js";
 import type { CompactOptions } from "../extensibility/extensions/types.js";
 import type { Skill } from "../extensibility/skills.js";
 import type { MCPManager } from "../mcp/index.js";
@@ -195,6 +195,8 @@ export interface InteractiveModeContext {
     checkShutdownRequested(): Promise<void>;
     setToolUIContext(uiContext: ExtensionUIContext, hasUI: boolean): void;
     initializeHookRunner(uiContext: ExtensionUIContext, hasUI: boolean): void;
+    /** Stack extension autocomplete behavior on top of the built-in editor provider. */
+    addAutocompleteProvider(factory: AutocompleteProviderFactory): void;
     setEditorComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => CustomEditor) | undefined): void;
     /**
      * Mount transcript content and repaint once. The single sink for "show this in

package/dist/types/modes/utils/context-usage.d.ts

@@ -24,18 +24,6 @@ export interface ContextBreakdown {
 }
 export declare function estimateSkillsTokens(skills: readonly Skill[]): number;
 export declare function estimateToolSchemaTokens(tools: ReadonlyArray<Pick<Tool, "name" | "description" | "parameters">>): number;
-/**
- * Compute just the NON-MESSAGE token total: system prompt (with its skills
- * section subtracted, since skills are tokenized separately) + system context
- * (the rest of the system-prompt array) + tools + skills.
- *
- * Exposed so callers like `StatusLineComponent` can cache the non-message
- * total separately from the message total. Non-message inputs (skills,
- * tools, system prompt) change rarely; the message list grows on every
- * streaming turn. Splitting the two lets the caller refresh each on its own
- * cadence — non-message recomputed only when the inputs identity changes,
- * messages walked incrementally as new entries append.
- */
 export declare function computeNonMessageTokens(session: AgentSession): number;
 /**
  * Shared helper for the four non-message token totals used by

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

@@ -1,6 +1,10 @@
 import { type KeywordHighlighter } from "./gradient-highlight.js";
-/** Hidden system notice appended after a user message that mentions "workflowz". */
+/** WORKFLOW_NOTICE is the default hidden notice for sessions with batched task calls enabled. */
 export declare const WORKFLOW_NOTICE: string;
+/** renderWorkflowNotice renders the workflow notice for the active task schema. */
+export declare function renderWorkflowNotice({ taskBatch }: {
+    taskBatch: boolean;
+}): string;
 /**
  * Whether `text` contains the standalone keyword "workflowz"
  * (lowercase, whitespace-delimited) in prose — never inside a code block, inline

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

@@ -184,6 +184,8 @@ export interface AgentSessionConfig {
     toolRegistry?: Map<string, AgentTool>;
     /** Tool names whose current registry entry is still the built-in implementation. */
     builtInToolNames?: Iterable<string>;
+    /** Update tool-session predicates that render guidance from the live active tool set. */
+    setActiveToolNames?: (names: Iterable<string>) => void;
     /** Current session pre-LLM message transform pipeline */
     transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => AgentMessage[] | Promise<AgentMessage[]>;
     /**
@@ -224,6 +226,8 @@ export interface AgentSessionConfig {
     rebuildSystemPrompt?: (toolNames: string[], tools: Map<string, AgentTool>) => Promise<{
         systemPrompt: string[];
     }>;
+    /** Local calendar date provider used by prompt-cache invalidation. Defaults to the host local date. */
+    getLocalCalendarDate?: () => string;
     /** Rebuild the SSH tool from current capability discovery results. */
     reloadSshTool?: () => Promise<AgentTool | null>;
     requestedToolNames?: ReadonlySet<string>;
@@ -366,6 +370,7 @@ export interface HandoffResult {
 export interface SessionHandoffOptions {
     autoTriggered?: boolean;
     signal?: AbortSignal;
+    onSwitchCancelled?: () => void;
 }
 /** Result from cycleModel() */
 export interface ModelCycleResult {
@@ -809,11 +814,10 @@ export declare class AgentSession {
         queueChipText?: string;
     }): Promise<boolean>;
     /**
-     * Send a user message to the agent.
-     * When deliverAs is set, queue the message instead of starting a new turn.
+     * Send a user message through the prompt flow.
      *
-     * @param content User message content (string or content array)
-     * @param options.deliverAs Delivery mode: "steer" or "followUp"
+     * Omitted `deliverAs` starts a turn when idle and queues as a steer while streaming.
+     * Explicit `deliverAs` queues without starting a turn in either state.
      */
     sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
         deliverAs?: "steer" | "followUp";

package/dist/types/system-prompt.d.ts

@@ -35,7 +35,7 @@ export declare function loadProjectContextFiles(options?: LoadContextFilesOption
  * Project-level SYSTEM.md overrides user-level SYSTEM.md.
  */
 export declare function loadSystemPromptFiles(options?: LoadContextFilesOptions): Promise<string | null>;
-export declare const DEFAULT_SYSTEM_PROMPT_TOOL_NAMES: readonly ["read", "bash", "eval", "edit", "write"];
+export declare const DEFAULT_SYSTEM_PROMPT_TOOL_NAMES: readonly ["read", "bash", "edit", "write"];
 export interface SystemPromptToolMetadata {
     label: string;
     description: string;

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

@@ -8,7 +8,7 @@ export interface BashInteractiveResult extends OutputSummary {
 export declare function runInteractiveBashPty(ui: NonNullable<AgentToolContext["ui"]>, options: {
     command: string;
     cwd: string;
-    timeoutMs: number;
+    timeoutMs?: number;
     signal?: AbortSignal;
     env?: Record<string, string>;
     artifactPath?: string;

package/dist/types/tools/bash-skill-urls.d.ts

@@ -25,6 +25,7 @@ export declare function resolveSkillUrlToPath(url: string, skills: readonly Skil
 export declare function expandSkillUrls(command: string, skills: readonly Skill[]): string;
 /**
  * Expand supported internal URLs in a bash command string to shell-escaped absolute paths.
+ * Unresolvable URLs and literal mentions inside larger quoted text are left unchanged.
  * Supported schemes: skill://, agent://, artifact://, memory://, rule://, local://
  */
 export declare function expandInternalUrls(command: string, options: InternalUrlExpansionOptions): Promise<string>;

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

@@ -72,6 +72,7 @@ export interface BashToolDetails {
     meta?: OutputMeta;
     timeoutSeconds?: number;
     requestedTimeoutSeconds?: number;
+    timeoutDisabled?: boolean;
     wallTimeMs?: number;
     /** Exit code of a command that ran to completion but failed (non-zero). */
     exitCode?: number;
@@ -97,7 +98,7 @@ export declare class BashTool implements AgentTool<typeof bashSchemaBase | typeo
     readonly formatApprovalDetails: (args: unknown) => string[];
     readonly label = "Bash";
     readonly loadMode = "essential";
-    readonly description: string;
+    get description(): string;
     readonly parameters: BashToolSchema;
     readonly concurrency: (args: Partial<BashToolInput>) => "shared" | "exclusive";
     readonly strict = true;

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

@@ -60,6 +60,7 @@ export declare function applyStealthPatches(browser: Browser, page: Page, state:
     browserSession: CDPSession | null;
     override: UserAgentOverride | null;
 }): Promise<void>;
+export declare function stealthIgnoreDefaultArgsForTest(executablePath: string | undefined): string[];
 export declare function targetSupportsUserAgentOverrideForTest(target: Target): boolean;
 export declare function configureUserAgentTargetsForTest(browser: Browser, state: {
     browserSession: CDPSession | null;

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

@@ -8,6 +8,7 @@ import type { OutputMeta } from "./output-meta.js";
 declare const searchSchema: import("arktype/internal/variants/object.ts").ObjectType<{
     pattern: string;
     path?: string | undefined;
+    selector?: string | undefined;
     case?: boolean | undefined;
     gitignore?: boolean | undefined;
     skip?: number | null | undefined;
@@ -66,6 +67,7 @@ export declare class GrepTool implements AgentTool<typeof searchSchema, GrepTool
     readonly parameters: import("arktype/internal/variants/object.ts").ObjectType<{
         pattern: string;
         path?: string | undefined;
+        selector?: string | undefined;
         case?: boolean | undefined;
         gitignore?: boolean | undefined;
         skip?: number | null | undefined;

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

@@ -172,6 +172,10 @@ export interface ToolSession {
     getAgentId?: () => string | null;
     /** Look up a registered tool by name (used by the eval js backend's tool bridge). */
     getToolByName?: (name: string) => AgentTool | undefined;
+    /** Return whether a built-in tool is active in this turn's tool set. */
+    isToolActive?: (name: string) => boolean;
+    /** Update the active built-in tool predicate when a session changes tools mid-run. */
+    setActiveToolNames?: (names: Iterable<string>) => void;
     /** Agent registry for IRC routing across live sessions. */
     agentRegistry?: AgentRegistry;
     /** Get artifacts directory for artifact:// URLs */

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

@@ -36,6 +36,30 @@ export declare function splitPathAndSel(rawPath: string): {
     path: string;
     sel?: string;
 };
+/**
+ * Three-way probe for whether the exact filesystem entry named by `filePath`
+ * exists. `stat` (used earlier) failed for reasons other than "no such file"
+ * (dangling symlink, `EACCES` on a parent, transient I/O), and each of those
+ * silently reinterpreted a real literal path such as `test:1-2` as `test`
+ * plus selector `1-2` (issue #4618). `lstat` inspects the entry itself, so a
+ * dangling symlink is still detected as present; ambiguous errors resolve to
+ * `"unknown"` so callers keep the raw path instead of guessing.
+ */
+export declare function probeLiteralPathExists(filePath: string, cwd: string): Promise<"exists" | "missing" | "unknown">;
+/**
+ * Async sibling of {@link splitPathAndSel} that prefers a literal filesystem
+ * path over selector interpretation. Filenames whose tail matches the selector
+ * grammar (e.g. `test:1-2`, `log:raw`) are legal on POSIX; without this the
+ * strict splitter peels the tail and both `read` and `grep` refuse to open the
+ * real file (issue #4618). The literal wins on a confirmed `lstat`, and also
+ * on `"unknown"` (`EACCES` on a parent, transient I/O), so an unreachable
+ * literal is never silently reinterpreted as `path + selector`. Only a
+ * definitive `ENOENT`/`ENOTDIR` falls back to the strict split.
+ */
+export declare function splitPathAndSelPreferringLiteral(rawPath: string, cwd: string): Promise<{
+    path: string;
+    sel?: string;
+}>;
 /**
  * Variant of {@link splitPathAndSel} for internal URLs (`scheme://...`).
  *

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

@@ -7,6 +7,7 @@ import { type TruncationResult } from "../session/streaming-output.js";
 import { type OutputMeta } from "./output-meta.js";
 declare const readSchema: import("arktype/internal/variants/object.ts").ObjectType<{
     path: string;
+    selector?: string | undefined;
 }, {}>;
 export type ReadToolInput = typeof readSchema.infer;
 export interface ReadToolDetails {
@@ -59,6 +60,7 @@ export declare class ReadTool implements AgentTool<typeof readSchema, ReadToolDe
     readonly description: string;
     readonly parameters: import("arktype/internal/variants/object.ts").ObjectType<{
         path: string;
+        selector?: string | undefined;
     }, {}>;
     readonly strict = true;
     constructor(session: ToolSession);
@@ -67,6 +69,7 @@ export declare class ReadTool implements AgentTool<typeof readSchema, ReadToolDe
 interface ReadRenderArgs {
     path?: unknown;
     file_path?: unknown;
+    selector?: unknown;
     sel?: string;
     offset?: number;
     limit?: number;

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

@@ -6,6 +6,14 @@
 import type { Component } from "@oh-my-pi/pi-tui";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types.js";
 import type { Theme } from "../modes/theme/theme.js";
+/**
+ * Per-renderer opt-in for a full viewport replay when the first result
+ * replaces a painted pending-call render. A predicate receives the painted
+ * call args and render options so the repaint stays scoped to the pending
+ * shapes that actually re-anchor (an over-eager replay wipes native
+ * scrollback on direct terminals).
+ */
+export type FirstResultViewportRepaint = boolean | ((args: unknown, options: RenderResultOptions) => boolean);
 export type ToolRenderer = {
     renderCall: (args: unknown, options: RenderResultOptions, theme: Theme) => Component;
     renderResult: (result: {
@@ -33,12 +41,11 @@ export type ToolRenderer = {
      */
     animatedPartialResult?: boolean | ((args: unknown) => boolean);
     /**
-     * Whether replacing a streamed pending placeholder with the first result
-     * requires a full viewport repaint. Use for merged renderers whose pending
-     * streamed args may have committed placeholder rows that the result render
-     * re-anchors instead of preserving.
+     * Whether replacing a pending call render with the first result requires a
+     * full viewport repaint. Use for merged renderers whose pending rows can be
+     * re-anchored instead of preserved by the result render.
      */
-    forceFirstResultViewportRepaint?: boolean;
+    forceFirstResultViewportRepaint?: FirstResultViewportRepaint;
     /**
      * Whether settling a provisional partial result into the final render requires
      * a full viewport repaint. Use when the result renderer changes chrome or