Skip to main content

Interface: SelfImprovementToolDeps

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:45

Dependencies required to construct the four self-improvement tools.

Callers provide runtime hooks for personality access, skill management, tool execution, and optional memory storage. The engine uses these to wire each tool without hard-coupling to specific service implementations.

Properties​

executeTool()​

executeTool: (name, args, context?) => Promise<unknown>

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:87

Executes a registered tool by name with the given arguments.

Parameters​

name​

string

args​

unknown

context?​

ToolExecutionContext

Returns​

Promise<unknown>


getActiveSkills()​

getActiveSkills: (context?) => object[]

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:64

Returns the agent's currently active skills.

Parameters​

context?​

ToolExecutionContext

Returns​

object[]


getLockedSkills()​

getLockedSkills: () => string[]

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:69

Returns skill IDs that may not be disabled (core skills).

Returns​

string[]


getPersonality()​

getPersonality: (context?) => Record<string, number>

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:51

Returns the calling agent's HEXACO personality trait values as a trait→value map. The context identifies the agent instance and session that made the tool call.

Parameters​

context?​

ToolExecutionContext

Returns​

Record<string, number>


getSessionParam()?​

optional getSessionParam: (param, context) => unknown

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:107

Optional host-level getter for session-scoped runtime params such as temperature.

Parameters​

param​

string

context​

ToolExecutionContext

Returns​

unknown


listTools()​

listTools: () => string[]

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:94

Returns the names of all currently registered tools.

Returns​

string[]


loadSkill()​

loadSkill: (id, context?) => Promise<{ category: string; name: string; skillId: string; }>

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:72

Dynamically loads a skill by ID and returns its metadata.

Parameters​

id​

string

context?​

ToolExecutionContext

Returns​

Promise<{ category: string; name: string; skillId: string; }>


mutationStore?​

optional mutationStore: PersonalityMutationStore

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:61

Durable store for personality mutations (used by AdaptPersonalityTool for persistence).


searchSkills()​

searchSkills: (query, context?) => object[]

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:81

Searches the skill registry by query string, returning matching skill metadata.

Parameters​

query​

string

context?​

ToolExecutionContext

Returns​

object[]


setPersonality()​

setPersonality: (trait, value, context?) => boolean | void

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:58

Sets a single HEXACO personality trait (already clamped) on the calling agent. Returns false when the caller cannot be resolved, in which case nothing was changed; returning nothing counts as applied.

Parameters​

trait​

string

value​

number

context?​

ToolExecutionContext

Returns​

boolean | void


setSessionParam()?​

optional setSessionParam: (param, value, context) => void

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:113

Optional host-level setter for session-scoped runtime params such as temperature.

Parameters​

param​

string

value​

unknown

context​

ToolExecutionContext

Returns​

void


storeMemory()?​

optional storeMemory: (trace, context?) => Promise<void>

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:101

Optional callback for persisting self-improvement trace memories. The context identifies the calling agent and session, so the host can store the trace in that agent's memory under that session's scope.

Parameters​

trace​
content​

string

scope​

string

tags​

string[]

type​

string

context?​

ToolExecutionContext

Returns​

Promise<void>


unloadSkill()​

unloadSkill: (id, context?) => void

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:78

Unloads (disables) a previously loaded skill.

Parameters​

id​

string

context?​

ToolExecutionContext

Returns​

void