@tiny-fish/cli 0.6.1 → 0.6.2-next.104

package/dist/commands/connect.d.ts

@@ -4,16 +4,17 @@ export declare const OPENCLAW_ONBOARDING_PROMPT: string;
 export declare function connectClaudeCode(options: {
     mcpUrl: string;
     launch: boolean;
-}): void;
+}): Promise<void>;
 export declare function connectCodex(options: {
     mcpUrl: string;
     launch: boolean;
-}): void;
+}): Promise<void>;
 export declare function connectHermes(options: {
     mcpUrl: string;
     launch: boolean;
-}): void;
+}): Promise<void>;
 export declare function connectOpenClaw(options: {
+    mcpUrl: string;
     launch: boolean;
-}): void;
+}): Promise<void>;
 export declare function registerConnect(program: Command): void;

package/dist/commands/connect.js

@@ -1,8 +1,11 @@
+import { randomUUID } from "node:crypto";
 import spawn from "cross-spawn";
+import { CLI_VERSION } from "../lib/constants.js";
 import { errLine } from "../lib/output.js";
 const DEFAULT_MCP_URL = "https://agent.tinyfish.ai/mcp";
 const NON_INTERACTIVE_TIMEOUT_MS = 10_000;
 const HERMES_SEED_TIMEOUT_MS = 120_000;
+const TELEMETRY_TIMEOUT_MS = 500;
 const MCP_LOGIN_UNAVAILABLE_MESSAGE = "This Claude Code installation does not expose `claude mcp login`, which is required for " +
     "one-command MCP authentication. Update Claude Code and retry, or authenticate TinyFish " +
     "manually from /mcp.";
@@ -108,6 +111,39 @@ const OPENCLAW = {
         unavailableMessage: OPENCLAW_SKILL_UNAVAILABLE_MESSAGE,
     },
 };
+function createConnectTelemetry(mcpUrl, client) {
+    const attemptId = randomUUID();
+    const endpoint = new URL("/api/cli/connect-event", mcpUrl).toString();
+    let enabled = true;
+    return {
+        attemptId,
+        async track(stage, failedStage) {
+            if (!enabled)
+                return;
+            try {
+                const response = await fetch(endpoint, {
+                    method: "POST",
+                    headers: { "content-type": "application/json" },
+                    body: JSON.stringify({
+                        attempt_id: attemptId,
+                        client,
+                        stage,
+                        failed_stage: failedStage,
+                        runtime_platform: process.platform,
+                        node_version: process.version,
+                        cli_version: CLI_VERSION,
+                    }),
+                    signal: AbortSignal.timeout(TELEMETRY_TIMEOUT_MS),
+                });
+                if (!response.ok)
+                    enabled = false;
+            }
+            catch {
+                enabled = false;
+            }
+        },
+    };
+}
 function requireCommandSupport(client) {
     const result = spawn.sync(client.command, client.supportCheck.args, {
         encoding: "utf8",
@@ -146,111 +182,142 @@ function removeExistingRegistration(client, removal) {
     }
     throw new Error(`Could not remove existing ${removal.label}: ${details}`);
 }
-function connectNativeMcpClient(client, options) {
-    requireCommandSupport(client);
-    for (const removal of client.removals)
-        removeExistingRegistration(client, removal);
-    const mcpUrl = new URL(options.mcpUrl);
-    mcpUrl.searchParams.set("source", "tinyfish_cli");
-    mcpUrl.searchParams.set("client", client.connectClient);
-    errLine(`Adding TinyFish to ${client.displayName}...`);
-    const addResult = spawn.sync(client.command, client.addArgs(mcpUrl.toString(), options.mcpUrl), {
-        stdio: "inherit",
-    });
-    if (addResult.error || addResult.status !== 0) {
-        throw new Error(`Could not add TinyFish to ${client.displayName}`, {
-            cause: addResult.error,
-        });
-    }
-    if (client.loginArgs) {
-        errLine("Signing in to TinyFish...");
-        const loginResult = spawn.sync(client.command, client.loginArgs, {
+async function connectNativeMcpClient(client, options) {
+    const telemetry = createConnectTelemetry(options.mcpUrl, client.connectClient);
+    let failureStage = "prerequisite_check";
+    try {
+        await telemetry.track("started");
+        requireCommandSupport(client);
+        failureStage = "registration_cleanup";
+        for (const removal of client.removals)
+            removeExistingRegistration(client, removal);
+        const mcpUrl = new URL(options.mcpUrl);
+        mcpUrl.searchParams.set("source", "tinyfish_cli");
+        mcpUrl.searchParams.set("client", client.connectClient);
+        mcpUrl.searchParams.set("connect_attempt_id", telemetry.attemptId);
+        failureStage = client.loginArgs ? "registration" : "registration_or_authentication";
+        errLine(`Adding TinyFish to ${client.displayName}...`);
+        const addResult = spawn.sync(client.command, client.addArgs(mcpUrl.toString(), options.mcpUrl), {
             stdio: "inherit",
         });
-        if (loginResult.error || loginResult.status !== 0) {
-            throw new Error(`Could not authenticate TinyFish in ${client.displayName}`, {
-                cause: loginResult.error,
+        if (addResult.error || addResult.status !== 0) {
+            throw new Error(`Could not add TinyFish to ${client.displayName}`, {
+                cause: addResult.error,
             });
         }
+        if (client.loginArgs) {
+            failureStage = "authentication";
+            errLine("Signing in to TinyFish...");
+            const loginResult = spawn.sync(client.command, client.loginArgs, {
+                stdio: "inherit",
+            });
+            if (loginResult.error || loginResult.status !== 0) {
+                throw new Error(`Could not authenticate TinyFish in ${client.displayName}`, {
+                    cause: loginResult.error,
+                });
+            }
+        }
+        if (!options.launch) {
+            errLine(`TinyFish is connected. Open ${client.displayName} to start using it.`);
+            await telemetry.track("completed");
+            return;
+        }
+        failureStage = "walkthrough_launch";
+        errLine(`Starting the TinyFish walkthrough in ${client.displayName}...`);
+        if (client.launchWalkthrough) {
+            client.launchWalkthrough();
+            await telemetry.track("completed");
+            return;
+        }
+        const result = spawn.sync(client.command, [DEFAULT_ONBOARDING_PROMPT], { stdio: "inherit" });
+        if (result.error) {
+            throw new Error(`Could not launch ${client.displayName}`, { cause: result.error });
+        }
+        if (result.signal === "SIGINT" || result.signal === "SIGTERM")
+            return;
+        if (result.status !== 0) {
+            throw new Error(`${client.displayName} walkthrough exited with status ${result.status ?? "unknown"}`);
+        }
+        await telemetry.track("completed");
     }
-    if (!options.launch) {
-        errLine(`TinyFish is connected. Open ${client.displayName} to start using it.`);
-        return;
-    }
-    errLine(`Starting the TinyFish walkthrough in ${client.displayName}...`);
-    if (client.launchWalkthrough) {
-        client.launchWalkthrough();
-        return;
-    }
-    const result = spawn.sync(client.command, [DEFAULT_ONBOARDING_PROMPT], { stdio: "inherit" });
-    if (result.error) {
-        throw new Error(`Could not launch ${client.displayName}`, { cause: result.error });
-    }
-    if (result.signal === "SIGINT" || result.signal === "SIGTERM")
-        return;
-    if (result.status !== 0) {
-        throw new Error(`${client.displayName} walkthrough exited with status ${result.status ?? "unknown"}`);
+    catch (error) {
+        await telemetry.track("failed", failureStage);
+        throw error;
     }
 }
-export function connectClaudeCode(options) {
-    connectNativeMcpClient(CLAUDE_CODE, options);
+export async function connectClaudeCode(options) {
+    await connectNativeMcpClient(CLAUDE_CODE, options);
 }
-export function connectCodex(options) {
-    connectNativeMcpClient(CODEX, options);
+export async function connectCodex(options) {
+    await connectNativeMcpClient(CODEX, options);
 }
-export function connectHermes(options) {
-    connectNativeMcpClient(HERMES, options);
+export async function connectHermes(options) {
+    await connectNativeMcpClient(HERMES, options);
 }
-export function connectOpenClaw(options) {
-    requireCommandSupport(OPENCLAW);
-    errLine("Installing the TinyFish CLI...");
-    const cliInstallResult = spawn.sync("npm", ["install", "--global", "@tiny-fish/cli@latest"], { stdio: "inherit" });
-    if (cliInstallResult.error || cliInstallResult.status !== 0) {
-        throw new Error("Could not install the TinyFish CLI", { cause: cliInstallResult.error });
-    }
-    errLine("Installing the TinyFish skill in OpenClaw...");
-    const skillInstallResult = spawn.sync("openclaw", [
-        "skills",
-        "install",
-        OPENCLAW_SKILL,
-        "--global",
-        "--force",
-        "--acknowledge-clawhub-risk",
-    ], { stdio: "inherit" });
-    if (skillInstallResult.error || skillInstallResult.status !== 0) {
-        throw new Error("Could not install the TinyFish skill in OpenClaw", {
-            cause: skillInstallResult.error,
+export async function connectOpenClaw(options) {
+    const telemetry = createConnectTelemetry(options.mcpUrl, "openclaw");
+    let failureStage = "prerequisite_check";
+    try {
+        await telemetry.track("started");
+        requireCommandSupport(OPENCLAW);
+        failureStage = "cli_install";
+        errLine("Installing the TinyFish CLI...");
+        const cliInstallResult = spawn.sync("npm", ["install", "--global", "@tiny-fish/cli@latest"], {
+            stdio: "inherit",
         });
-    }
-    const authStatus = spawn.sync("tinyfish", ["auth", "status"], { stdio: "ignore" });
-    if (commandNotFound(authStatus.error)) {
-        throw new Error(TINYFISH_CLI_NOT_FOUND_MESSAGE, { cause: authStatus.error });
-    }
-    if (authStatus.status !== 0) {
-        errLine("Signing in to TinyFish...");
-        const loginResult = spawn.sync("tinyfish", ["auth", "login", "--source", "openclaw"], { stdio: "inherit" });
-        if (commandNotFound(loginResult.error)) {
-            throw new Error(TINYFISH_CLI_NOT_FOUND_MESSAGE, { cause: loginResult.error });
+        if (cliInstallResult.error || cliInstallResult.status !== 0) {
+            throw new Error("Could not install the TinyFish CLI", { cause: cliInstallResult.error });
         }
-        if (loginResult.error || loginResult.status !== 0) {
-            throw new Error("Could not authenticate TinyFish for OpenClaw", {
-                cause: loginResult.error,
+        failureStage = "skill_install";
+        errLine("Installing the TinyFish skill in OpenClaw...");
+        const skillInstallResult = spawn.sync("openclaw", ["skills", "install", OPENCLAW_SKILL, "--global", "--force", "--acknowledge-clawhub-risk"], { stdio: "inherit" });
+        if (skillInstallResult.error || skillInstallResult.status !== 0) {
+            throw new Error("Could not install the TinyFish skill in OpenClaw", {
+                cause: skillInstallResult.error,
             });
         }
+        failureStage = "authentication";
+        const authStatus = spawn.sync("tinyfish", ["auth", "status"], { stdio: "ignore" });
+        if (commandNotFound(authStatus.error)) {
+            throw new Error(TINYFISH_CLI_NOT_FOUND_MESSAGE, { cause: authStatus.error });
+        }
+        if (authStatus.status !== 0) {
+            errLine("Signing in to TinyFish...");
+            const loginResult = spawn.sync("tinyfish", ["auth", "login", "--source", "openclaw"], {
+                stdio: "inherit",
+            });
+            if (commandNotFound(loginResult.error)) {
+                throw new Error(TINYFISH_CLI_NOT_FOUND_MESSAGE, { cause: loginResult.error });
+            }
+            if (loginResult.error || loginResult.status !== 0) {
+                throw new Error("Could not authenticate TinyFish for OpenClaw", {
+                    cause: loginResult.error,
+                });
+            }
+        }
+        if (!options.launch) {
+            errLine("TinyFish is connected. Open OpenClaw to start using it.");
+            await telemetry.track("completed");
+            return;
+        }
+        failureStage = "walkthrough_launch";
+        errLine("Starting the TinyFish walkthrough in OpenClaw...");
+        const launchResult = spawn.sync("openclaw", ["chat", "--message", OPENCLAW_ONBOARDING_PROMPT], {
+            stdio: "inherit",
+        });
+        if (launchResult.error) {
+            throw new Error("Could not launch OpenClaw", { cause: launchResult.error });
+        }
+        if (launchResult.signal === "SIGINT" || launchResult.signal === "SIGTERM")
+            return;
+        if (launchResult.status !== 0) {
+            throw new Error(`OpenClaw walkthrough exited with status ${launchResult.status ?? "unknown"}`);
+        }
+        await telemetry.track("completed");
     }
-    if (!options.launch) {
-        errLine("TinyFish is connected. Open OpenClaw to start using it.");
-        return;
-    }
-    errLine("Starting the TinyFish walkthrough in OpenClaw...");
-    const launchResult = spawn.sync("openclaw", ["chat", "--message", OPENCLAW_ONBOARDING_PROMPT], { stdio: "inherit" });
-    if (launchResult.error) {
-        throw new Error("Could not launch OpenClaw", { cause: launchResult.error });
-    }
-    if (launchResult.signal === "SIGINT" || launchResult.signal === "SIGTERM")
-        return;
-    if (launchResult.status !== 0) {
-        throw new Error(`OpenClaw walkthrough exited with status ${launchResult.status ?? "unknown"}`);
+    catch (error) {
+        await telemetry.track("failed", failureStage);
+        throw error;
     }
 }
 export function registerConnect(program) {
@@ -260,7 +327,7 @@ export function registerConnect(program) {
         .argument("<client>", "Agent client to connect (claude-code, codex, hermes, or openclaw)")
         .option("--launch", "Launch the agent and start the TinyFish walkthrough")
         .option("--url <mcpUrl>", "MCP endpoint override")
-        .action((client, options) => {
+        .action(async (client, options) => {
         const mcpUrl = options.url ?? DEFAULT_MCP_URL;
         if (mcpUrl.startsWith("-")) {
             throw new Error(`Invalid --url value: ${mcpUrl}`);
@@ -277,16 +344,16 @@ export function registerConnect(program) {
         }
         const connectOptions = { mcpUrl, launch: options.launch ?? false };
         if (client === "claude-code") {
-            connectClaudeCode(connectOptions);
+            await connectClaudeCode(connectOptions);
         }
         else if (client === "codex") {
-            connectCodex(connectOptions);
+            await connectCodex(connectOptions);
         }
         else if (client === "hermes") {
-            connectHermes(connectOptions);
+            await connectHermes(connectOptions);
         }
         else if (client === "openclaw") {
-            connectOpenClaw({ launch: connectOptions.launch });
+            await connectOpenClaw(connectOptions);
         }
         else {
             throw new Error(`Unsupported client: ${client}. Supported clients: claude-code, codex, hermes, openclaw`);

package/package.json

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