@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-mcp-adapter/types.d.ts

@@ -0,0 +1,286 @@
+import type { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import type { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import type { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import type { TextContent, ImageContent } from "@earendil-works/pi-ai";
+import type { UiStreamMode } from "./ui-stream-types.ts";
+export type Transport = StdioClientTransport | SSEClientTransport | StreamableHTTPClientTransport;
+export type ImportKind = "cursor" | "claude-code" | "claude-desktop" | "codex" | "windsurf" | "vscode";
+export interface McpTool {
+    name: string;
+    title?: string;
+    description?: string;
+    inputSchema?: unknown;
+    _meta?: Record<string, unknown>;
+}
+export interface McpResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+    _meta?: Record<string, unknown>;
+}
+export interface UiResourceMeta {
+    csp?: UiResourceCsp;
+    permissions?: UiResourcePermissions;
+    domain?: string;
+    prefersBorder?: boolean;
+}
+export interface UiResourceContent {
+    uri: string;
+    html: string;
+    mimeType?: string;
+    meta: UiResourceMeta;
+}
+export interface UiProxyRequestBody<TParams> {
+    token: string;
+    params: TParams;
+}
+export interface UiProxyResult<T = Record<string, unknown>> {
+    ok: boolean;
+    result?: T;
+    error?: string;
+}
+export interface UiResourceCsp {
+    connectDomains?: string[];
+    scriptDomains?: string[];
+    styleDomains?: string[];
+    fontDomains?: string[];
+    imgDomains?: string[];
+    mediaDomains?: string[];
+    frameDomains?: string[];
+    workerDomains?: string[];
+    baseUriDomains?: string[];
+}
+export interface UiResourcePermissions {
+    camera?: {};
+    microphone?: {};
+    geolocation?: {};
+    clipboardWrite?: {};
+}
+export interface UiToolInfo {
+    id?: string | number;
+    tool: {
+        name: string;
+        description?: string;
+        inputSchema?: unknown;
+    };
+}
+export interface UiHostContext {
+    toolInfo?: UiToolInfo;
+    theme?: "light" | "dark";
+    styles?: Record<string, unknown>;
+    displayMode?: UiDisplayMode;
+    availableDisplayModes?: UiDisplayMode[];
+    containerDimensions?: {
+        width?: number;
+        maxWidth?: number;
+        height?: number;
+        maxHeight?: number;
+    };
+    [key: string]: unknown;
+}
+export type UiDisplayMode = "inline" | "fullscreen" | "pip";
+export { UI_STREAM_HOST_CONTEXT_KEY, UI_STREAM_REQUEST_META_KEY, UI_STREAM_RESULT_PATCH_METHOD, SERVER_STREAM_RESULT_PATCH_METHOD, UI_STREAM_STRUCTURED_CONTENT_KEY, uiStreamModeSchema, visualizationStreamPhaseSchema, visualizationStreamFrameTypeSchema, visualizationStreamStatusSchema, uiStreamHostContextSchema, visualizationStreamEnvelopeSchema, uiStreamCallToolResultSchema, uiStreamResultPatchNotificationSchema, serverStreamResultPatchNotificationSchema, getUiStreamHostContext, getVisualizationStreamEnvelope, type UiStreamMode, type VisualizationStreamPhase, type VisualizationStreamFrameType, type VisualizationStreamStatus, type UiStreamHostContext, type VisualizationStreamEnvelope, type UiStreamCallToolResult, type UiStreamResultPatchNotification, type ServerStreamResultPatchNotification, type UiStreamSummary, } from "./ui-stream-types.ts";
+export interface UiMessageParams {
+    role?: string;
+    content?: unknown[];
+    type?: "prompt" | "notify" | "intent" | "message";
+    message?: string;
+    prompt?: string;
+    intent?: string;
+    params?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Extract prompt text from either legacy MCP UI message shapes or native AppBridge user messages.
+ */
+export declare function extractUiPromptText(params: UiMessageParams): string | undefined;
+/**
+ * Structured UI handoff recovered from a canonical prompt envelope.
+ */
+export interface UiPromptHandoff {
+    intent: string;
+    params: Record<string, unknown>;
+    raw: string;
+}
+/**
+ * Parse a canonical named UI handoff encoded as `intent\n{json}`.
+ */
+export declare function parseUiPromptHandoff(prompt: string): UiPromptHandoff | undefined;
+/**
+ * Accumulated messages from a UI session.
+ * Collected during the session and available when it ends.
+ */
+export interface UiSessionMessages {
+    prompts: string[];
+    notifications: string[];
+    intents: Array<{
+        intent: string;
+        params?: Record<string, unknown>;
+    }>;
+}
+export interface UiModelContextParams {
+    content?: unknown[];
+    structuredContent?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface UiOpenLinkResult {
+    isError?: boolean;
+    [key: string]: unknown;
+}
+export interface UiDisplayModeRequest {
+    mode?: UiDisplayMode;
+}
+export interface UiDisplayModeResult {
+    mode: UiDisplayMode;
+    [key: string]: unknown;
+}
+export interface McpContent {
+    type: "text" | "image" | "audio" | "resource" | "resource_link";
+    text?: string;
+    data?: string;
+    mimeType?: string;
+    resource?: {
+        uri: string;
+        text?: string;
+        blob?: string;
+    };
+    uri?: string;
+    name?: string;
+    description?: string;
+}
+export type ContentBlock = TextContent | ImageContent;
+export interface OAuthConfig {
+    /** OAuth grant type (defaults to authorization_code) */
+    grantType?: "authorization_code" | "client_credentials";
+    /** Pre-registered client ID (optional, dynamic registration used if not provided) */
+    clientId?: string;
+    /** Client secret for confidential clients */
+    clientSecret?: string;
+    /** Requested OAuth scopes */
+    scope?: string;
+    /** Exact authorization-code redirect URI for pre-registered clients */
+    redirectUri?: string;
+    /** Client display name for dynamic registration */
+    clientName?: string;
+    /** Client homepage URI for dynamic registration */
+    clientUri?: string;
+}
+export interface ServerEntry {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    /**
+     * Authentication type:
+     * - 'oauth' - Use OAuth 2.1 (auto-discovers endpoints, supports dynamic client registration)
+     * - 'bearer' - Use static Bearer token
+     * - false - Disable authentication
+     * If not specified and url is present, OAuth will be auto-detected unless custom headers are configured
+     */
+    auth?: "oauth" | "bearer" | false;
+    bearerToken?: string;
+    bearerTokenEnv?: string;
+    /**
+     * OAuth configuration (optional).
+     * If not provided, the SDK will attempt dynamic client registration.
+     * Set to false to explicitly disable OAuth for this server.
+     */
+    oauth?: OAuthConfig | false;
+    lifecycle?: "keep-alive" | "lazy" | "eager";
+    idleTimeout?: number;
+    requestTimeoutMs?: number;
+    exposeResources?: boolean;
+    directTools?: boolean | string[];
+    excludeTools?: string[];
+    debug?: boolean;
+}
+export interface McpOutputGuardSettings {
+    /** Maximum inline MCP text output bytes before truncation/spill-to-disk. Defaults to 51200 (50 KiB). */
+    maxBytes?: number;
+    /** Maximum inline MCP text output lines before truncation/spill-to-disk. Defaults to 2000. */
+    maxLines?: number;
+    /** Maximum details.mcpResult JSON bytes kept raw; larger results are summarized and spilled to disk. Defaults to 16384 (16 KiB). */
+    detailsMaxBytes?: number;
+}
+export interface McpSettings {
+    toolPrefix?: "server" | "none" | "short";
+    idleTimeout?: number;
+    requestTimeoutMs?: number;
+    directTools?: boolean;
+    disableProxyTool?: boolean;
+    autoAuth?: boolean;
+    sampling?: boolean;
+    samplingAutoApprove?: boolean;
+    elicitation?: boolean;
+    /**
+     * Guard oversized MCP tool/resource output before it is returned to the model.
+     * Defaults to true (50 KiB / 2,000 lines inline text, 16 KiB details.mcpResult).
+     * Set to false to restore raw MCP output behavior, or pass an object to tune
+     * the limits. Env kill switch: MCP_OUTPUT_GUARD=0.
+     */
+    outputGuard?: boolean | McpOutputGuardSettings;
+    /**
+     * Message returned in tool results when a server needs (re-)authentication.
+     * "${server}" is substituted with the server name. Defaults to a TUI
+     * instruction when unset.
+     */
+    authRequiredMessage?: string;
+}
+export interface McpConfig {
+    mcpServers: Record<string, ServerEntry>;
+    imports?: ImportKind[];
+    settings?: McpSettings;
+}
+export type ServerDefinition = ServerEntry;
+export interface ToolMetadata {
+    name: string;
+    originalName: string;
+    description: string;
+    resourceUri?: string;
+    uiResourceUri?: string;
+    inputSchema?: unknown;
+    uiStreamMode?: UiStreamMode;
+}
+export interface DirectToolSpec {
+    serverName: string;
+    originalName: string;
+    prefixedName: string;
+    description: string;
+    inputSchema?: unknown;
+    resourceUri?: string;
+    uiResourceUri?: string;
+    uiStreamMode?: UiStreamMode;
+}
+export interface ServerProvenance {
+    path: string;
+    kind: "user" | "project" | "import";
+    importKind?: string;
+}
+export interface McpAuthResult {
+    ok: boolean;
+    message?: string;
+}
+export interface McpPanelCallbacks {
+    reconnect: (serverName: string) => Promise<boolean>;
+    canAuthenticate: (serverName: string) => boolean;
+    authenticate: (serverName: string) => Promise<McpAuthResult>;
+    getConnectionStatus: (serverName: string) => "connected" | "idle" | "failed" | "needs-auth";
+    refreshCacheAfterReconnect: (serverName: string) => import("./metadata-cache.ts").ServerCacheEntry | null;
+}
+export interface McpPanelResult {
+    changes: Map<string, true | string[] | false>;
+    cancelled: boolean;
+}
+/**
+ * Get server prefix based on tool prefix mode.
+ */
+export declare function getServerPrefix(serverName: string, mode: "server" | "none" | "short"): string;
+/**
+ * Format a tool name with server prefix.
+ */
+export declare function formatToolName(toolName: string, serverName: string, prefix: "server" | "none" | "short"): string;
+export declare function isToolExcluded(toolName: string, serverName: string, prefix: "server" | "none" | "short", excludeTools?: unknown): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/builtin-extensions/pi-mcp-adapter/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-mcp-adapter/types.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n// types.ts - Core type definitions\nimport type { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport type { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport type { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { TextContent, ImageContent } from \"@earendil-works/pi-ai\";\nimport type { UiStreamMode } from \"./ui-stream-types.ts\";\n\n// Transport type (stdio + HTTP)\nexport type Transport = \n  | StdioClientTransport \n  | SSEClientTransport \n  | StreamableHTTPClientTransport;\n\n// Import sources for config\nexport type ImportKind = \n  | \"cursor\" \n  | \"claude-code\" \n  | \"claude-desktop\" \n  | \"codex\" \n  | \"windsurf\" \n  | \"vscode\";\n\n// Tool definition from MCP server\nexport interface McpTool {\n  name: string;\n  title?: string;\n  description?: string;\n  inputSchema?: unknown; // JSON Schema\n  _meta?: Record<string, unknown>;\n}\n\n// Resource definition from MCP server\nexport interface McpResource {\n  uri: string;\n  name: string;\n  description?: string;\n  mimeType?: string;\n  _meta?: Record<string, unknown>;\n}\n\nexport interface UiResourceMeta {\n  csp?: UiResourceCsp;\n  permissions?: UiResourcePermissions;\n  domain?: string;\n  prefersBorder?: boolean;\n}\n\nexport interface UiResourceContent {\n  uri: string;\n  html: string;\n  mimeType?: string;\n  meta: UiResourceMeta;\n}\n\nexport interface UiProxyRequestBody<TParams> {\n  token: string;\n  params: TParams;\n}\n\nexport interface UiProxyResult<T = Record<string, unknown>> {\n  ok: boolean;\n  result?: T;\n  error?: string;\n}\n\nexport interface UiResourceCsp {\n  connectDomains?: string[];\n  scriptDomains?: string[];\n  styleDomains?: string[];\n  fontDomains?: string[];\n  imgDomains?: string[];\n  mediaDomains?: string[];\n  frameDomains?: string[];\n  workerDomains?: string[];\n  baseUriDomains?: string[];\n}\n\nexport interface UiResourcePermissions {\n  camera?: {};\n  microphone?: {};\n  geolocation?: {};\n  clipboardWrite?: {};\n}\n\nexport interface UiToolInfo {\n  id?: string | number;\n  tool: {\n    name: string;\n    description?: string;\n    inputSchema?: unknown;\n  };\n}\n\nexport interface UiHostContext {\n  toolInfo?: UiToolInfo;\n  theme?: \"light\" | \"dark\";\n  styles?: Record<string, unknown>;\n  displayMode?: UiDisplayMode;\n  availableDisplayModes?: UiDisplayMode[];\n  containerDimensions?: {\n    width?: number;\n    maxWidth?: number;\n    height?: number;\n    maxHeight?: number;\n  };\n  [key: string]: unknown;\n}\n\nexport type UiDisplayMode = \"inline\" | \"fullscreen\" | \"pip\";\n\n// Re-export stream types from the shared lightweight module.\n// This allows the example package to import stream schemas without pulling the full types.ts dependency graph.\nexport {\n  UI_STREAM_HOST_CONTEXT_KEY,\n  UI_STREAM_REQUEST_META_KEY,\n  UI_STREAM_RESULT_PATCH_METHOD,\n  SERVER_STREAM_RESULT_PATCH_METHOD,\n  UI_STREAM_STRUCTURED_CONTENT_KEY,\n  uiStreamModeSchema,\n  visualizationStreamPhaseSchema,\n  visualizationStreamFrameTypeSchema,\n  visualizationStreamStatusSchema,\n  uiStreamHostContextSchema,\n  visualizationStreamEnvelopeSchema,\n  uiStreamCallToolResultSchema,\n  uiStreamResultPatchNotificationSchema,\n  serverStreamResultPatchNotificationSchema,\n  getUiStreamHostContext,\n  getVisualizationStreamEnvelope,\n  type UiStreamMode,\n  type VisualizationStreamPhase,\n  type VisualizationStreamFrameType,\n  type VisualizationStreamStatus,\n  type UiStreamHostContext,\n  type VisualizationStreamEnvelope,\n  type UiStreamCallToolResult,\n  type UiStreamResultPatchNotification,\n  type ServerStreamResultPatchNotification,\n  type UiStreamSummary,\n} from \"./ui-stream-types.ts\";\n\nexport interface UiMessageParams {\n  role?: string;\n  content?: unknown[];\n  type?: \"prompt\" | \"notify\" | \"intent\" | \"message\";\n  message?: string;\n  prompt?: string;\n  intent?: string;\n  params?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\n/**\n * Extract prompt text from either legacy MCP UI message shapes or native AppBridge user messages.\n */\nexport function extractUiPromptText(params: UiMessageParams): string | undefined {\n  if (params.type === \"prompt\" || params.prompt) {\n    const prompt = params.prompt ?? String(params.message ?? \"\");\n    return prompt || undefined;\n  }\n\n  if (params.role === \"user\" && Array.isArray(params.content)) {\n    const text = params.content\n      .map((block) => (block && typeof block === \"object\" && \"text\" in block ? String((block as { text?: unknown }).text ?? \"\") : \"\"))\n      .filter(Boolean)\n      .join(\"\\n\\n\");\n    return text || undefined;\n  }\n\n  return undefined;\n}\n\n/**\n * Structured UI handoff recovered from a canonical prompt envelope.\n */\nexport interface UiPromptHandoff {\n  intent: string;\n  params: Record<string, unknown>;\n  raw: string;\n}\n\n/**\n * Parse a canonical named UI handoff encoded as `intent\\n{json}`.\n */\nexport function parseUiPromptHandoff(prompt: string): UiPromptHandoff | undefined {\n  const newlineIndex = prompt.indexOf(\"\\n\");\n  if (newlineIndex <= 0) {\n    return undefined;\n  }\n\n  const intent = prompt.slice(0, newlineIndex).trim();\n  const payloadText = prompt.slice(newlineIndex + 1).trim();\n  if (!intent || !payloadText) {\n    return undefined;\n  }\n\n  if (!/^[A-Za-z][A-Za-z0-9_-]*$/.test(intent)) {\n    return undefined;\n  }\n\n  try {\n    const parsed = JSON.parse(payloadText);\n    if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      return undefined;\n    }\n    return {\n      intent,\n      params: parsed as Record<string, unknown>,\n      raw: prompt,\n    };\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Accumulated messages from a UI session.\n * Collected during the session and available when it ends.\n */\nexport interface UiSessionMessages {\n  prompts: string[];\n  notifications: string[];\n  intents: Array<{ intent: string; params?: Record<string, unknown> }>;\n}\n\nexport interface UiModelContextParams {\n  content?: unknown[];\n  structuredContent?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\nexport interface UiOpenLinkResult {\n  isError?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface UiDisplayModeRequest {\n  mode?: UiDisplayMode;\n}\n\nexport interface UiDisplayModeResult {\n  mode: UiDisplayMode;\n  [key: string]: unknown;\n}\n\n// Content types from MCP\nexport interface McpContent {\n  type: \"text\" | \"image\" | \"audio\" | \"resource\" | \"resource_link\";\n  text?: string;\n  data?: string;\n  mimeType?: string;\n  resource?: {\n    uri: string;\n    text?: string;\n    blob?: string;\n  };\n  uri?: string;\n  name?: string;\n  description?: string;\n}\n\n// Pi content block type\nexport type ContentBlock = TextContent | ImageContent;\n\n// OAuth configuration (SDK handles auto-discovery and dynamic registration)\nexport interface OAuthConfig {\n  /** OAuth grant type (defaults to authorization_code) */\n  grantType?: \"authorization_code\" | \"client_credentials\";\n  /** Pre-registered client ID (optional, dynamic registration used if not provided) */\n  clientId?: string;\n  /** Client secret for confidential clients */\n  clientSecret?: string;\n  /** Requested OAuth scopes */\n  scope?: string;\n  /** Exact authorization-code redirect URI for pre-registered clients */\n  redirectUri?: string;\n  /** Client display name for dynamic registration */\n  clientName?: string;\n  /** Client homepage URI for dynamic registration */\n  clientUri?: string;\n}\n\n// Server configuration\nexport interface ServerEntry {\n  command?: string;\n  args?: string[];\n  env?: Record<string, string>;\n  cwd?: string;\n  // HTTP fields\n  url?: string;\n  headers?: Record<string, string>;\n  /** \n   * Authentication type:\n   * - 'oauth' - Use OAuth 2.1 (auto-discovers endpoints, supports dynamic client registration)\n   * - 'bearer' - Use static Bearer token\n   * - false - Disable authentication\n   * If not specified and url is present, OAuth will be auto-detected unless custom headers are configured\n   */\n  auth?: \"oauth\" | \"bearer\" | false;\n  bearerToken?: string;\n  bearerTokenEnv?: string;\n  /** \n   * OAuth configuration (optional).\n   * If not provided, the SDK will attempt dynamic client registration.\n   * Set to false to explicitly disable OAuth for this server.\n   */\n  oauth?: OAuthConfig | false;\n  lifecycle?: \"keep-alive\" | \"lazy\" | \"eager\";\n  idleTimeout?: number; // minutes, overrides global setting\n  requestTimeoutMs?: number; // milliseconds, overrides global request timeout when > 0\n  // Resource handling\n  exposeResources?: boolean;\n  // Direct tool registration\n  directTools?: boolean | string[];\n  // Exclude specific MCP tools/resources by original or prefixed name\n  excludeTools?: string[];\n  // Debug\n  debug?: boolean;  // Show server stderr (default: false)\n}\n\n// Output guard tuning (settings.outputGuard object form)\nexport interface McpOutputGuardSettings {\n  /** Maximum inline MCP text output bytes before truncation/spill-to-disk. Defaults to 51200 (50 KiB). */\n  maxBytes?: number;\n  /** Maximum inline MCP text output lines before truncation/spill-to-disk. Defaults to 2000. */\n  maxLines?: number;\n  /** Maximum details.mcpResult JSON bytes kept raw; larger results are summarized and spilled to disk. Defaults to 16384 (16 KiB). */\n  detailsMaxBytes?: number;\n}\n\n// Settings\nexport interface McpSettings {\n  toolPrefix?: \"server\" | \"none\" | \"short\";\n  idleTimeout?: number; // minutes, default 10, 0 to disable\n  requestTimeoutMs?: number; // milliseconds, overrides the SDK request timeout when > 0\n  directTools?: boolean;\n  disableProxyTool?: boolean;\n  autoAuth?: boolean;\n  sampling?: boolean;\n  samplingAutoApprove?: boolean;\n  elicitation?: boolean;\n  /**\n   * Guard oversized MCP tool/resource output before it is returned to the model.\n   * Defaults to true (50 KiB / 2,000 lines inline text, 16 KiB details.mcpResult).\n   * Set to false to restore raw MCP output behavior, or pass an object to tune\n   * the limits. Env kill switch: MCP_OUTPUT_GUARD=0.\n   */\n  outputGuard?: boolean | McpOutputGuardSettings;\n  /**\n   * Message returned in tool results when a server needs (re-)authentication.\n   * \"${server}\" is substituted with the server name. Defaults to a TUI\n   * instruction when unset.\n   */\n  authRequiredMessage?: string;\n}\n\n// Root config\nexport interface McpConfig {\n  mcpServers: Record<string, ServerEntry>;\n  imports?: ImportKind[];\n  settings?: McpSettings;\n}\n\n// Alias for clarity\nexport type ServerDefinition = ServerEntry;\n\nexport interface ToolMetadata {\n  name: string;           // Prefixed tool name (e.g., \"xcodebuild_list_sims\")\n  originalName: string;   // Original MCP tool name (e.g., \"list_sims\")\n  description: string;\n  resourceUri?: string;   // For resource tools: the URI to read\n  uiResourceUri?: string; // For app-enabled tools: the UI resource URI\n  inputSchema?: unknown;  // JSON Schema for parameters (stored for describe/errors)\n  uiStreamMode?: UiStreamMode;\n}\n\nexport interface DirectToolSpec {\n  serverName: string;\n  originalName: string;\n  prefixedName: string;\n  description: string;\n  inputSchema?: unknown;\n  resourceUri?: string;\n  uiResourceUri?: string;\n  uiStreamMode?: UiStreamMode;\n}\n\nexport interface ServerProvenance {\n  path: string;\n  kind: \"user\" | \"project\" | \"import\";\n  importKind?: string;\n}\n\nexport interface McpAuthResult {\n  ok: boolean;\n  message?: string;\n}\n\nexport interface McpPanelCallbacks {\n  reconnect: (serverName: string) => Promise<boolean>;\n  canAuthenticate: (serverName: string) => boolean;\n  authenticate: (serverName: string) => Promise<McpAuthResult>;\n  getConnectionStatus: (serverName: string) => \"connected\" | \"idle\" | \"failed\" | \"needs-auth\";\n  refreshCacheAfterReconnect: (serverName: string) => import(\"./metadata-cache.ts\").ServerCacheEntry | null;\n}\n\nexport interface McpPanelResult {\n  changes: Map<string, true | string[] | false>;\n  cancelled: boolean;\n}\n\n/**\n * Get server prefix based on tool prefix mode.\n */\nexport function getServerPrefix(\n  serverName: string,\n  mode: \"server\" | \"none\" | \"short\"\n): string {\n  if (mode === \"none\") return \"\";\n  if (mode === \"short\") {\n    let short = serverName.replace(/-?mcp$/i, \"\").replace(/-/g, \"_\");\n    if (!short) short = \"mcp\";\n    return short;\n  }\n  return serverName.replace(/-/g, \"_\");\n}\n\n/**\n * Format a tool name with server prefix.\n */\nexport function formatToolName(\n  toolName: string,\n  serverName: string,\n  prefix: \"server\" | \"none\" | \"short\"\n): string {\n  const p = getServerPrefix(serverName, prefix);\n  return p ? `${p}_${toolName}` : toolName;\n}\n\nfunction normalizeToolName(value: string): string {\n  return value.replace(/-/g, \"_\");\n}\n\nexport function isToolExcluded(\n  toolName: string,\n  serverName: string,\n  prefix: \"server\" | \"none\" | \"short\",\n  excludeTools?: unknown\n): boolean {\n  if (!Array.isArray(excludeTools) || excludeTools.length === 0) return false;\n\n  const candidates = new Set<string>([\n    normalizeToolName(toolName),\n    normalizeToolName(formatToolName(toolName, serverName, prefix)),\n    normalizeToolName(formatToolName(toolName, serverName, \"server\")),\n    normalizeToolName(formatToolName(toolName, serverName, \"short\")),\n  ]);\n\n  for (const excluded of excludeTools) {\n    if (typeof excluded !== \"string\") continue;\n    if (candidates.has(normalizeToolName(excluded))) {\n      return true;\n    }\n  }\n\n  return false;\n}\n"]}

package/dist/builtin-extensions/pi-mcp-adapter/types.js

@@ -0,0 +1,94 @@
+// Re-export stream types from the shared lightweight module.
+// This allows the example package to import stream schemas without pulling the full types.ts dependency graph.
+export { UI_STREAM_HOST_CONTEXT_KEY, UI_STREAM_REQUEST_META_KEY, UI_STREAM_RESULT_PATCH_METHOD, SERVER_STREAM_RESULT_PATCH_METHOD, UI_STREAM_STRUCTURED_CONTENT_KEY, uiStreamModeSchema, visualizationStreamPhaseSchema, visualizationStreamFrameTypeSchema, visualizationStreamStatusSchema, uiStreamHostContextSchema, visualizationStreamEnvelopeSchema, uiStreamCallToolResultSchema, uiStreamResultPatchNotificationSchema, serverStreamResultPatchNotificationSchema, getUiStreamHostContext, getVisualizationStreamEnvelope, } from "./ui-stream-types.js";
+/**
+ * Extract prompt text from either legacy MCP UI message shapes or native AppBridge user messages.
+ */
+export function extractUiPromptText(params) {
+    if (params.type === "prompt" || params.prompt) {
+        const prompt = params.prompt ?? String(params.message ?? "");
+        return prompt || undefined;
+    }
+    if (params.role === "user" && Array.isArray(params.content)) {
+        const text = params.content
+            .map((block) => (block && typeof block === "object" && "text" in block ? String(block.text ?? "") : ""))
+            .filter(Boolean)
+            .join("\n\n");
+        return text || undefined;
+    }
+    return undefined;
+}
+/**
+ * Parse a canonical named UI handoff encoded as `intent\n{json}`.
+ */
+export function parseUiPromptHandoff(prompt) {
+    const newlineIndex = prompt.indexOf("\n");
+    if (newlineIndex <= 0) {
+        return undefined;
+    }
+    const intent = prompt.slice(0, newlineIndex).trim();
+    const payloadText = prompt.slice(newlineIndex + 1).trim();
+    if (!intent || !payloadText) {
+        return undefined;
+    }
+    if (!/^[A-Za-z][A-Za-z0-9_-]*$/.test(intent)) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(payloadText);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            return undefined;
+        }
+        return {
+            intent,
+            params: parsed,
+            raw: prompt,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Get server prefix based on tool prefix mode.
+ */
+export function getServerPrefix(serverName, mode) {
+    if (mode === "none")
+        return "";
+    if (mode === "short") {
+        let short = serverName.replace(/-?mcp$/i, "").replace(/-/g, "_");
+        if (!short)
+            short = "mcp";
+        return short;
+    }
+    return serverName.replace(/-/g, "_");
+}
+/**
+ * Format a tool name with server prefix.
+ */
+export function formatToolName(toolName, serverName, prefix) {
+    const p = getServerPrefix(serverName, prefix);
+    return p ? `${p}_${toolName}` : toolName;
+}
+function normalizeToolName(value) {
+    return value.replace(/-/g, "_");
+}
+export function isToolExcluded(toolName, serverName, prefix, excludeTools) {
+    if (!Array.isArray(excludeTools) || excludeTools.length === 0)
+        return false;
+    const candidates = new Set([
+        normalizeToolName(toolName),
+        normalizeToolName(formatToolName(toolName, serverName, prefix)),
+        normalizeToolName(formatToolName(toolName, serverName, "server")),
+        normalizeToolName(formatToolName(toolName, serverName, "short")),
+    ]);
+    for (const excluded of excludeTools) {
+        if (typeof excluded !== "string")
+            continue;
+        if (candidates.has(normalizeToolName(excluded))) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=types.js.map

package/dist/builtin-extensions/pi-mcp-adapter/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-mcp-adapter/types.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n// types.ts - Core type definitions\nimport type { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport type { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport type { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { TextContent, ImageContent } from \"@earendil-works/pi-ai\";\nimport type { UiStreamMode } from \"./ui-stream-types.ts\";\n\n// Transport type (stdio + HTTP)\nexport type Transport = \n  | StdioClientTransport \n  | SSEClientTransport \n  | StreamableHTTPClientTransport;\n\n// Import sources for config\nexport type ImportKind = \n  | \"cursor\" \n  | \"claude-code\" \n  | \"claude-desktop\" \n  | \"codex\" \n  | \"windsurf\" \n  | \"vscode\";\n\n// Tool definition from MCP server\nexport interface McpTool {\n  name: string;\n  title?: string;\n  description?: string;\n  inputSchema?: unknown; // JSON Schema\n  _meta?: Record<string, unknown>;\n}\n\n// Resource definition from MCP server\nexport interface McpResource {\n  uri: string;\n  name: string;\n  description?: string;\n  mimeType?: string;\n  _meta?: Record<string, unknown>;\n}\n\nexport interface UiResourceMeta {\n  csp?: UiResourceCsp;\n  permissions?: UiResourcePermissions;\n  domain?: string;\n  prefersBorder?: boolean;\n}\n\nexport interface UiResourceContent {\n  uri: string;\n  html: string;\n  mimeType?: string;\n  meta: UiResourceMeta;\n}\n\nexport interface UiProxyRequestBody<TParams> {\n  token: string;\n  params: TParams;\n}\n\nexport interface UiProxyResult<T = Record<string, unknown>> {\n  ok: boolean;\n  result?: T;\n  error?: string;\n}\n\nexport interface UiResourceCsp {\n  connectDomains?: string[];\n  scriptDomains?: string[];\n  styleDomains?: string[];\n  fontDomains?: string[];\n  imgDomains?: string[];\n  mediaDomains?: string[];\n  frameDomains?: string[];\n  workerDomains?: string[];\n  baseUriDomains?: string[];\n}\n\nexport interface UiResourcePermissions {\n  camera?: {};\n  microphone?: {};\n  geolocation?: {};\n  clipboardWrite?: {};\n}\n\nexport interface UiToolInfo {\n  id?: string | number;\n  tool: {\n    name: string;\n    description?: string;\n    inputSchema?: unknown;\n  };\n}\n\nexport interface UiHostContext {\n  toolInfo?: UiToolInfo;\n  theme?: \"light\" | \"dark\";\n  styles?: Record<string, unknown>;\n  displayMode?: UiDisplayMode;\n  availableDisplayModes?: UiDisplayMode[];\n  containerDimensions?: {\n    width?: number;\n    maxWidth?: number;\n    height?: number;\n    maxHeight?: number;\n  };\n  [key: string]: unknown;\n}\n\nexport type UiDisplayMode = \"inline\" | \"fullscreen\" | \"pip\";\n\n// Re-export stream types from the shared lightweight module.\n// This allows the example package to import stream schemas without pulling the full types.ts dependency graph.\nexport {\n  UI_STREAM_HOST_CONTEXT_KEY,\n  UI_STREAM_REQUEST_META_KEY,\n  UI_STREAM_RESULT_PATCH_METHOD,\n  SERVER_STREAM_RESULT_PATCH_METHOD,\n  UI_STREAM_STRUCTURED_CONTENT_KEY,\n  uiStreamModeSchema,\n  visualizationStreamPhaseSchema,\n  visualizationStreamFrameTypeSchema,\n  visualizationStreamStatusSchema,\n  uiStreamHostContextSchema,\n  visualizationStreamEnvelopeSchema,\n  uiStreamCallToolResultSchema,\n  uiStreamResultPatchNotificationSchema,\n  serverStreamResultPatchNotificationSchema,\n  getUiStreamHostContext,\n  getVisualizationStreamEnvelope,\n  type UiStreamMode,\n  type VisualizationStreamPhase,\n  type VisualizationStreamFrameType,\n  type VisualizationStreamStatus,\n  type UiStreamHostContext,\n  type VisualizationStreamEnvelope,\n  type UiStreamCallToolResult,\n  type UiStreamResultPatchNotification,\n  type ServerStreamResultPatchNotification,\n  type UiStreamSummary,\n} from \"./ui-stream-types.ts\";\n\nexport interface UiMessageParams {\n  role?: string;\n  content?: unknown[];\n  type?: \"prompt\" | \"notify\" | \"intent\" | \"message\";\n  message?: string;\n  prompt?: string;\n  intent?: string;\n  params?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\n/**\n * Extract prompt text from either legacy MCP UI message shapes or native AppBridge user messages.\n */\nexport function extractUiPromptText(params: UiMessageParams): string | undefined {\n  if (params.type === \"prompt\" || params.prompt) {\n    const prompt = params.prompt ?? String(params.message ?? \"\");\n    return prompt || undefined;\n  }\n\n  if (params.role === \"user\" && Array.isArray(params.content)) {\n    const text = params.content\n      .map((block) => (block && typeof block === \"object\" && \"text\" in block ? String((block as { text?: unknown }).text ?? \"\") : \"\"))\n      .filter(Boolean)\n      .join(\"\\n\\n\");\n    return text || undefined;\n  }\n\n  return undefined;\n}\n\n/**\n * Structured UI handoff recovered from a canonical prompt envelope.\n */\nexport interface UiPromptHandoff {\n  intent: string;\n  params: Record<string, unknown>;\n  raw: string;\n}\n\n/**\n * Parse a canonical named UI handoff encoded as `intent\\n{json}`.\n */\nexport function parseUiPromptHandoff(prompt: string): UiPromptHandoff | undefined {\n  const newlineIndex = prompt.indexOf(\"\\n\");\n  if (newlineIndex <= 0) {\n    return undefined;\n  }\n\n  const intent = prompt.slice(0, newlineIndex).trim();\n  const payloadText = prompt.slice(newlineIndex + 1).trim();\n  if (!intent || !payloadText) {\n    return undefined;\n  }\n\n  if (!/^[A-Za-z][A-Za-z0-9_-]*$/.test(intent)) {\n    return undefined;\n  }\n\n  try {\n    const parsed = JSON.parse(payloadText);\n    if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      return undefined;\n    }\n    return {\n      intent,\n      params: parsed as Record<string, unknown>,\n      raw: prompt,\n    };\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Accumulated messages from a UI session.\n * Collected during the session and available when it ends.\n */\nexport interface UiSessionMessages {\n  prompts: string[];\n  notifications: string[];\n  intents: Array<{ intent: string; params?: Record<string, unknown> }>;\n}\n\nexport interface UiModelContextParams {\n  content?: unknown[];\n  structuredContent?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\nexport interface UiOpenLinkResult {\n  isError?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface UiDisplayModeRequest {\n  mode?: UiDisplayMode;\n}\n\nexport interface UiDisplayModeResult {\n  mode: UiDisplayMode;\n  [key: string]: unknown;\n}\n\n// Content types from MCP\nexport interface McpContent {\n  type: \"text\" | \"image\" | \"audio\" | \"resource\" | \"resource_link\";\n  text?: string;\n  data?: string;\n  mimeType?: string;\n  resource?: {\n    uri: string;\n    text?: string;\n    blob?: string;\n  };\n  uri?: string;\n  name?: string;\n  description?: string;\n}\n\n// Pi content block type\nexport type ContentBlock = TextContent | ImageContent;\n\n// OAuth configuration (SDK handles auto-discovery and dynamic registration)\nexport interface OAuthConfig {\n  /** OAuth grant type (defaults to authorization_code) */\n  grantType?: \"authorization_code\" | \"client_credentials\";\n  /** Pre-registered client ID (optional, dynamic registration used if not provided) */\n  clientId?: string;\n  /** Client secret for confidential clients */\n  clientSecret?: string;\n  /** Requested OAuth scopes */\n  scope?: string;\n  /** Exact authorization-code redirect URI for pre-registered clients */\n  redirectUri?: string;\n  /** Client display name for dynamic registration */\n  clientName?: string;\n  /** Client homepage URI for dynamic registration */\n  clientUri?: string;\n}\n\n// Server configuration\nexport interface ServerEntry {\n  command?: string;\n  args?: string[];\n  env?: Record<string, string>;\n  cwd?: string;\n  // HTTP fields\n  url?: string;\n  headers?: Record<string, string>;\n  /** \n   * Authentication type:\n   * - 'oauth' - Use OAuth 2.1 (auto-discovers endpoints, supports dynamic client registration)\n   * - 'bearer' - Use static Bearer token\n   * - false - Disable authentication\n   * If not specified and url is present, OAuth will be auto-detected unless custom headers are configured\n   */\n  auth?: \"oauth\" | \"bearer\" | false;\n  bearerToken?: string;\n  bearerTokenEnv?: string;\n  /** \n   * OAuth configuration (optional).\n   * If not provided, the SDK will attempt dynamic client registration.\n   * Set to false to explicitly disable OAuth for this server.\n   */\n  oauth?: OAuthConfig | false;\n  lifecycle?: \"keep-alive\" | \"lazy\" | \"eager\";\n  idleTimeout?: number; // minutes, overrides global setting\n  requestTimeoutMs?: number; // milliseconds, overrides global request timeout when > 0\n  // Resource handling\n  exposeResources?: boolean;\n  // Direct tool registration\n  directTools?: boolean | string[];\n  // Exclude specific MCP tools/resources by original or prefixed name\n  excludeTools?: string[];\n  // Debug\n  debug?: boolean;  // Show server stderr (default: false)\n}\n\n// Output guard tuning (settings.outputGuard object form)\nexport interface McpOutputGuardSettings {\n  /** Maximum inline MCP text output bytes before truncation/spill-to-disk. Defaults to 51200 (50 KiB). */\n  maxBytes?: number;\n  /** Maximum inline MCP text output lines before truncation/spill-to-disk. Defaults to 2000. */\n  maxLines?: number;\n  /** Maximum details.mcpResult JSON bytes kept raw; larger results are summarized and spilled to disk. Defaults to 16384 (16 KiB). */\n  detailsMaxBytes?: number;\n}\n\n// Settings\nexport interface McpSettings {\n  toolPrefix?: \"server\" | \"none\" | \"short\";\n  idleTimeout?: number; // minutes, default 10, 0 to disable\n  requestTimeoutMs?: number; // milliseconds, overrides the SDK request timeout when > 0\n  directTools?: boolean;\n  disableProxyTool?: boolean;\n  autoAuth?: boolean;\n  sampling?: boolean;\n  samplingAutoApprove?: boolean;\n  elicitation?: boolean;\n  /**\n   * Guard oversized MCP tool/resource output before it is returned to the model.\n   * Defaults to true (50 KiB / 2,000 lines inline text, 16 KiB details.mcpResult).\n   * Set to false to restore raw MCP output behavior, or pass an object to tune\n   * the limits. Env kill switch: MCP_OUTPUT_GUARD=0.\n   */\n  outputGuard?: boolean | McpOutputGuardSettings;\n  /**\n   * Message returned in tool results when a server needs (re-)authentication.\n   * \"${server}\" is substituted with the server name. Defaults to a TUI\n   * instruction when unset.\n   */\n  authRequiredMessage?: string;\n}\n\n// Root config\nexport interface McpConfig {\n  mcpServers: Record<string, ServerEntry>;\n  imports?: ImportKind[];\n  settings?: McpSettings;\n}\n\n// Alias for clarity\nexport type ServerDefinition = ServerEntry;\n\nexport interface ToolMetadata {\n  name: string;           // Prefixed tool name (e.g., \"xcodebuild_list_sims\")\n  originalName: string;   // Original MCP tool name (e.g., \"list_sims\")\n  description: string;\n  resourceUri?: string;   // For resource tools: the URI to read\n  uiResourceUri?: string; // For app-enabled tools: the UI resource URI\n  inputSchema?: unknown;  // JSON Schema for parameters (stored for describe/errors)\n  uiStreamMode?: UiStreamMode;\n}\n\nexport interface DirectToolSpec {\n  serverName: string;\n  originalName: string;\n  prefixedName: string;\n  description: string;\n  inputSchema?: unknown;\n  resourceUri?: string;\n  uiResourceUri?: string;\n  uiStreamMode?: UiStreamMode;\n}\n\nexport interface ServerProvenance {\n  path: string;\n  kind: \"user\" | \"project\" | \"import\";\n  importKind?: string;\n}\n\nexport interface McpAuthResult {\n  ok: boolean;\n  message?: string;\n}\n\nexport interface McpPanelCallbacks {\n  reconnect: (serverName: string) => Promise<boolean>;\n  canAuthenticate: (serverName: string) => boolean;\n  authenticate: (serverName: string) => Promise<McpAuthResult>;\n  getConnectionStatus: (serverName: string) => \"connected\" | \"idle\" | \"failed\" | \"needs-auth\";\n  refreshCacheAfterReconnect: (serverName: string) => import(\"./metadata-cache.ts\").ServerCacheEntry | null;\n}\n\nexport interface McpPanelResult {\n  changes: Map<string, true | string[] | false>;\n  cancelled: boolean;\n}\n\n/**\n * Get server prefix based on tool prefix mode.\n */\nexport function getServerPrefix(\n  serverName: string,\n  mode: \"server\" | \"none\" | \"short\"\n): string {\n  if (mode === \"none\") return \"\";\n  if (mode === \"short\") {\n    let short = serverName.replace(/-?mcp$/i, \"\").replace(/-/g, \"_\");\n    if (!short) short = \"mcp\";\n    return short;\n  }\n  return serverName.replace(/-/g, \"_\");\n}\n\n/**\n * Format a tool name with server prefix.\n */\nexport function formatToolName(\n  toolName: string,\n  serverName: string,\n  prefix: \"server\" | \"none\" | \"short\"\n): string {\n  const p = getServerPrefix(serverName, prefix);\n  return p ? `${p}_${toolName}` : toolName;\n}\n\nfunction normalizeToolName(value: string): string {\n  return value.replace(/-/g, \"_\");\n}\n\nexport function isToolExcluded(\n  toolName: string,\n  serverName: string,\n  prefix: \"server\" | \"none\" | \"short\",\n  excludeTools?: unknown\n): boolean {\n  if (!Array.isArray(excludeTools) || excludeTools.length === 0) return false;\n\n  const candidates = new Set<string>([\n    normalizeToolName(toolName),\n    normalizeToolName(formatToolName(toolName, serverName, prefix)),\n    normalizeToolName(formatToolName(toolName, serverName, \"server\")),\n    normalizeToolName(formatToolName(toolName, serverName, \"short\")),\n  ]);\n\n  for (const excluded of excludeTools) {\n    if (typeof excluded !== \"string\") continue;\n    if (candidates.has(normalizeToolName(excluded))) {\n      return true;\n    }\n  }\n\n  return false;\n}\n"]}

package/dist/builtin-extensions/pi-mcp-adapter/ui-resource-handler.d.ts

@@ -0,0 +1,10 @@
+import type { McpServerManager } from "./server-manager.ts";
+import type { UiResourceContent } from "./types.ts";
+export declare class UiResourceHandler {
+    private manager;
+    private log;
+    constructor(manager: McpServerManager);
+    readUiResource(serverName: string, uri: string): Promise<UiResourceContent>;
+    private getListResourceMeta;
+}
+//# sourceMappingURL=ui-resource-handler.d.ts.map

package/dist/builtin-extensions/pi-mcp-adapter/ui-resource-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-resource-handler.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-mcp-adapter/ui-resource-handler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,YAAY,CAAC;AAUpE,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,GAAG,CAAoD;IAE/D,YAAoB,OAAO,EAAE,gBAAgB,EAAI;IAE3C,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2DhF;IAED,OAAO,CAAC,mBAAmB;CAO5B","sourcesContent":["// @ts-nocheck\nimport { RESOURCE_MIME_TYPE } from \"@modelcontextprotocol/ext-apps/app-bridge\";\nimport { UrlElicitationRequiredError, type ReadResourceResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { ResourceFetchError, ResourceParseError } from \"./errors.ts\";\nimport { logger } from \"./logger.ts\";\nimport type { McpServerManager } from \"./server-manager.ts\";\nimport type { UiResourceContent, UiResourceMeta } from \"./types.ts\";\n\ninterface ResourceContentRecord {\n  uri?: string;\n  mimeType?: string;\n  text?: string;\n  blob?: string;\n  _meta?: Record<string, unknown>;\n}\n\nexport class UiResourceHandler {\n  private log = logger.child({ component: \"UiResourceHandler\" });\n\n  constructor(private manager: McpServerManager) {}\n\n  async readUiResource(serverName: string, uri: string): Promise<UiResourceContent> {\n    const log = this.log.child({ server: serverName, uri });\n\n    if (!uri.startsWith(\"ui://\")) {\n      throw new ResourceParseError(uri, \"URI must start with ui://\", { server: serverName });\n    }\n\n    log.debug(\"Fetching UI resource\");\n\n    let result: ReadResourceResult;\n    try {\n      result = await this.manager.readResource(serverName, uri);\n    } catch (error) {\n      if (error instanceof UrlElicitationRequiredError) throw error;\n      const message = error instanceof Error ? error.message : String(error);\n      log.error(\"Failed to read resource\", error instanceof Error ? error : undefined);\n      throw new ResourceFetchError(uri, message, {\n        server: serverName,\n        cause: error instanceof Error ? error : undefined,\n      });\n    }\n\n    const content = selectContent(result, uri);\n    const mimeType = content.mimeType;\n\n    if (mimeType && !isHtmlMimeType(mimeType)) {\n      log.warn(\"Unsupported MIME type\", { mimeType });\n      throw new ResourceParseError(\n        uri,\n        `unsupported MIME type \"${mimeType}\" (expected text/html or ${RESOURCE_MIME_TYPE})`,\n        { server: serverName, mimeType }\n      );\n    }\n\n    const html = toHtml(content);\n    if (!html.trim()) {\n      log.warn(\"Resource content is empty\");\n      throw new ResourceParseError(uri, \"content is empty\", { server: serverName });\n    }\n\n    const contentMeta = extractUiMeta(content._meta);\n    const listMeta = extractUiMeta(this.getListResourceMeta(serverName, uri));\n\n    log.debug(\"Resource loaded successfully\", { \n      contentLength: html.length,\n      hasCsp: !!contentMeta.csp || !!listMeta.csp,\n    });\n\n    return {\n      uri: content.uri ?? uri,\n      html,\n      mimeType: mimeType ?? RESOURCE_MIME_TYPE,\n      meta: {\n        csp: contentMeta.csp ?? listMeta.csp,\n        permissions: contentMeta.permissions ?? listMeta.permissions,\n        domain: contentMeta.domain ?? listMeta.domain,\n        prefersBorder: contentMeta.prefersBorder ?? listMeta.prefersBorder,\n      },\n    };\n  }\n\n  private getListResourceMeta(serverName: string, uri: string): Record<string, unknown> | undefined {\n    const connection = this.manager.getConnection(serverName);\n    if (!connection?.resources?.length) return undefined;\n    const resource = connection.resources.find((entry) => entry.uri === uri);\n    if (!resource || !resource._meta || typeof resource._meta !== \"object\") return undefined;\n    return resource._meta;\n  }\n}\n\nfunction selectContent(result: ReadResourceResult, preferredUri: string): ResourceContentRecord {\n  const contents = (result.contents ?? []) as ResourceContentRecord[];\n  if (contents.length === 0) {\n    throw new Error(`No contents returned for UI resource: ${preferredUri}`);\n  }\n\n  const byUri = contents.find((content) => content.uri === preferredUri);\n  if (byUri) return byUri;\n\n  const byHtmlMime = contents.find(\n    (content) => content.mimeType && isHtmlMimeType(content.mimeType)\n  );\n  if (byHtmlMime) return byHtmlMime;\n\n  return contents[0];\n}\n\nfunction isHtmlMimeType(mimeType: string): boolean {\n  const normalized = mimeType.toLowerCase();\n  return normalized.startsWith(\"text/html\") || normalized === RESOURCE_MIME_TYPE.toLowerCase();\n}\n\nfunction toHtml(content: ResourceContentRecord): string {\n  if (typeof content.text === \"string\") {\n    return content.text;\n  }\n\n  if (typeof content.blob === \"string\") {\n    return Buffer.from(content.blob, \"base64\").toString(\"utf-8\");\n  }\n\n  throw new Error(`UI resource ${content.uri ?? \"(unknown)\"} did not include text or blob content`);\n}\n\nfunction extractUiMeta(meta: Record<string, unknown> | undefined): UiResourceMeta {\n  if (!meta || typeof meta !== \"object\") return {};\n  const ui = meta.ui as Record<string, unknown> | undefined;\n  if (!ui || typeof ui !== \"object\") return {};\n\n  const out: UiResourceMeta = {};\n\n  if (ui.csp && typeof ui.csp === \"object\") {\n    out.csp = ui.csp as UiResourceMeta[\"csp\"];\n  }\n  if (ui.permissions && typeof ui.permissions === \"object\") {\n    out.permissions = ui.permissions as UiResourceMeta[\"permissions\"];\n  }\n  if (typeof ui.domain === \"string\") {\n    out.domain = ui.domain;\n  }\n  if (typeof ui.prefersBorder === \"boolean\") {\n    out.prefersBorder = ui.prefersBorder;\n  }\n\n  return out;\n}\n"]}

package/dist/builtin-extensions/pi-mcp-adapter/ui-resource-handler.js

@@ -0,0 +1,118 @@
+// @ts-nocheck
+import { RESOURCE_MIME_TYPE } from "@modelcontextprotocol/ext-apps/app-bridge";
+import { UrlElicitationRequiredError } from "@modelcontextprotocol/sdk/types.js";
+import { ResourceFetchError, ResourceParseError } from "./errors.js";
+import { logger } from "./logger.js";
+export class UiResourceHandler {
+    manager;
+    log = logger.child({ component: "UiResourceHandler" });
+    constructor(manager) {
+        this.manager = manager;
+    }
+    async readUiResource(serverName, uri) {
+        const log = this.log.child({ server: serverName, uri });
+        if (!uri.startsWith("ui://")) {
+            throw new ResourceParseError(uri, "URI must start with ui://", { server: serverName });
+        }
+        log.debug("Fetching UI resource");
+        let result;
+        try {
+            result = await this.manager.readResource(serverName, uri);
+        }
+        catch (error) {
+            if (error instanceof UrlElicitationRequiredError)
+                throw error;
+            const message = error instanceof Error ? error.message : String(error);
+            log.error("Failed to read resource", error instanceof Error ? error : undefined);
+            throw new ResourceFetchError(uri, message, {
+                server: serverName,
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+        const content = selectContent(result, uri);
+        const mimeType = content.mimeType;
+        if (mimeType && !isHtmlMimeType(mimeType)) {
+            log.warn("Unsupported MIME type", { mimeType });
+            throw new ResourceParseError(uri, `unsupported MIME type "${mimeType}" (expected text/html or ${RESOURCE_MIME_TYPE})`, { server: serverName, mimeType });
+        }
+        const html = toHtml(content);
+        if (!html.trim()) {
+            log.warn("Resource content is empty");
+            throw new ResourceParseError(uri, "content is empty", { server: serverName });
+        }
+        const contentMeta = extractUiMeta(content._meta);
+        const listMeta = extractUiMeta(this.getListResourceMeta(serverName, uri));
+        log.debug("Resource loaded successfully", {
+            contentLength: html.length,
+            hasCsp: !!contentMeta.csp || !!listMeta.csp,
+        });
+        return {
+            uri: content.uri ?? uri,
+            html,
+            mimeType: mimeType ?? RESOURCE_MIME_TYPE,
+            meta: {
+                csp: contentMeta.csp ?? listMeta.csp,
+                permissions: contentMeta.permissions ?? listMeta.permissions,
+                domain: contentMeta.domain ?? listMeta.domain,
+                prefersBorder: contentMeta.prefersBorder ?? listMeta.prefersBorder,
+            },
+        };
+    }
+    getListResourceMeta(serverName, uri) {
+        const connection = this.manager.getConnection(serverName);
+        if (!connection?.resources?.length)
+            return undefined;
+        const resource = connection.resources.find((entry) => entry.uri === uri);
+        if (!resource || !resource._meta || typeof resource._meta !== "object")
+            return undefined;
+        return resource._meta;
+    }
+}
+function selectContent(result, preferredUri) {
+    const contents = (result.contents ?? []);
+    if (contents.length === 0) {
+        throw new Error(`No contents returned for UI resource: ${preferredUri}`);
+    }
+    const byUri = contents.find((content) => content.uri === preferredUri);
+    if (byUri)
+        return byUri;
+    const byHtmlMime = contents.find((content) => content.mimeType && isHtmlMimeType(content.mimeType));
+    if (byHtmlMime)
+        return byHtmlMime;
+    return contents[0];
+}
+function isHtmlMimeType(mimeType) {
+    const normalized = mimeType.toLowerCase();
+    return normalized.startsWith("text/html") || normalized === RESOURCE_MIME_TYPE.toLowerCase();
+}
+function toHtml(content) {
+    if (typeof content.text === "string") {
+        return content.text;
+    }
+    if (typeof content.blob === "string") {
+        return Buffer.from(content.blob, "base64").toString("utf-8");
+    }
+    throw new Error(`UI resource ${content.uri ?? "(unknown)"} did not include text or blob content`);
+}
+function extractUiMeta(meta) {
+    if (!meta || typeof meta !== "object")
+        return {};
+    const ui = meta.ui;
+    if (!ui || typeof ui !== "object")
+        return {};
+    const out = {};
+    if (ui.csp && typeof ui.csp === "object") {
+        out.csp = ui.csp;
+    }
+    if (ui.permissions && typeof ui.permissions === "object") {
+        out.permissions = ui.permissions;
+    }
+    if (typeof ui.domain === "string") {
+        out.domain = ui.domain;
+    }
+    if (typeof ui.prefersBorder === "boolean") {
+        out.prefersBorder = ui.prefersBorder;
+    }
+    return out;
+}
+//# sourceMappingURL=ui-resource-handler.js.map

package/dist/builtin-extensions/pi-mcp-adapter/ui-resource-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-resource-handler.js","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-mcp-adapter/ui-resource-handler.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport { RESOURCE_MIME_TYPE } from \"@modelcontextprotocol/ext-apps/app-bridge\";\nimport { UrlElicitationRequiredError, type ReadResourceResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { ResourceFetchError, ResourceParseError } from \"./errors.ts\";\nimport { logger } from \"./logger.ts\";\nimport type { McpServerManager } from \"./server-manager.ts\";\nimport type { UiResourceContent, UiResourceMeta } from \"./types.ts\";\n\ninterface ResourceContentRecord {\n  uri?: string;\n  mimeType?: string;\n  text?: string;\n  blob?: string;\n  _meta?: Record<string, unknown>;\n}\n\nexport class UiResourceHandler {\n  private log = logger.child({ component: \"UiResourceHandler\" });\n\n  constructor(private manager: McpServerManager) {}\n\n  async readUiResource(serverName: string, uri: string): Promise<UiResourceContent> {\n    const log = this.log.child({ server: serverName, uri });\n\n    if (!uri.startsWith(\"ui://\")) {\n      throw new ResourceParseError(uri, \"URI must start with ui://\", { server: serverName });\n    }\n\n    log.debug(\"Fetching UI resource\");\n\n    let result: ReadResourceResult;\n    try {\n      result = await this.manager.readResource(serverName, uri);\n    } catch (error) {\n      if (error instanceof UrlElicitationRequiredError) throw error;\n      const message = error instanceof Error ? error.message : String(error);\n      log.error(\"Failed to read resource\", error instanceof Error ? error : undefined);\n      throw new ResourceFetchError(uri, message, {\n        server: serverName,\n        cause: error instanceof Error ? error : undefined,\n      });\n    }\n\n    const content = selectContent(result, uri);\n    const mimeType = content.mimeType;\n\n    if (mimeType && !isHtmlMimeType(mimeType)) {\n      log.warn(\"Unsupported MIME type\", { mimeType });\n      throw new ResourceParseError(\n        uri,\n        `unsupported MIME type \"${mimeType}\" (expected text/html or ${RESOURCE_MIME_TYPE})`,\n        { server: serverName, mimeType }\n      );\n    }\n\n    const html = toHtml(content);\n    if (!html.trim()) {\n      log.warn(\"Resource content is empty\");\n      throw new ResourceParseError(uri, \"content is empty\", { server: serverName });\n    }\n\n    const contentMeta = extractUiMeta(content._meta);\n    const listMeta = extractUiMeta(this.getListResourceMeta(serverName, uri));\n\n    log.debug(\"Resource loaded successfully\", { \n      contentLength: html.length,\n      hasCsp: !!contentMeta.csp || !!listMeta.csp,\n    });\n\n    return {\n      uri: content.uri ?? uri,\n      html,\n      mimeType: mimeType ?? RESOURCE_MIME_TYPE,\n      meta: {\n        csp: contentMeta.csp ?? listMeta.csp,\n        permissions: contentMeta.permissions ?? listMeta.permissions,\n        domain: contentMeta.domain ?? listMeta.domain,\n        prefersBorder: contentMeta.prefersBorder ?? listMeta.prefersBorder,\n      },\n    };\n  }\n\n  private getListResourceMeta(serverName: string, uri: string): Record<string, unknown> | undefined {\n    const connection = this.manager.getConnection(serverName);\n    if (!connection?.resources?.length) return undefined;\n    const resource = connection.resources.find((entry) => entry.uri === uri);\n    if (!resource || !resource._meta || typeof resource._meta !== \"object\") return undefined;\n    return resource._meta;\n  }\n}\n\nfunction selectContent(result: ReadResourceResult, preferredUri: string): ResourceContentRecord {\n  const contents = (result.contents ?? []) as ResourceContentRecord[];\n  if (contents.length === 0) {\n    throw new Error(`No contents returned for UI resource: ${preferredUri}`);\n  }\n\n  const byUri = contents.find((content) => content.uri === preferredUri);\n  if (byUri) return byUri;\n\n  const byHtmlMime = contents.find(\n    (content) => content.mimeType && isHtmlMimeType(content.mimeType)\n  );\n  if (byHtmlMime) return byHtmlMime;\n\n  return contents[0];\n}\n\nfunction isHtmlMimeType(mimeType: string): boolean {\n  const normalized = mimeType.toLowerCase();\n  return normalized.startsWith(\"text/html\") || normalized === RESOURCE_MIME_TYPE.toLowerCase();\n}\n\nfunction toHtml(content: ResourceContentRecord): string {\n  if (typeof content.text === \"string\") {\n    return content.text;\n  }\n\n  if (typeof content.blob === \"string\") {\n    return Buffer.from(content.blob, \"base64\").toString(\"utf-8\");\n  }\n\n  throw new Error(`UI resource ${content.uri ?? \"(unknown)\"} did not include text or blob content`);\n}\n\nfunction extractUiMeta(meta: Record<string, unknown> | undefined): UiResourceMeta {\n  if (!meta || typeof meta !== \"object\") return {};\n  const ui = meta.ui as Record<string, unknown> | undefined;\n  if (!ui || typeof ui !== \"object\") return {};\n\n  const out: UiResourceMeta = {};\n\n  if (ui.csp && typeof ui.csp === \"object\") {\n    out.csp = ui.csp as UiResourceMeta[\"csp\"];\n  }\n  if (ui.permissions && typeof ui.permissions === \"object\") {\n    out.permissions = ui.permissions as UiResourceMeta[\"permissions\"];\n  }\n  if (typeof ui.domain === \"string\") {\n    out.domain = ui.domain;\n  }\n  if (typeof ui.prefersBorder === \"boolean\") {\n    out.prefersBorder = ui.prefersBorder;\n  }\n\n  return out;\n}\n"]}