session

package

Go to main page

Versions in this module

v0

v0.18.1

Oct 23, 2026

v0.18.0

Oct 22, 2026

Changes in this version

type Authority

+ Ceiling *governance.CapabilitySet

type PermissionMode

+ const ModeAuto

+ const ModeYolo

+ func (m PermissionMode) Rank() int

type Session

+ AgentCreateIntent string

+ AgentDefinitionName string

+ func (s *Session) RestoreWorkspaceEnrollmentBrokerKeys(keys []string, present bool) error

+ func (s *Session) TightenConfiguration(mode PermissionMode, limits Limits) error

+ func (s *Session) WorkspaceEnrollmentBrokerKeys() ([]string, bool)

v0.17.0

Oct 13, 2026

Changes in this version

+ type ExecutionCapabilities struct

+ Files bool

+ Shell bool

type ParallelPayload

+ ChildToolCallID ToolCallID

+ ExplicitRouterCategory string

+ Provider string

type Session

+ ExecutionCapabilities *ExecutionCapabilities

+ ExecutionTemplateID string

+ ExecutionTemplateRevision string

type SubagentPayload

+ ChildToolCallID ToolCallID

+ ExplicitRouterCategory string

+ Provider string

type TeamMemberSpec

+ ExplicitRouterCategory string

+ Provider string

type TeamPayload

+ ChildToolCallID ToolCallID

v0.16.0

Oct 7, 2026

Changes in this version

+ type ApprovalOrigin string

+ const ApprovalOriginHookGuardrail

+ const ApprovalOriginPermission

+ const ApprovalOriginPlan

+ const ApprovalOriginUnknown

type ApprovalPayload

+ Origin ApprovalOrigin

+ type AuxiliaryUsage struct

+ Buckets map[UsageKind]TokenUsage

+ func (a AuxiliaryUsage) Merge(other AuxiliaryUsage) AuxiliaryUsage

+ type ContextOccupancy struct

+ Estimated bool

+ InputTokens int

type Event

+ PlanContinuationFailure *PlanContinuationFailurePayload

type EventType

+ const EvPlanContinuationFailed

+ const EvToolResultAvailable

+ type GuardrailApprovalKind string

+ const GuardrailApprovalAction

+ const GuardrailApprovalResultRelease

+ type GuardrailPendingScope struct

+ GrantDigest string

+ Kind GuardrailApprovalKind

+ RepeatAvailable bool

+ ReviewID string

+ SessionOnly bool

+ type GuardrailRef struct

+ Category string

+ Ref string

+ type GuardrailReviewPayload struct

+ Assessment string

+ CheckerModelID string

+ CheckerProviderID string

+ Concerns []GuardrailRef

+ Disposition string

+ Inspection string

+ Job string

+ ReasonCode string

+ ReviewID string

+ RuleID string

+ RuleOrigin string

+ Sources []GuardrailRef

type HookPayload

+ Guardrail *GuardrailReviewPayload

+ type InstructionScope struct

+ Directory string

+ Examined bool

+ File string

+ Omitted bool

+ Partial bool

+ SourceID string

+ Text string

+ Unavailable bool

+ type InstructionSnapshot struct

+ Directories []string

+ DiscoveryExhausted bool

+ Scopes []InstructionScope

+ func (s InstructionSnapshot) MetadataBytes() int

type Message

+ UserPromptProvenance UserPromptProvenance

type PendingAsk

+ AskProvenance governance.AskProvenance

+ Guardrail *GuardrailPendingScope

+ type PlanContinuationFailurePayload struct

+ AskID string

+ PlanRunID string

+ type ProviderModelID struct

+ ModelID string

+ ProviderID string

type Session

+ func (s *Session) GrantToolAuthority(names []string) error

+ func (s *Session) InstructionSnapshot() InstructionSnapshot

+ func (s *Session) LatestContextOccupancy() (ContextOccupancy, bool)

+ func (s *Session) RecordAuxiliaryUsage(usage AuxiliaryUsage)

+ func (s *Session) RecordHarnessPrompt(text string) error

+ func (s *Session) RecordLatestContextOccupancy(occupancy ContextOccupancy)

+ func (s *Session) RecordPrincipalPromptWithParts(text string, parts []Content, instructions []Message) error

+ func (s *Session) ReplaceInstructionSnapshot(snapshot InstructionSnapshot)

type UsageKind

+ const UsageKindAskReviewer

+ const UsageKindCompaction

+ const UsageKindGuardrail

+ const UsageKindParallelJudge

+ const UsageKindReflection

+ const UsageKindRouter

type UserPromptPayload

+ Provenance UserPromptProvenance

+ type UserPromptProvenance string

+ const UserPromptProvenanceHarness

+ const UserPromptProvenancePrincipal

+ const UserPromptProvenanceUnknown

v0.15.0

Sep 23, 2026

Changes in this version

+ const NoProgressExtractiveNudgeText

+ const NoProgressNudgeText

+ var ErrNoPendingAuthorization = errors.New("session: no pending external authorization")

+ func ValidAuthorizationID(value string) bool

+ func ValidWorkspaceEnrollmentToolNames(names []string) bool

+ type ActivityState string

+ const ActivityActive

+ const ActivityDraft

+ const ActivityUnknown

+ func ActivityOf(messages []Message) ActivityState

+ func ValidActivity(a ActivityState) ActivityState

+ type AuthorizationBinding string

+ type AuthorizationPayload struct

+ AuthorizationID string

+ Call ToolCallID

+ DisplayName string

+ ExpiresAt time.Time

+ Status AuthorizationStatus

+ func (p AuthorizationPayload) Valid() bool

+ type AuthorizationResolution struct

+ func NewAuthorizationResolution(status AuthorizationStatus) (AuthorizationResolution, error)

+ func (r AuthorizationResolution) Status() AuthorizationStatus

+ func (r AuthorizationResolution) Valid() bool

+ type AuthorizationStatus string

+ const AuthorizationCancelled

+ const AuthorizationClosed

+ const AuthorizationDenied

+ const AuthorizationExpired

+ const AuthorizationFailed

+ const AuthorizationGranted

+ const AuthorizationInterrupted

+ const AuthorizationPending

type Event

+ Authorization *AuthorizationPayload

+ Title *TitlePayload

type EventType

+ const EvAuthorizationRequired

+ const EvAuthorizationResolved

+ const EvSessionTitle

+ type ExternalAuthorization struct

+ Binding AuthorizationBinding

+ DisplayName string

+ ExpiresAt time.Time

+ ID string

+ type ExternalBinding string

type ParallelPayload

+ RoutingDecision *RoutingDecision

+ type PendingAuthorization struct

+ Authorization ExternalAuthorization

+ Call ToolCall

+ Deferred []ToolCall

+ func (p PendingAuthorization) Clone() PendingAuthorization

+ type PendingWorkspaceEnrollment struct

+ ExpiresAt time.Time

+ ID WorkspaceEnrollmentID

+ RequiredServices uint32

type RequestManifestPayload

+ AdvertisedToolSchemaBytes int

+ type RetryMetadata struct

+ Disposition RetryDisposition

+ Progress StreamProgress

+ func (m RetryMetadata) Valid() bool

+ type RoutingDecision struct

+ Backend string

+ BreakerOpen bool

+ CandidateCategory string

+ CandidateModel string

+ ClassifierModel string

+ Confidence *float64

+ ConsecutiveMisses int

+ MinimumConfidence *float64

+ MissLimit int

+ Outcome string

type Session

+ ExternalBinding ExternalBinding

+ TitleGeneration TitleGenerationState

+ TitleRevision uint64

+ func (s *Session) AbortAuthorization(reason string) ([]ToolResult, error)

+ func (s *Session) AbortWorkspaceEnrollment(id WorkspaceEnrollmentID) error

+ func (s *Session) ApplyTitleGeneration(generation TitleGenerationState, attempts []TitleAttempt)

+ func (s *Session) BeginWorkspaceEnrollment(pending PendingWorkspaceEnrollment) error

+ func (s *Session) ClaimAuthorization() (PendingAuthorization, error)

+ func (s *Session) CompleteWorkspaceEnrollment(pending PendingWorkspaceEnrollment, exactTools []string) error

+ func (s *Session) InterruptAuthorization() ([]ToolResult, error)

+ func (s *Session) PauseForAuthorization(pending PendingAuthorization) error

+ func (s *Session) PendingAuthorization() (PendingAuthorization, bool)

+ func (s *Session) PendingWorkspaceEnrollment() (PendingWorkspaceEnrollment, bool)

+ func (s *Session) RecordTitleAttempt(attempt TitleAttempt)

+ func (s *Session) RecordTitleSourcePrompt(text string)

+ func (s *Session) RecordTokenUsage(kind UsageKind, providerID, modelID string, usage Usage)

+ func (s *Session) RestoreAuthorizationClaim(pending PendingAuthorization) error

+ func (s *Session) RestoreTitleMetadata(title string, provenance TitleProvenance, revision uint64, ...)

+ func (s *Session) RestoreTokenUsage(usage map[UsageKind]TokenUsage)

+ func (s *Session) SetGeneratedTitle(text string) error

+ func (s *Session) SetTitleGeneration(state TitleGenerationState)

+ func (s *Session) SetUsageAttribution(providerID, modelID string)

+ func (s *Session) TitleAttempts() []TitleAttempt

+ func (s *Session) TitleSourcePrompts() []string

+ func (s *Session) TokenUsageSnapshot() map[UsageKind]TokenUsage

+ func (s *Session) UsageFor(kind UsageKind) Usage

+ func (s *Session) ValidateAuthorizationState() error

type State

+ const StateAuthorizing

type SteerPayload

+ MessageID string

type SubagentPayload

+ RoutingDecision *RoutingDecision

type TeamMemberSpec

+ MemberIncarnation IncarnationID

+ MemberSessionID SessionID

+ RoutingDecision *RoutingDecision

+ type TitleAttempt struct

+ ID string

+ Outcome TitleAttemptOutcome

+ type TitleAttemptOutcome string

+ const TitleAttemptDeferred

+ const TitleAttemptFailed

+ const TitleAttemptInterrupted

+ const TitleAttemptSucceeded

+ type TitleGenerationState string

+ const TitleGenerationDisabled

+ const TitleGenerationExhausted

+ const TitleGenerationGenerated

+ const TitleGenerationPending

+ type TitlePayload struct

+ GenerationState TitleGenerationState

+ LatestAttempt *TitleAttempt

+ Provenance TitleProvenance

+ Revision uint64

+ Title string

type TitleProvenance

+ const TitleProvenanceGenerated

+ type TokenUsage struct

+ Models map[string]Usage

+ Total Usage

+ type UsageKind string

+ const UsageKindMain

+ const UsageKindSessionTitle

type UserPromptPayload

+ Synthetic bool

+ type WorkspaceEnrollmentID string

+ func (id WorkspaceEnrollmentID) Valid() bool

v0.14.0

Sep 4, 2026

v0.13.0

Sep 4, 2026

Changes in this version

type EnvironmentRef

+ Revision string

+ func (r EnvironmentRef) Valid() bool

+ type PlacementMetadata struct

+ Branch string

+ Kind string

+ Label string

+ Revision string

type Session

+ Placement PlacementMetadata

v0.12.0

Sep 1, 2026

Changes in this version

+ const CompactionSummaryMarker

+ const MaxMediaBytes

+ const MaxPromptMediaBytes

+ const MaxPromptMediaParts

+ const MaxToolResultBytes

+ const MaxToolResultTextBytes

+ const RequestPromptInstruction

+ const RequestPromptSystem

+ const RequestProvenanceCustom

+ const RequestProvenanceMemory

+ const RequestProvenanceProject

+ const RequestProvenanceRules

+ const RequestProvenanceSoul

+ const RequestProvenanceStable

+ const RequestProvenanceUnknown

+ const RequestProvenanceUserModel

+ const RequestProvenanceVolatile

+ const RequestToolAdvertised

+ const RequestToolAuthorityFiltered

+ const RequestToolDisclosureHidden

+ const RequestToolModeFiltered

+ const RequestToolMountUnavailable

+ const RequestToolShadowed

+ const RequestToolSourceCatalog

+ const RequestToolSourceMCP

+ const RequestToolSourceOverlay

+ const RoutingReasonAborted

+ const RoutingReasonAgentDefPinned

+ const RoutingReasonBreakerOpen

+ const RoutingReasonFork

+ const RoutingReasonPinnedModel

+ const RoutingReasonResume

+ const RoutingReasonRouterDisabled

+ const RoutingReasonTargetUnavailable

+ const Tier4SummaryMarker

+ const VerdictStringAllowAlways

+ const VerdictStringAllowOnce

+ const VerdictStringDeny

+ var ErrIllegalTransition = errors.New("session: illegal state transition")

+ var ErrInvalidContent = errors.New("session: invalid media content")

+ var ErrInvalidMediaURL = errors.New("session: invalid media URL")

+ var ErrInvalidSessionMetadata = errors.New("session: invalid kind or relationship")

+ var ErrNoPendingAsk = errors.New("session: no pending ask to resume")

+ var ErrOwnerAlreadySet = errors.New("session: owner already set")

+ func ClampTitle(s string) string

+ func DebugTargetFingerprint(s *Session) string

+ func IncarnationFingerprint(inc IncarnationID, id SessionID, owner *Principal) string

+ func IsGenuineUserPrompt(m Message) bool

+ func IsSynthesisedSummary(text string) bool

+ func NetworkCorrelationDigest(kind, value string) (string, bool)

+ func ParseArgs(call ToolCall, dst any) (msg string, ok bool)

+ func PrincipalScopeHash(p *Principal) [32]byte

+ func ToValidUTF8(s string) string

+ func ToolBlockText(b Content) string

+ func ValidateJSON(schema, payload json.RawMessage) error

+ func ValidateMediaParts(parts []Content) error

+ func ValidateMediaURL(raw string) error

+ func ValidateResolvedIP(ip net.IP) error

+ func ValidateSessionMetadata(kind SessionKind, rel SessionRelationship) error

+ func ValidateToolPairing(msgs []Message) error

+ func ValidateToolResultParts(parts []Content) error

+ func VerdictString(v ApprovalVerdict) string

+ func WithPrincipal(ctx context.Context, p *Principal) context.Context

+ type AdoptionMetadata struct

+ AdoptionRequestDigest string

+ AdoptionSourceID SessionID

+ func (m *AdoptionMetadata) Clone() *AdoptionMetadata

+ type ApprovalPayload struct

+ AllowAlways bool

+ AskID string

+ Call ToolCallID

+ Tool string

+ Verdict string

+ type ApprovalVerdict int

+ const VerdictAllowAlways

+ const VerdictAllowOnce

+ const VerdictDeny

+ type AskOrigin int

+ const AskOriginHook

+ const AskOriginNone

+ const AskOriginPlan

+ type Authority struct

+ CapabilitySet governance.CapabilitySet

+ DefinitionIdentity string

+ Provenance string

+ func (a Authority) Clone() Authority

+ func (a Authority) Valid() bool

+ type BlockKind string

+ const BlockAudio

+ const BlockEmbeddedResource

+ const BlockImage

+ const BlockResourceLink

+ const BlockStructuredContent

+ const BlockText

+ type CompactionArchivePayload struct

+ Replaced []Message

+ type Content struct

+ Audience []string

+ BlockKind BlockKind

+ Data []byte

+ Description string

+ Kind MediaKind

+ LastModified string

+ MIMEType string

+ Name string

+ Priority float64

+ Size int64

+ Text string

+ Title string

+ URL string

+ func NewAudioContent(mime string, data []byte) (Content, error)

+ func NewAudioURLContent(mime, rawURL string) (Content, error)

+ func NewContent(kind MediaKind, mime string, data []byte, rawURL string) (Content, error)

+ func NewEmbeddedResourceBlock(uri, mimeType, text string, blob []byte, audience []string) (Content, error)

+ func NewImageContent(mime string, data []byte) (Content, error)

+ func NewImageURLContent(mime, rawURL string) (Content, error)

+ func NewResourceLinkBlock(uri, name, title, description, mimeType string, size int64, audience []string) Content

+ func NewStructuredContentBlock(structuredJSON string) Content

+ func NewTextBlock(text string) Content

+ type Conversation struct

+ Messages []Message

+ func (c *Conversation) Append(m Message)

+ func (c *Conversation) Len() int

+ type Counters struct

+ ConsecutiveFailures int

+ ToolCalls int

+ Turns int

+ type EnvironmentKind string

+ const EnvKindLocal

+ const EnvKindMem

+ const EnvKindNoFS

+ type EnvironmentRef struct

+ ID string

+ Kind EnvironmentKind

+ type Event struct

+ Actor *Principal

+ Approval *ApprovalPayload

+ Ask *PendingAsk

+ CompactionArchive *CompactionArchivePayload

+ Hook *HookPayload

+ ModelRetry *ModelRetryPayload

+ NetworkAttempt *NetworkAttemptPayload

+ Parallel *ParallelPayload

+ RequestManifest *RequestManifestPayload

+ Result *ResultPayload

+ RunID string

+ Schedule *SchedulePayload

+ Seq int64

+ Steer *SteerPayload

+ Subagent *SubagentPayload

+ Team *TeamPayload

+ Text string

+ ToolCall *ToolCall

+ ToolResult *ToolResult

+ Turn int

+ TurnEnd *TurnEndPayload

+ Type EventType

+ Usage *Usage

+ UserPrompt *UserPromptPayload

+ type EventType string

+ const EvApproval

+ const EvCompaction

+ const EvCompactionArchive

+ const EvHook

+ const EvMessageDelta

+ const EvModelRetry

+ const EvNetworkAttempt

+ const EvNoProgress

+ const EvParallelBranch

+ const EvParallelEnd

+ const EvParallelStart

+ const EvPermissionAsk

+ const EvPermissionRetract

+ const EvProviderRoute

+ const EvReasoningDelta

+ const EvRecoverNotice

+ const EvRequestManifest

+ const EvResult

+ const EvScheduleFailed

+ const EvScheduleFired

+ const EvScheduleSkipped

+ const EvSessionInit

+ const EvSteer

+ const EvSubagentEnd

+ const EvSubagentStart

+ const EvSubagentTool

+ const EvTeamEnd

+ const EvTeamFindings

+ const EvTeamMember

+ const EvTeamStart

+ const EvTeamTasks

+ const EvToolCall

+ const EvToolProgress

+ const EvToolResult

+ const EvTurnEnd

+ const EvTurnStart

+ const EvUserPrompt

+ type GrantType string

+ const GrantTypeClientCredentials

+ const GrantTypeSystem

+ const GrantTypeUser

+ func GrantTypeFromClaims(claims map[string]any) GrantType

+ func (g GrantType) Valid() bool

+ type HookDecision string

+ const HookAdvisory

+ const HookBlocked

+ const HookInfo

+ const HookModified

+ type HookPayload struct

+ CallID ToolCallID

+ Decision HookDecision

+ Phase string

+ Tool string

+ type IncarnationID string

+ func LegacyIncarnationID(id SessionID, createdAtUnixNano int64, owner *Principal) IncarnationID

+ func NewIncarnationID() IncarnationID

+ func PersistedIncarnationID(inc IncarnationID, id SessionID, createdAtUnixNano int64, owner *Principal) IncarnationID

+ func (i IncarnationID) Valid() bool

+ type Limits struct

+ MaxConsecutiveFailures int

+ MaxToolCalls int

+ MaxTurns int

+ func (l Limits) WithDefaults(d Limits) Limits

+ type MediaKind string

+ const MediaAudio

+ const MediaImage

+ type Message struct

+ Parts []Content

+ ProviderPhase string

+ Reasoning string

+ ReasoningItemID string

+ Role Role

+ Text string

+ ToolCalls []ToolCall

+ ToolResult *ToolResult

+ func CloneMessages(msgs []Message) []Message

+ func ForkSnapshot(c *Conversation) []Message

+ func NewAssistantMessage(text, reasoning string, calls []ToolCall) Message

+ func NewSystemMessage(text string) Message

+ func NewToolMessage(result ToolResult) Message

+ func NewUserMessage(text string) Message

+ func NewUserMessageWithParts(text string, parts []Content) Message

+ func StripProviderState(messages []Message) []Message

+ type ModelRetryPayload struct

+ Disposition RetryDisposition

+ Progress StreamProgress

+ type NetworkAttemptPayload struct

+ Attempt int

+ BackoffMs int64

+ CorrelationDigest string

+ CorrelationKind string

+ Decision string

+ ElapsedMs int64

+ FailureClass string

+ HTTPStatus int

+ InBandStatus int

+ MaxAttempts int

+ RetryDisposition string

+ RunSerial int64

+ SessionID SessionID

+ StreamProgress string

+ SuppressionReason string

+ Turn int

+ func CanonicalNetworkAttempt(in NetworkAttemptPayload, id SessionID, runSerial int64, turn int) (NetworkAttemptPayload, bool)

+ type ParallelEventKind string

+ const ParallelBranchEnd

+ const ParallelBranchStart

+ const ParallelBranchTool

+ type ParallelPayload struct

+ BranchCount int

+ BranchIndex int

+ BranchLabel string

+ ChildID string

+ ChildIncarnation IncarnationID

+ Detail string

+ DurationMs int64

+ Failed bool

+ Goal string

+ InnerKind EventType

+ IsError bool

+ Join string

+ Kind ParallelEventKind

+ Model string

+ ParentCallID string

+ RoutedCategory string

+ RoutedModel string

+ RoutingReason string

+ Stop StopReason

+ Text string

+ ToolCount int

+ ToolName string

+ Usage Usage

+ Winner int

+ WinnerWorkspace string

+ Workspace string

+ type PendingAsk struct

+ Args json.RawMessage

+ AskID string

+ Call ToolCallID

+ ConfiguredAsk bool

+ FlooredConfiguredAllow bool

+ HookOriginated bool

+ PlanOriginated bool

+ Reason string

+ Tool string

+ func (p PendingAsk) Origin() AskOrigin

+ type PermissionMode string

+ const ModeAccept

+ const ModeDefault

+ const ModePlan

+ type Principal struct

+ GrantType GrantType

+ Issuer string

+ Name string

+ Subject string

+ func PrincipalFromClaims(claims map[string]any) *Principal

+ func PrincipalFromContext(ctx context.Context) *Principal

+ func (p *Principal) Clone() *Principal

+ func (p *Principal) IdentityWellFramed() bool

+ func (p *Principal) SameIdentity(other *Principal) bool

+ type RequestManifestPayload struct

+ ContextWindow int

+ MessageBytes int

+ MessageCount int

+ Model string

+ Prompt []RequestPromptComponent

+ Provider string

+ ReasoningEffort string

+ ToolDecisions []RequestToolDecision

+ ToolNames []string

+ type RequestPromptComponent struct

+ Bytes int

+ Kind string

+ Provenance string

+ type RequestToolDecision struct

+ Decision string

+ Name string

+ Source string

+ type ResultPayload struct

+ Disposition RetryDisposition

+ Error string

+ Permanent bool

+ Progress StreamProgress

+ Stop StopReason

+ Text string

+ Usage Usage

+ type RetryDisposition uint8

+ const RetryDispositionPermanent

+ const RetryDispositionRetryable

+ const RetryDispositionUnknown

+ func (d RetryDisposition) Valid() bool

+ type Role string

+ const RoleAssistant

+ const RoleSystem

+ const RoleTool

+ const RoleUser

+ type SchedulePayload struct

+ Err string

+ FireID string

+ Kind string

+ ScheduleName string

+ SessionID SessionID

+ Stop StopReason

+ type Session struct

+ Adoption *AdoptionMetadata

+ Authority Authority

+ Conversation *Conversation

+ Counters Counters

+ CreatedAt time.Time

+ DebugMCPServers []string

+ DebugMCPTools []string

+ DebugTargetFingerprint string

+ EnvironmentRef EnvironmentRef

+ ID SessionID

+ Kind SessionKind

+ Limits Limits

+ Mode PermissionMode

+ ModelID string

+ Owner *Principal

+ Profile string

+ ProviderID string

+ ReasoningEffort string

+ Relationship SessionRelationship

+ State State

+ Title string

+ TitleProvenance TitleProvenance

+ Usage Usage

+ Workspace string

+ func New(id SessionID, mode PermissionMode, workspace string, limits Limits, ...) *Session

+ func NewDebug(id SessionID, mode PermissionMode, limits Limits, createdAt time.Time, ...) (*Session, error)

+ func NewParallelBranch(id SessionID, mode PermissionMode, workspace string, limits Limits, ...) (*Session, error)

+ func NewScheduled(id SessionID, mode PermissionMode, workspace string, limits Limits, ...) (*Session, error)

+ func NewSubagent(id SessionID, mode PermissionMode, workspace string, limits Limits, ...) (*Session, error)

+ func NewTeamMember(id SessionID, mode PermissionMode, workspace string, limits Limits, ...) (*Session, error)

+ func (s *Session) Abandon() error

+ func (s *Session) BeginRun(runID string)

+ func (s *Session) BeginTurn() error

+ func (s *Session) BindAuthority(authority Authority) error

+ func (s *Session) BoundAuthority() (Authority, bool)

+ func (s *Session) Cancel() error

+ func (s *Session) Complete() error

+ func (s *Session) Fail() error

+ func (s *Session) FailedStepRetryPending() (RetryDisposition, StreamProgress, bool)

+ func (s *Session) FailureMetadata() (RetryDisposition, StreamProgress)

+ func (s *Session) FailurePermanence() bool

+ func (s *Session) Incarnation() IncarnationID

+ func (s *Session) Interrupt() error

+ func (s *Session) LastError() string

+ func (s *Session) LimitTripped() (StopReason, bool)

+ func (s *Session) PauseForApproval(ask PendingAsk) error

+ func (s *Session) PendingAsk() (PendingAsk, bool)

+ func (s *Session) PrepareFailedStepRetry() error

+ func (s *Session) RecordAssistant(m Message) error

+ func (s *Session) RecordFailureMetadata(disposition RetryDisposition, progress StreamProgress) error

+ func (s *Session) RecordFailurePermanence(permanent bool) error

+ func (s *Session) RecordLastError(cause string) error

+ func (s *Session) RecordToolResults(results []ToolResult) error

+ func (s *Session) RecordUsage(u Usage) error

+ func (s *Session) RecordUserPrompt(text string, instructions []Message) error

+ func (s *Session) RecordUserPromptWithParts(text string, parts []Content, instructions []Message) error

+ func (s *Session) RecordedStopReason() (StopReason, bool)

+ func (s *Session) Recover() error

+ func (s *Session) Rehome(workspace string) error

+ func (s *Session) RenameTitle(text string) error

+ func (s *Session) Reopen() error

+ func (s *Session) ReplaceHistory(messages []Message) error

+ func (s *Session) ReplaceHistoryAtBoundary(messages []Message) error

+ func (s *Session) ResetUsage() error

+ func (s *Session) RestoreFailedStepRetryPending(disposition RetryDisposition, progress StreamProgress) error

+ func (s *Session) RestoreIncarnation(inc IncarnationID) error

+ func (s *Session) RestoreLabels(owner *Principal, authority Authority) error

+ func (s *Session) RestoreSessionMetadata(kind SessionKind, rel SessionRelationship) error

+ func (s *Session) ResumeWith() (PendingAsk, error)

+ func (s *Session) RunID() string

+ func (s *Session) SeedHistory(messages []Message) error

+ func (s *Session) SetMode(mode PermissionMode) error

+ func (s *Session) SetTitle(text string)

+ func (s *Session) Stop(reason StopReason) error

+ func (s *Session) StopReason() (StopReason, bool)

+ type SessionID string

+ type SessionKind string

+ const SessionKindDebug

+ const SessionKindMain

+ const SessionKindParallelBranch

+ const SessionKindScheduled

+ const SessionKindSubagent

+ const SessionKindTeamMember

+ const SessionKindUnknown

+ type SessionRelationship struct

+ BranchIndex *int

+ CallID ToolCallID

+ DebugTargetID SessionID

+ DebugTargetIncarnation IncarnationID

+ MemberName string

+ OriginIncarnation IncarnationID

+ OriginSessionID SessionID

+ ParentIncarnation IncarnationID

+ ParentSessionID SessionID

+ ScheduleName string

+ TeamID string

+ type State string

+ const StateAwaiting

+ const StateCancelled

+ const StateCompleted

+ const StateFailed

+ const StateIdle

+ const StateRunning

+ func (s State) IsTerminal() bool

+ type SteerPayload struct

+ Parts []Content

+ Text string

+ type StopReason string

+ const StopBudget

+ const StopCancelled

+ const StopEndTurn

+ const StopError

+ const StopMaxConsecutiveFailures

+ const StopMaxToolCalls

+ const StopMaxTurns

+ const StopNoProgress

+ const StopNone

+ const StopPlanApproved

+ const StopPlanIterate

+ const StopStructuredOutput

+ const StopTimeout

+ type StreamProgress uint8

+ const StreamProgressComplete

+ const StreamProgressPrecommit

+ const StreamProgressUnknown

+ const StreamProgressVisible

+ func (p StreamProgress) Valid() bool

+ type SubagentPayload struct

+ Background bool

+ Cause string

+ ChildID string

+ ChildIncarnation IncarnationID

+ Detail string

+ DurationMs int64

+ Goal string

+ InnerKind EventType

+ IsError bool

+ Model string

+ ParentCallID string

+ RoutedCategory string

+ RoutedModel string

+ RoutingReason string

+ Stop StopReason

+ Text string

+ ToolCount int

+ ToolName string

+ Usage Usage

+ type TeamFindingSnapshot struct

+ Body string

+ Member string

+ type TeamMemberDisposition struct

+ Disposition string

+ ErrorRounds int

+ Name string

+ Reason string

+ type TeamMemberSpec struct

+ Lead bool

+ Model string

+ Mutating bool

+ Name string

+ Role string

+ RoutedCategory string

+ RoutedModel string

+ RoutingReason string

+ type TeamPayload struct

+ Cause string

+ ContextUsed int64

+ ContextWindow int64

+ Detail string

+ Dispositions []TeamMemberDisposition

+ Findings []TeamFindingSnapshot

+ InnerKind EventType

+ IsError bool

+ Member string

+ MemberIncarnation IncarnationID

+ MemberSessionID string

+ ParentCallID string

+ Roster []TeamMemberSpec

+ Rounds int

+ Stop StopReason

+ Tasks []TeamTaskSnapshot

+ TeamID string

+ Text string

+ ToolName string

+ Usage Usage

+ type TeamTaskSnapshot struct

+ Assignee string

+ Deps []string

+ Description string

+ ID string

+ State string

+ type TitleProvenance string

+ const TitleProvenanceFirstPrompt

+ const TitleProvenanceOperator

+ const TitleProvenanceUnknown

+ type ToolCall struct

+ Args json.RawMessage

+ ID ToolCallID

+ ItemID string

+ Name string

+ func NewToolCall(id ToolCallID, name string, args json.RawMessage) ToolCall

+ type ToolCallID string

+ type ToolResult struct

+ CallID ToolCallID

+ Content string

+ IsError bool

+ Parts []Content

+ func NewToolError(callID ToolCallID, content string) ToolResult

+ func NewToolResult(callID ToolCallID, content string) ToolResult

+ func NewToolResultWithParts(callID ToolCallID, content string, parts []Content) ToolResult

+ func RepairToolResult(r ToolResult) ToolResult

+ type Turn struct

+ Assistant Message

+ Index int

+ Results []ToolResult

+ Usage Usage

+ type TurnEndPayload struct

+ DurationMs int64

+ Estimated bool

+ InterTokenMaxMs int64

+ InterTokenMeanMs int64

+ TTFTMs int64

+ Usage Usage

+ type Usage struct

+ CacheReadTokens int

+ CacheWriteTokens int

+ InputTokens int

+ OutputTokens int

+ ReasoningTokens int

+ func (u Usage) Add(other Usage) Usage

+ func (u Usage) CacheHitRate() float64

+ func (u Usage) TotalTokens() int

+ type UserPromptPayload struct

+ Parts []Content

+ Text string

v0.11.0

Aug 14, 2026

v0.10.0

Aug 12, 2026

v0.9.0

Aug 6, 2026

v0.8.0

Aug 3, 2026

v0.7.0

Aug 1, 2026

v0.6.0

Jul 24, 2026

v0.5.1

Jul 16, 2026

v0.5.0

Jul 16, 2026

v0.4.0

Jun 30, 2026

v0.3.0

Jun 30, 2026

v0.2.0

Jun 25, 2026

v0.1.0

Jun 22, 2026

v0.0.4

Jun 21, 2026

v0.0.3

Jun 21, 2026

v0.0.2

Jun 20, 2026

v0.0.1

Jun 19, 2026

Other modules containing this package

github.com/stacklok/mecatl

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL