@docyrus/animaguru 0.7.0 → 0.7.1

package/README.md

@@ -72,6 +72,21 @@ Running `init` again refreshes an existing skill with the bundled version withou
 
 The default server is https://animaguru.com. Use `--url http://localhost:5190` on the leaf command or `ANIMAGURU_URL` to override it. HTTP is allowed only for loopback development. Authentication is stored separately per server in `~/.config/animaguru/credentials.json`, with file permissions 0600. Set `ANIMAGURU_CONFIG_DIR` for an isolated configuration directory. Browser login uses a ten-minute, single-use device code and receives a seven-day revocable Better Auth session. `auth login --no-browser` prints the URL for manual use. `auth logout` revokes the token. `ANIMAGURU_TOKEN` supports secret injection by agent runners; do not put tokens in arguments or commit them.
 
+## Personal and team projects
+
+CLI 0.7.1 can select a cloud workspace for project listing, project creation, and credit balances:
+
+```sh
+animaguru workspaces list
+animaguru workspaces use team_0123456789abcdef0123456789abcdef
+animaguru projects list
+animaguru projects create --name "Shared cast" --style pixel
+animaguru credits
+animaguru workspaces use personal
+```
+
+Use a team ID returned by `workspaces list`. The choice is saved per server in the existing credentials file. `workspaces list` also shows invitations; accept invitations in the web app before selecting that team. `projects get`, generation, jobs, and files use the project ID and work for any project you can access, regardless of the selected workspace. With `ANIMAGURU_TOKEN`, set `ANIMAGURU_WORKSPACE=personal` or a team ID instead of saving a selection. A cloud team is separate from the local `animaguru create workspace NAME` video folder.
+
 ## Agent workflow
 
 ```sh

package/dist/animaguru.js

@@ -542,7 +542,7 @@ var init_dist = __esm({
 // cli/package.json
 var package_default = {
   name: "@docyrus/animaguru",
-  version: "0.7.0",
+  version: "0.7.1",
   description: "Agent-friendly AnimaGuru CLI built with CrustJS",
   type: "module",
   bin: {
@@ -25871,6 +25871,22 @@ async function writeCredentials(credentials) {
   await chmod2(temp, 384);
   await rename2(temp, path);
 }
+async function selectedWorkspace(origin) {
+  const saved = process.env.ANIMAGURU_TOKEN ? void 0 : (await readCredentials())[origin]?.workspaceId;
+  const value = process.env.ANIMAGURU_WORKSPACE ?? saved ?? "me";
+  if (value === "personal" || value === "me") return "me";
+  if (!/^team_[a-f0-9]{32}$/.test(value)) throw new Error("ANIMAGURU_WORKSPACE must be 'personal' or a team ID.");
+  return value;
+}
+async function saveWorkspace(origin, workspaceId) {
+  if (process.env.ANIMAGURU_TOKEN) throw new Error("With ANIMAGURU_TOKEN, set ANIMAGURU_WORKSPACE instead of saving a workspace.");
+  if (process.env.ANIMAGURU_WORKSPACE) throw new Error("Unset ANIMAGURU_WORKSPACE before changing the saved workspace.");
+  const credentials = await readCredentials();
+  const saved = credentials[origin];
+  if (!saved || saved.expiresAt <= Date.now()) throw new Error("Sign in with animaguru auth login first.");
+  credentials[origin] = { ...saved, workspaceId };
+  await writeCredentials(credentials);
+}
 var ServiceError = class extends Error {
   constructor(status, code, message) {
     super(message);
@@ -27349,6 +27365,10 @@ var id = { name: "id", type: "string", required: true, description: "Project ID"
 var out = (stdout, data) => stdout(JSON.stringify(data));
 var actions = (text) => text ? text.split(",").map((s) => s.trim()).filter(Boolean) : [];
 var projectPath = (project) => `/api/v1/sprites/${encodeURIComponent(project)}`;
+var workspaceQuery = async (client) => {
+  const selected = await selectedWorkspace(client.origin);
+  return selected === "me" ? "" : `?workspace=${encodeURIComponent(selected)}`;
+};
 async function openBrowser(url2) {
   const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "rundll32" : "xdg-open";
   const args = process.platform === "win32" ? ["url.dll,FileProtocolHandler", url2] : [url2];
@@ -27419,7 +27439,29 @@ Confirm code: ${device.user_code}`);
     delete credentials[client.origin];
     await writeCredentials(credentials);
     out(stdout, { authenticated: false });
-  })))).add(defineCommand("credits", { description: "Show your remaining credit balance" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).action(async ({ flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request("/api/v1/credits"))))).add(defineCommand("catalog", { description: "List styles, kinds, actions, asset types, models, video settings and speech voices" }, (command) => command.action(({ stdout }) => out(stdout, { styles: SPRITE_STYLES, kinds: SPRITE_KINDS, actions: ALL_SPRITE_ACTIONS, imageModels: SPRITE_IMAGE_MODEL_IDS, videoModels: SPRITE_VIDEO_MODEL_IDS, assetTypes: ASSET_TYPES, musicModels: MUSIC_MODELS.map((m) => m.id), speechModels: SPEECH_MODELS.map((m) => m.id), sfxModels: SFX_MODELS.map((m) => m.id), elevenLabsVoices: ELEVENLABS_VOICES, voices: SPEECH_VOICES, videoProfiles: SPRITE_VIDEO_MODELS })))).command("projects", (projects) => projects.add(defineCommand("list", { description: "List your private projects" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).action(async ({ flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request("/api/v1/projects"))))).add(defineCommand("create", { description: "Create an empty sprite project; generate artwork with jobs submit" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).flags(...modelFlags).flags({ name: "name", type: "string", required: true }, { name: "style", type: "string", required: true, choices: SPRITE_STYLES }).action(async ({ flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request("/api/v1/sprites", { method: "POST", body: { name: flags.name, style: flags.style, ...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 }) => {
+  })))).command("workspaces", (workspaces) => workspaces.add(defineCommand("list", { description: "List Personal, joined teams and pending invitations" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).action(async ({ flags, stdout, signal }) => {
+    const client = new Client(flags.url, signal);
+    const data = await client.request("/api/v1/workspaces");
+    const selected = await selectedWorkspace(client.origin);
+    out(stdout, { ...data, current: data.workspaces.find((item) => selected === "me" ? item.type === "user" : item.id === selected) ?? null });
+  }))).add(defineCommand("use", { description: "Select Personal or a joined team for credits and project creation/listing" }, (command) => command.args({ name: "id", type: "string", required: true, description: "'personal' or a team ID from workspaces list" }).flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).action(async ({ args, flags, stdout, signal }) => {
+    const client = new Client(flags.url, signal);
+    const { workspaces: workspaces2 } = await client.request("/api/v1/workspaces");
+    const chosen = args.id === "personal" || args.id === "me" ? workspaces2.find((item) => item.type === "user") : workspaces2.find((item) => item.type === "team" && item.id === args.id);
+    if (!chosen) throw new Error("Workspace not found in your account. Run animaguru workspaces list.");
+    await saveWorkspace(client.origin, chosen.type === "user" ? "me" : chosen.id);
+    out(stdout, { current: chosen });
+  })))).add(defineCommand("credits", { description: "Show the selected workspace's remaining credit balance" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).action(async ({ flags, stdout, signal }) => {
+    const client = new Client(flags.url, signal);
+    out(stdout, await client.request(`/api/v1/credits${await workspaceQuery(client)}`));
+  }))).add(defineCommand("catalog", { description: "List styles, kinds, actions, asset types, models, video settings and speech voices" }, (command) => command.action(({ stdout }) => out(stdout, { styles: SPRITE_STYLES, kinds: SPRITE_KINDS, actions: ALL_SPRITE_ACTIONS, imageModels: SPRITE_IMAGE_MODEL_IDS, videoModels: SPRITE_VIDEO_MODEL_IDS, assetTypes: ASSET_TYPES, musicModels: MUSIC_MODELS.map((m) => m.id), speechModels: SPEECH_MODELS.map((m) => m.id), sfxModels: SFX_MODELS.map((m) => m.id), elevenLabsVoices: ELEVENLABS_VOICES, voices: SPEECH_VOICES, videoProfiles: SPRITE_VIDEO_MODELS })))).command("projects", (projects) => projects.add(defineCommand("list", { description: "List projects in the selected workspace" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).action(async ({ flags, stdout, signal }) => {
+    const client = new Client(flags.url, signal);
+    out(stdout, await client.request(`/api/v1/projects${await workspaceQuery(client)}`));
+  }))).add(defineCommand("create", { description: "Create an empty sprite project; generate artwork with jobs submit" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).flags(...modelFlags).flags({ name: "name", type: "string", required: true }, { name: "style", type: "string", required: true, choices: SPRITE_STYLES }).action(async ({ flags, stdout, signal }) => {
+    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, style: flags.style, ...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 }) => {
     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(

package/package.json

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

package/skills/animaguru/SKILL.md

@@ -16,7 +16,7 @@ Before creative work in a multi-animation workspace, select or create the intend
 Share the [animation-style gallery](https://animaguru.com/animation-styles), or open that URL in the internal browser when available, while asking the user to choose a style. Read the installed `animaguru.templates.json` for available styles and their skill names; `animaguru templates` lists the current CLI catalog. Offer the local catalog's choices so users select a skill actually installed in their workspace. Templates define appearance and motion; derive audience, message and story from the brief. Local scaffolding is separate from `projects create`, which creates a remote asset project. Never run `create` over an existing workspace.
 
 - Run `animaguru schema` for the installed command structure and flags, and `animaguru catalog` for styles, subject kinds, actions, asset types, models, video settings, and speech voices. Use `--help` on a leaf command for details.
-- Check `animaguru auth status` and `animaguru credits` before generation. If sign-in is needed, run `animaguru auth login --no-browser` and let the user approve the printed browser URL. Do not read or print stored credentials. Agent runners may inject `ANIMAGURU_TOKEN` as a secret.
+- Check `animaguru auth status`, `animaguru workspaces list`, and `animaguru credits` before generation. If sign-in is needed, run `animaguru auth login --no-browser` and let the user approve the printed browser URL. Select the user's requested Personal or team workspace with `animaguru workspaces use personal|TEAM_ID` before listing or creating projects. Do not read or print stored credentials. Agent runners may inject `ANIMAGURU_TOKEN` and `ANIMAGURU_WORKSPACE` as secrets or configuration.
 - The default service is `https://animaguru.com`. Respect an existing `ANIMAGURU_URL` or pass `--url` to the leaf command when the user chooses another service. HTTP is supported only for loopback development.
 
 ## Choose the project and submit work