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

sessionio

package module

Go to main page

Versions in this module

v0

v0.2.3

Aug 11, 2026

v0.2.2

Aug 11, 2026

v0.2.1

Aug 1, 2026

v0.2.0

Jul 28, 2026

Changes in this version

+ type ListingCache interface

+ Lookup func(key string, stamp string) (SessionRef, bool)

+ Retain func(key string, stamp string, ref SessionRef)

+ type ListingCacheSource interface

+ ListingCache func(sourceID string) (ListingCache, bool)

type NativeObservation

+ NativeKey string

type NodeKind

+ const NodeKindNativeRecord

v0.1.2

Jul 26, 2026

v0.1.1

Jul 25, 2026

v0.1.0

Jul 25, 2026

Changes in this version

+ const PresenceSchema

+ const ReaderSchema

+ var ErrStreamClosed = errors.New("sessionio: stream closed")

+ func ValidatePresenceSnapshot(snapshot PresenceSnapshot) error

+ func WriteJSON(writer io.Writer, producer Producer, records []Record) error

+ func WritePresenceJSON(writer io.Writer, producer Producer, snapshot PresenceSnapshot) error

+ type Adapter interface

+ Descriptor func() AdapterDescriptor

+ Read func(context.Context, SessionRef) (Stream[ReadItem], error)

+ Sessions func(context.Context, SessionRequest) (Stream[SessionRef], error)

+ Sources func(context.Context) (Stream[Source], error)

+ type AdapterDescriptor struct

+ Capabilities []CapabilityStatus

+ Harness Harness

+ Version string

+ type ByteRange struct

+ End int64

+ Start int64

+ type Capability string

+ const CapabilityBranches

+ const CapabilityDiscovery

+ const CapabilityEnvironment

+ const CapabilityIncrementalReading

+ const CapabilityMessages

+ const CapabilityReasoning

+ const CapabilityRepository

+ const CapabilityRichContent

+ const CapabilityTools

+ const CapabilityUsage

+ type CapabilityStatus struct

+ Capability Capability

+ Detail string

+ Support SupportLevel

+ type CaptureKind string

+ const CaptureKindByteExact

+ const CaptureKindDecodedStream

+ const CaptureKindStructuredSnapshot

+ type ContentAvailability string

+ const ContentAvailabilityAvailable

+ const ContentAvailabilityEncrypted

+ const ContentAvailabilityExternal

+ const ContentAvailabilityRedacted

+ const ContentAvailabilityUnavailable

+ type ContentBlock struct

+ Availability ContentAvailability

+ ID ContentID

+ Kind ContentKind

+ Media *MediaContent

+ Opaque *OpaqueContent

+ Text *TextContent

+ type ContentID string

+ type ContentKind string

+ const ContentKindMedia

+ const ContentKindOpaque

+ const ContentKindText

+ type DatabaseKey struct

+ Name string

+ Value string

+ type DatabaseLocator struct

+ Keys []DatabaseKey

+ Path string

+ Table string

+ type Diagnostic struct

+ Cause error

+ Code string

+ Locator *SourceLocator

+ Message string

+ Severity DiagnosticSeverity

+ type DiagnosticSeverity string

+ const DiagnosticSeverityError

+ const DiagnosticSeverityInfo

+ const DiagnosticSeverityWarning

+ type DiscoveryRevision string

+ type Event struct

+ Evidence []EvidenceRef

+ Facts *FactEvent

+ ID EventID

+ Kind EventKind

+ Marker *MarkerEvent

+ Message *MessageEvent

+ Reasoning *ReasoningEvent

+ Timestamp *time.Time

+ ToolCall *ToolCallEvent

+ ToolResult *ToolResultEvent

+ Unknown *UnknownEvent

+ Usage *UsageEvent

+ type EventID string

+ type EventKind string

+ const EventKindFacts

+ const EventKindMarker

+ const EventKindMessage

+ const EventKindReasoning

+ const EventKindToolCall

+ const EventKindToolResult

+ const EventKindUnknown

+ const EventKindUsage

+ type EvidenceRef struct

+ Locator SourceLocator

+ Observation ObservationID

+ type Fact struct

+ Kind FactKind

+ Value string

+ type FactEvent struct

+ Facts []Fact

+ type FactKind string

+ const FactKindApprovalPolicy

+ const FactKindCurrentDate

+ const FactKindEffort

+ const FactKindGitBranch

+ const FactKindGitCommit

+ const FactKindGitRemote

+ const FactKindGitRoot

+ const FactKindLaunchDirectory

+ const FactKindModel

+ const FactKindProvider

+ const FactKindSandboxPolicy

+ const FactKindTimezone

+ const FactKindWorkingDirectory

+ type FileLocator struct

+ ByteRange *ByteRange

+ Line *uint64

+ Path string

+ Record *uint64

+ Root string

+ type Harness string

+ const HarnessClaude

+ const HarnessCodex

+ const HarnessOMP

+ const HarnessOpenCode

+ type LimitationKind string

+ const LimitationKindExternalPayload

+ const LimitationKindMissingExternalPayload

+ const LimitationKindMutableMaterialization

+ const LimitationKindUpstreamTruncation

+ type LocatorKind string

+ const LocatorKindDatabase

+ const LocatorKindFile

+ const LocatorKindOpaque

+ type MarkerEvent struct

+ Name string

+ State string

+ type MediaContent struct

+ Data []byte

+ MediaType string

+ Reference string

+ type MessageEvent struct

+ Content []ContentBlock

+ Role MessageRole

+ type MessageRole string

+ const MessageRoleAssistant

+ const MessageRoleDeveloper

+ const MessageRoleSystem

+ const MessageRoleTool

+ const MessageRoleUnknown

+ const MessageRoleUser

+ type NDJSONEncoder struct

+ func NewNDJSONEncoder(writer io.Writer, producer Producer) (*NDJSONEncoder, error)

+ func (encoder *NDJSONEncoder) Encode(record Record) error

+ type NativeAgentMetadata struct

+ Nickname string

+ Path string

+ Role string

+ type NativeHistoryMetadata struct

+ BaseNativeID string

+ EndByteOffset *uint64

+ EndOrdinalExclusive *uint64

+ OwnStartOrdinal *uint64

+ type NativeIdentity struct

+ Kind NativeIdentityKind

+ Value string

+ type NativeIdentityKind string

+ const NativeIdentityKindSession

+ type NativeObservation struct

+ ID ObservationID

+ Limitations []SourceLimitation

+ Locator SourceLocator

+ NativeKind string

+ NativeVersion string

+ Representation NativeRepresentation

+ Revision Revision

+ Timestamp *time.Time

+ type NativeRelationshipHint struct

+ Kind NativeRelationshipKind

+ TargetNativeID string

+ type NativeRelationshipKind string

+ const NativeRelationshipKindControlParent

+ const NativeRelationshipKindForkParent

+ type NativeRepresentation struct

+ Capture CaptureKind

+ Codec string

+ Data []byte

+ Framing []byte

+ MediaType string

+ type NativeSessionMetadata struct

+ Agent *NativeAgentMetadata

+ History *NativeHistoryMetadata

+ Identities []NativeIdentity

+ Relationships []NativeRelationshipHint

+ type NextFunc func(context.Context) (T, error)

+ type NodeKind string

+ const NodeKindContent

+ const NodeKindEvent

+ const NodeKindObservation

+ const NodeKindSession

+ type NodeRef struct

+ ID string

+ Kind NodeKind

+ type ObservationID string

+ type OccurrenceID string

+ type OpaqueContent struct

+ Data []byte

+ MediaType string

+ NativeType string

+ type OpaqueLocator struct

+ Scheme string

+ Value string

+ type Payload struct

+ Data []byte

+ MediaType string

+ type PresenceCapability string

+ const PresenceCapabilityExactMatch

+ const PresenceCapabilityProbableMatch

+ type PresenceCapabilityStatus struct

+ Capability PresenceCapability

+ Detail string

+ Reason *PresenceReason

+ Support PresenceSupport

+ type PresenceCertainty string

+ const PresenceCertaintyExact

+ const PresenceCertaintyProbable

+ type PresenceEvidence struct

+ Certainty PresenceCertainty

+ Detail string

+ Kind PresenceEvidenceKind

+ type PresenceEvidenceKind string

+ const PresenceEvidenceHealthEndpoint

+ const PresenceEvidenceLoopbackListener

+ const PresenceEvidenceNativeSessionRegistry

+ const PresenceEvidenceOpenSessionFile

+ const PresenceEvidenceProcessIdentity

+ const PresenceEvidenceSessionStatus

+ const PresenceEvidenceTerminalBreadcrumb

+ const PresenceEvidenceTerminalIdentity

+ type PresenceMatch struct

+ Certainty PresenceCertainty

+ Evidence []PresenceEvidence

+ Harness Harness

+ NativeSessionID string

+ Occurrences []PresenceOccurrence

+ Processes []ProcessInstance

+ Selection PresenceSelection

+ type PresenceNDJSONEncoder struct

+ func NewPresenceNDJSONEncoder(writer io.Writer, producer Producer) (*PresenceNDJSONEncoder, error)

+ func (encoder *PresenceNDJSONEncoder) Encode(snapshot PresenceSnapshot) error

+ type PresenceOccurrence struct

+ Relation PresenceOccurrenceRelation

+ Session SessionRef

+ type PresenceOccurrenceRelation string

+ const PresenceOccurrenceRelationExactLocator

+ const PresenceOccurrenceRelationNativeIdentity

+ type PresenceProviderStatus struct

+ Capabilities []PresenceCapabilityStatus

+ Detail string

+ Harness Harness

+ Reason *PresenceReason

+ Support PresenceSupport

+ Version string

+ type PresenceReason string

+ const PresenceReasonAccessDenied

+ const PresenceReasonAuthenticationRequired

+ const PresenceReasonCrossEnvironment

+ const PresenceReasonInspectionFailed

+ const PresenceReasonNoSessionIdentity

+ const PresenceReasonPrerequisiteMissing

+ const PresenceReasonProcessExited

+ const PresenceReasonProviderUnavailable

+ const PresenceReasonProviderUnsupported

+ const PresenceReasonStaleProcessIdentity

+ const PresenceReasonUnmatchedNativeIdentity

+ type PresenceSelection struct

+ SessionID SessionID

+ Status PresenceSelectionStatus

+ type PresenceSelectionStatus string

+ const PresenceSelectionAmbiguous

+ const PresenceSelectionResolved

+ type PresenceSnapshot struct

+ ExpiresAt time.Time

+ Matches []PresenceMatch

+ ObservedAt time.Time

+ Providers []PresenceProviderStatus

+ UnmatchedProcesses []UnmatchedProcess

+ type PresenceSupport string

+ const PresenceSupportSupported

+ const PresenceSupportUnavailable

+ const PresenceSupportUnsupported

+ type ProcessInstance struct

+ Evidence []PresenceEvidence

+ PID uint64

+ StartedAt time.Time

+ type Producer struct

+ Name string

+ Version string

+ type ReadItem struct

+ Diagnostics []Diagnostic

+ Events []Event

+ Observation NativeObservation

+ Relations []Relation

+ Session SessionRef

+ type ReaderError struct

+ AdapterVersion string

+ Err error

+ Harness Harness

+ Locator *SourceLocator

+ Operation string

+ SessionID SessionID

+ func (readerError *ReaderError) Error() string

+ func (readerError *ReaderError) Unwrap() error

+ type ReasoningEvent struct

+ Content []ContentBlock

+ Summary []ContentBlock

+ type Record struct

+ Diagnostic *Diagnostic

+ Kind RecordKind

+ ReadItem *ReadItem

+ Session *SessionRef

+ Source *Source

+ type RecordKind string

+ const RecordKindDiagnostic

+ const RecordKindReadItem

+ const RecordKindSession

+ const RecordKindSource

+ type Registry struct

+ func NewRegistry(adapters ...Adapter) (*Registry, error)

+ func (registry *Registry) Adapter(harness Harness) (Adapter, bool)

+ func (registry *Registry) Descriptors() []AdapterDescriptor

+ func (registry *Registry) Register(adapter Adapter) error

+ type Relation struct

+ Evidence []EvidenceRef

+ From NodeRef

+ ID RelationID

+ Kind RelationKind

+ Origin RelationOrigin

+ To NodeRef

+ type RelationID string

+ type RelationKind string

+ const RelationKindActiveLeaf

+ const RelationKindBranchParent

+ const RelationKindContains

+ const RelationKindMaterializes

+ const RelationKindNext

+ const RelationKindPrevious

+ const RelationKindReplyTo

+ const RelationKindToolPair

+ const RelationKindUpdates

+ type RelationOrigin string

+ const RelationOriginDeterministic

+ const RelationOriginNative

+ type Revision struct

+ Kind RevisionKind

+ Value string

+ type RevisionKind string

+ const RevisionKindDatabaseTransaction

+ const RevisionKindEventSequence

+ const RevisionKindFileSnapshot

+ const RevisionKindOpaque

+ type SessionID string

+ type SessionRef struct

+ Diagnostics []Diagnostic

+ DiscoveryRevision DiscoveryRevision

+ ID SessionID

+ Native NativeSessionMetadata

+ NativeID string

+ Occurrence SourceOccurrence

+ StartedAt *time.Time

+ Title string

+ UpdatedAt *time.Time

+ type SessionRequest struct

+ Sources []SourceID

+ type Source struct

+ Capabilities []CapabilityStatus

+ Diagnostics []Diagnostic

+ Harness Harness

+ ID SourceID

+ Kind SourceKind

+ Locator SourceLocator

+ Status SourceStatus

+ type SourceID string

+ type SourceKind string

+ const SourceKindAuxiliary

+ const SourceKindCanonical

+ type SourceLimitation struct

+ Detail string

+ Kind LimitationKind

+ type SourceLocator struct

+ Database *DatabaseLocator

+ File *FileLocator

+ Kind LocatorKind

+ Opaque *OpaqueLocator

+ type SourceOccurrence struct

+ Harness Harness

+ ID OccurrenceID

+ Locator SourceLocator

+ SourceID SourceID

+ type SourceStatus string

+ const SourceStatusAvailable

+ const SourceStatusDisabled

+ const SourceStatusMissing

+ const SourceStatusUnsupported

+ type Stream interface

+ Close func() error

+ Next func(context.Context) (T, error)

+ func NewStream[T any](next NextFunc[T], close func() error) (Stream[T], error)

+ type SupportLevel string

+ const SupportExperimental

+ const SupportFull

+ const SupportPartial

+ const SupportUnavailable

+ type TextContent struct

+ Text string

+ type ToolCallEvent struct

+ CallID string

+ Input Payload

+ Name string

+ type ToolResultEvent struct

+ CallID string

+ Output Payload

+ Status ToolResultStatus

+ type ToolResultStatus string

+ const ToolResultStatusError

+ const ToolResultStatusPending

+ const ToolResultStatusRunning

+ const ToolResultStatusSuccess

+ const ToolResultStatusUnknown

+ type UnknownEvent struct

+ NativeType string

+ type UnmatchedProcess struct

+ ClaimedNativeIDs []string

+ Evidence []PresenceEvidence

+ Harness Harness

+ Process ProcessInstance

+ Reason PresenceReason

+ type UsageEvent struct

+ CacheReadTokens *int64

+ CacheWriteTokens *int64

+ InputTokens *int64

+ OutputTokens *int64

+ ReasoningTokens *int64

+ TotalTokens *int64

v0.0.5

Jul 24, 2026

v0.0.4

Jul 24, 2026

v0.0.3

Jul 24, 2026

v0.0.2

Jul 24, 2026

v0.0.1

Jul 24, 2026