@tiny-fish/cli 0.52.5-next.437 → 0.53.0

package/dist/commands/connect.js

@@ -1,5 +1,6 @@
 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 { ALL_HARNESSES } from '../lib/harness/harness-detect.js';
@@ -10,6 +11,8 @@ import { z } from 'zod';
 import { gateApiKey } from '../lib/connect-preflight.js';
 import { DEFAULT_MCP_URL } from '../lib/mcp-endpoint.js';
 import { connectHarness } from '../lib/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. */
 function applyConfigDir(client, configDir) {
     if (client !== 'cline') {
@@ -60,6 +63,7 @@ async function connectManyPath(options, mcpUrl, attemptId) {
         apiKey: options.apiKey,
         mcpUrl,
         attemptId,
+        trigger: options.trigger,
         dryRun: options.dryRun ?? false,
         uninstall: options.uninstall ?? false,
         noLaunch: options.skipLaunch === true,
@@ -80,6 +84,7 @@ async function connectSingleClient(client, options, mcpUrl, attemptId) {
         launch: options.launch ?? false,
         configDir: options.configDir ? applyConfigDir(client, options.configDir) : undefined,
         attemptId,
+        trigger: options.trigger,
         // A key that the install cannot use leaves only a browser hop no agent can finish.
         keyAuthOnly: !detectHumanInitiated() && !!validatedApiKey(options.apiKey),
         authTimeoutMs: detectHumanInitiated() ? undefined : 90_000,
@@ -117,10 +122,13 @@ export function registerConnect(program) {
         .option('--url <mcpUrl>', 'MCP endpoint override')
         .option('--verbose', 'Print the full npm and skills output instead of only on failure')
         .option('--config-dir <path>', 'Cline only: config dir of a relocated install (~/.cline)')
+        .addOption(new Option('--trigger <trigger>', 'What prompted this connect, for attribution').hideHelp())
         .action(async (client, options) => {
         if (options.apiKey && !validateKeyFormat(options.apiKey)) {
             throw new Error('Invalid --api-key value');
         }
+        if (options.trigger && !TRIGGER_FORMAT.test(options.trigger))
+            options.trigger = undefined;
         const { mcpUrl, attemptId } = parseMcpUrlOption(options);
         if (options.all) {
             if (client) {

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

@@ -81,6 +81,7 @@ export declare function connectConfigFileHarness(harness: keyof typeof CONFIG_FI
     mcpUrl: string;
     launch?: boolean;
     attemptId?: string;
+    trigger?: string;
     verbose?: boolean;
     authTimeoutMs?: number;
     onPostInstallFailed?: () => void;

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

@@ -33,6 +33,8 @@ export interface ConnectAllOptions {
     verbose?: boolean;
     /** Setup-page id riding in on --url; joins "copied the command" to this run. */
     attemptId?: string;
+    /** What prompted the connect (`--trigger`), stamped on every event. */
+    trigger?: string;
 }
 /** The harness has never created its dir, so connecting would build one it does not own. */
 export declare function needsFirstRun(detection: HarnessDetection): boolean;

package/dist/lib/connect-all.js

@@ -94,6 +94,7 @@ async function processHarness(detection, opts, prompt, oauthBudget, hoistedCliIn
             mcpUrl: opts.mcpUrl,
             launch: false,
             verbose: opts.verbose,
+            trigger: opts.trigger,
             keyAuthOnly: keyed && !isTTY,
             authTimeoutMs: headlessAuth ? OAUTH_SIGN_IN_TIMEOUT_MS : undefined,
             hoistedCliInstall,
@@ -379,7 +380,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, opts.attemptId);
+        await sendSetupCompleted(opts.mcpUrl, harnessTelemetry, validatedApiKey(opts.apiKey), mode, opts.attemptId, opts.trigger);
         // After the summary and before the launch, which is where the user is reading.
         emitNotice();
     }

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

@@ -108,5 +108,6 @@ export declare function createConnectTelemetry(mcpUrl: string, client: AgentClie
     apiKey?: string;
     attemptId?: string;
     fallbackAttemptId?: string;
+    trigger?: string;
 }): ConnectTelemetry;
 export {};

package/dist/lib/connect-runtime.js

@@ -334,6 +334,7 @@ export function createConnectTelemetry(mcpUrl, client, opts) {
     // command" to this install attempt.
     const attemptId = opts?.attemptId ?? seeded ?? opts?.fallbackAttemptId ?? randomUUID();
     const endpoint = new URL('/api/cli/connect-event', mcpUrl).toString();
+    const trigger = opts?.trigger;
     const pending = [];
     let lastTrackAt;
     let harnessVersion;
@@ -378,6 +379,7 @@ export function createConnectTelemetry(mcpUrl, client, opts) {
             calling_harness: detectHarness() ?? 'none',
             cli_invocation_id: CLI_INVOCATION_ID,
             runtime_env: detectRuntimeEnv(),
+            connect_trigger: trigger,
         });
     }
     return {

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

@@ -6,6 +6,8 @@ export interface NativeConnectOptions {
     mcpUrl: string;
     launch: boolean;
     attemptId?: string;
+    /** What prompted the connect (`--trigger`), stamped on every event. */
+    trigger?: string;
     /** Headless: refuse rather than fall back to an unfinishable browser sign-in. */
     keyAuthOnly?: boolean;
     /** Headless --all: bounds sign-in spawns and bars interactive CLI login. */

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

@@ -97,7 +97,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, attemptId?: string): Promise<void>;
+export declare function sendSetupCompleted(mcpUrl: string, harnesses: HarnessResult[], apiKey?: string, mode?: SetupMode, attemptId?: string, trigger?: string): Promise<void>;
 export declare const DOCTOR_ERROR_CLASSES: readonly ["command_not_found", "timeout", "spawn_error", "nonzero_exit", "unexpected_error"];
 export type DoctorErrorClass = (typeof DOCTOR_ERROR_CLASSES)[number];
 /** Derived, not read: the catch is generic, so only the code is trustworthy. */

package/dist/lib/setup-telemetry.js

@@ -183,7 +183,7 @@ export async function sendUpgradeCompleted(fromVersion, toVersion, outcome, scop
         apiKey,
     });
 }
-export async function sendSetupCompleted(mcpUrl, harnesses, apiKey, mode, attemptId) {
+export async function sendSetupCompleted(mcpUrl, harnesses, apiKey, mode, attemptId, trigger) {
     // Ahead of the parse so an opt-out run prints no telemetry debug.
     if (telemetryDisabled())
         return;
@@ -204,6 +204,7 @@ export async function sendSetupCompleted(mcpUrl, harnesses, apiKey, mode, attemp
             ...payload,
             cli_invocation_id: CLI_INVOCATION_ID,
             runtime_env: detectRuntimeEnv(),
+            ...(trigger ? { connect_trigger: trigger } : {}),
         });
     }
     catch (e) {

package/package.json

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