@oh-my-pi/pi-coding-agent 17.0.0 → 17.0.2

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

@@ -18,7 +18,7 @@ import { type CompactionResult, type ShakeConfig } from "@oh-my-pi/pi-agent-core
 import type { AssistantMessage, Context, ImageContent, Message, MessageAttribution, Model, ProviderSessionState, ResetCreditAccountStatus, ResetCreditRedeemOutcome, ResetCreditTarget, ServiceTier, ServiceTierByFamily, ServiceTierFamily, SimpleStreamOptions, TextContent, ToolChoice, UsageReport } from "@oh-my-pi/pi-ai";
 import { Effort } from "@oh-my-pi/pi-ai";
 import { postmortem } from "@oh-my-pi/pi-utils";
-import { type AdvisorConfig } from "../advisor/index.js";
+import { type AdvisorConfig, type AdvisorRuntimeStatus } from "../advisor/index.js";
 import { type AsyncJob, type AsyncJobDeliveryState, AsyncJobManager } from "../async/index.js";
 import type { Rule } from "../capability/rule.js";
 import type { ModelRegistry } from "../config/model-registry.js";
@@ -34,7 +34,7 @@ import type { CustomTool } from "../extensibility/custom-tools/types.js";
 import type { ExtensionRunner } from "../extensibility/extensions/index.js";
 import type { CompactOptions, ContextUsage } from "../extensibility/extensions/types.js";
 import type { RecoveredRetryError } from "../extensibility/shared-events.js";
-import type { Skill, SkillWarning } from "../extensibility/skills.js";
+import { type Skill, type SkillWarning } from "../extensibility/skills.js";
 import { type FileSlashCommand } from "../extensibility/slash-commands.js";
 import { GoalRuntime } from "../goals/runtime.js";
 import type { Goal, GoalModeState } from "../goals/state.js";
@@ -209,6 +209,8 @@ export interface AgentSessionConfig {
     skills?: Skill[];
     /** Skill loading warnings (already captured by SDK) */
     skillWarnings?: SkillWarning[];
+    /** Whether runtime reloads may rediscover disk-backed skills for this session. */
+    skillsReloadable?: boolean;
     /** Custom commands (TypeScript slash commands) */
     customCommands?: LoadedCustomCommand[];
     skillsSettings?: SkillsSettings;
@@ -222,6 +224,8 @@ export interface AgentSessionConfig {
     builtInToolNames?: Iterable<string>;
     /** Update tool-session predicates that render guidance from the live active tool set. */
     setActiveToolNames?: (names: Iterable<string>) => void;
+    /** Register the write transport lazily when runtime xdev mounts first need it. */
+    ensureWriteRegistered?: () => Promise<boolean>;
     /** Current session pre-LLM message transform pipeline */
     transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => AgentMessage[] | Promise<AgentMessage[]>;
     /**
@@ -273,7 +277,8 @@ export interface AgentSessionConfig {
     xdevRegistry?: XdevRegistry;
     /** Discoverable tools mounted under `xd://` in the initial enabled set (startup partition in `sdk.ts`). */
     initialMountedXdevToolNames?: string[];
-    requestedToolNames?: ReadonlySet<string>;
+    /** Explicit/effective names pinned top-level during runtime repartitioning. */
+    presentationPinnedToolNames?: ReadonlySet<string>;
     /**
      * Optional accessor for live MCP server instructions. Read by the session's
      * `rebuildSystemPrompt`-skip optimization to detect server-side instruction
@@ -489,15 +494,20 @@ export interface AdvisorStats {
     /** Per-advisor breakdown; one entry per active advisor (single-advisor sessions have one). */
     advisors: PerAdvisorStat[];
 }
-/** One advisor's slice of {@link AdvisorStats}, surfaced for the multi-advisor status panel. */
+/** One advisor's slice of {@link AdvisorStats}. Active advisors carry full
+ *  token/cost data; disabled/no-model/quota-exhausted advisors appear with
+ *  just `name` + `status` so the status line can render a dot for every
+ *  configured advisor. */
 export interface PerAdvisorStat {
     name: string;
-    model: Model;
+    status: AdvisorRuntimeStatus;
+    model?: Model;
     contextWindow: number;
     contextTokens: number;
     tokens: AdvisorStats["tokens"];
     cost: number;
     messages: AdvisorStats["messages"];
+    sessionId?: string;
 }
 export interface FreshSessionResult {
     previousSessionId: string;
@@ -610,6 +620,8 @@ export declare class AgentSession {
      */
     subscribe(listener: AgentSessionEventListener): () => void;
     subscribeCommandMetadataChanged(listener: CommandMetadataChangedListener): () => void;
+    /** Run one abortable auto-learn capture outside the primary agent loop. */
+    runAutolearnCapture(capture: (signal: AbortSignal) => Promise<void>): Promise<void>;
     /** True once dispose() has begun; deferred background work (e.g. the deferred
      *  MCP discovery task in sdk.ts) must not touch the session past this point. */
     get isDisposed(): boolean;
@@ -689,6 +701,12 @@ export declare class AgentSession {
     /** Removes tools installed by {@link activateVibeTools} and activates `nextToolNames`. */
     deactivateVibeTools(nextToolNames: string[]): Promise<void>;
     getSelectedMCPToolNames(): string[];
+    /**
+     * Rediscover disk-backed skills and rebuild prompt-facing state without
+     * recreating the session. Explicit skill snapshots (`--no-skills`,
+     * SDK-provided `skills`) remain fixed for the lifetime of the session.
+     */
+    refreshSkills(): Promise<void>;
     /**
      * Set active tools by name.
      * Only tools in the registry can be enabled. Unknown tool names are ignored.
@@ -907,6 +925,12 @@ export declare class AgentSession {
     get skillWarnings(): readonly SkillWarning[];
     getTodoPhases(): TodoPhase[];
     setTodoPhases(phases: TodoPhase[]): void;
+    /**
+     * Generate an automatic session title tied to this session's lifecycle.
+     * Input and replan callers share the signal so disposal cancels provider and
+     * local-worker requests instead of leaving background inference alive.
+     */
+    generateTitle(firstMessage: string): Promise<string | null>;
     /** Currently-applied {@link TITLE_SYSTEM.md} override, or undefined when the
      *  bundled prompt is in effect. Consumed by {@link InteractiveMode} so the
      *  first-input title path and the replan refresh share one source. */
@@ -1159,8 +1183,7 @@ export declare class AgentSession {
      */
     retry(): Promise<boolean>;
     /**
-     * Execute a bash command.
-     * Adds result to agent context and session.
+     * Execute a bash command and retain the session/branch that owned its start.
      * @param command The bash command to execute
      * @param onChunk Optional streaming callback for output
      * @param options.excludeFromContext If true, command output won't be sent to LLM (!! prefix)
@@ -1170,10 +1193,7 @@ export declare class AgentSession {
         excludeFromContext?: boolean;
         useUserShell?: boolean;
     }): Promise<BashResult>;
-    /**
-     * Record a bash execution result in session history.
-     * Used by executeBash and by extensions that handle bash execution themselves.
-     */
+    /** Record a bash result supplied outside executeBash in the current ownership scope. */
     recordBashResult(command: string, result: BashResult, options?: {
         excludeFromContext?: boolean;
     }): void;
@@ -1463,6 +1483,18 @@ export declare class AgentSession {
      * (`streamFn`, `promptCacheKey`, `providerSessionState`, ...).
      */
     getAdvisorAgent(): Agent | undefined;
+    /**
+     * Lightweight advisor status for the status line: returns just the configured
+     * flag and per-advisor name/status without computing token/cost breakdowns.
+     * Avoids re-tokenizing the advisor transcript on every render frame.
+     */
+    getAdvisorStatusOverview(): {
+        configured: boolean;
+        advisors: {
+            name: string;
+            status: AdvisorRuntimeStatus;
+        }[];
+    };
     /**
      * Return structured advisor stats for the status command and TUI panel.
      */

package/dist/types/session/session-history-format.d.ts

@@ -1,3 +1,4 @@
+import type { ToolResultMessage } from "@oh-my-pi/pi-ai";
 export interface HistoryFormatOptions {
     /** Optional H1 prepended to the transcript. */
     title?: string;
@@ -24,6 +25,15 @@ export interface HistoryFormatOptions {
      * this so it sees what changed without re-reading the file.
      */
     expandEditDiffs?: boolean;
+    /**
+     * Chunked rendering support: a caller formatting one logical transcript in
+     * several calls (the advisor's chunked delta render) passes a result index
+     * built over the WHOLE delta plus one shared consumed-id set, so a toolCall
+     * finds its toolResult across chunk boundaries and the result is never
+     * re-rendered as an orphan in a later chunk.
+     */
+    toolResultIndex?: ReadonlyMap<string, ToolResultMessage>;
+    consumedToolCallIds?: Set<string>;
 }
 /**
  * Hidden custom messages that inject the primary agent's operative *constraints*

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

@@ -48,6 +48,15 @@ export declare class SessionManager {
     /** Synchronous variant of {@link putBlob} for rebuild-only render paths. */
     putBlobSync(data: Buffer, options?: BlobPutOptions): BlobPutResult;
     captureState(): SessionManagerStateSnapshot;
+    /**
+     * Create an independent manager for the current logical session and branch.
+     * The clone shares the storage backend but owns its entry index and writer, so
+     * callers can finish session-owned work after this manager switches elsewhere.
+     * Set `persist` false when the original session is intentionally being dropped.
+     */
+    cloneCurrentSession(options?: {
+        persist?: boolean;
+    }): SessionManager;
     restoreState(snapshot: SessionManagerStateSnapshot): void;
     /** Switch to a different session file (resume / branch). */
     setSessionFile(sessionFile: string): Promise<void>;
@@ -140,6 +149,11 @@ export declare class SessionManager {
      * top-level entries via appendCompaction()/branchWithSummary().
      */
     appendMessage(message: Message | CustomMessage | HookMessage | BashExecutionMessage | PythonExecutionMessage | FileMentionMessage): string;
+    /**
+     * Append to a non-active branch without changing the current leaf.
+     * Used by work that retains ownership of a branch across tree navigation.
+     */
+    appendMessageToBranch(message: Message | CustomMessage | HookMessage | BashExecutionMessage | PythonExecutionMessage | FileMentionMessage, parentId: string | null): string;
     /** Append a thinking level change as child of current leaf, then advance leaf. Returns entry id. */
     appendThinkingLevelChange(thinkingLevel?: string, configured?: string): string;
     appendServiceTierChange(serviceTier: ServiceTierByFamily | null): string;

package/dist/types/session/streaming-output.d.ts

@@ -26,6 +26,8 @@ export interface OutputSummary {
     columnDroppedBytes?: number;
     /** Number of distinct lines that hit the per-line column cap. */
     columnTruncatedLines?: number;
+    /** Configured per-line column cap in effect (chars), when > 0. */
+    columnMax?: number;
     /** Artifact ID for internal URL access (artifact://<id>) when truncated */
     artifactId?: string;
 }

package/dist/types/slash-commands/helpers/active-oauth-account.d.ts

@@ -1,5 +1,14 @@
 import type { UsageLimit, UsageReport } from "@oh-my-pi/pi-ai";
 import type { OAuthAccountIdentity } from "../../session/auth-storage.js";
+/**
+ * Session marker label for an active OAuth identity: the base identifier
+ * (email → accountId → projectId) suffixed with the organization when present
+ * and distinct. Same-email Anthropic multi-org accounts share the base, so the
+ * org suffix is the only field that tells the session's quota pool apart —
+ * mirrors the account-list rows (`formatUsageReportAccount`) and login success.
+ * Returns `undefined` when no identifier is recoverable.
+ */
+export declare function formatActiveAccountLabel(identity: OAuthAccountIdentity | undefined): string | undefined;
 /**
  * True when a single usage-limit column belongs to the given OAuth identity.
  *

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

@@ -63,10 +63,10 @@ export interface SlashCommandRuntime {
     /** Re-advertise the available command list (no-op outside ACP). */
     refreshCommands: () => Promise<void> | void;
     /**
-     * Reload plugin state (caches, slash command registry, project registries)
-     * and re-emit available commands. Used by `/reload-plugins`, `/move`, and
-     * `/marketplace`/`/plugins` mutations so the session sees a consistent view
-     * after plugin or project-scope changes.
+     * Reload plugin state (caches, skills, slash command registry, project
+     * registries) and re-emit available commands. Used by `/reload-plugins`,
+     * `/move`, and `/marketplace`/`/plugins` mutations so the session sees a
+     * consistent view after plugin or project-scope changes.
      */
     reloadPlugins: () => Promise<void>;
     notifyTitleChanged?: () => Promise<void> | void;

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

@@ -79,7 +79,7 @@ export interface BuildSystemPromptOptions {
         depth?: number;
     }>;
     /** Skills provided directly to system prompt construction. */
-    skills?: Skill[];
+    skills?: readonly Skill[];
     /** Pre-loaded rulebook rules (descriptions, excluding TTSR and always-apply). */
     rules?: Array<{
         name: string;

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

@@ -1,4 +1,4 @@
 import type { ModelRegistry } from "../config/model-registry.js";
 import type { Settings } from "../config/settings.js";
 /** Compresses a delegated assignment into a one-sentence UI label via the tiny title model — fired by the executor spawn path because the task wire schema no longer carries a `description`; null on empty input or failure. */
-export declare function generateTaskLabel(assignment: string, registry: ModelRegistry, settings: Settings, sessionId?: string): Promise<string | null>;
+export declare function generateTaskLabel(assignment: string, registry: ModelRegistry, settings: Settings, sessionId?: string, signal?: AbortSignal): Promise<string | null>;

package/dist/types/telemetry-export.d.ts

@@ -1,19 +1,44 @@
 /**
- * Whether {@link initTelemetryExport} registered a real provider. The CLI uses
- * this to decide whether to switch on the agent loop's telemetry config — there
- * is no point emitting spans into a no-op tracer.
+ * OTLP telemetry export bootstrap.
+ *
+ * oh-my-pi's agent core (`@oh-my-pi/pi-agent-core`) emits OpenTelemetry GenAI
+ * spans through the global `@opentelemetry/api` tracer, and exposes run-level
+ * callbacks for metrics/log pipelines. This module registers the OTLP/proto
+ * trace, log, and metric SDK providers when the standard `OTEL_*` endpoint env
+ * vars are set so `omp` can be observed by any OTLP collector without vendor
+ * coupling.
+ *
+ * Only the `http/protobuf` transport is supported — an
+ * `OTEL_EXPORTER_OTLP*_PROTOCOL` of `grpc` or `http/json` declines rather than
+ * misrouting protobuf payloads. The exporter line is pinned to the 0.218/2.7
+ * family validated under Bun; the 1.x OTLP line deadlocks when its
+ * `req.on("close")` handler fires after a successful export.
+ */
+import type { AgentTelemetryConfig } from "@oh-my-pi/pi-agent-core";
+/**
+ * Whether {@link initTelemetryExport} registered any real OTLP signal provider.
+ * The CLI uses this to decide whether to switch on the agent loop's telemetry
+ * hooks; metrics and structured logs need those callbacks even when traces are
+ * disabled.
  */
 export declare function isTelemetryExportEnabled(): boolean;
 /**
- * Register the global TracerProvider + OTLP exporter when an OTLP endpoint is
- * configured via env. Idempotent, and a no-op when no endpoint is set (or when
- * the OTEL kill-switches are engaged), so it is safe to call unconditionally at
- * startup.
+ * Merge OTLP metrics/log hooks into an existing agent telemetry config.
+ *
+ * The caller still owns content-capture policy, cost estimation, and custom
+ * attributes. This only appends host-level metrics/log forwarding for the
+ * providers registered by {@link initTelemetryExport}.
+ */
+export declare function createTelemetryExportConfig(config: AgentTelemetryConfig | undefined): AgentTelemetryConfig | undefined;
+/**
+ * Register global trace/log/meter providers when OTLP endpoints are configured
+ * through env. Idempotent, and a no-op when no signal has an endpoint (or when
+ * the OTEL kill-switches are engaged), so startup can call it unconditionally.
  */
 export declare function initTelemetryExport(): Promise<void>;
 /**
- * Flush any buffered spans to the exporter. No-op when export is disabled.
+ * Flush buffered spans, log records, and metrics. No-op when export is disabled.
  * Hosts embedding the agent can call this at natural boundaries (e.g. the end
- * of a turn) so traces surface promptly rather than on the batch interval.
+ * of a turn) so telemetry surfaces promptly rather than on the batch interval.
  */
 export declare function flushTelemetryExport(): Promise<void>;

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

@@ -17,6 +17,14 @@ export interface ResolvedApproval {
     reason?: string;
     override: boolean;
 }
+/**
+ * Evaluate a tool's own approval declaration against `args` and return the
+ * resulting capability tier, defaulting to `exec` when the tool omits an
+ * approval. Unlike reading `tool.approval` directly, this runs function-valued
+ * approvals — the write tool's `xd://` gate uses it to take a mounted device's
+ * argument-dependent tier instead of falling back to `exec`.
+ */
+export declare function resolveToolTier(tool: ApprovalSubject, args: unknown): ToolTier;
 /**
  * Resolve approval policy for a tool call.
  *

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

@@ -76,6 +76,8 @@ export interface BashToolDetails {
     wallTimeMs?: number;
     /** Exit code of a command that ran to completion but failed (non-zero). */
     exitCode?: number;
+    /** True when the command was killed by its timeout deadline (not a failure). */
+    timedOut?: boolean;
     terminalId?: string;
     async?: {
         state: "running" | "completed" | "failed";

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

@@ -37,6 +37,12 @@ export interface CmuxBrowserHandle extends BrowserHandleCommon {
     surface?: string;
 }
 export type BrowserHandle = PuppeteerBrowserHandle | CmuxBrowserHandle;
+/** Controls bounded browser-handle teardown and identifies the owning resource in timeout diagnostics. */
+export interface ReleaseBrowserOptions {
+    kill: boolean;
+    timeoutMs?: number;
+    resource?: string;
+}
 export interface AcquireBrowserOptions {
     cwd: string;
     viewport?: {
@@ -50,9 +56,7 @@ export interface AcquireBrowserOptions {
 export declare function acquireBrowser(kind: BrowserKind, opts: AcquireBrowserOptions): Promise<BrowserHandle>;
 export declare function normalizeConnectedCdpUrl(rawCdpUrl: string): string;
 export declare function holdBrowser(handle: BrowserHandle): void;
-export declare function releaseBrowser(handle: BrowserHandle, opts: {
-    kill: boolean;
-}): Promise<void>;
+export declare function releaseBrowser(handle: BrowserHandle, opts: ReleaseBrowserOptions): Promise<void>;
 /** Test-only accessor for the module-global browsers map. */
 export declare function getBrowsersMapForTest(): ReadonlyMap<string, BrowserHandle>;
 export {};

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

@@ -87,6 +87,8 @@ export interface RunInTabOptions {
 }
 export interface ReleaseTabOptions {
     kill?: boolean;
+    /** Maximum time for each asynchronous cleanup resource before close fails with diagnostics. */
+    timeoutMs?: number;
 }
 export declare function getTab(name: string): TabSession | undefined;
 export declare function acquireTab(name: string, browser: BrowserHandle, opts: AcquireTabOptions): Promise<AcquireTabResult>;

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

@@ -0,0 +1,29 @@
+/**
+ * Canonical set of built-in tools that must stay top-level.
+ *
+ * These are the coding essentials the model always needs directly in its
+ * callable schema. `read`/`write` are additionally the `xd://` transport
+ * (`read xd://` lists devices, `write xd://<tool>` executes them), so demoting
+ * them under xdev makes every mounted device unreachable.
+ *
+ * Adapter boundaries (extension `registerTool`, SDK custom tools, RPC host
+ * tools) default an omitted `loadMode` to `"discoverable"`. A UI-only
+ * re-register of a built-in — e.g. wrapping `read`/`write`/`bash`/`edit`/`glob`
+ * to customize rendering — would then silently demote it to `discoverable` and,
+ * with `tools.xdev` on, unmount it from the top-level schema (issue #5764).
+ * {@link defaultLoadModeForToolName} pins these names to `"essential"` when the
+ * definition omits `loadMode`, so re-registering a built-in never demotes it.
+ */
+import type { ToolLoadMode } from "@oh-my-pi/pi-agent-core";
+/**
+ * Built-in tool names whose classes declare `loadMode = "essential"`. Kept in
+ * sync with the tool classes by `essential-tools.test.ts` (drift guard).
+ */
+export declare const ESSENTIAL_BUILTIN_TOOL_NAMES: Record<string, true>;
+/**
+ * Resolve a tool's presentation mode at an adapter boundary. An explicit
+ * `declared` mode always wins. When omitted, known essential built-in names
+ * default to `"essential"` (so a re-register never demotes them); everything
+ * else defaults to `"discoverable"`.
+ */
+export declare function defaultLoadModeForToolName(name: string, declared?: ToolLoadMode): ToolLoadMode;

package/dist/types/tools/image-gen.d.ts

@@ -2,7 +2,7 @@ import { type Model } from "@oh-my-pi/pi-ai";
 import { type ModelRegistry } from "../config/model-registry.js";
 import type { CustomTool } from "../extensibility/custom-tools/types.js";
 export type ImageProvider = "antigravity" | "gemini" | "openai" | "openai-codex" | "openrouter" | "xai";
-export type ImageProviderPreference = Exclude<ImageProvider, "openai-codex"> | "auto";
+export type ImageProviderPreference = ImageProvider | "auto";
 declare const responseModalitySchema: import("arktype/internal/variants/string.ts").StringType<"IMAGE" | "TEXT", {}>;
 export declare const imageGenSchema: import("arktype/internal/variants/object.ts").ObjectType<{
     subject: string;
@@ -20,6 +20,7 @@ export declare const imageGenSchema: import("arktype/internal/variants/object.ts
         data?: string | undefined;
         mime_type?: string | undefined;
     }[] | undefined;
+    provider?: "antigravity" | "auto" | "gemini" | "openai" | "openai-codex" | "openrouter" | "xai" | undefined;
 }, {}>;
 export type ImageGenParams = typeof imageGenSchema.infer;
 export type GeminiResponseModality = typeof responseModalitySchema.infer;

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

@@ -40,6 +40,7 @@ export * from "./bash.js";
 export * from "./browser.js";
 export * from "./checkpoint.js";
 export * from "./debug.js";
+export * from "./essential-tools.js";
 export * from "./eval.js";
 export * from "./eval-backends.js";
 export * from "./gh.js";
@@ -121,7 +122,9 @@ export interface ToolSession {
     /** Pre-loaded workspace tree (forwarded to subagents to skip re-scanning) */
     workspaceTree?: WorkspaceTree;
     /** Pre-loaded skills */
-    skills?: Skill[];
+    skills?: readonly Skill[];
+    /** Rediscover live session skills after a tool mutates their backing files. */
+    refreshSkills?: () => Promise<void>;
     /** Pre-loaded prompt templates */
     promptTemplates?: PromptTemplate[];
     /** Pre-loaded rules (forwarded to subagents to skip re-discovery). */

package/dist/types/tools/manage-skill.d.ts

@@ -12,6 +12,7 @@ export type ManageSkillParams = typeof manageSkillSchema.infer;
  * `autolearn.enabled`; backend-independent (the skill side is standalone).
  */
 export declare class ManageSkillTool implements AgentTool<typeof manageSkillSchema> {
+    private readonly refreshSkills?;
     readonly name = "manage_skill";
     readonly approval: "write";
     readonly label = "Manage Skill";
@@ -25,6 +26,7 @@ export declare class ManageSkillTool implements AgentTool<typeof manageSkillSche
     readonly strict = true;
     readonly loadMode: "essential";
     readonly summary = "Create, update, or delete an isolated managed skill";
+    constructor(refreshSkills?: (() => Promise<void>) | undefined);
     static createIf(session: ToolSession): ManageSkillTool | null;
     execute(_id: string, params: ManageSkillParams): Promise<AgentToolResult>;
 }

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

@@ -37,11 +37,20 @@ import type { ToolRenderer } from "./renderers.js";
  * behind dispatch.
  */
 export declare const XDEV_KEEP_TOP_LEVEL: Record<string, true>;
+/**
+ * Tools that carry the `xd://` transport itself and therefore can never be
+ * mounted as devices: `read xd://` lists/documents devices and
+ * `write xd://<tool>` executes them. Demoting either leaves every mounted
+ * device unreachable (issue #5764), so they stay top-level regardless of a
+ * declared `loadMode`.
+ */
+export declare const XDEV_TRANSPORT_TOOLS: Record<string, true>;
 /**
  * Whether an enabled tool is presented under `xd://` (rather than top-level)
  * while the `xd://` transport is active. Discoverable tools mount unless they
- * are pinned top-level by {@link XDEV_KEEP_TOP_LEVEL}; essential tools never do.
- * The caller gates this on the transport being active (a session-owned
+ * are pinned top-level by {@link XDEV_KEEP_TOP_LEVEL} or carry the transport
+ * itself ({@link XDEV_TRANSPORT_TOOLS}); essential tools never do. The caller
+ * gates this on the transport being active (a session-owned
  * {@link XdevRegistry} existing).
  */
 export declare function isMountableUnderXdev(tool: {

package/dist/types/utils/title-generator.d.ts

@@ -14,8 +14,9 @@ import type { Settings } from "../config/settings.js";
  *   resolver instead of a pre-evaluated value ensures the metadata's account_uuid
  *   reflects the credential actually selected for this request.
  * @param customSystemPrompt Optional title-specific system prompt override
+ * @param signal Session-lifecycle cancellation for background title requests
  */
-export declare function generateSessionTitle(firstMessage: string, registry: ModelRegistry, settings: Settings, sessionId?: string, currentModel?: Model<Api>, metadataResolver?: (provider: string) => Record<string, unknown> | undefined, customSystemPrompt?: string): Promise<string | null>;
+export declare function generateSessionTitle(firstMessage: string, registry: ModelRegistry, settings: Settings, sessionId?: string, currentModel?: Model<Api>, metadataResolver?: (provider: string) => Record<string, unknown> | undefined, customSystemPrompt?: string, signal?: AbortSignal): Promise<string | null>;
 export declare function generateTitleOnline(firstMessage: string, registry: ModelRegistry, settings: Settings, sessionId?: string, currentModel?: Model<Api>, metadataResolver?: (provider: string) => Record<string, unknown> | undefined, signal?: AbortSignal, customSystemPrompt?: string): Promise<string | null>;
 export declare function formatSessionTerminalTitle(sessionName: string | undefined, cwd?: string): string;
 /**

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

@@ -6,6 +6,7 @@
  */
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
 import type { AuthStorage } from "@oh-my-pi/pi-ai";
+import { ModelRegistry } from "../../config/model-registry.js";
 import type { CustomTool } from "../../extensibility/custom-tools/types.js";
 import type { ToolSession } from "../../tools/index.js";
 import { type SearchRenderDetails } from "./render.js";
@@ -32,6 +33,7 @@ export interface SearchQueryParams extends SearchToolParams {
  */
 export declare function runSearchQuery(params: SearchQueryParams, options?: {
     authStorage?: AuthStorage;
+    modelRegistry?: ModelRegistry;
     sessionId?: string;
     signal?: AbortSignal;
 }): Promise<{

package/dist/types/web/search/providers/base.d.ts

@@ -1,4 +1,5 @@
 import type { AuthStorage, FetchImpl } from "@oh-my-pi/pi-ai";
+import type { ModelRegistry } from "../../../config/model-registry.js";
 import type { SearchProviderId, SearchResponse } from "../types.js";
 /**
  * Shared web search parameters passed to providers.
@@ -44,6 +45,8 @@ export interface SearchParams {
      * the per-credential single-flight refresh.
      */
     authStorage: AuthStorage;
+    /** Provider/model transport settings used by native search endpoints. */
+    modelRegistry?: ModelRegistry;
     /**
      * Optional session id used as the round-robin / sticky key when selecting
      * among multiple credentials for the same provider. Pass through from the

package/dist/types/web/search/providers/kimi.d.ts

@@ -1,7 +1,10 @@
 /**
  * Kimi Web Search Provider
  *
- * Uses Moonshot Kimi Code search API to retrieve web results.
+ * Uses the Kimi Code search API to retrieve web results. This is the Kimi Code
+ * membership service, distinct from the Moonshot Open Platform — it requires a
+ * Kimi Code Console credential (`omp /login kimi-code` or an explicit
+ * `MOONSHOT_SEARCH_API_KEY` / `KIMI_SEARCH_API_KEY`), not `MOONSHOT_API_KEY`.
  * Endpoint: POST https://api.kimi.com/coding/v1/search
  */
 import { type AuthStorage, type FetchImpl } from "@oh-my-pi/pi-ai";

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

@@ -62,7 +62,7 @@ export declare const SEARCH_PROVIDER_OPTIONS: readonly [{
 }, {
     readonly value: "kimi";
     readonly label: "Kimi";
-    readonly description: "Requires MOONSHOT_SEARCH_API_KEY or MOONSHOT_API_KEY";
+    readonly description: "Kimi Code search (requires a Kimi Code Console key via KIMI_SEARCH_API_KEY/MOONSHOT_SEARCH_API_KEY or /login kimi-code; not MOONSHOT_API_KEY)";
 }, {
     readonly value: "parallel";
     readonly label: "Parallel";

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "17.0.0",
+	"version": "17.0.2",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -52,23 +52,28 @@
 		"@agentclientprotocol/sdk": "1.2.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "17.0.0",
-		"@oh-my-pi/omp-stats": "17.0.0",
-		"@oh-my-pi/pi-agent-core": "17.0.0",
-		"@oh-my-pi/pi-ai": "17.0.0",
-		"@oh-my-pi/pi-catalog": "17.0.0",
-		"@oh-my-pi/pi-mnemopi": "17.0.0",
-		"@oh-my-pi/pi-natives": "17.0.0",
-		"@oh-my-pi/pi-tui": "17.0.0",
-		"@oh-my-pi/pi-utils": "17.0.0",
-		"@oh-my-pi/pi-wire": "17.0.0",
-		"@oh-my-pi/snapcompact": "17.0.0",
+		"@oh-my-pi/hashline": "17.0.2",
+		"@oh-my-pi/omp-stats": "17.0.2",
+		"@oh-my-pi/pi-agent-core": "17.0.2",
+		"@oh-my-pi/pi-ai": "17.0.2",
+		"@oh-my-pi/pi-catalog": "17.0.2",
+		"@oh-my-pi/pi-mnemopi": "17.0.2",
+		"@oh-my-pi/pi-natives": "17.0.2",
+		"@oh-my-pi/pi-tui": "17.0.2",
+		"@oh-my-pi/pi-utils": "17.0.2",
+		"@oh-my-pi/pi-wire": "17.0.2",
+		"@oh-my-pi/snapcompact": "17.0.2",
 		"@opentelemetry/api": "^1.9.1",
-		"@opentelemetry/context-async-hooks": "^2.7.1",
+		"@opentelemetry/api-logs": "^0.220.0",
+		"@opentelemetry/context-async-hooks": "^2.9.0",
+		"@opentelemetry/exporter-logs-otlp-proto": "^0.220.0",
+		"@opentelemetry/exporter-metrics-otlp-proto": "^0.220.0",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.220.0",
-		"@opentelemetry/resources": "^2.7.1",
-		"@opentelemetry/sdk-trace-base": "^2.7.1",
-		"@opentelemetry/sdk-trace-node": "^2.7.1",
+		"@opentelemetry/resources": "^2.9.0",
+		"@opentelemetry/sdk-logs": "^0.220.0",
+		"@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",