IF Commons GitHub

models/identity-agent/mod

Written to: 4 requirements: 4 proved, 0 partly, 0 failing, 0 with no test recorded. 0040-identity-agent FR-001, 0040-identity-agent FR-002, 0040-identity-agent FR-003, 0040-identity-agent FR-004

AI agents as a module (commons data 0040-identity-agent). An agent is a principal that decides for itself what to do, and so it is accountable to an owner, has a provenance (which model, which prompt, which tools, at which version), has autonomy that is limited by a level, acts in runs under delegations, calls tools it has been granted, spends budgets that cannot be exceeded, and asks a person before anything risky. A version of an agent can be revoked, which pulls a bad model, prompt or tool set from every run that uses it.

Source: commons/data/models/identity-agent/mod.ts

1 of 19 exports are imported by a test of the run. A test that imports an export may not call it or check what it returns.

autonomyLevelconstno test imports it
const autonomyLevel: CodeList<string, string>

How much an agent may do without a person.

versionStatusconstno test imports it
const versionStatus: CodeList<string, string>

Where a version of an agent is.

runStatusconstno test imports it
const runStatus: CodeList<string, string>

Where a run of an agent is.

toolApprovalconstno test imports it
const toolApproval: CodeList<string, string>

Whether a tool grant needs approval.

callDecisionconstno test imports it
const callDecision: CodeList<string, string>

What was decided about a tool call.

callStatusconstno test imports it
const callStatus: CodeList<string, string>

Where a tool call is.

meterconstno test imports it
const meter: CodeList<string, string>

What a budget counts.

windowKindconstno test imports it
const windowKind: CodeList<string, string>

How long a budget lasts.

approvalStatusconstno test imports it
const approvalStatus: CodeList<string, string>

A program that decides for itself what to do, accountable to an owner and limited by its level of autonomy.

approverRuleconstno test imports it
const approverRule: CodeList<string, string>

A program that decides for itself what to do, accountable to an owner and limited by its level of autonomy.

agentconstno test imports it
const agent: Concept<"agent", { readonly autonomy: Attribute<Datatype, Multiplicity>; readonly purpose: Attribute<Dataty… (724 characters)
const agent: Concept<"agent", { readonly autonomy: Attribute<Datatype, Multiplicity>; readonly purpose: Attribute<Datatype, Multiplicity>; readonly framework: Attribute<Datatype, Multiplicity>; readonly frameworkVersion: Attribute<Datatype, Multiplicity>; readonly provider: Attribute<Datatype, Multiplicity>; readonly cardUrl: Attribute<Datatype, Multiplicity>; readonly approvalThreshold: Attribute<Datatype, Multiplicity>; readonly maxDelegationDepth: Attribute<Datatype, Multiplicity>; readonly maxConcurrentRuns: Attribute<Datatype, Multiplicity>; }, { readonly principal: Relationship<"one", AnyConcept | (() => AnyConcept)>; readonly sponsor: Relationship<"optional", AnyConcept | (() => AnyConcept)>; }, "principal">

An agent: a principal that decides for itself what to do, accountable to an owner. Its identity is its principal's.

agentVersionconstno test imports it
const agentVersion: Concept<"agentVersion", { readonly agentVersionId: Attribute<Datatype, Multiplicity>; readonly versi… (901 characters)
const agentVersion: Concept<"agentVersion", { readonly agentVersionId: Attribute<Datatype, Multiplicity>; readonly versionLabel: Attribute<Datatype, Multiplicity>; readonly modelProvider: Attribute<Datatype, Multiplicity>; readonly modelName: Attribute<Datatype, Multiplicity>; readonly modelVersion: Attribute<Datatype, Multiplicity>; readonly promptHash: Attribute<Datatype, Multiplicity>; readonly toolManifestHash: Attribute<Datatype, Multiplicity>; readonly codeRef: Attribute<Datatype, Multiplicity>; readonly status: Attribute<Datatype, Multiplicity>; readonly approvedAt: Attribute<Datatype, Multiplicity>; readonly createdAt: Attribute<Datatype, Multiplicity>; readonly versionKey: Attribute<Datatype, Multiplicity>; }, { readonly agent: Relationship<"one", AnyConcept | (() => AnyConcept)>; readonly approvedBy: Relationship<"optional", AnyConcept | (() => AnyConcept)>; }, "agentVersionId">

A version of an agent: which model, which prompt and which tools, pinned. Revoking it pulls it from every run.

agentToolconstno test imports it
const agentTool: Concept<"agentTool", { readonly agentToolId: Attribute<Datatype, Multiplicity>; readonly name: Attribut… (659 characters)
const agentTool: Concept<"agentTool", { readonly agentToolId: Attribute<Datatype, Multiplicity>; readonly name: Attribute<Datatype, Multiplicity>; readonly definition: Attribute<Datatype, Multiplicity>; readonly serverAudience: Attribute<Datatype, Multiplicity>; readonly riskLevel: Attribute<Datatype, Multiplicity>; readonly sideEffect: Attribute<Datatype, Multiplicity>; readonly argsSchemaHash: Attribute<Datatype, Multiplicity>; readonly status: Attribute<Datatype, Multiplicity>; }, { readonly tenant: Relationship<"optional", AnyConcept | (() => AnyConcept)>; readonly permission: Relationship<"one", AnyConcept | (() => AnyConcept)>; }, "agentToolId">

A tool that agents may be granted: its name, what it needs, how risky it is.

toolGrantconstno test imports it
const toolGrant: Concept<"toolGrant", { readonly expression: Attribute<Datatype, Multiplicity>; readonly approval: Attri… (553 characters)
const toolGrant: Concept<"toolGrant", { readonly expression: Attribute<Datatype, Multiplicity>; readonly approval: Attribute<Datatype, Multiplicity>; readonly maxCallsPerRun: Attribute<Datatype, Multiplicity>; readonly validTo: Attribute<Datatype, Multiplicity>; readonly status: Attribute<Datatype, Multiplicity>; }, { readonly agent: Relationship<"one", AnyConcept | (() => AnyConcept)>; readonly tool: Relationship<"one", AnyConcept | (() => AnyConcept)>; readonly grantedBy: Relationship<"one", AnyConcept | (() => AnyConcept)>; }, "agent" | "tool">

A tool that an agent has been granted, with a limit on its calls: never more than its owner may do.

agentRunconstno test imports it
const agentRun: AnyConcept

A run of an agent: one task, in one version, perhaps under a delegation, perhaps started by another run.

toolCallconstno test imports it
const toolCall: AnyConcept

A call of a tool in a run: what was decided, and a hash of the arguments, never the arguments.

agentBudgetconstno test imports it
const agentBudget: Concept<"agentBudget", { readonly budgetId: Attribute<Datatype, Multiplicity>; readonly meter: Attrib… (770 characters)
const agentBudget: Concept<"agentBudget", { readonly budgetId: Attribute<Datatype, Multiplicity>; readonly meter: Attribute<Datatype, Multiplicity>; readonly windowKind: Attribute<Datatype, Multiplicity>; readonly limitValue: Attribute<Datatype, Multiplicity>; readonly used: Attribute<Datatype, Multiplicity>; readonly windowStart: Attribute<Datatype, Multiplicity>; readonly version: Attribute<Datatype, Multiplicity>; readonly status: Attribute<Datatype, Multiplicity>; readonly budgetKey: Attribute<Datatype, Multiplicity>; }, { readonly agent: Relationship<"one", AnyConcept | (() => AnyConcept)>; readonly delegation: Relationship<"optional", AnyConcept | (() => AnyConcept)>; readonly run: Relationship<"optional", AnyConcept | (() => AnyConcept)>; }, "budgetId">

A budget: what an agent, under a delegation or in a run, may spend. A leaf: nothing refers to it, so it is updated in place.

approvalRequestconstno test imports it
const approvalRequest: Concept<"approvalRequest", { readonly approvalRequestId: Attribute<Datatype, Multiplicity>; reado… (1166 characters)
const approvalRequest: Concept<"approvalRequest", { readonly approvalRequestId: Attribute<Datatype, Multiplicity>; readonly actionKey: Attribute<Datatype, Multiplicity>; readonly resourceType: Attribute<Datatype, Multiplicity>; readonly resourceId: Attribute<Datatype, Multiplicity>; readonly argsHash: Attribute<Datatype, Multiplicity>; readonly summary: Attribute<Datatype, Multiplicity>; readonly riskLevel: Attribute<Datatype, Multiplicity>; readonly approverRule: Attribute<Datatype, Multiplicity>; readonly status: Attribute<Datatype, Multiplicity>; readonly requestedAt: Attribute<Datatype, Multiplicity>; readonly expiresAt: Attribute<Datatype, Multiplicity>; readonly decidedAt: Attribute<Datatype, Multiplicity>; readonly decisionReason: Attribute<Datatype, Multiplicity>; readonly consumedAt: Attribute<Datatype, Multiplicity>; }, { readonly run: Relationship<"one", AnyConcept | (() => AnyConcept)>; readonly agent: Relationship<"one", AnyConcept | (() => AnyConcept)>; readonly approverRole: Relationship<"optional", AnyConcept | (() => AnyConcept)>; readonly decidedBy: Relationship<"optional", AnyConcept | (() => AnyConcept)>; }, "approvalRequestId">

A request for a person to approve one call, bound to a hash of its arguments, usable once.

identityAgentModuleconst
const identityAgentModule: Module

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

Imported by 25 tests of the run (25 passed, 0 failed): the library's results

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