@tiny-fish/cli 0.30.2-next.257 → 0.30.2-next.259

package/dist/lib/connect-auth.d.ts

@@ -1,5 +1,5 @@
-import { type AgentClient } from "./connect-runtime.js";
+import { type AgentClient } from './connect-runtime.js';
 export declare const TINYFISH_CLI_NOT_FOUND_MESSAGE = "TinyFish CLI installed but is not available on PATH. Open a new terminal and retry.";
-export declare function ensureCliAuthenticated(source: AgentClient | "cli", apiKey?: string, opts?: {
+export declare function ensureCliAuthenticated(source: AgentClient | 'cli', apiKey?: string, opts?: {
     interactiveLogin?: boolean;
 }): void;

package/dist/lib/connect-auth.js

@@ -1,22 +1,22 @@
-import spawn from "cross-spawn";
-import { TINYFISH_API_KEY_VAR } from "./constants.js";
-import { persistApiKeyToEnvironment, validateKeyFormat, writeConfig } from "./auth.js";
-import { commandNotFound, ConnectStepError, spawnStepError, throwIfInterrupted, NON_INTERACTIVE_TIMEOUT_MS, } from "./connect-runtime.js";
-import { errLine } from "./output.js";
-export const TINYFISH_CLI_NOT_FOUND_MESSAGE = "TinyFish CLI installed but is not available on PATH. Open a new terminal and retry.";
+import spawn from 'cross-spawn';
+import { TINYFISH_API_KEY_VAR } from './constants.js';
+import { persistApiKeyToEnvironment, validateKeyFormat, writeConfig } from './auth.js';
+import { commandNotFound, ConnectStepError, spawnStepError, throwIfInterrupted, NON_INTERACTIVE_TIMEOUT_MS, } from './connect-runtime.js';
+import { errLine } from './output.js';
+export const TINYFISH_CLI_NOT_FOUND_MESSAGE = 'TinyFish CLI installed but is not available on PATH. Open a new terminal and retry.';
 export function ensureCliAuthenticated(source, apiKey, opts) {
     const envKey = apiKey ?? process.env[TINYFISH_API_KEY_VAR];
     if (envKey) {
         if (!validateKeyFormat(envKey)) {
-            throw new ConnectStepError("TINYFISH_API_KEY has invalid format", "invalid_config");
+            throw new ConnectStepError('TINYFISH_API_KEY has invalid format', 'invalid_config');
         }
         // Throwing variant: a write failure must reach connect's catch/flush, not exit(1) past it.
         writeConfig(envKey);
         persistApiKeyToEnvironment(envKey);
         return;
     }
-    const authStatus = spawn.sync("tinyfish", ["auth", "status"], {
-        stdio: "ignore",
+    const authStatus = spawn.sync('tinyfish', ['auth', 'status'], {
+        stdio: 'ignore',
         timeout: NON_INTERACTIVE_TIMEOUT_MS,
     });
     if (commandNotFound(authStatus.error)) {
@@ -28,19 +28,19 @@ export function ensureCliAuthenticated(source, apiKey, opts) {
     // "not signed in" and drop the user into an interactive login they never asked for.
     throwIfInterrupted(authStatus);
     if (authStatus.error) {
-        throw spawnStepError("Could not read TinyFish CLI auth status", authStatus);
+        throw spawnStepError('Could not read TinyFish CLI auth status', authStatus);
     }
     if (opts?.interactiveLogin === false) {
-        throw new Error("The TinyFish CLI is not signed in. Run: tinyfish auth login");
+        throw new Error('The TinyFish CLI is not signed in. Run: tinyfish auth login');
     }
-    errLine("Signing in to the TinyFish CLI...");
-    const loginResult = spawn.sync("tinyfish", ["auth", "login", "--source", source], {
-        stdio: "inherit",
+    errLine('Signing in to the TinyFish CLI...');
+    const loginResult = spawn.sync('tinyfish', ['auth', 'login', '--source', source], {
+        stdio: 'inherit',
     });
     if (commandNotFound(loginResult.error)) {
         throw spawnStepError(TINYFISH_CLI_NOT_FOUND_MESSAGE, loginResult);
     }
     if (loginResult.error || loginResult.status !== 0) {
-        throw spawnStepError("Could not authenticate the TinyFish CLI", loginResult);
+        throw spawnStepError('Could not authenticate the TinyFish CLI', loginResult);
     }
 }

package/dist/lib/connect-clients.d.ts

@@ -1,6 +1,6 @@
-import spawn from "cross-spawn";
-import { type Harness } from "./harness-detect.js";
-import { type AgentClient, type SupportedCommand } from "./connect-runtime.js";
+import spawn from 'cross-spawn';
+import { type Harness } from './harness-detect.js';
+import { type AgentClient, type SupportedCommand } from './connect-runtime.js';
 export declare const OPENCLAW_SKILL_INSTALL_ARGS: readonly string[];
 /** `openclaw skills` has no uninstall; ClawHub removes from the global dir. */
 export declare function openclawSkillUninstall(): {
@@ -12,14 +12,14 @@ export declare function openclawSkillUninstall(): {
 export declare const DEFAULT_ONBOARDING_PROMPT: string;
 export declare const OPENCLAW_ONBOARDING_PROMPT: string;
 /** The `skills` CLI's own agent names — not ours, and not every harness has one. */
-export type SkillAgent = "claude-code" | "codex" | "cursor" | "hermes-agent" | "opencode";
+export type SkillAgent = 'claude-code' | 'codex' | 'cursor' | 'hermes-agent' | 'opencode';
 /** Cursor writes its own MCP config, so it has no descriptor to carry this. */
 export declare const CURSOR_SKILL_TARGET: {
     readonly skillAgent: "cursor";
     readonly displayName: "Cursor";
 };
 export interface NativeMcpClient extends SupportedCommand {
-    connectClient: Exclude<AgentClient, "openclaw">;
+    connectClient: Exclude<AgentClient, 'openclaw'>;
     /** Omitted where the `skills` CLI has no agent for this harness (Grok ships its own plugin). */
     skillAgent?: SkillAgent;
     /** Capturable: this `mcp add` never runs OAuth inline; unset stays inherited. */
@@ -84,7 +84,7 @@ export interface HarnessCapabilities {
 /** Required booleans: a new harness or new flag fails to compile undecided. */
 export declare const HARNESS_CAPABILITIES: Record<Harness, HarnessCapabilities>;
 /** "printed" = handed to the user to paste; the walkthrough was never started for them. */
-export type WalkthroughOutcome = "launched" | "printed";
+export type WalkthroughOutcome = 'launched' | 'printed';
 /** Awaited before the handover; track+flush must land pre-block. */
 type OnWalkthroughDecided = (outcome: WalkthroughOutcome) => void | Promise<void>;
 export declare function launchNativeMcpClient(client: NativeMcpClient, onDecided?: OnWalkthroughDecided): Promise<WalkthroughOutcome>;

package/dist/lib/connect-clients.js

@@ -1,136 +1,136 @@
-import spawn from "cross-spawn";
-import { SKILL_INSTALL_TIMEOUT_MS } from "./cli-install.js";
-import { detectHumanInitiated } from "./harness.js";
-import { harnessConfigPath } from "./harness-detect.js";
-import { errLine, sanitizeLine } from "./output.js";
-import { spawnStepError, } from "./connect-runtime.js";
-import { TINYFISH_API_KEY_VAR } from "./constants.js";
+import spawn from 'cross-spawn';
+import { SKILL_INSTALL_TIMEOUT_MS } from './cli-install.js';
+import { detectHumanInitiated } from './harness.js';
+import { harnessConfigPath } from './harness-detect.js';
+import { errLine, sanitizeLine } from './output.js';
+import { spawnStepError } from './connect-runtime.js';
+import { TINYFISH_API_KEY_VAR } from './constants.js';
 const HERMES_SEED_TIMEOUT_MS = 120_000;
 // An old install is only one reason a flag can go unseen, so no message asserts the cause.
-const SUPPORT_CHECK_DEBUG_HINT = " Set TINYFISH_DEBUG=1 and retry to print the help output TinyFish read.";
-const MCP_ADD_UNAVAILABLE_MESSAGE = "Could not confirm this Claude Code installation exposes `claude mcp add`: `claude mcp " +
-    "--help` did not list it. Update Claude Code with `claude update` and retry." +
+const SUPPORT_CHECK_DEBUG_HINT = ' Set TINYFISH_DEBUG=1 and retry to print the help output TinyFish read.';
+const MCP_ADD_UNAVAILABLE_MESSAGE = 'Could not confirm this Claude Code installation exposes `claude mcp add`: `claude mcp ' +
+    '--help` did not list it. Update Claude Code with `claude update` and retry.' +
     SUPPORT_CHECK_DEBUG_HINT;
 // `claude mcp login` only exists upstream from Claude Code 2.1.186; older installs still register.
-const CLAUDE_CODE_KEYED_FALLBACK_NOTE = "Using your stored TinyFish API key: this Claude Code predates one-command sign-in " +
-    "(`claude mcp login`), so no browser sign-in is needed.";
-const CLAUDE_CODE_DEFERRED_AUTH_NOTE = "TinyFish is registered in Claude Code but not signed in: this Claude Code predates " +
-    "one-command sign-in (`claude mcp login`). Open Claude Code and run `/mcp` to sign in to " +
-    "TinyFish. `claude update` gets you one-command sign-in. Already have a TinyFish API key? " +
-    "Run `tinyfish connect claude-code --api-key <key>` instead.";
-const CODEX_OAUTH_RESOURCE_UNAVAILABLE_MESSAGE = "Could not confirm this Codex installation supports one-command MCP authentication: `codex " +
-    "mcp add --help` did not list `--oauth-resource`. Update Codex and retry, or add TinyFish " +
-    "manually with `codex mcp add`." +
+const CLAUDE_CODE_KEYED_FALLBACK_NOTE = 'Using your stored TinyFish API key: this Claude Code predates one-command sign-in ' +
+    '(`claude mcp login`), so no browser sign-in is needed.';
+const CLAUDE_CODE_DEFERRED_AUTH_NOTE = 'TinyFish is registered in Claude Code but not signed in: this Claude Code predates ' +
+    'one-command sign-in (`claude mcp login`). Open Claude Code and run `/mcp` to sign in to ' +
+    'TinyFish. `claude update` gets you one-command sign-in. Already have a TinyFish API key? ' +
+    'Run `tinyfish connect claude-code --api-key <key>` instead.';
+const CODEX_OAUTH_RESOURCE_UNAVAILABLE_MESSAGE = 'Could not confirm this Codex installation supports one-command MCP authentication: `codex ' +
+    'mcp add --help` did not list `--oauth-resource`. Update Codex and retry, or add TinyFish ' +
+    'manually with `codex mcp add`.' +
     SUPPORT_CHECK_DEBUG_HINT;
-const HERMES_OAUTH_UNAVAILABLE_MESSAGE = "Could not confirm this Hermes installation supports one-command MCP authentication: `hermes " +
-    "mcp add --help` did not list `--auth oauth`. Update Hermes and retry, or add TinyFish " +
-    "manually with `hermes mcp add`." +
+const HERMES_OAUTH_UNAVAILABLE_MESSAGE = 'Could not confirm this Hermes installation supports one-command MCP authentication: `hermes ' +
+    'mcp add --help` did not list `--auth oauth`. Update Hermes and retry, or add TinyFish ' +
+    'manually with `hermes mcp add`.' +
     SUPPORT_CHECK_DEBUG_HINT;
-const GROK_HTTP_UNAVAILABLE_MESSAGE = "Could not confirm this Grok installation supports remote MCP servers: `grok mcp add --help` " +
-    "did not list `--transport`. Update Grok and retry, or add TinyFish manually with " +
-    "`grok mcp add`." +
+const GROK_HTTP_UNAVAILABLE_MESSAGE = 'Could not confirm this Grok installation supports remote MCP servers: `grok mcp add --help` ' +
+    'did not list `--transport`. Update Grok and retry, or add TinyFish manually with ' +
+    '`grok mcp add`.' +
     SUPPORT_CHECK_DEBUG_HINT;
 // Grok has no `mcp login`; sign-in only happens inside the TUI. No key nudge here: a revoked
 // key leaves Grok with no OAuth fallback, and doctor cannot spot that yet (PF-3618).
-const GROK_SIGN_IN_HINT = "TinyFish is registered in Grok. Open Grok, run `/mcps`, select tinyfish, and press `i` to " +
-    "sign in.";
-const OPENCLAW_SKILL_UNAVAILABLE_MESSAGE = "Could not confirm this OpenClaw installation supports global skill installation: `openclaw " +
-    "skills install --help` did not list `--global` and `--acknowledge-clawhub-risk`. Update " +
-    "OpenClaw and retry, or install manually with `openclaw skills install @tinyfish/tinyfish " +
-    "--global --acknowledge-clawhub-risk`." +
+const GROK_SIGN_IN_HINT = 'TinyFish is registered in Grok. Open Grok, run `/mcps`, select tinyfish, and press `i` to ' +
+    'sign in.';
+const OPENCLAW_SKILL_UNAVAILABLE_MESSAGE = 'Could not confirm this OpenClaw installation supports global skill installation: `openclaw ' +
+    'skills install --help` did not list `--global` and `--acknowledge-clawhub-risk`. Update ' +
+    'OpenClaw and retry, or install manually with `openclaw skills install @tinyfish/tinyfish ' +
+    '--global --acknowledge-clawhub-risk`.' +
     SUPPORT_CHECK_DEBUG_HINT;
-const OPENCODE_MCP_ADD_UNAVAILABLE_MESSAGE = "Could not confirm this OpenCode installation supports one-command MCP setup: `opencode mcp " +
-    "add --help` did not list `--url`. Update OpenCode and retry, or add TinyFish manually with " +
-    "`opencode mcp add`." +
+const OPENCODE_MCP_ADD_UNAVAILABLE_MESSAGE = 'Could not confirm this OpenCode installation supports one-command MCP setup: `opencode mcp ' +
+    'add --help` did not list `--url`. Update OpenCode and retry, or add TinyFish manually with ' +
+    '`opencode mcp add`.' +
     SUPPORT_CHECK_DEBUG_HINT;
 // OpenCode is model-agnostic (unlike Claude Code / Codex), so a fresh install can default to a
 // model with no tool support — TinyFish runs entirely on tool calls, so it would fail there.
-const OPENCODE_MODEL_NOTE = "Note: TinyFish runs on tool calls, so OpenCode needs a model that supports tool use. Image-only " +
+const OPENCODE_MODEL_NOTE = 'Note: TinyFish runs on tool calls, so OpenCode needs a model that supports tool use. Image-only ' +
     'models (e.g. Nano Banana Pro) will show "No endpoints found that support tool use" — switch ' +
     "OpenCode's model if the walkthrough can't start.";
-const OPENCLAW_SKILL = "@tinyfish/tinyfish";
+const OPENCLAW_SKILL = '@tinyfish/tinyfish';
 // --force makes this an unconditional overwrite, so the same call installs and refreshes.
 export const OPENCLAW_SKILL_INSTALL_ARGS = [
-    "skills",
-    "install",
+    'skills',
+    'install',
     OPENCLAW_SKILL,
-    "--global",
-    "--force",
-    "--acknowledge-clawhub-risk",
+    '--global',
+    '--force',
+    '--acknowledge-clawhub-risk',
 ];
 /** `openclaw skills` has no uninstall; ClawHub removes from the global dir. */
 export function openclawSkillUninstall() {
     return {
-        command: "npx",
+        command: 'npx',
         args: [
-            "-y",
+            '-y',
             // Pinned: npx would otherwise execute whatever is newest at run time.
-            "clawhub@0.23.3",
-            "--workdir",
-            harnessConfigPath("openclaw"),
-            "uninstall",
+            'clawhub@0.23.3',
+            '--workdir',
+            harnessConfigPath('openclaw'),
+            'uninstall',
             OPENCLAW_SKILL,
-            "--yes",
+            '--yes',
         ],
         timeoutMs: SKILL_INSTALL_TIMEOUT_MS,
     };
 }
-export const DEFAULT_ONBOARDING_PROMPT = "I just connected TinyFish. Use the MCP server named `tinyfish` for every TinyFish tool call; " +
-    "if another TinyFish server is also registered, still use `tinyfish` and do not ask me which. " +
-    "Start by asking me what I want to look up on the web, and wait for my reply. Then call " +
-    "`guide_next_step` and follow its instructions one step at a time, asking for my input and " +
-    "waiting for my reply before each subsequent TinyFish tool call. If a tool call comes back " +
-    "blocked or not approved, tell me which tool needs approval and how to grant it, then wait for " +
-    "me instead of ending the walkthrough.";
-export const OPENCLAW_ONBOARDING_PROMPT = "I just installed the TinyFish skill. Guide me through it interactively: first ask what topic I " +
-    "want to search and wait for my reply before using TinyFish Search. Show me the results, ask " +
-    "which result I want to read, and wait before using TinyFish Fetch. Then ask what browser task " +
-    "I want to complete and wait before using TinyFish Agent. Never skip ahead or choose for me.";
+export const DEFAULT_ONBOARDING_PROMPT = 'I just connected TinyFish. Use the MCP server named `tinyfish` for every TinyFish tool call; ' +
+    'if another TinyFish server is also registered, still use `tinyfish` and do not ask me which. ' +
+    'Start by asking me what I want to look up on the web, and wait for my reply. Then call ' +
+    '`guide_next_step` and follow its instructions one step at a time, asking for my input and ' +
+    'waiting for my reply before each subsequent TinyFish tool call. If a tool call comes back ' +
+    'blocked or not approved, tell me which tool needs approval and how to grant it, then wait for ' +
+    'me instead of ending the walkthrough.';
+export const OPENCLAW_ONBOARDING_PROMPT = 'I just installed the TinyFish skill. Guide me through it interactively: first ask what topic I ' +
+    'want to search and wait for my reply before using TinyFish Search. Show me the results, ask ' +
+    'which result I want to read, and wait before using TinyFish Fetch. Then ask what browser task ' +
+    'I want to complete and wait before using TinyFish Agent. Never skip ahead or choose for me.';
 /** Cursor writes its own MCP config, so it has no descriptor to carry this. */
-export const CURSOR_SKILL_TARGET = { skillAgent: "cursor", displayName: "Cursor" };
+export const CURSOR_SKILL_TARGET = { skillAgent: 'cursor', displayName: 'Cursor' };
 const HEADER_FLAG = /(?:^|\s)--header(?:[\s<=]|$)/m;
 const claudeAddArgs = (mcpUrl) => [
-    "mcp",
-    "add",
-    "--scope",
-    "user",
-    "--transport",
-    "http",
-    "tinyfish",
+    'mcp',
+    'add',
+    '--scope',
+    'user',
+    '--transport',
+    'http',
+    'tinyfish',
     mcpUrl,
 ];
-const urlAddArgs = (mcpUrl) => ["mcp", "add", "tinyfish", "--url", mcpUrl];
+const urlAddArgs = (mcpUrl) => ['mcp', 'add', 'tinyfish', '--url', mcpUrl];
 // OpenCode takes `--header NAME=VALUE`, not Claude Code's `NAME: VALUE`.
 const headerKeyAuth = {
-    addArgs: (mcpUrl, apiKey) => [...urlAddArgs(mcpUrl), "--header", `X-API-Key=${apiKey}`],
+    addArgs: (mcpUrl, apiKey) => [...urlAddArgs(mcpUrl), '--header', `X-API-Key=${apiKey}`],
 };
 export const CLAUDE_CODE = {
-    command: "claude",
-    connectClient: "claude-code",
-    skillAgent: "claude-code",
+    command: 'claude',
+    connectClient: 'claude-code',
+    skillAgent: 'claude-code',
     nonInteractiveAdd: true,
-    displayName: "Claude Code",
+    displayName: 'Claude Code',
     supportCheck: {
-        args: ["mcp", "--help"],
+        args: ['mcp', '--help'],
         patterns: [/^\s*add(?:\s|\[)/m],
         optionalPatterns: [/^\s*login(?:\s|\[)/m],
         keyAuthPattern: HEADER_FLAG,
         unavailableMessage: MCP_ADD_UNAVAILABLE_MESSAGE,
     },
     keyAuth: {
-        addArgs: (mcpUrl, apiKey) => [...claudeAddArgs(mcpUrl), "--header", `X-API-Key: ${apiKey}`],
+        addArgs: (mcpUrl, apiKey) => [...claudeAddArgs(mcpUrl), '--header', `X-API-Key: ${apiKey}`],
     },
-    loginArgs: ["mcp", "login", "tinyfish"],
+    loginArgs: ['mcp', 'login', 'tinyfish'],
     degradedAuthNotes: {
         keyed: CLAUDE_CODE_KEYED_FALLBACK_NOTE,
         deferred: CLAUDE_CODE_DEFERRED_AUTH_NOTE,
     },
     // Project scope is shared in .mcp.json; a user setup command must not rewrite it.
     removals: [
-        { args: ["mcp", "remove", "tinyfish", "--scope", "user"], label: "user TinyFish registration" },
+        { args: ['mcp', 'remove', 'tinyfish', '--scope', 'user'], label: 'user TinyFish registration' },
         {
-            args: ["mcp", "remove", "tinyfish", "--scope", "local"],
-            label: "local TinyFish registration",
+            args: ['mcp', 'remove', 'tinyfish', '--scope', 'local'],
+            label: 'local TinyFish registration',
         },
     ],
     addArgs: (mcpUrl) => claudeAddArgs(mcpUrl),
@@ -141,36 +141,36 @@ export const CLAUDE_CODE = {
  * quotes back out. Untested on Windows.
  */
 export function openExternalUrl(url) {
-    if (process.platform === "darwin")
-        return spawn.sync("open", [url], { stdio: "ignore" });
-    if (process.platform === "win32") {
-        return spawn.sync("cmd", ["/c", "start", '""', `"${url}"`], {
-            stdio: "ignore",
+    if (process.platform === 'darwin')
+        return spawn.sync('open', [url], { stdio: 'ignore' });
+    if (process.platform === 'win32') {
+        return spawn.sync('cmd', ['/c', 'start', '""', `"${url}"`], {
+            stdio: 'ignore',
             windowsVerbatimArguments: true,
         });
     }
-    return spawn.sync("xdg-open", [url], { stdio: "ignore" });
+    return spawn.sync('xdg-open', [url], { stdio: 'ignore' });
 }
 function launchCodexWalkthrough() {
-    const deepLink = new URL("codex://new");
-    deepLink.searchParams.set("prompt", DEFAULT_ONBOARDING_PROMPT);
-    deepLink.searchParams.set("path", process.cwd());
+    const deepLink = new URL('codex://new');
+    deepLink.searchParams.set('prompt', DEFAULT_ONBOARDING_PROMPT);
+    deepLink.searchParams.set('path', process.cwd());
     const result = openExternalUrl(deepLink.toString());
     if (result.error || result.status !== 0) {
         // Headless box: nothing can open a window; recover like the gated clients.
-        printPromptForHandoff("Codex", "codex", DEFAULT_ONBOARDING_PROMPT, "Codex could not be opened here (no `codex://` handler)");
-        return "printed";
+        printPromptForHandoff('Codex', 'codex', DEFAULT_ONBOARDING_PROMPT, 'Codex could not be opened here (no `codex://` handler)');
+        return 'printed';
     }
-    errLine("Codex opened with the TinyFish walkthrough ready. Send the prompt to start.");
-    return "launched";
+    errLine('Codex opened with the TinyFish walkthrough ready. Send the prompt to start.');
+    return 'launched';
 }
 export const CODEX = {
-    command: "codex",
-    connectClient: "codex",
-    skillAgent: "codex",
-    displayName: "Codex",
+    command: 'codex',
+    connectClient: 'codex',
+    skillAgent: 'codex',
+    displayName: 'Codex',
     supportCheck: {
-        args: ["mcp", "add", "--help"],
+        args: ['mcp', 'add', '--help'],
         patterns: [/--oauth-resource(?:\s|<)/],
         keyAuthPattern: /(?:^|\s)--bearer-token-env-var(?:[\s<=]|$)/m,
         unavailableMessage: CODEX_OAUTH_RESOURCE_UNAVAILABLE_MESSAGE,
@@ -179,29 +179,29 @@ export const CODEX = {
     // Omitting `--oauth-resource` is what keeps `mcp add` from running OAuth.
     keyAuth: {
         envVar: TINYFISH_API_KEY_VAR,
-        addArgs: (mcpUrl) => [...urlAddArgs(mcpUrl), "--bearer-token-env-var", TINYFISH_API_KEY_VAR],
+        addArgs: (mcpUrl) => [...urlAddArgs(mcpUrl), '--bearer-token-env-var', TINYFISH_API_KEY_VAR],
     },
     detachedLaunch: launchCodexWalkthrough,
     // Retry only: running it after a finished inline OAuth is a second browser hop.
-    loginArgs: ["mcp", "login", "tinyfish"],
-    removals: [{ args: ["mcp", "remove", "tinyfish"], label: "TinyFish registration from Codex" }],
-    addArgs: (mcpUrl, oauthResource) => [...urlAddArgs(mcpUrl), "--oauth-resource", oauthResource],
+    loginArgs: ['mcp', 'login', 'tinyfish'],
+    removals: [{ args: ['mcp', 'remove', 'tinyfish'], label: 'TinyFish registration from Codex' }],
+    addArgs: (mcpUrl, oauthResource) => [...urlAddArgs(mcpUrl), '--oauth-resource', oauthResource],
 };
 const grokAddArgs = (mcpUrl) => [
-    "mcp",
-    "add",
-    "--transport",
-    "http",
-    "tinyfish",
+    'mcp',
+    'add',
+    '--transport',
+    'http',
+    'tinyfish',
     mcpUrl,
 ];
 export const GROK = {
-    command: "grok",
-    connectClient: "grok",
+    command: 'grok',
+    connectClient: 'grok',
     nonInteractiveAdd: true,
-    displayName: "Grok",
+    displayName: 'Grok',
     supportCheck: {
-        args: ["mcp", "add", "--help"],
+        args: ['mcp', 'add', '--help'],
         patterns: [/--transport(?:[\s<=]|$)/m],
         keyAuthPattern: HEADER_FLAG,
         unavailableMessage: GROK_HTTP_UNAVAILABLE_MESSAGE,
@@ -212,67 +212,67 @@ export const GROK = {
         envVar: TINYFISH_API_KEY_VAR,
         addArgs: (mcpUrl) => [
             ...grokAddArgs(mcpUrl),
-            "--header",
+            '--header',
             `Authorization: Bearer \${${TINYFISH_API_KEY_VAR}}`,
         ],
     },
     signInHint: GROK_SIGN_IN_HINT,
-    removals: [{ args: ["mcp", "remove", "tinyfish"], label: "TinyFish registration from Grok" }],
+    removals: [{ args: ['mcp', 'remove', 'tinyfish'], label: 'TinyFish registration from Grok' }],
     addArgs: grokAddArgs,
 };
 // Handover: spawn errors are ours; the exit is the user's.
 function handOverTerminal(command, args, displayName) {
-    const result = spawn.sync(command, args, { stdio: "inherit" });
+    const result = spawn.sync(command, args, { stdio: 'inherit' });
     if (result.error) {
         throw spawnStepError(`Could not launch ${displayName}`, result);
     }
 }
 function launchHermesWalkthrough() {
-    const seedResult = spawn.sync("hermes", ["chat", "-Q", "-q", DEFAULT_ONBOARDING_PROMPT], {
-        encoding: "utf8",
+    const seedResult = spawn.sync('hermes', ['chat', '-Q', '-q', DEFAULT_ONBOARDING_PROMPT], {
+        encoding: 'utf8',
         timeout: HERMES_SEED_TIMEOUT_MS,
     });
     if (seedResult.error || seedResult.status !== 0) {
-        throw spawnStepError("Could not start the TinyFish walkthrough in Hermes", seedResult);
+        throw spawnStepError('Could not start the TinyFish walkthrough in Hermes', seedResult);
     }
     // A colourised id would carry its trailing escape sequence into `--resume` (PF-3452).
-    const sessionId = sanitizeLine(seedResult.stderr ?? "").match(/session_id:\s*([^\s]+)/i)?.[1];
+    const sessionId = sanitizeLine(seedResult.stderr ?? '').match(/session_id:\s*([^\s]+)/i)?.[1];
     if (!sessionId) {
-        throw new Error("Hermes did not return a walkthrough session ID");
+        throw new Error('Hermes did not return a walkthrough session ID');
     }
-    handOverTerminal("hermes", ["--resume", sessionId], "Hermes");
+    handOverTerminal('hermes', ['--resume', sessionId], 'Hermes');
 }
 export const HERMES = {
-    command: "hermes",
-    connectClient: "hermes",
-    skillAgent: "hermes-agent",
-    displayName: "Hermes",
+    command: 'hermes',
+    connectClient: 'hermes',
+    skillAgent: 'hermes-agent',
+    displayName: 'Hermes',
     supportCheck: {
-        args: ["mcp", "add", "--help"],
+        args: ['mcp', 'add', '--help'],
         patterns: [/--auth\s+\{[^}]*oauth[^}]*\}/],
         unavailableMessage: HERMES_OAUTH_UNAVAILABLE_MESSAGE,
     },
     // No `keyAuth`: `hermes mcp add` has no --header, and `--auth header` prompts interactively.
-    removals: [{ args: ["mcp", "remove", "tinyfish"], label: "TinyFish registration from Hermes" }],
+    removals: [{ args: ['mcp', 'remove', 'tinyfish'], label: 'TinyFish registration from Hermes' }],
     // Hermes completes OAuth while adding the server; a separate `mcp login` would authenticate twice.
     oauthInAdd: true,
-    addArgs: (mcpUrl) => [...urlAddArgs(mcpUrl), "--auth", "oauth"],
+    addArgs: (mcpUrl) => [...urlAddArgs(mcpUrl), '--auth', 'oauth'],
     launchWalkthrough: launchHermesWalkthrough,
 };
 // OpenCode's TUI takes a positional as a project directory, so a bare `opencode "<prompt>"`
 // would be read as a folder. The `--prompt` flag seeds the interactive TUI with a first message
 // (opencode.ai/docs/cli), so the onboarding guide fires just like the other agents.
 function launchOpencode() {
-    handOverTerminal("opencode", ["--prompt", DEFAULT_ONBOARDING_PROMPT], "OpenCode");
+    handOverTerminal('opencode', ['--prompt', DEFAULT_ONBOARDING_PROMPT], 'OpenCode');
 }
 export const OPENCODE = {
-    command: "opencode",
-    connectClient: "opencode",
-    skillAgent: "opencode",
+    command: 'opencode',
+    connectClient: 'opencode',
+    skillAgent: 'opencode',
     nonInteractiveAdd: true,
-    displayName: "OpenCode",
+    displayName: 'OpenCode',
     supportCheck: {
-        args: ["mcp", "add", "--help"],
+        args: ['mcp', 'add', '--help'],
         patterns: [/--url(?:\s|$)/m],
         keyAuthPattern: HEADER_FLAG,
         unavailableMessage: OPENCODE_MCP_ADD_UNAVAILABLE_MESSAGE,
@@ -282,7 +282,7 @@ export const OPENCODE = {
     removals: [],
     // OpenCode writes ~/.config/opencode/opencode.json itself; `mcp auth` is the separate OAuth step.
     addArgs: (mcpUrl) => urlAddArgs(mcpUrl),
-    loginArgs: ["mcp", "auth", "tinyfish"],
+    loginArgs: ['mcp', 'auth', 'tinyfish'],
     launchWalkthrough: launchOpencode,
     postConnectNote: OPENCODE_MODEL_NOTE,
 };
@@ -297,17 +297,17 @@ export const NATIVE_MCP_CLIENTS = [
 /** Native descriptor by harness id; Cursor and OpenClaw have none. */
 export const NATIVE_BY_HARNESS = new Map(NATIVE_MCP_CLIENTS.map((client) => [client.connectClient, client]));
 export const OPENCLAW = {
-    command: "openclaw",
-    displayName: "OpenClaw",
+    command: 'openclaw',
+    displayName: 'OpenClaw',
     supportCheck: {
-        args: ["skills", "install", "--help"],
+        args: ['skills', 'install', '--help'],
         patterns: [/--global(?:\s|$)/, /--acknowledge-clawhub-risk(?:\s|$)/],
         unavailableMessage: OPENCLAW_SKILL_UNAVAILABLE_MESSAGE,
     },
 };
 /** Required booleans: a new harness or new flag fails to compile undecided. */
 export const HARNESS_CAPABILITIES = {
-    "claude-code": {
+    'claude-code': {
         signInViaCliLogin: false,
         canVerifyAuth: false,
         keyHeldByCli: false,
@@ -363,22 +363,22 @@ function printPromptForHandoff(displayName, command, prompt, reason) {
     errLine(`TinyFish is set up in ${displayName}.`);
     errLine(`${reason}, so TinyFish did not launch it. Start ${displayName} (\`${command}\`) yourself ` +
         `and paste this first message:`);
-    errLine("");
+    errLine('');
     errLine(prompt);
 }
 /** One gate + one decide-before-block path for every terminal handover. */
 async function deliverWalkthrough(displayName, command, prompt, handover, onDecided) {
     // Inherited-stdio handover: a non-TTY parent cannot approve tool calls.
     if (!detectHumanInitiated()) {
-        await onDecided?.("printed");
+        await onDecided?.('printed');
         printPromptForHandoff(displayName, command, prompt, `This terminal cannot answer ${displayName}'s tool-approval prompts`);
-        return "printed";
+        return 'printed';
     }
     // Decided and delivered first: the handover blocks for the whole session.
-    await onDecided?.("launched");
+    await onDecided?.('launched');
     errLine(`Starting the TinyFish walkthrough in ${displayName}...`);
     handover();
-    return "launched";
+    return 'launched';
 }
 export async function launchNativeMcpClient(client, onDecided) {
     if (client.detachedLaunch) {
@@ -393,5 +393,5 @@ export async function launchNativeMcpClient(client, onDecided) {
         : handOverTerminal(client.command, [DEFAULT_ONBOARDING_PROMPT], client.displayName), onDecided);
 }
 export function launchOpenClawWalkthrough(onDecided) {
-    return deliverWalkthrough("OpenClaw", "openclaw", OPENCLAW_ONBOARDING_PROMPT, () => handOverTerminal("openclaw", ["chat", "--message", OPENCLAW_ONBOARDING_PROMPT], "OpenClaw"), onDecided);
+    return deliverWalkthrough('OpenClaw', 'openclaw', OPENCLAW_ONBOARDING_PROMPT, () => handOverTerminal('openclaw', ['chat', '--message', OPENCLAW_ONBOARDING_PROMPT], 'OpenClaw'), onDecided);
 }

package/dist/lib/connect-fallback.d.ts

@@ -1,4 +1,4 @@
-import { type CliFallbackOutcome, type ConnectCheckpoint, type ConnectFailureStage } from "./connect-runtime.js";
+import { type CliFallbackOutcome, type ConnectCheckpoint, type ConnectFailureStage } from './connect-runtime.js';
 export type Prompt = (question: string) => Promise<string>;
 export declare const SEARCH_RETRY = "tinyfish search query --pretty -- \"<your query>\"";
 export declare const DEFAULT_VERIFICATION_QUERY = "today's top Hacker News story";