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

package/dist/variable-channel.d.ts

@@ -0,0 +1,48 @@
+/**
+ * VariableChannel — a typed async broadcast channel backing Set/Get Variable.
+ *
+ * A Set Variable node `send`s values onto a named channel; readers consume
+ * them without an explicit graph edge:
+ *   - `first()` resolves with the first value sent (cached), so a Prompt can
+ *     wait for a variable to exist before rendering. Resolves `undefined` if
+ *     the channel closes without ever receiving a value.
+ *   - `stream()` is a replaying async iterator: every subscriber sees the full
+ *     value history then live values until the channel closes, so a Get
+ *     Variable's streaming output is independent of scheduling order.
+ *
+ * The channel is generic in its value type so callers stay type-safe; the
+ * node-graph layer derives the concrete type from whatever feeds Set Variable.
+ *
+ * Lifecycle: the workflow runner closes a channel once its last Set Variable
+ * writer finishes, which unblocks waiting readers (with the buffered values,
+ * or `undefined`/end-of-stream when nothing was sent).
+ */
+export declare class VariableChannel<T = unknown> {
+    private readonly _buffer;
+    private _closed;
+    private _hasValue;
+    /** Resolvers waiting on {@link first}. */
+    private _firstWaiters;
+    /** Resolvers waiting for the next {@link stream} tick (new value or close). */
+    private _streamWaiters;
+    /** Whether the channel has been closed (no further values will arrive). */
+    get closed(): boolean;
+    /** Whether at least one value has been sent. */
+    get hasValue(): boolean;
+    /** Append a value and wake any waiting readers. No-op once closed. */
+    send(value: T): void;
+    /** Mark the channel closed and release every waiting reader. Idempotent. */
+    close(): void;
+    /**
+     * Resolve with the first value ever sent. Waits if none has arrived yet;
+     * resolves `undefined` if the channel closes without a value.
+     */
+    first(): Promise<T | undefined>;
+    /**
+     * Replaying async iterator: yields the full value history (from index 0)
+     * then live values, ending when the channel is closed and drained.
+     */
+    stream(): AsyncGenerator<T>;
+    private _wakeStreams;
+}
+//# sourceMappingURL=variable-channel.d.ts.map

package/dist/variable-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-channel.d.ts","sourceRoot":"","sources":["../src/variable-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,0CAA0C;IAC1C,OAAO,CAAC,aAAa,CAA6C;IAClE,+EAA+E;IAC/E,OAAO,CAAC,cAAc,CAAyB;IAE/C,2EAA2E;IAC3E,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,gDAAgD;IAChD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,sEAAsE;IACtE,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAgBnB;IAED,4EAA4E;IAC5E,KAAK,IAAI,IAAI,CAaZ;IAED;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAU9B;IAED;;;OAGG;IACI,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC,CAcjC;IAED,OAAO,CAAC,YAAY;CAOrB"}

package/dist/variable-channel.js

@@ -0,0 +1,110 @@
+/**
+ * VariableChannel — a typed async broadcast channel backing Set/Get Variable.
+ *
+ * A Set Variable node `send`s values onto a named channel; readers consume
+ * them without an explicit graph edge:
+ *   - `first()` resolves with the first value sent (cached), so a Prompt can
+ *     wait for a variable to exist before rendering. Resolves `undefined` if
+ *     the channel closes without ever receiving a value.
+ *   - `stream()` is a replaying async iterator: every subscriber sees the full
+ *     value history then live values until the channel closes, so a Get
+ *     Variable's streaming output is independent of scheduling order.
+ *
+ * The channel is generic in its value type so callers stay type-safe; the
+ * node-graph layer derives the concrete type from whatever feeds Set Variable.
+ *
+ * Lifecycle: the workflow runner closes a channel once its last Set Variable
+ * writer finishes, which unblocks waiting readers (with the buffered values,
+ * or `undefined`/end-of-stream when nothing was sent).
+ */
+export class VariableChannel {
+    _buffer = [];
+    _closed = false;
+    _hasValue = false;
+    /** Resolvers waiting on {@link first}. */
+    _firstWaiters = [];
+    /** Resolvers waiting for the next {@link stream} tick (new value or close). */
+    _streamWaiters = [];
+    /** Whether the channel has been closed (no further values will arrive). */
+    get closed() {
+        return this._closed;
+    }
+    /** Whether at least one value has been sent. */
+    get hasValue() {
+        return this._hasValue;
+    }
+    /** Append a value and wake any waiting readers. No-op once closed. */
+    send(value) {
+        if (this._closed) {
+            return;
+        }
+        this._buffer.push(value);
+        const firstArrival = !this._hasValue;
+        this._hasValue = true;
+        if (firstArrival) {
+            const waiters = this._firstWaiters;
+            this._firstWaiters = [];
+            for (const resolve of waiters) {
+                resolve(value);
+            }
+        }
+        this._wakeStreams();
+    }
+    /** Mark the channel closed and release every waiting reader. Idempotent. */
+    close() {
+        if (this._closed) {
+            return;
+        }
+        this._closed = true;
+        if (!this._hasValue) {
+            const waiters = this._firstWaiters;
+            this._firstWaiters = [];
+            for (const resolve of waiters) {
+                resolve(undefined);
+            }
+        }
+        this._wakeStreams();
+    }
+    /**
+     * Resolve with the first value ever sent. Waits if none has arrived yet;
+     * resolves `undefined` if the channel closes without a value.
+     */
+    first() {
+        if (this._hasValue) {
+            return Promise.resolve(this._buffer[0]);
+        }
+        if (this._closed) {
+            return Promise.resolve(undefined);
+        }
+        return new Promise((resolve) => {
+            this._firstWaiters.push(resolve);
+        });
+    }
+    /**
+     * Replaying async iterator: yields the full value history (from index 0)
+     * then live values, ending when the channel is closed and drained.
+     */
+    async *stream() {
+        let cursor = 0;
+        for (;;) {
+            while (cursor < this._buffer.length) {
+                yield this._buffer[cursor];
+                cursor += 1;
+            }
+            if (this._closed) {
+                return;
+            }
+            await new Promise((resolve) => {
+                this._streamWaiters.push(resolve);
+            });
+        }
+    }
+    _wakeStreams() {
+        const waiters = this._streamWaiters;
+        this._streamWaiters = [];
+        for (const resolve of waiters) {
+            resolve();
+        }
+    }
+}
+//# sourceMappingURL=variable-channel.js.map

package/dist/variable-channel.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,119 @@
+/**
+ * The workspace a run reads and writes files in, as an interface rather than a
+ * directory.
+ *
+ * Everything that touched the workspace used to take `workspaceDir: string` and
+ * call `node:fs`, which is why a cloud deployment had no workspace worth the
+ * name: there is no directory to hand out. A `Workspace` is backed by any
+ * `StorageAdapter`, so the local install passes a `FileStorageAdapter` over a
+ * real folder and the cloud passes its S3/Supabase adapter scoped to a per-user
+ * prefix. Callers cannot tell the difference and must not try — the interface
+ * exposes no adapter for that reason.
+ *
+ * Paths are workspace-relative and normalized: `notes.md`, `out/report.pdf`,
+ * `/workspace/notes.md` and `workspace/notes.md` all name the same file, and a
+ * path that would climb out of the root is rejected rather than clamped.
+ *
+ * Object stores have no directories. `mkdir` is therefore a no-op that
+ * succeeds, `list` synthesizes directory entries from key prefixes, and an
+ * empty directory does not survive a round trip. Code that needs a real
+ * directory — a host binary, an mmap'd database — goes through
+ * {@link Workspace.materialize} and {@link Workspace.absorb}, or reads
+ * {@link Workspace.localDir} and says plainly that it needs a local workspace.
+ */
+export interface WorkspaceEntry {
+    /** Workspace-relative path. */
+    path: string;
+    /** Last path segment. */
+    name: string;
+    /** Byte size; 0 for a directory. */
+    size: number;
+    /** Last-modified time in ms since epoch; 0 for a synthesized directory. */
+    modifiedAt: number;
+    isDirectory: boolean;
+}
+export interface WorkspaceStat {
+    path: string;
+    size: number;
+    modifiedAt: number;
+    contentType?: string;
+    isDirectory: boolean;
+}
+export interface Workspace {
+    /**
+     * The real directory backing this workspace, or null when it is virtual.
+     *
+     * Read it only to decide whether a host binary can run in place. Anything
+     * that merely moves bytes must use the methods below, which work either way.
+     */
+    readonly localDir: string | null;
+    /** Normalize a caller-supplied path to a workspace key. Throws if it escapes. */
+    key(path: string): string;
+    /** Opaque URI for a workspace path — what `retrieve`/`delete` round-trip. */
+    uri(path: string): string;
+    read(path: string): Promise<Uint8Array | null>;
+    readText(path: string): Promise<string | null>;
+    write(path: string, data: Uint8Array | string, contentType?: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<WorkspaceStat | null>;
+    /** Direct children of `path`, or every descendant when `recursive`. */
+    list(path?: string, opts?: {
+        recursive?: boolean;
+    }): Promise<WorkspaceEntry[]>;
+    /** Delete one file. Returns false when it was not there. */
+    delete(path: string): Promise<boolean>;
+    /** Delete a directory and everything under it. Returns how many files went. */
+    deleteAll(path: string): Promise<number>;
+    /** No-op on an object store; creates the directory on a local one. */
+    mkdir(path: string): Promise<void>;
+    copy(from: string, to: string): Promise<void>;
+    move(from: string, to: string): Promise<void>;
+    /**
+     * A real local path holding this file's current bytes, for handing to a host
+     * binary. On a local workspace that is the file itself, so a binary writing
+     * in place works. On a virtual one the bytes are staged into a scratch
+     * directory and the caller must {@link absorb} anything it changed.
+     */
+    materialize(path: string): Promise<string>;
+    /** Copy a real local file into the workspace. The inverse of materialize. */
+    absorb(localPath: string, path: string): Promise<void>;
+    /**
+     * A real directory a host binary may use for its inputs and outputs. The
+     * workspace root on a local workspace; a per-run scratch directory on a
+     * virtual one, whose contents reach storage only through `absorb`.
+     */
+    scratchDir(): Promise<string>;
+    /** Remove scratch files staged for this workspace after its run ends. */
+    cleanupScratch?(): Promise<void>;
+}
+/** Thrown when a path would resolve outside the workspace root. */
+export declare class WorkspacePathError extends Error {
+    constructor(path: string);
+}
+/** Thrown when an operation needs a real directory and the workspace is virtual. */
+export declare class WorkspaceNotLocalError extends Error {
+    constructor(what: string);
+}
+/** What a mutation did, for a host that wants to react to it. */
+export interface WorkspaceChange {
+    kind: "write" | "delete" | "mkdir" | "copy" | "move";
+    /** The path written, created or removed. Workspace-relative. */
+    path: string;
+}
+/**
+ * A workspace that reports its own mutations.
+ *
+ * The Workspace Explorer lists files over tRPC and has no way to learn that a
+ * chat turn just wrote one — workspace files are not database rows, so the
+ * `resource_change` broadcast that keeps every other panel live never fires for
+ * them. Wrapping the workspace a run resolves is the one place every writer
+ * passes through: the file capabilities, the save nodes, and anything else that
+ * goes through the interface rather than `node:fs`.
+ *
+ * `onChange` fires only after the underlying call resolves, so a rejected write
+ * never announces a file that is not there. It is called synchronously and must
+ * not throw — a notifier is a side channel, and a run must not fail because a
+ * listener did.
+ */
+export declare function observeWorkspace(inner: Workspace, onChange: (change: WorkspaceChange) => void): Workspace;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,iFAAiF;IACjF,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1B,6EAA6E;IAC7E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/C,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAClD,uEAAuE;IACvE,IAAI,CACF,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7B,4DAA4D;IAC5D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,+EAA+E;IAC/E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,sEAAsE;IACtE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3C,6EAA6E;IAC7E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B,yEAAyE;IACzE,cAAc,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,mEAAmE;AACnE,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,IAAI,EAAE,MAAM,EAGvB;CACF;AAED,oFAAoF;AACpF,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,IAAI,EAAE,MAAM,EAOvB;CACF;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACrD,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAC1C,SAAS,CAuDX"}

package/dist/workspace.js

@@ -0,0 +1,112 @@
+/**
+ * The workspace a run reads and writes files in, as an interface rather than a
+ * directory.
+ *
+ * Everything that touched the workspace used to take `workspaceDir: string` and
+ * call `node:fs`, which is why a cloud deployment had no workspace worth the
+ * name: there is no directory to hand out. A `Workspace` is backed by any
+ * `StorageAdapter`, so the local install passes a `FileStorageAdapter` over a
+ * real folder and the cloud passes its S3/Supabase adapter scoped to a per-user
+ * prefix. Callers cannot tell the difference and must not try — the interface
+ * exposes no adapter for that reason.
+ *
+ * Paths are workspace-relative and normalized: `notes.md`, `out/report.pdf`,
+ * `/workspace/notes.md` and `workspace/notes.md` all name the same file, and a
+ * path that would climb out of the root is rejected rather than clamped.
+ *
+ * Object stores have no directories. `mkdir` is therefore a no-op that
+ * succeeds, `list` synthesizes directory entries from key prefixes, and an
+ * empty directory does not survive a round trip. Code that needs a real
+ * directory — a host binary, an mmap'd database — goes through
+ * {@link Workspace.materialize} and {@link Workspace.absorb}, or reads
+ * {@link Workspace.localDir} and says plainly that it needs a local workspace.
+ */
+/** Thrown when a path would resolve outside the workspace root. */
+export class WorkspacePathError extends Error {
+    constructor(path) {
+        super(`Path '${path}' is outside the workspace`);
+        this.name = "WorkspacePathError";
+    }
+}
+/** Thrown when an operation needs a real directory and the workspace is virtual. */
+export class WorkspaceNotLocalError extends Error {
+    constructor(what) {
+        super(`${what} needs a local workspace directory, and this run has a virtual ` +
+            `one (cloud storage). Run it on a local install, or use a node that ` +
+            `reads and writes through the workspace instead.`);
+        this.name = "WorkspaceNotLocalError";
+    }
+}
+/**
+ * A workspace that reports its own mutations.
+ *
+ * The Workspace Explorer lists files over tRPC and has no way to learn that a
+ * chat turn just wrote one — workspace files are not database rows, so the
+ * `resource_change` broadcast that keeps every other panel live never fires for
+ * them. Wrapping the workspace a run resolves is the one place every writer
+ * passes through: the file capabilities, the save nodes, and anything else that
+ * goes through the interface rather than `node:fs`.
+ *
+ * `onChange` fires only after the underlying call resolves, so a rejected write
+ * never announces a file that is not there. It is called synchronously and must
+ * not throw — a notifier is a side channel, and a run must not fail because a
+ * listener did.
+ */
+export function observeWorkspace(inner, onChange) {
+    const notify = (kind, path) => {
+        try {
+            onChange({ kind, path });
+        }
+        catch {
+            // A listener must never break the write it is reporting.
+        }
+    };
+    return {
+        get localDir() {
+            return inner.localDir;
+        },
+        key: (path) => inner.key(path),
+        uri: (path) => inner.uri(path),
+        read: (path) => inner.read(path),
+        readText: (path) => inner.readText(path),
+        exists: (path) => inner.exists(path),
+        stat: (path) => inner.stat(path),
+        list: (path, opts) => inner.list(path, opts),
+        materialize: (path) => inner.materialize(path),
+        scratchDir: () => inner.scratchDir(),
+        cleanupScratch: () => inner.cleanupScratch?.() ?? Promise.resolve(),
+        async write(path, data, contentType) {
+            await inner.write(path, data, contentType);
+            notify("write", path);
+        },
+        async delete(path) {
+            const removed = await inner.delete(path);
+            if (removed)
+                notify("delete", path);
+            return removed;
+        },
+        async deleteAll(path) {
+            const count = await inner.deleteAll(path);
+            if (count > 0)
+                notify("delete", path);
+            return count;
+        },
+        async mkdir(path) {
+            await inner.mkdir(path);
+            notify("mkdir", path);
+        },
+        async copy(from, to) {
+            await inner.copy(from, to);
+            notify("copy", to);
+        },
+        async move(from, to) {
+            await inner.move(from, to);
+            notify("move", to);
+        },
+        async absorb(localPath, path) {
+            await inner.absorb(localPath, path);
+            notify("write", path);
+        }
+    };
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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

package/package.json

@@ -1,41 +1,60 @@
 {
   "name": "@nodetool-ai/runtime",
-  "version": "0.7.0-rc.23",
+  "version": "0.8.1",
   "description": "Processing context, message queue, and output normalization",
   "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "node ../../scripts/build-typescript-workspace.mjs && node -e \"require('node:fs').mkdirSync('dist/providers',{recursive:true}); require('node:fs').cpSync('src/providers/aki-manifest.json', 'dist/providers/aki-manifest.json')\"",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "tsc --noEmit"
+    "test": "node ../../scripts/run-vitest.mjs run",
+    "test:watch": "node ../../scripts/run-vitest.mjs",
+    "lint": "node ../../scripts/run-tsc.mjs --noEmit"
   },
   "dependencies": {
     "@aki-io/aki-io": "^1.0.1",
-    "@anthropic-ai/sdk": "^0.36.2",
-    "@msgpack/msgpack": "^3.1.3",
-    "@nodetool-ai/config": "^0.7.0-rc.23",
-    "@nodetool-ai/protocol": "^0.7.0-rc.23",
+    "@anthropic-ai/sdk": "^0.105.0",
+    "@huggingface/inference": "^4.13.25",
+    "@nodetool-ai/config": "^0.8.1",
+    "@nodetool-ai/protocol": "^0.8.1",
+    "@nodetool-ai/storage": "^0.8.1",
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/exporter-trace-otlp-proto": "^0.203.0",
-    "@opentelemetry/resources": "^2.6.0",
-    "@opentelemetry/sdk-node": "^0.203.0",
-    "@opentelemetry/sdk-trace-base": "^2.6.0",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.221.0",
+    "@opentelemetry/resources": "^2.10.0",
+    "@opentelemetry/sdk-node": "^0.221.0",
+    "@opentelemetry/sdk-trace-base": "^2.10.0",
     "@opentelemetry/semantic-conventions": "^1.40.0",
+    "@pydantic/genai-prices": "^0.0.69",
+    "fflate": "^0.8.2",
+    "js-tiktoken": "^1.0.21",
+    "msgpackr": "^1.11.2",
     "openai": "^6.35.0",
     "replicate": "^1.4.0",
-    "sharp": "^0.34.5",
-    "ws": "^8.19.0"
-  },
-  "optionalDependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.101"
+    "sharp": "^0.35.3",
+    "ws": "^8.19.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.283",
     "@types/node": "^22.0.0",
     "@types/ws": "^8.18.1",
-    "typescript": "^5.7.2",
-    "vitest": "^4.1.2"
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "^5.0.1"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.283",
+    "node-llama-cpp": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/claude-agent-sdk": {
+      "optional": true
+    },
+    "node-llama-cpp": {
+      "optional": true
+    }
   },
   "exports": {
     ".": {
@@ -43,6 +62,61 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./oauth": {
+      "nodetool-dev": "./src/providers/oauth/index.ts",
+      "types": "./dist/providers/oauth/index.d.ts",
+      "import": "./dist/providers/oauth/index.js",
+      "default": "./dist/providers/oauth/index.js"
+    },
+    "./context": {
+      "nodetool-dev": "./src/context.ts",
+      "types": "./dist/context.d.ts",
+      "import": "./dist/context.js",
+      "default": "./dist/context.js"
+    },
+    "./provider-transport": {
+      "nodetool-dev": "./src/providers/provider-transport.ts",
+      "types": "./dist/providers/provider-transport.d.ts",
+      "import": "./dist/providers/provider-transport.js",
+      "default": "./dist/providers/provider-transport.js"
+    },
+    "./safe-url": {
+      "nodetool-dev": "./src/providers/safe-url.ts",
+      "types": "./dist/providers/safe-url.d.ts",
+      "import": "./dist/providers/safe-url.js",
+      "default": "./dist/providers/safe-url.js"
+    },
+    "./entities": {
+      "nodetool-dev": "./src/entities.ts",
+      "types": "./dist/entities.d.ts",
+      "import": "./dist/entities.js",
+      "default": "./dist/entities.js"
+    },
+    "./media-ref-bytes": {
+      "nodetool-dev": "./src/media-ref-bytes.ts",
+      "types": "./dist/media-ref-bytes.d.ts",
+      "import": "./dist/media-ref-bytes.js",
+      "default": "./dist/media-ref-bytes.js"
+    },
+    "./prompt-asset-refs": {
+      "nodetool-dev": "./src/prompt-asset-refs.ts",
+      "types": "./dist/prompt-asset-refs.d.ts",
+      "import": "./dist/prompt-asset-refs.js",
+      "default": "./dist/prompt-asset-refs.js"
+    },
+    "./tracing": {
+      "nodetool-dev": "./src/tracing-helpers.ts",
+      "types": "./dist/tracing-helpers.d.ts",
+      "import": "./dist/tracing-helpers.js",
+      "default": "./dist/tracing-helpers.js"
+    },
+    "./providers/aki-manifest.json": "./dist/providers/aki-manifest.json",
+    "./google": {
+      "nodetool-dev": "./src/google/index.ts",
+      "types": "./dist/google/index.d.ts",
+      "import": "./dist/google/index.js",
+      "default": "./dist/google/index.js"
     }
   },
   "license": "MIT",
@@ -61,5 +135,19 @@
   "files": [
     "dist",
     "README.md"
+  ],
+  "keywords": [
+    "nodetool",
+    "ai",
+    "workflow",
+    "workflow-automation",
+    "typescript",
+    "llm",
+    "llm-providers",
+    "openai",
+    "anthropic",
+    "gemini",
+    "ollama",
+    "inference"
   ]
 }