@tiny-fish/cli 0.40.1-next.317 → 0.41.1-next.321

package/dist/index.js

@@ -1,8 +1,13 @@
 #!/usr/bin/env node
 import { buildProgram } from './program.js';
-const { program } = buildProgram();
 // Await parseAsync so async command handlers complete before the process exits
-program.parseAsync(process.argv).catch((e) => {
+buildProgram()
+    .then(({ program }) => program.parseAsync(process.argv))
+    .catch((e) => {
     process.stderr.write(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }) + '\n');
+    // A failed command import reads as a bare message; the stack names the module.
+    if (process.env['TINYFISH_DEBUG'] && e instanceof Error && e.stack) {
+        process.stderr.write(e.stack + '\n');
+    }
     process.exit(1);
 });

package/dist/lib/client.d.ts

@@ -30,6 +30,10 @@ declare const cliFetchResponseSchema: z.ZodObject<{
         last_modified: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         format: z.ZodLiteral<"markdown">;
         text: z.ZodNullable<z.ZodString>;
+        highlights: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            rank: z.ZodInt;
+        }, z.core.$strip>>>>;
     }, z.core.$strip>, z.ZodObject<{
         url: z.ZodString;
         final_url: z.ZodNullable<z.ZodString>;

package/dist/lib/hermes-env.d.ts

@@ -4,6 +4,8 @@ export type HermesHomeReason = 'timeout' | 'exit' | 'no_line' | 'relative';
 export interface HermesHomeFailure {
     reason: HermesHomeReason;
 }
+/** Tests share one process; the resolver result must not. */
+export declare function resetHermesHomeCache(): void;
 /** Asking Hermes beats reimplementing its profile override, which we'd drift from. */
 export declare function resolveHermesHome(): string | HermesHomeFailure;
 export declare const HERMES_KEY_VAR = "MCP_TINYFISH_API_KEY";

package/dist/lib/hermes-env.js

@@ -7,8 +7,24 @@ import { HARNESS_PROBE_TIMEOUT_MS } from './constants.js';
 import { sanitizeLine } from './output.js';
 // display_hermes_home() abbreviates under $HOME, so the value is not always absolute.
 const HERMES_HOME_LINE = /^\s*hermes_home:\s*(\S.*?)\s*$/m;
+// Cached: `hermes dump` starts Python, and doctor asks repeatedly.
+let cachedHermesHome;
+/** Tests share one process; the resolver result must not. */
+export function resetHermesHomeCache() {
+    cachedHermesHome = undefined;
+}
 /** Asking Hermes beats reimplementing its profile override, which we'd drift from. */
 export function resolveHermesHome() {
+    if (cachedHermesHome)
+        return cachedHermesHome.value;
+    const value = probeHermesHome();
+    // A timeout is load-dependent; caching it would sink a run a retry still saves.
+    if (typeof value === 'string' || value.reason !== 'timeout') {
+        cachedHermesHome = { value };
+    }
+    return value;
+}
+function probeHermesHome() {
     const result = spawn.sync('hermes', ['dump'], {
         encoding: 'utf8',
         env: { ...process.env, FORCE_COLOR: '0', NO_COLOR: '1' },

package/dist/program.d.ts

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 /** Split from index.ts so tests can drive the real program instead of hand-assembling one. */
-export declare function buildProgram(): {
+export declare function buildProgram(argv?: string[]): Promise<{
     program: Command;
     uninstallNotice: () => void;
-};
+}>;

package/dist/program.js

@@ -1,28 +1,55 @@
 import { Command } from 'commander';
 import { CLI_VERSION } from './lib/constants.js';
-import { registerAuth } from './commands/auth.js';
-import { registerBatch } from './commands/batch.js';
-import { registerFetch } from './commands/fetch.js';
-import { registerBrowser } from './commands/browser.js';
-import { registerProfile } from './commands/profile.js';
-import { registerVault } from './commands/vault.js';
-import { registerWallet } from './commands/wallet.js';
-import { registerRun } from './commands/run.js';
-import { registerRuns } from './commands/runs.js';
-import { registerConfigureClaude } from './commands/config-claude.js';
-import { registerSearch } from './commands/search.js';
-import { registerConnect } from './commands/connect.js';
-import { registerDoctor } from './commands/doctor.js';
-import { registerUpgrade } from './commands/upgrade.js';
-import { registerOnboard } from './commands/onboard.js';
 import { installNoticeEmit } from './lib/notice.js';
+// Loaded on demand: static imports pull zod, yaml, which, cross-spawn always.
+const GROUPS = {
+    auth: async (p) => (await import('./commands/auth.js')).registerAuth(p),
+    onboard: async (p) => (await import('./commands/onboard.js')).registerOnboard(p),
+    connect: async (p) => (await import('./commands/connect.js')).registerConnect(p),
+    doctor: async (p) => (await import('./commands/doctor.js')).registerDoctor(p),
+    upgrade: async (p) => (await import('./commands/upgrade.js')).registerUpgrade(p),
+    'config-claude': async (p) => (await import('./commands/config-claude.js')).registerConfigureClaude(p),
+    browser: async (p) => (await import('./commands/browser.js')).registerBrowser(p),
+    profile: async (p) => (await import('./commands/profile.js')).registerProfile(p),
+    vault: async (p) => (await import('./commands/vault.js')).registerVault(p),
+    wallet: async (p) => (await import('./commands/wallet.js')).registerWallet(p),
+    agent: async (p) => {
+        const agentCmd = p
+            .command('agent')
+            .description('Agent automation commands')
+            .enablePositionalOptions();
+        // Measured: Promise.all is slower here; ESM loading is CPU-bound.
+        // registerRuns hangs off the `run` command registerRun returns.
+        const runCmd = (await import('./commands/run.js')).registerRun(agentCmd);
+        (await import('./commands/runs.js')).registerRuns(runCmd);
+        (await import('./commands/batch.js')).registerBatch(agentCmd);
+    },
+    search: async (p) => (await import('./commands/search.js')).registerSearch(p),
+    fetch: async (p) => (await import('./commands/fetch.js')).registerFetch(p),
+};
+/** Commander answers these before routing, so no command module is needed. */
+const VERSION_FLAGS = ['-V', '--version'];
+// Unknown names need the full list to suggest against.
+/** First bare token is the command. Assumes no global option takes a value. */
+function groupsFor(argv) {
+    for (const arg of argv.slice(2)) {
+        if (arg === '--')
+            break;
+        if (!arg.startsWith('-')) {
+            return Object.hasOwn(GROUPS, arg) ? [arg] : Object.keys(GROUPS);
+        }
+        if (VERSION_FLAGS.includes(arg))
+            return [];
+    }
+    return Object.keys(GROUPS);
+}
 /** Split from index.ts so tests can drive the real program instead of hand-assembling one. */
-export function buildProgram() {
+export async function buildProgram(argv = process.argv) {
     const program = new Command();
     program
         .name('tinyfish')
         .description('TinyFish CLI — run web automations from your terminal or agent.')
-        .version(CLI_VERSION, '-V, --version', 'Show version')
+        .version(CLI_VERSION, VERSION_FLAGS.join(', '), 'Show version')
         .helpOption('-h, --help', 'Show help')
         .addHelpCommand(false)
         .enablePositionalOptions()
@@ -32,25 +59,10 @@ export function buildProgram() {
             process.env['TINYFISH_DEBUG'] = '1';
         }
     });
-    registerAuth(program);
-    registerOnboard(program);
-    registerConnect(program);
-    registerDoctor(program);
-    registerUpgrade(program);
-    registerConfigureClaude(program);
-    registerBrowser(program);
-    registerProfile(program);
-    registerVault(program);
-    registerWallet(program);
-    const agentCmd = program
-        .command('agent')
-        .description('Agent automation commands')
-        .enablePositionalOptions();
-    const runCmd = registerRun(agentCmd);
-    registerRuns(runCmd);
-    registerBatch(agentCmd);
-    registerSearch(program);
-    registerFetch(program);
+    // Order is user-visible: help lists commands as registered.
+    for (const name of groupsFor(argv)) {
+        await GROUPS[name](program);
+    }
     const uninstallNotice = installNoticeEmit(program);
     return { program, uninstallNotice };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiny-fish/cli",
-  "version": "0.40.1-next.317",
+  "version": "0.41.1-next.321",
   "description": "TinyFish CLI — run web automations from your terminal",
   "type": "module",
   "bin": {
@@ -34,7 +34,7 @@
     "format:check": "oxfmt --check ."
   },
   "dependencies": {
-    "@tiny-fish/sdk": "^0.5.0",
+    "@tiny-fish/sdk": "^0.6.0",
     "commander": "^12.0.0",
     "cross-spawn": "^7.0.6",
     "tldts": "^6.1.86",