Interface: ToolEffect

Defined in: ports/tool-effect.ts:8

Domain-agnostic effect descriptor emitted pre-flight by ToolDriver.describeEffects() or synthesized post-flight by CheckpointableScope.diffEffects().

Keyed on mutatesScope by ScopeLockManager to coordinate shared-read vs exclusive-write locks and evaluated by PolicyGuardASTNode, QuotaTripwireASTNode, and TelemetryCollectorASTNode.

Extended by

• FsToolEffect

Properties

Property	Modifier	Type	Description	Defined in
attributes?	readonly	Readonly<Record<string, unknown>>	Domain-specific structured effect attributes (such as paths, mode, or amountUsd).	ports/tool-effect.ts:14
kind	readonly	string	Domain-qualified effect kind identifier (such as 'fs:effect' or 'billing:effect').	ports/tool-effect.ts:10
mutatesScope?	readonly	boolean	Whether the effect mutates the active isolation scope state (true acquires an exclusive write lock).	ports/tool-effect.ts:12