@tiny-fish/cli 0.7.2-next.115 → 0.7.2-next.118

package/dist/lib/client.js

@@ -1,5 +1,6 @@
 import { APIStatusError, agentRunAsyncResponseSchema, agentRunResponseSchema, agentRunWithStreamingResponseSchema, fetchResponseSchema, browserSessionSchema, searchQueryResponseSchema, TinyFish, runSchema, runStatusSchema, } from "@tiny-fish/sdk";
 import { BASE_URL, CLI_VERSION } from "./constants.js";
+import { detectHarness, detectHumanInitiated } from "./harness.js";
 import { ApiError } from "./output.js";
 import { z } from "zod";
 class TinyFishCliClient extends TinyFish {
@@ -13,12 +14,17 @@ class TinyFishCliClient extends TinyFish {
         // Forwarded explicitly: the pinned published SDK may predate TF_CLIENT_* support.
         // Non-printable chars make fetch throw; 128 is the server cap (client_name varchar(128)).
         const sanitize = (value) => (value ?? "").replace(/[^\x20-\x7E]/g, "").trim().slice(0, 128);
-        const clientName = sanitize(process.env["TF_CLIENT_NAME"]);
+        // An explicit TF_CLIENT_NAME always wins over auto-detection, preserving the
+        // env-var forwarding contract added in PR #3781; otherwise fingerprint the
+        // calling harness so cli usage can be split by client (PF-3168).
+        const clientName = sanitize(process.env["TF_CLIENT_NAME"]) || sanitize(detectHarness() ?? undefined);
         const clientVersion = sanitize(process.env["TF_CLIENT_VERSION"]);
         if (clientName)
             headers["X-TF-Client-Name"] = clientName;
         if (clientVersion)
             headers["X-TF-Client-Version"] = clientVersion;
+        // Agent-vs-human signal, independent of harness detection or skill install.
+        headers["X-TF-Human-Initiated"] = detectHumanInitiated() ? "true" : "false";
         return headers;
     }
     // The SDK base client only exposes get/post/postStream; DELETE is needed for

package/dist/lib/harness.d.ts

@@ -0,0 +1,18 @@
+type Env = Record<string, string | undefined>;
+/** Returns the detected harness name, or null when none match. */
+export declare function detectHarness(env?: Env): string | null;
+interface HumanInitiatedStreams {
+    stdin: {
+        isTTY?: boolean;
+    };
+    stdout: {
+        isTTY?: boolean;
+    };
+}
+/**
+ * True only when both ends are a real terminal — a human at a prompt. Agents
+ * shell out without a TTY, so this reads false for every harness above and is
+ * the free agent-vs-human signal behind `X-TF-Human-Initiated`.
+ */
+export declare function detectHumanInitiated(streams?: HumanInitiatedStreams): boolean;
+export {};

package/dist/lib/harness.js

@@ -0,0 +1,40 @@
+// Detects the coding-agent harness that shelled out to the CLI, so usage events
+// can be split by harness (PF-3168). Names become the `X-TF-Client-Name` header
+// value (unenumerated, lowercase-kebab, matching MCP client_name like
+// "claude-code"). Explicit TF_CLIENT_NAME always wins upstream in client.ts.
+//
+// Fingerprints verified by running scripts/harness-probe against each harness.
+// Order matters: wrappers that embed another agent must precede the embedded
+// one. OpenClaw drives Claude Code via `sdk-cli`, so its env carries both
+// CLAUDECODE=1 and OPENCLAW_MCP_*; it must be checked before claude-code.
+const hasVarWithPrefix = (env, prefix) => Object.keys(env).some((key) => key.startsWith(prefix));
+// First match wins. Base agents (claude-code) go last so embedding wrappers win.
+const HARNESS_FINGERPRINTS = [
+    { name: "openclaw", matches: (env) => hasVarWithPrefix(env, "OPENCLAW_MCP_") },
+    { name: "grok", matches: (env) => env["GROK_AGENT"] === "1" },
+    // Cursor's VS Code host sets CURSOR_* broadly; CURSOR_AGENT=1 flags the
+    // agent specifically, so gate on it rather than the prefix.
+    { name: "cursor", matches: (env) => env["CURSOR_AGENT"] === "1" },
+    // Antigravity is Google's successor to the (deprecated) gemini-cli.
+    { name: "antigravity", matches: (env) => env["ANTIGRAVITY_AGENT"] === "1" },
+    // CODEX_CI seen in probe; CODEX_SANDBOX* appear under seatbelt. Match the
+    // prefix so we catch a Codex run regardless of which of its vars are set.
+    { name: "codex", matches: (env) => hasVarWithPrefix(env, "CODEX_") },
+    { name: "hermes", matches: (env) => hasVarWithPrefix(env, "HERMES_") },
+    {
+        name: "claude-code",
+        matches: (env) => env["CLAUDECODE"] === "1" || Boolean(env["CLAUDE_CODE_ENTRYPOINT"]),
+    },
+];
+/** Returns the detected harness name, or null when none match. */
+export function detectHarness(env = process.env) {
+    return HARNESS_FINGERPRINTS.find((fingerprint) => fingerprint.matches(env))?.name ?? null;
+}
+/**
+ * True only when both ends are a real terminal — a human at a prompt. Agents
+ * shell out without a TTY, so this reads false for every harness above and is
+ * the free agent-vs-human signal behind `X-TF-Human-Initiated`.
+ */
+export function detectHumanInitiated(streams = process) {
+    return Boolean(streams.stdin.isTTY && streams.stdout.isTTY);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiny-fish/cli",
-  "version": "0.7.2-next.115",
+  "version": "0.7.2-next.118",
   "description": "TinyFish CLI — run web automations from your terminal",
   "type": "module",
   "bin": {
@@ -54,6 +54,7 @@
     "esbuild": "0.28.1",
     "vite": "7.3.5",
     "brace-expansion": "^5.0.9",
+    "ip-address": ">=10.3.1",
     "postcss": ">=8.5.23",
     "tar": "^7.5.21"
   },