IF Commons GitHub

identity agent

AI agents: provenance, tools, runs, budgets and approvals

Applies to: Identity and access. Who may do what: principals, sessions, roles, policies, relationships, keys and certificates, machines, devices, delegation and agents.

Written in commons/data/models/identity-agent/mod.ts:214. Requires identityDelegation, identityRebac. 8 concepts, 10 code lists.

principal sponsor agent delegation run agent delegation initiator parentRun tenant version permission tenant agent approvedBy agent approverRole decidedBy run approval run tool agent grantedBy tool agent principal agent_budget delegation agentRun agent_run tenant agentVersion agent_tool permission agent_version approval_request accessRole tool_call approvalRequest agentTool tool_grant
How the concepts of identity agent relate
Diagram source
flowchart LR
  agent -->|principal| principal
  agent -->|sponsor| principal
  agent_budget -->|agent| agent
  agent_budget -->|delegation| delegation
  agent_budget -->|run| agentRun
  agent_run -->|agent| agent
  agent_run -->|delegation| delegation
  agent_run -->|initiator| principal
  agent_run -->|parentRun| agentRun
  agent_run -->|tenant| tenant
  agent_run -->|version| agentVersion
  agent_tool -->|permission| permission
  agent_tool -->|tenant| tenant
  agent_version -->|agent| agent
  agent_version -->|approvedBy| principal
  approval_request -->|agent| principal
  approval_request -->|approverRole| accessRole
  approval_request -->|decidedBy| principal
  approval_request -->|run| agentRun
  tool_call -->|approval| approvalRequest
  tool_call -->|run| agentRun
  tool_call -->|tool| agentTool
  tool_grant -->|agent| agent
  tool_grant -->|grantedBy| principal
  tool_grant -->|tool| agentTool

Concepts

ConceptDefinitionAttributesWritten in
agentA program that decides for itself what to do, accountable to an owner and limited by its level of autonomy9commons/data/models/identity-agent/mod.ts:40
agentBudgetWhat an agent, under a delegation or in a run, may spend of a meter in a window; it cannot be exceeded9commons/data/models/identity-agent/mod.ts:165
agentRunOne task of an agent, in one version, perhaps under a delegation, perhaps started by another run7commons/data/models/identity-agent/mod.ts:114
agentToolA tool that agents may be granted: what it is called, the permission a call needs, how risky it is8commons/data/models/identity-agent/mod.ts:81
agentVersionA version of an agent: which model, which prompt and which tools, pinned, so that a bad one can be pulled from every run12commons/data/models/identity-agent/mod.ts:59
approvalRequestA request for a person to approve one action of an agent, bound to a hash of its arguments, usable once14commons/data/models/identity-agent/mod.ts:184
toolCallA call of a tool in a run: what was decided, and a hash of its arguments, never the arguments17commons/data/models/identity-agent/mod.ts:138
toolGrantA tool that an agent has been granted, perhaps with a condition on its calls, never more than the agent's owner may do5commons/data/models/identity-agent/mod.ts:99

Code lists

Code listDefinitionCodes
approvalStatusWhere a request for approval is6
approverRuleWho may approve3
autonomyLevelHow much an agent may do without a person4
callDecisionWhat was decided about a tool call4
callStatusWhere a tool call is4
meterWhat a budget counts4
runStatusWhere a run of an agent is6
toolApprovalWhether a tool grant needs approval2
versionStatusWhere a version of an agent is5
windowKindHow long a budget lasts5

Titles, headings, exports, tables, columns and requirements. Esc closes.