autonomyLevelconstno test imports itconst autonomyLevel: CodeList<string, string>How much an agent may do without a person.
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.
autonomyLevelconstno test imports itconst autonomyLevel: CodeList<string, string>How much an agent may do without a person.
versionStatusconstno test imports itconst versionStatus: CodeList<string, string>Where a version of an agent is.
runStatusconstno test imports itconst runStatus: CodeList<string, string>Where a run of an agent is.
toolApprovalconstno test imports itconst toolApproval: CodeList<string, string>Whether a tool grant needs approval.
callDecisionconstno test imports itconst callDecision: CodeList<string, string>What was decided about a tool call.
callStatusconstno test imports itconst callStatus: CodeList<string, string>Where a tool call is.
meterconstno test imports itconst meter: CodeList<string, string>What a budget counts.
windowKindconstno test imports itconst windowKind: CodeList<string, string>How long a budget lasts.
approvalStatusconstno test imports itconst 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 itconst 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 itconst 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 itconst 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 itconst 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 itconst 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 itconst agentRun: AnyConceptA run of an agent: one task, in one version, perhaps under a delegation, perhaps started by another run.
toolCallconstno test imports itconst toolCall: AnyConceptA call of a tool in a run: what was decided, and a hash of the arguments, never the arguments.
agentBudgetconstno test imports itconst 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 itconst 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.
identityAgentModuleconstconst identityAgentModule: ModuleAI agents: provenance, tools, runs, budgets and approvals.