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

package/dist/lib/connect-native.js

@@ -17,6 +17,7 @@ import { dotenvMarkerHead, harnessDotenvPath, writeDotenvKey } from './dotenv-fi
 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-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 { 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

@@ -5,9 +5,12 @@ 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/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/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.464",
   "description": "TinyFish CLI — run web automations from your terminal",
   "type": "module",
   "bin": {