@oh-my-pi/pi-coding-agent 17.2.13 → 17.2.15

package/dist/types/cleanse/agent.d.ts

@@ -1,3 +1,4 @@
+import type { CustomCleanseCheckerSpec } from "./checkers.js";
 import type { CleanseAgentOutcome, CleanseAssignment, CleanseDiagnosticReport, CleanseLoopResult } from "./types.js";
 /** Hooks used by the standalone command to render subagent lifecycle progress. */
 export interface CleanseAgentHooks {
@@ -8,6 +9,8 @@ export interface CleanseAgentHooks {
 export interface CleanseAgentRuntime {
     readonly model: string;
     readonly sessionFile: string;
+    /** Run one discovery subagent that translates a user request into runnable checker specs. */
+    discoverCheckers(request: string, signal?: AbortSignal): Promise<CustomCleanseCheckerSpec[]>;
     dispatch(assignments: CleanseAssignment[], wave: number, report: CleanseDiagnosticReport, signal?: AbortSignal): Promise<CleanseAgentOutcome[]>;
     close(result?: CleanseLoopResult): Promise<void>;
 }

package/dist/types/cleanse/checkers.d.ts

@@ -3,11 +3,31 @@ import type { CleanseDiagnosticReport, SkippedCleanseCheck } from "./types.js";
 export interface CleanseDiagnosticSuiteOptions {
     includeTests?: boolean;
 }
+/** Identity and display metadata for one runnable checker. */
+export interface CleanseCheckerDescriptor {
+    id: string;
+    label: string;
+    language: string;
+    command: string;
+}
 /** Re-runnable checker set discovered from one project snapshot. */
 export interface CleanseDiagnosticSuite {
-    readonly checkCount: number;
+    /** Every discovered checker; unaffected by {@link CleanseDiagnosticSuite.select}. */
+    readonly checkers: readonly CleanseCheckerDescriptor[];
     readonly skipped: readonly SkippedCleanseCheck[];
+    /** Narrow subsequent {@link CleanseDiagnosticSuite.run} calls to the named checker ids. */
+    select(ids: readonly string[]): void;
     run(signal?: AbortSignal): Promise<CleanseDiagnosticReport>;
 }
 /** Discover configured language checkers without installing missing tools. */
 export declare function discoverCleanseDiagnosticSuite(projectCwd: string, options?: CleanseDiagnosticSuiteOptions): Promise<CleanseDiagnosticSuite>;
+/** One checker proposed by the prompted discovery agent. */
+export interface CustomCleanseCheckerSpec {
+    label: string;
+    language?: string;
+    cwd?: string;
+    command: string[];
+    parser?: string;
+}
+/** Build a runnable suite from discovery-agent checker specs, dropping unrunnable entries into `skipped`. */
+export declare function buildCustomCleanseSuite(projectCwd: string, specs: readonly CustomCleanseCheckerSpec[]): Promise<CleanseDiagnosticSuite>;

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

@@ -4,6 +4,10 @@ export interface CleanseCommandOptions {
     maxAgents?: number;
     model?: string;
     includeTests?: boolean;
+    /** Free-form description handed to a discovery agent instead of built-in checker discovery. */
+    request?: string;
+    /** Run every discovered checker without the interactive picker. */
+    all?: boolean;
 }
 /** Observable completion state returned to the CLI adapter. */
 export interface CleanseCommandResult {

package/dist/types/cleanse/parsers.d.ts

@@ -1,6 +1,8 @@
 import type { CleanseDiagnostic } from "./types.js";
 /** Machine and fallback output formats understood by cleanse. */
-export type CleanseParserKind = "rust" | "rust-test" | "go" | "go-test" | "ruff" | "pyright" | "eslint" | "biome" | "rubocop" | "phpstan" | "psalm" | "swiftlint" | "dart" | "credo" | "shellcheck" | "hlint" | "terraform" | "tflint" | "generic";
+export declare const CLEANSE_PARSER_KINDS: readonly ["rust", "rust-test", "go", "go-test", "staticcheck", "golangci", "ruff", "pyright", "mypy", "pylint", "flake8", "ty", "eslint", "biome", "oxlint", "deno-lint", "stylelint", "rubocop", "phpstan", "psalm", "swiftlint", "dart", "credo", "shellcheck", "hlint", "terraform", "tflint", "actionlint", "generic"];
+/** One machine or fallback output format understood by cleanse. */
+export type CleanseParserKind = (typeof CLEANSE_PARSER_KINDS)[number];
 /** Captured checker process output passed to a format parser. */
 export interface CleanseParserInput {
     checker: string;

package/dist/types/cli/args.d.ts

@@ -29,6 +29,7 @@ export interface Args {
     serviceTier?: ServiceTierOpenAISettingValue;
     hideThinking?: boolean;
     advisor?: boolean;
+    externalThinking?: boolean;
     continue?: boolean;
     resume?: string | true;
     fromClaude?: boolean;

package/dist/types/cli/cleanse-picker.d.ts

@@ -0,0 +1,17 @@
+import type { CleanseCheckerDescriptor } from "../cleanse/checkers.js";
+/** Outcome of the interactive cleanse target picker. */
+export type CleanseTargetChoice = {
+    kind: "all";
+} | {
+    kind: "checker";
+    id: string;
+} | {
+    kind: "request";
+    request: string;
+} | {
+    kind: "cancel";
+};
+/** Pick between running every discovered checker, one specific checker, or a free-form request. */
+export declare function pickCleanseTarget(checkers: readonly CleanseCheckerDescriptor[]): Promise<CleanseTargetChoice>;
+/** One-shot text prompt for a free-form cleanse request; `null` when cancelled or left empty. */
+export declare function promptCleanseRequest(): Promise<string | null>;

package/dist/types/cli/command-help.d.ts

@@ -28,6 +28,9 @@ export declare const completionsHelp: {
 export declare const completeHelp: {
     hidden: true;
 };
+export declare const compressHelp: {
+    description: string;
+};
 export declare const configHelp: {
     description: string;
 };

package/dist/types/cli/progress-reporter.d.ts

@@ -0,0 +1,19 @@
+/** Minimal output contract used by the interactive progress reporter. */
+export interface ProgressOutput {
+    isTTY?: boolean;
+    write(text: string): boolean;
+}
+/** Renders completed units of work on one transient terminal line. */
+export interface ProgressReporter {
+    readonly interactive: boolean;
+    start(total: number): void;
+    complete(): void;
+    finish(): void;
+}
+/**
+ * Create a TTY-only completion bar labelled `label`, e.g. `Repairing [████░░░░] 4/8`.
+ *
+ * Non-interactive output disables rendering entirely, so callers can print plain
+ * per-item lines instead by checking {@link ProgressReporter.interactive}.
+ */
+export declare function createProgressReporter(label: string, output?: ProgressOutput): ProgressReporter;

package/dist/types/commands/cleanse.d.ts

@@ -1,6 +1,12 @@
 import { Command } from "@oh-my-pi/pi-utils/cli";
 export default class Cleanse extends Command {
     static description: string;
+    static args: {
+        request: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+        };
+    };
     static flags: {
         agents: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
             char: string;
@@ -17,6 +23,11 @@ export default class Cleanse extends Command {
             description: string;
             default: boolean;
         };
+        all: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+            default: boolean;
+        };
     };
     static examples: string[];
     run(): Promise<void>;

package/dist/types/commands/compress.d.ts

@@ -0,0 +1,37 @@
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Compress extends Command {
+    static description: string;
+    static args: {
+        files: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: true;
+            multiple: true;
+        };
+    };
+    static flags: {
+        out: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            char: string;
+            description: string;
+        };
+        inPlace: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+        };
+        rounds: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            char: string;
+            description: string;
+            default: number;
+        };
+        agents: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            char: string;
+            description: string;
+            default: number;
+        };
+        model: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            char: string;
+            description: string;
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/types/commands/launch-help.d.ts

@@ -125,6 +125,9 @@ export declare const launchHelp: {
         advisor: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
             description: string;
         };
+        "external-thinking": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
         hook: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
             description: string;
             multiple: true;

package/dist/types/commands/launch.d.ts

@@ -129,6 +129,9 @@ export default class Index extends Command {
         advisor: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
             description: string;
         };
+        "external-thinking": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
         hook: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
             description: string;
             multiple: true;

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

@@ -0,0 +1,27 @@
+import type { CompressResult } from "./types.js";
+/** User-facing options for `omp compress`. */
+export interface CompressCommandOptions {
+    /** Files and glob patterns to compress. */
+    files: string[];
+    /** Model selector; defaults to the configured session model. */
+    model?: string;
+    /** Maximum drafts per file before that file gives up unapproved. Default 3. */
+    maxRounds?: number;
+    /** Concurrent files. Default 4. */
+    concurrency?: number;
+    /** Write the approved text here instead of stdout. Single file only. */
+    output?: string;
+    /** Overwrite each source file with its approved text. */
+    inPlace?: boolean;
+}
+/**
+ * Expand `patterns` into a deduplicated, sorted list of absolute file paths.
+ *
+ * Entries containing glob metacharacters are matched against `cwd`; everything else is
+ * treated as a literal path so filenames containing brackets still resolve. Throws when
+ * a literal path is missing or a pattern matches nothing, since silently compressing
+ * fewer files than asked is worse than failing.
+ */
+export declare function resolveCompressTargets(patterns: readonly string[], cwd: string): Promise<string[]>;
+/** Compress every requested file through the rewrite/approve loop. */
+export declare function runCompressCommand(options: CompressCommandOptions): Promise<CompressResult>;

package/dist/types/compress/protocol.d.ts

@@ -0,0 +1,49 @@
+import type { ToolDefinition } from "../extensibility/extensions/index.js";
+import type { CompressDraft, CompressLoss, CompressMetrics } from "./types.js";
+/** Transcript details for one `rewrite` call. */
+export interface RewriteDetails {
+    round: number;
+    draftTokens: number;
+    losses: number;
+}
+/** Transcript details for one `approve` call. */
+export interface ApproveDetails {
+    round: number;
+}
+/** Draft ledger shared by the protocol tools and the command loop. */
+export declare class CompressProtocol {
+    #private;
+    constructor(source: string);
+    /** Newest submitted draft, or undefined before the first `rewrite`. */
+    get latest(): CompressDraft | undefined;
+    /** True once `approve` accepted the newest draft. */
+    get approved(): boolean;
+    /** The agent's stated reason for accepting the final draft. */
+    get verdict(): string | undefined;
+    /** Number of drafts submitted so far. */
+    get rounds(): number;
+    /** Words in the source text. */
+    get sourceWords(): number;
+    /** Tokens in the source text. */
+    get sourceTokens(): number;
+    /** Size of `draft` against the source. */
+    metrics(draft: CompressDraft): CompressMetrics;
+    /** Record that the command has shown `round` back to the agent for a verdict. */
+    markReviewed(round: number): void;
+    /**
+     * Record a draft and return it. Supersedes any prior approval, so an accepted
+     * draft cannot be silently replaced by a later one.
+     */
+    submit(text: string, losses: readonly CompressLoss[]): CompressDraft;
+    /**
+     * Accept the newest draft and return it.
+     *
+     * Throws when no draft exists, or when the newest draft has not been shown back
+     * to the agent for a verdict — approval is only meaningful after that review.
+     */
+    accept(verdict: string): CompressDraft;
+    /** Tool that records a draft. Thin adapter over {@link submit}. */
+    rewriteTool(): ToolDefinition;
+    /** Tool that accepts the newest reviewed draft. Thin adapter over {@link accept}. */
+    approveTool(): ToolDefinition;
+}

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

@@ -0,0 +1,15 @@
+import type { AgentSession } from "../session/agent-session.js";
+import type { CompressProtocol } from "./protocol.js";
+/** A live compress session plus the resolved model label used in reporting. */
+export interface CompressSession {
+    session: AgentSession;
+    model: string;
+}
+/** Resolve the requested model and open a session restricted to the two protocol tools. */
+export declare function createCompressSession(options: {
+    cwd?: string;
+    model?: string;
+    protocol: CompressProtocol;
+    /** Distinct per concurrent session; agent ids must be unique within a process. */
+    agentId?: string;
+}): Promise<CompressSession>;

package/dist/types/compress/types.d.ts

@@ -0,0 +1,54 @@
+/** One piece of source content a draft knowingly does not carry over. */
+export interface CompressLoss {
+    /** The dropped content, quoted from the source or described precisely. */
+    content: string;
+    /** Why the draft is still correct without it. */
+    reason: string;
+}
+/** One submitted compression attempt. */
+export interface CompressDraft {
+    /** 1-based submission counter. */
+    round: number;
+    /** Complete compressed text, ready to ship as-is. */
+    text: string;
+    /** Everything the agent declared it dropped, possibly empty. */
+    losses: CompressLoss[];
+}
+/** Measured size of a draft against its source. */
+export interface CompressMetrics {
+    sourceWords: number;
+    draftWords: number;
+    sourceTokens: number;
+    draftTokens: number;
+    /** Token reduction as a fraction of the source; negative when a draft grew. */
+    ratio: number;
+}
+/** Why a run ended. `stalled` means the agent neither resubmitted nor approved. */
+export type CompressStatus = "approved" | "unapproved" | "stalled" | "cancelled";
+/** Observable completion state for one compressed file. */
+export interface CompressFileResult {
+    /** Absolute path of the source file. */
+    path: string;
+    status: CompressStatus;
+    /** Newest draft, present whenever `rewrite` was called at least once. */
+    draft?: CompressDraft;
+    metrics?: CompressMetrics;
+    /** The agent's stated reason for accepting the final draft. */
+    verdict?: string;
+    /** Number of drafts submitted. */
+    rounds: number;
+    /** Where the approved text was written; absent when it went to stdout. */
+    outputPath?: string;
+    sessionFile?: string;
+    /** Set when the file could not be processed at all (unreadable, session failure). */
+    error?: string;
+}
+/** Aggregate result returned to the CLI adapter. */
+export interface CompressResult {
+    exitCode: number;
+    files: CompressFileResult[];
+    /** Source tokens across every file that produced a draft. */
+    sourceTokens: number;
+    /** Draft tokens across every file that produced a draft. */
+    draftTokens: number;
+}

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

@@ -1026,6 +1026,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Instruct upstream providers to completely omit thinking summaries from responses (where supported)";
         };
     };
+    readonly externalThinking: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Thinking";
+            readonly label: "External Thinking";
+            readonly description: "Private scratchpad; not shown to user. Disables supported GPT, Claude, and Gemini reasoning";
+        };
+    };
     readonly "model.loopGuard.enabled": {
         readonly type: "boolean";
         readonly default: true;

package/dist/types/internal-urls/local-protocol.d.ts

@@ -5,6 +5,14 @@ export interface LocalProtocolOptions {
 }
 /** Resolve the session-scoped local:// root, shortening long Windows artifact paths before writes hit MAX_PATH. */
 export declare function resolveLocalRoot(options: LocalProtocolOptions, platform?: NodeJS.Platform): string;
+/**
+ * Recursively copy every local:// artifact from one session-scoped root to
+ * another. Used when a session transition mints a fresh local root (plan
+ * approve-and-execute, handoff) so plans, scratch files, and research notes the
+ * carried-forward context references stay readable in the replacement session.
+ * No-op when the roots match or the source root is absent.
+ */
+export declare function copyLocalArtifacts(sourceRoot: string, destinationRoot: string): Promise<void>;
 /** Resolve a local:// URL to an on-disk path under the active session's local root. */
 export declare function resolveLocalUrlToPath(input: string | InternalUrl, options: LocalProtocolOptions, platform?: NodeJS.Platform): string;
 /**

package/dist/types/mcp/transports/header-policy.d.ts

@@ -29,6 +29,14 @@ export declare function mergeMCPHeaders({ generated, configured }: MCPHeaderSour
  * case-insensitive name so the generated value is the only one sent.
  */
 export declare function setGeneratedHeader(headers: Record<string, string>, name: string, value: string): void;
+/**
+ * Return `headers` without any entry whose name case-insensitively matches
+ * `name`. Used to keep transport-reserved protocol headers (e.g.
+ * `MCP-Protocol-Version`) out of user-configured headers so config can never
+ * inject them. Returns the original reference when there is nothing to strip,
+ * so the common (no-match) path allocates nothing.
+ */
+export declare function withoutHeader(headers: Record<string, string> | undefined, name: string): Record<string, string> | undefined;
 export interface MCPFetchInit {
     method: "GET" | "POST" | "DELETE";
     body?: string;

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

@@ -22,6 +22,8 @@ export declare class HttpTransport implements MCPTransport {
     /** Called on 401/403 to attempt token refresh. Returns updated headers or null. */
     onAuthError?: () => Promise<Record<string, string> | null>;
     constructor(config: MCPHttpServerConfig | MCPSseServerConfig);
+    /** Record the protocol version negotiated during `initialize`. */
+    setProtocolVersion(version: string): void;
     get connected(): boolean;
     get url(): string;
     /**

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

@@ -122,6 +122,18 @@ export interface MCPConfigFile {
     /** Names to force-enable when a non-writable source reports `enabled: false`. */
     enabledServers?: string[];
 }
+/**
+ * Latest MCP protocol revision this client negotiates.
+ *
+ * Sent as `protocolVersion` in the `initialize` request and, for Streamable
+ * HTTP, echoed back to the server in the `MCP-Protocol-Version` header on every
+ * subsequent request (per the MCP HTTP transport spec). Must track the current
+ * stable revision: AWS Bedrock AgentCore Gateway refuses tool calls on an
+ * outbound per-user OAuth (`AUTHORIZATION_CODE`) target below `2025-11-25`, and
+ * it checks the version *before* consulting its token vault, so an older client
+ * is refused even for a caller whose consent is already stored.
+ */
+export declare const MCP_PROTOCOL_VERSION = "2025-11-25";
 /** MCP implementation info */
 export interface MCPImplementation {
     name: string;
@@ -227,6 +239,13 @@ export interface MCPTransport {
     notify(method: string, params?: Record<string, unknown>): Promise<void>;
     /** Close the transport */
     close(): Promise<void>;
+    /**
+     * Record the protocol version negotiated in the `initialize` response.
+     * Streamable HTTP transports echo it in the `MCP-Protocol-Version` header on
+     * every subsequent request; transports that need no per-request version
+     * (stdio) omit this.
+     */
+    setProtocolVersion?(version: string): void;
     /** Whether the transport is connected */
     readonly connected: boolean;
     /** Event handlers */

package/dist/types/modes/components/late-diagnostics-message.d.ts

@@ -16,5 +16,7 @@ export declare class LateDiagnosticsMessageComponent extends Container {
     private readonly files;
     constructor(files: LateDiagnosticsFile[]);
     setExpanded(expanded: boolean): void;
+    setToolActivityVisible(visible: boolean): void;
+    render(width: number): readonly string[];
     invalidate(): void;
 }

package/dist/types/modes/components/todo-reminder.d.ts

@@ -12,4 +12,6 @@ export declare class TodoReminderComponent extends Container {
     private readonly attempt;
     private readonly maxAttempts;
     constructor(todos: TodoItem[], attempt: number, maxAttempts: number);
+    setToolActivityVisible(visible: boolean): void;
+    render(width: number): readonly string[];
 }

package/dist/types/modes/components/tool-activity.d.ts

@@ -0,0 +1,17 @@
+import { type Component, Container } from "@oh-my-pi/pi-tui";
+export interface ToolActivityComponent {
+    setToolActivityVisible(visible: boolean): void;
+}
+export declare function isToolActivityComponent(component: Component): component is Component & ToolActivityComponent;
+export declare class ToolActivityContainer extends Container implements ToolActivityComponent {
+    #private;
+    constructor(component: Component | Component[]);
+    setToolActivityVisible(visible: boolean): void;
+    /**
+     * Forward Ctrl+O expansion to wrapped children. The transcript's expansion
+     * traversal only visits top-level children, so the wrapper must proxy or
+     * wrapped renderers would freeze at their insertion-time expansion state.
+     */
+    setExpanded(expanded: boolean): void;
+    render(width: number): readonly string[];
+}

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

@@ -26,6 +26,8 @@ import { type Component, Container, type NativeScrollbackCommittedRows, type Nat
  */
 export declare class TranscriptContainer extends Container implements NativeScrollbackLiveRegion, NativeScrollbackCommittedRows, RenderStablePrefix, ViewportTailProvider {
     #private;
+    addChild(component: Component): void;
+    setToolActivityVisible(visible: boolean): void;
     invalidate(): void;
     clear(): void;
     setNativeScrollbackCommittedRows(rows: number): void;

package/dist/types/modes/components/ttsr-notification.d.ts

@@ -10,6 +10,8 @@ import type { Rule } from "../../capability/rule.js";
 export declare class TtsrNotificationComponent extends Container {
     #private;
     constructor(rules: Rule[]);
+    setToolActivityVisible(visible: boolean): void;
+    render(width: number): readonly string[];
     /** Merge additional rules into this block (deduped by rule name). */
     addRules(rules: Rule[]): void;
     setExpanded(expanded: boolean): void;

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

@@ -313,7 +313,9 @@ export declare class InteractiveMode implements InteractiveModeContext {
     showError(message: string): void;
     showPinnedError(message: string): void;
     clearPinnedError(): void;
-    showWarning(message: string): void;
+    showWarning(message: string, options?: {
+        hideWithToolActivity?: boolean;
+    }): void;
     ensureLoadingAnimation(): void;
     setWorkingMessage(message?: string): void;
     applyPendingWorkingMessage(): void;

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

@@ -243,7 +243,9 @@ export interface InteractiveModeContext {
     showError(message: string): void;
     showPinnedError(message: string): void;
     clearPinnedError(): void;
-    showWarning(message: string): void;
+    showWarning(message: string, options?: {
+        hideWithToolActivity?: boolean;
+    }): void;
     showNewVersionNotification(newVersion: string): void;
     clearEditor(): void;
     updatePendingMessagesDisplay(): void;

package/dist/types/modes/utils/transcript-render-helpers.d.ts

@@ -7,6 +7,7 @@
 import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import { type Component } from "@oh-my-pi/pi-tui";
 import { type FileMentionMessage } from "../../session/messages.js";
+import { ToolActivityContainer } from "../components/tool-activity.js";
 import { TranscriptBlock } from "../components/transcript-container.js";
 type CustomOrHookMessage = Extract<AgentMessage, {
     role: "custom" | "hookMessage";
@@ -19,7 +20,7 @@ type AssistantAgentMessage = Extract<AgentMessage, {
  * or a batch of them) as a transcript block of one "Background job completed"
  * row per job.
  */
-export declare function buildAsyncResultBlock(message: CustomOrHookMessage): TranscriptBlock;
+export declare function buildAsyncResultBlock(message: CustomOrHookMessage): ToolActivityContainer;
 /**
  * Render a live IRC traffic custom message (`irc:incoming` / `irc:autoreply` /
  * `irc:relay`) as a transcript card. `getExpanded` supplies the live

package/dist/types/modes/utils/ui-helpers.d.ts

@@ -38,7 +38,9 @@ export declare class UiHelpers {
     renderInitialMessages(options?: RenderInitialMessagesOptions): void;
     clearEditor(): void;
     showError(errorMessage: string): void;
-    showWarning(warningMessage: string): void;
+    showWarning(warningMessage: string, options?: {
+        hideWithToolActivity?: boolean;
+    }): void;
     showNewVersionNotification(newVersion: string): void;
     updatePendingMessagesDisplay(): void;
     queueCompactionMessage(text: string, mode: "steer" | "followUp", images?: ImageContent[]): void;

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

@@ -138,6 +138,8 @@ export interface AgentSessionConfig {
     createMemoryTools?: () => Promise<AgentTool[]>;
     /** Creates the built-in `computer` tool for session-scoped runtime enablement (see {@link AgentSession.setComputerToolEnabled}). */
     createComputerTool?: () => Promise<AgentTool | null>;
+    /** Creates the private `think` scratchpad tool for runtime setting changes. */
+    createThinkTool?: () => Promise<AgentTool | null>;
     /** Creates the built-in `inspect_image` tool for session-scoped runtime enablement (see {@link AgentSession.setInspectImageMode}). */
     createInspectImageTool?: () => Promise<AgentTool | null>;
     /** Model registry for API key resolution and model discovery. */

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

@@ -331,6 +331,8 @@ export declare class AgentSession {
      * tool (e.g. restricted child sessions have no factory).
      */
     setComputerToolEnabled(enabled: boolean): Promise<boolean>;
+    /** Applies the external-thinking setting to the private scratchpad tool immediately. */
+    setThinkToolEnabled(enabled: boolean): Promise<boolean>;
     /**
      * Session-scoped inspect_image mode (`/vision`). `auto` clears the override
      * and returns to the persisted `inspect_image.mode` setting; `on`/`off`

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

@@ -43,6 +43,8 @@ interface SessionToolsOptions {
     toolRegistry?: Map<string, AgentTool>;
     createVibeTools?: () => AgentTool[];
     createComputerTool?: () => Promise<AgentTool | null>;
+    /** Creates the private `think` scratchpad tool for runtime setting changes. */
+    createThinkTool?: () => Promise<AgentTool | null>;
     /** Creates the built-in `inspect_image` tool for session-scoped runtime enablement (see {@link SessionTools.setInspectImageMode}). */
     createInspectImageTool?: () => Promise<AgentTool | null>;
     builtInToolNames?: Iterable<string>;
@@ -232,6 +234,17 @@ export declare class SessionTools {
      * tool (e.g. restricted child sessions have no factory).
      */
     setComputerToolEnabled(enabled: boolean): Promise<boolean>;
+    /**
+     * Session-scoped enable/disable for the private `think` scratchpad tool.
+     *
+     * Enabling constructs the tool once and refreshes the model's tool contract;
+     * disabling removes it from the active set while preserving its registry entry.
+     *
+     * @returns false when enabling was requested but this session cannot build the tool.
+     */
+    setThinkToolEnabled(enabled: boolean): Promise<boolean>;
+    /** Reconciles the external scratchpad after the active model changes. */
+    reconcileThinkTool(): Promise<boolean>;
     /** Current effective inspect_image state for `/vision status`. */
     inspectImageState(): {
         mode: InspectImageMode;

package/dist/types/tools/builtin-names.d.ts

@@ -1,7 +1,6 @@
 export declare const BUILTIN_TOOL_NAMES: readonly ["read", "bash", "edit", "ast_grep", "ast_edit", "ask", "debug", "eval", "github", "glob", "grep", "lsp", "inspect_image", "browser", "computer", "checkpoint", "rewind", "security_scan", "task", "hub", "todo", "web_search", "write", "memory_edit", "retain", "recall", "reflect", "learn", "manage_skill"];
 export type BuiltinToolName = (typeof BUILTIN_TOOL_NAMES)[number];
-/** Hidden built-ins: constructible and `--tools`-addressable, but never part of the default active set. */
-export declare const HIDDEN_TOOL_NAMES: readonly ["yield", "goal"];
+export declare const HIDDEN_TOOL_NAMES: readonly ["yield", "goal", "think"];
 export type HiddenToolName = (typeof HIDDEN_TOOL_NAMES)[number];
 /** Return the canonical tool name for current and legacy built-in tool IDs. */
 export declare function normalizeToolName(name: string): string;

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

@@ -67,6 +67,7 @@ export * from "./report-tool-issue.js";
 export * from "./resolve.js";
 export * from "./review.js";
 export * from "./security-scan.js";
+export * from "./think.js";
 export * from "./todo.js";
 export * from "./tts.js";
 export * from "./vibe.js";