@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/twitter/list-tweets.test.js

@@ -45,7 +45,7 @@ describe('twitter list-tweets parser', () => {
         const tweet = extractTimelineTweet({
             rest_id: '500',
             legacy: {
-                full_text: '总的来说，还是有个好爹',
+                full_text: 'Overall,family background still matters',
                 is_quote_status: true,
                 quoted_status_id_str: '499',
             },
@@ -54,7 +54,7 @@ describe('twitter list-tweets parser', () => {
                 result: {
                     rest_id: '499',
                     legacy: {
-                        full_text: '罗某官二代背景考',
+                        full_text: 'official family background review',
                         created_at: 'Wed May 13 22:00:00 +0000 2026',
                         extended_entities: {
                             media: [{ type: 'photo', media_url_https: 'https://pbs.twimg.com/media/x.jpg' }],
@@ -68,7 +68,7 @@ describe('twitter list-tweets parser', () => {
             id: '499',
             author: 'alice',
             name: 'Alice',
-            text: '罗某官二代背景考',
+            text: 'official family background review',
             created_at: 'Wed May 13 22:00:00 +0000 2026',
             url: 'https://x.com/alice/status/499',
             has_media: true,

package/clis/twitter/lists.js

@@ -63,12 +63,12 @@ export function extractListEntry(entry, seen) {
     };
 }
 
-// X 的 ListsManagementPageTimeline 把 /<user>/lists 整个页面的所有 section
-// 都塞在同一个 TimelineAddEntries instruction 里，靠 entry.entryId 前缀区分：
-//   - `owned-subscribed-list-module-*`  → 用户的 owned + subscribed list（要保留）
-//   - `list-to-follow-module-*`         → "Discover new Lists" 算法推荐（要剔除）
-//   - `cursor-*`                         → 分页游标（无 list 数据）
-// 旧版 parser 忽略 entryId 一律下钻，导致推荐 list 被当成自建/订阅泄漏出来。
+// X localized text ListsManagementPageTimeline put /<user>/lists all page section
+// into one TimelineAddEntries instruction localized text,by entry.entryId prefix distinction:
+//   - `owned-subscribed-list-module-*`  → user owned + subscribed list(should keep)
+//   - `list-to-follow-module-*`         → "Discover new Lists" algorithmic recommendations(should remove)
+//   - `cursor-*`                         → pagination cursor(none list data)
+// legacy parser ignore entryId always drill down,caused recommendations list treated as user-created/subscriptions leaked.
 const OWNED_SUBSCRIBED_ENTRY_PREFIX = 'owned-subscribed-list-module-';
 
 export function isOwnedSubscribedEntry(entry) {

package/clis/twitter/lists.test.js

@@ -109,8 +109,8 @@ describe('twitter lists parser', () => {
     });
 
     it('skips "Discover new Lists" recommendations (list-to-follow-module-*)', () => {
-        // 真实 X.com /<user>/lists 响应：Discover 推荐 + Your Lists 同 instruction，
-        // 区别只在 entry.entryId 前缀。Parser 必须按前缀剔除推荐。
+        // real X.com /<user>/lists response:Discover recommendation + Your Lists same instruction,
+        // differs only by entry.entryId prefix.Parser must filter recommendations by prefix.
         const payload = {
             data: {
                 viewer: {

package/clis/twitter/reply-dm.js

@@ -9,7 +9,7 @@ cli({
     strategy: Strategy.UI,
     browser: true,
     args: [
-        { name: 'text', type: 'string', required: true, positional: true, help: 'Message text to send (e.g. "我的微信 wxkabi")' },
+        { name: 'text', type: 'string', required: true, positional: true, help: 'Message text to send (e.g. "my messaging handle wxkabi")' },
         { name: 'max', type: 'int', required: false, default: 20, help: 'Maximum number of conversations to reply to (default: 20)' },
         { name: 'skip-replied', type: 'boolean', required: false, default: true, help: 'Skip conversations where you already sent the same text (default: true)' },
         { name: 'timeout', type: 'int', required: false, default: 600, help: 'Max seconds for the overall command (default: 600 — batch op)' },

package/clis/twitter/shared.test.js

@@ -275,8 +275,7 @@ describe('twitter parseTweetUrl', () => {
 describe('twitter buildTwitterArticleScopeSource', () => {
     // JSDOM-based tests prove the returned source actually works on real DOM —
     // mocked `evaluate` tests in adapter specs only verify the script string
-    // contains expected tokens, but cannot catch silent matching bugs (cf.
-    // dianping #1312: mocked-evaluate single tests miss in-browser logic bugs).
+    // contains expected tokens, but cannot catch silent in-browser matching bugs.
     function loadHelpers(tweetId, dom) {
         const source = buildTwitterArticleScopeSource(tweetId);
         const probe = new Function(
@@ -742,7 +741,7 @@ describe('twitter extractQuotedTweet', () => {
                 result: {
                     rest_id: '2040254679301718161',
                     legacy: {
-                        full_text: '罗某官二代背景考',
+                        full_text: 'official family background review',
                         created_at: 'Wed May 13 22:00:00 +0000 2026',
                     },
                     core: {
@@ -757,7 +756,7 @@ describe('twitter extractQuotedTweet', () => {
             id: '2040254679301718161',
             author: 'alice',
             name: 'Alice',
-            text: '罗某官二代背景考',
+            text: 'official family background review',
             created_at: 'Wed May 13 22:00:00 +0000 2026',
             url: 'https://x.com/alice/status/2040254679301718161',
             has_media: false,
@@ -773,7 +772,7 @@ describe('twitter extractQuotedTweet', () => {
                 result: {
                     rest_id: '99',
                     legacy: {
-                        full_text: '日本电车实录',
+                        full_text: 'Japanese train record',
                         extended_entities: {
                             media: [
                                 { type: 'photo', media_url_https: 'https://pbs.twimg.com/media/a.jpg' },

package/clis/twitter/trending.js

@@ -4,7 +4,7 @@ import { AuthRequiredError, EmptyResultError } from '@agentrhq/webcmd/errors';
 //
 // X (Twitter) removed the post-count caption from each trend cell on the
 // /explore/tabs/trending page in 2024-2025. The DOM now only carries:
-//   divs[0] = rank + category (e.g. "1 · Trending in United States")
+//   divs[0] = rank + category (e.g. "1 \u00b7 Trending in United States")
 //   divs[1] = topic
 //   divs[2..] = caret menu button (no post-count text)
 // We previously surfaced a `tweets` column whose value was permanently

package/clis/twitter/utils.js

@@ -216,7 +216,7 @@ export async function waitForComposerMediaReady(page, expectedCount = 1) {
         ).length;
         const blobCount = document.querySelectorAll('img[src^="blob:"], video[src^="blob:"]').length;
         const removeButtonCount = Array.from(document.querySelectorAll('button,[role="button"]')).filter((el) =>
-          /remove media|remove image|remove|编辑/i.test((el.getAttribute('aria-label') || '') + ' ' + (el.textContent || ''))
+          /remove media|remove image|remove|localized text/i.test((el.getAttribute('aria-label') || '') + ' ' + (el.textContent || ''))
         ).length;
         const explicitPreviewCount = Math.max(
           previewCount,

package/clis/web/read.js

@@ -223,7 +223,7 @@ function buildRenderAwareExtractorJs(options) {
           const section = document.createElement('section');
           section.setAttribute('data-webcmd-iframe-source', desc.src);
           const heading = document.createElement('h2');
-          heading.textContent = '来自 iframe: ' + (desc.src || fallbackLabel);
+          heading.textContent = 'localized text iframe: ' + (desc.src || fallbackLabel);
           section.appendChild(heading);
           Array.from(frameBody.childNodes).forEach(node => section.appendChild(node));
           return section;

package/clis/web/read.test.js

@@ -236,7 +236,7 @@ describe('web/read render-aware helpers', () => {
 
         expect(result.diagnostics.includedFrameCount).toBe(1);
         expect(result.contentHtml).toContain('data-webcmd-iframe-source="https://example.com/frame.html"');
-        expect(result.contentHtml).toContain('来自 iframe: https://example.com/frame.html');
+        expect(result.contentHtml).toContain('localized text iframe: https://example.com/frame.html');
         expect(result.contentHtml).toContain('Station A 42');
         expect(result.diagnostics.emptyContainers).toEqual(expect.arrayContaining([
             expect.objectContaining({ scope: 'iframe', id: 'gridDatas', url: 'https://example.com/frame.html' }),
@@ -277,7 +277,7 @@ describe('web/read render-aware helpers', () => {
         `, { url: 'https://example.com/main.html', runScripts: 'outside-only' });
         const frame = dom.window.document.querySelector('iframe');
         frame.contentDocument.open();
-        frame.contentDocument.write('<body><table id="gridHd"><tr><th>水位</th></tr><tr><td>42</td></tr></table><ul id="gridDatas"></ul></body>');
+        frame.contentDocument.write('<body><table id="gridHd"><tr><th>water level</th></tr><tr><td>42</td></tr></table><ul id="gridDatas"></ul></body>');
         frame.contentDocument.close();
 
         const result = dom.window.eval(__test__.buildRenderAwareExtractorJs({ frames: 'same-origin' }));

package/clis/yahoo-finance/quote.js

@@ -7,7 +7,7 @@ cli({
     site: 'yahoo-finance',
     name: 'quote',
     access: 'read',
-    description: 'Yahoo Finance 股票行情',
+    description: 'Yahoo Finance stock quote',
     domain: 'finance.yahoo.com',
     strategy: Strategy.COOKIE,
     args: [

package/clis/youtube/history.js

@@ -55,7 +55,7 @@ cli({
               || text(link);
             const channel =
               text(renderer.querySelector('#channel-name a'))
-              || text(renderer.querySelector('[aria-label^="前往频道："]'))
+              || text(renderer.querySelector('[aria-label^="Go to channel:"]'))
               || text(renderer.querySelector('[aria-label^="Go to channel:"]'))
               || text(renderer.querySelector('ytd-channel-name'))
               || text(renderer.querySelector('#metadata #byline-container'))
@@ -68,8 +68,8 @@ cli({
               .filter(Boolean);
             const combinedMetadata = (metadata.length ? metadata : lockupMetadata)
               .filter(value => value && value !== title && value !== '•');
-            const inferredChannel = channel || combinedMetadata.find(value => !/观看|views|前|前に|ago|次观看|次查看|stream/i.test(value)) || '';
-            const inferredViews = combinedMetadata.find(value => /观看|views/i.test(value)) || '';
+            const inferredChannel = channel || combinedMetadata.find(value => !/views|views|ago|agoに|ago|views|views|stream/i.test(value)) || '';
+            const inferredViews = combinedMetadata.find(value => /views|views/i.test(value)) || '';
             const inferredPublished = combinedMetadata.find(value => value !== inferredChannel && value !== inferredViews) || '';
             const duration =
               text(renderer.querySelector('ytd-thumbnail-overlay-time-status-renderer'))
@@ -96,7 +96,7 @@ cli({
             push({
               title,
               channel: 'Shorts',
-              views: stats.find(value => /观看|views/i.test(value)) || '',
+              views: stats.find(value => /views|views/i.test(value)) || '',
               duration: 'SHORT',
               published: '',
               url: href.startsWith('http') ? href : 'https://www.youtube.com' + href,

package/clis/youtube/transcript-group.js

@@ -7,7 +7,7 @@
  * - Speaker turns: detect ">>" markers from YouTube auto-captions
  * - Chapters: optional chapter headings inserted at appropriate timestamps
  */
-// Include CJK sentence-ending punctuation: 。！？ (fullwidth: ．！？)
+// Include CJK sentence-ending punctuation: .!? (fullwidth: ．!?)
 const SENTENCE_END = /[.!?\u3002\uFF01\uFF1F\uFF0E]["'\u2019\u201D)]*\s*$/;
 const QUESTION_END = /[?\uFF1F]["'\u2019\u201D)]*\s*$/;
 const TRANSCRIPT_GROUP_GAP_SECONDS = 20;

package/clis/youtube/transcript-group.test.js

@@ -52,14 +52,14 @@ describe('groupTranscriptSegments', () => {
     });
     it('recognizes CJK sentence-ending punctuation', () => {
         const segments = [
-            { start: 0, text: '你好世界。' },
-            { start: 2, text: '这是测试' },
-            { start: 4, text: '内容。' },
+            { start: 0, text: 'Hello world.' },
+            { start: 2, text: 'This is a test' },
+            { start: 4, text: 'content.' },
         ];
         const result = groupTranscriptSegments(segments);
         expect(result).toHaveLength(2);
-        expect(result[0].text).toBe('你好世界。');
-        expect(result[1].text).toBe('这是测试 内容。');
+        expect(result[0].text).toBe('Hello world.');
+        expect(result[1].text).toBe('This is a test content.');
     });
     it('returns empty array for empty input', () => {
         expect(groupTranscriptSegments([])).toEqual([]);

package/clis/youtube/transcript.js

@@ -444,11 +444,11 @@ cli({
         }
         if (captionData?.error) {
             const msg = `${captionData.error}${captionData.available ? ' (available: ' + captionData.available.join(', ') + ')' : ''}`;
-            // "No captions available" 是合法 empty 数据条件（作者没开字幕 + YT 没自动生成），
-            // 与 bilibili subtitle 的 EmptyResultError 同模式。下游应按 code EMPTY_RESULT 跳过
-            // 重试和 softFail 计数。其它 error（HTTP / parse / 短暂空响应）仍按 fetch 失败抛。
+            // "No captions available" is a valid empty data condition(creator disabled captions + YT no auto captions),
+            // Localized "no captions" text follows the same empty-result pattern; downstream should treat code EMPTY_RESULT as skip.
+            // retry and softFail count.other error(HTTP / parse / temporary empty response)still treat as fetch failure.
             if (captionData.error === 'No captions available for this video') {
-                throw new EmptyResultError('youtube transcript', '该视频没有字幕（作者未开启 + 无自动字幕）。');
+                throw new EmptyResultError('youtube transcript', 'This video has no captions(creator disabled captions + no automatic captions).');
             }
             throw new CommandExecutionError(msg);
         }
@@ -640,7 +640,7 @@ cli({
         }
         // Step 4: Format output based on mode
         if (mode === 'raw') {
-            // Precise timestamps in seconds with decimals, matching bilibili/subtitle format
+            // Precise timestamps in seconds with decimals, matching the subtitle segment format.
             return segments.map((seg, i) => ({
                 index: i + 1,
                 start: Number(seg.start).toFixed(2) + 's',

package/clis/youtube/video.js

@@ -114,10 +114,10 @@ cli({
           }
         } catch {}
 
-        // 播放门禁信号：会员专享（channel membership）/ 付费点播等视频 metadata 照常
-        // 可见，但视频流拿不到——playabilityStatus.status != 'OK'。reason 文本是本地化
-        // 的（中文 cookie 下是中文），所以 membersOnly 用 watch HTML 里 locale 无关的
-        // BADGE_STYLE_TYPE_MEMBERS_ONLY 徽标枚举判定，下游不要去 parse reason。
+        // playability gate signal:members-only(channel membership)/ paid video metadata as usual
+        // visible,but the video stream is unavailable——playabilityStatus.status != 'OK'.reason text is localized
+        // localized text(Chinese cookie is Chinese under this locale),so membersOnly localized text watch HTML localized text locale locale-independent
+        // BADGE_STYLE_TYPE_MEMBERS_ONLY badge enum detection,downstream should not parse reason.
         const ps = player.playabilityStatus || {};
         const membersOnly = html.indexOf('BADGE_STYLE_TYPE_MEMBERS_ONLY') !== -1;
 

package/clis/youtube/video.test.js

@@ -21,8 +21,8 @@ const videoSource = readFileSync(resolve(__dirname, 'video.js'), 'utf8');
 
 describe('youtube video source contract', () => {
   it('extracts playability gate signals inside the watch bootstrap evaluate', () => {
-    // 会员专享视频 metadata 照常可见但流不可播——playabilityStatus 是判断依据；
-    // reason 文本本地化，membersOnly 必须用 locale 无关的徽标枚举判定。
+    // members-only video metadata localized text——playabilityStatus is the decision source;
+    // reason localized text,membersOnly must use locale locale-independent badge enum detection.
     expect(videoSource).toContain('player.playabilityStatus');
     expect(videoSource).toContain('BADGE_STYLE_TYPE_MEMBERS_ONLY');
   });
@@ -39,8 +39,8 @@ describe('youtube video row mapping', () => {
 
   it('surfaces playabilityStatus / playabilityReason / membersOnly as rows', async () => {
     page.evaluate.mockResolvedValueOnce({
-      title: 'Koji杨远骋：高手如何用AI？',
-      channel: '课代表立正',
+      title: 'KojiKoji Yang:How experts useAI?',
+      channel: 'Class Notes',
       videoId: 'jgeqHyFzfIM',
       playabilityStatus: 'UNPLAYABLE',
       playabilityReason: "This video is available to this channel's members",
@@ -53,8 +53,8 @@ describe('youtube video row mapping', () => {
     expect(byField.playabilityStatus).toBe('UNPLAYABLE');
     expect(byField.membersOnly).toBe('true');
     expect(byField.playabilityReason).toContain('members');
-    // metadata 行照常返回（会员视频标题等仍可见）
-    expect(byField.title).toBe('Koji杨远骋：高手如何用AI？');
+    // metadata metadata rows still return(member video metadata remains visible)
+    expect(byField.title).toBe('KojiKoji Yang:How experts useAI?');
   });
 
   it('reports OK playability for a normal video', async () => {

package/dist/src/adapter-shadow.d.ts

@@ -0,0 +1,11 @@
+export type AdapterShadow = {
+    name: string;
+    userPath: string;
+    builtinPath: string;
+};
+export type AdapterShadowOptions = {
+    userClisDir?: string;
+    builtinClisDir?: string;
+};
+export declare function findShadowedUserAdapters(opts?: AdapterShadowOptions): AdapterShadow[];
+export declare function formatAdapterShadowIssue(shadows: AdapterShadow[]): string;

package/dist/src/adapter-shadow.js

@@ -0,0 +1,72 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { findPackageRoot, getCliManifestPath } from './package-paths.js';
+function defaultBuiltinClisDir() {
+    return path.join(findPackageRoot(fileURLToPath(import.meta.url)), 'clis');
+}
+function safeReaddir(dir) {
+    try {
+        return fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+function loadBuiltinCommandFiles(builtinClisDir) {
+    try {
+        const raw = fs.readFileSync(getCliManifestPath(builtinClisDir), 'utf-8');
+        const entries = JSON.parse(raw);
+        const files = new Set();
+        for (const entry of entries) {
+            const rel = entry.sourceFile ?? entry.modulePath;
+            if (rel)
+                files.add(path.resolve(builtinClisDir, rel));
+        }
+        return files;
+    }
+    catch {
+        return new Set();
+    }
+}
+export function findShadowedUserAdapters(opts = {}) {
+    const userClisDir = opts.userClisDir ?? path.join(os.homedir(), '.webcmd', 'clis');
+    const builtinClisDir = opts.builtinClisDir ?? defaultBuiltinClisDir();
+    const builtinCommandFiles = loadBuiltinCommandFiles(builtinClisDir);
+    const shadows = [];
+    for (const siteEntry of safeReaddir(userClisDir)) {
+        if (!siteEntry.isDirectory())
+            continue;
+        const site = siteEntry.name;
+        const userSiteDir = path.join(userClisDir, site);
+        const builtinSiteDir = path.join(builtinClisDir, site);
+        for (const commandEntry of safeReaddir(userSiteDir)) {
+            if (!commandEntry.isFile() || !commandEntry.name.endsWith('.js'))
+                continue;
+            const userPath = path.join(userSiteDir, commandEntry.name);
+            const builtinPath = path.join(builtinSiteDir, commandEntry.name);
+            const builtinResolved = path.resolve(builtinPath);
+            if (!builtinCommandFiles.has(builtinResolved))
+                continue;
+            shadows.push({
+                name: `${site}/${commandEntry.name.replace(/\.js$/, '')}`,
+                userPath,
+                builtinPath,
+            });
+        }
+    }
+    return shadows.sort((a, b) => a.name.localeCompare(b.name));
+}
+export function formatAdapterShadowIssue(shadows) {
+    const visible = shadows.slice(0, 10);
+    const lines = ['Local adapter overrides shadow packaged adapters:'];
+    for (const shadow of visible) {
+        lines.push(`  ${shadow.name}: ${shadow.userPath} overrides ${shadow.builtinPath}`);
+    }
+    if (shadows.length > visible.length) {
+        lines.push(`  ... and ${shadows.length - visible.length} more`);
+    }
+    lines.push('Remove the local ~/.webcmd/clis copy, or run webcmd adapter reset <site>, when you want packaged updates.');
+    return lines.join('\n');
+}

package/dist/src/adapter-shadow.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'vitest';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { findShadowedUserAdapters, formatAdapterShadowIssue } from './adapter-shadow.js';
+describe('adapter shadow detection', () => {
+    it('reports user adapters that shadow packaged manifest commands', () => {
+        const root = fs.mkdtempSync(path.join(os.tmpdir(), 'webcmd-adapter-shadow-'));
+        try {
+            const userClisDir = path.join(root, 'user-clis');
+            const builtinRoot = path.join(root, 'pkg');
+            const builtinClisDir = path.join(builtinRoot, 'clis');
+            fs.mkdirSync(path.join(userClisDir, 'instagram'), { recursive: true });
+            fs.mkdirSync(path.join(userClisDir, 'twitter'), { recursive: true });
+            fs.mkdirSync(path.join(builtinClisDir, 'instagram'), { recursive: true });
+            fs.mkdirSync(path.join(builtinClisDir, 'twitter'), { recursive: true });
+            fs.writeFileSync(path.join(userClisDir, 'instagram', 'saved.js'), '', 'utf-8');
+            fs.writeFileSync(path.join(userClisDir, 'instagram', 'utils.js'), '', 'utf-8');
+            fs.writeFileSync(path.join(userClisDir, 'twitter', 'search.js'), '', 'utf-8');
+            fs.writeFileSync(path.join(builtinClisDir, 'instagram', 'saved.js'), '', 'utf-8');
+            fs.writeFileSync(path.join(builtinClisDir, 'instagram', 'utils.js'), '', 'utf-8');
+            fs.writeFileSync(path.join(builtinClisDir, 'twitter', 'search.js'), '', 'utf-8');
+            fs.writeFileSync(path.join(builtinRoot, 'cli-manifest.json'), `${JSON.stringify([
+                { site: 'instagram', name: 'saved', sourceFile: 'instagram/saved.js' },
+            ])}\n`, 'utf-8');
+            expect(findShadowedUserAdapters({ userClisDir, builtinClisDir })).toEqual([
+                {
+                    name: 'instagram/saved',
+                    userPath: path.join(userClisDir, 'instagram', 'saved.js'),
+                    builtinPath: path.join(builtinClisDir, 'instagram', 'saved.js'),
+                },
+            ]);
+        }
+        finally {
+            fs.rmSync(root, { recursive: true, force: true });
+        }
+    });
+    it('formats a concise doctor issue', () => {
+        const issue = formatAdapterShadowIssue([
+            {
+                name: 'instagram/saved',
+                userPath: '/home/me/.webcmd/clis/instagram/saved.js',
+                builtinPath: '/pkg/clis/instagram/saved.js',
+            },
+        ]);
+        expect(issue).toContain('instagram/saved');
+        expect(issue).toContain('webcmd adapter reset <site>');
+    });
+});

package/dist/src/adapter-source.d.ts

@@ -0,0 +1,11 @@
+import type { InternalCliCommand } from './registry.js';
+/**
+ * Resolve the editable source file path for an adapter.
+ *
+ * Priority:
+ * 1. cmd.source (set for FS-scanned JS and manifest lazy-loaded JS)
+ * 2. cmd._modulePath (set for manifest lazy-loaded JS)
+ *
+ * Skip manifest: prefixed pseudo-paths (YAML commands inlined in manifest).
+ */
+export declare function resolveAdapterSourcePath(cmd: InternalCliCommand): string | undefined;

package/dist/src/adapter-source.js

@@ -0,0 +1,24 @@
+import * as fs from 'node:fs';
+/**
+ * Resolve the editable source file path for an adapter.
+ *
+ * Priority:
+ * 1. cmd.source (set for FS-scanned JS and manifest lazy-loaded JS)
+ * 2. cmd._modulePath (set for manifest lazy-loaded JS)
+ *
+ * Skip manifest: prefixed pseudo-paths (YAML commands inlined in manifest).
+ */
+export function resolveAdapterSourcePath(cmd) {
+    const candidates = [];
+    if (cmd.source && !cmd.source.startsWith('manifest:')) {
+        candidates.push(cmd.source);
+    }
+    if (cmd._modulePath) {
+        candidates.push(cmd._modulePath);
+    }
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return candidates[0];
+}

package/dist/src/adapter-source.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/adapter-source.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from 'vitest';
+import { resolveAdapterSourcePath } from './adapter-source.js';
+function makeCmd(overrides = {}) {
+    return {
+        site: 'test-site',
+        name: 'test-cmd', access: 'read',
+        description: 'test',
+        args: [],
+        ...overrides,
+    };
+}
+describe('resolveAdapterSourcePath', () => {
+    it('returns source when it is a real file path (not manifest:)', () => {
+        const cmd = makeCmd({ source: '/home/user/.webcmd/clis/arxiv/search.js' });
+        expect(resolveAdapterSourcePath(cmd)).toBe('/home/user/.webcmd/clis/arxiv/search.js');
+    });
+    it('skips manifest: pseudo-paths and falls back to _modulePath', () => {
+        const cmd = makeCmd({ source: 'manifest:arxiv/search', _modulePath: '/pkg/clis/arxiv/search.js' });
+        expect(resolveAdapterSourcePath(cmd)).toBe('/pkg/clis/arxiv/search.js');
+    });
+    it('returns undefined when only manifest: pseudo-path and no _modulePath', () => {
+        const cmd = makeCmd({ source: 'manifest:test/cmd' });
+        expect(resolveAdapterSourcePath(cmd)).toBeUndefined();
+    });
+    it('returns _modulePath when it is the only path available', () => {
+        const cmd = makeCmd({ _modulePath: '/project/clis/site/cmd.js' });
+        expect(resolveAdapterSourcePath(cmd)).toBe('/project/clis/site/cmd.js');
+    });
+});

package/dist/src/brand.d.ts

@@ -0,0 +1,9 @@
+export declare const PRODUCT_NAME = "webcmd";
+export declare const PRODUCT_DISPLAY_NAME = "Webcmd";
+export declare const CLI_COMMAND = "webcmd";
+export declare const PACKAGE_NAME = "@agentrhq/webcmd";
+export declare const CONFIG_DIR_NAME = ".webcmd";
+export declare const ENV_PREFIX = "WEBCMD";
+export declare const DAEMON_HEADER_NAME = "X-Webcmd";
+export declare const EXTENSION_PACKAGE_NAME = "webcmd-extension";
+export declare const EXTENSION_ARTIFACT_PREFIX = "webcmd-extension";

package/dist/src/brand.js

@@ -0,0 +1,9 @@
+export const PRODUCT_NAME = 'webcmd';
+export const PRODUCT_DISPLAY_NAME = 'Webcmd';
+export const CLI_COMMAND = 'webcmd';
+export const PACKAGE_NAME = '@agentrhq/webcmd';
+export const CONFIG_DIR_NAME = '.webcmd';
+export const ENV_PREFIX = 'WEBCMD';
+export const DAEMON_HEADER_NAME = 'X-Webcmd';
+export const EXTENSION_PACKAGE_NAME = 'webcmd-extension';
+export const EXTENSION_ARTIFACT_PREFIX = 'webcmd-extension';

package/dist/src/brand.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/brand.test.js

@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest';
+import { CLI_COMMAND, CONFIG_DIR_NAME, DAEMON_HEADER_NAME, ENV_PREFIX, EXTENSION_ARTIFACT_PREFIX, EXTENSION_PACKAGE_NAME, PACKAGE_NAME, PRODUCT_DISPLAY_NAME, PRODUCT_NAME, } from './brand.js';
+describe('webcmd brand constants', () => {
+    it('defines AgentR webcmd identity', () => {
+        expect(PRODUCT_NAME).toBe('webcmd');
+        expect(PRODUCT_DISPLAY_NAME).toBe('Webcmd');
+        expect(CLI_COMMAND).toBe('webcmd');
+        expect(PACKAGE_NAME).toBe('@agentrhq/webcmd');
+        expect(CONFIG_DIR_NAME).toBe('.webcmd');
+        expect(ENV_PREFIX).toBe('WEBCMD');
+        expect(DAEMON_HEADER_NAME).toBe('X-Webcmd');
+        expect(EXTENSION_PACKAGE_NAME).toBe('webcmd-extension');
+        expect(EXTENSION_ARTIFACT_PREFIX).toBe('webcmd-extension');
+    });
+});