Expand description
Execution & Telemetry IDs - Graph-centric observability identifiers
This module defines the canonical ID types for the enact-core runtime, aligned with the Execution/Step/Artifact hierarchy.
§ID Format
All IDs use prefixed KSUID (K-Sortable Unique IDentifier):
exec_[27 alphanumeric chars]- ExecutionIdstep_[27 alphanumeric chars]- StepIdartifact_[27 alphanumeric chars]- ArtifactId
§Hierarchy
ExecutionId (The Run)
├── StepId (Type: ToolNode) -> Artifacts
├── StepId (Type: LlmNode) -> Artifacts
└── StepId (Type: GraphNode "Sub-Agent")
└── ExecutionId (Nested run)
└── StepId...@see docs/TECHNICAL/01-EXECUTION-TELEMETRY.md
Modules§
- prefixes
- ID prefix constants for validation and generation
Structs§
- Artifact
Id - ArtifactId - Identifies persisted output produced by a step
- Execution
Id - ExecutionId - Identifies one run of a blueprint
- GraphId
- GraphId - Graph definition identifier
- Message
Id - MessageId - Individual message identifier
- Parent
Link - ParentLink - Traces causal origin of an execution
- StepId
- StepId - Identifies a distinct action within an execution
- Step
Source - StepSource - Tracks the origin of a step
- Tenant
Id - TenantId - Multi-tenant isolation identifier
- Thread
Id - ThreadId - Conversation thread identifier
- UserId
- UserId - User identifier
Enums§
- Callable
Type - CallableType - The type of callable that was invoked
- Cancellation
Policy - CancellationPolicy - What happens to children when parent is cancelled
- Parent
Type - ParentType - What kind of entity triggered this execution
- Spawn
Mode - SpawnMode - How a callable spawns child work
- Step
Source Type - StepSourceType - Why/how a step was created
- Step
Type - StepType - Defines what the step is (internal: NodeType)