@nodetool-ai/runtime 0.7.0-rc.23 → 0.8.1

package/dist/storage-workspace.js

@@ -0,0 +1,426 @@
+/**
+ * The one {@link Workspace} implementation, over any {@link StorageAdapter}.
+ *
+ * There is deliberately no second implementation for local folders: a local
+ * workspace is this class over a `FileStorageAdapter`, which is what keeps the
+ * two deployments on the same code path instead of on two that drift.
+ */
+import { getNodeBuiltinSync } from "@nodetool-ai/config";
+import { FileStorageAdapter } from "@nodetool-ai/storage";
+import { setWorkspaceFactory } from "./context.js";
+import { PrefixedStorageAdapter } from "./prefixed-storage-adapter.js";
+import { WorkspacePathError } from "./workspace.js";
+// Loaded lazily so this module still imports in browser / Edge runtimes, the
+// same way the storage adapters above it do. Only `materialize`, `absorb`,
+// `scratchDir` and the local branches of `mkdir`/`deleteAll` need them, and
+// each says so when they are missing.
+const nodeFsP = getNodeBuiltinSync("node:fs/promises");
+const nodePath = getNodeBuiltinSync("node:path");
+const nodeOs = getNodeBuiltinSync("node:os");
+function requireNode() {
+    if (!nodeFsP || !nodePath || !nodeOs) {
+        throw new Error("Local workspace file access requires a Node.js runtime; this workspace " +
+            "operation is not available here");
+    }
+    return { fs: nodeFsP, path: nodePath, os: nodeOs };
+}
+/** `path.resolve`, but only where Node is available. */
+function resolvePath(...parts) {
+    return requireNode().path.resolve(...parts);
+}
+/**
+ * Strip the prefixes a caller may write a workspace path with.
+ *
+ * `/workspace/notes.md`, `workspace/notes.md` and `notes.md` are the same
+ * file: agents and generated code write all three, and the sandbox has always
+ * treated `/workspace` as the root. An absolute path is read as
+ * workspace-relative rather than rejected, because that is what a model writes
+ * when it thinks it is on a normal filesystem.
+ */
+function stripWorkspacePrefix(path) {
+    let p = path.replaceAll("\\", "/").trim();
+    if (p.startsWith("/workspace/"))
+        return p.slice("/workspace/".length);
+    if (p === "/workspace" || p === "workspace")
+        return "";
+    if (p.startsWith("workspace/"))
+        return p.slice("workspace/".length);
+    // A Windows drive letter or a POSIX absolute path: keep the tail.
+    p = p.replace(/^[A-Za-z]:\//, "");
+    return p.startsWith("/") ? p.slice(1) : p;
+}
+/** Normalize to a key: no `.`/`..` segments, no leading or trailing slash. */
+function normalize(path) {
+    const segments = [];
+    for (const segment of stripWorkspacePrefix(path).split("/")) {
+        if (!segment || segment === ".")
+            continue;
+        if (segment === "..") {
+            if (segments.length === 0)
+                throw new WorkspacePathError(path);
+            segments.pop();
+            continue;
+        }
+        segments.push(segment);
+    }
+    return segments.join("/");
+}
+/**
+ * The real directory an adapter reads and writes, when it has one.
+ *
+ * Detected by shape rather than by `instanceof`: a host may pass any adapter
+ * that fronts a real directory, including one of its own. An `instanceof`
+ * check against `FileStorageAdapter` silently reports such a workspace as
+ * virtual, which would send every local run through the staging path.
+ */
+function localRootOf(storage) {
+    const candidate = storage.rootDir;
+    return typeof candidate === "string" && candidate !== "" ? candidate : null;
+}
+/**
+ * Whether a path's real (symlink-resolved) location stays inside the root.
+ *
+ * A local workspace's containment cannot be decided lexically: a symlink
+ * inside it can point anywhere on the host, and following one is how an agent
+ * reads `~/.ssh/id_rsa` through a file called `notes`. A virtual workspace
+ * needs none of this — an object store has no symlinks — which is why the
+ * check runs only when there is a real directory.
+ *
+ * A path that is not there is not an escape — a write target legitimately does
+ * not exist yet, and a read of a missing file must answer "missing" rather
+ * than "outside" — so the nearest existing ancestor is checked instead.
+ * `lstat`, not `access`: a DANGLING symlink pointing outside the root looks
+ * absent to `access`, and the create would then follow it out.
+ */
+async function realPathWithinRoot(root, candidate) {
+    const { fs, path } = requireNode();
+    const realRoot = await fs.realpath(root);
+    const within = (real) => {
+        const rel = path.relative(realRoot, real);
+        return rel === "" || (!rel.startsWith("..") && !path.isAbsolute(rel));
+    };
+    try {
+        return within(await fs.realpath(candidate));
+    }
+    catch {
+        // Not resolvable — either absent, or a link with no target.
+    }
+    try {
+        // Exists as a link whose target does not — never follow it.
+        await fs.lstat(candidate);
+        return false;
+    }
+    catch {
+        // Genuinely absent: the parent decides.
+    }
+    // Walk up to the nearest ancestor that exists — writing `out/deep/x.txt`
+    // into a workspace that has neither directory yet is ordinary, and only the
+    // first real ancestor can be resolved.
+    let parent = path.dirname(candidate);
+    while (true) {
+        try {
+            return within(await fs.realpath(parent));
+        }
+        catch {
+            // realpath failed — either this ancestor is genuinely absent, or it is
+            // itself a dangling symlink. lstat, not the loop's next iteration,
+            // tells them apart: a dangling symlink exists at this exact path and
+            // must never be walked past, or a symlink one level up pointing
+            // straight at the root would resolve "within" by accident.
+            try {
+                await fs.lstat(parent);
+                return false;
+            }
+            catch {
+                // Genuinely absent: keep climbing.
+            }
+            const next = path.dirname(parent);
+            if (next === parent)
+                return false;
+            parent = next;
+        }
+    }
+}
+const textDecoder = new TextDecoder();
+const textEncoder = new TextEncoder();
+export class StorageWorkspace {
+    storage;
+    localDir;
+    scratch = null;
+    constructor(storage, opts = {}) {
+        this.storage = storage;
+        this.localDir = opts.localDir ?? localRootOf(storage);
+    }
+    rootReady = null;
+    /** Create the workspace directory once, on first use. */
+    ensureRoot() {
+        if (!this.localDir)
+            return Promise.resolve();
+        const dir = this.localDir;
+        this.rootReady ??= requireNode()
+            .fs.mkdir(dir, { recursive: true })
+            .then(() => undefined);
+        return this.rootReady;
+    }
+    key(path) {
+        const key = normalize(path);
+        if (!key)
+            throw new WorkspacePathError(path);
+        return key;
+    }
+    /**
+     * Refuse a path whose real location leaves the workspace.
+     *
+     * Called on every operation that touches a local workspace. `key()` already
+     * refuses a `..` that climbs out lexically; this is the half a symlink
+     * defeats.
+     */
+    async assertContained(path) {
+        if (!this.localDir)
+            return;
+        // The root may not exist yet (a workspace folder created on first use).
+        // Without this the walk below climbs past it to an ancestor that does
+        // exist, finds that outside the root, and refuses every path in a
+        // perfectly good workspace.
+        await this.ensureRoot();
+        const target = resolvePath(this.localDir, this.key(path));
+        if (!(await realPathWithinRoot(this.localDir, target))) {
+            throw new WorkspacePathError(path);
+        }
+    }
+    uri(path) {
+        return this.storage.uriForKey(this.key(path));
+    }
+    async read(path) {
+        await this.assertContained(path);
+        const bytes = await this.storage.retrieve(this.uri(path));
+        // The file backend answers with a Buffer, the object stores with a plain
+        // Uint8Array. A caller comparing or structured-cloning the result must not
+        // be able to tell which backend it got, so narrow to the common type.
+        if (bytes === null)
+            return null;
+        return bytes instanceof Uint8Array && bytes.constructor === Uint8Array
+            ? bytes
+            : new Uint8Array(bytes);
+    }
+    async readText(path) {
+        const bytes = await this.read(path);
+        return bytes === null ? null : textDecoder.decode(bytes);
+    }
+    async write(path, data, contentType) {
+        await this.assertContained(path);
+        const bytes = typeof data === "string" ? textEncoder.encode(data) : data;
+        await this.storage.store(this.key(path), bytes, contentType);
+    }
+    async exists(path) {
+        try {
+            await this.assertContained(path);
+        }
+        catch {
+            return false;
+        }
+        return this.storage.exists(this.uri(path));
+    }
+    async stat(path) {
+        await this.assertContained(path);
+        const key = this.key(path);
+        const st = await this.storage.stat(this.storage.uriForKey(key));
+        if (st) {
+            return {
+                path: key,
+                size: st.size,
+                modifiedAt: st.modifiedAt,
+                contentType: st.contentType,
+                isDirectory: false
+            };
+        }
+        // No object at that key: it may still be a directory. On an object store a
+        // directory exists only as a shared prefix of other keys, so an empty one
+        // is indistinguishable from an absent one — but on a local workspace it is
+        // a real directory, and reporting an existing empty folder as missing is a
+        // difference a caller can see.
+        const listing = await this.storage.list(`${key}/`, { delimiter: "/" });
+        if (listing.entries.length > 0 || listing.commonPrefixes.length > 0) {
+            return { path: key, size: 0, modifiedAt: 0, isDirectory: true };
+        }
+        if (this.localDir) {
+            const { fs } = requireNode();
+            try {
+                const info = await fs.stat(resolvePath(this.localDir, key));
+                if (info.isDirectory()) {
+                    return {
+                        path: key,
+                        size: 0,
+                        modifiedAt: info.mtimeMs,
+                        isDirectory: true
+                    };
+                }
+            }
+            catch {
+                // Absent — fall through.
+            }
+        }
+        return null;
+    }
+    async list(path = "", opts = {}) {
+        const key = normalize(path);
+        if (key)
+            await this.assertContained(key);
+        const prefix = key ? `${key}/` : "";
+        const listing = await this.storage.list(prefix, opts.recursive === true ? {} : { delimiter: "/" });
+        const files = listing.entries.map((entry) => ({
+            path: entry.key,
+            name: entry.key.slice(entry.key.lastIndexOf("/") + 1),
+            size: entry.size,
+            modifiedAt: entry.modifiedAt,
+            isDirectory: false
+        }));
+        const dirs = listing.commonPrefixes.map((p) => {
+            const trimmed = p.endsWith("/") ? p.slice(0, -1) : p;
+            return {
+                path: trimmed,
+                name: trimmed.slice(trimmed.lastIndexOf("/") + 1),
+                size: 0,
+                modifiedAt: 0,
+                isDirectory: true
+            };
+        });
+        return [...dirs, ...files].sort((a, b) => a.path.localeCompare(b.path));
+    }
+    async delete(path) {
+        await this.assertContained(path);
+        return this.storage.delete(this.uri(path));
+    }
+    async deleteAll(path) {
+        const key = normalize(path);
+        // Same containment rule as every other mutating operation: without it a
+        // symlinked directory inside the workspace (`out -> ~/Documents`) makes
+        // this delete the link's target. `list` reads through the symlink and
+        // hands back keys that are lexically inside the root, so the adapter's own
+        // lexical check passes and `unlink` follows the link out.
+        if (key)
+            await this.assertContained(key);
+        const listing = await this.storage.list(key ? `${key}/` : "");
+        let deleted = 0;
+        for (const entry of listing.entries) {
+            if (await this.storage.delete(entry.uri))
+                deleted++;
+        }
+        // On an object store the prefix is gone once its keys are. A real
+        // directory would linger and keep showing up in `list`, so remove it —
+        // otherwise the same call leaves two different workspaces behind.
+        if (this.localDir && key) {
+            await requireNode().fs.rm(resolvePath(this.localDir, key), {
+                recursive: true,
+                force: true
+            });
+        }
+        return deleted;
+    }
+    async mkdir(path) {
+        // An object store has no directories — a key's prefix is its directory, so
+        // there is nothing to create and nothing to fail. A local workspace makes
+        // the real directory so an empty one survives and a host binary can cd
+        // into it.
+        if (this.localDir) {
+            const key = normalize(path);
+            if (!key)
+                return;
+            await this.assertContained(key);
+            await requireNode().fs.mkdir(resolvePath(this.localDir, key), {
+                recursive: true
+            });
+        }
+    }
+    async copy(from, to) {
+        const bytes = await this.read(from);
+        if (bytes === null) {
+            throw new Error(`Cannot copy '${from}': it does not exist`);
+        }
+        const st = await this.stat(from);
+        await this.write(to, bytes, st?.contentType);
+    }
+    async move(from, to) {
+        await this.copy(from, to);
+        await this.delete(from);
+    }
+    async materialize(path) {
+        await this.assertContained(path);
+        const key = this.key(path);
+        if (this.localDir)
+            return resolvePath(this.localDir, key);
+        const bytes = await this.read(key);
+        if (bytes === null) {
+            throw new Error(`Cannot stage '${path}': it does not exist`);
+        }
+        const node = requireNode();
+        const target = node.path.join(await this.scratchDir(), key);
+        await node.fs.mkdir(node.path.dirname(target), { recursive: true });
+        await node.fs.writeFile(target, bytes);
+        return target;
+    }
+    async absorb(localPath, path) {
+        const node = requireNode();
+        if (this.localDir &&
+            node.path.resolve(localPath) ===
+                node.path.resolve(this.localDir, this.key(path))) {
+            // The binary already wrote in place — the workspace *is* that file.
+            return;
+        }
+        await this.write(path, new Uint8Array(await node.fs.readFile(localPath)));
+    }
+    async scratchDir() {
+        if (this.localDir)
+            return this.localDir;
+        const node = requireNode();
+        this.scratch ??= node.fs.mkdtemp(node.path.join(node.os.tmpdir(), "nodetool-ws-"));
+        return this.scratch;
+    }
+    async cleanupScratch() {
+        const scratch = this.scratch;
+        this.scratch = null;
+        if (scratch) {
+            await requireNode().fs.rm(await scratch, { recursive: true, force: true });
+        }
+    }
+}
+/**
+ * Build a workspace over a storage backend.
+ *
+ * `prefix` carves a namespace out of a shared bucket — how a cloud deployment
+ * gives each user their own workspace inside the one bucket it has.
+ */
+export function createWorkspace(storage, opts = {}) {
+    if (!opts.prefix)
+        return new StorageWorkspace(storage);
+    return new StorageWorkspace(new PrefixedStorageAdapter(storage, opts.prefix), {
+        // A prefixed view of a local folder still has a real directory: the
+        // subfolder the prefix names.
+        localDir: (() => {
+            const root = localRootOf(storage);
+            return root ? resolvePath(root, opts.prefix) : null;
+        })()
+    });
+}
+/** A workspace over a real directory. */
+export function createLocalWorkspace(dir) {
+    return new StorageWorkspace(new FileStorageAdapter(dir));
+}
+/**
+ * Teach {@link ProcessingContext} how to build a workspace from the older
+ * `workspaceDir` / `workspaceStorage` options.
+ *
+ * The context cannot import this module — it must stay loadable off Node —
+ * so the direction is inverted: importing this file (which every host does,
+ * via the package index) installs the factory.
+ */
+setWorkspaceFactory((opts) => {
+    if (opts.workspace)
+        return opts.workspace;
+    if (opts.workspaceStorage)
+        return new StorageWorkspace(opts.workspaceStorage);
+    if (opts.workspaceDir)
+        return createLocalWorkspace(opts.workspaceDir);
+    return null;
+});
+//# sourceMappingURL=storage-workspace.js.map

package/dist/storage-workspace.js.map

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

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

@@ -0,0 +1,83 @@
+/**
+ * A {@link PythonBridge} that delegates every call to a current target bridge
+ * and re-emits the target's events. Swapping the target is transparent to
+ * holders of the reference: callers keep one stable handle whose behavior
+ * follows the active worker.
+ *
+ * `swap()` only re-points event forwarding — it never connects or closes a
+ * bridge. The owner of the lifecycle (the server) connects a worker bridge
+ * before swapping it in and closes it after swapping away.
+ */
+import { EventEmitter } from "node:events";
+import type { PythonBridge, ExecuteResult, ExecuteInputBlobs, ExecuteIdentity, JobBoundary, ModelEvictRequest, ModelEvictResult, ProgressEvent, PythonNodeMetadata, PythonWorkerLoadError, PythonWorkerStatus, PythonProviderInfo, UnifiedModelLike, ModelDownloadRequest, ModelPrepareRequest, ModelDownloadUpdate, ComfyStatusInfo, ComfyEvent, ComfyExecuteOptions, ComfyExecuteResult, ComfyModelDownloadRequest, ComfyModelDownloadUpdate, ComfyModelInfo, BlenderExecuteJob, BlenderStatusInfo, BlenderEvent, BlenderExecuteOptions, BlenderExecuteResult } from "./python-bridge-types.js";
+import type { ASRResult } from "./providers/types.js";
+export declare class SwappableBridge extends EventEmitter implements PythonBridge {
+    private _target;
+    private readonly _forwarders;
+    constructor(initial: PythonBridge);
+    /** The currently-delegated target (the server compares this to the local bridge). */
+    get target(): PythonBridge;
+    /** Swap the delegate. Re-points event forwarding; does NOT close either bridge. */
+    swap(next: PythonBridge): void;
+    private _subscribe;
+    private _unsubscribe;
+    connect(): Promise<void>;
+    ensureConnected(): Promise<void>;
+    execute(nodeType: string, fields: Record<string, unknown>, secrets: Record<string, string>, blobs: ExecuteInputBlobs, onProgress?: (event: ProgressEvent) => void, identity?: ExecuteIdentity): Promise<ExecuteResult>;
+    executeStream(nodeType: string, fields: Record<string, unknown>, secrets: Record<string, string>, blobs: ExecuteInputBlobs, onProgress?: (event: ProgressEvent) => void, identity?: ExecuteIdentity): AsyncGenerator<ExecuteResult>;
+    cancel(requestId: string): void;
+    getNodeMetadata(): PythonNodeMetadata[];
+    getLoadErrors(): PythonWorkerLoadError[];
+    getWorkerStatus(): Promise<PythonWorkerStatus>;
+    hasNodeType(nodeType: string): boolean;
+    get isConnected(): boolean;
+    isAvailable(): 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>>;
+    providerTTS(providerId: string, text: string, model: string, options?: Record<string, unknown>): AsyncGenerator<Uint8Array>;
+    providerTextToImage(providerId: string, params: Record<string, unknown>, secrets?: Record<string, string>, signal?: AbortSignal): Promise<Uint8Array>;
+    providerImageToImage(providerId: string, image: Uint8Array, params: Record<string, unknown>, secrets?: Record<string, string>, signal?: AbortSignal): Promise<Uint8Array>;
+    providerTextToVideo(providerId: string, params: Record<string, unknown>, secrets?: Record<string, string>, signal?: AbortSignal): Promise<Uint8Array>;
+    providerImageToVideo(providerId: string, image: Uint8Array, params: Record<string, unknown>, secrets?: Record<string, string>, signal?: AbortSignal): Promise<Uint8Array>;
+    providerReferenceToVideo(providerId: string, inputs: import("./providers/types.js").ReferenceToVideoInputs, params: Record<string, unknown>, secrets?: Record<string, string>, signal?: AbortSignal): Promise<Uint8Array>;
+    providerTextToAudio(providerId: string, params: Record<string, unknown>, secrets?: Record<string, string>): Promise<Uint8Array>;
+    providerTTSEncoded(providerId: string, params: Record<string, unknown>, secrets?: Record<string, string>): Promise<Uint8Array>;
+    providerASR(providerId: string, audio: Uint8Array, model: string, options?: Record<string, unknown>): Promise<ASRResult>;
+    providerEmbedding(providerId: string, text: string | string[], model: string, dimensions?: number): Promise<number[][]>;
+    listCachedModels(): Promise<UnifiedModelLike[]>;
+    downloadModel(req: ModelDownloadRequest, onProgress: (update: ModelDownloadUpdate) => void, requestId?: string): Promise<void>;
+    prepareModel(req: ModelPrepareRequest, onProgress: (update: ModelDownloadUpdate) => void, requestId?: string): Promise<void>;
+    supportsModelPreparation(backend: string): boolean;
+    cancelModelDownload(requestId: string): void;
+    deleteCachedModel(repoId: string): Promise<boolean>;
+    supportsModelManagement(): boolean;
+    evictModels(req?: ModelEvictRequest): Promise<ModelEvictResult>;
+    supportsJobLifecycle(): boolean;
+    jobStart(job: JobBoundary): Promise<void>;
+    jobEnd(job: JobBoundary): Promise<void>;
+    supportsComfy(): boolean;
+    getComfyStatus(): ComfyStatusInfo | null;
+    comfyExecute(workflow: Record<string, unknown>, options?: ComfyExecuteOptions, onEvent?: (event: ComfyEvent) => void, requestId?: string): Promise<ComfyExecuteResult>;
+    cancelComfyExecute(requestId: string): void;
+    supportsBlender(): boolean;
+    getBlenderStatus(): BlenderStatusInfo | null;
+    blenderExecute(job: BlenderExecuteJob, inputs: Record<string, string>, options?: BlenderExecuteOptions, onEvent?: (event: BlenderEvent) => void, requestId?: string): Promise<BlenderExecuteResult>;
+    cancelBlenderExecute(requestId: string): void;
+    comfyQueue(): Promise<Record<string, unknown>>;
+    comfyInterrupt(): Promise<void>;
+    comfyCancelPrompt(promptId: string): Promise<void>;
+    comfyUpload(filename: string, bytes: Uint8Array, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    comfyView(filename: string, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    comfyObjectInfo(): Promise<Record<string, unknown>>;
+    comfySystemStats(): Promise<Record<string, unknown>>;
+    comfyStatus(): Promise<ComfyStatusInfo>;
+    comfyFree(options?: Record<string, unknown>): Promise<void>;
+    comfyModelsList(folder?: string): Promise<ComfyModelInfo[]>;
+    comfyModelsDownload(req: ComfyModelDownloadRequest, onProgress: (update: ComfyModelDownloadUpdate) => void, requestId?: string): Promise<void>;
+    comfyModelsDelete(folder: string, filename: string): Promise<boolean>;
+    getRecentStderrSummary(limit?: number): string | null;
+    close(): void;
+}
+//# sourceMappingURL=swappable-python-bridge.d.ts.map

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

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