@oh-my-pi/pi-coding-agent 17.0.8 → 17.1.0

package/dist/types/exec/bash-executor.d.ts

@@ -43,6 +43,44 @@ export interface BashResult {
     artifactId?: string;
     workingDir?: string;
 }
+export interface DirenvPreflightOptions {
+    /** Caller-supplied env overlay; these values win over direnv-provided ones. */
+    callerEnv?: Record<string, string>;
+    signal?: AbortSignal;
+    /** Full direnv-load budget (`bash.direnvLoadTimeoutMs`). A positive
+     *  `callerTimeoutMs` clamps the effective load below this; `0`/undefined
+     *  leaves the full budget. */
+    timeoutMs?: number;
+    /** The caller's command deadline (ms). A positive value clamps the direnv
+     *  load so a cold `.envrc` can't outlast a short-timeout command; `0` or
+     *  undefined means "no caller clamp" — the load keeps its full `timeoutMs`
+     *  budget (a disabled command deadline is NOT a 0 ms load). Centralizing the
+     *  clamp here keeps every backend (executeBash, ACP terminal, PTY) on one
+     *  contract instead of each re-deriving it. */
+    callerTimeoutMs?: number;
+    /** `bash.direnv` setting — `"off"` skips the load entirely. */
+    direnvSetting: "auto" | "off";
+    /** Shell wrapper prefix (profiler/strace) to place *after* the unset prefix,
+     *  matching `executeBash`'s ordering. Backends that apply their own shell
+     *  wrapping (ACP `wrapShellLineForClientTerminal`) omit this. */
+    commandPrefix?: string | undefined;
+}
+/**
+ * Load the repo's direnv/devenv env and fold it into a `(command, env)` pair so
+ * every bash backend (one-shot `executeBash`, ACP client terminal, PTY) exposes
+ * the same devenv tools. Encapsulates: load the diff, merge `set` under the
+ * caller's overlay (caller wins), and prepend a regex-gated `unset -v` for
+ * variables the `.envrc` removes (skipping any the caller re-supplied).
+ *
+ * Returns the possibly-prefixed command plus the merged env, or the inputs
+ * unchanged (`env` = `callerEnv`) when direnv is off, absent, or has no `.envrc`.
+ * Pure transform: does NOT layer non-interactive env defaults — that stays the
+ * caller's job (so interactive PTY/ACP paths keep their own env shape).
+ */
+export declare function applyDirenvPreflight(command: string, cwd: string, opts: DirenvPreflightOptions): Promise<{
+    command: string;
+    env: Record<string, string> | undefined;
+}>;
 /** Translate `ShellMinimizerSettings` into native `MinimizerOptions`, or `undefined` when disabled. */
 export declare function buildMinimizerOptions(group: ShellMinimizerSettings): MinimizerOptions | undefined;
 export declare function isPersistentShellCdCommand(command: string): boolean;

package/dist/types/exec/direnv.d.ts

@@ -0,0 +1,33 @@
+/** Default cap on a single `direnv` invocation. The first export for a devenv
+ *  `.envrc` can build a shell; callers may raise this via `bash.direnvLoadTimeoutMs`. */
+export declare const DEFAULT_DIRENV_TIMEOUT_MS = 30000;
+/** Walk up from `startDir` to the nearest directory containing an `.envrc`. */
+export declare function findEnvrc(startDir: string): Promise<string | null>;
+export interface DirenvExportDiff {
+    /** Variables direnv sets to a concrete value. */
+    set: Record<string, string>;
+    /** Variables direnv removes (JSON `null`). */
+    unset: string[];
+}
+/** Parse `direnv export json` output (`{VAR: value|null}`) into set/unset halves. */
+export declare function parseDirenvExport(jsonText: string): DirenvExportDiff;
+/**
+ * Resolve the nearest `.envrc` from `cwd` and return its `direnv export` diff
+ * (variables to set, and variables direnv removes). Returns `null` when there
+ * is no `.envrc`, `direnv` is not installed, the `.envrc` is not on direnv's
+ * allow list, or the export fails/times out.
+ *
+ * direnv's own allow list is honored — an `.envrc` the user has not
+ * `direnv allow`ed is NEVER executed or auto-allowed. This keeps OMP's trust
+ * boundary identical to the user's own shell: cloning a repo with a poisoned
+ * `.envrc` grants it nothing until the user explicitly allows it.
+ *
+ * Always re-invokes `direnv export json` rather than serving a cached diff:
+ * direnv is fast once warm, and its own watch/mtime invalidation is the
+ * authoritative freshness signal (a content-hash cache here would go stale when
+ * a `watch_file` target changes without the `.envrc` text changing).
+ */
+export declare function loadDirenvEnv(cwd: string, opts?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<DirenvExportDiff | null>;

package/dist/types/export/html/args.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `/export` argument parsing, split from `./index.ts` so slash-command
+ * registries can parse arguments without eagerly loading the export module's
+ * embedded template/tool-view text.
+ */
+/** Dark and light TUI theme names bundled into a dual-theme export. */
+export interface ExportThemeNames {
+    dark: string;
+    light: string;
+}
+/** Parse `/export [--themes] [path]`; paths containing spaces were never supported. */
+export declare function parseExportArgs(args: string): {
+    outputPath?: string;
+    useUserThemes: boolean;
+};

package/dist/types/export/html/index.d.ts

@@ -1,45 +1,30 @@
 import type { AgentState } from "@oh-my-pi/pi-agent-core";
 import type { SessionEntry, SessionHeader } from "../../session/session-entries.js";
 import { SessionManager } from "../../session/session-manager.js";
+import type { ExportThemeNames } from "./args.js";
+export { type ExportThemeNames, parseExportArgs } from "./args.js";
 /** Compose the standalone export template: minified CSS, tool renderers, and viewer JS inlined. */
 export declare function getTemplate(): string;
 export interface ExportOptions {
     outputPath?: string;
-    /**
-     * Which color palette the export ships with.
-     * - `"web"` (default) — the omp brand identity (collab-web pink/purple),
-     *   so public HTML exports and the `/s/<id>` share viewer match the live
-     *   `my.omp.sh` client. See `web-palette.ts`.
-     * - `"theme"` — derive from `themeName` (or the active TUI theme), preserving
-     *   the pre-15.12 behavior where an export mirrored the user's terminal.
-     */
+    /** `"web"` bundles the omp web themes; `"theme"` bundles TUI themes. */
     palette?: "web" | "theme";
-    /**
-     * TUI theme to derive colors from when `palette: "theme"`. Ignored for the
-     * default `"web"` palette. Resolves to the active TUI theme when omitted.
-     */
+    /** Legacy single TUI theme name. Prefer `themeNames` for dual-theme exports. */
     themeName?: string;
+    /** Dark and light TUI themes to bundle when `palette` is `"theme"`. */
+    themeNames?: ExportThemeNames;
     /** Embed subagent session transcripts found next to the session file (default true). */
     includeSubSessions?: boolean;
 }
 /**
- * Generate CSS custom properties for the export `:root`.
+ * Generate CSS custom properties for one export theme.
  *
- * Two call shapes:
- *   • `generateThemeVars("web" | "theme", themeName?)` — explicit palette.
- *     `"web"` (the default for public artifacts) returns the fixed omp brand
- *     palette from `web-palette.ts` — collab-web pink/purple identity, shared
- *     with the live `my.omp.sh` client, so exports and the share viewer render
- *     identically to it. `"theme"` derives from the TUI theme via
- *     `getResolvedThemeColors(themeName)` plus the three
- *     `export.{pageBg,cardBg,infoBg}` surface overrides.
- *   • `generateThemeVars(themeName)` — legacy single-arg form: derive from the
- *     named TUI theme. Kept so existing callers (and the theme-islight test)
- *     keep working; equivalent to `generateThemeVars("theme", themeName)`.
- *
- * Exported for the share-viewer build script.
+ * The single-argument theme-name form remains available to callers that need
+ * one TUI palette. Standalone HTML uses `generateThemeStyles()` below.
  */
 export declare function generateThemeVars(palette?: "web" | "theme" | (string & {}), themeName?: string): Promise<string>;
+/** Generate dark, light, and auto-following CSS rules for a standalone viewer. */
+export declare function generateThemeStyles(palette: "web" | "theme", themeNames?: ExportThemeNames, legacyThemeName?: string): Promise<string>;
 /** Embedded subagent session transcript, keyed by slash-joined agent path in `SessionData.subSessions`. */
 export interface SubSession {
     /** Bare agent id (session file stem), e.g. "ToolAsk". */

package/dist/types/export/html/web-palette.d.ts

@@ -1,117 +1,56 @@
-/**
- * Web/export palette — the omp brand identity shared by the collab-web live
- * client (`my.omp.sh/`) and every public HTML export / share viewer (`/s/<id>`).
- *
- * Why this exists separately from `modes/theme/dark.json`: the `dark` theme is
- * the **default TUI theme** — its amber accent (`#febc38`) drives the terminal
- * status line, syntax highlighting, thinking levels, and bash/python mode
- * colors for every omp user. The public web artifacts want the collab-web
- * pink/purple identity instead, so they pin this palette rather than inheriting
- * the TUI's. Editing `dark.json` to repurpose it for the web would repaint
- * every terminal; this file keeps the two surfaces decoupled.
- *
- * Token layout — emitted as CSS custom properties on `:root`:
- *   • Legacy export names consumed by `template.css` / `template.js`
- *     (`--text`, `--body-bg`, `--container-bg`, `--info-bg`, `--accent`,
- *      `--border`, `--success`, `--error`, `--warning`, `--muted`, `--dim`,
- *      `--borderAccent`, `--selectedBg`, `--userMessageBg`, `--customMessageBg`,
- *      `--customMessageLabel`, `--mdHeading`, `--mdLink`, `--mdCode`,
- *      `--mdListBullet`, `--toolOutput`, `--thinkingText`, syntax*, …).
- *   • collab-web-native aliases consumed by the `tv-` tool-render bridge
- *     (`tool-render.css`: `var(--bg-inset, …)`, `var(--fg, …)`, …) so embedded
- *     tool cards resolve to the *real* collab-web tokens and render
- *     pixel-identical to the live client.
- *
- * Alpha-bearing tokens (`--border`, `--ring`, `--accent-muted`, …) keep their
- * `oklch(… / N%)` form — flattening them to opaque hex would produce harsh
- * white borders and non-matching translucent focus rings. Opaque surfaces are
- * sRGB hex (the collab-web `tokens.css` OKLCH dark-theme tokens converted via
- * the standard OKLab→linear-sRGB→gamma path); if the live client palette
- * changes, regenerate those from there.
- */
-export declare const WEB_EXPORT_PALETTE: {
-    readonly "--bg": "#0f0b14";
-    readonly "--bg-raised": "#16111c";
-    readonly "--bg-inset": "#09060c";
-    readonly "--bg-overlay": "#211b28";
-    readonly "--fg": "#e6e3ea";
-    readonly "--fg-muted": "#a49faa";
-    readonly "--fg-faint": "#6e6974";
-    readonly "--accent": "#ed4abf";
-    readonly "--accent-muted": "oklch(0.674 0.23 341 / 18%)";
-    readonly "--ok": "#68ca80";
-    readonly "--err": "#f05653";
-    readonly "--warn": "#e4b33f";
-    readonly "--ring": "oklch(0.817 0.112 205 / 70%)";
-    readonly "--font-mono": 'ui-monospace, "SF Mono", "JetBrains Mono", "Cascadia Mono", Menlo, Consolas, monospace';
-    readonly "--body-bg": "#0f0b14";
-    readonly "--container-bg": "#16111c";
-    readonly "--info-bg": "#09060c";
-    readonly "--text": "#e6e3ea";
-    readonly "--muted": "#a49faa";
-    readonly "--dim": "#6e6974";
-    readonly "--thinkingText": "#a49faa";
-    readonly "--border": "oklch(1 0 0 / 9%)";
-    readonly "--borderMuted": "oklch(1 0 0 / 6%)";
-    readonly "--borderAccent": "#945ff9";
-    readonly "--selectedBg": "#2d2535";
-    readonly "--success": "#68ca80";
-    readonly "--error": "#f05653";
-    readonly "--warning": "#e4b33f";
-    readonly "--userMessageBg": "oklch(0.674 0.23 341 / 6%)";
-    readonly "--userMessageText": "#e6e3ea";
-    readonly "--customMessageBg": "#211b28";
-    readonly "--customMessageText": "#a49faa";
-    readonly "--customMessageLabel": "#b281d6";
-    readonly "--toolPendingBg": "#16111c";
-    readonly "--toolSuccessBg": "#09060c";
-    readonly "--toolErrorBg": "oklch(0.66 0.19 25 / 14%)";
-    readonly "--toolTitle": "#e6e3ea";
-    readonly "--toolOutput": "#a49faa";
-    readonly "--mdHeading": "#ed4abf";
-    readonly "--mdLink": "#5ad8e5";
-    readonly "--mdLinkUrl": "#6e6974";
-    readonly "--mdCode": "#e6e3ea";
-    readonly "--mdCodeBlock": "#e6e3ea";
-    readonly "--mdCodeBlockBorder": "oklch(1 0 0 / 9%)";
-    readonly "--mdQuote": "#a49faa";
-    readonly "--mdQuoteBorder": "oklch(1 0 0 / 13%)";
-    readonly "--mdHr": "oklch(1 0 0 / 9%)";
-    readonly "--mdListBullet": "#ed4abf";
-    readonly "--toolDiffAdded": "#68ca80";
-    readonly "--toolDiffRemoved": "#f05653";
-    readonly "--toolDiffContext": "#6e6974";
-    readonly "--syntaxComment": "#6e6974";
-    readonly "--syntaxKeyword": "#945ff9";
-    readonly "--syntaxFunction": "#e4b33f";
-    readonly "--syntaxVariable": "#5ad8e5";
-    readonly "--syntaxString": "#68ca80";
-    readonly "--syntaxNumber": "#ed4abf";
-    readonly "--syntaxType": "#b281d6";
-    readonly "--syntaxOperator": "#e6e3ea";
-    readonly "--syntaxPunctuation": "#a49faa";
-    readonly "--thinkingOff": "#6e6974";
-    readonly "--thinkingMinimal": "#6e6974";
-    readonly "--thinkingLow": "#945ff9";
-    readonly "--thinkingMedium": "#b281d6";
-    readonly "--thinkingHigh": "#ed4abf";
-    readonly "--thinkingXhigh": "#e4b33f";
-    readonly "--bashMode": "#5ad8e5";
-    readonly "--pythonMode": "#e4b33f";
-    readonly "--statusLineBg": "#0f0b14";
-    readonly "--statusLineSep": "#6e6974";
-    readonly "--statusLineModel": "#ed4abf";
-    readonly "--statusLinePath": "#5ad8e5";
-    readonly "--statusLineGitClean": "#68ca80";
-    readonly "--statusLineGitDirty": "#e4b33f";
-    readonly "--statusLineContext": "#a49faa";
-    readonly "--statusLineSpend": "#5ad8e5";
-    readonly "--statusLineStaged": "#68ca80";
-    readonly "--statusLineDirty": "#e4b33f";
-    readonly "--statusLineUntracked": "#945ff9";
-    readonly "--statusLineOutput": "#b281d6";
-    readonly "--statusLineCost": "#b281d6";
-    readonly "--statusLineSubagents": "#ed4abf";
+/** omp web palette bundled into standalone exports and the share viewer. */
+export type WebExportScheme = "dark" | "light";
+export declare const WEB_EXPORT_PALETTES: {
+    readonly dark: {
+        readonly "--bg": "#0f0b14";
+        readonly "--bg-raised": "#16111c";
+        readonly "--bg-inset": "#09060c";
+        readonly "--bg-overlay": "#211b28";
+        readonly "--fg": "#e6e3ea";
+        readonly "--fg-muted": "#a49faa";
+        readonly "--fg-faint": "#6e6974";
+        readonly "--accent": "#ed4abf";
+        readonly "--accent-muted": "oklch(0.674 0.23 341 / 18%)";
+        readonly "--ok": "#68ca80";
+        readonly "--err": "#f05653";
+        readonly "--warn": "#e4b33f";
+        readonly "--border": "oklch(1 0 0 / 9%)";
+        readonly "--border-strong": "oklch(1 0 0 / 13%)";
+        readonly "--ring": "oklch(0.817 0.112 205 / 70%)";
+        readonly "--link": "#5ad8e5";
+        readonly "--syntaxComment": "#6e6974";
+        readonly "--syntaxKeyword": "#945ff9";
+        readonly "--syntaxFunction": "#e4b33f";
+        readonly "--syntaxVariable": "#5ad8e5";
+        readonly "--syntaxString": "#68ca80";
+        readonly "--syntaxNumber": "#ed4abf";
+        readonly "--syntaxType": "#b281d6";
+    };
+    readonly light: {
+        readonly "--bg": "oklch(0.985 0.004 307)";
+        readonly "--bg-raised": "oklch(1 0 0)";
+        readonly "--bg-inset": "oklch(0.95 0.006 307)";
+        readonly "--bg-overlay": "oklch(0.965 0.006 307)";
+        readonly "--fg": "oklch(0.26 0.03 307)";
+        readonly "--fg-muted": "oklch(0.46 0.03 307)";
+        readonly "--fg-faint": "oklch(0.58 0.025 307)";
+        readonly "--accent": "oklch(0.62 0.23 341)";
+        readonly "--accent-muted": "oklch(0.62 0.23 341 / 14%)";
+        readonly "--ok": "oklch(0.55 0.13 150)";
+        readonly "--err": "oklch(0.55 0.19 25)";
+        readonly "--warn": "oklch(0.6 0.13 85)";
+        readonly "--border": "oklch(0 0 0 / 10%)";
+        readonly "--border-strong": "oklch(0 0 0 / 15%)";
+        readonly "--ring": "oklch(0.58 0.13 230 / 70%)";
+        readonly "--link": "#0f7a88";
+        readonly "--syntaxComment": "#77717c";
+        readonly "--syntaxKeyword": "#6d35c7";
+        readonly "--syntaxFunction": "#8a6000";
+        readonly "--syntaxVariable": "#087f8c";
+        readonly "--syntaxString": "#247a3d";
+        readonly "--syntaxNumber": "#b51f88";
+        readonly "--syntaxType": "#7b3fa2";
+    };
 };
-/** Serialize the palette as `--key: value;` declarations for `:root { … }`. */
-export declare function webExportThemeVars(): string;
+/** Serialize one web color scheme as CSS custom-property declarations. */
+export declare function webExportThemeVars(scheme: WebExportScheme): string;

package/dist/types/extensibility/extensions/loader.d.ts

@@ -1,4 +1,5 @@
 import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { ServiceTierByFamily } from "@oh-my-pi/pi-ai";
 import { EventBus } from "../../utils/event-bus.js";
 import type { Extension, ExtensionFactory, ExtensionRuntime as IExtensionRuntime, LoadExtensionsResult, ProviderConfig } from "./types.js";
 export declare class ExtensionRuntimeNotInitializedError extends Error {
@@ -26,6 +27,8 @@ export declare class ExtensionRuntime implements IExtensionRuntime {
     setModel(): Promise<boolean>;
     getThinkingLevel(): ThinkingLevel;
     setThinkingLevel(): void;
+    getServiceTiers(): ServiceTierByFamily;
+    setServiceTier(): void;
     getSessionName(): string | undefined;
     setSessionName(): Promise<void>;
 }

package/dist/types/extensibility/extensions/types.d.ts

@@ -9,7 +9,7 @@
  */
 import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel, ToolApproval, ToolLoadMode } from "@oh-my-pi/pi-agent-core";
 import type { CompactionResult } from "@oh-my-pi/pi-agent-core/compaction";
-import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context, ImageContent, Model, ModelSpec, ProviderResponseMetadata, SimpleStreamOptions, Static, TextContent, TSchema } from "@oh-my-pi/pi-ai";
+import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context, ImageContent, Model, ModelSpec, ProviderResponseMetadata, ServiceTier, ServiceTierByFamily, ServiceTierFamily, SimpleStreamOptions, Static, TextContent, TSchema } from "@oh-my-pi/pi-ai";
 import type { OAuthCredentials, OAuthLoginCallbacks } from "@oh-my-pi/pi-ai/oauth/types";
 import type { AutocompleteItem, AutocompleteProvider, Component, EditorTheme, KeyId, TUI } from "@oh-my-pi/pi-tui";
 import type { logger as PiLogger } from "@oh-my-pi/pi-utils";
@@ -690,6 +690,8 @@ export interface RegisteredCommand {
 }
 /** Handler function type for events */
 export type ExtensionHandler<E, R = undefined> = (event: E, ctx: ExtensionContext) => Promise<R | void> | R | void;
+/** Service tiers accepted by each provider family. */
+export type ExtensionServiceTier<Family extends ServiceTierFamily> = Family extends "anthropic" ? "priority" : Family extends "google" ? "flex" | "priority" : ServiceTier;
 /**
  * ExtensionAPI passed to extension factory functions.
  */
@@ -806,6 +808,13 @@ export interface ExtensionAPI {
     getThinkingLevel(): ThinkingLevel | undefined;
     /** Set thinking level for the current session. */
     setThinkingLevel(level: ThinkingLevel): void;
+    /** Get a snapshot of the current session's per-family service tiers. */
+    getServiceTiers(): Readonly<ServiceTierByFamily>;
+    /**
+     * Set one provider family's service tier for subsequent requests, or clear
+     * its session override with `undefined`.
+     */
+    setServiceTier<Family extends ServiceTierFamily>(family: Family, tier: ExtensionServiceTier<Family> | undefined): void;
     /** Get the current session name. */
     getSessionName(): string | undefined;
     /** Set the session name. Persists to the session file. */
@@ -957,6 +966,8 @@ export type SetActiveToolsHandler = (toolNames: string[]) => Promise<void>;
 export type SetModelHandler = (model: Model) => Promise<boolean>;
 export type GetThinkingLevelHandler = () => ThinkingLevel | undefined;
 export type SetThinkingLevelHandler = (level: ThinkingLevel, persist?: boolean) => void;
+export type GetServiceTiersHandler = () => ServiceTierByFamily;
+export type SetServiceTierHandler = (family: ServiceTierFamily, tier: ServiceTier | undefined) => void;
 /** Shared state created by loader, used during registration and runtime. */
 export interface ExtensionRuntimeState {
     flagValues: Map<string, boolean | string>;
@@ -980,6 +991,8 @@ export interface ExtensionActions {
     setModel: SetModelHandler;
     getThinkingLevel: GetThinkingLevelHandler;
     setThinkingLevel: SetThinkingLevelHandler;
+    getServiceTiers?: GetServiceTiersHandler;
+    setServiceTier?: SetServiceTierHandler;
     getSessionName: () => string | undefined;
     setSessionName: (name: string) => Promise<void>;
 }
@@ -1018,8 +1031,10 @@ export interface ExtensionCommandContextActions {
     }>;
     reload: () => Promise<void>;
 }
-/** Full runtime = state + actions. */
+/** Full runtime = state + actions, including host-compatible service-tier fallbacks. */
 export interface ExtensionRuntime extends ExtensionRuntimeState, ExtensionActions {
+    getServiceTiers: GetServiceTiersHandler;
+    setServiceTier: SetServiceTierHandler;
 }
 /** Loaded extension with all registered items. */
 export interface Extension {

package/dist/types/extensibility/legacy-pi-coding-agent-shim.d.ts

@@ -371,4 +371,5 @@ export { getProjectDir } from "@oh-my-pi/pi-utils";
 export declare function getPackageDir(): string;
 export * from "../index.js";
 export { formatBytes as formatSize } from "../tools/render-utils.js";
+export { copyToClipboard } from "../utils/clipboard.js";
 export { Type } from "./typebox.js";

package/dist/types/extensibility/legacy-pi-tui-shim.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Compatibility shim for legacy extensions importing the package root of
+ * `@earendil-works/pi-tui` or `@mariozechner/pi-tui`.
+ *
+ * The historical root exported `decodeKittyPrintable`; the canonical TUI now
+ * exposes the equivalent, broader `decodePrintableKey` helper. Keep the legacy
+ * name available without reintroducing it into the canonical package surface.
+ */
+export * from "@oh-my-pi/pi-tui";
+export { decodePrintableKey as decodeKittyPrintable } from "@oh-my-pi/pi-tui";

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

@@ -57,7 +57,20 @@ export declare function __validateLegacyPiPackageRootOverrides(candidates: Recor
  */
 export declare function __buildLegacyPiPackageRootOverrides(isCompiled: boolean, bundledModuleKeys?: Iterable<string>): Record<string, string>;
 /** Test seam for compiled-binary legacy extension source rewriting. */
-export declare function __rewriteLegacyExtensionSourceForTests(source: string, importerPath: string, mtimeTag?: string | null): Promise<string>;
+export declare function __rewriteLegacyExtensionSourceForTests(source: string, importerPath: string, mtimeTag?: string | null, resolvedImportMtimeTag?: string | null): Promise<string>;
+/**
+ * Register {@link evaluateGraphCommonJs} as the graph-owned CommonJS require
+ * bridge on `globalThis`, first-wins.
+ *
+ * On source-link installs the `@(scope)/pi-coding-agent` root shim is served
+ * from `src/`, so an extension import can evaluate a second instance of this
+ * module with empty graph state. An unconditional set would let that empty
+ * instance clobber the host bundle's populated bridge and break transitive
+ * CommonJS resolution (#6449); guarding preserves the first (host-owned)
+ * registration. Idempotent: a subsequent call with a value already present is a
+ * no-op.
+ */
+export declare function ensureGraphCommonJsRequireRegistered(): void;
 /**
  * Load a legacy Pi extension module from its real on-disk location.
  *

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

@@ -31,3 +31,14 @@ export declare function artifactsDirsFromRegistry(): string[];
  * multiple dirs, the first hit wins (registry dirs are scanned first).
  */
 export declare function sessionFilesFromDisk(): Promise<Map<string, string>>;
+/**
+ * Availability half of the `history://` resolution semantics: true when a
+ * transcript for `agentId` can be served from a registered ref's live session
+ * or retained session file, or from an on-disk `.jsonl` under a known
+ * artifacts dir. Hint surfaces use this so they only advertise
+ * `history://<agentId>` links that `HistoryProtocolHandler` can actually
+ * resolve. A retained sessionFile path is verified on disk before it counts,
+ * and probing never throws: a stale path or unreadable artifacts subtree
+ * reads as unavailable instead of disturbing the caller's delivery path.
+ */
+export declare function hasResolvableTranscript(agentId: string): Promise<boolean>;

package/dist/types/live/controller.d.ts

@@ -0,0 +1,40 @@
+import type { AssistantMessage } from "@oh-my-pi/pi-ai";
+import type { AgentSession } from "../session/agent-session.js";
+import type { LivePhase, LiveTranscript } from "./visualizer.js";
+/** UI notifications emitted during a live session. */
+export interface LiveSessionCallbacks {
+    /** Reports connection and activity phase changes. */
+    onPhase(phase: LivePhase): void;
+    /** Reports clamped microphone and speaker RMS levels. */
+    onLevels(input: number, output: number): void;
+    /** Reports the latest available conversational transcript. */
+    onTranscript(transcript: LiveTranscript | undefined): void;
+    /** Reports one terminal stop, optionally carrying its cause. */
+    onTerminal(error?: Error): void;
+}
+/** Dependencies and presentation callbacks for a live session. */
+export interface LiveSessionControllerOptions {
+    /** Agent session that performs all delegated coding work. */
+    session: AgentSession;
+    /** UI callbacks for live session state. */
+    callbacks: LiveSessionCallbacks;
+    /** Extracts visible assistant text using the caller's normal UI rules. */
+    extractAssistantText(message: AssistantMessage): string;
+    /** Realtime output voice, defaulting to marin. */
+    voice?: string;
+}
+/** Coordinates the realtime conversational surface with normal AgentSession turns. */
+export declare class LiveSessionController {
+    #private;
+    constructor(options: LiveSessionControllerOptions);
+    /** Current realtime call phase. */
+    get phase(): LivePhase;
+    /** Whether microphone input is currently muted. */
+    get muted(): boolean;
+    /** Connects the realtime surface and starts microphone streaming. */
+    start(): Promise<void>;
+    /** Toggles microphone capture while leaving output and the session connected. */
+    toggleMute(): void;
+    /** Stops recording, closes the live session, and emits one terminal callback. */
+    stop(): Promise<void>;
+}

package/dist/types/live/protocol.d.ts

@@ -0,0 +1,85 @@
+/** Frameless Bidi model used by Codex Desktop live calls. */
+export declare const LIVE_MODEL: "gpt-live-1-boulder-alpha";
+/** Maximum UTF-8 payload size accepted by each context append. */
+export declare const CONTEXT_CHUNK_BYTES = 500;
+/** Semantic stream selected for appended Frameless Bidi context. */
+export type LiveContextChannel = "speakable" | "commentary";
+/** Text content item accepted by Frameless Bidi context appends. */
+export type LiveInputTextContent = {
+    type: "input_text";
+    text: string;
+};
+/** Session object posted alongside the SDP when opening a live call. */
+export type LiveSessionPayload = {
+    model: typeof LIVE_MODEL;
+    instructions: string;
+    audio: {
+        output: {
+            voice: string;
+        };
+    };
+    delegation: {
+        type: "client";
+    };
+};
+/** Messages sent by the client over the Frameless Bidi data channel. */
+export type LiveClientMessage = {
+    type: "delegation.context.append";
+    delegation_item_id: string;
+    channel?: LiveContextChannel;
+    content: LiveInputTextContent[];
+} | {
+    type: "session.context.append";
+    channel?: LiveContextChannel;
+    content: LiveInputTextContent[];
+} | {
+    type: "session.close";
+};
+/** Parsed Frameless Bidi server events, including unsupported wire event types. */
+export type LiveServerEvent = {
+    type: "session.started" | "session.updated";
+    session: {
+        id: string;
+        instructions?: string;
+    };
+} | {
+    type: "output_audio.delta";
+    audio: string;
+} | {
+    type: "input_transcript.added" | "output_transcript.added";
+    item: {
+        text: string;
+    };
+} | {
+    type: "turn.done";
+    turn: {
+        role: "user" | "assistant";
+        transcript: string;
+    };
+} | {
+    type: "delegation.created";
+    item: {
+        type: "delegation";
+        target: "client";
+        id: string;
+        content: LiveInputTextContent[];
+    };
+} | {
+    type: "error";
+    message: string;
+} | {
+    type: "unknown";
+    wireType: string;
+};
+/** Parse a JSON string or decoded value from the Frameless Bidi data channel. */
+export declare function parseLiveServerEvent(payload: unknown): LiveServerEvent | null;
+/** Build the session object posted in the multipart WebRTC call request. */
+export declare function buildLiveSessionPayload(instructions: string, voice: string): LiveSessionPayload;
+/** Build a context append associated with a server-created delegation. */
+export declare function buildDelegationContextAppend(delegationItemId: string, text: string, channel?: LiveContextChannel): LiveClientMessage;
+/** Build context appended to the live session outside a delegation. */
+export declare function buildSessionContextAppend(text: string, channel?: LiveContextChannel): LiveClientMessage;
+/** Build the message that gracefully closes a live session. */
+export declare function buildSessionClose(): LiveClientMessage;
+/** Split context into character-safe chunks of at most 500 UTF-8 bytes. */
+export declare function chunkLiveContext(text: string): string[];

package/dist/types/live/protocol.test.d.ts

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

package/dist/types/live/transport.d.ts

@@ -0,0 +1,48 @@
+import { type AuthStorage } from "@oh-my-pi/pi-ai";
+import { type LiveClientMessage, type LiveServerEvent } from "./protocol.js";
+type BrowserLiveApi = {
+    start(workletSource: string): Promise<string>;
+    acceptAnswer(sdp: string): Promise<void>;
+    waitForOpen(): Promise<void>;
+    send(payload: string): void;
+    pushAudio(payload: string): void;
+    setMuted(muted: boolean): void;
+    close(): Promise<void>;
+};
+declare global {
+    var ompCodexLive: BrowserLiveApi;
+}
+/** Callbacks emitted by the live WebRTC transport. */
+export interface LiveTransportCallbacks {
+    onEvent(event: LiveServerEvent): void;
+    onOutputLevel(level: number): void;
+}
+/** Configuration required to establish a Codex live call. */
+export interface LiveTransportOptions {
+    authStorage: AuthStorage;
+    sessionId: string;
+    instructions: string;
+    voice: string;
+    callbacks: LiveTransportCallbacks;
+    signal?: AbortSignal;
+}
+/** Extracts the server-assigned `rtc_<uuid>` call ID from a signaling Location header. */
+export declare function parseLiveCallId(location: string | null): string | undefined;
+/** Builds the Frameless Bidi sideband WebSocket URL for an accepted Codex call. */
+export declare function buildLiveSidebandUrl(callId: string): string;
+/** Headless-Chromium WebRTC transport for a Codex Frameless Bidi live session. */
+export declare class CodexLiveTransport {
+    #private;
+    constructor(options: LiveTransportOptions);
+    /** Establish the browser peer, perform Codex signaling, and wait for the data channel. */
+    connect(): Promise<void>;
+    /** Serialize one Frameless Bidi control message onto the call's sideband WebSocket. */
+    send(message: LiveClientMessage): Promise<void>;
+    /** Queue 16 kHz mono Float32 PCM for continuous browser-side resampling and playback. */
+    pushAudio(samples: Float32Array): void;
+    /** Enable or disable the browser audio source and discard queued input when muted. */
+    setMuted(muted: boolean): Promise<void>;
+    /** Stop audio, WebRTC, the page, and Chromium. Safe to call repeatedly. */
+    close(): Promise<void>;
+}
+export {};