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

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

@@ -0,0 +1,279 @@
+/**
+ * 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 { Node } from 'ts-morph';
+import { PrimitiveKind, } from '../types.js';
+import { BasePlugin, validationError, validationWarning } from './base.js';
+import { extractSchemaProperty } from '../utils/ast-helpers.js';
+import { zodToJsonSchema } from '../utils/schema-converter.js';
+/**
+ * Plugin for compiling tool primitives.
+ * Extends BasePlugin for function-based detection; overrides class-based detection.
+ */
+export class ToolPlugin extends BasePlugin {
+    constructor() {
+        super(...arguments);
+        this.kind = 'tool';
+        this.displayName = 'Tool';
+        this.defineFunction = 'defineTool';
+        this.legacyClassNames = ['LuaTool'];
+    }
+    /**
+     * Extract metadata from tool config object (function-based pattern).
+     * Used by BasePlugin's detectFunctionBased().
+     */
+    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,
+                hasInputSchema: config.getProperty('inputSchema') !== undefined,
+                hasCondition: config.getProperty('condition') !== undefined,
+                hasExecute: config.getProperty('execute') !== undefined,
+            },
+        };
+    }
+    /**
+     * 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 { ... }
+     */
+    detectClassBased(sourceFile, primitives) {
+        sourceFile.getClasses().forEach(classDecl => {
+            if (!this.isToolClass(classDecl))
+                return;
+            const className = classDecl.getName();
+            if (!className)
+                return;
+            // Check if this is a default export
+            const isDefaultExport = classDecl.isDefaultExport();
+            // Extract name from class property or derive from class name
+            let name = this.extractClassProperty(classDecl, 'name') ||
+                className.replace(/Tool$/, '').toLowerCase().replace(/([A-Z])/g, '-$1').replace(/^-/, '');
+            primitives.push({
+                kind: this.kind,
+                name,
+                description: this.extractClassProperty(classDecl, 'description') || '',
+                sourcePath: sourceFile.getFilePath(),
+                exportName: isDefaultExport ? 'default' : className,
+                isDefaultExport,
+                line: classDecl.getStartLineNumber(),
+                column: 1,
+                metadata: {
+                    pattern: 'class',
+                    className,
+                    hasInputSchema: classDecl.getProperty('inputSchema') !== undefined,
+                    hasCondition: classDecl.getMethod('condition') !== undefined || classDecl.getProperty('condition') !== undefined,
+                    hasExecute: classDecl.getMethod('execute') !== undefined || classDecl.getProperty('execute') !== undefined,
+                },
+            });
+        });
+    }
+    /**
+     * Check if a class extends or implements LuaTool.
+     */
+    isToolClass(classDecl) {
+        // Check extends
+        const extendsClause = classDecl.getExtends();
+        if (extendsClause && this.legacyClassNames.includes(extendsClause.getExpression().getText())) {
+            return true;
+        }
+        // Check implements
+        for (const impl of classDecl.getImplements()) {
+            if (this.legacyClassNames.includes(impl.getExpression().getText())) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Extract a string property from a class declaration.
+     */
+    extractClassProperty(classDecl, propName) {
+        const prop = classDecl.getProperty(propName);
+        if (!prop)
+            return undefined;
+        const initializer = prop.getInitializer();
+        if (initializer && Node.isStringLiteral(initializer)) {
+            return initializer.getLiteralValue();
+        }
+        return undefined;
+    }
+    validate(metadata) {
+        const errors = [];
+        const warnings = [];
+        if (!metadata.name) {
+            errors.push(validationError('Tool must have a name', {
+                line: metadata.line,
+                suggestion: 'Add a name property: name: "my-tool"',
+            }));
+        }
+        if (!metadata.metadata.hasExecute) {
+            errors.push(validationError('Tool must have an execute function', {
+                line: metadata.line,
+                suggestion: 'Add an execute function: execute: async (input, context) => { ... }',
+            }));
+        }
+        if (!metadata.description) {
+            warnings.push(validationWarning('Tool should have a description for better AI understanding', {
+                line: metadata.line,
+                suggestion: 'Add a description: description: "What this tool does"',
+            }));
+        }
+        if (!metadata.metadata.hasInputSchema) {
+            warnings.push(validationWarning('Tool should have an inputSchema for type safety', {
+                line: metadata.line,
+                suggestion: 'Add a schema: inputSchema: z.object({ ... })',
+            }));
+        }
+        if (metadata.name && !/^[a-z][a-z0-9-_]*$/.test(metadata.name)) {
+            warnings.push(validationWarning('Tool name should be lowercase with hyphens or underscores', { line: metadata.line }));
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    }
+    /**
+     * Override entry point generation to handle class-based tools specially.
+     * Function-based tools use BasePlugin's implementation.
+     */
+    generateEntryPoint(metadata) {
+        // Class-based tools need special wrapper that instantiates the class
+        if (metadata.metadata.pattern === 'class') {
+            return this.generateClassBasedEntryPoint(metadata);
+        }
+        // Function-based tools use base implementation
+        return super.generateEntryPoint(metadata);
+    }
+    /**
+     * Generate entry point for class-based tools.
+     * Creates an instance and wraps it in the standard primitive format.
+     */
+    generateClassBasedEntryPoint(metadata) {
+        // For default exports, use default import syntax
+        const importStatement = metadata.isDefaultExport
+            ? `import __ToolClass__ from '${metadata.sourcePath}';`
+            : `import { __lua_target__ as __ToolClass__ } from '${metadata.sourcePath}';`;
+        // For default exports, we don't re-export the class
+        const exportStatement = metadata.isDefaultExport
+            ? ''
+            : `export { __ToolClass__ as ${metadata.exportName} };`;
+        return `
+// =============================================================================
+// AUTO-GENERATED ENTRY POINT (Class-based)
+// Tool: ${metadata.name}
+// Source: ${metadata.sourcePath}
+// =============================================================================
+
+${importStatement}
+
+const toolInstance = new __ToolClass__();
+
+const __lua_primitive__ = {
+  version: '2.0.0',
+  kind: 'tool',
+  name: ${JSON.stringify(metadata.name)},
+  description: ${JSON.stringify(metadata.description)},
+  exportName: ${JSON.stringify(metadata.exportName)},
+  pattern: 'class',
+};
+
+export default {
+  __lua_primitive__,
+  primitive: {
+    kind: 'tool',
+    name: toolInstance.name,
+    description: toolInstance.description,
+    inputSchema: toolInstance.inputSchema,
+    execute: toolInstance.execute.bind(toolInstance),
+    condition: toolInstance.condition?.bind(toolInstance),
+  },
+};
+
+${exportStatement}
+`;
+    }
+    /**
+     * Add runtime validation for execute function.
+     */
+    getRuntimeValidation() {
+        return `
+  if (typeof primitive.primitive?.execute !== 'function') {
+    throw new Error('[Lua] Invalid tool artifact: execute is not a function');
+  }`;
+    }
+    async extractSchemas(metadata, project) {
+        if (!metadata.metadata.hasInputSchema)
+            return undefined;
+        const sourceFile = project.getSourceFile(metadata.sourcePath);
+        if (!sourceFile)
+            return undefined;
+        let schemaNode;
+        if (metadata.metadata.pattern === 'class' && metadata.metadata.className) {
+            // Class-based: class X implements LuaTool { inputSchema = z.object(...) }
+            const classDecl = sourceFile.getClass(metadata.metadata.className);
+            if (!classDecl)
+                return undefined;
+            const inputSchemaProp = classDecl.getProperty('inputSchema');
+            if (!inputSchemaProp)
+                return undefined;
+            schemaNode = inputSchemaProp.getInitializer();
+        }
+        else {
+            // Function-based: const x = defineTool({ inputSchema: z.object(...) })
+            const varDecl = sourceFile.getVariableDeclaration(metadata.exportName);
+            if (!varDecl)
+                return undefined;
+            const initializer = varDecl.getInitializer();
+            if (!initializer || !Node.isCallExpression(initializer))
+                return undefined;
+            const args = initializer.getArguments();
+            if (args.length === 0)
+                return undefined;
+            const config = args[0];
+            if (!Node.isObjectLiteralExpression(config))
+                return undefined;
+            schemaNode = extractSchemaProperty(config, 'inputSchema');
+        }
+        if (!schemaNode)
+            return undefined;
+        try {
+            const jsonSchema = await zodToJsonSchema(schemaNode);
+            return { input: jsonSchema };
+        }
+        catch (error) {
+            console.warn(`Warning: Could not convert schema for ${metadata.name}:`, error);
+            return undefined;
+        }
+    }
+    toManifestEntry(compiled, _context) {
+        const tool = {
+            kind: PrimitiveKind.TOOL,
+            name: compiled.name,
+            description: compiled.description,
+            path: `artifacts/${compiled.kind}/${compiled.name}.js`,
+            sourcePath: compiled.sourcePath,
+            hash: compiled.artifact.hash,
+            schemas: compiled.schemas ? {
+                input: compiled.schemas.input,
+                output: compiled.schemas.output,
+            } : undefined,
+        };
+        return tool;
+    }
+}
+//# sourceMappingURL=tool.plugin.js.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * Webhook compilation plugin.
+ *
+ * BACKWARD COMPATIBLE: Detects BOTH patterns:
+ * 1. Class-based (legacy): new LuaWebhook({ ... })
+ * 2. Function-based (new): const myWebhook = defineWebhook({ ... })
+ */
+import { Project, ObjectLiteralExpression } from 'ts-morph';
+import { type WebhookMetadata, type WebhookMetadataFields, type ValidationResult, type SchemaSet, type ManifestContext, type CompiledPrimitive, type ManifestPrimitive } from '../types.js';
+import { BasePlugin } from './base.js';
+/**
+ * Plugin for compiling webhook primitives.
+ * Extends BasePlugin for common detection/entry point/postProcess logic.
+ */
+export declare class WebhookPlugin extends BasePlugin<WebhookMetadataFields> {
+    readonly kind = "webhook";
+    readonly displayName = "Webhook";
+    readonly defineFunction = "defineWebhook";
+    readonly legacyClassNames: string[];
+    /**
+     * Extract metadata from webhook config object.
+     */
+    protected extractFromConfig(config: ObjectLiteralExpression, exportName: string, sourcePath: string, position: {
+        line: number;
+        column: number;
+    }, pattern: 'function' | 'class'): WebhookMetadata | null;
+    validate(metadata: WebhookMetadata): ValidationResult;
+    /**
+     * Add runtime validation for execute function.
+     */
+    protected getRuntimeValidation(): string;
+    /**
+     * Extract query, header, and body schemas from webhook.
+     */
+    extractSchemas(metadata: WebhookMetadata, project: Project): Promise<SchemaSet | undefined>;
+    toManifestEntry(compiled: CompiledPrimitive, _context?: ManifestContext): ManifestPrimitive;
+}

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

@@ -0,0 +1,127 @@
+/**
+ * Webhook compilation plugin.
+ *
+ * BACKWARD COMPATIBLE: Detects BOTH patterns:
+ * 1. Class-based (legacy): new LuaWebhook({ ... })
+ * 2. Function-based (new): const myWebhook = defineWebhook({ ... })
+ */
+import { Node } from 'ts-morph';
+import { PrimitiveKind, } from '../types.js';
+import { BasePlugin, validationError, validationWarning } from './base.js';
+import { extractSchemaProperty } from '../utils/ast-helpers.js';
+import { zodToJsonSchema } from '../utils/schema-converter.js';
+/**
+ * Plugin for compiling webhook primitives.
+ * Extends BasePlugin for common detection/entry point/postProcess logic.
+ */
+export class WebhookPlugin extends BasePlugin {
+    constructor() {
+        super(...arguments);
+        this.kind = 'webhook';
+        this.displayName = 'Webhook';
+        this.defineFunction = 'defineWebhook';
+        this.legacyClassNames = ['LuaWebhook'];
+    }
+    /**
+     * Extract metadata from webhook config object.
+     */
+    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,
+                hasQuerySchema: config.getProperty('querySchema') !== undefined,
+                hasHeaderSchema: config.getProperty('headerSchema') !== undefined,
+                hasBodySchema: config.getProperty('bodySchema') !== undefined,
+            },
+        };
+    }
+    validate(metadata) {
+        const errors = [];
+        const warnings = [];
+        if (!metadata.name) {
+            errors.push(validationError('Webhook must have a name', { line: metadata.line }));
+        }
+        if (!metadata.metadata.hasExecute) {
+            errors.push(validationError('Webhook must have an execute function', { line: metadata.line }));
+        }
+        if (!metadata.description) {
+            warnings.push(validationWarning('Webhook should have a description', { line: metadata.line }));
+        }
+        // Validate name format (URL-safe)
+        if (metadata.name && !/^[a-z][a-z0-9-]*$/.test(metadata.name)) {
+            warnings.push(validationWarning('Webhook name should be URL-safe (lowercase, hyphens only)', { line: metadata.line }));
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    }
+    /**
+     * Add runtime validation for execute function.
+     */
+    getRuntimeValidation() {
+        return `
+  if (typeof primitive.primitive?.execute !== 'function') {
+    throw new Error('[Lua] Invalid webhook artifact: execute is not a function');
+  }`;
+    }
+    /**
+     * Extract query, header, and body schemas from webhook.
+     */
+    async extractSchemas(metadata, project) {
+        const sourceFile = project.getSourceFile(metadata.sourcePath);
+        if (!sourceFile)
+            return undefined;
+        const varDecl = sourceFile.getVariableDeclaration(metadata.exportName);
+        if (!varDecl)
+            return undefined;
+        const initializer = varDecl.getInitializer();
+        if (!initializer || !Node.isCallExpression(initializer))
+            return undefined;
+        const args = initializer.getArguments();
+        if (args.length === 0)
+            return undefined;
+        const config = args[0];
+        if (!Node.isObjectLiteralExpression(config))
+            return undefined;
+        const schemas = {};
+        // Extract each schema type
+        const schemaProps = ['querySchema', 'headerSchema', 'bodySchema'];
+        for (const propName of schemaProps) {
+            if (metadata.metadata[`has${propName.charAt(0).toUpperCase() + propName.slice(1)}`]) {
+                const schemaNode = extractSchemaProperty(config, propName);
+                if (schemaNode) {
+                    try {
+                        const jsonSchema = await zodToJsonSchema(schemaNode);
+                        const key = propName.replace('Schema', '');
+                        schemas[key] = jsonSchema;
+                    }
+                    catch (error) {
+                        console.warn(`Warning: Could not convert ${propName} for ${metadata.name}:`, error);
+                    }
+                }
+            }
+        }
+        return Object.keys(schemas).length > 0 ? schemas : undefined;
+    }
+    toManifestEntry(compiled, _context) {
+        const webhook = {
+            kind: PrimitiveKind.WEBHOOK,
+            name: compiled.name,
+            description: compiled.description,
+            path: `artifacts/${compiled.kind}/${compiled.name}.js`,
+            sourcePath: compiled.sourcePath,
+            hash: compiled.artifact.hash,
+            schemas: compiled.schemas ? {
+                query: compiled.schemas.query,
+                headers: compiled.schemas.headers,
+                body: compiled.schemas.body,
+            } : undefined,
+        };
+        return webhook;
+    }
+}
+//# sourceMappingURL=webhook.plugin.js.map

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

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

package/dist/compiler/source-writer.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Source Writer
+ *
+ * Utilities for modifying Lua agent source code via AST manipulation.
+ * All ts-morph write operations are centralized here.
+ *
+ * ## Current Implementation
+ *
+ * Currently only supports updating `LuaAgent` config properties (name, persona)
+ * in the entry point file. This covers the main use cases:
+ * - `lua init` - setting initial agent config
+ * - `lua sync` - syncing agent name/persona from server
+ * - `lua persona` - updating persona
+ *
+ * ## Future Extensibility
+ *
+ * To support modifying other primitives (skills, jobs, webhooks, etc.),
+ * this module could be extended with a generic API like:
+ *
+ * ```typescript
+ * // Generic primitive update
+ * updatePrimitiveConfig({
+ *   kind: 'LuaSkill',           // Target class: LuaSkill, LuaJob, LuaWebhook, etc.
+ *   name: 'my-skill',           // Find by name property
+ *   file: 'src/skills/my.ts',   // Or specify file directly
+ *   updates: {
+ *     description: 'New desc',
+ *     context: 'New context',
+ *   }
+ * });
+ *
+ * // Or batch updates across files
+ * updatePrimitivesFromManifest(manifest, serverData);
+ * ```
+ *
+ * Key considerations for generic implementation:
+ * - Support different primitive classes (LuaSkill, LuaJob, LuaWebhook, LuaMCPServer)
+ * - Find primitives across multiple files (not just entry point)
+ * - Handle different value types (strings, numbers, objects, arrays)
+ * - Support adding/removing properties, not just updating
+ * - Preserve code formatting and comments where possible
+ *
+ * @example
+ * ```typescript
+ * // Current API - agent config only
+ * updateAgentConfig({ name: 'New Name', persona: 'New persona...' });
+ * setAgentName('New Name');
+ * setAgentPersona('New persona...');
+ * ```
+ */
+/**
+ * Options for source writing operations.
+ */
+export interface SourceWriteOptions {
+    /** Project directory to search (defaults to cwd) */
+    projectDir?: string;
+    /** Override default index file discovery with specific file path */
+    indexFile?: string;
+}
+/**
+ * Update string properties in the LuaAgent configuration in source code.
+ *
+ * This is a generic writer that can update any string properties in
+ * the LuaAgent constructor's config object.
+ *
+ * @param updates - Object with property names and their new values (undefined values are skipped)
+ * @param options - Optional configuration
+ * @returns true if update succeeded, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Update name only
+ * updateAgentConfig({ name: 'New Agent Name' });
+ *
+ * // Update multiple properties
+ * updateAgentConfig({
+ *   name: 'My Agent',
+ *   persona: 'You are a helpful assistant...'
+ * });
+ * ```
+ */
+export declare function updateAgentConfig(updates: Record<string, string | undefined>, options?: SourceWriteOptions): boolean;
+/**
+ * Set the agent name in source code.
+ *
+ * @param name - New agent name
+ * @param options - Optional configuration
+ * @returns true if update succeeded, false otherwise
+ */
+export declare function setAgentName(name: string, options?: SourceWriteOptions): boolean;
+/**
+ * Set the agent persona in source code.
+ *
+ * @param persona - New agent persona
+ * @param options - Optional configuration
+ * @returns true if update succeeded, false otherwise
+ */
+export declare function setAgentPersona(persona: string, options?: SourceWriteOptions): boolean;