Rulvar API reference / @rulvar/rulvar / ToolSource
Interface: ToolSource
Defined in: packages/core/dist/index.d.ts
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
Properties
| Property | Type | Defined in |
|---|---|---|
id | string | packages/core/dist/index.d.ts |
Methods
describeRegulatedPosture()?
optional describeRegulatedPosture(): RegulatedPostureDescriptor;Defined in: packages/core/dist/index.d.ts
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
tools()
tools(session): Promise<ToolDef<SchemaSpec<unknown>>[]>;Defined in: packages/core/dist/index.d.ts
Parameters
| Parameter | Type |
|---|---|
session | ToolSourceSession |
Returns
Promise<ToolDef<SchemaSpec<unknown>>[]>