@oh-my-pi/pi-coding-agent 16.1.18 → 16.1.20

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

@@ -2,6 +2,12 @@ import { type GalleryFixture } from "./gallery-fixtures";
 /** Lifecycle states the gallery renders, in display order. */
 export declare const GALLERY_STATES: readonly ["streaming", "progress", "success", "error"];
 export type GalleryState = (typeof GALLERY_STATES)[number];
+/** User-facing labels printed above each rendered lifecycle state. */
+export declare const GALLERY_STATE_LABELS: Record<GalleryState, string>;
+/** Accepted `--state` tokens, including legacy lifecycle names and displayed labels. */
+export declare const GALLERY_STATE_TOKENS: string[];
+/** Normalize user-provided `--state` tokens to the internal gallery lifecycle states. */
+export declare function parseGalleryStates(states: readonly string[] | undefined): GalleryState[] | undefined;
 export interface GalleryCommandArgs {
     /** Render width in columns (defaults to terminal width, clamped). */
     width?: number;

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

@@ -12,7 +12,7 @@ export default class Gallery extends Command {
         state: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
             char: string;
             description: string;
-            options: ("error" | "progress" | "streaming" | "success")[];
+            options: string[];
             multiple: true;
         };
         width: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {

package/dist/types/config/service-tier.d.ts

@@ -0,0 +1,34 @@
+import type { ServiceTier } from "@oh-my-pi/pi-ai";
+import type { SubmenuOption } from "./settings-schema";
+/**
+ * Service-tier setting values shared by every "Service Tier" setting. `"none"`
+ * is the omit-the-parameter sentinel; the remaining values mirror
+ * {@link ServiceTier}.
+ */
+export declare const SERVICE_TIER_SETTING_VALUES: readonly ["none", "auto", "default", "flex", "scale", "priority", "openai-only", "claude-only"];
+export type ServiceTierSettingValue = (typeof SERVICE_TIER_SETTING_VALUES)[number];
+/** Variant value set for scoped service-tier settings (subagent/advisor) that can defer to the main agent. */
+export declare const SERVICE_TIER_INHERIT_SETTING_VALUES: readonly ["inherit", "none", "auto", "default", "flex", "scale", "priority", "openai-only", "claude-only"];
+export type ServiceTierInheritSettingValue = (typeof SERVICE_TIER_INHERIT_SETTING_VALUES)[number];
+/** Submenu descriptions shared by the base `serviceTier` setting. */
+export declare const SERVICE_TIER_OPTIONS: ReadonlyArray<SubmenuOption<ServiceTierSettingValue>>;
+/** Submenu descriptions for inherit-capable service-tier settings. */
+export declare const SERVICE_TIER_INHERIT_OPTIONS: ReadonlyArray<SubmenuOption<ServiceTierInheritSettingValue>>;
+/**
+ * Resolve a service-tier setting value to the wire {@link ServiceTier} (or
+ * `undefined` to omit). `"inherit"` defers to `inherited`; `"none"` omits.
+ */
+export declare function resolveServiceTierSetting(value: string, inherited: ServiceTier | undefined): ServiceTier | undefined;
+/**
+ * Resolve the `serviceTier` *setting value* to stamp onto a subagent's settings
+ * snapshot.
+ *
+ * - A concrete `subagentSetting` (`"none"` or a tier) wins outright.
+ * - `"inherit"` defers to the parent's live effective tier when the caller has a
+ *   live session (`inherited` passed as `ServiceTier | null`, where `null` means
+ *   the parent explicitly has no tier — e.g. `/fast off`). When no live session
+ *   is available (`inherited === undefined`, e.g. cold subagent revive) it falls
+ *   back to the parent's configured `serviceTier` setting so behavior matches a
+ *   plain settings snapshot.
+ */
+export declare function resolveSubagentServiceTier(subagentSetting: string, configuredTier: ServiceTierSettingValue, inherited: ServiceTier | null | undefined): ServiceTierSettingValue;

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

@@ -1153,39 +1153,32 @@ export declare const SETTINGS_SCHEMA: {
             readonly group: "Sampling";
             readonly label: "Service Tier";
             readonly description: 'Processing priority hint (none = omit). OpenAI accepts the tier values directly; Anthropic realizes `priority` as `speed: "fast"` on supported Opus models. Scoped values target one family.';
-            readonly options: readonly [{
-                readonly value: "none";
-                readonly label: "None";
-                readonly description: "Omit service_tier parameter";
-            }, {
-                readonly value: "auto";
-                readonly label: "Auto";
-                readonly description: "Use provider default tier selection (OpenAI)";
-            }, {
-                readonly value: "default";
-                readonly label: "Default";
-                readonly description: "Standard priority processing (OpenAI)";
-            }, {
-                readonly value: "flex";
-                readonly label: "Flex";
-                readonly description: "Flexible capacity tier when available (OpenAI)";
-            }, {
-                readonly value: "scale";
-                readonly label: "Scale";
-                readonly description: "Scale Tier credits when available (OpenAI)";
-            }, {
-                readonly value: "priority";
-                readonly label: "Priority";
-                readonly description: "Priority on every supported provider (OpenAI `service_tier`, Anthropic fast mode)";
-            }, {
-                readonly value: "openai-only";
-                readonly label: "Priority (OpenAI only)";
-                readonly description: "Priority on OpenAI/OpenAI-Codex requests; ignored elsewhere";
-            }, {
-                readonly value: "claude-only";
-                readonly label: "Priority (Claude only)";
-                readonly description: "Anthropic fast mode on direct Claude requests; ignored elsewhere (incl. Bedrock/Vertex)";
-            }];
+            readonly options: readonly SubmenuOption<"auto" | "claude-only" | "default" | "flex" | "none" | "openai-only" | "priority" | "scale">[];
+        };
+    };
+    readonly serviceTierSubagent: {
+        readonly type: "enum";
+        readonly values: readonly ["inherit", "none", "auto", "default", "flex", "scale", "priority", "openai-only", "claude-only"];
+        readonly default: "inherit";
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Sampling";
+            readonly label: "Service Tier - Subagent";
+            readonly description: "Service Tier for spawned task/eval subagents. Inherit = match the main agent's live tier (tracks /fast); pick a value to scope subagents independently.";
+            readonly options: readonly SubmenuOption<"auto" | "claude-only" | "default" | "flex" | "inherit" | "none" | "openai-only" | "priority" | "scale">[];
+        };
+    };
+    readonly serviceTierAdvisor: {
+        readonly type: "enum";
+        readonly values: readonly ["inherit", "none", "auto", "default", "flex", "scale", "priority", "openai-only", "claude-only"];
+        readonly default: "none";
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Sampling";
+            readonly label: "Service Tier - Advisor";
+            readonly description: "Service Tier for the advisor model. None = standard processing; Inherit = match the main agent's live tier; pick a value (e.g. Priority) to run the advisor on a faster serving path.";
+            readonly options: readonly SubmenuOption<"auto" | "claude-only" | "default" | "flex" | "inherit" | "none" | "openai-only" | "priority" | "scale">[];
+            readonly condition: "advisorEnabled";
         };
     };
     readonly fastModeScope: {
@@ -4243,6 +4236,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Obfuscate secrets before sending to AI providers";
         };
     };
+    readonly "providers.ollama-cloud.maxConcurrency": {
+        readonly type: "number";
+        readonly default: 3;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Ollama Cloud Max Concurrency";
+            readonly description: "Maximum concurrent Ollama Cloud subagent runs per process; 0 disables the provider-specific limit";
+        };
+    };
     readonly "providers.webSearch": {
         readonly type: "enum";
         readonly values: readonly ["auto", ...SearchProviderId[]];

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

@@ -1,21 +1,3 @@
-/**
- * Coding-agent specific {@link Filesystem} adapter for the hashline patcher.
- *
- * Wires hashline's storage abstraction to the agent runtime:
- *
- * - Section paths are resolved through the plan-mode redirect so a bare
- *   `PLAN.md` lands at the canonical session artifact location.
- * - Reads go through `readEditFileText` (notebook-aware) and the
- *   auto-generated-file guard.
- * - Writes go through `serializeEditFileText` (notebook-aware) and the
- *   LSP writethrough, with FS-scan cache invalidation on success. The
- *   resulting `FileDiagnosticsResult` is captured per-path so the
- *   orchestrator can attach it to the tool result.
- *
- * Construct one per `executeHashlineSingle` call: per-section state
- * (batch request, diagnostics) lives on the instance and isn't safe to
- * share across concurrent edit tools.
- */
 import { Filesystem, type WriteResult } from "@oh-my-pi/hashline";
 import type { FileDiagnosticsResult, WritethroughCallback, WritethroughDeferredHandle } from "../../lsp";
 import type { ToolSession } from "../../tools";
@@ -50,6 +32,7 @@ export declare class HashlineFilesystem extends Filesystem {
     consumeDiagnostics(path: string): FileDiagnosticsResult | undefined;
     resolveAbsolute(relativePath: string): string;
     canonicalPath(relativePath: string): string;
+    allowTagPathRecovery(authoredPath: string, resolvedPath: string): boolean;
     readText(relativePath: string): Promise<string>;
     preflightWrite(relativePath: string): Promise<void>;
     writeText(relativePath: string, content: string): Promise<WriteResult>;

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

@@ -0,0 +1,10 @@
+/**
+ * Canonical keys served by the `omp-legacy-pi-bundled:` virtual namespace.
+ * Mirrors `Object.keys(BUNDLED_PI_REGISTRY)` from
+ * `legacy-pi-bundled-keys.ts`'s sibling registry file. `legacy-pi-compat.ts`
+ * statically imports this set to seed `LEGACY_PI_PACKAGE_ROOT_OVERRIDES` in
+ * compiled-binary mode without dragging the heavy registry's transitive
+ * graph into dev/test runs (the registry itself stays behind a dynamic
+ * import — see `ensureBundledRegistryLoaded` in `legacy-pi-compat.ts`).
+ */
+export declare const BUNDLED_PI_REGISTRY_KEYS: ReadonlySet<string>;

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

@@ -2,6 +2,9 @@
  * Canonical specifier → live module namespace. Keys MUST match the right-hand
  * side of `bundledRegistryVirtualSpecifier(...)` calls in
  * `legacy-pi-compat.ts`; the synthesizer enumerates each namespace's own
- * enumerable exports at extension load time.
+ * enumerable exports at extension load time. The companion
+ * `legacy-pi-bundled-keys.ts` mirrors `Object.keys(BUNDLED_PI_REGISTRY)` and
+ * is statically imported by `legacy-pi-compat.ts` to seed the override map
+ * without paying the cascade above.
  */
 export declare const BUNDLED_PI_REGISTRY: Readonly<Record<string, Readonly<Record<string, unknown>>>>;

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

@@ -49,6 +49,18 @@ export declare function __resolveTypeBoxShimPath(isCompiled: boolean, sourcePath
  * simulate the missing-entrypoint failure mode without touching the real FS.
  */
 export declare function __validateLegacyPiPackageRootOverrides(candidates: Record<string, string>, pathExistsSync?: (p: string) => boolean): Record<string, string>;
+/**
+ * Compute the override map keyed by every canonical specifier the host serves
+ * directly: the pi-ai / pi-coding-agent roots (compat shims that re-attach
+ * legacy helpers) plus, in compiled-binary mode, every other canonical pi-*
+ * package root AND every non-wildcard subpath registered in the bundled
+ * registry (see `legacy-pi-bundled-keys.ts`). Subpath coverage is what stops
+ * `@(scope)/pi-ai/oauth` and friends from falling through to the extension's
+ * own — possibly absent — peer install when bunfs filesystem walks fail
+ * (issue #3442 follow-up to #3423). Exported as a test seam so the
+ * compiled-binary branch is verifiable from dev tests.
+ */
+export declare function __buildLegacyPiPackageRootOverrides(isCompiled: boolean): Record<string, string>;
 /**
  * Load a legacy Pi extension module from its real on-disk location.
  *

package/dist/types/internal-urls/skill-protocol.d.ts

@@ -1,4 +1,4 @@
-import type { InternalResource, InternalUrl, ProtocolHandler, UrlCompletion } from "./types";
+import type { InternalResource, InternalUrl, ProtocolHandler, ResolveContext, UrlCompletion } from "./types";
 /**
  * Validate that a path is safe (no traversal, no absolute paths).
  */
@@ -9,6 +9,6 @@ export declare function validateRelativePath(relativePath: string): void;
 export declare class SkillProtocolHandler implements ProtocolHandler {
     readonly scheme = "skill";
     readonly immutable = true;
-    resolve(url: InternalUrl): Promise<InternalResource>;
+    resolve(url: InternalUrl, context?: ResolveContext): Promise<InternalResource>;
     complete(): Promise<UrlCompletion[]>;
 }

package/dist/types/internal-urls/types.d.ts

@@ -4,6 +4,7 @@
  * Internal URLs (`agent://`, `artifact://`, `history://`, `issue://`, `local://`, `mcp://`, `memory://`, `omp://`, `pr://`, `rule://`, `skill://`, and `vault://`) are resolved by tools like read,
  * providing access to agent outputs and server resources without exposing filesystem paths.
  */
+import type { Skill } from "../extensibility/skills";
 import type { LocalProtocolOptions } from "./local-protocol";
 /**
  * Raw resource payload returned by protocol handlers. The `immutable` flag is
@@ -85,6 +86,8 @@ export interface ResolveContext {
      * [#1608](https://github.com/can1357/oh-my-pi/issues/1608).
      */
     localProtocolOptions?: LocalProtocolOptions;
+    /** Calling session's loaded skills. Prefer this over process-global skill state. */
+    skills?: readonly Skill[];
 }
 /**
  * Caller context for write operations dispatched to host-owned URI handlers.

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

@@ -87,8 +87,6 @@ export declare class CustomEditor extends Editor {
     onPasteImage?: () => Promise<boolean>;
     /** Called when a bracketed paste contains one or more image-file paths. */
     onPasteImagePath?: (path: string) => void | Promise<void>;
-    /** Called when a bracketed paste contains one or more non-image file paths. */
-    onPasteFilePath?: (path: string) => void | Promise<void>;
     /** Called when the configured raw text-paste shortcut is pressed. */
     onPasteTextRaw?: () => void;
     /** Called when the configured dequeue shortcut is pressed. */

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

@@ -38,7 +38,6 @@ export declare class InputController {
         abort?: boolean;
         currentText?: string;
     }): number;
-    handleFilePathPaste(filePath: string): Promise<void>;
     handleImagePathPaste(path: string): Promise<void>;
     handleImagePaste(): Promise<boolean>;
     handleClipboardTextRawPaste(): Promise<void>;

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

@@ -760,6 +760,8 @@ export declare class AgentSession {
     abort(options?: {
         goalReason?: "interrupted" | "internal";
         reason?: string;
+        /** Internal `/compact` startup keeps the manual-compaction marker alive while aborting the active turn. */
+        preserveCompaction?: boolean;
     }): Promise<void>;
     /**
      * Start a new session, optionally with initial messages and parent tracking.

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

@@ -4,6 +4,7 @@
  * Runs each subagent on the main thread and forwards AgentEvents for progress tracking.
  */
 import type { AgentTelemetryConfig, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { ServiceTier } from "@oh-my-pi/pi-ai";
 import type { Rule } from "../capability/rule";
 import { ModelRegistry } from "../config/model-registry";
 import type { PromptTemplate } from "../config/prompt-templates";
@@ -119,6 +120,13 @@ export interface ExecutorOptions {
     authStorage?: AuthStorage;
     modelRegistry?: ModelRegistry;
     settings?: Settings;
+    /**
+     * Parent session's live effective service tier, the source of truth for a
+     * subagent whose `serviceTierSubagent` is `"inherit"`. `null` = the parent
+     * explicitly has no tier (e.g. `/fast off`); omitted = no live session, so
+     * inherit falls back to the configured `serviceTier` setting.
+     */
+    parentServiceTier?: ServiceTier | null;
     /** Override local:// protocol options so subagent shares parent's local:// root */
     localProtocolOptions?: LocalProtocolOptions;
     /**
@@ -188,7 +196,7 @@ export declare function finalizeSubprocessOutput(args: FinalizeSubprocessOutputA
  * Create proxy tools that reuse the parent's MCP connections.
  */
 export declare function createMCPProxyTools(mcpManager: MCPManager): CustomTool[];
-export declare function createSubagentSettings(baseSettings: Settings, overrides?: Partial<Record<SettingPath, unknown>>): Settings;
+export declare function createSubagentSettings(baseSettings: Settings, overrides?: Partial<Record<SettingPath, unknown>>, inheritedServiceTier?: ServiceTier | null): Settings;
 /**
  * Run a single agent in-process.
  */

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

@@ -33,6 +33,22 @@ export declare function mapWithConcurrencyLimit<T, R>(items: T[], concurrency: n
 export declare class Semaphore {
     #private;
     constructor(max: number);
-    acquire(): Promise<void>;
+    /**
+     * Resolves when a slot is available. Pass an `AbortSignal` so callers that
+     * stop waiting (parent task cancelled, wall-clock budget elapsed) also stop
+     * occupying a queue slot — otherwise a later `release()` would resolve the
+     * abandoned waiter, permanently shrinking effective concurrency for the
+     * remaining lifetime of the process (issue #3464 review feedback).
+     */
+    acquire(signal?: AbortSignal): Promise<void>;
     release(): void;
+    /**
+     * Adjust the maximum concurrency in place. Raising the ceiling immediately
+     * admits queued waiters that now fit; lowering it lets in-flight holders
+     * drain naturally (new acquires keep blocking until `#current` falls below
+     * the new max). Resizing the single shared instance — instead of replacing
+     * it — keeps in-flight slots counted, so a runtime or mixed limit change can
+     * never push concurrency past the cap (issue #3464 review feedback).
+     */
+    resize(max: number): void;
 }

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

@@ -1,6 +1,6 @@
 import type { InMemorySnapshotStore } from "@oh-my-pi/hashline";
 import type { AgentTelemetryConfig, AgentTool } from "@oh-my-pi/pi-agent-core";
-import type { FetchImpl, ImageContent, Model, ToolChoice } from "@oh-my-pi/pi-ai";
+import type { FetchImpl, ImageContent, Model, ServiceTier, ToolChoice } from "@oh-my-pi/pi-ai";
 import type { AsyncJobManager } from "../async/job-manager";
 import type { Rule } from "../capability/rule";
 import type { PromptTemplate } from "../config/prompt-templates";
@@ -191,6 +191,8 @@ export interface ToolSession {
     getActiveModelString?: () => string | undefined;
     /** Get the current session model object (provider/api capabilities), regardless of how it was chosen. */
     getActiveModel?: () => Model | undefined;
+    /** Get the session's live effective service tier (undefined = none). Source of truth for subagent `serviceTierSubagent: inherit`. */
+    getServiceTier?: () => ServiceTier | undefined;
     /** Auth storage for passing to subagents (avoids re-discovery) */
     authStorage?: import("../session/auth-storage").AuthStorage;
     /** Model registry for passing to subagents (avoids re-discovery) */

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

@@ -1,3 +1,4 @@
+import type { Skill } from "../extensibility/skills";
 import { type LocalProtocolOptions } from "../internal-urls";
 export declare function expandTilde(filePath: string, home?: string): string;
 export declare function expandPath(filePath: string): string;
@@ -189,6 +190,8 @@ export interface ToolScopeOptions {
     signal?: AbortSignal;
     /** Calling session's `local://` root mapping — pins resolutions to the calling session. */
     localProtocolOptions?: LocalProtocolOptions;
+    /** Calling session's loaded skills — lets skill:// resolve without process-global state. */
+    skills?: readonly Skill[];
 }
 export interface ToolScopeResolution {
     searchPath: string;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "16.1.18",
+	"version": "16.1.20",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -35,7 +35,7 @@
 		"check": "biome check . && bun run check:types",
 		"check:types": "tsgo -p tsconfig.json --noEmit",
 		"lint": "biome lint .",
-		"test": "bun test --parallel=4 test src",
+		"test": "bun ../../scripts/ci-test-ts.ts coding-agent-heavy --full",
 		"fix": "biome check --write --unsafe . && bun run format-prompts",
 		"fmt": "biome format --write . && bun run format-prompts",
 		"format-prompts": "bun scripts/format-prompts.ts",
@@ -48,17 +48,17 @@
 		"@agentclientprotocol/sdk": "0.25.0",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "16.1.18",
-		"@oh-my-pi/omp-stats": "16.1.18",
-		"@oh-my-pi/pi-agent-core": "16.1.18",
-		"@oh-my-pi/pi-ai": "16.1.18",
-		"@oh-my-pi/pi-catalog": "16.1.18",
-		"@oh-my-pi/pi-mnemopi": "16.1.18",
-		"@oh-my-pi/pi-natives": "16.1.18",
-		"@oh-my-pi/pi-tui": "16.1.18",
-		"@oh-my-pi/pi-utils": "16.1.18",
-		"@oh-my-pi/pi-wire": "16.1.18",
-		"@oh-my-pi/snapcompact": "16.1.18",
+		"@oh-my-pi/hashline": "16.1.20",
+		"@oh-my-pi/omp-stats": "16.1.20",
+		"@oh-my-pi/pi-agent-core": "16.1.20",
+		"@oh-my-pi/pi-ai": "16.1.20",
+		"@oh-my-pi/pi-catalog": "16.1.20",
+		"@oh-my-pi/pi-mnemopi": "16.1.20",
+		"@oh-my-pi/pi-natives": "16.1.20",
+		"@oh-my-pi/pi-tui": "16.1.20",
+		"@oh-my-pi/pi-utils": "16.1.20",
+		"@oh-my-pi/pi-wire": "16.1.20",
+		"@oh-my-pi/snapcompact": "16.1.20",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",

package/scripts/build-binary.ts

@@ -51,6 +51,17 @@ async function main(): Promise<void> {
 	try {
 		await runCommand(["bun", "--cwd=../stats", "scripts/generate-client-bundle.ts", "--generate"]);
 		await runCommand(["bun", "scripts/generate-docs-index.ts", "--generate"]);
+		// `legacy-pi-bundled-registry.ts` static-imports
+		// `@oh-my-pi/pi-coding-agent/export/html` (one of pi-coding-agent's
+		// named subpath exports, see scripts/generate-legacy-pi-bundled-registry.ts),
+		// whose source pulls in `tool-views.generated.js`. The root
+		// `package.json` "prepare" lifecycle hook builds that file on
+		// `bun install`, but a clean binary build that skips install hooks
+		// would `bun build --compile` against the registry entry and fail
+		// resolving the missing generated bundle. Rebuilding the tool views
+		// here makes the compile self-contained and matches what `prepack`
+		// does for the npm bundle.
+		await runCommand(["bun", "--cwd=../collab-web", "run", "build:tool-views"]);
 		await runCommand(
 			["bun", "--cwd=../natives", "run", "embed:native"],
 			crossTarget
@@ -58,6 +69,15 @@ async function main(): Promise<void> {
 				: Bun.env,
 		);
 		await runCommand(["bun", "scripts/embed-mupdf-wasm.ts", "--generate"]);
+		// Regenerate the bundled-pi registry + key set before the compile so any
+		// new pi-* subpath export added under `packages/*/package.json` is served
+		// from the host's in-process copy. Without this, `bun build --compile`
+		// would freeze whatever the committed registry happened to enumerate at
+		// the time of the last manual `--generate`, and a new subpath added
+		// since then would crash extension validation with `Cannot find module`
+		// (issue #3442). The generator also normalizes formatting, so the diff
+		// against the committed copy stays clean.
+		await runCommand(["bun", "scripts/generate-legacy-pi-bundled-registry.ts", "--generate"]);
 		try {
 			const buildEnv = shouldAdhocSignDarwinBinary() ? { ...Bun.env, BUN_NO_CODESIGN_MACHO_BINARY: "1" } : Bun.env;
 			await runCommand(