@portel/photon 1.18.0 → 1.20.0

package/dist/resource-server.d.ts

@@ -0,0 +1,105 @@
+/**
+ * ResourceServer — extracted from PhotonServer
+ *
+ * Encapsulates all MCP resource handling:
+ * - ListResources, ListResourceTemplates, ReadResource handlers
+ * - UI resource URI resolution (ui:// and photon:// schemes)
+ * - Icon image resolution (file → data URI)
+ * - Asset serving (UI HTML, prompts, static resources)
+ * - MCP Apps bridge script generation for Claude Desktop compatibility
+ *
+ * Dependency direction: PhotonServer → ResourceServer (never the reverse).
+ */
+import type { PhotonClassExtended } from '@portel/photon-core';
+/** Minimal interface for executing tool calls — avoids importing PhotonLoader */
+export interface ResourceToolExecutor {
+    executeTool(photon: PhotonClassExtended, toolName: string, args: Record<string, unknown>): Promise<any>;
+    getLoadedPhotons(): Map<string, PhotonClassExtended>;
+}
+/** Minimal options subset needed by ResourceServer */
+export interface ResourceServerOptions {
+    filePath: string;
+    embeddedAssets?: {
+        indexHtml: string;
+        bundleJs: string;
+    };
+    embeddedUITemplates?: Record<string, Record<string, string>>;
+}
+export declare class ResourceServer {
+    private toolExecutor;
+    private options;
+    private static readonly ICON_MIME_TYPES;
+    /** Cached resolved icons per tool name */
+    private resolvedIconsCache;
+    constructor(toolExecutor: ResourceToolExecutor, options: ResourceServerOptions);
+    /**
+     * Build UI resource URI based on detected format
+     */
+    buildUIResourceUri(photonName: string, uiId: string): string;
+    /**
+     * Build tool metadata for UI based on detected format
+     */
+    buildUIToolMeta(photonName: string, uiId: string): Record<string, unknown>;
+    /**
+     * Get UI mimeType based on detected format and client capabilities
+     */
+    getUIMimeType(): string;
+    /**
+     * Resolve raw icon image paths to MCP Icon[] format (data URIs).
+     * Results are cached so file I/O only happens once per tool.
+     */
+    resolveIconImages(iconImages: Array<{
+        path: string;
+        sizes?: string;
+        theme?: string;
+    }>): Array<{
+        src: string;
+        mimeType?: string;
+        sizes?: string;
+        theme?: string;
+    }>;
+    /**
+     * Check if a URI is a template (contains {parameters})
+     */
+    isUriTemplate(uri: string): boolean;
+    /**
+     * Match URI pattern with actual URI
+     * Example: github://repos/{owner}/{repo} matches github://repos/foo/bar
+     */
+    private matchUriPattern;
+    /**
+     * Parse parameters from URI based on pattern
+     * Example: pattern="github://repos/{owner}/{repo}", uri="github://repos/foo/bar"
+     * Returns: { owner: "foo", repo: "bar" }
+     */
+    private parseUriParams;
+    handleListResources(mcp: PhotonClassExtended | null): {
+        resources: any[];
+    };
+    handleListResourceTemplates(mcp: PhotonClassExtended | null): {
+        resourceTemplates: any[];
+    };
+    handleReadResource(request: any, mcp: PhotonClassExtended | null): Promise<any>;
+    /**
+     * Handle SEP-1865 ui:// resource read
+     */
+    private handleUIAssetRead;
+    /**
+     * Handle photon:// asset read (Beam format)
+     */
+    private handleAssetRead;
+    /**
+     * Handle static resource read (for both stdio and SSE handlers)
+     */
+    private handleStaticRead;
+    /**
+     * Format static result to MCP resource response
+     */
+    private formatStaticResult;
+    /**
+     * Generate minimal MCP Apps bridge script for Claude Desktop compatibility
+     * This handles the ui/initialize handshake and tool result delivery
+     */
+    generateMcpAppsBridge(mcp: PhotonClassExtended | null): string;
+}
+//# sourceMappingURL=resource-server.d.ts.map

package/dist/resource-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-server.d.ts","sourceRoot":"","sources":["../src/resource-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,WAAW,CACT,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,GAAG,CAAC,CAAC;IAChB,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACtD;AAED,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9D;AAED,qBAAa,cAAc;IAkBvB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO;IAlBjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAQrC;IAEF,0CAA0C;IAC1C,OAAO,CAAC,kBAAkB,CAGtB;gBAGM,YAAY,EAAE,oBAAoB,EAClC,OAAO,EAAE,qBAAqB;IAKxC;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAI5D;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK1E;;OAEG;IACH,aAAa,IAAI,MAAM;IAMvB;;;OAGG;IACH,iBAAiB,CACf,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAClE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAoC5E;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAInC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAMvB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAyBtB,mBAAmB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,GAAG;QAAE,SAAS,EAAE,GAAG,EAAE,CAAA;KAAE;IA2E1E,2BAA2B,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,GAAG;QAAE,iBAAiB,EAAE,GAAG,EAAE,CAAA;KAAE;IAiBpF,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,mBAAmB,GAAG,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;IA2CrF;;OAEG;YACW,iBAAiB;IAgD/B;;OAEG;YACW,eAAe;IA+C7B;;OAEG;YACW,gBAAgB;IAW9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;;OAGG;IACH,qBAAqB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,GAAG,MAAM;CA4W/D"}