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

package/dist/jtbd/registry.js

@@ -0,0 +1,451 @@
+/**
+ * The catalogue of jobs an agent is asked to get done.
+ *
+ * These are **end-to-end jobs**, not capability checks. Each is stated the way
+ * a user would state it, handed to the agent as an objective in the user's own
+ * words, and graded on whether the world it left behind is one the user would
+ * accept. No job names a tool: what tool to reach for, and in what order, is
+ * precisely what is under test.
+ *
+ * Two rules keep the catalogue honest.
+ *
+ * **Grade the outcome, not the route.** An outcome check asks "is there a
+ * connected graph that produces an output" — never "was `ui_connect_nodes`
+ * called". A model that finds a shorter route than the one we imagined has done
+ * the job, and a catalogue that fails it is measuring our imagination.
+ *
+ * **Every job states its `so I can`.** The optimizer quotes the statement back
+ * to a model when asking whether a run achieved anything, and an objective with
+ * no stated purpose gives it nothing to judge against.
+ *
+ * The worlds are the same headless bridges the `tool-loop` eval suites drive,
+ * composed rather than reimplemented, so a job cannot drift from the tool
+ * contract those suites already pin.
+ */
+import { createToolLoopBridge } from "../evals/tool-loop-bridge.js";
+import { TOOL_LOOP_NODE_CATALOG } from "../evals/tool-loop-cases.js";
+import { createJsScriptToolBridge } from "../evals/surfaces/js-script.js";
+import { createModel3DToolBridge } from "../evals/surfaces/model3d.js";
+import { createScriptToolBridge } from "../evals/surfaces/script.js";
+import { createSketchToolBridge } from "../evals/surfaces/sketch.js";
+import { createExplainerStoryboardToolBridge, createStoryboardToolBridge } from "../evals/surfaces/storyboard.js";
+import { createTimelineToolBridge, previewedAfterLastEdit, staggerSpanFitsClip, staggerUnitsOf } from "../evals/surfaces/timeline.js";
+import { findSystemSkill } from "../system-skills.js";
+import { defineJob } from "./run.js";
+const graphWorld = () => createToolLoopBridge({ nodeMetadata: TOOL_LOOP_NODE_CATALOG });
+const EXPLAINER_STORYBOARD_PROMPT = `${findSystemSkill("explainer-storyboard")?.content ?? ""}
+
+Evaluation adapter: these entities already exist. Call list_entities and reuse
+their ids: Lumen Style, Support Lead, Lumen Dashboard Mock, Glass Funnel. Make
+a 60-second planned board only. Persist it with create_storyboard, set_board
+entity_ids, and one add_shot op per beat. Use exact ordered slugs: problem,
+stakes, shift, mechanism-1, mechanism-2, outcome-proof, cta, sign-off. Every
+action names [Lumen Style]; dashboard mechanism actions say mock; proof includes
+[CLIENT INPUT NEEDED]. Do not render or assemble a timeline.`;
+const EXPLAINER_ENTITY_IDS = [
+    "lumen-style",
+    "support-lead",
+    "lumen-dashboard-mock",
+    "glass-funnel"
+];
+const MUSIC_VIDEO_ENTITIES = [
+    { id: "neon-style", name: "Neon Style", kind: "style" },
+    { id: "nova", name: "Nova", kind: "character" },
+    { id: "pool", name: "Drained Pool", kind: "location" },
+    { id: "phone", name: "Red Phone", kind: "prop" }
+];
+const COMMERCIAL_ENTITIES = [
+    { id: "warp-style", name: "WARP Style", kind: "style" },
+    { id: "runner", name: "Runner", kind: "character" },
+    { id: "warp-can", name: "WARP Can", kind: "prop" },
+    { id: "studio", name: "Night Studio", kind: "location" }
+];
+/** Nodes reachable from some input by following edges — the connected core. */
+function wiredNodeCount(state) {
+    const wired = new Set();
+    for (const edge of state.edges) {
+        wired.add(edge.source);
+        wired.add(edge.target);
+    }
+    return wired.size;
+}
+export const JOBS_TO_BE_DONE = [
+    defineJob({
+        id: "caption-titles-picture-locked",
+        statement: "When my picture is locked, I want one readable, consistent text layer, so I can help the audience follow the cut without missing the action.",
+        surfaces: ["timeline"], difficulty: "long-horizon", maxIterations: 16, expectedToolCalls: 14,
+        objective: "The open vertical 1080x1920 timeline has three picture clips: Host at 0-5000ms, Demo at 5000-10000ms, and End at 10000-15000ms. Add a consistent text layer: title 'WORK LESS. KNOW MORE.' for at least 2000ms, lower-third 'Maya Chen' for 3000ms after the host appears, caption 'Everything you need, in one place.' with readable duration, and a single CTA 'Try Lumen' at the end. Put scrims behind live-picture text and animate every text clip in and out. Do not render.",
+        createBridge: () => createTimelineToolBridge({ width: 1080, height: 1920, tracks: [{ type: "video", name: "Picture" }], clips: [{ name: "Host", trackIndex: 0, startMs: 0, durationMs: 5000 }, { name: "Demo", trackIndex: 0, startMs: 5000, durationMs: 5000 }, { name: "End", trackIndex: 0, startMs: 10000, durationMs: 5000 }] }),
+        outcomes: [
+            { name: "text-layer", describe: "Titles and captions are on overlay or subtitle tracks.", test: (s) => s.tracks.some((t) => t.type === "overlay") && s.clips.filter((c) => c.mediaType === "text").length >= 4 },
+            { name: "readable-animated", describe: "Every text clip stays readable and has entry and exit motion.", test: (s) => s.clips.filter((c) => c.mediaType === "text").every((c) => c.durationMs >= 1200 && c.animations.some((a) => a.role === "in") && c.animations.some((a) => a.role === "out")) }
+        ]
+    }),
+    defineJob({
+        id: "motion-title-sequence",
+        statement: "When I have picture and a music bed, I want a title sequence that moves with the track, so I can hand over a cut that looks designed instead of typed over.",
+        surfaces: ["timeline"], difficulty: "long-horizon", maxIterations: 18, expectedToolCalls: 14,
+        objective: "This vertical cut has three shots roughly laid out over a 120 BPM music bed that starts at zero. Open it with a title sequence that lands on the beat, put 'Maya Chen' under the second shot as a lower third, and finish on an end card that says 'SEE YOU THERE'. Keep each title together as one unit I can move later, and have the type move on and off rather than pop in and sit there. Do not render.",
+        systemPrompt: `${findSystemSkill("motion-graphics")?.content ?? ""}\nEvaluation adapter: this surface exposes the edits as ui_timeline_* tools — read get_timeline as ui_timeline_get_state and each edit_timeline op as the matching tool. preview_timeline_frame is here and reports the layer stack rather than pixels. There is no rendering and no version history to snapshot.`,
+        createBridge: () => createTimelineToolBridge({ preview: true, width: 1080, height: 1920, tracks: [{ type: "video", name: "Picture" }, { type: "audio", name: "Music" }], clips: [{ name: "Shot 1", trackIndex: 0, mediaType: "video", startMs: 0, durationMs: 4180 }, { name: "Shot 2", trackIndex: 0, mediaType: "video", startMs: 4180, durationMs: 5150 }, { name: "Shot 3", trackIndex: 0, mediaType: "video", startMs: 9330, durationMs: 5670 }, { name: "Music", trackIndex: 1, mediaType: "audio", startMs: 0, durationMs: 15000 }] }),
+        outcomes: [
+            // 120 BPM is a beat every 500ms; 60ms is the tolerance a cut reads as
+            // landing on one. Markers are a note to self, so the picture has to sit
+            // on the grid; any markers written down have to agree with it.
+            { name: "on-the-beat", describe: "Every picture boundary sits on the 120 BPM grid, and so does any marker.", test: (s) => { const onGrid = (ms) => Math.abs(ms - Math.round(ms / 500) * 500) <= 60; const picture = s.clips.filter((c) => c.mediaType === "video"); return picture.length > 0 && picture.every((c) => onGrid(c.startMs) && onGrid(c.startMs + c.durationMs)) && s.markers.every((m) => onGrid(m.timeMs)); } },
+            // An empty group is a movable thing holding nothing. The title itself
+            // has to be inside it, or be part of a composition.
+            { name: "titles-are-units", describe: "A title is one movable thing: text inside a group, or a composition.", test: (s) => { const groups = new Set(s.documentClips.filter((c) => c.mediaType === "group").map((c) => c.id)); return s.documentClips.some((c) => c.mediaType === "text" && (Boolean(c.compositionId) || (c.parentId !== undefined && groups.has(c.parentId)))); } },
+            { name: "type-moves-and-fits", describe: "Every text clip enters and exits, and a staggered entrance finishes inside its clip.", test: (s) => { const texts = s.documentClips.filter((c) => c.mediaType === "text"); return texts.length >= 2 && texts.every((c) => (c.animations ?? []).some((a) => a.role === "in") && (c.animations ?? []).some((a) => a.role === "out")) && texts.some((c) => (c.animations ?? []).some((a) => a.stagger && staggerUnitsOf(c, a.stagger.unit, { width: s.width, height: s.height }) >= 2)) && texts.every((c) => (c.animations ?? []).every((a) => staggerSpanFitsClip(c, a, { width: s.width, height: s.height }))); } },
+            { name: "looked-at-it", describe: "The last edit was followed by a look at the frame.", test: (s) => previewedAfterLastEdit(s.toolLog) }
+        ]
+    }),
+    defineJob({
+        id: "commercial-beat-sheet-from-brief",
+        statement: "When I have a product brief, I want a timed commercial board with consistent product references, so I can approve the spot before production.",
+        surfaces: ["storyboard"], difficulty: "long-horizon", maxIterations: 16, expectedToolCalls: 10,
+        objective: "Create a 30-second vertical commercial for WARP energy drink. Brand: electric, direct, nocturnal. Audience: late-night creators. Core pain: fading focus at midnight. USP: [CLIENT INPUT NEEDED]. CTA: Try WARP. Use Runner, WARP Can, Night Studio, and WARP Style. Plan hook, brand landing, problem, solution, proof, CTA, reiteration, closing. No rendering.",
+        systemPrompt: `${findSystemSkill("commercial-beat-sheet")?.content ?? ""}\nEvaluation adapter: the roster is already approved. Do not stop after list_entities: in this same turn create a board, attach all ids with set_board, and add exact ordered 8 beats: hook, brand-landing, problem, solution, proof, cta, reiteration, closing. Total 30 seconds. Every action names [WARP Style], proof uses [CLIENT INPUT NEEDED], and hook does not name WARP Can.`,
+        createBridge: () => createExplainerStoryboardToolBridge(COMMERCIAL_ENTITIES),
+        outcomes: [
+            { name: "timed-arc", describe: "Eight ordered beats total 30 seconds.", test: (s) => s.shots.map((x) => x.slug).join(",") === "hook,brand-landing,problem,solution,proof,cta,reiteration,closing" && s.shots.reduce((n, x) => n + x.durationSeconds, 0) === 30 },
+            { name: "truthful-consistent", describe: "The product roster is persisted, style holds, and unknown proof is marked.", test: (s) => s.entityIds.length === 4 && s.shots.every((x) => x.action.includes("[WARP Style]")) && s.shots.some((x) => x.action.includes("[CLIENT INPUT NEEDED]")) && !s.shots[0]?.action.includes("[WARP Can]") && s.savable }
+        ]
+    }),
+    defineJob({
+        id: "music-video-treatment-from-track",
+        statement: "When I have a mapped track, I want a beat-synced treatment with consistent artist references, so I can plan a shoot that cuts to the music.",
+        surfaces: ["storyboard"], difficulty: "long-horizon",
+        objective: "Create a planned music-video board for Nova's synthpop track Neon Tide. BPM 120, 4/4, 0:32. Section map: intro 0:00-0:08, verse 0:08-0:16, chorus 0:16-0:24, outro 0:24-0:32. Performance/narrative ratio 60/40. Use the artist Nova, Drained Pool, Red Phone, and Neon Style. The chorus downbeat is the biggest event. There are no confirmed release facts or lyrics, so use [ARTIST INPUT NEEDED] where needed. Do not render.",
+        maxIterations: 14, expectedToolCalls: 8,
+        systemPrompt: `${findSystemSkill("music-video-treatment")?.content ?? ""}\nEvaluation adapter: list and reuse existing entities, create a board, attach all entity ids with set_board, then add exactly intro, verse, chorus, outro in order. Each is 8 seconds (four bars at 120 BPM in 4/4); every action names [Neon Style], chorus names [Nova] and its downbeat event, and outro echoes intro.`,
+        createBridge: () => createExplainerStoryboardToolBridge(MUSIC_VIDEO_ENTITIES),
+        outcomes: [
+            { name: "bar-grid", describe: "Four four-bar sections total 32 seconds.", test: (s) => s.shots.map((x) => x.slug).join(",") === "intro,verse,chorus,outro" && s.shots.every((x) => x.durationSeconds === 8) },
+            { name: "artist-and-hook", describe: "The artist sells the chorus hook on its downbeat.", test: (s) => Boolean(s.shots.find((x) => x.slug === "chorus")?.action.includes("[Nova]") && s.shots.find((x) => x.slug === "chorus")?.action.toLowerCase().includes("downbeat")) },
+            { name: "consistent-roster", describe: "The board persists all production entities and applies the style to every section.", test: (s) => s.entityIds.length === 4 && s.shots.every((x) => x.action.includes("[Neon Style]")) && s.savable }
+        ]
+    }),
+    defineJob({
+        id: "workflow-from-prompt",
+        statement: "When I describe a text transformation in a sentence, I want a runnable workflow built for me, so I can use it without learning the node catalog.",
+        surfaces: ["workflow-authoring"],
+        difficulty: "smoke",
+        objective: "I need a workflow that takes a person's name as input and gives me back a greeting for them. Build it for me.",
+        expectedToolCalls: 8,
+        createBridge: graphWorld,
+        outcomes: [
+            {
+                name: "has-input",
+                describe: "The workflow takes a value in.",
+                test: (s) => s.nodes.some((n) => n.type.startsWith("nodetool.input."))
+            },
+            {
+                name: "has-output",
+                describe: "The workflow surfaces a result.",
+                test: (s) => s.nodes.some((n) => n.type.startsWith("nodetool.output."))
+            },
+            {
+                name: "connected",
+                describe: "Input and output are actually wired together.",
+                test: (s) => s.edges.length > 0 && wiredNodeCount(s) >= 2
+            }
+        ]
+    }),
+    defineJob({
+        id: "workflow-with-llm-step",
+        statement: "When a transformation needs judgement rather than string handling, I want the workflow to call a model, so I can automate work that has no formula.",
+        surfaces: ["workflow-authoring"],
+        difficulty: "standard",
+        objective: "Build me a workflow that takes a customer complaint as input, has an LLM write a polite reply to it, and returns that reply.",
+        expectedToolCalls: 10,
+        createBridge: graphWorld,
+        outcomes: [
+            {
+                name: "uses-agent",
+                describe: "An LLM step does the writing.",
+                test: (s) => s.nodes.some((n) => n.type.startsWith("nodetool.agents."))
+            },
+            {
+                name: "end-to-end",
+                describe: "Input, the LLM step and output are one connected chain.",
+                test: (s) => s.nodes.some((n) => n.type.startsWith("nodetool.input.")) &&
+                    s.nodes.some((n) => n.type.startsWith("nodetool.output.")) &&
+                    wiredNodeCount(s) >= 3
+            }
+        ]
+    }),
+    defineJob({
+        id: "script-cast-and-voice",
+        statement: "When I have a scene in my head, I want it written down with the right speakers attached, so I can hear it read back.",
+        surfaces: ["script"],
+        difficulty: "standard",
+        objective: "Write me a short two-hander: a nervous intern and a tired manager, four lines between them, at the coffee machine. Give each character their own voice.",
+        expectedToolCalls: 12,
+        createBridge: () => createScriptToolBridge(),
+        outcomes: [
+            {
+                name: "two-speakers",
+                describe: "Both characters exist in the cast.",
+                test: (s) => s.cast.length >= 2
+            },
+            {
+                name: "lines-written",
+                describe: "There are at least four lines.",
+                test: (s) => s.lines.length >= 4
+            },
+            {
+                name: "lines-attributed",
+                describe: "Every line belongs to a speaker.",
+                test: (s) => s.lines.length > 0 && s.lines.every((l) => l.speakerId !== null)
+            },
+            {
+                name: "voices-assigned",
+                describe: "Each character has a voice, so the script can be read back.",
+                test: (s) => s.cast.every((c) => c.hasVoice)
+            }
+        ]
+    }),
+    defineJob({
+        id: "storyboard-a-scene",
+        statement: "When I have a scene to shoot, I want it broken into shots with the action described, so I can see the coverage before I spend on renders.",
+        surfaces: ["storyboard"],
+        difficulty: "standard",
+        objective: "Board this for me: a courier bikes through rain to deliver a package, and the person opening the door is not who they expected. Five shots, each with the action written out and a length on it.",
+        expectedToolCalls: 14,
+        createBridge: () => createStoryboardToolBridge(),
+        outcomes: [
+            {
+                name: "five-shots",
+                describe: "The board has five shots.",
+                test: (s) => s.shots.length >= 5
+            },
+            {
+                name: "action-written",
+                describe: "Every shot says what happens in it.",
+                test: (s) => s.shots.length > 0 && s.shots.every((shot) => shot.action.trim() !== "")
+            },
+            {
+                name: "savable",
+                describe: "The board would survive a save — it is a real document.",
+                test: (s) => s.savable
+            }
+        ]
+    }),
+    defineJob({
+        id: "explainer-storyboard-from-brief",
+        statement: "When I have a confirmed product brief, I want a truthful, shootable explainer board with consistent visual references, so I can teach the product before spending on renders.",
+        surfaces: ["storyboard"],
+        difficulty: "long-horizon",
+        objective: "Create a 60-second shootable explainer storyboard for Lumen, a SaaS product for support leads. Brand traits: calm, precise, practical. Audience: non-technical support leads. Core problem: agents hunt through scattered customer context before answering. The shift: every case arrives with its relevant history in one place. How it works: connect the helpdesk, retrieve the customer's prior conversations, then draft a reply for human review. CTA: Start a Lumen trial. Platform: landing page. Tone: confident and plain. Use a clean soft-3D style, a Lumen dashboard mock, and one translucent glass funnel as the single metaphor. There are no confirmed metrics, integrations beyond the helpdesk, customer claims, or real screenshots. Plan the problem, stakes, shift, two mechanism beats, outcome/proof, CTA, and sign-off. Make every shot's action name the visible entities in brackets, include the style entity in every shot, make UI mechanism shots explicitly labelled mock, and use [CLIENT INPUT NEEDED] for proof. Do not render or assemble a timeline.",
+        expectedToolCalls: 14,
+        maxIterations: 18,
+        systemPrompt: EXPLAINER_STORYBOARD_PROMPT,
+        createBridge: () => createExplainerStoryboardToolBridge(),
+        outcomes: [
+            {
+                name: "teaching-arc",
+                describe: "The board covers the problem, shift, two mechanism steps, proof, CTA, and sign-off.",
+                test: (s) => {
+                    return s.shots.length === 8 && s.shots.map((shot) => shot.slug).join(",") === [
+                        "problem",
+                        "stakes",
+                        "shift",
+                        "mechanism-1",
+                        "mechanism-2",
+                        "outcome-proof",
+                        "cta",
+                        "sign-off"
+                    ].join(",");
+                }
+            },
+            {
+                name: "runtime-budget",
+                describe: "The planned beats total exactly 60 seconds.",
+                test: (s) => s.shots.length >= 7 &&
+                    s.shots.every((shot) => typeof shot.durationSeconds === "number") &&
+                    s.shots.reduce((total, shot) => total + (shot.durationSeconds ?? 0), 0) === 60
+            },
+            {
+                name: "entity-consistency",
+                describe: "Every shot names its visual references, including the shared style.",
+                test: (s) => s.entityIds.length === 4 &&
+                    EXPLAINER_ENTITY_IDS.every((id) => s.entityIds.includes(id)) &&
+                    s.shots.every((shot) => shot.action.includes("[Lumen Style]")) &&
+                    ["Support Lead", "Lumen Dashboard Mock", "Glass Funnel"].every((name) => s.shots.some((shot) => shot.action.includes(`[${name}]`))) &&
+                    s.shots.filter((shot) => shot.slug.startsWith("mechanism-")).every((shot) => shot.action.toLowerCase().includes("mock"))
+            },
+            {
+                name: "truthful-proof",
+                describe: "Unconfirmed proof remains marked for client input.",
+                test: (s) => s.shots.some((shot) => shot.action.includes("[CLIENT INPUT NEEDED]"))
+            },
+            {
+                name: "savable",
+                describe: "The board would survive a save as a real document.",
+                test: (s) => s.created && s.savable
+            }
+        ]
+    }),
+    defineJob({
+        id: "timeline-assemble-cut",
+        statement: "When I have footage and a music bed, I want them laid out on separate tracks in the right order, so I can watch a rough cut.",
+        surfaces: ["timeline"],
+        difficulty: "standard",
+        objective: "Put together a rough cut for me: three video shots back to back with no gaps, and a music track running underneath the whole thing.",
+        expectedToolCalls: 14,
+        createBridge: () => createTimelineToolBridge(),
+        outcomes: [
+            {
+                name: "separate-tracks",
+                describe: "Picture and music are on their own tracks.",
+                test: (s) => s.tracks.some((t) => t.type === "video") &&
+                    s.tracks.some((t) => t.type === "audio")
+            },
+            {
+                name: "three-shots",
+                describe: "Three picture clips are on the timeline.",
+                test: (s) => {
+                    const video = new Set(s.tracks.filter((t) => t.type === "video").map((t) => t.id));
+                    return s.clips.filter((c) => video.has(c.trackId)).length >= 3;
+                }
+            },
+            {
+                name: "no-gaps",
+                describe: "The picture clips run back to back, with no black between.",
+                test: (s) => {
+                    const video = new Set(s.tracks.filter((t) => t.type === "video").map((t) => t.id));
+                    const shots = s.clips
+                        .filter((c) => video.has(c.trackId))
+                        .sort((a, b) => a.startMs - b.startMs);
+                    return shots.every((clip, i) => {
+                        if (i === 0)
+                            return true;
+                        const prev = shots[i - 1];
+                        if (prev === undefined)
+                            return false;
+                        return clip.startMs <= prev.startMs + prev.durationMs;
+                    });
+                }
+            }
+        ]
+    }),
+    defineJob({
+        id: "sketch-layered-artwork",
+        statement: "When I want a piece of artwork I can revise later, I want it drawn on separate layers, so I can change the background without repainting the subject.",
+        surfaces: ["sketch"],
+        difficulty: "standard",
+        objective: "Draw me a simple landscape — sky, hills, and a sun. Keep each part on its own layer so I can adjust them separately afterwards, and name the layers for what they hold.",
+        maxIterations: 20,
+        expectedToolCalls: 20,
+        createBridge: () => createSketchToolBridge(),
+        outcomes: [
+            {
+                name: "layered",
+                describe: "The artwork is on three or more named layers.",
+                test: (s) => s.layers.length >= 3
+            },
+            {
+                name: "named-layers",
+                describe: "The layers are named for what they hold.",
+                test: (s) => s.layers.length > 0 &&
+                    s.layers.every((l) => l.name.trim() !== "" && !/^Layer \d+$/.test(l.name))
+            },
+            {
+                name: "actually-drawn",
+                describe: "Something was painted, not just set up.",
+                test: (s) => s.strokedFraction > 0
+            }
+        ]
+    }),
+    defineJob({
+        id: "model3d-compose-scene",
+        statement: "When I need a placeholder set for a shot, I want primitives arranged and lit, so I can block the camera before anyone models anything.",
+        surfaces: ["model3d"],
+        difficulty: "standard",
+        objective: "Block out a simple scene for me: a table with two objects sitting on top of it, and a light so the shot is not black. Name things for what they are.",
+        expectedToolCalls: 12,
+        createBridge: () => createModel3DToolBridge(),
+        outcomes: [
+            {
+                name: "has-objects",
+                describe: "There is a table and two things on it.",
+                test: (s) => s.objects.filter((o) => !o.type.toLowerCase().includes("light"))
+                    .length >= 3
+            },
+            {
+                name: "has-light",
+                describe: "The scene is lit.",
+                test: (s) => s.objects.some((o) => o.type.toLowerCase().includes("light"))
+            },
+            {
+                name: "stacked",
+                describe: "The objects sit above the table rather than inside it.",
+                test: (s) => {
+                    const solids = s.objects.filter((o) => !o.type.toLowerCase().includes("light"));
+                    const heights = solids.map((o) => o.position[1]);
+                    return new Set(heights).size >= 2;
+                }
+            }
+        ]
+    }),
+    defineJob({
+        id: "jsscript-write-and-test",
+        statement: "When I have a data-shaping step no node covers, I want a script written and proved against examples, so I can trust it in a workflow.",
+        surfaces: ["jsscript"],
+        difficulty: "standard",
+        objective: "Write me a script that takes a list of numbers and gives back a running total. Save some test cases with it so I can see it works.",
+        expectedToolCalls: 12,
+        createBridge: () => createJsScriptToolBridge(),
+        outcomes: [
+            {
+                name: "declares-ports",
+                describe: "The script takes something in and gives something back.",
+                test: (s) => s.inputs.length >= 1 && s.outputs.length >= 1
+            },
+            {
+                name: "valid",
+                describe: "The script passes the static check.",
+                test: (s) => s.valid
+            },
+            {
+                name: "tested",
+                describe: "It carries test cases proving it works.",
+                test: (s) => s.tests.length >= 1
+            }
+        ]
+    }),
+    defineJob({
+        id: "script-to-storyboard-handoff",
+        statement: "When a script is written, I want a board derived from it that still points back at the lines, so I can shoot it without retyping the scene.",
+        surfaces: ["script", "storyboard"],
+        difficulty: "long-horizon",
+        objective: "Here is what I need: write a short scene of four lines between two characters, then turn it into a storyboard where each shot covers the lines it is showing.",
+        maxIterations: 24,
+        expectedToolCalls: 22,
+        createBridge: () => createScriptToolBridge(),
+        outcomes: [
+            {
+                name: "scene-written",
+                describe: "The scene exists with four attributed lines.",
+                test: (s) => s.lines.length >= 4 && s.lines.every((l) => l.speakerId !== null)
+            },
+            {
+                name: "board-derived",
+                describe: "A storyboard was derived from that script.",
+                test: (s) => s.storyboardId !== null && s.derivedShots.length > 0
+            },
+            {
+                name: "linkage-kept",
+                describe: "The shots still say which lines they cover — the handoff kept the link.",
+                test: (s) => s.derivedShots.length > 0 &&
+                    s.derivedShots.some((shot) => shot.scriptLineIds.length > 0)
+            }
+        ]
+    })
+];
+/** Look one up by id. */
+export function findJob(id) {
+    return JOBS_TO_BE_DONE.find((job) => job.id === id);
+}
+//# sourceMappingURL=registry.js.map

package/dist/jtbd/registry.js.map

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

package/dist/jtbd/run.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Running a job and recording everything the run produced.
+ *
+ * The loop itself is {@link runToolLoop}, unchanged — a job is not a new way to
+ * drive a model, it is a new thing to ask of one and a fuller record of what
+ * came back. What this file adds is the record: the transcript, the outcome
+ * checks in the user's own terms, and the derived friction.
+ *
+ * Jobs are heterogeneous — a timeline job grades a cut, a sketch job grades
+ * pixels — so {@link defineJob} closes over each job's state type and hands the
+ * runner a `start()` that builds a world and knows how to grade it. The runner
+ * never sees a surface's state, so nothing here is cast.
+ */
+import type { BaseProvider } from "@nodetool-ai/runtime";
+import type { HeadlessTool } from "../evals/tool-loop-bridge.js";
+import type { JobRunReport, JobSuiteReport, JobToBeDone } from "./types.js";
+/** How a graded outcome check came out. */
+export interface OutcomeResult {
+    name: string;
+    describe: string;
+    passed: boolean;
+}
+/**
+ * A job with its surface state type sealed inside. The runner drives this; the
+ * registry is a list of these.
+ */
+export interface ErasedJob {
+    id: string;
+    statement: string;
+    surfaces: string[];
+    difficulty: JobToBeDone["difficulty"];
+    objective: string;
+    systemPrompt?: string;
+    maxIterations?: number;
+    needsModelProviders?: boolean;
+    expectedToolCalls?: number;
+    /** Names of the outcome checks, for `--list` without building a world. */
+    outcomeNames: string[];
+    /**
+     * Build a fresh world for one run and return both its tools and the grader
+     * that reads the state those tools left behind.
+     */
+    start: () => {
+        tools: HeadlessTool[];
+        grade: () => OutcomeResult[];
+    };
+}
+/** Seal a job's state type. The only way a job enters the registry. */
+export declare function defineJob<TFinal>(job: JobToBeDone<TFinal>): ErasedJob;
+/** The prompt under test when a job names none. */
+export declare const DEFAULT_JOB_SYSTEM_PROMPT = "You are an agent operating NodeTool through its tools.\n\nGet the user's job done end to end. Discover what a tool does before guessing at\nits arguments, read each result before the next call, and stop calling tools once\nthe job is done \u2014 then say in one line what you produced.\n\nFor a workflow-authoring job, end to end requires a `nodetool.output.*` node\nwired to the final value. Do not call the workflow done until it surfaces the\nrequested result.";
+export interface RunJobOptions {
+    provider: BaseProvider;
+    model: string;
+    /** Configured providers; a job needing them is skipped when absent. */
+    providers?: Record<string, BaseProvider>;
+    /** Turn cap when the job declares none. */
+    maxIterations?: number;
+    /** Override the prompt under test for every job (a job's own wins). */
+    systemPrompt?: string;
+    signal?: AbortSignal;
+    onEvent?: (line: string) => void;
+}
+export declare function runJob(job: ErasedJob, opts: RunJobOptions): Promise<JobRunReport>;
+export interface RunJobSuiteOptions extends RunJobOptions {
+    /** Jobs to run; defaults to the whole registry. */
+    jobs?: readonly ErasedJob[];
+}
+export declare function runJobSuite(opts: RunJobSuiteOptions): Promise<JobSuiteReport>;
+//# sourceMappingURL=run.d.ts.map

package/dist/jtbd/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/jtbd/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,KAAK,EAEV,YAAY,EACZ,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,KAAK,EAAE,MAAM;QAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,aAAa,EAAE,CAAA;KAAE,CAAC;CACtE;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAmCrE;AAUD,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,odAQpB,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,wBAAsB,MAAM,CAC1B,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,YAAY,CAAC,CA0EvB;AAED,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,mDAAmD;IACnD,IAAI,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7B;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,cAAc,CAAC,CAqCzB"}