Expand description
UI-independent application core for Twine.
Modules§
- config
- User configuration. Serde defaults supply omitted settings; the starter file shows basic choices.
- memories
- Discovery of local harness memories, instructions, and extraction records. Database reads use private snapshots; explicit edits are limited to Markdown files.
Structs§
- Agent
- One process filling one role in a workflow.
- Agent
Defaults - Optional choices that prefill the launch form. Each launch can override them.
- Agent
Graph - Agent coordination, not a general task executor. Only explicit signals follow links.
- AgentId
- Application
- Assignment
- Command
Receipt - Completion
Signal - Directory
Listing - Event
- File
Entry - File
Preview - File
Save Request - File
Snapshot - File
Version - Folder
State - The open folder and the recent folders the start page lists.
- GitChange
- GitDecoration
- GitRepository
- GitSnapshot
- Graph
Edge - Graph
Output - Graph
Position - Graph
Run - Handoff
- Work passed from a role in one stage to a role in the next, or back along a review loop.
- Harness
Model - Harness
Models - Instance
Count - How many agents can fill a role. The user picks the count within these bounds at launch.
- Model
List Request - A model list running on its own thread, so a slow harness never holds up the caller. Dropping it stops the harness and waits for its worker to clean up.
- Recent
Folder - Request
Id - Review
Loop - Sends work from a review stage back to an earlier stage when the reviewer requests changes.
- Role
- A responsibility in the type, independent of the harness that fills it.
- RoleId
- Role
Launch - One harness choice per role instance, fixed at launch.
- RunAgent
- Session
- Session
Id - Snapshot
- Stage
- StageId
- Stage
Role - One end of a handoff: a role while it runs in a stage.
- Terminal
Chunk - Terminal
Exit - Terminal
Id - Terminal
Size - Terminal
State - Trace
Activities Page - Trace
Activity - Trace
Activity Counts - Trace
Activity Id - Durable native tool or subagent identity within a prompt or assignment.
- Trace
Anchor - Trace
Detail Page - Trace
Event - Trace
Event Id - Trace
Events Page - Trace
Lane - Trace
Lane Id - Trace
Span - Trace
Span Id - Trace
Storage Status - Trace
Summary - Transcript
Page - A page of committed, unmodified terminal output. Offsets count bytes, not characters.
- Transcript
Request - A bounded storage request whose completion can be polled without waiting for disk I/O.
- Transcript
Size - Unavailable
Folder - Validation
Issue - Workflow
- Workflow
Id - Workflow
Run - Serializable run state. A run pins both its type reference and definition. Processes and completion mailboxes are deliberately absent; restoring an active run interrupts it.
- Workflow
State - Workflow
Terminal - Workflow
Trace - Workflow
Trace Page - Workflow
Type - Workflow
Type Definition
Enums§
- Agent
Color - A portable color name. The front end chooses the platform color for each appearance.
- Application
Error - Application
State - Builtin
Type - Stable identities for the default TOML graphs shipped with Twine.
- Catalog
Error - Command
- Command
Disposition - Command
Result - Completion
- The explicit signal that ends a stage.
- Decision
- Element
Path - The element of a definition that an issue points at. Indexes are positions in the definition’s lists, so they stay unambiguous even when two elements share an ID.
- Event
Error - Event
Kind - File
Content - File
Error - File
Kind - File
Save Outcome - GitChange
Kind - Graph
Event - Graph
Finish - Graph
Receive - Handoff
Content - Harness
Error - Harness
Id - Model
List Error - RunAgent
Status - RunError
- RunStatus
- Session
Status - State
Event - Store
Error - Terminal
Error - Terminal
Status - Trace
Activity Kind - Trace
Activity Status - Trace
Error - Trace
Event Kind - Trace
Span Status - Transcript
Error - Transcript
Read - Unavailable
Reason - Why a folder can’t be opened.
- Validation
Problem - Workflow
Kind - Workflow
Status - Workflow
Type Ref - One exact workflow type. A workflow keeps the reference it started with.
Constants§
- MAX_
PARALLEL_ AGENTS - The most agents that can run at once in one stage, counting every instance of every role.
- MAX_
REVIEW_ ROUNDS - The most times a review loop can send work back before the workflow stops.
- MAX_
TRACE_ PAGE_ SIZE - MAX_
TRANSCRIPT_ READ_ BYTES - Maximum bytes returned by a single transcript read.
- TEXT_
LIMIT
Functions§
- validate
- Checks that every reference resolves and that loops and parallelism stay bounded.