Scenes
Bounded, choreographed operations — the core orchestration primitive
A scene is a bounded operation with a start, an end, and a measurable goal.
Structure
- Intention — what the agent wants to achieve
- Audience — who it targets
- Arc — the strategic pattern (approach, surround, crescendo, etc.)
- Beats — individual steps, executed in sequence
- Constraints — budget, duration, beat limits
- Adaptation rules — reactions to sensor signals
Lifecycle
| Status | Meaning |
|---|---|
draft | Being composed, beats editable |
declared | Awaiting copilot approval |
scheduled | Approved, beats queuing |
live | Executing |
adapting | Membrane modifying scene |
completed | All beats fired or goal met |
declined | Audience declined |
expired | Constraints exceeded |
aborted | Manually stopped |
Signals
{
on_explicit_decline: "terminate",
on_positive_signal: "continue",
on_neutral_signal: "continue",
on_negative_signal: "decelerate",
}Actions: terminate, continue, decelerate, accelerate, escalate.
Constraints
constraints: {
maxDuration: "2h",
maxBeats: 6,
budget: 100,
}When exceeded, the onBoundsExceeded handler fires (default: terminate).
Outcome
| Outcome | Meaning |
|---|---|
succeeded | Goal met |
failed | Failure condition triggered |
declined | Audience declined |
expired | Constraints exceeded |
aborted | Manually stopped |
Outcomes are written to the ledger permanently and publicly.