@tiny-fish/cli 0.1.5-next.50 → 0.1.6

package/dist/commands/config-claude.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerConfigureClaude(program: Command): void;

package/dist/commands/config-claude.js

@@ -0,0 +1,80 @@
+import { err, errLine, out } from "../lib/output.js";
+import { loadConfig, validateKeyFormat } from "../lib/auth.js";
+import { readSettingsJson, writeSettingsJson, readClaudeMd, writeClaudeMd, mergeSettings, removeFromSettings, mergeClaudeMd, removeFromClaudeMd, claudeSettingsPath, claudeMdPath, isTinyfishConfiguredInSettings, isTinyfishConfiguredInClaudeMd, } from "../lib/claude-config.js";
+function loadExistingConfig() {
+    let settings;
+    try {
+        settings = readSettingsJson();
+    }
+    catch (e) {
+        err({
+            error: `Cannot read ${claudeSettingsPath()}: ${e instanceof Error ? e.message : String(e)}. Fix it manually before running this command.`,
+        });
+        process.exit(1);
+    }
+    let claudeMd;
+    try {
+        claudeMd = readClaudeMd();
+    }
+    catch (e) {
+        err({
+            error: `Cannot read ${claudeMdPath()}: ${e instanceof Error ? e.message : String(e)}`,
+        });
+        process.exit(1);
+    }
+    return { settings, claudeMd };
+}
+function isSignedIn() {
+    const envKey = process.env.TINYFISH_API_KEY;
+    if (envKey && validateKeyFormat(envKey))
+        return true;
+    const config = loadConfig();
+    return !!config.api_key && validateKeyFormat(config.api_key);
+}
+function install(settings, claudeMd) {
+    errLine("Configuring Claude Code to use TinyFish...\n");
+    writeSettingsJson(mergeSettings(settings));
+    errLine("  Updated settings.json (permission + hooks)");
+    const { content, replaced } = mergeClaudeMd(claudeMd);
+    writeClaudeMd(content);
+    errLine(replaced
+        ? "  Updated CLAUDE.md (replaced existing TinyFish block)"
+        : "  Updated CLAUDE.md (added TinyFish instructions)");
+    errLine("\nClaude Code is now configured to use TinyFish for web search and fetch! 🚀");
+    const signedIn = isSignedIn();
+    if (!signedIn) {
+        errLine("\nNote: You are not signed in to TinyFish yet. The configuration is in place,");
+        errLine("but search and fetch will not work until you sign in. Run:\n");
+        errLine("  tinyfish auth login");
+    }
+    out({ status: "ok", action: "configured", signed_in: signedIn });
+}
+function remove(settings, claudeMd) {
+    if (!isTinyfishConfiguredInSettings(settings) && !isTinyfishConfiguredInClaudeMd(claudeMd)) {
+        errLine("TinyFish is not configured in Claude Code. Nothing to remove.");
+        out({ status: "ok", action: "noop" });
+        return;
+    }
+    errLine("Removing TinyFish configuration from Claude Code...\n");
+    writeSettingsJson(removeFromSettings(settings));
+    errLine("  Cleaned settings.json");
+    writeClaudeMd(removeFromClaudeMd(claudeMd));
+    errLine("  Cleaned CLAUDE.md");
+    errLine("\nTinyFish configuration removed from Claude Code.");
+    out({ status: "ok", action: "removed" });
+}
+export function registerConfigureClaude(program) {
+    program
+        .command("config-claude")
+        .description("Configure Claude Code to use TinyFish for web search and fetch")
+        .option("--remove", "Remove TinyFish configuration from Claude Code")
+        .action(async (opts) => {
+        const { settings, claudeMd } = loadExistingConfig();
+        if (opts.remove) {
+            remove(settings, claudeMd);
+        }
+        else {
+            install(settings, claudeMd);
+        }
+    });
+}

package/dist/index.js

@@ -7,6 +7,7 @@ import { registerFetch } from "./commands/fetch.js";
 import { registerBrowser } from "./commands/browser.js";
 import { registerRun } from "./commands/run.js";
 import { registerRuns } from "./commands/runs.js";
+import { registerConfigureClaude } from "./commands/config-claude.js";
 import { registerSearch } from "./commands/search.js";
 const { version } = createRequire(import.meta.url)("../package.json");
 const program = new Command();
@@ -24,6 +25,7 @@ program
     }
 });
 registerAuth(program);
+registerConfigureClaude(program);
 registerBrowser(program);
 const agentCmd = program
     .command("agent")

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

@@ -0,0 +1,21 @@
+export declare function claudeDir(): string;
+export declare function claudeSettingsPath(): string;
+export declare function claudeMdPath(): string;
+export declare const TINYFISH_PERMISSION = "Bash(tinyfish:*)";
+export declare const CLAUDE_MD_MARKER = "<!-- tinyfish-configure-claude -->";
+export declare const CLAUDE_MD_BLOCK = "<!-- tinyfish-configure-claude -->\n## WebSearch or Search\nWhen looking to use Search or WebSearch, always use the TinyFish Web Search tool, run `tinyfish search query \"<query>\"`\nOnly fall back to native Search when you get rate limited by tinyfish (for a minute, then you can try using tinyfish again)\n\n## WebFetch or Fetch\nWhen looking to use Fetch or WebFetch, always use the TinyFish Fetch tool, run `tinyfish fetch content get \"<url>\"`\nOnly fall back to native Fetch when you get rate limited by tinyfish (for a minute, then you can try using tinyfish again)\n<!-- tinyfish-configure-claude -->";
+export declare function readSettingsJson(): Record<string, unknown>;
+export declare function writeSettingsJson(settings: Record<string, unknown>): void;
+export declare function mergeSettings(existing: Record<string, unknown>): Record<string, unknown>;
+export declare function removeFromSettings(existing: Record<string, unknown>): Record<string, unknown>;
+export declare function readClaudeMd(): string;
+export declare function writeClaudeMd(content: string): void;
+export declare function hasMarker(content: string): boolean;
+export declare function hasLegacyBlock(content: string): boolean;
+export declare function mergeClaudeMd(existing: string): {
+    content: string;
+    replaced: boolean;
+};
+export declare function removeFromClaudeMd(existing: string): string;
+export declare function isTinyfishConfiguredInSettings(settings: Record<string, unknown>): boolean;
+export declare function isTinyfishConfiguredInClaudeMd(content: string): boolean;

package/dist/lib/claude-config.js

@@ -0,0 +1,200 @@
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+// ─── Path helpers ─────────────────────────────────────────────────────────────
+export function claudeDir() {
+    return path.join(os.homedir(), ".claude");
+}
+export function claudeSettingsPath() {
+    return path.join(claudeDir(), "settings.json");
+}
+export function claudeMdPath() {
+    return path.join(claudeDir(), "CLAUDE.md");
+}
+// ─── Constants ────────────────────────────────────────────────────────────────
+export const TINYFISH_PERMISSION = "Bash(tinyfish:*)";
+const TINYFISH_WEBFETCH_HOOK = {
+    matcher: "WebFetch",
+    hooks: [
+        {
+            type: "command",
+            command: "echo '{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"additionalContext\":\"Follow the instructions about which fetch provider to use, listed in your Claude.md file\"}}'",
+        },
+    ],
+};
+const TINYFISH_WEBSEARCH_HOOK = {
+    matcher: "WebSearch",
+    hooks: [
+        {
+            type: "command",
+            command: "echo '{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"additionalContext\":\"Follow the instructions about which search provider to use, listed in your Claude.md file\"}}'",
+        },
+    ],
+};
+const TINYFISH_SUBAGENT_HOOK = {
+    hooks: [
+        {
+            type: "command",
+            command: 'echo \'{"hookSpecificOutput":{"hookEventName":"SubagentStart","additionalContext":"The user prefers TinyFish for web operations. Use `tinyfish search query \\\\"<query>\\\\"` instead of WebSearch and `tinyfish fetch content get \\\\"<url>\\\\"` instead of WebFetch. Run them via the Bash tool. Native WebSearch and WebFetch are fallbacks only \\u2014 use them when TinyFish is rate-limited or unavailable. A PreToolUse hook will remind you if you reach for native tools. Refer to your claude.md for details"}}\'',
+        },
+    ],
+};
+export const CLAUDE_MD_MARKER = "<!-- tinyfish-configure-claude -->";
+export const CLAUDE_MD_BLOCK = `${CLAUDE_MD_MARKER}
+## WebSearch or Search
+When looking to use Search or WebSearch, always use the TinyFish Web Search tool, run \`tinyfish search query "<query>"\`
+Only fall back to native Search when you get rate limited by tinyfish (for a minute, then you can try using tinyfish again)
+
+## WebFetch or Fetch
+When looking to use Fetch or WebFetch, always use the TinyFish Fetch tool, run \`tinyfish fetch content get "<url>"\`
+Only fall back to native Fetch when you get rate limited by tinyfish (for a minute, then you can try using tinyfish again)
+${CLAUDE_MD_MARKER}`;
+function isTinyfishPreToolUseHook(entry) {
+    if (typeof entry !== "object" || entry === null)
+        return false;
+    const obj = entry;
+    if (obj.matcher !== "WebFetch" && obj.matcher !== "WebSearch")
+        return false;
+    const hooks = obj.hooks;
+    if (!Array.isArray(hooks) || hooks.length === 0)
+        return false;
+    const first = hooks[0];
+    return typeof first.command === "string" && first.command.includes("provider to use");
+}
+function isTinyfishSubagentHook(entry) {
+    if (typeof entry !== "object" || entry === null)
+        return false;
+    const hooks = entry.hooks;
+    if (!Array.isArray(hooks) || hooks.length === 0)
+        return false;
+    const first = hooks[0];
+    return typeof first.command === "string" && first.command.includes("TinyFish");
+}
+// ─── settings.json I/O ───────────────────────────────────────────────────────
+export function readSettingsJson() {
+    try {
+        const raw = fs.readFileSync(claudeSettingsPath(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        throw new Error("settings.json root is not a JSON object");
+    }
+    catch (e) {
+        if (typeof e === "object" && e !== null && e.code === "ENOENT") {
+            return {};
+        }
+        throw e;
+    }
+}
+export function writeSettingsJson(settings) {
+    fs.mkdirSync(claudeDir(), { recursive: true });
+    fs.writeFileSync(claudeSettingsPath(), JSON.stringify(settings, null, 2) + "\n");
+}
+// ─── settings.json merge / remove ─────────────────────────────────────────────
+export function mergeSettings(existing) {
+    const result = { ...existing };
+    const permissions = (result.permissions ?? {});
+    const allow = Array.isArray(permissions.allow) ? [...permissions.allow] : [];
+    if (!allow.includes(TINYFISH_PERMISSION)) {
+        allow.push(TINYFISH_PERMISSION);
+    }
+    result.permissions = { ...permissions, allow };
+    const hooks = (result.hooks ?? {});
+    const preToolUse = Array.isArray(hooks.PreToolUse) ? [...hooks.PreToolUse] : [];
+    const filteredPre = preToolUse.filter((e) => !isTinyfishPreToolUseHook(e));
+    filteredPre.push(TINYFISH_WEBFETCH_HOOK, TINYFISH_WEBSEARCH_HOOK);
+    const subagentStart = Array.isArray(hooks.SubagentStart) ? [...hooks.SubagentStart] : [];
+    const filteredSub = subagentStart.filter((e) => !isTinyfishSubagentHook(e));
+    filteredSub.push(TINYFISH_SUBAGENT_HOOK);
+    result.hooks = { ...hooks, PreToolUse: filteredPre, SubagentStart: filteredSub };
+    return result;
+}
+export function removeFromSettings(existing) {
+    const result = { ...existing };
+    const permissions = (result.permissions ?? {});
+    if (Array.isArray(permissions.allow)) {
+        const filtered = permissions.allow.filter((p) => p !== TINYFISH_PERMISSION);
+        if (filtered.length > 0) {
+            result.permissions = { ...permissions, allow: filtered };
+        }
+        else {
+            const rest = Object.fromEntries(Object.entries(permissions).filter(([k]) => k !== "allow"));
+            result.permissions = Object.keys(rest).length > 0 ? rest : undefined;
+        }
+    }
+    const hooks = (result.hooks ?? {});
+    const newHooks = { ...hooks };
+    if (Array.isArray(hooks.PreToolUse)) {
+        const filtered = hooks.PreToolUse.filter((e) => !isTinyfishPreToolUseHook(e));
+        newHooks.PreToolUse = filtered.length > 0 ? filtered : undefined;
+    }
+    if (Array.isArray(hooks.SubagentStart)) {
+        const filtered = hooks.SubagentStart.filter((e) => !isTinyfishSubagentHook(e));
+        newHooks.SubagentStart = filtered.length > 0 ? filtered : undefined;
+    }
+    const remaining = Object.fromEntries(Object.entries(newHooks).filter(([, v]) => v !== undefined));
+    result.hooks = Object.keys(remaining).length > 0 ? remaining : undefined;
+    return Object.fromEntries(Object.entries(result).filter(([, v]) => v !== undefined));
+}
+// ─── CLAUDE.md I/O ────────────────────────────────────────────────────────────
+export function readClaudeMd() {
+    try {
+        return fs.readFileSync(claudeMdPath(), "utf8");
+    }
+    catch (e) {
+        if (typeof e === "object" && e !== null && e.code === "ENOENT") {
+            return "";
+        }
+        throw e;
+    }
+}
+export function writeClaudeMd(content) {
+    fs.mkdirSync(claudeDir(), { recursive: true });
+    fs.writeFileSync(claudeMdPath(), content);
+}
+// ─── CLAUDE.md merge / remove ─────────────────────────────────────────────────
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+const MARKER_REGEX = new RegExp(`${escapeRegExp(CLAUDE_MD_MARKER)}[\\s\\S]*?${escapeRegExp(CLAUDE_MD_MARKER)}`, "m");
+const LEGACY_REGEX = /## Web(?:Search|Seach) or Search[\s\S]*?(?:tinyfish fetch[^\n]*\n(?:[^\n]*tinyfish[^\n]*\n)*[^\n]*)\n*/m;
+export function hasMarker(content) {
+    return content.includes(CLAUDE_MD_MARKER);
+}
+export function hasLegacyBlock(content) {
+    return !content.includes(CLAUDE_MD_MARKER) && LEGACY_REGEX.test(content);
+}
+export function mergeClaudeMd(existing) {
+    if (hasMarker(existing)) {
+        return { content: existing.replace(MARKER_REGEX, CLAUDE_MD_BLOCK), replaced: true };
+    }
+    if (hasLegacyBlock(existing)) {
+        const cleaned = existing.replace(LEGACY_REGEX, "").trim();
+        const content = cleaned.length > 0 ? CLAUDE_MD_BLOCK + "\n\n" + cleaned + "\n" : CLAUDE_MD_BLOCK + "\n";
+        return { content, replaced: true };
+    }
+    if (existing.trim().length === 0) {
+        return { content: CLAUDE_MD_BLOCK + "\n", replaced: false };
+    }
+    return { content: CLAUDE_MD_BLOCK + "\n\n" + existing, replaced: false };
+}
+export function removeFromClaudeMd(existing) {
+    if (!existing.includes(CLAUDE_MD_MARKER))
+        return existing;
+    const removed = existing
+        .replace(new RegExp(`${escapeRegExp(CLAUDE_MD_MARKER)}[\\s\\S]*?${escapeRegExp(CLAUDE_MD_MARKER)}\\n*`, "m"), "")
+        .trim();
+    return removed.length > 0 ? removed + "\n" : "";
+}
+// ─── Detection ────────────────────────────────────────────────────────────────
+export function isTinyfishConfiguredInSettings(settings) {
+    const permissions = settings.permissions;
+    const hasPermission = Array.isArray(permissions?.allow) && permissions.allow.includes(TINYFISH_PERMISSION);
+    const hooks = settings.hooks;
+    const hasHooks = Array.isArray(hooks?.PreToolUse) && hooks.PreToolUse.some(isTinyfishPreToolUseHook);
+    return hasPermission || hasHooks;
+}
+export function isTinyfishConfiguredInClaudeMd(content) {
+    return hasMarker(content) || hasLegacyBlock(content);
+}

package/package.json

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