effects

package

v0.2.2 Latest Latest Go to latest Published: Sep 7, 2026 License: Apache-2.0 Imports: 0 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/Coder-s-OG-s/Trajectory-IR

Links

Open Source Insights

Documentation ¶

Overview ¶

Package effects ports Trajectory IR tool effect classes and MCP mapping. Rules match pkg/trajectory_ir/effects/classify.py (fail closed).

Index ¶

func RequiresBlockAndGate(e EffectClass) bool
type EffectClass
- func ClassifyFromMCP(annotations map[string]any) EffectClass

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func RequiresBlockAndGate ¶

func RequiresBlockAndGate(e EffectClass) bool

RequiresBlockAndGate reports whether resume must gate this effect (R02). Only NON_IDEMPOTENT_WRITE is gated. PURE (R03) and other classes may re-execute on resume without BlockedNeedsGate.

Types ¶

type EffectClass ¶

type EffectClass string

EffectClass is how dangerous a tool is for resume and gate policy.

const (
	PURE                 EffectClass = "PURE"
	READ_ONLY            EffectClass = "READ_ONLY"
	IDEMPOTENT_WRITE     EffectClass = "IDEMPOTENT_WRITE"
	NON_IDEMPOTENT_WRITE EffectClass = "NON_IDEMPOTENT_WRITE"
	AGENT_SPAWN          EffectClass = "AGENT_SPAWN"
	SENSITIVE            EffectClass = "SENSITIVE"
)

func ClassifyFromMCP ¶

func ClassifyFromMCP(annotations map[string]any) EffectClass

ClassifyFromMCP maps MCP tool annotations to an EffectClass. Missing or ambiguous input becomes NON_IDEMPOTENT_WRITE.

Python treats annotations.get("x") is True / is False strictly, so only boolean true/false count. Other JSON types fall through to fail closed.

Source Files ¶

View all Source files

effects.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL