Agent Identity

@agorio/plugin-agent-identity attaches organizational identity to an agent and logs its activity under that identity. It hooks onRegister (to bind the identity at setup) and onBeforeToolCall (to attach identity to each action and record activity).

import { agentIdentity } from '@agorio/plugin-agent-identity';
 
const agent = new ShoppingAgent({
  llm,
  plugins: [
    agentIdentity({
      orgId: 'org_acme',
      agentId: 'agent_acme_procurement_001',
    }),
  ],
});

Identity vs attestation

This plugin handles internal identity bookkeeping — which org and agent performed which action. For cryptographic, externally-verifiable identity on outbound merchant requests, use the SDK’s AgentAttestation helper (the HMAC-signed X-Agorio-Attestation header), which a merchant verifies with verifyAttestation(). The two compose: the plugin tracks who acted, while attestation lets the merchant prove it.

It’s MIT-licensed and published as @agorio/plugin-agent-identity.