cozyclay 1.9.0 → 2.0.0

package/dist/cozyclay-package.json

@@ -1 +1 @@
-{"payload":"{\"distribution\":\"npm\",\"package\":\"cozyclay\",\"version\":\"1.9.0\",\"repository\":\"NomaDamas/CozyClay\",\"content_sha256\":\"23d024bcbaab90240eba74f15829cde20e5647557d3d47a419c84662308762c6\"}","signature":"drtYdytc0gTfOfzIvj5Ca0me8xnmJqrdyF/O8DjO821uAAbszX0Fk2WP/Ai6rQOMjL9jWNw3JEhNKyQzIUGSAw=="}
+{"payload":"{\"distribution\":\"npm\",\"package\":\"cozyclay\",\"version\":\"2.0.0\",\"repository\":\"NomaDamas/CozyClay\",\"content_sha256\":\"2df2a5c5568a32133c5f4efc43abbd1ecb7bd07d89538eb6860a24afe12a98c5\"}","signature":"stRY9RUg5dAQVwVhfhYrieP1HpXK+ahX3U5g8qFMzsQYw2ZFEF+iXRblkvYNjk5MS2g43qKAEMN9F8K0MP3vAA=="}

package/dist/fonts/IBM-Plex-Sans-OFL.txt

@@ -0,0 +1,92 @@
+Copyright © 2017 IBM Corp. with Reserved Font Name "Plex"
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/fonts/JetBrains-Mono-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/fonts/README.md

@@ -1,15 +1,19 @@
 # Bundled fonts
 
 The `.woff2` files in this directory are redistributed with CozyClay under the
-SIL Open Font License 1.1, which permits bundling them with software provided
-each copy carries the copyright notice and the licence. Those are the two
-`-OFL.txt` files here; keep them alongside the fonts.
+SIL Open Font License 1.1. Each family has its upstream OFL text beside the
+font files. The existing Inter and Instrument Serif files remain until their
+later cleanup todo.
 
-| File | Family | Copyright | Licence |
-| --- | --- | --- | --- |
-| `inter-latin.woff2` | [Inter](https://github.com/rsms/inter) | Copyright (c) 2016 The Inter Project Authors | [OFL-1.1](Inter-OFL.txt) |
-| `instrument-serif-latin.woff2`, `instrument-serif-italic-latin.woff2` | [Instrument Serif](https://github.com/Instrument/instrument-serif) | Copyright 2022 The Instrument Serif Project Authors | [OFL-1.1](InstrumentSerif-OFL.txt) |
+| Files | Family | Upstream release | Copyright | Licence |
+| --- | --- | --- | --- | --- |
+| `ibm-plex-sans-400-latin.woff2`, `ibm-plex-sans-500-latin.woff2`, `ibm-plex-sans-600-latin.woff2` | IBM Plex Sans | [`@ibm/plex-sans@1.1.0`](https://github.com/IBM/plex/releases/tag/%40ibm/plex-sans%401.1.0) ([asset](https://github.com/IBM/plex/releases/download/%40ibm/plex-sans%401.1.0/ibm-plex-sans.zip)) | Copyright (c) 2017 IBM Corp. with Reserved Font Name "Plex" | [OFL-1.1](IBM-Plex-Sans-OFL.txt) |
+| `jetbrains-mono-400-latin.woff2`, `jetbrains-mono-500-latin.woff2` | JetBrains Mono | [`v2.304`](https://github.com/JetBrains/JetBrainsMono/releases/tag/v2.304) ([asset](https://github.com/JetBrains/JetBrainsMono/releases/download/v2.304/JetBrainsMono-2.304.zip)) | Copyright 2020 The JetBrains Mono Project Authors | [OFL-1.1](JetBrains-Mono-OFL.txt) |
+| `inter-latin.woff2` | [Inter](https://github.com/rsms/inter) | existing bundle | Copyright (c) 2016 The Inter Project Authors | [OFL-1.1](Inter-OFL.txt) |
+| `instrument-serif-latin.woff2`, `instrument-serif-italic-latin.woff2` | [Instrument Serif](https://github.com/Instrument/instrument-serif) | existing bundle | Copyright 2022 The Instrument Serif Project Authors | [OFL-1.1](InstrumentSerif-OFL.txt) |
 
-Both are subsets. Under OFL a modified copy may not use the Reserved Font Name,
-so if a subset is ever renamed or edited beyond subsetting, check clause 3 before
+The IBM Plex Sans files are the upstream Latin1 webfont subsets. Korean text
+continues through the Pretendard and Noto Sans KR fallbacks in `--sans`.
+Under the OFL, a modified copy may not use the Reserved Font Name, so if a
+subset is ever renamed or edited beyond subsetting, check clause 3 before
 shipping it.

package/dist/index.html

@@ -272,9 +272,9 @@
         header.site nav { gap: 14px; width: 100%; margin-left: 0; padding-bottom: 10px; }
       }
     </style>
-    <script type="module" crossorigin src="/assets/landing-IbRp3FnQ.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/analytics-B1hnH66c.js">
-    <link rel="modulepreload" crossorigin href="/assets/first-shot-handoff-CGgnvNu8.js">
+    <script type="module" crossorigin src="/assets/landing-BaXkpFip.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/analytics-MVZOEW8O.js">
+    <link rel="modulepreload" crossorigin href="/assets/first-shot-handoff-DgT28ZiV.js">
   </head>
   <body>
     <header class="site">
@@ -331,7 +331,7 @@
           <a class="btn ghost" href="https://github.com/NomaDamas/CozyClay">View on GitHub</a>
         </div>
         <p class="note">
-          Or run it on your machine: <code>npx cozyclay</code>. No Blender, no Unity. Open a saved <code>.cclayproject</code> from the first dialog.
+          Or run it on your machine: <code>npx cozyclay --via site</code>. No Blender, no Unity. Open a saved <code>.cclayproject</code> from the first dialog.
         </p>
       </div>
 
@@ -343,7 +343,7 @@
           <button class="playground-cover" id="playground-start" type="button" aria-label="Start the playground">
             <span class="btn primary">Play with the scene</span>
             <small>Loads the studio in this box (about 2 MB)</small>
-            <span class="playground-phone">Needs a mouse and keyboard. Come back on a computer, or run <code>npx cozyclay</code>.</span>
+            <span class="playground-phone">Needs a mouse and keyboard. Come back on a computer, or run <code>npx cozyclay --via site</code>.</span>
           </button>
           <div class="playground-loading">Loading the studio…</div>
           <div class="tutorial-card" id="tutorial-card" aria-live="polite">
@@ -354,7 +354,7 @@
         <div class="playground-bar">
           <div class="tutorial-done" id="tutorial-done" hidden>
             <p>Take your shot with you. Video export is not offered in this embedded Playground.</p>
-            <p>Download your edited project, run <code>npx cozyclay</code>, and open the downloaded <code>.cclayproject</code> in the local Studio. Use its existing Export menu for video.</p>
+            <p>Download your edited project, run <code>npx cozyclay --via playground</code>, and open the downloaded <code>.cclayproject</code> in the local Studio. Use its existing Export menu for video.</p>
             <button type="button" id="playground-download" class="copy">Download my project</button>
             <button type="button" id="playground-handoff-dismiss">Continue editing</button>
           </div>
@@ -392,7 +392,7 @@
       <section id="start">
         <h2>Quick start</h2>
         <p class="sub">Node.js 22.13+ and a Chromium browser.</p>
-        <pre class="with-copy"><code>npx cozyclay</code><button type="button" class="copy" data-copy="npx cozyclay">Copy</button></pre>
+        <pre class="with-copy"><code>npx cozyclay --via site</code><button type="button" class="copy" data-copy="npx cozyclay --via site">Copy</button></pre>
         <p class="sub">Or from source:</p>
         <pre><code>git clone https://github.com/NomaDamas/CozyClay.git
 cd CozyClay

package/dist/privacy/index.html

@@ -85,6 +85,8 @@
           CLI restarts, ports and browser storage resets. The browser's memory-only SDK starts with this
           anonymous ID on each launch. Independent state files receive independent random IDs, without
           fingerprinting, account linking or cross-device matching; do not copy the state file between users.
+          A copied start command such as <code>npx cozyclay --via site</code> stores that one source label
+          with the first-launch receipt instead of asking where you heard about CozyClay.
           Prompt text, asset names,
           file names, project content, local paths and any user-entered text are never collected. Session
           duration and action counts are bucketed. Source checkouts, forks, development servers, CI and tests
@@ -129,20 +131,20 @@ cclay telemetry on</code></pre>
           <table>
             <thead><tr><th>Event</th><th>Purpose</th></tr></thead>
             <tbody>
-              <tr><td>install:first_launch, app:session_started, app:session_ended</td><td>Counting installs and sessions; duration and action counts are bucketed</td></tr>
-              <tr><td>feature:used</td><td>One signal per feature per session</td></tr>
+              <tr><td>install:first_launch, app:session_started, app:session_ended</td><td>Counting installs and sessions; duration and action counts are bucketed. install:first_launch may carry heard_from (x, hn, reddit, github, friend, other, site or playground), from the first-launch prompt or a copied <code>npx cozyclay --via</code> command. app:session_ended also carries per-session edit gesture counts in five groups, pose_edit_bucket, camera_edit_bucket, object_edit_bucket, shot_edit_bucket and prompt_edit_bucket, each bucketed (0, 1-3, 4-10 or gte11); never what was edited</td></tr>
+              <tr><td>feature:used</td><td>One signal per feature per session: a fixed feature name such as pose_edit (a real bone or pose change), pose_save (saving a pose to the library), fal_motion_open (opening the AI video A/B card), camera_fly or export_video</td></tr>
               <tr><td>$pageview, scene:created, scene:loaded, craft:first_action, activation:completed</td><td>Funnel and drop-off analysis</td></tr>
               <tr><td>craft:first_edit</td><td>First successful Studio authoring change per editor mount; only a fixed edit-kind label and definition version 1 (not camera navigation, playback, loading, restore, or undo/redo)</td></tr>
               <tr><td>playground:first_edit</td><td>The same versioned first-edit definition for Playground, counted separately from Studio; no prompts or scene contents</td></tr>
               <tr><td>project:saved, project:opened</td><td>Whether people keep their work (object counts and ages are bucketed; never names or paths)</td></tr>
               <tr><td>motion:backend_state</td><td>Session capability baseline: backend (none, local_kimodo or hosted) and boolean host_configured, never a host address</td></tr>
-              <tr><td>motion:generate_requested</td><td>Explicit generation intent, not prompt-block editing: initiating surface (timeline, line_edit, trail or mcp), input_mode (prompt, pose or edit) and an ephemeral random request_id</td></tr>
-              <tr><td>motion:preflight_blocked</td><td>Request readiness refusal: request_id, surface and normalized reason (unconfigured, unreachable or unsupported_route)</td></tr>
-              <tr><td>motion:preflight_passed</td><td>Request readiness accepted, before job start: request_id, surface and backend (none, local_kimodo or hosted)</td></tr>
+              <tr><td>motion:generate_requested</td><td>Explicit generation intent, not prompt-block editing: initiating surface (timeline, line_edit, trail, mcp, fal_card or agent), input_mode (prompt, pose, edit, a_to_b or still) and an ephemeral random request_id</td></tr>
+              <tr><td>motion:preflight_blocked</td><td>Request readiness refusal: request_id, surface and normalized reason (unconfigured, unreachable, unsupported_route, locked or missing_input). locked means the AI video route is not enabled for the account yet; missing_input means the A/B captures were incomplete</td></tr>
+              <tr><td>motion:preflight_passed</td><td>Request readiness accepted, before job start: request_id, surface and backend (none, local_kimodo, hosted or fal)</td></tr>
               <tr><td>motion:job_started</td><td>Generation execution started: request_id, backend and input_mode</td></tr>
               <tr><td>motion:job_succeeded</td><td>Generation completed before result application: request_id, backend, input_mode and bucketed duration_bucket (lt1s, 1-3s, 3-10s, 10-30s or gte30s)</td></tr>
-              <tr><td>motion:job_failed</td><td>Generation failure or real cancellation: request_id, backend, input_mode, duration_bucket and normalized error_code (aborted, unsupported_route, generation_failed or unknown), never raw error messages</td></tr>
-              <tr><td>motion:result_applied</td><td>A generated result was applied to its requesting character: request_id and backend. Job success alone does not prove application.</td></tr>
+              <tr><td>motion:job_failed</td><td>Generation failure or real cancellation: request_id, backend, input_mode, duration_bucket and normalized error_code (aborted, unsupported_route, generation_failed, quota or unknown), never raw error messages</td></tr>
+              <tr><td>motion:result_applied</td><td>A generated result was applied to its requesting character: request_id and backend. For the fal AI video route, applied means the generated clip was loaded into the Studio for extraction. Job success alone does not prove application.</td></tr>
               <tr><td>workflow:run_requested</td><td>Workflow execution requests: surface (workflow), ephemeral run_id and node_count_bucket (0, 1-3, 4-10 or gte11). No graph contents, node labels or outputs.</td></tr>
               <tr><td>workflow:run_succeeded, workflow:run_failed, workflow:run_cancelled</td><td>Workflow outcomes paired by run_id, with duration_bucket (lt1s, 1-3s, 3-10s, 10-30s or gte30s); failures and actual cancellations also include failure_code (aborted, capture_failed, generation_failed or unknown). Starting another run does not imply cancellation.</td></tr>
               <tr><td>workflow:result_applied</td><td>Captured or generated image/video output was written to the Workflow canvas: run_id only, at most once per run, independently of a later failure. No image bytes or output contents.</td></tr>
@@ -157,6 +159,9 @@ cclay telemetry on</code></pre>
               <tr><td>export:attempt_started, export:attempt_succeeded, export:attempt_failed, export:attempt_cancelled</td><td>Export attempts and outcomes, paired by an ephemeral random attempt_id; export_kind (video, depth_video, frame or keyframe_pack), format (mp4, png or zip) and initiating surface (studio, workflow or embed). Terminal events include a bucketed duration_bucket; failures and real cancellations include only a normalized failure_code (unsupported_codec, encode_failed, render_failed, aborted or unknown), never raw error messages, filenames, URLs, paths, prompts or scene content. Success means pipeline completion or download handoff, not confirmation that the OS saved a file.</td></tr>
               <tr><td>export:keyframe_pack</td><td>Legacy Workflow pack handoffs, with numeric entries count and source=workflow; not an additional export attempt</td></tr>
               <tr><td>playground:opened, playground:first_action</td><td>Whether the home-page playground gets used</td></tr>
+              <tr><td>app:error</td><td>Uncaught errors and unhandled promise rejections, at most ten distinct per session: error_kind (error or unhandled_rejection), error_type (a built-in name such as TypeError or DOMException, other or non_error), error_source (app, extension, external or unknown) and, only for the app's own scripts, error_file (the bundle file name), error_line and error_col. Never the error message, stack text, URLs, query strings, paths, prompts or scene content.</td></tr>
+              <tr><td>device:profile</td><td>Once per session, whether the studio can run smoothly: gpu_vendor (nvidia, amd, intel, apple, qualcomm, arm, software, other or unknown), gpu_class (discrete, integrated, software or unknown), webgl (webgl2, webgl1 or none), cpu_bucket (1-4, 5-8, 9-16, gte17 or unknown), memory_bucket (lt4, 4-7, gte8 or unknown) and frame_rate_bucket (lt20, 20-40, 40-55, gte55 or unknown) from one three-second sample. The GPU renderer string and exact hardware values never leave the browser.</td></tr>
+              <tr><td>survey:use_case</td><td>An optional question shown at most once after a successful export, only while telemetry is on: use_case (animation, film, game, ad_mv, personal, other or skip) and team (team, solo or skip). Closed choices only; no free text.</td></tr>
               <tr><td>hosted:composer_viewed, hosted:login_started, hosted:ticket_created, hosted:result_opened, hosted:opened_in_studio</td><td>Hosted demo funnel</td></tr>
               <tr><td>tutorial:started</td><td>Camera tutorial attempts on surface (studio or playground), with numeric tutorial_version 1 and start_source (query, settings or landing). Restarting starts a new attempt; no tutorial attempt identifier or user text is sent.</td></tr>
               <tr><td>tutorial:step_entered, tutorial:dismissed</td><td>Entered steps and explicit dismissal of an unfinished tutorial; surface (studio or playground), numeric tutorial_version 1 and step_kind (fly, walk, dolly, orbit, shot, rail or play). Missing completion can indicate abandonment or missing telemetry; browser close does not promise a dismissal event.</td></tr>
@@ -166,7 +171,7 @@ cclay telemetry on</code></pre>
           </table>
         </div>
         <p class="note">Motion request_id values are fresh random 32-character hexadecimal values, held only for one request; they are not persisted or derived from prompts, hosts, credentials, project content or other identifiers. The ambiguous motion:generate_blocked event stopped being emitted in the September 15, 2026 issue #273 contract. Historical events are not relabeled and are excluded from the new explicit-demand metric. Automatic line previews and prompt-block edits are not explicit Generate requests.</p>
-        <p class="note">Every regular app event and session-end beacon carries the same distribution (npm or hosted), app_version when available, origin_kind (local or hosted), internal_qa boolean, coarse operating-system label and, for npm sessions, install_kind (npx or global). PostHog's free plan retains events for one year.</p>
+        <p class="note">Every regular app event and session-end beacon carries the same distribution (npm or hosted), app_version when available, origin_kind (local or hosted), internal_qa boolean, coarse operating-system label and, for npm sessions, install_kind (npx or global) and update_status (latest, outdated or unknown), read from the package's own cached update check. PostHog's free plan retains events for one year.</p>
         <p class="note">Workflow run_id, Agent turn_id and MCP request_id values are fresh random 32-character hexadecimal values held only for one execution. Execution telemetry contains only closed categories, outcomes and elapsed-time buckets; missing telemetry is left unknown, and a disconnected MCP editor is not backfilled.</p>
       </section>
 

package/dist/sitemap.xml

@@ -2,26 +2,26 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://cozyclay.org/</loc>
-    <lastmod>2026-09-15</lastmod>
+    <lastmod>2026-10-01</lastmod>
   </url>
   <url>
     <loc>https://cozyclay.org/greybox-to-video/</loc>
-    <lastmod>2026-09-14</lastmod>
+    <lastmod>2026-10-01</lastmod>
   </url>
   <url>
     <loc>https://cozyclay.org/previs-software/</loc>
-    <lastmod>2026-09-10</lastmod>
+    <lastmod>2026-10-01</lastmod>
   </url>
   <url>
     <loc>https://cozyclay.org/seedance-camera-control/</loc>
-    <lastmod>2026-09-10</lastmod>
+    <lastmod>2026-10-01</lastmod>
   </url>
   <url>
     <loc>https://cozyclay.org/ai-camera-control/</loc>
-    <lastmod>2026-09-10</lastmod>
+    <lastmod>2026-10-01</lastmod>
   </url>
   <url>
     <loc>https://cozyclay.org/privacy/</loc>
-    <lastmod>2026-09-15</lastmod>
+    <lastmod>2026-10-01</lastmod>
   </url>
 </urlset>

package/dist/workflow/index.html

@@ -8,12 +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-CVwzMhz2.js"></script>
+    <script type="module" crossorigin src="/assets/workflow-dNPGY9xz.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-hePW80VL.js">
-    <link rel="modulepreload" crossorigin href="/assets/analytics-B1hnH66c.js">
-    <link rel="modulepreload" crossorigin href="/assets/shot-prompt-CHUtw6af.js">
-    <link rel="stylesheet" crossorigin href="/assets/shot-prompt-C_g2BHVc.css">
-    <link rel="stylesheet" crossorigin href="/assets/workflow-DsudxKHF.css">
+    <link rel="modulepreload" crossorigin href="/assets/analytics-MVZOEW8O.js">
+    <link rel="modulepreload" crossorigin href="/assets/shot-prompt-Yrt99wZx.js">
+    <link rel="stylesheet" crossorigin href="/assets/shot-prompt-CbqWcWYi.css">
+    <link rel="stylesheet" crossorigin href="/assets/workflow-DRdwoDBT.css">
   </head>
   <body>
     <div id="workflow-root"></div>

package/mcp/LIVE-PROTOCOL.md

@@ -153,7 +153,7 @@ scene document already uses.
 | `remove_character` | `{ ref }` | `{ id }` | must refuse to empty the cast |
 | `place_object` | `{ kind, x?, z?, y?, rot?, name?, parent? }` | `{ id }` | `kind` from OBJECT_LIBRARY; optional `name` labels the object and optional `parent` attaches it under another object |
 | `import_asset` | `{ name, mimeType, dataUrl, placeAs, clay?, x?, y?, z?, rot?, height? }` | `{ assetId, objectId }` | decode `dataUrl` and store the bytes in the content-addressed asset store under `assetId`, then stand the result up through the Studio's own import pipeline. `placeAs: "cutout"` is a 1.8 m standee 2.6 m in front of the shot camera; `placeAs: "backdrop"` is the same card as a 5 m background plate 12 m down the shot camera's view ray, turned to face the lens (PNG, WebP, JPEG or GIF; `dataUrl` must be `data:image/…`; `mimeType` optional when the data URL carries it). `placeAs: "mesh"` imports a GLB, a Wavefront OBJ or an FBX (`data:model/gltf-binary`, `data:model/obj`, `data:model/fbx`, `data:text/plain` when `name` ends in `.obj` or `.fbx`, or `data:application/octet-stream`, and those same types as `mimeType`), fits height/footprint once, and stands the model on the floor. Omit both `x` and `z` to place it in front of the shot camera; if either is present, those are world metres and the missing axis is 0. Optional `rot` is yaw in degrees (omitted is 0, like the Import button). Optional `height` overrides the fitted standing size. Optional `y` is lift off the floor, applied after mint (`createMeshObject` always writes `y: 0`). Optional `clay: true` replaces file materials with matte clay. Bytes decide the format (glTF magic first, then FBX magic/`FBXVersion:`, then OBJ vertices). Exactly ONE undo entry: a single Ctrl+Z removes the placed object (the asset bytes stay, being content-addressed). This deliberately does NOT reuse the Workflow-tab scene sync, which writes the document without touching undo. |
-| `update_object` | `{ id, x?, y?, z?, rot?, rotX?, rotZ?, scale?, scaleX?, scaleY?, scaleZ?, color?, name?, height?, clay? }` | `{ id }` | `scale` sets all three axes; per-axis values override it; `name` renames the object. `height` is metres (cutout card height, or a mesh's fitted box height). `clay` is a boolean on mesh objects (file materials when false, matte clay when true). |
+| `update_object` | `{ id, x?, y?, z?, rot?, rotX?, rotZ?, scale?, scaleX?, scaleY?, scaleZ?, color?, name?, height?, clay?, hidden? }` | `{ id }` | `scale` sets all three axes; per-axis values override it; `name` renames the object. `height` is metres (cutout card height, or a mesh's fitted box height). `clay` is a boolean on mesh objects (file materials when false, matte clay when true). `hidden` shows or hides the prop without deleting it. |
 | `remove_object` | `{ id }` | `{ id }` | |
 | `group_objects` | `{ parent, children }` | `{ parent, children }` | attach every child under parent |
 | `ungroup_objects` | `{ children }` | `{ children }` | detach every child |

package/mcp/live-hub.mjs

@@ -7,98 +7,19 @@ import { mcpToolCategory } from "../src/execution-telemetry.js";
 import { WebSocket, WebSocketServer } from "ws";
 
 export const DEFAULT_COMMAND_TIMEOUT_MS = 5_000;
-/** A per-call override may extend a command, never past this ceiling: a hub
- * that waits longer than this can no longer tell a slow editor from a dead one. */
+/** A per-call override may extend a non-motion command, never past this ceiling. */
 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 MOTION_JOB_TTL_MS = 10 * 60_000;
-export const MOTION_JOB_POLL_INTERVAL_MS = 0;
-export const MAX_ACTIVE_MOTION_JOBS = 2;
-export const MAX_ACTIVE_MOTION_JOBS_PER_WORKSPACE = 1;
-
-const terminalMotionStatuses = new Set(["completed", "failed", "cancelled", "expired"]);
-
-/** MCP-internal job retention for push-only motion work. Its clock is injected
- * so expiry is deterministic without a polling loop or timing-based test. */
-export class MotionJobRegistry {
-	constructor({ clock = () => Date.now(), ttlMs = MOTION_JOB_TTL_MS } = {}) {
-		this.clock = clock;
-		this.ttlMs = ttlMs;
-		this.jobs = new Map();
-	}
-
-	create(workspaceId) {
-		this.cleanup();
-		const active = [...this.jobs.values()].filter((job) => !terminalMotionStatuses.has(job.status));
-		if (active.length >= MAX_ACTIVE_MOTION_JOBS) throw new Error(`Motion job capacity reached (${MAX_ACTIVE_MOTION_JOBS} active globally).`);
-		if (active.filter((job) => job.workspaceId === workspaceId).length >= MAX_ACTIVE_MOTION_JOBS_PER_WORKSPACE) {
-			throw new Error(`This workspace already has an active motion job.`);
-		}
-		const now = this.clock();
-		const job = {
-			taskId: randomUUID(), workspaceId, status: "queued", createdAt: now,
-			lastUpdatedAt: now, ttlMs: this.ttlMs, pollIntervalMs: MOTION_JOB_POLL_INTERVAL_MS,
-			cancel: null, expiresAt: null, outcome: null,
-			deliveredWorkspaceIds: new Set(),
-			installationStates: new Map(),
-		};
-		this.jobs.set(job.taskId, job);
-		return job;
-	}
-
-	task(job) {
-		return {
-			taskId: job.taskId, status: job.status, createdAt: job.createdAt,
-			lastUpdatedAt: job.lastUpdatedAt, ttlMs: job.ttlMs, pollIntervalMs: job.pollIntervalMs,
-		};
-	}
-
-	transition(job, status, outcome = null) {
-		this.cleanup();
-		job.status = status;
-		job.lastUpdatedAt = this.clock();
-		job.outcome = outcome;
-		job.expiresAt = terminalMotionStatuses.has(status) ? job.lastUpdatedAt + job.ttlMs : null;
-		if (job.expiresAt !== null) {
-			const timer = setTimeout(() => this.cleanup(), job.ttlMs);
-			timer.unref?.();
-		}
-		return this.task(job);
-	}
-
-	cancel(taskId, workspaceId) {
-		this.cleanup();
-		const job = this.jobs.get(taskId);
-		if (!job || job.workspaceId !== workspaceId || terminalMotionStatuses.has(job.status)) return null;
-		job.cancel?.();
-		return this.transition(job, "cancelled", { message: "Generation cancelled before editor delivery." });
-	}
-
-	forWorkspace(workspaceId) {
-		this.cleanup();
-		return [...this.jobs.values()].filter((job) =>
-			job.workspaceId === workspaceId && terminalMotionStatuses.has(job.status) && job.status !== "expired" && !job.deliveredWorkspaceIds.has(workspaceId));
-	}
-
-	cleanup() {
-		const now = this.clock();
-		for (const job of this.jobs.values()) {
-			if (job.expiresAt === null || now < job.expiresAt) continue;
-			if (job.status === "expired") {
-				this.jobs.delete(job.taskId);
-				continue;
-			}
-			job.status = "expired";
-			job.lastUpdatedAt = now;
-			job.outcome = { message: "Motion job outcome expired before this workspace reconnected." };
-			job.expiresAt = now + job.ttlMs;
-		}
-	}
-}
+export const STUDIO_COMMAND_TIMEOUT_MS = 30_000;
+const studioCommands = new Set([
+	"inspect_studio", "operate_studio", "arrange_objects", "arrange_characters", "patch_elements",
+	"frame_shot", "verify_result", "undo_edit", "read_studio_context", "resolve_studio_image",
+	"capture_framing_png", "reconcile_studio_command", "run_action",
+]);
 
 const mutationCommands = new Set([
 	"set_camera",
@@ -114,8 +35,8 @@ const mutationCommands = new Set([
 	"set_prompt_blocks",
 	"load_motion",
 	"load_scenes",
-	"operate_studio", "arrange_objects", "arrange_characters", "patch_elements", "frame_shot", "undo_edit",
-	"commit_motion_candidate", "import_asset",
+	"operate_studio", "arrange_objects", "arrange_characters", "patch_elements", "frame_shot", "undo_edit", "run_action",
+	"import_asset",
 ]);
 
 export class LiveMutationUncertainError extends Error {
@@ -217,8 +138,7 @@ export class LiveHub {
 	}
 
 	static commandTimeoutMs(name) {
-		if (name === "load_motion" || name === "prepare_motion_install") return LOAD_MOTION_TIMEOUT_MS;
-		if (name === "verify_motion_candidate" || name === "repair_motion_candidate") return 60_000;
+		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
@@ -226,6 +146,7 @@ export class LiveHub {
 		if (name === "capture_frame") return CAPTURE_FRAME_TIMEOUT_MS;
 		// A workflow run captures a frame and may generate an image upstream.
 		if (name === "run_workflow") return RUN_WORKFLOW_TIMEOUT_MS;
+		if (studioCommands.has(name)) return STUDIO_COMMAND_TIMEOUT_MS;
 		return DEFAULT_COMMAND_TIMEOUT_MS;
 	}
 
@@ -284,6 +205,7 @@ export class LiveHub {
 		let appliedEmitted = false;
 		let failure = null;
 		let description;
+		let studioContext;
 		let mutation;
 		let acknowledgedMutation = false;
 		const emitApplied = () => {
@@ -294,14 +216,30 @@ export class LiveHub {
 		const observer = {
 			hub: this, handle,
 			before(command) {
-				if (!LiveHub.commandMayMutate(command) || command === "load_motion") return false;
+				if (!LiveHub.commandMayMutate(command) || command === "load_motion" || command === "run_action") return false;
 				mutation = { name: command, before: mutationState(command, description), acknowledged: false };
 				description = undefined;
 				return mutation.before === undefined;
 			},
 			baseline(value) { if (mutation) mutation.before = mutationState(mutation.name, value); },
 			receipt(command, value) {
-				if (command === "describe") {
+				if (command === "inspect_studio") {
+					studioContext = value?.context;
+				} else if (command === "run_action") {
+					// The bus attests application itself. No legacy describe diff or
+					// post-ack read may turn an admitted refusal into uncertainty.
+					if (value?.ok === false) {
+						failure = value.mutated === "unknown" || value.code === "UNCERTAIN_APPLY" ? "uncertain" : "failed";
+					} else if (value?.ok === true) {
+						acknowledgedMutation = true;
+						// A journal replay has already reached its after revision; it
+						// does not count as another application on this invocation.
+						if (studioContext && ((value.authored && value.revision.after > studioContext.revision.scene) ||
+							(value.nextHost && ["workspaceId", "documentEpoch", "sceneId", "sceneEpoch"].some(key => value.nextHost[key] !== studioContext.host[key])))) applied = true;
+						if (value.output?.rolledBack === true || value.output?.failed?.length > 0) failure = "failed";
+					}
+					studioContext = undefined;
+				} else if (command === "describe") {
 					if (mutation?.acknowledged && !mutation.rolledBack) {
 						const after = mutationState(mutation.name, value);
 						if (mutation.before !== undefined && after !== undefined && !isDeepStrictEqual(mutation.before, after)) applied = true;
@@ -336,6 +274,7 @@ export class LiveHub {
 			emitApplied();
 			// Never retain scene data with an asynchronous motion job.
 			description = undefined;
+			studioContext = undefined;
 			mutation = null;
 		});
 		emit("mcp:tool_requested", { request_id: requestId, tool_category: category });
@@ -389,6 +328,8 @@ export class LiveHub {
 		if (!socket || socket.readyState !== WebSocket.OPEN) throw hubError("STALE_HANDLE", `Unknown or stale live workspace handle "${handle}".`);
 
 		const id = randomUUID();
+		// The caller's per-call deadline (a controller frame's timeoutMs, or a
+		// command's declared one), capped at the ceiling; else the name's default.
 		const bound = Number.isFinite(timeoutMs) && timeoutMs > 0
 			? Math.min(timeoutMs, MAX_COMMAND_TIMEOUT_MS)
 			: LiveHub.commandTimeoutMs(name);
@@ -401,7 +342,8 @@ export class LiveHub {
 					: hubError("TIMEOUT", message);
 				reject(error);
 			}, bound);
-			this.pending.set(id, { name, socket, resolve, reject, timer });
+			// Each waiting frame keeps the deadline it runs under.
+			this.pending.set(id, { name, socket, resolve, reject, timer, timeoutMs: bound });
 			try {
 				socket.send(JSON.stringify({ type: "cmd", id, name, args }));
 			} catch (error) {