Skip to main content

What Is a Signature

A signature is a typed input/output contract for a model call. In OpenAgents, any decision that gates action should be expressed as a signature.

Design Rules

  • Inputs are deterministic facts (task, repo context, budgets, tool outputs)
  • Outputs are machine consumable (enums, booleans, JSON)
  • Decision signatures include confidence and are confidence-gated
  • Outcomes are logged for replay and optimization

Plan Mode Signatures (Current)

Plan mode signatures live in crates/dsrs/src/signatures/plan_mode.rs and are exposed via the signature registry:
  • TopicDecompositionSignature
  • ParallelExplorationSignature
  • PlanSynthesisSignature
  • ComplexityClassificationSignature
  • DeepPlanningSignature
  • ResultValidationSignature

Registry and UI Exposure

Autopilot Desktop exposes signature metadata via the in‑process registry and WGPUI surfaces. Signature steps and results are rendered directly by the desktop runtime.

Why It Matters

Typed signatures make agent behavior inspectable, testable, and swappable. They are the unit of optimization for DSPy and the core of the Guidance and Plan Mode pipelines.