@nodetool-ai/runtime 0.7.0-rc.11

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

@@ -0,0 +1,70 @@
+export interface NodeMetadataProperty {
+    name: string;
+    type: {
+        type: string;
+        type_args?: Array<{
+            type: string;
+        }>;
+    };
+    default?: unknown;
+    description?: string;
+}
+export interface NodeMetadataOutput {
+    name: string;
+    type: {
+        type: string;
+        type_args?: Array<{
+            type: string;
+        }>;
+    };
+}
+export interface PythonNodeMetadata {
+    node_type: string;
+    title: string;
+    description: string;
+    properties: NodeMetadataProperty[];
+    outputs: NodeMetadataOutput[];
+    required_settings: string[];
+    is_streaming_output?: boolean;
+    is_streaming_input?: boolean;
+    is_dynamic?: boolean;
+}
+export interface ExecuteResult {
+    outputs: Record<string, unknown>;
+    blobs: Record<string, Uint8Array>;
+}
+export type ExecuteInputBlobs = Record<string, Uint8Array | Uint8Array[]>;
+export interface ProgressEvent {
+    request_id: string;
+    progress: number;
+    total: number;
+}
+export interface PythonBridgeOptions {
+    wsUrl?: string;
+    pythonPath?: string;
+    workerArgs?: string[];
+    autoRestart?: boolean;
+    startupTimeoutMs?: number;
+}
+export type StreamCallback = (chunk: Record<string, unknown>) => void;
+export interface PythonProviderInfo {
+    id: string;
+    capabilities: string[];
+    required_secrets: string[];
+}
+export interface PythonWorkerLoadError {
+    module: string;
+    phase: string;
+    error: string;
+    error_type?: string;
+}
+export interface PythonWorkerStatus {
+    protocol_version: number;
+    node_count: number;
+    provider_count: number;
+    namespaces: string[];
+    load_errors: PythonWorkerLoadError[];
+    transport: string;
+    max_frame_size: number;
+}
+//# sourceMappingURL=python-bridge-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"python-bridge-types.d.ts","sourceRoot":"","sources":["../src/python-bridge-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAC7D;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,qBAAqB,EAAE,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/python-bridge-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=python-bridge-types.js.map

package/dist/python-bridge-types.js.map

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

package/dist/python-node-executor.d.ts

@@ -0,0 +1,20 @@
+import type { ProcessingContext } from "./context.js";
+import type { ExecuteInputBlobs, ExecuteResult, ProgressEvent } from "./python-bridge-types.js";
+/** Minimal interface for the local Python stdio bridge. */
+interface PythonBridgeLike {
+    execute(nodeType: string, fields: Record<string, unknown>, secrets: Record<string, string>, blobs: ExecuteInputBlobs, onProgress?: (event: ProgressEvent) => void): Promise<ExecuteResult>;
+    executeStream?(nodeType: string, fields: Record<string, unknown>, secrets: Record<string, string>, blobs: ExecuteInputBlobs, onProgress?: (event: ProgressEvent) => void): AsyncGenerator<ExecuteResult>;
+}
+export declare class PythonNodeExecutor {
+    private bridge;
+    private nodeType;
+    private outputTypes;
+    private requiredSettings;
+    constructor(bridge: PythonBridgeLike, nodeType: string, _properties: Record<string, unknown>, outputTypes: Record<string, string>, requiredSettings: string[]);
+    private prepareExecution;
+    private materializeOutputs;
+    process(inputs: Record<string, unknown>, context?: ProcessingContext): Promise<Record<string, unknown>>;
+    genProcess(inputs: Record<string, unknown>, context?: ProcessingContext): AsyncGenerator<Record<string, unknown>>;
+}
+export {};
+//# sourceMappingURL=python-node-executor.d.ts.map

package/dist/python-node-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-node-executor.d.ts","sourceRoot":"","sources":["../src/python-node-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,aAAa,EACd,MAAM,0BAA0B,CAAC;AAKlC,2DAA2D;AAC3D,UAAU,gBAAgB;IACxB,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,KAAK,EAAE,iBAAiB,EACxB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAC1C,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,aAAa,CAAC,CACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,KAAK,EAAE,iBAAiB,EACxB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAC1C,cAAc,CAAC,aAAa,CAAC,CAAC;CAClC;AAgJD,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IAEhB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,gBAAgB;gBAJhB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,gBAAgB,EAAE,MAAM,EAAE;YAGtB,gBAAgB;YAyEhB,kBAAkB;IAwB1B,OAAO,CACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAY5B,UAAU,CACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAiB3C"}

package/dist/python-node-executor.js

@@ -0,0 +1,219 @@
+import { createLogger } from "@nodetool-ai/config";
+const log = createLogger("nodetool.runtime.python-node-executor");
+import { readFile } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { fileURLToPath } from "node:url";
+/** Media ref types that need blob conversion. */
+const MEDIA_TYPE_ALIASES = {
+    ImageRef: "image",
+    AudioRef: "audio",
+    VideoRef: "video",
+    Model3DRef: "model_3d",
+    image: "image",
+    audio: "audio",
+    video: "video",
+    model_3d: "model_3d"
+};
+/** File extensions by ref type. */
+const EXTENSION_MAP = {
+    image: ".png",
+    audio: ".wav",
+    video: ".mp4",
+    model_3d: ".glb"
+};
+/** MIME types by ref type. */
+const MIME_MAP = {
+    image: "image/png",
+    audio: "audio/wav",
+    video: "video/mp4",
+    model_3d: "model/gltf-binary"
+};
+function normalizeMediaOutputType(outputType) {
+    if (!outputType) {
+        return null;
+    }
+    return MEDIA_TYPE_ALIASES[outputType] ?? null;
+}
+function isMediaRef(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "uri" in value &&
+        typeof value.uri === "string");
+}
+function isMediaRefList(value) {
+    return Array.isArray(value) && value.every(isMediaRef);
+}
+const ASSET_ID_EXTENSION_CANDIDATES = {
+    image: ["png", "jpg", "jpeg", "webp", "gif", "bmp", "svg"],
+    audio: ["wav", "mp3", "ogg", "m4a", "aac", "flac"],
+    video: ["mp4", "webm", "mov", "avi", "mpeg", "mkv"],
+    model3d: ["glb", "gltf", "obj", "fbx"]
+};
+function isAbsoluteFilePath(uri) {
+    return (/^[A-Za-z]:[\\/]/.test(uri) || uri.startsWith("\\\\") || uri.startsWith("/"));
+}
+async function readUriBytes(uri) {
+    if (uri.startsWith("data:")) {
+        const parts = uri.split(",", 2);
+        if (parts.length !== 2) {
+            return null;
+        }
+        const [header, data] = parts;
+        const bytes = header.includes(";base64")
+            ? Buffer.from(data, "base64")
+            : Buffer.from(decodeURIComponent(data), "utf-8");
+        return new Uint8Array(bytes);
+    }
+    if (uri.startsWith("file://")) {
+        try {
+            return await readFile(fileURLToPath(uri));
+        }
+        catch {
+            return null;
+        }
+    }
+    if (isAbsoluteFilePath(uri)) {
+        try {
+            return await readFile(uri);
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+async function loadMediaRefBytes(value, context) {
+    // Inline base64 data takes priority over uri
+    const data = value.data;
+    if (typeof data === "string" && data.length > 0) {
+        return new Uint8Array(Buffer.from(data, "base64"));
+    }
+    if (data instanceof Uint8Array) {
+        return data;
+    }
+    if (!value.uri) {
+        return null;
+    }
+    if (context?.storage) {
+        const candidates = new Set();
+        candidates.add(value.uri);
+        if (value.asset_id) {
+            const refType = (value.type ?? "").toLowerCase();
+            const extensions = ASSET_ID_EXTENSION_CANDIDATES[refType] ?? ["bin"];
+            for (const extension of extensions) {
+                candidates.add(`/api/storage/${value.asset_id}.${extension}`);
+            }
+        }
+        for (const candidate of candidates) {
+            const stored = await context.storage.retrieve(candidate);
+            if (stored !== null) {
+                return stored;
+            }
+        }
+    }
+    return readUriBytes(value.uri);
+}
+export class PythonNodeExecutor {
+    bridge;
+    nodeType;
+    outputTypes;
+    requiredSettings;
+    constructor(bridge, nodeType, _properties, outputTypes, requiredSettings) {
+        this.bridge = bridge;
+        this.nodeType = nodeType;
+        this.outputTypes = outputTypes;
+        this.requiredSettings = requiredSettings;
+    }
+    async prepareExecution(inputs, context) {
+        // NodeActor merges node.properties + edge inputs before calling process(),
+        // so `inputs` already contains all fields. Filter out internal keys.
+        const fields = {};
+        for (const [key, value] of Object.entries(inputs)) {
+            if (key !== "_secrets" && !key.startsWith("__")) {
+                fields[key] = value;
+            }
+        }
+        const blobs = {};
+        for (const [key, value] of Object.entries(fields)) {
+            if (isMediaRef(value)) {
+                const ref = value;
+                log.info("Processing media ref input", {
+                    nodeType: this.nodeType,
+                    key,
+                    type: ref.type,
+                    hasUri: Boolean(ref.uri),
+                    uriLength: typeof ref.uri === "string" ? ref.uri.length : 0,
+                    hasData: ref.data !== null && ref.data !== undefined,
+                    dataType: typeof ref.data,
+                    dataLength: typeof ref.data === "string"
+                        ? ref.data.length
+                        : ref.data instanceof Uint8Array
+                            ? ref.data.length
+                            : 0,
+                    hasAssetId: Boolean(ref.asset_id)
+                });
+                const data = await loadMediaRefBytes(value, context);
+                log.info("Media ref blob result", {
+                    nodeType: this.nodeType,
+                    key,
+                    loaded: data !== null,
+                    blobSize: data?.length ?? 0
+                });
+                if (data !== null) {
+                    blobs[key] = data;
+                    delete fields[key];
+                }
+                continue;
+            }
+            if (isMediaRefList(value) && value.length > 0) {
+                const items = await Promise.all(value.map((item) => loadMediaRefBytes(item, context)));
+                if (items.every((item) => item !== null)) {
+                    blobs[key] = items;
+                    delete fields[key];
+                }
+            }
+        }
+        const secrets = {};
+        if (context) {
+            for (const key of this.requiredSettings) {
+                const value = await context.getSecret(key);
+                if (value)
+                    secrets[key] = value;
+            }
+        }
+        return { fields, blobs, secrets };
+    }
+    async materializeOutputs(result, context) {
+        const outputs = { ...result.outputs };
+        for (const [name, blobData] of Object.entries(result.blobs)) {
+            const mediaType = normalizeMediaOutputType(this.outputTypes[name]);
+            if (mediaType && context?.storage) {
+                const ext = EXTENSION_MAP[mediaType] ?? "";
+                const contentType = MIME_MAP[mediaType];
+                const storageKey = `python-bridge/${randomUUID()}${ext}`;
+                const uri = await context.storage.store(storageKey, blobData, contentType);
+                outputs[name] = { uri, type: mediaType };
+            }
+            else {
+                outputs[name] = blobData;
+            }
+        }
+        return outputs;
+    }
+    async process(inputs, context) {
+        const { fields, blobs, secrets } = await this.prepareExecution(inputs, context);
+        const result = await this.bridge.execute(this.nodeType, fields, secrets, blobs, undefined);
+        return this.materializeOutputs(result, context);
+    }
+    async *genProcess(inputs, context) {
+        if (!this.bridge.executeStream) {
+            yield await this.process(inputs, context);
+            return;
+        }
+        const { fields, blobs, secrets } = await this.prepareExecution(inputs, context);
+        for await (const partial of this.bridge.executeStream(this.nodeType, fields, secrets, blobs, undefined)) {
+            yield await this.materializeOutputs(partial, context);
+        }
+    }
+}
+//# sourceMappingURL=python-node-executor.js.map

package/dist/python-node-executor.js.map

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

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

@@ -0,0 +1,67 @@
+/**
+ * Python worker bridge using stdio transport.
+ *
+ * Communicates over stdin/stdout
+ * with length-prefixed msgpack framing instead of WebSocket.
+ * This eliminates WebSocket connection instability.
+ *
+ * Protocol: [4 bytes big-endian length][msgpack payload]
+ * Readiness: "NODETOOL_STDIO_READY" on stderr
+ * Logs: all Python output goes to stderr
+ */
+import { EventEmitter } from "node:events";
+import type { PythonNodeMetadata, ExecuteResult, ExecuteInputBlobs, ProgressEvent, StreamCallback, PythonProviderInfo, PythonBridgeOptions, PythonWorkerLoadError, PythonWorkerStatus } from "./python-bridge-types.js";
+export type { PythonNodeMetadata, ExecuteResult, ExecuteInputBlobs, ProgressEvent, StreamCallback, PythonProviderInfo, PythonBridgeOptions, PythonWorkerLoadError, PythonWorkerStatus };
+export declare class PythonStdioBridge extends EventEmitter {
+    private _process;
+    private _nodeMetadata;
+    private _loadErrors;
+    private _workerStatus;
+    private _pending;
+    private _pendingStream;
+    private _options;
+    private _connected;
+    private _connectPromise;
+    /** Buffered stdout data waiting to be parsed into frames. */
+    private _readBuffer;
+    /** Recent stderr lines from the worker for diagnostics. */
+    private _recentStderr;
+    constructor(options?: PythonBridgeOptions);
+    connect(): Promise<void>;
+    ensureConnected(): Promise<void>;
+    private _spawnAndConnect;
+    private _spawnCandidate;
+    /** Extract complete length-prefixed frames from _readBuffer. */
+    private _drainFrames;
+    private _send;
+    private _handleMessage;
+    private _discover;
+    execute(nodeType: string, fields: Record<string, unknown>, secrets: Record<string, string>, blobs: ExecuteInputBlobs, onProgress?: (event: ProgressEvent) => void): Promise<ExecuteResult>;
+    executeStream(nodeType: string, fields: Record<string, unknown>, secrets: Record<string, string>, blobs: ExecuteInputBlobs, onProgress?: (event: ProgressEvent) => void): AsyncGenerator<ExecuteResult>;
+    cancel(requestId: string): void;
+    getNodeMetadata(): PythonNodeMetadata[];
+    getLoadErrors(): PythonWorkerLoadError[];
+    getWorkerStatus(): Promise<PythonWorkerStatus>;
+    hasNodeType(nodeType: string): boolean;
+    get isConnected(): boolean;
+    listProviders(): Promise<PythonProviderInfo[]>;
+    getProviderModels(providerId: string, modelType: string, secrets?: Record<string, string>): Promise<Record<string, unknown>[]>;
+    providerGenerate(providerId: string, messages: Record<string, unknown>[], model: string, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    providerStream(providerId: string, messages: Record<string, unknown>[], model: string, options?: Record<string, unknown>): AsyncGenerator<Record<string, unknown>>;
+    providerTextToImage(providerId: string, params: Record<string, unknown>, secrets?: Record<string, string>): Promise<Uint8Array>;
+    providerImageToImage(providerId: string, image: Uint8Array, params: Record<string, unknown>, secrets?: Record<string, string>): Promise<Uint8Array>;
+    providerTTS(providerId: string, text: string, model: string, options?: Record<string, unknown>): AsyncGenerator<Uint8Array>;
+    providerASR(providerId: string, audio: Uint8Array, model: string, options?: Record<string, unknown>): Promise<import("./providers/types.js").ASRResult>;
+    providerEmbedding(providerId: string, text: string | string[], model: string, dimensions?: number): Promise<number[][]>;
+    private _providerCall;
+    close(): void;
+    /** Check if a Python interpreter can be found (without spawning). */
+    hasPython(): boolean;
+    getRecentStderrLines(limit?: number): string[];
+    getRecentStderrSummary(limit?: number): string | null;
+    private _rememberStderr;
+    private _getPythonLaunchCandidates;
+    private _looksLikeNodeToolEnv;
+    private _getManagedPythonPaths;
+}
+//# sourceMappingURL=python-stdio-bridge.d.ts.map

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

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