@elizaos/interop 2.0.0-alpha → 2.0.0-alpha.10

package/dist/typescript/python-bridge.d.ts

@@ -1,80 +0,0 @@
-/**
- * Python Plugin Bridge for elizaOS
- *
- * Loads Python plugins via subprocess IPC and adapts them
- * to the TypeScript Plugin interface.
- */
-import { EventEmitter } from "node:events";
-import type { Plugin } from "@elizaos/core";
-import type { IPCRequest, IPCResponse, PluginManifest } from "./types";
-/**
- * Options for loading a Python plugin
- */
-export interface PythonBridgeOptions {
-    /** Python module name to import */
-    moduleName: string;
-    /** Path to Python executable (defaults to 'python3') */
-    pythonPath?: string;
-    /** Working directory for the subprocess */
-    cwd?: string;
-    /** Additional environment variables */
-    env?: Record<string, string>;
-    /** Path to the bridge script */
-    bridgeScriptPath?: string;
-    /** Connection timeout in milliseconds */
-    timeout?: number;
-}
-/**
- * Python plugin bridge that communicates via subprocess
- */
-export declare class PythonPluginBridge extends EventEmitter {
-    private options;
-    private process;
-    private pendingRequests;
-    private messageBuffer;
-    private manifest;
-    private initialized;
-    private requestCounter;
-    constructor(options: PythonBridgeOptions);
-    /**
-     * Start the Python subprocess
-     */
-    start(): Promise<void>;
-    /**
-     * Wait for the Python process to send ready message
-     */
-    private waitForReady;
-    /**
-     * Handle incoming data from subprocess
-     */
-    private handleData;
-    /**
-     * Handle a parsed IPC message
-     */
-    private handleMessage;
-    /**
-     * Send a request and wait for response
-     */
-    sendRequest<T extends IPCResponse>(request: IPCRequest): Promise<T>;
-    /**
-     * Get the plugin manifest
-     */
-    getManifest(): PluginManifest | null;
-    /**
-     * Stop the Python subprocess
-     */
-    stop(): Promise<void>;
-    /**
-     * Cleanup resources
-     */
-    private cleanup;
-}
-/**
- * Load a Python plugin and return an elizaOS Plugin interface
- */
-export declare function loadPythonPlugin(options: PythonBridgeOptions): Promise<Plugin>;
-/**
- * Stop a Python plugin bridge
- */
-export declare function stopPythonPlugin(plugin: Plugin): Promise<void>;
-//# sourceMappingURL=python-bridge.d.ts.map

package/dist/typescript/python-bridge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"python-bridge.d.ts","sourceRoot":"","sources":["../../typescript/python-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EASV,MAAM,EAKP,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAGV,UAAU,EACV,WAAW,EACX,cAAc,EAGf,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAWD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAStC,OAAO,CAAC,OAAO;IAR3B,OAAO,CAAC,OAAO,CACR;IACP,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,cAAc,CAAa;gBAEf,OAAO,EAAE,mBAAmB;IAIhD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD5B;;OAEG;YACW,YAAY;IAsB1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAmBlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACG,WAAW,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC;IA2BzE;;OAEG;IACH,WAAW,IAAI,cAAc,GAAG,IAAI;IAIpC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B;;OAEG;IACH,OAAO,CAAC,OAAO;CAWhB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAUjB;AA8KD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE"}

package/dist/typescript/python-bridge.js

@@ -1,334 +0,0 @@
-/**
- * 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();
-    }
-}