@petercjl/infinite-canvas-cli 0.1.0 → 0.1.1

package/README.md

@@ -2,10 +2,12 @@
 
 `@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+, the independent ecommerce Chrome launcher and an installed `sealseek-media` CLI supporting image upload and canvas get/add. The browser uses port 9223 and the dedicated ecommerce profile. The website supplies the selected model and authenticated account. Each authorized generation can incur charges.
+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:
@@ -14,19 +16,19 @@ Provide the board ID, prompt and reference image attachments in their intended o
 
 To install:
 
-> 安装 @petercjl/infinite-canvas-cli，并将配套 Skill 安装到本机 Codex。
+> 安装 @petercjl/infinite-canvas-cli 及其配套 Skill。
 
 To update:
 
-> 更新 @petercjl/infinite-canvas-cli 及其本机 Codex 配套 Skill。
+> 更新 @petercjl/infinite-canvas-cli 及其配套 Skill。
 
 To recover:
 
 > 使用 infinite-canvas，恢复任务「任务ID」。
 
-To update the selected local Codex Skill:
+To synchronize the current Agent’s Skill:
 
-> 将 infinite-canvas 当前安装包配套的 Skill 同步到本机 Codex。
+> 将 infinite-canvas 当前安装包的配套 Skill 同步到当前 Agent。
 
 Codex/macOS has completed six live video tasks across two boards. Other Agent adapters require runtime verification.
 

package/bin/infinite-canvas.mjs

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import os from 'node:os';
 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';
@@ -32,11 +31,16 @@ async function main(argv){
     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};}
-    try{checks.browser=JSON.parse((await execute(process.env.INFINITE_CANVAS_BROWSER_BIN||path.join(os.homedir(),'.local','bin','ecommerce-browser'),['status','--json'],{timeout:15000})).stdout);}catch{checks.browser={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.state==='ready';if(!ok)process.exitCode=1;return out({ok,checks,paid_action:false,end_to_end:'not-tested-by-doctor'});
+    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==='browser'&&action==='status'){const {args}=parse(rest,{booleans:['json']});need(!args.length,'INVALID_ARGUMENT','Unexpected arguments.');const r=await execute(process.env.INFINITE_CANVAS_BROWSER_BIN||path.join(os.homedir(),'.local','bin','ecommerce-browser'),['status','--json'],{timeout:15000});return out(JSON.parse(r.stdout));}
   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.');

package/capabilities.json

@@ -2,7 +2,7 @@
   "schema": "infinite-canvas-capabilities",
   "schema_version": "1.0.0",
   "package": "@petercjl/infinite-canvas-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "input": {
     "required": [
       "canvas_id",
@@ -27,6 +27,7 @@
   },
   "operations": [
     "browser.status",
+    "browser.open",
     "board.inspect",
     "video.generate.native-agent",
     "task.inspect",
@@ -47,7 +48,7 @@
   },
   "dependencies": {
     "node": ">=22",
-    "browser": "ecommerce-browser, fixed loopback CDP 9223 and current-user ecommerce profile",
+    "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",
@@ -61,7 +62,7 @@
     "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": "runtime unresolved: ecommerce browser launcher required"
+    "generic:windows": "built-in Chrome discovery/startup implemented; actual host video end-to-end verification pending"
   },
   "commandContracts": {
     "video generate": {
@@ -138,6 +139,24 @@
       "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": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@petercjl/infinite-canvas-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Drive native Infinite Canvas Agent conversations and organize reference images and results in a Frame.",
   "type": "module",
   "bin": {

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

@@ -17,11 +17,11 @@ Return the local MP4 from `artifacts[].path`, task ID, board ID and Frame ID. Su
 
 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), the independent `ecommerce-browser` launcher, 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.
+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`; for a UI compatibility check use `doctor --live --canvas ID --json`. On missing login or board, ask the user to sign in/open the board in the dedicated ecommerce Chrome, 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.
+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.
@@ -41,6 +41,9 @@ If duplicate tabs for a board are detected, stop new submissions and writes with
 
 ## 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.
@@ -56,4 +59,4 @@ Read [runtime reference](references/runtime.md) only when command details or rec
 
 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 requested Agent through package-managed `skill install/update --agent codex`. 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.
+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

@@ -17,7 +17,7 @@
       "implementation": {
         "kind": "cli",
         "command": "infinite-canvas",
-        "instructions": "Resolve from PATH. Run version, capabilities and doctor. Requires Node.js >=22, ecommerce-browser and sealseek-media. 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."
+        "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

@@ -17,7 +17,7 @@
       "implementation": {
         "kind": "cli",
         "command": "infinite-canvas",
-        "instructions": "Resolve from PATH. Run version, capabilities and doctor. Requires Node.js >=22, ecommerce-browser and sealseek-media. Use structured JSON. Named-host runtime end-to-end verification is pending."
+        "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/references/runtime.md

@@ -8,10 +8,12 @@ Browser invariant: one board file, one tab. Reuse the existing tab for that canv
 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 codex --json
-infinite-canvas skill install --agent codex --json
-infinite-canvas skill update --agent codex --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
@@ -28,3 +30,9 @@ infinite-canvas update auto off --json
 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.

package/src/browser-runtime.mjs

@@ -0,0 +1,105 @@
+import fs from 'node:fs/promises';
+import {constants} from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import net from 'node:net';
+import {spawn} from 'node:child_process';
+import {execute,Fault,need,lock,sleep} from './core.mjs';
+
+export const CDP='http://127.0.0.1:9223';
+export const PROFILE_NAME='.dianshang-chrome-profile';
+const escapeRE=s=>s.replace(/[.*+?^${}()|[\]\\]/g,'\\$&');
+const powershell=env=>path.win32.join(env.SystemRoot||env.WINDIR||'C:\\Windows','System32','WindowsPowerShell','v1.0','powershell.exe');
+const psPrefix='$ErrorActionPreference="Stop"; [Console]::OutputEncoding=[Text.UTF8Encoding]::new($false); ';
+export function windowsListeners(output){
+  return String(output).split(/\r?\n/).map(line=>line.trim().split(/\s+/)).filter(row=>row.length===5&&/^TCP$/i.test(row[0])&&row[1].endsWith(':9223')&&/^\d+$/.test(row[4])&&['0.0.0.0:0','[::]:0'].includes(row[2])).map(row=>({pid:Number(row[4]),address:row[1].slice(0,-5).replace(/^\[|\]$/g,'')}));
+}
+
+export function chromeCandidates({platform=process.platform,env=process.env,home=os.homedir()}={}){
+  const p=platform==='win32'?path.win32:path.posix;
+  if(env.INFINITE_CANVAS_CHROME_BIN)return [env.INFINITE_CANVAS_CHROME_BIN];
+  if(platform==='darwin')return ['/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',p.join(home,'Applications/Google Chrome.app/Contents/MacOS/Google Chrome')];
+  if(platform==='win32')return [...new Set([env.LOCALAPPDATA||p.join(home,'AppData','Local'),env.ProgramFiles||env.PROGRAMFILES||'C:\\Program Files',env['ProgramFiles(x86)']||env['PROGRAMFILES(X86)']||'C:\\Program Files (x86)'].map(root=>p.join(root,'Google','Chrome','Application','chrome.exe')))];
+  return [];
+}
+export function dedicatedCommand(command,profile,platform=process.platform){
+  let c=String(command||''),expected=profile;
+  if(platform==='win32'){c=c.replaceAll('\\','/').toLowerCase();expected=expected.replaceAll('\\','/').toLowerCase();}
+  const flag=(name,value)=>new RegExp('(?:^|[\\s"])--'+name+'(?:=|\\s+)"?'+escapeRE(value)+'"?(?=$|[\\s"])').test(c);
+  return flag('remote-debugging-port','9223')&&flag('user-data-dir',expected)&&!/(?:^|[\s"])--no-sandbox(?:[\s"]|$)/.test(c)&&(!c.includes('--remote-debugging-address')||flag('remote-debugging-address','127.0.0.1'));
+}
+export function chromeArgs(profile,{headless=false,startupUrl='https://sealseek.cn/board/'}={}){
+  return ['--remote-debugging-address=127.0.0.1','--remote-debugging-port=9223','--user-data-dir='+profile,'--no-first-run','--no-default-browser-check',...(headless?['--headless=new']:[]),startupUrl];
+}
+async function listening(){return new Promise(resolve=>{const socket=net.createConnection({host:'127.0.0.1',port:9223});let done=false;const finish=v=>{if(done)return;done=true;socket.destroy();resolve(v);};socket.setTimeout(800,()=>finish(false));socket.once('connect',()=>finish(true));socket.once('error',()=>finish(false));});}
+async function launch(executable,args){
+  const child=spawn(executable,args,{detached:true,stdio:'ignore',windowsHide:false});
+  await new Promise((resolve,reject)=>{child.once('spawn',resolve);child.once('error',reject);});child.unref();return child.pid;
+}
+
+export class ChromeRuntime {
+  constructor({platform=process.platform,env=process.env,home=os.homedir(),access=async file=>{const stat=await fs.stat(file);if(!stat.isFile())return false;await fs.access(file,platform==='win32'?constants.F_OK:constants.X_OK);return true;},exec=execute,probe=listening,fetcher=fetch,launchProcess=launch,mkdir=dir=>fs.mkdir(dir,{recursive:true,mode:0o700}),pause=sleep,headless=false,startupUrl}={}){
+    Object.assign(this,{platform,env,home,access,exec,probe,fetcher,launchProcess,mkdir,pause,headless,startupUrl});
+    this.paths=platform==='win32'?path.win32:path.posix;this.profile=this.paths.join(home,PROFILE_NAME);
+  }
+  async discover(){
+    for(const file of chromeCandidates(this)){try{if(await this.access(file))return {installed:true,executable:file,source:this.env.INFINITE_CANVAS_CHROME_BIN?'configured':'standard-location'};}catch{}}
+    if(this.env.INFINITE_CANVAS_CHROME_BIN)return {installed:false,executable:this.env.INFINITE_CANVAS_CHROME_BIN,source:'configured',error:{code:'CHROME_NOT_FOUND',message:'Configured Chrome executable is unavailable.'}};
+    if(this.platform==='win32'){
+      for(const key of ['HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\App Paths\\chrome.exe','HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\App Paths\\chrome.exe']){
+        try{const {stdout}=await this.exec('reg.exe',['query',key,'/ve'],{timeout:3000,windowsHide:true});let file=stdout.match(/REG_(?:EXPAND_)?SZ\s+(.+)/)?.[1]?.trim().replace(/^"|"$/g,'');if(file){file=file.replace(/%([^%]+)%/g,(_,name)=>Object.entries(this.env).find(([k])=>k.toLowerCase()===name.toLowerCase())?.[1]||'%'+name+'%');if(await this.access(file))return {installed:true,executable:file,source:'windows-app-paths'};}}catch{}
+      }
+    }
+    return {installed:false,source:'system-discovery',error:{code:['darwin','win32'].includes(this.platform)?'CHROME_NOT_FOUND':'UNSUPPORTED_PLATFORM',message:'Install Google Chrome, or provide its executable with INFINITE_CANVAS_CHROME_BIN.'}};
+  }
+  async owners(){
+    if(this.platform==='win32'){
+      const network=await this.exec(path.win32.join(this.env.SystemRoot||this.env.WINDIR||'C:\\Windows','System32','netstat.exe'),['-ano','-p','tcp'],{timeout:5000,maxBuffer:2*1024*1024,windowsHide:true});
+      const connections=windowsListeners(network.stdout),pids=[...new Set(connections.map(p=>p.pid))];if(!pids.length)return [];
+      const script=psPrefix+'$result=@(foreach($id in @('+pids.join(',')+')){ $p=Get-CimInstance Win32_Process -Filter ("ProcessId = "+$id); [pscustomobject]@{pid=$p.ProcessId;name=$p.Name;command=$p.CommandLine} }); ConvertTo-Json -InputObject $result -Compress';
+      const {stdout}=await this.exec(powershell(this.env),['-NoProfile','-NonInteractive','-Command',script],{timeout:30000,maxBuffer:1024*1024,windowsHide:true});const data=JSON.parse(stdout.replace(/^\uFEFF/,''));return (Array.isArray(data)?data:[data]).map(p=>({...p,addresses:connections.filter(c=>c.pid===p.pid).map(c=>c.address)}));
+    }
+    if(this.platform==='darwin'){
+      const {stdout}=await this.exec('/usr/sbin/lsof',['-b','-nP','-t','-iTCP:9223','-sTCP:LISTEN'],{timeout:5000});const pids=[...new Set(stdout.trim().split(/\s+/).filter(v=>/^\d+$/.test(v)))];
+      return Promise.all(pids.map(async pid=>({pid:Number(pid),command:(await this.exec('/bin/ps',['-p',pid,'-o','command='],{timeout:3000})).stdout.trim()})));
+    }
+    throw new Fault('UNSUPPORTED_PLATFORM','Built-in Chrome startup currently supports macOS and Windows.');
+  }
+  async inspect(chrome){
+    if(!await this.probe())return {state:'stopped',running:false,ready:false};
+    let owners;
+    try{owners=await this.owners();}catch{return {state:'conflict',running:true,ready:false,error:{code:'BROWSER_OWNERSHIP_UNVERIFIED',message:'Port 9223 is occupied, but its process/profile could not be verified.'}};}
+    const matches=owners.length>0&&owners.every(p=>dedicatedCommand(p.command,this.profile,this.platform)&&(this.platform==='win32'?p.name?.toLowerCase()==='chrome.exe'&&p.addresses?.length&&p.addresses.every(a=>['127.0.0.1','::1'].includes(a)):p.command.startsWith(chrome.executable+' ')||p.command.startsWith('"'+chrome.executable+'" ')));
+    if(!matches)return {state:'conflict',running:true,ready:false,error:{code:'BROWSER_PORT_CONFLICT',message:'Port 9223 belongs to another process, profile, or non-loopback listener. Preserve it and resolve the conflict.'}};
+    try{
+      const response=await this.fetcher(CDP+'/json/version',{signal:AbortSignal.timeout(1500),redirect:'error'});const data=await response.json(),ws=new URL(data.webSocketDebuggerUrl);
+      need(response.ok&&/^(?:Headless)?Chrome\//.test(data.Browser)&&ws.protocol==='ws:'&&ws.hostname==='127.0.0.1'&&ws.port==='9223','BROWSER_UNAVAILABLE','Chrome CDP response is invalid.');
+      return {state:'ready',running:true,ready:true,pids:owners.map(p=>p.pid),browser:data.Browser};
+    }catch{return {state:'starting',running:true,ready:false,pids:owners.map(p=>p.pid)};}
+  }
+  async status(){
+    const chrome=await this.discover();const runtime=await this.inspect(chrome);
+    return {ok:(chrome.installed||runtime.ready)&&!runtime.error,available:chrome.installed||runtime.ready,chrome,...runtime,cdp:CDP,profile:this.profile,source:'built-in',...(chrome.error&&!runtime.ready?{error:chrome.error}:{}),next_action:runtime.ready?'open-or-reuse-board':chrome.installed&&!runtime.error?'browser open':runtime.error?'resolve-port-conflict':'install-google-chrome'};
+  }
+  async configuredLauncher(action){
+    const file=this.env.INFINITE_CANVAS_BROWSER_BIN;if(!file)return null;
+    let value;try{const r=await this.exec(file,[action,'--json'],{timeout:30000});value=JSON.parse(r.stdout);}catch(e){try{value=JSON.parse(e.stdout);}catch{throw new Fault('BROWSER_UNAVAILABLE','Configured browser launcher is unavailable.');}}
+    need(value.cdp===CDP&&this.paths.resolve(value.profile||'')===this.profile,'PROFILE_MISMATCH','Configured launcher must use port 9223 and the current-user dedicated profile.');
+    const own=await this.status();need(!own.error,own.error?.code||'BROWSER_UNAVAILABLE',own.error?.message||'Browser verification failed.');return {...own,source:'configured-launcher'};
+  }
+  async open({timeoutMs=60000}={}){
+    if(this.env.INFINITE_CANVAS_BROWSER_BIN){await this.configuredLauncher('open');const result=await this.status();need(result.ready,'BROWSER_UNAVAILABLE','Configured launcher did not make Chrome ready.');return result;}
+    const end=Date.now()+timeoutMs;
+    while(Date.now()<end){
+      try{return await lock('browser-start:'+this.profile,async()=>{
+        let state=await this.status();if(state.ready)return {...state,reused:true,started:false};
+        need(!state.error,state.error?.code||'BROWSER_UNAVAILABLE',state.error?.message||'Browser is unavailable.');
+        need(state.chrome.installed,'CHROME_NOT_FOUND','Google Chrome is unavailable.');
+        if(!state.running){await this.mkdir(this.profile);await this.launchProcess(state.chrome.executable,chromeArgs(this.profile,{headless:this.headless,startupUrl:this.startupUrl}));}
+        const started=!state.running;while(Date.now()<end){await this.pause(300);state=await this.status();need(!state.error,state.error?.code||'BROWSER_UNAVAILABLE',state.error?.message||'Browser start conflict.');if(state.ready)return {...state,started,reused:!started};}
+        throw new Fault('BROWSER_START_TIMEOUT','Chrome did not become ready. Check whether this dedicated profile is already open without debugging; preserve its files and existing browser processes.');
+      });}catch(e){if(e.code!=='BUSY')throw e;await this.pause(300);}
+    }
+    throw new Fault('BUSY','Another process is preparing the dedicated Chrome browser.');
+  }
+}

package/src/browser.mjs

@@ -1,9 +1,9 @@
 import path from 'node:path';
-import os from 'node:os';
 import crypto from 'node:crypto';
 import {chromium} from 'playwright-core';
-import {execute,need,Fault,sleep,hash,canonical,newJSON,lock} from './core.mjs';
+import {need,Fault,sleep,newJSON,lock} from './core.mjs';
 import {sceneSignature,verifyGrouping} from './frame.mjs';
+import {ChromeRuntime} from './browser-runtime.mjs';
 
 export const LOCATORS={newChat:'button:has(svg.lucide-square-plus)',upload:'input[type=file][accept="image/*,video/mp4,video/webm,video/*"]',editor:'[contenteditable=true][role=textbox]',send:'button[aria-label="发送消息"]'};
 export async function handleBrowserDialog(dialog){try{if(dialog.type()==='beforeunload'||dialog.type()==='alert')await dialog.accept();else await dialog.dismiss();return true;}catch{return false;}}
@@ -25,12 +25,9 @@ export function nativeSubmission(body,expectedPrompt,files){
 export class BrowserDriver {
   async connect(canvasId,{open=true}={}){
     this.canvasId=canvasId;
-    let launcher=process.env.INFINITE_CANVAS_BROWSER_BIN||'ecommerce-browser',r;
-    try{r=await execute(launcher,['status','--json'],{timeout:15000});}catch(e){if(e.code==='ENOENT'&&!process.env.INFINITE_CANVAS_BROWSER_BIN){launcher=path.join(os.homedir(),'.local','bin','ecommerce-browser');r=await execute(launcher,['status','--json'],{timeout:15000});}else throw new Fault('BROWSER_UNAVAILABLE','Cannot inspect the ecommerce browser.');}
-    let status=JSON.parse(r.stdout);if(status.state!=='ready'&&open){await execute(launcher,['open'],{timeout:30000});status=JSON.parse((await execute(launcher,['status','--json'],{timeout:15000})).stdout);}
+    const runtime=new ChromeRuntime();
+    const status=open?await runtime.open():await runtime.configuredLauncher('status')||await runtime.status();
     need(status.state==='ready'&&status.cdp==='http://127.0.0.1:9223','BROWSER_UNAVAILABLE','The fixed ecommerce CDP browser is unavailable.');
-    const profile=path.join(os.homedir(),'.dianshang-chrome-profile');need(path.resolve(status.profile)===profile,'PROFILE_MISMATCH','Ecommerce browser profile mismatch.');
-    if(process.platform!=='win32'){let verified=false;for(const pid of status.pids||[]){try{const ps=await execute('ps',['-p',String(pid),'-o','command=']);verified ||= ps.stdout.includes('--remote-debugging-port=9223')&&ps.stdout.includes('--user-data-dir='+profile);}catch{}}need(verified,'PROFILE_MISMATCH','Chrome process arguments could not be verified.');}
     this.status=status;this.browser=await chromium.connectOverCDP(status.cdp,{timeout:15000});
     for(const context of this.browser.contexts()){for(const page of context.pages())page.on('dialog',handleBrowserDialog);context.on('page',page=>page.on('dialog',handleBrowserDialog));}
     await this.composerLock(()=>this.selectBoardTab({open}));

package/src/contracts.mjs

@@ -4,6 +4,8 @@ export const commandContracts={
   'video generate':{options:{'--canvas':s,'--prompt':s,'--prompt-file':s,'--reference':{...s,repeatable:true},'--output':s,'--request-id':s,'--new':b,'--submit':b,'--dry-run':b,'--json':b},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':s,'--json':b},sideEffects:'local-write',externalMutation:'resume continues original task; sync reapplies existing video archival and grouping; never a second generation.'},
   'frame group':{options:{'--canvas':s,'--elements':s,'--frame-id':s,'--name':s,'--submit':b,'--json':b},sideEffects:'local-write',externalMutation:'With --submit: reparent existing nodes and preserve their identities.'},
+  'browser status':{options:{'--json':b},sideEffects:'none',output:'Chrome availability and separate CDP runtime readiness'},
+  'browser open':{options:{'--json':b},sideEffects:'local-write',externalMutation:'Launch or reuse system Chrome on loopback 9223 with the current-user dedicated profile; no generation.'},
   'doctor':{options:{'--canvas':s,'--live':b,'--json':b},sideEffects:'none'},
   'skill source':{options:{'--json':b},sideEffects:'none'},
   'skill status|install|update':{options:{'--agent':s,'--path':s,'--json':b},sideEffects:'local-write'},
@@ -13,10 +15,10 @@ export const commandContracts={
 export const manifest={schema:'infinite-canvas-capabilities',schema_version:'1.0.0',package:META.name,version:META.version,
   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','board.inspect','video.generate.native-agent','task.inspect','task.wait','task.resume','task.sync','frame.group-existing'],
+  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:'ecommerce-browser, fixed loopback CDP 9223 and current-user ecommerce 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':'runtime unresolved: ecommerce browser launcher required'},
+  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,
   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.']
@@ -36,7 +38,8 @@ task resume TASK_ID --json                  (same session/run, no resubmission)
 task sync TASK_ID --json                    (reapply existing output to canvas, no generation)
 frame group --canvas ID --elements IDS.json --frame-id ID [--name TEXT]
   [--submit] --json                         (preview by default)
-browser status --json
+browser status --json                       (read-only installation and runtime state)
+browser open --json                         (built-in system Chrome startup/reuse)
 board inspect --canvas ID --json
 doctor [--live --canvas ID] --json
 capabilities --json
@@ -47,8 +50,10 @@ update check --json
 update install --yes [--agent AGENT_NAME --path DIR] --json
 update auto on|off|status --json
 
-Runtime: Node >=22; ecommerce-browser; sealseek-media; logged-in board.
-Configuration: INFINITE_CANVAS_STATE_DIR, INFINITE_CANVAS_BROWSER_BIN,
+Runtime: Node >=22; installed Google Chrome on macOS/Windows; sealseek-media.
+Chrome startup is bundled. doctor checks availability; doctor --live verifies a running editable board.
+Configuration: INFINITE_CANVAS_STATE_DIR, INFINITE_CANVAS_CHROME_BIN,
+INFINITE_CANVAS_BROWSER_BIN (optional legacy launcher override),
 INFINITE_CANVAS_MEDIA_BIN. Credentials remain with their existing providers.
 Package update detection is throttled and can be disabled using
 INFINITE_CANVAS_AUTO_UPDATE=0. No generation is submitted by installation.

package/src/core.mjs

@@ -33,7 +33,7 @@ export const sleep=ms=>new Promise(r=>setTimeout(r,ms));
 export function alive(pid){try{process.kill(pid,0);return true;}catch{return false;}}
 export async function lock(key,fn,{root=stateRoot()}={}){
   const p=path.join(root,'locks',hash(key)+'.json');await mkdir(path.dirname(p));
-  if(await exists(p)){const old=await readJSON(p);need(old.owner===META.name,'UNMANAGED_STATE','Unrecognized lock.');need(!alive(old.pid),'BUSY','Another process owns this operation.',{pid:old.pid});await fs.rename(p,p+'.'+crypto.randomUUID()+'.abandoned');}
+  if(await exists(p)){let old;try{old=await readJSON(p);}catch(e){if(e.code==='ENOENT')return lock(key,fn,{root});if(e instanceof SyntaxError)throw new Fault('BUSY','Another process is committing its lock.');throw e;}need(old.owner===META.name,'UNMANAGED_STATE','Unrecognized lock.');need(!alive(old.pid),'BUSY','Another process owns this operation.',{pid:old.pid});await fs.rename(p,p+'.'+crypto.randomUUID()+'.abandoned');}
   try{await newJSON(p,{owner:META.name,pid:process.pid,key,createdAt:new Date().toISOString()});}catch(e){if(['EEXIST','OUTPUT_EXISTS'].includes(e.code))throw new Fault('BUSY','Operation is already locked.');throw e;}
   try{return await fn();}finally{await fs.unlink(p);}
 }