lua-cli 3.5.0-alpha.3 → 3.5.0-beta.1

package/dist/compiler/bundler.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Bundler — esbuild bundling for primitives.
+ *
+ * Extracted from Compiler to separate bundling concerns:
+ * - Virtual source plugin (handles non-exported primitives)
+ * - Lua-CLI shim plugin (strips lua-cli imports for VM sandbox)
+ * - esbuild bundling with source maps
+ */
+import { Project } from 'ts-morph';
+import type { PrimitiveMetadata, BundledArtifact } from './types.js';
+export interface BundlerOptions {
+    outDir: string;
+    minify: boolean;
+    sourceMaps: boolean;
+    debug: boolean;
+}
+export declare class Bundler {
+    private options;
+    private project;
+    private verbose;
+    constructor(options: BundlerOptions, project: Project, verbose: (msg: string) => void);
+    /**
+     * Strip lua-cli and api-exports import statements from source code using TypeScript AST.
+     * This is more robust than regex and handles all edge cases (multiline, comments, etc.).
+     */
+    private stripLuaCliImportsAST;
+    /**
+     * Bundle a primitive's entry point using esbuild.
+     */
+    bundle(metadata: PrimitiveMetadata, entryPointCode: string): Promise<BundledArtifact>;
+    /**
+     * Create esbuild plugin that serves the source file as a virtual module
+     * with an appended named export for the primitive.
+     */
+    private createVirtualSourcePlugin;
+    /**
+     * Create esbuild plugin that strips lua-cli and api-exports imports using TypeScript AST.
+     * Uses ts-morph to properly parse and remove import declarations, handling all edge cases
+     * including multiline imports, comments, and complex syntax that regex can't handle.
+     */
+    private createLuaCliShimPlugin;
+}

package/dist/compiler/bundler.js

@@ -0,0 +1,187 @@
+/**
+ * Bundler — esbuild bundling for primitives.
+ *
+ * Extracted from Compiler to separate bundling concerns:
+ * - Virtual source plugin (handles non-exported primitives)
+ * - Lua-CLI shim plugin (strips lua-cli imports for VM sandbox)
+ * - esbuild bundling with source maps
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import crypto from 'crypto';
+import { build } from 'esbuild';
+export class Bundler {
+    constructor(options, project, verbose) {
+        this.options = options;
+        this.project = project;
+        this.verbose = verbose;
+    }
+    /**
+     * Strip lua-cli and api-exports import statements from source code using TypeScript AST.
+     * This is more robust than regex and handles all edge cases (multiline, comments, etc.).
+     */
+    stripLuaCliImportsAST(code, filename = 'temp.ts') {
+        try {
+            // Create temporary source file for parsing
+            const tempFile = this.project.createSourceFile(`__strip_${filename}`, code, {
+                overwrite: true,
+            });
+            // Find and remove lua-cli and api-exports imports
+            const imports = tempFile.getImportDeclarations();
+            imports.forEach((imp) => {
+                const moduleSpecifier = imp.getModuleSpecifierValue();
+                if (moduleSpecifier === 'lua-cli' ||
+                    moduleSpecifier === 'lua-cli/skill' ||
+                    moduleSpecifier.includes('api-exports')) {
+                    imp.remove();
+                }
+            });
+            const result = tempFile.getText();
+            this.project.removeSourceFile(tempFile);
+            return result;
+        }
+        catch (error) {
+            // Fallback to original code if parsing fails
+            return code;
+        }
+    }
+    /**
+     * Bundle a primitive's entry point using esbuild.
+     */
+    async bundle(metadata, entryPointCode) {
+        const tempDir = path.join(this.options.outDir, '.temp');
+        const outfile = path.join(tempDir, `${metadata.kind}-${metadata.name}.bundle.js`);
+        const sourceDir = path.dirname(metadata.sourcePath);
+        if (this.options.debug) {
+            this.verbose(`      Source: ${metadata.sourcePath}`);
+            this.verbose(`      Output: ${outfile}`);
+        }
+        const virtualSourcePlugin = this.createVirtualSourcePlugin(metadata);
+        const luaCliShimPlugin = this.createLuaCliShimPlugin();
+        await build({
+            stdin: {
+                contents: entryPointCode,
+                resolveDir: sourceDir,
+                loader: 'ts',
+                sourcefile: `${metadata.kind}-${metadata.name}-entry.ts`,
+            },
+            bundle: true,
+            format: 'cjs',
+            platform: 'node',
+            target: 'node18',
+            minify: this.options.minify,
+            sourcemap: this.options.sourceMaps ? 'external' : false,
+            outfile,
+            external: ['zod'],
+            plugins: [luaCliShimPlugin, virtualSourcePlugin],
+            logLevel: this.options.debug ? 'debug' : 'silent',
+        });
+        const code = await fs.readFile(outfile, 'utf-8');
+        let sourceMap = '';
+        try {
+            sourceMap = await fs.readFile(outfile + '.map', 'utf-8');
+        }
+        catch { /* no source map */ }
+        const originalSource = await fs.readFile(metadata.sourcePath, 'utf-8');
+        const hash = crypto.createHash('sha256').update(code).digest('hex').slice(0, 16);
+        const stats = await fs.stat(outfile);
+        return { code, sourceMap, originalSource, size: stats.size, hash };
+    }
+    /**
+     * Create esbuild plugin that serves the source file as a virtual module
+     * with an appended named export for the primitive.
+     */
+    createVirtualSourcePlugin(metadata) {
+        const bundler = this;
+        const sourcePath = metadata.sourcePath;
+        const exportName = metadata.exportName;
+        const sourceDir = path.dirname(sourcePath);
+        return {
+            name: 'lua-virtual-source',
+            setup(build) {
+                build.onResolve({ filter: /.*/ }, (args) => {
+                    const resolved = args.path.startsWith('.')
+                        ? path.resolve(args.resolveDir, args.path)
+                        : args.path;
+                    const normalizedResolved = resolved.replace(/\.(ts|tsx|js|jsx)$/, '');
+                    const normalizedSource = sourcePath.replace(/\.(ts|tsx|js|jsx)$/, '');
+                    if (normalizedResolved === normalizedSource) {
+                        return { path: sourcePath, namespace: 'lua-virtual-source' };
+                    }
+                    return null;
+                });
+                build.onLoad({ filter: /.*/, namespace: 'lua-virtual-source' }, async () => {
+                    const sourceFile = bundler.project.getSourceFile(sourcePath);
+                    let content = sourceFile?.getText() ?? await fs.readFile(sourcePath, 'utf-8');
+                    content = bundler.stripLuaCliImportsAST(content, path.basename(sourcePath));
+                    const virtualContent = metadata.isDefaultExport
+                        ? content
+                        : `${content}\nexport { ${exportName} as __lua_target__ };\n`;
+                    return { contents: virtualContent, loader: 'ts', resolveDir: sourceDir };
+                });
+            },
+        };
+    }
+    /**
+     * Create esbuild plugin that strips lua-cli and api-exports imports using TypeScript AST.
+     * Uses ts-morph to properly parse and remove import declarations, handling all edge cases
+     * including multiline imports, comments, and complex syntax that regex can't handle.
+     */
+    createLuaCliShimPlugin() {
+        const stripImports = this.stripLuaCliImportsAST.bind(this);
+        const debug = this.options.debug;
+        const verbose = this.verbose.bind(this);
+        return {
+            name: 'lua-cli-import-stripper',
+            setup(build) {
+                // Strip lua-cli imports from all source files using AST parsing
+                build.onLoad({ filter: /\.([jt]sx?)$/, namespace: 'file' }, async (args) => {
+                    // Skip node_modules
+                    if (args.path.includes('node_modules'))
+                        return null;
+                    // Quick check: does file contain lua-cli or api-exports imports?
+                    const contents = await fs.readFile(args.path, 'utf-8');
+                    if (!contents.includes('lua-cli') && !contents.includes('api-exports')) {
+                        return null; // No lua-cli imports, let esbuild handle normally
+                    }
+                    // Use ts-morph to parse and remove imports
+                    try {
+                        const modifiedContents = stripImports(contents, path.basename(args.path));
+                        // Only return modified contents if something changed
+                        if (modifiedContents !== contents) {
+                            return {
+                                contents: modifiedContents,
+                                loader: args.path.endsWith('.ts') || args.path.endsWith('.tsx') ? 'ts' : 'js',
+                                resolveDir: path.dirname(args.path),
+                            };
+                        }
+                        return null;
+                    }
+                    catch (error) {
+                        // If AST parsing fails, fall back to original content
+                        // The safety-net onResolve below will catch any remaining imports
+                        if (debug) {
+                            verbose(`      Warning: Failed to parse ${args.path} with ts-morph, using fallback`);
+                        }
+                        return null;
+                    }
+                });
+                // Safety net: catch any lua-cli imports that somehow weren't stripped
+                // This handles edge cases where AST parsing might fail or imports are dynamically generated
+                build.onResolve({ filter: /^lua-cli(\/skill)?$/ }, () => ({
+                    path: 'lua-cli-empty',
+                    namespace: 'lua-cli-empty',
+                }));
+                build.onResolve({ filter: /api-exports(\.(js|ts))?$/ }, () => ({
+                    path: 'lua-cli-empty',
+                    namespace: 'lua-cli-empty',
+                }));
+                build.onLoad({ filter: /.*/, namespace: 'lua-cli-empty' }, () => ({
+                    contents: '/* lua-cli stripped - APIs provided by VM sandbox */',
+                    loader: 'js',
+                }));
+            },
+        };
+    }
+}
+//# sourceMappingURL=bundler.js.map

package/dist/compiler/bundler.js.map

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

package/dist/compiler/compiler.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Main Lua Compiler
+ *
+ * This is the entry point for compilation. It orchestrates:
+ * 1. Scanning source files for primitives
+ * 2. Validating all primitives
+ * 3. Bundling each primitive with esbuild
+ * 4. Writing artifacts to disk
+ */
+import { CompilerOptions, CompilationResult } from './types.js';
+export * from './types.js';
+export declare class Compiler {
+    private project;
+    private options;
+    private bundler;
+    /** Cached agent info from traversal (avoids re-traversing for manifest) */
+    private cachedAgentInfo;
+    constructor(options: CompilerOptions);
+    /**
+     * Run the compilation.
+     */
+    compile(): Promise<CompilationResult>;
+    /**
+     * Scan for primitives using agent traversal (preferred) or fallback to full scan.
+     *
+     * Agent traversal only compiles primitives that are actually registered with
+     * a LuaAgent, matching the old compiler's behavior.
+     *
+     * Also caches the agent info for manifest creation (avoids re-traversing).
+     */
+    private scanForPrimitives;
+    /**
+     * Fallback discovery: scan all source files for primitives when no LuaAgent is found.
+     *
+     * Unlike agent traversal (which only compiles registered primitives), this method
+     * runs every plugin on every source file to discover ALL primitive-like code:
+     * - ToolPlugin: defineTool() OR classes extending/implementing LuaTool
+     * - JobPlugin: defineJob() OR new LuaJob({...})
+     * - WebhookPlugin: defineWebhook() OR new LuaWebhook({...})
+     * - PreProcessorPlugin: definePreProcessor() OR new PreProcessor({...})
+     * - PostProcessorPlugin: definePostProcessor() OR new PostProcessor({...})
+     * - McpServerPlugin: defineMCPServer() OR new LuaMCPServer({...})
+     *
+     * This is less precise and may include unused primitives, but necessary for
+     * projects that don't use the LuaAgent pattern.
+     *
+     * @returns All detected primitive metadata from the entire codebase
+     */
+    private scanAllFiles;
+    /**
+     * Compile primitives in parallel with a concurrency limit.
+     * Returns results in the same order as input, with either compiled primitive or error.
+     */
+    private compileInParallel;
+    /**
+     * Compile a single primitive through the full pipeline.
+     *
+     * The compilation pipeline for each primitive:
+     * 1. Generate entry point code via the plugin
+     * 2. Bundle with esbuild using stdin (no temp entry file) + virtual module plugin
+     * 3. Run plugin's post-processing hook (if any)
+     * 4. Extract schemas via plugin (e.g., Zod → JSON Schema for tools)
+     *
+     * Uses esbuild's stdin option for the entry point and a virtual module plugin
+     * that appends `export { X as __lua_target__ }` to the source file. This
+     * eliminates all temp files while handling non-exported primitives correctly.
+     *
+     * @param metadata - Primitive metadata from detection phase
+     * @returns Compiled primitive with bundled code, schemas, and metadata, or null if plugin not found
+     */
+    private compilePrimitive;
+    /**
+     * Write all compilation artifacts to disk with full project preservation.
+     *
+     * Output structure:
+     * ```
+     * dist-v2/
+     * ├── artifacts/
+     * │   ├── tool/
+     * │   │   ├── {name}.js      # Bundled code
+     * │   │   ├── {name}.js.map  # Source map
+     * │   │   └── {name}.json    # Metadata (schemas, description, etc.)
+     * │   ├── job/
+     * │   ├── webhook/
+     * │   └── ...
+     * ├── sources/
+     * │   └── {hash}.ts          # Deduplicated source files (by content hash)
+     * └── manifest.json          # Full compilation manifest
+     * ```
+     *
+     * @param primitives - All compiled primitives to write
+     */
+    private writeArtifacts;
+    /**
+     * Write primitive artifacts: bundles, source maps, and metadata JSON files.
+     */
+    private writePrimitiveArtifacts;
+    /**
+     * Store all project files for full reconstruction (enables `lua init --from-server`).
+     * Returns the list of project files with their hashes.
+     */
+    private storeProjectFiles;
+    /**
+     * Create the compilation manifest with all metadata.
+     *
+     * Uses cached agent info from scanForPrimitives() to avoid re-traversing.
+     * Delegates to each plugin's toManifestEntry() for type-specific fields.
+     */
+    private createManifest;
+    /**
+     * Map compiled primitives to manifest entries using plugins.
+     * Single source of truth for primitive → manifest conversion.
+     */
+    private mapPrimitivesToManifest;
+    /**
+     * Recursively collect all project files for full reconstruction.
+     *
+     * This enables `lua init --from-server` to recreate the exact project structure.
+     *
+     * File categorization:
+     * - 'source': .ts, .tsx, .js files
+     * - 'config': package.json, tsconfig.json, lua.skill.yaml, *.yaml, *.yml, *.json
+     * - 'other': README.md, .env.example, etc.
+     *
+     * Excludes (via shouldSkipDirectory/shouldSkipFile):
+     * - node_modules, dist, .git, coverage, etc.
+     * - test files, declaration files, lock files
+     *
+     * @returns Array of file info with relative paths and categorized types
+     */
+    private collectProjectFiles;
+    /**
+     * Log the output directory tree.
+     */
+    private logTree;
+    /**
+     * Create the compilation result with stats.
+     * Note: The full manifest (with projectFiles) is written by writeArtifacts.
+     * This returns a minimal manifest for the result object.
+     */
+    private createResult;
+    /**
+     * Calculate compilation statistics.
+     */
+    private calculateStats;
+    /**
+     * Create a minimal manifest for the result object.
+     * The full manifest (with projectFiles) is written to disk by writeArtifacts.
+     */
+    private createMinimalManifest;
+    /**
+     * Log a message (always shown).
+     */
+    private log;
+    /**
+     * Log a verbose message (only shown in verbose or debug mode).
+     */
+    private verbose;
+}
+/**
+ * Compile a Lua project.
+ *
+ * @example
+ * ```typescript
+ * const result = await compile({
+ *   rootDir: process.cwd(),
+ *   outDir: 'dist',
+ * });
+ *
+ * if (!result.success) {
+ *   console.error('Compilation failed:');
+ *   result.errors.forEach(e => console.error(`  ${e.message}`));
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export declare function compile(options: CompilerOptions): Promise<CompilationResult>;