Crate zagens_tools

Structs§

ConfiguredToolSpec
DagPlanView: Lightweight plan view for scheduling (no execution state).
Footprint: Declared resource footprint for scheduling / policy.
PolicyDecision: Policy output consumed by the turn loop and future DAG scheduler.
PolicyEngine: Policy engine — stateless rule set (proposal §8.1, §8.1.2).
PolicyInput: Inputs for a single tool policy evaluation.
PolicyPlanMeta: Legacy-compatible plan flags derived from a policy decision.
PolicyShadowStats: Shadow-mode counters (tools.policy = "shadow").
ResourceSet: Resource access summary (M2 minimal form; M3+ may split Fs/Net/Proc).
SchedulerShadowStats: Shadow-mode counters (tools.scheduler = "shadow").
ToolCall
ToolCallRuntime
ToolInvocation
ToolManifest: Per-tool manifest consumed by PolicyEngine (M3) and DAG scheduler (M4).
ToolRegistry
ToolResult: Result of a tool execution.
ToolSpec

ApprovalNeed: Whether a tool call needs user approval before execution.
ApprovalRequirement: Approval requirement for a tool.
FootprintProvenance: Where a footprint declaration came from (proposal §8.1.2).
FunctionCallError
ParallelResourceKey: Resource bucket for DAG / batch parallel scheduling (M4 consumer).
PolicySessionMode: Session mode slice consumed by policy rules.
ResourceLockMode: Shared vs exclusive lock for one scheduling resource slot.
SandboxClass: Sandbox enforcement tier derived from footprint (proposal §8.1).
ScheduleResource: Coarse scheduling resource (path-level refinement lives in runtime bridge).
SpawnClass: Process / privilege class for tools that spawn subprocesses.
ToolCallSource
ToolCapability: Capabilities that a tool may have or require.
ToolError: Errors that can occur during tool execution.

build_execution_waves: Build execution waves as plan index groups (proposal §8.2 DAG batching).
derive_conservative_footprint: Derive a conservative footprint from capability flags and the M1 union bit.
optional_bool: Helper to extract an optional bool field with default.
optional_str: Helper to extract an optional string field from JSON input.
optional_u64: Helper to extract an optional u64 field with default.
policy_shadow_stats
record_policy_shadow_diff: Record a shadow comparison between legacy and engine plan flags.
record_scheduler_shadow_diff: Record a shadow comparison between legacy and DAG execution groups.
required_str: Helper to extract a required string field from JSON input.
required_u64: Helper to extract a required u64 field from JSON input.
resource_lock_order: Stable sort key for deadlock-free lock acquisition order.
resource_lock_targets: Resources to lock before executing one tool plan (writes → exclusive, reads → shared).
scheduler_shadow_stats
wave_parallel_eligible: Whether every plan in a wave may use the parallel executor path.