cozyclay 2.0.0 → 2.0.2

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # Changelog
 
+## 2.0.2
+
+The first-run audit release: `npx cozyclay` is exercised end to end as a new
+user, and the things that broke on that path are fixed. 2.0.1 (the camera
+tutorial refresh and light-mode default, #586) was tagged but never reached
+npm; this release carries it.
+
+Agent and package
+
+- The Studio Agent panel in the npm package answered every turn with
+  "502 — agent unavailable": the sidecar's Studio tools imported `three`
+  (a devDependency the package does not ship) through `src/scenes.js`. The
+  timeline clock moved to its own module and a test now walks every import
+  reachable from `bin/` and fails on any chain to `three`. (#591)
+- A CLIProxy key in the environment no longer leaves the panel on the ChatGPT
+  sign-in wall; readiness counts every key-authenticated provider. (#591)
+- `CCLAY_KIMODO_HOST=… npx cozyclay` died at start with
+  `Cannot find package 'three'`: the motion bridge now runs from the staged
+  MCP runtime (which carries `three`, `tools/` and `dist/models`), and the
+  package isolation test keeps it that way. (#591)
+- A live-hub port already taken by another CozyClay is reported on the
+  launcher's terminal and named in the pane's error instead of
+  "Studio execution is not installed"; agent handler failures are logged
+  before the 502; a session id with no record no longer shows
+  "Previous conversation could not be restored". (#591)
+
+Studio
+
+- Create on the start screen opens the selected sample scene under the typed
+  name instead of an empty stage named after it; starting over with unsaved
+  work asks first. (#591)
+- Reloading a project created from the start screen brought the previous
+  session's walking take back onto the character, with "Unsaved changes":
+  the hosted-demo seed re-fired on every mount while the bridge probe was
+  down. It now skips a saved project (a `?scene=` launch still seeds), and a
+  reload opens on the clean checkpoint. (#591)
+- With a take installed, the gizmo and the Transform panel's Position and
+  Rotation move the character again; the take keeps animating relative to
+  the new placement. (#591)
+- The shot card's hover actions sit above the card, so clicking a short
+  shot's name selects it instead of hitting Delete. Draw rail is disabled
+  with a reason when no shot is selected. (#591)
+
+Tests
+
+- The start-screen and project-menu browser suites run against the v2
+  shell again, gain the sample-card Create regression, and join the CI
+  browser matrix as observation suites; new regressions cover the package
+  import graph, CLIProxy readiness, the stage transform and the reload
+  session. (#591)
+
+## 2.0.1
+
+- The camera tutorial follows the v2 shell and new installs default to the
+  light theme. (#586)
+
 ## 2.0.0
 
 CozyClay 2.0 is the v2 editor: a floating-glass shell with light and dark

package/bin/agent/agent-routes.mjs

@@ -249,7 +249,12 @@ function liveToolsRuntime(mcpRuntime) {
 	return liveToolsModules(mcpRuntime).then(async ([registry, { startLiveHub }]) => {
 		const owner = liveHubOwner();
 		const token = randomBytes(32).toString("hex");
-		const liveHub = await startLiveHub(Number(process.env.COZYCLAY_LIVE_PORT ?? 5184), { token, owner });
+		const livePort = Number(process.env.COZYCLAY_LIVE_PORT ?? 5184);
+		const liveHub = await startLiveHub(livePort, { token, owner });
+		// EADDRINUSE comes back as null: another CozyClay (or its dev server) owns
+		// the port, and the Studio page is built to connect to that port, so the
+		// pane would answer every turn with a misleading capability error.
+		if (!liveHub) console.error(`cozyclay: live hub port ${livePort} is already in use (another CozyClay or its dev server?); the Agent pane cannot drive this Studio until that port is free.`);
 		registry.setLiveHub(liveHub);
 		const handlers = registry.createToolHandlers().map((tool) => ({
 			...tool,
@@ -270,7 +275,7 @@ function liveToolsRuntime(mcpRuntime) {
 			publishLiveEndpoint({ port: liveHub.port, token, owner });
 			liveHub.server?.once("close", () => removeLiveEndpoint(liveHub.port));
 		}
-		return { liveHub, handlers };
+		return { liveHub, handlers, hubPortBusy: !liveHub ? livePort : null };
 	}).catch((error) => {
 		// The pane answers CAPABILITY_MISSING on use; the reason belongs on the
 		// launcher's terminal rather than nowhere.
@@ -425,6 +430,7 @@ export function createAgentHandler({ auth = defaultAuth, codex, models, codexBas
 			await session.modelSession?.abort?.("studio stop", acknowledged ? { quiet: true } : undefined);
 			json(res, 200, { ok: true, status: jobId ? "stopped" : "detached", ...(outcome ? { outcome: { status: outcome.status ?? null, code: outcome.code ?? null, mutated: outcome.mutated ?? null } } : {}) }); return true;
 		}
+		if (!studioRuntime && !hub && hubDeps.hubPortBusy) throw new StudioProtocolError("CAPABILITY_MISSING", `The Studio live hub could not start: port ${hubDeps.hubPortBusy} is in use by another CozyClay or its dev server. Free that port and relaunch.`);
 		if (!studioRuntime && (!hub?.command || !hub?.workspaceId)) throw new StudioProtocolError("CAPABILITY_MISSING", "Studio execution is not installed.");
 		if (!value.context.host.workspaceHandle) throw new StudioProtocolError("LIVE_HUB_UNAVAILABLE", "A connected editor handle is required.");
 		let session = studioSessions.get(value.sessionId);

package/bin/codex-auth.mjs

@@ -6,6 +6,7 @@ import { join } from "node:path";
 import { openBrowser } from "./open-browser.mjs";
 import { writeSecureJson } from "./agent/secure-file.mjs";
 import { readKeys } from "./agent/provider-keys.mjs";
+import { PROVIDERS } from "./agent/providers.mjs";
 
 export const AUTHORIZE_ENDPOINT = "https://auth.openai.com/oauth/authorize";
 export const TOKEN_ENDPOINT = "https://auth.openai.com/oauth/token";
@@ -51,7 +52,7 @@ const decodeJwt = (value) => { try { return JSON.parse(Buffer.from(value.split("
 const claims = () => decodeJwt(readTokens()?.id_token || "");
 function providersConfigured() {
 	const configured = new Set();
-	for (const name of ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "GEMINI_API_KEY", "GOOGLE_API_KEY", "OPENROUTER_API_KEY"]) if (process.env[name]?.trim()) configured.add(name);
+	for (const provider of PROVIDERS) for (const name of provider.env) if (process.env[name]?.trim()) configured.add(provider.id);
 	for (const [id, value] of Object.entries(readKeys())) if (typeof value === "string" && value.trim()) configured.add(id);
 	return configured.size;
 }

package/bin/cozyclay.mjs

@@ -407,10 +407,13 @@ process.on("SIGTERM", () => shutdown(143));
 
 if (opts.motion && kimodoHost && existsSync(BRIDGE)) {
 	try {
+		// The package has no three (a devDependency); the bridge runs from the
+		// staged MCP runtime, which carries three, tools/ and src/.
+		const bridgeRoot = SOURCE_CHECKOUT ? PKG_ROOT : await ensureMcpRuntime();
 		({ child: bridge, port: bridgePort } = await startBridge({
 			command: process.execPath,
-			args: [BRIDGE],
-			cwd: PKG_ROOT,
+			args: [join(bridgeRoot, "tools", "ardy", "bridge.mjs")],
+			cwd: bridgeRoot,
 			env: process.env,
 			mainPort: opts.port,
 			onSpawn: (child) => {
@@ -431,6 +434,7 @@ if (opts.motion && kimodoHost && existsSync(BRIDGE)) {
 		}));
 	} catch (err) {
 		console.error(`cozyclay: motion generation sidecar failed: ${err.message}`);
+		for (const line of err.lines ?? []) console.error(`cozyclay: ${line}`);
 		console.error("cozyclay: studio did not start; set COZYCLAY_BRIDGE_PORT to an available port or use --no-motion.");
 		if (bridge) await terminateOwned(bridge);
 		process.exit(1);
@@ -455,7 +459,12 @@ server = createServer((req, res) => {
 		return;
 	}
 	if (url.pathname.startsWith("/agent/")) {
-		void agentHandler(req, res, url.pathname).then((handled) => { if (!handled && !res.writableEnded) { res.writeHead(404); res.end(); } }).catch(() => { if (!res.headersSent) { res.writeHead(502); res.end(JSON.stringify({ error: "agent unavailable" })); } });
+		void agentHandler(req, res, url.pathname).then((handled) => { if (!handled && !res.writableEnded) { res.writeHead(404); res.end(); } }).catch((error) => {
+			// The pane only sees "502 — agent unavailable"; the reason belongs on
+			// the launcher's terminal rather than nowhere.
+			console.error(`cozyclay: agent request ${url.pathname} failed: ${error?.message ?? error}`);
+			if (!res.headersSent) { res.writeHead(502); res.end(JSON.stringify({ error: "agent unavailable" })); }
+		});
 		return;
 	}
 	if (url.pathname === "/__cozyclay/telemetry") {

package/bin/mcp-runtime.mjs

@@ -18,6 +18,7 @@ const MCP_RUNTIME = process.env.COZYCLAY_MCP_RUNTIME_DIR || join(
 function probeMcpRuntime(runtime = MCP_RUNTIME) {
 	const server = join(runtime, "mcp", "server.mjs");
 	if (!existsSync(server)) throw new Error("MCP server is missing");
+	if (!existsSync(join(runtime, "tools", "ardy", "bridge.mjs"))) throw new Error("motion bridge is missing");
 	const runtimeRequire = createRequire(join(runtime, "package.json"));
 	for (const dependency of ["@modelcontextprotocol/sdk/server/mcp.js", "three", "ws", "zod"]) runtimeRequire.resolve(dependency);
 	return server;
@@ -46,6 +47,15 @@ function installMcpRuntime() {
 		// The server publishes its live endpoint file from this module.
 		copyFileSync(join(PKG_ROOT, "bin", "live-endpoint.mjs"), join(staging, "bin", "live-endpoint.mjs"));
 		cpSync(join(PKG_ROOT, "src"), join(staging, "src"), { recursive: true });
+		// The motion bridge imports three, which only this runtime resolves, so the
+		// package launches it from here; its out/ scratch dirs are never copied.
+		for (const dir of ["ardy", "kimodo", "projflow"]) {
+			cpSync(join(PKG_ROOT, "tools", dir), join(staging, "tools", dir), { recursive: true, filter: (path) => basename(path) !== "out" });
+		}
+		copyFileSync(join(PKG_ROOT, "tools", "process-supervisor.mjs"), join(staging, "tools", "process-supervisor.mjs"));
+		// gvhmr-floor.mjs loads its FBX rigs from ../../{public,dist}/models.
+		const models = join(PKG_ROOT, "dist", "models");
+		if (existsSync(models)) cpSync(models, join(staging, "dist", "models"), { recursive: true });
 
 		const npm = process.platform === "win32" ? "npm.cmd" : "npm";
 		const child = spawn(npm, ["ci", "--no-audit", "--no-fund"], {

package/dist/app/index.html

@@ -34,13 +34,13 @@
     <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-CA55tcI3.js"></script>
+    <script type="module" crossorigin src="/assets/app-BxBLC6GT.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-hePW80VL.js">
     <link rel="modulepreload" crossorigin href="/assets/analytics-MVZOEW8O.js">
     <link rel="modulepreload" crossorigin href="/assets/first-shot-handoff-DgT28ZiV.js">
-    <link rel="modulepreload" crossorigin href="/assets/shot-prompt-Yrt99wZx.js">
+    <link rel="modulepreload" crossorigin href="/assets/shot-prompt-hN0j_O-p.js">
     <link rel="stylesheet" crossorigin href="/assets/shot-prompt-CbqWcWYi.css">
-    <link rel="stylesheet" crossorigin href="/assets/app-C1sdVbg4.css">
+    <link rel="stylesheet" crossorigin href="/assets/app-CJdxvnrl.css">
   </head>
   <body>
     <div id="root">