Files
archie/internal/tools/classification.go
T
sam 8356863712 feat: Tools P1 — guardrails, classification, budget, availability, disclosure, dispatch
- ToolCallGuardrailConfig + GuardrailEngine with RecordSuccess/RecordFailure
- ToolClassification bitmask (idempotent/mutating) with dispatch gating
- TurnBudget for token/char accounting with spill-to-disk
- AvailabilityCache with TTL + failure grace window
- Progressive disclosure engine for tool schema filtering
- Tool dispatch executor with parallel/serial classification
- RecordSuccess fix: now returns GuardrailDecision (no-progress threshold)
- All tests pass with -race, 58 new test functions across 6 test files
2026-07-26 09:53:38 +10:00

46 lines
1.4 KiB
Go

package tools
// ToolClassification is a bitmask that describes a tool's behavioral
// characteristics for dispatch gating, guardrail decisions, and budget
// enforcement.
type ToolClassification int
const (
// ClassIdempotent marks a read-only tool. Idempotent tools can be
// safely retried and run in parallel with other idempotent tools.
ClassIdempotent ToolClassification = 1 << iota
// ClassMutating marks a tool that modifies external state (writes files,
// creates resources, sends messages, etc.). Mutating tools require
// serialization, checkpointing, and stricter guardrail monitoring.
ClassMutating
)
// IsIdempotent reports whether the classification includes the idempotent
// flag. A zero-value classification reports false.
func (c ToolClassification) IsIdempotent() bool {
return c&ClassIdempotent != 0
}
// IsMutating reports whether the classification includes the mutating flag.
// A zero-value classification reports false.
func (c ToolClassification) IsMutating() bool {
return c&ClassMutating != 0
}
// String returns a human-readable representation of the classification.
func (c ToolClassification) String() string {
switch {
case c == 0:
return "default"
case c.IsIdempotent() && c.IsMutating():
return "idempotent|mutating"
case c.IsIdempotent():
return "idempotent"
case c.IsMutating():
return "mutating"
default:
return "unknown"
}
}