@tiny-fish/cli 0.48.3-next.389 → 0.48.3-next.391

package/dist/lib/connect-runtime.js

@@ -179,6 +179,18 @@ export async function runGuarded(state, telemetry, body) {
 function probeTimeoutMs(client) {
     return client.supportCheck.timeoutMs ?? NON_INTERACTIVE_TIMEOUT_MS;
 }
+// Flags go unseen for reasons besides age; state facts, not causes.
+function unavailableMessage(client, version) {
+    const { minVersion } = client.supportCheck;
+    const found = version ? ` (found ${version})` : '';
+    // Numeric collation orders dotted versions: 7.7.3 sorts after 7.4.13.
+    const belowMin = minVersion && (!version || version.localeCompare(minVersion, 'en', { numeric: true }) < 0);
+    const required = belowMin
+        ? ` ${client.displayName} ${minVersion} or newer is required${found}.`
+        : '';
+    return (`${client.supportCheck.unavailableMessage}${required}` +
+        ' Set TINYFISH_DEBUG=1 and retry to print the help output TinyFish read.');
+}
 function throwProbeFailure(client, result) {
     throwIfInterrupted(result);
     // A hung probe is a timeout, not a missing capability.
@@ -188,10 +200,13 @@ function throwProbeFailure(client, result) {
             `${probeTimeoutMs(client) / 1000}s. Retry.`, 'timeout', { cause: result.error, failureDetail: spawnFailureDetail(result) });
     }
     // It ran and exited non-zero, so the version is still answerable.
-    throw new ConnectStepError(client.supportCheck.unavailableMessage, 'harness_command_unsupported', {
+    debugProbeOutput(client, sanitizeLine(`${result.stdout ?? ''}\n${result.stderr ?? ''}`));
+    const harnessVersion = probeHarnessVersion(client);
+    throw new ConnectStepError(unavailableMessage(client, harnessVersion), 'harness_command_unsupported', {
         cause: result.error,
-        harnessVersion: probeHarnessVersion(client),
-        failureDetail: spawnFailureDetail(result),
+        harnessVersion,
+        // A spawn error leaves stderr empty; its message is the diagnosis.
+        failureDetail: result.error?.message ?? spawnFailureDetail(result),
     });
 }
 function supportProbeOutput(client) {
@@ -220,8 +235,9 @@ function requireEssential(client, output) {
     if (client.supportCheck.patterns.every((pattern) => pattern.test(output)))
         return;
     debugProbeOutput(client, output);
-    throw new ConnectStepError(client.supportCheck.unavailableMessage, 'harness_too_old', {
-        harnessVersion: probeHarnessVersion(client),
+    const harnessVersion = probeHarnessVersion(client);
+    throw new ConnectStepError(unavailableMessage(client, harnessVersion), 'harness_too_old', {
+        harnessVersion,
     });
 }
 /** Absence is a fact; an unknown flag means an upstream rename. */

package/dist/lib/harness/harness-messages.js

@@ -1,9 +1,6 @@
 // User-facing copy for the harness specs; kept apart so the spec file stays structure.
-// 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.';
 export 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;
+    '--help` did not list it. Update Claude Code with `claude update` and retry.';
 // `claude mcp login` only exists upstream from Claude Code 2.1.186; older installs still register.
 export 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.';
@@ -13,8 +10,7 @@ export const CLAUDE_CODE_DEFERRED_AUTH_NOTE = 'TinyFish is registered in Claude
     'Run `tinyfish connect claude-code --api-key <key>` instead.';
 export const CODEX_MCP_URL_UNAVAILABLE_MESSAGE = 'Could not confirm this Codex installation supports remote MCP servers: `codex mcp add ' +
     '--help` did not list `--url`. Update Codex and retry, or add TinyFish manually with ' +
-    '`codex mcp add`.' +
-    SUPPORT_CHECK_DEBUG_HINT;
+    '`codex mcp add`.';
 export const CODEX_KEYED_FALLBACK_NOTE = 'Using your stored TinyFish API key: this Codex cannot report whether an OAuth sign-in ' +
     'finished, so no browser sign-in is attempted.';
 export const CODEX_DEFERRED_AUTH_NOTE = 'TinyFish is registered in Codex but not signed in: this Codex predates reliable sign-in ' +
@@ -22,24 +18,20 @@ export const CODEX_DEFERRED_AUTH_NOTE = 'TinyFish is registered in Codex but not
     '`npm install -g @openai/codex@latest` for one-command sign-in.';
 export 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;
+    'manually with `hermes mcp add`.';
 export 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 mcp add`.';
 // 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).
 export const GROK_SIGN_IN_HINT = 'TinyFish is registered in Grok. Open Grok, run `/mcps`, select tinyfish, and press `i` to ' +
     'sign in.';
 export const OPENCLAW_SKILL_UNAVAILABLE_MESSAGE = 'Could not confirm this OpenClaw installation supports global skill installation: `openclaw ' +
     'skills install --help` did not list `--global`. Update OpenClaw and retry, or install ' +
-    'manually with `openclaw skills install @tinyfish/tinyfish --global`.' +
-    SUPPORT_CHECK_DEBUG_HINT;
+    'manually with `openclaw skills install @tinyfish/tinyfish --global`.';
 export 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 mcp add`.';
 // 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.
 export const OPENCODE_MODEL_NOTE = 'Note: TinyFish runs on tool calls, so OpenCode needs a model that supports tool use. Image-only ' +
@@ -47,9 +39,8 @@ export const OPENCODE_MODEL_NOTE = 'Note: TinyFish runs on tool calls, so OpenCo
     "OpenCode's model if the walkthrough can't start.";
 export const KILO_MCP_ADD_UNAVAILABLE_MESSAGE = 'Could not confirm this Kilo Code installation supports remote MCP servers: `kilo mcp add ' +
     '--help` did not list `--url`. Update Kilo Code with `kilo upgrade` and retry, or add ' +
-    'TinyFish manually with `kilo mcp add`.' +
-    SUPPORT_CHECK_DEBUG_HINT;
+    'TinyFish manually with `kilo mcp add`.';
 export const HERMES_RESTART_NOTE = 'Restart your Hermes session to pick up TinyFish — Hermes discovers MCP servers at startup.';
 export const CLINE_MCP_ADD_UNAVAILABLE_MESSAGE = 'Could not confirm this Cline installation supports non-interactive MCP setup: `cline mcp add ' +
-    '--help` did not list `--transport` and `--yes`. Update Cline with `cline --update` and retry.' +
-    SUPPORT_CHECK_DEBUG_HINT;
+    '--help` did not list `--transport` and `--yes`. Update Cline with `npm i -g cline@latest` ' +
+    'or `cline --update` and retry.';

package/dist/lib/harness/harness-spec.d.ts

@@ -14,6 +14,8 @@ export interface HarnessSupportCheck {
     unknownVariant?: RegExp;
     /** Defaults to NON_INTERACTIVE_TIMEOUT_MS; raise for a slow cold start. */
     timeoutMs?: number;
+    /** First release with the probed flags; bisected upstream, not derivable. */
+    minVersion?: string;
     unavailableMessage: string;
 }
 /** One entry per harness: every per-harness fact, and no behaviour. */
@@ -124,6 +126,8 @@ export declare const HARNESS_SPECS: {
             args: string[];
             patterns: RegExp[];
             keyAuthPattern: RegExp;
+            timeoutMs: number;
+            minVersion: string;
             unavailableMessage: string;
         };
         urlStyle: "positional";
@@ -232,6 +236,7 @@ export declare const HARNESS_SPECS: {
             args: string[];
             patterns: RegExp[];
             keyAuthPattern: RegExp;
+            minVersion: string;
             unavailableMessage: string;
         };
         urlStyle: "flag";

package/dist/lib/harness/harness-spec.js

@@ -51,6 +51,9 @@ export const HARNESS_SPECS = {
             // Without `--yes` the add opens a wizard and exits non-zero off a TTY.
             patterns: [/--transport(?:[\s<=]|$)/m, /--yes(?:[\s<=]|$)/m],
             keyAuthPattern: HEADER_FLAG,
+            // Cold start on first run outlasts the 10s default.
+            timeoutMs: 30_000,
+            minVersion: '3.0.30',
             unavailableMessage: CLINE_MCP_ADD_UNAVAILABLE_MESSAGE,
         },
         urlStyle: 'positional',
@@ -162,6 +165,7 @@ export const HARNESS_SPECS = {
             args: ['mcp', 'add', '--help'],
             patterns: [/--url(?:\s|$)/m],
             keyAuthPattern: HEADER_FLAG,
+            minVersion: '7.4.13',
             unavailableMessage: KILO_MCP_ADD_UNAVAILABLE_MESSAGE,
         },
         urlStyle: 'flag',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiny-fish/cli",
-  "version": "0.48.3-next.389",
+  "version": "0.48.3-next.391",
   "description": "TinyFish CLI — run web automations from your terminal",
   "type": "module",
   "bin": {