@portel/photon 1.0.0

package/dist/base.d.ts

@@ -0,0 +1,58 @@
+/**
+ * PhotonMCP Base Class
+ *
+ * Optional base class for creating Photon MCPs.
+ * You don't need to extend this - any class with async methods works!
+ *
+ * Usage:
+ * ```typescript
+ * export default class Calculator extends PhotonMCP {
+ *   /**
+ *    * Add two numbers together
+ *    * @param a First number
+ *    * @param b Second number
+ *    *\/
+ *   async add(params: { a: number; b: number }) {
+ *     return params.a + params.b;
+ *   }
+ * }
+ * ```
+ *
+ * Or without extending (plain class):
+ * ```typescript
+ * export default class Calculator {
+ *   async add(params: { a: number; b: number }) {
+ *     return params.a + params.b;
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Simple base class for creating Photon MCPs
+ *
+ * - Class name = MCP name
+ * - Public async methods = Tools
+ * - Return value = Tool result
+ */
+export declare class PhotonMCP {
+    /**
+     * Get MCP name from class name
+     * Converts PascalCase to kebab-case (e.g., MyAwesomeMCP → my-awesome-mcp)
+     */
+    static getMCPName(): string;
+    /**
+     * Get all tool methods from this class
+     * Returns all public async methods except lifecycle hooks
+     */
+    static getToolMethods(): string[];
+    /**
+     * Execute a tool method
+     */
+    executeTool(toolName: string, parameters: any): Promise<any>;
+    /**
+     * Optional lifecycle hooks
+     */
+    onInitialize?(): Promise<void>;
+    onShutdown?(): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAQ3B;;;OAGG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM,EAAE;IA0BjC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAgBlE;;OAEG;IACG,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAC9B,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CACnC"}

package/dist/base.js

@@ -0,0 +1,92 @@
+/**
+ * PhotonMCP Base Class
+ *
+ * Optional base class for creating Photon MCPs.
+ * You don't need to extend this - any class with async methods works!
+ *
+ * Usage:
+ * ```typescript
+ * export default class Calculator extends PhotonMCP {
+ *   /**
+ *    * Add two numbers together
+ *    * @param a First number
+ *    * @param b Second number
+ *    *\/
+ *   async add(params: { a: number; b: number }) {
+ *     return params.a + params.b;
+ *   }
+ * }
+ * ```
+ *
+ * Or without extending (plain class):
+ * ```typescript
+ * export default class Calculator {
+ *   async add(params: { a: number; b: number }) {
+ *     return params.a + params.b;
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Simple base class for creating Photon MCPs
+ *
+ * - Class name = MCP name
+ * - Public async methods = Tools
+ * - Return value = Tool result
+ */
+export class PhotonMCP {
+    /**
+     * Get MCP name from class name
+     * Converts PascalCase to kebab-case (e.g., MyAwesomeMCP → my-awesome-mcp)
+     */
+    static getMCPName() {
+        return this.name
+            .replace(/MCP$/, '') // Remove "MCP" suffix if present
+            .replace(/([A-Z])/g, '-$1')
+            .toLowerCase()
+            .replace(/^-/, ''); // Remove leading dash
+    }
+    /**
+     * Get all tool methods from this class
+     * Returns all public async methods except lifecycle hooks
+     */
+    static getToolMethods() {
+        const prototype = this.prototype;
+        const methods = [];
+        // Get all property names from prototype chain
+        let current = prototype;
+        while (current && current !== PhotonMCP.prototype) {
+            Object.getOwnPropertyNames(current).forEach((name) => {
+                // Skip constructor, private methods (starting with _), and lifecycle hooks
+                if (name !== 'constructor' &&
+                    !name.startsWith('_') &&
+                    name !== 'onInitialize' &&
+                    name !== 'onShutdown' &&
+                    typeof prototype[name] === 'function' &&
+                    !methods.includes(name)) {
+                    methods.push(name);
+                }
+            });
+            current = Object.getPrototypeOf(current);
+        }
+        return methods;
+    }
+    /**
+     * Execute a tool method
+     */
+    async executeTool(toolName, parameters) {
+        const method = this[toolName];
+        if (!method || typeof method !== 'function') {
+            throw new Error(`Tool not found: ${toolName}`);
+        }
+        try {
+            const result = await method.call(this, parameters);
+            return result;
+        }
+        catch (error) {
+            console.error(`Tool execution failed: ${toolName} - ${error.message}`);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IACpB;;;OAGG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,CAAC,IAAI;aACb,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,iCAAiC;aACrD,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;aAC1B,WAAW,EAAE;aACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB;IAC9C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,cAAc;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,8CAA8C;QAC9C,IAAI,OAAO,GAAG,SAAS,CAAC;QACxB,OAAO,OAAO,IAAI,OAAO,KAAK,SAAS,CAAC,SAAS,EAAE,CAAC;YAClD,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBACnD,2EAA2E;gBAC3E,IACE,IAAI,KAAK,aAAa;oBACtB,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;oBACrB,IAAI,KAAK,cAAc;oBACvB,IAAI,KAAK,YAAY;oBACrB,OAAQ,SAAiB,CAAC,IAAI,CAAC,KAAK,UAAU;oBAC9C,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EACvB,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,UAAe;QACjD,MAAM,MAAM,GAAI,IAAY,CAAC,QAAQ,CAAC,CAAC;QAEvC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACnD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,0BAA0B,QAAQ,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CAOF"}

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Photon MCP CLI
+ *
+ * Command-line interface for running .photon.ts files as MCP servers
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}