@tiny-fish/cli 0.19.1-next.179 → 0.19.1-next.181

package/dist/commands/connect.js

@@ -35,6 +35,7 @@ async function connectNativeMcpClient(client, options) {
     await runGuarded(state, telemetry, () => {
         telemetry.track("started");
         const { optionalSupported } = requireCommandSupport(client);
+        state.harnessDegraded = !!client.loginArgs && !optionalSupported;
         telemetry.track("checkpoint", { phase: "prerequisite_ok" });
         state.stage = "registration_cleanup";
         for (const removal of client.removals)
@@ -47,7 +48,7 @@ async function connectNativeMcpClient(client, options) {
         const storedKey = validatedApiKey(options.apiKey);
         const useKeyAuth = client.headerAuthSupported === true && !!storedKey;
         // Undefining `loginArgs` reuses the deferred-auth path codex/hermes already take.
-        const loginDegraded = !!client.loginArgs && !optionalSupported;
+        const loginDegraded = state.harnessDegraded === true;
         const loginArgs = loginDegraded ? undefined : client.loginArgs;
         // A probed client authenticates inside `mcp add` too, so a failure there is either.
         state.stage =
@@ -98,9 +99,15 @@ async function connectNativeMcpClient(client, options) {
             }
             telemetry.track("checkpoint", { phase: "oauth_done" });
         }
+        const signInDeferred = !useKeyAuth && !addSignedIn && !pendingLogin;
+        const authMode = useKeyAuth
+            ? "api-key"
+            : signInDeferred
+                ? "deferred"
+                : "oauth";
         // Registration/OAuth make MCP work; later steps are cosmetic and must not fail the attempt.
-        settle(state, telemetry, "completed");
-        runPostInstallSteps(client, options, state, telemetry, !useKeyAuth && !addSignedIn && !pendingLogin);
+        settle(state, telemetry, "completed", { authMode });
+        runPostInstallSteps(client, options, state, telemetry, signInDeferred);
     });
 }
 function connectedLine(client, signInDeferred) {
@@ -163,7 +170,12 @@ export async function connectOpencode(options) {
 }
 export async function connectOpenClaw(options) {
     const telemetry = createConnectTelemetry(options.mcpUrl, "openclaw", options);
-    const state = { stage: "prerequisite_check", settled: false };
+    // Skill install, no MCP server — never degraded, and false keeps it inside a `= false` filter.
+    const state = {
+        stage: "prerequisite_check",
+        settled: false,
+        harnessDegraded: false,
+    };
     await runGuarded(state, telemetry, () => {
         telemetry.track("started");
         requireCommandSupport(OPENCLAW);
@@ -230,7 +242,13 @@ export async function connectOpenClaw(options) {
 /** Writes mcp.json directly — no `cursor mcp add` exists. */
 export async function connectCursor(options) {
     const telemetry = createConnectTelemetry(options.mcpUrl, "cursor", options);
-    const state = { stage: "prerequisite_check", settled: false };
+    // Never degraded: no sign-in command to be missing. False, not absent, so a `= false`
+    // filter still catches Cursor.
+    const state = {
+        stage: "prerequisite_check",
+        settled: false,
+        harnessDegraded: false,
+    };
     await runGuarded(state, telemetry, async () => {
         telemetry.track("started");
         telemetry.track("checkpoint", { phase: "prerequisite_ok" });
@@ -279,7 +297,7 @@ export async function connectCursor(options) {
         else {
             errLine("TinyFish is connected. Reload the Cursor window, then approve/sign in under Settings → MCP.");
         }
-        settle(state, telemetry, "completed");
+        settle(state, telemetry, "completed", { authMode: resolvedKey ? "api-key" : "deferred" });
     });
 }
 /** Best-effort: false when no handler/open fails — caller falls back to reload copy. */

package/dist/lib/connect-clients.js

@@ -13,7 +13,8 @@ const CLAUDE_CODE_KEYED_FALLBACK_NOTE = "Using your stored TinyFish API key: thi
     "(`claude mcp login`), so no browser sign-in is needed.";
 const CLAUDE_CODE_DEFERRED_AUTH_NOTE = "TinyFish is registered in Claude Code but not signed in: this Claude Code predates " +
     "one-command sign-in (`claude mcp login`). Open Claude Code and run `/mcp` to sign in to " +
-    "TinyFish. `claude update` gets you one-command sign-in.";
+    "TinyFish. `claude update` gets you one-command sign-in. Already have a TinyFish API key? " +
+    "Run `tinyfish connect claude-code --api-key <key>` instead.";
 const CODEX_OAUTH_RESOURCE_UNAVAILABLE_MESSAGE = "Could not confirm this Codex installation supports one-command MCP authentication: `codex " +
     "mcp add --help` did not list `--oauth-resource`. Update Codex and retry, or add TinyFish " +
     "manually with `codex mcp add`." +

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

@@ -1,8 +1,10 @@
+import { type AuthMode } from "./registration-detect.js";
 export declare const NON_INTERACTIVE_TIMEOUT_MS = 10000;
 export type AgentClient = "claude-code" | "codex" | "cursor" | "hermes" | "openclaw" | "opencode";
 type ConnectStage = "started" | "checkpoint" | "completed" | "failed" | "aborted" | "post_install_failed";
 type ConnectFailureStage = "prerequisite_check" | "registration_cleanup" | "registration" | "registration_or_authentication" | "client_oauth" | "cli_install" | "skill_install" | "authentication" | "walkthrough_launch";
 type ConnectFailureReason = "harness_not_installed" | "harness_command_unsupported" | "harness_too_old";
+export type ConnectAuthMode = Extract<AuthMode, "oauth" | "api-key"> | "deferred";
 type ConnectCheckpoint = "prerequisite_ok" | "registered" | "oauth_done" | "cli_installed" | "skill_installed" | "authenticated";
 /** Ctrl+C/SIGTERM killed a setup child — abandonment, not error. */
 export declare class ConnectInterruptedError extends Error {
@@ -15,12 +17,17 @@ export declare function commandNotFound(error: unknown): boolean;
 export interface ConnectRunState {
     stage: ConnectFailureStage;
     settled: boolean;
+    /** On state, not per-call: otherwise degraded installs never appear to fail. */
+    harnessDegraded?: boolean;
 }
 interface ConnectStageDetail {
     failedStage?: ConnectFailureStage;
     phase?: ConnectCheckpoint;
     failureReason?: ConnectFailureReason;
     harnessVersion?: string;
+    authMode?: ConnectAuthMode;
+    /** Orthogonal to `authMode`: a stored key wins over `mcp login` on a healthy client too. */
+    harnessDegraded?: boolean;
 }
 export interface ConnectTelemetry {
     attemptId: string;

package/dist/lib/connect-runtime.js

@@ -36,7 +36,7 @@ export function settle(state, telemetry, stage, detail) {
     if (state.settled)
         return;
     state.settled = true;
-    telemetry.track(stage, detail);
+    telemetry.track(stage, { harnessDegraded: state.harnessDegraded, ...detail });
 }
 // Raw-mode children still surface via throwIfInterrupted; cooked-mode stages
 // (npm/npx/OAuth waits) land here.
@@ -165,6 +165,8 @@ export function createConnectTelemetry(mcpUrl, client, opts) {
                 phase: detail?.phase,
                 failure_reason: detail?.failureReason,
                 harness_version: detail?.harnessVersion,
+                auth_mode: detail?.authMode,
+                harness_degraded: detail?.harnessDegraded,
                 runtime_platform: process.platform,
                 node_version: process.version,
                 cli_version: CLI_VERSION,

package/package.json

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