@portel/photon-core 2.3.0 → 2.4.0

package/dist/asset-discovery.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Asset Discovery Utilities
+ *
+ * Discover and extract UI, prompt, and resource assets from Photon files.
+ * Extracted from photon's loader.ts.
+ *
+ * Depends on: getMimeType (from ./mime-types), SchemaExtractor (from ./schema-extractor)
+ */
+import type { PhotonAssets } from './types.js';
+/**
+ * Discover and extract assets from a Photon file
+ *
+ * Convention:
+ * - Asset folder: {photon-name}/ next to {photon-name}.photon.ts
+ * - Subfolder: ui/, prompts/, resources/
+ *
+ * @param photonPath - Absolute path to the .photon.ts file
+ * @param source - Source code content of the Photon file
+ */
+export declare function discoverAssets(photonPath: string, source: string): Promise<PhotonAssets | undefined>;
+/**
+ * Auto-discover assets from the ui/, prompts/, resources/ subdirectories
+ */
+export declare function autoDiscoverAssets(assetFolder: string, assets: PhotonAssets): Promise<void>;
+//# sourceMappingURL=asset-discovery.d.ts.map

package/dist/asset-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-discovery.d.ts","sourceRoot":"","sources":["../src/asset-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAc/C;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA+CnC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAgEf"}

package/dist/asset-discovery.js

@@ -0,0 +1,144 @@
+/**
+ * Asset Discovery Utilities
+ *
+ * Discover and extract UI, prompt, and resource assets from Photon files.
+ * Extracted from photon's loader.ts.
+ *
+ * Depends on: getMimeType (from ./mime-types), SchemaExtractor (from ./schema-extractor)
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { getMimeType } from './mime-types.js';
+import { SchemaExtractor } from './schema-extractor.js';
+/**
+ * Check if a file or directory exists
+ */
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Discover and extract assets from a Photon file
+ *
+ * Convention:
+ * - Asset folder: {photon-name}/ next to {photon-name}.photon.ts
+ * - Subfolder: ui/, prompts/, resources/
+ *
+ * @param photonPath - Absolute path to the .photon.ts file
+ * @param source - Source code content of the Photon file
+ */
+export async function discoverAssets(photonPath, source) {
+    const extractor = new SchemaExtractor();
+    const dir = path.dirname(photonPath);
+    const basename = path.basename(photonPath, '.photon.ts');
+    // Convention: asset folder has same name as photon (without .photon.ts)
+    const assetFolder = path.join(dir, basename);
+    // Check if asset folder exists
+    let folderExists = false;
+    try {
+        const stat = await fs.stat(assetFolder);
+        folderExists = stat.isDirectory();
+    }
+    catch {
+        // Folder doesn't exist
+    }
+    // Extract explicit asset declarations from source annotations
+    const assets = extractor.extractAssets(source, folderExists ? assetFolder : undefined);
+    // If no folder exists and no explicit declarations, skip
+    if (!folderExists &&
+        assets.ui.length === 0 &&
+        assets.prompts.length === 0 &&
+        assets.resources.length === 0) {
+        return undefined;
+    }
+    if (folderExists) {
+        // Resolve paths for explicitly declared assets
+        for (const ui of assets.ui) {
+            ui.resolvedPath = path.resolve(assetFolder, ui.path.replace(/^\.\//, ''));
+        }
+        for (const prompt of assets.prompts) {
+            prompt.resolvedPath = path.resolve(assetFolder, prompt.path.replace(/^\.\//, ''));
+        }
+        for (const resource of assets.resources) {
+            resource.resolvedPath = path.resolve(assetFolder, resource.path.replace(/^\.\//, ''));
+        }
+        // Auto-discover assets from folder structure
+        await autoDiscoverAssets(assetFolder, assets);
+    }
+    return assets;
+}
+/**
+ * Auto-discover assets from the ui/, prompts/, resources/ subdirectories
+ */
+export async function autoDiscoverAssets(assetFolder, assets) {
+    // Auto-discover UI files
+    const uiDir = path.join(assetFolder, 'ui');
+    if (await fileExists(uiDir)) {
+        try {
+            const files = await fs.readdir(uiDir);
+            for (const file of files) {
+                const id = path.basename(file, path.extname(file));
+                if (!assets.ui.find((u) => u.id === id)) {
+                    assets.ui.push({
+                        id,
+                        path: `./ui/${file}`,
+                        resolvedPath: path.join(uiDir, file),
+                        mimeType: getMimeType(file),
+                    });
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    // Auto-discover prompt files
+    const promptsDir = path.join(assetFolder, 'prompts');
+    if (await fileExists(promptsDir)) {
+        try {
+            const files = await fs.readdir(promptsDir);
+            for (const file of files) {
+                if (file.endsWith('.md') || file.endsWith('.txt')) {
+                    const id = path.basename(file, path.extname(file));
+                    if (!assets.prompts.find((p) => p.id === id)) {
+                        assets.prompts.push({
+                            id,
+                            path: `./prompts/${file}`,
+                            resolvedPath: path.join(promptsDir, file),
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    // Auto-discover resource files
+    const resourcesDir = path.join(assetFolder, 'resources');
+    if (await fileExists(resourcesDir)) {
+        try {
+            const files = await fs.readdir(resourcesDir);
+            for (const file of files) {
+                const id = path.basename(file, path.extname(file));
+                if (!assets.resources.find((r) => r.id === id)) {
+                    assets.resources.push({
+                        id,
+                        path: `./resources/${file}`,
+                        resolvedPath: path.join(resourcesDir, file),
+                        mimeType: getMimeType(file),
+                    });
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+}
+//# sourceMappingURL=asset-discovery.js.map

package/dist/asset-discovery.js.map

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

package/dist/class-detection.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Class Detection Utilities
+ *
+ * Shared logic for detecting Photon classes in ES modules.
+ * Extracted from photon, ncp, and lumina loaders.
+ */
+/**
+ * Check if a value is a class constructor
+ */
+export declare function isClass(fn: unknown): fn is new (...args: unknown[]) => unknown;
+/**
+ * Check if a class has async methods (instance or static)
+ *
+ * Checks for AsyncFunction, AsyncGeneratorFunction, and GeneratorFunction
+ * on both prototype (instance methods) and the class itself (static methods).
+ */
+export declare function hasAsyncMethods(ClassConstructor: new (...args: unknown[]) => unknown): boolean;
+/**
+ * Find a single Photon class in a module
+ *
+ * Priority: default export first, then named exports.
+ * Returns the first class with async methods, or null.
+ */
+export declare function findPhotonClass(module: Record<string, unknown>): (new (...args: unknown[]) => unknown) | null;
+/**
+ * Find all Photon classes in a module
+ *
+ * Returns every exported class that has async methods.
+ * Used by NCP which may load multiple classes from one file.
+ */
+export declare function findPhotonClasses(module: Record<string, unknown>): Array<new (...args: unknown[]) => unknown>;
+//# sourceMappingURL=class-detection.d.ts.map

package/dist/class-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-detection.d.ts","sourceRoot":"","sources":["../src/class-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,OAAO,CA+B9F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,IAAI,CAgB7G;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAU7G"}

package/dist/class-detection.js

@@ -0,0 +1,86 @@
+/**
+ * Class Detection Utilities
+ *
+ * Shared logic for detecting Photon classes in ES modules.
+ * Extracted from photon, ncp, and lumina loaders.
+ */
+/**
+ * Check if a value is a class constructor
+ */
+export function isClass(fn) {
+    return typeof fn === 'function' && /^\s*class\s+/.test(fn.toString());
+}
+/**
+ * Check if a class has async methods (instance or static)
+ *
+ * Checks for AsyncFunction, AsyncGeneratorFunction, and GeneratorFunction
+ * on both prototype (instance methods) and the class itself (static methods).
+ */
+export function hasAsyncMethods(ClassConstructor) {
+    const asyncCtorNames = new Set([
+        'AsyncFunction',
+        'AsyncGeneratorFunction',
+        'GeneratorFunction',
+    ]);
+    // Check instance methods on prototype
+    const prototype = ClassConstructor.prototype;
+    for (const key of Object.getOwnPropertyNames(prototype)) {
+        if (key === 'constructor')
+            continue;
+        const descriptor = Object.getOwnPropertyDescriptor(prototype, key);
+        if (descriptor && typeof descriptor.value === 'function') {
+            if (asyncCtorNames.has(descriptor.value.constructor.name)) {
+                return true;
+            }
+        }
+    }
+    // Check static methods on the class itself
+    for (const key of Object.getOwnPropertyNames(ClassConstructor)) {
+        if (['length', 'name', 'prototype'].includes(key))
+            continue;
+        const descriptor = Object.getOwnPropertyDescriptor(ClassConstructor, key);
+        if (descriptor && typeof descriptor.value === 'function') {
+            if (asyncCtorNames.has(descriptor.value.constructor.name)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Find a single Photon class in a module
+ *
+ * Priority: default export first, then named exports.
+ * Returns the first class with async methods, or null.
+ */
+export function findPhotonClass(module) {
+    // Try default export first
+    if (module.default && isClass(module.default)) {
+        if (hasAsyncMethods(module.default)) {
+            return module.default;
+        }
+    }
+    // Try named exports
+    for (const exportedItem of Object.values(module)) {
+        if (isClass(exportedItem) && hasAsyncMethods(exportedItem)) {
+            return exportedItem;
+        }
+    }
+    return null;
+}
+/**
+ * Find all Photon classes in a module
+ *
+ * Returns every exported class that has async methods.
+ * Used by NCP which may load multiple classes from one file.
+ */
+export function findPhotonClasses(module) {
+    const classes = [];
+    for (const exportedItem of Object.values(module)) {
+        if (isClass(exportedItem) && hasAsyncMethods(exportedItem)) {
+            classes.push(exportedItem);
+        }
+    }
+    return classes;
+}
+//# sourceMappingURL=class-detection.js.map

package/dist/class-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-detection.js","sourceRoot":"","sources":["../src/class-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,EAAW;IACjC,OAAO,OAAO,EAAE,KAAK,UAAU,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,gBAAqD;IACnF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;QAC7B,eAAe;QACf,wBAAwB;QACxB,mBAAmB;KACpB,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,IAAI,GAAG,KAAK,aAAa;YAAE,SAAS;QACpC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACnE,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACzD,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1D,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAC1E,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACzD,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1D,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAA+B;IAC7D,2BAA2B;IAC3B,IAAI,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,IAAI,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA+B;IAC/D,MAAM,OAAO,GAA+C,EAAE,CAAC;IAE/D,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/compiler.d.ts

@@ -0,0 +1,22 @@
+/**
+ * TypeScript Compiler Utilities
+ *
+ * Shared esbuild-based TypeScript compilation with caching.
+ * Extracted from photon and ncp loaders.
+ *
+ * NOTE: No esbuild dependency in package.json — the consumer must provide it.
+ * Uses `await import('esbuild')` for dynamic resolution.
+ */
+/**
+ * Compile a .photon.ts file to JavaScript and cache the result
+ *
+ * @param tsFilePath - Absolute path to the TypeScript source file
+ * @param options.cacheDir - Directory to store compiled output
+ * @param options.content - Optional pre-read file content (avoids extra read)
+ * @returns Absolute path to the compiled .mjs file
+ */
+export declare function compilePhotonTS(tsFilePath: string, options: {
+    cacheDir: string;
+    content?: string;
+}): Promise<string>;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,MAAM,CAAC,CA+BjB"}

package/dist/compiler.js

@@ -0,0 +1,48 @@
+/**
+ * TypeScript Compiler Utilities
+ *
+ * Shared esbuild-based TypeScript compilation with caching.
+ * Extracted from photon and ncp loaders.
+ *
+ * NOTE: No esbuild dependency in package.json — the consumer must provide it.
+ * Uses `await import('esbuild')` for dynamic resolution.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as crypto from 'crypto';
+/**
+ * Compile a .photon.ts file to JavaScript and cache the result
+ *
+ * @param tsFilePath - Absolute path to the TypeScript source file
+ * @param options.cacheDir - Directory to store compiled output
+ * @param options.content - Optional pre-read file content (avoids extra read)
+ * @returns Absolute path to the compiled .mjs file
+ */
+export async function compilePhotonTS(tsFilePath, options) {
+    const source = options.content ?? (await fs.readFile(tsFilePath, 'utf-8'));
+    const hash = crypto.createHash('sha256').update(source).digest('hex').slice(0, 16);
+    const fileName = path.basename(tsFilePath, '.ts');
+    const cachedJsPath = path.join(options.cacheDir, `${fileName}.${hash}.mjs`);
+    // Check if cached version exists
+    try {
+        await fs.access(cachedJsPath);
+        return cachedJsPath;
+    }
+    catch {
+        // Cache miss — compile
+    }
+    // Dynamic import — consumer must have esbuild installed
+    const esbuild = await import('esbuild');
+    const result = await esbuild.transform(source, {
+        loader: 'ts',
+        format: 'esm',
+        target: 'es2022',
+        sourcemap: 'inline',
+    });
+    // Ensure cache directory exists
+    await fs.mkdir(options.cacheDir, { recursive: true });
+    // Write compiled JavaScript
+    await fs.writeFile(cachedJsPath, result.code, 'utf-8');
+    return cachedJsPath;
+}
+//# sourceMappingURL=compiler.js.map

package/dist/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,OAA+C;IAE/C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEnF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,QAAQ,IAAI,IAAI,MAAM,CAAC,CAAC;IAE5E,iCAAiC;IACjC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC9B,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;IAED,wDAAwD;IACxD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE;QAC7C,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;IAEH,gCAAgC;IAChC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtD,4BAA4B;IAC5B,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEvD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/env-utils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Environment Variable Utilities
+ *
+ * Shared logic for resolving constructor parameters from environment variables.
+ * Extracted from photon's config-docs.ts and lumina's photon-loader.ts.
+ */
+/**
+ * Minimal constructor parameter info needed for env resolution.
+ * Compatible with both photon-core's full ConstructorParam and
+ * lumina's simplified version (which omits isPrimitive).
+ */
+export interface EnvConstructorParam {
+    name: string;
+    type: string;
+    isOptional: boolean;
+    hasDefault: boolean;
+    defaultValue?: any;
+}
+/**
+ * Info about a missing required parameter
+ */
+export interface MissingParamInfo {
+    paramName: string;
+    envVarName: string;
+    type: string;
+}
+/**
+ * Convert a photon name and parameter name to an environment variable name
+ *
+ * @example toEnvVarName('my-mcp', 'apiKey') → 'MY_MCP_API_KEY'
+ */
+export declare function toEnvVarName(photonName: string, paramName: string): string;
+/**
+ * Parse an environment variable string value to the appropriate type
+ */
+export declare function parseEnvValue(value: string, type: string): any;
+/**
+ * Generate a sensible example value for a parameter based on its name and type
+ */
+export declare function generateExampleValue(paramName: string, paramType: string): string | null;
+/**
+ * Generate documentation and example env vars for constructor parameters
+ */
+export declare function summarizeConstructorParams(params: EnvConstructorParam[], photonName: string): {
+    docs: string;
+    exampleEnv: Record<string, string>;
+};
+/**
+ * Generate a user-friendly error message for missing configuration
+ */
+export declare function generateConfigErrorMessage(photonName: string, missing: MissingParamInfo[]): string;
+/**
+ * Resolve constructor arguments from environment variables
+ *
+ * @returns values array (aligned with params) and configError string if any required params are missing
+ */
+export declare function resolveEnvArgs(params: EnvConstructorParam[], photonName: string): {
+    values: any[];
+    missing: MissingParamInfo[];
+};
+//# sourceMappingURL=env-utils.d.ts.map

package/dist/env-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-utils.d.ts","sourceRoot":"","sources":["../src/env-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAO1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAU9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4CxF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,mBAAmB,EAAE,EAC7B,UAAU,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA8BtD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,EAAE,GAC1B,MAAM,CAmCR;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,mBAAmB,EAAE,EAC7B,UAAU,EAAE,MAAM,GACjB;IAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAmBhD"}

package/dist/env-utils.js

@@ -0,0 +1,171 @@
+/**
+ * Environment Variable Utilities
+ *
+ * Shared logic for resolving constructor parameters from environment variables.
+ * Extracted from photon's config-docs.ts and lumina's photon-loader.ts.
+ */
+/**
+ * Convert a photon name and parameter name to an environment variable name
+ *
+ * @example toEnvVarName('my-mcp', 'apiKey') → 'MY_MCP_API_KEY'
+ */
+export function toEnvVarName(photonName, paramName) {
+    const prefix = photonName.toUpperCase().replace(/-/g, '_');
+    const suffix = paramName
+        .replace(/([A-Z])/g, '_$1')
+        .toUpperCase()
+        .replace(/^_/, '');
+    return `${prefix}_${suffix}`;
+}
+/**
+ * Parse an environment variable string value to the appropriate type
+ */
+export function parseEnvValue(value, type) {
+    switch (type) {
+        case 'number':
+            return parseFloat(value);
+        case 'boolean':
+            return value.toLowerCase() === 'true';
+        case 'string':
+        default:
+            return value;
+    }
+}
+/**
+ * Generate a sensible example value for a parameter based on its name and type
+ */
+export function generateExampleValue(paramName, paramType) {
+    const lowerName = paramName.toLowerCase();
+    if (lowerName.includes('apikey') || lowerName.includes('api_key')) {
+        return 'sk_your_api_key_here';
+    }
+    if (lowerName.includes('token') || lowerName.includes('secret')) {
+        return 'your_secret_token';
+    }
+    if (lowerName.includes('url') || lowerName.includes('endpoint')) {
+        return 'https://api.example.com';
+    }
+    if (lowerName.includes('host') || lowerName.includes('server')) {
+        return 'localhost';
+    }
+    if (lowerName.includes('port')) {
+        return '5432';
+    }
+    if (lowerName.includes('database') || lowerName.includes('db')) {
+        return 'my_database';
+    }
+    if (lowerName.includes('user') || lowerName.includes('username')) {
+        return 'admin';
+    }
+    if (lowerName.includes('password')) {
+        return 'your_secure_password';
+    }
+    if (lowerName.includes('path') || lowerName.includes('dir')) {
+        return '/path/to/directory';
+    }
+    if (lowerName.includes('name')) {
+        return 'my-service';
+    }
+    if (lowerName.includes('region')) {
+        return 'us-east-1';
+    }
+    if (paramType === 'boolean') {
+        return 'true';
+    }
+    if (paramType === 'number') {
+        return '3000';
+    }
+    return null;
+}
+/**
+ * Generate documentation and example env vars for constructor parameters
+ */
+export function summarizeConstructorParams(params, photonName) {
+    const docs = params
+        .map((param) => {
+        const envVarName = toEnvVarName(photonName, param.name);
+        const required = !param.isOptional && !param.hasDefault;
+        const status = required ? '[REQUIRED]' : '[OPTIONAL]';
+        const defaultInfo = param.hasDefault
+            ? ` (default: ${JSON.stringify(param.defaultValue)})`
+            : '';
+        const exampleValue = generateExampleValue(param.name, param.type);
+        let line = `  • ${envVarName} ${status}`;
+        line += `\n    Type: ${param.type}${defaultInfo}`;
+        if (exampleValue) {
+            line += `\n    Example: ${envVarName}="${exampleValue}"`;
+        }
+        return line;
+    })
+        .join('\n\n');
+    const exampleEnv = {};
+    params.forEach((param) => {
+        const envVarName = toEnvVarName(photonName, param.name);
+        if (!param.isOptional && !param.hasDefault) {
+            exampleEnv[envVarName] =
+                generateExampleValue(param.name, param.type) || `your-${param.name}`;
+        }
+    });
+    return { docs, exampleEnv };
+}
+/**
+ * Generate a user-friendly error message for missing configuration
+ */
+export function generateConfigErrorMessage(photonName, missing) {
+    const envVarList = missing
+        .map((m) => `  • ${m.envVarName} (${m.paramName}: ${m.type})`)
+        .join('\n');
+    const exampleEnv = Object.fromEntries(missing.map((m) => [m.envVarName, `<your-${m.paramName}>`]));
+    return `
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚠️  Configuration Warning: ${photonName} MCP
+
+Missing required environment variables:
+${envVarList}
+
+Tools will fail until configuration is fixed.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+To fix, add environment variables to your MCP client config:
+
+{
+  "mcpServers": {
+    "${photonName}": {
+      "command": "npx",
+      "args": ["@portel/photon", "${photonName}"],
+      "env": ${JSON.stringify(exampleEnv, null, 8).replace(/\n/g, '\n      ')}
+    }
+  }
+}
+
+Or run: photon ${photonName} --config
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`.trim();
+}
+/**
+ * Resolve constructor arguments from environment variables
+ *
+ * @returns values array (aligned with params) and configError string if any required params are missing
+ */
+export function resolveEnvArgs(params, photonName) {
+    const values = [];
+    const missing = [];
+    for (const param of params) {
+        const envVarName = toEnvVarName(photonName, param.name);
+        const envValue = process.env[envVarName];
+        if (envValue !== undefined) {
+            values.push(parseEnvValue(envValue, param.type));
+        }
+        else if (param.hasDefault || param.isOptional) {
+            values.push(undefined);
+        }
+        else {
+            missing.push({ paramName: param.name, envVarName, type: param.type });
+            values.push(undefined);
+        }
+    }
+    return { values, missing };
+}
+//# sourceMappingURL=env-utils.js.map

package/dist/env-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-utils.js","sourceRoot":"","sources":["../src/env-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,SAAiB;IAChE,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,SAAS;SACrB,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SAC1B,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrB,OAAO,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,IAAY;IACvD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3B,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;QACxC,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,SAAiB;IACvE,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAE1C,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChE,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAChE,OAAO,yBAAyB,CAAC;IACnC,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/D,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjE,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAA6B,EAC7B,UAAkB;IAElB,MAAM,IAAI,GAAG,MAAM;SAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;QACxD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;QACtD,MAAM,WAAW,GAAG,KAAK,CAAC,UAAU;YAClC,CAAC,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG;YACrD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAElE,IAAI,IAAI,GAAG,OAAO,UAAU,IAAI,MAAM,EAAE,CAAC;QACzC,IAAI,IAAI,eAAe,KAAK,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;QAClD,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,IAAI,kBAAkB,UAAU,KAAK,YAAY,GAAG,CAAC;QAC3D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC3C,UAAU,CAAC,UAAU,CAAC;gBACpB,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACzE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAkB,EAClB,OAA2B;IAE3B,MAAM,UAAU,GAAG,OAAO;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC;SAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CACnC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAC5D,CAAC;IAEF,OAAO;;6BAEoB,UAAU;;;EAGrC,UAAU;;;;;;;;;;OAUL,UAAU;;oCAEmB,UAAU;eAC/B,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC;;;;;iBAK5D,UAAU;;;CAG1B,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,MAA6B,EAC7B,UAAkB;IAElB,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACtE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -51,4 +51,11 @@ export * from './channels/index.js';
 export { withLock, setLockManager, getLockManager, type LockManager, } from './decorators.js';
 export { type McpAppsInitialize, type McpAppsToolInput, type McpAppsToolResult, type McpAppsHostContextChanged, type McpAppsResourceTeardown, type McpAppsModelContextUpdate, type PlatformContext, createMcpAppsInitialize, createThemeChangeMessages, } from './mcp-apps.js';
 export { getPhotonConfigDir, getPhotonConfigPath, loadPhotonConfig, savePhotonConfig, hasPhotonConfig, deletePhotonConfig, listConfiguredPhotons, } from './config.js';
+export { isClass, hasAsyncMethods, findPhotonClass, findPhotonClasses, } from './class-detection.js';
+export { toEnvVarName, parseEnvValue, generateExampleValue, summarizeConstructorParams, generateConfigErrorMessage, resolveEnvArgs, type MissingParamInfo, type EnvConstructorParam, } from './env-utils.js';
+export { compilePhotonTS } from './compiler.js';
+export { getMimeType } from './mime-types.js';
+export { parseRuntimeRequirement, checkRuntimeCompatibility, } from './version-check.js';
+export { PhotonError, ValidationError, type ValidationResult, type Validator, combineResults, isString, isNumber, isBoolean, isObject, isArray, notEmpty, hasLength, matchesPattern, isEmail, isUrl, inRange, isPositive, isInteger, hasArrayLength, arrayOf, hasFields, oneOf, validate, validateOrThrow, pathExists, hasExtension, assertDefined, assertString, assertNumber, assertObject, assertArray, } from './validation.js';
+export { discoverAssets, autoDiscoverAssets, } from './asset-discovery.js';
 //# sourceMappingURL=index.d.ts.map