paybot-mcp 0.2.1 → 0.3.1

package/README.md

@@ -1,109 +1,193 @@
-# paybot-mcp
-
-MCP server for [PayBot](https://paybotcore.com) — payment tools for AI agents via the Model Context Protocol.
-
-## Install
-
-```bash
-npm install paybot-mcp paybot-sdk
-```
-
-## Usage with Claude Desktop
-
-Add to `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "paybot": {
-      "command": "npx",
-      "args": ["paybot-mcp"],
-      "env": {
-        "PAYBOT_API_KEY": "pb_...",
-        "PAYBOT_FACILITATOR_URL": "https://facilitator.paybot.dev",
-        "PAYBOT_BOT_ID": "my-agent"
-      }
-    }
-  }
-}
-```
-
-## Usage with Claude Code
-
-```json
-{
-  "mcpServers": {
-    "paybot": {
-      "command": "npx",
-      "args": ["paybot-mcp"],
-      "env": {
-        "PAYBOT_API_KEY": "pb_...",
-        "PAYBOT_BOT_ID": "my-agent"
-      }
-    }
-  }
-}
-```
-
-## Environment Variables
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `PAYBOT_API_KEY` | PayBot API key | (required) |
-| `PAYBOT_FACILITATOR_URL` | Facilitator server URL | `http://localhost:3000` |
-| `PAYBOT_BOT_ID` | Default bot identifier | `mcp-agent` |
-| `PAYBOT_WALLET_KEY` | Wallet private key for real payments | (optional) |
-
-## Available Tools
-
-| Tool | Description |
-|------|-------------|
-| `paybot_pay` | Make a USDC payment for an API, service, or resource |
-| `paybot_balance` | Check trust level, spending limits, and remaining budget |
-| `paybot_history` | View recent payment history and audit events |
-| `paybot_register` | Register a new bot with the facilitator |
-
-### paybot_pay
-
-```
-amount: string     - Amount in USD (e.g., "0.05")
-recipient: string  - Recipient wallet address (0x...)
-resource: string   - URL or description of what you're paying for
-botId?: string     - Bot identifier (defaults to env)
-network?: string   - Network CAIP-2 ID (default: Base Sepolia)
-```
-
-### paybot_balance
-
-```
-botId?: string - Bot identifier (defaults to env)
-```
-
-### paybot_history
-
-```
-botId?: string  - Bot identifier (defaults to env)
-limit?: number  - Max events to return (default: 10)
-```
-
-### paybot_register
-
-```
-botId: string        - Unique bot identifier
-trustLevel?: number  - Initial trust level 0-5 (default: 1)
-```
-
-## Programmatic Usage
-
-```typescript
-import { createMcpServer } from 'paybot-mcp/server';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-
-const server = createMcpServer();
-const transport = new StdioServerTransport();
-await server.connect(transport);
-```
-
-## License
-
-[Apache 2.0](LICENSE)
+# paybot-mcp
+
+MCP server for [PayBot](https://paybotcore.com) — payment tools for AI agents via the Model Context Protocol.
+
+## Install
+
+```bash
+npm install paybot-mcp paybot-sdk
+```
+
+## Usage with Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "paybot": {
+      "command": "npx",
+      "args": ["paybot-mcp"],
+      "env": {
+        "PAYBOT_API_KEY": "pb_...",
+        "PAYBOT_FACILITATOR_URL": "https://api.paybotcore.com",
+        "PAYBOT_BOT_ID": "my-agent"
+      }
+    }
+  }
+}
+```
+
+## Usage with Claude Code
+
+```json
+{
+  "mcpServers": {
+    "paybot": {
+      "command": "npx",
+      "args": ["paybot-mcp"],
+      "env": {
+        "PAYBOT_API_KEY": "pb_...",
+        "PAYBOT_BOT_ID": "my-agent"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `PAYBOT_API_KEY` | PayBot API key | (required) |
+| `PAYBOT_FACILITATOR_URL` | Facilitator server URL | `https://api.paybotcore.com` |
+| `PAYBOT_BOT_ID` | Default bot identifier | `mcp-agent` |
+| `PAYBOT_WALLET_KEY` | Wallet private key for real payments | (optional) |
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `paybot_pay` | Make a payment (USDC by default; supports alternate tokens + idempotency) |
+| `paybot_balance` | Check trust level, spending limits, and remaining budget |
+| `paybot_history` | View recent payment history and audit events |
+| `paybot_register` | Register a new bot with the facilitator (optional idempotency key) |
+| `paybot_list_networks_and_tokens` | Discover supported networks and tokens (offline, no API key) |
+| `paybot_health_extended` | Extended facilitator health (status/version/uptime + extras) |
+| `paybot_set_spending_limit` | Set per-transaction / daily / hourly limits and a recipient allowlist |
+| `paybot_commission_inspect` | Inspect commission summary and a filterable ledger |
+| `paybot_pool_create` | Create an in-process bot pool with an optional shared treasury |
+| `paybot_pool_allocate` | Add a bot to a pool, optionally paying as it through the treasury |
+| `paybot_pool_revoke` | Remove a bot from a pool |
+| `paybot_pool_status` | Report pool treasury and per-bot spend counters |
+
+### paybot_pay
+
+| Param | Type | Notes |
+|-------|------|-------|
+| `amount` | string | Amount in USD (e.g., `"0.05"`) |
+| `recipient` | string | Recipient wallet address (`0x...`) |
+| `resource` | string | URL or description of what you're paying for |
+| `botId?` | string | Bot identifier (defaults to env) |
+| `network?` | string | Network CAIP-2 ID (default: Base Sepolia) |
+| `token?` | string | Token ticker (default `USDC`); e.g. `USDC`, `EURC`, `DAI` |
+| `idempotencyKey?` | string | Repeat call with the same key returns the cached result |
+
+### paybot_balance
+
+| Param | Type | Notes |
+|-------|------|-------|
+| `botId?` | string | Bot identifier (defaults to env) |
+
+### paybot_history
+
+| Param | Type | Notes |
+|-------|------|-------|
+| `botId?` | string | Bot identifier (defaults to env) |
+| `limit?` | number | Max events to return (default: 10) |
+
+### paybot_register
+
+| Param | Type | Notes |
+|-------|------|-------|
+| `botId` | string | Unique bot identifier |
+| `trustLevel?` | number | Initial trust level 0-5 (default: 1) |
+| `idempotencyKey?` | string | Repeat register with the same key returns the cached result |
+
+### paybot_list_networks_and_tokens
+
+Read-only discovery. Requires no API key and makes zero network calls. Surfaces
+only the **public** open-core registry — operator-private mainnet addresses are
+never shown (e.g. EURC advertises its Base Sepolia testnet deployment only).
+
+_No parameters._
+
+### paybot_health_extended
+
+| Param | Type | Notes |
+|-------|------|-------|
+| `botId?` | string | Bot identifier (defaults to env) |
+
+Returns `status`, `version`, `uptime`, `timestamp`, plus any extra fields the
+facilitator reports.
+
+### paybot_set_spending_limit
+
+Tightens an agent's own limits. The facilitator enforces the operator ceiling
+and may reject attempts to loosen beyond policy.
+
+| Param | Type | Notes |
+|-------|------|-------|
+| `botId?` | string | Bot identifier (defaults to env) |
+| `maxTransactionUsd?` | number | Max USD per transaction |
+| `maxDailySpendUsd?` | number | Max USD spend per day |
+| `maxTransactionsPerHour?` | number | Max transactions per hour |
+| `allowedRecipients?` | string[] | Allowlist of recipient addresses |
+
+### paybot_commission_inspect
+
+| Param | Type | Notes |
+|-------|------|-------|
+| `botId?` | string | Bot identifier (defaults to env) |
+| `status?` | enum | Filter ledger by `pending` \| `forwarded` \| `deferred` |
+| `startDate?` | string | Ledger start date (ISO 8601) |
+| `endDate?` | string | Ledger end date (ISO 8601) |
+| `limit?` | number | Max ledger entries (default: 50) |
+| `offset?` | number | Ledger pagination offset |
+
+### paybot_pool_create
+
+Creates an in-process bot pool for this MCP session. Treasury accounting is
+in-memory; the facilitator remains the authoritative limit.
+
+| Param | Type | Notes |
+|-------|------|-------|
+| `poolId` | string | Identifier for this pool (used by allocate/revoke/status) |
+| `sharedDailyLimitUsd?` | number | Optional shared daily spend cap across all bots |
+
+### paybot_pool_allocate
+
+| Param | Type | Notes |
+|-------|------|-------|
+| `poolId` | string | Pool identifier |
+| `botId` | string | Bot identifier to add to the pool |
+| `trustLevel?` | number | Initial trust level 0-5 |
+| `pay?` | object | Optional `{ amount, recipient, resource, network?, token? }` to pay as this bot |
+
+### paybot_pool_revoke
+
+| Param | Type | Notes |
+|-------|------|-------|
+| `poolId` | string | Pool identifier |
+| `botId` | string | Bot identifier to remove |
+
+### paybot_pool_status
+
+| Param | Type | Notes |
+|-------|------|-------|
+| `poolId` | string | Pool identifier |
+
+## Programmatic Usage
+
+```typescript
+import { createMcpServer } from 'paybot-mcp/server';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+
+const server = createMcpServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);
+```
+
+## License
+
+[Apache 2.0](LICENSE)

package/dist/denial-guidance.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @module denial-guidance
+ *
+ * Plain-language operator guidance for PayBot policy denials.
+ *
+ * When `paybot_pay` (or any policy-gated tool) is denied by core, the SDK
+ * returns a machine `errorCode` (e.g. `DAILY_LIMIT_EXCEEDED`). On its own that
+ * code is actionable only to someone who already knows the policy model. This
+ * module maps each known policy code to a single plain-language sentence
+ * telling the agent (and the human reading its log) what to do about it — so a
+ * trust/limit/policy denial is actionable without opening core's logs.
+ *
+ * Scope: guidance is offered ONLY for codes that core treats as policy
+ * decisions (the SDK's {@link POLICY_ERROR_CODES} set). Non-policy failures
+ * (network, facilitator unreachable, signing) carry no guidance — fabricating
+ * a "what to do" line for an infrastructure error would be misleading.
+ *
+ * Dependencies: none at runtime. The policy code set mirrors the SDK's
+ *   `POLICY_ERROR_CODES`; see {@link POLICY_ERROR_CODES} note below.
+ * Used by: src/server.ts (`paybot_pay` denial path).
+ */
+/**
+ * Codes core treats as policy decisions (trust / AML / limit / envelope).
+ *
+ * This mirrors paybot-sdk's internal `POLICY_ERROR_CODES`. The SDK defines the
+ * set in its `errors` module but does NOT re-export it from the package root
+ * (paybot-sdk@0.4.0 only re-exports the error classes such as
+ * `PayBotPolicyError`). Rather than reach into an un-exported submodule, the
+ * MCP keeps a local copy of this small, stable set — decoupling the tool from
+ * the SDK's internal module layout. Keep in sync if the SDK adds policy codes.
+ */
+export declare const POLICY_ERROR_CODES: ReadonlySet<string>;
+/**
+ * One-line, no-hype action for each known policy code. Keys MUST be a subset of
+ * {@link POLICY_ERROR_CODES}; a code that is in the set but missing here falls
+ * back to {@link GENERIC_POLICY_GUIDANCE} (still actionable, never silent).
+ *
+ * Company voice: direct, technical, no marketing language, ≤1 sentence.
+ */
+export declare const POLICY_GUIDANCE: Readonly<Record<string, string>>;
+/**
+ * Fallback guidance for a policy code that core flags but this map does not yet
+ * cover (e.g. a future SDK policy code). Keeps a denial actionable and never
+ * silently omits the code — it just cannot offer a code-specific next step.
+ */
+export declare const GENERIC_POLICY_GUIDANCE = "This payment was blocked by a spending policy; review the bot's limits and trust level with paybot_balance, then adjust with paybot_set_spending_limit.";
+/**
+ * Resolve the plain-language guidance line for a denial error code.
+ *
+ * Returns guidance ONLY for policy codes (members of the SDK's
+ * {@link POLICY_ERROR_CODES}). Known codes get their mapped sentence; a policy
+ * code with no explicit mapping gets {@link GENERIC_POLICY_GUIDANCE}. Any code
+ * that is not a policy code — and a missing/undefined code — returns `null`, so
+ * the caller surfaces the SDK's own error text without fabricating advice.
+ *
+ * @param errorCode - Machine code from the SDK `PaymentResult.errorCode`, or
+ *   undefined when the SDK did not provide one.
+ * @returns A one-line guidance string for policy denials, otherwise `null`.
+ *
+ * @example
+ * policyGuidance('DAILY_LIMIT_EXCEEDED')
+ * // → 'Raise the per-day limit with paybot_set_spending_limit, ...'
+ * policyGuidance('NETWORK_ERROR')
+ * // → null  (non-policy failure: no guidance)
+ */
+export declare function policyGuidance(errorCode: string | undefined): string | null;
+/**
+ * Build the full denial response text for a failed `PaymentResult`.
+ *
+ * Surfaces the machine `errorCode` and the human `errorDetails` (when present)
+ * in addition to the SDK's `error` message, then appends a plain-language
+ * guidance line for policy denials. Mirrors the in-repo reference pattern in
+ * `paybot_pool_allocate`, which already surfaces `errorCode` on the flagship
+ * tool's behalf.
+ *
+ * Behaviour by case:
+ * - Policy denial with a known code → message + `Code:` + `Details:` (if any) + guidance.
+ * - Policy denial with an unmapped policy code → as above with generic guidance.
+ * - Non-policy failure with a real SDK code → message + `Code:` (+ details), NO guidance.
+ * - Non-policy failure with no code → message only (unchanged legacy text), NO invented code.
+ *
+ * @param result - The failed payment result (`success: false`). Only `error`,
+ *   `errorCode`, and `errorDetails` are read.
+ * @returns The multi-line denial text for the MCP tool response.
+ *
+ * @example
+ * formatDenial({ error: 'Daily limit exceeded', errorCode: 'DAILY_LIMIT_EXCEEDED' })
+ * // → 'Payment failed: Daily limit exceeded\nCode: DAILY_LIMIT_EXCEEDED\nGuidance: Raise the per-day limit ...'
+ */
+export declare function formatDenial(result: {
+    error?: string;
+    errorCode?: string;
+    errorDetails?: Record<string, unknown>;
+}): string;
+//# sourceMappingURL=denial-guidance.d.ts.map

package/dist/denial-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"denial-guidance.d.ts","sourceRoot":"","sources":["../src/denial-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAKjD,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS3D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,4JACwH,CAAC;AAE7J;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAQ3E;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,GAAG,MAAM,CAiBT"}

package/dist/denial-guidance.js

@@ -0,0 +1,122 @@
+/**
+ * @module denial-guidance
+ *
+ * Plain-language operator guidance for PayBot policy denials.
+ *
+ * When `paybot_pay` (or any policy-gated tool) is denied by core, the SDK
+ * returns a machine `errorCode` (e.g. `DAILY_LIMIT_EXCEEDED`). On its own that
+ * code is actionable only to someone who already knows the policy model. This
+ * module maps each known policy code to a single plain-language sentence
+ * telling the agent (and the human reading its log) what to do about it — so a
+ * trust/limit/policy denial is actionable without opening core's logs.
+ *
+ * Scope: guidance is offered ONLY for codes that core treats as policy
+ * decisions (the SDK's {@link POLICY_ERROR_CODES} set). Non-policy failures
+ * (network, facilitator unreachable, signing) carry no guidance — fabricating
+ * a "what to do" line for an infrastructure error would be misleading.
+ *
+ * Dependencies: none at runtime. The policy code set mirrors the SDK's
+ *   `POLICY_ERROR_CODES`; see {@link POLICY_ERROR_CODES} note below.
+ * Used by: src/server.ts (`paybot_pay` denial path).
+ */
+/**
+ * Codes core treats as policy decisions (trust / AML / limit / envelope).
+ *
+ * This mirrors paybot-sdk's internal `POLICY_ERROR_CODES`. The SDK defines the
+ * set in its `errors` module but does NOT re-export it from the package root
+ * (paybot-sdk@0.4.0 only re-exports the error classes such as
+ * `PayBotPolicyError`). Rather than reach into an un-exported submodule, the
+ * MCP keeps a local copy of this small, stable set — decoupling the tool from
+ * the SDK's internal module layout. Keep in sync if the SDK adds policy codes.
+ */
+export const POLICY_ERROR_CODES = new Set([
+    'TRUST_VIOLATION',
+    'AML_BLOCKED',
+    'DAILY_LIMIT_EXCEEDED',
+    'SPENDING_ENVELOPE',
+]);
+/**
+ * One-line, no-hype action for each known policy code. Keys MUST be a subset of
+ * {@link POLICY_ERROR_CODES}; a code that is in the set but missing here falls
+ * back to {@link GENERIC_POLICY_GUIDANCE} (still actionable, never silent).
+ *
+ * Company voice: direct, technical, no marketing language, ≤1 sentence.
+ */
+export const POLICY_GUIDANCE = Object.freeze({
+    DAILY_LIMIT_EXCEEDED: 'Raise the per-day limit with paybot_set_spending_limit, or wait for the daily window to reset.',
+    TRUST_VIOLATION: 'This bot\'s trust level is too low for this payment; raise its trust level or route the payment through a higher-trust bot.',
+    AML_BLOCKED: 'The recipient or amount was flagged by AML screening; verify the recipient address and amount, and escalate to an operator if it is expected.',
+    SPENDING_ENVELOPE: 'The payment falls outside this bot\'s allowed spending envelope; widen the envelope with paybot_set_spending_limit or use an in-envelope recipient/amount.',
+});
+/**
+ * Fallback guidance for a policy code that core flags but this map does not yet
+ * cover (e.g. a future SDK policy code). Keeps a denial actionable and never
+ * silently omits the code — it just cannot offer a code-specific next step.
+ */
+export const GENERIC_POLICY_GUIDANCE = 'This payment was blocked by a spending policy; review the bot\'s limits and trust level with paybot_balance, then adjust with paybot_set_spending_limit.';
+/**
+ * Resolve the plain-language guidance line for a denial error code.
+ *
+ * Returns guidance ONLY for policy codes (members of the SDK's
+ * {@link POLICY_ERROR_CODES}). Known codes get their mapped sentence; a policy
+ * code with no explicit mapping gets {@link GENERIC_POLICY_GUIDANCE}. Any code
+ * that is not a policy code — and a missing/undefined code — returns `null`, so
+ * the caller surfaces the SDK's own error text without fabricating advice.
+ *
+ * @param errorCode - Machine code from the SDK `PaymentResult.errorCode`, or
+ *   undefined when the SDK did not provide one.
+ * @returns A one-line guidance string for policy denials, otherwise `null`.
+ *
+ * @example
+ * policyGuidance('DAILY_LIMIT_EXCEEDED')
+ * // → 'Raise the per-day limit with paybot_set_spending_limit, ...'
+ * policyGuidance('NETWORK_ERROR')
+ * // → null  (non-policy failure: no guidance)
+ */
+export function policyGuidance(errorCode) {
+    if (!errorCode) {
+        return null;
+    }
+    if (!POLICY_ERROR_CODES.has(errorCode)) {
+        return null;
+    }
+    return POLICY_GUIDANCE[errorCode] ?? GENERIC_POLICY_GUIDANCE;
+}
+/**
+ * Build the full denial response text for a failed `PaymentResult`.
+ *
+ * Surfaces the machine `errorCode` and the human `errorDetails` (when present)
+ * in addition to the SDK's `error` message, then appends a plain-language
+ * guidance line for policy denials. Mirrors the in-repo reference pattern in
+ * `paybot_pool_allocate`, which already surfaces `errorCode` on the flagship
+ * tool's behalf.
+ *
+ * Behaviour by case:
+ * - Policy denial with a known code → message + `Code:` + `Details:` (if any) + guidance.
+ * - Policy denial with an unmapped policy code → as above with generic guidance.
+ * - Non-policy failure with a real SDK code → message + `Code:` (+ details), NO guidance.
+ * - Non-policy failure with no code → message only (unchanged legacy text), NO invented code.
+ *
+ * @param result - The failed payment result (`success: false`). Only `error`,
+ *   `errorCode`, and `errorDetails` are read.
+ * @returns The multi-line denial text for the MCP tool response.
+ *
+ * @example
+ * formatDenial({ error: 'Daily limit exceeded', errorCode: 'DAILY_LIMIT_EXCEEDED' })
+ * // → 'Payment failed: Daily limit exceeded\nCode: DAILY_LIMIT_EXCEEDED\nGuidance: Raise the per-day limit ...'
+ */
+export function formatDenial(result) {
+    const lines = [`Payment failed: ${result.error ?? 'unknown error'}`];
+    if (result.errorCode) {
+        lines.push(`Code: ${result.errorCode}`);
+    }
+    if (result.errorDetails && Object.keys(result.errorDetails).length > 0) {
+        lines.push(`Details: ${JSON.stringify(result.errorDetails)}`);
+    }
+    const guidance = policyGuidance(result.errorCode);
+    if (guidance) {
+        lines.push(`Guidance: ${guidance}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=denial-guidance.js.map

package/dist/denial-guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"denial-guidance.js","sourceRoot":"","sources":["../src/denial-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC;IAC7D,iBAAiB;IACjB,aAAa;IACb,sBAAsB;IACtB,mBAAmB;CACpB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC7E,oBAAoB,EAClB,gGAAgG;IAClG,eAAe,EACb,6HAA6H;IAC/H,WAAW,EACT,+IAA+I;IACjJ,iBAAiB,EACf,4JAA4J;CAC/J,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAClC,0JAA0J,CAAC;AAE7J;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAC,SAA6B;IAC1D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,eAAe,CAAC,SAAS,CAAC,IAAI,uBAAuB,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,YAAY,CAAC,MAI5B;IACC,MAAM,KAAK,GAAa,CAAC,mBAAmB,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;IAE/E,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/server.d.ts

@@ -2,11 +2,17 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
  * Create a PayBot MCP server exposing payment tools to AI agents.
  *
- * Tools:
- * - paybot_pay — make a USDC payment
+ * Tools (v0.3.0):
+ * - paybot_pay — make a payment (USDC default; optional token + idempotencyKey)
  * - paybot_balance — check spending limits and budget
  * - paybot_history — view recent payment history
- * - paybot_register — register a new bot
+ * - paybot_register — register a new bot (optional idempotencyKey)
+ * - paybot_list_networks_and_tokens — discover supported networks/tokens (offline, public registry only)
+ * - paybot_health_extended — facilitator health (status/version/uptime + extras)
+ * - paybot_set_spending_limit — tighten an agent's own spending limits
+ * - paybot_commission_inspect — commission summary + ledger
+ * - paybot_pool_create / paybot_pool_allocate / paybot_pool_revoke / paybot_pool_status —
+ *   in-process multi-bot pool with a shared daily treasury
  */
 export declare function createMcpServer(): McpServer;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAwJ3C"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiDpE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAkjB3C"}