Permissions

type Permission = {
  /** Stable cuid for this grant. */
  id: string;
  /** Agent's externalId. */
  agent_id: string;
  wallet_address: string;
  wallet_display_name: string;
  /** "active" once the wallet owner has authorized the signer on-chain;
   *  "pending" before that. */
  status: "active" | "pending";
  max_per_tx_usdc: string;
  daily_cap_usdc: string | null;
  /** USDC moved by this grant today (UTC). */
  used_today_usdc: string;
  /** daily_cap_usdc minus used_today_usdc, or null if uncapped. */
  remaining_today_usdc: string | null;
  recipient_allowlist: string[];
  contract_allowlist: string[];
  expires_at: string | null;
  created_at: string;
  activated_at: string | null;
};

type PermissionListFilters = {
  /** Filter by agent externalId. */
  agent_id?: string;
  /** Max items per page. Default 50, max 100. */
  limit?: number;
};

// Iterate every grant in the account
for await (const p of tally.permissions.list()) {
  console.log(`${p.agent_id} → ${p.wallet_display_name}: $${p.remaining_today_usdc} left`);
}

// Filter by agent + cap the read
const grants = await tally.permissions.list({
  agent_id: "research-bot",
}).toArray(20);