@oh-my-pi/pi-coding-agent 15.9.3 → 15.9.67

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

@@ -32,6 +32,7 @@ export type CompactionQueuedMessage = {
 export type SubmittedUserInput = {
     text: string;
     images?: ImageContent[];
+    imageLinks?: (string | undefined)[];
     customType?: string;
     display?: boolean;
     cancelled: boolean;
@@ -60,6 +61,7 @@ export interface InteractiveModeContext {
     todoContainer: Container;
     btwContainer: Container;
     omfgContainer: Container;
+    errorBannerContainer: Container;
     editor: CustomEditor;
     editorContainer: Container;
     hookWidgetContainerAbove: Container;
@@ -87,6 +89,7 @@ export interface InteractiveModeContext {
     planModePlanFilePath?: string;
     hideThinkingBlock: boolean;
     pendingImages: ImageContent[];
+    pendingImageLinks: (string | undefined)[];
     compactionQueuedMessages: CompactionQueuedMessage[];
     pendingTools: Map<string, ToolExecutionHandle>;
     pendingBashComponents: BashExecutionComponent[];
@@ -130,6 +133,8 @@ export interface InteractiveModeContext {
         dim?: boolean;
     }): void;
     showError(message: string): void;
+    showPinnedError(message: string): void;
+    clearPinnedError(): void;
     showWarning(message: string): void;
     showNewVersionNotification(newVersion: string): void;
     clearEditor(): void;
@@ -146,6 +151,7 @@ export interface InteractiveModeContext {
     startPendingSubmission(input: {
         text: string;
         images?: ImageContent[];
+        imageLinks?: (string | undefined)[];
         customType?: string;
         display?: boolean;
     }): SubmittedUserInput;
@@ -170,6 +176,7 @@ export interface InteractiveModeContext {
     isKnownSlashCommand(text: string): boolean;
     addMessageToChat(message: AgentMessage, options?: {
         populateHistory?: boolean;
+        imageLinks?: readonly (string | undefined)[];
     }): Component[];
     renderSessionContext(sessionContext: SessionContext, options?: {
         updateFooter?: boolean;
@@ -190,7 +197,6 @@ export interface InteractiveModeContext {
     toggleTodoExpansion(): void;
     handleExportCommand(text: string): Promise<void>;
     handleShareCommand(): Promise<void>;
-    handleCopyCommand(sub?: string): void;
     handleTodoCommand(args: string): Promise<void>;
     handleSessionCommand(): Promise<void>;
     handleJobsCommand(): Promise<void>;
@@ -228,6 +234,7 @@ export interface InteractiveModeContext {
     }): void;
     showPluginSelector(mode?: "install" | "uninstall"): void;
     showUserMessageSelector(): void;
+    showCopySelector(): void;
     showTreeSelector(): void;
     showSessionSelector(): void;
     handleResumeSession(sessionPath: string): Promise<void>;

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

@@ -0,0 +1,53 @@
+import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
+/** A fenced code block extracted from assistant markdown. */
+export interface CodeBlock {
+    /** Info string after the opening fence (language id), trimmed. */
+    lang: string;
+    /** Block body with the trailing newline stripped. */
+    code: string;
+}
+/** A runnable command found in the transcript. */
+export interface LastCommand {
+    kind: "bash" | "eval";
+    code: string;
+    /** Highlight language: "bash" for bash, "python"/"javascript" for eval. */
+    language: string;
+}
+/**
+ * A node in the `/copy` picker tree. Leaves carry `content` (placed on the
+ * clipboard) plus `copyMessage` (the status shown afterwards); groups carry
+ * `children` to drill into.
+ */
+export interface CopyTarget {
+    /** Stable identifier (e.g. "msg:1", "msg:1:code:0", "msg:1:all", "cmd:1"). */
+    id: string;
+    label: string;
+    /** Dim annotation: line/block counts, language, or tool name. */
+    hint?: string;
+    /** Full text rendered in the preview pane. */
+    preview: string;
+    /** Highlight language for code/command previews (undefined = plain/markdown). */
+    language?: string;
+    /** Leaf: text copied to the clipboard. */
+    content?: string;
+    /** Leaf: status message shown after copying. */
+    copyMessage?: string;
+    /** Group: nested targets to drill into. */
+    children?: CopyTarget[];
+}
+/** Minimal session surface needed to assemble copy targets (eases testing). */
+export interface CopySource {
+    readonly messages: readonly AgentMessage[];
+    getLastVisibleHandoffText(): string | undefined;
+}
+/** Extract fenced code blocks from assistant markdown, in document order. */
+export declare function extractCodeBlocks(text: string): CodeBlock[];
+/** Walk the transcript backwards for the most recent bash command or eval code. */
+export declare function extractLastCommand(messages: readonly AgentMessage[]): LastCommand | undefined;
+/**
+ * Assemble the unified `/copy` target tree: recent assistant messages
+ * (most recent first, each drillable into its code blocks), runnable command
+ * targets interleaved after the assistant message that issued them, and a
+ * fresh-handoff fallback when no assistant message exists yet.
+ */
+export declare function buildCopyTargets(source: CopySource): CopyTarget[];

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

@@ -24,6 +24,7 @@ export declare class UiHelpers {
     }): void;
     addMessageToChat(message: AgentMessage, options?: {
         populateHistory?: boolean;
+        imageLinks?: readonly (string | undefined)[];
     }): Component[];
     /**
      * Render session context to chat. Used for initial load and rebuild after compaction.

package/dist/types/session/blob-store.d.ts

@@ -1,15 +1,16 @@
+export interface BlobPutOptions {
+    /** Optional file extension for a sidecar hardlink/copy that OS openers can type-detect. */
+    extension?: string;
+}
 export interface BlobPutResult {
     hash: string;
+    /** Canonical content-addressed path, always `<dir>/<sha256-hex>`. */
     path: string;
+    /** Path with the requested extension when supplied, otherwise the canonical path. */
+    displayPath: string;
     get ref(): string;
 }
-/**
- * Content-addressed blob store for externalizing large binary data (images) from session JSONL files.
- *
- * Files are stored at `<dir>/<sha256-hex>` with no extension. The SHA-256 hash is computed
- * over the raw binary data (not base64). Content-addressing makes writes idempotent and
- * provides automatic deduplication across sessions.
- */
+export declare function blobExtensionForImageMimeType(mimeType: string | undefined): string | undefined;
 export declare class BlobStore {
     readonly dir: string;
     constructor(dir: string);
@@ -17,13 +18,13 @@ export declare class BlobStore {
      * Write binary data to the blob store.
      * @returns SHA-256 hex hash of the data
      */
-    put(data: Buffer): Promise<BlobPutResult>;
+    put(data: Buffer, options?: BlobPutOptions): Promise<BlobPutResult>;
     /**
      * Synchronous variant of {@link put}. Use on persistence hot paths where the caller
      * cannot afford the microtask hops of the async version (e.g. OOM-safe session writes).
      * Returns once the bytes are in the kernel page cache.
      */
-    putSync(data: Buffer): BlobPutResult;
+    putSync(data: Buffer, options?: BlobPutOptions): BlobPutResult;
     /** Read blob by hash, returns Buffer or null if not found. */
     get(hash: string): Promise<Buffer | null>;
     /** Check if a blob exists. */
@@ -46,9 +47,9 @@ export declare function externalizeImageDataUrlSync(blobStore: BlobStore, dataUr
  * Externalize an image's base64 data to the blob store, returning a blob reference.
  * If the data is already a blob reference, returns it unchanged.
  */
-export declare function externalizeImageData(blobStore: BlobStore, base64Data: string): Promise<string>;
+export declare function externalizeImageData(blobStore: BlobStore, base64Data: string, mimeType?: string): Promise<string>;
 /** Synchronous variant of {@link externalizeImageData}. */
-export declare function externalizeImageDataSync(blobStore: BlobStore, base64Data: string): string;
+export declare function externalizeImageDataSync(blobStore: BlobStore, base64Data: string, mimeType?: string): string;
 /**
  * Resolve an externalized provider image data URL back to its original string.
  * If the data is not a blob reference, returns it unchanged.

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

@@ -1,7 +1,7 @@
 import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import type { ImageContent, Message, MessageAttribution, ServiceTier, TextContent } from "@oh-my-pi/pi-ai";
 import { ArtifactManager } from "./artifacts";
-import { type BlobPutResult } from "./blob-store";
+import { type BlobPutOptions, type BlobPutResult } from "./blob-store";
 import { type BashExecutionMessage, type CustomMessage, type FileMentionMessage, type HookMessage, type PythonExecutionMessage } from "./messages";
 import type { SessionStorage } from "./session-storage";
 export declare const CURRENT_SESSION_VERSION = 3;
@@ -208,7 +208,7 @@ export interface SessionInfo {
      */
     status?: SessionStatus;
 }
-export type ReadonlySessionManager = Pick<SessionManager, "getCwd" | "getSessionDir" | "getSessionId" | "getSessionFile" | "getSessionName" | "getArtifactsDir" | "getArtifactManager" | "allocateArtifactPath" | "saveArtifact" | "getArtifactPath" | "getLeafId" | "getLeafEntry" | "getEntry" | "getLabel" | "getBranch" | "getHeader" | "getEntries" | "getTree" | "getUsageStatistics" | "putBlob">;
+export type ReadonlySessionManager = Pick<SessionManager, "getCwd" | "getSessionDir" | "getSessionId" | "getSessionFile" | "getSessionName" | "getArtifactsDir" | "getArtifactManager" | "allocateArtifactPath" | "saveArtifact" | "getArtifactPath" | "getLeafId" | "getLeafEntry" | "getEntry" | "getLabel" | "getBranch" | "getHeader" | "getEntries" | "getTree" | "getUsageStatistics" | "putBlob" | "putBlobSync">;
 /** Exported for testing */
 export declare function migrateSessionEntries(entries: FileEntry[]): void;
 /** Exported for compaction.test.ts */
@@ -294,7 +294,9 @@ export declare class SessionManager {
     private readonly storage;
     private constructor();
     /** Puts a binary blob into the blob store and returns the blob reference */
-    putBlob(data: Buffer): Promise<BlobPutResult>;
+    putBlob(data: Buffer, options?: BlobPutOptions): Promise<BlobPutResult>;
+    /** Synchronous variant of {@link putBlob} for rebuild-only render paths. */
+    putBlobSync(data: Buffer, options?: BlobPutOptions): BlobPutResult;
     captureState(): SessionManagerStateSnapshot;
     restoreState(snapshot: SessionManagerStateSnapshot): void;
     /** Switch to a different session file (used for resume and branching) */

package/dist/types/system-prompt.d.ts

@@ -84,6 +84,8 @@ export interface BuildSystemPromptOptions {
     workspaceTree?: WorkspaceTree | Promise<WorkspaceTree>;
     /** Whether the local memory://root summary is active. */
     memoryRootEnabled?: boolean;
+    /** Active model identifier (e.g. "anthropic/claude-opus-4") surfaced to the agent. */
+    model?: string;
 }
 /** Result of building provider-facing system prompt messages. */
 export interface BuildSystemPromptResult {

package/dist/types/tiny/title-client.d.ts

@@ -1,5 +1,19 @@
 import type { Subprocess } from "bun";
-import type { TinyTitleProgressEvent, TinyTitleWorkerOutbound } from "./title-protocol";
+import type { TinyTitleProgressEvent, TinyTitleWorkerInbound, TinyTitleWorkerOutbound } from "./title-protocol";
+/**
+ * Abstraction over the tiny-model subprocess. Modelled as a worker interface
+ * so existing callers (titles, memory completions, downloads) compose the
+ * same way; the runtime implementation is a Bun child process so
+ * `onnxruntime-node`'s NAPI finalizer never runs inside the main agent
+ * address space — that destructor segfaults Bun on Windows during shutdown
+ * (issue #1606).
+ */
+interface WorkerHandle {
+    send(message: TinyTitleWorkerInbound): void;
+    onMessage(handler: (message: TinyTitleWorkerOutbound) => void): () => void;
+    onError(handler: (error: Error) => void): () => void;
+    terminate(): Promise<void>;
+}
 export interface TinyTitleDownloadOptions {
     signal?: AbortSignal;
     onProgress?: (event: TinyTitleProgressEvent) => void;
@@ -39,6 +53,7 @@ interface SpawnedSubprocess {
 export declare function createTinyTitleSubprocess(): SpawnedSubprocess;
 export declare class TinyTitleClient {
     #private;
+    constructor(spawnWorker?: () => WorkerHandle);
     onProgress(listener: (event: TinyTitleProgressEvent) => void): () => void;
     generate(modelKey: string, message: string, signal?: AbortSignal): Promise<string | null>;
     complete(modelKey: string, prompt: string, options?: {

package/dist/types/tool-discovery/mode.d.ts

@@ -0,0 +1,8 @@
+import type { Settings } from "../config/settings";
+import type { SettingValue } from "../config/settings-schema";
+export declare const TOOL_DISCOVERY_AUTO_THRESHOLD = 40;
+export declare const TOOL_DISCOVERY_SEARCH_TOOL_NAME = "search_tool_bm25";
+export type ToolDiscoveryModeSetting = SettingValue<"tools.discoveryMode">;
+export type EffectiveToolDiscoveryMode = Exclude<ToolDiscoveryModeSetting, "auto">;
+export declare function countToolsForAutoDiscovery(toolNames: Iterable<string>): number;
+export declare function resolveEffectiveToolDiscoveryMode(settings: Settings, toolCount: number): EffectiveToolDiscoveryMode;

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

@@ -21,7 +21,11 @@ interface TarStorage {
 }
 interface ZipStorage {
     type: "zip";
-    bytes: Uint8Array;
+    archivePath: string;
+    compressedSize: number;
+    compression: number;
+    flags: number;
+    localHeaderOffset: number;
 }
 type EntryStorage = TarStorage | ZipStorage;
 interface ArchiveIndexEntry extends ArchiveNode {

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

@@ -13,6 +13,14 @@ import type { EvalStatusEvent, EvalToolDetails } from "../eval/types";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import { type Theme } from "../modes/theme/theme";
 export declare const EVAL_DEFAULT_PREVIEW_LINES = 10;
+/**
+ * Rows of source kept in the *pending* eval preview. The window follows the
+ * streaming edge (newest lines pinned to the bottom) so you can watch the code
+ * being written, while staying bounded — a volatile tool block taller than the
+ * viewport would otherwise strand its scrolled-off head out of native scrollback
+ * on ED3-risk terminals. Matches the streaming windows used by edit/write.
+ */
+export declare const EVAL_STREAMING_PREVIEW_LINES = 12;
 interface EvalRenderCellArg {
     language?: string;
     code?: string;

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

@@ -76,6 +76,31 @@ export declare function formatBadge(label: string, color: ToolUIColor, theme: Th
  * Uses consistent wording pattern.
  */
 export declare function formatMoreItems(remaining: number, itemType: string): string;
+/**
+ * Maximum rows a tool's streaming/pending *call* preview may render before it is
+ * capped. This is intentionally conservative: the preview still sits inside a
+ * transcript that already consumed some viewport rows, and tool blocks carry
+ * extra chrome (status/header/border/"more lines"), so a "reasonable" raw code
+ * or command preview like 10-12 lines can still overflow and strand its top
+ * while the block is volatile. Keeping the live call window short avoids that
+ * across terminals without turning the transcript into an interactive scroller.
+ */
+export declare const CALL_PREVIEW_MAX_LINES = 6;
+/**
+ * Cap a pre-rendered pending/call preview to a bounded window. When truncated,
+ * show both the head and the live tail so the user can still see what the tool
+ * is currently writing while the volatile block stays short enough not to strand
+ * its top above the viewport. `Ctrl+O` widens the bounded window, but does not
+ * fully uncap live tool previews for the same reason.
+ *
+ * `prefix` (raw, e.g. a dim tree gutter) is prepended to the summary line so
+ * nested previews stay aligned.
+ */
+export declare function capPreviewLines(lines: string[], theme: Theme, options?: {
+    max?: number;
+    expanded?: boolean;
+    prefix?: string;
+}): string[];
 export declare function formatMeta(meta: string[], theme: Theme): string;
 export declare function formatErrorMessage(message: string | undefined, theme: Theme): string;
 export declare function formatEmptyMessage(message: string, theme: Theme): string;

package/dist/types/tui/code-cell.d.ts

@@ -11,6 +11,12 @@ export interface CodeCellOptions {
     output?: string;
     outputMaxLines?: number;
     codeMaxLines?: number;
+    /**
+     * Show the LAST `codeMaxLines` rows (the live streaming edge) instead of the
+     * first, with a "… N earlier lines" marker on top. Lets a pending preview
+     * follow code as it is written while staying bounded. Ignored when `expanded`.
+     */
+    codeTail?: boolean;
     expanded?: boolean;
     /** Animate the cell border with a sweeping segment while pending/running. */
     animate?: boolean;

package/dist/types/tui/hyperlink.d.ts

@@ -7,6 +7,18 @@
  * - `"always"`: unconditionally (useful for viewers that support OSC 8 without advertising it)
  */
 export declare function isHyperlinkEnabled(): boolean;
+/**
+ * Wrap `displayText` in an OSC 8 hyperlink pointing at `uri`.
+ *
+ * Returns `displayText` unchanged when hyperlinks are disabled, `uri` contains
+ * terminal control bytes, or `displayText` already contains an OSC 8 sequence.
+ */
+export declare function uriHyperlink(uri: string, displayText: string): string;
+/**
+ * Wrap `displayText` in an OSC 8 hyperlink pointing at an HTTP(S) URL.
+ * `www.example.com` inputs are linked as `https://www.example.com`.
+ */
+export declare function urlHyperlink(url: string, displayText: string): string;
 /**
  * Wrap `displayText` in an OSC 8 hyperlink pointing at the given absolute file path.
  *

package/dist/types/tui/output-block.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Bordered output container with optional header and sections.
+ */
+import type { Component } from "@oh-my-pi/pi-tui";
 import type { Theme } from "../modes/theme/theme";
 import type { State } from "./types";
 export interface OutputBlockOptions {
@@ -13,6 +17,12 @@ export interface OutputBlockOptions {
     /** Animate the border with a sweeping dark segment (pending/running state). */
     animate?: boolean;
 }
+declare const FRAMED_BLOCK_COMPONENT: unique symbol;
+export type FramedBlockComponent = Component & {
+    [FRAMED_BLOCK_COMPONENT]?: true;
+};
+export declare function markFramedBlockComponent<T extends Component>(component: T): T & FramedBlockComponent;
+export declare function isFramedBlockComponent(component: Component): boolean;
 /**
  * Monotonic frame counter for animated borders, quantized to the TUI's ~16ms
  * render cap so the cache key advances once per ~60fps frame — fine enough for a
@@ -44,3 +54,4 @@ export declare class CachedOutputBlock {
     /** Invalidate the cache, forcing a rebuild on next render. */
     invalidate(): void;
 }
+export {};

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

@@ -5,7 +5,7 @@
  */
 import type { Component } from "@oh-my-pi/pi-tui";
 import type { RenderResultOptions } from "../../extensibility/custom-tools/types";
-import type { Theme } from "../../modes/theme/theme";
+import { type Theme } from "../../modes/theme/theme";
 import type { SearchResponse } from "./types";
 export interface SearchRenderDetails {
     response: SearchResponse;
@@ -20,7 +20,6 @@ export declare function renderSearchResult(result: {
     details?: SearchRenderDetails;
 }, options: RenderResultOptions, theme: Theme, args?: {
     query?: string;
-    allowLongAnswer?: boolean;
     maxAnswerLines?: number;
 }): Component;
 /** Render web search call (query preview) */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.9.3",
+	"version": "15.9.67",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -47,14 +47,14 @@
 		"@agentclientprotocol/sdk": "0.22.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "15.9.3",
-		"@oh-my-pi/omp-stats": "15.9.3",
-		"@oh-my-pi/pi-agent-core": "15.9.3",
-		"@oh-my-pi/pi-ai": "15.9.3",
-		"@oh-my-pi/pi-mnemopi": "15.9.3",
-		"@oh-my-pi/pi-natives": "15.9.3",
-		"@oh-my-pi/pi-tui": "15.9.3",
-		"@oh-my-pi/pi-utils": "15.9.3",
+		"@oh-my-pi/hashline": "15.9.67",
+		"@oh-my-pi/omp-stats": "15.9.67",
+		"@oh-my-pi/pi-agent-core": "15.9.67",
+		"@oh-my-pi/pi-ai": "15.9.67",
+		"@oh-my-pi/pi-mnemopi": "15.9.67",
+		"@oh-my-pi/pi-natives": "15.9.67",
+		"@oh-my-pi/pi-tui": "15.9.67",
+		"@oh-my-pi/pi-utils": "15.9.67",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",

package/src/autoresearch/dashboard.ts

@@ -1,4 +1,4 @@
-import { matchesKey, replaceTabs, Text, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
+import { matchesKey, replaceTabs, ScrollView, Text, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
 import type { Theme } from "../modes/theme/theme";
 import { formatElapsed, formatNum, isBetter } from "./helpers";
 import { currentResults, findBaselineMetric, findBaselineRunNumber, findBaselineSecondary } from "./state";
@@ -76,14 +76,14 @@ export function createDashboardController(): DashboardController {
 							const viewportRows = Math.max(4, terminalRows - 4);
 							const maxScroll = Math.max(0, body.length - viewportRows);
 							if (scrollOffset > maxScroll) scrollOffset = maxScroll;
-							const visible = body.slice(scrollOffset, scrollOffset + viewportRows);
-							const footer = renderOverlayFooter(width, scrollOffset, viewportRows, body.length, theme);
-							return [
-								header,
-								...visible,
-								...Array.from({ length: Math.max(0, viewportRows - visible.length) }, () => ""),
-								footer,
-							];
+							const sv = new ScrollView(body.slice(scrollOffset, scrollOffset + viewportRows), {
+								height: viewportRows,
+								scrollbar: "auto",
+								totalRows: body.length,
+								theme: { track: t => theme.fg("dim", t), thumb: t => theme.fg("accent", t) },
+							});
+							sv.setScrollOffset(scrollOffset);
+							return [header, ...sv.render(width), renderOverlayFooter(width, theme)];
 						},
 						handleInput(data: string): void {
 							const totalRows =
@@ -406,18 +406,8 @@ function renderOverlayRunningLine(
 	);
 }
 
-function renderOverlayFooter(
-	width: number,
-	scrollOffset: number,
-	viewportRows: number,
-	totalRows: number,
-	theme: Theme,
-): string {
-	const position =
-		totalRows > viewportRows
-			? ` ${scrollOffset + 1}-${Math.min(totalRows, scrollOffset + viewportRows)}/${totalRows}`
-			: "";
-	const hint = theme.fg("dim", ` up/down j/k pageup pagedown g G esc${position} `);
+function renderOverlayFooter(width: number, theme: Theme): string {
+	const hint = theme.fg("dim", " up/down j/k pageup pagedown g G esc ");
 	const fill = Math.max(0, width - visibleWidth(hint));
 	return theme.fg("borderMuted", "-".repeat(fill)) + hint;
 }

package/src/cli/classify-install-target.ts

@@ -1,7 +1,11 @@
 /**
- * Classify an install spec as a marketplace plugin reference or a plain npm package.
+ * Classify an install spec as a local path, marketplace plugin reference, or
+ * plain npm package.
  *
  * Rules (applied in order):
+ *  0. Looks like a filesystem path (`.`, `..`, `./…`, `..\…`, `/…`, `~/…`,
+ *     `C:\…`, `\\unc`) -> local. Routed through `PluginManager.link()` so the
+ *     `omp plugin install <path>` and `omp plugin link <path>` flows agree.
  *  1. Starts with `@` (scoped npm) -> always npm.
  *  2. Contains `@` after the first character -> split on the LAST `@`.
  *     If the right-hand side is a known marketplace name, it's a marketplace ref.
@@ -25,10 +29,32 @@ const NPM_DIST_TAGS = new Set([
 // Semver-like: starts with digit, or contains version range prefixes
 const LOOKS_LIKE_VERSION = /^[\d~^>=<]/;
 
-export function classifyInstallTarget(
-	spec: string,
-	knownMarketplaces: Set<string>,
-): { type: "marketplace"; name: string; marketplace: string } | { type: "npm"; spec: string } {
+/**
+ * Detect specs that name a filesystem path rather than a package: bare `.` /
+ * `..`, cwd-relative (`./`, `../`, `.\`, `..\`), absolute (`/`, `C:\`, `C:/`,
+ * UNC `\\`), and tilde-prefixed (`~`, `~/`, `~\`). Tilde paths still rely on
+ * the shell or the caller for expansion — we only classify them so they reach
+ * the link path instead of npm-name validation.
+ */
+function isLocalPathSpec(spec: string): boolean {
+	if (spec === "." || spec === ".." || spec === "~") return true;
+	if (spec.startsWith("./") || spec.startsWith("../")) return true;
+	if (spec.startsWith(".\\") || spec.startsWith("..\\")) return true;
+	if (spec.startsWith("~/") || spec.startsWith("~\\")) return true;
+	if (spec.startsWith("/")) return true;
+	if (spec.startsWith("\\\\")) return true;
+	if (/^[A-Za-z]:[\\/]/.test(spec)) return true;
+	return false;
+}
+
+export type ClassifiedInstallTarget =
+	| { type: "local"; path: string }
+	| { type: "marketplace"; name: string; marketplace: string }
+	| { type: "npm"; spec: string };
+
+export function classifyInstallTarget(spec: string, knownMarketplaces: Set<string>): ClassifiedInstallTarget {
+	// Rule 0: filesystem path — bypass npm/marketplace validation entirely.
+	if (isLocalPathSpec(spec)) return { type: "local", path: spec };
 	// Rule 1: scoped npm package — @ at position 0 is never a marketplace separator.
 	if (spec.startsWith("@")) return { type: "npm", spec };
 	// Rule 2: @ somewhere after the first character.

package/src/cli/claude-trace-cli.ts

@@ -380,6 +380,18 @@ function isMessagesRequest(message: ParsedHttpMessage): boolean {
 	return pathNameFromRequestTarget(message.path ?? "") === "/v1/messages";
 }
 
+// Claude Code fires a background warmup/classification call on its small fast
+// model (a haiku variant, ANTHROPIC_SMALL_FAST_MODEL) before sending the user's
+// real message. Skip it so the capture lands on the actual prompt.
+function isBackgroundModelRequest(message: ParsedHttpMessage): boolean {
+	try {
+		const parsed = JSON.parse(decodeBody(message.headers, message.body)) as { model?: unknown };
+		return typeof parsed.model === "string" && parsed.model.toLowerCase().includes("haiku");
+	} catch {
+		return false;
+	}
+}
+
 function decodeBody(headers: readonly HeaderEntry[], body: Buffer): string {
 	const encoding = headerValue(headers, "content-encoding")?.toLowerCase().trim();
 	try {
@@ -636,7 +648,7 @@ export class ClaudeMessagesProxy {
 			upstreamTls.write(data);
 			const messages = requestParser.push(data);
 			for (const message of messages) {
-				if (!isMessagesRequest(message)) {
+				if (!isMessagesRequest(message) || isBackgroundModelRequest(message)) {
 					responseQueue.push(null);
 					continue;
 				}

package/src/cli/plugin-cli.ts

@@ -354,6 +354,7 @@ async function handleInstall(
 		console.error(chalk.dim(`  ${APP_NAME} plugin install name@marketplace`));
 		console.error(chalk.dim(`  ${APP_NAME} plugin install github:user/repo`));
 		console.error(chalk.dim(`  ${APP_NAME} plugin install https://github.com/user/repo#v1.0`));
+		console.error(chalk.dim(`  ${APP_NAME} plugin install ./path/to/local/plugin`));
 		process.exit(1);
 	}
 
@@ -382,6 +383,49 @@ async function handleInstall(
 			continue;
 		}
 
+		if (target.type === "local") {
+			// Local paths route to link(): symlink the directory into the plugins
+			// node_modules tree so source edits show up without a reinstall. Matches
+			// `omp plugin link <path>` so users can use either verb interchangeably.
+			if (flags.scope) {
+				console.error(
+					chalk.yellow(
+						`Warning: --scope is only supported for marketplace installs (name@marketplace). Ignoring for ${spec}.`,
+					),
+				);
+			}
+			if (flags.force) {
+				console.error(
+					chalk.yellow(
+						`Warning: --force has no effect for local path installs (link is already idempotent). Ignoring for ${spec}.`,
+					),
+				);
+			}
+			if (flags.dryRun) {
+				if (flags.json) {
+					console.log(JSON.stringify({ dryRun: true, action: "link", path: target.path }, null, 2));
+				} else {
+					console.log(chalk.dim(`[dry-run] Would link ${spec}`));
+				}
+				continue;
+			}
+			try {
+				const result = await manager.link(target.path);
+				if (flags.json) {
+					console.log(JSON.stringify(result, null, 2));
+				} else {
+					console.log(chalk.green(`${theme.status.success} Linked ${result.name} from ${spec}`));
+					if (result.manifest.description) {
+						console.log(chalk.dim(`  ${result.manifest.description}`));
+					}
+				}
+			} catch (err) {
+				console.error(chalk.red(`${theme.status.error} Failed to install ${spec}: ${err}`));
+				process.exit(1);
+			}
+			continue;
+		}
+
 		// --scope only applies to marketplace installs; warn when it would be silently no-op'd for npm.
 		if (flags.scope) {
 			console.error(
@@ -923,6 +967,7 @@ ${chalk.bold("Sources:")}
   github:user/repo[#ref]          GitHub shorthand (also gitlab:, bitbucket:, codeberg:, sourcehut:)
   https://github.com/user/repo    Full git URL (https, ssh, or git protocol)
   name@marketplace                Marketplace plugin (see marketplace command)
+  ./path, ../path, /abs, ~/path   Local plugin directory (symlinked, same as plugin link)
 
 ${chalk.bold("Config Subcommands:")}
   config list <pkg>              List all settings

package/src/cli/web-search-cli.ts

@@ -97,7 +97,6 @@ export async function runSearchCommand(cmd: SearchCommandArgs): Promise<void> {
 	const result = await runSearchQuery(params);
 	const component = renderSearchResult(result, { expanded: cmd.expanded, isPartial: false }, theme, {
 		query: cmd.query,
-		allowLongAnswer: true,
 		maxAnswerLines: cmd.expanded ? undefined : 6,
 	});