@petercjl/infinite-canvas-cli 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Peter CJL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# Infinite Canvas CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`@petercjl/infinite-canvas-cli` uses an existing SealSeek Infinite Canvas board to generate videos through its native Agent conversation. It imports ordered reference images, sends the supplied prompt in a fresh conversation, downloads the video, and groups the original image nodes and video node in a Frame.
+
+This package requires Node.js 22+, installed Google Chrome on macOS or Windows and an installed `sealseek-media` CLI supporting image upload and canvas get/add. The package discovers and launches Chrome itself on loopback port 9223 with a persistent current-user dedicated profile. Browser login is completed in that window. The website supplies the selected model and authenticated account. Each authorized generation can incur charges.
+
+Each board file uses exactly one browser tab. Concurrent videos run in separate Agent conversations within that tab; UI submissions and canvas writes are queued while remote generation runs in parallel. Duplicate tabs must be resolved before submission or saving.
+
+`doctor` distinguishes Chrome installation from runtime state. An installed executable passes the browser dependency check while Chrome is stopped. `browser open` launches or reuses the dedicated instance; video execution prepares it automatically. A port/profile conflict is reported explicitly. Chrome outside the standard paths can be selected with `INFINITE_CANVAS_CHROME_BIN`.
+
+## Agent usage
+
+Provide the board ID, prompt and reference image attachments in their intended order. Send the Agent:
+
+> 使用 infinite-canvas，画板 ID 为「画板ID」，按所附图片顺序作为图1、图2，生成视频：「完整提示词」。
+
+To install:
+
+> 安装 @petercjl/infinite-canvas-cli 及其配套 Skill。
+
+To update:
+
+> 更新 @petercjl/infinite-canvas-cli 及其配套 Skill。
+
+To recover:
+
+> 使用 infinite-canvas，恢复任务「任务ID」。
+
+To synchronize the current Agent’s Skill:
+
+> 将 infinite-canvas 当前安装包的配套 Skill 同步到当前 Agent。
+
+Codex/macOS has completed six live video tasks across two boards. Other Agent adapters require runtime verification.
+
+## Developer entry points
+
+```sh
+npm install
+npm test
+node bin/infinite-canvas.mjs --help
+node bin/infinite-canvas.mjs doctor --json
+```
+
+See the bundled [Skill](skills/infinite-canvas-video/SKILL.md) and [runtime commands](skills/infinite-canvas-video/references/runtime.md). `capabilities --json` exposes machine-readable contracts. Video generation defaults to dry run; `--submit` starts a background job and returns its task ID. Resume never clicks Send again after a submission intent has been recorded.
+
+Canvas operations reuse the existing helper CLI. Frame grouping provides the missing atomic operation for reparenting existing nodes, with backup, fresh-read conflict checks and save/readback verification. Website-authenticated read and canvas operations are isolated in one browser adapter. The adapter does not directly submit generation endpoints.
+
+The service has no documented compare-and-swap canvas save contract. Avoid concurrent manual editing during a job; detected unsaved or conflicting changes stop progress for recovery. Canvas synchronization relies on the current webpage editor adapter and must be revalidated when the webpage changes.

package/bin/infinite-canvas.mjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import {META,ROOT,need,parse,readJSON,execute,stateRoot,newJSON,redact,safeId} from '../src/core.mjs';
+import {manifest,HELP} from '../src/contracts.mjs';
+import {automaticCheck,checkUpdate,installUpdate,updatePolicy,SKILL,skillStatus,installSkill} from '../src/lifecycle.mjs';
+
+const out=v=>console.log(JSON.stringify(v,null,2));
+async function main(argv){
+  const [command,action,...rest]=argv;
+  if(!command||['help','--help','-h'].includes(command))return console.log(HELP);
+  need(Number(process.versions.node.split('.')[0])>=22,'CAPABILITY_UNAVAILABLE','Node.js 22 or newer is required.');
+  if(['version','--version','-v'].includes(command)){const {args,options}=parse(argv.slice(1),{booleans:['json']});need(!args.length,'INVALID_ARGUMENT','Unexpected arguments.');return options.json?out({ok:true,name:META.name,version:META.version,entry:path.join(ROOT,'bin/infinite-canvas.mjs')}):console.log('infinite-canvas '+META.version);}
+  if(argv.includes('--help')||argv.includes('-h')){need(['video','task','frame','browser','board','skill','update','doctor','capabilities'].includes(command),'UNKNOWN_COMMAND','Unknown command.');return console.log(HELP);}
+  if(command==='_worker'){need(argv.length===2,'INVALID_ARGUMENT','Invalid worker invocation.');const {processJob}=await import('../src/workflow.mjs');return out(await processJob(action));}
+  if(command==='skill'){
+    const {options:o,args}=parse(rest,{values:['agent','path'],booleans:['json']});need(!args.length,'INVALID_ARGUMENT','Unexpected arguments.');
+    if(action==='source')return out({ok:true,source:SKILL,name:'infinite-canvas-video',version:META.version,installation:{named_agents:['codex'],fallback_agent:'generic',custom_path_required:true,scope:'selected Agent only'}});
+    if(action==='status')return out(await skillStatus(o.agent||'codex',o.path));
+    need(['install','update'].includes(action),'UNKNOWN_COMMAND','Use skill source/status/install/update.');return out(await installSkill(o.agent||'codex',o.path));
+  }
+  if(command==='update'){
+    if(action==='auto'){const [mode,...flags]=rest;const {args}=parse(flags,{booleans:['json']});need(['on','off','status'].includes(mode)&&!args.length,'INVALID_ARGUMENT','Use update auto on/off/status.');return out(await updatePolicy(mode));}
+    const {options:o,args}=parse(rest,{values:['agent','path'],booleans:['yes','json']});need(!args.length,'INVALID_ARGUMENT','Unexpected arguments.');
+    if(action==='check')return out({ok:true,...await checkUpdate({force:true})});
+    need(action==='install','UNKNOWN_COMMAND','Use update check/install.');return out(await installUpdate({yes:o.yes,agent:o.agent,destination:o.path}));
+  }
+  if(command==='capabilities'){const {args}=parse(argv.slice(1),{booleans:['json']});need(!args.length,'INVALID_ARGUMENT','Unexpected arguments.');await automaticCheck();return out({ok:true,...manifest});}
+  if(command==='doctor'){
+    const {options:o,args}=parse(argv.slice(1),{values:['canvas'],booleans:['live','json']});need(!args.length,'INVALID_ARGUMENT','Unexpected arguments.');await automaticCheck();const checks={node:process.version,entry:path.join(ROOT,'bin/infinite-canvas.mjs'),platform:process.platform,skill:SKILL};
+    for(const library of ['playwright-core','image-size']){try{await import(library);checks[library]={ok:true};}catch{checks[library]={ok:false};}}
+    try{checks.media={ok:true,version:(await execute(process.env.INFINITE_CANVAS_MEDIA_BIN||'sealseek-media',['--version'],{timeout:15000})).stdout.trim()};}catch{checks.media={ok:false};}
+    const {ChromeRuntime}=await import('../src/browser-runtime.mjs');const runtime=new ChromeRuntime();
+    try{checks.browser=await runtime.configuredLauncher('status')||await runtime.status();}catch(e){checks.browser={ok:false,error:redact(e)};}
+    if(o.live){need(o.canvas,'INVALID_ARGUMENT','Live doctor requires --canvas ID.');const {BrowserDriver,LOCATORS}=await import('../src/browser.mjs');const driver=new BrowserDriver();try{await driver.connect(o.canvas,{open:false});const board=await driver.getBoard();checks.live={canvas_id:String(board.id),title:board.title,locators:{}};for(const [k,s]of Object.entries(LOCATORS))checks.live.locators[k]=await driver.page.locator(s).count();}finally{await driver.close();}}
+    const ok=checks.media.ok&&checks['playwright-core'].ok&&checks['image-size'].ok&&checks.browser.ok;if(!ok)process.exitCode=1;return out({ok,checks,browser_ready:!!checks.browser.ready,paid_action:false,end_to_end:'not-tested-by-doctor'});
+  }
+  if(command==='browser'){
+    const {args}=parse(rest,{booleans:['json']});need(!args.length&&['status','open'].includes(action),'INVALID_ARGUMENT','Use browser status/open --json.');
+    const {ChromeRuntime}=await import('../src/browser-runtime.mjs');const runtime=new ChromeRuntime();
+    const result=action==='open'?await runtime.open():await runtime.configuredLauncher('status')||await runtime.status();if(!result.ok)process.exitCode=1;return out(result);
+  }
+  if(command==='board'&&action==='inspect'){const {options:o,args}=parse(rest,{values:['canvas'],booleans:['json']});need(!args.length&&o.canvas,'INVALID_ARGUMENT','Provide --canvas ID.');const {MediaCLI}=await import('../src/media-cli.mjs');return out(await new MediaCLI().get(o.canvas));}
+  if(command==='video'&&action==='generate'){
+    const {options:o,args}=parse(rest,{values:['canvas','prompt','prompt-file','output','request-id'],repeat:['reference'],booleans:['new','submit','dry-run','json']});need(!args.length&&!(o.submit&&o['dry-run']),'INVALID_ARGUMENT','Conflicting options or extra arguments.');need(!!o.prompt!==!!o['prompt-file'],'INVALID_ARGUMENT','Provide exactly one prompt source.');need(!(o.new&&o['request-id']),'INVALID_ARGUMENT','Use new or request-id.');
+    const {prepareInput,createJob,summary}=await import('../src/state.mjs');const input=await prepareInput({canvas:o.canvas,prompt:o.prompt??await fs.readFile(o['prompt-file'],'utf8'),references:o.reference,output:o.output});await automaticCheck();
+    if(!o.submit)return out({ok:true,dry_run:true,paid_action:false,canvas_id:input.canvasId,prompt:input.prompt,references:input.references.map((r,i)=>({label:'图'+(i+1),source:r.source,sha256:r.sha256||null})),workflow:['import-references','new-native-conversation','ordered-attachments','send-prompt','follow-run','download','deduplicate-video','group-original-nodes-in-frame'],generation_submission:'webpage Agent Send button',model:'inherit webpage settings'});
+    const {job,reused}=await createJob(input,{requestId:o['request-id'],newRequest:!!o.new});if(!reused){const {spawnWorker}=await import('../src/workflow.mjs');await spawnWorker(job.id);}return out({...summary(job),reused});
+  }
+  if(command==='task'){
+    const {options:o,args}=parse(rest,{values:['timeout'],booleans:['json']});need(args.length===1,'INVALID_ARGUMENT','Provide one task ID.');const {getJob,summary}=await import('../src/state.mjs');
+    if(action==='get'){need(!o.timeout,'INVALID_ARGUMENT','timeout applies only to wait.');return out(summary(await getJob(args[0])));}
+    const {resumeJob,waitJob,syncJob}=await import('../src/workflow.mjs');if(['resume','sync'].includes(action)){need(!o.timeout,'INVALID_ARGUMENT','timeout applies only to wait.');return out(await (action==='sync'?syncJob:resumeJob)(args[0]));}need(action==='wait','UNKNOWN_COMMAND','Use task get/wait/resume/sync.');return out(await waitJob(args[0],Number(o.timeout||30)));
+  }
+  if(command==='frame'&&action==='group'){
+    const {options:o,args}=parse(rest,{values:['canvas','elements','frame-id','name'],booleans:['submit','json']});need(!args.length&&o.canvas&&o.elements&&o['frame-id'],'INVALID_ARGUMENT','Provide canvas, elements JSON file, and frame-id.');safeId(o.canvas,'canvas ID');safeId(o['frame-id'],'Frame ID');const ids=await readJSON(o.elements);need(Array.isArray(ids)&&ids.length>0&&ids.length<=30&&new Set(ids).size===ids.length,'INVALID_INPUT','Provide unique element IDs.');ids.forEach(id=>safeId(id,'element ID'));await automaticCheck();
+    const {BrowserDriver}=await import('../src/browser.mjs');const {groupIntoFrame}=await import('../src/frame.mjs');const driver=new BrowserDriver();try{await driver.connect(o.canvas);const group=content=>groupIntoFrame(content,{ids,frameId:o['frame-id'],name:o.name});if(!o.submit){const board=await driver.getBoard();const preview=group(board.content);delete preview.content;return out({ok:true,dry_run:true,...preview});}const directory=path.join(stateRoot(),'frame-operations',crypto.randomUUID());return out({ok:true,...await driver.saveFrame(group,directory),content:undefined});}finally{await driver.close();}
+  }
+  need(false,'UNKNOWN_COMMAND','Unknown command. Use --help.');
+}
+main(process.argv.slice(2)).catch(e=>{out({ok:false,error:redact(e)});process.exitCode=1;});

package/capabilities.json

@@ -0,0 +1,238 @@
+{
+  "schema": "infinite-canvas-capabilities",
+  "schema_version": "1.0.0",
+  "package": "@petercjl/infinite-canvas-cli",
+  "version": "0.1.1",
+  "input": {
+    "required": [
+      "canvas_id",
+      "prompt",
+      "references"
+    ],
+    "references": "ordered PNG/JPEG/WebP local files or HTTPS URLs"
+  },
+  "output": {
+    "terminal": "local MP4 + saved Frame containing original reference nodes and one video node",
+    "fields": [
+      "task_id",
+      "status",
+      "canvas_id",
+      "session_id",
+      "run_id",
+      "frame_id",
+      "reference_element_ids",
+      "video_element_id",
+      "artifacts"
+    ]
+  },
+  "operations": [
+    "browser.status",
+    "browser.open",
+    "board.inspect",
+    "video.generate.native-agent",
+    "task.inspect",
+    "task.wait",
+    "task.resume",
+    "task.sync",
+    "frame.group-existing"
+  ],
+  "generationTransport": {
+    "kind": "native-browser-ui",
+    "newConversationPerLogicalVideo": true,
+    "singleTabPerCanvas": true,
+    "concurrency": "separate conversations in the same tab; queued UI submissions and canvas writes; parallel remote runs",
+    "submission": "click native Send",
+    "directGenerationAPI": false,
+    "recovery": "saved sessionId/runId; read-only run and history APIs",
+    "model": "inherit webpage settings"
+  },
+  "dependencies": {
+    "node": ">=22",
+    "browser": "Installed Google Chrome; built-in macOS/Windows discovery and startup on loopback 9223 with current-user dedicated profile",
+    "canvasAPI": "sealseek-media >=0.6.7, public CLI commands",
+    "libraries": [
+      "playwright-core",
+      "image-size"
+    ],
+    "optional": [
+      "ffprobe"
+    ]
+  },
+  "platforms": {
+    "codex:macos": "tested: six native Agent video tasks across two boards; one tab per board; downloads, deduplication and Frame readback verified",
+    "generic:macos": "spec-compatible, runtime untested",
+    "sealseek:macos": "spec-compatible, runtime untested",
+    "generic:windows": "built-in Chrome discovery/startup implemented; actual host video end-to-end verification pending"
+  },
+  "commandContracts": {
+    "video generate": {
+      "options": {
+        "--canvas": {
+          "type": "string"
+        },
+        "--prompt": {
+          "type": "string"
+        },
+        "--prompt-file": {
+          "type": "string"
+        },
+        "--reference": {
+          "type": "string",
+          "repeatable": true
+        },
+        "--output": {
+          "type": "string"
+        },
+        "--request-id": {
+          "type": "string"
+        },
+        "--new": {
+          "type": "boolean"
+        },
+        "--submit": {
+          "type": "boolean"
+        },
+        "--dry-run": {
+          "type": "boolean"
+        },
+        "--json": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "local-write",
+      "externalMutation": "With --submit: import references, send native Agent conversation, import a missing video, group selected elements in a Frame.",
+      "paid": "Only native webpage sending may charge credits."
+    },
+    "task get|wait|resume|sync": {
+      "options": {
+        "--timeout": {
+          "type": "string"
+        },
+        "--json": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "local-write",
+      "externalMutation": "resume continues original task; sync reapplies existing video archival and grouping; never a second generation."
+    },
+    "frame group": {
+      "options": {
+        "--canvas": {
+          "type": "string"
+        },
+        "--elements": {
+          "type": "string"
+        },
+        "--frame-id": {
+          "type": "string"
+        },
+        "--name": {
+          "type": "string"
+        },
+        "--submit": {
+          "type": "boolean"
+        },
+        "--json": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "local-write",
+      "externalMutation": "With --submit: reparent existing nodes and preserve their identities."
+    },
+    "browser status": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "none",
+      "output": "Chrome availability and separate CDP runtime readiness"
+    },
+    "browser open": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "local-write",
+      "externalMutation": "Launch or reuse system Chrome on loopback 9223 with the current-user dedicated profile; no generation."
+    },
+    "doctor": {
+      "options": {
+        "--canvas": {
+          "type": "string"
+        },
+        "--live": {
+          "type": "boolean"
+        },
+        "--json": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "none"
+    },
+    "skill source": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "none"
+    },
+    "skill status|install|update": {
+      "options": {
+        "--agent": {
+          "type": "string"
+        },
+        "--path": {
+          "type": "string"
+        },
+        "--json": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "local-write"
+    },
+    "update check|install": {
+      "options": {
+        "--yes": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string"
+        },
+        "--path": {
+          "type": "string"
+        },
+        "--json": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "package-and-skill-update"
+    },
+    "update auto": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "local-write"
+    }
+  },
+  "automaticUpdates": {
+    "enabledByDefault": true,
+    "defaultMode": "notify",
+    "intervalHours": 24,
+    "timeoutMs": 1500,
+    "trigger": "ordinary video/frame/doctor/capabilities entry; excludes help/version/skill/task polling",
+    "configuration": "private update-policy.json; update auto on|off|status",
+    "disable": "INFINITE_CANVAS_AUTO_UPDATE=0",
+    "recovery": "offline backoff preserves installation; source checkout updates through Git; explicit install keeps a package backup",
+    "installation": "explicit --yes only; no automatic installation"
+  },
+  "limitations": [
+    "No service-side atomic canvas revision check; stop on detected user edits.",
+    "Frame grouping first version supports unrotated image/video nodes.",
+    "Do not submit another generation after unknown submission."
+  ]
+}

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@petercjl/infinite-canvas-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Drive native Infinite Canvas Agent conversations and organize reference images and results in a Frame.",
+  "type": "module",
+  "bin": {
+    "infinite-canvas": "bin/infinite-canvas.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "skills",
+    "capabilities.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --test",
+    "check": "node --check bin/infinite-canvas.mjs && node --test"
+  },
+  "dependencies": {
+    "playwright-core": "1.62.1",
+    "image-size": "2.0.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/petercjl/infinite-canvas-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/petercjl/infinite-canvas-cli/issues"
+  },
+  "homepage": "https://github.com/petercjl/infinite-canvas-cli#readme"
+}

package/skills/infinite-canvas-video/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: infinite-canvas-video
+description: "Use infinite-canvas to generate a video through an existing SealSeek Infinite Canvas Agent conversation UI, using a board ID, an unchanged user prompt, and ordered reference images; retrieve the video and group original image and video nodes in a Frame. Use when the user explicitly selects this canvas workflow."
+---
+
+# Infinite Canvas Video
+
+Execute an explicitly selected canvas video request with the installed `infinite-canvas` capability. The application or user owns creative choices, prompt, reference selection/order and acceptance. The CLI owns native submission, authentication reuse, canvas writes, idempotency and recovery.
+
+## Input and output
+
+Require a board file ID, the exact prompt and 1–20 ordered PNG, JPEG or WebP references (local paths or HTTPS URLs). Ask only for missing required inputs. Preserve the prompt and image order; 图1 means the first attached image. Inherit model settings from the webpage. An authorized generation request allows one paid native Agent submission. A planning or dry-run request allows validation only.
+
+Return the local MP4 from `artifacts[].path`, task ID, board ID and Frame ID. Success means `status=succeeded`, a nonempty downloaded video, original reference node IDs plus one video node in the saved Frame, and verified readback. A generated video with unfinished grouping is a partial result, reported with its task ID and recovery action.
+
+## Capability resolution
+
+Resolve `infinite-canvas` from PATH. Run `version --json`, `capabilities --json` and `skill source --json` to inspect the installed implementation and current canonical Skill. Minimum contract: native Agent Send, ordered references, existing-node grouping, task get/wait/resume, local video output. Load the selected host adapter in `adapters/`; `generic.json` is the portable fallback. If the entry or required feature is missing, return `CAPABILITY_UNAVAILABLE`; report the missing dependency instead of substituting another generation provider.
+
+External dependencies are Node.js 22+, `playwright-core` and `image-size` (package managed), installed Google Chrome on macOS or Windows, and `sealseek-media` with image upload, canvas get/add capabilities. This Skill invokes the helper through the CLI contract; it does not compose another generation Skill. Browser authentication stays in the user's dedicated Chrome profile. Never copy cookies or tokens into a prompt, output or package.
+
+## Main line
+
+1. Validate required inputs and authorization. Run `doctor --json`: its browser check means Chrome is available to launch; `browser_ready` separately reports runtime readiness. Use `browser open --json` to prepare Chrome. The CLI discovers and launches the system browser itself with fixed loopback 9223 and the persistent current-user `.dianshang-chrome-profile`; a separate launcher installation is unnecessary. For a UI compatibility check use `doctor --live --canvas ID --json`. On missing login, have the user sign in in that Chrome window, then return here. The CLI uses CDP port 9223 and the dedicated ecommerce profile. Enforce the single-tab constraint below before any submission or canvas write.
+2. Prepare the exact prompt in a new file when needed; preserve any existing file. Run `video generate --canvas ID --prompt-file FILE --reference IMAGE1 --reference IMAGE2 --dry-run --json`, repeating `--reference` in order. Dry run checks local inputs; it does not prove provider availability.
+3. For an authorized real request, run the same inputs with `--submit --json`. Save the returned task ID immediately. Repeated identical inputs reuse the same task. `--request-id KEY` provides caller-controlled idempotency; `--new` deliberately creates a new paid task and requires explicit intent to generate another video.
+4. Follow `task wait TASK_ID --timeout 30 --json` or `task get TASK_ID --json`. The worker imports references, creates a new native Agent conversation, attaches images, pastes the exact prompt and clicks Send. Status/history reads track the captured session and run. Generation is submitted only through the native UI.
+5. On completion, inspect the returned artifact and report its local path. The worker deduplicates the generated video against the board and groups the already imported image nodes and video into one actual Frame. Use the same task ID for any unfinished download or grouping.
+
+## Single-tab constraint and concurrency
+
+**Each board file must be open in exactly one browser tab.** Multiple tabs editing the same board cause save conflicts and the website may suspend editing. Reuse that board's existing tab. A different board may have its own tab.
+
+Run concurrent videos through separate native Agent conversations inside the board's single tab. Serialize the short UI operations: import references, create a fresh conversation, attach images, send once and capture session/run IDs. After submission, track each run independently while preparing another conversation in the same tab. Serialize canvas imports and Frame writes per board; remote generation waiting does not hold that queue. Keep the requested board file count unchanged when adding concurrent video tasks.
+
+Start one `video generate --submit` task per requested video, record every returned ID, and poll all tasks together. Submit the remaining tasks while earlier runs generate. The CLI queues tab selection and composition per board, including simultaneous first use. Use the installed CLI's verified selectors and transport; ordinary runs require no new selector or endpoint exploration.
+
+Conversation readiness means native session creation has completed before attaching references. Attachment readiness counts only the current composer and waits for uploaded HTTPS images. Other conversations may still stream during these steps. After canvas API writes, the CLI synchronizes the editor in place and verifies saved/live scene agreement. Page reload is excluded from this write path because the old scene's auto-save can replace newly imported nodes or Frames. Webpage contract changes return an adapter error for a separate repair cycle.
+
+If duplicate tabs for a board are detected, stop new submissions and writes with `BOARD_SELECTION_REQUIRED`. Preserve all task/session/run IDs, resolve the duplicate tabs, then resume existing tasks. When the website displays its other-tab editing protection, restore editing in the single retained tab after duplicates are closed. Claim resumed generation only from the existing run; a tab conflict never authorizes another paid submission.
+
+## Branches and recovery
+
+- `CHROME_NOT_FOUND`: install Google Chrome or set `INFINITE_CANVAS_CHROME_BIN` to its actual executable; return to step 1.
+- `BROWSER_PORT_CONFLICT` / `BROWSER_OWNERSHIP_UNVERIFIED`: preserve existing browser processes/profile files, resolve the 9223 ownership conflict, then return to step 1.
+- `BROWSER_START_TIMEOUT`: inspect the dedicated profile’s existing Chrome and startup permissions; preserve task IDs and return to step 1 after readiness is restored.
+- `waiting`: the monitoring window or a connection ended; use `task resume TASK_ID --json`, then return to step 4. Remote runs continue independently.
+- `uncertain` / `SUBMISSION_UNCERTAIN`: preserve the task; resume inspects the captured session for exactly one run. If identity cannot be resolved, report the uncertainty and request inspection. Never start another paid task as an automatic retry.
+- `canvas_pending`: return any downloaded video as a partial result, then resume the same task for import/grouping. It does not resubmit generation.
+- For an explicitly requested repair of canvas archival after a completed task, use `task sync TASK_ID --json`. It reapplies the existing video's import/grouping with the original reference nodes and never generates another video. Preserve intentional user deletions unless restoration is authorized.
+- `UI_LOCATOR_CHANGED`, `AGENT_MODE_REQUIRED`, `REFERENCE_ORDER_CHANGED`: stop and report the adapter issue. If sending may have happened, preserve the task and inspect its history before further action.
+- `CANVAS_UNSAVED`, `CANVAS_CHANGED`, `UI_BUSY`: ask the user to finish active work and save; resume the same task after the board is settled.
+- `PROVIDER_FAILURE`: report the existing run's failure. Another video attempt is a new paid action.
+- File conflicts or unmanaged Skill/state: preserve existing files and report the exact conflict.
+
+Read [runtime reference](references/runtime.md) only when command details or recovery diagnostics are needed, then return to the relevant main-line step. Do not infer completion from chat prose alone.
+
+## QA and evolution
+
+Check one clean user message, captured native session/run IDs, attachment order at submission, exactly one result URL, returned reference metadata when provided, artifact bytes/hash and saved Frame membership. Report unavailable reference metadata or absent ffprobe verification honestly. Scope claims to actually tested hosts and operating systems. The current browser adapter needs live validation after webpage changes; independent clean-context regression is user gated.
+
+Install/update only the executing/requested Agent through package-managed `skill install/update --agent AGENT_NAME --path RESOLVED_SKILL_DIR`. A named adapter supplies a default only for that host; other valid Agent names use the generic adapter and their own explicitly resolved Skill directory. The package is the source of truth. Automatic update detection is bounded and can be disabled; installation is explicit. Keep model defaults and private assets outside the package.

package/skills/infinite-canvas-video/adapters/codex.json

@@ -0,0 +1,24 @@
+{
+  "schema": "portable-skill-adapter",
+  "platform": "codex",
+  "mappings": [
+    {
+      "capability_id": "canvas.video.execute",
+      "status": "implemented",
+      "features": [
+        "native-agent-send",
+        "new-conversation",
+        "ordered-reference-images",
+        "canvas-import",
+        "existing-node-frame-group",
+        "task-recovery",
+        "local-video-output"
+      ],
+      "implementation": {
+        "kind": "cli",
+        "command": "infinite-canvas",
+        "instructions": "Resolve from PATH. Run version, capabilities and doctor. Requires Node.js >=22, installed Google Chrome and sealseek-media; Chrome discovery/startup is bundled for macOS and Windows. Use structured JSON. Codex/macOS end-to-end verified with six native Agent videos across two boards, one tab per board, downloads and saved Frame readback. Other hosts require their own runtime validation."
+      }
+    }
+  ]
+}

package/skills/infinite-canvas-video/adapters/generic.json

@@ -0,0 +1,24 @@
+{
+  "schema": "portable-skill-adapter",
+  "platform": "generic",
+  "mappings": [
+    {
+      "capability_id": "canvas.video.execute",
+      "status": "implemented",
+      "features": [
+        "native-agent-send",
+        "new-conversation",
+        "ordered-reference-images",
+        "canvas-import",
+        "existing-node-frame-group",
+        "task-recovery",
+        "local-video-output"
+      ],
+      "implementation": {
+        "kind": "cli",
+        "command": "infinite-canvas",
+        "instructions": "Resolve from PATH. Run version, capabilities and doctor. Requires Node.js >=22, installed Google Chrome and sealseek-media; Chrome discovery/startup is bundled for macOS and Windows. Use structured JSON. Named-host runtime end-to-end verification is pending."
+      }
+    }
+  ]
+}

package/skills/infinite-canvas-video/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "无限画板视频"
+  short_description: "通过网页 Agent 生成参考图视频并将输入和成片归入同一 Frame"
+  default_prompt: "使用 $infinite-canvas-video 按提供的画板、提示词和参考图片生成短视频。"

package/skills/infinite-canvas-video/capabilities.json

@@ -0,0 +1,52 @@
+{
+  "schema": "portable-skill-capabilities",
+  "schema_version": "1.0.0",
+  "skill": "infinite-canvas-video",
+  "target_platforms": [
+    "codex",
+    "generic"
+  ],
+  "host_resolution": {
+    "fallback_adapter": "generic"
+  },
+  "capabilities": [
+    {
+      "id": "canvas.video.execute",
+      "purpose": "Execute native Agent video generation and verified canvas grouping",
+      "required": true,
+      "required_features": [
+        "native-agent-send",
+        "new-conversation",
+        "ordered-reference-images",
+        "canvas-import",
+        "existing-node-frame-group",
+        "task-recovery",
+        "local-video-output"
+      ],
+      "input_fields": [
+        "canvas_id",
+        "prompt",
+        "references"
+      ],
+      "output_fields": [
+        "task_id",
+        "status",
+        "session_id",
+        "run_id",
+        "frame_id",
+        "artifacts"
+      ],
+      "side_effects": {
+        "external_mutation": true,
+        "may_cost_money": true,
+        "authorization": "An authorized video request permits one native generation; resume never resubmits."
+      },
+      "errors": [
+        "CAPABILITY_UNAVAILABLE",
+        "SUBMISSION_UNCERTAIN",
+        "CANVAS_SYNC_PENDING",
+        "OUTPUT_CONTRACT_FAILED"
+      ]
+    }
+  ]
+}

package/skills/infinite-canvas-video/references/runtime.md

@@ -0,0 +1,38 @@
+# Runtime command reference
+
+These commands are for the executing Agent and developers.
+
+Browser invariant: one board file, one tab. Reuse the existing tab for that canvas ID. Concurrent tasks use distinct native conversations and captured session/run IDs within that tab. `BOARD_SELECTION_REQUIRED` means resolve duplicate tabs before continuing; preserve the existing tasks. UI submission and canvas writes are queued per board, while remote runs can progress concurrently.
+
+```sh
+infinite-canvas version --json
+infinite-canvas capabilities --json
+infinite-canvas doctor --json
+infinite-canvas browser status --json
+infinite-canvas browser open --json
+infinite-canvas skill source --json
+infinite-canvas skill status --agent AGENT_NAME --path RESOLVED_SKILL_DIR --json
+infinite-canvas skill install --agent AGENT_NAME --path RESOLVED_SKILL_DIR --json
+infinite-canvas skill update --agent AGENT_NAME --path RESOLVED_SKILL_DIR --json
+infinite-canvas video generate --canvas BOARD_ID --prompt-file PROMPT_FILE --reference IMAGE_1 --reference IMAGE_2 --dry-run --json
+infinite-canvas video generate --canvas BOARD_ID --prompt-file PROMPT_FILE --reference IMAGE_1 --reference IMAGE_2 --submit --json
+infinite-canvas task get TASK_ID --json
+infinite-canvas task wait TASK_ID --timeout 30 --json
+infinite-canvas task resume TASK_ID --json
+infinite-canvas task sync TASK_ID --json
+infinite-canvas update auto off --json
+```
+
+`--output` is an output directory; the MP4 filename is the unique task ID. Existing different bytes are preserved. HTTPS reference downloads are bounded to 30 MiB, local images are validated, and redirecting media URLs are rejected. An interrupted task is resumed with its original inputs and captured run.
+
+`board inspect --canvas ID --json` reads the board. `frame group --canvas ID --elements ELEMENT_IDS_JSON --frame-id FRAME_ID --json` previews grouping; `--submit` saves it. Only the selected existing unrotated image/video nodes are moved into the actual Frame. Layout uses a horizontal row with bounded media dimensions. Existing unrelated elements are preserved; conflicting Frame membership stops the operation.
+
+State resides under the user's application-data directory (`INFINITE_CANVAS_STATE_DIR` can select another private location). It contains task state, reference copies, readback backups, download metadata and worker logs. Preserve it for recovery; treat media URLs and prompts as private. `INFINITE_CANVAS_AUTO_UPDATE=0` disables automatic registry detection. Explicit update installation requires `update install --yes`, refuses source checkouts and backs up the installed package. Unpublished development versions have no registry update available.
+
+The CLI never prints browser credentials. Changing source, a live webpage deployment or a helper CLI version may require revalidation. JSON failures include `error.code` and `error.message`; keep the original task ID in user-facing recovery advice.
+
+## Built-in Chrome runtime
+
+Only Google Chrome is an external browser prerequisite. macOS discovery checks system and current-user Applications; Windows checks per-user and Program Files locations, then App Paths registry entries. `INFINITE_CANVAS_CHROME_BIN` selects an actual executable for a custom installation. No extra launcher is required. `INFINITE_CANVAS_BROWSER_BIN` remains an explicit legacy override and is verified against the same port/profile contract.
+
+`browser status` is read-only. `chrome.installed` and `available` describe installation; `running` and `ready` describe the dedicated instance. A stopped but installed Chrome passes the browser dependency check in `doctor`. `browser open` and normal video execution launch/reuse it, verify process ownership, loopback CDP 9223 and the current-user profile. On Windows this profile is under the current home directory; on macOS it is under the current home directory with the same `.dianshang-chrome-profile` name. Windows uses built-in PowerShell process/TCP queries; macOS uses bounded nonblocking system process queries. Startup is queued so concurrent jobs share the browser. `doctor --live --canvas ID` requires the running, authenticated, editable board as well.