@aexol/spectral 0.8.2 → 0.8.6

package/dist/mcp/consent-manager.d.ts

@@ -0,0 +1,14 @@
+export type ToolConsentMode = "never" | "once-per-server" | "always";
+export declare class ConsentManager {
+    private mode;
+    private approvedServers;
+    private deniedServers;
+    private log;
+    constructor(mode?: ToolConsentMode);
+    requiresPrompt(serverName: string): boolean;
+    shouldCacheConsent(): boolean;
+    registerDecision(serverName: string, approved: boolean): void;
+    ensureApproved(serverName: string): void;
+    clear(serverName?: string): void;
+}
+//# sourceMappingURL=consent-manager.d.ts.map

package/dist/mcp/consent-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent-manager.d.ts","sourceRoot":"","sources":["../../src/mcp/consent-manager.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAErE,qBAAa,cAAc;IAKb,OAAO,CAAC,IAAI;IAJxB,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,GAAG,CAAiD;gBAExC,IAAI,GAAE,eAAmC;IAI7D,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAO3C,kBAAkB,IAAI,OAAO;IAI7B,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAc7D,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAaxC,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;CAWjC"}

package/dist/mcp/direct-tools.d.ts

@@ -0,0 +1,11 @@
+import type { ToolDefinition } from "../sdk/coding-agent/index.js";
+import type { McpExtensionState } from "./state.js";
+import type { DirectToolSpec, McpConfig } from "./types.js";
+import type { MetadataCache } from "./metadata-cache.js";
+export declare function resolveDirectTools(config: McpConfig, cache: MetadataCache | null, prefix: "server" | "none" | "short", envOverride?: string[]): DirectToolSpec[];
+export declare function getMissingConfiguredDirectToolServers(config: McpConfig, cache: MetadataCache | null): string[];
+export declare function buildProxyDescription(config: McpConfig, cache: MetadataCache | null, directSpecs: DirectToolSpec[]): string;
+type DirectToolExecute = ToolDefinition["execute"];
+export declare function createDirectToolExecutor(getState: () => McpExtensionState | null, getInitPromise: () => Promise<McpExtensionState> | null, spec: DirectToolSpec): DirectToolExecute;
+export {};
+//# sourceMappingURL=direct-tools.d.ts.map

package/dist/mcp/direct-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/direct-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAwEzD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,EACnC,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,cAAc,EAAE,CAoGlB;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,aAAa,GAAG,IAAI,GAC1B,MAAM,EAAE,CAkBV;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,WAAW,EAAE,cAAc,EAAE,GAC5B,MAAM,CAoDR;AAED,KAAK,iBAAiB,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;AAEnD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,iBAAiB,GAAG,IAAI,EACxC,cAAc,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,EACvD,IAAI,EAAE,cAAc,GACnB,iBAAiB,CAwJnB"}

package/dist/mcp/errors.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Custom error types for MCP UI operations.
+ * Provides structured errors with context and recovery hints.
+ */
+export interface McpUiErrorContext {
+    server?: string;
+    tool?: string;
+    uri?: string;
+    session?: string;
+    [key: string]: unknown;
+}
+/**
+ * Base error class for MCP UI errors.
+ */
+export declare class McpUiError extends Error {
+    readonly code: string;
+    readonly context: McpUiErrorContext;
+    readonly recoveryHint?: string;
+    readonly cause?: Error;
+    constructor(message: string, options: {
+        code: string;
+        context?: McpUiErrorContext;
+        recoveryHint?: string;
+        cause?: Error;
+    });
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error fetching a UI resource from the MCP server.
+ */
+export declare class ResourceFetchError extends McpUiError {
+    constructor(uri: string, reason: string, options?: {
+        server?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Error parsing or validating UI resource content.
+ */
+export declare class ResourceParseError extends McpUiError {
+    constructor(uri: string, reason: string, options?: {
+        server?: string;
+        mimeType?: string;
+    });
+}
+/**
+ * Error connecting to the AppBridge.
+ */
+export declare class BridgeConnectionError extends McpUiError {
+    constructor(reason: string, options?: {
+        session?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Error related to user consent for tool calls.
+ */
+export declare class ConsentError extends McpUiError {
+    readonly denied: boolean;
+    constructor(server: string, options: {
+        denied?: boolean;
+        requiresApproval?: boolean;
+    });
+}
+/**
+ * Error with UI server session management.
+ */
+export declare class SessionError extends McpUiError {
+    constructor(reason: string, options?: {
+        session?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Error starting or operating the UI server.
+ */
+export declare class ServerError extends McpUiError {
+    constructor(reason: string, options?: {
+        port?: number;
+        cause?: Error;
+    });
+}
+/**
+ * Error communicating with the MCP server.
+ */
+export declare class McpServerError extends McpUiError {
+    constructor(server: string, reason: string, options?: {
+        tool?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Wrap an unknown error into an McpUiError.
+ */
+export declare function wrapError(error: unknown, context?: McpUiErrorContext): McpUiError;
+/**
+ * Check if an error is a specific MCP UI error type.
+ */
+export declare function isErrorCode(error: unknown, code: string): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/mcp/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/mcp/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,iBAAiB,CAAC;QAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;IAeH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;gBAE9C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAU/C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;gBAE9C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;CASnD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;gBACvC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAS1E;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAGvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE;CAgB5D;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;gBAExC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAUhD;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAEvC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAU7C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;gBAE1C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAU7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAmBjF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE"}

package/dist/mcp/glimpse-ui.d.ts

@@ -0,0 +1,10 @@
+export declare function isGlimpseAvailable(): boolean;
+export declare function openGlimpseWindow(html: string, options: {
+    title: string;
+    width?: number;
+    height?: number;
+    onClosed: () => void;
+}): Promise<{
+    close: () => void;
+}>;
+//# sourceMappingURL=glimpse-ui.d.ts.map

package/dist/mcp/glimpse-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glimpse-ui.d.ts","sourceRoot":"","sources":["../../src/mcp/glimpse-ui.ts"],"names":[],"mappings":"AASA,wBAAgB,kBAAkB,IAAI,OAAO,CAW5C;AAyBD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;;GA2BF"}

package/dist/mcp/host-html-template.d.ts

@@ -0,0 +1,17 @@
+import type { UiHostContext, UiResourceContent, UiResourceCsp } from "./types.js";
+export interface HostHtmlTemplateInput {
+    sessionToken: string;
+    serverName: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    resource: UiResourceContent;
+    allowAttribute: string;
+    requireToolConsent: boolean;
+    cacheToolConsent: boolean;
+    hostContext?: UiHostContext;
+    appBridgeModuleUrl?: string;
+}
+export declare function buildHostHtmlTemplate(input: HostHtmlTemplateInput): string;
+export declare function buildCspMetaContent(csp: UiResourceCsp | undefined): string | undefined;
+export declare function applyCspMeta(html: string, cspContent: string | undefined): string;
+//# sourceMappingURL=host-html-template.d.ts.map

package/dist/mcp/host-html-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-html-template.d.ts","sourceRoot":"","sources":["../../src/mcp/host-html-template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKlF,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAkV1E;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CA2BtF;AAOD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQjF"}

package/dist/mcp/host-html-template.js

@@ -102,8 +102,8 @@ export function buildHostHtmlTemplate(input) {
     const ALLOW_ATTRIBUTE = ${allowAttribute};
     const REQUIRE_TOOL_CONSENT = ${requireToolConsent};
     const CACHE_TOOL_CONSENT = ${cacheToolConsent};
-    const STREAM_CONTEXT_KEY = "pi-mcp-adapter/stream";
-    const STREAM_PATCH_METHOD = "notifications/pi-mcp-adapter/ui-result-patch";
+    const STREAM_CONTEXT_KEY = "spectral-mcp-adapter/stream";
+    const STREAM_PATCH_METHOD = "notifications/spectral-mcp-adapter/ui-result-patch";
 
     const iframe = document.getElementById("mcp-app");
     const statusNode = document.getElementById("status");
@@ -147,7 +147,7 @@ export function buildHostHtmlTemplate(input) {
 
     const bridge = new AppBridge(
       null,
-      { name: "pi", version: "1.0.0" },
+      { name: "spectral", version: "1.0.0" },
       { serverTools: {}, openLinks: {}, logging: {}, updateModelContext: {}, message: {} },
       { hostContext: HOST_CONTEXT }
     );

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
+export default function mcpAdapter(ext: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,8BAA8B,CAAC;AAa3E,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,GAAG,EAAE,YAAY,QAySnD"}

package/dist/mcp/index.js

@@ -1,3 +1,4 @@
+import { setLiveMcpStateGetter } from "./state-getter.js";
 import { Type } from "typebox";
 import { showTools, reconnectServers, authenticateServer, showSetupStatus } from "./commands.js";
 import { loadMcpConfig } from "./config.js";
@@ -7,8 +8,9 @@ import { loadMetadataCache } from "./metadata-cache.js";
 import { executeCall, executeConnect, executeDescribe, executeList, executeSearch, executeStatus, executeUiMessages } from "./proxy-modes.js";
 import { getConfigPathFromArgv, truncateAtWord } from "./utils.js";
 import { initializeOAuth, shutdownOAuth } from "./mcp-auth-flow.js";
-export default function mcpAdapter(pi) {
+export default function mcpAdapter(ext) {
     let state = null;
+    setLiveMcpStateGetter(() => state);
     let initPromise = null;
     let lifecycleGeneration = 0;
     async function shutdownState(currentState, reason) {
@@ -53,7 +55,7 @@ export default function mcpAdapter(pi) {
         || directSpecs.length === 0
         || missingConfiguredDirectToolServers.length > 0;
     for (const spec of directSpecs) {
-        pi.registerTool({
+        ext.registerTool({
             name: spec.prefixedName,
             label: `MCP: ${spec.originalName}`,
             description: spec.description || "(no description)",
@@ -62,12 +64,12 @@ export default function mcpAdapter(pi) {
             execute: createDirectToolExecutor(() => state, () => initPromise, spec),
         });
     }
-    const getPiTools = () => pi.getAllTools();
-    pi.registerFlag("mcp-config", {
+    const getSpectralTools = () => ext.getAllTools();
+    ext.registerFlag("mcp-config", {
         description: "Path to MCP config file",
         type: "string",
     });
-    pi.on("session_start", async (_event, ctx) => {
+    ext.on("session_start", async (_event, ctx) => {
         const generation = ++lifecycleGeneration;
         const previousState = state;
         state = null;
@@ -87,7 +89,7 @@ export default function mcpAdapter(pi) {
         await initializeOAuth().catch(err => {
             console.error("MCP OAuth initialization failed:", err);
         });
-        const promise = initializeMcp(pi, ctx);
+        const promise = initializeMcp(ext, ctx);
         initPromise = promise;
         promise.then(async (nextState) => {
             if (generation !== lifecycleGeneration || initPromise !== promise) {
@@ -113,7 +115,7 @@ export default function mcpAdapter(pi) {
             initPromise = null;
         });
     });
-    pi.on("session_shutdown", async () => {
+    ext.on("session_shutdown", async () => {
         ++lifecycleGeneration;
         const currentState = state;
         state = null;
@@ -128,7 +130,7 @@ export default function mcpAdapter(pi) {
             console.error("MCP: session shutdown cleanup failed", error);
         }
     });
-    pi.registerCommand("mcp", {
+    ext.registerCommand("mcp", {
         description: "Show MCP server status",
         handler: async (args, ctx) => {
             if (!state && initPromise) {
@@ -158,17 +160,17 @@ export default function mcpAdapter(pi) {
                     await showTools(state, ctx);
                     break;
                 case "setup":
-                    await showSetupStatus(state, pi, ctx, earlyConfigPath);
+                    await showSetupStatus(state, ext, ctx, earlyConfigPath);
                     break;
                 case "status":
                 case "":
                 default:
-                    await showSetupStatus(state, pi, ctx, earlyConfigPath);
+                    await showSetupStatus(state, ext, ctx, earlyConfigPath);
                     break;
             }
         },
     });
-    pi.registerCommand("mcp-auth", {
+    ext.registerCommand("mcp-auth", {
         description: "Authenticate with an MCP server (OAuth)",
         handler: async (args, ctx) => {
             const serverName = args?.trim();
@@ -197,7 +199,7 @@ export default function mcpAdapter(pi) {
         },
     });
     if (shouldRegisterProxyTool) {
-        pi.registerTool({
+        ext.registerTool({
             name: "mcp",
             label: "MCP",
             description: buildProxyDescription(earlyConfig, earlyCache, directSpecs),
@@ -253,7 +255,7 @@ export default function mcpAdapter(pi) {
                     return executeUiMessages(state);
                 }
                 if (params.tool) {
-                    return executeCall(state, params.tool, parsedArgs, params.server, getPiTools);
+                    return executeCall(state, params.tool, parsedArgs, params.server, getSpectralTools);
                 }
                 if (params.restart) {
                     return executeConnect(state, params.restart);

package/dist/mcp/init.d.ts

@@ -0,0 +1,10 @@
+import type { ExtensionAPI, ExtensionContext } from "../sdk/coding-agent/index.js";
+import type { McpExtensionState } from "./state.js";
+export declare function initializeMcp(ext: ExtensionAPI, ctx: ExtensionContext): Promise<McpExtensionState>;
+export declare function updateServerMetadata(state: McpExtensionState, serverName: string): void;
+export declare function updateMetadataCache(state: McpExtensionState, serverName: string): void;
+export declare function flushMetadataCache(state: McpExtensionState): void;
+export declare function updateStatusBar(state: McpExtensionState): void;
+export declare function getFailureAgeSeconds(state: McpExtensionState, serverName: string): number | null;
+export declare function lazyConnect(state: McpExtensionState, serverName: string): Promise<boolean>;
+//# sourceMappingURL=init.d.ts.map

package/dist/mcp/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/mcp/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA0BpD,wBAAsB,aAAa,CACjC,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAsL5B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAWvF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CA+BtF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAMjE;AAMD,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAU9D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhG;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoChG"}

package/dist/mcp/init.js

@@ -10,8 +10,8 @@ import { openUrl, parallelLimit } from "./utils.js";
 import { logger } from "./logger.js";
 import { getMissingConfiguredDirectToolServers } from "./direct-tools.js";
 const FAILURE_BACKOFF_MS = 60 * 1000;
-export async function initializeMcp(pi, ctx) {
-    const configPath = pi.getFlag("mcp-config");
+export async function initializeMcp(ext, ctx) {
+    const configPath = ext.getFlag("mcp-config");
     const config = loadMcpConfig(configPath);
     const manager = new McpServerManager();
     const samplingAutoApprove = config.settings?.samplingAutoApprove === true;
@@ -40,9 +40,9 @@ export async function initializeMcp(pi, ctx) {
         consentManager,
         uiServer: null,
         completedUiSessions: [],
-        openBrowser: (url) => openUrl(pi, url, process.env.BROWSER),
+        openBrowser: (url) => openUrl(ext, url, process.env.BROWSER),
         ui,
-        sendMessage: (message, options) => pi.sendMessage(message, options),
+        sendMessage: (message, options) => ext.sendMessage(message, options),
     };
     const serverEntries = Object.entries(config.mcpServers);
     if (serverEntries.length === 0) {

package/dist/mcp/lifecycle.d.ts

@@ -0,0 +1,30 @@
+import type { ServerDefinition } from "./types.js";
+import type { McpServerManager } from "./server-manager.js";
+export type ReconnectCallback = (serverName: string) => void;
+export declare class McpLifecycleManager {
+    private manager;
+    private keepAliveServers;
+    private allServers;
+    private serverSettings;
+    private globalIdleTimeout;
+    private healthCheckInterval?;
+    private onReconnect?;
+    private onIdleShutdown?;
+    constructor(manager: McpServerManager);
+    /**
+     * Set callback to be invoked after a successful auto-reconnect.
+     * Use this to update tool metadata when a server reconnects.
+     */
+    setReconnectCallback(callback: ReconnectCallback): void;
+    markKeepAlive(name: string, definition: ServerDefinition): void;
+    registerServer(name: string, definition: ServerDefinition, settings?: {
+        idleTimeout?: number;
+    }): void;
+    setGlobalIdleTimeout(minutes: number): void;
+    setIdleShutdownCallback(callback: (serverName: string) => void): void;
+    startHealthChecks(intervalMs?: number): void;
+    private checkConnections;
+    private getIdleTimeout;
+    gracefulShutdown(): Promise<void>;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/mcp/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/mcp/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,MAAM,MAAM,iBAAiB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAE7D,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,gBAAgB,CAAuC;IAC/D,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,mBAAmB,CAAC,CAAiB;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAoB;IACxC,OAAO,CAAC,cAAc,CAAC,CAA+B;gBAE1C,OAAO,EAAE,gBAAgB;IAIrC;;;OAGG;IACH,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIvD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAI/D,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAOrG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3C,uBAAuB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrE,iBAAiB,CAAC,UAAU,SAAQ,GAAG,IAAI;YAO7B,gBAAgB;IA0B9B,OAAO,CAAC,cAAc;IAMhB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CAMxC"}

package/dist/mcp/logger.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Centralized logging for MCP UI operations.
+ * Provides structured, contextual logs with levels.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LogContext {
+    server?: string;
+    session?: string;
+    tool?: string;
+    uri?: string;
+    [key: string]: unknown;
+}
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    context?: LogContext;
+    error?: Error;
+    timestamp: Date;
+}
+type LogHandler = (entry: LogEntry) => void;
+declare class Logger {
+    private minLevel;
+    private handlers;
+    private defaultContext;
+    setLevel(level: LogLevel): void;
+    setDefaultContext(context: LogContext): void;
+    addHandler(handler: LogHandler): void;
+    clearHandlers(): void;
+    private shouldLog;
+    private emit;
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: Error, context?: LogContext): void;
+    /**
+     * Create a child logger with additional default context.
+     */
+    child(context: LogContext): ChildLogger;
+}
+declare class ChildLogger {
+    private parent;
+    private context;
+    constructor(parent: Logger, context: LogContext);
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: Error, context?: LogContext): void;
+    child(context: LogContext): ChildLogger;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/mcp/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/mcp/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAgB5C,cAAM,MAAM;IACV,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,cAAc,CAAkB;IAExC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAI5C,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAIrC,aAAa,IAAI,IAAI;IAIrB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,IAAI;IAoCZ,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjE;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW;CAGxC;AAED,cAAM,WAAW;IAEb,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;gBADP,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU;IAG7B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjE,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW;CAGxC;AAcD,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/mcp/mcp-auth-flow.d.ts

@@ -0,0 +1,69 @@
+/**
+ * MCP Auth Flow
+ *
+ * High-level OAuth flow management using the MCP SDK's built-in auth functions.
+ */
+import { type StoredTokens } from "./mcp-auth.js";
+import type { ServerEntry } from "./types.js";
+/** Auth status for a server */
+export type AuthStatus = "authenticated" | "expired" | "not_authenticated";
+/**
+ * Start OAuth authentication flow for a server.
+ * Returns the authorization URL when browser authorization is required.
+ */
+export declare function startAuth(serverName: string, serverUrl: string, definition?: ServerEntry): Promise<{
+    authorizationUrl: string;
+}>;
+/**
+ * Complete OAuth authentication with the authorization code.
+ */
+export declare function completeAuth(serverName: string, authorizationCode: string): Promise<AuthStatus>;
+/**
+ * Perform the complete OAuth authentication flow for a server.
+ *
+ * @param serverName - The name of the MCP server
+ * @param serverUrl - The URL of the MCP server
+ * @param definition - The server definition (optional)
+ * @returns The final auth status
+ */
+export declare function authenticate(serverName: string, serverUrl: string, definition?: ServerEntry): Promise<AuthStatus>;
+/**
+ * Get a valid access token for a server, refreshing if necessary.
+ *
+ * @param serverName - The name of the MCP server
+ * @param serverUrl - The URL of the MCP server
+ * @returns The valid tokens or null if not authenticated
+ */
+export declare function getValidToken(serverName: string, serverUrl: string): Promise<StoredTokens | null>;
+/**
+ * Check the authentication status for a server.
+ *
+ * @param serverName - The name of the MCP server
+ * @returns The current auth status
+ */
+export declare function getAuthStatus(serverName: string): Promise<AuthStatus>;
+/**
+ * Remove all OAuth credentials for a server.
+ *
+ * @param serverName - The name of the MCP server
+ */
+export declare function removeAuth(serverName: string): Promise<void>;
+/**
+ * Check if OAuth is supported for a server configuration.
+ * OAuth is supported for HTTP servers unless explicitly disabled.
+ *
+ * @param definition - The server definition
+ * @returns True if OAuth is supported
+ */
+export declare function supportsOAuth(definition: ServerEntry): boolean;
+/**
+ * Initialize the OAuth system on startup.
+ * Starts the callback server if there are any OAuth servers configured.
+ */
+export declare function initializeOAuth(): Promise<void>;
+/**
+ * Shutdown the OAuth system.
+ * Stops the callback server and cancels pending auths.
+ */
+export declare function shutdownOAuth(): Promise<void>;
+//# sourceMappingURL=mcp-auth-flow.d.ts.map

package/dist/mcp/mcp-auth-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-auth-flow.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-auth-flow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,OAAO,EAQL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,SAAS,GAAG,mBAAmB,CAAA;AAkD1E;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,WAAW,GACvB,OAAO,CAAC;IAAE,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CAyDvC;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CAcrB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,WAAW,GACvB,OAAO,CAAC,UAAU,CAAC,CAuErB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA2C9B;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAM3E;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAalE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,WAAW,GAAG,OAAO,CAU9D;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD"}

package/dist/mcp/mcp-auth.d.ts

@@ -0,0 +1,100 @@
+/**
+ * MCP Auth Storage Module
+ *
+ * Handles secure storage of OAuth credentials, tokens, client information,
+ * and PKCE state for MCP servers. Maintains backward compatibility with
+ * per-server directory structure.
+ *
+ * Token storage location: $MCP_OAUTH_DIR/<server>/tokens.json when set,
+ * otherwise <Pi agent dir>/mcp-oauth/<server>/tokens.json
+ */
+/** OAuth token storage format */
+export interface StoredTokens {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    scope?: string;
+}
+/** OAuth client information from dynamic or static registration */
+export interface StoredClientInfo {
+    clientId: string;
+    clientSecret?: string;
+    clientIdIssuedAt?: number;
+    clientSecretExpiresAt?: number;
+}
+/** Complete auth entry for a server */
+export interface AuthEntry {
+    tokens?: StoredTokens;
+    clientInfo?: StoredClientInfo;
+    codeVerifier?: string;
+    oauthState?: string;
+    serverUrl?: string;
+}
+/**
+ * Get auth entry for a server.
+ */
+export declare function getAuthEntry(serverName: string): AuthEntry | undefined;
+/**
+ * Get auth entry and validate it's for the correct URL.
+ * Returns undefined if URL has changed (credentials are invalid).
+ */
+export declare function getAuthForUrl(serverName: string, serverUrl: string): AuthEntry | undefined;
+/**
+ * Save auth entry for a server.
+ */
+export declare function saveAuthEntry(serverName: string, entry: AuthEntry, serverUrl?: string): void;
+/**
+ * Remove auth entry for a server.
+ * Also removes the server directory if empty.
+ */
+export declare function removeAuthEntry(serverName: string): void;
+/**
+ * Update tokens for a server.
+ */
+export declare function updateTokens(serverName: string, tokens: StoredTokens, serverUrl?: string): void;
+/**
+ * Update client info for a server.
+ */
+export declare function updateClientInfo(serverName: string, clientInfo: StoredClientInfo, serverUrl?: string): void;
+/**
+ * Update code verifier for a server.
+ */
+export declare function updateCodeVerifier(serverName: string, codeVerifier: string): void;
+/**
+ * Clear code verifier for a server.
+ */
+export declare function clearCodeVerifier(serverName: string): void;
+/**
+ * Update OAuth state for a server.
+ */
+export declare function updateOAuthState(serverName: string, state: string): void;
+/**
+ * Get OAuth state for a server.
+ */
+export declare function getOAuthState(serverName: string): string | undefined;
+/**
+ * Clear OAuth state for a server.
+ */
+export declare function clearOAuthState(serverName: string): void;
+/**
+ * Check if stored tokens are expired.
+ * Returns null if no tokens exist, false if no expiry or not expired, true if expired.
+ */
+export declare function isTokenExpired(serverName: string): boolean | null;
+/**
+ * Check if a server has stored tokens.
+ */
+export declare function hasStoredTokens(serverName: string): boolean;
+/**
+ * Clear all credentials for a server.
+ */
+export declare function clearAllCredentials(serverName: string): void;
+/**
+ * Clear only client info for a server.
+ */
+export declare function clearClientInfo(serverName: string): void;
+/**
+ * Clear only tokens for a server.
+ */
+export declare function clearTokens(serverName: string): void;
+//# sourceMappingURL=mcp-auth.d.ts.map

package/dist/mcp/mcp-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-auth.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,uCAAuC;AACvC,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2DD;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAW1F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAM5F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAkBxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,gBAAgB,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAIjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAM1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAMxD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAKjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAMxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAMpD"}