@oh-my-pi/pi-coding-agent 15.6.0 → 15.7.1

package/CHANGELOG.md

@@ -2,6 +2,41 @@
 
 ## [Unreleased]
 
+## [15.7.0] - 2026-05-31
+
+### Added
+
+- Added a `Web search` setup tab that lets users choose the preferred `providers.webSearch` provider during onboarding
+- Added manual authorization-code/redirect URL prompts for OAuth providers that require non-callback login in the setup wizard
+- Added an `omp completions <bash|zsh|fish>` command that prints a shell completion script generated from the live command/flag metadata, so completions never drift from the actual CLI. Subcommands, flags, and enum values complete statically; `--model`/`--smol`/`--slow`/`--plan` resolve against the bundled model catalog and `--resume` against on-disk sessions via a hidden `__complete` helper.
+- Added a `/switch` slash command that opens the temporary model selector for the current session, mirroring the `alt+p` keybinding.
+- Added `replace block N:` and `delete block N` operators to the `edit` tool: they resolve the syntactic block beginning on line N via tree-sitter (native `blockRangeAt`) and replace or delete its full line span, so a construct can be rewritten or removed without counting its closing line. Unresolvable blocks (unsupported language, blank/closing-delimiter line, or a parse error) are rejected with guidance to use an explicit `replace N..M:` / `delete N..M` range.
+- Added an animated pending border for `bash` and `eval` execution blocks: while a command/cell is running, a single dark segment glides clockwise around the block's outer edge (top → right → bottom → left), replacing the previous static accent border. Motion is eased per edge (decelerating into each corner) and timed against a fixed lap duration mapped onto the live perimeter, so streaming a new output line or resizing the terminal nudges the segment proportionally instead of resetting its position. Driven by the existing spinner cadence and gated on the `display.shimmer` setting (no motion when `disabled`).
+- Added `providers.tinyModelDevice` and `providers.tinyModelDtype` settings (Providers tab) controlling local tiny-model acceleration for session titles and Mnemosyne memory tasks. `providers.tinyModelDevice` selects the ONNX execution provider (`default` keeps the platform pick — DirectML on Windows, CUDA on Linux x64, CPU elsewhere); `providers.tinyModelDtype` selects quantization/precision (`default` keeps each model's shipped `q4`, e.g. `fp16` trades speed for fidelity). The `PI_TINY_DEVICE` / `PI_TINY_DTYPE` env vars override the matching setting. Also added `PI_TINY_DTYPE` as the env counterpart to `PI_TINY_DEVICE`; an unrecognized device/precision fails loudly at worker startup instead of silently loading a different one.
+- Added a bundled set of default rules shipped with the agent (TypeScript/Rust convention rules registered as TTSR conditions). They load via the new lowest-priority `builtin-defaults` discovery provider, so any user/project/tool rule of the same name overrides the bundled copy. Disable the whole set with `ttsr.builtinRules: false`, or drop individual rules (bundled or your own) by name via `ttsr.disabledRules`.
+
+### Changed
+
+- Changed setup onboarding to a tabbed `Set up your providers` scene with dedicated `Sign in` and `Web search` panels
+- Changed the glyph mode picker to preselect the currently configured symbol preset instead of always defaulting to Unicode and to show live glyph samples in the picker rows
+- Changed OAuth sign-in flow in the setup wizard so users can authenticate multiple providers before leaving with Escape
+- Changed the plan-approval model-tier slider and the `ctrl+p`/`alt+p` role-cycle status to share one status-line-style chip track: each tier renders in its own role color and the active tier is filled as a powerline chip with a luminance-matched label. The role-cycle status now shows only the chip track — the resolved model and thinking level already live on the status line — instead of the verbose `Switched to <role>: <model> (cycle: …)` line.
+- Changed the in-flight `bash` tool-call preview to render as a full bordered block as soon as the call appears, instead of a one-line `Bash: $ …` status that only expanded into a block once the command produced its first output chunk. Silent commands (e.g. `sleep 30`) now show the framed command block — with the animated pending border — for their whole runtime.
+- Changed local tiny-model inference to request a worker-safe accelerated ONNX execution provider where available (DirectML on Windows, CUDA on Linux x64), with CPU retry if acceleration cannot initialize. `PI_TINY_DEVICE=cpu` restores CPU-only behavior; `PI_TINY_DEVICE=metal` is accepted as a WebGPU alias but guarded back to CPU in the production macOS worker because WebGPU currently hard-crashes Bun on worker teardown.
+
+### Fixed
+
+- Used the native block resolver for hashline operations so `replace block` edits now derive block ranges from file-aware parsing
+- Fixed OAuth login handling to cancel cleanly when users press Esc or Ctrl+C during authentication
+- Fixed the `read` tool description advertising `inspect_image` ("for visual analysis, call `inspect_image`") even when the `inspect_image` tool was disabled, which left the model hunting for a tool absent from its function list. The image section is now gated on `inspect_image.enabled`: when disabled it instead states that reading an image path returns the decoded image inline.
+- Fixed session-title generation latching onto literal text inside fenced code blocks — a pasted UI mockup containing "Welcome to Claude Code v2.1.158" titled the session "Setup Screen for Claude Code v2.1.158" instead of capturing the actual request. The first user message now has fenced code blocks stripped before titling (both the online `pi/smol` and local on-device model paths share the same preprocessing), with a fallback to the original message when stripping would leave too little to title from (e.g. a message that is essentially just a code block).
+- Fixed slash-command autocomplete repaint requests so Windows Terminal sessions with unknown native viewport state keep updating the input box and candidate list. ([#1550](https://github.com/can1357/oh-my-pi/issues/1550))
+- Fixed Python `eval` failing the whole session when the managed `~/.omp/python-env` interpreter exists on disk but no longer runs (e.g. a stale `uv`-managed Python that was removed or upgraded). Availability resolution now enumerates every candidate — active/project venv, the managed env, then the system interpreter — and probes each in priority order, falling through to the first that actually executes instead of failing fast on the first resolved path. The kernel spawns whichever interpreter the probe selected, so a working system Python takes over transparently.
+
+### Removed
+
+- Removed the `recipe` tool and its `recipe.enabled` setting. Task-runner targets (just/package.json/Cargo/make/Taskfile) are invoked directly through `bash`.
+
 ## [15.6.0] - 2026-05-30
 ### Added
 

package/dist/types/capability/rule-buckets.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Rule bucketing
+ *
+ * Single funnel that every discovered rule passes through on its way into a
+ * session. It applies the user's disable levers, registers TTSR rules with the
+ * manager, and splits the rest into the always-apply and rulebook buckets.
+ *
+ * Bucket precedence (matches docs/rulebook-matching-pipeline.md §5):
+ *   1. TTSR     — non-empty `condition` that `TtsrManager.addRule` accepts
+ *   2. always   — `alwaysApply === true`
+ *   3. rulebook — has a `description`
+ */
+import type { TtsrManager } from "../export/ttsr";
+import { type Rule } from "./rule";
+export interface RuleBuckets {
+    rulebookRules: Rule[];
+    alwaysApplyRules: Rule[];
+}
+export interface BucketRulesOptions {
+    /** Rule names to drop entirely (bundled defaults and user rules alike). */
+    disabledRules?: readonly string[];
+    /** When false, drop every rule from the bundled `builtin-defaults` provider. */
+    builtinRules?: boolean;
+}
+/**
+ * Filter and bucket rules, registering TTSR rules on `ttsrManager` as a side
+ * effect. Disabled rules are dropped before any bucket assignment, so a
+ * disabled rule is neither matched as TTSR nor surfaced via `rule://`.
+ */
+export declare function bucketRules(rules: readonly Rule[], ttsrManager: TtsrManager, options?: BucketRulesOptions): RuleBuckets;

package/dist/types/capability/rule.d.ts

@@ -1,4 +1,11 @@
 import type { SourceMeta } from "./types";
+/**
+ * Provider id for the bundled default rules shipped with the agent.
+ * Lowest priority, so any user/project/tool rule of the same name overrides
+ * a bundled default. Also used to gate the whole bundled set via
+ * `ttsr.builtinRules`.
+ */
+export declare const BUILTIN_DEFAULTS_PROVIDER_ID = "builtin-defaults";
 /**
  * Parsed frontmatter from rule files.
  */

package/dist/types/cli/completion-gen.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Shell-completion generation (bash, zsh, fish).
+ *
+ * Single source of truth: the declarative `flags`/`args` descriptors carried by
+ * each `Command` subclass plus the registered subcommand table. {@link buildSpec}
+ * walks that metadata — the same data `renderCommandBody` renders for `--help` —
+ * and {@link generateCompletion} emits a self-contained completion script. Adding
+ * a flag to a command's static `flags` therefore propagates into completions with
+ * no edits here.
+ *
+ * Static candidates (enum `options`, the builtin tool list) are baked into the
+ * script. A small set of flags resolve dynamic candidates (the live model
+ * catalog and on-disk sessions) by calling back into `<bin> __complete <kind>`
+ * — see `commands/complete.ts`. The flag→source mapping below is the only manual
+ * knob and is keyed by flag name so it stays stable as flags are added.
+ */
+import type { CliConfig } from "@oh-my-pi/pi-utils/cli";
+export type Shell = "bash" | "zsh" | "fish";
+/** How a flag/positional value should be completed. */
+export type ValueSource = {
+    kind: "flag";
+} | {
+    kind: "value";
+} | {
+    kind: "enum";
+    values: readonly string[];
+} | {
+    kind: "list";
+    values: readonly string[];
+} | {
+    kind: "models";
+    multiple: boolean;
+} | {
+    kind: "sessions";
+} | {
+    kind: "file";
+} | {
+    kind: "dir";
+};
+export interface CompletionFlag {
+    /** Long name without the leading `--`. */
+    name: string;
+    /** Short character without the leading `-`. */
+    char?: string;
+    description: string;
+    value: ValueSource;
+    /** Flag may appear multiple times (oclif `multiple`). */
+    repeatable: boolean;
+}
+export interface CompletionArg {
+    name: string;
+    description: string;
+    value: ValueSource;
+}
+export interface CompletionCommand {
+    name: string;
+    aliases: readonly string[];
+    description: string;
+    flags: CompletionFlag[];
+    args: CompletionArg[];
+}
+export interface CompletionSpec {
+    bin: string;
+    /** Flags/args of the default (no-subcommand) command. */
+    root: {
+        flags: CompletionFlag[];
+        args: CompletionArg[];
+    };
+    commands: CompletionCommand[];
+}
+/**
+ * Build a {@link CompletionSpec} from loaded command classes.
+ *
+ * @param rootName  Entry name of the default command (its flags become top-level
+ *                  flags; it is excluded from the subcommand list).
+ * @param aliasMap  Canonical-name → aliases (merged from the registration table
+ *                  and the command class's static `aliases`).
+ */
+export declare function buildSpec(config: CliConfig, rootName: string, aliasMap: Map<string, readonly string[]>): CompletionSpec;
+export declare function generateCompletion(shell: Shell, spec: CompletionSpec): string;

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

@@ -0,0 +1,6 @@
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Complete extends Command {
+    static hidden: boolean;
+    static strict: boolean;
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,13 @@
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Completions extends Command {
+    static description: string;
+    static args: {
+        shell: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: true;
+            options: readonly ["bash", "zsh", "fish"];
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

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

@@ -1,8 +1,17 @@
 /**
- * Install dependencies for optional features.
+ * Run onboarding setup or install dependencies for optional features.
  */
 import { Command } from "@oh-my-pi/pi-utils/cli";
 import { type SetupComponent } from "../cli/setup-cli";
+import { runRootCommand } from "../main";
+export interface OnboardingSetupDependencies {
+    runRoot?: typeof runRootCommand;
+    stdinIsTTY?: boolean;
+    stdoutIsTTY?: boolean;
+    writeStderr?: (text: string) => void;
+    exit?: (code: number) => never;
+}
+export declare function runOnboardingSetup(deps?: OnboardingSetupDependencies): Promise<void>;
 export default class Setup extends Command {
     static description: string;
     static args: {

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

@@ -105,6 +105,10 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly setupVersion: {
+        readonly type: "number";
+        readonly default: 0;
+    };
     readonly "auth.broker.url": {
         readonly type: "string";
         readonly default: undefined;
@@ -1142,6 +1146,15 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Skip welcome screen and startup status messages";
         };
     };
+    readonly "startup.setupWizard": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly label: "Setup Wizard";
+            readonly description: "Show newly added onboarding steps once per setup version";
+        };
+    };
     readonly "startup.checkUpdate": {
         readonly type: "boolean";
         readonly default: true;
@@ -2050,6 +2063,24 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "ttsr.builtinRules": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "context";
+            readonly label: "Builtin Rules";
+            readonly description: "Load the default rules shipped with the agent (override individually with ttsr.disabledRules)";
+        };
+    };
+    readonly "ttsr.disabledRules": {
+        readonly type: "array";
+        readonly default: string[];
+        readonly ui: {
+            readonly tab: "context";
+            readonly label: "Disabled Rules";
+            readonly description: "Rule names to ignore entirely (applies to bundled defaults and your own rules)";
+        };
+    };
     readonly "edit.mode": {
         readonly type: "enum";
         readonly values: import("..").EditMode[];
@@ -2363,7 +2394,7 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "write";
                 readonly label: "Write";
-                readonly description: "Auto-approve read-only and write tools; require confirmation for exec tools such as bash, eval, browser, task, recipe, and ssh.";
+                readonly description: "Auto-approve read-only and write tools; require confirmation for exec tools such as bash, eval, browser, task, and ssh.";
             }, {
                 readonly value: "yolo";
                 readonly label: "Yolo";
@@ -2570,15 +2601,6 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the tts tool for xAI Grok Voice speech synthesis";
         };
     };
-    readonly "recipe.enabled": {
-        readonly type: "boolean";
-        readonly default: true;
-        readonly ui: {
-            readonly tab: "tools";
-            readonly label: "Recipe";
-            readonly description: "Enable the recipe tool when a justfile / package.json / Cargo.toml / Makefile / Taskfile is present";
-        };
-    };
     readonly "inspect_image.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -3356,6 +3378,140 @@ export declare const SETTINGS_SCHEMA: {
             })[];
         };
     };
+    readonly "providers.tinyModelDevice": {
+        readonly type: "enum";
+        readonly values: readonly ["default", "gpu", "cpu", "metal", "webgpu", "cuda", "dml", "coreml", "auto", "wasm", "webnn", "webnn-gpu", "webnn-cpu", "webnn-npu"];
+        readonly default: "default";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly label: "Tiny Model Device";
+            readonly description: "ONNX execution provider for local tiny models (titles + memory). Default picks DirectML on Windows, CUDA on Linux x64, CPU elsewhere. The PI_TINY_DEVICE env var overrides this.";
+            readonly options: readonly [{
+                readonly value: "default";
+                readonly label: "Default";
+                readonly description: "DirectML on Windows, CUDA on Linux x64, CPU elsewhere";
+            }, {
+                readonly value: "gpu";
+                readonly label: "GPU";
+                readonly description: "Accelerated provider (WebGPU/Metal, CUDA, or DirectML)";
+            }, {
+                readonly value: "cpu";
+                readonly label: "CPU";
+                readonly description: "CPU-only inference";
+            }, {
+                readonly value: "metal";
+                readonly label: "Metal";
+                readonly description: "WebGPU alias for Apple GPUs";
+            }, {
+                readonly value: "webgpu";
+                readonly label: "WebGPU";
+                readonly description: "WebGPU/Metal backend";
+            }, {
+                readonly value: "cuda";
+                readonly label: "CUDA";
+                readonly description: "NVIDIA CUDA (Linux x64)";
+            }, {
+                readonly value: "dml";
+                readonly label: "DirectML";
+                readonly description: "DirectML backend (Windows)";
+            }, {
+                readonly value: "coreml";
+                readonly label: "CoreML";
+                readonly description: "Apple CoreML (opt-in; can fail to load)";
+            }, {
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Let ONNX Runtime choose a provider";
+            }, {
+                readonly value: "wasm";
+                readonly label: "WASM";
+                readonly description: "WebAssembly backend";
+            }, {
+                readonly value: "webnn";
+                readonly label: "WebNN";
+                readonly description: "WebNN backend";
+            }, {
+                readonly value: "webnn-gpu";
+                readonly label: "WebNN GPU";
+                readonly description: "WebNN GPU device";
+            }, {
+                readonly value: "webnn-cpu";
+                readonly label: "WebNN CPU";
+                readonly description: "WebNN CPU device";
+            }, {
+                readonly value: "webnn-npu";
+                readonly label: "WebNN NPU";
+                readonly description: "WebNN NPU device";
+            }];
+        };
+    };
+    readonly "providers.tinyModelDtype": {
+        readonly type: "enum";
+        readonly values: readonly ["default", "q4", "q4f16", "q8", "fp16", "fp32", "int8", "uint8", "bnb4", "q2", "q2f16", "q1", "q1f16", "auto"];
+        readonly default: "default";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly label: "Tiny Model Precision";
+            readonly description: "ONNX quantization/precision for local tiny models. Default uses each model's shipped dtype (q4); lower precision is faster, higher is more faithful. The PI_TINY_DTYPE env var overrides this.";
+            readonly options: readonly [{
+                readonly value: "default";
+                readonly label: "Default";
+                readonly description: "Each model's shipped dtype (currently q4)";
+            }, {
+                readonly value: "q4";
+                readonly label: "q4";
+                readonly description: "4-bit weights; smallest and fastest";
+            }, {
+                readonly value: "q4f16";
+                readonly label: "q4f16";
+                readonly description: "4-bit weights with fp16 activations";
+            }, {
+                readonly value: "q8";
+                readonly label: "q8";
+                readonly description: "8-bit quantization";
+            }, {
+                readonly value: "fp16";
+                readonly label: "fp16";
+                readonly description: "16-bit float; higher fidelity, larger";
+            }, {
+                readonly value: "fp32";
+                readonly label: "fp32";
+                readonly description: "Full precision; largest and slowest";
+            }, {
+                readonly value: "int8";
+                readonly label: "int8";
+                readonly description: "Signed 8-bit integer";
+            }, {
+                readonly value: "uint8";
+                readonly label: "uint8";
+                readonly description: "Unsigned 8-bit integer";
+            }, {
+                readonly value: "bnb4";
+                readonly label: "bnb4";
+                readonly description: "bitsandbytes 4-bit";
+            }, {
+                readonly value: "q2";
+                readonly label: "q2";
+                readonly description: "2-bit weights";
+            }, {
+                readonly value: "q2f16";
+                readonly label: "q2f16";
+                readonly description: "2-bit weights with fp16 activations";
+            }, {
+                readonly value: "q1";
+                readonly label: "q1";
+                readonly description: "1-bit weights";
+            }, {
+                readonly value: "q1f16";
+                readonly label: "q1f16";
+                readonly description: "1-bit weights with fp16 activations";
+            }, {
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Let transformers.js choose per device";
+            }];
+        };
+    };
     readonly "providers.memoryModel": {
         readonly type: "enum";
         readonly values: readonly ["online", "qwen3-1.7b", "gemma-3-1b", "qwen2.5-1.5b", "lfm2-1.2b"];
@@ -3743,6 +3899,10 @@ export interface TtsrSettings {
     interruptMode: "never" | "prose-only" | "tool-only" | "always";
     repeatMode: "once" | "after-gap";
     repeatGap: number;
+    /** Bucketing-only (read by bucketRules, not the TtsrManager). */
+    builtinRules?: boolean;
+    /** Bucketing-only (read by bucketRules, not the TtsrManager). */
+    disabledRules?: string[];
 }
 export interface ExaSettings {
     enabled: boolean;

package/dist/types/discovery/builtin-defaults.d.ts

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

package/dist/types/discovery/builtin-rules/index.d.ts

@@ -0,0 +1,7 @@
+/** A bundled rule's stable name and raw markdown (frontmatter + body). */
+export interface BuiltinRuleSource {
+    name: string;
+    content: string;
+}
+/** All bundled default rules, ordered by name. */
+export declare const BUILTIN_RULE_SOURCES: readonly BuiltinRuleSource[];

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

@@ -20,6 +20,7 @@ import "../capability/system-prompt";
 import "../capability/tool";
 import "./agents-md";
 import "./builtin";
+import "./builtin-defaults";
 import "./claude";
 import "./claude-plugins";
 import "./cline";

package/dist/types/edit/hashline/block-resolver.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tree-sitter-backed {@link BlockResolver} for the hashline `replace block N:`
+ * operator. Bridges the pure hashline seam to the native `blockRangeAt`
+ * primitive in `@oh-my-pi/pi-natives`, which infers the language from the file
+ * path and returns the 1-indexed line span of the syntactic block beginning on
+ * the requested line (or `null` when none can be resolved).
+ */
+import type { BlockResolver } from "@oh-my-pi/hashline";
+export declare const nativeBlockResolver: BlockResolver;

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

@@ -1,3 +1,4 @@
+export * from "./block-resolver";
 export * from "./diff";
 export * from "./execute";
 export * from "./filesystem";

package/dist/types/eval/py/kernel.d.ts

@@ -1,4 +1,5 @@
 import { type KernelDisplayOutput } from "./display";
+import { type PythonRuntime } from "./runtime";
 export type { KernelDisplayOutput, PythonStatusEvent } from "./display";
 export { renderKernelDisplay } from "./display";
 export type KernelRuntimeEnv = Record<string, string | null>;
@@ -53,6 +54,8 @@ export interface PythonKernelAvailability {
     ok: boolean;
     pythonPath?: string;
     reason?: string;
+    /** The probed-working runtime, when one was found. */
+    runtime?: PythonRuntime;
 }
 export declare function checkPythonKernelAvailability(cwd: string): Promise<PythonKernelAvailability>;
 export declare class PythonKernel {

package/dist/types/eval/py/runtime.d.ts

@@ -16,6 +16,16 @@ export declare function filterEnv(env: Record<string, string | undefined>): Reco
  */
 export declare function resolveVenvPath(cwd: string): string | undefined;
 /**
- * Resolve Python runtime including executable path, environment, and venv detection.
+ * Enumerate candidate Python runtimes in priority order: an active/project venv,
+ * the managed `~/.omp/python-env`, then the system interpreter on PATH. Every
+ * candidate that physically exists is returned so callers can probe each in turn
+ * rather than committing to the first — a managed env left behind by a removed
+ * `uv` install no longer shadows a working system Python.
+ */
+export declare function enumeratePythonRuntimes(cwd: string, baseEnv: Record<string, string | undefined>): PythonRuntime[];
+/**
+ * Resolve the highest-priority Python runtime. Prefer {@link enumeratePythonRuntimes}
+ * when you can probe candidates; this returns only the first one and throws when
+ * no interpreter exists.
  */
 export declare function resolvePythonRuntime(cwd: string, baseEnv: Record<string, string | undefined>): PythonRuntime;