@oh-my-pi/pi-coding-agent 15.10.0 → 15.10.2

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

@@ -8,7 +8,7 @@ import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectIte
 import type { CompactOptions } from "../extensibility/extensions/types";
 import type { MCPManager } from "../mcp";
 import type { PlanApprovalDetails } from "../plan-mode/approved-plan";
-import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
+import type { AgentSession } from "../session/agent-session";
 import type { HistoryStorage } from "../session/history-storage";
 import type { SessionContext, SessionManager } from "../session/session-manager";
 import type { ShakeMode } from "../session/shake-types";
@@ -51,6 +51,7 @@ export type TodoPhase = {
 };
 export interface InteractiveModeInitOptions {
     suppressWelcomeIntro?: boolean;
+    clearInitialTerminalHistory?: boolean;
 }
 export type InteractiveSelectorDialogOptions = ExtensionUIDialogOptions & Pick<HookSelectorOptions, "disabledIndices">;
 export interface InteractiveModeContext {
@@ -76,7 +77,6 @@ export interface InteractiveModeContext {
     mcpManager?: MCPManager;
     lspServers?: LspStartupServerInfo[];
     isInitialized: boolean;
-    isBackgrounded: boolean;
     isBashMode: boolean;
     toolOutputExpanded: boolean;
     todoExpanded: boolean;
@@ -126,9 +126,21 @@ export interface InteractiveModeContext {
     checkShutdownRequested(): Promise<void>;
     setToolUIContext(uiContext: ExtensionUIContext, hasUI: boolean): void;
     initializeHookRunner(uiContext: ExtensionUIContext, hasUI: boolean): void;
-    createBackgroundUiContext(): ExtensionUIContext;
     setEditorComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => CustomEditor) | undefined): void;
-    handleBackgroundEvent(event: AgentSessionEvent): Promise<void>;
+    /**
+     * Mount transcript content and repaint once. The single sink for "show this in
+     * chat": producers build and return a `Component` (or a `ChatBlock` carrying
+     * its own lifecycle) and hand it here instead of touching `chatContainer` /
+     * `ui.requestRender()` directly. `ChatBlock`s are mounted (their `onMount`
+     * runs) so their timers/subscriptions start.
+     */
+    present(content: Component | readonly Component[]): void;
+    /**
+     * Dispose every live block in the transcript (stopping timers/subscriptions)
+     * and clear it. Used before a full rebuild so animated/streaming blocks do not
+     * leak.
+     */
+    resetTranscript(): void;
     showStatus(message: string, options?: {
         dim?: boolean;
     }): void;
@@ -147,6 +159,9 @@ export interface InteractiveModeContext {
     flushPendingModelSwitch(): Promise<void>;
     setWorkingMessage(message?: string): void;
     applyPendingWorkingMessage(): void;
+    /** Acknowledge a user interrupt (Esc) by switching the loader to an
+     *  "Interrupting…" label until the agent turn unwinds. */
+    notifyInterrupting(): void;
     ensureLoadingAnimation(): void;
     startPendingSubmission(input: {
         text: string;
@@ -208,6 +223,7 @@ export interface InteractiveModeContext {
     handleDumpCommand(): void;
     handleDebugTranscriptCommand(): Promise<void>;
     handleClearCommand(): Promise<void>;
+    handleFreshCommand(): Promise<void>;
     handleDropCommand(): Promise<void>;
     handleForkCommand(): Promise<void>;
     handleBashCommand(command: string, excludeFromContext?: boolean): Promise<void>;
@@ -248,9 +264,9 @@ export interface InteractiveModeContext {
     handleCtrlD(): void;
     handleCtrlZ(): void;
     handleDequeue(): void;
-    handleBackgroundCommand(): void;
     handleImagePaste(): Promise<boolean>;
     handleBtwCommand(question: string): Promise<void>;
+    handleTanCommand(work: string): Promise<void>;
     hasActiveBtw(): boolean;
     handleBtwEscape(): boolean;
     handleOmfgCommand(complaint: string): Promise<void>;

package/dist/types/modes/utils/copy-targets.d.ts

@@ -6,6 +6,17 @@ export interface CodeBlock {
     /** Block body with the trailing newline stripped. */
     code: string;
 }
+/** A blockquote block: a maximal run of `>`-prefixed lines from markdown. */
+export interface QuoteBlock {
+    /** Block body with each line's `>` marker (and one optional space) removed. */
+    text: string;
+}
+/** A drillable block within an assistant message, in document order. */
+export type MessageBlock = ({
+    kind: "code";
+} & CodeBlock) | ({
+    kind: "quote";
+} & QuoteBlock);
 /** A runnable command found in the transcript. */
 export interface LastCommand {
     kind: "bash" | "eval";
@@ -19,7 +30,7 @@ export interface LastCommand {
  * `children` to drill into.
  */
 export interface CopyTarget {
-    /** Stable identifier (e.g. "msg:1", "msg:1:code:0", "msg:1:all", "cmd:1"). */
+    /** Stable id (e.g. "msg:1", "msg:1:code:0", "msg:1:quote:0", "msg:1:all", "cmd:1"). */
     id: string;
     label: string;
     /** Dim annotation: line/block counts, language, or tool name. */
@@ -40,8 +51,17 @@ export interface CopySource {
     readonly messages: readonly AgentMessage[];
     getLastVisibleHandoffText(): string | undefined;
 }
+/**
+ * Split assistant markdown into drillable blocks — fenced code and `>`-quoted
+ * runs — in document order. Fences mask their bodies, so a `>` line inside a
+ * code block is never mistaken for a quote. An unclosed fence is treated as
+ * ordinary text, matching the fenced-block grammar.
+ */
+export declare function extractBlocks(text: string): MessageBlock[];
 /** Extract fenced code blocks from assistant markdown, in document order. */
 export declare function extractCodeBlocks(text: string): CodeBlock[];
+/** Extract `>`-quoted blocks from assistant markdown, in document order. */
+export declare function extractQuoteBlocks(text: string): QuoteBlock[];
 /** Walk the transcript backwards for the most recent bash command or eval code. */
 export declare function extractLastCommand(messages: readonly AgentMessage[]): LastCommand | undefined;
 /**

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

@@ -1,14 +1,14 @@
 import { type KeywordHighlighter } from "./gradient-highlight";
-/** Hidden system notice appended after a user message that mentions "workflow". */
+/** Hidden system notice appended after a user message that mentions "workflowz". */
 export declare const WORKFLOW_NOTICE: string;
 /**
- * Whether `text` contains the standalone keyword "workflow"/"workflows"
+ * Whether `text` contains the standalone keyword "workflowz"
  * (lowercase, whitespace-delimited) in prose — never inside a code block, inline
  * code span, or XML/HTML section.
  */
 export declare function containsWorkflow(text: string): boolean;
 /**
- * Highlight every standalone "workflow"/"workflows" in `text` for editor display
+ * Highlight every standalone "workflowz" in `text` for editor display
  * with a warm amber→green gradient (hue 30..150), visually distinct from
  * ultrathink's rainbow and orchestrate's teal→violet.
  */

package/dist/types/plan-mode/approved-plan.d.ts

@@ -1,9 +1,10 @@
 /** Shape forwarded from the plan-mode resolve handler to InteractiveMode's
  *  approval popup. Populated by the standing handler that the resolve tool
- *  dispatches to when the agent submits `resolve { action: "apply" }`. */
+ *  dispatches to when the agent submits `resolve { action: "apply" }`.
+ *  `planFilePath` is the agent-chosen `local://<slug>-plan.md` artifact — it is
+ *  never renamed on approval, so links to it stay valid for the session. */
 export interface PlanApprovalDetails {
     planFilePath: string;
-    finalPlanFilePath: string;
     title: string;
     planExists: boolean;
 }
@@ -39,11 +40,29 @@ export declare function resolvePlanTitle(input: {
  *  Replaces `-`/`_` separators with spaces and capitalizes the first letter.
  *  Returns an empty string when the input collapses to whitespace. */
 export declare function humanizePlanTitle(title: string): string;
-interface RenameApprovedPlanFileOptions {
+/** The `local://` URL a plan slug maps to. The agent writes the plan here and
+ *  passes the slug to `resolve`; the file is never renamed, so this URL — and
+ *  any hyperlink to it — stays valid for the life of the session. */
+export declare function planFileUrlForSlug(slug: string): string;
+export interface ResolveApprovedPlanInput {
+    /** The agent's `extra.title` from the `resolve` call, if any. */
+    suppliedTitle?: unknown;
+    /** The plan path recorded in plan-mode state (the entry default or a prior plan). */
+    statePlanFilePath: string;
+    /** Read a plan `local://` URL, returning null when the file does not exist. */
+    readPlan: (planUrl: string) => Promise<string | null>;
+    /** Optional fallback: list candidate plan `local://` URLs (newest first) so a
+     *  plan whose name can't be reconstructed (e.g. a dropped `extra.title`) is
+     *  still found. */
+    listPlanFiles?: () => Promise<string[]>;
+}
+export interface ResolvedApprovedPlan {
     planFilePath: string;
-    finalPlanFilePath: string;
-    getArtifactsDir: () => string | null;
-    getSessionId: () => string | null;
+    planContent: string;
+    title: string;
 }
-export declare function renameApprovedPlanFile(options: RenameApprovedPlanFileOptions): Promise<void>;
-export {};
+/** Locate the plan file the agent wrote and finalize its title — without
+ *  renaming anything. Tries, in order: the slug derived from `extra.title`
+ *  (`local://<slug>-plan.md`), the plan path from plan-mode state, then a scan
+ *  of recent plan files. Throws a `ToolError` guiding the agent when none exist. */
+export declare function resolveApprovedPlan(input: ResolveApprovedPlanInput): Promise<ResolvedApprovedPlan>;

package/dist/types/plan-mode/plan-protection.d.ts

@@ -3,10 +3,10 @@ import { type ProtectedToolContext } from "@oh-my-pi/pi-agent-core/compaction/to
  * Build a compaction protection matcher that keeps `read` results for the active
  * plan file intact through prune/shake — the plan analog of skill-read
  * protection. Matches both the canonical `local://PLAN.md` alias and the
- * session's current plan reference path (e.g. a titled `local://<title>.md`), so
- * the plan survives compaction whether the agent reads it by alias or by title.
+ * session's current plan reference path (the agent-chosen `local://<slug>-plan.md`),
+ * so the plan survives compaction whether the agent reads it by alias or by name.
  *
- * `getPlanReferencePath` is evaluated at match time so a mid-session retitle
- * (plan approval renames `PLAN.md` → `<title>.md`) is honored immediately.
+ * `getPlanReferencePath` is evaluated at match time so the plan path set on
+ * approval is honored immediately.
  */
 export declare function createPlanReadMatcher(getPlanReferencePath: () => string): (context: ProtectedToolContext) => boolean;

package/dist/types/sdk.d.ts

@@ -51,6 +51,8 @@ export interface CreateAgentSessionOptions {
     /** Optional provider-facing session identifier for prompt caches and sticky auth selection.
      * Keeps persisted session files isolated while reusing provider-side caches. */
     providerSessionId?: string;
+    /** Optional provider-facing prompt cache key, distinct from request lineage. */
+    providerPromptCacheKey?: string;
     /** Custom tools to register (in addition to built-in tools). Accepts both CustomTool and ToolDefinition. */
     customTools?: (CustomTool | ToolDefinition)[];
     /** Inline extensions (merged with discovery). */

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

@@ -294,6 +294,11 @@ export interface SessionStats {
     premiumRequests: number;
     cost: number;
 }
+export interface FreshSessionResult {
+    previousSessionId: string;
+    sessionId: string;
+    closedProviderSessions: number;
+}
 export declare const ANTHROPIC_TOOL_CALL_BATCH_CAP = 4;
 export declare function resolveToolCallBatchCapForModel(model: Model | undefined): number | undefined;
 export declare class AgentSession {
@@ -308,6 +313,8 @@ export declare class AgentSession {
     constructor(config: AgentSessionConfig);
     /** Model registry for API key resolution and model discovery */
     get modelRegistry(): ModelRegistry;
+    get asyncJobManager(): AsyncJobManager | undefined;
+    getAgentId(): string | undefined;
     /** Advance the tool-choice queue and return the next directive for the upcoming LLM call. */
     nextToolChoice(): ToolChoice | undefined;
     /**
@@ -378,6 +385,7 @@ export declare class AgentSession {
      * Call this when completely done with the session.
      */
     dispose(): Promise<void>;
+    freshSession(): FreshSessionResult | undefined;
     /** Full agent state */
     get state(): AgentState;
     /** Current model (may be undefined if not yet selected) */
@@ -609,9 +617,22 @@ export declare class AgentSession {
     setTodoPhases(phases: TodoPhase[]): void;
     /**
      * Abort current operation and wait for agent to become idle.
+     *
+     * `reason` (e.g. `USER_INTERRUPT_LABEL`) rides the agent's `AbortController`
+     * and surfaces verbatim on the aborted assistant message's `errorMessage`, so
+     * the transcript can distinguish a deliberate user interrupt from an opaque
+     * abort. Omit it for internal/lifecycle aborts.
      */
     abort(options?: {
         goalReason?: "interrupted" | "internal";
+        reason?: string;
+    }): Promise<void>;
+    /**
+     * Abort active work, then immediately resume the agent so queued steer/follow-up
+     * messages drain instead of waiting for another natural turn boundary.
+     */
+    interruptAndFlushQueuedMessages(options?: {
+        reason?: string;
     }): Promise<void>;
     /**
      * Start a new session, optionally with initial messages and parent tracking.

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

@@ -2,5 +2,5 @@
  * Re-exports from @oh-my-pi/pi-ai.
  * All credential storage types and the AuthStorage class now live in the ai package.
  */
-export type { ApiKeyCredential, AuthCredential, AuthCredentialEntry, AuthCredentialStore, AuthStorageData, AuthStorageOptions, OAuthCredential, SerializedAuthStorage, SnapshotResponse, StoredAuthCredential, } from "@oh-my-pi/pi-ai";
+export type { ApiKeyCredential, AuthCredential, AuthCredentialEntry, AuthCredentialStore, AuthStorageData, AuthStorageOptions, CredentialOrigin, CredentialOriginKind, OAuthCredential, SerializedAuthStorage, SnapshotResponse, StoredAuthCredential, } from "@oh-my-pi/pi-ai";
 export { AuthBrokerClient, AuthStorage, DEFAULT_SNAPSHOT_CACHE_TTL_MS, REMOTE_REFRESH_SENTINEL, RemoteAuthCredentialStore, readAuthBrokerSnapshotCache, SqliteAuthCredentialStore, writeAuthBrokerSnapshotCache, } from "@oh-my-pi/pi-ai";

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

@@ -40,6 +40,18 @@ export declare const SILENT_ABORT_MARKER = "__omp.silent_abort__";
  *  than string-comparing inline so refactors to the marker constant (e.g.,
  *  namespacing changes) propagate through every consumer in lockstep. */
 export declare function isSilentAbort(errorMessage: string | undefined): boolean;
+/** Reason threaded through `AbortController.abort(reason)` when the user aborts
+ *  the turn with Esc (see `AgentSession.abort`). The agent surfaces it verbatim
+ *  on the aborted assistant message's `errorMessage`, so the transcript reads as
+ *  a deliberate user interrupt instead of an opaque failure. */
+export declare const USER_INTERRUPT_LABEL = "Interrupted by user";
+/** Resolve the operator-facing label for an aborted assistant turn. A custom
+ *  abort reason (e.g. `USER_INTERRUPT_LABEL`) threaded onto `errorMessage` is
+ *  shown verbatim; aborts with no threaded reason fall back to the retry-aware
+ *  generic label. Centralizes the live-stream (`EventController`), replay
+ *  (`ui-helpers`), and component (`AssistantMessageComponent`) render paths so
+ *  they stay in lockstep. */
+export declare function resolveAbortLabel(errorMessage: string | undefined, retryAttempt?: number): string;
 /** Extract the optional `__pendingDisplayTag` field from a CustomMessage's
  *  `details` blob. Safe over `unknown`; returns undefined when the field is
  *  absent or non-string. */

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

@@ -317,9 +317,11 @@ export declare class SessionManager {
     /**
      * Move the session to a new working directory.
      * Moves session files and artifacts on disk, updates all internal references,
-     * and rewrites the session header with the new cwd.
+     * and rewrites the session header with the new cwd. When provided,
+     * `targetSessionDir` is used instead of deriving the default directory for
+     * the new cwd (for `--continue --session-dir` / `--resume --session-dir`).
      */
-    moveTo(newCwd: string): Promise<void>;
+    moveTo(newCwd: string, targetSessionDir?: string): Promise<void>;
     isPersisted(): boolean;
     /**
      * Force-persist all current entries to disk, even when no assistant message exists yet.
@@ -407,6 +409,7 @@ export declare class SessionManager {
     /** The source that set the session name: "user" (manual /rename or RPC) or "auto" (generated title). */
     get titleSource(): "auto" | "user" | undefined;
     getSessionName(): string | undefined;
+    onSessionNameChanged(cb: () => void): () => void;
     /**
      * Set the session display name.
      * @param source - "user" for explicit renames (/rename command, RPC); "auto" for generated titles.
@@ -565,7 +568,9 @@ export declare class SessionManager {
      * Fork a session into the current project directory.
      * Copies history from another session file while creating a new session file in the current sessionDir.
      */
-    static forkFrom(sourcePath: string, cwd: string, sessionDir?: string, storage?: SessionStorage): Promise<SessionManager>;
+    static forkFrom(sourcePath: string, cwd: string, sessionDir?: string, storage?: SessionStorage, options?: {
+        suppressBreadcrumb?: boolean;
+    }): Promise<SessionManager>;
     /**
      * Open a specific session file.
      * @param path Path to session file

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

@@ -69,15 +69,13 @@ export interface SlashCommandRuntime {
 }
 /**
  * Runtime visible to TUI-only handlers (`handleTui`). Carries the interactive
- * mode context plus the background-detach hook. Intentionally narrower than
- * `SlashCommandRuntime` so existing callers can keep building it from just
- * `{ ctx, handleBackgroundCommand }`; when the TUI dispatcher needs to invoke
- * a `handle` (no `handleTui` override), it synthesizes a `SlashCommandRuntime`
- * from `ctx`.
+ * mode context. Intentionally narrower than `SlashCommandRuntime` so existing
+ * callers can keep building it from just `{ ctx }`; when the TUI dispatcher
+ * needs to invoke a `handle` (no `handleTui` override), it synthesizes a
+ * `SlashCommandRuntime` from `ctx`.
  */
 export interface TuiSlashCommandRuntime {
     ctx: InteractiveModeContext;
-    handleBackgroundCommand: () => void;
 }
 /** Unified slash-command spec consumed by both TUI and ACP dispatchers. */
 export interface SlashCommandSpec extends BuiltinSlashCommand {

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

@@ -7,6 +7,8 @@ import type { AgentTelemetryConfig, ThinkingLevel } from "@oh-my-pi/pi-agent-cor
 import { ModelRegistry } from "../config/model-registry";
 import type { PromptTemplate } from "../config/prompt-templates";
 import { Settings } from "../config/settings";
+import { type SettingPath } from "../config/settings-schema";
+import type { CustomTool } from "../extensibility/custom-tools/types";
 import { type Skill } from "../extensibility/skills";
 import type { HindsightSessionState } from "../hindsight/state";
 import type { LocalProtocolOptions } from "../internal-urls";
@@ -100,6 +102,15 @@ export interface YieldItem {
     data?: unknown;
     status?: "success" | "aborted";
     error?: string;
+    /**
+     * Set by the in-tool yield validator when it exhausted its retry budget
+     * (MAX_SCHEMA_RETRIES) and accepted a schema-invalid payload anyway.
+     * `finalizeSubprocessOutput` honors this by serializing the payload and
+     * surfacing a stderr warning, instead of re-emitting `schema_violation`
+     * — which would silently swap the subagent's "accepted" view for a
+     * different, opaque error blob in the parent's view of the result.
+     */
+    schemaOverridden?: boolean;
 }
 interface FinalizeSubprocessOutputArgs {
     rawOutput: string;
@@ -118,9 +129,15 @@ interface FinalizeSubprocessOutputResult {
     abortedViaYield: boolean;
     hasYield: boolean;
 }
+export declare const SUBAGENT_WARNING_SCHEMA_OVERRIDDEN = "SYSTEM WARNING: Subagent exhausted schema-retry budget; result was accepted despite failing the output schema.";
 export declare const SUBAGENT_WARNING_NULL_YIELD = "SYSTEM WARNING: Subagent called yield with null data.";
 export declare const SUBAGENT_WARNING_MISSING_YIELD = "SYSTEM WARNING: Subagent exited without calling yield tool after 3 reminders.";
 export declare function finalizeSubprocessOutput(args: FinalizeSubprocessOutputArgs): FinalizeSubprocessOutputResult;
+/**
+ * Create proxy tools that reuse the parent's MCP connections.
+ */
+export declare function createMCPProxyTools(mcpManager: MCPManager): CustomTool[];
+export declare function createSubagentSettings(baseSettings: Settings, overrides?: Partial<Record<SettingPath, unknown>>): Settings;
 /**
  * Run a single agent in-process.
  */

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

@@ -29,6 +29,7 @@ export declare class TaskTool implements AgentTool<TaskToolSchemaInstance, TaskT
     readonly strict = true;
     readonly loadMode = "discoverable";
     readonly renderResult: typeof renderResult;
+    readonly mergeCallAndResult = true;
     get parameters(): TaskToolSchemaInstance;
     renderCall(args: unknown, options: Parameters<typeof renderTaskCall>[1], theme: Theme): import("@oh-my-pi/pi-tui").Component;
     /** Dynamic description that reflects current disabled-agent settings */

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

@@ -1,6 +1,6 @@
 import type { Component } from "@oh-my-pi/pi-tui";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
-import type { Theme } from "../modes/theme/theme";
+import { type Theme } from "../modes/theme/theme";
 import type { TaskParams, TaskToolDetails } from "./types";
 /**
  * Render the tool call arguments.
@@ -19,8 +19,9 @@ export declare function renderResult(result: {
         text?: string;
     }>;
     details?: TaskToolDetails;
-}, options: RenderResultOptions, theme: Theme): Component;
+}, options: RenderResultOptions, theme: Theme, args?: TaskParams): Component;
 export declare const taskToolRenderer: {
     renderCall: typeof renderCall;
     renderResult: typeof renderResult;
+    mergeCallAndResult: boolean;
 };

package/dist/types/tools/archive-reader.d.ts

@@ -31,6 +31,8 @@ type EntryStorage = TarStorage | ZipStorage;
 interface ArchiveIndexEntry extends ArchiveNode {
     storage?: EntryStorage;
 }
+export declare function formatArchiveEntryLines(entries: readonly ArchiveDirectoryEntry[]): string[];
+export declare function sniffArchiveFormat(bytes: Uint8Array): ArchiveFormat | undefined;
 export declare function parseArchivePathCandidates(filePath: string): ArchivePathCandidate[];
 export declare class ArchiveReader {
     #private;
@@ -41,4 +43,7 @@ export declare class ArchiveReader {
     readFile(subPath: string): Promise<ExtractedArchiveFile>;
 }
 export declare function openArchive(filePath: string): Promise<ArchiveReader>;
+export declare function listArchiveRoot(bytes: Uint8Array, format: ArchiveFormat, opts?: {
+    limit?: number;
+}): Promise<string>;
 export {};

package/dist/types/tools/ast-edit.d.ts

@@ -34,6 +34,9 @@ export interface AstEditToolDetails {
     /** Absolute base directory used during the edit. Used by the renderer to resolve
      * display-relative paths to absolute paths for OSC 8 hyperlinks. */
     searchPath?: string;
+    /** Session cwd at edit time. Display header paths are cwd-relative, so the
+     * renderer resolves them against this; `searchPath` is the scope target. */
+    cwd?: string;
 }
 export declare class AstEditTool implements AgentTool<typeof astEditSchema, AstEditToolDetails> {
     private readonly session;

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

@@ -31,6 +31,9 @@ export interface AstGrepToolDetails {
     /** Absolute base directory used during search. Used by the renderer to resolve
      * display-relative paths to absolute paths for OSC 8 hyperlinks. */
     searchPath?: string;
+    /** Session cwd at search time. Display header/match paths are cwd-relative, so
+     * the renderer resolves them against this; `searchPath` is the scope target. */
+    cwd?: string;
 }
 export declare class AstGrepTool implements AgentTool<typeof astGrepSchema, AstGrepToolDetails> {
     private readonly session;

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

@@ -99,6 +99,7 @@ export interface ShellRendererConfig<TArgs> {
     resolveCommand?: (args: TArgs | undefined) => string | undefined;
     resolveCwd?: (args: TArgs | undefined) => string | undefined;
     resolveEnv?: (args: TArgs | undefined) => Record<string, string> | undefined;
+    showHeader?: boolean;
 }
 export declare function getBashEnvForDisplay(args: BashRenderArgs): Record<string, string> | undefined;
 /**

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

@@ -42,6 +42,14 @@ export type EvalProxyExecutor = (params: EvalToolParams, signal?: AbortSignal) =
 export interface EvalToolDescriptionOptions {
     py?: boolean;
     js?: boolean;
+    /**
+     * Whether `agent()` is allowed in this session. Driven by the parent's
+     * spawn policy (`getSessionSpawns`). Defaults to `true` for backward
+     * compatibility — when the session forbids spawning, the prelude doc
+     * omits the `agent()` entry so the model does not promise itself a
+     * helper that will only ever throw "spawns disabled".
+     */
+    spawns?: boolean;
 }
 export declare function getEvalToolDescription(options?: EvalToolDescriptionOptions): string;
 export interface EvalToolOptions {

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

@@ -15,10 +15,14 @@ declare const findSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type FindToolInput = z.infer<typeof findSchema>;
 /**
- * Group find matches by their directory so the model doesn't pay repeated
- * tokens for shared path prefixes. Preserves the input order: groups appear in
- * the order their first member was emitted (mtime-desc for native glob), and
- * within a group entries keep their relative order.
+ * Group find matches into a multi-level directory tree so the model doesn't pay
+ * repeated tokens for shared path prefixes. Single-child directory chains fold
+ * into one header (`# a/b/c/`), so a common prefix — including an absolute root
+ * for out-of-cwd results — collapses to a single line. Each level adds one `#`;
+ * files are listed bare under the deepest directory header that owns them.
+ *
+ * Order follows the input (mtime-desc for native glob): a directory appears when
+ * its first member is emitted, and a node's own files precede its subdirectories.
  */
 export declare function formatFindGroupedOutput(paths: readonly string[]): string;
 export interface FindToolDetails {

package/dist/types/tools/gh-cache-invalidation.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Drop `github-cache` rows for any `gh issue|pr <mutating-subcmd>` call
+ * embedded in `command`. Safe to invoke unconditionally; no-op when the
+ * command does not touch GitHub state.
+ */
+export declare function invalidateGithubCacheForBashCommand(command: string): void;

package/dist/types/tools/github-cache.d.ts

@@ -55,6 +55,18 @@ export interface PutCachedInput<T = unknown> {
 export declare function putCached<T = unknown>(input: PutCachedInput<T>): void;
 /** Drop a specific cache entry. */
 export declare function invalidate(repo: string, kind: CacheKind, number: number, includeComments?: boolean, authKey?: string): void;
+/**
+ * Drop every cached row for a given issue/PR number, regardless of repo,
+ * auth key, include_comments flag, or row kind ({@link CacheKind}). Best-effort:
+ * swallows DB failures the same way {@link invalidate} does.
+ *
+ * Used by the bash-side detector that reacts to `gh issue close` / `gh pr merge`
+ * style mutations. Repo + auth-key narrowing is intentionally skipped because
+ * the bash command often does not name the repo (defaults to cwd's `gh`
+ * config) and resolving the *current* repo from `cwd` for every bash call would
+ * be far more expensive than a write-amplified DELETE.
+ */
+export declare function invalidateAllForNumber(number: number, repo?: string): void;
 /** Drop every cached row. Test helper. */
 export declare function clearAll(): void;
 /**