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

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

@@ -0,0 +1,143 @@
+/**
+ * Job compilation plugin.
+ *
+ * BACKWARD COMPATIBLE: Detects BOTH patterns:
+ * 1. Class-based (legacy): new LuaJob({ ... })
+ * 2. Function-based (new): const myJob = defineJob({ ... })
+ */
+import { Node } from 'ts-morph';
+import { PrimitiveKind, } from '../types.js';
+import { BasePlugin, validationError, validationWarning } from './base.js';
+import { extractStringProperty } from '../utils/ast-helpers.js';
+/**
+ * Plugin for compiling job primitives.
+ * Extends BasePlugin for common detection/entry point/postProcess logic.
+ */
+export class JobPlugin extends BasePlugin {
+    constructor() {
+        super(...arguments);
+        this.kind = 'job';
+        this.displayName = 'Job';
+        this.defineFunction = 'defineJob';
+        this.legacyClassNames = ['LuaJob'];
+    }
+    /**
+     * Extract metadata from job config object.
+     */
+    extractFromConfig(config, exportName, sourcePath, position, pattern) {
+        const common = this.extractCommonFields(config, exportName, sourcePath, position);
+        if (!common)
+            return null;
+        // Extract schedule
+        const scheduleNode = config.getProperty('schedule');
+        let scheduleType;
+        let scheduleExpression;
+        if (scheduleNode && Node.isPropertyAssignment(scheduleNode)) {
+            const scheduleValue = scheduleNode.getInitializer();
+            if (scheduleValue && Node.isObjectLiteralExpression(scheduleValue)) {
+                scheduleType = extractStringProperty(scheduleValue, 'type');
+                scheduleExpression = extractStringProperty(scheduleValue, 'expression');
+            }
+        }
+        // Extract timeout value
+        let timeoutValue;
+        const timeoutNode = config.getProperty('timeout');
+        if (timeoutNode && Node.isPropertyAssignment(timeoutNode)) {
+            const init = timeoutNode.getInitializer();
+            if (init && Node.isNumericLiteral(init)) {
+                timeoutValue = Number(init.getText());
+            }
+        }
+        // Extract retry config
+        let retryConfig;
+        const retryNode = config.getProperty('retry');
+        if (retryNode && Node.isPropertyAssignment(retryNode)) {
+            const retryValue = retryNode.getInitializer();
+            if (retryValue && Node.isObjectLiteralExpression(retryValue)) {
+                retryConfig = {};
+                const maxProp = retryValue.getProperty('maxAttempts');
+                if (maxProp && Node.isPropertyAssignment(maxProp)) {
+                    const maxInit = maxProp.getInitializer();
+                    if (maxInit && Node.isNumericLiteral(maxInit)) {
+                        retryConfig.maxAttempts = Number(maxInit.getText());
+                    }
+                }
+                const backoffProp = retryValue.getProperty('backoffSeconds');
+                if (backoffProp && Node.isPropertyAssignment(backoffProp)) {
+                    const backoffInit = backoffProp.getInitializer();
+                    if (backoffInit && Node.isNumericLiteral(backoffInit)) {
+                        retryConfig.backoffSeconds = Number(backoffInit.getText());
+                    }
+                }
+            }
+        }
+        return {
+            kind: this.kind,
+            ...common,
+            metadata: {
+                pattern,
+                scheduleType,
+                scheduleExpression,
+                hasExecute: config.getProperty('execute') !== undefined,
+                hasTimeout: config.getProperty('timeout') !== undefined,
+                hasRetry: config.getProperty('retry') !== undefined,
+                timeoutValue,
+                retryConfig,
+            },
+        };
+    }
+    validate(metadata) {
+        const errors = [];
+        const warnings = [];
+        if (!metadata.name) {
+            errors.push(validationError('Job must have a name', { line: metadata.line }));
+        }
+        if (!metadata.metadata.hasExecute) {
+            errors.push(validationError('Job must have an execute function', { line: metadata.line }));
+        }
+        if (!metadata.metadata.scheduleType) {
+            errors.push(validationError('Job must have a schedule', {
+                line: metadata.line,
+                suggestion: 'Add a schedule: schedule: { type: "cron", expression: "0 9 * * *" }',
+            }));
+        }
+        if (!metadata.description) {
+            warnings.push(validationWarning('Job should have a description', { line: metadata.line }));
+        }
+        // Validate schedule type
+        const validScheduleTypes = ['cron', 'interval', 'once'];
+        if (metadata.metadata.scheduleType && !validScheduleTypes.includes(metadata.metadata.scheduleType)) {
+            errors.push(validationError(`Invalid schedule type: ${metadata.metadata.scheduleType}. Must be one of: ${validScheduleTypes.join(', ')}`, { line: metadata.line }));
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    }
+    /**
+     * Add runtime validation for executeFunction (LuaJob uses this internally).
+     */
+    getRuntimeValidation() {
+        return `
+  // LuaJob uses executeFunction internally
+  if (typeof primitive.primitive?.executeFunction !== 'function') {
+    throw new Error('[Lua] Invalid job artifact: executeFunction is not a function');
+  }`;
+    }
+    toManifestEntry(compiled, _context) {
+        const jobMeta = compiled.metadata;
+        const job = {
+            kind: PrimitiveKind.JOB,
+            name: compiled.name,
+            description: compiled.description,
+            path: `artifacts/${compiled.kind}/${compiled.name}.js`,
+            sourcePath: compiled.sourcePath,
+            hash: compiled.artifact.hash,
+            schedule: jobMeta.scheduleType ? {
+                type: jobMeta.scheduleType,
+                expression: jobMeta.scheduleExpression,
+            } : undefined,
+            timeout: jobMeta.timeoutValue,
+            retry: jobMeta.retryConfig,
+        };
+        return job;
+    }
+}
+//# sourceMappingURL=job.plugin.js.map

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

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

package/dist/compiler/plugins/mcp-server.plugin.d.ts

@@ -0,0 +1,50 @@
+/**
+ * MCP Server compilation plugin.
+ *
+ * BACKWARD COMPATIBLE: Detects BOTH patterns:
+ * 1. Class-based (legacy): new LuaMCPServer({ ... })
+ * 2. Function-based (new): const myServer = defineMCPServer({ ... })
+ */
+import { ObjectLiteralExpression } from 'ts-morph';
+import { type MCPServerMetadata, type MCPServerMetadataFields, type ValidationResult, type ManifestContext, type CompiledPrimitive, type ManifestPrimitive } from '../types.js';
+import { BasePlugin } from './base.js';
+/**
+ * Plugin for compiling MCP server primitives.
+ * Extends BasePlugin for common detection/entry point/postProcess logic.
+ */
+export declare class MCPServerPlugin extends BasePlugin<MCPServerMetadataFields> {
+    readonly kind = "mcp-server";
+    readonly displayName = "MCP Server";
+    readonly defineFunction = "defineMCPServer";
+    readonly legacyClassNames: string[];
+    /**
+     * Extract metadata from MCP server config object.
+     */
+    protected extractFromConfig(config: ObjectLiteralExpression, exportName: string, sourcePath: string, position: {
+        line: number;
+        column: number;
+    }, pattern: 'function' | 'class'): MCPServerMetadata | null;
+    /**
+     * Extract the source text of a resolver function property.
+     */
+    private getResolverSource;
+    /**
+     * Bundle a resolver function into a self-contained, compressed, VM-executable string.
+     * This is called during compilation for MCP servers with dynamic resolvers.
+     */
+    private bundleResolver;
+    /**
+     * Check if a property has a resolver function (arrow function or function expression).
+     */
+    private hasResolverFunction;
+    validate(metadata: MCPServerMetadata): ValidationResult;
+    /**
+     * Add transport field to the entry point.
+     */
+    protected getEntryPointFields(metadata: MCPServerMetadata): string;
+    /**
+     * Create the manifest entry for an MCP server.
+     * Bundles resolver functions (url/headers) if present.
+     */
+    toManifestEntry(compiled: CompiledPrimitive, context?: ManifestContext): Promise<ManifestPrimitive>;
+}

package/dist/compiler/plugins/mcp-server.plugin.js

@@ -0,0 +1,186 @@
+/**
+ * MCP Server compilation plugin.
+ *
+ * BACKWARD COMPATIBLE: Detects BOTH patterns:
+ * 1. Class-based (legacy): new LuaMCPServer({ ... })
+ * 2. Function-based (new): const myServer = defineMCPServer({ ... })
+ */
+import { Node } from 'ts-morph';
+import { build } from 'esbuild';
+import { PrimitiveKind, } from '../types.js';
+import { BasePlugin, validationError, validationWarning } from './base.js';
+import { extractStringProperty } from '../utils/ast-helpers.js';
+import { compressForPush } from '../../utils/artifact-loader.js';
+/**
+ * Plugin for compiling MCP server primitives.
+ * Extends BasePlugin for common detection/entry point/postProcess logic.
+ */
+export class MCPServerPlugin extends BasePlugin {
+    constructor() {
+        super(...arguments);
+        this.kind = 'mcp-server';
+        this.displayName = 'MCP Server';
+        this.defineFunction = 'defineMCPServer';
+        this.legacyClassNames = ['LuaMCPServer'];
+    }
+    /**
+     * Extract metadata from MCP server config object.
+     */
+    extractFromConfig(config, exportName, sourcePath, position, pattern) {
+        const common = this.extractCommonFields(config, exportName, sourcePath, position);
+        if (!common)
+            return null;
+        const transport = extractStringProperty(config, 'transport') || 'streamable-http';
+        const url = extractStringProperty(config, 'url');
+        // Check for resolver functions and extract their source text
+        const hasUrlResolver = this.hasResolverFunction(config, 'url');
+        const hasHeadersResolver = this.hasResolverFunction(config, 'headers');
+        const urlResolverSource = hasUrlResolver ? this.getResolverSource(config, 'url') : undefined;
+        const headersResolverSource = hasHeadersResolver ? this.getResolverSource(config, 'headers') : undefined;
+        return {
+            kind: this.kind,
+            ...common,
+            metadata: {
+                pattern,
+                transport,
+                url,
+                hasUrlResolver,
+                hasHeadersResolver,
+                urlResolverSource,
+                headersResolverSource,
+            },
+        };
+    }
+    /**
+     * Extract the source text of a resolver function property.
+     */
+    getResolverSource(config, propName) {
+        const prop = config.getProperty(propName);
+        if (!prop || !Node.isPropertyAssignment(prop))
+            return undefined;
+        const value = prop.getInitializer();
+        if (!value)
+            return undefined;
+        if (Node.isArrowFunction(value) || Node.isFunctionExpression(value)) {
+            return value.getText();
+        }
+        return undefined;
+    }
+    /**
+     * Bundle a resolver function into a self-contained, compressed, VM-executable string.
+     * This is called during compilation for MCP servers with dynamic resolvers.
+     */
+    async bundleResolver(functionCode, resolverType, serverName, outDir) {
+        try {
+            const moduleCode = `const resolverFunc = ${functionCode};\nexport default resolverFunc;\n`;
+            const result = await build({
+                stdin: {
+                    contents: moduleCode,
+                    resolveDir: outDir,
+                    loader: 'ts',
+                },
+                bundle: true,
+                platform: 'node',
+                target: 'node18',
+                format: 'cjs',
+                minify: true,
+                write: false,
+                external: ['zod'],
+            });
+            const bundledCode = result.outputFiles?.[0]?.text ?? '';
+            if (!bundledCode) {
+                throw new Error(`esbuild produced empty output for MCP ${resolverType} resolver`);
+            }
+            // Wrap for VM execution and compress (gzip + base64)
+            const wrappedCode = `(async () => {\n  ${bundledCode}\n  const resolverFunc = module.exports.default || module.exports;\n  return resolverFunc();\n})()`;
+            return compressForPush(wrappedCode);
+        }
+        catch (error) {
+            console.warn(`Warning: Could not bundle MCP ${resolverType} resolver for ${serverName}: ${error.message}`);
+            try {
+                return compressForPush(`(${functionCode})()`);
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    /**
+     * Check if a property has a resolver function (arrow function or function expression).
+     */
+    hasResolverFunction(config, propName) {
+        const prop = config.getProperty(propName);
+        if (!prop || !Node.isPropertyAssignment(prop))
+            return false;
+        const value = prop.getInitializer();
+        if (!value)
+            return false;
+        return Node.isArrowFunction(value) || Node.isFunctionExpression(value);
+    }
+    validate(metadata) {
+        const errors = [];
+        const warnings = [];
+        if (!metadata.name) {
+            errors.push(validationError('MCP Server must have a name', { line: metadata.line }));
+        }
+        const transport = metadata.metadata.transport;
+        const validTransports = ['streamable-http', 'sse'];
+        if (transport === 'stdio') {
+            errors.push(validationError('stdio transport is not supported. Use streamable-http or sse instead.', {
+                line: metadata.line,
+                suggestion: 'Change transport to "streamable-http" (recommended) or "sse"',
+                docsUrl: 'https://docs.lua.ai/mcp-servers#transport',
+            }));
+        }
+        else if (!validTransports.includes(transport)) {
+            errors.push(validationError(`Invalid transport: ${transport}. Must be one of: ${validTransports.join(', ')}`, { line: metadata.line }));
+        }
+        if (!metadata.metadata.url && !metadata.metadata.hasUrlResolver) {
+            errors.push(validationError('MCP Server must have a url or url resolver', { line: metadata.line }));
+        }
+        if (!metadata.description) {
+            warnings.push(validationWarning('MCP Server should have a description', { line: metadata.line }));
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Add transport field to the entry point.
+     */
+    getEntryPointFields(metadata) {
+        return `transport: ${JSON.stringify(metadata.metadata.transport)},`;
+    }
+    /**
+     * Create the manifest entry for an MCP server.
+     * Bundles resolver functions (url/headers) if present.
+     */
+    async toManifestEntry(compiled, context) {
+        const mcpMeta = compiled.metadata;
+        const outDir = context?.outDir || process.cwd();
+        // Bundle resolver functions if present
+        let urlResolver;
+        let headersResolver;
+        if (mcpMeta.urlResolverSource) {
+            urlResolver = await this.bundleResolver(mcpMeta.urlResolverSource, 'url', compiled.name, outDir) ?? undefined;
+        }
+        if (mcpMeta.headersResolverSource) {
+            headersResolver = await this.bundleResolver(mcpMeta.headersResolverSource, 'headers', compiled.name, outDir) ?? undefined;
+        }
+        const mcpServer = {
+            kind: PrimitiveKind.MCP_SERVER,
+            name: compiled.name,
+            description: compiled.description,
+            path: `artifacts/${compiled.kind}/${compiled.name}.js`,
+            sourcePath: compiled.sourcePath,
+            hash: compiled.artifact.hash,
+            config: mcpMeta.config,
+            urlResolver,
+            headersResolver,
+        };
+        return mcpServer;
+    }
+}
+//# sourceMappingURL=mcp-server.plugin.js.map

package/dist/compiler/plugins/mcp-server.plugin.js.map

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

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

@@ -0,0 +1,20 @@
+/**
+ * PostProcessor compilation plugin.
+ *
+ * Extends ProcessorPluginBase for shared validation and runtime checks.
+ * Minimal — just config fields and manifest entry.
+ */
+import { ObjectLiteralExpression } from 'ts-morph';
+import { type PostProcessorMetadata, type PostProcessorMetadataFields, type ManifestContext, type CompiledPrimitive, type ManifestPrimitive } from '../types.js';
+import { ProcessorPluginBase } from './processor-base.js';
+export declare class PostProcessorPlugin extends ProcessorPluginBase<PostProcessorMetadataFields> {
+    readonly kind = "postprocessor";
+    readonly displayName = "PostProcessor";
+    readonly defineFunction = "definePostProcessor";
+    readonly legacyClassNames: string[];
+    protected extractFromConfig(config: ObjectLiteralExpression, exportName: string, sourcePath: string, position: {
+        line: number;
+        column: number;
+    }, pattern: 'function' | 'class'): PostProcessorMetadata | null;
+    toManifestEntry(compiled: CompiledPrimitive, _context?: ManifestContext): ManifestPrimitive;
+}

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

@@ -0,0 +1,39 @@
+/**
+ * PostProcessor compilation plugin.
+ *
+ * Extends ProcessorPluginBase for shared validation and runtime checks.
+ * Minimal — just config fields and manifest entry.
+ */
+import { PrimitiveKind, } from '../types.js';
+import { ProcessorPluginBase } from './processor-base.js';
+export class PostProcessorPlugin extends ProcessorPluginBase {
+    constructor() {
+        super(...arguments);
+        this.kind = 'postprocessor';
+        this.displayName = 'PostProcessor';
+        this.defineFunction = 'definePostProcessor';
+        this.legacyClassNames = ['PostProcessor', 'LuaPostprocessor'];
+    }
+    extractFromConfig(config, exportName, sourcePath, position, pattern) {
+        const common = this.extractCommonFields(config, exportName, sourcePath, position);
+        if (!common)
+            return null;
+        return {
+            kind: this.kind,
+            ...common,
+            metadata: { pattern, hasExecute: config.getProperty('execute') !== undefined },
+        };
+    }
+    toManifestEntry(compiled, _context) {
+        const postprocessor = {
+            kind: PrimitiveKind.POSTPROCESSOR,
+            name: compiled.name,
+            description: compiled.description,
+            path: `artifacts/${compiled.kind}/${compiled.name}.js`,
+            sourcePath: compiled.sourcePath,
+            hash: compiled.artifact.hash,
+        };
+        return postprocessor;
+    }
+}
+//# sourceMappingURL=postprocessor.plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postprocessor.plugin.js","sourceRoot":"","sources":["../../../src/compiler/plugins/postprocessor.plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,aAAa,GAOd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,OAAO,mBAAoB,SAAQ,mBAAgD;IAAzF;;QACW,SAAI,GAAG,eAAe,CAAC;QACvB,gBAAW,GAAG,eAAe,CAAC;QAC9B,mBAAc,GAAG,qBAAqB,CAAC;QACvC,qBAAgB,GAAG,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;IA8BpE,CAAC;IA5BW,iBAAiB,CACzB,MAA+B,EAC/B,UAAkB,EAClB,UAAkB,EAClB,QAA0C,EAC1C,OAA6B;QAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAClF,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,MAAM;YACT,QAAQ,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE;SAC/E,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,QAA2B,EAAE,QAA0B;QACrE,MAAM,aAAa,GAA0B;YAC3C,IAAI,EAAE,aAAa,CAAC,aAAa;YACjC,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,IAAI,EAAE,aAAa,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK;YACtD,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI;SAC7B,CAAC;QACF,OAAO,aAAa,CAAC;IACvB,CAAC;CACF"}

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

@@ -0,0 +1,20 @@
+/**
+ * PreProcessor compilation plugin.
+ *
+ * Extends ProcessorPluginBase for shared validation and runtime checks.
+ * Only adds: isAsync extraction + isAsync in manifest entry.
+ */
+import { ObjectLiteralExpression } from 'ts-morph';
+import { type PreProcessorMetadata, type PreProcessorMetadataFields, type ManifestContext, type CompiledPrimitive, type ManifestPrimitive } from '../types.js';
+import { ProcessorPluginBase } from './processor-base.js';
+export declare class PreProcessorPlugin extends ProcessorPluginBase<PreProcessorMetadataFields> {
+    readonly kind = "preprocessor";
+    readonly displayName = "PreProcessor";
+    readonly defineFunction = "definePreProcessor";
+    readonly legacyClassNames: string[];
+    protected extractFromConfig(config: ObjectLiteralExpression, exportName: string, sourcePath: string, position: {
+        line: number;
+        column: number;
+    }, pattern: 'function' | 'class'): PreProcessorMetadata | null;
+    toManifestEntry(compiled: CompiledPrimitive, _context?: ManifestContext): ManifestPrimitive;
+}

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

@@ -0,0 +1,48 @@
+/**
+ * PreProcessor compilation plugin.
+ *
+ * Extends ProcessorPluginBase for shared validation and runtime checks.
+ * Only adds: isAsync extraction + isAsync in manifest entry.
+ */
+import { Node, SyntaxKind } from 'ts-morph';
+import { PrimitiveKind, } from '../types.js';
+import { ProcessorPluginBase } from './processor-base.js';
+export class PreProcessorPlugin extends ProcessorPluginBase {
+    constructor() {
+        super(...arguments);
+        this.kind = 'preprocessor';
+        this.displayName = 'PreProcessor';
+        this.defineFunction = 'definePreProcessor';
+        this.legacyClassNames = ['PreProcessor', 'LuaPreprocessor'];
+    }
+    extractFromConfig(config, exportName, sourcePath, position, pattern) {
+        const common = this.extractCommonFields(config, exportName, sourcePath, position);
+        if (!common)
+            return null;
+        let isAsync = false;
+        const asyncProp = config.getProperty('async');
+        if (asyncProp && Node.isPropertyAssignment(asyncProp)) {
+            const init = asyncProp.getInitializer();
+            if (init)
+                isAsync = init.getKind() === SyntaxKind.TrueKeyword;
+        }
+        return {
+            kind: this.kind,
+            ...common,
+            metadata: { pattern, hasExecute: config.getProperty('execute') !== undefined, isAsync },
+        };
+    }
+    toManifestEntry(compiled, _context) {
+        const preprocessor = {
+            kind: PrimitiveKind.PREPROCESSOR,
+            name: compiled.name,
+            description: compiled.description,
+            path: `artifacts/${compiled.kind}/${compiled.name}.js`,
+            sourcePath: compiled.sourcePath,
+            hash: compiled.artifact.hash,
+            isAsync: compiled.metadata?.isAsync ?? false,
+        };
+        return preprocessor;
+    }
+}
+//# sourceMappingURL=preprocessor.plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preprocessor.plugin.js","sourceRoot":"","sources":["../../../src/compiler/plugins/preprocessor.plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA2B,IAAI,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EACL,aAAa,GAOd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,OAAO,kBAAmB,SAAQ,mBAA+C;IAAvF;;QACW,SAAI,GAAG,cAAc,CAAC;QACtB,gBAAW,GAAG,cAAc,CAAC;QAC7B,mBAAc,GAAG,oBAAoB,CAAC;QACtC,qBAAgB,GAAG,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;IAsClE,CAAC;IApCW,iBAAiB,CACzB,MAA+B,EAC/B,UAAkB,EAClB,UAAkB,EAClB,QAA0C,EAC1C,OAA6B;QAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAClF,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,SAAS,IAAI,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,GAAG,SAAS,CAAC,cAAc,EAAE,CAAC;YACxC,IAAI,IAAI;gBAAE,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,WAAW,CAAC;QAChE,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,MAAM;YACT,QAAQ,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,OAAO,EAAE;SACxF,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,QAA2B,EAAE,QAA0B;QACrE,MAAM,YAAY,GAAyB;YACzC,IAAI,EAAE,aAAa,CAAC,YAAY;YAChC,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,IAAI,EAAE,aAAa,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK;YACtD,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI;YAC5B,OAAO,EAAG,QAAQ,CAAC,QAAuC,EAAE,OAAO,IAAI,KAAK;SAC7E,CAAC;QACF,OAAO,YAAY,CAAC;IACtB,CAAC;CACF"}

package/dist/compiler/plugins/processor-base.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared base class for PreProcessor and PostProcessor plugins.
+ *
+ * These two plugin types are nearly identical — same validation rules,
+ * same runtime checks, same extraction pattern. This base eliminates
+ * the duplication while letting each plugin customize:
+ * - Config fields (kind, displayName, defineFunction, legacyClassNames)
+ * - extractFromConfig() (preprocessor extracts isAsync, postprocessor doesn't)
+ * - toManifestEntry() (preprocessor includes isAsync field)
+ */
+import type { ProcessorMetadataFields, PrimitiveMetadata, ValidationResult } from '../types.js';
+import { BasePlugin } from './base.js';
+export declare abstract class ProcessorPluginBase<T extends ProcessorMetadataFields> extends BasePlugin<T> {
+    validate(metadata: PrimitiveMetadata<T>): ValidationResult;
+    protected getRuntimeValidation(): string;
+}

package/dist/compiler/plugins/processor-base.js

@@ -0,0 +1,34 @@
+/**
+ * Shared base class for PreProcessor and PostProcessor plugins.
+ *
+ * These two plugin types are nearly identical — same validation rules,
+ * same runtime checks, same extraction pattern. This base eliminates
+ * the duplication while letting each plugin customize:
+ * - Config fields (kind, displayName, defineFunction, legacyClassNames)
+ * - extractFromConfig() (preprocessor extracts isAsync, postprocessor doesn't)
+ * - toManifestEntry() (preprocessor includes isAsync field)
+ */
+import { BasePlugin, validationError, validationWarning } from './base.js';
+export class ProcessorPluginBase extends BasePlugin {
+    validate(metadata) {
+        const errors = [];
+        const warnings = [];
+        if (!metadata.name) {
+            errors.push(validationError(`${this.displayName} must have a name`, { line: metadata.line }));
+        }
+        if (!metadata.metadata?.hasExecute) {
+            errors.push(validationError(`${this.displayName} must have an execute function`, { line: metadata.line }));
+        }
+        if (!metadata.description) {
+            warnings.push(validationWarning(`${this.displayName} should have a description`, { line: metadata.line }));
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    }
+    getRuntimeValidation() {
+        return `
+  if (typeof primitive.primitive?.execute !== 'function') {
+    throw new Error('[Lua] Invalid ${this.kind} artifact: execute is not a function');
+  }`;
+    }
+}
+//# sourceMappingURL=processor-base.js.map

package/dist/compiler/plugins/processor-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor-base.js","sourceRoot":"","sources":["../../../src/compiler/plugins/processor-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE3E,MAAM,OAAgB,mBAAuD,SAAQ,UAAa;IAChG,QAAQ,CAAC,QAA8B;QACrC,MAAM,MAAM,GAA+B,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAiC,EAAE,CAAC;QAElD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,WAAW,mBAAmB,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAChG,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,WAAW,gCAAgC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7G,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,WAAW,4BAA4B,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7G,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAES,oBAAoB;QAC5B,OAAO;;qCAE0B,IAAI,CAAC,IAAI;IAC1C,CAAC;IACH,CAAC;CACF"}

package/dist/compiler/plugins/registry.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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 type { CompilationPlugin } from './base.js';
+/**
+ * Registry of all compilation plugins.
+ *
+ * Plugins are looked up by their 'kind' property, which must match
+ * the primitive's kind value exactly.
+ */
+export declare class PluginRegistry {
+    private plugins;
+    constructor();
+    /**
+     * Register a plugin.
+     * @throws Error if a plugin with the same kind is already registered
+     */
+    register(plugin: CompilationPlugin): void;
+    /**
+     * Get a plugin by kind.
+     */
+    get(kind: string): CompilationPlugin | undefined;
+    /**
+     * Get all registered plugins.
+     */
+    getAll(): CompilationPlugin[];
+    /**
+     * Get all registered primitive kinds.
+     */
+    getAllKinds(): string[];
+    /**
+     * Check if a plugin exists for a kind.
+     */
+    has(kind: string): boolean;
+    /**
+     * Get the number of registered plugins.
+     */
+    get size(): number;
+}
+/**
+ * The global plugin registry instance.
+ * Use this in the compiler and CLI.
+ */
+export declare const pluginRegistry: PluginRegistry;
+/**
+ * Get all define function names (for detection).
+ * E.g., ['defineTool', 'defineJob', 'defineWebhook', ...]
+ */
+export declare function getAllDefineFunctions(): string[];
+/**
+ * Get plugin by define function name.
+ */
+export declare function getPluginByDefineFunction(funcName: string): CompilationPlugin | undefined;