@oh-my-pi/pi-coding-agent 16.4.8 → 16.5.0

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

@@ -6,7 +6,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move";
 export type SpinnerType = "status" | "activity";
 export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "thinkingMax" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
 /** Check if a string is a valid ThemeColor value */
@@ -160,6 +160,7 @@ export declare class Theme {
     get icon(): {
         model: string;
         plan: string;
+        prewalk: string;
         goal: string;
         pause: string;
         loop: string;

package/dist/types/sdk.d.ts

@@ -17,7 +17,7 @@ import { type LocalProtocolOptions } from "./internal-urls/index.js";
 import { MCPManager, type MCPToolsLoadResult } from "./mcp/index.js";
 import type { MnemopiSessionState } from "./mnemopi/state.js";
 import { AgentRegistry } from "./registry/agent-registry.js";
-import { AgentSession } from "./session/agent-session.js";
+import { AgentSession, type PlanYolo, type Prewalk } from "./session/agent-session.js";
 import type { AuthStorage } from "./session/auth-storage.js";
 import { SessionManager } from "./session/session-manager.js";
 import { type BuildSystemPromptResult } from "./system-prompt.js";
@@ -52,6 +52,10 @@ export interface CreateAgentSessionOptions {
         model: Model;
         thinkingLevel?: ThinkingLevel;
     }>;
+    /** Prewalk from the starting model to a fast/cheap target at the first edit/write once the todo list exists. */
+    prewalk?: Prewalk;
+    /** Force read-only plan mode at start, auto-approve on the model's first resolve call, then switch to execute. */
+    planYolo?: PlanYolo;
     /** Provider-facing system prompt override. Replaces the fully rendered default blocks. */
     systemPrompt?: string | string[] | ((defaultPrompt: string[]) => string | string[]);
     /** Already-loaded custom prompt text rendered through the bundled custom system prompt template. */

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

@@ -151,6 +151,33 @@ export interface AsyncJobSnapshot {
     delivery: AsyncJobDeliveryState;
 }
 export type { ShakeMode, ShakeResult };
+/**
+ * Prewalk: switches an active session one-way from its starting model to
+ * a fast/cheap `target` at the first completed turn that runs an edit/write
+ * tool once the todo list exists. A hidden plan nudge asks the starting
+ * model to write a plan, initialize its todo list from it, and start; the
+ * todo call opens the trigger gate (it never fires the switch itself), so
+ * the starting model always begins the implementation. A hidden
+ * checklist nudge asks the target model to verify its work before
+ * finishing. Both are always on — this is the one mechanism that won out
+ * over turn-count and ungated variants in testing.
+ */
+export interface Prewalk {
+    target: Model;
+    thinkingLevel?: ConfiguredThinkingLevel;
+}
+/**
+ * PlanYolo: forces the session into read-only plan mode at start, then
+ * auto-approves the plan the instant the model calls `resolve({ action:
+ * "apply" })` for it — no interactive review — and switches to a fast/cheap
+ * `target` model to implement it. The headless counterpart to interactive
+ * plan mode's "Approve and execute", for print/non-interactive runs where
+ * there is no one to click Approve.
+ */
+export interface PlanYolo {
+    target: Model;
+    thinkingLevel?: ConfiguredThinkingLevel;
+}
 export interface AgentSessionConfig {
     agent: Agent;
     sessionManager: SessionManager;
@@ -164,6 +191,11 @@ export interface AgentSessionConfig {
     }>;
     /** Initial session thinking selector. */
     thinkingLevel?: ConfiguredThinkingLevel;
+    /** Prewalk from the starting model to a fast/cheap target at the first edit/write once the todo list exists. */
+    prewalk?: Prewalk;
+    /** Force read-only plan mode at start, auto-approve on the model's first
+     *  `resolve` call, then switch to the target to implement. */
+    planYolo?: PlanYolo;
     /** Initial per-family service tiers (OpenAI / Anthropic / Google) for the live session. */
     serviceTierByFamily?: ServiceTierByFamily;
     /** Prompt templates for expansion */
@@ -489,6 +521,14 @@ export declare class AgentSession {
     fileSnapshotStore?: InMemorySnapshotStore;
     readonly configWarnings: string[];
     readonly rawSseDebugBuffer: RawSseDebugBuffer;
+    /**
+     * Arm prewalk outside the normal startup path (the `/prewalk` slash
+     * command): sets the target and immediately steers the plan nudge rather
+     * than waiting for the next turn boundary, since an explicit manual
+     * invocation means "start this now." A no-op with a notice if a prewalk
+     * is already armed and waiting.
+     */
+    armPrewalk(target: Model, thinkingLevel?: ConfiguredThinkingLevel): void;
     constructor(config: AgentSessionConfig);
     /** Model registry for API key resolution and model discovery */
     get modelRegistry(): ModelRegistry;
@@ -736,6 +776,8 @@ export declare class AgentSession {
     }>;
     /** Prompt templates */
     getPlanModeState(): PlanModeState | undefined;
+    /** Prewalk state, if armed and active */
+    getPrewalkState(): Prewalk | undefined;
     setPlanModeState(state: PlanModeState | undefined): void;
     getGoalModeState(): GoalModeState | undefined;
     setGoalModeState(state: GoalModeState | undefined): void;

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

@@ -50,4 +50,13 @@ export interface BuildSessionContextOptions {
      */
     keepDanglingToolCalls?: boolean;
 }
+/**
+ * Display-only marker set on transcript assistant messages whose dangling
+ * `toolCall` blocks were stripped (no paired result on the resolved path —
+ * failed/retried turns, results on sibling branches). The TUI renders a
+ * placeholder row from it so the turn's activity never silently vanishes.
+ */
+export interface StrippedToolCallsMarker {
+    strippedToolCalls?: number;
+}
 export declare function buildSessionContext(entries: SessionEntry[], leafId?: string | null, byId?: Map<string, SessionEntry>, options?: BuildSessionContextOptions): SessionContext;

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

@@ -77,6 +77,12 @@ export interface CompactionEntry<T = unknown> extends SessionEntryBase {
     preserveData?: Record<string, unknown>;
     /** True if generated by an extension, undefined/false if pi-generated (backward compatible) */
     fromExtension?: boolean;
+    /**
+     * Dead-end warning from the post-pass progress guard: the pass completed
+     * but freed too little for maintenance to continue. Rendered on the
+     * compaction divider.
+     */
+    warning?: string;
 }
 export interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {
     type: "branch_summary";

package/dist/types/thinking.d.ts

@@ -9,11 +9,11 @@ export interface ThinkingLevelMetadata {
     description: string;
 }
 /**
- * Parses a provider-facing effort value.
+ * Parses a provider-facing effort value. Accepts unambiguous abbreviations.
  */
 export declare function parseEffort(value: string | null | undefined): Effort | undefined;
 /**
- * Parses an agent-local thinking selector.
+ * Parses an agent-local thinking selector. Accepts unambiguous abbreviations.
  */
 export declare function parseThinkingLevel(value: string | null | undefined): ThinkingLevel | undefined;
 /**

package/dist/types/tiny/models.d.ts

@@ -1,4 +1,4 @@
-/** Default session-title model: the online pi/smol path (no local download / on-device inference). */
+/** Default session-title model: the online @smol path (no local download / on-device inference). */
 export declare const ONLINE_TINY_TITLE_MODEL_KEY = "online";
 /** Local model the `tiny-models` CLI downloads when none is named. Not the session-title default — that is {@link ONLINE_TINY_TITLE_MODEL_KEY}. */
 export declare const DEFAULT_TINY_TITLE_LOCAL_MODEL_KEY = "lfm2-700m";

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

@@ -13,6 +13,7 @@ export declare const DEFAULT_VIEWPORT: {
 export declare const BROWSER_PROTOCOL_TIMEOUT_MS = 60000;
 export declare function loadPuppeteer(): Promise<typeof Puppeteer>;
 export declare function loadPuppeteerInWorker(safeDir: string): Promise<typeof Puppeteer>;
+export declare function ensureChromiumExecutable(): Promise<string | undefined>;
 export interface LaunchHeadlessOptions {
     headless: boolean;
     viewport?: {

package/dist/types/tools/browser/run-cancellation.d.ts

@@ -9,7 +9,33 @@
  * that do await it still receive the rejection.
  */
 export declare function markHandled<T>(promise: Promise<T>): Promise<T>;
-/** Sleeps inside evaluated browser code while honoring the owning run's cancellation signal. */
-export declare function waitForBrowserRun(ms: number, signal: AbortSignal): Promise<void>;
+/** Headroom subtracted from the cell budget so an in-run deadline fires before the opaque whole-cell timeout. */
+export declare const CELL_BUDGET_SLACK_MS = 1000;
+/** Default poll deadline for `wait(predicate)` before clamping to the cell budget. */
+export declare const DEFAULT_PREDICATE_TIMEOUT_MS = 30000;
+/** Options for the predicate form of the run-scoped `wait()` helper. */
+export interface WaitPredicateOptions {
+    /** Max time to poll before failing, in ms (default 30s, clamped to the cell budget). */
+    timeout?: number;
+    /** Poll interval in ms (default 100, floor 10). */
+    interval?: number;
+}
+/**
+ * Effective `wait(predicate)` deadline for a given cell budget. Always strictly below
+ * the cell budget so the named `wait(predicate) timed out` error wins the race against
+ * the opaque whole-cell "Browser code execution timed out". `0`/`Infinity` ("disable")
+ * map to the largest bounded deadline; negative/NaN garbage falls back to the default.
+ */
+export declare function resolvePredicateTimeout(cellTimeoutMs: number, explicit?: number): number;
+/**
+ * Run-scoped `wait()` helper for evaluated browser code, honoring the owning run's
+ * cancellation signal.
+ *
+ * - `wait(ms)` sleeps for `ms` milliseconds.
+ * - `wait(fn, { timeout?, interval? })` polls `fn` (sync or async) until it returns a
+ *   truthy value and resolves with that value; throws a named `ToolError` on timeout
+ *   instead of stalling into the whole-cell deadline. Predicate errors propagate.
+ */
+export declare function waitForBrowserRun(msOrPredicate: number | (() => unknown), signal: AbortSignal, opts?: WaitPredicateOptions): Promise<unknown>;
 /** Binds a long-lived browser facade to one evaluated run's abort signal. */
 export declare function bindBrowserRunFacade<T extends object>(target: T, signal: AbortSignal): T;

package/dist/types/tools/browser/tab-protocol.d.ts

@@ -59,6 +59,12 @@ export type WorkerInitPayload = {
     safeDir: string;
     targetId: string;
     dialogs?: "accept" | "dismiss";
+    /**
+     * Post-timeout recycle: before adopting the page, dismiss any open JS dialog and
+     * stop a pending navigation so a blocked target cannot stall worker init (which
+     * previously force-killed the tab). Never set for first-time Electron attach.
+     */
+    recover?: boolean;
 };
 export type ToolReply = {
     ok: true;

package/dist/types/tools/browser/tab-worker.d.ts

@@ -1,6 +1,12 @@
 import type { HTMLElement } from "linkedom";
 import type { ElementHandle, ImageFormat } from "puppeteer-core";
 import type { Transport } from "./tab-protocol.js";
+declare module "puppeteer-core" {
+    interface Frame {
+        /** Puppeteer's main JavaScript realm, retained by our pinned runtime patch. */
+        mainRealm(): Realm;
+    }
+}
 declare global {
     interface Element extends HTMLElement {
     }

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

@@ -1,4 +1,4 @@
-export declare const BUILTIN_TOOL_NAMES: readonly ["read", "bash", "edit", "ast_grep", "ast_edit", "ask", "debug", "eval", "ssh", "github", "glob", "grep", "lsp", "inspect_image", "browser", "checkpoint", "rewind", "task", "job", "irc", "todo", "web_search", "search_tool_bm25", "write", "memory_edit", "retain", "recall", "reflect", "learn", "manage_skill"];
+export declare const BUILTIN_TOOL_NAMES: readonly ["read", "bash", "launch", "edit", "ast_grep", "ast_edit", "ask", "debug", "eval", "ssh", "github", "glob", "grep", "lsp", "inspect_image", "browser", "checkpoint", "rewind", "task", "job", "irc", "todo", "web_search", "search_tool_bm25", "write", "memory_edit", "retain", "recall", "reflect", "learn", "manage_skill"];
 export type BuiltinToolName = (typeof BUILTIN_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

@@ -48,6 +48,7 @@ export * from "./image-gen.js";
 export * from "./inspect-image.js";
 export * from "./irc.js";
 export * from "./job.js";
+export * from "./launch.js";
 export * from "./learn.js";
 export * from "./manage-skill.js";
 export * from "./memory-edit.js";

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

@@ -0,0 +1,121 @@
+import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback, ToolApprovalDecision } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
+import type { Component } from "@oh-my-pi/pi-tui";
+import type { RenderResultOptions } from "../extensibility/custom-tools/types.js";
+import type { DaemonSnapshot, DaemonSpec, DaemonState } from "../launch/protocol.js";
+import type { Theme } from "../modes/theme/theme.js";
+import type { ToolSession } from "./index.js";
+declare const launchSchema: import("arktype/internal/variants/object.ts").ObjectType<{
+    op: "describe" | "list" | "logs" | "restart" | "send" | "start" | "stop" | "wait";
+    name?: string | undefined;
+    application?: string | undefined;
+    args?: string[] | undefined;
+    env?: {
+        [x: string]: string;
+    } | undefined;
+    cwd?: string | undefined;
+    pty?: boolean | undefined;
+    ready?: {
+        log?: string | undefined;
+        port?: number | undefined;
+        host?: string | undefined;
+        timeout?: number | undefined;
+    } | undefined;
+    restart?: "always" | "no" | "on-failure" | undefined;
+    persist?: boolean | undefined;
+    detached?: boolean | undefined;
+    lines?: number | undefined;
+    head?: boolean | undefined;
+    grep?: string | undefined;
+    follow?: boolean | undefined;
+    cursor?: number | undefined;
+    for?: "exit" | "ready" | undefined;
+    pattern?: string | undefined;
+    text?: string | undefined;
+    enter?: boolean | undefined;
+    keys?: string[] | undefined;
+    signal?: "SIGHUP" | "SIGINT" | "SIGKILL" | "SIGQUIT" | "SIGTERM" | undefined;
+    timeout?: number | undefined;
+}, {}>;
+type LaunchParams = typeof launchSchema.infer;
+/** Structured launch state retained for compact TUI rendering. */
+export interface LaunchToolDetails {
+    op: LaunchParams["op"];
+    daemon?: DaemonSnapshot;
+    daemons?: DaemonSnapshot[];
+    cursor?: number;
+    timedOut?: boolean;
+    /** logs: daemon lifecycle state at read time. */
+    state?: DaemonState;
+    /** logs: virtual terminal rows for display; model-facing content remains sanitized text. */
+    terminalRows?: string[];
+    /** wait: output line that satisfied the pattern. */
+    matched?: string;
+    /** describe: immutable launch spec backing the command/cwd detail lines. */
+    spec?: DaemonSpec;
+}
+declare function approvalFor(params: unknown): ToolApprovalDecision;
+/** Project-scoped launch tool for supervising processes in every coding-agent session. */
+export declare class LaunchTool implements AgentTool<typeof launchSchema, LaunchToolDetails, Theme> {
+    private readonly session;
+    readonly name = "launch";
+    readonly label = "Launch";
+    readonly loadMode = "essential";
+    readonly summary = "Launch and control shared long-running project processes";
+    readonly description: string;
+    readonly parameters: import("arktype/internal/variants/object.ts").ObjectType<{
+        op: "describe" | "list" | "logs" | "restart" | "send" | "start" | "stop" | "wait";
+        name?: string | undefined;
+        application?: string | undefined;
+        args?: string[] | undefined;
+        env?: {
+            [x: string]: string;
+        } | undefined;
+        cwd?: string | undefined;
+        pty?: boolean | undefined;
+        ready?: {
+            log?: string | undefined;
+            port?: number | undefined;
+            host?: string | undefined;
+            timeout?: number | undefined;
+        } | undefined;
+        restart?: "always" | "no" | "on-failure" | undefined;
+        persist?: boolean | undefined;
+        detached?: boolean | undefined;
+        lines?: number | undefined;
+        head?: boolean | undefined;
+        grep?: string | undefined;
+        follow?: boolean | undefined;
+        cursor?: number | undefined;
+        for?: "exit" | "ready" | undefined;
+        pattern?: string | undefined;
+        text?: string | undefined;
+        enter?: boolean | undefined;
+        keys?: string[] | undefined;
+        signal?: "SIGHUP" | "SIGINT" | "SIGKILL" | "SIGQUIT" | "SIGTERM" | undefined;
+        timeout?: number | undefined;
+    }, {}>;
+    readonly strict = true;
+    readonly examples: readonly ToolExample<LaunchParams>[];
+    readonly approval: typeof approvalFor;
+    constructor(session: ToolSession);
+    execute(_toolCallId: string, params: LaunchParams, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<LaunchToolDetails, typeof launchSchema>, _context?: AgentToolContext): Promise<AgentToolResult<LaunchToolDetails>>;
+}
+/** Args shape visible to the renderer, possibly mid-stream (every field optional). */
+type LaunchRenderArgs = Partial<LaunchParams>;
+/** TUI renderer: one status header per op, meta from structured details, capped body lines. */
+export declare const launchToolRenderer: {
+    inline: boolean;
+    mergeCallAndResult: boolean;
+    animatedPendingPreview: boolean;
+    renderCall(args: LaunchRenderArgs, options: RenderResultOptions, theme: Theme): Component;
+    renderResult(result: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        details?: LaunchToolDetails;
+        isError?: boolean;
+    }, options: RenderResultOptions, theme: Theme, args?: LaunchRenderArgs): Component;
+};
+export {};

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

@@ -33,6 +33,8 @@ export declare const PREVIEW_LIMITS: {
     /** Max diff lines shown when collapsed (edit tool) */
     readonly DIFF_COLLAPSED_LINES: 40;
 };
+/** Default number of terminal output rows shown before expansion. */
+export declare const DEFAULT_TERMINAL_PREVIEW_LINES = 10;
 /** Truncation lengths for different content types */
 export declare const TRUNCATE_LENGTHS: {
     /** Short titles, labels */

package/dist/types/tools/terminal-output.d.ts

@@ -0,0 +1,5 @@
+import type { Terminal as XtermTerminal } from "@xterm/headless";
+/** Applies the active tool-output color while preserving safe styles from a virtual terminal row. */
+export declare function styleTerminalRow(row: string, baseForeground: string): string;
+/** Reads terminal screen rows as sanitized text plus only the styles the TUI may replay. */
+export declare function readTerminalRows(terminal: XtermTerminal, startRow: number, rowCount: number): string[];

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

@@ -4,8 +4,8 @@ import type { ToolSession } from "../tools/index.js";
 export type VibeCli = "fast" | "good";
 /**
  * CLI flavor → bundled agent type. This IS the model-tier mapping: `sonic`
- * carries `model: "pi/smol"` (the configured fast/low-latency role) and `task`
- * carries `model: "pi/task"` (inherits the session's strong model).
+ * carries `model: "@smol"` (the configured fast/low-latency role) and `task`
+ * carries `model: "@task"` (inherits the session's strong model).
  * Resolution goes through {@link resolveAgentModelPatterns} exactly like a
  * `task` spawn, so `task.agentModelOverrides` and model-role settings apply.
  */

package/dist/types/web/search/types.d.ts

@@ -83,14 +83,6 @@ export declare const SEARCH_PROVIDER_OPTIONS: readonly [{
     readonly value: "duckduckgo";
     readonly label: "DuckDuckGo";
     readonly description: "Credential-free best-effort fallback; may be bot-challenged on datacenter/shared-egress IPs";
-}, {
-    readonly value: "bing";
-    readonly label: "Bing";
-    readonly description: "Credential-free HTML scrape of Bing results; may be bot-challenged";
-}, {
-    readonly value: "yahoo";
-    readonly label: "Yahoo";
-    readonly description: "Credential-free HTML scrape of Yahoo (Bing-backed) results";
 }, {
     readonly value: "ecosia";
     readonly label: "Ecosia";

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "16.4.8",
+	"version": "16.5.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -49,39 +49,39 @@
 		"bench:guard": "bun scripts/bench-guard.ts"
 	},
 	"dependencies": {
-		"@agentclientprotocol/sdk": "0.25.0",
+		"@agentclientprotocol/sdk": "1.2.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "16.4.8",
-		"@oh-my-pi/omp-stats": "16.4.8",
-		"@oh-my-pi/pi-agent-core": "16.4.8",
-		"@oh-my-pi/pi-ai": "16.4.8",
-		"@oh-my-pi/pi-catalog": "16.4.8",
-		"@oh-my-pi/pi-mnemopi": "16.4.8",
-		"@oh-my-pi/pi-natives": "16.4.8",
-		"@oh-my-pi/pi-tui": "16.4.8",
-		"@oh-my-pi/pi-utils": "16.4.8",
-		"@oh-my-pi/pi-wire": "16.4.8",
-		"@oh-my-pi/snapcompact": "16.4.8",
+		"@oh-my-pi/hashline": "16.5.0",
+		"@oh-my-pi/omp-stats": "16.5.0",
+		"@oh-my-pi/pi-agent-core": "16.5.0",
+		"@oh-my-pi/pi-ai": "16.5.0",
+		"@oh-my-pi/pi-catalog": "16.5.0",
+		"@oh-my-pi/pi-mnemopi": "16.5.0",
+		"@oh-my-pi/pi-natives": "16.5.0",
+		"@oh-my-pi/pi-tui": "16.5.0",
+		"@oh-my-pi/pi-utils": "16.5.0",
+		"@oh-my-pi/pi-wire": "16.5.0",
+		"@oh-my-pi/snapcompact": "16.5.0",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
-		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",
+		"@opentelemetry/exporter-trace-otlp-proto": "^0.220.0",
 		"@opentelemetry/resources": "^2.7.1",
 		"@opentelemetry/sdk-trace-base": "^2.7.1",
 		"@opentelemetry/sdk-trace-node": "^2.7.1",
-		"@puppeteer/browsers": "^3.0.4",
+		"@puppeteer/browsers": "^3.0.6",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",
-		"arktype": "2.2.2",
+		"arktype": "2.2.3",
 		"chalk": "^5.6.2",
 		"diff": "^9.0.0",
-		"fast-xml-parser": "^5.9.0",
+		"fast-xml-parser": "^5.9.3",
 		"handlebars": "^4.7.9",
 		"header-generator": "^2.1.82",
-		"linkedom": "^0.18.12",
-		"lru-cache": "11.5.1",
+		"linkedom": "^0.18.13",
+		"lru-cache": "11.5.2",
 		"mammoth": "^1.12.0",
-		"mupdf": "^1.27.0",
+		"mupdf": "^1.28.0",
 		"puppeteer-core": "25.3.0",
 		"turndown": "7.2.4",
 		"turndown-plugin-gfm": "1.0.2",

package/src/cli/args.ts

@@ -27,6 +27,11 @@ export interface Args {
 	smol?: string;
 	slow?: string;
 	plan?: string;
+	prewalk?: boolean;
+	noPrewalk?: boolean;
+	prewalkInto?: string;
+	planYolo?: boolean;
+	planYoloInto?: string;
 	maxTime?: number;
 	apiKey?: string;
 	systemPrompt?: string;
@@ -231,6 +236,12 @@ export function parseArgs(inputArgs: string[], extensionFlags?: Map<string, { ty
 			result.hideThinking = true;
 		} else if (arg === "--advisor") {
 			result.advisor = true;
+		} else if (arg === "--prewalk") {
+			result.prewalk = true;
+		} else if (arg === "--no-prewalk") {
+			result.noPrewalk = true;
+		} else if (arg === "--plan-yolo") {
+			result.planYolo = true;
 		} else if (arg === "--print" || arg === "-p") {
 			result.print = true;
 		} else if (arg === "--print-thoughts") {

package/src/cli/flag-tables.ts

@@ -121,6 +121,12 @@ export const STRING_SETTERS: Record<string, StringSetter> = {
 	"--plan": (result, value) => {
 		result.plan = value;
 	},
+	"--prewalk-into": (result, value) => {
+		result.prewalkInto = value;
+	},
+	"--plan-yolo-into": (result, value) => {
+		result.planYoloInto = value;
+	},
 	"--max-time": (result, value, deps) => {
 		const seconds = Number(value);
 		if (Number.isFinite(seconds) && seconds > 0) {
@@ -275,6 +281,9 @@ export const VALUELESS_FLAGS: ReadonlySet<string> = new Set([
 	"--no-pty",
 	"--hide-thinking",
 	"--advisor",
+	"--prewalk",
+	"--no-prewalk",
+	"--plan-yolo",
 	"--print",
 	"--print-thoughts",
 	"--no-extensions",