cozyclay 2.1.0 → 3.0.0

package/dist/cozyclay-package.json

@@ -1 +1 @@
-{"payload":"{\"distribution\":\"npm\",\"package\":\"cozyclay\",\"version\":\"2.1.0\",\"repository\":\"NomaDamas/CozyClay\",\"content_sha256\":\"94d0d33855916922202e0ff1c4afc9aff0e6db281adae8072ae72da7936dd906\"}","signature":"BDrFE1pch5PcqsC6Q9eeqhgX+hfAdOLbJEbdZGM+upY9ACMIItqHsHEmqan1Qkl1i636NrVs0e0zGH7cVmFPCQ=="}
+{"payload":"{\"distribution\":\"npm\",\"package\":\"cozyclay\",\"version\":\"3.0.0\",\"repository\":\"NomaDamas/CozyClay\",\"content_sha256\":\"e6a50c77650f2894d8154267dec8faafb86cad41e859b2594f233d5a18348530\"}","signature":"rwtYOUdZUQo57FluVUioxvNg+gKzRgBC38gyKcd7GIrm5nhq3iff5eV90XV7YFAJfVHn466qu3iLBsnjKkpIDA=="}

package/dist/index.html

@@ -301,9 +301,9 @@
         .btn, a.card, .seg button, .tutorial-steps li { transition: none; }
       }
     </style>
-    <script type="module" crossorigin src="/assets/landing-BSesrCpL.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/analytics-B41FmPYI.js">
-    <link rel="modulepreload" crossorigin href="/assets/first-shot-handoff-BlT33CGf.js">
+    <script type="module" crossorigin src="/assets/landing-DjHD8u7k.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/analytics-C9sUnndd.js">
+    <link rel="modulepreload" crossorigin href="/assets/first-shot-handoff-CC4xe4HM.js">
   </head>
   <body>
     <header class="site">

package/dist/llms.txt

@@ -11,6 +11,20 @@
 - [Camera control for AI video](https://cozyclay.org/ai-camera-control/): why camera prompts drift and what the models actually accept.
 - [Privacy](https://cozyclay.org/privacy/): analytics and telemetry disclosure.
 
+## Agent loop
+
+1. Install and open the Studio: `npx cozyclay`.
+2. Wait for a live editor: `cclay live status --wait`.
+3. Read before editing: `cclay live inspect --scope scene` or `--scope catalogue`.
+4. Apply one semantic batch with `cclay live arrange-objects`, `arrange-characters`, `frame-shot`, or `patch`.
+5. Verify the result. For a whole shot, use `cclay live verify --targets <id> --checks framing --range whole_clip --visual contact_sheet --out verify.png`.
+6. Use `--strict` when sampled framing findings should make the command fail. A sampled result is evidence for the returned frames, not proof of every frame.
+7. Read the receipt before retrying. `UNCERTAIN_APPLY` means reconcile or inspect first. `STALE_HANDLE` means status and workspace selection again. `NOT_IN_MODE` means switch Storyboard/Animation before using motion tools.
+
+The Studio, MCP server and `cclay live` use the same command contract. `script` can call several tools in one QuickJS transaction for computed layouts. Every authored edit returns a receipt and can be undone.
+
+For source-checkout CI, start the same Studio in owned headless Chrome with `node tools/headless-studio.mjs --project shot.cclayproject --port 5920 --live-port 5924`; then point `COZYCLAY_LIVE_PORT=5924 cclay live ...` at it. The launcher owns the Vite and Chrome children and cleans them up on exit.
+
 ## Source
 
 - GitHub: https://github.com/NomaDamas/CozyClay

package/dist/sw.js

@@ -9,7 +9,8 @@ const CACHE_PREFIX = "cozyclay-pwa-";
 // v6 also: hosted demo and ticket pages are network-only; never freeze queue state.
 // v7: force-refresh the asset cache — v6 clients were holding a stale app shell
 // (the html-flex crash-screen regression) and never re-fetching it.
-const CACHE_NAME = `${CACHE_PREFIX}v7`;
+// v8: CozyClay 3 drops the shipped walk clip (motion is compiled in the studio).
+const CACHE_NAME = `${CACHE_PREFIX}v8`;
 // The installable app is the studio, not the landing page.
 const APP_SHELL = "/app/";
 const CORE_ASSETS = [
@@ -23,7 +24,6 @@ const CORE_ASSETS = [
 	"./icons/apple-touch-icon.png",
 	"./favicon.ico",
 	"./fonts/inter-latin.woff2",
-	"./demo/walk-then-stop.npz",
 	"./models/x-bot-tpose.fbx",
 	"./models/y-bot-tpose.fbx",
 ];
@@ -79,14 +79,11 @@ self.addEventListener("message", (event) => {
 self.addEventListener("fetch", (event) => {
 	const { request } = event;
 	const url = new URL(request.url);
-	// The composer and ticket are live API surfaces. A stale shell would either
-	// submit with an old Turnstile key or show a frozen queue position.
-	if (url.pathname.startsWith("/d/") || url.pathname.startsWith("/demo/")) return;
 	// Landing-page playground presets are edited in place; a cache-first hit
 	// would pin the first version a visitor ever saw.
 	if (url.pathname.startsWith("/scenes/")) return;
 	if (request.method !== "GET") return;
-	if (url.origin !== self.location.origin || url.pathname.includes("/ardy/")) return;
+	if (url.origin !== self.location.origin) return;
 	if (request.headers.has("range")) {
 		event.respondWith((async () => {
 			try {

package/dist/workflow/index.html

@@ -8,11 +8,12 @@
     <meta name="theme-color" content="#101116" />
     <meta name="description" content="CozyClay visual workflow builder" />
     <title>CozyClay Workflow</title>
-    <script type="module" crossorigin src="/assets/workflow-Br-K7Srs.js"></script>
+    <script type="module" crossorigin src="/assets/workflow-C4yKH1p4.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-hePW80VL.js">
-    <link rel="modulepreload" crossorigin href="/assets/analytics-B41FmPYI.js">
-    <link rel="modulepreload" crossorigin href="/assets/scene-asset-sync-BCWDJB1d.js">
-    <link rel="stylesheet" crossorigin href="/assets/scene-asset-sync-DjJ_cJ2R.css">
+    <link rel="modulepreload" crossorigin href="/assets/analytics-C9sUnndd.js">
+    <link rel="modulepreload" crossorigin href="/assets/fflate.module-KbGj5-H6.js">
+    <link rel="modulepreload" crossorigin href="/assets/scene-asset-sync-Hx_FzdOH.js">
+    <link rel="stylesheet" crossorigin href="/assets/scene-asset-sync-_S8NQl5B.css">
     <link rel="stylesheet" crossorigin href="/assets/workflow-DRdwoDBT.css">
   </head>
   <body>

package/mcp/LIVE-PROTOCOL.md

@@ -43,28 +43,15 @@ server -> editor, one per command:
 
     { "type": "cmd", "id": "<opaque string>", "name": "<command>", "args": { ... } }
 
-server -> editor, for an MCP-owned motion job state or terminal outcome (and again
-on reconnect while retained). A completed event follows the editor's successful
-`load_motion` acknowledgement:
-
-    { "type": "event", "name": "motion_job", "payload": { "taskId", "status", "createdAt", "lastUpdatedAt", "ttlMs", "pollIntervalMs", "outcome?" } }
-
-editor -> server, to cancel its own active job before editor delivery:
-
-    { "type": "event", "name": "motion_job_cancel", "payload": { "taskId": "<opaque task id>" } }
-
 editor -> server, one per command, echoing `id`:
 
     { "type": "result", "id": "<same id>", "ok": true,  "value": { ... } }
     { "type": "result", "id": "<same id>", "ok": false, "error": "<human message>" }
 
 Unknown `name` MUST answer `ok:false`, never silence. The server times a
-command out after 5 s and treats it as failed, except `load_motion` and
-`import_asset`, which retain a dedicated 30 s editor bound (decode and stand a
-mesh, or install a take). Measurement
-justifies the existing headroom: 12 real editor installs of one 94,672-byte
-ARDY NPZ had nearest-rank p50 29.96 ms, p95 547.29 ms, and p99 547.29 ms;
-30 s remains appropriate for materially larger cold-cache production takes. A timeout or disconnect during
+command out after 5 s and treats it as failed, except `import_asset` and the
+Studio commands (`inspect_studio`, `run_action`, `capture_framing_png`, ...),
+which retain a dedicated 30 s editor bound. A timeout or disconnect during
 a mutation is ambiguous: it may already have applied, so callers MUST NOT retry
 blindly and should `describe` before recovering.
 
@@ -113,29 +100,6 @@ can wait for an editor instead of polling:
 
     { "type": "event", "name": "editor_connected" | "editor_disconnected", "payload": { "handle", "workspaceId", "meta" } }
 
-## Motion jobs
-
-`generate_motion` returns immediately with exactly `{ taskId, status, createdAt,
-lastUpdatedAt, ttlMs, pollIntervalMs }`; `pollIntervalMs` is `0` because the
-model never polls it. The MCP server retains terminal outcomes for `ttlMs`
-(currently 10 minutes) and pushes `motion_job` to the matching stable workspace
-on completion, failure, cancellation, or reconnect. For a completed job, the
-server first installs the take through the request/response `load_motion`
-command, then publishes the terminal lifecycle event. The event never installs
-the take a second time. A retained outcome that passes its TTL is explicitly
-expired and is never replayed.
-
-If the editor explicitly rejects `load_motion`, the job transitions to `failed`
-and publishes that terminal event. If the socket disconnects or times out while
-installation is in flight, the job also fails but is not retried: the mutation
-may already have applied, so retrying could install the same take twice.
-
-Cancellation is cooperative at the bridge HTTP stream: `motion_job_cancel`
-aborts that request. The ARDY bridge detects the disconnected stream and kills
-its request-owned child process groups. A cancelled job is terminal and is never
-sent to editor installation. There are no `tasks/*` tools or start/status/list
-polling tools in the MCP surface.
-
 ## Commands (v1)
 
 All coordinates are metres, rotations are degrees of yaw, ids are the ids the
@@ -158,8 +122,6 @@ scene document already uses.
 | `group_objects` | `{ parent, children }` | `{ parent, children }` | attach every child under parent |
 | `ungroup_objects` | `{ children }` | `{ children }` | detach every child |
 | `apply_batch` | `{ ops, atomic?: false, stopOnError?: true, label?: "MCP batch" }` | `{ label, applied: number[], failed: [{ index, error }], rolledBack }` | executes at most 100 object mutations as one undo entry. `atomic` and `stopOnError` are independent; atomic failure restores the pre-batch objects and creates no undo entry. Nested batches are rejected. v1 rejects character mutations because cast history is a separate store. |
-| `set_prompt_blocks` | `{ blocks: [{ startFrame, endFrame, text }] }` | `{ blocks }` | replace the active character's authored prompt clips after validating each frame range and text |
-| `load_motion` | `{ url, prompt?, blocks?, drop? }` | `{ loaded, url, blocks }` | install an ARDY motion on the selected character. It has the dedicated 30-second editor-processing timeout; motion-job completion carries the character id captured when generation started |
 | `load_scenes` | `{ document }` | `{ sceneName, activeSceneId, scenes: [{ id, name }] }` | replace the whole scene document (same shape `serializeSceneDocument` emits); the response attests the full scene list and active scene for `add_scene` and `switch_scene` parity |
 
 ### Previs mode and character kind in the Studio context
@@ -176,12 +138,10 @@ is admitted against. Two parts of it describe what a project and its cast can do
 
 Before an animation-only tool runs, the server reads these fields from the
 context it admits the command against (`mark_camera_move`, which sends no
-command, reads `previsMode` from `describe`). In a storyboard project `generate_motion`, `set_prompt_blocks`, `load_motion` and
-`mark_camera_move` answer `{ ok: false, code: "NOT_IN_MODE", reason }` and send
-no command; `generate_motion` and `load_motion` on a capsule figure answer
-`{ ok: false, code: "TARGET_NOT_READY", reason }` with the kind's reason. The
-editor's own motion, take, IK and pose commands refuse a capsule figure with
-`TARGET_NOT_READY` as well, so `studio_run` reaches the same answer.
+command, reads `previsMode` from `describe`). In a storyboard project
+`mark_camera_move` answers `{ ok: false, code: "NOT_IN_MODE", reason }` and sends
+no command. The editor's own motion, take, IK and pose commands refuse a capsule
+figure with `TARGET_NOT_READY`, so `studio_run` reaches that answer.
 
 ## Hard rules for the editor side
 

package/mcp/README.md

@@ -1,16 +1,16 @@
 # CozyClay MCP server
 
 Lets an AI assistant (Claude Desktop, Cursor, any MCP client) block a scene, place the camera,
-generate character motion and read the shot back as film vocabulary — then turn it into an AI
+compile character motion and read the shot back as film vocabulary — then turn it into an AI
 image/video prompt.
 
 Works two ways, with one tool catalog:
 
-- **Editor open** — tool calls drive the visible viewport live: camera, cast, set, motion,
-  prompt blocks on the timeline.
+- **Editor open** — tool calls drive the visible viewport live: camera, cast, set and the
+  compiled motion on the timeline (`studio_run` with `motion.compile`).
 - **No editor** — scene, camera, prompt and project-file tools run in memory with no browser,
-  GPU or build step. `capture_frame`, `set_prompt_blocks`, `generate_motion`, `apply_batch`,
-  and `import_mesh` explicitly require a live editor.
+  GPU or build step. `capture_frame`, `apply_batch` and `import_mesh` explicitly require a
+  live editor.
 
 ## Run it locally
 
@@ -77,7 +77,6 @@ generated frame matches the blocking instead of drifting off into a generic shot
 | `group_objects` | attach children to a parent so they move as one; pass `parent: null` to detach |
 | `apply_batch` | execute up to 100 object mutations as one user-visible undo transaction |
 | `render_prompt` | the shot as an AI image or video prompt |
-| `generate_motion` | multi-phase character motion through the ARDY bridge — phases land as prompt blocks |
 | `mark_camera_move` / `describe_camera_move` | name a move between two camera positions |
 | `add_scene` / `switch_scene` | multiple scenes per project |
 | `open_project` / `save_project` | read and write `.cclayproject` files |
@@ -116,38 +115,29 @@ thin terminal front end over this hub, not a parallel surface, so anything true
 above (admission envelopes, receipts, per-workspace exclusion) is true of it too. The
 terminal-agent guide for it is [`../docs/agent-cli.md`](../docs/agent-cli.md).
 
-## Motion generation
+## Motion
 
-`generate_motion` takes plain-language beats and a length:
-
-```
-phases: ["seated on a chair, slowly stands up",
-         "breaks into a sprint",
-         "trips and falls hard to the ground"]
-seconds: 10
-```
-
-It tiles them into contiguous ARDY segments, streams the generation through the local bridge
-(`127.0.0.1:5181`, started by `npm run dev`), and — when an editor is connected — loads the
-result onto the active character with prompt blocks on the timeline. Beats longer than the
-per-block limit are split into consecutive blocks, so one phase can produce multiple blocks.
-Pass a previous `motion_url` to reload a clip without generating again.
+Motion is compiled, not generated: run `motion.compile` through `studio_run` with a motion
+spec (key poses, anchors, props, walks, hinged objects, task checks). The Studio bakes every
+frame on the rig, answers the QA groups, and installs the take; `motion.sample` and
+`motion.qa` read it back. The spec format and the loop are in
+[`../docs/motion3-agent-guide.md`](../docs/motion3-agent-guide.md).
 
 ## Storyboard projects and capsule figures
 
-The tool list is fixed when the server starts, so it is the same 28 tools in every project. A
+The tool list is fixed when the server starts, so it is the same 27 tools in every project. A
 tool that does not apply to the project or to its target answers a structured refusal instead
 of acting; nothing is sent to the editor and nothing changes. The refusal is the tool's only
 text content, with `isError: true`:
 
 ```json
-{ "ok": false, "code": "NOT_IN_MODE", "reason": "This project is a Storyboard - generate_motion is available in Animation projects." }
+{ "ok": false, "code": "NOT_IN_MODE", "reason": "This project is a Storyboard - mark_camera_move is available in Animation projects." }
 ```
 
 | code | when | tools |
 | --- | --- | --- |
-| `NOT_IN_MODE` | the project's `previsMode` is `storyboard` | `generate_motion`, `set_prompt_blocks`, `load_motion`, `mark_camera_move` |
-| `TARGET_NOT_READY` | the target character is a capsule figure (`model: "proxy-figure"`) | `generate_motion` (the editor's active character), `load_motion` (its `character`, else the active one) |
+| `NOT_IN_MODE` | the project's `previsMode` is `storyboard` | `mark_camera_move` |
+| `TARGET_NOT_READY` | the target character is a capsule figure (`model: "proxy-figure"`) | `studio_run` motion, take, IK and pose actions |
 
 `describe_scene` reports `previsMode: storyboard` or `previsMode: animation` (the connected
 editor's project; `open_project` sets it without one) and marks each cast member
@@ -156,7 +146,7 @@ editor's project; `open_project` sets it without one) and marks each cast member
 A **storyboard project** is a sequence of still shots: one picture per panel, held for a
 number of frames, with a caption. Block it with the camera, cast and set tools, and run the
 still-shot commands (`shot.createStill`, `shot.setCaption`, `shot.setHold`, ...) through
-`studio_run`. Motion, prompt blocks and named camera moves belong to Animation projects.
+`studio_run`. Motion and named camera moves belong to Animation projects.
 
 A **capsule figure** is a rigless stand-in for blocking: `add_character { subject, model:
 "proxy-figure", posture: "sit" }`. It places, turns and frames like any cast member and holds a

package/mcp/live-hub.mjs

@@ -11,7 +11,7 @@ export const DEFAULT_COMMAND_TIMEOUT_MS = 5_000;
 export const MAX_COMMAND_TIMEOUT_MS = 300_000;
 export const DEFAULT_HEARTBEAT_MS = 15_000;
 export const RUN_WORKFLOW_TIMEOUT_MS = 180_000;
-export const LOAD_MOTION_TIMEOUT_MS = 30_000;
+
 export const IMPORT_ASSET_TIMEOUT_MS = 30_000;
 export const CAPTURE_FRAME_TIMEOUT_MS = 30_000;
 export const STUDIO_COMMAND_TIMEOUT_MS = 30_000;
@@ -31,9 +31,7 @@ const mutationCommands = new Set([
 	"remove_object",
 	"group_objects",
 	"ungroup_objects",
-	"apply_batch",
-	"set_prompt_blocks",
-	"load_motion",
+		"apply_batch",
 	"load_scenes",
 	"operate_studio", "arrange_objects", "arrange_characters", "patch_elements", "frame_shot", "undo_edit", "run_action",
 	"import_asset",
@@ -75,7 +73,7 @@ const safely = (work) => {
 const mutationState = (name, description) => {
 	if (!description || typeof description !== "object") return undefined;
 	if (name === "set_camera") return description.camera;
-	if (["add_character", "update_character", "remove_character", "set_prompt_blocks"].includes(name)) return description.characters;
+	if (["add_character", "update_character", "remove_character"].includes(name)) return description.characters;
 	if (name === "load_scenes") return description.document;
 	return description.objects;
 };
@@ -138,7 +136,7 @@ export class LiveHub {
 	}
 
 	static commandTimeoutMs(name) {
-		if (name === "load_motion") return LOAD_MOTION_TIMEOUT_MS;
+		
 		// A 32 MiB mesh as a data URL will not decode, store and stand in 5 s.
 		if (name === "import_asset") return IMPORT_ASSET_TIMEOUT_MS;
 		// Close two-person shots (OTS) raycast two skinned rigs over a full-frame
@@ -216,7 +214,7 @@ export class LiveHub {
 		const observer = {
 			hub: this, handle,
 			before(command) {
-				if (!LiveHub.commandMayMutate(command) || command === "load_motion" || command === "run_action") return false;
+				if (!LiveHub.commandMayMutate(command) || command === "run_action") return false;
 				mutation = { name: command, before: mutationState(command, description), acknowledged: false };
 				description = undefined;
 				return mutation.before === undefined;
@@ -253,9 +251,7 @@ export class LiveHub {
 						if (mutation) mutation.rolledBack = value?.rolledBack === true;
 						if (value?.rolledBack === true || value?.failed?.length > 0) failure = "failed";
 					}
-					// The load acknowledgement is the existing installation receipt,
-					// including generation jobs whose MCP control response was queued.
-					if (command === "load_motion" && value?.loaded === true) applied = true;
+					
 				}
 				emitApplied();
 			},

package/mcp/package.json

@@ -11,10 +11,8 @@
 		"start": "node server.mjs",
 		"verify": "node verify.mjs && node verify-protocol-version.mjs && node verify-http-origin.mjs && node verify-import-mesh.mjs",
 		"verify:annotations": "node verify-tool-annotations.mjs",
-		"verify:prompts": "node verify-prompts.mjs",
 		"verify:live": "node verify-live.mjs && node verify-live-p0.mjs && node verify-live-routing.mjs && node verify-live-controller.mjs && node verify-live-scene-parity.mjs && node verify-live-batch.mjs && node verify-live-editor-model.mjs && node verify-live-port.mjs",
-		"verify:capture": "node verify-live-capture.mjs",
-		"verify:motion-job": "node verify-live-motion-job.mjs"
+		"verify:capture": "node verify-live-capture.mjs"
 	},
 	"engines": {
 		"node": ">=22.13"

package/mcp/tool-handlers.mjs

@@ -33,8 +33,6 @@ import { readMeshFromPath } from "./mesh-file.mjs";
 import { encodePng, readImageFromPath } from "./image-file.mjs";
 import { rankingRow, scoreSculptAgainstReference } from "../src/sculpt-compare.js";
 import { DEFAULT_POSE } from "../src/poses.js";
-import { generationArgs } from '../src/motion/generation.js';
-import { BLOCK_MAX_SECONDS, PROMPT_GUIDE, normalizePhases, splitLongBeat, tileClipFrames } from "./ardy-prompts.mjs";
 
 import {
 	CAMERA_MOVES,
@@ -105,8 +103,8 @@ export const liveWorkspace = new AsyncLocalStorage();
 const liveWorkspaceTools = new Set([
 	"describe_scene", "describe_shot", "render_prompt", "mark_camera_move", "describe_camera_move", "save_project",
 	"set_camera", "frame_shot", "add_character", "place_character", "remove_character",
-	"focus_character", "place_object", "import_mesh", "sculpt_object", "compare_sculpt", "group_objects", "set_prompt_blocks", "generate_motion", "update_object",
-	"remove_object", "apply_batch", "add_scene", "switch_scene", "open_project", "capture_frame", "load_motion",
+	"focus_character", "place_object", "import_mesh", "sculpt_object", "compare_sculpt", "group_objects", "update_object",
+	"remove_object", "apply_batch", "add_scene", "switch_scene", "open_project", "capture_frame",
 	"studio_commands", "studio_run",
 ]);
 const MAX_CAPTURE_BYTES = 1_000_000;
@@ -114,7 +112,6 @@ const CAPTURE_ARTIFACT_TTL_MS = 10 * 60_000;
 const MAX_CAPTURE_ARTIFACTS = 20;
 const captureArtifacts = [];
 const captureArtifactPattern = /^cozyclay-capture-[0-9a-f-]+\.png$/;
-const motionUrlPattern = /^\/(ardy\/motions\/[0-9]+-[0-9a-f]{6}|ardy\/assembled\/[A-Za-z0-9._-]+\.npz)$/;
 export const cleanupCaptureArtifacts = () => {
 	for (const path of captureArtifacts.splice(0)) {
 		try { unlinkSync(path); } catch {}
@@ -164,9 +161,6 @@ const TOOL_ANNOTATIONS = Object.freeze({
 	sculpt_object: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
 	compare_sculpt: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
 	group_objects: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
-	set_prompt_blocks: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
-	load_motion: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
-	generate_motion: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
 	update_object: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
 	remove_object: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
 	apply_batch: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
@@ -242,8 +236,6 @@ const previsRefusal = (toolName, { feature, context, characterId } = {}) => {
 		: isProxyFigure(findCharacter(characterId ?? state.focus));
 	return proxy ? refusal("TARGET_NOT_READY", kindRefusal(feature)) : null;
 };
-/** The Studio context and one command's declaration, as executeStudioCommand admits it. */
-const inspectAction = (action) => liveHub.command("inspect_studio", { scope: "actions", ids: [action] }, liveWorkspace.getStore());
 
 const scene = () => activeScene(state.doc.scenes, state.doc.activeSceneId);
 const stage = () => scene().stage;
@@ -514,8 +506,7 @@ function sceneReport({ characterCursor = 0, objectCursor = 0, limit = 50 } = {})
 				`${c.pose ? " posed" : ""}${c.hidden ? " hidden" : ""}` +
 				`${c === framed ? "  <- framed" : ""}`,
 			`    model: ${c.model}  kind: ${isProxyFigure(c) ? "proxy" : "rig"}${isProxyFigure(c) ? `  posture: ${c.posture ?? "stand"}` : ""}  pose: ${JSON.stringify(c.pose ?? null)}  tint: ${c.tint ?? null}  scale: ${c.scale ?? 1}`,
-			`    motionRef: ${JSON.stringify(c.motionRef ?? null)}`,
-			`    layer: ${JSON.stringify({ waypoints: c.layer?.waypoints ?? [], promptClips: c.layer?.promptClips ?? [] })}`,
+						`    layer: ${JSON.stringify({ waypoints: c.layer?.waypoints ?? [] })}`,
 		);
 	}
 
@@ -589,7 +580,7 @@ function shotReport() {
 const studioAliasTools = new Set([
 	"set_camera", "frame_shot", "place_object", "update_object", "remove_object",
 	"import_mesh", "sculpt_object", "group_objects", "add_scene", "switch_scene", "apply_batch", "open_project",
-	"add_character", "place_character", "remove_character", "set_prompt_blocks", "load_motion", "generate_motion",
+	"add_character", "place_character", "remove_character",
 ]);
 const studioAdmissionSchema = {
 	expectedRevision: z.number().int().min(0).optional().describe("scene revision to admit against; defaults to the inspected revision"),
@@ -1319,161 +1310,6 @@ export const createToolHandlers = ({ projectRootPromise } = {}) => {
 			},
 		),
 
-		tool(
-			"set_prompt_blocks",
-			{
-				title: "Author the motion beats on the timeline",
-				description:
-					"Write Prompt Blocks onto the timeline WITHOUT generating — the beats and their frame " +
-					"ranges, so a schedule can be read and revised before any GPU time is spent. Hit " +
-					"the studio's top-bar Generate Motion button, or call generate_motion, when it reads right.\n\n" +
-					PROMPT_GUIDE,
-				inputSchema: {
-					beats: z
-						.array(
-							z.object({
-								text: z.string().min(3).describe("the beat, in ARDY's sentence shape"),
-								seconds: z
-									.number()
-									.min(0.5)
-									.max(20)
-									.optional()
-									.describe(`how long this beat holds; defaults to 3 s when omitted, and over ${BLOCK_MAX_SECONDS}s it becomes chained blocks`),
-							}),
-						)
-						.min(1)
-						.max(8)
-						.describe("beats in order; each one becomes a contiguous block"),
-				},
-			},
-			async ({ beats, ...admission }) => {
-				if (!liveHub?.connected) {
-					return previsRefusal("set_prompt_blocks") ?? text("Prompt Blocks live on the studio timeline — open the editor and try again.");
-				}
-				const normalized = normalizePhases(beats.map((b) => b.text));
-				// The timeline runs on a 24 fps production clock.
-				const TIMELINE_FPS = 24;
-				let cursor = 0;
-				const blocks = [];
-				for (const [i, textValue] of normalized.texts.entries()) {
-					const whole = beats[Math.min(normalized.sources[i], beats.length - 1)].seconds ?? 3;
-					const spans = splitLongBeat(whole);
-					for (const span of spans) {
-						const frames = Math.max(1, Math.round(span * TIMELINE_FPS));
-						blocks.push({ startFrame: cursor, endFrame: cursor + frames, text: textValue });
-						cursor += frames;
-					}
-				}
-				try {
-					const inspected = await inspectAction("character.setPromptBlocks");
-					return previsRefusal("set_prompt_blocks", { context: await contextOf(inspected) }) ??
-						await runStudioCommand({ ...admission, inspected, action: "character.setPromptBlocks", args: context => ({
-						characterId: context.activeCharacterId, blocks,
-					}) });
-				} catch (error) {
-					return liveError(error);
-				}
-			},
-		),
-
-		tool(
-			"load_motion",
-			{
-				title: "Load an existing motion take",
-				description:
-					"Unlike generate_motion, load_motion installs a previously generated or assembled motion take WITHOUT regenerating — " +
-					"re-using a completed /ardy/motions/<id> take or an /ardy/assembled/*.npz tile (the long-take recipe). " +
-					"It is synchronous and returns the editor's confirmation.",
-				inputSchema: {
-					url: z.string().describe("/ardy/motions/<id> or /ardy/assembled/<name>.npz"),
-					prompt: z.string().optional().describe("Label shown on the timeline block."),
-					character: z.string().optional().describe('which character receives the take — letter, slot number or id; defaults to the editor\u2019s active character'),
-				},
-			},
-			async (args) => {
-				if (!motionUrlPattern.test(args.url)) {
-					throw new Error(`Unsupported motion url "${args.url}". Use /ardy/motions/<id> or /ardy/assembled/<name>.npz.`);
-				}
-				const inspected = liveHub?.connected ? await inspectAction('motion.replace') : undefined;
-				const characterId = args.character === undefined ? inspected?.context?.activeCharacterId : await liveCharacterId(args.character);
-				const refused = previsRefusal("load_motion", { feature: "take", context: await contextOf(inspected), characterId });
-				if (refused) return refused;
-				return runStudioCommand({ ...args, inspected, action: 'motion.replace', args: context => ({
-					characterId: args.character === undefined ? context.activeCharacterId : characterId,
-					url: args.url, prompt: args.prompt ?? '',
-				}) });
-			},
-		),
-
-		tool(
-			"generate_motion",
-			{
-				title: "Generate character motion (Kimodo)",
-				description:
-					"Alias for motion.generate in the editor. Returns its bus receipt; started jobs carry jobId for studio_run job.await or job.cancel. " +
-					"The installed take is undoable with studio_run edit.undo.\n\n" +
-					PROMPT_GUIDE,
-				inputSchema: {
-					phases: z
-						.array(
-							z.union([
-								z.string().min(3),
-								z.object({
-									text: z.string().min(3),
-									seconds: z.number().min(0.5).max(30).describe("how long THIS beat holds"),
-								}),
-							]),
-						)
-						.min(1)
-						.max(8)
-						.describe(
-							"one beat per phase, in order. Follow the shared Kimodo prompt guide in this tool's " +
-								"description; it is the single source for prompt wording and phase guidance. Give a " +
-								"plain string to share the clip evenly, or { text, seconds } to hold a beat for a " +
-								"specific time.",
-						),
-					seconds: z
-						.number()
-						.min(2)
-						.max(60)
-						.default(9)
-						.describe("total clip length; ignored when every phase carries its own seconds"),
-					seed: z.number().int().optional().describe("generation seed"),
-					motion_url: z
-						.string()
-						.regex(motionUrlPattern)
-						.optional()
-						.describe("reuse an already-generated clip, or a curated clip staged under public/ardy/assembled/"),
-					drop: z
-						.object({
-							from_s: z.number().min(0).describe("clip time the plunge begins, seconds"),
-							to_s: z.number().positive().describe("clip time it lands, seconds; must be after from_s"),
-							meters: z.number().positive().max(30).describe("how far the body falls"),
-						})
-						.optional()
-						.describe(
-							"a vertical fall staged onto the clip — the whole body drops this many metres over " +
-								"[from_s, to_s] on a gravity curve. Stand the character on a roof with place_character's " +
-								"y, then drop them past its edge; ARDY itself only generates flat-ground motion.",
-						),
-				},
-			},
-			async ({ phases, seconds = 9, seed, motion_url, drop, ...admission }) => {
-				if (!liveHub?.connected) return previsRefusal("generate_motion", { feature: "motion" }) ?? text(noLiveEditor("Motion requires a connected CozyClay editor."));
-				const normalized = normalizePhases(phases.map(phase => typeof phase === 'string' ? phase : phase.text));
-				const beats = normalized.texts.map((text, index) => ({ text, seconds: phases[normalized.sources[index]]?.seconds ?? seconds / phases.length })).filter(beat => beat.text);
-				const action = motion_url ? 'motion.replace' : 'motion.generate', inspected = await inspectAction(action);
-				const refused = previsRefusal("generate_motion", { feature: "motion", context: await contextOf(inspected) });
-				if (refused) return refused;
-				return runStudioCommand({ ...admission, inspected, action, args: context => {
-					const generated = generationArgs({ characterId: context.activeCharacterId, source: { kind: 'generate', beats, ...(seed === undefined ? {} : { seed }) } });
-					return motion_url ? { characterId: generated.characterId, url: motion_url, prompt: beats.map(beat => beat.text).join(' '),
-						blocks: generated.blocks.map(({ startFrame, endFrame, text: prompt }) => ({ startFrame, endFrame, prompt })), ...(drop ? { drop } : {}) }
-						: { ...generated, ...(drop ? { drop } : {}) };
-				} });
-			},
-		),
-
 		tool(
 			"update_object",
 			{