@agentrhq/webcmd 0.1.2 → 0.2.1

package/dist/src/cli.js

@@ -36,7 +36,7 @@ import { daemonRestart, daemonStatus, daemonStop } from './commands/daemon.js';
 import { log } from './logger.js';
 import { bindTab, BrowserCommandError, sendCommand } from './browser/daemon-client.js';
 import { fetchDaemonStatus } from './browser/daemon-transport.js';
-import { aliasForContextId, loadProfileConfig, renameProfile, resolveProfileContextId, setDefaultProfile } from './browser/profile.js';
+import { aliasForContextId, loadProfileConfig, profileRouteParams, renameProfile, resolveProfileSelection, setDefaultProfile } from './browser/profile.js';
 import { formatDaemonVersion, isDaemonStale } from './browser/daemon-version.js';
 import { DEFAULT_BROWSER_CONNECT_TIMEOUT } from './browser/config.js';
 import { CLI_COMMAND } from './brand.js';
@@ -428,7 +428,7 @@ async function resolveStoredBrowserTarget(page, scope) {
     return resolveBrowserTargetInSession(page, defaultPage, { scope, source: 'saved' });
 }
 /** Create a browser page for browser commands. Uses a named browser session for continuity. */
-async function getBrowserPage(session, targetPage, contextId, opts = {}) {
+async function getBrowserPage(session, targetPage, profileSelection, opts = {}) {
     const { BrowserBridge } = await import('./browser/index.js');
     const bridge = new BrowserBridge();
     // Internal GC timeout for browser sessions. Not the per-command runtime timeout.
@@ -438,11 +438,11 @@ async function getBrowserPage(session, targetPage, contextId, opts = {}) {
         timeout: DEFAULT_BROWSER_CONNECT_TIMEOUT,
         session,
         surface: 'browser',
-        ...(contextId && { contextId }),
+        ...profileRouteParams(profileSelection),
         ...(idleTimeout && idleTimeout > 0 && { idleTimeout }),
         windowMode: opts.windowMode ?? getBrowserWindowMode(undefined, 'foreground'),
     });
-    const targetScope = getBrowserScope(session, contextId);
+    const targetScope = getBrowserScope(session, profileSelection?.contextId);
     const resolvedTargetPage = targetPage
         ? await resolveBrowserTargetInSession(page, targetPage, { scope: targetScope, source: 'explicit' })
         : await resolveStoredBrowserTarget(page, targetScope);
@@ -497,9 +497,9 @@ function getBrowserSession(command) {
         return raw.trim();
     throw new Error('<session> is a required positional argument: webcmd browser <session> <command>');
 }
-function getBrowserContextId(command) {
+function getBrowserProfileSelection(command) {
     const raw = getCommandOption(command, 'profile');
-    return resolveProfileContextId(typeof raw === 'string' && raw.trim() ? raw.trim() : undefined);
+    return resolveProfileSelection(typeof raw === 'string' && raw.trim() ? raw.trim() : undefined);
 }
 function getPageSession(page) {
     const session = page.session;
@@ -508,8 +508,11 @@ function getPageSession(page) {
     throw new Error('Browser page is missing a session');
 }
 function getPageScope(page) {
-    const contextId = page.contextId;
-    return getBrowserScope(getPageSession(page), typeof contextId === 'string' && contextId.trim() ? contextId.trim() : undefined);
+    const { contextId, preferredContextId } = page;
+    const selected = typeof contextId === 'string' && contextId.trim()
+        ? contextId.trim()
+        : (typeof preferredContextId === 'string' && preferredContextId.trim() ? preferredContextId.trim() : undefined);
+    return getBrowserScope(getPageSession(page), selected);
 }
 function snapshotMetricText(snapshot) {
     return typeof snapshot === 'string' ? snapshot : JSON.stringify(snapshot, null, 2);
@@ -882,9 +885,9 @@ Examples:
                 const command = args.at(-1) instanceof Command ? args.at(-1) : undefined;
                 const targetPage = getBrowserTargetId(command);
                 const session = getBrowserSession(command);
-                const contextId = getBrowserContextId(command);
+                const profileSelection = getBrowserProfileSelection(command);
                 const windowMode = getBrowserWindowMode(command, 'foreground');
-                page = await getBrowserPage(session, targetPage, contextId, { windowMode });
+                page = await getBrowserPage(session, targetPage, profileSelection, { windowMode });
                 await fn(page, ...args);
             }
             catch (err) {
@@ -933,12 +936,14 @@ Examples:
                 ? optsOrCommand
                 : {};
             const session = getBrowserSession(command);
-            const contextId = getBrowserContextId(command);
+            const profileSelection = getBrowserProfileSelection(command);
+            const contextId = profileSelection?.contextId;
+            const routing = profileRouteParams(profileSelection);
             try {
                 const { BrowserBridge } = await import('./browser/index.js');
                 const bridge = new BrowserBridge();
-                await bridge.connect({ timeout: DEFAULT_BROWSER_CONNECT_TIMEOUT, session, surface: 'browser', ...(contextId && { contextId }) });
-                await fn({ session, contextId }, opts);
+                await bridge.connect({ timeout: DEFAULT_BROWSER_CONNECT_TIMEOUT, session, surface: 'browser', ...routing });
+                await fn({ session, contextId, routing }, opts);
             }
             catch (err) {
                 if (err instanceof BrowserCommandError) {
@@ -956,7 +961,7 @@ Examples:
         .description('Bind an existing Cloak runtime tab to the browser session named by <session>')
         .option('--page <id>', 'Cloak tab page id from `webcmd browser <session> tab list`')
         .option('--index <n>', 'Cloak tab index from `webcmd browser <session> tab list`')
-        .action(browserSessionCommandAction(async ({ session, contextId }, opts) => {
+        .action(browserSessionCommandAction(async ({ session, contextId, routing }, opts) => {
         const page = typeof opts.page === 'string' && opts.page.trim() ? opts.page.trim() : undefined;
         const rawIndex = typeof opts.index === 'string' && opts.index.trim() ? opts.index.trim() : undefined;
         if ((page && rawIndex) || (!page && !rawIndex)) {
@@ -966,14 +971,14 @@ Examples:
             throw new BrowserCommandError('--index must be a non-negative integer.', 'invalid_request');
         }
         const index = rawIndex === undefined ? undefined : Number.parseInt(rawIndex, 10);
-        const data = await bindTab(session, { ...(contextId && { contextId }), ...(page && { page }), ...(index !== undefined && { index }) });
+        const data = await bindTab(session, { ...routing, ...(page && { page }), ...(index !== undefined && { index }) });
         saveBrowserTargetState(undefined, getBrowserScope(session, contextId));
         console.log(JSON.stringify({ session, ...((data && typeof data === 'object') ? data : { data }) }, null, 2));
     }));
     browser.command('unbind')
         .description('Compatibility command; release the Cloak browser session named by <session>')
-        .action(browserSessionCommandAction(async ({ session, contextId }) => {
-        await sendCommand('close-window', { session, surface: 'browser', ...(contextId && { contextId }) });
+        .action(browserSessionCommandAction(async ({ session, contextId, routing }) => {
+        await sendCommand('close-window', { session, surface: 'browser', ...routing });
         saveBrowserTargetState(undefined, getBrowserScope(session, contextId));
         console.log(JSON.stringify({ unbound: true, session }, null, 2));
     }));
@@ -2980,7 +2985,7 @@ cli({
     adapterCmd
         .command('eject')
         .description('Copy an official adapter to ~/.webcmd/clis/ for local editing')
-        .argument('<site>', 'Site name (e.g. twitter, bilibili)')
+        .argument('<site>', 'Site name (e.g. twitter, youtube)')
         .action(async (site) => {
         const os = await import('node:os');
         const userClisDir = path.join(os.homedir(), '.webcmd', 'clis');
@@ -3009,7 +3014,7 @@ cli({
     adapterCmd
         .command('reset')
         .description('Remove local override and restore official adapter version')
-        .argument('[site]', 'Site name (e.g. twitter, bilibili)')
+        .argument('[site]', 'Site name (e.g. twitter, youtube)')
         .option('--all', 'Reset all local overrides')
         .action(async (site, opts) => {
         const os = await import('node:os');

package/dist/src/cli.test.js

@@ -100,10 +100,10 @@ describe('createProgram root help descriptions', () => {
         registry.clear();
         try {
             cli({
-                site: 'bilibili',
+                site: 'reddit',
                 name: 'hot',
                 access: 'read',
-                description: 'Bilibili hot videos',
+                description: 'Reddit hot posts',
                 strategy: Strategy.PUBLIC,
                 browser: false,
             });
@@ -118,9 +118,9 @@ describe('createProgram root help descriptions', () => {
             const program = createProgram('', '');
             const help = program.helpInformation();
             expect(help).toContain('Site adapters (2):');
-            expect(help).toContain('bilibili, youtube');
+            expect(help).toContain('reddit, youtube');
             expect(help).toContain("webcmd <site> --help -f yaml");
-            expect(help).not.toMatch(/\n  bilibili\s+hot/);
+            expect(help).not.toMatch(/\n  reddit\s+hot/);
             expect(help).not.toMatch(/\n  youtube\s+search/);
         }
         finally {
@@ -135,11 +135,11 @@ describe('createProgram root help descriptions', () => {
         registry.clear();
         try {
             cli({
-                site: 'bilibili',
-                name: 'hot',
+                site: 'youtube',
+                name: 'search',
                 access: 'read',
-                description: 'Bilibili hot videos',
-                domain: 'www.bilibili.com',
+                description: 'Search YouTube',
+                domain: 'www.youtube.com',
                 strategy: Strategy.PUBLIC,
                 browser: false,
             });
@@ -158,7 +158,7 @@ describe('createProgram root help descriptions', () => {
             expect(help).toContain('App adapters (1):');
             expect(help).toMatch(/App adapters \(1\):\n {2}chatwise/);
             expect(help).toContain('Site adapters (1):');
-            expect(help).toMatch(/Site adapters \(1\):\n {2}bilibili/);
+            expect(help).toMatch(/Site adapters \(1\):\n {2}youtube/);
             // App adapters appear before Site adapters (External CLIs are absent here)
             expect(help.indexOf('App adapters')).toBeLessThan(help.indexOf('Site adapters'));
         }
@@ -172,7 +172,7 @@ describe('createProgram root help descriptions', () => {
         expect(classifyAdapter('localhost')).toBe('app');
         expect(classifyAdapter('127.0.0.1')).toBe('app');
         expect(classifyAdapter('::1')).toBe('app');
-        expect(classifyAdapter('www.bilibili.com')).toBe('site');
+        expect(classifyAdapter('www.youtube.com')).toBe('site');
     });
     it('splits list table output into App and Site sections without changing per-site rows', async () => {
         const registry = getRegistry();
@@ -200,11 +200,11 @@ describe('createProgram root help descriptions', () => {
                 browser: true,
             });
             cli({
-                site: 'bilibili',
-                name: 'hot',
+                site: 'youtube',
+                name: 'search',
                 access: 'read',
-                description: 'Bilibili hot videos',
-                domain: 'www.bilibili.com',
+                description: 'Search YouTube',
+                domain: 'www.youtube.com',
                 strategy: Strategy.PUBLIC,
                 browser: false,
             });
@@ -216,7 +216,7 @@ describe('createProgram root help descriptions', () => {
             expect(output.indexOf('App adapters')).toBeLessThan(output.indexOf('Site adapters'));
             expect(output).toMatch(/App adapters[\s\S]*antigravity[\s\S]*history \[ui\] — Read Antigravity history/);
             expect(output).toMatch(/App adapters[\s\S]*chatwise[\s\S]*ask \[ui\] — Ask Chatwise desktop app/);
-            expect(output).toMatch(/Site adapters[\s\S]*bilibili[\s\S]*hot \[public\] — Bilibili hot videos/);
+            expect(output).toMatch(/Site adapters[\s\S]*youtube[\s\S]*search \[public\] — Search YouTube/);
             expect(output).toContain('3 built-in commands across 2 apps + 1 sites,');
         }
         finally {
@@ -235,11 +235,11 @@ describe('createProgram root help descriptions', () => {
         registry.clear();
         try {
             cli({
-                site: 'bilibili',
-                name: 'hot',
+                site: 'youtube',
+                name: 'search',
                 access: 'read',
-                description: 'Bilibili hot videos',
-                domain: 'www.bilibili.com',
+                description: 'Search YouTube',
+                domain: 'www.youtube.com',
                 strategy: Strategy.PUBLIC,
                 browser: false,
                 columns: ['title', 'url'],
@@ -257,9 +257,9 @@ describe('createProgram root help descriptions', () => {
             const rows = JSON.parse(jsonOutput);
             expect(rows).toMatchObject([
                 {
-                    site: 'bilibili',
-                    name: 'hot',
-                    domain: 'www.bilibili.com',
+                    site: 'youtube',
+                    name: 'search',
+                    domain: 'www.youtube.com',
                     columns: ['title', 'url'],
                 },
             ]);
@@ -281,11 +281,11 @@ describe('createProgram root help descriptions', () => {
         registry.clear();
         try {
             cli({
-                site: 'bilibili',
-                name: 'hot',
+                site: 'youtube',
+                name: 'search',
                 access: 'read',
-                description: 'Bilibili hot videos',
-                domain: 'www.bilibili.com',
+                description: 'Search YouTube',
+                domain: 'www.youtube.com',
                 strategy: Strategy.PUBLIC,
                 browser: false,
             });
@@ -304,13 +304,13 @@ describe('createProgram root help descriptions', () => {
             expect(data.app_adapters.count).toBe(1);
             expect(data.app_adapters.apps).toEqual(['chatwise']);
             expect(data.site_adapters.count).toBe(1);
-            expect(data.site_adapters.sites).toEqual(['bilibili']);
+            expect(data.site_adapters.sites).toEqual(['youtube']);
             expect(data.external_clis.count).toBeGreaterThanOrEqual(0);
             expect(Array.isArray(data.external_clis.clis)).toBe(true);
             expect(Array.isArray(data.external_clis.display)).toBe(true);
             // Adapters must NOT leak into the core commands list
             const commandNames = data.commands.map((cmd) => cmd.name);
-            expect(commandNames).not.toContain('bilibili');
+            expect(commandNames).not.toContain('youtube');
             expect(commandNames).not.toContain('chatwise');
         }
         finally {
@@ -327,10 +327,10 @@ describe('createProgram root help descriptions', () => {
         registry.clear();
         try {
             cli({
-                site: 'bilibili',
-                name: 'hot',
+                site: 'youtube',
+                name: 'search',
                 access: 'read',
-                description: 'Bilibili hot videos',
+                description: 'Search YouTube',
                 strategy: Strategy.PUBLIC,
                 browser: false,
             });
@@ -338,9 +338,9 @@ describe('createProgram root help descriptions', () => {
             process.argv = ['node', 'webcmd', '--help', '-f', 'yaml'];
             const data = yaml.load(program.helpInformation());
             expect(data.site_adapters.count).toBe(1);
-            expect(data.site_adapters.sites).toEqual(['bilibili']);
+            expect(data.site_adapters.sites).toEqual(['youtube']);
             expect(data.commands.map((cmd) => cmd.name)).toContain('list');
-            expect(data.commands.map((cmd) => cmd.name)).not.toContain('bilibili');
+            expect(data.commands.map((cmd) => cmd.name)).not.toContain('youtube');
         }
         finally {
             process.argv = argv;
@@ -356,28 +356,28 @@ describe('createProgram root help descriptions', () => {
         registry.clear();
         try {
             cli({
-                site: 'bilibili',
-                name: 'hot',
+                site: 'youtube',
+                name: 'search',
                 access: 'read',
-                description: 'Bilibili hot videos',
+                description: 'Search YouTube',
                 strategy: Strategy.PUBLIC,
                 browser: false,
                 args: [{ name: 'limit', type: 'int', default: 20, help: 'Number of videos' }],
                 columns: ['title', 'url'],
             });
             const program = createProgram('', '');
-            const site = program.commands.find(cmd => cmd.name() === 'bilibili');
+            const site = program.commands.find(cmd => cmd.name() === 'youtube');
             expect(site).toBeTruthy();
-            process.argv = ['node', 'webcmd', 'bilibili', '--help', '-f', 'yaml'];
+            process.argv = ['node', 'webcmd', 'youtube', '--help', '-f', 'yaml'];
             const data = yaml.load(site.helpInformation());
-            expect(data.site).toBe('bilibili');
+            expect(data.site).toBe('youtube');
             expect(data.commands).toMatchObject([
                 {
-                    name: 'hot',
+                    name: 'search',
                     access: 'read',
-                    description: 'Bilibili hot videos',
+                    description: 'Search YouTube',
                     browser: false,
-                    example: 'webcmd bilibili hot -f yaml',
+                    example: 'webcmd youtube search -f yaml',
                     command_options: [{ name: 'limit', type: 'int', default: 20 }],
                     columns: ['title', 'url'],
                 },
@@ -397,31 +397,31 @@ describe('createProgram root help descriptions', () => {
         registry.clear();
         try {
             cli({
-                site: 'bilibili',
-                name: 'hot',
+                site: 'youtube',
+                name: 'search',
                 access: 'read',
-                description: 'Bilibili hot videos',
+                description: 'Search YouTube',
                 strategy: Strategy.PUBLIC,
                 browser: false,
                 args: [{ name: 'limit', type: 'int', default: 20, help: 'Number of videos' }],
             });
             cli({
-                site: 'bilibili',
+                site: 'youtube',
                 name: 'video',
                 access: 'read',
                 description: 'Read one video',
-                domain: 'www.bilibili.com',
+                domain: 'www.youtube.com',
                 strategy: Strategy.PUBLIC,
                 browser: true,
                 args: [{ name: 'bvid', positional: true, required: true, help: 'Video id' }],
             });
             const program = createProgram('', '');
-            const site = program.commands.find(cmd => cmd.name() === 'bilibili');
+            const site = program.commands.find(cmd => cmd.name() === 'youtube');
             expect(site).toBeTruthy();
             const help = site.helpInformation();
-            expect(help).toContain('hot [options]  [read] Bilibili hot videos');
-            expect(help).toContain('video <bvid>   [read] Read one video');
-            expect(help).toContain('hot [options]');
+            expect(help).toContain('search [options]  [read] Search YouTube');
+            expect(help).toContain('video <bvid>      [read] Read one video');
+            expect(help).toContain('search [options]');
             expect(help).not.toContain('video <bvid> [options]');
             expect(help).not.toContain('\nOptions:');
             expect(help).toContain('Common options:');
@@ -442,12 +442,12 @@ describe('createProgram root help descriptions', () => {
         registry.clear();
         try {
             cli({
-                site: 'bilibili',
+                site: 'youtube',
                 name: 'video',
                 access: 'read',
                 description: 'Read one video',
                 strategy: Strategy.PUBLIC,
-                domain: 'www.bilibili.com',
+                domain: 'www.youtube.com',
                 browser: true,
                 args: [
                     { name: 'bvid', positional: true, required: true, help: 'Video id' },
@@ -456,14 +456,14 @@ describe('createProgram root help descriptions', () => {
                 columns: ['title', 'url'],
             });
             const program = createProgram('', '');
-            const site = program.commands.find(cmd => cmd.name() === 'bilibili');
+            const site = program.commands.find(cmd => cmd.name() === 'youtube');
             const command = site.commands.find(cmd => cmd.name() === 'video');
             expect(command).toBeTruthy();
-            process.argv = ['node', 'webcmd', 'bilibili', 'video', '--help', '-f', 'yaml'];
+            process.argv = ['node', 'webcmd', 'youtube', 'video', '--help', '-f', 'yaml'];
             const data = yaml.load(command.helpInformation());
-            expect(data.usage).toBe('webcmd bilibili video <bvid> [options]');
+            expect(data.usage).toBe('webcmd youtube video <bvid> [options]');
             expect(data.browser).toBe(true);
-            expect(data.domain).toBe('www.bilibili.com');
+            expect(data.domain).toBe('www.youtube.com');
             expect(data.positionals).toMatchObject([{ name: 'bvid', positional: true, required: true }]);
             expect(data.command_options).toMatchObject([{ name: 'with-comments', default: false }]);
             expect(data.common_options.map((option) => option.name)).toEqual(['format', 'trace', 'verbose', 'help']);
@@ -1004,7 +1004,7 @@ describe('profile list', () => {
                 runtimeVersion: '1.0.3',
                 pending: 0,
                 memoryMB: 20,
-                port: 19825,
+                port: 9777,
             }),
         });
         const program = createProgram('', '');
@@ -1027,7 +1027,7 @@ describe('profile list', () => {
                 profiles: [],
                 pending: 0,
                 memoryMB: 20,
-                port: 19825,
+                port: 9777,
             }),
         });
         const program = createProgram('', '');

package/dist/src/commanderAdapter.test.js

@@ -251,12 +251,12 @@ describe('commanderAdapter default formats', () => {
 });
 describe('commanderAdapter error envelope output', () => {
     const cmd = {
-        site: 'xiaohongshu',
-        name: 'note', access: 'read',
-        description: 'Read one note',
+        site: 'github',
+        name: 'issue', access: 'read',
+        description: 'Read one issue',
         browser: false,
         args: [
-            { name: 'note-id', positional: true, required: true, help: 'Note ID' },
+            { name: 'issue-id', positional: true, required: true, help: 'Issue ID' },
         ],
         func: vi.fn(),
     };
@@ -268,26 +268,26 @@ describe('commanderAdapter error envelope output', () => {
     });
     it('outputs YAML error envelope with adapter hint to stderr', async () => {
         const program = new Command();
-        const siteCmd = program.command('xiaohongshu');
+        const siteCmd = program.command('github');
         registerCommandToProgram(siteCmd, cmd);
         const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
-        mockExecuteCommand.mockRejectedValueOnce(new EmptyResultError('xiaohongshu/note', 'Pass the full search_result URL with xsec_token instead of a bare note ID.'));
-        await program.parseAsync(['node', 'webcmd', 'xiaohongshu', 'note', '69ca3927000000001a020fd5']);
+        mockExecuteCommand.mockRejectedValueOnce(new EmptyResultError('github/issue', 'Pass the full issue URL instead of a bare issue number.'));
+        await program.parseAsync(['node', 'webcmd', 'github', 'issue', '12345']);
         const output = stderrSpy.mock.calls.map(c => String(c[0])).join('');
         expect(output).toContain('ok: false');
         expect(output).toContain('code: EMPTY_RESULT');
-        expect(output).toContain('xsec_token');
+        expect(output).toContain('full issue URL');
         expect(output).toContain('--trace=retain-on-failure');
-        expect(output).toContain('webcmd xiaohongshu note --trace retain-on-failure');
+        expect(output).toContain('webcmd github issue --trace retain-on-failure');
         stderrSpy.mockRestore();
     });
     it('outputs YAML error envelope for selector errors', async () => {
         const program = new Command();
-        const siteCmd = program.command('xiaohongshu');
+        const siteCmd = program.command('github');
         registerCommandToProgram(siteCmd, cmd);
         const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
         mockExecuteCommand.mockRejectedValueOnce(selectorError('.note-title', 'The note title selector no longer matches the current page.'));
-        await program.parseAsync(['node', 'webcmd', 'xiaohongshu', 'note', '69ca3927000000001a020fd5']);
+        await program.parseAsync(['node', 'webcmd', 'github', 'issue', '12345']);
         const output = stderrSpy.mock.calls.map(c => String(c[0])).join('');
         expect(output).toContain('ok: false');
         expect(output).toContain('code: SELECTOR');
@@ -297,16 +297,16 @@ describe('commanderAdapter error envelope output', () => {
     });
     it('does not add an AutoFix rerun hint when trace is already enabled', async () => {
         const program = new Command();
-        const siteCmd = program.command('xiaohongshu');
+        const siteCmd = program.command('github');
         registerCommandToProgram(siteCmd, cmd);
         const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
         mockExecuteCommand.mockRejectedValueOnce(selectorError('.note-title'));
         await program.parseAsync([
             'node',
             'webcmd',
-            'xiaohongshu',
-            'note',
-            '69ca3927000000001a020fd5',
+            'github',
+            'issue',
+            '12345',
             '--trace',
             'retain-on-failure',
         ]);
@@ -317,7 +317,7 @@ describe('commanderAdapter error envelope output', () => {
     });
     it('includes trace metadata from the error envelope when execution attached it', async () => {
         const program = new Command();
-        const siteCmd = program.command('xiaohongshu');
+        const siteCmd = program.command('github');
         registerCommandToProgram(siteCmd, cmd);
         const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
         const err = selectorError('.note-title');
@@ -336,9 +336,9 @@ describe('commanderAdapter error envelope output', () => {
         await program.parseAsync([
             'node',
             'webcmd',
-            'xiaohongshu',
-            'note',
-            '69ca3927000000001a020fd5',
+            'github',
+            'issue',
+            '12345',
             '--trace',
             'retain-on-failure',
         ]);

package/dist/src/commands/daemon.test.js

@@ -39,7 +39,7 @@ describe('daemonStatus', () => {
             runtimeVersion: '1.6.8',
             pending: 0,
             memoryMB: 64,
-            port: 19825,
+            port: 9777,
         });
         await daemonStatus();
         expect(stdoutSpy).toHaveBeenCalledWith(expect.stringContaining('running'));
@@ -49,7 +49,7 @@ describe('daemonStatus', () => {
         expect(stdoutSpy).toHaveBeenCalledWith(expect.stringContaining('connected'));
         expect(stdoutSpy).toHaveBeenCalledWith(expect.stringContaining('v1.6.8'));
         expect(stdoutSpy).toHaveBeenCalledWith(expect.stringContaining('64 MB'));
-        expect(stdoutSpy).toHaveBeenCalledWith(expect.stringContaining('19825'));
+        expect(stdoutSpy).toHaveBeenCalledWith(expect.stringContaining('9777'));
     });
     it('shows disconnected when runtime is not connected', async () => {
         fetchDaemonStatusMock.mockResolvedValue({
@@ -61,7 +61,7 @@ describe('daemonStatus', () => {
             runtimeName: 'fake',
             pending: 0,
             memoryMB: 32,
-            port: 19825,
+            port: 9777,
         });
         await daemonStatus();
         expect(stdoutSpy).toHaveBeenCalledWith(expect.stringContaining('disconnected'));
@@ -77,7 +77,7 @@ describe('daemonStatus', () => {
             runtimeVersion: undefined,
             pending: 0,
             memoryMB: 32,
-            port: 19825,
+            port: 9777,
         });
         await daemonStatus();
         expect(stdoutSpy).toHaveBeenCalledWith(expect.stringContaining('fake connected'));
@@ -105,7 +105,7 @@ describe('daemonStatus runtime label states (#1575)', () => {
             daemonVersion: PKG_VERSION,
             pending: 0,
             memoryMB: 32,
-            port: 19825,
+            port: 9777,
             runtimeName: 'fake',
             ...extra,
         });
@@ -173,7 +173,7 @@ describe('daemonStop', () => {
             runtimeName: 'fake',
             pending: 0,
             memoryMB: 50,
-            port: 19825,
+            port: 9777,
         });
         requestDaemonShutdownMock.mockResolvedValue(true);
         await daemonStop();
@@ -190,7 +190,7 @@ describe('daemonStop', () => {
             runtimeName: 'fake',
             pending: 0,
             memoryMB: 50,
-            port: 19825,
+            port: 9777,
         });
         requestDaemonShutdownMock.mockResolvedValue(false);
         await daemonStop();
@@ -221,7 +221,7 @@ describe('daemonRestart', () => {
             profiles: [{ contextId: 'work', runtimeConnected: true, pending: 0 }],
             pending: 0,
             memoryMB: 50,
-            port: 19825,
+            port: 9777,
         });
         restartDaemonMock.mockResolvedValue({
             previousStatus: { daemonVersion: '1.7.6' },
@@ -237,13 +237,13 @@ describe('daemonRestart', () => {
                 profiles: [{ contextId: 'work', runtimeConnected: true, pending: 0 }],
                 pending: 0,
                 memoryMB: 51,
-                port: 19825,
+                port: 9777,
             },
         });
         await daemonRestart();
         expect(restartDaemonMock).toHaveBeenCalledTimes(1);
         expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining('will disconnect 1 browser profile'));
-        expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining(`Daemon restarted on port 19825 (v${PKG_VERSION})`));
+        expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining(`Daemon restarted on port 9777 (v${PKG_VERSION})`));
         expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining('Runtime connected; 1 profile connected'));
     });
     it('starts a new daemon when none was running', async () => {
@@ -261,11 +261,11 @@ describe('daemonRestart', () => {
                 runtimeName: 'fake',
                 pending: 0,
                 memoryMB: 51,
-                port: 19825,
+                port: 9777,
             },
         });
         await daemonRestart();
-        expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining(`Daemon started on port 19825 (v${PKG_VERSION})`));
+        expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining(`Daemon started on port 9777 (v${PKG_VERSION})`));
         expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining('Cloak runtime has not connected yet'));
     });
     it('reports failure when the daemon cannot stop', async () => {
@@ -278,7 +278,7 @@ describe('daemonRestart', () => {
             runtimeName: 'fake',
             pending: 0,
             memoryMB: 50,
-            port: 19825,
+            port: 9777,
         });
         restartDaemonMock.mockResolvedValue({
             previousStatus: { daemonVersion: '1.7.6' },

package/dist/src/constants.d.ts

@@ -2,9 +2,8 @@
  * Shared constants used across explore, synthesize, and pipeline modules.
  */
 import { DAEMON_HEADER_NAME } from './brand.js';
-/** Default daemon port for HTTP/WebSocket communication with browser extension */
-export declare const DEFAULT_DAEMON_PORT = 19825;
-export declare function unsupportedDaemonPortEnvMessage(value?: string): string;
+/** Default daemon port for HTTP communication with the browser runtime. */
+export declare const DEFAULT_DAEMON_PORT = 9777;
 export { DAEMON_HEADER_NAME };
 /** URL query params that are volatile/ephemeral and should be stripped from patterns */
 export declare const VOLATILE_PARAMS: Set<string>;