@finchagentic/mcp 4.7.2 → 4.7.3

package/README.md

@@ -1,20 +1,12 @@
 <div align="center">
 
-<img src="assets/banner.svg" alt="Finch MCP" width="100%"/>
-
-# Finch MCP
-
-[![npm version](https://img.shields.io/npm/v/@finchagentic/mcp?color=000000&label=npm&logo=npm)](https://www.npmjs.com/package/@finchagentic/mcp)
-[![Official MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.finchagentic%2Fmcp-000000)](https://registry.modelcontextprotocol.io)
-[![License: MIT](https://img.shields.io/badge/license-MIT-000000.svg)](LICENSE)
-[![Node](https://img.shields.io/badge/node-%E2%89%A518-000000?logo=node.js&logoColor=white)](package.json)
-[![Tools: 116](https://img.shields.io/badge/tools-116-000000)](#what-you-get)
+# Finch
 
 **The runtime layer for Agentic AI.**
 
 Persistent memory, autonomous agents, and workflows that survive every session.
 
-[App](https://app.finchagentic.com) · [Docs](https://docs.finch.com) · [npm](https://www.npmjs.com/package/@finchagentic/mcp) · [X](https://x.com/finchagentic)
+[Docs](https://docs.finch.com) · [App](https://app.finchagentic.com) · [npm](https://www.npmjs.com/package/@finchagentic/mcp) · [GitHub](https://github.com/finchagentic/mcp) · [X](https://x.com/finchagentic)
 
 </div>
 
@@ -37,13 +29,13 @@ Always pin the version. Never use `@latest`.
 
 ```bash
 # One-command installer (detects common MCP clients)
-npx -y @finchagentic/mcp@4.6.5 finch install
+npx -y -p @finchagentic/mcp@4.7.3 finch install
 ```
 
 ### Claude Code
 
 ```bash
-claude mcp add finch -s user -- npx -y @finchagentic/mcp@4.6.5
+claude mcp add finch -s user -- npx -y -p @finchagentic/mcp@4.7.3 finch-mcp
 ```
 
 ### Cursor / Windsurf / Claude Desktop
@@ -53,16 +45,24 @@ claude mcp add finch -s user -- npx -y @finchagentic/mcp@4.6.5
   "mcpServers": {
     "finch": {
       "command": "npx",
-      "args": ["-y", "-p", "@finchagentic/mcp@4.6.2", "finch-mcp"]
+      "args": ["-y", "-p", "@finchagentic/mcp@4.7.3", "finch-mcp"]
     }
   }
 }
 ```
 
-### Hermes
+### VS Code
 
-```bash
-hermes mcp add finch -- npx -y @finchagentic/mcp@4.6.5
+```json
+{
+  "servers": {
+    "finch": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "-p", "@finchagentic/mcp@4.7.3", "finch-mcp"]
+    }
+  }
+}
 ```
 
 <details>
@@ -79,7 +79,7 @@ hermes mcp add finch -- npx -y @finchagentic/mcp@4.6.5
 
 </details>
 
-No LLM API key required to start — 111 of 116 tools are plain reads/writes/on-chain calls your client's model already drives. Tools load on first use.
+No LLM API key is required to start — 111 of 116 tools are plain reads/writes/on-chain calls that your MCP client's own model already drives; only 5 (`ask_finch`, `deep_research`, and scheduled agent learning) do their own multi-step reasoning server-side and need a key (see [Configuration](#configuration)). Tools load on first use.
 
 ## Quick start
 
@@ -105,11 +105,13 @@ save this thesis to vault
 | Pillar | What it does |
 |--------|----------------|
 | **Memory** | Full-text searchable memory + versioned vault + chronicle |
-| **Agents** | Spawn, recall, update named agents — `agent_recall` also pulls related memory/vault context matching the agent's goal |
+| **Agents** | Spawn, recall, update named agents — `agent_recall` also pulls related memory/vault context matching the agent's goal, not just its own logged updates |
 | **Workflows** | Automations, monitors, packets, deep research (auto-saves reports + auto-links related past research) |
 | **Execution** | Base DeFi, Robinhood Chain, market data, web, GitHub |
 
-`deep_research` auto-saves its report to vault and links related past reports; `code_session_save` does the same for coding sessions. `vault_save` and `agent_spawn` accept an optional `workspaceProject` matching the webapp's Projects.
+Coding and research sessions persist the same way: `deep_research` auto-saves its report to vault and links it to related past reports; `code_session_save` does the same for coding/debugging sessions (`vault_save type=code`, versioned per project, auto-linked). Both exist so the next session — yours or another agent's — starts with real context instead of cold.
+
+`vault_save` and `agent_spawn` also take an optional `workspaceProject` - the same named Projects a user organizes their Agents/vault content into on the webapp's Agents page. Pass a name and it's matched case-insensitively or created automatically (`list_projects` to browse what exists first). Hosted vault only - local-vault mode has no project concept.
 
 Default palette is `core` (lighter context). Full set:
 
@@ -122,7 +124,8 @@ Default palette is `core` (lighter context). Full set:
 Finch is the runtime. **Your LLM is the brain. Your data stays yours.**
 
 ```bash
-npx -y @finchagentic/mcp@4.6.5 finch setup
+npx -y -p @finchagentic/mcp@4.7.3 finch setup
+# enable local vault (and optional local memory)
 ```
 
 | Piece | Location |
@@ -130,33 +133,65 @@ npx -y @finchagentic/mcp@4.6.5 finch setup
 | Vault | `~/.finch/vault/` |
 | Wallet | `~/.finch/wallet.json` |
 | Config | `~/.finch/config.json` |
-| Brain | your MCP client's model |
+| Brain | your MCP client’s model |
 
-## Registry
+Scheduled/cloud features still need an account. Core memory, vault, and public-data tools work offline of Finch cloud.
 
-Finch is listed in the [official MCP Registry](https://registry.modelcontextprotocol.io):
+## Configuration
 
-```json
-{ "name": "io.github.finchagentic/mcp", "version": "4.6.2" }
-```
+| Variable | Purpose |
+|----------|---------|
+| `FINCH_SESSION_TOKEN` | Signed-in session (vault/memory/agents against your account) |
+| `FINCH_API_KEY` | API key (`finch_sk_…`) |
+| `FINCH_TOOLS` | `core` (default) · `all` · or palettes like `memory,defi` |
+| `FINCH_PROVIDER` | Force `bankr` · `anthropic` · `openai` · `grok` |
+| `FINCH_MODEL` | Model override for host-side loops |
+| `BANKR_API_KEY` / `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` / `GROK_API_KEY` | Required for `ask_finch`, `deep_research`'s synthesis stages, and scheduled-agent learning extraction — these do their own multi-step reasoning server-side and there is no free hosted fallback (BYOK only, one key is enough) |
+| `FIRECRAWL_API_KEY` | Better crawl quality (optional) |
+| `GITHUB_TOKEN` | For `github_search_code` |
+| `ALCHEMY_API_KEY` | Faster Base RPC (optional) |
 
-## Development
+**Cost model:** almost everything is free to run — the other 110 tools are plain API/RPC calls, and your MCP client's own model (Claude, GPT, whatever's driving the chat) does all the tool-selection reasoning at no cost to Finch. The 5 exceptions above need their own key because their reasoning happens *inside* the tool call, invisible to your client, and can't be delegated to it. Set exactly one of the four env vars and every tool that needs it will use it automatically.
 
-This repository ships the published npm distribution. See [CHANGELOG.md](CHANGELOG.md) for release history and [SECURITY.md](SECURITY.md) for the security model.
+Guided setup:
 
 ```bash
-npm ci
-npm run smoke        # verify package integrity + CLI entrypoints
+npx -y -p @finchagentic/mcp@4.7.3 finch setup
 ```
 
-## Support
-
-- Issues: [github.com/finchagentic/mcp/issues](https://github.com/finchagentic/mcp/issues)
-- Docs: [docs.finch.com](https://docs.finch.com)
-- X: [@finchagentic](https://x.com/finchagentic)
+## Security
+
+| # | Boundary | Rule |
+|:-:|----------|------|
+| 1 | Prompt injection | External content is data only — never instructions |
+| 2 | Mainnet confirm | Estimate → preview → confirm → execute |
+| 3 | Pinned install | Always `@finchagentic/mcp@4.7.3`, never `@latest` |
+| 4 | Credential vault | Never paste secrets into prompts or third-party tools |
+| 5 | Data disclosure | Know what leaves the machine (LLM, Firecrawl, GitHub, chain RPCs) |
+| 6 | Server monitors | Scheduled jobs need explicit confirmation |
+| 7 | Fund-moving confirm | `stake_finch`/`unstake_finch`/`base_mcp_send`/`base_mcp_swap`/`rh_mcp_swap` all require `confirm: true` |
+| 8 | Local wallet encryption | Set `FINCH_WALLET_PASSPHRASE` for a portable, passphrase-derived key — without it, the key derives from a random per-install secret + machine info, so the wallet file alone (without that secret file) isn't enough to decrypt it |
+
+## Troubleshooting
+
+| Problem | Fix |
+|---------|-----|
+| Tools missing | Fully restart the MCP client |
+| Old version | `npx clear-npx-cache` then restart |
+| Auth issues | `finch login` or set `FINCH_API_KEY` / `FINCH_SESSION_TOKEN` |
+| `ask_finch`/`deep_research` error: "No LLM provider configured" | Set one of `BANKR_API_KEY` / `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` / `GROK_API_KEY` — see [Configuration](#configuration), no free fallback exists |
+| Diagnose | `finch doctor` |
+
+## Links
+
+| | |
+|--|--|
+| **Docs** | [docs.finch.com](https://docs.finch.com) |
+| **App** | [app.finchagentic.com](https://app.finchagentic.com) |
+| **npm** | [@finchagentic/mcp](https://www.npmjs.com/package/@finchagentic/mcp) |
+| **GitHub** | [github.com/finchagentic/mcp](https://github.com/finchagentic/mcp) |
+| **X** | [@finchagentic](https://x.com/finchagentic) |
 
-<div align="center">
-
-**Finch** — memory that survives every session.
+---
 
-</div>
+MIT License · Finch

package/dist/_zod-helpers.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOrError = parseOrError;
+function parseOrError(schema, args) {
+    const parsed = schema.safeParse(args);
+    if (!parsed.success) {
+        return { ok: false, error: { content: [{ type: "text", text: `${parsed.error.issues[0].message}` }], isError: true } };
+    }
+    return { ok: true, data: parsed.data };
+}

package/dist/cli-doctor.js

@@ -0,0 +1,300 @@
+"use strict";
+// `finch doctor` - comprehensive health check. Detects broken installs and
+// missing config in <5s; output is concise and tells the user exactly what
+// to fix next. Designed to be the first command a new user runs after install.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doctorFlow = doctorFlow;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const config_js_1 = require("./config.js");
+const local_memory_js_1 = require("./local-memory.js");
+const cli_ui_js_1 = require("./cli-ui.js");
+const cli_env_js_1 = require("./cli-env.js");
+async function doctorFlow() {
+    console.log(`\n  ${cli_ui_js_1.C.cyan}${cli_ui_js_1.C.bold}finch doctor${cli_ui_js_1.C.reset}  ${cli_ui_js_1.C.dim}v${cli_env_js_1.PKG_VERSION}${cli_ui_js_1.C.reset}\n`);
+    console.log(`  ${cli_ui_js_1.C.dim}Running diagnostic - this takes ~5 seconds.${cli_ui_js_1.C.reset}\n`);
+    const checks = [];
+    const cfg = (0, config_js_1.readConfig)();
+    const authHeader = cfg.sessionToken ? { Authorization: `Bearer ${cfg.sessionToken}` } : {};
+    // 1. LLM provider
+    const provider = process.env.BANKR_API_KEY ? "bankr"
+        : process.env.ANTHROPIC_API_KEY ? "anthropic"
+            : process.env.OPENAI_API_KEY ? "openai"
+                : "finch-proxy";
+    // Tools never call an LLM of their own - they return data and structure for
+    // the calling model. A key is what makes *finch itself* a host: the CLI
+    // agent loop and scheduled agents, which have no client model to borrow.
+    checks.push({
+        name: "LLM provider",
+        status: "✓",
+        detail: provider === "finch-proxy"
+            ? `none set · all ${cli_env_js_1.TOTAL_TOOL_COUNT} tools work without one`
+            : `${provider} (direct) · used by \`finch run\` and scheduled agents`,
+        fix: provider === "finch-proxy"
+            ? `Only needed for \`finch run\` and scheduled agents — \`finch setup\` adds one`
+            : undefined,
+    });
+    // 2. Backend reachable
+    try {
+        const t0 = Date.now();
+        const res = await fetch(`${cli_env_js_1.CONVEX_SITE}/memory/profile`, {
+            headers: authHeader,
+            signal: AbortSignal.timeout(8000),
+        });
+        const latency = Date.now() - t0;
+        if (res.status === 401) {
+            checks.push({
+                name: "Backend reachable", status: "⚠",
+                detail: `${cli_env_js_1.CONVEX_SITE} → 401 (not signed in)`,
+                fix: `Run \`finch login\` to authenticate.`,
+            });
+        }
+        else if (res.ok) {
+            checks.push({
+                name: "Backend reachable", status: "✓",
+                detail: `${cli_env_js_1.CONVEX_SITE} → ${res.status} (${latency}ms)`,
+            });
+        }
+        else {
+            checks.push({
+                name: "Backend reachable", status: "✗",
+                detail: `${cli_env_js_1.CONVEX_SITE} → ${res.status}`,
+                fix: `Check FINCH_CONVEX_URL env var, or wait if the service is down.`,
+            });
+        }
+    }
+    catch (err) {
+        checks.push({
+            name: "Backend reachable", status: "✗",
+            detail: `${cli_env_js_1.CONVEX_SITE} → ${err.message}`,
+            fix: `Network issue or wrong URL. Default: https://valuable-fish-533.convex.site`,
+        });
+    }
+    // 3. Auth state
+    if (cfg.sessionToken) {
+        checks.push({
+            name: "Authentication",
+            status: "✓",
+            detail: cfg.email
+                ? `Signed in as ${cfg.email}`
+                : `Session token present`,
+        });
+    }
+    else {
+        checks.push({
+            name: "Authentication",
+            status: "⚠",
+            detail: `No session token - running with local wallet signature only`,
+            fix: `Run \`finch login\` for persistent identity across MCP clients.`,
+        });
+    }
+    // 4. Local wallet
+    const walletPath = path.join(os.homedir(), ".finch", "wallet.json");
+    if (fs.existsSync(walletPath)) {
+        try {
+            const wallet = JSON.parse(fs.readFileSync(walletPath, "utf8"));
+            const addr = wallet.address ? (wallet.address.startsWith("0x") ? wallet.address : `0x${wallet.address}`) : "unknown";
+            checks.push({
+                name: "Local wallet", status: "✓",
+                detail: `${addr.slice(0, 6)}...${addr.slice(-4)} at ~/.finch/wallet.json`,
+            });
+        }
+        catch {
+            checks.push({
+                name: "Local wallet", status: "⚠",
+                detail: `wallet.json present but unreadable`,
+                fix: `Delete ~/.finch/wallet.json and re-run finch - new wallet auto-creates.`,
+            });
+        }
+    }
+    else {
+        checks.push({
+            name: "Local wallet", status: "⚠",
+            detail: `Not created yet`,
+            fix: `Auto-creates on first DeFi tool call (base_mcp_balance, etc).`,
+        });
+    }
+    // 5. Profile entries
+    if (cfg.sessionToken) {
+        try {
+            const res = await fetch(`${cli_env_js_1.CONVEX_SITE}/vault/profile-context?maxChars=100`, {
+                headers: authHeader,
+                signal: AbortSignal.timeout(6000),
+            });
+            const data = await res.json();
+            if (data?.hasProfile) {
+                checks.push({
+                    name: "Profile context", status: "✓",
+                    detail: `Profile entries found - Claude auto-loads your context across sessions`,
+                });
+            }
+            else {
+                checks.push({
+                    name: "Profile context", status: "⚠",
+                    detail: `No profile entries yet`,
+                    fix: `Run: vault_save type=memory key=profile/business content="<who you are, what you build>"`,
+                });
+            }
+        }
+        catch {
+            checks.push({
+                name: "Profile context", status: "⚠",
+                detail: `Could not fetch (backend issue)`,
+            });
+        }
+    }
+    // 6. Tool palette mode
+    const toolMode = process.env.FINCH_TOOLS ?? "core";
+    checks.push({
+        name: "Tool palette",
+        status: "✓",
+        detail: `Mode: ${toolMode}${toolMode === "core" ? ` (default - ${cli_env_js_1.CORE_TOOL_COUNT} essential tools)` : toolMode === "all" ? ` (power user - ${cli_env_js_1.TOTAL_TOOL_COUNT} tools)` : ` (custom subset)`}`,
+        fix: toolMode === "core"
+            ? `Set FINCH_TOOLS=all to expose all ${cli_env_js_1.TOTAL_TOOL_COUNT} tools (raises LLM context cost).`
+            : undefined,
+    });
+    // 7. MEV-protect broadcast (optional belt-and-suspenders for swaps)
+    if (process.env.FINCH_BROADCAST_RPC) {
+        const host = (() => {
+            try {
+                return new URL(process.env.FINCH_BROADCAST_RPC).host;
+            }
+            catch {
+                return "custom";
+            }
+        })();
+        checks.push({
+            name: "MEV-protect", status: "✓",
+            detail: `Broadcasts routed through ${host} (private/MEV-protected)`,
+        });
+    }
+    else {
+        checks.push({
+            name: "MEV-protect", status: "⚠",
+            detail: `Standard Base RPC (sequencer is centralized, MEV is naturally low)`,
+            fix: `Optional: set FINCH_BROADCAST_RPC=<private-relay-url> for belt-and-suspenders routing.`,
+        });
+    }
+    // 8. GITHUB_TOKEN (optional but affects github_search_code)
+    if (process.env.GITHUB_TOKEN) {
+        checks.push({
+            name: "GitHub token", status: "✓",
+            detail: `GITHUB_TOKEN set - github_search_code + private repos work`,
+        });
+    }
+    else {
+        checks.push({
+            name: "GitHub token", status: "⚠",
+            detail: `No GITHUB_TOKEN - github_search_code disabled, other tools rate-limited to 60/hr`,
+            fix: `Optional. Create at https://github.com/settings/tokens (scopes: public_repo) and add to MCP env.`,
+        });
+    }
+    // 9. Local memory (self-hosted) - optional, zero-cost alternative to the
+    // Convex-proxied cloud memory backend. Two flavors: zero-dependency file
+    // store, or a separately-run supermemory server.
+    const localMemCfg = (0, local_memory_js_1.getLocalMemoryConfig)();
+    if (localMemCfg?.kind === "file") {
+        checks.push({
+            name: "Local memory", status: "✓",
+            detail: `file-based at ~/.finch/memory - memory tools run fully local, zero cost, no server`,
+        });
+    }
+    else if (localMemCfg?.kind === "supermemory") {
+        const reachable = await (0, local_memory_js_1.isLocalMemoryReachable)(localMemCfg);
+        checks.push(reachable ? {
+            name: "Local memory", status: "✓",
+            detail: `supermemory reachable at ${localMemCfg.url} - memory tools run fully local, zero cost`,
+        } : {
+            name: "Local memory", status: "⚠",
+            detail: `memoryBackend is "local" but ${localMemCfg.url} isn't reachable`,
+            fix: `Start the local server (see \`npx supermemory local\`), or run \`finch setup\` again.`,
+        });
+    }
+    else {
+        checks.push({
+            name: "Local memory", status: "⚠",
+            detail: `Not configured - memory tools use the Finch-hosted proxy`,
+            fix: `Run \`finch setup\` to switch to a free, self-hosted local memory backend.`,
+        });
+    }
+    // 10. Local vault (user-owned, on-disk) - the account-free alternative to the
+    // Convex-hosted vault.
+    if (cfg.vaultBackend === "local") {
+        const vaultDir = path.join(os.homedir(), ".finch", "vault");
+        let entryCount = 0;
+        try {
+            const idx = JSON.parse(fs.readFileSync(path.join(vaultDir, "index.json"), "utf8"));
+            entryCount = Object.keys(idx.entries ?? {}).length;
+        }
+        catch { /* no index yet */ }
+        checks.push({
+            name: "Local vault", status: "✓",
+            detail: `on-disk at ~/.finch/vault (${entryCount} entr${entryCount === 1 ? "y" : "ies"}) - you own the data, no account needed`,
+        });
+    }
+    else {
+        checks.push({
+            name: "Local vault", status: "⚠",
+            detail: `Not configured - vault tools use the Finch-hosted store (needs login)`,
+            fix: `Run \`finch setup\` to store vault artifacts locally, no account required.`,
+        });
+    }
+    // ── Render ────────────────────────────────────────────────────────────────
+    const colorFor = (s) => s === "✓" ? cli_ui_js_1.C.green : s === "⚠" ? cli_ui_js_1.C.yellow : cli_ui_js_1.C.red;
+    const widest = Math.max(...checks.map((c) => c.name.length));
+    for (const c of checks) {
+        const pad = c.name.padEnd(widest);
+        console.log(`  ${colorFor(c.status)}${c.status}${cli_ui_js_1.C.reset}  ${cli_ui_js_1.C.cyan}${pad}${cli_ui_js_1.C.reset}  ${c.detail}`);
+        if (c.fix)
+            console.log(`     ${" ".repeat(widest)}  ${cli_ui_js_1.C.dim}→ ${c.fix}${cli_ui_js_1.C.reset}`);
+    }
+    const counts = { "✓": 0, "⚠": 0, "✗": 0 };
+    checks.forEach((c) => counts[c.status]++);
+    console.log("");
+    console.log(`  ${cli_ui_js_1.C.dim}Summary:${cli_ui_js_1.C.reset} ${cli_ui_js_1.C.green}${counts["✓"]} ok${cli_ui_js_1.C.reset} · ${cli_ui_js_1.C.yellow}${counts["⚠"]} warning${cli_ui_js_1.C.reset} · ${cli_ui_js_1.C.red}${counts["✗"]} critical${cli_ui_js_1.C.reset}`);
+    console.log("");
+    if (counts["✗"] > 0) {
+        console.log(`  ${cli_ui_js_1.C.red}Critical issues found - fix the lines above before relying on finch.${cli_ui_js_1.C.reset}\n`);
+        process.exit(1);
+    }
+    else if (counts["⚠"] > 0) {
+        console.log(`  ${cli_ui_js_1.C.dim}Warnings are non-blocking - finch works but could be smoother.${cli_ui_js_1.C.reset}\n`);
+    }
+    else {
+        console.log(`  ${cli_ui_js_1.C.green}All systems healthy.${cli_ui_js_1.C.reset}\n`);
+    }
+}

package/dist/cli-env.js

@@ -0,0 +1,91 @@
+"use strict";
+// Bootstrap state shared across every cli-*.ts module: env hydration (must
+// run before anything else reads process.env), tool counts, backend URL,
+// package version, and the local wallet address reader.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PKG_VERSION = exports.CONVEX_SITE = exports.CORE_TOOL_COUNT = exports.TOTAL_TOOL_COUNT = void 0;
+exports.getLocalWalletAddress = getLocalWalletAddress;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const server_js_1 = require("./server.js");
+const tool_filter_js_1 = require("./tool-filter.js");
+const config_js_1 = require("./config.js");
+(0, config_js_1.hydrateEnvFromConfig)();
+// Derived tool counts - single source of truth, kept in sync with the
+// actual registered tools. Updates here propagate to banner, login,
+// and doctor without manual edits.
+exports.TOTAL_TOOL_COUNT = server_js_1.ALL_TOOLS.length;
+exports.CORE_TOOL_COUNT = (() => {
+    const prev = process.env.FINCH_TOOLS;
+    try {
+        process.env.FINCH_TOOLS = "core";
+        return (0, tool_filter_js_1.filterTools)(server_js_1.ALL_TOOLS).length;
+    }
+    finally {
+        if (prev === undefined)
+            delete process.env.FINCH_TOOLS;
+        else
+            process.env.FINCH_TOOLS = prev;
+    }
+})();
+exports.CONVEX_SITE = process.env.FINCH_CONVEX_URL ?? "https://valuable-fish-533.convex.site";
+exports.PKG_VERSION = (() => {
+    try {
+        const raw = fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8");
+        return JSON.parse(raw).version ?? "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+})();
+// Read wallet address from the encrypted JSON without decrypting -
+// ethers stores the address in plaintext inside the keystore file.
+function getLocalWalletAddress() {
+    try {
+        const walletPath = path.join(os.homedir(), ".finch", "wallet.json");
+        if (!fs.existsSync(walletPath))
+            return null;
+        const data = JSON.parse(fs.readFileSync(walletPath, "utf8"));
+        const addr = data.address;
+        if (!addr)
+            return null;
+        return addr.startsWith("0x") ? addr : `0x${addr}`;
+    }
+    catch {
+        return null;
+    }
+}