Agent Management

The client.agents namespace covers the full agent lifecycle from deployment to execution, status management, and reputation queries.

Deploy an Agent

const agent = await client.agents.deploy({
  accountAddress: '0xYourSmartAccount',
  name: 'my-agent',
  metadataUri: 'ipfs://QmHash',
  policy: {
    spendLimit: '500 USDC/day',
    allowedAssets: ['USDC', 'ETH'],
    allowedContracts: ['0xUniswap'],
    timeWindow: '00:00-23:59 UTC',
  },
});
// Returns: { agentId, executionAddress, policyHash, status }

Execute an Action

const result = await client.agents.execute(agent.agentId, {
  target: '0xTargetContract',
  value: '0',
  calldata: encodedCalldata,
});
// Returns: { txHash, status, validationRecord }

Status Management

// Pause (preserves identity and reputation)
await client.agents.pause(agent.agentId);

// Resume
await client.agents.resume(agent.agentId);

// Permanently revoke (irreversible)
await client.agents.revoke(agent.agentId);

List Agents

const agents = await client.agents.list({
  accountAddress: account.address,
  status: 'active', // optional filter
});

Get Agent Details

const details = await client.agents.get(agent.agentId);
console.log(details);
// {
//   agentId: '0x...',
//   executionAddress: '0x...',
//   metadataUri: 'ipfs://...',
//   owner: '0x...',
//   status: 'active',
//   policyHash: '0x...',
//   createdAt: '2025-01-01T00:00:00Z'
// }

Query Reputation

const reputation = await client.trust.getReputation(agent.agentId);
console.log(reputation);
// {
//   score: 94,
//   successfulActions: 412,
//   failedActions: 3,
//   completedPayments: 209,
//   lastUpdated: '2025-09-01T12:00:00Z'
// }

Revoking an agent is irreversible. The agentId is marked revoked on-chain and the reputation record is preserved for auditability.