@oh-my-pi/pi-coding-agent 15.7.6 → 15.8.2

package/dist/types/async/job-manager.d.ts

@@ -9,8 +9,8 @@ export interface AsyncJob {
     resultText?: string;
     errorText?: string;
     /**
-     * Registry id of the agent that registered the job (e.g. "0-Main",
-     * "3-AuthLoader"). Used by scoped cancel/list APIs so a subagent's teardown
+     * Registry id of the agent that registered the job (e.g. "Main",
+     * "AuthLoader"). Used by scoped cancel/list APIs so a subagent's teardown
      * does not cancel its parent's jobs. Undefined for callers that don't
      * supply an id (e.g. legacy tests, SDK consumers without an agent context).
      */
@@ -36,7 +36,7 @@ export interface AsyncJobRegisterOptions {
 /**
  * Filter applied to job query/cancel APIs. With `ownerId`, results are
  * restricted to jobs registered by that agent (registry id from
- * `AgentRegistry`, e.g. "0-Main", "3-AuthLoader").
+ * `AgentRegistry`, e.g. "Main", "AuthLoader").
  */
 export interface AsyncJobFilter {
     ownerId?: string;

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

@@ -15,6 +15,7 @@ export interface Args {
     systemPrompt?: string;
     appendSystemPrompt?: string;
     thinking?: Effort;
+    hideThinking?: boolean;
     continue?: boolean;
     resume?: string | true;
     help?: boolean;

package/dist/types/cli/claude-trace-cli.d.ts

@@ -0,0 +1,54 @@
+export declare const CLAUDE_TRACE_DEBUG_CERT = "-----BEGIN CERTIFICATE-----\nMIIDFzCCAf+gAwIBAgIUAe9omAqLbydZc5ZYZGhwbbpMSF0wDQYJKoZIhvcNAQEL\nBQAwGzEZMBcGA1UEAwwQb21wLWNsYXVkZS10cmFjZTAeFw0yNjA2MDIwODA2MjFa\nFw0zNjA1MzAwODA2MjFaMBsxGTAXBgNVBAMMEG9tcC1jbGF1ZGUtdHJhY2UwggEi\nMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCmpGe5T8B0oA2L82Rn5JJdXOBS\nZX0DyBjiIK+Tqe8T3oAr41XDLnweqtrMDSBDYbVqAoKjNbaTUSYYcxSm0MAVs63w\n08SfJmShZM9pElfANqXqMiyhksFgji7JEyt/rbbId207a7s5KvRvm3g/sxN/wGtr\nC5LCLMlc2GWEGD8qrVIQbmLw884qvtXi70RFUPP3Wpy4wGMWSdE+9IA27R5cMJS5\noHsO4HGB6J8VzLY+HGY2yr4BJ9qrAyjd1UetFd9RdcjyWpsbAfX8nWP+uleTNOiT\nExNz7dPt/k6OPLNmI1iT/ruRS0uUzHZTimPd67TPQR/70RaW7Bh5wArawGw9AgMB\nAAGjUzBRMB0GA1UdDgQWBBQa4Ir8P3GAolZoPiuB4V2cq3riAjAfBgNVHSMEGDAW\ngBQa4Ir8P3GAolZoPiuB4V2cq3riAjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3\nDQEBCwUAA4IBAQClPYki235gDEUu7eDm60qsAGWxbKVv4pSh+vB+xgNgzMk4aOuU\nmSfp8Y8covwklph8VfDoKTaEGqqX0Q5s74Ctl6Mwy7b0u8Zztk/g4GynLocI7TQD\nftZMgZka49+FkEsjp+XZtQbO4vOL5UsccpsLhFQQQuhVyiJ4gNo/VzgvSDkBuf3Q\nRz7xFiDKCqFEoMPty4+nKEw5832FJ5mDCOyMk6fGSO8Wbt/hmRQQFu2cSdoBs0OT\nAQQJETQjPkKeTDX4jdSAlOeKwfyjfdfgeQuMkzX8xafisJa66MLPzOVbIuGbvbWD\nQVCd76iYPcfNK+JZUhmAUvTHSuwgJMZ6+NgI\n-----END CERTIFICATE-----";
+export declare const CLAUDE_TRACE_DEBUG_KEY = "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCmpGe5T8B0oA2L\n82Rn5JJdXOBSZX0DyBjiIK+Tqe8T3oAr41XDLnweqtrMDSBDYbVqAoKjNbaTUSYY\ncxSm0MAVs63w08SfJmShZM9pElfANqXqMiyhksFgji7JEyt/rbbId207a7s5KvRv\nm3g/sxN/wGtrC5LCLMlc2GWEGD8qrVIQbmLw884qvtXi70RFUPP3Wpy4wGMWSdE+\n9IA27R5cMJS5oHsO4HGB6J8VzLY+HGY2yr4BJ9qrAyjd1UetFd9RdcjyWpsbAfX8\nnWP+uleTNOiTExNz7dPt/k6OPLNmI1iT/ruRS0uUzHZTimPd67TPQR/70RaW7Bh5\nwArawGw9AgMBAAECggEADX2mhA3H0pPuj35J36X/5Me9xWM//AwOr6febwGalazg\nCtg3EOZ01/VptzaiKQetAdhoLmxidooNn9HD7JQJKPid7q7w7m1+R26mN/xrLD2A\nWyBqv+iQoo+ANs5y1BMChuIxmVY/FwFk6UWDNlekuXqgzPln4okbrYTmBbaszniO\nMu1SI/3fpnTA3iJ634FUSRVoUPP8r0WEEUtpW1wAhsJR701gvKRYw/+YcRglkhm7\nT4l6TuBcgIVzUqAc3oZLHVIMKN0ZprZSeopSRozTcUANfYONakvK9Hx1qf+/rmTR\nqZHg2uOxlqvxyABnwdk8rmyFx8YqUeN9jaAbbXxtBQKBgQDQRjc0gVg4STqcFqUu\nFW35MZ88S7+xTuRd/EG1dpsu2lptx1yhSLTsF5GfxBQKXCQUfWrpkyuCmlV6s+wJ\nH0LSyAJQ4ffBsFterQz7dRKTlhRJNk5PYn8jjNCAuBYVSbQZqZ3yZgG3CT3G5+PZ\n8Ln3tJHqTRfP5B8KTMcNYiLI0wKBgQDM0/gdb9Dvdz/32GIpxwNNIb52IxnNVVrm\nM69+4XNg6CqvctZFuaMQ03W2J5IKAdESaCGLz9pwHZRjfBORcw3BPKD2QkfN5NJg\nhWvLlfAsblCYiCCjTCB6rf1OJOQ5fHoNFh1wqDaQCk0flsb9nlZmQQR5ZUHaJhSC\nQqMmeKvMrwKBgQDDzp+sH0Z/dGlDwg59auw/caWRHG4WFmOg8L4eCmoO/H4z41B0\n2VQu+mGQYNmue733/Yl8Gz62xL5EY88vLFK4tA1pWWiCknj0Y6Fm70QNuPVNd17c\nR2/cTlDgEzG/xdEqp0q1T62hFXEdBXoztZxBA2SDcQNIEeIU3uXs8SxevQKBgFp4\nacf+wody4aNERR900sV32RtvJ49lWxAA1kwxone0NF5oV7JWa2scK4r4cW3QHZuG\nuQJ7HV2WAxvqCu6cpf+rGuGKpxKPNkkBxXoX0Qye8SReRCQ8lL/7J74jV1b43yP2\nl6xR8D+w/R2tyFjvXfQuVZ6VFgAX/8kFS/DLLf7rAoGAcnFgCwyzcq6FWL8iW23J\nGnbZ0IQk6SPch87MzMmnOFlEXrCf5l832vwI65tNzOoB0yQoWVfBv5sb4Zy9zeFj\nFbkpRZC0Kfi9PLzDV4IawoIINYthOJxIKJg+yrmrUWCggXxwdzYIYKLRIskMXoYs\nmNMXfUstElEcKO7+DKiPi6U=\n-----END PRIVATE KEY-----";
+export interface HeaderEntry {
+    name: string;
+    value: string;
+}
+export interface CapturedRequest {
+    method: string;
+    path: string;
+    version: string;
+    headers: HeaderEntry[];
+    body: string;
+}
+export interface CapturedResponse {
+    statusCode: number | undefined;
+    statusMessage: string;
+    version: string;
+    headers: HeaderEntry[];
+    body: string;
+}
+export interface CapturedMessagesExchange {
+    target: string;
+    request: CapturedRequest;
+    response: CapturedResponse;
+}
+export interface ClaudeMessagesProxyOptions {
+    host?: string;
+    port?: number;
+    upstreamTlsRejectUnauthorized?: boolean;
+}
+export interface ClaudeTraceCommandArgs {
+    command?: string;
+    message?: string;
+    cwd?: string;
+    host?: string;
+    port?: number;
+    timeoutMs?: number;
+    inputDelayMs?: number;
+    json?: boolean;
+    upstreamTlsRejectUnauthorized?: boolean;
+}
+export declare function formatCapturedMessagesExchange(exchange: CapturedMessagesExchange): string;
+export declare class ClaudeMessagesProxy {
+    #private;
+    constructor(options?: ClaudeMessagesProxyOptions);
+    get host(): string;
+    get port(): number;
+    get url(): string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    waitForCapture(timeoutMs: number): Promise<CapturedMessagesExchange>;
+}
+export declare function runClaudeMessagesCapture(args?: ClaudeTraceCommandArgs): Promise<CapturedMessagesExchange>;
+export declare function runClaudeTraceCommand(args?: ClaudeTraceCommandArgs): Promise<void>;

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

@@ -1,3 +1,10 @@
-import type { SessionInfo } from "../session/session-manager";
-/** Show TUI session selector and return selected session path or null if cancelled */
-export declare function selectSession(sessions: SessionInfo[]): Promise<string | null>;
+import { type SessionInfo } from "../session/session-manager";
+/**
+ * Show the TUI session selector and return the selected session, or null if
+ * cancelled. Tab toggles between current-folder and all-projects scope; the
+ * all-projects list is loaded lazily via `SessionManager.listAll`.
+ */
+export declare function selectSession(sessions: SessionInfo[], options?: {
+    allSessions?: SessionInfo[];
+    startInAllScope?: boolean;
+}): Promise<SessionInfo | null>;

package/dist/types/cli/update-cli.d.ts

@@ -25,6 +25,23 @@ export declare function resolveUpdateMethodForTest(ompPath: string, bunBinDir: s
  * Atomically replace the installed binary and roll back if version verification fails.
  */
 export declare function replaceBinaryForUpdate(options: BinaryReplacementOptions): Promise<InstalledVersionVerification>;
+/**
+ * Build the bun argv used to globally install a specific omp version.
+ *
+ * The version is selected by hitting {@link NPM_REGISTRY} directly in
+ * {@link getLatestRelease}, so the install MUST observe the same catalog:
+ *
+ * - `--registry=${NPM_REGISTRY}` pins the install to the official registry
+ *   regardless of the user's bunfig/`.npmrc`. A mirror (corporate proxy,
+ *   Taobao, …) that hasn't yet replicated the release would otherwise reject
+ *   a version the upstream registry already advertises.
+ * - `--no-cache` tells bun to ignore its on-disk manifest snapshot so it
+ *   re-fetches metadata from that registry on every invocation.
+ *
+ * Together these two flags make `omp update` produce exactly the registry
+ * lookup the version check just performed. See #1686.
+ */
+export declare function buildBunInstallArgs(expectedVersion: string): string[];
 /**
  * Run the update command.
  */

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

@@ -81,6 +81,9 @@ export default class Index extends Command {
             description: string;
             options: import("@oh-my-pi/pi-ai").Effort[];
         };
+        "hide-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/config/keybindings.d.ts

@@ -19,6 +19,7 @@ interface AppKeybindings {
     "app.message.followUp": true;
     "app.message.dequeue": true;
     "app.clipboard.pasteImage": true;
+    "app.clipboard.pasteTextRaw": true;
     "app.clipboard.copyLine": true;
     "app.clipboard.copyPrompt": true;
     "app.session.new": true;
@@ -42,6 +43,10 @@ declare module "@oh-my-pi/pi-tui" {
     interface Keybindings extends AppKeybindings {
     }
 }
+/**
+ * Resolve default image-paste shortcuts for the current terminal platform.
+ */
+export declare function getDefaultPasteImageKeys(platform?: NodeJS.Platform): KeyId[];
 /**
  * All keybindings definitions: TUI + app-specific.
  */
@@ -227,9 +232,13 @@ export declare const KEYBINDINGS: {
         readonly description: "Dequeue message";
     };
     readonly "app.clipboard.pasteImage": {
-        readonly defaultKeys: "alt+v" | "ctrl+v";
+        readonly defaultKeys: KeyId[];
         readonly description: "Paste image from clipboard";
     };
+    readonly "app.clipboard.pasteTextRaw": {
+        readonly defaultKeys: ["ctrl+shift+v", "alt+shift+v"];
+        readonly description: "Paste text from clipboard as raw text (no collapse)";
+    };
     readonly "app.clipboard.copyLine": {
         readonly defaultKeys: "alt+shift+l";
         readonly description: "Copy current line";

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

@@ -3281,7 +3281,7 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "exa";
                 readonly label: "Exa";
-                readonly description: "Uses Exa API when EXA_API_KEY is set; falls back to Exa MCP";
+                readonly description: "Requires EXA_API_KEY";
             }, {
                 readonly value: "brave";
                 readonly label: "Brave";
@@ -3321,7 +3321,7 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "kagi";
                 readonly label: "Kagi";
-                readonly description: "Requires KAGI_API_KEY and Kagi Search API beta access";
+                readonly description: "Requires KAGI_API_KEY (Kagi V1 Search API)";
             }, {
                 readonly value: "synthetic";
                 readonly label: "Synthetic";

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

@@ -74,6 +74,19 @@ export declare class Settings {
      */
     flush(): Promise<void>;
     cloneForCwd(cwd: string): Promise<Settings>;
+    /**
+     * Re-scope this instance to a new working directory *in place*: reload the
+     * project layer (`.claude/settings.yml` etc.) from `cwd`, re-resolve
+     * path-scoped settings against it, and re-fire side-effect hooks (theme,
+     * symbols, tab width, …). Global settings and runtime overrides are preserved.
+     *
+     * Unlike {@link cloneForCwd}, this mutates the live instance, so every holder
+     * (the `settings` proxy, the active session, controllers) observes the new
+     * project scope without swapping references — used when the process changes
+     * directory mid-run (`/move`, cross-project resume). No-op when `cwd` is
+     * already the current scope.
+     */
+    reloadForCwd(cwd: string): Promise<void>;
     getStorage(): AgentStorage | null;
     getCwd(): string;
     getAgentDir(): string;

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

@@ -52,5 +52,11 @@ export declare class EditTool implements AgentTool<TInput> {
      * internal `name` and `customWireName`, so returned calls route correctly.
      */
     get customWireName(): string | undefined;
+    /**
+     * Normalize streamed args into the source text this edit introduces, so
+     * stream matchers (TTSR rules) run against real file content instead of the
+     * mode-specific patch grammar.
+     */
+    matcherDigest(args: unknown): string | undefined;
     execute(_toolCallId: string, params: EditParams, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<EditToolDetails, TInput>, context?: AgentToolContext): Promise<AgentToolResult<EditToolDetails, TInput>>;
 }

package/dist/types/edit/streaming.d.ts

@@ -52,6 +52,14 @@ export interface EditStreamingStrategy<Args = unknown> {
      * compute returned `null` because args are still too partial).
      */
     renderStreamingFallback(args: Args, uiTheme: Theme): string;
+    /**
+     * Project the (potentially partial) args onto the plain text the edit
+     * introduces into files — added lines without patch grammar — so stream
+     * matchers (TTSR rules) can run source-level patterns against real content
+     * instead of the mode-specific wire format. Returns `undefined` when the
+     * args don't yet carry any content.
+     */
+    matcherDigest(args: Args): string | undefined;
 }
 /**
  * Given an edits array parsed from partial JSON, drop the last entry when the

package/dist/types/eval/concurrency-bridge.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Host-side handler for the eval `parallel()` / `pipeline()` worker pool.
+ *
+ * The pool ceiling is not a kernel-side knob: it tracks the `task.maxConcurrency`
+ * setting so an eval fan-out runs as wide as a `task` tool batch would. `0` means
+ * unbounded — run every item at once, exactly like `task.maxConcurrency = 0`.
+ */
+import type { ToolSession } from "../tools";
+import type { JsStatusEvent } from "./js/shared/types";
+/** Synthetic bridge name reserved for the parallel-pool ceiling across both runtimes. */
+export declare const EVAL_CONCURRENCY_BRIDGE_NAME = "__concurrency__";
+export interface EvalConcurrencyBridgeOptions {
+    session: ToolSession;
+    signal?: AbortSignal;
+    emitStatus?: (event: JsStatusEvent) => void;
+}
+export interface EvalConcurrencyResult {
+    /** Worker-pool ceiling; `0` means unbounded (run every item at once). */
+    limit: number;
+}
+/**
+ * Resolve the worker-pool ceiling for an eval cell's `parallel()`/`pipeline()`
+ * helpers from the live `task.maxConcurrency` setting. Negative/non-finite
+ * values collapse to `0` (unbounded), matching the `task` tool's own handling.
+ */
+export declare function runEvalConcurrency(_args: unknown, options: EvalConcurrencyBridgeOptions): EvalConcurrencyResult;

package/dist/types/eval/js/tool-bridge.d.ts

@@ -1,5 +1,6 @@
 import type { ToolSession } from "../../tools";
 import { type EvalBudgetResult } from "../budget-bridge";
+import { type EvalConcurrencyResult } from "../concurrency-bridge";
 import type { JsStatusEvent } from "./shared/types";
 export type { JsStatusEvent } from "./shared/types";
 interface ToolBridgeOptions {
@@ -7,7 +8,7 @@ interface ToolBridgeOptions {
     signal?: AbortSignal;
     emitStatus?: (event: JsStatusEvent) => void;
 }
-type ToolValue = string | EvalBudgetResult | {
+type ToolValue = string | EvalBudgetResult | EvalConcurrencyResult | {
     text: string;
     details?: unknown;
     images?: Array<{

package/dist/types/export/ttsr.d.ts

@@ -23,6 +23,15 @@ export declare class TtsrManager {
      * assistant prose, thinking text, and unrelated tool argument streams.
      */
     checkDelta(delta: string, context: TtsrMatchContext): Rule[];
+    /**
+     * Replace the scoped buffer with a tool-provided normalized snapshot and
+     * return matching rules.
+     *
+     * Used for tools exposing `matcherDigest`: the digest is recomputed from the
+     * full (partial) arguments on every delta, so it replaces the buffer instead
+     * of being appended to it.
+     */
+    checkSnapshot(snapshot: string, context: TtsrMatchContext): Rule[];
     /** Mark rules as injected (won't trigger again until conditions allow). */
     markInjected(rulesToMark: Rule[]): void;
     /** Mark rule names as injected (won't trigger again until conditions allow). */

package/dist/types/extensibility/plugins/legacy-pi-compat.d.ts

@@ -13,6 +13,17 @@ import * as path from "node:path";
  * Exported for tests; production callers use `BUNFS_PACKAGE_ROOT` below.
  */
 export declare function __computeBunfsPackageRoot(metaDir: string, pathImpl?: typeof path): string;
+/**
+ * Load a legacy Pi extension module from its real on-disk location.
+ *
+ * The extension runs in place, so its `import.meta.url` is the real source file
+ * and `__dirname`-relative `readFileSync` asset loads (HTML/CSS bundled next to
+ * the entry) resolve exactly as they do under the original Pi runtime — no
+ * temp-directory mirroring and no asset copying. An `onLoad` hook scoped to the
+ * entry's relative-import graph rewrites only the legacy `@(scope)/pi-*` and
+ * `@sinclair/typebox` imports in the extension's own source; everything else
+ * resolves natively.
+ */
 export declare function loadLegacyPiModule(resolvedPath: string): Promise<unknown>;
 export declare function installLegacyPiSpecifierShim(): void;
 /** Test seam: clears the memoized canonical specifier resolutions. */

package/dist/types/main.d.ts

@@ -12,6 +12,7 @@ import type { SubmittedUserInput } from "./modes/types";
 import { type CreateAgentSessionOptions, type CreateAgentSessionResult, createAgentSession, discoverAuthStorage } from "./sdk";
 import type { AgentSession } from "./session/agent-session";
 import type { AuthStorage } from "./session/auth-storage";
+import { type SessionInfo, SessionManager } from "./session/session-manager";
 export interface InteractiveModeNotify {
     kind: "warn" | "error" | "info";
     message: string;
@@ -39,6 +40,10 @@ export interface AcpSessionFactoryOptions {
  * tool registry and shadow the client-supplied servers (issue #1234).
  */
 export declare function createAcpSessionFactory(args: AcpSessionFactoryOptions): AcpSessionFactory;
+type ForkSessionPromptResult = "accepted" | "declined" | "unavailable";
+type ForkSessionPrompt = (session: SessionInfo) => Promise<ForkSessionPromptResult>;
+/** Resolves CLI session flags into an existing, forked, in-memory, or cancelled session manager. */
+export declare function createSessionManager(parsed: Args, cwd: string, activeSettings?: Settings, askToForkSession?: ForkSessionPrompt): Promise<SessionManager | undefined>;
 interface RunRootCommandDependencies {
     createAgentSession?: typeof createAgentSession;
     discoverAuthStorage?: typeof discoverAuthStorage;

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

@@ -5,6 +5,24 @@
  * Messages are newline-delimited JSON.
  */
 import type { MCPRequestOptions, MCPStdioServerConfig, MCPTransport } from "../../mcp/types";
+/** Minimal write surface of `Subprocess.stdin` we need for framed sends. */
+interface FrameSink {
+    write(chunk: string): unknown;
+    flush(): unknown;
+}
+/**
+ * Write a newline-delimited JSON-RPC frame to the subprocess's stdin sink,
+ * swallowing synchronous errors so the caller can decide how to react.
+ *
+ * Bun's `FileSink` may throw synchronously (most reliably on Windows) when
+ * the read end of the pipe has been closed by a subprocess that exited
+ * between read-loop ticks. Letting that throw escape an `async` method
+ * surfaces as an unhandled promise rejection at the call site.
+ *
+ * Returns `true` when the frame was accepted by the sink, `false` when the
+ * sink threw — callers signal transport closure on `false`.
+ */
+export declare function writeFrame(stdin: FrameSink, frame: string): boolean;
 /**
  * Stdio transport for MCP servers.
  * Spawns a subprocess and communicates via stdin/stdout.
@@ -30,3 +48,4 @@ export declare class StdioTransport implements MCPTransport {
  * Create and connect a stdio transport.
  */
 export declare function createStdioTransport(config: MCPStdioServerConfig): Promise<StdioTransport>;
+export {};

package/dist/types/modes/components/custom-editor.d.ts

@@ -1,6 +1,6 @@
 import { Editor, type KeyId } from "@oh-my-pi/pi-tui";
 import type { AppKeybinding } from "../../config/keybindings";
-type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.clipboard.pasteImage" | "app.clipboard.copyPrompt">;
+type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.clipboard.pasteImage" | "app.clipboard.pasteTextRaw" | "app.clipboard.copyPrompt">;
 /**
  * Custom editor that handles configurable app-level shortcuts for coding-agent.
  */
@@ -26,6 +26,8 @@ export declare class CustomEditor extends Editor {
     onCopyPrompt?: () => void;
     /** Called when the configured image-paste shortcut is pressed. */
     onPasteImage?: () => Promise<boolean>;
+    /** Called when the configured raw text-paste shortcut is pressed. */
+    onPasteTextRaw?: () => void;
     /** Called when the configured dequeue shortcut is pressed. */
     onDequeue?: () => void;
     /** Called when Caps Lock is pressed. */

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

@@ -41,6 +41,9 @@ export interface HookSelectorOptions {
     onExternalEditor?: () => void;
     helpText?: string;
     slider?: HookSelectorSlider;
+    /** Indices into the original options that cannot be selected: they render
+     *  dimmed, are skipped during navigation, and reject enter/timeout. */
+    disabledIndices?: readonly number[];
 }
 export interface HookSelectorOption {
     label: string;

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

@@ -1,28 +1,55 @@
 import { type Component, Container } from "@oh-my-pi/pi-tui";
 import type { SessionInfo } from "../../session/session-manager";
+/** Returns the IDs of sessions whose recorded prompts match a query, best first. */
+export type SessionHistoryMatcher = (query: string) => string[];
+/**
+ * Combine fuzzy session matches with prompt-history matches for ranking, using
+ * both signals rather than replacing one with the other.
+ *
+ * - `fuzzy` is the ordered fuzzy-filter result over session metadata (best first).
+ * - `historyIds` are session IDs whose recorded prompts matched the query,
+ *   ordered by history relevance (best first); duplicates are tolerated.
+ *
+ * Ranking: sessions matched by **both** signals lead (keeping fuzzy order), then
+ * fuzzy-only matches, then history-only matches (by history order). A fuzzy match
+ * is never dropped, and history matches not present in `allSessions` (e.g. deleted
+ * or out-of-scope sessions) are ignored since they cannot be resumed from here.
+ */
+export declare function mergeSessionRanking(allSessions: SessionInfo[], fuzzy: SessionInfo[], historyIds: string[]): SessionInfo[];
 /**
  * Custom session list component with multi-line items and search
  */
 declare class SessionList implements Component {
     #private;
-    private readonly allSessions;
-    private readonly showCwd;
-    onSelect?: (sessionPath: string) => void;
+    onSelect?: (session: SessionInfo) => void;
     onCancel?: () => void;
     onExit: () => void;
+    onToggleScope?: () => void;
     onDeleteRequest?: (session: SessionInfo) => void;
-    constructor(allSessions: SessionInfo[], showCwd?: boolean);
+    constructor(sessions: SessionInfo[], showCwd?: boolean, historyMatcher?: SessionHistoryMatcher);
+    /** Replace the visible dataset, e.g. when toggling folder/all-projects scope. */
+    setSessions(sessions: SessionInfo[], showCwd: boolean): void;
     removeSession(sessionPath: string): void;
     invalidate(): void;
     render(width: number): string[];
     handleInput(keyData: string): void;
 }
+export interface SessionSelectorOptions {
+    onDelete?: (session: SessionInfo) => Promise<boolean>;
+    historyMatcher?: SessionHistoryMatcher;
+    /** Loads sessions across all projects for the all-projects scope toggle (Tab). */
+    loadAllSessions?: () => Promise<SessionInfo[]>;
+    /** Preloaded all-projects list; cached so the first Tab toggle is instant. */
+    allSessions?: SessionInfo[];
+    /** Open directly in all-projects scope (e.g. the current folder has no sessions). */
+    startInAllScope?: boolean;
+}
 /**
  * Component that renders a session selector with optional confirmation dialog
  */
 export declare class SessionSelectorComponent extends Container {
     #private;
-    constructor(sessions: SessionInfo[], onSelect: (sessionPath: string) => void, onCancel: () => void, onExit: () => void, onDelete?: (session: SessionInfo) => Promise<boolean>);
+    constructor(sessions: SessionInfo[], onSelect: (session: SessionInfo) => void, onCancel: () => void, onExit: () => void, options?: SessionSelectorOptions);
     setOnRequestRender(callback: () => void): void;
     handleInput(keyData: string): void;
     getSessionList(): SessionList;

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

@@ -34,6 +34,14 @@ export declare class ToolExecutionComponent extends Container {
      * This triggers an immediate final diff computation for edit-like tools.
      */
     setArgsComplete(_toolCallId?: string): void;
+    /**
+     * Await the streaming diff recompute kicked off by the most recent
+     * `updateArgs`/`setArgsComplete`. The recompute reads the file and re-runs the
+     * whole-file Myers diff off the render path, signalling completion only via a
+     * throttled `requestRender`. Tests await this to sample a *settled* preview
+     * deterministically instead of racing the spinner's render ticks.
+     */
+    whenPreviewSettled(): Promise<void>;
     updateResult(result: {
         content: Array<{
             type: string;

package/dist/types/modes/controllers/extension-ui-controller.d.ts

@@ -3,7 +3,7 @@ import { KeybindingsManager } from "../../config/keybindings";
 import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions, TerminalInputHandler } from "../../extensibility/extensions";
 import { type HookSelectorSlider } from "../../modes/components/hook-selector";
 import { type Theme } from "../../modes/theme/theme";
-import type { InteractiveModeContext } from "../../modes/types";
+import type { InteractiveModeContext, InteractiveSelectorDialogOptions } from "../../modes/types";
 export declare class ExtensionUiController {
     #private;
     private ctx;
@@ -30,7 +30,7 @@ export declare class ExtensionUiController {
     /**
      * Show a selector for hooks.
      */
-    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: ExtensionUIDialogOptions, extra?: {
+    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: InteractiveSelectorDialogOptions, extra?: {
         slider?: HookSelectorSlider;
     }): Promise<string | undefined>;
     /**

package/dist/types/modes/controllers/input-controller.d.ts

@@ -18,6 +18,7 @@ export declare class InputController {
     }): number;
     handleBackgroundCommand(): void;
     handleImagePaste(): Promise<boolean>;
+    handleClipboardTextRawPaste(): Promise<void>;
     createAutocompleteProvider(commands: SlashCommand[], basePath: string): AutocompleteProvider;
     /** Copy the current editor line to the system clipboard. */
     handleCopyCurrentLine(): void;

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

@@ -26,7 +26,7 @@ import type { ToolExecutionHandle } from "./components/tool-execution";
 import { type LoopLimitRuntime } from "./loop-limit";
 import { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
-import type { CompactionQueuedMessage, InteractiveModeContext, InteractiveModeInitOptions, SubmittedUserInput, TodoItem, TodoPhase } from "./types";
+import type { CompactionQueuedMessage, InteractiveModeContext, InteractiveModeInitOptions, InteractiveSelectorDialogOptions, SubmittedUserInput, TodoItem, TodoPhase } from "./types";
 /** Options for creating an InteractiveMode instance (for future API use) */
 export interface InteractiveModeOptions {
     /** Providers that were migrated during startup */
@@ -112,6 +112,13 @@ export declare class InteractiveMode implements InteractiveModeContext {
     init(options?: InteractiveModeInitOptions): Promise<void>;
     /** Reload slash commands and autocomplete for the provided working directory. */
     refreshSlashCommandState(cwd?: string): Promise<void>;
+    /**
+     * Re-point the process and every cwd-derived cache at `newCwd` after the
+     * active session's working directory changed (`/move` relocation or resuming
+     * a session from another project). The SessionManager's cwd MUST already
+     * reflect `newCwd` before this is called.
+     */
+    applyCwdChange(newCwd: string): Promise<void>;
     getUserInput(): Promise<SubmittedUserInput>;
     disableLoopMode(message?: string): void;
     /**
@@ -253,7 +260,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     emitCustomToolSessionEvent(reason: "start" | "switch" | "branch" | "tree" | "shutdown", previousSessionFile?: string): Promise<void>;
     setHookWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void;
     setHookStatus(key: string, text: string | undefined): void;
-    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: ExtensionUIDialogOptions, extra?: {
+    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: InteractiveSelectorDialogOptions, extra?: {
         slider?: HookSelectorSlider;
     }): Promise<string | undefined>;
     hideHookSelector(): void;

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

@@ -19,7 +19,7 @@ import type { CustomEditor } from "./components/custom-editor";
 import type { EvalExecutionComponent } from "./components/eval-execution";
 import type { HookEditorComponent } from "./components/hook-editor";
 import type { HookInputComponent } from "./components/hook-input";
-import type { HookSelectorComponent } from "./components/hook-selector";
+import type { HookSelectorComponent, HookSelectorOptions } from "./components/hook-selector";
 import type { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
 import type { LoopLimitRuntime } from "./loop-limit";
@@ -51,6 +51,7 @@ export type TodoPhase = {
 export interface InteractiveModeInitOptions {
     suppressWelcomeIntro?: boolean;
 }
+export type InteractiveSelectorDialogOptions = ExtensionUIDialogOptions & Pick<HookSelectorOptions, "disabledIndices">;
 export interface InteractiveModeContext {
     ui: TUI;
     chatContainer: Container;
@@ -217,6 +218,7 @@ export interface InteractiveModeContext {
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     openInBrowser(urlOrPath: string): void;
     refreshSlashCommandState(cwd?: string): Promise<void>;
+    applyCwdChange(newCwd: string): Promise<void>;
     showSettingsSelector(): void;
     showHistorySearch(): void;
     showExtensionsDashboard(): void;
@@ -264,7 +266,7 @@ export interface InteractiveModeContext {
     emitCustomToolSessionEvent(reason: "start" | "switch" | "branch" | "tree" | "shutdown", previousSessionFile?: string): Promise<void>;
     setHookWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void;
     setHookStatus(key: string, text: string | undefined): void;
-    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: ExtensionUIDialogOptions): Promise<string | undefined>;
+    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: InteractiveSelectorDialogOptions): Promise<string | undefined>;
     hideHookSelector(): void;
     showHookInput(title: string, placeholder?: string): Promise<string | undefined>;
     hideHookInput(): void;

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

@@ -6,7 +6,7 @@
  * creation and removed when the owner releases them.
  */
 import type { AgentSession } from "../session/agent-session";
-export declare const MAIN_AGENT_ID = "0-Main";
+export declare const MAIN_AGENT_ID = "Main";
 export type AgentStatus = "running" | "idle" | "completed" | "aborted";
 export type AgentKind = "main" | "sub";
 export interface AgentRef {

package/dist/types/sdk.d.ts

@@ -101,13 +101,13 @@ export interface CreateAgentSessionOptions {
     parentHindsightSessionState?: HindsightSessionState;
     /** Parent Mnemopi state to alias for subagent memory tools. */
     parentMnemopiSessionState?: MnemopiSessionState;
-    /** Pre-allocated agent identity for IRC routing. Default: "0-Main" for top-level, parentTaskPrefix-derived for sub. */
+    /** Pre-allocated agent identity for IRC routing. Default: "Main" for top-level, parentTaskPrefix-derived for sub. */
     agentId?: string;
     /** Display name for the agent in IRC. Default: "main" or "sub". */
     agentDisplayName?: string;
     /** Optional shared agent registry for IRC routing. Default: AgentRegistry.global(). */
     agentRegistry?: AgentRegistry;
-    /** Parent task ID prefix for nested artifact naming (e.g., "6-Extensions") */
+    /** Parent task ID prefix for nested artifact naming (e.g., "Extensions") */
     parentTaskPrefix?: string;
     /** Inherited eval executor session id for subagents sharing parent eval state. */
     parentEvalSessionId?: string;

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

@@ -201,7 +201,7 @@ export interface AgentSessionConfig {
      * **MUST NOT** dispose it on their own teardown.
      */
     ownedAsyncJobManager?: AsyncJobManager;
-    /** Agent identity (registry id like "0-Main" or "3-Alice") used for IRC routing. */
+    /** Agent identity (registry id like "Main" or "Alice") used for IRC routing. */
     agentId?: string;
     /** Shared agent registry (for forwarding IRC observations to the main session UI). */
     agentRegistry?: AgentRegistry;
@@ -973,7 +973,9 @@ export declare class AgentSession {
      * Uses the last assistant message's usage data when available,
      * otherwise estimates tokens for all messages.
      */
-    getContextUsage(): ContextUsage | undefined;
+    getContextUsage(options?: {
+        contextWindow?: number;
+    }): ContextUsage | undefined;
     fetchUsageReports(signal?: AbortSignal): Promise<UsageReport[] | null>;
     /**
      * Export session to HTML.