Interface: EmergentTool
Defined in: packages/agentos/src/cognition/emergent/types.ts:686
A tool created at runtime by the Emergent Capability Engine.
EmergentTool is the persisted record that backs a forged tool. It carries
the tool's identity, schemas, implementation spec, current tier, audit trail,
and accumulated usage statistics.
Properties
createdAt
createdAt:
string
Defined in: packages/agentos/src/cognition/emergent/types.ts:743
ISO-8601 timestamp of when the tool was first forged and registered.
createdBy
createdBy:
string
Defined in: packages/agentos/src/cognition/emergent/types.ts:738
The agent that created this tool, or 'system'. The agent identity is the
persona: forge_tool passes the caller's personaId, and an agent-tier
tool runs only for a caller with that personaId. (A GMI instance id is
minted per session and cannot own a tool meant to outlive one: an
agent-tier row from an earlier release that carries one loads suspended
with the reason legacy_owner.)
description
description:
string
Defined in: packages/agentos/src/cognition/emergent/types.ts:704
Natural language description of what the tool does and when to use it. Injected into the LLM prompt as the tool's description field.
id
id:
string
Defined in: packages/agentos/src/cognition/emergent/types.ts:691
Globally unique identifier assigned at forge time.
Convention: emergent:<uuid-v4> (e.g., "emergent:a1b2c3d4-...").
implementation
implementation:
ToolImplementation
Defined in: packages/agentos/src/cognition/emergent/types.ts:722
The implementation specification — either a composable pipeline or sandboxed code. Determines how the executor runs the tool.
inputSchema
inputSchema:
JSONSchemaObject
Defined in: packages/agentos/src/cognition/emergent/types.ts:710
JSON Schema defining the structure of arguments the tool accepts. Validated by the executor before each invocation.
judgeVerdicts
judgeVerdicts: (
CreationVerdict|PromotionVerdict)[]
Defined in: packages/agentos/src/cognition/emergent/types.ts:750
Ordered log of all judge verdicts issued for this tool, from initial creation through any subsequent promotion reviews. The most recent verdict is the last element.
name
name:
string
Defined in: packages/agentos/src/cognition/emergent/types.ts:698
Machine-readable tool name exposed to the LLM in tool call requests. Must be unique among tools currently registered for the agent.
Example
"fetch_github_pr_summary"
outputSchema
outputSchema:
JSONSchemaObject
Defined in: packages/agentos/src/cognition/emergent/types.ts:716
JSON Schema defining the structure of the tool's output on success. Used by downstream tools and the judge for output validation.
source
source:
string
Defined in: packages/agentos/src/cognition/emergent/types.ts:762
Human-readable label describing the origin of this tool for audit purposes.
Example
"forged by agent gmi-42 during session sess-99"
tier
tier:
ToolTier
Defined in: packages/agentos/src/cognition/emergent/types.ts:728
Current lifecycle tier. Tools start at 'session' and may be promoted
to 'agent' and then 'shared' as they accumulate usage and pass audits.
usageStats
usageStats:
ToolUsageStats
Defined in: packages/agentos/src/cognition/emergent/types.ts:756
Accumulated runtime usage statistics. Updated after every invocation by the usage tracking subsystem.