@selesai/code 0.13.40 → 0.14.0

package/dist/core/extensions/types.js

@@ -21,6 +21,9 @@ export function defineTool(tool) {
 export function isBashToolResult(e) {
     return e.toolName === "bash";
 }
+export function isPowerShellToolResult(e) {
+    return e.toolName === "powershell";
+}
 export function isReadToolResult(e) {
     return e.toolName === "read";
 }

package/dist/core/extensions/virtual-modules.js

@@ -1,5 +1,7 @@
 import * as bundledPiAgentCore from "@earendil-works/pi-agent-core";
 import * as bundledPiAiCompat from "@earendil-works/pi-ai/compat";
+import * as bundledPiAiTranscript from "@earendil-works/pi-ai/utils/transcript";
+import * as bundledPiAiClassifier from "@earendil-works/pi-ai/api/typesafe-system-one";
 import * as bundledPiAiOauth from "@earendil-works/pi-ai/oauth";
 import * as bundledPiAiProviders from "@earendil-works/pi-ai/providers/all";
 import * as bundledPiTui from "@earendil-works/pi-tui";
@@ -24,6 +26,8 @@ export const VIRTUAL_MODULES = {
     // global API keep working at runtime until compat is removed.
     "@earendil-works/pi-ai": bundledPiAiCompat,
     "@earendil-works/pi-ai/compat": bundledPiAiCompat,
+    "@earendil-works/pi-ai/utils/transcript": bundledPiAiTranscript,
+    "@earendil-works/pi-ai/api/typesafe-system-one": bundledPiAiClassifier,
     "@earendil-works/pi-ai/oauth": bundledPiAiOauth,
     "@earendil-works/pi-ai/providers/all": bundledPiAiProviders,
     "@earendil-works/pi-coding-agent": bundledPiCodingAgent,
@@ -33,6 +37,8 @@ export const VIRTUAL_MODULES = {
     "@mariozechner/pi-tui": bundledPiTui,
     "@mariozechner/pi-ai": bundledPiAiCompat,
     "@mariozechner/pi-ai/compat": bundledPiAiCompat,
+    "@mariozechner/pi-ai/utils/transcript": bundledPiAiTranscript,
+    "@mariozechner/pi-ai/api/typesafe-system-one": bundledPiAiClassifier,
     "@mariozechner/pi-ai/oauth": bundledPiAiOauth,
     "@mariozechner/pi-ai/providers/all": bundledPiAiProviders,
     "@mariozechner/pi-coding-agent": bundledPiCodingAgent,

package/dist/core/extensions/wrapper.d.ts

@@ -9,11 +9,11 @@ import type { ExtensionRunner } from "./runner.ts";
 import type { RegisteredTool } from "./types.ts";
 /**
  * Wrap a RegisteredTool into an AgentTool.
- * Uses the runner's createContext() for consistent context across tools and event handlers.
+ * Uses the runner's createToolContext() for consistent context across tools and event handlers.
  */
 export declare function wrapRegisteredTool(registeredTool: RegisteredTool, runner: ExtensionRunner): AgentTool;
 /**
  * Wrap all registered tools into AgentTools.
- * Uses the runner's createContext() for consistent context across tools and event handlers.
+ * Uses the runner's createToolContext() for consistent context across tools and event handlers.
  */
 export declare function wrapRegisteredTools(registeredTools: RegisteredTool[], runner: ExtensionRunner): AgentTool[];

package/dist/core/extensions/wrapper.js

@@ -7,14 +7,14 @@
 import { wrapToolDefinition } from "../tools/tool-definition-wrapper.js";
 /**
  * Wrap a RegisteredTool into an AgentTool.
- * Uses the runner's createContext() for consistent context across tools and event handlers.
+ * Uses the runner's createToolContext() for consistent context across tools and event handlers.
  */
 export function wrapRegisteredTool(registeredTool, runner) {
-    return wrapToolDefinition(registeredTool.definition, () => runner.createContext());
+    return wrapToolDefinition(registeredTool.definition, (toolCallId, signal) => runner.createToolContext(toolCallId, signal));
 }
 /**
  * Wrap all registered tools into AgentTools.
- * Uses the runner's createContext() for consistent context across tools and event handlers.
+ * Uses the runner's createToolContext() for consistent context across tools and event handlers.
  */
 export function wrapRegisteredTools(registeredTools, runner) {
     return registeredTools.map((tool) => wrapRegisteredTool(tool, runner));

package/dist/core/footer-data-provider.d.ts

@@ -10,7 +10,7 @@ export type GitPaths = {
 export declare function findGitPaths(cwd: string): GitPaths | null;
 /**
  * Provides git branch and extension statuses - data not otherwise accessible to extensions.
- * Token stats, model info available via ctx.sessionManager and ctx.model.
+ * Context usage on ctx.getContextUsage(), token stats on ctx.sessionManager.getEntries(), model info on ctx.model.
  */
 export declare class FooterDataProvider {
     private cwd;

package/dist/core/footer-data-provider.js

@@ -81,7 +81,7 @@ function shouldPollGitHead(repoDir) {
 }
 /**
  * Provides git branch and extension statuses - data not otherwise accessible to extensions.
- * Token stats, model info available via ctx.sessionManager and ctx.model.
+ * Context usage on ctx.getContextUsage(), token stats on ctx.sessionManager.getEntries(), model info on ctx.model.
  */
 export class FooterDataProvider {
     cwd;

package/dist/core/handoff.d.ts

@@ -3,7 +3,6 @@ import type { AssistantMessage, Context } from "@earendil-works/pi-ai";
 import type { Model } from "@earendil-works/pi-ai";
 import type { SessionEntry } from "./session-manager.ts";
 export declare const DEFAULT_HANDOFF_GOAL = "Continue the previous session from this handoff.";
-export declare const AUTO_HANDOFF_GOAL = "Continue the previous session without losing its direction. Preserve the big picture: the overall objective, why the work matters, the intended outcome and success criteria, the current approach and key decisions, relevant constraints, exact reference files or artifacts, completed and remaining work, known failures or test results, and the next concrete action. Make clear how the immediate next step contributes to the overall goal.";
 export declare function entryToMessage(entry: SessionEntry): AgentMessage | undefined;
 export declare function getHandoffMessages(branch: SessionEntry[]): AgentMessage[];
 export declare function buildAiContext(conversationText: string, goal: string): Context;

package/dist/core/handoff.js

@@ -1,7 +1,6 @@
 import { serializeConversation } from "./compaction/utils.js";
 import { convertToLlm } from "./messages.js";
 export const DEFAULT_HANDOFF_GOAL = "Continue the previous session from this handoff.";
-export const AUTO_HANDOFF_GOAL = `Continue the previous session without losing its direction. Preserve the big picture: the overall objective, why the work matters, the intended outcome and success criteria, the current approach and key decisions, relevant constraints, exact reference files or artifacts, completed and remaining work, known failures or test results, and the next concrete action. Make clear how the immediate next step contributes to the overall goal.`;
 const SYSTEM_PROMPT = `Write a handoff document for a fresh agent to continue the current conversation. Return only the handoff document text; do not save a file or describe saving one. No question, no fluff, just write the handoff. Do not reproduce, quote, or reformat the conversation history or its tool calls — distill it into what matters; never emit transcript-style markup or raw tool-call text.
 
 Include a "suggested skills" section in the document, which suggests skills that the agent should invoke.

package/dist/core/http-dispatcher.js

@@ -1,6 +1,8 @@
 import { EventEmitter } from "node:events";
 import * as undici from "undici";
 export const DEFAULT_HTTP_IDLE_TIMEOUT_MS = 300_000;
+// Node's 250ms default can terminate valid connection attempts on high-latency routes.
+const DEFAULT_AUTO_SELECT_FAMILY_ATTEMPT_TIMEOUT_MS = 2_000;
 export const HTTP_IDLE_TIMEOUT_CHOICES = [
     { label: "30 sec", timeoutMs: 30_000 },
     { label: "1 min", timeoutMs: 60_000 },
@@ -73,6 +75,9 @@ export function configureHttpDispatcher(timeoutMs = DEFAULT_HTTP_IDLE_TIMEOUT_MS
         // Keep HTTP origins on CONNECT tunnels as they were before Undici 8.7.
         proxyTunnel: true,
         bodyTimeout: normalizedTimeoutMs,
+        connect: {
+            autoSelectFamilyAttemptTimeout: DEFAULT_AUTO_SELECT_FAMILY_ATTEMPT_TIMEOUT_MS,
+        },
         headersTimeout: normalizedTimeoutMs,
         clientFactory: createUndiciClient,
         factory: createUndiciOriginDispatcher,

package/dist/core/index.d.ts

@@ -9,5 +9,5 @@ export type { CacheWarmingDecision, CacheWarmingStatus } from "./cache-warmer.ts
 export type { CompactionResult } from "./compaction/index.ts";
 export { createEventBus, type EventBus, type EventBusController } from "./event-bus.ts";
 export { areExperimentalFeaturesEnabled } from "./experimental.ts";
-export { type AgentEndEvent, type AgentSettledEvent, type AgentStartEvent, type AgentToolResult, type AgentToolUpdateCallback, type BeforeAgentStartEvent, type BeforeAgentStartEventResult, type BuildSystemPromptOptions, type CacheWarmingDecisionEvent, type CacheWarmingDecisionEventResult, type ContextEvent, defineTool, discoverAndLoadExtensions, type ExecOptions, type ExecResult, type Extension, type ExtensionAPI, type ExtensionCommandContext, type ExtensionContext, type ExtensionError, type ExtensionEvent, type ExtensionFactory, type ExtensionFlag, type ExtensionHandler, ExtensionRunner, type ExtensionShortcut, type ExtensionUIContext, type InlineExtension, type LoadExtensionsResult, type MessageRenderer, type NormalizedBuildSystemPromptOptions, type RegisteredCommand, type SessionBeforeCompactEvent, type SessionBeforeForkEvent, type SessionBeforeSwitchEvent, type SessionBeforeTreeEvent, type SessionCompactEvent, type SessionShutdownEvent, type SessionStartEvent, type SessionTreeEvent, type ToolCallEvent, type ToolCallEventResult, type ToolDefinition, type ToolRenderResultOptions, type ToolResultEvent, type TurnEndEvent, type TurnStartEvent, type WorkingIndicatorOptions, } from "./extensions/index.ts";
+export { type AgentActivityOutcome, type AgentBeforeSettleEvent, type AgentBeforeSettleEventResult, type AgentEndEvent, type AgentSettledEvent, type AgentStartEvent, type AgentToolResult, type AgentToolUpdateCallback, type BeforeAgentStartEvent, type BeforeAgentStartEventResult, type BoundaryContextPreview, type BoundaryResult, type BoundaryState, type BuildSystemPromptOptions, type CacheWarmingDecisionEvent, type CacheWarmingDecisionEventResult, type CompactionEntryDraft, type ContextEditEntryDraft, type ContextEvent, type ContextWithSystemEvent, type CustomEntryDraft, type CustomMessageEntryDraft, defineTool, discoverAndLoadExtensions, type ExecOptions, type ExecResult, type Extension, type ExtensionAPI, type ExtensionCommandContext, type ExtensionContext, type ExtensionError, type ExtensionEvent, type ExtensionFactory, type ExtensionFlag, type ExtensionHandler, ExtensionRunner, type ExtensionShortcut, type ExtensionUIContext, type InlineExtension, type LoadExtensionsResult, type MessageRenderer, type NormalizedBuildSystemPromptOptions, type RegisteredCommand, type SessionBeforeCompactEvent, type SessionBeforeForkEvent, type SessionBeforeSwitchEvent, type SessionBeforeTreeEvent, type SessionBoundaryDraft, type SessionCompactEvent, type SessionShutdownEvent, type SessionStartEvent, type SessionTreeEvent, type ToolCallEvent, type ToolCallEventResult, type ToolDefinition, type ToolRenderResultOptions, type ToolResultEvent, type TurnEndEvent, type TurnEndEventResult, type TurnStartEvent, type WorkingIndicatorOptions, } from "./extensions/index.ts";
 export { createSyntheticSourceInfo } from "./source-info.ts";

package/dist/core/keybindings.d.ts

@@ -45,6 +45,7 @@ export interface AppKeybindings {
     "app.tree.filter.cycleBackward": true;
 }
 export type AppKeybinding = keyof AppKeybindings;
+export declare function useWindowsKeybindings(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): boolean;
 declare module "@earendil-works/pi-tui" {
     interface Keybindings extends AppKeybindings {
     }
@@ -83,11 +84,11 @@ export declare const KEYBINDINGS: {
         readonly description: "Move cursor word right";
     };
     readonly "tui.editor.cursorLineStart": {
-        readonly defaultKeys: ["home", "ctrl+home", "ctrl+a"];
+        readonly defaultKeys: ["home", "ctrl+a"];
         readonly description: "Move to line start";
     };
     readonly "tui.editor.cursorLineEnd": {
-        readonly defaultKeys: ["end", "ctrl+end", "ctrl+e"];
+        readonly defaultKeys: ["end", "ctrl+e"];
         readonly description: "Move to line end";
     };
     readonly "tui.editor.jumpForward": {
@@ -138,10 +139,6 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "alt+y";
         readonly description: "Yank pop";
     };
-    readonly "tui.editor.undo": {
-        readonly defaultKeys: "ctrl+-";
-        readonly description: "Undo";
-    };
     readonly "tui.input.newLine": {
         readonly defaultKeys: ["shift+enter", "ctrl+j"];
         readonly description: "Insert newline";
@@ -206,18 +203,6 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: [];
         readonly description: "Scroll viewport down one line";
     };
-    readonly "tui.altScreen.previousPrompt": {
-        readonly defaultKeys: ["ctrl+shift+up", "ctrl+up"];
-        readonly description: "Jump to previous semantic prompt";
-    };
-    readonly "tui.altScreen.nextPrompt": {
-        readonly defaultKeys: ["ctrl+shift+down", "ctrl+down"];
-        readonly description: "Jump to next semantic prompt";
-    };
-    readonly "tui.altScreen.search": {
-        readonly defaultKeys: "ctrl+shift+f";
-        readonly description: "Search the primary scroll view";
-    };
     readonly "tui.altScreen.searchNext": {
         readonly defaultKeys: ["enter", "ctrl+g"];
         readonly description: "Select the next search match";
@@ -231,13 +216,29 @@ export declare const KEYBINDINGS: {
         readonly description: "Close transcript search";
     };
     readonly "tui.altScreen.top": {
-        readonly defaultKeys: "home";
+        readonly defaultKeys: "ctrl+home";
         readonly description: "Scroll viewport to top";
     };
     readonly "tui.altScreen.bottom": {
-        readonly defaultKeys: "end";
+        readonly defaultKeys: "ctrl+end";
         readonly description: "Scroll viewport to bottom";
     };
+    readonly "tui.editor.undo": {
+        readonly description: "Undo";
+        readonly defaultKeys: "alt+z" | "ctrl+-" | "ctrl+z";
+    };
+    readonly "tui.altScreen.previousPrompt": {
+        readonly description: "Jump to previous semantic prompt";
+        readonly defaultKeys: "ctrl+up" | ("ctrl+shift+up" | "ctrl+up")[];
+    };
+    readonly "tui.altScreen.nextPrompt": {
+        readonly description: "Jump to next semantic prompt";
+        readonly defaultKeys: "ctrl+down" | ("ctrl+down" | "ctrl+shift+down")[];
+    };
+    readonly "tui.altScreen.search": {
+        readonly description: "Search the primary scroll view";
+        readonly defaultKeys: "ctrl+f" | "ctrl+shift+f";
+    };
     readonly "app.interrupt": {
         readonly defaultKeys: "escape";
         readonly description: "Cancel or abort";
@@ -267,7 +268,7 @@ export declare const KEYBINDINGS: {
         readonly description: "Cycle to next model";
     };
     readonly "app.model.cycleBackward": {
-        readonly defaultKeys: "shift+ctrl+p";
+        readonly defaultKeys: "alt+p" | "shift+ctrl+p";
         readonly description: "Cycle to previous model";
     };
     readonly "app.model.select": {
@@ -295,16 +296,16 @@ export declare const KEYBINDINGS: {
         readonly description: "Copy selection or last assistant message";
     };
     readonly "app.message.followUp": {
-        readonly defaultKeys: "alt+enter";
+        readonly defaultKeys: "alt+enter" | "ctrl+q";
         readonly description: "Queue follow-up message";
     };
     readonly "app.message.dequeue": {
-        readonly defaultKeys: "alt+up";
+        readonly defaultKeys: "alt+q" | "alt+up";
         readonly description: "Restore queued messages";
     };
     readonly "app.clipboard.pasteImage": {
         readonly defaultKeys: "alt+v" | "ctrl+v";
-        readonly description: "Paste image from clipboard (text fallback)";
+        readonly description: "Paste files on macOS, images, or text from clipboard";
     };
     readonly "app.session.new": {
         readonly defaultKeys: [];

package/dist/core/keybindings.js

@@ -2,8 +2,29 @@ import { TUI_KEYBINDINGS, KeybindingsManager as TuiKeybindingsManager, } from "@
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { getAgentDir } from "../config.js";
+import { stripBom } from "../utils/text.js";
+export function useWindowsKeybindings(platform = process.platform, env = process.env) {
+    return platform === "win32" || (platform === "linux" && Boolean(env.WSL_DISTRO_NAME || env.WSL_INTEROP));
+}
+const windowsKeybindings = useWindowsKeybindings();
 export const KEYBINDINGS = {
     ...TUI_KEYBINDINGS,
+    "tui.editor.undo": {
+        ...TUI_KEYBINDINGS["tui.editor.undo"],
+        defaultKeys: process.platform === "win32" ? "ctrl+z" : windowsKeybindings ? "alt+z" : "ctrl+-",
+    },
+    "tui.altScreen.previousPrompt": {
+        ...TUI_KEYBINDINGS["tui.altScreen.previousPrompt"],
+        defaultKeys: windowsKeybindings ? "ctrl+up" : ["ctrl+shift+up", "ctrl+up"],
+    },
+    "tui.altScreen.nextPrompt": {
+        ...TUI_KEYBINDINGS["tui.altScreen.nextPrompt"],
+        defaultKeys: windowsKeybindings ? "ctrl+down" : ["ctrl+shift+down", "ctrl+down"],
+    },
+    "tui.altScreen.search": {
+        ...TUI_KEYBINDINGS["tui.altScreen.search"],
+        defaultKeys: windowsKeybindings ? "ctrl+f" : "ctrl+shift+f",
+    },
     "app.interrupt": { defaultKeys: "escape", description: "Cancel or abort" },
     "app.clear": { defaultKeys: "ctrl+c", description: "Clear editor" },
     "app.exit": { defaultKeys: "ctrl+d", description: "Exit when editor is empty" },
@@ -24,7 +45,7 @@ export const KEYBINDINGS = {
         description: "Cycle to next model",
     },
     "app.model.cycleBackward": {
-        defaultKeys: "shift+ctrl+p",
+        defaultKeys: windowsKeybindings ? "alt+p" : "shift+ctrl+p",
         description: "Cycle to previous model",
     },
     "app.model.select": { defaultKeys: "ctrl+l", description: "Open model selector" },
@@ -46,16 +67,16 @@ export const KEYBINDINGS = {
         description: "Copy selection or last assistant message",
     },
     "app.message.followUp": {
-        defaultKeys: "alt+enter",
+        defaultKeys: windowsKeybindings ? "ctrl+q" : "alt+enter",
         description: "Queue follow-up message",
     },
     "app.message.dequeue": {
-        defaultKeys: "alt+up",
+        defaultKeys: windowsKeybindings ? "alt+q" : "alt+up",
         description: "Restore queued messages",
     },
     "app.clipboard.pasteImage": {
-        defaultKeys: process.platform === "win32" ? "alt+v" : "ctrl+v",
-        description: "Paste image from clipboard (text fallback)",
+        defaultKeys: windowsKeybindings ? "alt+v" : "ctrl+v",
+        description: "Paste files on macOS, images, or text from clipboard",
     },
     "app.session.new": { defaultKeys: [], description: "Start a new session" },
     "app.session.tree": { defaultKeys: [], description: "Open session tree" },
@@ -262,7 +283,7 @@ function loadRawConfig(path) {
     if (!existsSync(path))
         return undefined;
     try {
-        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        const parsed = JSON.parse(stripBom(readFileSync(path, "utf-8")));
         if (typeof parsed !== "object" || parsed === null)
             return undefined;
         return parsed;

package/dist/core/mcp-servers.d.ts

@@ -0,0 +1,134 @@
+/**
+ * MCP server configuration and the servers extensions register with `pi.registerMcpServer()`.
+ *
+ * The core only validates and stores registrations. The MCP extension (built in, or another
+ * extension that handles `mcp_servers_change`) connects them next to the servers from `mcp.json`.
+ */
+/** Whether a tool name matches any of the entries, each an exact name or a pattern. */
+export declare function createToolNameMatcher(entries: readonly string[]): (name: string) => boolean;
+/** MCP resource tools, which reach every server with resources. */
+export declare const LIST_MCP_RESOURCES_TOOL = "list_mcp_resources";
+export declare const LIST_MCP_RESOURCE_TEMPLATES_TOOL = "list_mcp_resource_templates";
+export declare const READ_MCP_RESOURCE_TOOL = "read_mcp_resource";
+/** Whether a tool comes from MCP: a server tool (`mcp__<server>__<tool>`) or a resource tool. */
+export declare function isMcpToolName(name: string): boolean;
+/**
+ * - `codemode`: tools are callable from codemode scripts but neither declared to the model nor
+ *   listed in the codemode description, which lists only the server's namespace. Scripts find them
+ *   with `searchTools()`. `codemode-deferred` is accepted as an alias.
+ * - `deferred`: not declared to the model until the `tool_search` tool loads them; the model then
+ *   calls them directly. Does not need codemode.
+ * - `direct`: tools are declared to the model like any other tool (and callable from codemode).
+ * - `hidden`: tools are registered but unreachable.
+ */
+export type McpExposure = "codemode" | "deferred" | "direct" | "hidden";
+interface McpServerConfigBase {
+    /** Default: `codemode`. */
+    exposure?: McpExposure;
+    /**
+     * What the server offers, in a sentence. The `mcp_servers` system prompt section lists the server
+     * with it, tool search ranks the server's tools by it, and codemode's `describeNamespace()` returns it.
+     */
+    description?: string;
+    /**
+     * Exposure of single tools, overriding `exposure`. Keys are tool names as the server offers them,
+     * or patterns where `*` matches any characters. An exact name wins over patterns; among patterns
+     * the first match in the object wins. `hidden` removes tools, so `"exposure": "hidden"` with
+     * overrides for a few tools exposes only those.
+     */
+    toolExposure?: Record<string, McpExposure>;
+    /** Set to false to keep the entry without connecting. Default: true. */
+    enabled?: boolean;
+    /** Per-request timeout in seconds. Progress notifications from the server reset it. Default: 60. */
+    timeout?: number;
+}
+export interface McpStdioServerConfig extends McpServerConfigBase {
+    type?: "stdio";
+    command: string;
+    args?: string[];
+    /** Values may reference environment variables (`${NAME}`) or commands (`!cmd`). */
+    env?: Record<string, string>;
+    /** Relative paths resolve against the session working directory. */
+    cwd?: string;
+}
+/** OAuth client settings for servers that do not support dynamic client registration. */
+export interface McpOAuthConfig {
+    /** Pre-registered client id. Without it, pi registers a client with the authorization server. */
+    clientId?: string;
+    /** May reference environment variables (`${NAME}`) or commands (`!cmd`). */
+    clientSecret?: string;
+    /**
+     * Port of the loopback callback server, for clients registered with a fixed redirect URI. Without
+     * `callbackUrl`, the redirect URI is `http://127.0.0.1:<port>/callback`.
+     */
+    callbackPort?: number;
+    /**
+     * Redirect URI registered for `clientId`, for example `http://localhost:8080/oauth/callback`. It must
+     * be an `http` URI on `localhost`, `127.0.0.1`, or `[::1]`. Without a port, the callback server
+     * listens on `callbackPort` or a free port, which is added to the URI (RFC 8252).
+     */
+    callbackUrl?: string;
+    /** Scopes to request, separated by spaces. Default: the scopes the server advertises. */
+    scope?: string;
+    /**
+     * `client_name` sent with dynamic client registration, for servers that only accept known clients.
+     * Default: `APP_NAME` (Selesai).
+     */
+    clientName?: string;
+    /** Dynamic client registration. CIMD is disabled: Selesai has no hosted metadata document. */
+    clientRegistration?: "dcr";
+    /**
+     * Authorization server metadata document (RFC 8414 or OpenID Connect discovery) to use instead of
+     * discovery through the server, for servers that advertise a wrong authorization server or none.
+     * The document is trusted as configured. Must use https, except on loopback hosts.
+     */
+    authServerMetadataUrl?: string;
+}
+/** Whether a redirect URI can be served by pi's loopback callback server. */
+export declare function isLoopbackRedirectUri(value: string): boolean;
+export interface McpHttpServerConfig extends McpServerConfigBase {
+    type?: "http";
+    url: string;
+    /** Values may reference environment variables (`${NAME}`) or commands (`!cmd`). */
+    headers?: Record<string, string>;
+    oauth?: McpOAuthConfig;
+    /**
+     * Send the token of a pi provider (`/login <provider>`) instead of using OAuth. Not allowed in project
+     * `mcp.json` files, and requires https except on loopback hosts, since it sends the credential to `url`.
+     */
+    auth?: {
+        provider: string;
+    };
+}
+export type McpServerConfig = McpStdioServerConfig | McpHttpServerConfig;
+/** Namespace of a server's tools: `mcp__<server>` with `-` replaced by `_`, like the tool names. */
+export declare function mcpNamespace(server: string): string;
+/** Exposure of one tool of a server: its `toolExposure` entry, else the server's `exposure`. */
+export declare function getMcpToolExposure(config: McpServerConfig, toolName: string): McpExposure;
+/**
+ * Validate one server entry of the `mcpServers` shape. Returns a copy of the config with exposure
+ * aliases resolved, or an error message.
+ */
+export declare function validateMcpServerConfig(name: string, raw: unknown): McpServerConfig | string;
+/** A server an extension registered with `pi.registerMcpServer()`. */
+export interface RegisteredMcpServer {
+    name: string;
+    config: McpServerConfig;
+    /** Path of the extension that registered the server. */
+    extensionPath: string;
+}
+/** Servers registered by the extensions of one runtime. */
+export declare class McpServerRegistry {
+    private readonly servers;
+    private changeListener;
+    /** Register or replace a server. The caller checks ownership. */
+    register(server: RegisteredMcpServer): void;
+    /** Remove a server registered by `extensionPath`. Servers of other extensions are left alone. */
+    unregister(name: string, extensionPath: string): void;
+    get(name: string): RegisteredMcpServer | undefined;
+    /** Copies of the registered servers, in registration order. */
+    list(): RegisteredMcpServer[];
+    /** Called after every change. The runner sets it when it binds, to emit `mcp_servers_change`. */
+    setChangeListener(listener: (() => void) | undefined): void;
+}
+export {};