@kevros/agentkit

Governance primitive for Coinbase AgentKit — 16 governance actions including verify, attest, bind, verify-outcome, delegate, batch, and more. One import, sixteen actions.

Install

npm install @kevros/agentkit

Quick Start

import { AgentKit } from "@coinbase/agentkit";
import { CdpEvmWalletProvider } from "@coinbase/agentkit/wallet-providers";
import { kevrosGovernanceProvider } from "@kevros/agentkit";

const agentKit = new AgentKit({
  walletProvider: new CdpEvmWalletProvider({ ... }),
  actionProviders: [kevrosGovernanceProvider({ agentId: "my-agent" })],
});

// Your agent now has 16 governance actions alongside all Coinbase actions

Actions

| Action | Description | Cost | |--------|-------------|------| | verify_action | Check if an action is allowed. Returns ALLOW/CLAMP/DENY with cryptographic release token. | $0.01 | | attest_provenance | Record an action in a hash-chained, tamper-evident provenance ledger. Post-quantum attested. | $0.02 | | bind_intent | Cryptographically bind a declared intent to the command that fulfills it. | $0.02 | | bind_wallet | Bind a Coinbase wallet address to a governance identity. | $0.02 | | verify_outcome | Verify that an executed action achieved its declared intent. | Free | | request_bundle | Generate a certifier-grade compliance evidence bundle. | $0.05 | | check_peer_trust | Check another agent's trust score and provenance history before collaborating. | Free | | delegate | Grant scoped, time-limited capabilities to another agent. | Free | | list_delegations | List active delegation tokens for an agent. | Free | | revoke_delegation | Revoke a delegation token. | Free | | batch_operations | Execute up to 100 governance operations in a single call. | Per-op | | replay_decisions | Replay historical verify decisions through an alternative policy. | Free | | update_policy | Create or update a named policy template. | Free | | policy_history | Get the version history for a policy template. | Free | | create_webhook | Register a webhook for governance event notifications. | Free | | list_webhooks | List webhook subscriptions registered by this operator. | Free |

Configuration

// Zero config (auto-signup: 1,000 free calls/mo)
kevrosGovernanceProvider({ agentId: "my-agent" })

// Explicit API key
kevrosGovernanceProvider({ apiKey: "kvrs_..." })

// Custom gateway
kevrosGovernanceProvider({
  apiKey: "kvrs_...",
  gatewayUrl: "https://your-gateway.example.com",
})

Runtime

Node.js only. This package uses filesystem access (~/.kevros/api_key) for API key caching during auto-signup. It will not work in browser environments or Cloudflare Workers. This matches AgentKit's server-side agent deployment pattern.

Links

• Kevros Gateway
• Agent Card
• x402 Discovery
• TaskHawk Systems

License

BSL-1.1 — © TaskHawk Systems LLC