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

package/dist/compiler/source-writer.js

@@ -0,0 +1,223 @@
+/**
+ * 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...');
+ * ```
+ */
+import { Project, Node } from 'ts-morph';
+import fs from 'fs';
+import path from 'path';
+import { findEntryPoint } from './utils/file-discovery.js';
+/**
+ * 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 function updateAgentConfig(updates, options) {
+    // Filter out undefined values
+    const filteredUpdates = {};
+    for (const [key, value] of Object.entries(updates)) {
+        if (value !== undefined) {
+            filteredUpdates[key] = value;
+        }
+    }
+    if (Object.keys(filteredUpdates).length === 0) {
+        return true; // Nothing to update
+    }
+    let indexPath;
+    try {
+        if (options?.indexFile) {
+            indexPath = options.indexFile;
+        }
+        else {
+            // Try to find the entry point
+            const entryPoint = findEntryPoint(options?.projectDir);
+            if (entryPoint) {
+                indexPath = entryPoint;
+            }
+            else {
+                // Fallback to src/index.ts
+                const baseDir = options?.projectDir || process.cwd();
+                indexPath = path.join(baseDir, 'src', 'index.ts');
+            }
+        }
+    }
+    catch {
+        // Fallback to src/index.ts if discovery fails
+        const baseDir = options?.projectDir || process.cwd();
+        indexPath = path.join(baseDir, 'src', 'index.ts');
+    }
+    if (!fs.existsSync(indexPath)) {
+        console.warn(`Warning: Entry file not found at ${indexPath}`);
+        return false;
+    }
+    try {
+        const project = new Project({ skipAddingFilesFromTsConfig: true });
+        const sourceFile = project.addSourceFileAtPath(indexPath);
+        let updated = false;
+        sourceFile.forEachDescendant((node) => {
+            if (Node.isNewExpression(node) && node.getExpression().getText() === 'LuaAgent') {
+                const args = node.getArguments();
+                if (args.length > 0 && Node.isObjectLiteralExpression(args[0])) {
+                    const configObj = args[0];
+                    configObj.getProperties().forEach((prop) => {
+                        if (Node.isPropertyAssignment(prop)) {
+                            const propName = prop.getName();
+                            if (Object.prototype.hasOwnProperty.call(filteredUpdates, propName)) {
+                                const newValue = filteredUpdates[propName];
+                                const init = prop.getInitializer();
+                                if (init) {
+                                    const formattedValue = formatValueForProperty(propName, newValue);
+                                    init.replaceWithText(formattedValue);
+                                    updated = true;
+                                }
+                            }
+                        }
+                    });
+                }
+            }
+        });
+        if (updated) {
+            sourceFile.saveSync();
+        }
+        return true;
+    }
+    catch (error) {
+        console.warn('Warning: Could not update agent config in source:', error);
+        return false;
+    }
+}
+/**
+ * Set the agent name in source code.
+ *
+ * @param name - New agent name
+ * @param options - Optional configuration
+ * @returns true if update succeeded, false otherwise
+ */
+export function setAgentName(name, options) {
+    return updateAgentConfig({ name }, options);
+}
+/**
+ * Set the agent persona in source code.
+ *
+ * @param persona - New agent persona
+ * @param options - Optional configuration
+ * @returns true if update succeeded, false otherwise
+ */
+export function setAgentPersona(persona, options) {
+    return updateAgentConfig({ persona }, options);
+}
+// =============================================================================
+// FUTURE: GENERIC PRIMITIVE UPDATE TYPES
+// =============================================================================
+// 
+// When extending to support other primitives, consider these types:
+//
+// type PrimitiveClassName = 'LuaAgent' | 'LuaSkill' | 'LuaJob' | 'LuaWebhook' | 'LuaMCPServer' | 'PreProcessor' | 'PostProcessor';
+//
+// interface UpdatePrimitiveOptions {
+//   /** Target class name to find */
+//   kind: PrimitiveClassName;
+//   /** Find primitive by name (searches for name property match) */
+//   name?: string;
+//   /** Or specify exact file path */
+//   file?: string;
+//   /** Properties to update */
+//   updates: Record<string, unknown>;
+//   /** Project directory */
+//   projectDir?: string;
+// }
+//
+// Key implementation notes:
+// - Use compiler's existing file discovery to find primitive source files
+// - Leverage manifest to map primitive names to source paths
+// - Handle class-based and object-based patterns (new LuaSkill({...}) vs const skill: LuaSkill = {...})
+// - Consider using ts-morph's manipulation API for safer edits
+// =============================================================================
+// =============================================================================
+// INTERNAL HELPERS
+// =============================================================================
+/**
+ * Format a value for insertion into source code.
+ * Uses appropriate quoting based on property type.
+ *
+ * TODO: For generic primitive support, extend to handle:
+ * - Numbers (no quotes)
+ * - Objects (JSON.stringify with formatting)
+ * - Arrays (preserve or format)
+ * - References (variable names, imports)
+ */
+function formatValueForProperty(propertyName, value) {
+    // Properties that typically use template literals (multiline strings)
+    const templateLiteralProperties = ['persona', 'description', 'context', 'systemPrompt'];
+    if (templateLiteralProperties.includes(propertyName)) {
+        // Use template literal for multiline strings
+        const escaped = value.replace(/`/g, '\\`').replace(/\$\{/g, '\\${');
+        return `\`${escaped}\``;
+    }
+    // Use single quotes for simple strings
+    const escaped = value.replace(/'/g, "\\'");
+    return `'${escaped}'`;
+}
+//# sourceMappingURL=source-writer.js.map

package/dist/compiler/source-writer.js.map

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

package/dist/compiler/types.d.ts

@@ -0,0 +1,289 @@
+/**
+ * Compilation Types
+ *
+ * All types related to the compilation process, plugins, and output manifest.
+ * Uses discriminated unions for type-safe primitive handling.
+ */
+export interface CompilerOptions {
+    /** Root directory of the project */
+    rootDir: string;
+    /** Output directory for artifacts */
+    outDir: string;
+    /** Enable source maps */
+    sourceMaps?: boolean;
+    /** Minify output */
+    minify?: boolean;
+    /** Enable debug mode (extra verbose logging, preserve temps) */
+    debug?: boolean;
+    /** Enable verbose output (show each primitive as it compiles) */
+    verbose?: boolean;
+    /** Skip validation warnings (still show errors) */
+    quietWarnings?: boolean;
+    /** Add runtime validation wrapper to artifacts (default: true) */
+    runtimeValidation?: boolean;
+}
+export interface CompilationResult {
+    success: boolean;
+    manifest: CompilationManifest;
+    errors: CompilationError[];
+    warnings: CompilationWarning[];
+    stats: CompilationStats;
+}
+/** Base for compilation messages (errors and warnings) */
+interface CompilationMessageBase {
+    primitive?: string;
+    kind?: string;
+    file: string;
+    line?: number;
+    message: string;
+}
+export interface CompilationError extends CompilationMessageBase {
+    column?: number;
+    suggestion?: string;
+}
+export interface CompilationWarning extends CompilationMessageBase {
+}
+export interface CompilationStats {
+    totalPrimitives: number;
+    byKind: Record<string, number>;
+    totalSize: number;
+    duration: number;
+}
+/** Core identity fields shared by all primitive representations */
+interface PrimitiveIdentity {
+    /** Primitive type (tool, job, webhook, etc.) */
+    kind: string;
+    /** Name from the definition */
+    name: string;
+    /** Description from the definition */
+    description: string;
+    /** Path to the source file */
+    sourcePath: string;
+}
+/** Pattern for class-based or function-based definitions */
+export type DefinitionPattern = 'class' | 'function';
+/** Base metadata fields that all primitives share */
+export interface BaseMetadataFields {
+    pattern?: string;
+}
+/** Common fields extracted by extractCommonFields() helper (excludes 'kind' which plugins add) */
+export interface CommonExtractedFields extends Omit<PrimitiveIdentity, 'kind'> {
+    exportName: string;
+    isDefaultExport: boolean;
+    line: number;
+    column: number;
+}
+/** Metadata extracted from source code during scanning */
+export interface PrimitiveMetadata<T extends BaseMetadataFields = BaseMetadataFields> extends PrimitiveIdentity {
+    /** The export name in the source file (or 'default' for default exports) */
+    exportName: string;
+    /** Whether this primitive uses `export default` syntax */
+    isDefaultExport: boolean;
+    /** Line number in source (for error messages) */
+    line?: number;
+    /** Column number in source */
+    column?: number;
+    /** Type-specific metadata (typed per plugin) */
+    metadata: T;
+}
+export interface ToolMetadataFields extends BaseMetadataFields {
+    pattern: DefinitionPattern;
+    className?: string;
+    hasInputSchema: boolean;
+    hasCondition?: boolean;
+    hasExecute?: boolean;
+}
+export interface SkillMetadataFields extends BaseMetadataFields {
+    pattern: DefinitionPattern;
+    toolRefs: string[];
+    context?: string;
+}
+export interface JobMetadataFields extends BaseMetadataFields {
+    pattern: DefinitionPattern;
+    scheduleType?: string;
+    scheduleExpression?: string;
+    hasExecute?: boolean;
+    hasTimeout?: boolean;
+    hasRetry?: boolean;
+    timeoutValue?: number;
+    retryConfig?: {
+        maxAttempts?: number;
+        backoffSeconds?: number;
+    };
+}
+export interface WebhookMetadataFields extends BaseMetadataFields {
+    pattern: DefinitionPattern;
+    hasExecute?: boolean;
+    hasQuerySchema?: boolean;
+    hasHeaderSchema?: boolean;
+    hasBodySchema?: boolean;
+}
+/** Shared metadata for pre/post processors */
+export interface ProcessorMetadataFields extends BaseMetadataFields {
+    pattern: DefinitionPattern;
+    hasExecute?: boolean;
+    isAsync?: boolean;
+}
+export type PreProcessorMetadataFields = ProcessorMetadataFields;
+export type PostProcessorMetadataFields = ProcessorMetadataFields;
+export interface MCPServerMetadataFields extends BaseMetadataFields {
+    transport: 'stdio' | 'sse' | 'streamable-http';
+    url?: string;
+    hasUrlResolver?: boolean;
+    hasHeadersResolver?: boolean;
+    urlResolverSource?: string;
+    headersResolverSource?: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    config?: Record<string, unknown>;
+}
+export type ToolMetadata = PrimitiveMetadata<ToolMetadataFields>;
+export type SkillMetadata = PrimitiveMetadata<SkillMetadataFields>;
+export type JobMetadata = PrimitiveMetadata<JobMetadataFields>;
+export type WebhookMetadata = PrimitiveMetadata<WebhookMetadataFields>;
+export type PreProcessorMetadata = PrimitiveMetadata<PreProcessorMetadataFields>;
+export type PostProcessorMetadata = PrimitiveMetadata<PostProcessorMetadataFields>;
+export type MCPServerMetadata = PrimitiveMetadata<MCPServerMetadataFields>;
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationMessage[];
+    warnings: ValidationMessage[];
+}
+export interface ValidationMessage {
+    message: string;
+    line?: number;
+    column?: number;
+    suggestion?: string;
+    docsUrl?: string;
+}
+export interface JSONSchema {
+    type?: string | string[];
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema;
+    enum?: unknown[];
+    const?: unknown;
+    description?: string;
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    additionalProperties?: boolean | JSONSchema;
+    oneOf?: JSONSchema[];
+    anyOf?: JSONSchema[];
+    allOf?: JSONSchema[];
+    $ref?: string;
+}
+export interface SchemaSet {
+    input?: JSONSchema;
+    output?: JSONSchema;
+    query?: JSONSchema;
+    headers?: JSONSchema;
+    body?: JSONSchema;
+    [key: string]: JSONSchema | undefined;
+}
+export interface BundledArtifact {
+    code: string;
+    sourceMap: string;
+    originalSource: string;
+    size: number;
+    hash: string;
+}
+export interface CompiledPrimitive extends PrimitiveIdentity {
+    artifact: BundledArtifact;
+    schemas?: SchemaSet;
+    metadata: BaseMetadataFields;
+}
+export interface ProjectFile {
+    relativePath: string;
+    hash: string;
+    size: number;
+    type: 'source' | 'config' | 'other';
+}
+export declare enum PrimitiveKind {
+    TOOL = "tool",
+    SKILL = "skill",
+    JOB = "job",
+    WEBHOOK = "webhook",
+    PREPROCESSOR = "preprocessor",
+    POSTPROCESSOR = "postprocessor",
+    MCP_SERVER = "mcp-server"
+}
+interface ManifestPrimitiveBase extends PrimitiveIdentity {
+    /** Path to the compiled artifact */
+    path: string;
+    /** Content hash for cache invalidation */
+    hash: string;
+}
+export interface ManifestTool extends ManifestPrimitiveBase {
+    kind: PrimitiveKind.TOOL;
+    schemas?: {
+        input?: JSONSchema;
+        output?: JSONSchema;
+    };
+}
+export interface ManifestSkill extends ManifestPrimitiveBase {
+    kind: PrimitiveKind.SKILL;
+    context?: string;
+    tools: string[];
+}
+export interface ManifestJob extends ManifestPrimitiveBase {
+    kind: PrimitiveKind.JOB;
+    schedule?: {
+        type: string;
+        expression?: string;
+        interval?: string;
+    };
+    timeout?: number;
+    retry?: {
+        maxAttempts?: number;
+        backoffSeconds?: number;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface ManifestWebhook extends ManifestPrimitiveBase {
+    kind: PrimitiveKind.WEBHOOK;
+    schemas?: {
+        query?: JSONSchema;
+        headers?: JSONSchema;
+        body?: JSONSchema;
+    };
+}
+export interface ManifestPreProcessor extends ManifestPrimitiveBase {
+    kind: PrimitiveKind.PREPROCESSOR;
+    isAsync?: boolean;
+}
+export interface ManifestPostProcessor extends ManifestPrimitiveBase {
+    kind: PrimitiveKind.POSTPROCESSOR;
+}
+export interface ManifestMCPServer extends ManifestPrimitiveBase {
+    kind: PrimitiveKind.MCP_SERVER;
+    config?: Record<string, unknown>;
+    urlResolver?: string;
+    headersResolver?: string;
+}
+export type ManifestPrimitive = ManifestTool | ManifestSkill | ManifestJob | ManifestWebhook | ManifestPreProcessor | ManifestPostProcessor | ManifestMCPServer;
+export interface CompilationManifest {
+    version: string;
+    compiledAt: string;
+    agent?: {
+        name: string;
+        persona: string;
+    };
+    primitives: ManifestPrimitive[];
+    projectFiles: ProjectFile[];
+    config: {
+        packageJson?: string;
+        tsconfigJson?: string;
+        luaSkillYaml?: string;
+    };
+}
+export interface ManifestContext {
+    agentPrimitives?: PrimitiveMetadata[];
+    outDir?: string;
+}
+export {};

package/dist/compiler/types.js

@@ -0,0 +1,20 @@
+/**
+ * Compilation Types
+ *
+ * All types related to the compilation process, plugins, and output manifest.
+ * Uses discriminated unions for type-safe primitive handling.
+ */
+// =============================================================================
+// MANIFEST PRIMITIVES
+// =============================================================================
+export var PrimitiveKind;
+(function (PrimitiveKind) {
+    PrimitiveKind["TOOL"] = "tool";
+    PrimitiveKind["SKILL"] = "skill";
+    PrimitiveKind["JOB"] = "job";
+    PrimitiveKind["WEBHOOK"] = "webhook";
+    PrimitiveKind["PREPROCESSOR"] = "preprocessor";
+    PrimitiveKind["POSTPROCESSOR"] = "postprocessor";
+    PrimitiveKind["MCP_SERVER"] = "mcp-server";
+})(PrimitiveKind || (PrimitiveKind = {}));
+//# sourceMappingURL=types.js.map

package/dist/compiler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgRH,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,MAAM,CAAN,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,gCAAe,CAAA;IACf,4BAAW,CAAA;IACX,oCAAmB,CAAA;IACnB,8CAA6B,CAAA;IAC7B,gDAA+B,CAAA;IAC/B,0CAAyB,CAAA;AAC3B,CAAC,EARW,aAAa,KAAb,aAAa,QAQxB"}

package/dist/compiler/utils/ast-helpers.d.ts

@@ -0,0 +1,57 @@
+/**
+ * AST helper functions for extracting values from ts-morph nodes.
+ *
+ * These utilities make it easy to extract typed values from
+ * object literal expressions in TypeScript source code.
+ */
+import { Node, ObjectLiteralExpression, SourceFile } from 'ts-morph';
+/**
+ * Extract a string value from an object property.
+ * Handles string literals and template literals.
+ */
+export declare function extractStringProperty(obj: ObjectLiteralExpression, propertyName: string): string | undefined;
+/**
+ * Extract a boolean value from an object property.
+ */
+export declare function extractBooleanProperty(obj: ObjectLiteralExpression, propertyName: string): boolean | undefined;
+/**
+ * Extract a number value from an object property.
+ */
+export declare function extractNumberProperty(obj: ObjectLiteralExpression, propertyName: string): number | undefined;
+/**
+ * Extract an object literal from an object property.
+ */
+export declare function extractObjectProperty(obj: ObjectLiteralExpression, propertyName: string): ObjectLiteralExpression | undefined;
+/**
+ * Extract a schema node from an object property.
+ * Returns the initializer node which can be evaluated as a Zod schema.
+ */
+export declare function extractSchemaProperty(obj: ObjectLiteralExpression, propertyName: string): Node | undefined;
+/**
+ * Check if a property exists on an object literal.
+ */
+export declare function hasProperty(obj: ObjectLiteralExpression, propertyName: string): boolean;
+/**
+ * Extract all property names from an object literal.
+ */
+export declare function getPropertyNames(obj: ObjectLiteralExpression): string[];
+/**
+ * Check if a node is a function (arrow or regular).
+ */
+export declare function isFunction(node: Node | undefined): boolean;
+/**
+ * Get the text of a function body.
+ */
+export declare function getFunctionBody(node: Node | undefined): string | undefined;
+/**
+ * Find the source file path for an imported identifier.
+ *
+ * Checks both default and named imports for the given identifier name.
+ * Falls back to the current source file if not found in imports (for local definitions).
+ *
+ * @param identifier - The identifier name to find (e.g., 'MyTool', 'searchTool')
+ * @param sourceFile - The source file containing the imports
+ * @param resolveImportPath - Function to resolve module specifier to absolute path
+ * @returns Absolute path to the source file, or sourceFile path for local definitions
+ */
+export declare function findImportSource(identifier: string, sourceFile: SourceFile, resolveImportPath: (specifier: string, fromFile: string) => string | null): string | null;