@elizaos/interop 2.0.0-alpha

package/dist/typescript/python-bridge.js

@@ -0,0 +1,334 @@
+/**
+ * Python Plugin Bridge for elizaOS
+ *
+ * Loads Python plugins via subprocess IPC and adapts them
+ * to the TypeScript Plugin interface.
+ */
+import { EventEmitter } from "node:events";
+/**
+ * Python plugin bridge that communicates via subprocess
+ */
+export class PythonPluginBridge extends EventEmitter {
+    options;
+    process = null;
+    pendingRequests = new Map();
+    messageBuffer = "";
+    manifest = null;
+    initialized = false;
+    requestCounter = 0;
+    constructor(options) {
+        super();
+        this.options = options;
+    }
+    /**
+     * Start the Python subprocess
+     */
+    async start() {
+        const { spawn } = await import("node:child_process");
+        const pythonPath = this.options.pythonPath ?? "python3";
+        const bridgeScript = this.options.bridgeScriptPath ??
+            new URL("../python/bridge_server.py", import.meta.url).pathname;
+        this.process = spawn(pythonPath, ["-u", bridgeScript, "--module", this.options.moduleName], {
+            cwd: this.options.cwd,
+            env: { ...process.env, ...this.options.env },
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        // Handle stdout (JSON-RPC messages)
+        if (this.process.stdout) {
+            this.process.stdout.on("data", (data) => {
+                this.handleData(data.toString());
+            });
+        }
+        // Handle stderr (logging)
+        if (this.process.stderr) {
+            this.process.stderr.on("data", (data) => {
+                console.error(`[Python Plugin ${this.options.moduleName}]`, data.toString());
+            });
+        }
+        // Handle process exit
+        this.process.on("exit", (code, signal) => {
+            this.emit("exit", { code, signal });
+            this.cleanup();
+        });
+        this.process.on("error", (error) => {
+            this.emit("error", error);
+        });
+        // Wait for the ready message with manifest
+        await this.waitForReady();
+        this.initialized = true;
+    }
+    /**
+     * Wait for the Python process to send ready message
+     */
+    async waitForReady() {
+        const timeout = this.options.timeout ?? 30000;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Python plugin startup timeout after ${timeout}ms`));
+            }, timeout);
+            const handler = (msg) => {
+                if (msg.type === "ready" && "manifest" in msg) {
+                    clearTimeout(timer);
+                    this.manifest = msg.manifest;
+                    resolve();
+                }
+            };
+            this.once("message", handler);
+        });
+    }
+    /**
+     * Handle incoming data from subprocess
+     */
+    handleData(data) {
+        this.messageBuffer += data;
+        // Process complete JSON messages (newline-delimited)
+        const lines = this.messageBuffer.split("\n");
+        this.messageBuffer = lines.pop() ?? "";
+        for (const line of lines) {
+            if (line.trim()) {
+                try {
+                    const message = JSON.parse(line);
+                    this.handleMessage(message);
+                }
+                catch (error) {
+                    console.error("Failed to parse IPC message:", line, error);
+                }
+            }
+        }
+    }
+    /**
+     * Handle a parsed IPC message
+     */
+    handleMessage(message) {
+        this.emit("message", message);
+        // Check if this is a response to a pending request
+        if (message.id && this.pendingRequests.has(message.id)) {
+            const pending = this.pendingRequests.get(message.id);
+            if (!pending)
+                return;
+            this.pendingRequests.delete(message.id);
+            clearTimeout(pending.timeout);
+            if (message.type === "error") {
+                pending.reject(new Error(message.error));
+            }
+            else {
+                pending.resolve(message);
+            }
+        }
+    }
+    /**
+     * Send a request and wait for response
+     */
+    async sendRequest(request) {
+        if (!this.process || !this.initialized) {
+            throw new Error("Python bridge not started");
+        }
+        const id = `req_${++this.requestCounter}`;
+        const requestWithId = { ...request, id };
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                reject(new Error(`Request timeout for ${request.type}`));
+            }, this.options.timeout ?? 30000);
+            this.pendingRequests.set(id, {
+                resolve: resolve,
+                reject,
+                timeout,
+            });
+            const json = `${JSON.stringify(requestWithId)}\n`;
+            if (this.process?.stdin) {
+                this.process.stdin.write(json);
+            }
+        });
+    }
+    /**
+     * Get the plugin manifest
+     */
+    getManifest() {
+        return this.manifest;
+    }
+    /**
+     * Stop the Python subprocess
+     */
+    async stop() {
+        if (this.process) {
+            this.process.kill("SIGTERM");
+            // Wait for graceful shutdown
+            await new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    if (this.process) {
+                        this.process.kill("SIGKILL");
+                    }
+                    resolve();
+                }, 5000);
+                if (this.process) {
+                    this.process.on("exit", () => {
+                        clearTimeout(timeout);
+                        resolve();
+                    });
+                }
+                else {
+                    resolve();
+                }
+            });
+        }
+        this.cleanup();
+    }
+    /**
+     * Cleanup resources
+     */
+    cleanup() {
+        this.process = null;
+        this.initialized = false;
+        // Reject all pending requests
+        for (const pending of this.pendingRequests.values()) {
+            clearTimeout(pending.timeout);
+            pending.reject(new Error("Bridge closed"));
+        }
+        this.pendingRequests.clear();
+    }
+}
+/**
+ * Load a Python plugin and return an elizaOS Plugin interface
+ */
+export async function loadPythonPlugin(options) {
+    const bridge = new PythonPluginBridge(options);
+    await bridge.start();
+    const manifest = bridge.getManifest();
+    if (!manifest) {
+        throw new Error("Failed to get plugin manifest");
+    }
+    return createPluginFromBridge(manifest, bridge);
+}
+/**
+ * Create a Plugin from a Python bridge
+ */
+function createPluginFromBridge(manifest, bridge) {
+    // 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 response = await bridge.sendRequest({
+                type: "action.validate",
+                id: "",
+                action: actionDef.name,
+                memory: message,
+                state: state ?? null,
+            });
+            return response.valid;
+        },
+        handler: async (_runtime, message, state, options, _callback) => {
+            const response = await bridge.sendRequest({
+                type: "action.invoke",
+                id: "",
+                action: actionDef.name,
+                memory: message,
+                state: state ?? null,
+                options: options ?? null,
+            });
+            const result = response.result;
+            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 response = await bridge.sendRequest({
+                type: "provider.get",
+                id: "",
+                provider: providerDef.name,
+                memory: message,
+                state: state,
+            });
+            return {
+                text: response.result.text,
+                values: response.result.values,
+                data: response.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 response = await bridge.sendRequest({
+                type: "action.validate",
+                id: "",
+                action: evalDef.name,
+                memory: message,
+                state: state ?? null,
+            });
+            return response.valid;
+        },
+        handler: async (_runtime, message, state) => {
+            const response = await bridge.sendRequest({
+                type: "evaluator.invoke",
+                id: "",
+                evaluator: evalDef.name,
+                memory: message,
+                state: state ?? null,
+            });
+            if (!response.result) {
+                return undefined;
+            }
+            return {
+                success: response.result.success,
+                text: response.result.text,
+                error: response.result.error
+                    ? new Error(response.result.error)
+                    : undefined,
+                data: response.result.data,
+                values: response.result.values,
+            };
+        },
+    }));
+    // Store bridge reference for cleanup
+    const bridgeRef = { current: bridge };
+    return {
+        name: manifest.name,
+        description: manifest.description,
+        config: manifest.config ?? {},
+        dependencies: manifest.dependencies,
+        actions,
+        providers,
+        evaluators,
+        routes: [],
+        services: [],
+        async init(config) {
+            await bridge.sendRequest({
+                type: "plugin.init",
+                id: "",
+                config,
+            });
+        },
+        // Extension for cleanup
+        _bridge: bridgeRef,
+    };
+}
+/**
+ * Stop a Python plugin bridge
+ */
+export async function stopPythonPlugin(plugin) {
+    const extended = plugin;
+    if (extended._bridge?.current) {
+        await extended._bridge.current.stop();
+    }
+}

package/dist/typescript/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/typescript/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/typescript/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/typescript/wasm-loader.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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;
+}
+/**
+ * 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/typescript/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;AAEvB,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;CAC/B;AAQD;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAsTD;;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"}