@nodetool-ai/document-services 0.0.0-stage → 0.8.9-beta.2

package/README.md

@@ -1,3 +1,7 @@
-# Temporary Holding Version
+# Document services
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Canonical storyboard, entity, script and timeline model interfaces shared by
+HTTP and local execution hosts. This optional package depends on the full
+persistence models and runtime contracts, without the HTTP application.
+
+Import `documentModelInterfaces` from `@nodetool-ai/document-services`.

package/dist/.nodetool-build-stamp

@@ -0,0 +1 @@
+2026-10-31T10:34:52.785Z

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The model interfaces a graph uses to reach the documents a director approves:
+ * storyboards and the entity library.
+ *
+ * They live here rather than in `session/model-interfaces.ts` so the CLI's
+ * local (no-server) runs get the same implementations — a `nodetool debug` run
+ * of a graph that recasts a board has to write the same rows the server does,
+ * or the harness proves nothing about the server.
+ */
+import type { ProcessingContextModelInterfaces } from "@nodetool-ai/runtime";
+/** Storyboards, mirroring the script trio: owner-scoped reads, CAS updates. */
+export declare function storyboardModelInterfaces(): Pick<ProcessingContextModelInterfaces, "getStoryboard" | "listStoryboards" | "findRecastStoryboard" | "createStoryboard" | "updateStoryboard">;
+/**
+ * The entity library. An entity is an image asset carrying a marker, so every
+ * read here is an owner-scoped asset read and every write is a metadata write —
+ * the same path the `entities` agent capability takes.
+ */
+export declare function entityModelInterfaces(): Pick<ProcessingContextModelInterfaces, "listEntities" | "getEntity" | "upsertEntity">;
+/** All three groups, for a host installing the whole document surface. */
+/**
+ * Scripts and timeline sequences, owner-scoped with CAS updates.
+ *
+ * These live here rather than beside the server session because the CLI
+ * installs this module: without them `nodetool debug` cannot run a single
+ * `nodetool.script.*` or `nodetool.timeline.*` node, which is most of what the
+ * graph-resource fixtures do.
+ */
+export declare function scriptModelInterfaces(): Pick<ProcessingContextModelInterfaces, "getTimelineSequence" | "createTimelineSequence" | "updateTimelineSequence" | "getScript" | "createScript" | "updateScript">;
+export declare function documentModelInterfaces(): ProcessingContextModelInterfaces;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,OAAO,KAAK,EAEV,gCAAgC,EACjC,MAAM,sBAAsB,CAAC;AA2F9B,+EAA+E;AAC/E,wBAAgB,yBAAyB,IAAI,IAAI,CAC/C,gCAAgC,EAC9B,eAAe,GACf,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,kBAAkB,CACrB,CA+DA;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAC3C,gCAAgC,EAChC,cAAc,GAAG,WAAW,GAAG,cAAc,CAC9C,CA2DA;AAED,0EAA0E;AAC1E;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAC3C,gCAAgC,EAC9B,qBAAqB,GACrB,wBAAwB,GACxB,wBAAwB,GACxB,WAAW,GACX,cAAc,GACd,cAAc,CACjB,CA0EA;AAED,wBAAgB,uBAAuB,IAAI,gCAAgC,CA8B1E"}

package/dist/index.js

@@ -0,0 +1,296 @@
+/**
+ * The model interfaces a graph uses to reach the documents a director approves:
+ * storyboards and the entity library.
+ *
+ * They live here rather than in `session/model-interfaces.ts` so the CLI's
+ * local (no-server) runs get the same implementations — a `nodetool debug` run
+ * of a graph that recasts a board has to write the same rows the server does,
+ * or the harness proves nothing about the server.
+ */
+import { Asset, ImageDocument, Script, Storyboard, TimelineSequence, entityFromAsset } from "@nodetool-ai/models";
+import { ENTITY_METADATA_KEY, isRecord, readEntityMarker } from "@nodetool-ai/protocol";
+/** How many of the caller's image assets a library scan reads. */
+const ENTITY_ASSET_LIMIT = 1000;
+const norm = (value) => value.trim().toLowerCase();
+/**
+ * The entity row an upsert writes to: the one a previous run of the same graph
+ * made (`source.key`), else the one with the same kind and name in the same
+ * project. Null when neither exists and the entity is new.
+ *
+ * A caller that gives a key never lands on a row carrying a *different* key.
+ * Two SKUs of one product share a display name, so name matching would make the
+ * second SKU overwrite the first's descriptor, picture and key — and inherit
+ * its recast mapping. A row carrying no key of its own is still fair game: that
+ * is how an entity a person made by hand becomes the graph's on the first keyed
+ * run, instead of gaining a duplicate beside it.
+ */
+async function findUpsertTarget(args) {
+    const [assets] = await Asset.paginate(args.userId, {
+        contentType: "image",
+        projectId: args.projectId,
+        limit: ENTITY_ASSET_LIMIT
+    });
+    const markers = assets.map((asset) => [asset, readEntityMarker(asset.metadata)]);
+    const key = args.source?.key?.trim();
+    if (key) {
+        const bySource = markers.find(([, marker]) => marker?.source?.key === key);
+        if (bySource)
+            return bySource[0];
+    }
+    const name = norm(args.name);
+    const byName = markers.find(([, marker]) => !!marker &&
+        marker.kind === args.kind &&
+        norm(marker.name) === name &&
+        (!key || !marker.source?.key?.trim()));
+    return byName?.[0] ?? null;
+}
+/**
+ * Write the marker fields onto an asset's metadata and save it. Optional
+ * fields are left alone when the caller did not pass them, so a re-run that
+ * only knows the name and descriptor does not wipe a hand-written description.
+ */
+async function writeEntityMarker(asset, args) {
+    const refusal = Asset.systemEntityRefusal(asset);
+    if (refusal) {
+        throw new Error(refusal);
+    }
+    const raw = asset.metadata?.[ENTITY_METADATA_KEY];
+    const marker = isRecord(raw) ? { ...raw } : {};
+    marker["kind"] = args.kind;
+    marker["name"] = args.name;
+    marker["descriptor"] = args.descriptor;
+    if (args.description !== undefined)
+        marker["description"] = args.description;
+    if (args.tags !== undefined)
+        marker["tags"] = args.tags;
+    if (args.voiceId !== undefined) {
+        if (args.voiceId === null)
+            delete marker["voice_id"];
+        else
+            marker["voice_id"] = args.voiceId;
+    }
+    if (args.source !== undefined)
+        marker["source"] = { ...args.source };
+    // A swap points the entity's picture at another asset rather than moving the
+    // marker: the id boards and scripts store is the marker asset's, and moving
+    // it would leave every one of those references dangling.
+    if (args.imageAssetId && args.imageAssetId !== asset.id) {
+        marker["reference_asset_id"] = args.imageAssetId;
+    }
+    else {
+        delete marker["reference_asset_id"];
+    }
+    asset.metadata = { ...(asset.metadata ?? {}), [ENTITY_METADATA_KEY]: marker };
+    if (args.projectId) {
+        asset.project_id = args.projectId;
+    }
+    await asset.save();
+    const entity = entityFromAsset(asset);
+    if (!entity) {
+        throw new Error(`Entity marker on asset ${asset.id} was not readable`);
+    }
+    return entity;
+}
+/** Storyboards, mirroring the script trio: owner-scoped reads, CAS updates. */
+export function storyboardModelInterfaces() {
+    return {
+        getStoryboard: async ({ userId, id }) => {
+            const board = await Storyboard.findById(id);
+            if (!board || board.user_id !== userId)
+                return null;
+            return board.toResponse();
+        },
+        listStoryboards: async ({ userId, projectId, limit }) => {
+            const boards = projectId
+                ? await Storyboard.listByProject(projectId, userId, limit)
+                : await Storyboard.listByUser(userId, limit);
+            return boards.map((board) => board.toResponse());
+        },
+        // Scoped, not listed: `listStoryboards` answers with a window of the most
+        // recently updated rows, and a catalog batch bigger than that window would
+        // stop finding the copies it made and re-render them every pass.
+        findRecastStoryboard: async ({ userId, projectId, templateId, recastKey }) => {
+            const board = await Storyboard.findRecast({
+                userId,
+                projectId,
+                templateId,
+                recastKey
+            });
+            return board ? board.toResponse() : null;
+        },
+        createStoryboard: async ({ userId, name, projectId, document }) => {
+            const board = new Storyboard({
+                user_id: userId,
+                name: name ?? "Untitled storyboard",
+                project_id: projectId ?? "default",
+                document: JSON.stringify(document)
+            });
+            await board.save();
+            return board.toResponse();
+        },
+        updateStoryboard: async ({ userId, id, document, timelineId, baseUpdatedAt }) => {
+            const existing = await Storyboard.findById(id);
+            if (!existing || existing.user_id !== userId)
+                return null;
+            const fields = {};
+            if (document !== undefined)
+                fields.document = JSON.stringify(document);
+            if (timelineId !== undefined)
+                fields.timeline_id = timelineId;
+            const updated = await Storyboard.updateFieldsIfUnchanged(id, baseUpdatedAt ?? existing.updated_at, fields);
+            return updated ? updated.toResponse() : null;
+        }
+    };
+}
+/**
+ * The entity library. An entity is an image asset carrying a marker, so every
+ * read here is an owner-scoped asset read and every write is a metadata write —
+ * the same path the `entities` agent capability takes.
+ */
+export function entityModelInterfaces() {
+    return {
+        listEntities: async ({ userId, projectId, kind, tags, nameContains, limit }) => {
+            const [assets] = await Asset.paginate(userId, {
+                contentType: "image",
+                projectId,
+                limit: ENTITY_ASSET_LIMIT
+            });
+            const wanted = nameContains ? norm(nameContains) : "";
+            const matched = assets
+                .map((asset) => entityFromAsset(asset))
+                .filter((entity) => entity !== null)
+                .filter((entity) => {
+                if (kind && entity.kind !== kind)
+                    return false;
+                if (wanted && !norm(entity.name).includes(wanted))
+                    return false;
+                if (tags && tags.length > 0) {
+                    const own = entity.tags ?? [];
+                    if (!tags.every((tag) => own.includes(tag)))
+                        return false;
+                }
+                return true;
+            });
+            return limit !== undefined
+                ? matched.slice(0, Math.max(limit, 0))
+                : matched;
+        },
+        getEntity: async ({ userId, id }) => {
+            // An asset owned by someone else reads as missing, and an untagged one is
+            // not an entity — the library only sees assets carrying the marker.
+            const asset = await Asset.find(userId, id);
+            return asset ? entityFromAsset(asset) : null;
+        },
+        upsertEntity: async (args) => {
+            const asset = await Asset.find(args.userId, args.imageAssetId);
+            if (!asset) {
+                throw new Error(`Asset ${args.imageAssetId} was not found`);
+            }
+            if (!asset.content_type.startsWith("image/")) {
+                throw new Error(`${asset.name || asset.id} is a ${asset.content_type} asset; entities are image assets`);
+            }
+            const validatedArgs = { ...args, imageAssetId: asset.id };
+            const existing = await findUpsertTarget(validatedArgs);
+            if (existing) {
+                return {
+                    entity: await writeEntityMarker(existing, validatedArgs),
+                    created: false
+                };
+            }
+            return { entity: await writeEntityMarker(asset, validatedArgs), created: true };
+        }
+    };
+}
+/** All three groups, for a host installing the whole document surface. */
+/**
+ * Scripts and timeline sequences, owner-scoped with CAS updates.
+ *
+ * These live here rather than beside the server session because the CLI
+ * installs this module: without them `nodetool debug` cannot run a single
+ * `nodetool.script.*` or `nodetool.timeline.*` node, which is most of what the
+ * graph-resource fixtures do.
+ */
+export function scriptModelInterfaces() {
+    return {
+        getTimelineSequence: async ({ userId, id }) => {
+            const seq = await TimelineSequence.findById(id);
+            if (!seq || seq.user_id !== userId)
+                return null;
+            return seq.toTimelineSequence();
+        },
+        createTimelineSequence: async ({ userId, sequence }) => {
+            const seq = TimelineSequence.fromTimelineSequence(userId, sequence);
+            await seq.save();
+            return seq.toTimelineSequence();
+        },
+        updateTimelineSequence: async ({ userId, id, sequence }) => {
+            const existing = await TimelineSequence.findById(id);
+            if (!existing || existing.user_id !== userId)
+                return null;
+            const next = TimelineSequence.fromTimelineSequence(userId, sequence);
+            const updated = await TimelineSequence.updateFieldsIfUnchanged(id, next.updated_at, {
+                name: next.name,
+                fps: next.fps,
+                width: next.width,
+                height: next.height,
+                duration_ms: next.duration_ms,
+                document: next.document
+            });
+            return updated ? updated.toTimelineSequence() : null;
+        },
+        getScript: async ({ userId, id }) => {
+            const script = await Script.findById(id);
+            if (!script || script.user_id !== userId)
+                return null;
+            return script.toResponse();
+        },
+        createScript: async ({ userId, name, projectId, document }) => {
+            const script = new Script({
+                user_id: userId,
+                name: name ?? "Untitled script",
+                project_id: projectId ?? "default",
+                document: JSON.stringify(document)
+            });
+            await script.save();
+            return script.toResponse();
+        },
+        updateScript: async ({ userId, id, document, timelineId, baseUpdatedAt }) => {
+            const existing = await Script.findById(id);
+            if (!existing || existing.user_id !== userId)
+                return null;
+            const fields = {};
+            if (document !== undefined)
+                fields.document = JSON.stringify(document);
+            if (timelineId !== undefined)
+                fields.timeline_id = timelineId;
+            const updated = await Script.updateFieldsIfUnchanged(id, baseUpdatedAt ?? existing.updated_at, fields);
+            return updated ? updated.toResponse() : null;
+        }
+    };
+}
+export function documentModelInterfaces() {
+    return {
+        getImageDocument: async ({ userId, id }) => {
+            const doc = await ImageDocument.findById(id);
+            if (!doc || doc.user_id !== userId)
+                return null;
+            return doc.toResponse();
+        },
+        createImageDocument: async ({ userId, name, projectId, width, height, document }) => {
+            const doc = new ImageDocument({
+                user_id: userId,
+                project_id: projectId ?? "default",
+                name,
+                width,
+                height,
+                document: JSON.stringify(document)
+            });
+            await doc.save();
+            return doc.toResponse();
+        },
+        ...scriptModelInterfaces(),
+        ...storyboardModelInterfaces(),
+        ...entityModelInterfaces()
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@nodetool-ai/document-services",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.8.9-beta.2",
+  "description": "Shared document services for NodeTool hosts",
+  "type": "module",
+  "engines": {
+    "node": "24.22.1"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "node ../../scripts/build-typescript-workspace.mjs",
+    "test": "node ../../scripts/run-vitest.mjs run",
+    "lint": "node ../../scripts/run-tsc.mjs --noEmit"
+  },
+  "dependencies": {
+    "@nodetool-ai/models": "0.8.9-beta.2",
+    "@nodetool-ai/protocol": "0.8.9-beta.2",
+    "@nodetool-ai/runtime": "0.8.9-beta.2"
+  },
+  "devDependencies": {
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "^5.0.1",
+    "@types/node": "^22.0.0"
+  },
+  "exports": {
+    ".": {
+      "nodetool-dev": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nodetool-ai/nodetool.git",
+    "directory": "packages/document-services"
+  },
+  "homepage": "https://nodetool.ai",
+  "bugs": {
+    "url": "https://github.com/nodetool-ai/nodetool/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "nodetool",
+    "ai",
+    "workflow",
+    "workflow-automation",
+    "typescript",
+    "message-types",
+    "msgpack",
+    "protocol",
+    "websocket"
+  ]
+}