@nodetool-ai/runtime 0.8.8 → 0.8.9-beta.2

package/dist/workspace.d.ts

@@ -1,119 +1,2 @@
-/**
- * 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;
+export { WorkspacePathError, WorkspaceNotLocalError, observeWorkspace, type Workspace, type WorkspaceEntry, type WorkspaceStat, type WorkspaceChange } from "@nodetool-ai/runtime-core";
 //# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC"}

package/dist/workspace.js

@@ -1,112 +1,2 @@
-/**
- * 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);
-        }
-    };
-}
+export { WorkspacePathError, WorkspaceNotLocalError, observeWorkspace } from "@nodetool-ai/runtime-core";
 //# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAkFH,mEAAmE;AACnE,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,IAAY;QACtB,KAAK,CAAC,SAAS,IAAI,4BAA4B,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,IAAY;QACtB,KAAK,CACH,GAAG,IAAI,iEAAiE;YACtE,qEAAqE;YACrE,iDAAiD,CACpD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AASD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAgB,EAChB,QAA2C;IAE3C,MAAM,MAAM,GAAG,CAAC,IAA6B,EAAE,IAAY,EAAQ,EAAE;QACnE,IAAI,CAAC;YACH,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,QAAQ;YACV,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;QACD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAC9B,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACxC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;QACpC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAChC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QAC5C,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;QAC9C,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE;QACpC,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE;QAEnE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW;YACjC,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;YAC3C,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI;YACf,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,OAAO;gBAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACpC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,IAAI;YAClB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,KAAK,GAAG,CAAC;gBAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI;YACd,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE;YACjB,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC3B,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE;YACjB,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC3B,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI;YAC1B,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACpC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAKjB,MAAM,2BAA2B,CAAC"}

package/dist/yt-dlp-format.d.ts

@@ -0,0 +1,22 @@
+/**
+ * yt-dlp format selectors, split so yt-dlp never merges.
+ *
+ * yt-dlp merges a `+` selector (`bv*+ba`) with the ffmpeg binary. NodeTool
+ * ships no ffmpeg, so a caller downloads each side of the top-level `+` with
+ * its own yt-dlp call and muxes the two files in process with
+ * `muxStreamCopy` from `@nodetool-ai/runtime/media`.
+ */
+/** What NodeTool asks for when no selector is given: best picture, best sound. */
+export declare const DEFAULT_YT_DLP_FORMAT = "bv*+ba/b";
+/**
+ * Split `selector` on its top-level `+`.
+ *
+ * The result has one component (download one file, no mux) or two (the
+ * video side, then the audio side). A `/` fallback stays inside its component
+ * for yt-dlp to resolve, so `bv+ba/b` splits into `bv` and `ba/b`. A `+`
+ * inside `[...]` is part of a filter and does not split. A `+` inside `(...)`
+ * is a merge this cannot split, so it throws, as do unbalanced brackets, an
+ * empty side, more than two sides, and a top-level `,` beside a `+`.
+ */
+export declare function splitYtDlpFormat(selector: string): string[];
+//# sourceMappingURL=yt-dlp-format.d.ts.map

package/dist/yt-dlp-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yt-dlp-format.d.ts","sourceRoot":"","sources":["../src/yt-dlp-format.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CA2D3D"}

package/dist/yt-dlp-format.js

@@ -0,0 +1,90 @@
+/**
+ * yt-dlp format selectors, split so yt-dlp never merges.
+ *
+ * yt-dlp merges a `+` selector (`bv*+ba`) with the ffmpeg binary. NodeTool
+ * ships no ffmpeg, so a caller downloads each side of the top-level `+` with
+ * its own yt-dlp call and muxes the two files in process with
+ * `muxStreamCopy` from `@nodetool-ai/runtime/media`.
+ */
+/** What NodeTool asks for when no selector is given: best picture, best sound. */
+export const DEFAULT_YT_DLP_FORMAT = "bv*+ba/b";
+/**
+ * Split `selector` on its top-level `+`.
+ *
+ * The result has one component (download one file, no mux) or two (the
+ * video side, then the audio side). A `/` fallback stays inside its component
+ * for yt-dlp to resolve, so `bv+ba/b` splits into `bv` and `ba/b`. A `+`
+ * inside `[...]` is part of a filter and does not split. A `+` inside `(...)`
+ * is a merge this cannot split, so it throws, as do unbalanced brackets, an
+ * empty side, more than two sides, and a top-level `,` beside a `+`.
+ */
+export function splitYtDlpFormat(selector) {
+    const text = selector.trim();
+    if (!text)
+        throw new Error("The format selector is empty");
+    const cuts = [];
+    let depth = 0;
+    let inFilter = false;
+    let quote = null;
+    let plusInGroup = false;
+    let commaAtTop = false;
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i];
+        if (quote) {
+            if (ch === quote)
+                quote = null;
+            continue;
+        }
+        if (inFilter) {
+            if (ch === "'" || ch === '"')
+                quote = ch;
+            else if (ch === "]")
+                inFilter = false;
+            continue;
+        }
+        if (ch === "[")
+            inFilter = true;
+        else if (ch === "]")
+            throw new Error(`Format selector "${text}" has a "]" with no "["`);
+        else if (ch === "(")
+            depth += 1;
+        else if (ch === ")") {
+            if (depth === 0)
+                throw new Error(`Format selector "${text}" has a ")" with no "("`);
+            depth -= 1;
+        }
+        else if (ch === "+") {
+            if (depth > 0)
+                plusInGroup = true;
+            else
+                cuts.push(i);
+        }
+        else if (ch === "," && depth === 0) {
+            commaAtTop = true;
+        }
+    }
+    if (inFilter || quote)
+        throw new Error(`Format selector "${text}" has an unclosed "["`);
+    if (depth > 0)
+        throw new Error(`Format selector "${text}" has an unclosed "("`);
+    if (plusInGroup) {
+        throw new Error(`Format selector "${text}" merges inside parentheses. NodeTool merges ` +
+            `without ffmpeg only at the top level: write it as "<video>+<audio>".`);
+    }
+    if (cuts.length === 0)
+        return [text];
+    if (commaAtTop) {
+        throw new Error(`Format selector "${text}" mixes "," and "+". Ask for one video and ` +
+            `one audio format, as "<video>+<audio>".`);
+    }
+    if (cuts.length > 1) {
+        throw new Error(`Format selector "${text}" merges ${cuts.length + 1} formats. NodeTool ` +
+            `muxes one video and one audio format, as "<video>+<audio>".`);
+    }
+    const parts = [text.slice(0, cuts[0]).trim(), text.slice(cuts[0] + 1).trim()];
+    if (parts.some((part) => part.length === 0)) {
+        throw new Error(`Format selector "${text}" has an empty side of "+"`);
+    }
+    return parts;
+}
+//# sourceMappingURL=yt-dlp-format.js.map

package/dist/yt-dlp-format.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodetool-ai/runtime",
-  "version": "0.8.8",
+  "version": "0.8.9-beta.2",
   "description": "Processing context, message queue, and output normalization",
   "type": "module",
   "engines": {
@@ -20,10 +20,10 @@
     "@anthropic-ai/sdk": "^0.105.0",
     "@huggingface/inference": "^4.13.25",
     "@meta-sam/parser": "^0.1.0",
-    "@nodetool-ai/browser": "0.8.8",
-    "@nodetool-ai/config": "0.8.8",
-    "@nodetool-ai/protocol": "0.8.8",
-    "@nodetool-ai/storage": "0.8.8",
+    "@nodetool-ai/browser": "0.8.9-beta.2",
+    "@nodetool-ai/config": "0.8.9-beta.2",
+    "@nodetool-ai/protocol": "0.8.9-beta.2",
+    "@nodetool-ai/storage": "0.8.9-beta.2",
     "@opentelemetry/api": "^1.9.0",
     "@pydantic/genai-prices": "^0.1.9",
     "fflate": "^0.8.2",
@@ -32,7 +32,12 @@
     "replicate": "^1.4.0",
     "ws": "^8.19.0",
     "zod": "^4.4.3",
-    "@nodetool-ai/antigravity-cli": "0.8.8"
+    "@nodetool-ai/antigravity-cli": "0.8.9-beta.2",
+    "@mediabunny/server": "1.54.0",
+    "mediabunny": "1.54.0",
+    "node-av": "^6.1.1",
+    "@nodetool-ai/runtime-core": "0.8.9-beta.2",
+    "@nodetool-ai/execution-core": "0.8.9-beta.2"
   },
   "devDependencies": {
     "js-tiktoken": "^1.0.21",
@@ -97,6 +102,18 @@
       "import": "./dist/trim-video-window.js",
       "default": "./dist/trim-video-window.js"
     },
+    "./media": {
+      "nodetool-dev": "./src/media/index.ts",
+      "types": "./dist/media/index.d.ts",
+      "import": "./dist/media/index.js",
+      "default": "./dist/media/index.js"
+    },
+    "./media/testing": {
+      "nodetool-dev": "./src/media/testing.ts",
+      "types": "./dist/media/testing.d.ts",
+      "import": "./dist/media/testing.js",
+      "default": "./dist/media/testing.js"
+    },
     "./context": {
       "nodetool-dev": "./src/context.ts",
       "types": "./dist/context.d.ts",