@tiny-fish/cli 0.57.0 → 0.57.1-next.465

package/dist/commands/auth.js

@@ -2,8 +2,8 @@ import { spawn } from 'child_process';
 import * as readline from 'readline';
 import { Option } from 'commander';
 import { CONNECT_ATTEMPT_ENV, clearConfig, getDashboardUrl, loadConfig, maskKey, persistApiKeyToEnvironment, savePendingConnectAttempt, saveConfig, validateKeyFormat, } from '../lib/auth.js';
-import { createStdinPrompt } from '../lib/connect-fallback.js';
-import { ConnectInterruptedError } from '../lib/connect-runtime.js';
+import { createStdinPrompt } from '../lib/connect/connect-fallback.js';
+import { ConnectInterruptedError } from '../lib/connect/connect-runtime.js';
 import { TINYFISH_API_KEY_VAR } from '../lib/constants.js';
 import { err, errLine, out, outLine, warnLine } from '../lib/output.js';
 import { verifyMcpAuth } from '../lib/verify.js';

package/dist/commands/connect.js

@@ -2,16 +2,16 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { Option } from 'commander';
 import { saveConnectConfigDir, validateKeyFormat, validatedApiKey } from '../lib/auth.js';
-import { runConnectAll } from '../lib/connect-all.js';
+import { runConnectAll } from '../lib/connect/connect-all.js';
 import { ALL_HARNESSES } from '../lib/harness/harness-detect.js';
 import { HARNESS_CHOICES, resolveHarnessName } from '../lib/harness/harness-spec.js';
 import { detectHumanInitiated } from '../lib/harness.js';
 import { emitNotice } from '../lib/notice.js';
 import { errLine } from '../lib/output.js';
 import { z } from 'zod';
-import { gateApiKey } from '../lib/connect-preflight.js';
+import { gateApiKey } from '../lib/connect/connect-preflight.js';
 import { DEFAULT_MCP_URL } from '../lib/mcp-endpoint.js';
-import { connectHarness } from '../lib/connect-harness.js';
+import { connectHarness } from '../lib/connect/connect-harness.js';
 // The route 400s anything else, losing the event; drop it instead.
 const TRIGGER_FORMAT = /^[a-z0-9-]{1,32}$/;
 /** Cline reads CLINE_DIR itself, so setting it steers the add, the remove and our own probe. */

package/dist/commands/onboard.js

@@ -3,7 +3,7 @@ import { getApiKey, saveConfig } from '../lib/auth.js';
 import { fetchContentGet, searchQuery } from '../lib/client.js';
 import { BASE_URL, TINYFISH_API_KEY_VAR } from '../lib/constants.js';
 import { errLine, handleApiError, outLine } from '../lib/output.js';
-import { connectHarness, launchAgent } from '../lib/connect-harness.js';
+import { connectHarness, launchAgent } from '../lib/connect/connect-harness.js';
 import { HARNESS_DISPLAY_NAMES } from '../lib/harness/harness-detect.js';
 const EXAMPLE_QUERIES = [
     'What are recent changes in the AI dev stack? Give me the top 5 changes that matter, why they matter, and any action needed.',

package/dist/commands/profile.js

@@ -354,7 +354,7 @@ function signInNextStep(profileId) {
 async function handOffSignIn(profile, opts, created) {
     const setupUrl = profileSetupUrl(profile.id, opts.site);
     if (detectHumanInitiated()) {
-        const { openExternalUrl } = await import('../lib/connect-clients.js');
+        const { openExternalUrl } = await import('../lib/connect/connect-clients.js');
         openExternalUrl(setupUrl);
     }
     if (!opts.pretty) {

package/dist/commands/upgrade.js

@@ -8,7 +8,7 @@ import { sendUpgradeCompleted, telemetryDisabled, } from '../lib/setup-telemetry
 import { installSignalGuard, SIGNAL_EXIT_CODES } from '../lib/signals.js';
 import { installTinyFishCli } from '../lib/cli-install.js';
 import { updateWebSkill } from '../lib/skill-install.js';
-import { ConnectInterruptedError } from '../lib/connect-runtime.js';
+import { ConnectInterruptedError } from '../lib/connect/connect-runtime.js';
 const VERSION_READ_TIMEOUT_MS = 2_000;
 const INTERRUPTED_MESSAGE = 'Upgrade interrupted — run `tinyfish upgrade` again to finish.';
 function attempt(label, run) {

package/dist/lib/claude-plugin.js

@@ -2,7 +2,7 @@ import spawn from 'cross-spawn';
 import { z } from 'zod';
 import { loadConfig, matchesCliKey } from './auth.js';
 import { captureStdio, capturedOutput, replay } from './cli-install.js';
-import { throwIfInterrupted } from './connect-runtime.js';
+import { throwIfInterrupted } from './connect/connect-runtime.js';
 import { CLAUDE_PLUGIN_ID, HARNESS_PROBE_TIMEOUT_MS, PLUGIN_CONNECT_ATTEMPT_VAR, TINYFISH_API_KEY_VAR, } from './constants.js';
 import { claudeSettingsPath, readSettingsEnv, writeSettingsEnv } from './config/claude-config.js';
 import { noColourEnv, parseJson } from './output.js';

package/dist/lib/cli-install.js

@@ -1,5 +1,5 @@
 import spawn from 'cross-spawn';
-import { spawnStepError } from './connect-runtime.js';
+import { spawnStepError } from './connect/connect-runtime.js';
 import { TINYFISH_CLI_PACKAGE } from './constants.js';
 import { installRoot } from './install-root.js';
 import { errLine } from './output.js';

package/dist/lib/config/connect-config-file.d.ts

@@ -1,5 +1,5 @@
-import { type OnWalkthroughDecided, type WalkthroughOutcome } from '../connect-clients.js';
-import { type ConnectAuthMode } from '../connect-runtime.js';
+import { type OnWalkthroughDecided, type WalkthroughOutcome } from '../connect/connect-clients.js';
+import { type ConnectAuthMode } from '../connect/connect-runtime.js';
 import { cursorMcpPath, writeCursorMcpConfig } from './cursor-config.js';
 import { commandCodeMcpPath, writeCommandCodeMcpConfig } from './command-code-config.js';
 import { ompMcpPath, writeOmpMcpConfig } from './omp-config.js';

package/dist/lib/config/connect-config-file.js

@@ -1,9 +1,9 @@
 import { z } from 'zod';
 import { CONNECT_SOURCE, saveConnectContext, validatedApiKey } from '../auth.js';
-import { CURSOR_SKILL_TARGET, KEYLESS_ONBOARDING_PROMPT, launchCommandCodeWalkthrough, launchOmpWalkthrough, launchPiWalkthrough, openExternalUrl, } from '../connect-clients.js';
-import { ensureCliAuthenticated } from '../connect-auth.js';
+import { CURSOR_SKILL_TARGET, KEYLESS_ONBOARDING_PROMPT, launchCommandCodeWalkthrough, launchOmpWalkthrough, launchPiWalkthrough, openExternalUrl, } from '../connect/connect-clients.js';
+import { ensureCliAuthenticated } from '../connect/connect-auth.js';
 import { installWebSkill } from '../skill-install.js';
-import { ConnectStepError, createConnectTelemetry, runGuarded, settle, } from '../connect-runtime.js';
+import { ConnectStepError, createConnectTelemetry, runGuarded, settle, } from '../connect/connect-runtime.js';
 import { cursorInstallDeeplink, cursorMcpPath, readCursorTinyfishEntry, writeCursorMcpConfig, } from './cursor-config.js';
 import { commandCodeMcpPath, readCommandCodeTinyfishEntry, writeCommandCodeMcpConfig, } from './command-code-config.js';
 import { ompMcpPath, readOmpTinyfishEntry, writeOmpMcpConfig } from './omp-config.js';
@@ -14,7 +14,7 @@ import { detectHumanInitiated } from '../harness.js';
 import { errLine } from '../output.js';
 import { verifyMcpAuth } from '../verify.js';
 import { apiBaseFromMcpUrl } from '../mcp-endpoint.js';
-import { finishSetupHint, requireKeylessMcp, trackPostInstallFailure, walkthroughPhase, } from '../connect-steps.js';
+import { finishSetupHint, requireKeylessMcp, trackPostInstallFailure, walkthroughPhase, } from '../connect/connect-steps.js';
 const PI_RELOAD_COPY = 'TinyFish is configured in pi. Restart pi, then run `/mcp-auth tinyfish` there if it asks you ' +
     'to sign in.';
 // The skill is the working path either way, so the note must not read as a failure.

package/dist/lib/config/omp-config.js

@@ -1,6 +1,6 @@
 import * as path from 'path';
 import spawn from 'cross-spawn';
-import { ConnectStepError } from '../connect-runtime.js';
+import { ConnectStepError } from '../connect/connect-runtime.js';
 import { HARNESS_PROBE_TIMEOUT_MS } from '../constants.js';
 import { buildTinyfishKeylessServerEntry, planWrite, readTinyfishEntry, removeServer, writeMcpConfig, } from './mcp-json-config.js';
 const UNRESOLVED_REASON = '`omp config path` did not report a config directory';

package/dist/lib/{connect-all-auth.js → connect/connect-all-auth.js}

@@ -1,8 +1,8 @@
 import { NATIVE_BY_HARNESS } from './connect-clients.js';
-import { harnessSpec } from './harness/harness-spec.js';
+import { harnessSpec } from '../harness/harness-spec.js';
 import { ConnectInterruptedError, ConnectStepError, SignInTimeoutError, probeSupportVariant, } from './connect-runtime.js';
-import { ALL_HARNESSES, HARNESS_DISPLAY_NAMES as DISPLAY_NAMES, } from './harness/harness-detect.js';
-import { errLine } from './output.js';
+import { ALL_HARNESSES, HARNESS_DISPLAY_NAMES as DISPLAY_NAMES, } from '../harness/harness-detect.js';
+import { errLine } from '../output.js';
 // Must undercut agent tool-call budgets (Claude Code Bash defaults to 120s).
 export const OAUTH_SIGN_IN_TIMEOUT_MS = 90_000;
 // A probe that exits non-zero is an install so old the subcommand is missing entirely.

package/dist/lib/{connect-all-summary.js → connect/connect-all-summary.js}

@@ -1,6 +1,6 @@
 import { finishSetupCommand } from './connect-runtime.js';
-import { harnessSpec } from './harness/harness-spec.js';
-import { HARNESS_COMMANDS, HARNESS_DISPLAY_NAMES as DISPLAY_NAMES, RELOAD_ACTION, } from './harness/harness-detect.js';
+import { harnessSpec } from '../harness/harness-spec.js';
+import { HARNESS_COMMANDS, HARNESS_DISPLAY_NAMES as DISPLAY_NAMES, RELOAD_ACTION, } from '../harness/harness-detect.js';
 // Naming a harness the user does not have is the noise PF-3708 cut.
 const HIDDEN_ONCE_SOMETHING_WORKED = new Set([
     'deselected',

package/dist/lib/{connect-all-uninstall.d.ts → connect/connect-all-uninstall.d.ts}

@@ -1,4 +1,4 @@
-import { type Harness } from './harness/harness-detect.js';
+import { type Harness } from '../harness/harness-detect.js';
 import type { HarnessRunResult } from './connect-all.js';
 export declare function planText(harness: Harness, mcpUrl: string, apiKey?: string): string;
 export declare function uninstallPlanText(harness: Harness): string;

package/dist/lib/{connect-all-uninstall.js → connect/connect-all-uninstall.js}

@@ -1,21 +1,21 @@
 import * as path from 'path';
-import { clearConnectContext, connectContextState } from './auth.js';
+import { clearConnectContext, connectContextState } from '../auth.js';
 import { NATIVE_BY_HARNESS, openclawSkillUninstall } from './connect-clients.js';
 import { ConnectInterruptedError, spawnRemoval } from './connect-runtime.js';
-import { removeCursorMcpServer, planCursorWrite } from './config/cursor-config.js';
-import { commandCodeMcpPath, planCommandCodeWrite, removeCommandCodeMcpServer, } from './config/command-code-config.js';
-import { planOmpWrite, removeOmpMcpServer } from './config/omp-config.js';
-import { piMcpPath, planPiWrite, removePiMcpServer } from './config/pi-config.js';
-import { HERMES_KEY_VAR, hermesEnvPath, removeHermesKey, resolveHermesHome } from './hermes-env.js';
-import { clearHermesWebBackends } from './hermes-plugin.js';
-import { removeClaudeSettingsKey } from './claude-plugin.js';
-import { claudeSettingsPath } from './config/claude-config.js';
-import { HARNESS_DISPLAY_NAMES as DISPLAY_NAMES, harnessDisplayPath, } from './harness/harness-detect.js';
-import { ALL_HARNESSES, harnessSpec } from './harness/harness-spec.js';
-import { skillRootDir } from './skill-paths.js';
-import { removeWebSkills } from './skill-vendor.js';
-import { isOpencodeStyle, opencodeStyleConfigPath } from './config/opencode-config.js';
-import { errLine } from './output.js';
+import { removeCursorMcpServer, planCursorWrite } from '../config/cursor-config.js';
+import { commandCodeMcpPath, planCommandCodeWrite, removeCommandCodeMcpServer, } from '../config/command-code-config.js';
+import { planOmpWrite, removeOmpMcpServer } from '../config/omp-config.js';
+import { piMcpPath, planPiWrite, removePiMcpServer } from '../config/pi-config.js';
+import { HERMES_KEY_VAR, hermesEnvPath, removeHermesKey, resolveHermesHome, } from '../hermes-env.js';
+import { clearHermesWebBackends } from '../hermes-plugin.js';
+import { removeClaudeSettingsKey } from '../claude-plugin.js';
+import { claudeSettingsPath } from '../config/claude-config.js';
+import { HARNESS_DISPLAY_NAMES as DISPLAY_NAMES, harnessDisplayPath, } from '../harness/harness-detect.js';
+import { ALL_HARNESSES, harnessSpec } from '../harness/harness-spec.js';
+import { skillRootDir } from '../skill-paths.js';
+import { removeWebSkills } from '../skill-vendor.js';
+import { isOpencodeStyle, opencodeStyleConfigPath } from '../config/opencode-config.js';
+import { errLine } from '../output.js';
 export function planText(harness, mcpUrl, apiKey) {
     if (harness === 'cursor')
         return planCursorWrite(mcpUrl, apiKey);

package/dist/lib/{connect-all.d.ts → connect/connect-all.d.ts}

@@ -1,5 +1,5 @@
-import { type Harness, type HarnessDetection } from './harness/harness-detect.js';
-import { type VerifyDepth } from './verify.js';
+import { type Harness, type HarnessDetection } from '../harness/harness-detect.js';
+import { type VerifyDepth } from '../verify.js';
 export type Outcome = 'not_detected' | 'not_installed' | 'stale_config' | 'needs_first_run' | 'installed' | 'failed' | 'harness_too_old' | 'interrupted' | 'auth_pending' | 'no_tty_auth_skip' | 'uninstalled' | 'uninstall_noop' | 'uninstall_pointer' | 'dry_run' | 'not_reached' | 'deselected';
 export type HarnessResultBase = {
     harness: Harness;

package/dist/lib/{connect-all.js → connect/connect-all.js}

@@ -1,11 +1,11 @@
-import { CLAUDE_PLUGIN_SERVER, connectedViaClaudePlugin } from './claude-plugin.js';
+import { CLAUDE_PLUGIN_SERVER, connectedViaClaudePlugin } from '../claude-plugin.js';
 import * as readline from 'node:readline/promises';
-import { harnessSpec } from './harness/harness-spec.js';
+import { harnessSpec } from '../harness/harness-spec.js';
 import spawn from 'cross-spawn';
 import { connectHarness } from './connect-harness.js';
-import { loadConfig, validatedApiKey } from './auth.js';
-import { installTinyFishCli, } from './cli-install.js';
-import { cliInstallNeeded } from './cli-presence.js';
+import { loadConfig, validatedApiKey } from '../auth.js';
+import { installTinyFishCli, } from '../cli-install.js';
+import { cliInstallNeeded } from '../cli-presence.js';
 import { authGate, mapConnectError, OAUTH_SIGN_IN_TIMEOUT_MS } from './connect-all-auth.js';
 import { actionable, computeExitCode, reloadHint, renderSummary } from './connect-all-summary.js';
 import { planText, uninstallHarness, uninstallPlanText } from './connect-all-uninstall.js';
@@ -14,12 +14,12 @@ import { KEYLESS_ONBOARDING_PROMPT, useServerLine } from './connect-clients.js';
 import { gateApiKey } from './connect-preflight.js';
 import { ConnectInterruptedError } from './connect-runtime.js';
 import { pickHarnesses } from './connect-picker.js';
-import { commandOnPath, detectInstalledHarnesses, isStaleConfig, AuthMode, HARNESS_COMMANDS, HARNESS_DISPLAY_NAMES as DISPLAY_NAMES, ALL_HARNESSES, } from './harness/harness-detect.js';
-import { detectHumanInitiated } from './harness.js';
-import { emitNotice } from './notice.js';
-import { errLine, outLine, setErrIndent } from './output.js';
-import { sendSetupCompleted, sendSetupStarted, } from './setup-telemetry.js';
-import { verifyMcpAuth, verifyMcpHealth } from './verify.js';
+import { commandOnPath, detectInstalledHarnesses, isStaleConfig, AuthMode, HARNESS_COMMANDS, HARNESS_DISPLAY_NAMES as DISPLAY_NAMES, ALL_HARNESSES, } from '../harness/harness-detect.js';
+import { detectHumanInitiated } from '../harness.js';
+import { emitNotice } from '../notice.js';
+import { errLine, outLine, setErrIndent } from '../output.js';
+import { sendSetupCompleted, sendSetupStarted, } from '../setup-telemetry.js';
+import { verifyMcpAuth, verifyMcpHealth } from '../verify.js';
 const STEP_INDENT = '  ';
 /** Undefined means Ctrl+C: the caller stops the whole run. */
 function runHoistedCliInstall(verbose) {

package/dist/lib/{connect-auth.js → connect/connect-auth.js}

@@ -1,8 +1,8 @@
 import spawn from 'cross-spawn';
-import { TINYFISH_API_KEY_VAR } from './constants.js';
-import { persistApiKeyToEnvironment, validateKeyFormat, writeConfig } from './auth.js';
+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';
+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];

package/dist/lib/{connect-clients.d.ts → connect/connect-clients.d.ts}

@@ -1,7 +1,7 @@
 import spawn from 'cross-spawn';
 import { type AgentClient, type SupportedCommand } from './connect-runtime.js';
-import { type HarnessSpec, type SkillAgent } from './harness/harness-spec.js';
-import { installClaudeDirectoryPlugin } from './claude-plugin.js';
+import { type HarnessSpec, type SkillAgent } from '../harness/harness-spec.js';
+import { installClaudeDirectoryPlugin } from '../claude-plugin.js';
 export declare function openclawSkillInstallArgs(ackFlag: string | undefined): string[];
 /** `openclaw skills` has no uninstall; ClawHub removes from the global dir. */
 export declare function openclawSkillUninstall(): {

package/dist/lib/{connect-clients.js → connect/connect-clients.js}

@@ -1,15 +1,15 @@
 import spawn from 'cross-spawn';
-import { SKILL_INSTALL_TIMEOUT_MS } from './cli-install.js';
-import { detectHumanInitiated } from './harness.js';
-import { harnessConfigPath } from './harness/harness-detect.js';
-import { errLine, sanitizeLine, warnLine } from './output.js';
+import { SKILL_INSTALL_TIMEOUT_MS } from '../cli-install.js';
+import { detectHumanInitiated } from '../harness.js';
+import { harnessConfigPath } from '../harness/harness-detect.js';
+import { errLine, sanitizeLine, warnLine } from '../output.js';
 import { ConnectInterruptedError, ConnectStepError, spawnStepError, } from './connect-runtime.js';
-import { TINYFISH_API_KEY_VAR } from './constants.js';
-import { HARNESS_SPECS, NATIVE_HARNESSES, harnessSpec, } from './harness/harness-spec.js';
-import { HERMES_KEY_VAR, captureHermesKeyRestore, hermesEnvPath, resolveHermesHome, writeHermesKey, } from './hermes-env.js';
-import { hermesConfigPath, readHermesEntry } from './config/hermes-config.js';
-import { installHermesPlugin, removeHermesMcpEntry, setHermesWebBackends, writeHermesMcpEntry, } from './hermes-plugin.js';
-import { CLAUDE_PLUGIN_SERVER, installClaudeDirectoryPlugin } from './claude-plugin.js';
+import { TINYFISH_API_KEY_VAR } from '../constants.js';
+import { HARNESS_SPECS, NATIVE_HARNESSES, harnessSpec, } from '../harness/harness-spec.js';
+import { HERMES_KEY_VAR, captureHermesKeyRestore, hermesEnvPath, resolveHermesHome, writeHermesKey, } from '../hermes-env.js';
+import { hermesConfigPath, readHermesEntry } from '../config/hermes-config.js';
+import { installHermesPlugin, removeHermesMcpEntry, setHermesWebBackends, writeHermesMcpEntry, } from '../hermes-plugin.js';
+import { CLAUDE_PLUGIN_SERVER, installClaudeDirectoryPlugin } from '../claude-plugin.js';
 const HERMES_SEED_TIMEOUT_MS = 120_000;
 const OPENCLAW_SKILL = '@tinyfish/tinyfish';
 // --force makes this an unconditional overwrite, so the same call installs and refreshes.

package/dist/lib/{connect-fallback.js → connect/connect-fallback.js}

@@ -1,12 +1,12 @@
 import * as readline from 'node:readline/promises';
 import spawn from 'cross-spawn';
-import { resolvedApiKey, validateKeyFormat } from './auth.js';
-import { installTinyFishCli } from './cli-install.js';
-import { cliInstallNeeded } from './cli-presence.js';
+import { resolvedApiKey, validateKeyFormat } from '../auth.js';
+import { installTinyFishCli } from '../cli-install.js';
+import { cliInstallNeeded } from '../cli-presence.js';
 import { ensureCliAuthenticated, TINYFISH_CLI_NOT_FOUND_MESSAGE } from './connect-auth.js';
-import { TINYFISH_API_KEY_VAR } from './constants.js';
+import { TINYFISH_API_KEY_VAR } from '../constants.js';
 import { commandNotFound, ConnectInterruptedError, ConnectStepError, throwIfInterrupted, } from './connect-runtime.js';
-import { errLine, outLine } from './output.js';
+import { errLine, outLine } from '../output.js';
 export const SEARCH_RETRY = 'tinyfish search query --pretty -- "<your query>"';
 // Echoes the finale suggestion, so headless rescues rehearse the same task.
 export const DEFAULT_VERIFICATION_QUERY = "today's top Hacker News story";

package/dist/lib/{connect-harness.js → connect/connect-harness.js}

@@ -1,8 +1,8 @@
 import { NATIVE_BY_HARNESS, launchNativeMcpClient, launchCommandCodeWalkthrough, launchOmpWalkthrough, launchPiWalkthrough, launchOpenClawWalkthrough, } from './connect-clients.js';
-import { errLine } from './output.js';
+import { errLine } from '../output.js';
 import { connectNativeMcpClient } from './connect-native.js';
 import { connectOpenClaw } from './connect-openclaw.js';
-import { connectConfigFileHarness, connectCursor } from './config/connect-config-file.js';
+import { connectConfigFileHarness, connectCursor } from '../config/connect-config-file.js';
 /** Total over the non-native harnesses: a new one fails to compile until wired here. */
 const LAUNCH_OVERRIDES = {
     omp: () => launchOmpWalkthrough(),

package/dist/lib/{connect-native.js → connect/connect-native.js}

@@ -1,22 +1,23 @@
 import spawn from 'cross-spawn';
-import { CONNECT_SOURCE, persistApiKeyToEnvironment, saveConnectContext, validatedApiKey, } from './auth.js';
+import { CONNECT_SOURCE, persistApiKeyToEnvironment, saveConnectContext, validatedApiKey, } from '../auth.js';
 import { KEYLESS_ONBOARDING_PROMPT, launchNativeMcpClient, onboardingPrompt, } from './connect-clients.js';
-import { captureStdio, capturedOutput, replay, SKILL_INSTALL_TIMEOUT_MS, STEP_MAX_BUFFER, } from './cli-install.js';
+import { captureStdio, capturedOutput, replay, SKILL_INSTALL_TIMEOUT_MS, STEP_MAX_BUFFER, } from '../cli-install.js';
 import { ensureCliAuthenticated } from './connect-auth.js';
-import { installWebSkill } from './skill-install.js';
-import { waitForSignInUrl } from './sign-in-url.js';
+import { installWebSkill } from '../skill-install.js';
+import { waitForSignInUrl } from '../sign-in-url.js';
 import { ConnectInterruptedError, ConnectStepError, createConnectTelemetry, runGuarded, settle, SignInTimeoutError, spawnRemoval, spawnStepError, } from './connect-runtime.js';
-import { DASHBOARD_URL, TINYFISH_API_KEY_VAR } from './constants.js';
-import { strayProjectKeyFiles } from './config/opencode-config.js';
-import { AuthMode, HARNESS_COMMANDS, RELOAD_ACTION, resolveCommand, } from './harness/harness-detect.js';
-import { opencodeStrayKeyNote } from './harness/harness-messages.js';
-import { SIGN_IN_PROBES, TINYFISH_LIST_ROW } from './registration-detect.js';
-import { errLine, sanitizeLine, warnLine } from './output.js';
-import { verifyMcpAuth } from './verify.js';
-import { dotenvMarkerHead, harnessDotenvPath, writeDotenvKey } from './dotenv-file.js';
-import { apiBaseFromMcpUrl, isDefaultEndpoint } from './mcp-endpoint.js';
-import { removeWebSkills } from './skill-vendor.js';
+import { DASHBOARD_URL, TINYFISH_API_KEY_VAR } from '../constants.js';
+import { strayProjectKeyFiles } from '../config/opencode-config.js';
+import { AuthMode, HARNESS_COMMANDS, RELOAD_ACTION, resolveCommand, } from '../harness/harness-detect.js';
+import { opencodeStrayKeyNote } from '../harness/harness-messages.js';
+import { SIGN_IN_PROBES, TINYFISH_LIST_ROW } from '../registration-detect.js';
+import { errLine, sanitizeLine, warnLine } from '../output.js';
+import { verifyMcpAuth } from '../verify.js';
+import { dotenvMarkerHead, harnessDotenvPath, writeDotenvKey } from '../dotenv-file.js';
+import { apiBaseFromMcpUrl, isDefaultEndpoint } from '../mcp-endpoint.js';
+import { removeWebSkills } from '../skill-vendor.js';
 import { finishSetupHint, requireKeylessMcp, requireSupportOrRescue, runCliInstallStep, trackPostInstallFailure, walkthroughPhase, } from './connect-steps.js';
+import { SUGGESTED_PROMPTS } from '../suggested-prompt.js';
 /** Several installs can disagree; every later spawn reuses this one. */
 function pinExecutable(client) {
     const resolved = resolveCommand(client.command);
@@ -446,6 +447,28 @@ export async function connectNativeMcpClient(unpinned, options) {
     });
     return state.authMode;
 }
+/** `cli_connect_suggested_prompt` A/B; control records exposure without printing. */
+async function printSuggestedPrompt(client, telemetry) {
+    if (client.connectClient !== 'claude-code')
+        return;
+    const variant = await telemetry.suggestedPromptVariant();
+    if (!variant)
+        return;
+    const line = SUGGESTED_PROMPTS[variant];
+    if (line)
+        errLine(line);
+    telemetry.track('checkpoint', {
+        phase: 'suggested_prompt_shown',
+        suggestedPromptVariant: variant,
+    });
+}
+async function printConnectedMessage(client, options, telemetry, signInDeferred, failed) {
+    // Under --all the summary replaces this; sign-in hints still print.
+    if (signInDeferred || !options.deferOutro)
+        errLine(connectedLine(client, signInDeferred));
+    if (!options.deferOutro && !failed)
+        await printSuggestedPrompt(client, telemetry);
+}
 function connectedLine(client, signInDeferred) {
     // The CLI never observes deferred auth, so don't claim "connected".
     if (signInDeferred) {
@@ -528,9 +551,7 @@ async function runPostInstallSteps(client, options, state, telemetry, signInDefe
         if (client.postConnectNote)
             errLine(client.postConnectNote);
         if (!options.launch) {
-            // Under --all the summary replaces this; sign-in hints still print.
-            if (signInDeferred || !options.deferOutro)
-                errLine(connectedLine(client, signInDeferred));
+            await printConnectedMessage(client, options, telemetry, signInDeferred, failed);
         }
         else {
             await attempt('walkthrough_launch', async () => {

package/dist/lib/{connect-openclaw.js → connect/connect-openclaw.js}

@@ -1,11 +1,11 @@
 import spawn from 'cross-spawn';
-import { saveConnectContext } from './auth.js';
+import { saveConnectContext } from '../auth.js';
 import { OPENCLAW, openclawSkillInstallArgs, launchOpenClawWalkthrough, } from './connect-clients.js';
-import { captureStdio, capturedOutput, replay } from './cli-install.js';
+import { captureStdio, capturedOutput, replay } from '../cli-install.js';
 import { ensureCliAuthenticated } from './connect-auth.js';
 import { createConnectTelemetry, runGuarded, settle, spawnStepError, } from './connect-runtime.js';
-import { RELOAD_ACTION } from './harness/harness-detect.js';
-import { errLine } from './output.js';
+import { RELOAD_ACTION } from '../harness/harness-detect.js';
+import { errLine } from '../output.js';
 import { finishSetupHint, requireSupportOrRescue, runCliInstallStep, trackPostInstallFailure, walkthroughPhase, } from './connect-steps.js';
 /** Skill install only: no key handoff or post-install callback to honour. */
 export async function connectOpenClaw(options) {

package/dist/lib/{connect-picker.d.ts → connect/connect-picker.d.ts}

@@ -1,5 +1,5 @@
 import type { Readable } from 'node:stream';
-import { type Harness, type HarnessDetection } from './harness/harness-detect.js';
+import { type Harness, type HarnessDetection } from '../harness/harness-detect.js';
 type PickSelection = Harness[] | 'cancel';
 export interface PickResult {
     selection: PickSelection;

package/dist/lib/{connect-picker.js → connect/connect-picker.js}

@@ -1,5 +1,5 @@
 import * as readline from 'node:readline';
-import { HARNESS_DISPLAY_NAMES, } from './harness/harness-detect.js';
+import { HARNESS_DISPLAY_NAMES, } from '../harness/harness-detect.js';
 const KEY_HELP = '  ↑↓ move   space toggle one   a none/all   q cancel';
 function header(count) {
     return `Found ${count} agent config${count === 1 ? '' : 's'} on this machine.\n\n`;

package/dist/lib/{connect-preflight.d.ts → connect/connect-preflight.d.ts}

@@ -1,4 +1,4 @@
-import { type SetupBlockedMode } from './setup-telemetry.js';
+import { type SetupBlockedMode } from '../setup-telemetry.js';
 export type PreflightOutcome = 'ok' | 'blocked';
 interface PreflightOptions {
     apiKey?: string;

package/dist/lib/{connect-preflight.js → connect/connect-preflight.js}

@@ -1,9 +1,9 @@
-import { apiKeyStatus, configFile, validateKeyFormat } from './auth.js';
-import { TINYFISH_API_KEY_VAR } from './constants.js';
-import { apiBaseFromMcpUrl } from './mcp-endpoint.js';
-import { errLine, warnLine } from './output.js';
-import { sendSetupBlocked, } from './setup-telemetry.js';
-import { verifyMcpAuth } from './verify.js';
+import { apiKeyStatus, configFile, validateKeyFormat } from '../auth.js';
+import { TINYFISH_API_KEY_VAR } from '../constants.js';
+import { apiBaseFromMcpUrl } from '../mcp-endpoint.js';
+import { errLine, warnLine } from '../output.js';
+import { sendSetupBlocked, } from '../setup-telemetry.js';
+import { verifyMcpAuth } from '../verify.js';
 function sourceAdvice(source) {
     switch (source) {
         case 'env':

package/dist/lib/{connect-runtime.d.ts → connect/connect-runtime.d.ts}

@@ -1,6 +1,7 @@
-import { AuthMode } from './harness/harness-detect.js';
-import type { Harness, HarnessSupportCheck } from './harness/harness-spec.js';
-import type { PiAdapterState } from './config/pi-config.js';
+import { AuthMode } from '../harness/harness-detect.js';
+import type { Harness, HarnessSupportCheck } from '../harness/harness-spec.js';
+import type { PiAdapterState } from '../config/pi-config.js';
+import { type SuggestedPromptVariant } from '../suggested-prompt.js';
 export declare const NON_INTERACTIVE_TIMEOUT_MS = 10000;
 export type AgentClient = Harness;
 type ConnectStage = 'started' | 'checkpoint' | 'completed' | 'failed' | 'aborted' | 'post_install_failed';
@@ -8,7 +9,7 @@ export type ConnectFailureStage = 'prerequisite_check' | 'registration_cleanup'
 export declare const CONNECT_FAILURE_REASONS: readonly ["harness_not_installed", "harness_command_unsupported", "harness_too_old", "key_auth_unsupported", "command_not_found", "timeout", "spawn_error", "nonzero_exit", "invalid_config", "user_abandoned", "process_terminated", "unexpected_error"];
 export type ConnectFailureReason = (typeof CONNECT_FAILURE_REASONS)[number];
 export type ConnectAuthMode = Exclude<AuthMode, AuthMode.Unknown> | 'deferred';
-export type ConnectCheckpoint = 'prerequisite_ok' | 'registered' | 'oauth_done' | 'cli_installed' | 'skill_installed' | 'plugin_installed' | 'authenticated' | 'cli_verified' | 'walkthrough_launched' | 'walkthrough_prompt_printed';
+export type ConnectCheckpoint = 'prerequisite_ok' | 'registered' | 'oauth_done' | 'cli_installed' | 'skill_installed' | 'plugin_installed' | 'authenticated' | 'cli_verified' | 'walkthrough_launched' | 'walkthrough_prompt_printed' | 'suggested_prompt_shown';
 export type CliFallbackOutcome = 'cli_verified' | 'cli_install_failed' | 'no_credentials' | 'invalid_credentials' | 'authentication_failed' | 'verification_failed' | 'abandoned';
 /** Ctrl+C killed a setup child — abandonment, not error. */
 export declare class ConnectInterruptedError extends Error {
@@ -83,6 +84,8 @@ interface ConnectStageDetail {
     piAdapterState?: PiAdapterState;
     /** claude-code only: why connect skipped the Directory plugin. */
     pluginFallbackReason?: string;
+    /** Only with `suggested_prompt_shown` (route refine). */
+    suggestedPromptVariant?: SuggestedPromptVariant;
 }
 export interface ConnectTelemetry {
     attemptId: string;
@@ -90,6 +93,8 @@ export interface ConnectTelemetry {
     setHarnessVersion(version?: string): void;
     setFallbackOutcome(outcome: CliFallbackOutcome): void;
     flush(): Promise<void>;
+    /** Waits up to 2s for in-flight events; the variant rides `completed`. */
+    suggestedPromptVariant(): Promise<SuggestedPromptVariant | undefined>;
 }
 /** Terminal events exactly once, whichever of flow or signal handler wins. */
 export declare function settle(state: ConnectRunState, telemetry: ConnectTelemetry, stage: ConnectStage, detail?: ConnectStageDetail): void;

package/dist/lib/{connect-runtime.js → connect/connect-runtime.js}

@@ -1,13 +1,16 @@
 import { randomUUID } from 'node:crypto';
 import spawn from 'cross-spawn';
-import { CONNECT_ATTEMPT_ENV, isAttemptId, resolvedApiKey, takePendingConnectAttempt, } from './auth.js';
-import { CLI_INVOCATION_ID, CLI_VERSION } from './constants.js';
-import { detectHarness, detectHumanInitiated, detectRuntimeEnv } from './harness.js';
-import { boundedVersion, errLine, noColourEnv, sanitizeLine } from './output.js';
-import { isOlder } from './cli-presence.js';
-import { postConnectEvent, telemetryDisabled } from './setup-telemetry.js';
-import { installSignalGuard } from './signals.js';
+import { CONNECT_ATTEMPT_ENV, isAttemptId, resolvedApiKey, takePendingConnectAttempt, } from '../auth.js';
+import { CLI_INVOCATION_ID, CLI_VERSION } from '../constants.js';
+import { detectHarness, detectHumanInitiated, detectRuntimeEnv } from '../harness.js';
+import { boundedVersion, errLine, noColourEnv, sanitizeLine } from '../output.js';
+import { isOlder } from '../cli-presence.js';
+import { parseSuggestedPromptVariant } from '../suggested-prompt.js';
+import { postConnectEvent, telemetryDisabled } from '../setup-telemetry.js';
+import { installSignalGuard } from '../signals.js';
 export const NON_INTERACTIVE_TIMEOUT_MS = 10_000;
+// One POST attempt; a retried `completed` skips the prompt instead of stalling connect.
+const SUGGESTED_PROMPT_WAIT_MS = 2_000;
 // Mirrors the route's Zod enum; tests both sides pin it.
 export const CONNECT_FAILURE_REASONS = [
     'harness_not_installed',
@@ -339,6 +342,10 @@ export function createConnectTelemetry(mcpUrl, client, opts) {
     let lastTrackAt;
     let harnessVersion;
     let fallbackOutcome;
+    let suggestedPromptVariant;
+    async function flush() {
+        await Promise.all(pending.splice(0));
+    }
     async function deliver(body) {
         // Ahead of the key read; postConnectEvent's own opt-out check is too late to skip it.
         if (telemetryDisabled())
@@ -350,6 +357,9 @@ export function createConnectTelemetry(mcpUrl, client, opts) {
             attempts: 2,
             apiKey: resolvedApiKey(opts?.apiKey),
             label: 'connect',
+            onResponse: (headers) => {
+                suggestedPromptVariant ??= parseSuggestedPromptVariant(headers);
+            },
         });
     }
     function eventBody(stage, detail, stageDurationMs) {
@@ -371,6 +381,7 @@ export function createConnectTelemetry(mcpUrl, client, opts) {
             harness_degraded: d.harnessDegraded,
             pi_adapter_state: d.piAdapterState,
             plugin_fallback_reason: d.pluginFallbackReason,
+            suggested_prompt_variant: d.suggestedPromptVariant,
             stage_duration_ms: stageDurationMs,
             runtime_platform: process.platform,
             node_version: process.version,
@@ -405,8 +416,14 @@ export function createConnectTelemetry(mcpUrl, client, opts) {
         },
         // Awaited in finally so in-flight events land before exit. Drains, so the signal-guard
         // flush and the finally flush do not re-await the same events.
-        async flush() {
-            await Promise.all(pending.splice(0));
+        flush,
+        async suggestedPromptVariant() {
+            // Snapshot, not drain: the final flush still awaits these.
+            await Promise.race([
+                Promise.all([...pending]),
+                new Promise((resolve) => setTimeout(resolve, SUGGESTED_PROMPT_WAIT_MS).unref()),
+            ]);
+            return suggestedPromptVariant;
         },
     };
 }

package/dist/lib/{connect-steps.d.ts → connect/connect-steps.d.ts}

@@ -1,4 +1,4 @@
-import { type TakeHoistedCliInstall } from './cli-install.js';
+import { type TakeHoistedCliInstall } from '../cli-install.js';
 import { type ConnectCheckpoint, requireCommandSupport, type AgentClient, type ConnectRunState, type ConnectTelemetry, type SupportedCommand } from './connect-runtime.js';
 import type { WalkthroughOutcome } from './connect-clients.js';
 export interface NativeConnectOptions {

package/dist/lib/{connect-steps.js → connect/connect-steps.js}

@@ -1,9 +1,9 @@
-import { verifyMcpHealth } from './verify.js';
-import { installTinyFishCli } from './cli-install.js';
-import { cliInstallNeeded } from './cli-presence.js';
+import { verifyMcpHealth } from '../verify.js';
+import { installTinyFishCli } from '../cli-install.js';
+import { cliInstallNeeded } from '../cli-presence.js';
 import { createStdinPrompt, runCliFallback } from './connect-fallback.js';
-import { detectHumanInitiated } from './harness.js';
-import { errLine } from './output.js';
+import { detectHumanInitiated } from '../harness.js';
+import { errLine } from '../output.js';
 import { ConnectInterruptedError, ConnectStepError, HoistedFailureReportedError, finishSetupCommand, requireCommandSupport, settle, stageDurationOf, withStageDuration, } from './connect-runtime.js';
 export async function requireKeylessMcp(mcpUrl) {
     if ((await verifyMcpHealth(mcpUrl, true)).ok)

package/dist/lib/doctor-repairs.js

@@ -1,6 +1,6 @@
 import spawn from 'cross-spawn';
-import { connectHarness } from './connect-harness.js';
-import { OAUTH_SIGN_IN_TIMEOUT_MS } from './connect-all-auth.js';
+import { connectHarness } from './connect/connect-harness.js';
+import { OAUTH_SIGN_IN_TIMEOUT_MS } from './connect/connect-all-auth.js';
 import { Registered } from './harness/harness-detect.js';
 import { detectHumanInitiated } from './harness.js';
 import { errLine } from './output.js';

package/dist/lib/hermes-env.js

@@ -2,7 +2,7 @@ import os from 'node:os';
 import path from 'node:path';
 import spawn from 'cross-spawn';
 import { HERMES_COLD_START_TIMEOUT_MS } from './constants.js';
-import { throwIfInterrupted } from './connect-runtime.js';
+import { throwIfInterrupted } from './connect/connect-runtime.js';
 import { noColourEnv, sanitizeLine } from './output.js';
 import { captureDotenvKeyRestore, dotenvMarkerHead, readDotenvKey, removeDotenvKey, writeDotenvKey, } from './dotenv-file.js';
 // display_hermes_home() abbreviates under $HOME, so the value is not always absolute.

package/dist/lib/hermes-plugin.js

@@ -1,7 +1,7 @@
 import spawn from 'cross-spawn';
 import { z } from 'zod';
 import { captureStdio, capturedOutput, replay, STEP_MAX_BUFFER, } from './cli-install.js';
-import { commandNotFound, ConnectStepError, spawnStepError, throwIfInterrupted, } from './connect-runtime.js';
+import { commandNotFound, ConnectStepError, spawnStepError, throwIfInterrupted, } from './connect/connect-runtime.js';
 import { HARNESS_PROBE_TIMEOUT_MS, TINYFISH_ACCESS_MODE_HEADER, TINYFISH_KEYLESS_ACCESS_MODE, } from './constants.js';
 import { HERMES_HEADER_TEMPLATE, HERMES_MCP_SERVER_KEY } from './config/hermes-config.js';
 import { errLine, noColourEnv, parseJson, sanitizeLine } from './output.js';

package/dist/lib/registration-detect.d.ts

@@ -1,5 +1,5 @@
 import { type RecordedAuthMode } from './auth.js';
-import type { AgentClient } from './connect-runtime.js';
+import type { AgentClient } from './connect/connect-runtime.js';
 import { AuthMode, type Harness, Registered } from './harness/harness-detect.js';
 export interface RegistrationStatus {
     harness: Harness;

package/dist/lib/registration-detect.js

@@ -3,7 +3,7 @@ import * as path from 'path';
 import spawn from 'cross-spawn';
 import { z } from 'zod';
 import { loadConfig, matchesCliKey } from './auth.js';
-import { NATIVE_BY_HARNESS } from './connect-clients.js';
+import { NATIVE_BY_HARNESS } from './connect/connect-clients.js';
 import { HARNESS_PROBE_TIMEOUT_MS } from './constants.js';
 import { errLine, noColourEnv } from './output.js';
 import { readClineTinyfishEntry } from './config/cline-config.js';

package/dist/lib/setup-telemetry.d.ts

@@ -19,6 +19,8 @@ export declare function postConnectEvent(options: {
     attempts: number;
     label: string;
     apiKey?: string;
+    /** Trusted origins only, like the notice. */
+    onResponse?: (headers: Headers) => void;
 }): Promise<void>;
 declare const harnessResultSchema: z.ZodObject<{
     harness: z.ZodEnum<{

package/dist/lib/setup-telemetry.js

@@ -53,7 +53,7 @@ function telemetryHeaders(endpoint, apiKey) {
  * being installed against, upgrade has none and uses BASE_URL.
  */
 export async function postConnectEvent(options) {
-    const { endpoint, body, attempts, label, apiKey } = options;
+    const { endpoint, body, attempts, label, apiKey, onResponse } = options;
     if (telemetryDisabled())
         return;
     // Swallows its own write failure so callers can treat this function as total.
@@ -80,8 +80,10 @@ export async function postConnectEvent(options) {
             });
             // Before the ok branch so a rejected event still yields a notice; gated on origin so a
             // `--url` host cannot print its own text as a TinyFish advisory.
-            if (trusted)
+            if (trusted) {
                 captureNotice(response.headers);
+                onResponse?.(response.headers);
+            }
             if (response.ok)
                 return;
             // 4xx will reject the same body again (schema mismatch, e.g. new stages on an old server).

package/dist/lib/sign-in-url.d.ts

@@ -1,4 +1,4 @@
-import type { SpawnStepResult } from './connect-runtime.js';
+import type { SpawnStepResult } from './connect/connect-runtime.js';
 export interface SignInUrlRun {
     url?: string;
     output: string;

package/dist/lib/skill-install.d.ts

@@ -1,5 +1,5 @@
 import { type InstallOptions } from './cli-install.js';
-import { type SkillAgent } from './connect-clients.js';
+import { type SkillAgent } from './connect/connect-clients.js';
 export declare function installWebSkill(client: {
     skillAgent?: SkillAgent;
     displayName: string;

package/dist/lib/skill-install.js

@@ -3,8 +3,8 @@ import * as path from 'node:path';
 import spawn from 'cross-spawn';
 import { loadConfig } from './auth.js';
 import { captureStdio, capturedOutput, replay } from './cli-install.js';
-import { OPENCLAW, openclawSkillInstallArgs } from './connect-clients.js';
-import { ConnectInterruptedError, ConnectStepError, probeSupportVariant, throwIfInterrupted, } from './connect-runtime.js';
+import { OPENCLAW, openclawSkillInstallArgs } from './connect/connect-clients.js';
+import { ConnectInterruptedError, ConnectStepError, probeSupportVariant, throwIfInterrupted, } from './connect/connect-runtime.js';
 import { WEB_SKILL_NAMES } from './constants.js';
 import { installedPackageDir, installRoot } from './install-root.js';
 import { ALL_HARNESSES, harnessSpec } from './harness/harness-spec.js';

package/dist/lib/skill-vendor.js

@@ -2,7 +2,7 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { bundledSkillsRoot } from './bundled-skill.js';
 import { LEGACY_SKILL_NAMES, WEB_SKILL_NAMES } from './constants.js';
-import { ConnectStepError } from './connect-runtime.js';
+import { ConnectStepError } from './connect/connect-runtime.js';
 import { errLine } from './output.js';
 import { skillLockPath, skillRootDir } from './skill-paths.js';
 // A younger staging dir may belong to a live concurrent connect.

package/dist/lib/suggested-prompt.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+declare const suggestedPromptVariantSchema: z.ZodEnum<{
+    search: "search";
+    control: "control";
+    fetch: "fetch";
+}>;
+export type SuggestedPromptVariant = z.infer<typeof suggestedPromptVariantSchema>;
+/** CLI-owned copy: the server sends only the key. Control prints nothing. */
+export declare const SUGGESTED_PROMPTS: Record<SuggestedPromptVariant, string | undefined>;
+/** Unknown or missing header = unenrolled. */
+export declare function parseSuggestedPromptVariant(headers: Headers): SuggestedPromptVariant | undefined;
+export {};

package/dist/lib/suggested-prompt.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+// Mirrors suggestedPromptVariantSchema in frontend/app/api/cli/connect-event/schemas.ts.
+const suggestedPromptVariantSchema = z.enum(['control', 'search', 'fetch']);
+const VARIANT_HEADER = 'x-tf-suggested-prompt-variant';
+/** CLI-owned copy: the server sends only the key. Control prints nothing. */
+export const SUGGESTED_PROMPTS = {
+    control: undefined,
+    search: 'Next: in Claude Code, ask "Use TinyFish to search the web for today\'s top AI news and summarize it."',
+    fetch: 'Next: in Claude Code, ask "Use TinyFish to fetch https://news.ycombinator.com and summarize the top 3 stories."',
+};
+/** Unknown or missing header = unenrolled. */
+export function parseSuggestedPromptVariant(headers) {
+    // A throw here would read as a failed POST and retry it.
+    if (typeof headers?.get !== 'function')
+        return undefined;
+    return suggestedPromptVariantSchema.safeParse(headers.get(VARIANT_HEADER)?.trim()).data;
+}

package/package.json

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