Skip to main content

Module ids

Module ids 

Source
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] - ExecutionId
  • step_[27 alphanumeric chars] - StepId
  • artifact_[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§

ArtifactId
ArtifactId - Identifies persisted output produced by a step
ExecutionId
ExecutionId - Identifies one run of a blueprint
GraphId
GraphId - Graph definition identifier
MessageId
MessageId - Individual message identifier
ParentLink
ParentLink - Traces causal origin of an execution
StepId
StepId - Identifies a distinct action within an execution
StepSource
StepSource - Tracks the origin of a step
TenantId
TenantId - Multi-tenant isolation identifier
ThreadId
ThreadId - Conversation thread identifier
UserId
UserId - User identifier

Enums§

CallableType
CallableType - The type of callable that was invoked
CancellationPolicy
CancellationPolicy - What happens to children when parent is cancelled
ParentType
ParentType - What kind of entity triggered this execution
SpawnMode
SpawnMode - How a callable spawns child work
StepSourceType
StepSourceType - Why/how a step was created
StepType
StepType - Defines what the step is (internal: NodeType)

Type Aliases§

NodeId
NodeId - Alias for StepId
RunId
RunId - Alias for ExecutionId