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

package/dist/compiler/plugins/registry.js

@@ -0,0 +1,107 @@
+/**
+ * Plugin registry for the compilation system.
+ *
+ * This is where all primitive type plugins are registered.
+ * To add a new primitive type:
+ * 1. Create a new plugin class implementing CompilationPlugin
+ * 2. Import it here
+ * 3. Register it in the constructor
+ *
+ * That's the ONLY place you need to change.
+ */
+import { ToolPlugin } from './tool.plugin.js';
+import { JobPlugin } from './job.plugin.js';
+import { WebhookPlugin } from './webhook.plugin.js';
+import { PreProcessorPlugin } from './preprocessor.plugin.js';
+import { PostProcessorPlugin } from './postprocessor.plugin.js';
+import { MCPServerPlugin } from './mcp-server.plugin.js';
+import { SkillPlugin } from './skill.plugin.js';
+/**
+ * Registry of all compilation plugins.
+ *
+ * Plugins are looked up by their 'kind' property, which must match
+ * the primitive's kind value exactly.
+ */
+export class PluginRegistry {
+    constructor() {
+        // =========================================================================
+        // REGISTER ALL PLUGINS HERE
+        // =========================================================================
+        // To add a new primitive type, just add a line here:
+        this.plugins = new Map();
+        this.register(new ToolPlugin());
+        this.register(new JobPlugin());
+        this.register(new WebhookPlugin());
+        this.register(new PreProcessorPlugin());
+        this.register(new PostProcessorPlugin());
+        this.register(new MCPServerPlugin());
+        this.register(new SkillPlugin());
+        // =========================================================================
+    }
+    /**
+     * Register a plugin.
+     * @throws Error if a plugin with the same kind is already registered
+     */
+    register(plugin) {
+        if (this.plugins.has(plugin.kind)) {
+            throw new Error(`Plugin conflict: A plugin for kind '${plugin.kind}' is already registered. ` +
+                `Each primitive type can only have one plugin.`);
+        }
+        this.plugins.set(plugin.kind, plugin);
+    }
+    /**
+     * Get a plugin by kind.
+     */
+    get(kind) {
+        return this.plugins.get(kind);
+    }
+    /**
+     * Get all registered plugins.
+     */
+    getAll() {
+        return Array.from(this.plugins.values());
+    }
+    /**
+     * Get all registered primitive kinds.
+     */
+    getAllKinds() {
+        return Array.from(this.plugins.keys());
+    }
+    /**
+     * Check if a plugin exists for a kind.
+     */
+    has(kind) {
+        return this.plugins.has(kind);
+    }
+    /**
+     * Get the number of registered plugins.
+     */
+    get size() {
+        return this.plugins.size;
+    }
+}
+// =============================================================================
+// SINGLETON INSTANCE
+// =============================================================================
+/**
+ * The global plugin registry instance.
+ * Use this in the compiler and CLI.
+ */
+export const pluginRegistry = new PluginRegistry();
+// =============================================================================
+// HELPER FUNCTIONS
+// =============================================================================
+/**
+ * Get all define function names (for detection).
+ * E.g., ['defineTool', 'defineJob', 'defineWebhook', ...]
+ */
+export function getAllDefineFunctions() {
+    return pluginRegistry.getAll().map(p => p.defineFunction);
+}
+/**
+ * Get plugin by define function name.
+ */
+export function getPluginByDefineFunction(funcName) {
+    return pluginRegistry.getAll().find(p => p.defineFunction === funcName);
+}
+//# sourceMappingURL=registry.js.map

package/dist/compiler/plugins/registry.js.map

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

package/dist/compiler/plugins/skill.plugin.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Skill compilation plugin.
+ *
+ * BACKWARD COMPATIBLE: Detects BOTH patterns:
+ * 1. Class-based (legacy): new LuaSkill({ ... })
+ * 2. Function-based (new): const mySkill = defineSkill({ ... })
+ *
+ * Skills are containers that group tools together. Unlike other primitives,
+ * skills don't have executable code - they are configuration/metadata that
+ * defines tool groupings and shared context.
+ *
+ * Output: JSON metadata file (not bundled JS) containing:
+ * - name, description, context
+ * - tool references (names of tools belonging to this skill)
+ */
+import { SourceFile, ObjectLiteralExpression } from 'ts-morph';
+import { type PrimitiveMetadata, type SkillMetadata, type SkillMetadataFields, type ValidationResult, type ManifestContext, type CompiledPrimitive, type ManifestPrimitive } from '../types.js';
+import { BasePlugin, ReferenceResolverContext } from './base.js';
+/**
+ * Plugin for compiling skill primitives.
+ * Extends BasePlugin for common detection/entry point logic.
+ */
+export declare class SkillPlugin extends BasePlugin<SkillMetadataFields> {
+    readonly kind = "skill";
+    readonly displayName = "Skill";
+    readonly defineFunction = "defineSkill";
+    readonly legacyClassNames: string[];
+    /**
+     * Extract metadata from skill config object.
+     */
+    protected extractFromConfig(config: ObjectLiteralExpression, exportName: string, sourcePath: string, position: {
+        line: number;
+        column: number;
+    }, pattern: 'function' | 'class'): SkillMetadata | null;
+    /**
+     * Extract tool references from the tools array.
+     *
+     * Handles:
+     * - new ToolClass() → extracts class name
+     * - toolVariable → extracts variable name
+     */
+    private extractToolRefs;
+    /**
+     * Detect tools added via .addTools([...]) or .addTool(new Tool()) method calls.
+     * These are an alternative to the constructor tools: [...] array.
+     */
+    private extractToolRefsFromMethodCalls;
+    validate(metadata: SkillMetadata): ValidationResult;
+    /**
+     * Add context and tools fields to the entry point.
+     */
+    protected getEntryPointFields(metadata: SkillMetadata): string;
+    /**
+     * Resolve tool references from this skill.
+     *
+     * Skills reference tools by class/variable name. This method:
+     * 1. Finds where each tool is imported from
+     * 2. Uses ToolPlugin to detect the tool in that file
+     * 3. Returns the tool metadata for compilation
+     */
+    resolveReferences(metadata: PrimitiveMetadata, sourceFile: SourceFile, context: ReferenceResolverContext): PrimitiveMetadata[];
+    /**
+     * Resolve a class import to its source file path.
+     */
+    private resolveClassImport;
+    /**
+     * Create the manifest entry for a skill.
+     * Resolves tool class names to actual tool names using context.
+     */
+    toManifestEntry(compiled: CompiledPrimitive, context?: ManifestContext): ManifestPrimitive;
+}

package/dist/compiler/plugins/skill.plugin.js

@@ -0,0 +1,243 @@
+/**
+ * Skill compilation plugin.
+ *
+ * BACKWARD COMPATIBLE: Detects BOTH patterns:
+ * 1. Class-based (legacy): new LuaSkill({ ... })
+ * 2. Function-based (new): const mySkill = defineSkill({ ... })
+ *
+ * Skills are containers that group tools together. Unlike other primitives,
+ * skills don't have executable code - they are configuration/metadata that
+ * defines tool groupings and shared context.
+ *
+ * Output: JSON metadata file (not bundled JS) containing:
+ * - name, description, context
+ * - tool references (names of tools belonging to this skill)
+ */
+import { Node } from 'ts-morph';
+import { findImportSource } from '../utils/ast-helpers.js';
+import { PrimitiveKind, } from '../types.js';
+import { BasePlugin, validationError, validationWarning } from './base.js';
+import { extractStringProperty } from '../utils/ast-helpers.js';
+/**
+ * Plugin for compiling skill primitives.
+ * Extends BasePlugin for common detection/entry point logic.
+ */
+export class SkillPlugin extends BasePlugin {
+    constructor() {
+        super(...arguments);
+        this.kind = 'skill';
+        this.displayName = 'Skill';
+        this.defineFunction = 'defineSkill';
+        this.legacyClassNames = ['LuaSkill'];
+    }
+    /**
+     * Extract metadata from skill config object.
+     */
+    extractFromConfig(config, exportName, sourcePath, position, pattern) {
+        const common = this.extractCommonFields(config, exportName, sourcePath, position);
+        if (!common)
+            return null;
+        const context = extractStringProperty(config, 'context');
+        // Extract tool references from constructor tools array
+        const toolRefs = this.extractToolRefs(config);
+        // Also detect tools added via .addTools() / .addTool() method calls
+        const methodToolRefs = this.extractToolRefsFromMethodCalls(config.getSourceFile());
+        toolRefs.push(...methodToolRefs);
+        return {
+            kind: this.kind,
+            ...common,
+            metadata: {
+                pattern,
+                context,
+                toolRefs,
+            },
+        };
+    }
+    /**
+     * Extract tool references from the tools array.
+     *
+     * Handles:
+     * - new ToolClass() → extracts class name
+     * - toolVariable → extracts variable name
+     */
+    extractToolRefs(config) {
+        const refs = [];
+        const toolsProp = config.getProperty('tools');
+        if (!toolsProp || !Node.isPropertyAssignment(toolsProp))
+            return refs;
+        const toolsValue = toolsProp.getInitializer();
+        if (!toolsValue || !Node.isArrayLiteralExpression(toolsValue))
+            return refs;
+        for (const element of toolsValue.getElements()) {
+            if (Node.isNewExpression(element)) {
+                // new ToolClass() → get class name
+                const className = element.getExpression().getText();
+                refs.push(className);
+            }
+            else if (Node.isIdentifier(element)) {
+                // toolVariable → get variable name
+                refs.push(element.getText());
+            }
+            else if (Node.isCallExpression(element)) {
+                // defineTool(...) or someFactory() → try to get the assigned name
+                // This is trickier - for now just note we have a tool
+                refs.push(`__inline_tool_${refs.length}`);
+            }
+        }
+        return refs;
+    }
+    /**
+     * Detect tools added via .addTools([...]) or .addTool(new Tool()) method calls.
+     * These are an alternative to the constructor tools: [...] array.
+     */
+    extractToolRefsFromMethodCalls(sourceFile) {
+        const refs = [];
+        sourceFile.forEachDescendant((node) => {
+            if (!Node.isCallExpression(node))
+                return;
+            const expression = node.getExpression();
+            if (!Node.isPropertyAccessExpression(expression))
+                return;
+            const property = expression.getName();
+            if (property !== 'addTools' && property !== 'addTool')
+                return;
+            const args = node.getArguments();
+            if (args.length === 0)
+                return;
+            if (property === 'addTools') {
+                const arrayArg = args[0];
+                if (Node.isArrayLiteralExpression(arrayArg)) {
+                    for (const element of arrayArg.getElements()) {
+                        if (Node.isNewExpression(element)) {
+                            refs.push(element.getExpression().getText());
+                        }
+                        else if (Node.isIdentifier(element)) {
+                            refs.push(element.getText());
+                        }
+                    }
+                }
+            }
+            else if (property === 'addTool') {
+                const arg = args[0];
+                if (Node.isNewExpression(arg)) {
+                    refs.push(arg.getExpression().getText());
+                }
+                else if (Node.isIdentifier(arg)) {
+                    refs.push(arg.getText());
+                }
+            }
+        });
+        return refs;
+    }
+    validate(metadata) {
+        const errors = [];
+        const warnings = [];
+        if (!metadata.name) {
+            errors.push(validationError('Skill must have a name', { line: metadata.line }));
+        }
+        if (!metadata.description) {
+            warnings.push(validationWarning('Skill should have a description', { line: metadata.line }));
+        }
+        if (metadata.metadata.toolRefs.length === 0) {
+            warnings.push(validationWarning('Skill has no tools - consider adding tools or removing the skill', { line: metadata.line }));
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Add context and tools fields to the entry point.
+     */
+    getEntryPointFields(metadata) {
+        return `context: ${JSON.stringify(metadata.metadata.context || '')},
+  tools: ${JSON.stringify(metadata.metadata.toolRefs)},`;
+    }
+    /**
+     * Resolve tool references from this skill.
+     *
+     * Skills reference tools by class/variable name. This method:
+     * 1. Finds where each tool is imported from
+     * 2. Uses ToolPlugin to detect the tool in that file
+     * 3. Returns the tool metadata for compilation
+     */
+    resolveReferences(metadata, sourceFile, context) {
+        const skillMeta = metadata.metadata;
+        const toolRefs = skillMeta.toolRefs || [];
+        if (toolRefs.length === 0) {
+            return [];
+        }
+        const toolPlugin = context.getPlugin('tool');
+        if (!toolPlugin) {
+            context.log('⚠️  No plugin registered for tool');
+            return [];
+        }
+        const tools = [];
+        for (const className of toolRefs) {
+            // Resolve where this tool class is defined
+            const toolSourcePath = this.resolveClassImport(className, sourceFile, context);
+            if (!toolSourcePath) {
+                context.log(`⚠️  Could not resolve import for tool class: ${className}`);
+                continue;
+            }
+            try {
+                const toolFile = context.project.addSourceFileAtPath(toolSourcePath);
+                const detected = toolPlugin.detect(toolFile);
+                // Find by class/export name
+                const match = detected.find(d => {
+                    const toolMeta = d.metadata;
+                    return d.exportName === className || toolMeta.className === className;
+                }) || (detected.length === 1 ? detected[0] : null);
+                if (match) {
+                    tools.push(match);
+                }
+                else {
+                    context.log(`⚠️  Could not find tool "${className}" in ${toolSourcePath}`);
+                }
+            }
+            catch (error) {
+                context.log(`⚠️  Error extracting tool ${className}: ${error}`);
+            }
+        }
+        return tools;
+    }
+    /**
+     * Resolve a class import to its source file path.
+     */
+    resolveClassImport(className, sourceFile, context) {
+        return findImportSource(className, sourceFile, context.resolveImportPath);
+    }
+    /**
+     * Create the manifest entry for a skill.
+     * Resolves tool class names to actual tool names using context.
+     */
+    toManifestEntry(compiled, context) {
+        // Cast to skill-specific metadata type
+        const skillMetadata = compiled.metadata;
+        // Get tool references from the compiled skill's metadata
+        const toolClassNames = skillMetadata.toolRefs || [];
+        // Resolve tool class names to actual tool names
+        const toolNames = toolClassNames.map((className) => {
+            const tool = context?.agentPrimitives?.find(p => {
+                if (p.kind !== 'tool')
+                    return false;
+                const toolMeta = p.metadata;
+                return toolMeta.className === className || p.name === className;
+            });
+            return tool?.name || className;
+        });
+        const skill = {
+            kind: PrimitiveKind.SKILL,
+            name: compiled.name,
+            description: compiled.description,
+            path: `artifacts/${compiled.kind}/${compiled.name}.js`,
+            sourcePath: compiled.sourcePath,
+            hash: compiled.artifact.hash,
+            context: skillMetadata.context,
+            tools: toolNames,
+        };
+        return skill;
+    }
+}
+//# sourceMappingURL=skill.plugin.js.map

package/dist/compiler/plugins/skill.plugin.js.map

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

package/dist/compiler/plugins/tool.plugin.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Tool compilation plugin.
+ *
+ * BACKWARD COMPATIBLE: Detects BOTH patterns:
+ * 1. Class-based (legacy): class MyTool extends LuaTool { ... }
+ * 2. Function-based (new): const myTool = defineTool({ ... })
+ *
+ * NOTE: This plugin extends BasePlugin but overrides class-based detection because:
+ * - Class-based tools use extends/implements detection (not `new LuaTool` instantiation)
+ * - Class-based metadata is extracted from class properties, not config objects
+ * - Entry point generation differs significantly for class-based tools
+ */
+import { SourceFile, Project, ObjectLiteralExpression } from 'ts-morph';
+import { type ToolMetadata, type ToolMetadataFields, type ValidationResult, type SchemaSet, type ManifestContext, type CompiledPrimitive, type ManifestPrimitive, type PrimitiveMetadata } from '../types.js';
+import { BasePlugin } from './base.js';
+/**
+ * Plugin for compiling tool primitives.
+ * Extends BasePlugin for function-based detection; overrides class-based detection.
+ */
+export declare class ToolPlugin extends BasePlugin<ToolMetadataFields> {
+    readonly kind = "tool";
+    readonly displayName = "Tool";
+    readonly defineFunction = "defineTool";
+    readonly legacyClassNames: string[];
+    /**
+     * Extract metadata from tool config object (function-based pattern).
+     * Used by BasePlugin's detectFunctionBased().
+     */
+    protected extractFromConfig(config: ObjectLiteralExpression, exportName: string, sourcePath: string, position: {
+        line: number;
+        column: number;
+    }, pattern: 'function' | 'class'): ToolMetadata | null;
+    /**
+     * Override class-based detection to detect class DEFINITIONS (extends/implements)
+     * instead of class INSTANTIATIONS (new LuaTool).
+     *
+     * Detects:
+     * - class MyTool extends LuaTool { ... }
+     * - export default class MyTool extends LuaTool { ... }
+     */
+    protected detectClassBased(sourceFile: SourceFile, primitives: PrimitiveMetadata<ToolMetadataFields>[]): void;
+    /**
+     * Check if a class extends or implements LuaTool.
+     */
+    private isToolClass;
+    /**
+     * Extract a string property from a class declaration.
+     */
+    private extractClassProperty;
+    validate(metadata: ToolMetadata): ValidationResult;
+    /**
+     * Override entry point generation to handle class-based tools specially.
+     * Function-based tools use BasePlugin's implementation.
+     */
+    generateEntryPoint(metadata: ToolMetadata): string;
+    /**
+     * Generate entry point for class-based tools.
+     * Creates an instance and wraps it in the standard primitive format.
+     */
+    private generateClassBasedEntryPoint;
+    /**
+     * Add runtime validation for execute function.
+     */
+    protected getRuntimeValidation(): string;
+    extractSchemas(metadata: ToolMetadata, project: Project): Promise<SchemaSet | undefined>;
+    toManifestEntry(compiled: CompiledPrimitive, _context?: ManifestContext): ManifestPrimitive;
+}