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

package/dist/commands/connect.js

@@ -1,22 +1,22 @@
-import spawn from "cross-spawn";
-import { CONNECT_SOURCE, persistApiKeyToEnvironment, saveConnectContext, validateKeyFormat, validatedApiKey, } from "../lib/auth.js";
-import { CLAUDE_CODE, CODEX, CURSOR_SKILL_TARGET, GROK, HERMES, OPENCLAW, OPENCLAW_SKILL_INSTALL_ARGS, OPENCODE, launchNativeMcpClient, launchOpenClawWalkthrough, openExternalUrl, } from "../lib/connect-clients.js";
-import { captureStdio, capturedOutput, HoistedFailureReportedError, installTinyFishCli, replay, } from "../lib/cli-install.js";
-import { ensureCliAuthenticated } from "../lib/connect-auth.js";
-import { createStdinPrompt, runCliFallback } from "../lib/connect-fallback.js";
-import { installWebSkill } from "../lib/skill-install.js";
-import { ConnectInterruptedError, ConnectStepError, createConnectTelemetry, finishSetupCommand, requireCommandSupport, runGuarded, settle, SignInTimeoutError, spawnStepError, spawnRemoval, } from "../lib/connect-runtime.js";
-import { cursorInstallDeeplink, cursorMcpPath, readCursorTinyfishEntry, writeCursorMcpConfig, } from "../lib/cursor-config.js";
-import { runConnectAll } from "../lib/connect-all.js";
-import { AuthMode, RELOAD_ACTION } from "../lib/harness-detect.js";
-import { detectHumanInitiated } from "../lib/harness.js";
-import { TINYFISH_API_KEY_VAR } from "../lib/constants.js";
-import { emitNotice } from "../lib/notice.js";
-import { SIGN_IN_PROBES } from "../lib/registration-detect.js";
-import { errLine, warnLine } from "../lib/output.js";
-import { z } from "zod";
-import { verifyMcpAuth } from "../lib/verify.js";
-export const DEFAULT_MCP_URL = "https://agent.tinyfish.ai/mcp";
+import spawn from 'cross-spawn';
+import { CONNECT_SOURCE, persistApiKeyToEnvironment, saveConnectContext, validateKeyFormat, validatedApiKey, } from '../lib/auth.js';
+import { CLAUDE_CODE, CODEX, CURSOR_SKILL_TARGET, GROK, HERMES, OPENCLAW, OPENCLAW_SKILL_INSTALL_ARGS, OPENCODE, launchNativeMcpClient, launchOpenClawWalkthrough, openExternalUrl, } from '../lib/connect-clients.js';
+import { captureStdio, capturedOutput, HoistedFailureReportedError, installTinyFishCli, replay, } from '../lib/cli-install.js';
+import { ensureCliAuthenticated } from '../lib/connect-auth.js';
+import { createStdinPrompt, runCliFallback } from '../lib/connect-fallback.js';
+import { installWebSkill } from '../lib/skill-install.js';
+import { ConnectInterruptedError, ConnectStepError, createConnectTelemetry, finishSetupCommand, requireCommandSupport, runGuarded, settle, SignInTimeoutError, spawnStepError, spawnRemoval, } from '../lib/connect-runtime.js';
+import { cursorInstallDeeplink, cursorMcpPath, readCursorTinyfishEntry, writeCursorMcpConfig, } from '../lib/cursor-config.js';
+import { runConnectAll } from '../lib/connect-all.js';
+import { AuthMode, RELOAD_ACTION } from '../lib/harness-detect.js';
+import { detectHumanInitiated } from '../lib/harness.js';
+import { TINYFISH_API_KEY_VAR } from '../lib/constants.js';
+import { emitNotice } from '../lib/notice.js';
+import { SIGN_IN_PROBES } from '../lib/registration-detect.js';
+import { errLine, warnLine } from '../lib/output.js';
+import { z } from 'zod';
+import { verifyMcpAuth } from '../lib/verify.js';
+export const DEFAULT_MCP_URL = 'https://agent.tinyfish.ai/mcp';
 function removeExistingRegistration(client, removal, verbose) {
     const result = spawnRemoval(client.command, removal.args);
     if (result.status === 0)
@@ -24,7 +24,7 @@ function removeExistingRegistration(client, removal, verbose) {
     // Best-effort: a stale entry makes `mcp add` error or upsert, with a truer message.
     if (!verbose)
         return;
-    const details = result.stderr?.trim() || result.error?.message || "unknown error";
+    const details = result.stderr?.trim() || result.error?.message || 'unknown error';
     warnLine(`Could not remove existing ${removal.label}: ${details}`);
 }
 /** false: fall back to OAuth — a config naming an unset variable authenticates nothing. */
@@ -34,29 +34,29 @@ function exportApiKey(apiKey, displayName, deferOutro) {
     }
     catch (error) {
         errLine(`Could not export TINYFISH_API_KEY (${error instanceof Error ? error.message : String(error)}); ` +
-            "signing in instead.");
+            'signing in instead.');
         return false;
     }
     process.env[TINYFISH_API_KEY_VAR] = apiKey;
     if (deferOutro) {
-        deferOutro("Exported TINYFISH_API_KEY to your shell profile — restart your agents (or open a new " +
-            "terminal) before use.");
+        deferOutro('Exported TINYFISH_API_KEY to your shell profile — restart your agents (or open a new ' +
+            'terminal) before use.');
     }
     else {
         errLine(`Exported TINYFISH_API_KEY to your shell profile — ${displayName} reads the key from there, ` +
-            "so restart it (or open a new terminal) before use.");
+            'so restart it (or open a new terminal) before use.');
     }
     return true;
 }
 /** A bounded spawn's timeout means the sign-in never finished. */
 function signInStepError(message, result, bounded) {
     const error = spawnStepError(message, result);
-    return bounded && error.failureReason === "timeout"
+    return bounded && error.failureReason === 'timeout'
         ? new SignInTimeoutError(error.message, error.cause)
         : error;
 }
 function isMissingHarness(error) {
-    return error instanceof ConnectStepError && error.failureReason === "harness_not_installed";
+    return error instanceof ConnectStepError && error.failureReason === 'harness_not_installed';
 }
 /** Undefined means the rescue ran; the caller returns immediately. */
 async function requireSupportOrRescue(client, connectClient, state, telemetry, options) {
@@ -73,7 +73,7 @@ async function requireSupportOrRescue(client, connectClient, state, telemetry, o
 // The harness attempt stays failed; the rescue rides fallback_outcome (PF-3707).
 async function runMissingHarnessFallback(displayName, connectClient, state, telemetry, options) {
     // Stamped before any step: Ctrl+C settles before an outcome exists.
-    telemetry.setFallbackOutcome("abandoned");
+    telemetry.setFallbackOutcome('abandoned');
     errLine(`${displayName} was not found on PATH. Setting up the TinyFish CLI instead.`);
     const outcome = await runCliFallback({
         apiKey: options.apiKey,
@@ -85,28 +85,28 @@ async function runMissingHarnessFallback(displayName, connectClient, state, tele
             onStepStart: (stage) => {
                 state.stage = stage;
             },
-            onStepDone: (phase) => telemetry.track("checkpoint", { phase }),
+            onStepDone: (phase) => telemetry.track('checkpoint', { phase }),
         },
     });
     telemetry.setFallbackOutcome(outcome);
     // Never `completed`: dashboards read that as "the harness install worked".
-    settle(state, telemetry, "failed", {
-        failedStage: "prerequisite_check",
-        failureReason: "harness_not_installed",
+    settle(state, telemetry, 'failed', {
+        failedStage: 'prerequisite_check',
+        failureReason: 'harness_not_installed',
     });
-    if (outcome !== "cli_verified") {
+    if (outcome !== 'cli_verified') {
         process.exitCode = 1;
         return;
     }
-    errLine("The TinyFish CLI is installed and working.");
-    errLine("Using a different agent? Run: tinyfish connect --all");
+    errLine('The TinyFish CLI is installed and working.');
+    errLine('Using a different agent? Run: tinyfish connect --all');
 }
 async function connectNativeMcpClient(client, options) {
     const telemetry = createConnectTelemetry(options.mcpUrl, client.connectClient, options);
-    const state = { stage: "prerequisite_check", settled: false };
+    const state = { stage: 'prerequisite_check', settled: false };
     const probeAuthenticated = SIGN_IN_PROBES[client.connectClient];
     await runGuarded(state, telemetry, async () => {
-        telemetry.track("started");
+        telemetry.track('started');
         const support = await requireSupportOrRescue(client, client.connectClient, state, telemetry, options);
         if (!support)
             return;
@@ -128,25 +128,25 @@ async function connectNativeMcpClient(client, options) {
             // No keyAuth at all is structural (Hermes); a missing flag is just an old install.
             if (client.keyAuth) {
                 throw new ConnectStepError(`This ${client.displayName} install cannot take a TinyFish API key, and signing in ` +
-                    `needs a terminal. Update it, then re-run: tinyfish connect ${client.connectClient}`, "harness_too_old");
+                    `needs a terminal. Update it, then re-run: tinyfish connect ${client.connectClient}`, 'harness_too_old');
             }
             throw new ConnectStepError(`${client.displayName} cannot take a TinyFish API key, and signing in needs a ` +
-                `terminal. Run: tinyfish connect ${client.connectClient}`, "key_auth_unsupported");
+                `terminal. Run: tinyfish connect ${client.connectClient}`, 'key_auth_unsupported');
         }
-        telemetry.track("checkpoint", { phase: "prerequisite_ok" });
-        state.stage = "registration_cleanup";
+        telemetry.track('checkpoint', { phase: 'prerequisite_ok' });
+        state.stage = 'registration_cleanup';
         for (const removal of client.removals)
             removeExistingRegistration(client, removal, options.verbose ?? false);
         const mcpUrl = new URL(options.mcpUrl);
-        mcpUrl.searchParams.set("source", CONNECT_SOURCE);
-        mcpUrl.searchParams.set("client", client.connectClient);
-        mcpUrl.searchParams.set("connect_attempt_id", telemetry.attemptId);
+        mcpUrl.searchParams.set('source', CONNECT_SOURCE);
+        mcpUrl.searchParams.set('client', client.connectClient);
+        mcpUrl.searchParams.set('connect_attempt_id', telemetry.attemptId);
         // Undefining `loginArgs` reuses the deferred-auth path codex/hermes already take.
         const loginDegraded = state.harnessDegraded === true;
         const loginArgs = loginDegraded ? undefined : client.loginArgs;
         // A probed client authenticates inside `mcp add` too, so a failure there is either.
         state.stage =
-            loginArgs && !probeAuthenticated ? "registration" : "registration_or_authentication";
+            loginArgs && !probeAuthenticated ? 'registration' : 'registration_or_authentication';
         errLine(`Adding TinyFish to ${client.displayName}...`);
         // Header keys ride argv (/proc/<pid>/cmdline); these CLIs take headers no other way.
         const addArgs = keyedAdd
@@ -155,7 +155,7 @@ async function connectNativeMcpClient(client, options) {
         // Capturing an inline-OAuth add hides the sign-in URL and hangs.
         const interactiveAdd = !(client.nonInteractiveAdd || keyedAdd);
         const addResult = spawn.sync(client.command, addArgs, interactiveAdd
-            ? { stdio: "inherit", timeout: options.authTimeoutMs }
+            ? { stdio: 'inherit', timeout: options.authTimeoutMs }
             : captureStdio(options.verbose ?? false));
         if (addResult.error || addResult.status !== 0) {
             // Built first: its interrupt check must run before any replay.
@@ -163,15 +163,15 @@ async function connectNativeMcpClient(client, options) {
             replay(capturedOutput(addResult));
             throw error;
         }
-        telemetry.track("checkpoint", { phase: "registered" });
+        telemetry.track('checkpoint', { phase: 'registered' });
         // Codex runs OAuth inside `mcp add` and exits 0 either way, so the recorded state decides
         // whether the login step below still runs. Unknown keeps the pre-probe behaviour.
         const addSignedIn = probeAuthenticated?.();
         if (addSignedIn)
-            telemetry.track("checkpoint", { phase: "oauth_done" });
+            telemetry.track('checkpoint', { phase: 'oauth_done' });
         const degradedNotes = loginDegraded ? client.degradedAuthNotes : undefined;
         if (useKeyAuth) {
-            errLine(degradedNotes?.keyed ?? "Using your stored TinyFish API key — no browser sign-in needed.");
+            errLine(degradedNotes?.keyed ?? 'Using your stored TinyFish API key — no browser sign-in needed.');
         }
         else if (degradedNotes) {
             // Printed here, not with the closing line, so a `--launch` run sees it before the handover.
@@ -182,10 +182,10 @@ async function connectNativeMcpClient(client, options) {
         const pendingLogin = !useKeyAuth && retryLogin ? loginArgs : undefined;
         let signInDeferred = !useKeyAuth && !addSignedIn && !pendingLogin;
         if (pendingLogin) {
-            state.stage = "client_oauth";
-            errLine("Signing in to TinyFish...");
+            state.stage = 'client_oauth';
+            errLine('Signing in to TinyFish...');
             const loginResult = spawn.sync(client.command, pendingLogin, {
-                stdio: "inherit",
+                stdio: 'inherit',
                 timeout: options.authTimeoutMs,
             });
             if (loginResult.error || loginResult.status !== 0) {
@@ -194,16 +194,16 @@ async function connectNativeMcpClient(client, options) {
             if (probeAuthenticated?.() === false)
                 signInDeferred = true;
             else
-                telemetry.track("checkpoint", { phase: "oauth_done" });
+                telemetry.track('checkpoint', { phase: 'oauth_done' });
         }
         const authMode = useKeyAuth
             ? AuthMode.ApiKey
             : signInDeferred
-                ? "deferred"
+                ? 'deferred'
                 : AuthMode.OAuth;
         state.authMode = authMode;
         // Registration/OAuth make MCP work; later steps are cosmetic and must not fail the attempt.
-        settle(state, telemetry, "completed", { authMode });
+        settle(state, telemetry, 'completed', { authMode });
         await runPostInstallSteps(client, options, state, telemetry, signInDeferred);
     });
     return state.authMode;
@@ -214,7 +214,7 @@ function connectedLine(client, signInDeferred) {
         if (client.signInHint)
             return client.signInHint;
         return (`TinyFish is configured in ${client.displayName}. ${client.displayName} will ask you ` +
-            "to sign in to TinyFish the first time you use it.");
+            'to sign in to TinyFish the first time you use it.');
     }
     return (`TinyFish is connected. Open ${client.displayName}; if it is already running, ` +
         `${RELOAD_ACTION[client.connectClient]} to pick up the tools.`);
@@ -237,22 +237,22 @@ async function runPostInstallSteps(client, options, state, telemetry, signInDefe
     };
     try {
         if (options.cliInstall !== false) {
-            await attempt("cli_install", () => runCliInstallStep(options, telemetry));
+            await attempt('cli_install', () => runCliInstallStep(options, telemetry));
         }
         if (client.skillAgent) {
-            await attempt("skill_install", () => {
+            await attempt('skill_install', () => {
                 installWebSkill(client, { verbose: options.verbose ?? false });
-                telemetry.track("checkpoint", { phase: "skill_installed" });
+                telemetry.track('checkpoint', { phase: 'skill_installed' });
             });
         }
         // Before auth: a failed sign-in must not lose the harness record.
         saveConnectContext(client.connectClient, telemetry.attemptId, state.authMode);
-        await attempt("authentication", () => {
+        await attempt('authentication', () => {
             // A set timeout means headless; never shell an interactive login.
             ensureCliAuthenticated(client.connectClient, options.apiKey, {
                 interactiveLogin: options.authTimeoutMs === undefined,
             });
-            telemetry.track("checkpoint", { phase: "authenticated" });
+            telemetry.track('checkpoint', { phase: 'authenticated' });
         });
         if (client.postConnectNote)
             errLine(client.postConnectNote);
@@ -262,12 +262,12 @@ async function runPostInstallSteps(client, options, state, telemetry, signInDefe
                 errLine(connectedLine(client, signInDeferred));
         }
         else {
-            await attempt("walkthrough_launch", async () => {
+            await attempt('walkthrough_launch', async () => {
                 // Before the handover, or the only sign-in instructions scroll past under the agent.
                 if (signInDeferred && client.signInHint)
                     errLine(client.signInHint);
                 await launchNativeMcpClient(client, async (outcome) => {
-                    telemetry.track("checkpoint", { phase: walkthroughPhase(outcome) });
+                    telemetry.track('checkpoint', { phase: walkthroughPhase(outcome) });
                     // Flushed pre-block; the session-long handover would strand the delivery.
                     await telemetry.flush();
                 });
@@ -294,18 +294,18 @@ function runCliInstallStep(options, telemetry) {
             throw firstTake ? outcome.error : new HoistedFailureReportedError(outcome.error.message);
         }
         if (firstTake) {
-            telemetry.track("checkpoint", {
-                phase: "cli_installed",
+            telemetry.track('checkpoint', {
+                phase: 'cli_installed',
                 stageDurationMs: outcome.durationMs,
             });
         }
         return;
     }
     installTinyFishCli({ verbose: options.verbose ?? false, announce: true });
-    telemetry.track("checkpoint", { phase: "cli_installed" });
+    telemetry.track('checkpoint', { phase: 'cli_installed' });
 }
 function walkthroughPhase(outcome) {
-    return outcome === "printed" ? "walkthrough_prompt_printed" : "walkthrough_launched";
+    return outcome === 'printed' ? 'walkthrough_prompt_printed' : 'walkthrough_launched';
 }
 function finishSetupHint(connectClient) {
     return `Finish setup with: ${finishSetupCommand(connectClient)}`;
@@ -316,9 +316,9 @@ function trackPostInstallFailure(displayName, state, telemetry, error) {
         return;
     // An earlier harness already owns the shared install's failure record.
     if (!(error instanceof HoistedFailureReportedError)) {
-        telemetry.track("post_install_failed", {
+        telemetry.track('post_install_failed', {
             failedStage: state.stage,
-            failureReason: error instanceof ConnectStepError ? error.failureReason : "unexpected_error",
+            failureReason: error instanceof ConnectStepError ? error.failureReason : 'unexpected_error',
         });
     }
     errLine(`The ${displayName} MCP connection succeeded, but a finishing step ` +
@@ -340,74 +340,74 @@ export async function connectOpencode(options) {
     return connectNativeMcpClient(OPENCODE, options);
 }
 export async function connectOpenClaw(options) {
-    const telemetry = createConnectTelemetry(options.mcpUrl, "openclaw", options);
+    const telemetry = createConnectTelemetry(options.mcpUrl, 'openclaw', options);
     // Skill install, no MCP server — never degraded, and false keeps it inside a `= false` filter.
     const state = {
-        stage: "prerequisite_check",
+        stage: 'prerequisite_check',
         settled: false,
         harnessDegraded: false,
     };
     await runGuarded(state, telemetry, async () => {
-        telemetry.track("started");
-        const support = await requireSupportOrRescue(OPENCLAW, "openclaw", state, telemetry, options);
+        telemetry.track('started');
+        const support = await requireSupportOrRescue(OPENCLAW, 'openclaw', state, telemetry, options);
         if (!support)
             return;
         telemetry.setHarnessVersion(support.harnessVersion);
-        telemetry.track("checkpoint", { phase: "prerequisite_ok" });
+        telemetry.track('checkpoint', { phase: 'prerequisite_ok' });
         if (options.hoistedCliInstall) {
-            state.stage = "cli_install";
+            state.stage = 'cli_install';
             const { outcome, firstTake } = options.hoistedCliInstall();
             // A carried failure fails openclaw exactly like the inline install.
             if (!outcome.ok)
                 throw outcome.error;
             if (firstTake) {
-                telemetry.track("checkpoint", {
-                    phase: "cli_installed",
+                telemetry.track('checkpoint', {
+                    phase: 'cli_installed',
                     stageDurationMs: outcome.durationMs,
                 });
             }
         }
         else if (options.cliInstall !== false) {
-            state.stage = "cli_install";
+            state.stage = 'cli_install';
             installTinyFishCli({ verbose: options.verbose ?? false, announce: true });
-            telemetry.track("checkpoint", { phase: "cli_installed" });
+            telemetry.track('checkpoint', { phase: 'cli_installed' });
         }
-        state.stage = "skill_install";
-        errLine("Installing the TinyFish skill in OpenClaw...");
-        const skillInstallResult = spawn.sync("openclaw", OPENCLAW_SKILL_INSTALL_ARGS, captureStdio(options.verbose ?? false));
+        state.stage = 'skill_install';
+        errLine('Installing the TinyFish skill in OpenClaw...');
+        const skillInstallResult = spawn.sync('openclaw', OPENCLAW_SKILL_INSTALL_ARGS, captureStdio(options.verbose ?? false));
         if (skillInstallResult.error || skillInstallResult.status !== 0) {
             // Built first: its interrupt check must run before any replay.
-            const error = spawnStepError("Could not install the TinyFish skill in OpenClaw", skillInstallResult);
+            const error = spawnStepError('Could not install the TinyFish skill in OpenClaw', skillInstallResult);
             replay(capturedOutput(skillInstallResult));
             throw error;
         }
-        telemetry.track("checkpoint", { phase: "skill_installed" });
+        telemetry.track('checkpoint', { phase: 'skill_installed' });
         // Stores the key before probing, so a passed --api-key never reaches an interactive login.
-        state.stage = "authentication";
-        ensureCliAuthenticated("openclaw", options.apiKey);
-        telemetry.track("checkpoint", { phase: "authenticated" });
-        saveConnectContext("openclaw", telemetry.attemptId);
+        state.stage = 'authentication';
+        ensureCliAuthenticated('openclaw', options.apiKey);
+        telemetry.track('checkpoint', { phase: 'authenticated' });
+        saveConnectContext('openclaw', telemetry.attemptId);
         // For openclaw the skill install and auth ARE functional; only the walkthrough is cosmetic.
-        settle(state, telemetry, "completed");
+        settle(state, telemetry, 'completed');
         if (!options.launch) {
             // Under --all the summary already lists OpenClaw.
             if (!options.deferOutro) {
-                errLine("TinyFish is connected. Open OpenClaw; if it is already running, " +
+                errLine('TinyFish is connected. Open OpenClaw; if it is already running, ' +
                     `${RELOAD_ACTION.openclaw} to pick up the skill.`);
             }
             return;
         }
-        state.stage = "walkthrough_launch";
+        state.stage = 'walkthrough_launch';
         try {
             await launchOpenClawWalkthrough(async (outcome) => {
-                telemetry.track("checkpoint", { phase: walkthroughPhase(outcome) });
+                telemetry.track('checkpoint', { phase: walkthroughPhase(outcome) });
                 // Flushed pre-block; the session-long handover would strand the delivery.
                 await telemetry.flush();
             });
         }
         catch (error) {
-            trackPostInstallFailure("OpenClaw", state, telemetry, error);
-            errLine(finishSetupHint("openclaw"));
+            trackPostInstallFailure('OpenClaw', state, telemetry, error);
+            errLine(finishSetupHint('openclaw'));
         }
     });
 }
@@ -419,10 +419,10 @@ export async function connectCursor(options) {
         try {
             const registered = new URL(registeredUrl);
             const requested = new URL(options.mcpUrl);
-            const registeredId = registered.searchParams.get("connect_attempt_id");
-            const registeredSource = registered.searchParams.get("source");
-            const registeredClient = registered.searchParams.get("client");
-            for (const key of ["source", "client", "connect_attempt_id"]) {
+            const registeredId = registered.searchParams.get('connect_attempt_id');
+            const registeredSource = registered.searchParams.get('source');
+            const registeredClient = registered.searchParams.get('client');
+            for (const key of ['source', 'client', 'connect_attempt_id']) {
                 registered.searchParams.delete(key);
                 requested.searchParams.delete(key);
             }
@@ -430,7 +430,7 @@ export async function connectCursor(options) {
             requested.searchParams.sort();
             if (registered.toString() === requested.toString() &&
                 registeredSource === CONNECT_SOURCE &&
-                registeredClient === "cursor" &&
+                registeredClient === 'cursor' &&
                 z.uuid().safeParse(registeredId).success) {
                 fallbackAttemptId = registeredId ?? undefined;
             }
@@ -439,51 +439,51 @@ export async function connectCursor(options) {
             // A hand-edited invalid URL is repaired below with a fresh attempt id.
         }
     }
-    const telemetry = createConnectTelemetry(options.mcpUrl, "cursor", {
+    const telemetry = createConnectTelemetry(options.mcpUrl, 'cursor', {
         ...options,
         fallbackAttemptId,
     });
     // Never degraded: no sign-in command to be missing. False, not absent, so a `= false`
     // filter still catches Cursor.
     const state = {
-        stage: "prerequisite_check",
+        stage: 'prerequisite_check',
         settled: false,
         harnessDegraded: false,
     };
     await runGuarded(state, telemetry, async () => {
-        telemetry.track("started");
-        telemetry.track("checkpoint", { phase: "prerequisite_ok" });
-        state.stage = "skill_install";
+        telemetry.track('started');
+        telemetry.track('checkpoint', { phase: 'prerequisite_ok' });
+        state.stage = 'skill_install';
         installWebSkill(CURSOR_SKILL_TARGET, { verbose: options.verbose ?? false });
-        telemetry.track("checkpoint", { phase: "skill_installed" });
+        telemetry.track('checkpoint', { phase: 'skill_installed' });
         // Auth first: a key lets the config carry an X-API-Key header, removing the sign-in hand-back.
-        state.stage = "authentication";
-        ensureCliAuthenticated("cursor", options.apiKey);
-        telemetry.track("checkpoint", { phase: "authenticated" });
+        state.stage = 'authentication';
+        ensureCliAuthenticated('cursor', options.apiKey);
+        telemetry.track('checkpoint', { phase: 'authenticated' });
         const resolvedKey = validatedApiKey(options.apiKey);
         // ensureCliAuthenticated leaves a key stored, and `auth status` exits 0 on a malformed one.
         if (!resolvedKey) {
-            errLine("Ignoring the stored API key: invalid format. Run: tinyfish auth login");
+            errLine('Ignoring the stored API key: invalid format. Run: tinyfish auth login');
         }
-        state.stage = "registration";
-        errLine("Adding TinyFish to Cursor...");
+        state.stage = 'registration';
+        errLine('Adding TinyFish to Cursor...');
         const mcpUrl = new URL(options.mcpUrl);
-        mcpUrl.searchParams.set("source", CONNECT_SOURCE);
-        mcpUrl.searchParams.set("client", "cursor");
-        mcpUrl.searchParams.set("connect_attempt_id", telemetry.attemptId);
+        mcpUrl.searchParams.set('source', CONNECT_SOURCE);
+        mcpUrl.searchParams.set('client', 'cursor');
+        mcpUrl.searchParams.set('connect_attempt_id', telemetry.attemptId);
         const result = writeCursorMcpConfig(mcpUrl.toString(), resolvedKey);
-        if (result.status === "corrupt_skip") {
+        if (result.status === 'corrupt_skip') {
             throw new ConnectStepError(`Could not update ${cursorMcpPath()}: existing file could not be read or is not valid JSON (${result.error}). ` +
-                `Fix the file, then re-run: tinyfish connect cursor`, "invalid_config");
+                `Fix the file, then re-run: tinyfish connect cursor`, 'invalid_config');
         }
         if (result.backupPath) {
             errLine(`Backed up existing Cursor MCP config to ${result.backupPath}`);
         }
         if (result.repaired) {
-            errLine("Repaired the existing TinyFish entry (updated auth/config to current).");
+            errLine('Repaired the existing TinyFish entry (updated auth/config to current).');
         }
-        telemetry.track("checkpoint", { phase: "registered" });
-        saveConnectContext("cursor", telemetry.attemptId);
+        telemetry.track('checkpoint', { phase: 'registered' });
+        saveConnectContext('cursor', telemetry.attemptId);
         if (resolvedKey) {
             // Deeplink would embed the key in a URL (process args, LaunchServices logs) — reload instead.
             const verify = await verifyMcpAuth(resolvedKey);
@@ -491,17 +491,17 @@ export async function connectCursor(options) {
                 errLine("TinyFish is connected and verified (health+auth). Reload the Cursor window (or restart cursor-agent) and it's live.");
             }
             else {
-                errLine(`TinyFish is configured, but the authenticated check failed (${verify.reason ?? "unknown"}). ` +
-                    "Fix: rotate/re-enter your key with `tinyfish auth login`, then re-run: tinyfish connect cursor");
+                errLine(`TinyFish is configured, but the authenticated check failed (${verify.reason ?? 'unknown'}). ` +
+                    'Fix: rotate/re-enter your key with `tinyfish auth login`, then re-run: tinyfish connect cursor');
             }
         }
         else if (detectHumanInitiated() && launchCursorDeeplink(mcpUrl.toString())) {
-            errLine("Cursor should pop a TinyFish install confirmation — approve it, then sign in when prompted.");
+            errLine('Cursor should pop a TinyFish install confirmation — approve it, then sign in when prompted.');
         }
         else {
-            errLine("TinyFish is connected. Reload the Cursor window, then approve/sign in under Settings → MCP.");
+            errLine('TinyFish is connected. Reload the Cursor window, then approve/sign in under Settings → MCP.');
         }
-        settle(state, telemetry, "completed", { authMode: resolvedKey ? AuthMode.ApiKey : "deferred" });
+        settle(state, telemetry, 'completed', { authMode: resolvedKey ? AuthMode.ApiKey : 'deferred' });
     });
 }
 /** Best-effort: false when no handler/open fails — caller falls back to reload copy. */
@@ -511,7 +511,7 @@ function launchCursorDeeplink(mcpUrl) {
 }
 // A new client fails to compile until wired here.
 const AGENT_LAUNCHERS = {
-    "claude-code": () => launchNativeMcpClient(CLAUDE_CODE),
+    'claude-code': () => launchNativeMcpClient(CLAUDE_CODE),
     codex: () => launchNativeMcpClient(CODEX),
     grok: () => launchNativeMcpClient(GROK),
     hermes: () => launchNativeMcpClient(HERMES),
@@ -519,7 +519,7 @@ const AGENT_LAUNCHERS = {
     openclaw: launchOpenClawWalkthrough,
     // Cursor has no chat CLI to launch.
     cursor: () => {
-        throw new Error("Cursor has no launchable walkthrough. Open Cursor and start chatting.");
+        throw new Error('Cursor has no launchable walkthrough. Open Cursor and start chatting.');
     },
 };
 export async function launchAgent(client) {
@@ -527,7 +527,7 @@ export async function launchAgent(client) {
 }
 // A new client fails to compile until wired here.
 const CLIENT_CONNECTORS = {
-    "claude-code": connectClaudeCode,
+    'claude-code': connectClaudeCode,
     codex: connectCodex,
     grok: connectGrok,
     hermes: connectHermes,
@@ -537,29 +537,29 @@ const CLIENT_CONNECTORS = {
     cursor: async (options) => {
         await connectCursor(options);
         if (options.launch) {
-            errLine("Cursor has no launchable walkthrough. Open Cursor and start chatting.");
+            errLine('Cursor has no launchable walkthrough. Open Cursor and start chatting.');
         }
     },
 };
 export function registerConnect(program) {
     program
-        .command("connect")
-        .description("Connect TinyFish to an AI agent")
-        .argument("[client]", "Agent client to connect (claude-code, codex, cursor, grok, hermes, openclaw, or opencode); omit to pick from the agents detected on this machine")
-        .option("--all", "Detect and connect every supported harness found on this machine")
-        .option("--dry-run", "Print planned writes per harness without touching anything (--all only)")
-        .option("--uninstall", "Remove TinyFish entries written by connect --all")
-        .option("--skip-launch", "Skip the end-of-install agent launch (--all only)")
-        .option("--api-key <apiKey>", "TinyFish API key to persist for the installed skill")
-        .option("--launch", "Launch the agent and start the TinyFish walkthrough")
-        .option("--url <mcpUrl>", "MCP endpoint override")
-        .option("--verbose", "Print the full npm and skills output instead of only on failure")
+        .command('connect')
+        .description('Connect TinyFish to an AI agent')
+        .argument('[client]', 'Agent client to connect (claude-code, codex, cursor, grok, hermes, openclaw, or opencode); omit to pick from the agents detected on this machine')
+        .option('--all', 'Detect and connect every supported harness found on this machine')
+        .option('--dry-run', 'Print planned writes per harness without touching anything (--all only)')
+        .option('--uninstall', 'Remove TinyFish entries written by connect --all')
+        .option('--skip-launch', 'Skip the end-of-install agent launch (--all only)')
+        .option('--api-key <apiKey>', 'TinyFish API key to persist for the installed skill')
+        .option('--launch', 'Launch the agent and start the TinyFish walkthrough')
+        .option('--url <mcpUrl>', 'MCP endpoint override')
+        .option('--verbose', 'Print the full npm and skills output instead of only on failure')
         .action(async (client, options) => {
         if (options.apiKey && !validateKeyFormat(options.apiKey)) {
-            throw new Error("Invalid --api-key value");
+            throw new Error('Invalid --api-key value');
         }
         let mcpUrl = options.url ?? DEFAULT_MCP_URL;
-        if (mcpUrl.startsWith("-")) {
+        if (mcpUrl.startsWith('-')) {
             throw new Error(`Invalid --url value: ${mcpUrl}`);
         }
         let parsedUrl;
@@ -569,25 +569,25 @@ export function registerConnect(program) {
         catch {
             throw new Error(`Invalid --url value: ${mcpUrl}`);
         }
-        if (!["http:", "https:"].includes(parsedUrl.protocol)) {
+        if (!['http:', 'https:'].includes(parsedUrl.protocol)) {
             throw new Error(`Invalid --url value: ${mcpUrl}`);
         }
         // Page-minted attempt id rides in on --url. Strip before the URL becomes the MCP
         // base — registration re-stamps it, and nothing else may carry it.
-        const pageAttemptId = parsedUrl.searchParams.get("connect_attempt_id");
+        const pageAttemptId = parsedUrl.searchParams.get('connect_attempt_id');
         let attemptId;
         if (pageAttemptId !== null) {
-            parsedUrl.searchParams.delete("connect_attempt_id");
+            parsedUrl.searchParams.delete('connect_attempt_id');
             mcpUrl = parsedUrl.toString();
             if (z.uuid().safeParse(pageAttemptId).success)
                 attemptId = pageAttemptId;
         }
         if (options.all) {
             if (client) {
-                throw new Error("Pass either a client or --all, not both.");
+                throw new Error('Pass either a client or --all, not both.');
             }
             if (options.launch) {
-                throw new Error("--launch is not supported with --all. Connect a single client to launch it.");
+                throw new Error('--launch is not supported with --all. Connect a single client to launch it.');
             }
             const exitCode = await runConnectAll({
                 apiKey: options.apiKey,
@@ -603,15 +603,15 @@ export function registerConnect(program) {
             return;
         }
         if (options.dryRun || options.uninstall || options.skipLaunch) {
-            throw new Error("--dry-run, --uninstall and --skip-launch are only supported with --all.");
+            throw new Error('--dry-run, --uninstall and --skip-launch are only supported with --all.');
         }
         if (!client) {
             if (options.launch) {
-                throw new Error("--launch is not supported with --all. Connect a single client to launch it.");
+                throw new Error('--launch is not supported with --all. Connect a single client to launch it.');
             }
             const humanInitiated = detectHumanInitiated();
             if (!humanInitiated) {
-                errLine("No terminal detected: connecting every detected harness (same as tinyfish connect --all).");
+                errLine('No terminal detected: connecting every detected harness (same as tinyfish connect --all).');
             }
             const exitCode = await runConnectAll({
                 apiKey: options.apiKey,
@@ -642,9 +642,9 @@ export function registerConnect(program) {
             await connector(connectOptions);
         }
         else {
-            throw new Error("Unsupported client: " +
+            throw new Error('Unsupported client: ' +
                 client +
-                ". Supported clients: claude-code, codex, cursor, grok, hermes, openclaw, opencode");
+                '. Supported clients: claude-code, codex, cursor, grok, hermes, openclaw, opencode');
         }
         // Deferred to here so the notice lands after install output, not interleaved with it.
         emitNotice();