@tiny-fish/cli 0.23.1-next.205 → 0.23.1-next.207

package/dist/commands/doctor.js

@@ -63,10 +63,14 @@ function pointsElsewhere(registeredUrl, mcpUrl) {
         return "an unparseable endpoint";
     }
 }
+/** Either it reads the CLI's key at runtime or it holds a copy: the CLI's own verdict covers both. */
+function runsOnCliCredential(status) {
+    return status.usesCliKey === true || status.keyMatchesCliKey === true;
+}
 function keyedVerdict(status, keyAuth, cliKeyMissing) {
     if (!keyAuth) {
         // Its auth is the CLI credential; a warn would exit 0.
-        if (status.usesCliKey) {
+        if (runsOnCliCredential(status)) {
             return cliKeyMissing
                 ? {
                     status: "fail",
@@ -79,7 +83,7 @@ function keyedVerdict(status, keyAuth, cliKeyMissing) {
                     };
         }
         // A bare warn beside exit 0 reads as a pass.
-        const because = status.keyReason ?? "its key is not readable here";
+        const because = status.keyReason ?? "the CLI cannot verify a key it does not hold";
         return { status: "warn", detail: `registered, but ${because}, so its reach is unproven` };
     }
     if (keyAuth.ok) {
@@ -89,13 +93,6 @@ function keyedVerdict(status, keyAuth, cliKeyMissing) {
         };
     }
     if (keyAuth.status === 401) {
-        // Resolved in doctor's shell, not codex's, so a 401 proves nothing.
-        if (status.keyIsIndirect) {
-            return {
-                status: "warn",
-                detail: "registered, but the key doctor resolved for it is rejected",
-            };
-        }
         return { status: "fail", detail: "registered, but TinyFish rejects its API key" };
     }
     // Only 401 blames the key; connect would loop on the rest.
@@ -192,20 +189,14 @@ function isDefaultEndpoint(mcpUrl) {
         return false;
     }
 }
-function verifyHarnessKey(status, cliKey, cliAuth, mcpUrl) {
+function verifyHarnessKey(status, cliAuth, mcpUrl) {
     if (!isDefaultEndpoint(mcpUrl))
         return undefined;
     // `pointsElsewhere` already fails; a second reason only misleads.
     if (pointsElsewhere(status.registeredUrl, mcpUrl))
         return undefined;
-    // A harness with no key of its own reads the CLI's.
-    if (status.usesCliKey)
-        return cliAuth;
-    if (!status.apiKey)
-        return undefined;
-    if (status.apiKey === cliKey && cliAuth)
-        return cliAuth;
-    return verifyMcpAuth(status.apiKey);
+    // The CLI never holds a harness's key, so only its own credential can be verified.
+    return runsOnCliCredential(status) ? cliAuth : undefined;
 }
 // Only Cursor's repair is a pure local file write; every other one needs a browser sign-in.
 const UNATTENDED_SAFE = new Set(["cursor"]);
@@ -252,7 +243,7 @@ export async function runDoctor(options) {
     const [connectivity, cliAuthResult, keyAuths] = await Promise.all([
         checkConnectivity(options.mcpUrl),
         cliAuth,
-        Promise.all(statuses.map((status) => verifyHarnessKey(status, credential.key, cliAuth, options.mcpUrl))),
+        Promise.all(statuses.map((status) => verifyHarnessKey(status, cliAuth, options.mcpUrl))),
     ]);
     const checks = [
         checkCliVersion(),

package/dist/lib/auth.d.ts

@@ -36,8 +36,6 @@ export declare function persistApiKeyToEnvironment(apiKey: string, options?: Env
 export declare function clearConfig(): boolean;
 /** The one rule that is ours to enforce: the key becomes an HTTP header, so CR/LF cannot pass. */
 export declare function isHeaderSafe(key: string): boolean;
-/** No length rule: short real keys must survive. */
-export declare function hasKeyPrefix(key: string): boolean;
 export declare function validateKeyFormat(key: string): boolean;
 export declare function maskKey(key: string): string;
 export type KeySource = "explicit" | "env" | "config" | "none";
@@ -51,6 +49,8 @@ export interface UnresolvedKey {
 }
 /** Key for optional paths (telemetry, auth probes) — absent is a valid answer, so never exits. */
 export declare function resolvedApiKey(explicitApiKey?: string): string | undefined;
+/** Answers "is this the CLI's own key" without the value leaving the caller; see sdk/cli/CLAUDE.md. */
+export declare function matchesCliKey(value: string | undefined): boolean;
 /** resolvedApiKey for keys that reach a config file or the wire — loadConfig() is unvalidated on read. */
 export declare function validatedApiKey(explicitApiKey?: string): string | undefined;
 /**

package/dist/lib/auth.js

@@ -193,7 +193,7 @@ export function isHeaderSafe(key) {
     return true;
 }
 /** No length rule: short real keys must survive. */
-export function hasKeyPrefix(key) {
+function hasKeyPrefix(key) {
     return KEY_PREFIXES.some((p) => key.startsWith(p));
 }
 export function validateKeyFormat(key) {
@@ -219,6 +219,10 @@ function lookupApiKey(explicitApiKey) {
 export function resolvedApiKey(explicitApiKey) {
     return lookupApiKey(explicitApiKey).value;
 }
+/** Answers "is this the CLI's own key" without the value leaving the caller; see sdk/cli/CLAUDE.md. */
+export function matchesCliKey(value) {
+    return value !== undefined && value === resolvedApiKey();
+}
 /** resolvedApiKey for keys that reach a config file or the wire — loadConfig() is unvalidated on read. */
 export function validatedApiKey(explicitApiKey) {
     const key = resolvedApiKey(explicitApiKey);

package/dist/lib/client.js

@@ -1,6 +1,6 @@
 import { APIStatusError, agentRunAsyncResponseSchema, agentRunResponseSchema, agentRunWithStreamingResponseSchema, fetchResponseSchema, browserSessionSchema, searchQueryResponseSchema, TinyFish, runSchema, runStatusSchema, } from "@tiny-fish/sdk";
 import { CONNECT_SOURCE, loadConfig } from "./auth.js";
-import { API_URL_OVERRIDE, CLI_VERSION } from "./constants.js";
+import { API_URL_OVERRIDE, CLI_AGENT_IDENTITY, CLI_VERSION } from "./constants.js";
 import { detectHarness, detectHumanInitiated } from "./harness.js";
 import { captureNotice } from "./notice.js";
 import { ApiError } from "./output.js";
@@ -34,7 +34,7 @@ class TinyFishCliClient extends TinyFish {
         const base = super._buildHeaders();
         const headers = {
             ...base,
-            "X-TF-Request-Origin": "tinyfish-cli",
+            "X-TF-Request-Origin": CLI_AGENT_IDENTITY,
             "User-Agent": `${base["User-Agent"] ?? ""} @tiny-fish/cli/${CLI_VERSION}`.trim(),
         };
         // Forwarded explicitly: the pinned published SDK may predate TF_CLIENT_* support.

package/dist/lib/connect-install.js

@@ -3,7 +3,7 @@ import spawn from "cross-spawn";
 import { loadConfig, persistApiKeyToEnvironment, validateKeyFormat, writeConfig } from "./auth.js";
 import { CURSOR_SKILL_TARGET, NATIVE_MCP_CLIENTS, OPENCLAW_SKILL_INSTALL_ARGS, } from "./connect-clients.js";
 import { commandNotFound, ConnectStepError, spawnStepError, throwIfInterrupted, NON_INTERACTIVE_TIMEOUT_MS, } from "./connect-runtime.js";
-import { TINYFISH_CLI_PACKAGE } from "./constants.js";
+import { CLI_AGENT_IDENTITY, TINYFISH_CLI_PACKAGE } from "./constants.js";
 import { installRoot } from "./install-root.js";
 import { errLine } from "./output.js";
 export const SKILL_INSTALL_TIMEOUT_MS = 120_000;
@@ -66,6 +66,8 @@ function skillAddArgs(skillAgents) {
 function skillSpawnEnv() {
     return {
         ...process.env,
+        // `skills` gates its logo art on agent detection.
+        AI_AGENT: CLI_AGENT_IDENTITY,
         PATH: `${path.dirname(process.execPath)}${path.delimiter}${process.env.PATH ?? ""}`,
     };
 }

package/dist/lib/constants.d.ts

@@ -1,6 +1,7 @@
 export declare const CLI_VERSION: string;
 /** Unversioned: the install site appends `@latest`, the version read must not. */
 export declare const TINYFISH_CLI_PACKAGE = "@tiny-fish/cli";
+export declare const CLI_AGENT_IDENTITY = "tinyfish-cli";
 export declare const BASE_URL: string;
 export declare const API_URL_OVERRIDE: string | undefined;
 /** URL where users can create and manage API keys */

package/dist/lib/constants.js

@@ -4,6 +4,8 @@ const _pkg = _require("../../package.json");
 export const CLI_VERSION = _pkg.version;
 /** Unversioned: the install site appends `@latest`, the version read must not. */
 export const TINYFISH_CLI_PACKAGE = "@tiny-fish/cli";
+// How we identify ourselves to other tools; `skills` echoes it back.
+export const CLI_AGENT_IDENTITY = "tinyfish-cli";
 /** Base URL for the TinyFish API. Override with TINYFISH_API_URL for staging/self-hosted. */
 const apiUrlOverride = process.env["TINYFISH_API_URL"]?.trim() || undefined;
 if (apiUrlOverride) {

package/dist/lib/cursor-config.d.ts

@@ -14,10 +14,10 @@ export interface CursorTinyfishEntry {
     hasApiKeyHeader: boolean;
     /** Registered endpoint, so a caller can tell "registered" from "registered at the right place". */
     url?: string;
-    apiKey?: string;
+    keyMatchesCliKey?: boolean;
     error?: string;
 }
-/** Carries the header value; callers keep it off the report. */
+/** Reports the header's shape, never its value. */
 export declare function readCursorTinyfishEntry(): CursorTinyfishEntry;
 /** Merges only the `tinyfish` key; skips unreadable/corrupt files rather than clobber. */
 export declare function writeCursorMcpConfig(mcpUrl: string, apiKey?: string): CursorMcpWriteResult;

package/dist/lib/cursor-config.js

@@ -1,6 +1,7 @@
 import * as fs from "fs";
 import * as os from "os";
 import * as path from "path";
+import { matchesCliKey } from "./auth.js";
 // The one config file the CLI writes directly — hence backup/merge rigor.
 const TINYFISH_SERVER_KEY = "tinyfish";
 export function cursorConfigDir() {
@@ -65,7 +66,7 @@ export function planCursorWrite(mcpUrl, apiKey) {
         ? `${filePath}: would create with a "tinyfish" MCP server entry${authNote}`
         : `${filePath}: would back up to a timestamped copy, then merge in the "tinyfish" MCP server entry${authNote}`;
 }
-/** Carries the header value; callers keep it off the report. */
+/** Reports the header's shape, never its value. */
 export function readCursorTinyfishEntry() {
     const existing = readExisting();
     if ("error" in existing)
@@ -78,12 +79,12 @@ export function readCursorTinyfishEntry() {
     // Header names are case-insensitive, and this file is hand-editable — matching only the
     // casing we write would understate auth mode for a user who typed it differently.
     const keyHeader = isPlainRecord(headers)
-        ? Object.entries(headers).find(([name, value]) => name.toLowerCase() === "x-api-key" && typeof value === "string")
+        ? Object.entries(headers).find((entry) => entry[0].toLowerCase() === "x-api-key" && typeof entry[1] === "string")
         : undefined;
     return {
         present: true,
         hasApiKeyHeader: keyHeader !== undefined,
-        ...(keyHeader ? { apiKey: keyHeader[1] } : {}),
+        ...(matchesCliKey(keyHeader?.[1]) ? { keyMatchesCliKey: true } : {}),
         ...(typeof entry.url === "string" ? { url: entry.url } : {}),
     };
 }

package/dist/lib/registration-detect.d.ts

@@ -7,10 +7,8 @@ export interface RegistrationStatus {
     connectedBefore: boolean;
     /** The endpoint the harness is actually pointed at, when the probe exposes it. */
     registeredUrl?: string;
-    /** For doctor to verify; never for the report. */
-    apiKey?: string;
-    /** From the environment, not the config, so a 401 is ambiguous. */
-    keyIsIndirect?: boolean;
+    /** Its key is a copy of the CLI's, so the CLI's own verification covers it. */
+    keyMatchesCliKey?: boolean;
     /** Holds no key; reads the CLI's at runtime. */
     usesCliKey?: boolean;
     connected?: boolean;

package/dist/lib/registration-detect.js

@@ -2,7 +2,7 @@ import * as fs from "fs";
 import * as path from "path";
 import spawn from "cross-spawn";
 import { z } from "zod";
-import { hasKeyPrefix, loadConfig } from "./auth.js";
+import { loadConfig, matchesCliKey } from "./auth.js";
 import { errLine } from "./output.js";
 import { readCursorTinyfishEntry } from "./cursor-config.js";
 import { detectInstalledHarnesses, harnessConfigPath, harnessDisplayPath, AuthMode, Registered, } from "./harness-detect.js";
@@ -26,10 +26,6 @@ const NO_SUCH_SERVER = /no (?:mcp )?server named/i;
 const API_KEY_HEADER = /x-api-key/i;
 // `claude mcp get` prints the value; `mcp add` masks it.
 const API_KEY_HEADER_VALUE = /^\s*X-API-Key:\s*(\S+)\s*$/im;
-// Charset is the redaction guard: `***`, `[REDACTED]`, dotted masks.
-function extractableKey(value) {
-    return value && hasKeyPrefix(value) && /^[A-Za-z0-9_-]+$/.test(value) ? value : undefined;
-}
 // OpenCode colours its list even through a pipe, putting `\x1b[34m` between the line start and
 // the server name, so an unstripped probe reads a registered harness as absent.
 // eslint-disable-next-line no-control-regex
@@ -119,23 +115,23 @@ function tinyfishServerName(output) {
         .map((name) => name.trim())
         .find((name) => SERVER_NAMED_TINYFISH.test(name));
 }
-function parseMcpGet(output, keyAuthPattern) {
+function parseMcpGet(output) {
     // Positive evidence only: whether `mcp get` echoes headers at all is unverified, so absence
     // of the pattern is `unknown`, never proof of OAuth.
     const url = /^\s*URL:\s*(\S+)/m.exec(output)?.[1];
-    const key = extractableKey(API_KEY_HEADER_VALUE.exec(output)?.[1]);
+    const keyMatchesCliKey = matchesCliKey(API_KEY_HEADER_VALUE.exec(output)?.[1]);
     const status = MCP_GET_STATUS.exec(output)?.[1];
     const connected = status === undefined ? undefined : connectionState(status);
     return {
         registered: Registered.Yes,
-        authMode: keyAuthPattern.test(output) ? AuthMode.ApiKey : AuthMode.Unknown,
+        authMode: API_KEY_HEADER.test(output) ? AuthMode.ApiKey : AuthMode.Unknown,
         ...(url ? { registeredUrl: url } : {}),
-        ...(key ? { apiKey: key } : {}),
+        ...(keyMatchesCliKey ? { keyMatchesCliKey } : {}),
         ...(connected === undefined ? {} : { connected }),
     };
 }
 // claude-code only. Codex cannot use this: its `mcp get` exits 0 on a missing server.
-function fromMcpGet(command, keyAuthPattern) {
+function fromMcpGet(command) {
     const probe = runProbe(command, ["mcp", "get", "tinyfish"]);
     if (probe.outcome === "unavailable") {
         return { registered: Registered.Unknown, authMode: AuthMode.Unknown, reason: probe.reason };
@@ -154,7 +150,7 @@ function fromMcpGet(command, keyAuthPattern) {
             const rescoped = runProbe(command, ["mcp", "get", scoped]);
             if (rescoped.outcome === "ran" && rescoped.exitCode === 0) {
                 return {
-                    ...parseMcpGet(rescoped.output, keyAuthPattern),
+                    ...parseMcpGet(rescoped.output),
                     reason: `registered as ${scoped}`,
                 };
             }
@@ -173,7 +169,7 @@ function fromMcpGet(command, keyAuthPattern) {
         }
         return { registered: Registered.No, authMode: AuthMode.Unknown };
     }
-    return parseMcpGet(probe.output, keyAuthPattern);
+    return parseMcpGet(probe.output);
 }
 // `codex mcp get <missing>` prints an error and exits 0, so presence must never be read from
 // its exit code; `mcp list --json` is the only trustworthy read-back.
@@ -217,17 +213,16 @@ export function codexOauthCompleted() {
 }
 // This reaches the pasted report, so its shape is checked first.
 const ENV_VAR_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
-/** Codex stores a variable name, not a value, so resolve it. */
+/** Codex stores a variable name; resolving it only answers whether it is the CLI's key. */
 function codexEnvKey(envVar) {
     if (!ENV_VAR_NAME.test(envVar)) {
         return { keyReason: "its key comes from an unusable variable name" };
     }
-    const key = extractableKey(process.env[envVar]);
-    if (key)
-        return { apiKey: key, keyIsIndirect: true };
+    if (matchesCliKey(process.env[envVar]))
+        return { keyMatchesCliKey: true };
     return {
         keyReason: process.env[envVar]
-            ? `$${envVar} does not hold a TinyFish key here`
+            ? `$${envVar} holds a key this CLI cannot verify`
             : `$${envVar} is not set here`,
     };
 }
@@ -264,12 +259,11 @@ function probeCursor() {
     }
     if (!entry.present)
         return { registered: Registered.No, authMode: AuthMode.Unknown };
-    const key = extractableKey(entry.apiKey);
     return {
         registered: Registered.Yes,
         authMode: entry.hasApiKeyHeader ? AuthMode.ApiKey : AuthMode.Unknown,
         ...(entry.url ? { registeredUrl: entry.url } : {}),
-        ...(key ? { apiKey: key } : {}),
+        ...(entry.keyMatchesCliKey ? { keyMatchesCliKey: true } : {}),
     };
 }
 // Both list commands print this header in every state, including "no servers configured".
@@ -342,15 +336,13 @@ function probeOpencode() {
     }
     return fromMcpList("opencode", probe.output, AuthMode.Unknown, OPENCODE_ROW_URL);
 }
-// Verified against grok 0.0.60: a list, with the header value in the clear.
+// Verified against grok 0.0.60: a list. Header values stay `unknown`; only names are read.
 const grokEntrySchema = z.looseObject({
     name: z.string().optional(),
     url: z.string().optional(),
-    headers: z.record(z.string(), z.string()).optional(),
+    headers: z.record(z.string(), z.unknown()).optional(),
 });
 const grokListSchema = z.array(grokEntrySchema);
-// Grok drops X-API-Key when the server advertises OAuth metadata, so keys ride Authorization.
-const BEARER_VALUE = /^Bearer\s+(\S+)$/i;
 // Grok has no `mcp get`; `mcp list --json` is the only machine-readable view.
 function probeGrok() {
     const probe = runProbe("grok", ["mcp", "list", "--json"]);
@@ -385,23 +377,16 @@ function probeGrok() {
     const entry = entries.find((server) => server.name === "tinyfish");
     if (!entry)
         return { registered: Registered.No, authMode: AuthMode.Unknown };
-    const authorization = Object.entries(entry.headers ?? {}).find(([name]) => name.toLowerCase() === "authorization")?.[1];
-    // `${VAR}` expands to "" when the env var is unset: a present-but-empty header is a broken key.
-    const hasAuthorization = authorization !== undefined;
-    const key = extractableKey(BEARER_VALUE.exec(authorization ?? "")?.[1]);
+    // Grok drops X-API-Key when the server advertises OAuth metadata, so keys ride Authorization.
+    const hasAuthorization = Object.keys(entry.headers ?? {}).some((name) => name.toLowerCase() === "authorization");
     return {
         registered: Registered.Yes,
         authMode: hasAuthorization ? AuthMode.ApiKey : AuthMode.OAuth,
         ...(entry.url ? { registeredUrl: entry.url } : {}),
-        ...(key ? { apiKey: key } : {}),
-        // A keyed Grok entry suppresses OAuth discovery, so an unreadable key cannot fall back.
-        ...(hasAuthorization && !key
-            ? { keyReason: "its Authorization header is not a readable TinyFish key" }
-            : {}),
     };
 }
 const PROBES = {
-    "claude-code": () => fromMcpGet("claude", API_KEY_HEADER),
+    "claude-code": () => fromMcpGet("claude"),
     codex: probeCodex,
     cursor: probeCursor,
     grok: probeGrok,

package/package.json

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