@sovovs/bycli 2.0.0 → 2.1.1

package/dist/src/cli.js

@@ -506,7 +506,7 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
                     description: c.description,
                     access: c.access,
                     strategy: strategyLabel(c),
-                    browser: !!c.browser,
+                    browser: c.browser,
                     args: formatArgSummary(c.args),
                 }));
             renderOutput(rows, {

package/dist/src/commanderAdapter.js

@@ -11,7 +11,7 @@
  */
 import { log } from './logger.js';
 import yaml from 'js-yaml';
-import { fullName, getRegistry } from './registry.js';
+import { fullName, getRegistry, hasBrowserCapability } from './registry.js';
 import { render as renderOutput } from './output.js';
 import { executeCommand, prepareCommandArgs } from './execution.js';
 import { commandHelpData, formatCommandHelpText, formatCommandListTerm, formatSiteCommandDescription, formatSiteHelpText, getRequestedHelpFormat, renderStructuredHelp, siteHelpData, } from './help.js';
@@ -48,7 +48,7 @@ export function registerCommandToProgram(siteCmd, cmd) {
         .option('-f, --format <fmt>', 'Output format: table, plain, json, yaml, md, csv', 'table')
         .option('--trace <mode>', 'Trace capture: off, on, retain-on-failure', 'off')
         .option('-v, --verbose', 'Debug output', false);
-    if (cmd.browser) {
+    if (hasBrowserCapability(cmd)) {
         subCmd
             .option('--window <mode>', 'Browser window mode: foreground or background')
             .option('--site-session <mode>', 'Adapter site session lifecycle: ephemeral or persistent')
@@ -108,9 +108,9 @@ export function registerCommandToProgram(siteCmd, cmd) {
                 prepared: true,
                 ...(typeof globals.profile === 'string' && globals.profile.trim() ? { profile: globals.profile.trim() } : {}),
                 ...(typeof optionsRecord.trace === 'string' && optionsRecord.trace !== 'off' ? { trace: optionsRecord.trace } : {}),
-                ...(cmd.browser && typeof optionsRecord.window === 'string' ? { windowMode: optionsRecord.window } : {}),
-                ...(cmd.browser && typeof optionsRecord.siteSession === 'string' ? { siteSession: optionsRecord.siteSession } : {}),
-                ...(cmd.browser && typeof optionsRecord.keepTab === 'string' ? { keepTab: optionsRecord.keepTab } : {}),
+                ...(hasBrowserCapability(cmd) && typeof optionsRecord.window === 'string' ? { windowMode: optionsRecord.window } : {}),
+                ...(hasBrowserCapability(cmd) && typeof optionsRecord.siteSession === 'string' ? { siteSession: optionsRecord.siteSession } : {}),
+                ...(hasBrowserCapability(cmd) && typeof optionsRecord.keepTab === 'string' ? { keepTab: optionsRecord.keepTab } : {}),
             });
             if (result === null || result === undefined) {
                 return;

package/dist/src/daemon.js

@@ -35,6 +35,7 @@ import { reapOrphanedVerifyRuns } from './recorder/runner/reap.js';
 import { resolveTempPolicy, resolveRunnerConfig, resolveTempCapacity } from './recorder/runner/config.js';
 import { defaultSessionKeyRegistry } from './recorder/runner/session-keys.js';
 import { recordExtensionVersion } from './update-check.js';
+import { EXTENSION_CAPABILITY_MISSING_ERROR_CODE, EXTENSION_CAPABILITY_MISSING_HTTP_STATUS, extensionCapabilityHint, missingRequiredExtensionCapability, normalizeExtensionCapabilities, } from './browser/extension-capabilities.js';
 import { buildCommandDispatchFailure, buildExtensionDisconnectFailure, getResponseCorsHeaders, } from './daemon-utils.js';
 const PORT = parseInt(process.env.BYCLI_DAEMON_PORT ?? String(DEFAULT_DAEMON_PORT), 10);
 // The verify runner (M6b) spawns child processes that connect back to THIS daemon for a
@@ -123,6 +124,7 @@ function registerExtensionConnection(ws, rawContextId) {
         ws,
         extensionVersion: current?.ws === ws ? current.extensionVersion : null,
         extensionCompatRange: current?.ws === ws ? current.extensionCompatRange : null,
+        extensionCapabilities: current?.ws === ws ? current.extensionCapabilities : [],
         lastSeenAt: Date.now(),
     };
     extensionProfiles.set(contextId, connection);
@@ -357,6 +359,7 @@ async function handleRequest(req, res) {
             extensionConnected: true,
             extensionVersion: profile.extensionVersion ?? undefined,
             extensionCompatRange: profile.extensionCompatRange ?? undefined,
+            extensionCapabilities: profile.extensionCapabilities,
             pending: [...pending.values()].filter((entry) => entry.contextId === profile.contextId).length,
             lastSeenAt: profile.lastSeenAt,
         }));
@@ -368,6 +371,7 @@ async function handleRequest(req, res) {
             extensionConnected: !!route.connection,
             extensionVersion: route.connection?.extensionVersion ?? undefined,
             extensionCompatRange: route.connection?.extensionCompatRange ?? undefined,
+            extensionCapabilities: route.connection?.extensionCapabilities,
             contextId: route.connection?.contextId ?? requestedContextId,
             profileRequired: route.errorCode === 'profile_required',
             profileDisconnected: route.errorCode === 'profile_disconnected',
@@ -423,6 +427,17 @@ async function handleRequest(req, res) {
                 });
                 return;
             }
+            const requiredCapability = missingRequiredExtensionCapability(body, route.connection.extensionCapabilities);
+            if (requiredCapability) {
+                jsonResponse(res, EXTENSION_CAPABILITY_MISSING_HTTP_STATUS, {
+                    id: body.id,
+                    ok: false,
+                    errorCode: EXTENSION_CAPABILITY_MISSING_ERROR_CODE,
+                    error: `Connected Browser Bridge does not advertise ${requiredCapability}.`,
+                    errorHint: extensionCapabilityHint(requiredCapability),
+                });
+                return;
+            }
             const timeoutMs = typeof body.timeout === 'number' && body.timeout > 0
                 ? body.timeout * 1000
                 : 120000;
@@ -529,6 +544,7 @@ wss.on('connection', (ws) => {
                 const connection = registerExtensionConnection(ws, msg.contextId);
                 connection.extensionVersion = typeof msg.version === 'string' ? msg.version : null;
                 connection.extensionCompatRange = typeof msg.compatRange === 'string' ? msg.compatRange : null;
+                connection.extensionCapabilities = normalizeExtensionCapabilities(msg.capabilities);
                 connection.lastSeenAt = Date.now();
                 if (connection.extensionVersion)
                     recordExtensionVersion(connection.extensionVersion);

package/dist/src/discovery.d.ts

@@ -37,6 +37,11 @@ export declare function ensureUserAdapters(): Promise<void>;
  * Uses pre-compiled manifest when available for instant startup.
  */
 export declare function discoverClis(...dirs: string[]): Promise<void>;
+/**
+ * Fast-path: register commands from pre-compiled manifest.
+ * TS modules are deferred — loaded lazily on first execution.
+ */
+export declare function loadFromManifest(manifestPath: string, clisDir: string): Promise<boolean>;
 /**
  * Discover and register plugins from ~/.bycli/plugins/.
  * Each subdirectory is treated as a plugin (site = directory name).

package/dist/src/discovery.js

@@ -113,7 +113,7 @@ export async function discoverClis(...dirs) {
  * Fast-path: register commands from pre-compiled manifest.
  * TS modules are deferred — loaded lazily on first execution.
  */
-async function loadFromManifest(manifestPath, clisDir) {
+export async function loadFromManifest(manifestPath, clisDir) {
     try {
         const raw = await fs.promises.readFile(manifestPath, 'utf-8');
         const manifest = JSON.parse(raw);
@@ -121,7 +121,7 @@ async function loadFromManifest(manifestPath, clisDir) {
             if (!entry.modulePath)
                 continue;
             const modulePath = path.resolve(clisDir, entry.modulePath);
-            const cmd = {
+            const common = {
                 site: entry.site,
                 name: entry.name,
                 aliases: entry.aliases,
@@ -130,7 +130,6 @@ async function loadFromManifest(manifestPath, clisDir) {
                 example: entry.example,
                 domain: entry.domain,
                 strategy: parseStrategy(entry.strategy),
-                browser: entry.browser,
                 args: entry.args ?? [],
                 columns: entry.columns,
                 defaultFormat: entry.defaultFormat,
@@ -141,7 +140,16 @@ async function loadFromManifest(manifestPath, clisDir) {
                 _lazy: true,
                 _modulePath: modulePath,
             };
-            // normalizeCommand inside registerCommand handles strategy → browser/navigateBefore
+            const cmd = entry.browser === 'conditional'
+                ? {
+                    ...common,
+                    browser: 'conditional',
+                    requiresBrowser: () => {
+                        throw new Error(`Conditional manifest placeholder ${entry.site}/${entry.name} was not hydrated`);
+                    },
+                    _hydrateBeforeBrowserRouting: true,
+                }
+                : { ...common, browser: entry.browser };
             registerCommand(cmd);
         }
         return true;

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

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

package/dist/src/download/article-download.d.ts

@@ -6,6 +6,7 @@
  * Flow: ArticleData → TurndownService → image download → frontmatter → .md file
  */
 import TurndownService from 'turndown';
+export { extractWechatArticleHtml } from './wechat-article.js';
 export interface ArticleData {
     title: string;
     author?: string;
@@ -49,6 +50,8 @@ export interface ArticleDownloadOptions {
      * as-is so the output is self-contained when piped.
      */
     stdout?: boolean;
+    /** Opt-in hardened Markdown rules used by HTML-focused adapters. */
+    secureMarkdown?: boolean;
 }
 export interface ArticleDownloadResult {
     title: string;
@@ -58,6 +61,9 @@ export interface ArticleDownloadResult {
     size: string;
     saved: string;
 }
+export declare function convertArticleHtmlToMarkdown(contentHtml: string, options?: {
+    safeFencedCodeBlocks?: boolean;
+}): string;
 /**
  * Download an article to Markdown with optional image localization.
  *

package/dist/src/download/article-download.js

@@ -11,12 +11,29 @@ import TurndownService from 'turndown';
 import { gfm } from 'turndown-plugin-gfm';
 import { httpDownload, sanitizeFilename } from './index.js';
 import { formatBytes } from './progress.js';
+export { extractWechatArticleHtml } from './wechat-article.js';
 const IMAGE_CONCURRENCY = 5;
 const DEFAULT_LABELS = {
     author: '作者',
     publishTime: '发布时间',
     sourceUrl: '原文链接',
 };
+function escapeMarkdownText(value) {
+    return value.replace(/\s+/g, ' ').trim()
+        .replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;').replace(/'/g, '&#39;')
+        .replace(/([\\`*_[\]{}()#+.!|>~-])/g, '\\$1');
+}
+function safeHttpUrl(value) {
+    const normalized = value.trim().startsWith('//') ? `https:${value.trim()}` : value.trim();
+    try {
+        const url = new URL(normalized);
+        return url.protocol === 'http:' || url.protocol === 'https:' ? url.href : '';
+    }
+    catch {
+        return '';
+    }
+}
 // ============================================================
 // Markdown Conversion
 // ============================================================
@@ -36,13 +53,48 @@ const STRIPPED_TAGS = [
     'form', 'button', 'dialog',
     'header', 'footer', 'nav', 'aside',
 ];
-function createTurndown(configure, cleanSelectors) {
+function createTurndown(configure, cleanSelectors, secureMarkdown = false) {
     const td = new TurndownService({
         headingStyle: 'atx',
         codeBlockStyle: 'fenced',
         bulletListMarker: '-',
     });
     td.use(gfm);
+    if (secureMarkdown) {
+        const escapeDestination = (value) => value.replace(/([\\()])/g, '\\$1');
+        td.addRule('safeFencedCodeBlock', {
+            filter: 'pre',
+            replacement: (_content, node) => {
+                const element = node;
+                const code = element.textContent || '';
+                const longest = Math.max(0, ...[...code.matchAll(/`+/g)].map(match => match[0].length));
+                const fence = '`'.repeat(Math.max(3, longest + 1));
+                const className = element.querySelector('code')?.getAttribute('class') || '';
+                const language = element.getAttribute('data-lang')
+                    || /(?:^|\s)language-([^\s]+)/.exec(className)?.[1]
+                    || '';
+                return `\n${fence}${language}\n${code.replace(/\n$/, '')}\n${fence}\n`;
+            },
+        });
+        td.addRule('safeImage', {
+            filter: 'img',
+            replacement: (_content, node) => {
+                const element = node;
+                const alt = escapeMarkdownText(element.getAttribute('alt') || '');
+                const src = element.getAttribute('src') || '';
+                return src ? `![${alt}](${escapeDestination(src)})` : alt;
+            },
+        });
+        td.addRule('safeLink', {
+            filter: 'a',
+            replacement: (_content, node) => {
+                const element = node;
+                const label = escapeMarkdownText(element.textContent || '');
+                const href = element.getAttribute('href') || '';
+                return href ? `[${label}](${escapeDestination(href)})` : label;
+            },
+        });
+    }
     td.remove(STRIPPED_TAGS);
     // turndown-plugin-gfm@1.0.2 emits single-tilde strikethrough (`~x~`), which
     // is not the canonical GFM form. Override it so exported markdown is
@@ -104,11 +156,14 @@ function createTurndown(configure, cleanSelectors) {
         filter: (node) => node.nodeName === 'IFRAME',
         replacement: (_content, node) => {
             const el = node;
-            const src = el.getAttribute('src') || '';
+            const rawSrc = el.getAttribute('src') || '';
+            const src = secureMarkdown ? safeHttpUrl(rawSrc) : rawSrc;
             if (!src)
                 return '';
-            const title = el.getAttribute('title') || 'Embedded content';
-            return `\n[${title}](${src})\n`;
+            const rawTitle = el.getAttribute('title') || 'Embedded content';
+            const title = secureMarkdown ? escapeMarkdownText(rawTitle) : rawTitle;
+            const destination = secureMarkdown ? src.replace(/([\\()])/g, '\\$1') : src;
+            return `\n[${title}](${destination})\n`;
         },
     });
     // Per-adapter dirty-node removal. Adapters know their site's specific noise
@@ -139,14 +194,16 @@ function createTurndown(configure, cleanSelectors) {
         configure(td);
     return td;
 }
-function convertToMarkdown(contentHtml, codeBlocks, configure, cleanSelectors) {
-    const td = createTurndown(configure, cleanSelectors);
+function convertToMarkdown(contentHtml, codeBlocks, configure, cleanSelectors, secureMarkdown = false) {
+    const td = createTurndown(configure, cleanSelectors, secureMarkdown);
     let md = td.turndown(contentHtml);
-    // Restore code block placeholders
-    codeBlocks.forEach((block, i) => {
-        const placeholder = `CODEBLOCK-PLACEHOLDER-${i}`;
-        const fenced = `\n\`\`\`${block.lang}\n${block.code}\n\`\`\`\n`;
-        md = md.replace(placeholder, fenced);
+    // Legacy callers may still supply extracted blocks. New callers preserve
+    // real <pre>/<code> nodes so Turndown owns fencing without collision-prone
+    // magic text; legacy blocks are appended with safe dynamic fences.
+    codeBlocks.forEach((block) => {
+        const longest = Math.max(0, ...[...block.code.matchAll(/`+/g)].map(match => match[0].length));
+        const fence = '`'.repeat(Math.max(3, longest + 1));
+        md += `\n\n${fence}${block.lang}\n${block.code}\n${fence}`;
     });
     // Clean up
     md = md.replace(/\u00a0/g, ' ');
@@ -158,6 +215,9 @@ function convertToMarkdown(contentHtml, codeBlocks, configure, cleanSelectors) {
     md = md.replace(/\n{3,}/g, '\n\n');
     return md;
 }
+export function convertArticleHtmlToMarkdown(contentHtml, options = {}) {
+    return convertToMarkdown(contentHtml, [], undefined, undefined, options.safeFencedCodeBlocks === true);
+}
 function replaceImageUrls(md, urlMap) {
     return md.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, (match, alt, imgUrl) => {
         const local = urlMap[imgUrl];
@@ -230,7 +290,7 @@ async function downloadImages(imgUrls, imgDir, headers, detectExt) {
  * 6. File write
  */
 export async function downloadArticle(data, options) {
-    const { output, downloadImages: shouldDownloadImages = true, imageHeaders, maxTitleLength = 80, configureTurndown, detectImageExt, frontmatterLabels, cleanSelectors, stdout = false, } = options;
+    const { output, downloadImages: shouldDownloadImages = true, imageHeaders, maxTitleLength = 80, configureTurndown, detectImageExt, frontmatterLabels, cleanSelectors, stdout = false, secureMarkdown = false, } = options;
     const labels = { ...DEFAULT_LABELS, ...frontmatterLabels };
     if (!data.title) {
         return [{
@@ -253,7 +313,7 @@ export async function downloadArticle(data, options) {
             }];
     }
     // Convert HTML to Markdown
-    let markdown = convertToMarkdown(data.contentHtml, data.codeBlocks || [], configureTurndown, cleanSelectors);
+    let markdown = convertToMarkdown(data.contentHtml, data.codeBlocks || [], configureTurndown, cleanSelectors, secureMarkdown);
     const safeTitle = sanitizeFilename(data.title, maxTitleLength);
     // Download images only when writing to disk. In stdout mode remote URLs
     // stay intact so the piped output is self-contained.
@@ -268,13 +328,14 @@ export async function downloadArticle(data, options) {
     // Build frontmatter with customizable labels.
     // Shape: `# Title\n[> meta\n...]\n---\n\n<markdown>` — exactly one blank
     // line separates every section, so we never produce ≥3 consecutive newlines.
-    const headerLines = [`# ${data.title}`];
+    const headerValue = (value) => secureMarkdown ? escapeMarkdownText(value) : value;
+    const headerLines = [`# ${headerValue(data.title)}`];
     if (data.author)
-        headerLines.push(`> ${labels.author}: ${data.author}`);
+        headerLines.push(`> ${labels.author}: ${headerValue(data.author)}`);
     if (data.publishTime)
-        headerLines.push(`> ${labels.publishTime}: ${data.publishTime}`);
+        headerLines.push(`> ${labels.publishTime}: ${headerValue(data.publishTime)}`);
     if (data.sourceUrl)
-        headerLines.push(`> ${labels.sourceUrl}: ${data.sourceUrl}`);
+        headerLines.push(`> ${labels.sourceUrl}: ${headerValue(data.sourceUrl)}`);
     const frontmatter = headerLines.join('\n') + '\n\n---\n\n';
     const fullContent = frontmatter + markdown;
     const size = Buffer.byteLength(fullContent, 'utf-8');

package/dist/src/download/wechat-article.d.ts

@@ -0,0 +1,8 @@
+export declare const MAX_WECHAT_HTML_BYTES: number;
+export declare const MAX_WECHAT_NODES = 100000;
+export declare const MAX_WECHAT_CODE_BLOCKS = 1000;
+export interface ExtractedWechatArticle {
+    contentHtml: string;
+    imageUrls: string[];
+}
+export declare function extractWechatArticleHtml(html: string): ExtractedWechatArticle;

package/dist/src/download/wechat-article.js

@@ -0,0 +1,137 @@
+import { parse, serialize } from 'parse5';
+import { CommandExecutionError } from '../errors.js';
+export const MAX_WECHAT_HTML_BYTES = 10 * 1024 * 1024;
+export const MAX_WECHAT_NODES = 100_000;
+export const MAX_WECHAT_CODE_BLOCKS = 1_000;
+function isElement(node) {
+    return 'tagName' in node;
+}
+function attr(node, name) {
+    return node.attrs.find(item => item.name === name)?.value;
+}
+function hasClass(node, name) {
+    return (attr(node, 'class') || '').split(/\s+/).includes(name);
+}
+function safeUrl(value) {
+    const normalized = value.trim().startsWith('//') ? `https:${value.trim()}` : value.trim();
+    try {
+        const url = new URL(normalized);
+        return url.protocol === 'http:' || url.protocol === 'https:' ? url.href : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function textContent(node) {
+    if ('value' in node)
+        return node.value;
+    if (!('childNodes' in node))
+        return '';
+    return node.childNodes.map(textContent).join('');
+}
+export function extractWechatArticleHtml(html) {
+    if (Buffer.byteLength(html, 'utf8') > MAX_WECHAT_HTML_BYTES) {
+        throw new CommandExecutionError('WeChat article HTML exceeds the 10 MiB limit');
+    }
+    const document = parse(html);
+    let content;
+    let nodes = 0;
+    let codeBlocks = 0;
+    const stack = [document];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        nodes += 1;
+        if (nodes > MAX_WECHAT_NODES)
+            throw new CommandExecutionError('WeChat article HTML exceeds the DOM node limit');
+        if (isElement(node)) {
+            if (attr(node, 'id') === 'js_content')
+                content = node;
+            if (node.tagName === 'pre') {
+                codeBlocks += 1;
+                if (codeBlocks > MAX_WECHAT_CODE_BLOCKS)
+                    throw new CommandExecutionError('WeChat article HTML exceeds the code block limit');
+            }
+        }
+        if ('childNodes' in node) {
+            for (let i = node.childNodes.length - 1; i >= 0; i -= 1)
+                stack.push(node.childNodes[i]);
+        }
+    }
+    if (!content)
+        throw new CommandExecutionError('WeChat article has no #js_content');
+    const parents = [content];
+    while (parents.length > 0) {
+        const parent = parents.pop();
+        parent.childNodes = parent.childNodes.filter(node => {
+            if (!isElement(node))
+                return true;
+            return !['script', 'style'].includes(node.tagName)
+                && !hasClass(node, 'qr_code_pc') && !hasClass(node, 'reward_area')
+                && !hasClass(node, 'code-snippet__line-index');
+        });
+        for (const node of parent.childNodes) {
+            if (isElement(node)) {
+                node.attrs = node.attrs.flatMap(item => {
+                    if (!['href', 'src', 'poster', 'data-src'].includes(item.name))
+                        return [item];
+                    const value = safeUrl(item.value);
+                    return value ? [{ ...item, value }] : [];
+                });
+                if (node.tagName === 'img') {
+                    const lazy = attr(node, 'data-src');
+                    if (lazy) {
+                        node.attrs = node.attrs.filter(item => !['src', 'data-src'].includes(item.name));
+                        node.attrs.push({ name: 'src', value: lazy });
+                    }
+                }
+                if (hasClass(node, 'code-snippet__fix')) {
+                    const descendants = [...node.childNodes].reverse();
+                    let pre;
+                    const lines = [];
+                    while (descendants.length > 0) {
+                        const descendant = descendants.pop();
+                        if (isElement(descendant)) {
+                            if (descendant.tagName === 'pre')
+                                pre = descendant;
+                            if (descendant.tagName === 'code') {
+                                const line = textContent(descendant);
+                                if (!/^[ce]?ounter\(line/.test(line))
+                                    lines.push(line);
+                                continue;
+                            }
+                        }
+                        if ('childNodes' in descendant) {
+                            for (let i = descendant.childNodes.length - 1; i >= 0; i -= 1)
+                                descendants.push(descendant.childNodes[i]);
+                        }
+                    }
+                    if (pre && lines.length > 0) {
+                        pre.childNodes = [{ nodeName: '#text', value: lines.join('\n'), parentNode: pre }];
+                    }
+                }
+                parents.push(node);
+            }
+        }
+    }
+    const imageUrls = [];
+    const seenImages = new Set();
+    const imageStack = [content];
+    while (imageStack.length > 0) {
+        const node = imageStack.pop();
+        if (isElement(node) && node.tagName === 'img') {
+            const src = attr(node, 'src');
+            if (src && !seenImages.has(src)) {
+                seenImages.add(src);
+                imageUrls.push(src);
+            }
+        }
+        if ('childNodes' in node) {
+            for (let i = node.childNodes.length - 1; i >= 0; i -= 1)
+                imageStack.push(node.childNodes[i]);
+        }
+    }
+    const fragment = {
+        nodeName: '#document-fragment', childNodes: content.childNodes,
+    };
+    return { contentHtml: serialize(fragment), imageUrls };
+}

package/dist/src/download/wechat-article.test.d.ts

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

package/dist/src/execution.d.ts

@@ -11,6 +11,9 @@
  */
 import { type CliCommand, type Arg, type CommandArgs } from './registry.js';
 import { type ObservationExportResult } from './observation/index.js';
+/** Internal test-only reset. Never use this to recover a production process. */
+export declare function _resetLazyModuleStateForTests(): void;
+export declare function _getLazyModuleFingerprintReadCountForTests(): number;
 export declare function coerceAndValidateArgs(cmdArgs: Arg[], kwargs: CommandArgs): CommandArgs;
 export declare function executeCommand(cmd: CliCommand, rawKwargs: CommandArgs, debug?: boolean, opts?: {
     prepared?: boolean;
@@ -22,3 +25,5 @@ export declare function executeCommand(cmd: CliCommand, rawKwargs: CommandArgs,
     onTraceExport?: (trace: ObservationExportResult) => void;
 }): Promise<unknown>;
 export declare function prepareCommandArgs(cmd: CliCommand, rawKwargs: CommandArgs): CommandArgs;
+/** Prepare adapter arguments using the execution boundary's public error contract. */
+export declare function prepareCommandArgsOrThrowArgumentError(cmd: CliCommand, rawKwargs: CommandArgs): CommandArgs;