@portel/mcp 1.0.0

package/dist/elicit.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Elicit - Cross-platform user input
+ *
+ * Provides a unified API for requesting user input that works across:
+ * - Native OS dialogs (default)
+ * - CLI readline (when in TTY)
+ * - MCP elicitation (when runtime provides handler)
+ */
+import type { ElicitOptions, ElicitResult, PromptHandler, ElicitHandler } from './types.js';
+declare global {
+    var __photon_prompt__: PromptHandler | undefined;
+    var __photon_elicit__: ElicitHandler | undefined;
+}
+export declare function setPromptHandler(handler: PromptHandler | null): void;
+export declare function setElicitHandler(handler: ElicitHandler | null): void;
+export declare function getPromptHandler(): PromptHandler | undefined;
+export declare function getElicitHandler(): ElicitHandler | undefined;
+/**
+ * Simple prompt function
+ */
+export declare function prompt(message: string, defaultValue?: string): Promise<string | null>;
+/**
+ * Confirm dialog - returns true/false
+ */
+export declare function confirm(message: string): Promise<boolean>;
+/**
+ * Full elicit with options
+ */
+export declare function elicit(options: ElicitOptions): Promise<ElicitResult>;
+/**
+ * Elicit using readline (for CLI/terminal)
+ */
+export declare function elicitReadline(options: ElicitOptions): Promise<ElicitResult>;
+/**
+ * Elicit using native OS dialog
+ */
+export declare function elicitNativeDialog(options: ElicitOptions): Promise<ElicitResult>;
+export type { ElicitOptions, ElicitResult, PromptHandler, ElicitHandler };
+//# sourceMappingURL=elicit.d.ts.map

package/dist/elicit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicit.d.ts","sourceRoot":"","sources":["../src/elicit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5F,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,iBAAiB,EAAE,aAAa,GAAG,SAAS,CAAC;IACjD,IAAI,iBAAiB,EAAE,aAAa,GAAG,SAAS,CAAC;CAClD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAEpE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAEpE;AAED,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAED,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAY3F;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAe/D;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAU1E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAgClF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBtF;AA6HD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC"}

package/dist/elicit.js

@@ -0,0 +1,238 @@
+/**
+ * Elicit - Cross-platform user input
+ *
+ * Provides a unified API for requesting user input that works across:
+ * - Native OS dialogs (default)
+ * - CLI readline (when in TTY)
+ * - MCP elicitation (when runtime provides handler)
+ */
+import { exec } from 'child_process';
+import * as os from 'os';
+import * as readline from 'readline';
+export function setPromptHandler(handler) {
+    globalThis.__photon_prompt__ = handler || undefined;
+}
+export function setElicitHandler(handler) {
+    globalThis.__photon_elicit__ = handler || undefined;
+}
+export function getPromptHandler() {
+    return globalThis.__photon_prompt__;
+}
+export function getElicitHandler() {
+    return globalThis.__photon_elicit__;
+}
+/**
+ * Simple prompt function
+ */
+export async function prompt(message, defaultValue) {
+    if (globalThis.__photon_prompt__) {
+        return globalThis.__photon_prompt__(message, defaultValue);
+    }
+    const result = await elicitNativeDialog({
+        prompt: message,
+        defaultValue,
+        type: 'text',
+    });
+    return result.success ? (result.value ?? null) : null;
+}
+/**
+ * Confirm dialog - returns true/false
+ */
+export async function confirm(message) {
+    if (globalThis.__photon_elicit__) {
+        const result = await globalThis.__photon_elicit__({
+            prompt: message,
+            type: 'confirm',
+        });
+        return result.confirmed ?? false;
+    }
+    const result = await elicitNativeDialog({
+        prompt: message,
+        type: 'confirm',
+    });
+    return result.confirmed ?? false;
+}
+/**
+ * Full elicit with options
+ */
+export async function elicit(options) {
+    if (globalThis.__photon_elicit__) {
+        return globalThis.__photon_elicit__(options);
+    }
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+        return elicitReadline(options);
+    }
+    return elicitNativeDialog(options);
+}
+/**
+ * Elicit using readline (for CLI/terminal)
+ */
+export async function elicitReadline(options) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        const promptText = options.defaultValue
+            ? `${options.prompt} [${options.defaultValue}]: `
+            : `${options.prompt}: `;
+        if (options.type === 'confirm') {
+            rl.question(`${options.prompt} (y/n): `, (answer) => {
+                rl.close();
+                const confirmed = answer.toLowerCase().startsWith('y');
+                resolve({ success: true, confirmed, value: confirmed ? 'yes' : 'no' });
+            });
+        }
+        else {
+            rl.question(promptText, (answer) => {
+                rl.close();
+                const value = answer || options.defaultValue || '';
+                resolve({ success: true, value });
+            });
+        }
+        if (options.timeout && options.timeout > 0) {
+            setTimeout(() => {
+                rl.close();
+                resolve({ success: false, error: 'Input timeout' });
+            }, options.timeout);
+        }
+    });
+}
+/**
+ * Elicit using native OS dialog
+ */
+export async function elicitNativeDialog(options) {
+    const platform = os.platform();
+    try {
+        switch (platform) {
+            case 'darwin':
+                return elicitMacOS(options);
+            case 'win32':
+                return elicitWindows(options);
+            case 'linux':
+                return elicitLinux(options);
+            default:
+                return elicitReadline(options);
+        }
+    }
+    catch (error) {
+        return { success: false, error: error.message };
+    }
+}
+function elicitMacOS(options) {
+    return new Promise((resolve) => {
+        const title = options.title || 'Input Required';
+        const message = options.prompt;
+        const defaultValue = options.defaultValue || '';
+        const isPassword = options.type === 'password';
+        const isConfirm = options.type === 'confirm';
+        let script;
+        if (isConfirm) {
+            script = `display dialog "${escapeAppleScript(message)}" with title "${escapeAppleScript(title)}" buttons {"Cancel", "No", "Yes"} default button "Yes"\nset buttonPressed to button returned of result\nreturn buttonPressed`;
+        }
+        else if (isPassword) {
+            script = `display dialog "${escapeAppleScript(message)}" with title "${escapeAppleScript(title)}" default answer "${escapeAppleScript(defaultValue)}" with hidden answer buttons {"Cancel", "OK"} default button "OK"\nreturn text returned of result`;
+        }
+        else {
+            script = `display dialog "${escapeAppleScript(message)}" with title "${escapeAppleScript(title)}" default answer "${escapeAppleScript(defaultValue)}" buttons {"Cancel", "OK"} default button "OK"\nreturn text returned of result`;
+        }
+        exec(`osascript -e '${script.replace(/'/g, "'\"'\"'")}'`, (error, stdout, _stderr) => {
+            if (error) {
+                resolve({ success: false, error: error.code === 1 ? 'User cancelled' : error.message });
+                return;
+            }
+            const value = stdout.trim();
+            if (isConfirm) {
+                resolve({ success: true, confirmed: value === 'Yes', value });
+            }
+            else {
+                resolve({ success: true, value });
+            }
+        });
+    });
+}
+function elicitWindows(options) {
+    return new Promise((resolve) => {
+        const title = options.title || 'Input Required';
+        const message = options.prompt;
+        const defaultValue = options.defaultValue || '';
+        const isConfirm = options.type === 'confirm';
+        let script;
+        if (isConfirm) {
+            script = `Add-Type -AssemblyName System.Windows.Forms\n$result = [System.Windows.Forms.MessageBox]::Show('${escapePowerShell(message)}', '${escapePowerShell(title)}', 'YesNoCancel', 'Question')\nWrite-Output $result`;
+        }
+        else {
+            script = `Add-Type -AssemblyName Microsoft.VisualBasic\n$result = [Microsoft.VisualBasic.Interaction]::InputBox('${escapePowerShell(message)}', '${escapePowerShell(title)}', '${escapePowerShell(defaultValue)}')\nWrite-Output $result`;
+        }
+        exec(`powershell -Command "${script.replace(/"/g, '\\"')}"`, (error, stdout, _stderr) => {
+            if (error) {
+                resolve({ success: false, error: error.message });
+                return;
+            }
+            const value = stdout.trim();
+            if (isConfirm) {
+                if (value === 'Cancel') {
+                    resolve({ success: false, error: 'User cancelled' });
+                }
+                else {
+                    resolve({ success: true, confirmed: value === 'Yes', value });
+                }
+            }
+            else {
+                if (value === '') {
+                    resolve({ success: false, error: 'User cancelled' });
+                }
+                else {
+                    resolve({ success: true, value });
+                }
+            }
+        });
+    });
+}
+function elicitLinux(options) {
+    return new Promise((resolve) => {
+        const title = options.title || 'Input Required';
+        const message = options.prompt;
+        const defaultValue = options.defaultValue || '';
+        const isPassword = options.type === 'password';
+        const isConfirm = options.type === 'confirm';
+        let command;
+        if (isConfirm) {
+            command = `zenity --question --title="${escapeShell(title)}" --text="${escapeShell(message)}" 2>/dev/null || kdialog --yesno "${escapeShell(message)}" --title "${escapeShell(title)}" 2>/dev/null`;
+        }
+        else if (isPassword) {
+            command = `zenity --password --title="${escapeShell(title)}" 2>/dev/null || kdialog --password "${escapeShell(message)}" --title "${escapeShell(title)}" 2>/dev/null`;
+        }
+        else {
+            command = `zenity --entry --title="${escapeShell(title)}" --text="${escapeShell(message)}" --entry-text="${escapeShell(defaultValue)}" 2>/dev/null || kdialog --inputbox "${escapeShell(message)}" "${escapeShell(defaultValue)}" --title "${escapeShell(title)}" 2>/dev/null`;
+        }
+        exec(command, (error, stdout, _stderr) => {
+            if (error) {
+                if (error.code === 1) {
+                    resolve({ success: false, error: 'User cancelled' });
+                }
+                else {
+                    elicitReadline(options).then(resolve);
+                }
+                return;
+            }
+            const value = stdout.trim();
+            if (isConfirm) {
+                resolve({ success: true, confirmed: true, value: 'yes' });
+            }
+            else {
+                resolve({ success: true, value });
+            }
+        });
+    });
+}
+function escapeAppleScript(str) {
+    return str.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+function escapePowerShell(str) {
+    return str.replace(/'/g, "''");
+}
+function escapeShell(str) {
+    return str.replace(/"/g, '\\"').replace(/\$/g, '\\$').replace(/`/g, '\\`');
+}
+//# sourceMappingURL=elicit.js.map

package/dist/elicit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicit.js","sourceRoot":"","sources":["../src/elicit.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @portel/mcp
+ *
+ * MCP protocol utilities for connecting to and calling MCP servers.
+ *
+ * Used by:
+ * - NCP (MCP orchestrator)
+ * - Photon runtimes
+ * - Any tool needing MCP connectivity
+ */
+export type { MCPToolInfo, MCPToolResult, MCPTransport, MCPSourceType, MissingMCPInfo, MCPServerConfig, MCPConfig, PhotonMCPConfig, ElicitOptions, ElicitResult, PromptHandler, ElicitHandler, } from './types.js';
+export { MCPClient, MCPClientFactory, MCPError, MCPNotConnectedError, MCPToolError, MCPConfigurationError, createMCPProxy, } from './mcp-client.js';
+export { SDKMCPTransport, SDKMCPClientFactory, loadMCPConfig, createSDKMCPClientFactory, resolveMCPSource, } from './mcp-sdk-transport.js';
+export { PHOTON_CONFIG_DIR, MCP_SERVERS_CONFIG_FILE, loadPhotonMCPConfig, savePhotonMCPConfig, isMCPConfigured, getMCPServerConfig, listMCPServers, setMCPServerConfig, removeMCPServerConfig, toMCPConfig, resolveEnvVars, } from './photon-config.js';
+export { prompt, confirm, elicit, elicitReadline, elicitNativeDialog, setPromptHandler, getPromptHandler, setElicitHandler, getElicitHandler, } from './elicit.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,SAAS,EACT,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,MAAM,EACN,OAAO,EACP,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @portel/mcp
+ *
+ * MCP protocol utilities for connecting to and calling MCP servers.
+ *
+ * Used by:
+ * - NCP (MCP orchestrator)
+ * - Photon runtimes
+ * - Any tool needing MCP connectivity
+ */
+// MCP Client
+export { MCPClient, MCPError, MCPNotConnectedError, MCPToolError, MCPConfigurationError, createMCPProxy, } from './mcp-client.js';
+// MCP SDK Transport
+export { SDKMCPTransport, SDKMCPClientFactory, loadMCPConfig, createSDKMCPClientFactory, resolveMCPSource, } from './mcp-sdk-transport.js';
+// MCP Configuration
+export { PHOTON_CONFIG_DIR, MCP_SERVERS_CONFIG_FILE, loadPhotonMCPConfig, savePhotonMCPConfig, isMCPConfigured, getMCPServerConfig, listMCPServers, setMCPServerConfig, removeMCPServerConfig, toMCPConfig, resolveEnvVars, } from './photon-config.js';
+// Elicitation
+export { prompt, confirm, elicit, elicitReadline, elicitNativeDialog, setPromptHandler, getPromptHandler, setElicitHandler, getElicitHandler, } from './elicit.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH,aAAa;AACb,OAAO,EACL,SAAS,EAET,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,oBAAoB;AACpB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,cAAc;AACd,OAAO,EACL,MAAM,EACN,OAAO,EACP,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC"}

package/dist/mcp-client.d.ts

@@ -0,0 +1,66 @@
+/**
+ * MCP Protocol Client
+ *
+ * Enables calling external MCPs via the MCP protocol.
+ * Runtime-agnostic - the actual transport is provided by the runtime.
+ */
+import type { MCPToolInfo, MCPToolResult, MCPTransport, MCPSourceType, MissingMCPInfo } from './types.js';
+/**
+ * Factory interface for creating MCP clients
+ */
+export interface MCPClientFactory {
+    create(mcpName: string): MCPClient;
+    listServers(): Promise<string[]>;
+}
+/**
+ * MCP Client - Protocol wrapper for calling external MCPs
+ */
+export declare class MCPClient {
+    private mcpName;
+    private transport;
+    private toolsCache;
+    constructor(mcpName: string, transport: MCPTransport);
+    get name(): string;
+    call(toolName: string, parameters?: Record<string, any>): Promise<any>;
+    list(): Promise<MCPToolInfo[]>;
+    find(query: string): Promise<MCPToolInfo[]>;
+    isConnected(): Promise<boolean>;
+    clearCache(): void;
+    private parseResult;
+}
+/**
+ * Base class for MCP-related errors
+ */
+export declare class MCPError extends Error {
+    readonly mcpName: string;
+    constructor(mcpName: string, message: string);
+}
+/**
+ * Error thrown when MCP server is not connected
+ */
+export declare class MCPNotConnectedError extends MCPError {
+    constructor(mcpName: string);
+}
+/**
+ * Error thrown when MCP tool call fails
+ */
+export declare class MCPToolError extends MCPError {
+    readonly toolName: string;
+    readonly details: string;
+    constructor(mcpName: string, toolName: string, details: string);
+}
+/**
+ * Error thrown when MCP is not configured correctly
+ */
+export declare class MCPConfigurationError extends MCPError {
+    readonly configPath: string;
+    readonly missingMCPs: MissingMCPInfo[];
+    constructor(missingMCPs: MissingMCPInfo[]);
+    private static formatMessage;
+}
+/**
+ * Create a proxy-based MCP client for fluent API
+ */
+export declare function createMCPProxy(client: MCPClient): MCPClient & Record<string, (params?: any) => Promise<any>>;
+export type { MCPToolInfo, MCPToolResult, MCPTransport, MCPSourceType, MissingMCPInfo };
+//# sourceMappingURL=mcp-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../src/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,SAAS;IAIlB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,SAAS;IAJnB,OAAO,CAAC,UAAU,CAA8B;gBAGtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,YAAY;IAGjC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAyB1E,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAY9B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAU3C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC,UAAU,IAAI,IAAI;IAIlB,OAAO,CAAC,WAAW;CAuBpB;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAEf,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM,EAC/B,OAAO,EAAE,MAAM;CAKlB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;aAGtB,QAAQ,EAAE,MAAM;aAChB,OAAO,EAAE,MAAM;gBAF/B,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM;CAKlC;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,WAAW,EAAE,cAAc,EAAE,CAAC;gBAElC,WAAW,EAAE,cAAc,EAAE;IASzC,OAAO,CAAC,MAAM,CAAC,aAAa;CAyB7B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAO5G;AAED,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC"}

package/dist/mcp-client.js

@@ -0,0 +1,172 @@
+/**
+ * MCP Protocol Client
+ *
+ * Enables calling external MCPs via the MCP protocol.
+ * Runtime-agnostic - the actual transport is provided by the runtime.
+ */
+/**
+ * MCP Client - Protocol wrapper for calling external MCPs
+ */
+export class MCPClient {
+    mcpName;
+    transport;
+    toolsCache = null;
+    constructor(mcpName, transport) {
+        this.mcpName = mcpName;
+        this.transport = transport;
+    }
+    get name() {
+        return this.mcpName;
+    }
+    async call(toolName, parameters = {}) {
+        const connected = await this.transport.isConnected(this.mcpName);
+        if (!connected) {
+            throw new MCPNotConnectedError(this.mcpName);
+        }
+        try {
+            const result = await this.transport.callTool(this.mcpName, toolName, parameters);
+            if (result.isError) {
+                const errorText = result.content.find(c => c.type === 'text')?.text || 'Unknown error';
+                throw new MCPToolError(this.mcpName, toolName, errorText);
+            }
+            return this.parseResult(result);
+        }
+        catch (error) {
+            if (error instanceof MCPError)
+                throw error;
+            throw new MCPToolError(this.mcpName, toolName, error instanceof Error ? error.message : String(error));
+        }
+    }
+    async list() {
+        if (this.toolsCache)
+            return this.toolsCache;
+        const connected = await this.transport.isConnected(this.mcpName);
+        if (!connected) {
+            throw new MCPNotConnectedError(this.mcpName);
+        }
+        this.toolsCache = await this.transport.listTools(this.mcpName);
+        return this.toolsCache;
+    }
+    async find(query) {
+        const tools = await this.list();
+        const lowerQuery = query.toLowerCase();
+        return tools.filter(t => t.name.toLowerCase().includes(lowerQuery) ||
+            t.description?.toLowerCase().includes(lowerQuery));
+    }
+    async isConnected() {
+        return this.transport.isConnected(this.mcpName);
+    }
+    clearCache() {
+        this.toolsCache = null;
+    }
+    parseResult(result) {
+        if (!result.content || result.content.length === 0)
+            return null;
+        if (result.content.length === 1 && result.content[0].type === 'text') {
+            const text = result.content[0].text || '';
+            try {
+                return JSON.parse(text);
+            }
+            catch {
+                return text;
+            }
+        }
+        return result.content.map(c => {
+            if (c.type === 'text') {
+                try {
+                    return JSON.parse(c.text || '');
+                }
+                catch {
+                    return c.text;
+                }
+            }
+            return c;
+        });
+    }
+}
+/**
+ * Base class for MCP-related errors
+ */
+export class MCPError extends Error {
+    mcpName;
+    constructor(mcpName, message) {
+        super(message);
+        this.mcpName = mcpName;
+        this.name = 'MCPError';
+    }
+}
+/**
+ * Error thrown when MCP server is not connected
+ */
+export class MCPNotConnectedError extends MCPError {
+    constructor(mcpName) {
+        super(mcpName, `MCP server '${mcpName}' is not connected`);
+        this.name = 'MCPNotConnectedError';
+    }
+}
+/**
+ * Error thrown when MCP tool call fails
+ */
+export class MCPToolError extends MCPError {
+    toolName;
+    details;
+    constructor(mcpName, toolName, details) {
+        super(mcpName, `MCP tool '${mcpName}:${toolName}' failed: ${details}`);
+        this.toolName = toolName;
+        this.details = details;
+        this.name = 'MCPToolError';
+    }
+}
+/**
+ * Error thrown when MCP is not configured correctly
+ */
+export class MCPConfigurationError extends MCPError {
+    configPath;
+    missingMCPs;
+    constructor(missingMCPs) {
+        const configPath = `~/.photon/mcp-servers.json`;
+        const message = MCPConfigurationError.formatMessage(missingMCPs, configPath);
+        super(missingMCPs[0]?.name || 'unknown', message);
+        this.name = 'MCPConfigurationError';
+        this.configPath = configPath;
+        this.missingMCPs = missingMCPs;
+    }
+    static formatMessage(missingMCPs, configPath) {
+        const lines = [
+            '',
+            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+            '❌ MCP Configuration Required',
+            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+            '',
+            `The following MCP server${missingMCPs.length > 1 ? 's are' : ' is'} required but not configured:`,
+            '',
+        ];
+        for (const mcp of missingMCPs) {
+            lines.push(`  • ${mcp.name}`);
+            if (mcp.source)
+                lines.push(`    Source: ${mcp.source} (${mcp.sourceType})`);
+            if (mcp.declaredIn)
+                lines.push(`    Declared in: ${mcp.declaredIn}`);
+            if (mcp.originalError)
+                lines.push(`    Error: ${mcp.originalError}`);
+            lines.push('');
+        }
+        lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        lines.push(`Add configuration to ${configPath}`);
+        lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        return lines.join('\n');
+    }
+}
+/**
+ * Create a proxy-based MCP client for fluent API
+ */
+export function createMCPProxy(client) {
+    return new Proxy(client, {
+        get(target, prop) {
+            if (prop in target)
+                return target[prop];
+            return (params = {}) => target.call(prop, params);
+        },
+    });
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/mcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../src/mcp-client.ts"],"names":[],"mappings":"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"}

package/dist/mcp-sdk-transport.d.ts

@@ -0,0 +1,49 @@
+/**
+ * MCP SDK Transport
+ *
+ * Uses the official @modelcontextprotocol/sdk for connecting to MCP servers.
+ * Supports: stdio, sse, streamable-http, websocket transports.
+ */
+import { MCPClient, createMCPProxy, type MCPClientFactory } from './mcp-client.js';
+import type { MCPToolInfo, MCPToolResult, MCPTransport, MCPServerConfig, MCPConfig } from './types.js';
+/**
+ * SDK-based MCP Transport using official @modelcontextprotocol/sdk
+ */
+export declare class SDKMCPTransport implements MCPTransport {
+    private config;
+    private verbose;
+    private connections;
+    constructor(config: MCPConfig, verbose?: boolean);
+    private getConnection;
+    callTool(mcpName: string, toolName: string, parameters: Record<string, any>): Promise<MCPToolResult>;
+    listTools(mcpName: string): Promise<MCPToolInfo[]>;
+    isConnected(mcpName: string): Promise<boolean>;
+    listServers(): string[];
+    disconnectAll(): Promise<void>;
+}
+/**
+ * SDK-based MCP Client Factory
+ */
+export declare class SDKMCPClientFactory implements MCPClientFactory {
+    private transport;
+    constructor(config: MCPConfig, verbose?: boolean);
+    create(mcpName: string): MCPClient;
+    listServers(): Promise<string[]>;
+    disconnect(): Promise<void>;
+    getTransport(): SDKMCPTransport;
+}
+/**
+ * Resolve an MCP source to a runnable configuration
+ */
+export declare function resolveMCPSource(name: string, source: string, sourceType: 'github' | 'npm' | 'url' | 'local'): MCPServerConfig;
+/**
+ * Load MCP configuration from standard locations
+ */
+export declare function loadMCPConfig(verbose?: boolean): Promise<MCPConfig>;
+/**
+ * Create an SDK-based MCP client factory from default config
+ */
+export declare function createSDKMCPClientFactory(verbose?: boolean): Promise<SDKMCPClientFactory>;
+export { MCPClient, createMCPProxy };
+export type { MCPServerConfig, MCPConfig };
+//# sourceMappingURL=mcp-sdk-transport.d.ts.map

package/dist/mcp-sdk-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-sdk-transport.d.ts","sourceRoot":"","sources":["../src/mcp-sdk-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EACL,SAAS,EAGT,cAAc,EACd,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,eAAe,EACf,SAAS,EACV,MAAM,YAAY,CAAC;AA4IpB;;GAEG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAIhD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAJjB,OAAO,CAAC,WAAW,CAA4C;gBAGrD,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,OAAe;YAGpB,aAAa;IAerB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAKpG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKlD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMpD,WAAW,IAAI,MAAM,EAAE;IAIjB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAMrC;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,OAAe;IAIvD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAI5B,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,YAAY,IAAI,eAAe;CAGhC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAC7C,eAAe,CAgBjB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAyBhF;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAGtG;AAED,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;AACrC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC"}

package/dist/mcp-sdk-transport.js

@@ -0,0 +1,263 @@
+/**
+ * MCP SDK Transport
+ *
+ * Uses the official @modelcontextprotocol/sdk for connecting to MCP servers.
+ * Supports: stdio, sse, streamable-http, websocket transports.
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { WebSocketClientTransport } from '@modelcontextprotocol/sdk/client/websocket.js';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { MCPClient, MCPNotConnectedError, MCPToolError, createMCPProxy, } from './mcp-client.js';
+/**
+ * Manages a single MCP server connection using official SDK
+ */
+class SDKMCPConnection {
+    name;
+    config;
+    verbose;
+    client = null;
+    transport = null;
+    tools = [];
+    initialized = false;
+    constructor(name, config, verbose = false) {
+        this.name = name;
+        this.config = config;
+        this.verbose = verbose;
+    }
+    log(message) {
+        if (this.verbose)
+            console.error(`[MCP:${this.name}] ${message}`);
+    }
+    createTransport() {
+        const transportType = this.config.transport || (this.config.command ? 'stdio' : 'sse');
+        switch (transportType) {
+            case 'stdio': {
+                if (!this.config.command) {
+                    throw new Error(`stdio transport requires 'command' for ${this.name}`);
+                }
+                this.log(`Creating stdio transport: ${this.config.command} ${(this.config.args || []).join(' ')}`);
+                return new StdioClientTransport({
+                    command: this.config.command,
+                    args: this.config.args,
+                    cwd: this.config.cwd,
+                    env: this.config.env,
+                });
+            }
+            case 'sse': {
+                if (!this.config.url)
+                    throw new Error(`sse transport requires 'url' for ${this.name}`);
+                this.log(`Creating SSE transport: ${this.config.url}`);
+                return new SSEClientTransport(new URL(this.config.url), {
+                    requestInit: this.config.headers ? { headers: this.config.headers } : undefined,
+                });
+            }
+            case 'streamable-http': {
+                if (!this.config.url)
+                    throw new Error(`streamable-http transport requires 'url' for ${this.name}`);
+                this.log(`Creating streamable HTTP transport: ${this.config.url}`);
+                return new StreamableHTTPClientTransport(new URL(this.config.url), {
+                    requestInit: this.config.headers ? { headers: this.config.headers } : undefined,
+                });
+            }
+            case 'websocket': {
+                if (!this.config.url)
+                    throw new Error(`websocket transport requires 'url' for ${this.name}`);
+                this.log(`Creating WebSocket transport: ${this.config.url}`);
+                return new WebSocketClientTransport(new URL(this.config.url));
+            }
+            default:
+                throw new Error(`Unknown transport type: ${transportType}`);
+        }
+    }
+    async connect() {
+        if (this.client)
+            return;
+        this.transport = this.createTransport();
+        this.client = new Client({ name: 'portel-mcp', version: '1.0.0' }, { capabilities: { roots: { listChanged: false } } });
+        this.log('Connecting...');
+        await this.client.connect(this.transport);
+        this.log('Connected');
+        const toolsResult = await this.client.listTools();
+        this.tools = (toolsResult.tools || []).map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        }));
+        this.log(`Loaded ${this.tools.length} tools`);
+        this.initialized = true;
+    }
+    async callTool(toolName, parameters) {
+        if (!this.client || !this.initialized) {
+            throw new MCPNotConnectedError(this.name);
+        }
+        try {
+            const result = await this.client.callTool({
+                name: toolName,
+                arguments: parameters,
+            });
+            if (result?.content && Array.isArray(result.content)) {
+                return {
+                    content: result.content.map((c) => ({
+                        type: c.type || 'text',
+                        text: c.text,
+                        data: c.data,
+                        mimeType: c.mimeType,
+                    })),
+                    isError: result.isError,
+                };
+            }
+            return {
+                content: [{ type: 'text', text: typeof result === 'string' ? result : JSON.stringify(result) }],
+                isError: false,
+            };
+        }
+        catch (error) {
+            throw new MCPToolError(this.name, toolName, error.message);
+        }
+    }
+    listTools() {
+        return this.tools;
+    }
+    isConnected() {
+        return this.initialized && this.client !== null;
+    }
+    async disconnect() {
+        if (this.client) {
+            this.log('Disconnecting...');
+            await this.client.close();
+            this.client = null;
+            this.transport = null;
+            this.initialized = false;
+        }
+    }
+}
+/**
+ * SDK-based MCP Transport using official @modelcontextprotocol/sdk
+ */
+export class SDKMCPTransport {
+    config;
+    verbose;
+    connections = new Map();
+    constructor(config, verbose = false) {
+        this.config = config;
+        this.verbose = verbose;
+    }
+    async getConnection(mcpName) {
+        let connection = this.connections.get(mcpName);
+        if (connection?.isConnected())
+            return connection;
+        const serverConfig = this.config.mcpServers[mcpName];
+        if (!serverConfig)
+            throw new MCPNotConnectedError(mcpName);
+        connection = new SDKMCPConnection(mcpName, serverConfig, this.verbose);
+        await connection.connect();
+        this.connections.set(mcpName, connection);
+        return connection;
+    }
+    async callTool(mcpName, toolName, parameters) {
+        const connection = await this.getConnection(mcpName);
+        return connection.callTool(toolName, parameters);
+    }
+    async listTools(mcpName) {
+        const connection = await this.getConnection(mcpName);
+        return connection.listTools();
+    }
+    async isConnected(mcpName) {
+        if (!this.config.mcpServers[mcpName])
+            return false;
+        const connection = this.connections.get(mcpName);
+        return connection?.isConnected() ?? false;
+    }
+    listServers() {
+        return Object.keys(this.config.mcpServers);
+    }
+    async disconnectAll() {
+        for (const connection of this.connections.values()) {
+            await connection.disconnect();
+        }
+        this.connections.clear();
+    }
+}
+/**
+ * SDK-based MCP Client Factory
+ */
+export class SDKMCPClientFactory {
+    transport;
+    constructor(config, verbose = false) {
+        this.transport = new SDKMCPTransport(config, verbose);
+    }
+    create(mcpName) {
+        return new MCPClient(mcpName, this.transport);
+    }
+    async listServers() {
+        return this.transport.listServers();
+    }
+    async disconnect() {
+        await this.transport.disconnectAll();
+    }
+    getTransport() {
+        return this.transport;
+    }
+}
+/**
+ * Resolve an MCP source to a runnable configuration
+ */
+export function resolveMCPSource(name, source, sourceType) {
+    switch (sourceType) {
+        case 'npm':
+            return { command: 'npx', args: ['-y', source.replace(/^npm:/, '')], transport: 'stdio' };
+        case 'github':
+            return { command: 'npx', args: ['-y', `@${source}`], transport: 'stdio' };
+        case 'url':
+            if (source.startsWith('ws://') || source.startsWith('wss://')) {
+                return { url: source, transport: 'websocket' };
+            }
+            return { url: source, transport: 'sse' };
+        case 'local':
+            return { command: 'node', args: [source.replace(/^~/, process.env.HOME || '')], transport: 'stdio' };
+        default:
+            throw new Error(`Unknown MCP source type: ${sourceType}`);
+    }
+}
+/**
+ * Load MCP configuration from standard locations
+ */
+export async function loadMCPConfig(verbose = false) {
+    const log = verbose ? (msg) => console.error(`[MCPConfig] ${msg}`) : () => { };
+    const configPaths = [
+        process.env.PHOTON_MCP_CONFIG,
+        path.join(process.cwd(), 'photon.mcp.json'),
+        path.join(os.homedir(), '.config', 'photon', 'mcp.json'),
+        path.join(os.homedir(), '.photon', 'mcp-servers.json'),
+    ].filter(Boolean);
+    for (const configPath of configPaths) {
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            const config = JSON.parse(content);
+            if (config.mcpServers && typeof config.mcpServers === 'object') {
+                log(`Loaded MCP config from ${configPath}`);
+                return config;
+            }
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                log(`Failed to load ${configPath}: ${error.message}`);
+        }
+    }
+    log('No MCP config found');
+    return { mcpServers: {} };
+}
+/**
+ * Create an SDK-based MCP client factory from default config
+ */
+export async function createSDKMCPClientFactory(verbose = false) {
+    const config = await loadMCPConfig(verbose);
+    return new SDKMCPClientFactory(config, verbose);
+}
+export { MCPClient, createMCPProxy };
+//# sourceMappingURL=mcp-sdk-transport.js.map

package/dist/mcp-sdk-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-sdk-transport.js","sourceRoot":"","sources":["../src/mcp-sdk-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,YAAY,EACZ,cAAc,GAEf,MAAM,iBAAiB,CAAC;AASzB;;GAEG;AACH,MAAM,gBAAgB;IAOV;IACA;IACA;IARF,MAAM,GAAkB,IAAI,CAAC;IAC7B,SAAS,GAAQ,IAAI,CAAC;IACtB,KAAK,GAAkB,EAAE,CAAC;IAC1B,WAAW,GAAG,KAAK,CAAC;IAE5B,YACU,IAAY,EACZ,MAAuB,EACvB,UAAmB,KAAK;QAFxB,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAiB;QACvB,YAAO,GAAP,OAAO,CAAiB;IAC/B,CAAC;IAEI,GAAG,CAAC,OAAe;QACzB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAEO,eAAe;QACrB,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAEvF,QAAQ,aAAa,EAAE,CAAC;YACtB,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACzB,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACzE,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnG,OAAO,IAAI,oBAAoB,CAAC;oBAC9B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;oBAC5B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;oBACtB,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;oBACpB,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;iBACrB,CAAC,CAAC;YACL,CAAC;YAED,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;oBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACvF,IAAI,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;gBACvD,OAAO,IAAI,kBAAkB,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;oBACtD,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;iBAChF,CAAC,CAAC;YACL,CAAC;YAED,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;oBAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACnG,IAAI,CAAC,GAAG,CAAC,uCAAuC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;gBACnE,OAAO,IAAI,6BAA6B,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;oBACjE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;iBAChF,CAAC,CAAC;YACL,CAAC;YAED,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;oBAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC7F,IAAI,CAAC,GAAG,CAAC,iCAAiC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC7D,OAAO,IAAI,wBAAwB,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,CAAC;YAED;gBACE,MAAM,IAAI,KAAK,CAAC,2BAA2B,aAAa,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CACtB,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,EACxC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,CACpD,CAAC;QAEF,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAEtB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YACtD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;QAEJ,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,UAA+B;QAC9D,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtC,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;gBACxC,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,UAAU;aACtB,CAAC,CAAC;YAEH,IAAI,MAAM,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrD,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;wBACvC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,MAAM;wBACtB,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;qBACrB,CAAC,CAAC;oBACH,OAAO,EAAE,MAAM,CAAC,OAA8B;iBAC/C,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/F,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAC7B,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IAIhB;IACA;IAJF,WAAW,GAAkC,IAAI,GAAG,EAAE,CAAC;IAE/D,YACU,MAAiB,EACjB,UAAmB,KAAK;QADxB,WAAM,GAAN,MAAM,CAAW;QACjB,YAAO,GAAP,OAAO,CAAiB;IAC/B,CAAC;IAEI,KAAK,CAAC,aAAa,CAAC,OAAe;QACzC,IAAI,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE/C,IAAI,UAAU,EAAE,WAAW,EAAE;YAAE,OAAO,UAAU,CAAC;QAEjD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAE3D,UAAU,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvE,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAE1C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,QAAgB,EAAE,UAA+B;QAC/E,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,UAAU,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO,UAAU,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;IAC5C,CAAC;IAED,WAAW;QACT,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YACnD,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACtB,SAAS,CAAkB;IAEnC,YAAY,MAAiB,EAAE,UAAmB,KAAK;QACrD,IAAI,CAAC,SAAS,GAAG,IAAI,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,OAAe;QACpB,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;IACvC,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,MAAc,EACd,UAA8C;IAE9C,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,KAAK;YACR,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QAC3F,KAAK,QAAQ;YACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QAC5E,KAAK,KAAK;YACR,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;YACjD,CAAC;YACD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC3C,KAAK,OAAO;YACV,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QACvG;YACE,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAmB,KAAK;IAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;IAEtF,MAAM,WAAW,GAAG;QAClB,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,iBAAiB,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,kBAAkB,CAAC;KACvD,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;IAE9B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;YAChD,IAAI,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;gBAC/D,GAAG,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;gBAC5C,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,GAAG,CAAC,kBAAkB,UAAU,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC3B,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,UAAmB,KAAK;IACtE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,IAAI,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC"}

package/dist/photon-config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Photon Runtime Configuration
+ *
+ * Manages ~/.photon/mcp-servers.json for MCP server configuration.
+ */
+import type { MCPConfig, MCPServerConfig, PhotonMCPConfig } from './types.js';
+export declare const PHOTON_CONFIG_DIR: string;
+export declare const MCP_SERVERS_CONFIG_FILE: string;
+export declare function loadPhotonMCPConfig(configPath?: string): Promise<PhotonMCPConfig>;
+export declare function savePhotonMCPConfig(config: PhotonMCPConfig, configPath?: string): Promise<void>;
+export declare function isMCPConfigured(mcpName: string, config?: PhotonMCPConfig): Promise<boolean>;
+export declare function getMCPServerConfig(mcpName: string, config?: PhotonMCPConfig): Promise<MCPServerConfig | undefined>;
+export declare function setMCPServerConfig(mcpName: string, serverConfig: MCPServerConfig, configPath?: string): Promise<void>;
+export declare function removeMCPServerConfig(mcpName: string, configPath?: string): Promise<void>;
+export declare function listMCPServers(configPath?: string): Promise<string[]>;
+export declare function toMCPConfig(config: PhotonMCPConfig): MCPConfig;
+export declare function resolveEnvVars(serverConfig: MCPServerConfig): MCPServerConfig;
+export type { PhotonMCPConfig };
+//# sourceMappingURL=photon-config.d.ts.map

package/dist/photon-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-config.d.ts","sourceRoot":"","sources":["../src/photon-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9E,eAAO,MAAM,iBAAiB,QAAqC,CAAC;AACpE,eAAO,MAAM,uBAAuB,QAAmD,CAAC;AAExF,wBAAsB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAkBvF;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrG;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAGjG;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAGxH;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3H;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/F;AAED,wBAAsB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG3E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAE9D;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,eAAe,GAAG,eAAe,CAoB7E;AAMD,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/photon-config.js

@@ -0,0 +1,80 @@
+/**
+ * Photon Runtime Configuration
+ *
+ * Manages ~/.photon/mcp-servers.json for MCP server configuration.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+export const PHOTON_CONFIG_DIR = path.join(os.homedir(), '.photon');
+export const MCP_SERVERS_CONFIG_FILE = path.join(PHOTON_CONFIG_DIR, 'mcp-servers.json');
+export async function loadPhotonMCPConfig(configPath) {
+    const filePath = configPath || MCP_SERVERS_CONFIG_FILE;
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const config = JSON.parse(content);
+        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
+            console.error(`Invalid config format in ${filePath}: missing mcpServers`);
+            return { mcpServers: {} };
+        }
+        return config;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return { mcpServers: {} };
+        console.error(`Failed to load config from ${filePath}: ${error.message}`);
+        return { mcpServers: {} };
+    }
+}
+export async function savePhotonMCPConfig(config, configPath) {
+    const filePath = configPath || MCP_SERVERS_CONFIG_FILE;
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(filePath, JSON.stringify(config, null, 2), 'utf-8');
+}
+export async function isMCPConfigured(mcpName, config) {
+    const cfg = config || await loadPhotonMCPConfig();
+    return mcpName in cfg.mcpServers;
+}
+export async function getMCPServerConfig(mcpName, config) {
+    const cfg = config || await loadPhotonMCPConfig();
+    return cfg.mcpServers[mcpName];
+}
+export async function setMCPServerConfig(mcpName, serverConfig, configPath) {
+    const config = await loadPhotonMCPConfig(configPath);
+    config.mcpServers[mcpName] = serverConfig;
+    await savePhotonMCPConfig(config, configPath);
+}
+export async function removeMCPServerConfig(mcpName, configPath) {
+    const config = await loadPhotonMCPConfig(configPath);
+    delete config.mcpServers[mcpName];
+    await savePhotonMCPConfig(config, configPath);
+}
+export async function listMCPServers(configPath) {
+    const config = await loadPhotonMCPConfig(configPath);
+    return Object.keys(config.mcpServers);
+}
+export function toMCPConfig(config) {
+    return { mcpServers: config.mcpServers };
+}
+export function resolveEnvVars(serverConfig) {
+    const resolved = { ...serverConfig };
+    if (resolved.env) {
+        const processedEnv = {};
+        for (const [key, value] of Object.entries(resolved.env)) {
+            processedEnv[key] = resolveEnvValue(value);
+        }
+        resolved.env = processedEnv;
+    }
+    if (resolved.args) {
+        resolved.args = resolved.args.map(resolveEnvValue);
+    }
+    if (resolved.url) {
+        resolved.url = resolveEnvValue(resolved.url);
+    }
+    return resolved;
+}
+function resolveEnvValue(value) {
+    return value.replace(/\$\{([^}]+)\}/g, (_, varName) => process.env[varName] || '');
+}
+//# sourceMappingURL=photon-config.js.map

package/dist/photon-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-config.js","sourceRoot":"","sources":["../src/photon-config.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @portel/mcp type definitions
+ */
+/**
+ * Tool information returned from MCP discovery
+ */
+export interface MCPToolInfo {
+    name: string;
+    description?: string;
+    inputSchema?: {
+        type: 'object';
+        properties?: Record<string, any>;
+        required?: string[];
+    };
+}
+/**
+ * Result from an MCP tool call
+ */
+export interface MCPToolResult {
+    content: Array<{
+        type: 'text' | 'image' | 'resource';
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Interface that runtimes must implement to provide MCP connectivity
+ */
+export interface MCPTransport {
+    callTool(mcpName: string, toolName: string, parameters: Record<string, any>): Promise<MCPToolResult>;
+    listTools(mcpName: string): Promise<MCPToolInfo[]>;
+    isConnected(mcpName: string): Promise<boolean>;
+}
+/**
+ * MCP source type - how the MCP was declared
+ */
+export type MCPSourceType = 'npm' | 'github' | 'local' | 'url' | 'unknown';
+/**
+ * Information about a missing MCP dependency
+ */
+export interface MissingMCPInfo {
+    name: string;
+    source: string;
+    sourceType: MCPSourceType;
+    declaredIn?: string;
+    originalError?: string;
+}
+/**
+ * MCP Server configuration
+ */
+export interface MCPServerConfig {
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    url?: string;
+    transport?: 'stdio' | 'sse' | 'streamable-http' | 'websocket';
+    headers?: Record<string, string>;
+}
+/**
+ * Full MCP configuration file format
+ */
+export interface MCPConfig {
+    mcpServers: Record<string, MCPServerConfig>;
+}
+/**
+ * Photon MCP servers configuration
+ */
+export interface PhotonMCPConfig {
+    mcpServers: Record<string, MCPServerConfig>;
+}
+/**
+ * Elicitation options
+ */
+export interface ElicitOptions {
+    prompt: string;
+    title?: string;
+    defaultValue?: string;
+    type?: 'text' | 'password' | 'confirm';
+    schema?: object;
+    timeout?: number;
+}
+/**
+ * Elicitation result
+ */
+export interface ElicitResult {
+    success: boolean;
+    value?: string;
+    confirmed?: boolean;
+    error?: string;
+}
+/**
+ * Prompt handler type
+ */
+export type PromptHandler = (message: string, defaultValue?: string) => Promise<string | null>;
+/**
+ * Full elicit handler type
+ */
+export type ElicitHandler = (options: ElicitOptions) => Promise<ElicitResult>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * @portel/mcp type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@portel/mcp",
+  "version": "1.0.0",
+  "description": "MCP protocol utilities - client, transport, elicitation",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "client",
+    "transport",
+    "elicitation"
+  ],
+  "author": "Portel",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AruLNa662/portel-mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.0",
+    "@portel/cli": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}