@nodetool-ai/agents 0.7.0-rc.22 → 0.8.1

package/dist/capabilities/storyboards.specs.js

@@ -0,0 +1,418 @@
+/**
+ * The `storyboards` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `storyboards.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `storyboards.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+import { DEFAULT_CONCURRENCY, MAX_CONCURRENCY } from "./concurrency.js";
+export const SHOT_TARGETS_SCHEMA = {
+    type: "array",
+    items: { type: "string" },
+    description: "Shots to render, each a shot id, 0-based index, or slug. Omit to render " +
+        "every shot that still needs this step."
+};
+export const LIST_STORYBOARDS_SCHEMA = {
+    type: "object",
+    properties: {
+        limit: { type: "number", description: "Max boards to return (default 20)." }
+    }
+};
+export const CREATE_STORYBOARD_SCHEMA = {
+    type: "object",
+    properties: {
+        name: {
+            type: "string",
+            description: "Name of the new storyboard."
+        },
+        brief: {
+            type: "string",
+            description: "Board brief. Defaults to empty."
+        },
+        style: {
+            type: "string",
+            description: "Style text appended to every shot prompt. Defaults to empty."
+        },
+        aspect_ratio: {
+            type: "string",
+            description: "Shot aspect ratio, e.g. '16:9' (default '16:9')."
+        },
+        project_id: {
+            type: "string",
+            description: "Project to create the storyboard in (default 'default')."
+        },
+        id: {
+            type: "string",
+            description: "Optional id. If a storyboard with this id already exists and you " +
+                "own it, that row is returned instead of creating a duplicate."
+        }
+    },
+    required: ["name"]
+};
+export const GET_STORYBOARD_SCHEMA = {
+    type: "object",
+    properties: {
+        storyboard_id: { type: "string", description: "Storyboard id." }
+    },
+    required: ["storyboard_id"]
+};
+export const RENDER_STILLS_SCHEMA = {
+    type: "object",
+    properties: {
+        storyboard_id: { type: "string", description: "Storyboard id." },
+        targets: SHOT_TARGETS_SCHEMA,
+        provider: {
+            type: "string",
+            description: "Provider id (from find_model). Defaults to the board's image model."
+        },
+        model: {
+            type: "string",
+            description: "Model id (from find_model). Defaults to the board's image model."
+        },
+        style: {
+            type: "string",
+            description: "Style text appended to every prompt. Defaults to the board's style."
+        },
+        stale_only: {
+            type: "boolean",
+            description: "Render only the selected shots whose current version is stale — " +
+                "recorded against a style, model, aspect ratio or prompt the shot no " +
+                "longer has. Omitted or false renders every selected shot."
+        },
+        concurrency: {
+            type: "number",
+            description: `Shots rendered in parallel (default ${DEFAULT_CONCURRENCY}, max ${MAX_CONCURRENCY}).`
+        }
+    },
+    required: ["storyboard_id"]
+};
+export const RENDER_CLIPS_SCHEMA = {
+    type: "object",
+    properties: {
+        storyboard_id: { type: "string", description: "Storyboard id." },
+        targets: SHOT_TARGETS_SCHEMA,
+        provider: {
+            type: "string",
+            description: "Provider id (from find_model). Defaults to the board's video model."
+        },
+        model: {
+            type: "string",
+            description: "Model id (from find_model). Defaults to the board's video model."
+        },
+        resolution: {
+            type: "string",
+            description: "Provider resolution hint, e.g. '720p'."
+        },
+        mode: {
+            type: "string",
+            enum: ["keyframe", "direct", "reference"],
+            description: "Override how the selected shots render, for this call only. " +
+                "'keyframe' animates each shot's still (image_to_video); 'direct' " +
+                "generates from the prompt with no still (text_to_video); 'reference' " +
+                "uses entity reference images (reference_to_video). Defaults " +
+                "to each shot's own render_mode, which defaults to 'keyframe'. Set " +
+                "the shot's render_mode with edit_storyboard to make it stick."
+        },
+        stale_only: {
+            type: "boolean",
+            description: "Render only the selected shots whose current version is stale — " +
+                "recorded against a style, model, aspect ratio or prompt the shot no " +
+                "longer has. Omitted or false renders every selected shot."
+        },
+        concurrency: {
+            type: "number",
+            description: `Shots rendered in parallel (default ${DEFAULT_CONCURRENCY}, max ${MAX_CONCURRENCY}).`
+        }
+    },
+    required: ["storyboard_id"]
+};
+export const REVISE_CLIP_SCHEMA = {
+    type: "object",
+    properties: {
+        storyboard_id: { type: "string", description: "Storyboard id." },
+        target: {
+            type: "string",
+            description: "Shot id, 0-based index, or slug."
+        },
+        instruction: {
+            type: "string",
+            description: "The change to make, phrased as a video edit prompt."
+        },
+        provider: { type: "string", description: "Provider id (from find_model)." },
+        model: { type: "string", description: "Model id (from find_model)." }
+    },
+    required: ["storyboard_id", "target", "instruction"]
+};
+export const ASSEMBLE_STORYBOARD_TIMELINE_SCHEMA = {
+    type: "object",
+    properties: {
+        storyboard_id: { type: "string", description: "Storyboard id." },
+        name: {
+            type: "string",
+            description: "Name for the sequence. Defaults to the storyboard's name."
+        },
+        fps: { type: "number", description: "Frame rate (default 30)." }
+    },
+    required: ["storyboard_id"]
+};
+export const EDIT_STORYBOARD_SCHEMA = {
+    type: "object",
+    properties: {
+        storyboard_id: { type: "string", description: "Storyboard id." },
+        ops: {
+            type: "array",
+            description: 'Operations in order. Each is {"op": <name>, ...arguments}: ' +
+                "add_shot {action, slug?, camera?, motion?, dialogue?, narration?, " +
+                "duration_seconds?, duration_source?, render_mode?, entity_ids?, " +
+                "location_id?, covered_by?, notes?, index?}, " +
+                "update_shot {target, ...same fields}, remove_shot {target}, " +
+                "reorder_shot {target, index}, move_shot {target, scene_id?, " +
+                "position}, duplicate_shot {target}, set_board {brief?, style?, " +
+                "aspect_ratio?, entity_ids?, image_model?, video_model?}, " +
+                "set_setup {brief?, genre?, stage?}, update_scene {scene_id, " +
+                "slugline?, lighting?}, create_scene {after_scene_id?}, " +
+                "merge_scene {scene_id}, set_style {entity_id? | style?}, " +
+                "select_version {target, kind, version}, delete_version {target, " +
+                "kind, version}, add_keyframe_version {target, asset_id, flip_of?}. " +
+                "move_shot is how a shot changes scene: `position` is 0-based inside " +
+                "the target scene and every shot is renumbered after, so a scene's " +
+                "shots stay contiguous. set_style with an entity_id applies that " +
+                "style entity as the board preset (it replaces any other style " +
+                "entity and its descriptor becomes the board style); with `style` it " +
+                "sets the descriptor alone. Versions are 0-based, oldest first. " +
+                "`target` is a shot id, its 0-based index, or its slug. " +
+                "covered_by {shot_id, start_seconds?, end_seconds?} says this shot's " +
+                "picture is a window into another shot's clip — how you record a " +
+                "generation whose fixed length covers several beats. The covered " +
+                "shot then reads as rendered, is skipped by the render selections, " +
+                "and assembles as that window. Pass null to undo it. " +
+                "image_model/video_model take a model object from find_model and " +
+                "become the board's defaults for render_storyboard_stills and " +
+                "render_storyboard_clips.",
+            items: { type: "object" }
+        }
+    },
+    required: ["storyboard_id", "ops"]
+};
+export const DIRECT_STORYBOARD_SCHEMA = {
+    type: "object",
+    properties: {
+        storyboard_id: { type: "string", description: "Storyboard id." },
+        redirect: {
+            type: "boolean",
+            description: "Required to run over a board that already has shots. Retained " +
+                "shots keep their ids, their rendered stills and clips, and their " +
+                "status, so a re-direct rewrites the direction without resetting the " +
+                "media. Without it a board with shots is refused."
+        },
+        shot_count: {
+            type: "number",
+            description: "How many shots to ask for (default 6)."
+        },
+        provider: {
+            type: "string",
+            description: "Provider id (from find_model). Defaults to the board's director model."
+        },
+        model: {
+            type: "string",
+            description: "Model id (from find_model). Defaults to the board's director model."
+        }
+    },
+    required: ["storyboard_id"]
+};
+export const EXTRACT_SCRIPT_SCHEMA = {
+    type: "object",
+    properties: {
+        storyboard_id: { type: "string", description: "Storyboard id." },
+        name: {
+            type: "string",
+            description: "Name for the created script. Defaults to the board's name + ' script'."
+        },
+        relink: {
+            type: "boolean",
+            description: "Re-project onto the script the board already links, instead of " +
+                "failing. Rewrites that script's lines and the board's line " +
+                "references; every take voiced from a changed line becomes stale."
+        }
+    },
+    required: ["storyboard_id"]
+};
+export const listStoryboardsSpec = {
+    name: "list_storyboards",
+    description: "List the caller's storyboards, newest first: id, name, shot count, how " +
+        "many shots have a still and a clip, and the timeline it was assembled " +
+        "into. Start here when the user names a board but not its id.",
+    inputSchema: LIST_STORYBOARDS_SCHEMA,
+    category: "read",
+    userMessage: () => "Listing storyboards"
+};
+export const createStoryboardSpec = {
+    name: "create_storyboard",
+    description: "Create a blank storyboard and return its id. This is the first step of " +
+        "directing one headlessly: create it, then add and rewrite shots with " +
+        "edit_storyboard. An open editor picks the new board up once you open it. " +
+        "Stills and clips stay empty — render them with render_storyboard_stills " +
+        "and render_storyboard_clips.",
+    inputSchema: CREATE_STORYBOARD_SCHEMA,
+    category: "write",
+    userMessage: (params) => {
+        const name = params["name"];
+        return typeof name === "string" && name.trim()
+            ? `Creating storyboard ${name}`
+            : "Creating storyboard";
+    }
+};
+export const getStoryboardSpec = {
+    name: "get_storyboard",
+    description: "Read one storyboard: brief, style, aspect ratio, the still/clip models it " +
+        "renders with, and every shot with its id, index, slug, action, camera, " +
+        "motion, duration, status, and whether it already has a still or a clip. " +
+        "`has_clip` counts a shot whose picture is a window into another shot's " +
+        "generation; `covered_by` says which shot and which window. " +
+        "Call this before rendering — the other tools address shots by these ids.",
+    inputSchema: GET_STORYBOARD_SCHEMA,
+    category: "read",
+    userMessage: (params) => `Reading storyboard ${String(params["storyboard_id"])}`
+};
+export const renderStoryboardStillsSpec = {
+    name: "render_storyboard_stills",
+    description: "Render keyframe stills for a storyboard's shots by calling the image " +
+        "model directly — no workflow is created or run. Each still is saved as an " +
+        "asset and becomes the shot's selected keyframe (previous stills are kept " +
+        "as versions). Omit `targets` to render every shot that has no still yet " +
+        "and is not set to render directly, so a whole board is one call. Stills " +
+        "are the cheap step: render them, look at them, then spend on clips.",
+    inputSchema: RENDER_STILLS_SCHEMA,
+    category: "write",
+    userMessage: (params) => {
+        const targets = params["targets"];
+        const count = Array.isArray(targets) ? `${targets.length} ` : "";
+        return `Rendering ${count}storyboard stills`;
+    }
+};
+export const renderStoryboardClipsSpec = {
+    name: "render_storyboard_clips",
+    description: "Render video clips for a storyboard's shots with the video model " +
+        "directly — no workflow is created or run. A shot renders the way its " +
+        "render_mode says: 'keyframe' (the default) animates its selected still " +
+        "with image_to_video, 'direct' generates from the prompt with " +
+        "text_to_video and needs no still; 'reference' uses entity reference images " +
+        "with reference_to_video. Pass `mode` to override for this " +
+        "call. Each clip is saved as an asset and attached to its shot (previous " +
+        "takes are kept as versions), leaving the shot 'rendered' and ready for " +
+        "assemble_storyboard_timeline. Omit `targets` to render every shot that " +
+        "still needs a clip and can render one — a shot covered by another " +
+        "shot's generation already has its picture and is skipped. " +
+        "A keyframe-mode shot with no " +
+        "still is reported, not rendered — run render_storyboard_stills first, or " +
+        "set its render_mode to 'direct' or 'reference'. This is the expensive step.",
+    inputSchema: RENDER_CLIPS_SCHEMA,
+    category: "write",
+    userMessage: (params) => {
+        const targets = params["targets"];
+        const count = Array.isArray(targets) ? `${targets.length} ` : "";
+        return `Rendering ${count}storyboard clips`;
+    }
+};
+export const reviseStoryboardClipSpec = {
+    name: "revise_storyboard_clip",
+    description: "Revise one shot's rendered clip with a text instruction ('make it darker, " +
+        "add rain') via video-to-video. Seeds the shot's current clip and swaps the " +
+        "result in as the selected take, keeping the previous one as a version. The " +
+        "shot must already have a clip.",
+    inputSchema: REVISE_CLIP_SCHEMA,
+    category: "write",
+    userMessage: (params) => `Revising shot ${String(params["target"])}`
+};
+export const assembleStoryboardTimelineSpec = {
+    name: "assemble_storyboard_timeline",
+    description: "Lay a storyboard's rendered clips end to end into a timeline sequence and " +
+        "save it, without building a workflow. Clips keep their link to the shot " +
+        "they came from, and the screenplay's narration and music become draft " +
+        "audio clips the timeline can generate on demand. When the board links a " +
+        "script, each shot is instead as long as the takes it covers and every " +
+        "voiced line gets its own voiceover clip. Shots with no rendered clip, " +
+        "and lines with no take, are skipped and listed. Re-running rebuilds the " +
+        "same sequence in place, keeping tracks the board does not own. Validate " +
+        "the result with validate_timeline before rendering.",
+    inputSchema: ASSEMBLE_STORYBOARD_TIMELINE_SCHEMA,
+    category: "write",
+    userMessage: (params) => `Assembling storyboard ${String(params["storyboard_id"])} into a timeline`
+};
+export const editStoryboardSpec = {
+    name: "edit_storyboard",
+    description: "Edit a saved storyboard's shot list headlessly: add, rewrite, remove and " +
+        "reorder shots, and set the board's brief, style, aspect ratio and " +
+        "entities. Operations run in order against the stored document and the " +
+        "result is saved; an open board picks the change up live. Rendering stays " +
+        "with render_storyboard_stills / render_storyboard_clips — this tool " +
+        "directs, it does not spend. Call get_storyboard first for shot ids.",
+    inputSchema: EDIT_STORYBOARD_SCHEMA,
+    category: "write",
+    userMessage: (params) => {
+        const count = Array.isArray(params["ops"]) ? params["ops"].length : 0;
+        return `Editing storyboard ${String(params["storyboard_id"])} (${count} ops)`;
+    }
+};
+export const extractScriptFromStoryboardSpec = {
+    name: "extract_script_from_storyboard",
+    description: "Project a storyboard's spoken words into a new script resource and link " +
+        "the two: every shot's dialogue and narration becomes a script line, the " +
+        "character entity a shot names becomes a cast member, and each shot keeps " +
+        "the ids of the lines it covers. The board keeps its visuals, the script " +
+        "owns the words from here on — voice them with voice_script_lines. Fails " +
+        "when the board already links a script; pass relink: true to re-project " +
+        "onto that script instead.",
+    inputSchema: EXTRACT_SCRIPT_SCHEMA,
+    category: "write",
+    userMessage: (params) => `Extracting a script from storyboard ${String(params["storyboard_id"])}`
+};
+export const directStoryboardSpec = {
+    name: "direct_storyboard",
+    description: "Run the Director over a storyboard's brief, genre and style, and write " +
+        "the screenplay it produces onto the board: scenes with sluglines and " +
+        "lighting, and shots with action, camera and motion. This is how a board " +
+        "gets its shot list without writing each one by hand — set the brief with " +
+        "edit_storyboard's set_setup first. Pass redirect: true to re-direct a " +
+        "board that already has shots; retained shots keep their ids and their " +
+        "rendered media. Renders nothing: stills and clips stay with " +
+        "render_storyboard_stills / render_storyboard_clips.",
+    inputSchema: DIRECT_STORYBOARD_SCHEMA,
+    category: "write",
+    userMessage: (params) => `Directing storyboard ${String(params["storyboard_id"])}`
+};
+export const deleteStoryboardSpec = {
+    name: "delete_storyboard",
+    description: "Delete a storyboard you own, together with its saved version history. " +
+        "This cannot be undone. A storyboard belonging to another user is reported " +
+        "as missing.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            storyboard_id: {
+                type: "string",
+                description: "The storyboard to delete. You must own it."
+            }
+        },
+        required: ["storyboard_id"]
+    },
+    category: "write",
+    userMessage: (params) => `Deleting storyboard ${params["storyboard_id"]}`
+};
+/** Every spec this module declares, in declaration order. */
+export const storyboardsSpecs = [
+    listStoryboardsSpec,
+    createStoryboardSpec,
+    getStoryboardSpec,
+    renderStoryboardStillsSpec,
+    renderStoryboardClipsSpec,
+    reviseStoryboardClipSpec,
+    assembleStoryboardTimelineSpec,
+    editStoryboardSpec,
+    directStoryboardSpec,
+    extractScriptFromStoryboardSpec,
+    deleteStoryboardSpec
+];
+//# sourceMappingURL=storyboards.specs.js.map

package/dist/capabilities/storyboards.specs.js.map

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

package/dist/capabilities/threads.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The `threads` capability module — the chat history, read-only.
+ *
+ * Every other surface an agent can inspect headlessly (workflows, jobs,
+ * scripts, timelines, sketches) had a capability; the conversations themselves
+ * had none, so "what did we say last time" was unanswerable without opening the
+ * database by hand. These three read `Thread` and `Message` from
+ * `@nodetool-ai/models` in-process — no server, no HTTP.
+ *
+ * Read-only on purpose. Chat history is written by the runners that own a turn
+ * (the websocket chat runner, the CLI turn); a tool that let an agent rewrite
+ * what was said would make the transcript untrustworthy as evidence.
+ *
+ * Ownership is the same rule the REST routes apply: a thread or message
+ * belonging to someone else reads as missing rather than as forbidden.
+ */
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+declare const listThreads: CapabilityExport;
+declare const getThread: CapabilityExport;
+declare const getMessage: CapabilityExport;
+/** Every thread capability, in declaration order. */
+export declare const THREAD_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { listThreads, getThread, getMessage };
+//# sourceMappingURL=threads.d.ts.map

package/dist/capabilities/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/capabilities/threads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAsHpB,QAAA,MAAM,WAAW,EAAE,gBAoClB,CAAC;AAEF,QAAA,MAAM,SAAS,EAAE,gBAgChB,CAAC;AAEF,QAAA,MAAM,UAAU,EAAE,gBAyCjB,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAI1D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC"}