cozyclay 3.1.5 → 3.2.0

package/CHANGELOG.md

@@ -2,6 +2,82 @@
 
 ## Unreleased
 
+## 3.2.0 - 2026-10-26
+
+Motion gets physics you can see and trust: props swing and settle after the hand stops, balance and jumps are judged by real mass and gravity and the Studio draws why, and characters no longer pass through each other when you drag or compile.
+
+Studio
+
+- **Physics overlay.** Tick **Physics** in the motion controls, or call
+  `motion.physicsOverlay`, to draw the centre of mass (green inside the feet,
+  red outside, grey in the air), the support polygon under the feet, each
+  jump's actual hips path next to its gravity arc, and a short trail behind
+  swinging props. It shows in scrub, playback and video export, and red
+  frames are exactly the ones QA calls BALANCE. (#950)
+- Dragging a hand or foot IK handle into another character now stops at that
+  character's body instead of passing through, even on a fast drag across a
+  thin forearm. Hold **Alt** while dragging to pass through on purpose; a
+  one-time notice says so. The other character never moves. (#949)
+
+Motion3
+
+- **Prop spring.** `objects.<id>.spring = { length, stiffness, damping }`
+  makes a carried or free prop (a bag, a lantern, a club) swing a beat behind
+  the hand and settle. `length` is the string or rod length; stiffness
+  defaults to gravity over length and damping to 0.5, so `spring: { length: 0.5 }`
+  already swings naturally. Put the prop's base at the hand with `at`/`along`,
+  because the swing pivots at the base; QA notes a base that sits far from the
+  hand. The swing is computed once at compile time, stops when a dropped prop
+  lands, and never pushes the prop into the floor. (#945)
+- **BALANCE** now uses a mass-weighted centre of mass against the support
+  polygon of the grounded feet, instead of a four-point average and a box. Its
+  hint gives the distance and direction (for example 0.10 m ahead of the feet),
+  and a lean that changes direction stays one issue. A hint that moves the
+  root now moves every key that holds the pose, so the body does not slide
+  between them. (#944, #937)
+- **FLOAT** issues come with a fix: the root keyed onto the gravity arc between
+  takeoff and landing, returning to the original motion at both ends. When the
+  correction would be too large, the hint gives the apex height or the air time
+  that would fit instead. (#943)
+- **`fix.person`** (on by default) moves a character's arms out of another
+  character's body at compile time, keeps contact you allowed in
+  `checks.allow`, and gives the same take after saving and reopening. (#948)
+
+Agent
+
+- Kimi K3 models (`kimi-k3*` on the Moonshot hosts) work on the
+  OpenAI-compatible provider with their reasoning efforts and full output
+  limit. A turn that spends every output token before answering now says so
+  and suggests a lower reasoning effort, instead of failing with no output.
+  (#951, #947)
+
+Package and tests
+
+- `jpeg-js`, which the MCP image tools import, is a root dev dependency, so a
+  development checkout runs the MCP tests without a separate install. The test
+  runner now skips the MCP suites with a clear message when `mcp/node_modules`
+  is missing. (#946, #936)
+- The Studio camera QA enters look-through from the dock's Shot Camera card,
+  where the Studio shows it. (#952, #925)
+
+## 3.1.6 - 2026-10-25
+
+The npm package ships the MCP module the live tools need, so the Studio's live tools and `cozyclay mcp` work on a fresh install.
+
+Studio
+
+- A 3.1.5 global install shows the **Update** chip in the top bar for the
+  first time, since this is the first release after the chip shipped.
+  **Update now**, or the command it offers to copy, installs 3.1.6; then
+  restart `cclay`.
+
+MCP
+
+- The npm package now ships `mcp/project-camera.mjs`, so the Studio's live
+  tools and `cozyclay mcp` start on an npm install instead of failing with
+  "Cannot find module" (broken since 3.1.2). The package check now fails a
+  release whose `bin/` or `mcp/` code imports a file the package leaves out.
+
 ## 3.1.5 - 2026-10-25
 
 The Studio tells you when a new release is out and installs it in one click, Claude models work in the agent panel again, IK edits stay on their own character, turns and walks look more natural, and anonymous analytics show where the Studio gets in the way.

package/bin/agent/agent-runner.mjs

@@ -414,7 +414,8 @@ export function createAgentRunner({ models: suppliedModels, sessionStore, tools
 					initialState: { systemPrompt: activePrompt, model: selected.model, thinkingLevel: thinkingLevel ?? "off", tools: await adapters(input), messages: restored?.history ?? [] },
 					streamFn: createRetryingStream({ ai: pi.ai, models: registry, refreshAuth, onAttempt: (message) => { countAttempt(message); emitQuota(state.active?.queue, state.lastInput); } }),
 					transformContext: studioView,
-					onPayload: (payload, model) => (model?.api === "anthropic-messages" ? withAnthropicCacheBreakpoints(payload, model) : undefined),
+					// keeps the output limit this request really sent, for a turn that runs out of it (finish)
+					onPayload: (payload, model) => { if (state.active) state.active.maxTokens = payload?.max_tokens ?? payload?.max_completion_tokens ?? payload?.max_output_tokens; return model?.api === "anthropic-messages" ? withAnthropicCacheBreakpoints(payload, model) : undefined; },
 					onResponse: (response) => { if (state.active && response?.headers) state.active.lastResponseHeaders = response.headers; },
 					sessionId,
 					// pi-agent-core's Agent attributes requests to pi (OpenRouter, NVIDIA NIM and OpenCode headers); these are
@@ -480,7 +481,11 @@ export function createAgentRunner({ models: suppliedModels, sessionStore, tools
 				// The run's outcome is its last assistant message: the Agent ends a
 				// failed or cancelled request there (stopReason error/aborted).
 				const last = event.messages.findLast((message) => message.role === "assistant");
-				const status = last?.stopReason === "aborted" ? "aborted" : last?.stopReason === "error" ? "error" : "completed";
+				// #947: a request that hit its output limit before any answer or tool call (reasoning alone can use it up)
+				// is a failure, not an empty success; with some text or a tool call it completes as before.
+				const outOfTokens = last?.stopReason === "length" && !last.content?.some((part) => part?.type === "toolCall" || (part?.type === "text" && part.text))
+					? `The model used all ${state.active?.maxTokens ?? state.currentModel?.maxTokens} output tokens before answering. Lower the reasoning effort or raise the output limit.` : null;
+				const status = last?.stopReason === "aborted" ? "aborted" : last?.stopReason === "error" || outOfTokens ? "error" : "completed";
 				// #379 / 16q: an acknowledged Studio Stop whose held tool already settled
 				// with a real structured outcome (tool.done above) calls `abort(reason,
 				// { quiet: true })` purely to stop the model from being prompted again —
@@ -493,10 +498,10 @@ export function createAgentRunner({ models: suppliedModels, sessionStore, tools
 					const rawMessage = last?.errorMessage || (status === "aborted" ? "The turn was aborted." : "The model or live editor could not complete this turn.");
 					const truncated = /ended before a terminal response event/i.test(rawMessage);
 					const classified = status === "aborted" ? { code: "aborted", status: undefined } : classifyError({ message: rawMessage });
-					const code = status === "aborted" ? "aborted" : truncated ? "truncated" : classified.code;
+					const code = status === "aborted" ? "aborted" : truncated || outOfTokens ? "truncated" : classified.code;
 					const detail = sanitizeUpstreamDetail(JSON.stringify({ message: rawMessage }));
 					const fallback = code === "aborted" ? "The turn was aborted." : code === "truncated" ? "The model stream ended before a terminal response event." : "The model or live editor could not complete this turn.";
-					queue.push({ type: "error", code, message: detail || fallback, ...(classified.status ? { status: classified.status } : {}) });
+					queue.push({ type: "error", code, message: outOfTokens || detail || fallback, ...(classified.status ? { status: classified.status } : {}) });
 				}
 				queue.push({ type: "done", usage: { ...state.active.usage }, ...(state.lastInput?.reportCost ? { cost: state.active.cost ?? 0 } : {}) });
 				queue.close();

package/bin/agent/openai-compatible-provider.mjs

@@ -33,6 +33,29 @@ function endpointModel(id, base) {
 	};
 }
 
+/** Moonshot's own API (#947): a host check on the address, nothing else. */
+export const isMoonshotBase = (base) => { try { return /^api\.moonshot\.(ai|cn)$/.test(new URL(base).hostname); } catch { return false; } };
+// The documented default output limit for Kimi K3 models; the catalog's 1048576 is the context window.
+const KIMI_K3_MAX_TOKENS = 131072;
+
+/** A Kimi K3 model on Moonshot's API (#947), or null. It always reasons (low/high/max, never off) and needs its
+ * reasoning_content sent back, so it takes pi-ai's catalog kimi-k3 as its template, with a larger output limit than
+ * the generic 8192 that its reasoning alone can use up. Null when the catalog has no template: the generic shape. */
+export async function moonshotModel(id, base, moonshot = isMoonshotBase(base)) {
+	if (!moonshot || !/^kimi-k3/.test(id)) return null;
+	try {
+		const cn = new URL(base).hostname.endsWith(".cn");
+		const catalog = cn
+			? (await import("@earendil-works/pi-ai/providers/moonshotai-cn.models")).MOONSHOTAI_CN_MODELS
+			: (await import("@earendil-works/pi-ai/providers/moonshotai.models")).MOONSHOTAI_MODELS;
+		const template = catalog?.["kimi-k3"];
+		if (!template?.compat) return null;
+		return { ...structuredClone(template), id, name: id, provider: OPENAI_COMPATIBLE_ID, baseUrl: v1(base), maxTokens: KIMI_K3_MAX_TOKENS };
+	} catch { return null; }
+}
+
+const serverModel = async (id, base) => (await moonshotModel(id, base)) ?? endpointModel(id, base);
+
 /** The server's model ids, or an error that says what went wrong in words the login and the picker can show. */
 async function listEndpoint(base, key, signal) {
 	let data;
@@ -82,7 +105,7 @@ export async function openaiCompatibleProvider() {
 		api: { "openai-completions": completionsApi },
 		fetchModels: async ({ credential, signal }) => {
 			const base = credential?.env?.[BASE_ENV];
-			return base ? (await listEndpoint(base, credential.key, signal)).map((id) => endpointModel(id, base)) : [];
+			return base ? Promise.all((await listEndpoint(base, credential.key, signal)).map((id) => serverModel(id, base))) : [];
 		},
 	});
 }

package/dist/app/index.html

@@ -34,14 +34,14 @@
     <title>CozyClay Studio — 3D staging and previs in your browser</title>
 
     <script defer src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "6a4384d1375d4ffc8a30a6346a8ad1a0"}'></script>
-    <script type="module" crossorigin src="/assets/app-CTKcyPM-.js"></script>
+    <script type="module" crossorigin src="/assets/app-DxoI941o.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-hePW80VL.js">
-    <link rel="modulepreload" crossorigin href="/assets/task-board-CkLZGPkv.js">
+    <link rel="modulepreload" crossorigin href="/assets/task-board-5PKn7ZaA.js">
     <link rel="modulepreload" crossorigin href="/assets/fflate.module-KbGj5-H6.js">
-    <link rel="modulepreload" crossorigin href="/assets/scene-asset-sync-t45pWCyq.js">
-    <link rel="modulepreload" crossorigin href="/assets/motion3-compile-Du7UXrWn.js">
+    <link rel="modulepreload" crossorigin href="/assets/scene-asset-sync-LeI3eSnO.js">
+    <link rel="modulepreload" crossorigin href="/assets/motion3-compile-B4SX4TGx.js">
     <link rel="stylesheet" crossorigin href="/assets/scene-asset-sync-BEjjhNEo.css">
-    <link rel="stylesheet" crossorigin href="/assets/app-CEP7jzXB.css">
+    <link rel="stylesheet" crossorigin href="/assets/app-Dige7q3X.css">
   </head>
   <body>
     <div id="root">

package/dist/assets/TaskBoard-BUjjuvm5.js

@@ -0,0 +1 @@
+import{r as e}from"./rolldown-runtime-hePW80VL.js";import{Za as t,c as n,d as r,f as i,l as a,m as o,o as s,ua as c,v as l}from"./task-board-5PKn7ZaA.js";import{o as u,r as d,t as f}from"./motion3-compile-B4SX4TGx.js";var p=e(t(),1),m=2e3,h=(e,t)=>new Promise(n=>{let r=setTimeout(n,e);t.addEventListener(`abort`,()=>{clearTimeout(r),n()},{once:!0})});function g(e,t){(0,p.useEffect)(()=>{let n=new Map;for(let[r,i]of Object.entries(e))for(let e of i)n.set(e,t[r]??r);let r=()=>{for(let e of document.querySelectorAll(`[data-node-id]`)){let t=n.get(e.getAttribute(`data-node-id`));t?(e.setAttribute(`data-task-scope`,t),e.setAttribute(`title`,c(`In task: ${t}`,`작업 중: ${t}`,`任务中：${t}`))):e.hasAttribute(`data-task-scope`)&&(e.removeAttribute(`data-task-scope`),e.removeAttribute(`title`))}};r();let i=new MutationObserver(r);return i.observe(document.body,{childList:!0,subtree:!0}),()=>{i.disconnect(),n.clear(),r()}},[e,t])}function _({sessionId:e,pulse:t,labelOf:c,onMainNote:_}){let v=(0,p.useMemo)(()=>s(),[]),y=u(),[b,x]=(0,p.useReducer)((e,t)=>t.seed?o(e,t.seed):t.reset?n():r(e,t.event),void 0,n),[S,C]=(0,p.useState)({}),[w,T]=(0,p.useState)(f),E=(0,p.useRef)(0),D=(0,p.useRef)(_);(0,p.useEffect)(()=>{E.current=b.after,D.current=_},[b.after,_]),(0,p.useEffect)(()=>{x({reset:!0}),E.current=0},[e]),(0,p.useEffect)(()=>d(T),[]),(0,p.useEffect)(()=>y.subscribe(e=>{typeof e?.type!=`string`||!e.type.startsWith(`task.`)||(C(t=>i(t,e)),(e.type===`task.userEdit`||e.type===`task.undone`)&&x({event:e}))}),[y]),(0,p.useEffect)(()=>{if(!e)return;let t=new AbortController;return(async()=>{for(;!t.signal.aborted;){try{let{tasks:n}=await v.board(e);x({seed:n}),await v.events(e,E.current,e=>{if(e.type===`main.turn`&&e.turnId){let n=``;v.frames(e.turnId,e=>{e.type===`text.delta`&&(n+=e.text??``),e.type===`tool.start`&&(n=``)},t.signal).then(()=>D.current?.(n),()=>{})}x({event:e})},t.signal)}catch{}await h(m,t.signal)}})(),()=>t.abort()},[v,e,t]);let O=b.order.filter(e=>b.tasks[e]?.status===`running`&&b.tasks[e]?.turnId),k=O.map(e=>`${e}:${b.tasks[e].turnId}`).join();return(0,p.useEffect)(()=>{let e=O.map(e=>{let t=new AbortController,{turnId:n}=b.tasks[e];return v.frames(n,t=>{let n=a(t,c);n&&x({event:{type:`task.progress`,taskId:e,status:`running`,progress:n}})},t.signal).catch(()=>{}),t});return()=>e.forEach(e=>e.abort())},[v,k,c]),g(S,(0,p.useMemo)(()=>Object.fromEntries(b.order.map(e=>[e,b.tasks[e].title])),[b])),(0,p.useEffect)(()=>{l.set({client:v,labelOf:c,undo:async e=>{let t=await y.run(`task.undo`,{taskId:e});if(t?.ok===!1)throw Error(t.message??t.code);x({event:{type:`task.undone`,taskId:e}})}})},[y,v,c]),(0,p.useEffect)(()=>{l.set({board:b,activity:w})},[b,w]),(0,p.useEffect)(()=>()=>l.set({board:n(),open:null}),[e]),null}export{_ as default};