@oh-my-pi/pi-coding-agent 17.2.9 → 17.2.11

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

@@ -71,6 +71,8 @@ export interface ModelChangeEntry extends SessionEntryBase {
     model: string;
     /** Role: "default", "smol", "slow", etc. Undefined treated as "default" */
     role?: string;
+    /** True when this transition selected a retry-fallback model rather than the configured model. */
+    resolvedModelIsFallback?: boolean;
 }
 export interface ServiceTierChangeEntry extends SessionEntryBase {
     type: "service_tier_change";
@@ -183,6 +185,14 @@ export interface SessionInitEntry extends SessionEntryBase {
     task: string;
     /** Tools available to the agent */
     tools: string[];
+    /** Agent definition name (for example `scout` or `reviewer`). */
+    agent?: string;
+    /** Semantic model role declared by the agent, retained even after concrete model resolution. */
+    modelRole?: string;
+    /** Initially resolved provider/model selector for historical display. */
+    resolvedModel?: string;
+    /** Whether the agent definition is read-only, allowing an exact zero-LoC attribution. */
+    readOnly?: boolean;
     /** Output schema if structured output was requested. */
     outputSchema?: unknown;
     /** Enforcement policy recorded with the output schema for faithful revival. */

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

@@ -3,13 +3,23 @@ import { BlobStore } from "./blob-store.js";
 import { type FileEntry, type SessionTitleSlotEntry } from "./session-entries.js";
 import { type SessionStorage } from "./session-storage.js";
 import { type SessionTitleUpdate } from "./session-title-slot.js";
+export interface VisitEntriesFromFileStreamOptions {
+    /** Stop after the visitor returns `false`. */
+    shouldContinue?: () => boolean;
+    /** Stop after this many valid or malformed JSONL records have been consumed. */
+    maxRecords?: number;
+    /** Yield to the macrotask queue after this many bytes have been consumed. */
+    yieldEveryBytes?: number;
+    /** Yield to the macrotask queue after this many entries have been visited. */
+    yieldEveryEntries?: number;
+}
 /** Parse session JSONL while stripping and folding the optional fixed title slot. */
 export declare function parseSessionContent(content: string): {
     entries: FileEntry[];
     titleSlot: SessionTitleUpdate | undefined;
 };
 /** Parse session JSONL and visit each entry without retaining prior entries. */
-export declare function visitEntriesFromFileStream(filePath: string, visit: (entry: FileEntry) => void): Promise<SessionTitleUpdate | undefined>;
+export declare function visitEntriesFromFileStream(filePath: string, visit: (entry: FileEntry) => void | boolean, options?: VisitEntriesFromFileStreamOptions): Promise<SessionTitleUpdate | undefined>;
 /** Exported for testing — the ≥8MiB streaming path (works on any file size). */
 export declare function loadEntriesFromFileStream(filePath: string): Promise<{
     entries: FileEntry[];

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

@@ -220,12 +220,17 @@ export declare class SessionManager {
      * Append a model change as a child of the current leaf, then advance the leaf.
      * @param model Model in "provider/modelId" format
      * @param role Optional role (default: "default")
+     * @param resolvedModelIsFallback Whether this transition selected a retry-fallback model
      */
-    appendModelChange(model: string, role?: string): string;
+    appendModelChange(model: string, role?: string, resolvedModelIsFallback?: boolean): string;
     appendSessionInit(init: {
         systemPrompt: string;
         task: string;
         tools: string[];
+        agent?: string;
+        modelRole?: string;
+        resolvedModel?: string;
+        readOnly?: boolean;
         outputSchema?: unknown;
         outputSchemaMode?: StructuredSubagentSchemaMode;
         restrictToolNames?: boolean;
@@ -375,6 +380,9 @@ export declare class SessionManager {
             systemPrompt: string;
             task: string;
             tools: string[];
+            agent?: string;
+            modelRole?: string;
+            resolvedModel?: string;
             outputSchema?: unknown;
             outputSchemaMode?: StructuredSubagentSchemaMode;
             restrictToolNames?: boolean;

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

@@ -3,7 +3,7 @@ import type { Model } from "@oh-my-pi/pi-ai";
 import type { ModelRegistry } from "../config/model-registry.js";
 import type { Settings, SkillsSettings } from "../config/settings.js";
 import type { CustomTool } from "../extensibility/custom-tools/types.js";
-import type { ExtensionRunner } from "../extensibility/extensions/index.js";
+import type { ExtensionRunner, ToolInfo } from "../extensibility/extensions/index.js";
 import { type Skill, type SkillWarning } from "../extensibility/skills.js";
 import { type LocalProtocolOptions } from "../internal-urls/index.js";
 import type { MemoryBackendStartOptions } from "../memory-backend/types.js";
@@ -108,6 +108,14 @@ export declare class SessionTools {
     get baseSystemPrompt(): string[];
     /** Replaces the controller-owned base prompt without applying it to the agent. */
     setBaseSystemPrompt(prompt: string[]): void;
+    /**
+     * Registers the per-turn `before_agent_start` system-prompt override and
+     * applies it to the agent. Base rebuilds during the turn preserve it until
+     * {@link clearTurnSystemPromptOverride}.
+     */
+    setTurnSystemPromptOverride(prompt: string[]): void;
+    /** Drops the active per-turn override; later rebuilds fall back to the base prompt. */
+    clearTurnSystemPromptOverride(): void;
     /** Skills currently rendered into the system prompt. */
     get skills(): Skill[];
     /** Diagnostics produced while loading the current skills. */
@@ -132,6 +140,15 @@ export declare class SessionTools {
     hasBuiltInTool(name: string): boolean;
     /** Names of every registered tool. */
     getAllToolNames(): string[];
+    /**
+     * Full metadata for every registered tool, including source provenance.
+     *
+     * Backs the `getAllTools()` ExtensionAPI method. Returns {@link ToolInfo}
+     * objects (not bare names) so extensions authored against upstream
+     * `@earendil-works/pi-coding-agent` — which promises `ToolInfo[]` — can read
+     * `sourceInfo.source` unchanged.
+     */
+    getAllToolInfos(): ToolInfo[];
     /** Installs and activates the ephemeral vibe tool set. */
     activateVibeTools(baseToolNames: string[]): Promise<void>;
     /** Uninstalls vibe tools and activates the replacement set. */

package/dist/types/session/turn-recovery.d.ts

@@ -100,8 +100,13 @@ export declare class TurnRecovery {
         autoContinue: boolean;
         triggerContextTokens?: number;
     }): Promise<RecoveryCompactionResult>;
-    /** Restores the configured primary after fallback cooldown expiry. */
-    maybeRestoreRetryFallbackPrimary(): Promise<void>;
+    /**
+     * Restores the configured primary after fallback cooldown expiry.
+     * @returns true when the active model was actually switched back to the
+     * primary, so callers can re-run the pre-send context-fit check against the
+     * reverted (possibly smaller) window before issuing the next request.
+     */
+    maybeRestoreRetryFallbackPrimary(): Promise<boolean>;
     /** Applies model fallback policy from live usage health before a turn starts. */
     maybeApplyUsageAwareFallback(signal: AbortSignal, confirmer?: UsageFallbackConfirmer): Promise<boolean>;
     /** Applies automatic retry, credential rotation, and model fallback policy. */

package/dist/types/slash-commands/acp-builtins.d.ts

@@ -1,4 +1,4 @@
-import type { AvailableCommand } from "@agentclientprotocol/sdk";
+import type { AvailableCommand } from "@oh-my-pi/pi-utils/acp";
 import type { AcpBuiltinSlashCommandResult, SlashCommandRuntime } from "./types.js";
 export type { AcpBuiltinSlashCommandResult } from "./types.js";
 /**

package/dist/types/slash-commands/available-commands.d.ts

@@ -1,4 +1,4 @@
-import type { AvailableCommand } from "@agentclientprotocol/sdk";
+import type { AvailableCommand } from "@oh-my-pi/pi-utils/acp";
 import type { SkillsSettings } from "../config/settings.js";
 import type { LoadedCustomCommand } from "../extensibility/custom-commands/index.js";
 import type { ExtensionRunner } from "../extensibility/extensions/index.js";

package/dist/types/task/executor.d.ts

@@ -87,6 +87,8 @@ export interface ExecutorOptions {
      */
     detached?: boolean;
     modelOverride?: string | string[];
+    /** Explicit pre-expansion model role alias selected for this run. */
+    modelRole?: string;
     /**
      * Active model selector of the parent session, used as an auth-aware fallback
      * if the resolved subagent model has no working credentials. See #985.
@@ -260,6 +262,8 @@ export interface IrcWakeTurnMonitorOptions {
     agent: AgentDefinition;
     description?: string;
     modelOverride?: string | string[];
+    /** Explicit pre-expansion model role alias selected for this run. */
+    modelRole?: string;
     eventBus?: EventBus;
     parentToolCallId?: string;
     /** Fallback session file when the registry ref carries none. */
@@ -309,6 +313,8 @@ export interface FollowUpTurnOptions {
     message: string;
     index?: number;
     description?: string;
+    /** Explicit pre-expansion model role alias retained from the original run. */
+    modelRole?: string;
     /** Structured-output state retained from the original invocation. */
     outputSchema?: unknown;
     outputSchemaMode?: StructuredSubagentSchemaMode;

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

@@ -1,17 +1,16 @@
 import type { AgentTool, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
 import type { ToolSession } from "../index.js";
 import type { Theme } from "../modes/theme/theme.js";
-import { type AgentDefinition, type SingleResult, type TaskItem, type TaskToolDetails, type TaskToolSchemaInstance } from "./types.js";
+import { type SingleResult, type TaskItem, type TaskToolDetails, type TaskToolSchemaInstance } from "./types.js";
 import "../tools/review.js";
 import { renderResult, renderCall as renderTaskCall } from "./render.js";
 export { loadBundledAgents as BUNDLED_AGENTS } from "./agents.js";
 export { discoverCommands, expandCommand, getCommand } from "./commands.js";
 export { discoverAgents, getAgent } from "./discovery.js";
 export { AgentOutputManager } from "./output-manager.js";
+export * from "./read-only-policy.js";
 export type { AgentDefinition, AgentProgress, SingleResult, SubagentEventPayload, SubagentLifecyclePayload, SubagentProgressPayload, TaskParams, TaskToolDetails, } from "./types.js";
 export { TASK_SUBAGENT_EVENT_CHANNEL, TASK_SUBAGENT_LIFECYCLE_CHANNEL, TASK_SUBAGENT_PROGRESS_CHANNEL, taskSchema, } from "./types.js";
-export declare const READ_ONLY_TOOL_NAMES: ReadonlySet<string>;
-export declare function isReadOnlyAgent(agent: AgentDefinition): boolean;
 /**
  * Preview text for a child result. Falls back to "(no output)" — annotated
  * with the request count when the child actually did work, so the parent can
@@ -50,6 +49,8 @@ export declare function composeSpawnAdvisory(args: {
     willRunAsync: boolean;
     scoutAvailable?: boolean;
 }): string | undefined;
+/** Rescan one cwd and publish its definitions to existing and future task tools. */
+export declare function refreshAgentDiscovery(cwd: string): Promise<void>;
 /**
  * Task tool - Delegate tasks to specialized agents.
  *

package/dist/types/task/read-only-policy.d.ts

@@ -0,0 +1,3 @@
+import type { AgentDefinition } from "./types.js";
+export declare const READ_ONLY_TOOL_NAMES: ReadonlySet<string>;
+export declare function isReadOnlyAgent(agent: AgentDefinition): boolean;

package/dist/types/task/structured-subagent.d.ts

@@ -74,6 +74,8 @@ export interface EffectiveSubagentPolicy {
     agent: AgentDefinition;
     effectiveAgent: AgentDefinition;
     modelOverride?: string | string[];
+    /** Explicit pre-expansion model role alias selected for this run. */
+    modelRole?: string;
     parentActiveModelPattern?: string;
     schema: StructuredSubagentSchemaResolution;
     planMode: boolean;

package/dist/types/task/types.d.ts

@@ -336,6 +336,8 @@ export interface AgentProgress {
     cost: number;
     durationMs: number;
     modelOverride?: string | string[];
+    /** Explicit pre-expansion model role alias selected for this run. */
+    modelRole?: string;
     /** Resolved model display string in the form `<provider>/<id>`, optionally suffixed with `:<thinkingLevel>` when the level was set explicitly. Undefined when the model could not be resolved. */
     resolvedModel?: string;
     /** True when {@link resolvedModel} is the target of an active retry fallback (not the originally configured model). Lets observer-only UIs (collab guests, Agent Hub rows with no live session) flag the fallback and keep the provider. */
@@ -404,6 +406,8 @@ export interface SingleResult {
     /** Model's context window in tokens, when known. */
     contextWindow?: number;
     modelOverride?: string | string[];
+    /** Explicit pre-expansion model role alias selected for this run. */
+    modelRole?: string;
     /** Resolved model display string in the form `<provider>/<id>`, optionally suffixed with `:<thinkingLevel>` when the level was set explicitly. Omitted from tool-result JSON when undefined to keep wire payloads small. */
     resolvedModel?: string;
     /** True when {@link resolvedModel} is the target of an active retry fallback. Mirrors {@link AgentProgress.resolvedModelIsFallback} onto the settled result. */

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

@@ -119,7 +119,7 @@ export declare class BashTool implements AgentTool<typeof bashSchemaBase | typeo
 }
 export interface BashRenderArgs {
     command?: string;
-    env?: Record<string, string>;
+    env?: Record<string, unknown>;
     timeout?: number;
     cwd?: string;
     __partialJson?: string;
@@ -141,10 +141,10 @@ export interface ShellRendererConfig<TArgs> {
     resolveTitle: (args: TArgs | undefined, options: RenderResultOptions) => string;
     resolveCommand?: (args: TArgs | undefined) => string | undefined;
     resolveCwd?: (args: TArgs | undefined) => string | undefined;
-    resolveEnv?: (args: TArgs | undefined) => Record<string, string> | undefined;
+    resolveEnv?: (args: TArgs | undefined) => Record<string, unknown> | undefined;
     showHeader?: boolean;
 }
-export declare function getBashEnvForDisplay(args: BashRenderArgs): Record<string, string> | undefined;
+export declare function getBashEnvForDisplay(args: BashRenderArgs): Record<string, unknown> | undefined;
 /**
  * Returns the bash command formatted for the result body: the dim `$ cd … &&`
  * prefix joined with syntax-highlighted command lines. The prefix is applied

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

@@ -116,7 +116,8 @@ export declare function applyStealthPatches(browser: Browser, page: Page, state:
     override: UserAgentOverride | null;
 }): Promise<void>;
 /** Exposes executable candidates for detection tests. */
-export declare function systemChromiumCandidatesForTest(platform?: NodeJS.Platform, home?: string, which?: (name: string) => string | undefined): string[];
+export declare function systemChromiumCandidatesForTest(platform?: NodeJS.Platform, home?: string, which?: (name: string) => string | null | undefined): string[];
+export declare function chromiumExecutableProbeForTest(executablePath: string): Promise<boolean>;
 export declare function stealthIgnoreDefaultArgsForTest(executablePath: string | undefined): string[];
 export declare function targetSupportsUserAgentOverrideForTest(target: Target): boolean;
 export declare function configureUserAgentTargetsForTest(browser: Browser, state: {

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

@@ -1,4 +1,4 @@
-import type { HTMLElement } from "linkedom";
+import type { HTMLElement } from "@oh-my-pi/pi-utils/dom";
 import type { ElementHandle, Page } from "puppeteer-core";
 import type { Transport } from "./tab-protocol.js";
 declare module "puppeteer-core" {
@@ -72,7 +72,7 @@ export declare function preparePageForScreenshot(page: Pick<Page, "bringToFront"
 export declare function describeInflight(inflight: Map<number, InflightOp>): string;
 export declare class WorkerCore {
     #private;
-    constructor(transport: Transport);
+    constructor(transport: Transport, isolated: boolean);
     nextElementId(): number;
     cacheElement(id: number, handle: ElementHandle): void;
 }

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

@@ -185,6 +185,7 @@ type PathEntrySplitter = (item: string) => {
  */
 export declare function splitDelimitedPathEntry(entry: string, cwd: string, options?: {
     splitter?: PathEntrySplitter;
+    routedUrlPredicate?: (entry: string) => boolean;
 }): Promise<string[] | null>;
 /** Expand delimited entries in-place while preserving unsplit entries. */
 export declare function expandDelimitedPathEntries(entries: readonly string[], cwd: string, options?: {

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

@@ -63,11 +63,7 @@ export declare class ReadTool implements AgentTool<typeof readSchema, ReadToolDe
     readonly label = "Read";
     readonly loadMode = "essential";
     description: string;
-    readonly parameters: import("@oh-my-pi/omptype").FluentType<{
-        path: string;
-    }, {
-        path: string;
-    }>;
+    get parameters(): typeof readSchema;
     readonly strict = true;
     constructor(session: ToolSession);
     /**

package/dist/types/tools/run-scope.d.ts

@@ -1,3 +1,28 @@
+/** Associates a browser operation failure with its owning evaluated run. */
+export declare function markBrowserRunRejection<T>(reason: T, owner: object): T;
+/** Returns whether a rejection was marked for the specified evaluated run. */
+export declare function isBrowserRunRejection(reason: unknown, owner: object): boolean;
+/** Returns whether a rejection belongs to the marked browser run or its evaluated source file. */
+export declare function isBrowserRunOwnedRejection(reason: unknown, owner: object, filename: string): boolean;
+type FloatingRejectionHandler = (reason: unknown) => void;
+/**
+ * Observes native promise-combinator results derived from browser promises for
+ * the duration of one evaluated run. Native `await` remains unchanged; dropped
+ * user continuations from `Promise.all` and `Promise.race` are routed to the
+ * owning run.
+ */
+export declare function withBrowserPromiseCombinatorTracking<T>(owner: object, onFloatingRejection: FloatingRejectionHandler, run: () => Promise<T>): Promise<T>;
+/**
+ * Observes every explicit continuation of a browser promise without replacing
+ * the native promise. Browser failures remain contained; an unhandled error
+ * created by user continuation code is reported to the owning run.
+ */
+export declare function observeBrowserRunPromise<T>(promise: Promise<T>, owner: object, onFloatingRejection: FloatingRejectionHandler): Promise<T>;
+/**
+ * Installs worker-realm rejection routing. Consumed browser-run failures stay in
+ * the worker; unrelated failures retain the default fatal worker behavior.
+ */
+export declare function installBrowserWorkerRejectionGuard(consume: (reason: unknown) => boolean): () => void;
 /**
  * Marks a run-scoped promise as observed without changing its behavior for awaited callers.
  *
@@ -38,4 +63,5 @@ export declare function resolvePredicateTimeout(cellTimeoutMs: number, explicit?
  */
 export declare function waitForRun(msOrPredicate: number | (() => unknown), signal: AbortSignal, opts?: WaitPredicateOptions): Promise<unknown>;
 /** Binds a long-lived scope facade (page/tab/desktop objects) to one evaluated run's abort signal. */
-export declare function bindRunFacade<T extends object>(target: T, signal: AbortSignal): T;
+export declare function bindRunFacade<T extends object>(target: T, signal: AbortSignal, rejectionOwner?: object, onFloatingRejection?: FloatingRejectionHandler): T;
+export {};

package/dist/types/tools/shell-tokenize.d.ts

@@ -41,3 +41,19 @@ export interface FlatShellCommandSegment {
  * complete input in that case.
  */
 export declare function extractFlatShellCommandSegments(command: string): FlatShellCommandSegment[];
+/**
+ * Parses a leading `cd <path> && ...` prefix so the bash tool can route the
+ * target through its structured `cwd` parameter when the model omits it.
+ *
+ * Returns the single path token (quotes and backslash escapes resolved to their
+ * literal value) and the command remainder after the top-level `&&`, or `null`
+ * when the command does not begin with exactly `cd`, one path token, and a
+ * top-level `&&`. The scanner deliberately bails on anything else in the prefix
+ * — redirects (`cd /tmp 2>/dev/null && ...`), extra arguments, or paths needing
+ * shell expansion (`$`, backticks, `(`) — leaving the whole command for the
+ * shell instead of absorbing shell syntax into `cwd`.
+ */
+export declare function extractLeadingCdTarget(command: string): {
+    path: string;
+    rest: string;
+} | null;

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

@@ -1,4 +1,4 @@
-import type { Terminal as XtermTerminal } from "@xterm/headless";
+import type { Terminal as XtermTerminal } from "@oh-my-pi/pi-utils/vterm";
 /** 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. */

package/dist/types/utils/turndown.d.ts

@@ -1,4 +1,4 @@
-import TurndownService from "turndown";
+import TurndownService from "@oh-my-pi/pi-utils/turndown";
 /**
  * Build a Turndown instance configured for GFM with the fixes omp relies on:
  * `~~strikethrough~~`, unescaped heading periods, and single-space list markers.

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

@@ -1,5 +1,4 @@
 import type { AsyncJobManager } from "../async/job-manager.js";
-import type { SessionEntry } from "../session/session-entries.js";
 import { SessionManager } from "../session/session-manager.js";
 import type { ToolSession } from "../tools/index.js";
 /** The two worker CLI flavors the director drives. */
@@ -87,8 +86,8 @@ export interface VibeWaitOutcome {
     stillRunning: string[];
     timedOut: boolean;
 }
-/** Child ids claimed by any valid Vibe spawn event, independent of current parent scope. */
-export declare function persistedVibeChildIds(entries: Iterable<SessionEntry>): Set<string>;
+/** Child ids claimed by valid Vibe spawn records from untrusted persisted JSON. */
+export declare function persistedVibeChildIds(entries: Iterable<unknown>): Set<string>;
 /** Thrown from a turn job body so the job manager marks the job failed while carrying the formatted result. */
 export declare class VibeTurnError extends Error {
 }

package/dist/types/web/scrapers/readthedocs.d.ts

@@ -1,5 +1,2 @@
-/**
- * Read the Docs handler for web-fetch
- */
 import { type SpecialHandler } from "./types.js";
 export declare const handleReadTheDocs: SpecialHandler;

package/dist/types/web/search/providers/browser-headers.d.ts

@@ -1,8 +1,7 @@
 /**
  * Build a fresh, internally consistent desktop navigation fingerprint for one HTTP request.
- * By default, this randomizes across valid modern versions of Chrome, Firefox, Edge, and Safari
- * using real-world traffic data. Set `randomized` to `false` when a fetch must preserve a
- * stable Mac Chrome identity.
+ * By default, this randomizes across coherent modern Chrome, Firefox, and Safari profiles.
+ * Set `randomized` to `false` when a fetch must preserve a stable Mac Chrome identity.
  */
 export declare function buildBrowserNavigationHeaders(options?: {
     randomized?: boolean;

package/examples/custom-tools/README.md

@@ -96,7 +96,7 @@ renderResult(result, { expanded, isPartial }, theme) {
 **Use `z.enum` for discriminated string tool args:**
 
 ```typescript
-const { z } = pi.zod;
+const z = pi.zod;
 
 parameters: z.object({
 	action: z.enum(["list", "add"]),

package/examples/extensions/README.md

@@ -114,7 +114,7 @@ export default function (pi: ExtensionAPI) {
 **Use `z.enum` for discriminated string tool args:**
 
 ```typescript
-const { z } = pi.zod;
+const z = pi.zod;
 
 parameters: z.object({
 	action: z.enum(["list", "add"]),

package/examples/extensions/api-demo.ts

@@ -1,14 +1,13 @@
 /**
  * API Demo Extension
  *
- * Demonstrates using ExtensionAPI's logger, injected `pi.zod`, and pi module access.
- * These features are now exposed directly on the ExtensionAPI, matching
- * the CustomToolAPI interface.
+ * Demonstrates using ExtensionAPI's logger, injected schema builder, and pi
+ * module access.
  */
 import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
 
 export default function (pi: ExtensionAPI) {
-	const { z } = pi.zod;
+	const z = pi.zod;
 
 	// Access the logger for debugging
 	pi.logger.debug("API demo extension loaded");
@@ -16,7 +15,7 @@ export default function (pi: ExtensionAPI) {
 	pi.registerTool({
 		name: "api_demo",
 		label: "API Demo",
-		description: "Demonstrates ExtensionAPI capabilities: logger, zod, and pi module access",
+		description: "Demonstrates ExtensionAPI capabilities: logger, schema validation, and pi module access",
 		parameters: z.object({
 			message: z.string().describe("Test message"),
 			logLevel: z.enum(["error", "warn", "debug"]).default("debug").describe("Log level to use"),
@@ -48,7 +47,7 @@ export default function (pi: ExtensionAPI) {
 							``,
 							`Features demonstrated:`,
 							`1. ✓ Logger access via pi.logger`,
-							`2. ✓ Zod access via pi.zod`,
+							`2. ✓ Schema builder access via pi.arktype`,
 							`3. ✓ Pi module access via pi.pi`,
 							``,
 							`Context:`,

package/examples/extensions/chalk-logger.ts

@@ -3,7 +3,7 @@
  * Tests that jiti can resolve npm modules correctly.
  */
 import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
-import chalk from "chalk";
+import chalk from "@oh-my-pi/pi-utils/chalk";
 
 export default function (pi: ExtensionAPI) {
 	// Log with colors using chalk

package/examples/extensions/hello.ts

@@ -1,12 +1,12 @@
 /**
  * Hello Tool - Minimal custom tool example
  *
- * Demonstrates using ExtensionAPI's logger, injected `pi.zod`, and pi module access.
+ * Demonstrates using ExtensionAPI's logger and injected schema builder.
  */
 import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
 
 export default function (pi: ExtensionAPI) {
-	const { z } = pi.zod;
+	const z = pi.zod;
 
 	pi.registerTool({
 		name: "hello",

package/examples/extensions/reload-runtime.ts

@@ -8,7 +8,7 @@
 import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
 
 export default function (pi: ExtensionAPI) {
-	const { z } = pi.zod;
+	const z = pi.zod;
 
 	// Command entrypoint for reload.
 	// Treat reload as terminal for this handler.

package/examples/extensions/tools.ts

@@ -36,7 +36,7 @@ export default function toolsExtension(pi: ExtensionAPI) {
 
 	// Find the last tools-config entry in the current branch
 	async function restoreFromBranch(ctx: ExtensionContext) {
-		allTools = pi.getAllTools();
+		allTools = pi.getAllTools().map(t => t.name);
 
 		// Get entries in current branch only
 		const branchEntries = ctx.sessionManager.getBranch();
@@ -66,7 +66,7 @@ export default function toolsExtension(pi: ExtensionAPI) {
 		description: "Enable/disable tools",
 		handler: async (_args, ctx) => {
 			// Refresh tool list
-			allTools = pi.getAllTools();
+			allTools = pi.getAllTools().map(t => t.name);
 
 			await ctx.ui.custom((tui, theme, _keybindings, done) => {
 				// Build settings items for each tool

package/examples/extensions/with-deps/index.ts

@@ -8,7 +8,7 @@ import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
 import ms from "ms";
 
 export default function (pi: ExtensionAPI) {
-	const { z } = pi.zod;
+	const z = pi.zod;
 
 	// Register a tool that uses ms
 	pi.registerTool({

package/examples/sdk/06-extensions.ts

@@ -41,7 +41,7 @@ console.log();
 import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
 
 export default function (pi: ExtensionAPI) {
-	const { z } = pi.zod;
+	const z = pi.zod;
 
 	pi.on("agent_start", async () => {
 		console.log("[Extension] Agent starting");

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "17.2.9",
+	"version": "17.2.11",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -49,21 +49,19 @@
 		"bench:guard": "bun scripts/bench-guard.ts"
 	},
 	"dependencies": {
-		"@agentclientprotocol/sdk": "1.2.1",
 		"@babel/parser": "^7.29.7",
-		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "17.2.9",
-		"@oh-my-pi/omp-stats": "17.2.9",
-		"@oh-my-pi/omptype": "17.2.9",
-		"@oh-my-pi/pi-agent-core": "17.2.9",
-		"@oh-my-pi/pi-ai": "17.2.9",
-		"@oh-my-pi/pi-catalog": "17.2.9",
-		"@oh-my-pi/pi-mnemopi": "17.2.9",
-		"@oh-my-pi/pi-natives": "17.2.9",
-		"@oh-my-pi/pi-tui": "17.2.9",
-		"@oh-my-pi/pi-utils": "17.2.9",
-		"@oh-my-pi/pi-wire": "17.2.9",
-		"@oh-my-pi/snapcompact": "17.2.9",
+		"@oh-my-pi/hashline": "17.2.11",
+		"@oh-my-pi/omp-stats": "17.2.11",
+		"@oh-my-pi/omptype": "17.2.11",
+		"@oh-my-pi/pi-agent-core": "17.2.11",
+		"@oh-my-pi/pi-ai": "17.2.11",
+		"@oh-my-pi/pi-catalog": "17.2.11",
+		"@oh-my-pi/pi-mnemopi": "17.2.11",
+		"@oh-my-pi/pi-natives": "17.2.11",
+		"@oh-my-pi/pi-tui": "17.2.11",
+		"@oh-my-pi/pi-utils": "17.2.11",
+		"@oh-my-pi/pi-wire": "17.2.11",
+		"@oh-my-pi/snapcompact": "17.2.11",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/api-logs": "^0.220.0",
 		"@opentelemetry/context-async-hooks": "^2.9.0",
@@ -75,29 +73,15 @@
 		"@opentelemetry/sdk-metrics": "^2.9.0",
 		"@opentelemetry/sdk-trace-base": "^2.9.0",
 		"@opentelemetry/sdk-trace-node": "^2.9.0",
-		"@puppeteer/browsers": "^3.0.6",
-		"@types/turndown": "5.0.6",
-		"@xterm/headless": "^6.0.0",
-		"chalk": "^5.6.2",
-		"fast-xml-parser": "^5.9.3",
-		"handlebars": "^4.7.9",
-		"header-generator": "^2.1.82",
-		"linkedom": "^0.18.13",
-		"lru-cache": "11.5.2",
-		"mammoth": "^1.12.0",
 		"mupdf": "^1.28.0",
-		"puppeteer-core": "25.3.0",
-		"turndown": "7.2.4",
-		"turndown-plugin-gfm": "1.0.2",
-		"zod": "^4"
+		"puppeteer-core": "25.3.0"
 	},
 	"optionalDependencies": {
 		"@huggingface/transformers": "^4.2.0",
 		"sherpa-onnx-node": "1.13.2"
 	},
 	"devDependencies": {
-		"@types/bun": "^1.3.14",
-		"marked": "^18.0.6"
+		"@types/bun": "^1.3.14"
 	},
 	"engines": {
 		"bun": ">=1.3.14"