BundleActivation class

Per-bundle activation: activate / catalog / tear-down standard.

Constructors

BundleActivation({required KnowledgeSystem system, required String bundleId, KernelServerHost? boot, Future<KernelToolResult> callTool(String tool, Map<String, dynamic> args)?, StateStore? behaviorStore})

Properties

behaviorStore → StateStore?

Optional shared state store for activated behavior definitions. When a host injects a durable store (e.g. KV-backed), suspended behavior runs survive restarts (the runbook profile). Defaults to a per-behavior in-memory store (the ephemeral/flow profile).

final

boot → KernelServerHost?

Used by FlowDefinitionWorkflow closures (toolDispatcher, skillRunner, ...). When null, flow registration still works but action/api steps throw at run time.

final

bundleId → String

Bundle namespace prefix. Every registered asset id is <bundleId>.<id>.

final

callTool → Future<KernelToolResult> Function(String tool, Map<String, dynamic> args)?

Optional in-process tool dispatch closure — an alternative to a full boot host when the host endpoint is a registry (e.g. a BuiltinToolRegistry) that exposes callTool without ever surfacing a raw KernelServerHost. Flow/behavior tool-action steps dispatch through callTool ?? boot?.callTool, so a host can wire tool dispatch with just this closure (mirroring how skill executors bind a host callTool). When both are provided, callTool takes precedence.

final

hashCode → int

The hash code for this object.

no setter, inherited

registeredAgents → List<String>

no setter

registeredBehaviors → List<String>

no setter

registeredFacts → List<String>

no setter

registeredFlows → List<String>

no setter

registeredPhilosophies → List<String>

no setter

registeredProfiles → List<String>

no setter

registeredSkills → List<String>

no setter

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

system → KnowledgeSystem

Asset registration target — the kernel's KnowledgeSystem.

final

Methods

activate(McpBundle bundle) → Future<BundleActivationResult>

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

ownsAgent(String exposedId) → bool

ownsBehavior(String exposedId) → bool

ownsFact(String exposedId) → bool

ownsFlow(String exposedId) → bool

ownsPhilosophy(String exposedId) → bool

ownsProfile(String exposedId) → bool

ownsSkill(String exposedId) → bool

registerAgent(AgentDefinition a) → Future<String>

mb.AgentDefinition → KnowledgeSystem.agents.createAgent.

registerBehavior(BehaviorDefinition def) → String

mb.BehaviorDefinition → unified behavior engine, registered in OpsRuntime.behaviorRegistry. The bundle's declarative steps map to engine steps; the action dispatcher routes tool invocations through the host endpoint (boot.callTool) and skill invocations through SkillFacade.execute — mirroring how flow steps dispatch. Uses an ephemeral state store; a durable store is the runbook profile.

registerFact(Fact f) → Future<String>

mb.Fact (SVO triple) → FactRecord. The bundle's subject/predicate/object goes into FactRecord content so the triple semantics survive FactFacade.queryFacts; entityId = subject so entity-scoped queries work without a hop.

registerFlow(FlowDefinition fl) → String

mb.FlowDefinition → FlowDefinitionWorkflow factory inserted into OpsRuntime.workflowRegistry. Step execution wires through boot.server.callTool / SkillFacade.execute / LlmPort / recursive OpsFacade.runWorkflow.

registerPhilosophy(Philosophy ph) → Future<String>

mb.Philosophy → EthosRecord. The runtime fields (statement / rationale / examples / ...) are stuffed into the EthosRecord payload since EthosRecord keeps that opaque.

registerProfile(ProfileDefinition p) → String

mb.ProfileDefinition → kernel Profile via toJson/fromJson (the two schemas share id / name / description / version / sections / capabilities / metadata).

registerSkill(SkillModule s) → Future<String>

mb.SkillModule → SkillBundle (manifest + best-effort sequential procedures). mb's graph-shaped steps (step.next[]) are flattened to mcp_skill's sequential order since the runtime model is sequential.

toString() → String

A string representation of this object.

inherited

unregisterAll() → Future<void>

Operators

operator ==(Object other) → bool

The equality operator.

inherited