Rulvar API reference

---

Rulvar API reference / @rulvar/core / ToolSource

Interface: ToolSource

Defined in: packages/core/src/l0/spi/toolsource.ts:96

The ToolSource seam: tools() yields the source's current ToolDefs. The toolset snapshot for a given agent spawn is captured at spawn time and hashed into the spawn's identity via toolsetHash; a mid-run change MUST NOT mutate an in-flight agent's toolset.

Extended by

• McpToolSource

Properties

Property	Type	Defined in
id	string	packages/core/src/l0/spi/toolsource.ts:97

Methods

describeRegulatedPosture()?

optional describeRegulatedPosture(): RegulatedPostureDescriptor;

Defined in: packages/core/src/l0/spi/toolsource.ts:107

The construction-side posture attestation (RV4101): a PURE snapshot of the risk postures this source chose at construction (no wire, no connect, no side effects), read by compileRegulatedProfile to refuse a loosened posture and hash a tightened one. Optional: a source without it counts into the profile's unrecognized tally instead of being implied verified.

Returns

RegulatedPostureDescriptor

---

tools()

tools(session): Promise<ToolDef<SchemaSpec>[]>;

Defined in: packages/core/src/l0/spi/toolsource.ts:98

Parameters

Parameter	Type
session	ToolSourceSession

Returns

Promise<ToolDef<SchemaSpec>[]>