@bufinance/intelligence

The single source of BU.FI intelligence — Bu's brain.

Framework-neutral: tool definitions, the SOUL persona, the agent loop, arbitration, knowledge-graph, locale, formatters, and one-shot services — with no desk workspace import, UI framework, or agent runtime. All data access is HTTP to the deployed BU.FI surfaces (hyper-mcp + Shiva).

One brain, many channels. Eve is the channel adapter that wires Discord, Slack, and the web app to this package; every surface runs the same brain. The package replaces the two divergent implementations that used to do the same job — desk-v1 @bu/intelligence (in-process) and the bu-intelligence-agent tool copies.

import { tools, SOUL, type BuTool, type BuToolContext } from '@bufinance/intelligence';

A BuTool is { name, description, inputSchema, outputSchema?, gated?, execute(input, ctx) }. The adapter (Eve) wraps each with its own defineTool; the brain never knows the transport. ctx injects the resolved identity + hyper-mcp/Shiva URLs + token.

Circle agent-wallet tools

@bufinance/intelligence/agent-wallet exports the Circle-compatible workspace wallet registry, durable onboarding sequence, and framework-neutral tools used by Eve and other BUFI harnesses. The contract mirrors Open Agents @open-agents/agent-wallet and Circle's Vercel AI/Mastra starter-kit surface.

Adapters may inject ctx.agentWallet.execute for local tests or isolated harness compute. Without an injected executor, tools call the identically named bufi-hyper MCP operation. This package never holds Circle API keys or entity secrets.

The package's policy.approvalRequired flag is mandatory adapter metadata. Eve maps it to a fresh always() human-in-the-loop gate. bufi-hyper must also validate the durable approval event server-side before every wallet mutation, fiat handoff, x402 payment, or Gateway deposit; UI state alone is never authority.

Status

v0.0.0 — scaffold. The consolidation is in progress; see CONSOLIDATION.md for the per-module migration map, the v6→v7 re-homing of the coupled pieces (artifacts/voice), the build order, publishing, and branch landing.

Published from bufinance-publish/intelligence/ (standalone, dist-only, prefixed tags intel-v*) — same pattern as @bufinance/fx / @bufinance/kawaii.