feat: add Floe credit action provider

Adds FloeActionProvider — working capital for AI agents on Base.

Financial independence is the precursor to agent autonomy. Long-running
agents can't do anything meaningful without their own fundable balance
sheet. Floe gives them one.

3,000+ secured working capital lines issued. Zero defaults.

8 actions:
  Read: getMarkets, checkStatus, getBalance, checkHealth
  Write: instantBorrow, repay, grantDelegation, x402Fetch

Deposit USDC, borrow up to 95% as a credit line. Fixed rates, per-loan
isolated escrow, gas-free for delegated agents. Fund with a bank account
or card — no crypto experience needed. Built-in x402 payment proxy.

Includes:
  - Full test suite with mocked wallet and API
  - Example agent (typescript/examples/floe-credit-agent/)
  - Provider README

Network: Base Mainnet
Contract: 0x17946cD3e180f82e632805e5549EC913330Bb175

Author: achris7

typescript/agentkit/src/action-providers/floe/README.md

@@ -0,0 +1,55 @@
+# Floe Working Capital Provider
+
+Financial independence is the precursor to agent autonomy. Long-running agents can't do anything meaningful without their own fundable balance sheet. Floe gives them one.
+
+**3,000+ secured working capital lines issued. Zero defaults.**
+
+Deposit USDC, borrow up to 95% as a credit line. Fixed rates, per-loan isolated escrow, gas-free. Fund with a bank account or card — no crypto experience needed.
+
+## Actions
+
+| Action | Type | Description |
+|--------|------|-------------|
+| `getMarkets` | Read | List available lending markets |
+| `instantBorrow` | Write | Deposit USDC, borrow up to 95% working capital — auto-selects best lender |
+| `repay` | Write | Repay a loan (deposit returns automatically) |
+| `checkStatus` | Read | Loan health, balance, accrued interest, time to expiry |
+| `getBalance` | Read | Credit balance for facilitator-delegated agents |
+| `checkHealth` | Read | On-chain LTV and liquidation risk |
+| `grantDelegation` | Write | Delegate credit to Floe facilitator for gas-free x402 payments (one-time) |
+| `x402Fetch` | Write | Call any x402 API — Floe handles payment automatically |
+
+## Setup
+
+```typescript
+import { AgentKit } from "@coinbase/agentkit";
+import { getVercelAITools } from "@coinbase/agentkit-vercel-ai-sdk";
+import { FloeActionProvider } from "@coinbase/agentkit";
+
+const agentkit = await AgentKit.from({
+  walletProvider,
+  actionProviders: [new FloeActionProvider()],
+});
+
+// Use with Vercel AI SDK, LangChain, or any framework
+const tools = getVercelAITools(agentkit);
+```
+
+## Why agents need credit
+
+100M+ x402 machine payments since May 2025. 100,000+ agents with onchain identity. Zero credit outstanding to any of them.
+
+Every economy runs on credit. Agents don't have FICO — but they have something better: deterministic cashflows and verifiable execution history. Floe is the credit bureau and capital rail for AI agents.
+
+## Network
+
+- **Base Mainnet** — Coinbase's L2, built for payments
+- **Contract:** [`0x17946cD3e180f82e632805e5549EC913330Bb175`](https://basescan.org/address/0x17946cD3e180f82e632805e5549EC913330Bb175)
+
+## Links
+
+- [Docs](https://floe-labs.gitbook.io/docs)
+- [Bank Account → First API Call](https://floe-labs.gitbook.io/docs/agents/fiat-to-x402) — fund with fiat, no crypto needed
+- [Full npm package (45 actions)](https://www.npmjs.com/package/floe-agent)
+- [Dashboard](https://dev-dashboard.floelabs.xyz)
+- [Website](https://floelabs.xyz)

typescript/agentkit/src/action-providers/floe/constants.ts

@@ -0,0 +1,86 @@
+import { type Address } from "viem";
+
+export const SUPPORTED_NETWORKS = ["base-mainnet"];
+
+export const LENDING_MATCHER_ADDRESSES: Record<string, Address> = {
+  "base-mainnet": "0x17946cD3e180f82e632805e5549EC913330Bb175",
+};
+
+export const FACILITATOR_ADDRESSES: Record<string, Address> = {
+  "base-mainnet": "0x58EDdE022FFDAD3Fb0Fb0E7D51eb05AaF66a31f1",
+};
+
+export const FACILITATOR_API = "https://credit-api.floelabs.xyz";
+
+export const TOKEN_ADDRESSES: Record<string, Record<string, Address>> = {
+  "base-mainnet": {
+    usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    weth: "0x4200000000000000000000000000000000000006",
+    cbbtc: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
+  },
+};
+
+export const USDC_DECIMALS = 6;
+
+export const LENDING_MATCHER_ABI = [
+  {
+    inputs: [
+      { name: "operator", type: "address" },
+      { name: "borrowLimit", type: "uint256" },
+      { name: "maxRateBps", type: "uint256" },
+      { name: "expiry", type: "uint256" },
+      { name: "onBehalfOfRestriction", type: "address" },
+    ],
+    name: "setOperator",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { name: "agent", type: "address" },
+      { name: "operator", type: "address" },
+    ],
+    name: "getOperatorPermission",
+    outputs: [
+      { name: "approved", type: "bool" },
+      { name: "borrowLimit", type: "uint256" },
+      { name: "borrowed", type: "uint256" },
+      { name: "maxRateBps", type: "uint256" },
+      { name: "expiry", type: "uint256" },
+      { name: "onBehalfOfRestriction", type: "address" },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+] as const;
+
+export const ERC20_ABI = [
+  {
+    inputs: [
+      { name: "spender", type: "address" },
+      { name: "amount", type: "uint256" },
+    ],
+    name: "approve",
+    outputs: [{ name: "", type: "bool" }],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [{ name: "account", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" },
+    ],
+    name: "allowance",
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+] as const;