@tiny-fish/cli 0.31.1-next.271 → 0.31.1-next.272

package/dist/commands/connect.js

@@ -665,13 +665,14 @@ function parseMcpUrlOption(options) {
     }
     return { mcpUrl, attemptId };
 }
-async function connectAllPath(options, mcpUrl) {
+async function connectAllPath(options, mcpUrl, attemptId) {
     if (options.launch) {
         throw new Error('--launch is not supported with --all. Connect a single client to launch it.');
     }
     const exitCode = await runConnectAll({
         apiKey: options.apiKey,
         mcpUrl,
+        attemptId,
         dryRun: options.dryRun ?? false,
         uninstall: options.uninstall ?? false,
         noLaunch: options.skipLaunch === true,
@@ -681,7 +682,7 @@ async function connectAllPath(options, mcpUrl) {
     if (!process.exitCode)
         process.exitCode = exitCode;
 }
-async function connectPickPath(options, mcpUrl) {
+async function connectPickPath(options, mcpUrl, attemptId) {
     if (options.launch) {
         throw new Error('--launch is not supported with --all. Connect a single client to launch it.');
     }
@@ -692,6 +693,7 @@ async function connectPickPath(options, mcpUrl) {
     const exitCode = await runConnectAll({
         apiKey: options.apiKey,
         mcpUrl,
+        attemptId,
         dryRun: false,
         uninstall: false,
         pick: humanInitiated,
@@ -743,14 +745,14 @@ export function registerConnect(program) {
             if (client) {
                 throw new Error('Pass either a client or --all, not both.');
             }
-            await connectAllPath(options, mcpUrl);
+            await connectAllPath(options, mcpUrl, attemptId);
             return;
         }
         if (options.dryRun || options.uninstall || options.skipLaunch) {
             throw new Error('--dry-run, --uninstall and --skip-launch are only supported with --all.');
         }
         if (!client) {
-            await connectPickPath(options, mcpUrl);
+            await connectPickPath(options, mcpUrl, attemptId);
             return;
         }
         await connectSingleClient(client, options, mcpUrl, attemptId);

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

@@ -31,6 +31,8 @@ export interface ConnectAllOptions {
     pick?: boolean;
     /** Inherit subprocess stdio instead of replaying it only on failure. */
     verbose?: boolean;
+    /** Setup-page id riding in on --url; joins "copied the command" to this run. */
+    attemptId?: string;
 }
 export declare function runConnectAll(opts: ConnectAllOptions): Promise<number>;
 export declare const FIRST_TASK_PROMPT: string;

package/dist/lib/connect-all.js

@@ -14,7 +14,7 @@ import { commandOnPath, detectInstalledHarnesses, HARNESS_COMMANDS, HARNESS_DISP
 import { detectHumanInitiated } from './harness.js';
 import { emitNotice } from './notice.js';
 import { errLine, outLine, setErrIndent } from './output.js';
-import { sendSetupCompleted } from './setup-telemetry.js';
+import { sendSetupCompleted, sendSetupStarted, } from './setup-telemetry.js';
 import { verifyMcpAuth, verifyMcpHealth } from './verify.js';
 const STEP_INDENT = '  ';
 // Derived: a native add carries the key, or the CLI holds it itself.
@@ -315,6 +315,12 @@ async function finishRun(results, opts, isTTY) {
 }
 export async function runConnectAll(opts) {
     const isTTY = detectHumanInitiated();
+    // Ahead of detection and the hoisted install; either can end the process silently.
+    // Not on the picker path: an explicit cancel is not a setup.
+    if (!opts.uninstall && !opts.dryRun && !opts.pick) {
+        // validatedApiKey falls back to env/config; opts.apiKey alone splits the run's two ends.
+        await sendSetupStarted(opts.mcpUrl, opts.attemptId, validatedApiKey(opts.apiKey));
+    }
     // Open interface holds stdin raw; hermes' input() then wedges.
     const prompt = isTTY ? createStdinPrompt() : undefined;
     const detections = detectInstalledHarnesses();
@@ -372,7 +378,7 @@ export async function runConnectAll(opts) {
             verify_depth: r.verifyDepth ?? null,
             verify_ok: r.verifyOk ?? null,
         }));
-        await sendSetupCompleted(opts.mcpUrl, harnessTelemetry, validatedApiKey(opts.apiKey), mode);
+        await sendSetupCompleted(opts.mcpUrl, harnessTelemetry, validatedApiKey(opts.apiKey), mode, opts.attemptId);
         // After the summary and before the launch, which is where the user is reading.
         emitNotice();
     }

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

@@ -40,6 +40,8 @@ declare const harnessResultSchema: z.ZodObject<{
     }>>;
     verify_ok: z.ZodNullable<z.ZodBoolean>;
 }, z.core.$strip>;
+/** First act of a `--all` run; everything upstream of it stays invisible. */
+export declare function sendSetupStarted(mcpUrl: string, attemptId?: string, apiKey?: string): Promise<void>;
 export declare const setupCompletedPayloadSchema: z.ZodObject<{
     harnesses: z.ZodArray<z.ZodObject<{
         harness: z.ZodEnum<{
@@ -65,6 +67,7 @@ export declare const setupCompletedPayloadSchema: z.ZodObject<{
         pick: "pick";
         pick_numeric: "pick_numeric";
     }>>;
+    connect_attempt_id: z.ZodOptional<z.ZodUUID>;
 }, z.core.$strip>;
 export type SetupCompletedPayload = z.infer<typeof setupCompletedPayloadSchema>;
 export type HarnessResult = z.infer<typeof harnessResultSchema>;
@@ -74,7 +77,7 @@ export type UpgradeOutcome = 'updated' | 'failed' | 'interrupted';
 export type UpgradeScope = 'both' | 'cli' | 'skill';
 /** `toVersion` is null when the run was interrupted or the installed version could not be read. */
 export declare function sendUpgradeCompleted(fromVersion: string, toVersion: string | null, outcome: UpgradeOutcome, scope: UpgradeScope, apiKey?: string): Promise<void>;
-export declare function sendSetupCompleted(mcpUrl: string, harnesses: HarnessResult[], apiKey?: string, mode?: SetupMode): Promise<void>;
+export declare function sendSetupCompleted(mcpUrl: string, harnesses: HarnessResult[], apiKey?: string, mode?: SetupMode, attemptId?: string): Promise<void>;
 export declare const DOCTOR_HARNESS_SCOPES: readonly ["all", "claude-code", "codex", "cursor", "grok", "hermes", "openclaw", "opencode"];
 export declare const doctorCompletedPayloadSchema: z.ZodObject<{
     schema_version: z.ZodInt;

package/dist/lib/setup-telemetry.js

@@ -101,6 +101,25 @@ const harnessResultSchema = z.object({
     verify_depth: z.enum(['health', 'health+auth']).nullable(),
     verify_ok: z.boolean().nullable(),
 });
+/** First act of a `--all` run; everything upstream of it stays invisible. */
+export async function sendSetupStarted(mcpUrl, attemptId, apiKey) {
+    if (telemetryDisabled())
+        return;
+    // Route 400s a bad id and postConnectEvent never retries 4xx, losing the whole event.
+    const stamped = attemptId && z.uuid().safeParse(attemptId).success ? attemptId : undefined;
+    await postConnectEvent({
+        endpoint: new URL('/api/cli/connect-event', mcpUrl).toString(),
+        body: JSON.stringify({
+            event: 'setup_started',
+            cli_version: CLI_VERSION,
+            runtime_platform: process.platform,
+            ...(stamped ? { connect_attempt_id: stamped } : {}),
+        }),
+        attempts: 1,
+        label: 'setup',
+        apiKey,
+    });
+}
 export const setupCompletedPayloadSchema = z.object({
     harnesses: z
         .array(harnessResultSchema)
@@ -111,6 +130,7 @@ export const setupCompletedPayloadSchema = z.object({
     cli_version: z.string(),
     // Segments picker runs from --all runs; the server field shipped first.
     mode: z.enum(['all', 'pick', 'pick_numeric']).optional(),
+    connect_attempt_id: z.uuid().optional(),
 });
 /** `toVersion` is null when the run was interrupted or the installed version could not be read. */
 export async function sendUpgradeCompleted(fromVersion, toVersion, outcome, scope, apiKey) {
@@ -128,7 +148,7 @@ export async function sendUpgradeCompleted(fromVersion, toVersion, outcome, scop
         apiKey,
     });
 }
-export async function sendSetupCompleted(mcpUrl, harnesses, apiKey, mode) {
+export async function sendSetupCompleted(mcpUrl, harnesses, apiKey, mode, attemptId) {
     // Ahead of the parse so an opt-out run prints no telemetry debug.
     if (telemetryDisabled())
         return;
@@ -140,6 +160,10 @@ export async function sendSetupCompleted(mcpUrl, harnesses, apiKey, mode) {
             harnesses,
             cli_version: CLI_VERSION,
             ...(mode ? { mode } : {}),
+            // Guarded here, not only at the route: a parse throw drops the whole event, not one field.
+            ...(attemptId && z.uuid().safeParse(attemptId).success
+                ? { connect_attempt_id: attemptId }
+                : {}),
         });
         endpoint = new URL('/api/cli/connect-event', mcpUrl).toString();
         body = JSON.stringify({ event: 'setup_completed', ...payload });

package/package.json

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