Home > intention-kernel > CapabilityDefinition

CapabilityDefinition interface

Executable operation independent of its infrastructure adapters.

Signature:

export interface CapabilityDefinition<TInput, TOutput>

Properties

Property	Modifiers	Type	Description
automation?	readonly	CapabilityAutomation	(Optional) Optional host-owned input factory used only by declarative progression authority.
confirmation	readonly	"none" | "required" | "capability"	Required is kernel-owned; capability delegates confirmation to its own resumable interaction.
description	readonly	string	Precise model-visible operation description.
effect	readonly	"none" | "read" | "write"	Side-effect classification used to determine concurrency and safeguards.
guidance?	readonly	CapabilityGuidance	(Optional) Optional semantic examples and exclusions shown to the interpreter.
id	readonly	CapabilityId	Stable semantic operation name visible to the model and planner.
input	readonly	RuntimeSchema<TInput>	Runtime validator and JSON Schema projection for proposed inputs.
invalidates	readonly	readonly FactReference[]	Existing fact roots and descendants replaced after successful completion.
output	readonly	RuntimeSchema<TOutput>	Runtime validator for completed outputs.
provides	readonly	readonly FactDeclaration[]	Versioned facts this capability may publish after completion.
referenceRequirements?	readonly	CapabilityReferenceRequirements	(Optional) Optional bounds for semantic references to current server-owned options.
requires	readonly	readonly FactRequirement[]	Confirmed facts required before execution.
version	readonly	number	Positive contract version included in compiled fingerprints.

Methods

Method	Description
execute(context, input)	Execute this operation after the planner validates its input and prerequisites.