agentvault 1.0.2 → 1.0.5

package/dist/src/packaging/wasm-compiler.d.ts

@@ -0,0 +1,160 @@
+/**
+ * WASM Compiler Abstraction
+ *
+ * This module provides a clean abstraction for WASM compilation with stub implementations
+ * for different compilation targets. It serves as the foundation for future real compilation
+ * support (Motoko, Rust, AssemblyScript, etc.).
+ */
+import type { AgentConfig, PackageResult } from './types.js';
+/**
+ * Supported compilation targets
+ */
+export type CompilationTarget = 'javascript' | 'motoko' | 'rust' | 'assemblyscript';
+/**
+ * WASM compilation options
+ */
+export interface WasmCompilationOptions {
+    /** Compilation target language */
+    target: CompilationTarget;
+    /** Enable optimization passes */
+    optimize?: boolean;
+    /** Optimization level (0-3) */
+    optimizationLevel?: 0 | 1 | 2 | 3;
+    /** Enable debug information */
+    debug?: boolean;
+    /** Memory configuration */
+    memory?: WasmMemoryConfig;
+    /** Custom compilation flags */
+    flags?: string[];
+}
+/**
+ * WASM memory configuration
+ */
+export interface WasmMemoryConfig {
+    /** Initial memory pages (64KB each) */
+    initial: number;
+    /** Maximum memory pages (optional) */
+    maximum?: number;
+    /** Memory is shared across threads */
+    shared?: boolean;
+}
+/**
+ * WASM compilation result
+ */
+export interface WasmCompilationResult {
+    /** Compiled WASM binary */
+    wasmBinary: Buffer;
+    /** WAT text representation */
+    watText: string;
+    /** Embedded source bundle (if applicable) */
+    sourceBundle?: string;
+    /** Compilation metadata */
+    metadata: WasmCompilationMetadata;
+}
+/**
+ * Compilation metadata
+ */
+export interface WasmCompilationMetadata {
+    /** Compilation target used */
+    target: CompilationTarget;
+    /** WASM binary size in bytes */
+    binarySize: number;
+    /** Source bundle size in bytes (if applicable) */
+    sourceBundleSize?: number;
+    /** Exported functions */
+    exports: string[];
+    /** Memory configuration used */
+    memory: WasmMemoryConfig;
+    /** Compilation timestamp */
+    timestamp: Date;
+    /** Whether this is a stub implementation */
+    isStub: boolean;
+}
+/**
+ * WASM Compiler class
+ *
+ * Provides compilation methods for different targets. Currently implements:
+ * - JavaScript bundling (real implementation using esbuild)
+ * - Motoko compilation (stub)
+ * - Rust compilation (stub)
+ * - AssemblyScript compilation (stub)
+ */
+export declare class WasmCompiler {
+    private options;
+    constructor(options?: Partial<WasmCompilationOptions>);
+    /**
+     * Compile agent to WASM
+     *
+     * Routes to the appropriate compilation method based on target.
+     */
+    compile(config: AgentConfig): Promise<WasmCompilationResult>;
+    /**
+     * Compile JavaScript/TypeScript to WASM
+     *
+     * Uses esbuild to bundle the agent code and embeds it in a WASM module.
+     * This is the primary compilation path for most agents.
+     */
+    private compileJavaScript;
+    /**
+     * Stub: Compile Motoko to WASM
+     *
+     * This is a placeholder for future Motoko compilation support.
+     * Motoko is the native language for Internet Computer canisters.
+     */
+    private compileMotokoStub;
+    /**
+     * Stub: Compile Rust to WASM
+     *
+     * This is a placeholder for future Rust compilation support.
+     * Would use wasm-pack or cargo-wasm for actual compilation.
+     */
+    private compileRustStub;
+    /**
+     * Stub: Compile AssemblyScript to WASM
+     *
+     * This is a placeholder for future AssemblyScript compilation support.
+     * AssemblyScript compiles TypeScript-like syntax directly to WASM.
+     */
+    private compileAssemblyScriptStub;
+    /**
+     * Bundle source code using esbuild
+     */
+    private bundleSource;
+    /**
+     * Generate WASM binary with embedded source bundle
+     */
+    private generateWasmBinary;
+    /**
+     * Generate stub WASM binary (minimal valid WASM without embedded code)
+     */
+    private generateStubWasmBinary;
+    /**
+     * Generate WAT text representation
+     */
+    private generateWatText;
+    /**
+     * Generate stub WAT text representation
+     */
+    private generateStubWatText;
+}
+/**
+ * Compile agent to WASM and write output files
+ *
+ * High-level function that handles the full compilation pipeline.
+ */
+export declare function compileAgentToWasm(config: AgentConfig, outputDir: string, options?: Partial<WasmCompilationOptions>): Promise<PackageResult>;
+/**
+ * Validate WASM binary
+ *
+ * Checks that a buffer has valid WASM magic bytes and version.
+ */
+export declare function validateWasmBinary(buffer: Buffer): boolean;
+/**
+ * Get supported compilation targets
+ */
+export declare function getSupportedTargets(): CompilationTarget[];
+/**
+ * Check if a compilation target is supported (non-stub)
+ */
+export declare function isTargetFullySupported(target: CompilationTarget): boolean;
+//# sourceMappingURL=wasm-compiler.d.ts.map

package/dist/src/packaging/wasm-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-compiler.d.ts","sourceRoot":"","sources":["../../../src/packaging/wasm-compiler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,iBAAiB,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,EAAE,uBAAuB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,8BAA8B;IAC9B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gCAAgC;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,4BAA4B;IAC5B,SAAS,EAAE,IAAI,CAAC;IAChB,4CAA4C;IAC5C,MAAM,EAAE,OAAO,CAAC;CACjB;AAoED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,GAAE,OAAO,CAAC,sBAAsB,CAAM;IAIzD;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAelE;;;;;OAKG;YACW,iBAAiB;IA0B/B;;;;;OAKG;YACW,iBAAiB;IAkB/B;;;;;OAKG;YACW,eAAe;IAkB7B;;;;;OAKG;YACW,yBAAyB;IAkBvC;;OAEG;YACW,YAAY;IA0C1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsI1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyG9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAwDvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAwD5B;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC5C,OAAO,CAAC,aAAa,CAAC,CA0CxB;AAsCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAgB1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAGzE"}