@elizaos/interop 2.0.0-alpha.52 → 2.0.0-alpha.520

package/dist/types.d.ts

@@ -0,0 +1,301 @@
+/**
+ * Cross-language interop types for elizaOS
+ *
+ * These types define the wire format for communication between
+ * different language runtimes (Rust, TypeScript, Python).
+ *
+ * Standalone definitions matching proto schemas in /schemas/eliza/v1/ipc.proto.
+ * For full proto-generated types, import from @elizaos/core.
+ */
+import type { Content, Memory, State } from "@elizaos/core";
+/**
+ * Supported interop protocols
+ */
+export type InteropProtocol = "wasm" | "ffi" | "ipc" | "native";
+/**
+ * Supported plugin languages
+ */
+export type PluginLanguage = "typescript" | "rust" | "python";
+/**
+ * Plugin interop configuration
+ */
+export interface PluginInteropConfig {
+    /** Communication protocol */
+    protocol: InteropProtocol;
+    /** Path to WASM module (for wasm protocol) */
+    wasmPath?: string;
+    /** Path to shared library (for ffi protocol) */
+    sharedLibPath?: string;
+    /** IPC command to spawn subprocess */
+    ipcCommand?: string;
+    /** IPC port for TCP communication */
+    ipcPort?: number;
+    /** Working directory for subprocess */
+    cwd?: string;
+}
+/**
+ * Cross-language plugin manifest
+ */
+export interface PluginManifest {
+    name: string;
+    description: string;
+    version: string;
+    language: PluginLanguage;
+    interop?: PluginInteropConfig;
+    config?: Record<string, string | number | boolean | null>;
+    dependencies?: string[];
+    actions?: ActionManifest[];
+    providers?: ProviderManifest[];
+    evaluators?: EvaluatorManifest[];
+    services?: ServiceManifest[];
+    routes?: RouteManifest[];
+    events?: Record<string, string[]>;
+}
+/**
+ * Action manifest (metadata only, no handlers)
+ */
+export interface ActionManifest {
+    name: string;
+    description: string;
+    similes?: string[];
+    examples?: ActionExample[][];
+}
+/**
+ * Action example for documentation
+ */
+export interface ActionExample {
+    name: string;
+    content: Content;
+}
+/**
+ * Provider manifest
+ */
+export interface ProviderManifest {
+    name: string;
+    description?: string;
+    dynamic?: boolean;
+    position?: number;
+    private?: boolean;
+}
+/**
+ * Evaluator manifest
+ */
+export interface EvaluatorManifest {
+    name: string;
+    description: string;
+    alwaysRun?: boolean;
+    similes?: string[];
+}
+/**
+ * Service manifest
+ */
+export interface ServiceManifest {
+    type: string;
+    description?: string;
+}
+/**
+ * Route manifest
+ */
+export interface RouteManifest {
+    path: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "STATIC";
+    name?: string;
+    public?: boolean;
+    isMultipart?: boolean;
+}
+/**
+ * Base IPC message
+ */
+export interface IPCMessage {
+    type: string;
+    id: string;
+}
+/**
+ * Action invocation request
+ */
+export interface ActionInvokeRequest extends IPCMessage {
+    type: "action.invoke";
+    action: string;
+    memory: Memory;
+    state: State | null;
+    options: Record<string, unknown> | null;
+}
+/**
+ * Action result response
+ */
+export interface ActionResultResponse extends IPCMessage {
+    type: "action.result";
+    result: ActionResultPayload;
+}
+/**
+ * Action result payload
+ */
+export interface ActionResultPayload {
+    success: boolean;
+    text?: string;
+    error?: string;
+    data?: Record<string, unknown>;
+    values?: Record<string, unknown>;
+}
+/**
+ * Action validation request
+ */
+export interface ActionValidateRequest extends IPCMessage {
+    type: "action.validate";
+    action: string;
+    memory: Memory;
+    state: State | null;
+}
+/**
+ * Validation result response
+ */
+export interface ValidationResponse extends IPCMessage {
+    type: "validate.result";
+    valid: boolean;
+}
+/**
+ * Provider get request
+ */
+export interface ProviderGetRequest extends IPCMessage {
+    type: "provider.get";
+    provider: string;
+    memory: Memory;
+    state: State;
+}
+/**
+ * Provider result response
+ */
+export interface ProviderResultResponse extends IPCMessage {
+    type: "provider.result";
+    result: ProviderResultPayload;
+}
+/**
+ * Provider result payload
+ */
+export interface ProviderResultPayload {
+    text?: string;
+    values?: Record<string, unknown>;
+    data?: Record<string, unknown>;
+}
+/**
+ * Evaluator invocation request
+ */
+export interface EvaluatorInvokeRequest extends IPCMessage {
+    type: "evaluator.invoke";
+    evaluator: string;
+    memory: Memory;
+    state: State | null;
+}
+/**
+ * Service start request
+ */
+export interface ServiceStartRequest extends IPCMessage {
+    type: "service.start";
+    service: string;
+}
+/**
+ * Service stop request
+ */
+export interface ServiceStopRequest extends IPCMessage {
+    type: "service.stop";
+    service: string;
+}
+/**
+ * Service response
+ */
+export interface ServiceResponse extends IPCMessage {
+    type: "service.response";
+    success: boolean;
+    error?: string;
+}
+/**
+ * Route handler request
+ */
+export interface RouteHandlerRequest extends IPCMessage {
+    type: "route.handle";
+    path: string;
+    method: string;
+    body?: unknown;
+    params?: Record<string, string>;
+    query?: Record<string, unknown>;
+    headers?: Record<string, string | string[]>;
+}
+/**
+ * Route handler response
+ */
+export interface RouteHandlerResponse extends IPCMessage {
+    type: "route.response";
+    status: number;
+    headers?: Record<string, string | string[]>;
+    body?: unknown;
+}
+/**
+ * Plugin initialization request
+ */
+export interface PluginInitRequest extends IPCMessage {
+    type: "plugin.init";
+    config: Record<string, string>;
+}
+/**
+ * Plugin initialization response
+ */
+export interface PluginInitResponse extends IPCMessage {
+    type: "plugin.init.result";
+    success: boolean;
+    error?: string;
+}
+/**
+ * Error response
+ */
+export interface ErrorResponse extends IPCMessage {
+    type: "error";
+    error: string;
+    details?: unknown;
+}
+/**
+ * All possible IPC request types
+ */
+export type IPCRequest = ActionInvokeRequest | ActionValidateRequest | ProviderGetRequest | EvaluatorInvokeRequest | ServiceStartRequest | ServiceStopRequest | RouteHandlerRequest | PluginInitRequest;
+/**
+ * All possible IPC response types
+ */
+export type IPCResponse = ActionResultResponse | ValidationResponse | ProviderResultResponse | ServiceResponse | RouteHandlerResponse | PluginInitResponse | ErrorResponse;
+/**
+ * WASM plugin exports interface
+ */
+export interface WasmPluginExports {
+    /** Get plugin manifest as JSON string */
+    get_manifest(): string;
+    /** Initialize the plugin with config JSON */
+    init(config_json: string): void;
+    /** Validate an action (returns boolean) */
+    validate_action(action: string, memory_json: string, state_json: string): boolean;
+    /** Invoke an action (returns result JSON) */
+    invoke_action(action: string, memory_json: string, state_json: string, options_json: string): string;
+    /** Get provider data (returns result JSON) */
+    get_provider(provider: string, memory_json: string, state_json: string): string;
+    /** Validate an evaluator */
+    validate_evaluator(evaluator: string, memory_json: string, state_json: string): boolean;
+    /** Invoke an evaluator (returns result JSON) */
+    invoke_evaluator(evaluator: string, memory_json: string, state_json: string): string;
+    /** Handle a route (returns response JSON) */
+    handle_route(path: string, method: string, request_json: string): string;
+    /** Memory allocation for passing strings */
+    alloc(size: number): number;
+    /** Memory deallocation */
+    dealloc(ptr: number, size: number): void;
+}
+/**
+ * WASM memory interface
+ */
+export interface WasmMemory {
+    buffer: ArrayBuffer;
+}
+/**
+ * WASM instance with memory and exports
+ */
+export interface WasmPluginInstance {
+    exports: WasmPluginExports;
+    memory: WasmMemory;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * Cross-language interop types for elizaOS
+ *
+ * These types define the wire format for communication between
+ * different language runtimes (Rust, TypeScript, Python).
+ *
+ * Standalone definitions matching proto schemas in /schemas/eliza/v1/ipc.proto.
+ * For full proto-generated types, import from @elizaos/core.
+ */
+export {};

package/dist/wasm-loader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * WASM Plugin Loader for elizaOS
+ *
+ * Loads Rust (or other) plugins compiled to WebAssembly and adapts them
+ * to the TypeScript Plugin interface.
+ */
+import type { Plugin } from "@elizaos/core";
+import type { PluginManifest } from "./types";
+/**
+ * Options for loading a WASM plugin
+ */
+export interface WasmLoaderOptions {
+    /** Path or URL to the WASM file */
+    wasmPath: string;
+    /** Optional path to plugin.json manifest (auto-detected if not provided) */
+    manifestPath?: string;
+    /** Import object for WASM instantiation */
+    imports?: WebAssembly.Imports;
+    /** Maximum allowed WASM binary size in bytes. */
+    maxWasmBytes?: number;
+    /** Maximum allowed initial memory size in bytes (post-instantiation). */
+    maxMemoryBytes?: number;
+}
+/**
+ * Load a WASM plugin and return an elizaOS Plugin interface
+ */
+export declare function loadWasmPlugin(options: WasmLoaderOptions): Promise<Plugin>;
+/**
+ * Preload and validate a WASM plugin without fully loading it
+ */
+export declare function validateWasmPlugin(wasmPath: string): Promise<{
+    valid: boolean;
+    manifest?: PluginManifest;
+    error?: string;
+}>;
+//# sourceMappingURL=wasm-loader.d.ts.map

package/dist/wasm-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-loader.d.ts","sourceRoot":"","sources":["../typescript/wasm-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EASV,MAAM,EAKP,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAEV,cAAc,EAIf,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAC9B,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAmZD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAkBD"}

package/dist/wasm-loader.js

@@ -0,0 +1,314 @@
+/**
+ * WASM Plugin Loader for elizaOS
+ *
+ * Loads Rust (or other) plugins compiled to WebAssembly and adapts them
+ * to the TypeScript Plugin interface.
+ */
+import { logger } from "@elizaos/core";
+/**
+ * Text encoder/decoder for string passing
+ */
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+/**
+ * Load a WASM plugin and return an elizaOS Plugin interface
+ */
+export async function loadWasmPlugin(options) {
+    const { wasmPath, manifestPath } = options;
+    // Load the WASM module
+    const wasmInstance = await loadWasmModule(wasmPath, options);
+    // Get the manifest from the WASM module or external file
+    let manifest;
+    if (manifestPath) {
+        manifest = await loadManifest(manifestPath);
+    }
+    else {
+        // Try to get manifest from WASM exports
+        const manifestJson = wasmInstance.exports.get_manifest();
+        manifest = JSON.parse(manifestJson);
+    }
+    // Create the plugin adapter
+    return createPluginFromWasm(manifest, wasmInstance);
+}
+/**
+ * Load a WASM module and instantiate it
+ */
+async function loadWasmModule(wasmPath, options) {
+    // Default imports for WASM
+    const defaultImports = {
+        env: {
+            // Console logging
+            console_log: (_ptr, _len) => {
+                // Will be resolved once we have memory
+            },
+            console_error: (_ptr, _len) => {
+                // Will be resolved once we have memory
+            },
+            // Abort handler
+            abort: (_msg, file, line, column) => {
+                throw new Error(`WASM abort at ${file}:${line}:${column}`);
+            },
+        },
+        wasi_snapshot_preview1: {
+            // Minimal WASI stubs for compatibility
+            proc_exit: (code) => {
+                throw new Error(`WASM exit with code ${code}`);
+            },
+            fd_write: () => 0,
+            fd_read: () => 0,
+            fd_close: () => 0,
+            fd_seek: () => 0,
+            environ_get: () => 0,
+            environ_sizes_get: () => 0,
+            clock_time_get: () => 0,
+            random_get: (_buf, _len) => {
+                // Fill with random bytes
+                return 0;
+            },
+        },
+    };
+    const imports = { ...defaultImports, ...options.imports };
+    // Determine if we're in Node.js or browser
+    const isNode = typeof globalThis.process !== "undefined" &&
+        globalThis.process.versions &&
+        globalThis.process.versions.node;
+    let wasmModule;
+    if (isNode) {
+        // Node.js: read file
+        const fs = await import("node:fs/promises");
+        if (typeof options.maxWasmBytes === "number") {
+            const st = await fs.stat(wasmPath);
+            if (st.size > options.maxWasmBytes) {
+                throw new Error(`WASM binary too large (${st.size} bytes > ${options.maxWasmBytes} bytes)`);
+            }
+        }
+        const wasmBuffer = await fs.readFile(wasmPath);
+        if (typeof options.maxWasmBytes === "number" &&
+            wasmBuffer.byteLength > options.maxWasmBytes) {
+            throw new Error(`WASM binary too large (${wasmBuffer.byteLength} bytes > ${options.maxWasmBytes} bytes)`);
+        }
+        wasmModule = await WebAssembly.compile(wasmBuffer);
+    }
+    else {
+        // Browser: fetch
+        const response = await fetch(wasmPath);
+        const wasmBuffer = await response.arrayBuffer();
+        if (typeof options.maxWasmBytes === "number" &&
+            wasmBuffer.byteLength > options.maxWasmBytes) {
+            throw new Error(`WASM binary too large (${wasmBuffer.byteLength} bytes > ${options.maxWasmBytes} bytes)`);
+        }
+        wasmModule = await WebAssembly.compile(wasmBuffer);
+    }
+    const instance = await WebAssembly.instantiate(wasmModule, imports);
+    // Set up console logging now that we have memory
+    const memory = instance.exports.memory;
+    if (typeof options.maxMemoryBytes === "number" &&
+        memory.buffer.byteLength > options.maxMemoryBytes) {
+        throw new Error(`WASM memory too large (${memory.buffer.byteLength} bytes > ${options.maxMemoryBytes} bytes)`);
+    }
+    if (imports.env) {
+        const env = imports.env;
+        env.console_log = (ptr, len) => {
+            const bytes = new Uint8Array(memory.buffer, ptr, len);
+            logger.info({ src: "interop:wasm", event: "interop.wasm.stdout", stream: "stdout" }, decoder.decode(bytes));
+        };
+        env.console_error = (ptr, len) => {
+            const bytes = new Uint8Array(memory.buffer, ptr, len);
+            logger.error({ src: "interop:wasm", event: "interop.wasm.stderr", stream: "stderr" }, decoder.decode(bytes));
+        };
+    }
+    // Provide secure randomness for WASI random_get if present
+    if (imports.wasi_snapshot_preview1) {
+        const wasi = imports.wasi_snapshot_preview1;
+        wasi.random_get = (buf, len) => {
+            const view = new Uint8Array(memory.buffer, buf, len);
+            const cryptoObj = globalThis.crypto;
+            if (!cryptoObj || typeof cryptoObj.getRandomValues !== "function") {
+                throw new Error("No secure random source available for WASI random_get");
+            }
+            cryptoObj.getRandomValues(view);
+            return 0;
+        };
+    }
+    // Type guard to validate exports match WasmPluginExports interface
+    const exports = instance.exports;
+    const typedExports = {
+        get_manifest: exports.get_manifest,
+        init: exports.init,
+        validate_action: exports.validate_action,
+        invoke_action: exports.invoke_action,
+        get_provider: exports.get_provider,
+        validate_evaluator: exports.validate_evaluator,
+        invoke_evaluator: exports.invoke_evaluator,
+        handle_route: exports.handle_route,
+        alloc: exports.alloc,
+        dealloc: exports.dealloc,
+    };
+    return {
+        exports: typedExports,
+        memory: { buffer: memory.buffer },
+    };
+}
+/**
+ * Load manifest from external JSON file
+ */
+async function loadManifest(manifestPath) {
+    const isNode = typeof globalThis.process !== "undefined" &&
+        globalThis.process.versions &&
+        globalThis.process.versions.node;
+    if (isNode) {
+        const fs = await import("node:fs/promises");
+        const content = await fs.readFile(manifestPath, "utf-8");
+        return JSON.parse(content);
+    }
+    else {
+        const response = await fetch(manifestPath);
+        return response.json();
+    }
+}
+/**
+ * Helper to pass a string to WASM and get result
+ */
+function _callWasmWithString(instance, fn, ...strings) {
+    const { exports, memory } = instance;
+    const ptrs = [];
+    const lens = [];
+    // Allocate and write strings
+    for (const str of strings) {
+        const bytes = encoder.encode(str);
+        const ptr = exports.alloc(bytes.length);
+        const view = new Uint8Array(memory.buffer, ptr, bytes.length);
+        view.set(bytes);
+        ptrs.push(ptr);
+        lens.push(bytes.length);
+    }
+    // Call the function
+    const args = [];
+    for (let i = 0; i < strings.length; i++) {
+        args.push(ptrs[i], lens[i]);
+    }
+    const resultPtr = fn(...args);
+    // Read result (assuming null-terminated or length-prefixed)
+    // For now, assume it returns a pointer to a null-terminated string
+    let resultLen = 0;
+    const view = new Uint8Array(memory.buffer);
+    while (view[resultPtr + resultLen] !== 0 &&
+        resultPtr + resultLen < view.length) {
+        resultLen++;
+    }
+    const result = decoder.decode(new Uint8Array(memory.buffer, resultPtr, resultLen));
+    // Deallocate input strings
+    for (let i = 0; i < strings.length; i++) {
+        exports.dealloc(ptrs[i], lens[i]);
+    }
+    return result;
+}
+/**
+ * Create a Plugin from a WASM instance
+ */
+function createPluginFromWasm(manifest, instance) {
+    const { exports } = instance;
+    // Create action wrappers
+    const actions = (manifest.actions ?? []).map((actionDef) => ({
+        name: actionDef.name,
+        description: actionDef.description,
+        similes: actionDef.similes,
+        examples: actionDef.examples,
+        validate: async (_runtime, message, state) => {
+            const result = exports.validate_action(actionDef.name, JSON.stringify(message), JSON.stringify(state ?? null));
+            return typeof result === "boolean" ? result : result !== 0;
+        },
+        handler: async (_runtime, message, state, options, _callback) => {
+            const resultJson = exports.invoke_action(actionDef.name, JSON.stringify(message), JSON.stringify(state ?? null), JSON.stringify(options ?? {}));
+            const result = JSON.parse(resultJson);
+            return {
+                success: result.success,
+                text: result.text,
+                error: result.error ? new Error(result.error) : undefined,
+                data: result.data,
+                values: result.values,
+            };
+        },
+    }));
+    // Create provider wrappers
+    const providers = (manifest.providers ?? []).map((providerDef) => ({
+        name: providerDef.name,
+        description: providerDef.description,
+        dynamic: providerDef.dynamic,
+        position: providerDef.position,
+        private: providerDef.private,
+        get: async (_runtime, message, state) => {
+            const resultJson = exports.get_provider(providerDef.name, JSON.stringify(message), JSON.stringify(state));
+            const result = JSON.parse(resultJson);
+            return {
+                text: result.text,
+                values: result.values,
+                data: result.data,
+            };
+        },
+    }));
+    // Create evaluator wrappers
+    const evaluators = (manifest.evaluators ?? []).map((evalDef) => ({
+        name: evalDef.name,
+        description: evalDef.description,
+        alwaysRun: evalDef.alwaysRun,
+        similes: evalDef.similes,
+        examples: [],
+        validate: async (_runtime, message, state) => {
+            const result = exports.validate_evaluator(evalDef.name, JSON.stringify(message), JSON.stringify(state ?? null));
+            return typeof result === "boolean" ? result : result !== 0;
+        },
+        handler: async (_runtime, message, state) => {
+            const resultJson = exports.invoke_evaluator(evalDef.name, JSON.stringify(message), JSON.stringify(state ?? null));
+            if (!resultJson || resultJson === "null") {
+                return undefined;
+            }
+            const result = JSON.parse(resultJson);
+            return {
+                success: result.success,
+                text: result.text,
+                error: result.error ? new Error(result.error) : undefined,
+                data: result.data,
+                values: result.values,
+            };
+        },
+    }));
+    // Return the plugin
+    return {
+        name: manifest.name,
+        description: manifest.description,
+        config: manifest.config ?? {},
+        dependencies: manifest.dependencies,
+        actions,
+        providers,
+        evaluators,
+        // Routes would need special handling for WASM
+        routes: [],
+        // Services need special handling
+        services: [],
+        async init(config) {
+            exports.init(JSON.stringify(config));
+        },
+    };
+}
+/**
+ * Preload and validate a WASM plugin without fully loading it
+ */
+export async function validateWasmPlugin(wasmPath) {
+    try {
+        const instance = await loadWasmModule(wasmPath, {});
+        const manifestJson = instance.exports.get_manifest();
+        const manifest = JSON.parse(manifestJson);
+        // Basic validation
+        if (!manifest.name || !manifest.description) {
+            return { valid: false, error: "Missing required manifest fields" };
+        }
+        return { valid: true, manifest };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}