agentvault 1.0.1 → 1.0.5

package/dist/src/packaging/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Types for agent packaging
+ */
+/**
+ * Supported agent types that can be packaged
+ */
+export type AgentType = 'clawdbot' | 'goose' | 'cline' | 'polytician' | 'nemoclaw' | 'generic';
+/**
+ * Agent configuration as detected from the source directory
+ */
+export interface AgentConfig {
+    /** Name of the agent */
+    name: string;
+    /** Detected agent type */
+    type: AgentType;
+    /** Source directory path */
+    sourcePath: string;
+    /** Entry point file (if detected) */
+    entryPoint?: string;
+    /** Agent version (if detected) */
+    version?: string;
+}
+/**
+ * Options for the packaging process
+ */
+export interface PackageOptions {
+    /** Source directory containing the agent */
+    sourcePath: string;
+    /** Output directory for compiled artifacts */
+    outputPath?: string;
+    /** Force overwrite of existing output files */
+    force?: boolean;
+    /** Skip validation steps */
+    skipValidation?: boolean;
+    /** Compilation target (wasmedge for local, motoko for ICP) */
+    target?: 'wasmedge' | 'motoko' | 'pure-wasm';
+    /** Enable debugging features (source maps, verbose output) */
+    debug?: boolean;
+    /** Optimization level (0-3) */
+    optimize?: number;
+    /** Run ic-wasm optimize after WASM generation (requires ic-wasm) */
+    icWasmOptimize?: boolean;
+    /** Run ic-wasm shrink to remove unused functions (requires ic-wasm) */
+    icWasmShrink?: boolean;
+    /** Validate WASM against Candid .did interface (requires ic-wasm) */
+    candidInterface?: string;
+    /** Memory limit to set via ic-wasm resource (e.g. '4GiB') */
+    memoryLimit?: string;
+    /** Compute quota to set via ic-wasm resource */
+    computeQuota?: string;
+}
+/**
+ * Result of a successful packaging operation
+ */
+export interface PackageResult {
+    /** Detected agent configuration */
+    config: AgentConfig;
+    /** Path to the generated WASM file */
+    wasmPath: string;
+    /** Path to the generated WAT file (WebAssembly Text format) */
+    watPath: string;
+    /** Path to the serialized state JSON */
+    statePath: string;
+    /** Path to the generated JavaScript bundle */
+    jsBundlePath?: string;
+    /** Path to the generated source map (if enabled) */
+    sourceMapPath?: string;
+    /** Path to the generated manifest file */
+    manifestPath?: string;
+    /** Path to the generated Candid interface (if motoko target) */
+    didPath?: string;
+    /** Size of the WASM file in bytes */
+    wasmSize: number;
+    /** Compilation target used */
+    target: 'wasmedge' | 'motoko' | 'pure-wasm';
+    /** Timestamp of the packaging operation */
+    timestamp: Date;
+    /** Compilation duration in milliseconds */
+    duration?: number;
+    /** Number of functions exported */
+    functionCount?: number;
+    /** Original WASM size before ic-wasm optimization (bytes) */
+    originalWasmSize?: number;
+    /** Size reduction percentage from optimization (0-100) */
+    optimizationReductionPercent?: number;
+    /** Whether Candid validation passed */
+    candidValidationPassed?: boolean;
+    /** Optimization warnings */
+    optimizationWarnings?: string[];
+}
+/**
+ * Validation error that occurred during packaging
+ */
+export interface ValidationError {
+    /** Error code for programmatic handling */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** File path related to the error (if applicable) */
+    filePath?: string;
+}
+/**
+ * Result of agent validation
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** List of validation errors (if any) */
+    errors: ValidationError[];
+    /** List of validation warnings */
+    warnings: string[];
+}
+/**
+ * Parsed agent configuration with agent-specific settings
+ */
+export interface ParsedAgentConfig {
+    base: {
+        name: string;
+        version?: string;
+        description?: string;
+    };
+    type: 'clawdbot' | 'goose' | 'cline' | 'polytician' | 'nemoclaw' | 'generic';
+}
+/**
+ * Config file location
+ */
+export interface ConfigFilePath {
+    path: string;
+    type: 'json' | 'yaml' | 'directory';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/packaging/types.d.ts.map

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

package/dist/src/packaging/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for agent packaging
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/packaging/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/packaging/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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"}