@docyrus/animaguru 0.15.0 → 0.16.1

package/README.md

@@ -55,6 +55,8 @@ Scaffolding requires no AnimaGuru sign-in and spends no generation credits; depe
 
 The official PixiJS skills are vendored with their MIT license and a hashed provenance manifest. Skills and template files ship in both the npm package and macOS installer; `create` does not fetch agent instructions from a remote repository at runtime.
 
+CLI 0.16.1 also installs **AnimaGuru Cutcraft** in both agent skill folders. Ask your agent to use `$animaguru-cutcraft` for tactile paper-collage explainers with exact editorial lettering, one narrator and purposeful cutout motion. Its generation adapter checks the server's enabled models, tracks asynchronous jobs and supports controlled animation of generated transparent artwork when precise placement is needed or video providers are unavailable. Cutcraft is an additional skill; the gallery retains its 31 visual styles.
+
 ## Install the project skill
 
 Run this in the folder where you want your coding agent to use AnimaGuru:
@@ -89,7 +91,7 @@ Use a team ID returned by `workspaces list`. The choice is saved per server in t
 
 ## Agent workflow
 
-Remote projects are neutral containers. `projects create` has no `--style` flag. Choose a style when generating a sprite; local film setup keeps its separate style interview.
+Remote projects have no art style. `projects create` takes a name only. Choose the style for each sprite with `generate --style` or `files import --style` (hd-cartoon when left out); local film setup keeps its separate style interview.
 
 ```sh
 animaguru projects create --name "Forest cast"
@@ -102,7 +104,7 @@ animaguru files list PROJECT_ID
 animaguru files export PROJECT_ID --output forest-cast.zip
 ```
 
-`jobs wait` waits for the specified job only. A drawing may queue follow-up animation jobs; inspect `jobs list` and wait for those before exporting. Jobs continue on the server if the CLI exits. `files export` refuses to overwrite a file. `projects rename PROJECT_ID --name "New name"` and `projects delete PROJECT_ID --yes` manage the library. `models PROJECT_ID --image-model gpt-image-2.5 --video-model heygen/heygen-video-1` sets the defaults for future jobs. The previous `--model` option remains an alias for `--image-model`.
+`jobs wait` waits for the specified job only. A drawing may queue follow-up animation jobs; inspect `jobs list` and wait for those before exporting. Jobs continue on the server if the CLI exits. `files export` refuses to overwrite a file. `projects rename PROJECT_ID --name "New name"` and `projects delete PROJECT_ID --yes` manage the library. `projects move PROJECT_ID --to OTHER_PROJECT_ID --characters SLUG,SLUG --assets ASSET_ID --avatars GROUP_ID` moves characters (with all their animations), saved assets and the project's own avatars to another project you can write to, without regenerating anything (CLI 0.16.0). `models PROJECT_ID --image-model gpt-image-2.5 --video-model heygen/heygen-video-1` sets the defaults for future jobs. The previous `--model` option remains an alias for `--image-model`.
 
 Generation and reference imports require `--yes`, which authorizes credit spending. Read estimates from `projects get` before submitting. Estimates are ranges; actual provider usage is recorded to your own balance. Paid generation needs configured production provider bindings and secrets.
 
@@ -313,7 +315,7 @@ Custom motions require 2–12 frame descriptions, a 20–600 character prompt, a
 Reference images:
 
 ```sh
-animaguru files import PROJECT_ID --file knight.png --name Knight --description "Keep the blue armor" --yes
+animaguru files import PROJECT_ID --file knight.png --name Knight --style pixel --description "Keep the blue armor" --yes
 ```
 
 PNG, JPEG and WebP are accepted up to 10 MB. A configured service redraws the reference and charges credits; otherwise it imports the original artwork.

package/dist/animaguru.js

@@ -10605,12 +10605,12 @@ If you're a developer and you believe this is a bug in isomorphic-git, please fi
        * @param {string} transport
        * @param {string} [suggestion]
        */
-      constructor(url2, transport, suggestion) {
+      constructor(url3, transport, suggestion) {
         super(
-          `Git remote "${url2}" uses an unrecognized transport protocol: "${transport}"`
+          `Git remote "${url3}" uses an unrecognized transport protocol: "${transport}"`
         );
         this.code = this.name = _UnknownTransportError.code;
-        this.data = { url: url2, transport, suggestion };
+        this.data = { url: url3, transport, suggestion };
       }
     };
     UnknownTransportError.code = "UnknownTransportError";
@@ -10618,10 +10618,10 @@ If you're a developer and you believe this is a bug in isomorphic-git, please fi
       /**
        * @param {string} url
        */
-      constructor(url2) {
-        super(`Cannot parse remote URL: "${url2}"`);
+      constructor(url3) {
+        super(`Cannot parse remote URL: "${url3}"`);
         this.code = this.name = _UrlParseError.code;
-        this.data = { url: url2 };
+        this.data = { url: url3 };
       }
     };
     UrlParseError.code = "UrlParseError";
@@ -12487,7 +12487,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
         throw err2;
       }
     }
-    async function _addRemote({ fs: fs2, gitdir, remote, url: url2, force }) {
+    async function _addRemote({ fs: fs2, gitdir, remote, url: url3, force }) {
       if (!isValidRef(remote, true)) {
         throw new InvalidRefNameError(remote, cleanGitRef.clean(remote));
       }
@@ -12495,12 +12495,12 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       if (!force) {
         const remoteNames = await config2.getSubsections("remote");
         if (remoteNames.includes(remote)) {
-          if (url2 !== await config2.get(`remote.${remote}.url`)) {
+          if (url3 !== await config2.get(`remote.${remote}.url`)) {
             throw new AlreadyExistsError("remote", remote);
           }
         }
       }
-      await config2.set(`remote.${remote}.url`, url2);
+      await config2.set(`remote.${remote}.url`, url3);
       await config2.set(
         `remote.${remote}.fetch`,
         `+refs/heads/*:refs/remotes/${remote}/*`
@@ -12512,21 +12512,21 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       dir,
       gitdir = join15(dir, ".git"),
       remote,
-      url: url2,
+      url: url3,
       force = false
     }) {
       try {
         assertParameter("fs", fs2);
         assertParameter("gitdir", gitdir);
         assertParameter("remote", remote);
-        assertParameter("url", url2);
+        assertParameter("url", url3);
         const fsp = new FileSystem(fs2);
         const updatedGitdir = await discoverGitdir({ fsp, dotgit: gitdir });
         return await _addRemote({
           fs: fsp,
           gitdir: updatedGitdir,
           remote,
-          url: url2,
+          url: url3,
           force
         });
       } catch (err2) {
@@ -14086,10 +14086,10 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       if (!ref.startsWith("refs/")) return;
       return fullname ? ref : abbreviateRef(ref);
     }
-    function translateSSHtoHTTP(url2) {
-      url2 = url2.replace(/^[^/@:]+@([^/@:]+):/, "https://$1/");
-      url2 = url2.replace(/^ssh:\/\//, "https://");
-      return url2;
+    function translateSSHtoHTTP(url3) {
+      url3 = url3.replace(/^[^/@:]+@([^/@:]+):/, "https://$1/");
+      url3 = url3.replace(/^ssh:\/\//, "https://");
+      return url3;
     }
     function calculateBasicAuthHeader({ username = "", password = "" }) {
       return `Basic ${Buffer.from(`${username}:${password}`).toString("base64")}`;
@@ -14119,16 +14119,16 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       return result;
     }
     var CREDENTIALS = /^(https?:\/\/)([^/?#]+)@/i;
-    function extractAuthFromUrl(url2) {
-      const credentials = url2.match(CREDENTIALS);
-      if (credentials == null) return { url: url2, auth: {} };
+    function extractAuthFromUrl(url3) {
+      const credentials = url3.match(CREDENTIALS);
+      if (credentials == null) return { url: url3, auth: {} };
       return {
-        url: url2.replace(CREDENTIALS, "$1"),
-        auth: parseUserinfo(url2, credentials[2])
+        url: url3.replace(CREDENTIALS, "$1"),
+        auth: parseUserinfo(url3, credentials[2])
       };
     }
-    function parseUserinfo(url2, userpass) {
-      const parsed = parseUrl(url2);
+    function parseUserinfo(url3, userpass) {
+      const parsed = parseUrl(url3);
       const hasPassword = userpass.indexOf(":") !== -1;
       if (parsed !== null) {
         return {
@@ -14142,10 +14142,10 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
         password: hasPassword ? userpass.slice(separatorIndex + 1) : void 0
       };
     }
-    function parseUrl(url2) {
+    function parseUrl(url3) {
       if (typeof URL !== "function") return null;
       try {
-        return new URL(url2);
+        return new URL(url3);
       } catch (_) {
         return null;
       }
@@ -14269,7 +14269,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       }
       return split;
     }
-    var corsProxify = (corsProxy, url2) => corsProxy.endsWith("?") ? `${corsProxy}${url2}` : `${corsProxy}/${url2.replace(/^https?:\/\//, "")}`;
+    var corsProxify = (corsProxy, url3) => corsProxy.endsWith("?") ? `${corsProxy}${url3}` : `${corsProxy}/${url3.replace(/^https?:\/\//, "")}`;
     var updateHeaders = (headers, auth) => {
       if (auth.username || auth.password) {
         headers.Authorization = calculateBasicAuthHeader(auth);
@@ -14330,8 +14330,8 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
         signal,
         protocolVersion
       }) {
-        let { url: url2, auth } = extractAuthFromUrl(_origUrl);
-        const proxifiedURL = corsProxy ? corsProxify(corsProxy, url2) : url2;
+        let { url: url3, auth } = extractAuthFromUrl(_origUrl);
+        const proxifiedURL = corsProxy ? corsProxify(corsProxy, url3) : url3;
         if (auth.username || auth.password) {
           headers.Authorization = calculateBasicAuthHeader(auth);
         }
@@ -14353,7 +14353,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           if (res.statusCode === 401 || res.statusCode === 203) {
             const getAuth = providedAuthBefore ? onAuthFailure : onAuth;
             if (getAuth) {
-              auth = await getAuth(url2, {
+              auth = await getAuth(url3, {
                 ...auth,
                 headers: { ...headers }
               });
@@ -14366,7 +14366,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
               }
             }
           } else if (res.statusCode === 200 && providedAuthBefore && onAuthSuccess) {
-            await onAuthSuccess(url2, auth);
+            await onAuthSuccess(url3, auth);
           }
         } while (tryAgain);
         if (res.statusCode !== 200) {
@@ -14409,22 +14409,22 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
         onProgress,
         corsProxy,
         service,
-        url: url2,
+        url: url3,
         auth,
         body,
         headers,
         signal
       }) {
-        const urlAuth = extractAuthFromUrl(url2);
-        if (urlAuth) url2 = urlAuth.url;
-        if (corsProxy) url2 = corsProxify(corsProxy, url2);
+        const urlAuth = extractAuthFromUrl(url3);
+        if (urlAuth) url3 = urlAuth.url;
+        if (corsProxy) url3 = corsProxify(corsProxy, url3);
         headers["content-type"] = `application/x-${service}-request`;
         headers.accept = `application/x-${service}-result`;
         updateHeaders(headers, auth);
         const res = await http.request({
           onProgress,
           method: "POST",
-          url: `${url2}/${service}`,
+          url: `${url3}/${service}`,
           body,
           headers,
           signal
@@ -14446,33 +14446,33 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
        * @throws {UrlParseError} - If the URL cannot be parsed.
        * @throws {UnknownTransportError} - If the transport is not supported.
        */
-      static getRemoteHelperFor({ url: url2 }) {
+      static getRemoteHelperFor({ url: url3 }) {
         const remoteHelpers = /* @__PURE__ */ new Map();
         remoteHelpers.set("http", GitRemoteHTTP);
         remoteHelpers.set("https", GitRemoteHTTP);
-        const parts = parseRemoteUrl({ url: url2 });
+        const parts = parseRemoteUrl({ url: url3 });
         if (!parts) {
-          throw new UrlParseError(url2);
+          throw new UrlParseError(url3);
         }
         if (remoteHelpers.has(parts.transport)) {
           return remoteHelpers.get(parts.transport);
         }
         throw new UnknownTransportError(
-          url2,
+          url3,
           parts.transport,
-          parts.transport === "ssh" ? translateSSHtoHTTP(url2) : void 0
+          parts.transport === "ssh" ? translateSSHtoHTTP(url3) : void 0
         );
       }
     };
     var scpLike = /^[^/@:]+@[^/@:]+:/;
-    function parseRemoteUrl({ url: url2 }) {
-      if (scpLike.test(url2)) {
+    function parseRemoteUrl({ url: url3 }) {
+      if (scpLike.test(url3)) {
         return {
           transport: "ssh",
-          address: url2
+          address: url3
         };
       }
-      const matches = url2.match(/(\w+)(:\/\/|::)(.*)/);
+      const matches = url3.match(/(\w+)(:\/\/|::)(.*)/);
       if (matches === null) return;
       if (matches[2] === "://") {
         return {
@@ -14583,9 +14583,9 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
     }
     function addCredentialUsername({ config: config2, onAuth }) {
       if (!onAuth) return onAuth;
-      return async (url2, auth) => {
-        const username = auth.username || await config2.get(`credential.${url2}.username`);
-        return onAuth(url2, username ? { ...auth, username } : auth);
+      return async (url3, auth) => {
+        const username = auth.username || await config2.get(`credential.${url3}.username`);
+        return onAuth(url3, username ? { ...auth, username } : auth);
       };
     }
     function emptyPackfile(pack) {
@@ -14911,15 +14911,15 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       const ref = _ref || await _currentBranch({ fs: fs2, gitdir, test: true });
       const config2 = await GitConfigManager.get({ fs: fs2, gitdir });
       const remote = _remote || ref && await config2.get(`branch.${ref}.remote`) || "origin";
-      const url2 = _url2 || await config2.get(`remote.${remote}.url`);
-      if (typeof url2 === "undefined") {
+      const url3 = _url2 || await config2.get(`remote.${remote}.url`);
+      if (typeof url3 === "undefined") {
         throw new MissingParameterError("remote OR url");
       }
       const remoteRef = _remoteRef || ref && await config2.get(`branch.${ref}.merge`) || _ref || "HEAD";
       if (corsProxy === void 0) {
         corsProxy = await config2.get("http.corsProxy");
       }
-      const GitRemoteHTTP2 = GitRemoteManager.getRemoteHelperFor({ url: url2 });
+      const GitRemoteHTTP2 = GitRemoteManager.getRemoteHelperFor({ url: url3 });
       const remoteHTTP = await GitRemoteHTTP2.discover({
         http,
         onAuth: addCredentialUsername({ config: config2, onAuth }),
@@ -14927,7 +14927,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
         onAuthFailure: addCredentialUsername({ config: config2, onAuth: onAuthFailure }),
         corsProxy,
         service: "git-upload-pack",
-        url: url2,
+        url: url3,
         headers,
         protocolVersion: 1
       });
@@ -15013,7 +15013,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
         onProgress,
         corsProxy,
         service: "git-upload-pack",
-        url: url2,
+        url: url3,
         auth,
         body: [packbuffer],
         headers
@@ -15101,7 +15101,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       const noun = fullref.startsWith("refs/tags") ? "tag" : "branch";
       response.FETCH_HEAD = {
         oid,
-        description: `${noun} '${abbreviateRef(fullref)}' of ${url2}`
+        description: `${noun} '${abbreviateRef(fullref)}' of ${url3}`
       };
       if (onProgress || onMessage) {
         const lines = splitLines(response.progress);
@@ -15190,7 +15190,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       onPostCheckout,
       dir,
       gitdir,
-      url: url2,
+      url: url3,
       corsProxy,
       ref,
       remote,
@@ -15207,7 +15207,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
     }) {
       try {
         await _init({ fs: fs2, gitdir });
-        await _addRemote({ fs: fs2, gitdir, remote, url: url2, force: false });
+        await _addRemote({ fs: fs2, gitdir, remote, url: url3, force: false });
         if (corsProxy) {
           const config2 = await GitConfigManager.get({ fs: fs2, gitdir });
           await config2.set(`http.corsProxy`, corsProxy);
@@ -15266,7 +15266,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       onPostCheckout,
       dir,
       gitdir = join15(dir, ".git"),
-      url: url2,
+      url: url3,
       corsProxy = void 0,
       ref = void 0,
       remote = "origin",
@@ -15289,7 +15289,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
         if (!noCheckout) {
           assertParameter("dir", dir);
         }
-        assertParameter("url", url2);
+        assertParameter("url", url3);
         const fsp = new FileSystem(fs2);
         const updatedGitdir = await discoverGitdir({ fsp, dotgit: gitdir });
         return await _clone({
@@ -15304,7 +15304,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           onPostCheckout,
           dir,
           gitdir: updatedGitdir,
-          url: url2,
+          url: url3,
           corsProxy,
           ref,
           remote,
@@ -15781,7 +15781,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       dir,
       gitdir,
       ref,
-      url: url2,
+      url: url3,
       remote,
       remoteRef,
       prune,
@@ -15815,7 +15815,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           gitdir,
           corsProxy,
           ref,
-          url: url2,
+          url: url3,
           remote,
           remoteRef,
           singleBranch,
@@ -15864,7 +15864,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       dir,
       gitdir = join15(dir, ".git"),
       ref,
-      url: url2,
+      url: url3,
       remote,
       remoteRef,
       corsProxy,
@@ -15896,7 +15896,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           dir,
           gitdir: updatedGitdir,
           ref,
-          url: url2,
+          url: url3,
           remote,
           remoteRef,
           fastForwardOnly: true,
@@ -15924,7 +15924,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       ref,
       remote,
       remoteRef,
-      url: url2,
+      url: url3,
       corsProxy,
       depth = null,
       since = null,
@@ -15956,7 +15956,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           ref,
           remote,
           remoteRef,
-          url: url2,
+          url: url3,
           corsProxy,
           depth,
           since,
@@ -16078,14 +16078,14 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       onAuthSuccess,
       onAuthFailure,
       corsProxy,
-      url: url2,
+      url: url3,
       headers = {},
       forPush = false
     }) {
       try {
         assertParameter("http", http);
-        assertParameter("url", url2);
-        const GitRemoteHTTP2 = GitRemoteManager.getRemoteHelperFor({ url: url2 });
+        assertParameter("url", url3);
+        const GitRemoteHTTP2 = GitRemoteManager.getRemoteHelperFor({ url: url3 });
         const remote = await GitRemoteHTTP2.discover({
           http,
           onAuth,
@@ -16093,7 +16093,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           onAuthFailure,
           corsProxy,
           service: forPush ? "git-receive-pack" : "git-upload-pack",
-          url: url2,
+          url: url3,
           headers,
           protocolVersion: 1
         });
@@ -16143,15 +16143,15 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       onAuthSuccess,
       onAuthFailure,
       corsProxy,
-      url: url2,
+      url: url3,
       headers = {},
       forPush = false,
       protocolVersion = 2
     }) {
       try {
         assertParameter("http", http);
-        assertParameter("url", url2);
-        const GitRemoteHTTP2 = GitRemoteManager.getRemoteHelperFor({ url: url2 });
+        assertParameter("url", url3);
+        const GitRemoteHTTP2 = GitRemoteManager.getRemoteHelperFor({ url: url3 });
         const remote = await GitRemoteHTTP2.discover({
           http,
           onAuth,
@@ -16159,7 +16159,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           onAuthFailure,
           corsProxy,
           service: forPush ? "git-receive-pack" : "git-upload-pack",
-          url: url2,
+          url: url3,
           headers,
           protocolVersion
         });
@@ -16561,8 +16561,8 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       const remoteNames = await config2.getSubsections("remote");
       const remotes = Promise.all(
         remoteNames.map(async (remote) => {
-          const url2 = await config2.get(`remote.${remote}.url`);
-          return { remote, url: url2 };
+          const url3 = await config2.get(`remote.${remote}.url`);
+          return { remote, url: url3 };
         })
       );
       return remotes;
@@ -16625,7 +16625,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       onAuthSuccess,
       onAuthFailure,
       corsProxy,
-      url: url2,
+      url: url3,
       headers = {},
       forPush = false,
       protocolVersion = 2,
@@ -16635,7 +16635,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
     }) {
       try {
         assertParameter("http", http);
-        assertParameter("url", url2);
+        assertParameter("url", url3);
         const remote = await GitRemoteHTTP.discover({
           http,
           onAuth,
@@ -16643,7 +16643,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           onAuthFailure,
           corsProxy,
           service: forPush ? "git-receive-pack" : "git-upload-pack",
-          url: url2,
+          url: url3,
           headers,
           protocolVersion
         });
@@ -16657,7 +16657,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           headers,
           corsProxy,
           service: forPush ? "git-receive-pack" : "git-upload-pack",
-          url: url2,
+          url: url3,
           body
         });
         return parseListRefsResponse(res.body);
@@ -17114,7 +17114,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       dir,
       gitdir = join15(dir, ".git"),
       ref,
-      url: url2,
+      url: url3,
       remote,
       remoteRef,
       prune = false,
@@ -17159,7 +17159,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           dir,
           gitdir: updatedGitdir,
           ref,
-          url: url2,
+          url: url3,
           remote,
           remoteRef,
           fastForward: fastForward2,
@@ -17342,12 +17342,12 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       }
       const config2 = await GitConfigManager.get({ fs: fs2, gitdir });
       remote = remote || await config2.get(`branch.${ref}.pushRemote`) || await config2.get("remote.pushDefault") || await config2.get(`branch.${ref}.remote`) || "origin";
-      const url2 = _url2 || await config2.get(`remote.${remote}.pushurl`) || await config2.get(`remote.${remote}.url`);
-      if (typeof url2 === "undefined") {
+      const url3 = _url2 || await config2.get(`remote.${remote}.pushurl`) || await config2.get(`remote.${remote}.url`);
+      if (typeof url3 === "undefined") {
         throw new MissingParameterError("remote OR url");
       }
       const remoteRef = _remoteRef || await config2.get(`branch.${ref}.merge`);
-      if (typeof url2 === "undefined") {
+      if (typeof url3 === "undefined") {
         throw new MissingParameterError("remoteRef");
       }
       if (corsProxy === void 0) {
@@ -17355,7 +17355,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       }
       const fullRef = await GitRefManager.expand({ fs: fs2, gitdir, ref });
       const oid = _delete ? "0000000000000000000000000000000000000000" : await GitRefManager.resolve({ fs: fs2, gitdir, ref: fullRef });
-      const GitRemoteHTTP2 = GitRemoteManager.getRemoteHelperFor({ url: url2 });
+      const GitRemoteHTTP2 = GitRemoteManager.getRemoteHelperFor({ url: url3 });
       const httpRemote = await GitRemoteHTTP2.discover({
         http,
         onAuth: addCredentialUsername({ config: config2, onAuth }),
@@ -17363,7 +17363,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
         onAuthFailure: addCredentialUsername({ config: config2, onAuth: onAuthFailure }),
         corsProxy,
         service: "git-receive-pack",
-        url: url2,
+        url: url3,
         headers,
         protocolVersion: 1,
         signal
@@ -17390,7 +17390,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       if (onPrePush) {
         const hookCancel = await onPrePush({
           remote,
-          url: url2,
+          url: url3,
           localRef: { ref: _delete ? "(delete)" : fullRef, oid },
           remoteRef: { ref: fullRemoteRef, oid: oldoid }
         });
@@ -17487,7 +17487,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
         onProgress,
         corsProxy,
         service: "git-receive-pack",
-        url: url2,
+        url: url3,
         auth,
         headers,
         body: [...packstream1, ...packstream2],
@@ -17537,7 +17537,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       ref,
       remoteRef,
       remote = "origin",
-      url: url2,
+      url: url3,
       force = false,
       delete: _delete = false,
       corsProxy,
@@ -17565,7 +17565,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           ref,
           remoteRef,
           remote,
-          url: url2,
+          url: url3,
           force,
           delete: _delete,
           corsProxy,
@@ -19761,7 +19761,7 @@ var require_ignore2 = __commonJS({
 // cli/package.json
 var package_default = {
   name: "@docyrus/animaguru",
-  version: "0.15.0",
+  version: "0.16.1",
   description: "Agent-friendly AnimaGuru CLI built with CrustJS",
   type: "module",
   bin: {
@@ -22817,16 +22817,16 @@ function serializeParams(options) {
   if (id2.includes(":") || id2.includes(";")) throw new TypeError('Invalid hyperlink id: ":" and ";" are reserved by the OSC 8 format.');
   return `id=${id2}`;
 }
-function linkCode(url2, options) {
-  assertMatches(url2, "hyperlink URL", /^[\x21-\x7e]*$/, " without spaces");
+function linkCode(url3, options) {
+  assertMatches(url3, "hyperlink URL", /^[\x21-\x7e]*$/, " without spaces");
   const params = serializeParams(options);
   return {
-    open: `${OSC}8;${params};${url2}${ST}`,
+    open: `${OSC}8;${params};${url3}${ST}`,
     close: HYPERLINK_CLOSE
   };
 }
-function link$1(text2, url2, options) {
-  return applyStyle(text2, linkCode(url2, options));
+function link$1(text2, url3, options) {
+  return applyStyle(text2, linkCode(url3, options));
 }
 var dynamicColorKinds = ["fg", "bg"];
 function stepIsModifier(step) {
@@ -22966,9 +22966,9 @@ function createStyleInstance(options, runtime) {
     get colorDepth() {
       return resolveCapabilities().colorDepth;
     },
-    link(text2, url2, hyperlinkOptions) {
-      if (resolveCapabilities().modifiersEnabled) return link$1(text2, url2, hyperlinkOptions);
-      linkCode(url2, hyperlinkOptions);
+    link(text2, url3, hyperlinkOptions) {
+      if (resolveCapabilities().modifiersEnabled) return link$1(text2, url3, hyperlinkOptions);
+      linkCode(url3, hyperlinkOptions);
       return text2;
     },
     ...Object.fromEntries(dynamicColorKinds.map((kind) => [kind, (...args) => {
@@ -24086,8 +24086,8 @@ function isNewerVersion(current, latest) {
 }
 async function fetchLatestVersion(packageName, registryUrl, timeoutMs) {
   try {
-    const url2 = `${registryUrl.replace(/\/+$/, "")}/${encodeURIComponent(packageName)}`;
-    const response = await fetch(url2, {
+    const url3 = `${registryUrl.replace(/\/+$/, "")}/${encodeURIComponent(packageName)}`;
+    const response = await fetch(url3, {
       signal: AbortSignal.timeout(timeoutMs),
       headers: { Accept: "application/vnd.npm.install-v1+json" }
     });
@@ -25306,7 +25306,7 @@ var toUnits = (credits) => Math.round(credits * UNITS_PER_CREDIT);
 
 // shared/sprites/types.ts
 var SPRITE_KINDS = ["character", "vehicle", "machine", "effect"];
-var SPRITE_ACTIONS = ["idle", "walk", "run", "shoot", "jump", "hurt", "death", "slide", "punch", "kick"];
+var SPRITE_ACTIONS = ["idle", "walk", "run", "skid-stop", "shoot", "jump", "hurt", "death", "slide", "punch", "kick"];
 var SPRITE_KIND_ACTIONS = {
   character: SPRITE_ACTIONS,
   vehicle: ["idle", "move", "fire", "hurt", "destroyed"],
@@ -28228,21 +28228,21 @@ var asciiTabOrNewline = /[\t\n\r]/g;
 function stripTabAndNewline(value) {
   return value.replace(asciiTabOrNewline, "");
 }
-function urlHostnameOk(url2, hostname3) {
+function urlHostnameOk(url3, hostname3) {
   hostname3.lastIndex = 0;
-  return hostname3.test(url2.hostname);
+  return hostname3.test(url3.hostname);
 }
-function urlProtocolOk(url2, protocol) {
+function urlProtocolOk(url3, protocol) {
   protocol.lastIndex = 0;
-  return protocol.test(url2.protocol.endsWith(":") ? url2.protocol.slice(0, -1) : url2.protocol);
+  return protocol.test(url3.protocol.endsWith(":") ? url3.protocol.slice(0, -1) : url3.protocol);
 }
 var $ZodURL = /* @__PURE__ */ $constructor("$ZodURL", (inst, def) => {
   $ZodStringFormat.init(inst, def);
   inst._zod.check = (payload) => {
     try {
       const trimmed = payload.value.trim();
-      const url2 = validateURL(trimmed, def);
-      if (url2 === URL_BAD_FORMAT) {
+      const url3 = validateURL(trimmed, def);
+      if (url3 === URL_BAD_FORMAT) {
         payload.issues.push({
           code: "invalid_format",
           format: "url",
@@ -28253,7 +28253,7 @@ var $ZodURL = /* @__PURE__ */ $constructor("$ZodURL", (inst, def) => {
         });
         return;
       }
-      if (url2 === URL_UNPARSEABLE) {
+      if (url3 === URL_UNPARSEABLE) {
         payload.issues.push({
           code: "invalid_format",
           format: "url",
@@ -28263,11 +28263,11 @@ var $ZodURL = /* @__PURE__ */ $constructor("$ZodURL", (inst, def) => {
         });
         return;
       }
-      if (url2 === true) {
+      if (url3 === true) {
         payload.value = stripTabAndNewline(trimmed);
         return;
       }
-      if (def.hostname && !urlHostnameOk(url2, def.hostname)) {
+      if (def.hostname && !urlHostnameOk(url3, def.hostname)) {
         payload.issues.push({
           code: "invalid_format",
           format: "url",
@@ -28278,7 +28278,7 @@ var $ZodURL = /* @__PURE__ */ $constructor("$ZodURL", (inst, def) => {
           continue: !def.abort
         });
       }
-      if (def.protocol && !urlProtocolOk(url2, def.protocol)) {
+      if (def.protocol && !urlProtocolOk(url3, def.protocol)) {
         payload.issues.push({
           code: "invalid_format",
           format: "url",
@@ -28289,7 +28289,7 @@ var $ZodURL = /* @__PURE__ */ $constructor("$ZodURL", (inst, def) => {
           continue: !def.abort
         });
       }
-      payload.value = def.normalize ? url2.href : stripTabAndNewline(trimmed);
+      payload.value = def.normalize ? url3.href : stripTabAndNewline(trimmed);
       return;
     } catch (_) {
       payload.issues.push({
@@ -45105,10 +45105,10 @@ import { dirname as dirname3, join as join4, resolve as resolve3 } from "node:pa
 import { homedir as homedir3 } from "node:os";
 import { createHash, randomUUID } from "node:crypto";
 function serverUrl(value) {
-  const url2 = new URL(value);
-  if (url2.username || url2.password || url2.search || url2.hash || url2.pathname !== "/") throw new Error("Use an origin URL without credentials, path, query or fragment.");
-  if (url2.protocol !== "https:" && !(url2.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url2.hostname))) throw new Error("Use HTTPS, except for local development.");
-  return url2.origin;
+  const url3 = new URL(value);
+  if (url3.username || url3.password || url3.search || url3.hash || url3.pathname !== "/") throw new Error("Use an origin URL without credentials, path, query or fragment.");
+  if (url3.protocol !== "https:" && !(url3.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url3.hostname))) throw new Error("Use HTTPS, except for local development.");
+  return url3.origin;
 }
 function credentialsPath() {
   return resolve3(process.env.ANIMAGURU_CONFIG_DIR ?? join4(homedir3(), ".config", "animaguru"), "credentials.json");
@@ -46168,7 +46168,7 @@ async function createVideoProject(options, installer = installDependencies) {
   const manifest = JSON.parse(await readFile4(packagePath, "utf8"));
   manifest.name = basename2(directory).toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 100) || "animaguru-video";
   await writeFile6(packagePath, JSON.stringify(manifest, null, 2) + "\n");
-  const skills = [.../* @__PURE__ */ new Set(["animaguru", "animaguru-video", "animaguru-brand-kit", ...VIDEO_PURPOSE_SKILLS, ...VIDEO_TEMPLATES.map((template) => template.skill)])];
+  const skills = [.../* @__PURE__ */ new Set(["animaguru", "animaguru-video", "animaguru-brand-kit", "animaguru-cutcraft", ...VIDEO_PURPOSE_SKILLS, ...VIDEO_TEMPLATES.map((template) => template.skill)])];
   const pixiSkillsRoot = join6(packageRoot, "vendor/pixijs-skills/skills");
   const pixiSkills = (await readdir2(pixiSkillsRoot, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
   for (const agent of [".agents", ".claude"]) {
@@ -46402,6 +46402,9 @@ var assetRequest = external_exports.discriminatedUnion("type", [
   }).transform((p) => ({ ...p, voice: p.voice || (isElevenLabsSpeech(p.model) ? DEFAULT_ELEVENLABS_VOICE : "Kore") })),
   external_exports.object({ ...base, type: external_exports.literal("sfx"), model: external_exports.literal("eleven_text_to_sound_v2").default("eleven_text_to_sound_v2"), seconds: external_exports.number().min(0.5).max(30).default(5), loop: external_exports.boolean().default(false), promptInfluence: external_exports.number().min(0).max(1).default(0.3) })
 ]);
+var LIBRARY_AUDIO_MODEL = "library-audio";
+var libraryAudio = external_exports.object({ name: base.name, prompt: external_exports.string().trim().max(4e3).default(""), type: external_exports.enum(["music", "sfx"]), model: external_exports.literal(LIBRARY_AUDIO_MODEL), loop: external_exports.boolean().default(false) });
+var savedAssetOptions = external_exports.union([assetRequest, libraryAudio]);
 var speechCharacters = (text2) => Array.from(text2).length;
 function assetEstimate(p, now = Date.now()) {
   if (p.type === "image") return Math.ceil(130 * spriteImageModel(p.model).relCost);
@@ -47088,7 +47091,7 @@ var avatarTemplate = (id2) => AVATAR_LOOK_TEMPLATES.find((t) => t.id === id2);
 var heygenId = external_exports.string().trim().regex(/^(?!\.{1,2}$)[A-Za-z0-9_.-]{1,128}$/, "Use an avatar id returned by AnimaGuru.");
 var sha = external_exports.string().regex(/^[a-f0-9]{64}$/);
 var name = external_exports.string().trim().min(1).max(80);
-var https = external_exports.string().trim().max(2048).url().refine((url2) => url2.startsWith("https://"), "Use an HTTPS URL.");
+var https = external_exports.string().trim().max(2048).url().refine((url3) => url3.startsWith("https://"), "Use an HTTPS URL.");
 var AVATAR_INLINE_MAX_BYTES = 8 * 1024 * 1024;
 var AVATAR_PHOTO_TYPES = ["image/png", "image/jpeg", "image/webp"];
 var AVATAR_FOOTAGE_TYPES = ["video/mp4", "video/quicktime", "video/webm"];
@@ -47458,10 +47461,10 @@ async function providerError(response) {
   if (response.status === 403) return new YouTubeError("YouTube denied this request. Check channel permissions and your Google project's YouTube API configuration.", false, false, reason);
   return new YouTubeError(`YouTube request failed (${response.status}${reason ? `: ${reason}` : ""}).`, response.status === 429 || response.status >= 500, false, reason);
 }
-async function googleFetch(url2, init, signal) {
+async function googleFetch(url3, init, signal) {
   signal?.throwIfAborted();
   try {
-    return await fetch(url2, { ...init, redirect: "manual", signal: AbortSignal.any([AbortSignal.timeout(18e4), ...signal ? [signal] : []]) });
+    return await fetch(url3, { ...init, redirect: "manual", signal: AbortSignal.any([AbortSignal.timeout(18e4), ...signal ? [signal] : []]) });
   } catch {
     signal?.throwIfAborted();
     throw new YouTubeError("YouTube connection interrupted.", true);
@@ -47493,8 +47496,8 @@ async function accessToken(credentials, signal, force = false) {
   await saveYouTubeCredentials(credentials);
   return credentials.accessToken;
 }
-async function youtubeRequest(credentials, url2, init = {}, signal) {
-  const send = (token3) => googleFetch(url2, { ...init, headers: { ...init.headers, Authorization: `Bearer ${token3}` } }, signal);
+async function youtubeRequest(credentials, url3, init = {}, signal) {
+  const send = (token3) => googleFetch(url3, { ...init, headers: { ...init.headers, Authorization: `Bearer ${token3}` } }, signal);
   let response = await send(await accessToken(credentials, signal));
   if (response.status === 401) {
     await response.body?.cancel();
@@ -47567,26 +47570,26 @@ async function youtubeLogin(options) {
       response.setHeader("Referrer-Policy", "no-referrer");
       response.setHeader("Content-Type", "text/plain; charset=UTF-8");
       response.setHeader("Content-Security-Policy", "default-src 'none'");
-      let url2;
+      let url3;
       try {
-        url2 = new URL(request2.url ?? "/", redirectUri);
+        url3 = new URL(request2.url ?? "/", redirectUri);
       } catch {
         response.writeHead(400).end("Invalid request.");
         return;
       }
-      if (request2.method !== "GET" || request2.headers.host !== new URL(redirectUri).host || url2.pathname !== "/oauth2callback" || (request2.url?.length ?? 0) > 8192) {
+      if (request2.method !== "GET" || request2.headers.host !== new URL(redirectUri).host || url3.pathname !== "/oauth2callback" || (request2.url?.length ?? 0) > 8192) {
         response.writeHead(404).end("Not found.");
         return;
       }
-      const returnedState = Buffer.from(url2.searchParams.get("state") ?? "");
+      const returnedState = Buffer.from(url3.searchParams.get("state") ?? "");
       const expectedState = Buffer.from(state);
       if (used || returnedState.length !== expectedState.length || !timingSafeEqual(returnedState, expectedState)) {
         response.writeHead(400).end("Invalid authorization state.");
         return;
       }
       used = true;
-      const code = url2.searchParams.get("code");
-      if (url2.searchParams.has("error") || !code || code.length > 4096) {
+      const code = url3.searchParams.get("code");
+      if (url3.searchParams.has("error") || !code || code.length > 4096) {
         response.writeHead(400).end("Authorization cancelled. Return to your terminal.");
         fail(new Error("YouTube authorization cancelled."));
         return;
@@ -47607,11 +47610,11 @@ async function youtubeLogin(options) {
     let token3;
     try {
       options.signal?.throwIfAborted();
-      const url2 = new URL("https://accounts.google.com/o/oauth2/v2/auth");
-      url2.search = new URLSearchParams({ client_id: client.clientId, redirect_uri: redirectUri, response_type: "code", scope: requested.join(" "), state, code_challenge: createHash4("sha256").update(verifier).digest("base64url"), code_challenge_method: "S256", access_type: "offline", prompt: "consent select_account" }).toString();
+      const url3 = new URL("https://accounts.google.com/o/oauth2/v2/auth");
+      url3.search = new URLSearchParams({ client_id: client.clientId, redirect_uri: redirectUri, response_type: "code", scope: requested.join(" "), state, code_challenge: createHash4("sha256").update(verifier).digest("base64url"), code_challenge_method: "S256", access_type: "offline", prompt: "consent select_account" }).toString();
       options.log?.("YouTube authorization stays on this machine. Tokens and upload receipts are saved in owner-only local files. Video bytes go directly to Google. Google privacy: https://policies.google.com/privacy \xB7 YouTube terms: https://www.youtube.com/t/terms");
-      options.log?.(`Open ${url2.href}`);
-      if (options.browser !== false) await options.openBrowser?.(url2.href);
+      options.log?.(`Open ${url3.href}`);
+      if (options.browser !== false) await options.openBrowser?.(url3.href);
       const body = await tokenRequest(client, { grant_type: "authorization_code", code: await callback, code_verifier: verifier, redirect_uri: redirectUri }, options.signal);
       token3 = typeof body.refresh_token === "string" ? body.refresh_token : typeof body.access_token === "string" ? body.access_token : void 0;
       const scopes = typeof body.scope === "string" ? body.scope.split(" ") : [];
@@ -47746,7 +47749,7 @@ function fromStream(stream) {
 }
 async function request({
   onProgress,
-  url: url2,
+  url: url3,
   method = "GET",
   headers = {},
   fetchOptions = {},
@@ -47756,7 +47759,7 @@ async function request({
   if (body) {
     body = await collect(body);
   }
-  const res = await fetch(url2, {
+  const res = await fetch(url3, {
     ...fetchOptions,
     method,
     headers,
@@ -47947,13 +47950,13 @@ async function withLock(root, run) {
     await rm2(path, { force: true });
   }
 }
-async function openContext(dir, options, url2) {
+async function openContext(dir, options, url3) {
   const root = await cloudRootFor(dir);
   const link2 = await readJson2(join11(root, LINK_FILE));
   if (!link2) throw new Error("This folder is not linked to a cloud project. Run animaguru cloud link, or animaguru cloud clone ID.");
   if (link2.schemaVersion !== 1 || !cloudProjectId.safeParse(link2.projectId).success) throw new Error(`Unsupported cloud link in ${LINK_FILE}. Run animaguru cloud unlink and link again.`);
   const state = await readJson2(join11(root, STATE_FILE)) ?? { schemaVersion: 1, base: null, files: {} };
-  return { root, gitdir: join11(root, GIT_DIR), link: link2, state, client: new Client(url2 ?? link2.origin, options.signal), options };
+  return { root, gitdir: join11(root, GIT_DIR), link: link2, state, client: new Client(url3 ?? link2.origin, options.signal), options };
 }
 async function cloudLink(dir) {
   const link2 = await readJson2(join11(await cloudRootFor(dir), LINK_FILE));
@@ -48431,14 +48434,14 @@ async function restoreCloud(options) {
 // cli/src/youtube-upload.ts
 var YOUTUBE_CHUNK_BYTES = 8 * 1024 * 1024;
 function safeYouTubeSession(value) {
-  let url2;
+  let url3;
   try {
-    url2 = new URL(value);
+    url3 = new URL(value);
   } catch {
     throw new YouTubeError("Google returned an invalid upload session.");
   }
-  if (url2.protocol !== "https:" || !["www.googleapis.com", "youtube.googleapis.com"].includes(url2.hostname) || url2.port || url2.username || url2.password || url2.hash || !/^\/upload\/youtube\/v3\/videos\/?$/.test(url2.pathname) || !url2.searchParams.get("upload_id")) throw new YouTubeError("Google returned an invalid upload session.");
-  return url2.href;
+  if (url3.protocol !== "https:" || !["www.googleapis.com", "youtube.googleapis.com"].includes(url3.hostname) || url3.port || url3.username || url3.password || url3.hash || !/^\/upload\/youtube\/v3\/videos\/?$/.test(url3.pathname) || !url3.searchParams.get("upload_id")) throw new YouTubeError("Google returned an invalid upload session.");
+  return url3.href;
 }
 async function inspectMp4(file2, signal) {
   const handle = await open6(file2, "r");
@@ -48632,14 +48635,14 @@ async function completed(job, response) {
   return youtubeJobSummary(job);
 }
 async function transfer(credentials, job, source, options) {
-  const url2 = safeYouTubeSession(job.sessionUrl);
+  const url3 = safeYouTubeSession(job.sessionUrl);
   let attempts = 0;
   let stalled = 0;
   try {
     while (true) {
       await source.check();
       try {
-        const probe = await youtubeRequest(credentials, url2, { method: "PUT", headers: { "Content-Range": `bytes */${job.bytes}`, "Content-Length": "0" }, body: Buffer.alloc(0) }, options.signal);
+        const probe = await youtubeRequest(credentials, url3, { method: "PUT", headers: { "Content-Range": `bytes */${job.bytes}`, "Content-Length": "0" }, body: Buffer.alloc(0) }, options.signal);
         if (probe.ok) return await completed(job, probe);
         const offset = receivedBytes(probe, job.bytes);
         await probe.body?.cancel();
@@ -48648,7 +48651,7 @@ async function transfer(credentials, job, source, options) {
         const read2 = await source.handle.read(bytes, 0, bytes.length, offset);
         if (read2.bytesRead !== bytes.length) throw new Error("The MP4 changed during upload. Restore it before resuming.");
         await source.check();
-        const response = await youtubeRequest(credentials, url2, { method: "PUT", headers: { "Content-Type": "video/mp4", "Content-Length": String(bytes.length), "Content-Range": `bytes ${offset}-${offset + bytes.length - 1}/${job.bytes}` }, body: new Uint8Array(bytes) }, options.signal);
+        const response = await youtubeRequest(credentials, url3, { method: "PUT", headers: { "Content-Type": "video/mp4", "Content-Length": String(bytes.length), "Content-Range": `bytes ${offset}-${offset + bytes.length - 1}/${job.bytes}` }, body: new Uint8Array(bytes) }, options.signal);
         if (response.ok) return await completed(job, response);
         const uploaded = receivedBytes(response, job.bytes);
         await response.body?.cancel();
@@ -48891,18 +48894,32 @@ var metadataFields = {
   /** Facts the server cannot read from the file, such as tempo or mood; they override what it measured. */
   details: detailsInput.default({})
 };
+var LIBRARY_UPLOAD_MAX_BYTES = 95 * 1024 * 1024;
+var libraryBlobSha = external_exports.string().regex(/^[a-f0-9]{64}$/, "Use the file's lowercase hex SHA-256.");
+var url2 = external_exports.string().trim().url().max(500);
+var libraryOrigin = external_exports.object({
+  name: text(80),
+  url: url2,
+  author: external_exports.string().trim().min(1).max(120).optional(),
+  authorUrl: url2.optional(),
+  license: text(80),
+  licenseUrl: url2.optional()
+});
 var libraryPublishBody = external_exports.object({
   /** Defaults to the title as a slug. */
   id: slug.optional(),
-  projectId: external_exports.string().regex(/^prj_[A-Za-z0-9]{8,40}$/),
+  /** The project an asset or sprite comes from; uploads have none. */
+  projectId: external_exports.string().regex(/^prj_[A-Za-z0-9]{8,40}$/).optional(),
   source: external_exports.discriminatedUnion("kind", [
     external_exports.object({ kind: external_exports.literal("asset"), assetId: external_exports.string().uuid() }),
-    external_exports.object({ kind: external_exports.literal("sprite"), character: slug })
+    external_exports.object({ kind: external_exports.literal("sprite"), character: slug }),
+    /** Audio uploaded with PUT /api/v1/asset-library/uploads/SHA256, e.g. a CC0 recording, with who made it. */
+    external_exports.object({ kind: external_exports.literal("upload"), type: external_exports.enum(["music", "sfx"]), sha: libraryBlobSha, origin: libraryOrigin })
   ]),
   /** Replace an existing entry with the same id. */
   replace: external_exports.boolean().default(false),
   ...metadataFields
-});
+}).refine((body) => body.source.kind === "upload" || body.projectId, { message: "Choose a project.", path: ["projectId"] });
 var libraryUpdateBody = external_exports.object({ ...metadataFields, keywords: keywordList, details: detailsInput }).partial().refine((value) => Object.keys(value).length > 0, "Change at least one field.");
 
 // cli/src/library.ts
@@ -48961,6 +48978,24 @@ async function updateLibraryAsset(client, id2, flags) {
   return client.request(libraryPath(id2), { method: "PATCH", body: checked(libraryUpdateBody.safeParse(await words(flags))), timeout: 12e4 });
 }
 
+// shared/projects.ts
+var MOVE_WORK_MAX = 50;
+var moveList = (item) => external_exports.array(item).max(MOVE_WORK_MAX).default([]);
+var moveWorkBody = external_exports.object({
+  to: external_exports.string().trim().regex(/^prj_[A-Za-z0-9]{8,40}$/, "Choose the project to move the work to."),
+  characters: moveList(external_exports.string().trim().regex(/^[A-Za-z0-9][A-Za-z0-9_.-]{0,79}$/, "Use a character id from the project.")),
+  assets: moveList(external_exports.string().trim().uuid("Use an asset id from the project.")),
+  avatars: moveList(heygenId)
+}).refine((body) => body.characters.length + body.assets.length + body.avatars.length > 0, { message: "Choose at least one character, asset or avatar to move." }).refine((body) => body.characters.length + body.assets.length + body.avatars.length <= MOVE_WORK_MAX, { message: `Move at most ${MOVE_WORK_MAX} items at a time.` });
+
+// cli/src/projects.ts
+var commaList2 = (value) => value?.split(",").map((item) => item.trim()).filter(Boolean);
+async function moveWork(client, project, flags) {
+  const parsed = moveWorkBody.safeParse({ to: flags.to, characters: commaList2(flags.characters), assets: commaList2(flags.assets), avatars: commaList2(flags.avatars) });
+  if (!parsed.success) throw new Error(parsed.error.issues[0]?.message ?? "Choose what to move with --characters, --assets or --avatars.");
+  return client.request(`/api/v1/sprites/${encodeURIComponent(project)}/move`, { method: "POST", body: parsed.data });
+}
+
 // cli/src/commands.ts
 var assetModelIds = [...SPRITE_IMAGE_MODEL_IDS, ...SPRITE_VIDEO_MODEL_IDS, ...MUSIC_MODELS.map((m) => m.id), ...SPEECH_MODELS.map((m) => m.id), ...SFX_MODELS.map((m) => m.id)];
 var assetAuthorizationFlags = [
@@ -49007,9 +49042,9 @@ var workspaceQuery = async (client) => {
   const selected = await selectedWorkspace(client.origin);
   return selected === "me" ? "" : `?workspace=${encodeURIComponent(selected)}`;
 };
-async function openBrowser(url2) {
+async function openBrowser(url3) {
   const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "rundll32" : "xdg-open";
-  const args = process.platform === "win32" ? ["url.dll,FileProtocolHandler", url2] : [url2];
+  const args = process.platform === "win32" ? ["url.dll,FileProtocolHandler", url3] : [url3];
   await new Promise((resolve15) => {
     const child = spawn3(command, args, { stdio: "ignore", detached: true });
     child.once("error", () => resolve15());
@@ -49179,7 +49214,12 @@ Confirm code: ${device.user_code}`);
     const client = new Client(flags.url, signal);
     const selected = await selectedWorkspace(client.origin);
     out(stdout, await client.request("/api/v1/sprites", { method: "POST", body: { owner: selected, name: flags.name, ...selectedModels(flags) } }));
-  }))).add(defineCommand("get", { description: "Read project, subjects, animations, estimates and job state" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(projectPath(args.id)))))).add(defineCommand("rename", { description: "Rename a project" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).flags({ name: "name", type: "string", required: true }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`/api/v1/projects/${encodeURIComponent(args.id)}`, { method: "PATCH", body: { name: flags.name } }))))).add(defineCommand("delete", { description: "Delete a project; requires --yes" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).flags({ name: "yes", type: "boolean", required: true }).action(async ({ args, flags, stdout, signal }) => {
+  }))).add(defineCommand("get", { description: "Read project, subjects, animations, estimates and job state" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(projectPath(args.id)))))).add(defineCommand("rename", { description: "Rename a project" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).flags({ name: "name", type: "string", required: true }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`/api/v1/projects/${encodeURIComponent(args.id)}`, { method: "PATCH", body: { name: flags.name } }))))).add(defineCommand("move", { description: "Move characters (with their animations), saved assets and avatars to another project you can write to" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).flags(
+    { name: "to", type: "string", required: true, description: "Project ID to move the work to" },
+    { name: "characters", type: "string", description: "Comma-separated character slugs from projects get" },
+    { name: "assets", type: "string", description: "Comma-separated asset IDs from assets list" },
+    { name: "avatars", type: "string", description: "Comma-separated avatar group IDs from avatars list --ownership private" }
+  ).action(async ({ args, flags, stdout, signal }) => out(stdout, await moveWork(new Client(flags.url, signal), args.id, flags))))).add(defineCommand("delete", { description: "Delete a project; requires --yes" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).flags({ name: "yes", type: "boolean", required: true }).action(async ({ args, flags, stdout, signal }) => {
     if (!flags.yes) throw new Error("Pass --yes to delete this project.");
     out(stdout, await new Client(flags.url, signal).request(`/api/v1/projects/${encodeURIComponent(args.id)}`, { method: "DELETE" }));
   })))).command("assets", (assets) => assets.add(defineCommand("list", { description: "List saved assets, their blob hashes, and configured generation models" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${projectPath(args.id)}/assets`))))).add(defineCommand("generate", { description: "Generate an image, video, music, speech or sound-effect asset; --yes authorizes credits" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags(
@@ -49260,7 +49300,7 @@ Confirm code: ${device.user_code}`);
     if (!flags.yes) throw new Error("Pass --yes to authorize spending credits.");
     const body = spriteJobBody.parse({ kind: "character", name: flags.name, description: flags.description, ...flags.style ? { style: flags.style } : {}, subjectKind: flags.kind, actions: actions(flags.actions), ...selectedModels(flags) });
     out(stdout, await new Client(flags.url, signal).request(`${projectPath(args.id)}/jobs`, { method: "POST", body }));
-  }))).add(defineCommand("schema", { description: "Print the Crust command schema for agent discovery" }, (command) => command.action(async ({ stdout }) => out(stdout, await createCli().snapshot())))).command("files", (files) => files.add(defineCommand("import", { description: "Import a PNG, JPEG or WebP reference; --yes authorizes redraw costs when configured" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags(...modelFlags).flags({ name: "file", type: "string", required: true }, { name: "name", type: "string", required: true }, { name: "description", type: "string" }, { name: "yes", type: "boolean", required: true }).action(async ({ args, flags, stdout, signal }) => {
+  }))).add(defineCommand("schema", { description: "Print the Crust command schema for agent discovery" }, (command) => command.action(async ({ stdout }) => out(stdout, await createCli().snapshot())))).command("files", (files) => files.add(defineCommand("import", { description: "Import a PNG, JPEG or WebP reference and draw it in --style; --yes authorizes redraw costs when configured" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags(...modelFlags).flags({ name: "file", type: "string", required: true }, { name: "name", type: "string", required: true }, { name: "description", type: "string" }, { name: "style", type: "string", choices: SPRITE_STYLES, description: "Artwork style to draw it in (default hd-cartoon)" }, { name: "yes", type: "boolean", required: true }).action(async ({ args, flags, stdout, signal }) => {
     if (!flags.yes) throw new Error("Pass --yes to authorize reference redraw costs.");
     const extension = flags.file.split(".").at(-1)?.toLowerCase();
     const type = extension === "png" ? "image/png" : extension === "jpg" || extension === "jpeg" ? "image/jpeg" : extension === "webp" ? "image/webp" : void 0;
@@ -49271,6 +49311,7 @@ Confirm code: ${device.user_code}`);
     form.set("image", new Blob([bytes], { type }), `reference.${extension}`);
     form.set("name", flags.name);
     if (flags.description) form.set("description", flags.description);
+    if (flags.style) form.set("style", flags.style);
     for (const [key, value] of Object.entries(selectedModels(flags))) form.set(key, value);
     out(stdout, await new Client(flags.url, signal).request(`${projectPath(args.id)}/reference`, { method: "POST", body: form }));
   }))).add(defineCommand("list", { description: "List project file paths and content hashes" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`/api/v1/projects/${encodeURIComponent(args.id)}/files`))))).add(defineCommand("export", { description: "Download all project assets as a ZIP; refuses to overwrite" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).flags({ name: "output", type: "string", required: true }).action(async ({ args, flags, stdout, signal }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docyrus/animaguru",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "Agent-friendly AnimaGuru CLI built with CrustJS",
   "type": "module",
   "bin": {

package/skills/animaguru/SKILL.md

@@ -39,7 +39,7 @@ CLI/API balances, estimates, credit ranges and queued-job receipts use AnimaGuru
 
 ## Standalone images, video, music and speech
 
-CLI 0.4.0 adds `assets generate`, `assets submit`, `assets list`, and `assets download`. Use `assets list PROJECT_ID` to discover saved assets and configured provider models. Create neutral asset projects with `projects create --name NAME`. Projects have no art style; choose style when generating an individual sprite.
+CLI 0.4.0 adds `assets generate`, `assets submit`, `assets list`, and `assets download`. Use `assets list PROJECT_ID` to discover saved assets and configured provider models. Create asset projects with `projects create --name NAME`. Projects have no art style; choose the style for each sprite with `generate --style` or `files import --style`.
 
 ```sh
 animaguru assets generate PROJECT_ID --type image --name "Forest" \
@@ -75,6 +75,8 @@ animaguru files export PROJECT_ID --output forest-cast.zip
 
 `jobs wait` tracks only the specified job. Drawing can queue follow-up animations: inspect `jobs list` and wait for the relevant jobs before exporting. A timeout or CLI exit does not cancel server work. Inspect existing jobs before retrying a paid submission to avoid duplicate charges. Report failed jobs and their errors instead of repeatedly submitting the same work.
 
+`projects move PROJECT_ID --to OTHER_PROJECT_ID [--characters SLUG,SLUG] [--assets ASSET_ID] [--avatars GROUP_ID]` moves work between projects for free: characters with all their animations, saved assets and the project's own avatars. Use it to gather work into one project instead of regenerating it; it needs CLI 0.16.0.
+
 `files export` downloads a ZIP and refuses to overwrite an existing file. Choose a fresh output path. Inspect the exported manifest and actual assets before integrating them into the game or app; use their real dimensions, frame ordering, and animation metadata.
 
 ## Shared workspace commands

package/skills/animaguru/references/sprites.md

@@ -26,4 +26,4 @@ Custom motion:
 
 Custom motions require 2–12 frame descriptions, a 20–600 character prompt, and 4–24 fps. Explicit model flags override selections in the JSON file.
 
-Import reference artwork with `animaguru files import PROJECT_ID --file knight.png --name Knight --description "Keep the blue armor" --yes`. PNG, JPEG, and WebP are accepted up to 10 MB. When configured, the service redraws the reference and charges credits; otherwise it imports the original artwork.
+Import reference artwork with `animaguru files import PROJECT_ID --file knight.png --name Knight --style pixel --description "Keep the blue armor" --yes`. PNG, JPEG, and WebP are accepted up to 10 MB. `--style` picks the art style to redraw it in (projects have none; without it the drawing is hd-cartoon, and it needs CLI 0.16.0). When configured, the service redraws the reference and charges credits; otherwise it imports the original artwork.

package/skills/animaguru-cutcraft/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: animaguru-cutcraft
+description: Create AnimaGuru Cutcraft explainers and product stories with tactile paper collage, precise editorial typography, purposeful motion, and AnimaGuru-generated media. Use for this visual treatment or a Vox-inspired explainer adapted to AnimaGuru.
+---
+
+# AnimaGuru Cutcraft
+
+Make an original editorial film that explains an idea through things the viewer can see move, connect, separate and resolve. Use AnimaGuru for generation and a controlled composition for titles, labels, timing and branding. The style can serve another product; use that product's facts and identity.
+
+## Establish the film
+
+Reuse the user's subject, references, language, placement and generation authorization. Resolve only consequential missing choices. For an exploratory sample, state sensible assumptions and proceed: a short English landscape film with a single narrator is a useful starting point, not a requirement for every film.
+
+Read first-party product material before writing claims. Separate actual product footage from conceptual illustrations in the production records. Avoid unverified performance claims, invented customer evidence, and promises of perfect AI results. End an advertisement with a relevant invitation; end an educational explainer on its insight unless a CTA was requested.
+
+Write a concise narration and a beat sheet pairing each spoken idea with a visible event. Duration follows the measured voice and the user's brief. A problem, a concrete mechanism, an outcome and a short close can work for a product film; choose the structure that fits the subject.
+
+## The Cutcraft visual language
+
+- **Material:** matte colored cardstock, visible fibers, slightly irregular scissor edges and short directional contact shadows. Layer flat pieces; keep silhouettes readable. Avoid glossy plastic and unrelated photorealistic environments.
+- **AnimaGuru palette:** warm cream `#F7F2E8`, ink `#162B38`, brand blue `#2C6BD0`, orange `#E67D43`, with restrained sage `#93AA8B`. For client films, replace accents with the client's brand. Backgrounds should have quiet areas for type.
+- **Typography:** one bold editorial heading family and a compatible reading face. Use actual local fonts, vector logos and rendered text for names, numbers and claims. Keep generated footage free of essential lettering. Short labels summarize; narration carries the full sentence.
+- **Composition:** one dominant idea per beat, useful negative space, visibly separated foreground and background. A print-like grid, small folio marks and a fine blue connector line give the film its own identity. Avoid copying Vox's logo, layouts or other identifying brand elements.
+- **Motion:** cutouts slide, rotate at plausible paper joints, pin into place, peel, stack or reveal. A connector is drawn when a relationship becomes clear. Motion answers the spoken line; texture and camera movement remain restrained.
+- **Continuity:** lock material, light direction, palette, camera language and recurring character description. An orange fox with a cobalt scarf is an optional AnimaGuru motif, not compulsory casting for other subjects.
+- **Sound:** one narrator across the film, a quiet instrumental bed and a few motivated paper taps or rustles. Keep speech intelligible and let the closing thought breathe.
+
+Build a visual explanation instead of using the same decorative collage under every sentence. If illustrating control, visibly move one object while its surroundings stay fixed. If explaining a connected workflow, show the pieces joining in the order the narration names them.
+
+## Generate with AnimaGuru
+
+Read [the generation adapter](references/generation.md) when producing media. It covers CLI discovery, supported references, credit estimates, continuity and local assembly. Do not substitute MaxFusion calls or assume a Google Omni model exists.
+
+Prefer the installed AnimaGuru CLI for local asset work; use connected MCP tools when they are available and appropriate. Creating this skill is not generation authorization. A user request to generate the film authorizes a proportionate initial attempt; honor stated budgets and surface a concrete estimate before submission. Do not purchase credits or change provider defaults as part of film production.
+
+Generate artwork and motion separately from exact type. For a short trial, a few strong compositions with changing editorial labels usually communicate more than many loosely related clips. Reuse good existing textures, music or SFX when they fit. A generated clip may be one layer inside a controlled film rather than the entire frame.
+
+For precise placement or when video providers are unavailable, generate isolated transparent paper subjects and animate their transforms in the composition. Build the fixed setting from separate paper layers. This is a complete production route: character movement, path reveals, clip placement and typography can remain editable without a video-model call. Describe it as animation of generated artwork, not as AI-generated video footage.
+
+Use a single speech asset or consistently configured segments. Measure the recording before finalizing scenes; do not assume the requested pacing was achieved. Replace or mute incidental speech from video generation when using the separate narrator.
+
+## Review and deliver
+
+Keep the brief, narration, scene timings, request settings, estimates, job IDs, returned asset IDs, costs and source links together with the film's production files. Preserve an editable composition or reproducible render recipe and local copies of the media.
+
+Inspect the actual opening, middle, transitions and closing frames. Check exact brand spelling, readable labels, character consistency, contrast, crop and any model artifacts. Check audio duration and clipping; listen when playback tools permit, and describe listening limitations honestly. Repair the composition before buying another generation when timing, crop or typography can solve the problem.
+
+Export a playable local film and report what was generated, what was reused, and any remaining defects. Return a preview, the final file, and a link to the skill. Creating a film does not imply publishing it publicly or changing the product website.

package/skills/animaguru-cutcraft/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "AnimaGuru Cutcraft"
+  short_description: "Paper collage explainers made with AnimaGuru"
+  default_prompt: "Use $animaguru-cutcraft to make a short AnimaGuru explainer with tactile paper collage and precise editorial motion."

package/skills/animaguru-cutcraft/references/generation.md

@@ -0,0 +1,61 @@
+# AnimaGuru generation adapter
+
+## Discover the actual environment
+
+For CLI work, inspect `animaguru --help`, `animaguru schema`, `animaguru auth status`, `animaguru credits` and `animaguru catalog`. Do not read credential files. If it is absent, use connected MCP or obtain agreement to install the CLI; installation and authentication are separate actions.
+
+List projects before choosing one, then inspect the selected project and `assets list PROJECT_ID`. Reuse the user's project where appropriate. Use returned project IDs, asset IDs and file SHAs. Create a separate project when the film needs its own asset container. Saved filenames are not file SHAs.
+
+The CLI catalog describes known capabilities; the live project's `availableModels` and `videoProfiles` describe enabled models. Choose from their intersection. A local `--dry-run` can succeed for a disabled server model, so it does not prove provider availability.
+
+With MCP, discover the equivalent project, catalog, assets, estimate, generate and job tools. If account linking is needed, let the user complete it. Never invent tool calls or fall back to database access.
+
+## Plan and estimate
+
+Save requests as JSON and validate each with `assets generate ... --dry-run` or a batch with `assets batch PROJECT_ID --file REQUESTS.json --dry-run`. Add all estimates, including speech and any music/SFX, before the first submission. These are AnimaGuru credits; compare returned amounts directly with the authorized credit budget. Actual usage can differ from estimates.
+
+Use only a model and options returned by the live catalog. An image can establish an art direction or become a video reference. An illustrative prompt shell is:
+
+> Original tactile editorial paper collage: matte warm cream cardstock, cobalt blue and fox-orange cutouts, visible paper fibers, slightly imperfect scissor edges, soft short shadows falling down-right. [One concrete composition and action.] Restrained studio lighting and readable silhouettes. Keep a quiet area for separately composed editorial type. No lettering, captions, logos or watermark.
+
+Describe the subject, position, scale and material of each important element. Keep recurring character features verbatim between requests. Exact logos and text belong in the composition, not in model-generated pixels.
+
+## Submit and track
+
+For example, after replacing placeholders with discovered values and validating the settings:
+
+```sh
+animaguru assets generate PROJECT_ID --type image --name "cutcraft-keyframe" \
+  --model IMAGE_MODEL --aspect-ratio 3:2 --prompt "SAVED ART DIRECTION" --dry-run
+animaguru assets generate PROJECT_ID --type video --name "cutcraft-scene" \
+  --model VIDEO_MODEL --workflow image-to-video --reference IMAGE_FILE_SHA \
+  --seconds 8 --resolution 768p --mode speed \
+  --prompt "SAVED VISUAL ACTION" --dry-run
+```
+
+The literal values above are examples, not assumed capabilities. Image aspect ratios, video modes, duration limits, soundtrack handling and audio support vary by model. Add `--yes` only for the user's authorized work. Save the queued receipt immediately. Submission results may be job receipts rather than completed assets.
+
+Use `jobs list PROJECT_ID` and `jobs wait PROJECT_ID JOB_ID --timeout SECONDS` to track the original job. A timeout does not cancel it. Check the job and saved assets before resubmitting after an uncertain response. Do not repeatedly regenerate failed work without diagnosing the error and checking the remaining budget.
+
+When a job explicitly fails because its provider is unavailable, preserve that receipt and inspect models from another provider. A replacement with compatible capabilities and an estimate inside the authorized scope can continue the task. Remove unsupported options when changing providers; a seed or prompt-expansion setting valid for one model may be invalid for another. Relay the returned charge or refund status without assuming all failed jobs are free.
+
+Download finished assets with `assets download PROJECT_ID ASSET_ID --output FILE`. Keep stdout receipts separate from media and never overwrite an existing downloaded file inadvertently.
+
+## Choose continuity deliberately
+
+- For different explanatory ideas, use intentional cuts, a shared palette and a common layout. An unrelated next scene does not need the previous clip's last frame.
+- For one continuous action, use a supported video extension workflow with the saved video file SHA as `--source`. Inspect the catalog for its resolution and duration limits. `extendOutput` distinguishes the combined video from continuation-only output; inspect and trim any returned overlap rather than counting it twice.
+- First/last-frame workflows use `--reference` and `--end-reference` only when the model profile supports them. Both must be saved files belonging to the selected project.
+- A locally extracted end frame is not automatically a project asset. Use an explicitly supported upload/import path before referencing it; do not invent an extract-frame or raw upload MCP tool. A character-import command can redraw and charge credits, so it is not a transparent generic frame upload.
+
+Do not carry over the reference workflow's fixed ten-second clip assumption. Choose durations from the model profile and the story, and measure the returned files.
+
+## Narration and assembly
+
+Generate one narrator with `assets generate ... --type speech --voice VOICE --delivery INSTRUCTIONS --prompt TRANSCRIPT`, after discovering the available speech model and voice. Use delivery instructions supported by that provider. Keep the spoken transcript independent of the visual directions. Download and measure the actual recording with `ffprobe`.
+
+For generated motion layers, mute their sound when it conflicts with the separate narration. Reuse or generate a compatible instrumental bed at low level. Keep clip selection, crop, text, logos and all timing deterministic in the composition. Use an existing AnimaGuru HTML/Pixi film workspace when one is supplied; otherwise choose a local composition/export tool suited to the requested deliverable. Keep source files and a reproducible export command.
+
+For controlled cutout animation, request `transparent: true` image assets (CLI `--transparent`) and check the downloaded alpha channel. Keep a subject's complete silhouette inside the image. Animate these assets as separate layers against a fixed setting; drive position, rotation, entrances and holds from absolute time. Use actual transparent silhouettes for a moving subject instead of moving an opaque rectangular illustration. If video providers are all unavailable, this route can complete the film using working image and speech providers without repeated failed video submissions.
+
+Normalize frame size, frame rate and pixel format before concatenation. Export a broadly playable H.264/AAC MP4, or the user's requested format. Check duration, dimensions, audio presence, frame count and representative rendered frames. Preserve truthful asset attribution: motion made with AnimaGuru remains generated footage even when exact typography and editing are composed locally.