Update to PixVerse

{
  "description": "PixVerse setup: repair CLI or FFmpeg dependencies, authenticate and diagnose account readiness when setup blocks the requested workflow.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 218
    }
  ],
  "name": "pixverse-setup",
  "skill_md_contents": "---\nname: pixverse-setup\ndescription: \"PixVerse setup: repair CLI or FFmpeg dependencies, authenticate and diagnose account readiness when setup blocks the requested workflow.\"\n---\n\n# PixVerse Setup\n\nUse this when the user asks to install, authenticate, diagnose, check balance, inspect slots, fix PixVerse CLI problems, or understand command/queue syntax.\n\n## Installed Command\n\nBefore running helper commands, resolve the absolute plugin root from this `SKILL.md` path: it is two directories above this skill directory and contains `.codex-plugin/plugin.json`. In every new shell session, set:\n\n```bash\nPVX=\"<absolute-plugin-root>/scripts/pvx\"\n```\n\nRun helper commands through `\"${PVX}\"`. Do not assume the user's current working directory is the plugin checkout, and do not bypass the installed wrapper with a module invocation.\n\nRead the internal playbooks that match the issue:\n\n- first-run setup, dependencies, login, FFmpeg, doctor: `../../skills-internal/pixverse-agent-setup/SKILL.md`\n- command forms, model ids, queue specs, task polling, CLI errors: `../../skills-internal/pixverse-agent-gateway/SKILL.md`\n- Canvas binding, graph sync/mutation, paid reconciliation, browser handoff: `../../skills-internal/pixverse-agent-canvas/SKILL.md`\n- project bootstrap after setup is ready: `../../skills-internal/pixverse-agent-project-memory/SKILL.md`\n\nRead `../../skills-shared/web-handoff.md` before any OAuth, subscription, workspace-management, or\nCanvas browser action. Every plugin web destination uses the Codex in-app Browser by default.\n\nThe latest reviewed npm release is `1.4.5` (reviewed 2026-09-22). `1.4.0` is the compatibility floor, not an install pin. Refresh the online runtime with `\"${PVX}\" bootstrap --yes` when the user asks to update or when installing/replacing this plugin. A global CLI upgrade does not refresh this private runtime. Read `../../skills-shared/pixverse-cli-1.4.5.md` for the current CLI changes.\n\n## Setup Gate\n\nPixVerse Agent Plugin `1.3.2` requires `pixverse>=1.4.0` and Node.js `>=22.12.0` on both managed channels, and never uses a global `pixverse` package. Setup reports `pixverse_cli_channel`: the online plugin installs npm `latest` in its private stable runtime, while the local plugin installs only the internal ZIP bundled with that plugin into a separate internal runtime. A local package is rejected if its bundled CLI declares a different Node engine.\n\nStart with cached readiness:\n\n```bash\n\"${PVX}\" setup status\n```\n\nIf status is missing or blocked, refresh checks:\n\n```bash\n\"${PVX}\" doctor\n```\n\nIf doctor reports the managed CLI missing or below minimum, or when installing/updating the plugin, refresh it in one call:\n\n```bash\n\"${PVX}\" bootstrap --yes\n```\n\nOn the online channel, this installs `pixverse@latest` when absent and refreshes an existing supported version. On the internal channel, it verifies, extracts, dependency-installs, smoke-tests, and activates the bundled internal ZIP. A matching internal runtime is reused only after its install metadata, package/capabilities, dependencies, entrypoints, and smoke test still pass; otherwise bootstrap rebuilds it from the ZIP. Internal installation never falls back to npm latest, and a failed update preserves the previously active internal CLI.\n\nDoctor probe timeouts are returned as structured blocked checks and cached with next steps; they must not surface as Python tracebacks or be mistaken for missing binaries. Retry doctor after checking connectivity, and only start paid work once auth and slot capacity are readable.\n\nUpgrading the plugin/CLI (including replacing a same-version package) must preserve existing CLI\ncredentials and reuse the Codex IAB profile. Do not run login/logout or clear authorization solely\nbecause the version changed; an expired or revoked session still follows the normal login flow.\n\nIf PixVerse auth is missing:\n\n```bash\n\"${PVX}\" pixverse auth login --json\n\"${PVX}\" doctor\n```\n\nRun login as one long-lived call. The wrapper forces JSON mode, preventing PixVerse CLI from opening\nthe system browser. As soon as stderr emits `Authorize at: <url>`, open that exact URL in the Codex\nin-app Browser and keep the login process alive while the user authorizes. Never ask them to paste\naccount tokens. After completion, `doctor` refreshes cached auth/readiness. If the URL is not emitted or\nlogin remains false, run `\"${PVX}\" pixverse auth status --json`, check connectivity, and retry login once\nrather than attempting paid work. Use `--open-system` only after an explicit user request.\n\nUse the wrapper for realpath-safe CLI calls:\n\n```bash\n\"${PVX}\" pixverse --version\n\"${PVX}\" pixverse auth status --json\n```\n\n## Canvas Setup Routing\n\nCanvas setup, login, account, balance, membership, and active-workspace failures still use the setup\ngates in this skill. For project binding, graph checkpoints, guarded mutations, paid node generation,\ncredit reconciliation, and browser handoff, read\n`../../skills-internal/pixverse-agent-canvas/SKILL.md`; that is the canonical Canvas playbook.\nCanvas Browser login and PixVerse CLI authentication are separate sessions.\n\n## Balance And Slots\n\nBefore paid generation or queue planning:\n\n```bash\n\"${PVX}\" billing snapshot\n\"${PVX}\" quote queue <queue.json>\n```\n\nAfter setup, generation proceeds automatically after preflight by default, including the first batch. Only effective `require` waits for batch approval. If the user asks to control spending, enable project confirmation; “Allow future generation” restores automatic execution. Follow `../../skills-shared/generation-confirmation.md`.\n\nThe same preflight reports login and membership. Follow `../../skills-shared/quality-policy.md`:\nFree/Basic must stop and choose upgrade or fallback; any model-entitlement rejection also\npauses generation. Show the clickable subscription/recharge link, then wait for the user's\nchoice. Upgrade is followed by a live recheck; fallback consent enables v6 540p / Nano Banana\n2 Lite 1080p with a fresh preflight. Obtain the subscription URL using:\n\n```bash\n\"${PVX}\" pixverse subscribe\n```\n\nDo not call `subscribe` without the user's intent. It returns a structured handoff that must be opened\nin the Codex in-app Browser; it does not open the system browser by default. If a user explicitly\nconfirms that their displayed Free/Basic account is an unrestricted internal test account, record the\nlocal exception with `\"${PVX}\" preferences membership-routing unrestricted-test`; never infer or offer\nthat override to ordinary users. It changes model routing only—login, balance, quote, and approval\ngates remain active.\n"
}