Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

acpx

package module

Go to main page

Versions in this module

v0

v0.2.1

Jul 4, 2026

v0.2.0

Jul 4, 2026

v0.1.0

Jul 4, 2026

Changes in this version

+ const DefaultArtifactsDir

+ const DefaultFlowPath

+ const DefaultLiveProjectionPath

+ const DefaultRunProjectionPath

+ const DefaultSessionsDir

+ const DefaultStepsProjectionPath

+ const DefaultTracePath

+ const SchemaFlowDefinitionSnapshotV1

+ const SchemaFlowRunBundleV1

+ const SchemaFlowTraceEventV1

+ const SchemaSessionV1

+ var ErrInvalidBundle = errors.New("invalid acpx bundle")

+ var ErrUnsafePath = errors.New("unsafe acpx bundle path")

+ func ValidateArtifactRef(ref ArtifactRef) error

+ func ValidateBundle(ctx context.Context, root string) error

+ func ValidateBundlePath(value string) error

+ func ValidateFlowSnapshot(snapshot FlowSnapshot) error

+ func ValidateManifest(m Manifest) error

+ func ValidateTrace(events []TraceEvent, status RunStatus) error

+ type ArtifactRef struct

+ Bytes int64

+ MediaType string

+ Path string

+ SHA256 string

+ type Bundle struct

+ Flow *FlowSnapshot

+ Manifest Manifest

+ Root string

+ Trace []TraceEvent

+ func LoadBundle(ctx context.Context, root string) (*Bundle, error)

+ type FlowEdge struct

+ From string

+ Switch *SwitchEdge

+ To string

+ type FlowNodeResult struct

+ AttemptID string

+ DurationMs float64

+ Error string

+ FinishedAt string

+ NodeID string

+ NodeType NodeType

+ Outcome NodeOutcome

+ Output json.RawMessage

+ StartedAt string

+ type FlowRunSnapshot struct

+ HasTitle bool

+ type FlowRunState struct

+ CurrentAttemptID string

+ CurrentNode string

+ CurrentNodeStartedAt string

+ CurrentNodeType NodeType

+ Error string

+ FinishedAt string

+ FlowName string

+ FlowPath string

+ Input json.RawMessage

+ LastHeartbeatAt string

+ Outputs map[string]json.RawMessage

+ Results map[string]FlowNodeResult

+ RunID string

+ RunTitle string

+ SessionBindings map[string]FlowSessionBinding

+ StartedAt string

+ Status RunStatus

+ StatusDetail string

+ Steps []FlowStepRecord

+ UpdatedAt string

+ WaitingOn string

+ type FlowSessionBinding struct

+ ACPSessionID string

+ AcpXRecordID string

+ AgentCommand string

+ AgentName string

+ AgentSessionID string

+ BundleID string

+ CWD string

+ Handle string

+ Key string

+ Name string

+ Profile string

+ type FlowSnapshot struct

+ Edges []FlowEdge

+ Name string

+ Nodes map[string]NodeSnapshot

+ Permissions json.RawMessage

+ Run *FlowRunSnapshot

+ Schema string

+ StartAt string

+ type FlowStepRecord struct

+ Agent json.RawMessage

+ AttemptID string

+ Error string

+ FinishedAt string

+ NodeID string

+ NodeType NodeType

+ Outcome NodeOutcome

+ Output json.RawMessage

+ PromptText *string

+ RawText *string

+ Session *FlowSessionBinding

+ StartedAt string

+ Trace json.RawMessage

+ type Manifest struct

+ FinishedAt string

+ FlowName string

+ FlowPath string

+ Paths ManifestPaths

+ RunID string

+ RunTitle string

+ Schema string

+ Sessions []ManifestSessionEntry

+ StartedAt string

+ Status RunStatus

+ TraceSchema string

+ type ManifestPaths struct

+ ArtifactsDir string

+ Flow string

+ LiveProjection string

+ RunProjection string

+ SessionsDir string

+ StepsProjection string

+ Trace string

+ type ManifestSessionEntry struct

+ BindingPath string

+ EventsPath string

+ Handle string

+ ID string

+ RecordPath string

+ type NodeCWD struct

+ Mode string

+ Value string

+ type NodeOutcome string

+ const NodeOutcomeCancelled

+ const NodeOutcomeFailed

+ const NodeOutcomeOK

+ const NodeOutcomeTimedOut

+ type NodeSession struct

+ Handle string

+ Isolated bool

+ type NodeSnapshot struct

+ ActionExecution string

+ CWD *NodeCWD

+ HasExec bool

+ HasParse bool

+ HasPrompt bool

+ HasRun bool

+ HeartbeatMs float64

+ NodeType NodeType

+ Profile string

+ Session *NodeSession

+ StatusDetail string

+ Summary string

+ TimeoutMs float64

+ type NodeType string

+ const NodeTypeACP

+ const NodeTypeAction

+ const NodeTypeCheckpoint

+ const NodeTypeCompute

+ type RunStatus string

+ const RunStatusComplete

+ const RunStatusFailed

+ const RunStatusRunning

+ const RunStatusTimedOut

+ const RunStatusWaiting

+ type SessionEvent struct

+ At string

+ Direction string

+ Message json.RawMessage

+ Seq int64

+ type SwitchEdge struct

+ Cases map[string]string

+ On string

+ type TraceAttempt struct

+ Completed bool

+ NodeID string

+ OutcomeType string

+ Started bool

+ type TraceEvent struct

+ Artifact *ArtifactRef

+ At string

+ AttemptID string

+ NodeID string

+ Payload map[string]json.RawMessage

+ RunID string

+ Scope TraceScope

+ Seq int64

+ SessionID string

+ Type string

+ func ReadTrace(ctx context.Context, r io.Reader) ([]TraceEvent, error)

+ func ReadTraceFile(ctx context.Context, filePath string) ([]TraceEvent, error)

+ type TraceProjection struct

+ ArtifactCount int

+ Attempts map[string]TraceAttempt

+ EventCount int

+ RunID string

+ SessionCount int

+ func RebuildTraceProjection(events []TraceEvent) (TraceProjection, error)

+ type TraceScope string

+ const TraceScopeACP

+ const TraceScopeAction

+ const TraceScopeArtifact

+ const TraceScopeNode

+ const TraceScopeRun

+ const TraceScopeSession