Skip to main content

Interface: SelfImprovementToolDeps

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

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?, signal?, tool?) => Promise<unknown>

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

Executes a registered tool by name with the given arguments.

Parameters​

name​

string

args​

unknown

context?​

ToolExecutionContext

signal?​

AbortSignal

tool?​

ITool<any, any>

Returns​

Promise<unknown>


getActiveSkills()​

getActiveSkills: (context?) => object[]

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

Returns the agent's currently active skills.

Parameters​

context?​

ToolExecutionContext

Returns​

object[]


getLockedSkills()​

getLockedSkills: () => string[]

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

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:108

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:166

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:153

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:129

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:118

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


searchSkills()​

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

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

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:115

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:172

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:160

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:135

Unloads (disables) a previously loaded skill.

Parameters​

id​

string

context?​

ToolExecutionContext

Returns​

void