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

package/dist/compiler/utils/ast-helpers.js

@@ -0,0 +1,164 @@
+/**
+ * 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, SyntaxKind } from 'ts-morph';
+/**
+ * Extract a string value from an object property.
+ * Handles string literals and template literals.
+ */
+export function extractStringProperty(obj, propertyName) {
+    const prop = obj.getProperty(propertyName);
+    if (!prop || !Node.isPropertyAssignment(prop))
+        return undefined;
+    const value = prop.getInitializer();
+    if (!value)
+        return undefined;
+    // String literal: "value" or 'value'
+    if (Node.isStringLiteral(value)) {
+        return value.getLiteralValue();
+    }
+    // Template literal without expressions: `value`
+    if (Node.isNoSubstitutionTemplateLiteral(value)) {
+        return value.getLiteralValue();
+    }
+    // Template literal with expressions: `${x}` - return the full text
+    if (Node.isTemplateExpression(value)) {
+        // For complex templates, return the raw text minus backticks
+        const text = value.getText();
+        return text.slice(1, -1);
+    }
+    return undefined;
+}
+/**
+ * Extract a boolean value from an object property.
+ */
+export function extractBooleanProperty(obj, propertyName) {
+    const prop = obj.getProperty(propertyName);
+    if (!prop || !Node.isPropertyAssignment(prop))
+        return undefined;
+    const value = prop.getInitializer();
+    if (!value)
+        return undefined;
+    const kind = value.getKind();
+    // TrueKeyword = 110, FalseKeyword = 95 in ts-morph
+    if (kind === SyntaxKind.TrueKeyword)
+        return true;
+    if (kind === SyntaxKind.FalseKeyword)
+        return false;
+    // Handle string "true" or "false"
+    if (Node.isStringLiteral(value)) {
+        const text = value.getLiteralValue();
+        if (text === 'true')
+            return true;
+        if (text === 'false')
+            return false;
+    }
+    return undefined;
+}
+/**
+ * Extract a number value from an object property.
+ */
+export function extractNumberProperty(obj, propertyName) {
+    const prop = obj.getProperty(propertyName);
+    if (!prop || !Node.isPropertyAssignment(prop))
+        return undefined;
+    const value = prop.getInitializer();
+    if (!value)
+        return undefined;
+    if (Node.isNumericLiteral(value)) {
+        return value.getLiteralValue();
+    }
+    return undefined;
+}
+/**
+ * Extract an object literal from an object property.
+ */
+export function extractObjectProperty(obj, propertyName) {
+    const prop = obj.getProperty(propertyName);
+    if (!prop || !Node.isPropertyAssignment(prop))
+        return undefined;
+    const value = prop.getInitializer();
+    if (!value)
+        return undefined;
+    if (Node.isObjectLiteralExpression(value)) {
+        return value;
+    }
+    return undefined;
+}
+/**
+ * Extract a schema node from an object property.
+ * Returns the initializer node which can be evaluated as a Zod schema.
+ */
+export function extractSchemaProperty(obj, propertyName) {
+    const prop = obj.getProperty(propertyName);
+    if (!prop || !Node.isPropertyAssignment(prop))
+        return undefined;
+    return prop.getInitializer();
+}
+/**
+ * Check if a property exists on an object literal.
+ */
+export function hasProperty(obj, propertyName) {
+    return obj.getProperty(propertyName) !== undefined;
+}
+/**
+ * Extract all property names from an object literal.
+ */
+export function getPropertyNames(obj) {
+    return obj.getProperties()
+        .filter(prop => Node.isPropertyAssignment(prop))
+        .map(prop => prop.getName());
+}
+/**
+ * Check if a node is a function (arrow or regular).
+ */
+export function isFunction(node) {
+    if (!node)
+        return false;
+    return Node.isArrowFunction(node) || Node.isFunctionExpression(node);
+}
+/**
+ * Get the text of a function body.
+ */
+export function getFunctionBody(node) {
+    if (!node)
+        return undefined;
+    if (Node.isArrowFunction(node)) {
+        const body = node.getBody();
+        return body.getText();
+    }
+    if (Node.isFunctionExpression(node)) {
+        const body = node.getBody();
+        return body?.getText();
+    }
+    return 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 function findImportSource(identifier, sourceFile, resolveImportPath) {
+    for (const importDecl of sourceFile.getImportDeclarations()) {
+        const defaultImport = importDecl.getDefaultImport();
+        const namedImports = importDecl.getNamedImports();
+        // Check if identifier matches default import or any named import
+        const isMatch = (defaultImport && defaultImport.getText() === identifier) ||
+            namedImports.some(named => named.getName() === identifier);
+        if (isMatch) {
+            return resolveImportPath(importDecl.getModuleSpecifierValue(), sourceFile.getFilePath());
+        }
+    }
+    // Not found in imports - assume local definition in same file
+    return sourceFile.getFilePath();
+}
+//# sourceMappingURL=ast-helpers.js.map

package/dist/compiler/utils/ast-helpers.js.map

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

package/dist/compiler/utils/common.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Common utility functions for the compiler.
+ */
+/**
+ * Hash content using SHA256, returning first 16 hex characters.
+ * Used for content deduplication and cache keys.
+ */
+export declare function hashContent(content: string): string;
+/**
+ * Check if a file should be skipped during scanning.
+ * Used by both primitive detection and project file collection.
+ *
+ * @param filePathOrName - Can be a full path or just a filename
+ */
+export declare function shouldSkipFile(filePathOrName: string): boolean;
+/**
+ * Check if a directory should be skipped during scanning.
+ */
+export declare function shouldSkipDirectory(name: string): boolean;
+/**
+ * Format file size in human-readable format.
+ */
+export declare function formatSize(bytes: number): string;

package/dist/compiler/utils/common.js

@@ -0,0 +1,66 @@
+/**
+ * Common utility functions for the compiler.
+ */
+import crypto from 'crypto';
+// =============================================================================
+// HASHING
+// =============================================================================
+/**
+ * Hash content using SHA256, returning first 16 hex characters.
+ * Used for content deduplication and cache keys.
+ */
+export function hashContent(content) {
+    return crypto.createHash('sha256').update(content).digest('hex').slice(0, 16);
+}
+// =============================================================================
+// FILE FILTERING
+// =============================================================================
+/**
+ * Check if a file should be skipped during scanning.
+ * Used by both primitive detection and project file collection.
+ *
+ * @param filePathOrName - Can be a full path or just a filename
+ */
+export function shouldSkipFile(filePathOrName) {
+    return (filePathOrName.includes('node_modules') ||
+        filePathOrName.includes('.test.') ||
+        filePathOrName.includes('.spec.') ||
+        filePathOrName.includes('__tests__') ||
+        filePathOrName.endsWith('.d.ts') ||
+        filePathOrName.endsWith('.map') ||
+        filePathOrName.startsWith('.') ||
+        filePathOrName === 'package-lock.json' ||
+        filePathOrName === 'yarn.lock' ||
+        filePathOrName === 'pnpm-lock.yaml');
+}
+/**
+ * Check if a directory should be skipped during scanning.
+ */
+export function shouldSkipDirectory(name) {
+    const skipDirs = [
+        'node_modules',
+        'dist',
+        'dist-v2',
+        '.git',
+        '.lua',
+        '.temp',
+        'coverage',
+        '.next',
+        '.turbo',
+    ];
+    return skipDirs.includes(name);
+}
+// =============================================================================
+// FORMATTING
+// =============================================================================
+/**
+ * Format file size in human-readable format.
+ */
+export function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)}MB`;
+}
+//# sourceMappingURL=common.js.map

package/dist/compiler/utils/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/compiler/utils/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,cAAsB;IACnD,OAAO,CACL,cAAc,CAAC,QAAQ,CAAC,cAAc,CAAC;QACvC,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACjC,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACjC,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC;QACpC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC;QAChC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC/B,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC;QAC9B,cAAc,KAAK,mBAAmB;QACtC,cAAc,KAAK,WAAW;QAC9B,cAAc,KAAK,gBAAgB,CACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,QAAQ,GAAG;QACf,cAAc;QACd,MAAM;QACN,SAAS;QACT,MAAM;QACN,MAAM;QACN,OAAO;QACP,UAAU;QACV,OAAO;QACP,QAAQ;KACT,CAAC;IACF,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,GAAG,CAAC;IACrC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC"}

package/dist/compiler/utils/file-discovery.d.ts

@@ -0,0 +1,34 @@
+/**
+ * File Discovery Utilities
+ *
+ * Centralized logic for finding entry points and index files in Lua agent projects.
+ * Used by source-writer and agent-traverser.
+ */
+/**
+ * Find the entry point file for a Lua agent project.
+ *
+ * Searches in priority order:
+ * 1. index.ts (root)
+ * 2. src/index.ts
+ * 3. agent.ts (root)
+ * 4. src/agent.ts
+ * 5. main.ts (root)
+ * 6. src/main.ts
+ *
+ * @param projectDir - Project directory to search (defaults to cwd)
+ * @returns Absolute path to entry point, or null if not found
+ */
+export declare function findEntryPoint(projectDir?: string): string | null;
+/**
+ * Find the index file for a Lua agent project.
+ * Same as findEntryPoint but throws if not found.
+ *
+ * @param projectDir - Project directory to search (defaults to cwd)
+ * @returns Absolute path to entry point
+ * @throws Error if no entry point found
+ */
+export declare function findIndexFile(projectDir?: string): string;
+/**
+ * Get the list of priority entry point paths (for documentation/debugging).
+ */
+export declare function getEntryPointPriority(): readonly string[];

package/dist/compiler/utils/file-discovery.js

@@ -0,0 +1,68 @@
+/**
+ * File Discovery Utilities
+ *
+ * Centralized logic for finding entry points and index files in Lua agent projects.
+ * Used by source-writer and agent-traverser.
+ */
+import path from 'path';
+import fs from 'fs';
+/**
+ * Priority order for finding entry point files.
+ * Common conventions for where agents define their LuaAgent.
+ */
+const ENTRY_POINT_PRIORITY = [
+    'index.ts',
+    'src/index.ts',
+    'agent.ts',
+    'src/agent.ts',
+    'main.ts',
+    'src/main.ts',
+];
+/**
+ * Find the entry point file for a Lua agent project.
+ *
+ * Searches in priority order:
+ * 1. index.ts (root)
+ * 2. src/index.ts
+ * 3. agent.ts (root)
+ * 4. src/agent.ts
+ * 5. main.ts (root)
+ * 6. src/main.ts
+ *
+ * @param projectDir - Project directory to search (defaults to cwd)
+ * @returns Absolute path to entry point, or null if not found
+ */
+export function findEntryPoint(projectDir) {
+    const baseDir = projectDir || process.cwd();
+    for (const relativePath of ENTRY_POINT_PRIORITY) {
+        const fullPath = path.join(baseDir, relativePath);
+        if (fs.existsSync(fullPath)) {
+            return fullPath;
+        }
+    }
+    return null;
+}
+/**
+ * Find the index file for a Lua agent project.
+ * Same as findEntryPoint but throws if not found.
+ *
+ * @param projectDir - Project directory to search (defaults to cwd)
+ * @returns Absolute path to entry point
+ * @throws Error if no entry point found
+ */
+export function findIndexFile(projectDir) {
+    const entryPoint = findEntryPoint(projectDir);
+    if (!entryPoint) {
+        const baseDir = projectDir || process.cwd();
+        throw new Error(`No entry point found in ${baseDir}. ` +
+            `Expected one of: ${ENTRY_POINT_PRIORITY.join(', ')}`);
+    }
+    return entryPoint;
+}
+/**
+ * Get the list of priority entry point paths (for documentation/debugging).
+ */
+export function getEntryPointPriority() {
+    return ENTRY_POINT_PRIORITY;
+}
+//# sourceMappingURL=file-discovery.js.map

package/dist/compiler/utils/file-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-discovery.js","sourceRoot":"","sources":["../../../src/compiler/utils/file-discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;;GAGG;AACH,MAAM,oBAAoB,GAAG;IAC3B,UAAU;IACV,cAAc;IACd,UAAU;IACV,cAAc;IACd,SAAS;IACT,aAAa;CACd,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,UAAmB;IAChD,MAAM,OAAO,GAAG,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAE5C,KAAK,MAAM,YAAY,IAAI,oBAAoB,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAClD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,UAAmB;IAC/C,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,2BAA2B,OAAO,IAAI;YACtC,oBAAoB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtD,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/dist/compiler/utils/path-resolver.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Path Resolver Utilities
+ *
+ * Resolves TypeScript path aliases (e.g., @/, ~/) from tsconfig.json.
+ * Enables the compiler to follow imports that use path aliases.
+ */
+interface PathMappings {
+    baseUrl: string;
+    paths: Record<string, string[]>;
+}
+/**
+ * Reads TypeScript path alias mappings from tsconfig.json.
+ * Results are cached for the process lifetime.
+ *
+ * @returns Path mappings or null if no paths configured
+ */
+export declare function getTsConfigPathMappings(): PathMappings | null;
+/**
+ * Resolves a path alias to an absolute path using tsconfig.json mappings.
+ *
+ * @param specifier - The import specifier (e.g., '@/tools/MyTool')
+ * @returns Resolved absolute path or null if no alias matched
+ */
+export declare function resolvePathAlias(specifier: string): string | null;
+export {};

package/dist/compiler/utils/path-resolver.js

@@ -0,0 +1,66 @@
+/**
+ * Path Resolver Utilities
+ *
+ * Resolves TypeScript path aliases (e.g., @/, ~/) from tsconfig.json.
+ * Enables the compiler to follow imports that use path aliases.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+let cachedMappings;
+/**
+ * Reads TypeScript path alias mappings from tsconfig.json.
+ * Results are cached for the process lifetime.
+ *
+ * @returns Path mappings or null if no paths configured
+ */
+export function getTsConfigPathMappings() {
+    if (cachedMappings !== undefined)
+        return cachedMappings;
+    const tsconfigPath = path.join(process.cwd(), 'tsconfig.json');
+    if (!fs.existsSync(tsconfigPath)) {
+        cachedMappings = null;
+        return null;
+    }
+    try {
+        const tsconfigContent = fs.readFileSync(tsconfigPath, 'utf-8');
+        const tsconfig = JSON.parse(tsconfigContent);
+        const compilerOptions = tsconfig.compilerOptions || {};
+        if (compilerOptions.paths) {
+            cachedMappings = {
+                baseUrl: compilerOptions.baseUrl || '.',
+                paths: compilerOptions.paths,
+            };
+            return cachedMappings;
+        }
+    }
+    catch {
+        // Ignore parsing errors
+    }
+    cachedMappings = null;
+    return null;
+}
+/**
+ * Resolves a path alias to an absolute path using tsconfig.json mappings.
+ *
+ * @param specifier - The import specifier (e.g., '@/tools/MyTool')
+ * @returns Resolved absolute path or null if no alias matched
+ */
+export function resolvePathAlias(specifier) {
+    const mappings = getTsConfigPathMappings();
+    if (!mappings)
+        return null;
+    // Sort patterns by specificity (longest first) to match TypeScript's behavior
+    const sortedPatterns = Object.entries(mappings.paths).sort(([a], [b]) => b.length - a.length);
+    for (const [pattern, targets] of sortedPatterns) {
+        // Convert TypeScript path pattern to regex (e.g., "@/*" -> /^@\/(.*)$/)
+        const patternRegex = new RegExp('^' + pattern.replace(/\*/g, '(.*)').replace(/\//g, '\\/') + '$');
+        const match = specifier.match(patternRegex);
+        if (match) {
+            const captured = match[1] || '';
+            const targetPath = targets[0].replace('*', captured);
+            return path.join(process.cwd(), mappings.baseUrl, targetPath);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=path-resolver.js.map

package/dist/compiler/utils/path-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.js","sourceRoot":"","sources":["../../../src/compiler/utils/path-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAO7B,IAAI,cAA+C,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB;IACrC,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IAExD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IAE/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,cAAc,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC7C,MAAM,eAAe,GAAG,QAAQ,CAAC,eAAe,IAAI,EAAE,CAAC;QAEvD,IAAI,eAAe,CAAC,KAAK,EAAE,CAAC;YAC1B,cAAc,GAAG;gBACf,OAAO,EAAE,eAAe,CAAC,OAAO,IAAI,GAAG;gBACvC,KAAK,EAAE,eAAe,CAAC,KAAK;aAC7B,CAAC;YACF,OAAO,cAAc,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;IAED,cAAc,GAAG,IAAI,CAAC;IACtB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,QAAQ,GAAG,uBAAuB,EAAE,CAAC;IAC3C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,8EAA8E;IAC9E,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CACxD,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAClC,CAAC;IAEF,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,cAAc,EAAE,CAAC;QAChD,wEAAwE;QACxE,MAAM,YAAY,GAAG,IAAI,MAAM,CAC7B,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,GAAG,CACjE,CAAC;QAEF,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/compiler/utils/schema-converter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Zod schema to JSON Schema converter.
+ *
+ * Uses ts-evaluator to evaluate Zod schema AST nodes at compile time,
+ * automatically resolving imports, variables, and expressions.
+ */
+import { Node } from 'ts-morph';
+import type { JSONSchema } from '../types.js';
+/**
+ * Convert a Zod schema AST node to JSON Schema.
+ *
+ * Uses ts-evaluator for proper AST evaluation — resolves all variable
+ * references, imports, and expressions automatically.
+ *
+ * @param schemaNode - The ts-morph node containing the Zod schema
+ * @returns JSON Schema object
+ */
+export declare function zodToJsonSchema(schemaNode: Node): Promise<JSONSchema>;
+/**
+ * Convert a Zod schema string to JSON Schema.
+ * Fallback for when only a string representation is available (no AST node).
+ *
+ * @param zodSchemaCode - String representation of Zod schema
+ * @returns JSON Schema object
+ */
+export declare function zodStringToJsonSchema(zodSchemaCode: string): Promise<JSONSchema>;

package/dist/compiler/utils/schema-converter.js

@@ -0,0 +1,94 @@
+/**
+ * Zod schema to JSON Schema converter.
+ *
+ * Uses ts-evaluator to evaluate Zod schema AST nodes at compile time,
+ * automatically resolving imports, variables, and expressions.
+ */
+import ts from 'typescript';
+import { evaluate } from 'ts-evaluator';
+/**
+ * Convert a Zod schema AST node to JSON Schema.
+ *
+ * Uses ts-evaluator for proper AST evaluation — resolves all variable
+ * references, imports, and expressions automatically.
+ *
+ * @param schemaNode - The ts-morph node containing the Zod schema
+ * @returns JSON Schema object
+ */
+export async function zodToJsonSchema(schemaNode) {
+    const { z } = await import('zod');
+    const { zodToJsonSchema: convertSchema } = await import('zod-to-json-schema');
+    try {
+        const sourceFile = schemaNode.getSourceFile();
+        const project = sourceFile.getProject();
+        const tsNode = schemaNode.compilerNode;
+        const typeChecker = project.getTypeChecker().compilerObject;
+        const result = evaluate({
+            node: tsNode,
+            typeChecker,
+            typescript: ts,
+            environment: {
+                preset: 'NODE',
+                extra: { z },
+            },
+            policy: {
+                deterministic: false,
+                network: false,
+                console: false,
+                io: { read: true, write: false },
+                process: { exit: false, spawnChild: false },
+            },
+        });
+        if (!result.success) {
+            throw new Error(result.reason?.message || 'Failed to evaluate schema');
+        }
+        const zodSchema = result.value;
+        if (!zodSchema || typeof zodSchema !== 'object') {
+            return { type: 'object' };
+        }
+        // zod-to-json-schema returns its own JsonSchema7 type, cast for compatibility
+        const jsonSchema = convertSchema(zodSchema, { target: 'jsonSchema7' });
+        return cleanJsonSchema(jsonSchema);
+    }
+    catch (error) {
+        console.warn(`Warning: Could not convert Zod schema:`, error?.message || error);
+        return { type: 'object' };
+    }
+}
+/**
+ * Clean up JSON Schema by removing unnecessary properties.
+ */
+function cleanJsonSchema(schema) {
+    // Remove top-level metadata we don't need
+    const { $schema, title, definitions, $ref, ...cleanSchema } = schema;
+    // If there's a $ref to definitions, inline it
+    if ($ref && definitions) {
+        const refName = $ref.replace('#/definitions/', '');
+        if (definitions[refName]) {
+            return cleanJsonSchema(definitions[refName]);
+        }
+    }
+    return cleanSchema;
+}
+/**
+ * Convert a Zod schema string to JSON Schema.
+ * Fallback for when only a string representation is available (no AST node).
+ *
+ * @param zodSchemaCode - String representation of Zod schema
+ * @returns JSON Schema object
+ */
+export async function zodStringToJsonSchema(zodSchemaCode) {
+    try {
+        const { z } = await import('zod');
+        const { zodToJsonSchema: convertSchema } = await import('zod-to-json-schema');
+        const evalFunction = new Function('z', `return ${zodSchemaCode}`);
+        const zodSchema = evalFunction(z);
+        const jsonSchema = convertSchema(zodSchema, { target: 'jsonSchema7' });
+        return cleanJsonSchema(jsonSchema);
+    }
+    catch (error) {
+        console.warn(`Warning: Could not evaluate Zod schema string:`, error?.message || error);
+        return { type: 'object' };
+    }
+}
+//# sourceMappingURL=schema-converter.js.map

package/dist/compiler/utils/schema-converter.js.map

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

package/dist/config/compile.constants.d.ts

@@ -1,12 +1,12 @@
 /**
  * Constants for the compile command
  */
-import { BuildOptions } from "esbuild";
 /**
  * Directory names used during compilation
  */
 export declare const COMPILE_DIRS: {
     readonly DIST: "dist";
+    readonly DIST_V2: "dist-v2";
     readonly LUA: ".lua";
     readonly TOOLS: "tools";
 };
@@ -16,6 +16,7 @@ export declare const COMPILE_DIRS: {
 export declare const COMPILE_FILES: {
     readonly DEPLOYMENT_JSON: "deployment.json";
     readonly DEPLOY_JSON: "deploy.json";
+    readonly MANIFEST_JSON: "manifest.json";
     readonly INDEX_TS: "index.ts";
     readonly INDEX_JS: "index.js";
     readonly PACKAGE_JSON: "package.json";
@@ -31,27 +32,6 @@ export declare const SKILL_DEFAULTS: {
     readonly DESCRIPTION: "";
     readonly CONTEXT: "";
 };
-/**
- * External packages that should not be bundled with tools
- * These are native modules, or modules that should be provided by the runtime environment
- * Note: lua-cli is NOT in this list because it's handled by the sandboxGlobalsPlugin
- * which transforms imports to use sandbox globals instead
- */
-export declare const EXTERNAL_PACKAGES: readonly ["zod", "keytar", "esbuild", "commander", "inquirer", "node-fetch", "ws", "socket.io-client", "ts-morph"];
-/**
- * Common esbuild configuration for tool bundling
- */
-export declare const ESBUILD_TOOL_CONFIG: Partial<BuildOptions>;
-/**
- * Common esbuild configuration for main index bundling
- */
-export declare const ESBUILD_INDEX_CONFIG: Partial<BuildOptions>;
-/**
- * Default input schema for tools without explicit schema
- */
-export declare const DEFAULT_INPUT_SCHEMA: {
-    readonly type: "object";
-};
 /**
  * JSON formatting options
  */