runtime

Jul 28, 2026

Changes in this version

type ArtifactContent

+ func (c ArtifactContent) Validate() error

type ArtifactRef

+ func (r ArtifactRef) Validate() error

+ type ContractError struct

+ Contract string

+ Err error

+ func (e *ContractError) Error() string

+ func (e *ContractError) Is(target error) bool

+ func (e *ContractError) Unwrap() error

type ForkThreadResult

+ func (r ForkThreadResult) Validate() error

type PendingToolSettlementTarget

+ func (t PendingToolSettlementTarget) Validate() error

type RecoverInterruptedTurnResult

+ func (r RecoverInterruptedTurnResult) Validate() error

type SQLiteStartupResult

+ func (r SQLiteStartupResult) Validate() error

type SQLiteStoreInspection

+ func (i SQLiteStoreInspection) Validate() error

type SQLiteStoreMigrationResult

+ func (r SQLiteStoreMigrationResult) Validate() error

type SQLiteStoreVerification

+ func (v SQLiteStoreVerification) Validate() error

type SubAgentActivityTimelineResult

+ func (r SubAgentActivityTimelineResult) Validate() error

type SubAgentDetail

+ func (d SubAgentDetail) Validate() error

type SubAgentHostOptions

+ func NewSubAgentHostOptions(cfg config.Config, options ...SubAgentOption) (SubAgentHostOptions, error)

+ type SubAgentOption struct

+ func WithSubAgentCapabilities(capabilities CapabilityOptions) SubAgentOption

+ func WithSubAgentDynamicToolSurface(provider ToolSurfaceProvider) SubAgentOption

+ func WithSubAgentEffectfulTools(registry *tools.Registry, gate EffectAuthorizationGate) SubAgentOption

+ func WithSubAgentEventSink(sink EventSink) SubAgentOption

+ func WithSubAgentIDGenerator(generator func(string) string) SubAgentOption

+ func WithSubAgentLoopLimits(limits LoopLimits) SubAgentOption

+ func WithSubAgentModelGateway(gateway ModelGateway, identity ModelGatewayIdentity, ...) SubAgentOption

+ func WithSubAgentReadOnlyTools(items ...tools.Tool) SubAgentOption

+ func WithSubAgentRunTimeout(timeout time.Duration) SubAgentOption

+ func WithSubAgentThreadTitleMode(mode ThreadTitleMode) SubAgentOption

type SubAgentSnapshot

+ func (s SubAgentSnapshot) Validate() error

type ThreadAgentTodoState

+ func (s ThreadAgentTodoState) Validate() error

type ThreadCompactionHostOptions

+ func NewThreadCompactionHostOptions(cfg config.Config, options ...ThreadCompactionOption) (ThreadCompactionHostOptions, error)

+ type ThreadCompactionOption struct

+ func WithThreadCompactionEventSink(sink EventSink) ThreadCompactionOption

+ func WithThreadCompactionIDGenerator(generator func(string) string) ThreadCompactionOption

+ func WithThreadCompactionLoopLimits(limits LoopLimits) ThreadCompactionOption

+ func WithThreadCompactionModelGateway(gateway ModelGateway, identity ModelGatewayIdentity, ...) ThreadCompactionOption

type ThreadDetailEvents

+ func (p ThreadDetailEvents) Validate() error

type TurnExecutionHostOptions

+ func NewTurnExecutionHostOptions(cfg config.Config, options ...TurnExecutionOption) (TurnExecutionHostOptions, error)

type TurnExecutionOption

+ func WithTurnCapabilities(capabilities CapabilityOptions) TurnExecutionOption

+ func WithTurnDynamicToolSurface(provider ToolSurfaceProvider) TurnExecutionOption

+ func WithTurnEffectfulTools(registry *tools.Registry, gate EffectAuthorizationGate) TurnExecutionOption

+ func WithTurnEventSink(sink EventSink) TurnExecutionOption

+ func WithTurnIDGenerator(generator func(string) string) TurnExecutionOption

+ func WithTurnLoopLimits(limits LoopLimits) TurnExecutionOption

+ func WithTurnModelGateway(gateway ModelGateway, identity ModelGatewayIdentity, ...) TurnExecutionOption

+ func WithTurnReadOnlyTools(items ...tools.Tool) TurnExecutionOption

+ func WithTurnThreadTitleMode(mode ThreadTitleMode) TurnExecutionOption

type WaitSubAgentsResult

+ func (r WaitSubAgentsResult) Validate() error

Jul 26, 2026

Changes in this version

+ type ReadThreadTurnRequest struct

+ ThreadID ThreadID

+ TurnID TurnID

type SubAgentReadHost

+ func (h *SubAgentReadHost) ReadThreadTurn(ctx context.Context, req ReadThreadTurnRequest) (ThreadTurnSnapshot, error)

type ThreadOverview

+ func (o ThreadOverview) Validate() error

type ThreadReadHost

+ func (h *ThreadReadHost) ReadThreadTurn(ctx context.Context, req ReadThreadTurnRequest) (ThreadTurnSnapshot, error)

type ThreadTurnSnapshot

+ func (s ThreadTurnSnapshot) Validate() error

type ThreadTurnsPage

+ func (p ThreadTurnsPage) Validate() error

Jul 26, 2026

Changes in this version

type ThreadTurnSnapshot

+ UserMessageOrigin ThreadUserMessageOrigin

+ type ThreadUserMessageOrigin string

+ const ThreadUserMessageOriginDelegatedMission

+ const ThreadUserMessageOriginPendingToolCompletion

+ const ThreadUserMessageOriginSubAgentInput

+ const ThreadUserMessageOriginUser

Jul 26, 2026

Changes in this version

+ var ErrInvalidThreadInventoryCursor = errors.New("floret thread inventory cursor is invalid")

+ var ErrInvalidThreadTurnCursor = errors.New("floret thread turn cursor is invalid")

+ type ListRootThreadsRequest struct

+ Cursor ThreadInventoryCursor

+ Limit int

+ type RootThreadsPage struct

+ GeneratedAt time.Time

+ HasMore bool

+ NextCursor ThreadInventoryCursor

+ Threads []ThreadSummary

+ func (p RootThreadsPage) Validate() error

type SubAgentReadHost

+ func (h *SubAgentReadHost) ListThreadTurns(ctx context.Context, req ListThreadTurnsRequest) (ThreadTurnsPage, error)

+ type ThreadInventoryCursor string

+ type ThreadInventoryHost struct

+ func NewThreadInventoryHost(bootstrap *HostBootstrap) (*ThreadInventoryHost, error)

+ func (h *ThreadInventoryHost) ListRootThreads(ctx context.Context, req ListRootThreadsRequest) (RootThreadsPage, error)

type ThreadPhase

+ func (p ThreadPhase) Valid() bool

type ThreadSnapshot

+ func (s ThreadSnapshot) Validate() error

type ThreadStatus

+ func (s ThreadStatus) Valid() bool

type ThreadSummary

+ func (s ThreadSummary) Validate() error

+ type ThreadTitleSource string

+ const ThreadTitleSourceHost

+ const ThreadTitleSourceProvider

+ const ThreadTitleSourceUnset

+ func ParseThreadTitleSource(raw string) (ThreadTitleSource, error)

+ func (s ThreadTitleSource) Valid() bool

+ type ThreadTitleStatus string

+ const ThreadTitleStatusFailed

+ const ThreadTitleStatusPending

+ const ThreadTitleStatusReady

+ const ThreadTitleStatusUnset

+ func ParseThreadTitleStatus(raw string) (ThreadTitleStatus, error)

+ func (s ThreadTitleStatus) Valid() bool

+ type ThreadTurnCursor string

Jul 25, 2026

Changes in this version

type CreateThreadRequest

+ func (r CreateThreadRequest) Validate() error

+ type ListSubAgentPendingToolSettlementTargetsRequest struct

+ ChildThreadID ThreadID

+ ParentThreadID ThreadID

type RunTurnRequest

+ func (r RunTurnRequest) Validate() error

+ type SQLiteMigrationPolicy string

+ const SQLiteMigrationApplyCompatible

+ const SQLiteMigrationRefuse

+ type SQLiteStartupPhase string

+ const SQLiteStartupInspecting

+ const SQLiteStartupMigrating

+ const SQLiteStartupOpening

+ const SQLiteStartupVerifying

+ type SQLiteStartupProgress struct

+ Maintenance *SQLiteStoreMaintenanceProgress

+ Phase SQLiteStartupPhase

+ type SQLiteStartupRequest struct

+ MigrationOperationID string

+ MigrationPolicy SQLiteMigrationPolicy

+ Progress func(SQLiteStartupProgress)

+ type SQLiteStartupResult struct

+ Inspection *SQLiteStoreInspection

+ Migration *SQLiteStoreMigrationResult

+ Store *Store

+ Verification *SQLiteStoreVerification

+ func StartSQLiteStore(ctx context.Context, path string, request SQLiteStartupRequest, ...) (SQLiteStartupResult, error)

type SubAgentReadHost

+ func (h *SubAgentReadHost) ListPendingToolSettlementTargets(ctx context.Context, req ListSubAgentPendingToolSettlementTargetsRequest) ([]PendingToolSettlementTarget, error)

type ThreadReadHost

+ func (h *ThreadReadHost) ListPendingToolSettlementTargets(ctx context.Context, threadID ThreadID) ([]PendingToolSettlementTarget, error)

type TurnExecutionHostOptions

+ func NewTurnExecutionOptions(cfg config.Config, options ...TurnExecutionOption) (TurnExecutionHostOptions, error)

+ type TurnExecutionOption struct

+ func WithDynamicToolSurface(provider ToolSurfaceProvider) TurnExecutionOption

+ func WithEffectfulTools(registry *tools.Registry, gate EffectAuthorizationGate) TurnExecutionOption

+ func WithEventSink(sink EventSink) TurnExecutionOption

+ func WithLoopLimits(limits LoopLimits) TurnExecutionOption

+ func WithModelGateway(gateway ModelGateway, identity ModelGatewayIdentity, ...) TurnExecutionOption

+ func WithReadOnlyTools(items ...tools.Tool) TurnExecutionOption

+ func WithThreadTitleMode(mode ThreadTitleMode) TurnExecutionOption

Jul 24, 2026

Changes in this version

type SQLiteStoreMaintenanceOperation

+ const SQLiteStoreOperationOpen

+ type SQLiteStoreOpenRequest struct

+ ExpectedSchema StoreSchemaIdentity

+ ExpectedState SQLiteStoreState

Jul 24, 2026

Changes in this version

+ type SQLiteStoreAction string

+ const SQLiteStoreActionExportDiagnostics

+ const SQLiteStoreActionMigrate

+ const SQLiteStoreActionRequiresNewerReader

+ const SQLiteStoreActionRetryInspection

+ type SQLiteStoreInspection struct

+ Actions []SQLiteStoreAction

+ AutomaticMigration bool

+ Current StoreSchemaIdentity

+ Empty bool

+ Exists bool

+ Kind SQLiteStoreKind

+ LeasePolicyState SQLiteStoreLeasePolicyState

+ Migratable []StoreSchemaMigrationSource

+ Observed StoreSchemaIdentity

+ PersistedLeasePolicy *StoreLeasePolicy

+ Reason SQLiteStoreReason

+ RequestedLeasePolicy StoreLeasePolicy

+ RequiresExclusive bool

+ Retryable bool

+ SafeDetail string

+ SafeToRetry bool

+ State SQLiteStoreState

+ func InspectSQLiteStore(ctx context.Context, path string, options ...SQLiteStoreOption) (SQLiteStoreInspection, error)

+ type SQLiteStoreKind string

+ const SQLiteStoreKindFloret

+ const SQLiteStoreKindUnknown

+ type SQLiteStoreLeasePolicyState string

+ const SQLiteStoreLeasePolicyMatches

+ const SQLiteStoreLeasePolicyMismatch

+ const SQLiteStoreLeasePolicyUnavailable

+ type SQLiteStoreMaintenanceError struct

+ Err error

+ Operation SQLiteStoreMaintenanceOperation

+ Reason SQLiteStoreReason

+ Retryable bool

+ SafeToRetry bool

+ func (e *SQLiteStoreMaintenanceError) Error() string

+ func (e *SQLiteStoreMaintenanceError) Unwrap() error

+ type SQLiteStoreMaintenanceOperation string

+ const SQLiteStoreOperationInspect

+ const SQLiteStoreOperationMigrate

+ const SQLiteStoreOperationVerify

+ type SQLiteStoreMaintenancePhase string

+ const SQLiteStoreMaintenanceMigrating

+ const SQLiteStoreMaintenancePreflight

+ const SQLiteStoreMaintenanceVerifying

+ const SQLiteStoreMaintenanceWaiting

+ type SQLiteStoreMaintenanceProgress struct

+ Committed bool

+ OperationID string

+ Phase SQLiteStoreMaintenancePhase

+ Reason SQLiteStoreReason

+ Retryable bool

+ RolledBack bool

+ SafeToCancel bool

+ SafeToRetry bool

+ Sequence uint64

+ Status SQLiteStoreMaintenanceStatus

+ Step int

+ Total int

+ type SQLiteStoreMaintenanceStatus string

+ const SQLiteStoreMaintenanceCancelled

+ const SQLiteStoreMaintenanceFailed

+ const SQLiteStoreMaintenanceReady

+ const SQLiteStoreMaintenanceRunning

+ type SQLiteStoreMigrationMode string

+ const SQLiteStoreMigrationApply

+ const SQLiteStoreMigrationPlan

+ type SQLiteStoreMigrationRequest struct

+ ExpectedSchema StoreSchemaIdentity

+ Mode SQLiteStoreMigrationMode

+ OperationID string

+ Progress func(SQLiteStoreMaintenanceProgress)

+ type SQLiteStoreMigrationResult struct

+ After SQLiteStoreInspection

+ Before SQLiteStoreInspection

+ Changed bool

+ Committed bool

+ Mode SQLiteStoreMigrationMode

+ OperationID string

+ Reason SQLiteStoreReason

+ Retryable bool

+ RolledBack bool

+ SafeToRetry bool

+ Status SQLiteStoreMaintenanceStatus

+ Steps []SQLiteStoreMigrationStep

+ func MigrateSQLiteStore(ctx context.Context, path string, request SQLiteStoreMigrationRequest, ...) (SQLiteStoreMigrationResult, error)

+ type SQLiteStoreMigrationStep struct

+ Code string

+ From StoreSchemaIdentity

+ To StoreSchemaIdentity

+ type SQLiteStoreOption func(*sqliteStoreOptions)

+ func WithSQLiteStoreLeasePolicy(policy StoreLeasePolicy) SQLiteStoreOption

+ type SQLiteStoreReason string

+ const SQLiteStoreReasonBusy

+ const SQLiteStoreReasonCancelled

+ const SQLiteStoreReasonContract

+ const SQLiteStoreReasonCorrupt

+ const SQLiteStoreReasonCurrent

+ const SQLiteStoreReasonFingerprint

+ const SQLiteStoreReasonIO

+ const SQLiteStoreReasonInspectionStale

+ const SQLiteStoreReasonInvalidRequest

+ const SQLiteStoreReasonLeaseMismatch

+ const SQLiteStoreReasonLegacyMigration

+ const SQLiteStoreReasonMigrationAvailable

+ const SQLiteStoreReasonMigrationFailed

+ const SQLiteStoreReasonNewerReader

+ const SQLiteStoreReasonPermission

+ const SQLiteStoreReasonSchemaMetadata

+ const SQLiteStoreReasonStoreEmpty

+ const SQLiteStoreReasonStoreMissing

+ const SQLiteStoreReasonUnrecognized

+ const SQLiteStoreReasonUnsupported

+ type SQLiteStoreState string

+ const SQLiteStoreStateBusy

+ const SQLiteStoreStateCorrupt

+ const SQLiteStoreStateCurrent

+ const SQLiteStoreStateDrifted

+ const SQLiteStoreStateEmpty

+ const SQLiteStoreStateFuture

+ const SQLiteStoreStateIOError

+ const SQLiteStoreStateMissing

+ const SQLiteStoreStatePermissionDenied

+ const SQLiteStoreStateUnsupportedOlder

+ const SQLiteStoreStateUpgradeable

+ type SQLiteStoreVerification struct

+ Checks []SQLiteStoreVerificationCheck

+ Inspection SQLiteStoreInspection

+ func VerifySQLiteStore(ctx context.Context, path string, options ...SQLiteStoreOption) (SQLiteStoreVerification, error)

+ type SQLiteStoreVerificationCheck struct

+ Code string

+ Passed bool

+ SafeDetail string

type StoreLeasePolicy

+ func (p StoreLeasePolicy) Validate() error

+ type StoreSchemaIdentity struct

+ Fingerprint string

+ Version string

+ type StoreSchemaMigrationRequirement string

+ const StoreSchemaMigrationRequirementNone

+ const StoreSchemaMigrationRequirementQuiescentAuthority

+ type StoreSchemaMigrationSource struct

+ Identity StoreSchemaIdentity

+ Requirement StoreSchemaMigrationRequirement

type UnsupportedStoreSchemaError

+ Current StoreSchemaIdentity

+ Migratable []StoreSchemaMigrationSource

+ Observed StoreSchemaIdentity

Jul 24, 2026

Changes in this version

+ const MaxMessageAttachmentMIMETypeBytes

+ const MaxMessageAttachmentNameRunes

+ const MaxMessageAttachmentResourceRefBytes

+ const MaxMessageAttachmentSizeBytes

+ const MaxMessageAttachmentsPayloadBytes

+ const MaxMessageAttachmentsPerTurn

+ const MaxMessageAttachmentsTotalSizeBytes

type MessageAttachment

+ TextStats *MessageAttachmentTextStats

+ type MessageAttachmentTextStats struct

+ LogicalLineCount int64

+ UnicodeCodePointCount int64

+ type ModelGatewayAttachmentPayloadMode string

+ const ModelGatewayAttachmentPayloadDescriptors

+ const ModelGatewayAttachmentPayloadExpanded

type ModelGatewayCapabilities

+ AttachmentPayload ModelGatewayAttachmentPayloadMode

+ type ModelGatewayRequestPreparer interface

+ PrepareModelRequest func(context.Context, ModelRequest) (PreparedModelRequest, error)

+ type ModelRequestTokenEstimate struct

+ Confidence string

+ Coverage ModelRequestTokenEstimateCoverage

+ EstimatedInputTokens int64

+ MessageTokens int64

+ Method string

+ PrefixTokens int64

+ Source string

+ ToolDefinitionTokens int64

+ type ModelRequestTokenEstimateCoverage string

+ const ModelRequestTokenEstimateCoverageComplete

+ type PreparedModelRequest interface

+ Close func() error

+ RenderedPayloadFingerprint func() string

+ StreamModel func(context.Context) (<-chan ModelEvent, error)

+ TokenEstimate func() ModelRequestTokenEstimate

Jul 22, 2026

Changes in this version

+ type ModelGatewayCapabilities struct

+ Reasoning *config.ReasoningCapability

type SubAgentHostOptions

+ ModelGatewayCapabilities ModelGatewayCapabilities

type ThreadCompactionHostOptions

+ ModelGatewayCapabilities ModelGatewayCapabilities

type TurnExecutionHostOptions

+ ModelGatewayCapabilities ModelGatewayCapabilities

Jul 21, 2026

Changes in this version

type ThreadReadHost

+ func (h *ThreadReadHost) ReadApprovalQueue(ctx context.Context, req ReadApprovalQueueRequest) (ApprovalQueue, error)

Jul 21, 2026

Changes in this version

+ const MaxMessageReferenceIDBytes

+ const MaxMessageReferenceLabelRunes

+ const MaxMessageReferenceResourceRefBytes

+ const MaxMessageReferenceTextRunes

+ const MaxMessageReferencesPayloadBytes

+ const MaxMessageReferencesPerTurn

+ const MaxTurnSupplementalContextItems

+ const MaxTurnSupplementalContextKindRunes

+ const MaxTurnSupplementalContextTextRunes

+ const MaxTurnSupplementalContextTitleRunes

+ const MaxTurnSupplementalMetadataKeyBytes

+ const MaxTurnSupplementalMetadataPairs

+ const MaxTurnSupplementalMetadataValueRunes

+ const MaxTurnSupplementalPayloadBytes

+ const MessageReferenceDirectory

+ const MessageReferenceFile

+ const MessageReferenceProcess

+ const MessageReferenceTerminal

+ const MessageReferenceText

+ var ErrStaleThreadTurnCursor = errors.New("floret thread turn cursor is stale")

+ type ApprovalDecision string

+ const ApprovalDecisionApprove

+ const ApprovalDecisionReject

+ type ApprovalDecisionReceipt struct

+ ApprovalID string

+ ApprovalRevision int64

+ AuthorizationProofHash string

+ Decision ApprovalDecision

+ DecisionID string

+ QueueGeneration int64

+ QueueRevision int64

+ Reason string

+ ResolvedAt time.Time

+ RootThreadID ThreadID

+ State string

+ SubmittedAt time.Time

+ func (r ApprovalDecisionReceipt) Validate() error

+ type ApprovalIdentity struct

+ ApprovalID string

+ EffectAttemptID string

+ RunID RunID

+ ThreadID ThreadID

+ ToolCallID string

+ TurnID TurnID

+ func (i ApprovalIdentity) Validate() error

+ type ApprovalQueue struct

+ CurrentApprovalID string

+ GeneratedAt time.Time

+ Generation int64

+ Items []ApprovalRecord

+ Revision int64

+ RootThreadID ThreadID

+ func (q ApprovalQueue) Validate() error

+ type ApprovalRecord struct

+ ApprovalID string

+ ArgsHash string

+ AuthorizationProofHash string

+ BatchIndex int

+ BatchSize int

+ DecisionID string

+ Destructive bool

+ EffectAttemptID string

+ Effects []string

+ HostContext map[string]string

+ Labels map[string]string

+ OpenWorld bool

+ ParentThreadID ThreadID

+ QueueSequence int64

+ ReadOnly bool

+ Reason string

+ RequestFingerprint string

+ RequestedAt time.Time

+ ResolvedAt time.Time

+ Resources []ApprovalResource

+ Revision int64

+ RootThreadID ThreadID

+ RunID RunID

+ State string

+ Step int

+ ThreadID ThreadID

+ ToolCallID string

+ ToolKind string

+ ToolName string

+ TurnID TurnID

+ UpdatedAt time.Time

+ func (p ApprovalRecord) Validate() error

+ type ApprovalResource struct

+ Kind string

+ Value string

+ func (r ApprovalResource) Validate() error

type ListThreadTurnsRequest

+ BeforeCursor *ThreadTurnsBeforeCursor

+ SinceCursor *ThreadTurnsSinceCursor

+ type MessageReference struct

+ Kind MessageReferenceKind

+ Label string

+ ReferenceID string

+ ResourceRef string

+ Text string

+ Truncated bool

+ func (r MessageReference) Validate() error

+ type MessageReferenceKind string

+ type ReadApprovalQueueRequest struct

+ ThreadID ThreadID

type RecoverInterruptedTurnResult

+ Failure *ThreadTurnFailure

+ type ResolveApprovalRequest struct

+ Decision ApprovalDecision

+ DecisionID string

+ ExpectedApprovalRevision int64

+ ExpectedCurrent ApprovalIdentity

+ ExpectedGeneration int64

+ ExpectedRevision int64

+ ExpectedRootThreadID ThreadID

+ func (r ResolveApprovalRequest) Validate() error

+ type ResolveApprovalResult struct

+ Approval ApprovalRecord

+ Queue ApprovalQueue

+ Receipt ApprovalDecisionReceipt

+ Replayed bool

+ func (r ResolveApprovalResult) Validate() error

type SendSubAgentInputRequest

+ References []MessageReference

type SpawnSubAgentRequest

+ References []MessageReference

type ThreadDetailMessage

+ References []MessageReference

type ThreadSnapshot

+ TitleGeneration int64

type ThreadSummary

+ TitleGeneration int64

+ type ThreadTurnFailure struct

+ Code ThreadTurnFailureCode

+ Message string

+ func (f ThreadTurnFailure) Validate() error

+ type ThreadTurnFailureCode string

+ const ThreadTurnFailureAuthorizationContract

+ const ThreadTurnFailureAuthorizationUnavailable

+ const ThreadTurnFailureCancelled

+ const ThreadTurnFailureEffectOutcomeUnknown

+ const ThreadTurnFailureEngineContract

+ const ThreadTurnFailureInterrupted

+ const ThreadTurnFailureLegacyUnclassified

+ const ThreadTurnFailureProvider

+ const ThreadTurnFailureStorage

+ const ThreadTurnFailureToolDispatch

+ func (c ThreadTurnFailureCode) Valid() bool

+ type ThreadTurnRetrySource struct

+ EntryID string

+ TurnID TurnID

type ThreadTurnSnapshot

+ CanRetry bool

+ Recoverable bool

+ RetrySource *ThreadTurnRetrySource

+ UserReferences []MessageReference

+ type ThreadTurnsBeforeCursor struct

+ EntryID string

type ThreadTurnsPage

+ BeforeCursor *ThreadTurnsBeforeCursor

+ SinceCursor ThreadTurnsSinceCursor

+ type ThreadTurnsSinceCursor struct

+ EntryID string

type TurnExecutionHost

+ func (h *TurnExecutionHost) ReadApprovalQueue(ctx context.Context, req ReadApprovalQueueRequest) (ApprovalQueue, error)

+ func (h *TurnExecutionHost) ResolveApproval(ctx context.Context, req ResolveApprovalRequest) (ResolveApprovalResult, error)

type TurnInput

+ References []MessageReference

type TurnResult

+ Failure *ThreadTurnFailure

+ Replayed bool

type TurnStatus

+ const TurnStatusInterrupted

Jul 19, 2026

Changes in this version

+ var ErrInterruptedTurnNotFound = errors.New("floret interrupted turn not found")

+ var ErrRecoveryTargetResolved = errors.New("floret interrupted turn recovery target is resolved")

type InterruptedTurnRecoveryHostBinder

+ func (b *InterruptedTurnRecoveryHostBinder) BindSubAgent(ctx context.Context, parentThreadID, childThreadID ThreadID) (*InterruptedTurnRecoveryHostFactory, error)

+ func (b *InterruptedTurnRecoveryHostBinder) BindThread(ctx context.Context, threadID ThreadID) (*InterruptedTurnRecoveryHostFactory, error)

+ type InterruptedTurnRecoveryHostFactory struct

+ func (f *InterruptedTurnRecoveryHostFactory) NewHost(ctx context.Context, sink EventSink) (*InterruptedTurnRecoveryHost, error)

Jul 19, 2026

Changes in this version

+ var ErrArtifactNotFound = errors.New("floret artifact not found")

+ var ErrAuthorityCorrupt = errors.New("floret authority state is corrupt")

+ var ErrAuthorizationContract = errors.New("floret effect authorization contract failed")

+ var ErrAuthorizationUnavailable = errors.New("floret effect authorization is unavailable")

+ var ErrEffectDispatchConsumed = errors.New("floret authorized effect dispatch was consumed")

+ var ErrEffectOutcomeUnknown = errors.New("floret effect outcome is unknown")

+ var ErrEffectUnauthorized = errors.New("floret effect is unauthorized")

+ var ErrInvalidAuthorizationProof = errors.New("floret effect authorization proof is invalid")

+ var ErrNoRetryTarget = errors.New("floret thread has no retry target")

+ var ErrPendingToolNotActive = errors.New("floret pending tool is not active")

+ var ErrPendingToolNotFound = errors.New("floret pending tool not found")

+ var ErrPendingToolSettlementConflict = errors.New("floret pending tool settlement conflict")

+ var ErrRequestConflict = errors.New("floret request conflicts with persisted authority")

+ var ErrStaleAuthority = errors.New("floret authority proof is stale")

+ var ErrStoreClosed = errors.New("floret store is closed")

+ var ErrSubAgentClosed = errors.New("floret subagent is closed")

+ var ErrSubAgentClosing = errors.New("floret subagent is closing")

+ var ErrThreadBusy = errors.New("floret thread is busy")

+ var ErrThreadDeleted = errors.New("floret thread is deleted")

+ var ErrUnsupportedStoreCapability = errors.New("floret store capability is unsupported")

+ func ConfigureHostCapabilities(store *Store, configure func(*HostBootstrap) error) (err error)

+ type ArtifactContent struct

+ Ref ArtifactRef

+ Text string

+ type ArtifactID string

+ type AuthorityBusyError struct

+ Err error

+ Kind AuthorityBusyKind

+ func (e *AuthorityBusyError) Error() string

+ func (e *AuthorityBusyError) Is(target error) bool

+ func (e *AuthorityBusyError) Unwrap() error

+ type AuthorityBusyKind string

+ const AuthorityBusyAuthority

+ const AuthorityBusyTurn

+ type AuthorizedEffect func(EffectAuthorizationProof) (EffectDispatchResult, error)

type CloseSubAgentRequest

+ CloseOperationID string

+ type CommittedCleanupError struct

+ Err error

+ ThreadID ThreadID

+ func (e *CommittedCleanupError) Error() string

+ func (e *CommittedCleanupError) Unwrap() error

+ type CommittedEffectError struct

+ EffectAttemptID string

+ Err error

+ func (e *CommittedEffectError) Error() string

+ func (e *CommittedEffectError) Unwrap() error

type CompactThreadResult

+ Replayed bool

+ type CreateIntentID string

type CreateThreadRequest

+ CreateIntentID CreateIntentID

+ type EffectAuthorizationGate interface

+ Dispatch func(context.Context, EffectAuthorizationRequest, AuthorizedEffect) (EffectDispatchResult, error)

+ type EffectAuthorizationGateFunc func(context.Context, EffectAuthorizationRequest, AuthorizedEffect) (EffectDispatchResult, error)

+ func (f EffectAuthorizationGateFunc) Dispatch(ctx context.Context, req EffectAuthorizationRequest, effect AuthorizedEffect) (EffectDispatchResult, error)

+ type EffectAuthorizationProof struct

+ ApprovalID string

+ AuditHash string

+ AuditReference string

+ AuthorizedAt time.Time

+ EffectAttemptID string

+ LeaseGeneration int64

+ LeaseOwnerID string

+ PolicyRevision string

+ RequestFingerprint string

+ RunID RunID

+ ThreadID ThreadID

+ ToolCallID string

+ TurnID TurnID

+ type EffectAuthorizationRequest struct

+ ArgumentHash string

+ BatchIndex int

+ BatchSize int

+ Destructive bool

+ EffectAttemptID string

+ Effects []tools.Effect

+ HostContext map[string]string

+ Labels map[string]string

+ LeaseGeneration int64

+ LeaseOwnerID string

+ ObservedHeartbeat int64

+ OpenWorld bool

+ Permission tools.PermissionSpec

+ ReadOnly bool

+ RequestFingerprint string

+ Resources []tools.ResourceRef

+ RunID RunID

+ Step int

+ ThreadID ThreadID

+ ToolCallID string

+ ToolName string

+ TurnID TurnID

+ type EffectDispatchResult struct

+ type InterruptedTurnRecoveryHost struct

+ func (h *InterruptedTurnRecoveryHost) RecoverInterruptedTurn(ctx context.Context) (RecoverInterruptedTurnResult, error)

+ type InterruptedTurnRecoveryHostBinder struct

+ func NewInterruptedTurnRecoveryHostBinder(bootstrap *HostBootstrap) (*InterruptedTurnRecoveryHostBinder, error)

+ func (b *InterruptedTurnRecoveryHostBinder) NewSubAgentHost(ctx context.Context, parentThreadID, childThreadID ThreadID, sink EventSink) (*InterruptedTurnRecoveryHost, error)

+ func (b *InterruptedTurnRecoveryHostBinder) NewThreadHost(ctx context.Context, threadID ThreadID, sink EventSink) (*InterruptedTurnRecoveryHost, error)

type PendingToolCompletionRequest

+ CompletionRequestID string

+ ContinuationRunID RunID

+ ContinuationTurnID TurnID

+ Input TurnInput

+ Target PendingToolSettlementTarget

+ type PendingToolCompletionResult struct

+ CompletionRequestID string

+ Replayed bool

+ RunID RunID

+ Status TurnStatus

+ ThreadID ThreadID

+ Turn *TurnResult

+ TurnID TurnID

+ func (r PendingToolCompletionResult) Validate() error

+ type PendingToolRecoveryHost struct

+ func (h *PendingToolRecoveryHost) SettlePendingTool(ctx context.Context, req PendingToolSettlementRequest) (PendingToolSettlementResult, error)

+ type PendingToolRecoveryHostBinder struct

+ func NewPendingToolRecoveryHostBinder(bootstrap *HostBootstrap) (*PendingToolRecoveryHostBinder, error)

+ func (b *PendingToolRecoveryHostBinder) NewSubAgentHost(ctx context.Context, parentThreadID ThreadID, sink EventSink) (*PendingToolRecoveryHost, error)

+ func (b *PendingToolRecoveryHostBinder) NewThreadHost(ctx context.Context, threadID ThreadID, sink EventSink) (*PendingToolRecoveryHost, error)

type PendingToolSettlementTarget

+ EffectAttemptID string

+ type PublishSubAgentPendingToolCompletionRequest struct

+ ChildThreadID ThreadID

+ Input TurnInput

+ InputRequestID string

+ Labels RunLabels

+ Output string

+ ParentThreadID ThreadID

+ Status PendingToolCompletionStatus

+ Summary string

+ Target PendingToolSettlementTarget

+ type ReadArtifactRequest struct

+ ArtifactID ArtifactID

+ ThreadID ThreadID

+ type RecoverInterruptedTurnResult struct

+ Replayed bool

+ RunID RunID

+ Status TurnStatus

+ ThreadID ThreadID

+ TurnID TurnID

+ type RequestConflictError struct

+ Err error

+ Operation string

+ RequestID string

+ func (e *RequestConflictError) Error() string

+ func (e *RequestConflictError) Is(target error) bool

+ func (e *RequestConflictError) Unwrap() error

type SendSubAgentInputRequest

+ Attachments []MessageAttachment

+ InputRequestID string

type SpawnSubAgentRequest

+ Attachments []MessageAttachment

+ PublicationID string

+ type StoreLeasePolicy struct

+ ClockSkewAllowance time.Duration

+ RenewInterval time.Duration

+ TTL time.Duration

+ type StoreLeasePolicyMismatchError struct

+ Configured StoreLeasePolicy

+ Persisted StoreLeasePolicy

+ func (e *StoreLeasePolicyMismatchError) Error() string

type SubAgentHost

+ func (h *SubAgentHost) PublishPendingToolCompletion(ctx context.Context, req PublishSubAgentPendingToolCompletionRequest) (SubAgentSnapshot, error)

+ func (h *SubAgentHost) SettlePendingTool(ctx context.Context, req PendingToolSettlementRequest) (PendingToolSettlementResult, error)

+ type SubAgentHostBinder struct

+ func NewSubAgentHostBinder(bootstrap *HostBootstrap) (*SubAgentHostBinder, error)

+ func (b *SubAgentHostBinder) Bind(parentThreadID ThreadID) (*SubAgentHostFactory, error)

type SubAgentHostOptions

+ EffectAuthorizationGate EffectAuthorizationGate

type SubAgentReadHost

+ func (h *SubAgentReadHost) ReadArtifact(ctx context.Context, req ReadArtifactRequest) (ArtifactContent, error)

+ type SubAgentReadHostBinder struct

+ func NewSubAgentReadHostBinder(bootstrap *HostBootstrap) (*SubAgentReadHostBinder, error)

+ func (b *SubAgentReadHostBinder) NewHost(ctx context.Context, parentThreadID ThreadID) (*SubAgentReadHost, error)

type SubAgentStatus

+ const SubAgentStatusClosing

+ type ThreadCompactionHostBinder struct

+ func NewThreadCompactionHostBinder(bootstrap *HostBootstrap) (*ThreadCompactionHostBinder, error)

+ func (b *ThreadCompactionHostBinder) Bind(threadID ThreadID) (*ThreadCompactionHostFactory, error)

+ type ThreadCreateHostBinder struct

+ func NewThreadCreateHostBinder(bootstrap *HostBootstrap) (*ThreadCreateHostBinder, error)

+ func (b *ThreadCreateHostBinder) Bind(threadID ThreadID, createIntentID CreateIntentID) (*ThreadCreateHost, error)

+ type ThreadDeleteHostBinder struct

+ func NewThreadDeleteHostBinder(bootstrap *HostBootstrap) (*ThreadDeleteHostBinder, error)

+ func (b *ThreadDeleteHostBinder) NewHost(ctx context.Context, threadID ThreadID) (*ThreadDeleteHost, error)

type ThreadDetailToolResult

+ EffectAttemptID string

+ type ThreadForkHostBinder struct

+ func NewThreadForkHostBinder(bootstrap *HostBootstrap) (*ThreadForkHostBinder, error)

+ func (b *ThreadForkHostBinder) NewHost(ctx context.Context, threadID ThreadID, sink EventSink) (*ThreadForkHost, error)

type ThreadReadHost

+ func (h *ThreadReadHost) ReadArtifact(ctx context.Context, req ReadArtifactRequest) (ArtifactContent, error)

+ type ThreadReadHostBinder struct

+ func NewThreadReadHostBinder(bootstrap *HostBootstrap) (*ThreadReadHostBinder, error)

+ func (b *ThreadReadHostBinder) NewHost(ctx context.Context, threadID ThreadID) (*ThreadReadHost, error)

+ type ThreadTitleHostBinder struct

+ func NewThreadTitleHostBinder(bootstrap *HostBootstrap) (*ThreadTitleHostBinder, error)

+ func (b *ThreadTitleHostBinder) NewHost(ctx context.Context, threadID ThreadID, sink EventSink) (*ThreadTitleHost, error)

type TurnExecutionHost

+ func (h *TurnExecutionHost) SettlePendingTool(ctx context.Context, req PendingToolSettlementRequest) (PendingToolSettlementResult, error)

+ type TurnExecutionHostBinder struct

+ func NewTurnExecutionHostBinder(bootstrap *HostBootstrap) (*TurnExecutionHostBinder, error)

+ func (b *TurnExecutionHostBinder) Bind(threadID ThreadID) (*TurnExecutionHostFactory, error)

type TurnExecutionHostOptions

+ EffectAuthorizationGate EffectAuthorizationGate

+ type UnsupportedStoreSchemaError struct

+ CurrentFingerprint string

+ CurrentVersion string

+ ObservedFingerprint string

+ ObservedVersion string

+ PredecessorFingerprint string

+ PredecessorVersion string

+ func (e *UnsupportedStoreSchemaError) Error() string

Jul 18, 2026

Changes in this version

+ var ErrSubAgentParentRequired = errors.New("floret subagent operation requires parent authority")

+ var ErrThreadAuthorityInvariant = errors.New("floret thread authority invariant violated")

+ var ErrThreadNotActive = errors.New("floret thread is not active")

+ type HostBootstrap struct

+ func NewHostBootstrap(store *Store) (*HostBootstrap, error)

+ type PendingToolRecoveryHostFactory struct

+ func NewPendingToolRecoveryHostFactory(bootstrap *HostBootstrap) (*PendingToolRecoveryHostFactory, error)

+ func (f *PendingToolRecoveryHostFactory) NewHost(opts PendingToolRecoveryHostOptions) (*PendingToolSettlementHost, error)

+ type PendingToolRecoveryHostOptions struct

+ ParentThreadID ThreadID

+ Sink EventSink

+ ThreadID ThreadID

type PendingToolSettlementHost

+ func NewSubAgentPendingToolSettlementHost(host *SubAgentHost) (*PendingToolSettlementHost, error)

+ func NewTurnPendingToolSettlementHost(host *TurnExecutionHost) (*PendingToolSettlementHost, error)

+ type SubAgentHost struct

+ func (h *SubAgentHost) CloseSubAgent(ctx context.Context, req CloseSubAgentRequest) (SubAgentSnapshot, error)

+ func (h *SubAgentHost) SendSubAgentInput(ctx context.Context, req SendSubAgentInputRequest) (SubAgentSnapshot, error)

+ func (h *SubAgentHost) SpawnSubAgent(ctx context.Context, req SpawnSubAgentRequest) (SubAgentSnapshot, error)

+ func (h *SubAgentHost) WaitSubAgents(ctx context.Context, req WaitSubAgentsRequest) (WaitSubAgentsResult, error)

+ type SubAgentHostFactory struct

+ func NewSubAgentHostFactory(bootstrap *HostBootstrap) (*SubAgentHostFactory, error)

+ func (f *SubAgentHostFactory) NewHost(opts SubAgentHostOptions) (*SubAgentHost, error)

+ type SubAgentHostOptions struct

+ Approver tools.Approver

+ Capabilities CapabilityOptions

+ Config config.Config

+ IDGenerator func(string) string

+ LoopLimits LoopLimits

+ ModelGateway ModelGateway

+ ModelGatewayIdentity ModelGatewayIdentity

+ ParentThreadID ThreadID

+ Sink EventSink

+ SubAgentRunTimeout time.Duration

+ ThreadTitleMode ThreadTitleMode

+ ToolSurfaceProvider ToolSurfaceProvider

+ Tools *tools.Registry

+ type SubAgentMaintenanceHostFactory struct

+ func NewSubAgentMaintenanceHostFactory(bootstrap *HostBootstrap) (*SubAgentMaintenanceHostFactory, error)

+ func (f *SubAgentMaintenanceHostFactory) NewHost(opts SubAgentMaintenanceHostOptions) (*SubAgentMaintenanceHost, error)

+ type SubAgentMaintenanceHostOptions struct

+ ParentThreadID ThreadID

+ Sink EventSink

+ type SubAgentReadHost struct

+ func (h *SubAgentReadHost) ListSubAgentActivityTimeline(ctx context.Context, req ListSubAgentActivityTimelineRequest) (SubAgentActivityTimelineResult, error)

+ func (h *SubAgentReadHost) ListSubAgents(ctx context.Context, parentThreadID ThreadID) ([]SubAgentSnapshot, error)

+ func (h *SubAgentReadHost) ReadSubAgentDetail(ctx context.Context, req ReadSubAgentDetailRequest) (SubAgentDetail, error)

+ type SubAgentReadHostFactory struct

+ func NewSubAgentReadHostFactory(bootstrap *HostBootstrap) (*SubAgentReadHostFactory, error)

+ func (f *SubAgentReadHostFactory) NewHost(opts SubAgentReadHostOptions) (*SubAgentReadHost, error)

+ type SubAgentReadHostOptions struct

+ ParentThreadID ThreadID

+ Sink EventSink

+ type ThreadCompactionHost struct

+ func (h *ThreadCompactionHost) CompactThread(ctx context.Context, req CompactThreadRequest) (CompactThreadResult, error)

+ type ThreadCompactionHostFactory struct

+ func NewThreadCompactionHostFactory(bootstrap *HostBootstrap) (*ThreadCompactionHostFactory, error)

+ func (f *ThreadCompactionHostFactory) NewHost(opts ThreadCompactionHostOptions) (*ThreadCompactionHost, error)

+ type ThreadCompactionHostOptions struct

+ Config config.Config

+ IDGenerator func(string) string

+ LoopLimits LoopLimits

+ ModelGateway ModelGateway

+ ModelGatewayIdentity ModelGatewayIdentity

+ Sink EventSink

+ ThreadID ThreadID

+ type TurnExecutionHost struct

+ func (h *TurnExecutionHost) CompletePendingTool(ctx context.Context, req PendingToolCompletionRequest) (TurnResult, error)

+ func (h *TurnExecutionHost) ListPendingApprovals(ctx context.Context, req ListPendingApprovalsRequest) (PendingApprovals, error)

+ func (h *TurnExecutionHost) RetryTurn(ctx context.Context, req RetryTurnRequest) (TurnResult, error)

+ func (h *TurnExecutionHost) RunTurn(ctx context.Context, req RunTurnRequest) (TurnResult, error)

+ func (h *TurnExecutionHost) UpdateThreadAgentTodos(ctx context.Context, req UpdateThreadAgentTodosRequest) (ThreadAgentTodoState, error)

+ type TurnExecutionHostFactory struct

+ func NewTurnExecutionHostFactory(bootstrap *HostBootstrap) (*TurnExecutionHostFactory, error)

+ func (f *TurnExecutionHostFactory) NewHost(opts TurnExecutionHostOptions) (*TurnExecutionHost, error)

+ type TurnExecutionHostOptions struct

+ Approver tools.Approver

+ Capabilities CapabilityOptions

+ Config config.Config

+ IDGenerator func(string) string

+ LoopLimits LoopLimits

+ ModelGateway ModelGateway

+ ModelGatewayIdentity ModelGatewayIdentity

+ Sink EventSink

+ ThreadID ThreadID

+ ThreadTitleMode ThreadTitleMode

+ ToolSurfaceProvider ToolSurfaceProvider

+ Tools *tools.Registry

Jul 18, 2026

Changes in this version

type HostOptions

+ Runtime *HostRuntime

+ type HostRuntime struct

+ func NewHostRuntime(store *Store) (*HostRuntime, error)

+ type PendingToolSettlementHost struct

+ func NewPendingToolSettlementHost(opts ThreadCapabilityOptions) (*PendingToolSettlementHost, error)

+ func (h *PendingToolSettlementHost) SettlePendingTool(ctx context.Context, req PendingToolSettlementRequest) (PendingToolSettlementResult, error)

+ type SubAgentMaintenanceHost struct

+ func NewSubAgentMaintenanceHost(opts ThreadCapabilityOptions) (*SubAgentMaintenanceHost, error)

+ func (h *SubAgentMaintenanceHost) CloseSubAgents(ctx context.Context, req CloseSubAgentsRequest) (CloseSubAgentsResult, error)

+ type ThreadCapabilityOptions struct

+ Runtime *HostRuntime

+ Sink EventSink

+ type ThreadCreateHost struct

+ func NewThreadCreateHost(opts ThreadCapabilityOptions) (*ThreadCreateHost, error)

+ func (h *ThreadCreateHost) CreateThread(ctx context.Context, req CreateThreadRequest) (ThreadSummary, error)

+ type ThreadDeleteHost struct

+ func NewThreadDeleteHost(opts ThreadCapabilityOptions) (*ThreadDeleteHost, error)

+ func (h *ThreadDeleteHost) DeleteThread(ctx context.Context, threadID ThreadID) error

+ type ThreadForkHost struct

+ func NewThreadForkHost(opts ThreadCapabilityOptions) (*ThreadForkHost, error)

+ func (h *ThreadForkHost) ForkThread(ctx context.Context, req ForkThreadRequest) (ForkThreadResult, error)

+ type ThreadReadHost struct

+ func NewThreadReadHost(opts ThreadCapabilityOptions) (*ThreadReadHost, error)

+ func (h *ThreadReadHost) ListSubAgentActivityTimeline(ctx context.Context, req ListSubAgentActivityTimelineRequest) (SubAgentActivityTimelineResult, error)

+ func (h *ThreadReadHost) ListSubAgentDetailEvents(ctx context.Context, req ListSubAgentDetailEventsRequest) (SubAgentDetailEvents, error)

+ func (h *ThreadReadHost) ListSubAgents(ctx context.Context, parentThreadID ThreadID) ([]SubAgentSnapshot, error)

+ func (h *ThreadReadHost) ListThreadDetailEvents(ctx context.Context, req ListThreadDetailEventsRequest) (ThreadDetailEvents, error)

+ func (h *ThreadReadHost) ListThreadTurns(ctx context.Context, req ListThreadTurnsRequest) (ThreadTurnsPage, error)

+ func (h *ThreadReadHost) ReadLatestThreadTurn(ctx context.Context, threadID ThreadID) (ThreadTurnSnapshot, error)

+ func (h *ThreadReadHost) ReadSubAgentDetail(ctx context.Context, req ReadSubAgentDetailRequest) (SubAgentDetail, error)

+ func (h *ThreadReadHost) ReadThread(ctx context.Context, threadID ThreadID) (ThreadSnapshot, error)

+ func (h *ThreadReadHost) ReadThreadAgentTodos(ctx context.Context, threadID ThreadID) (ThreadAgentTodoState, error)

+ func (h *ThreadReadHost) ReadThreadContext(ctx context.Context, threadID ThreadID) (ThreadContextSnapshot, error)

+ func (h *ThreadReadHost) ReadThreadOverview(ctx context.Context, threadID ThreadID) (ThreadOverview, error)

+ func (h *ThreadReadHost) ReadTurnProjection(ctx context.Context, req ReadTurnProjectionRequest) (ThreadTurnProjection, error)

+ type ThreadTitleHost struct

+ func NewThreadTitleHost(opts ThreadCapabilityOptions) (*ThreadTitleHost, error)

+ func (h *ThreadTitleHost) SetThreadTitle(ctx context.Context, req SetThreadTitleRequest) (ThreadSnapshot, error)

Jul 18, 2026

Changes in this version

+ type CreateThreadRequest struct

+ ThreadID ThreadID

type Host

+ func (h *Host) CreateThread(ctx context.Context, req CreateThreadRequest) (ThreadSummary, error)

type ThreadMaintenanceHost

+ func (h *ThreadMaintenanceHost) CreateThread(ctx context.Context, req CreateThreadRequest) (ThreadSummary, error)

Jul 18, 2026

Changes in this version

type Host

+ func (h *Host) ReadThreadOverview(ctx context.Context, threadID ThreadID) (ThreadOverview, error)

+ func (h *Host) SetThreadTitle(ctx context.Context, req SetThreadTitleRequest) (ThreadSnapshot, error)

+ type MessageAttachment struct

+ MIMEType string

+ Name string

+ ResourceRef string

+ SizeBytes int64

+ func (a MessageAttachment) Validate() error

type ModelMessage

+ Attachments []MessageAttachment

+ type SetThreadTitleRequest struct

+ ThreadID ThreadID

+ Title string

type ThreadDetailMessage

+ Attachments []MessageAttachment

type ThreadMaintenanceHost

+ func (h *ThreadMaintenanceHost) ReadThreadOverview(ctx context.Context, threadID ThreadID) (ThreadOverview, error)

+ func (h *ThreadMaintenanceHost) SetThreadTitle(ctx context.Context, req SetThreadTitleRequest) (ThreadSnapshot, error)

+ type ThreadOverview struct

+ LatestTurn *ThreadTurnSnapshot

+ Thread ThreadSnapshot

type ThreadTurnSnapshot

+ UserAttachments []MessageAttachment

+ type TurnInput struct

+ Attachments []MessageAttachment

+ Text string

+ func (i TurnInput) Validate() error

Jul 18, 2026

Changes in this version

type Host

+ func (h *Host) ReadLatestThreadTurn(ctx context.Context, threadID ThreadID) (ThreadTurnSnapshot, error)

type PendingApproval

+ func (p PendingApproval) Validate() error

type PendingApprovalResource

+ func (r PendingApprovalResource) Validate() error

type PendingApprovals

+ func (p PendingApprovals) Validate() error

type ThreadMaintenanceHost

+ func (h *ThreadMaintenanceHost) ReadLatestThreadTurn(ctx context.Context, threadID ThreadID) (ThreadTurnSnapshot, error)

Jul 17, 2026

Changes in this version

+ var ErrAgentTodoVersionConflict = errors.New("floret agent todo version conflict")

+ var ErrJournalInvariant = errors.New("floret thread journal invariant violated")

+ type AgentTodo struct

+ Content string

+ ID string

+ Status AgentTodoStatus

+ type AgentTodoStatus string

+ const AgentTodoCompleted

+ const AgentTodoInProgress

+ const AgentTodoPending

+ func (s AgentTodoStatus) Valid() bool

type Host

+ func (h *Host) ListThreadTurns(ctx context.Context, req ListThreadTurnsRequest) (ThreadTurnsPage, error)

+ func (h *Host) ReadThreadAgentTodos(ctx context.Context, threadID ThreadID) (ThreadAgentTodoState, error)

+ func (h *Host) UpdateThreadAgentTodos(ctx context.Context, req UpdateThreadAgentTodosRequest) (ThreadAgentTodoState, error)

+ type ListThreadTurnsRequest struct

+ AfterOrdinal int64

+ BeforeOrdinal int64

+ Limit int

+ Tail int

+ ThreadID ThreadID

type SubAgentDetailToolCall

+ ControlSignal *ThreadDetailControlSignal

+ type ThreadAgentTodoState struct

+ Items []AgentTodo

+ ThreadID ThreadID

+ UpdatedAt time.Time

+ UpdatedByRunID RunID

+ UpdatedByToolCall string

+ UpdatedByTurnID TurnID

+ Version int64

+ type ThreadControlSignal struct

+ ArgsHash string

+ CallID string

+ Disposition string

+ Name string

+ Payload map[string]any

+ Text string

+ type ThreadDetailControlSignal struct

+ ArgsHash string

+ CallID string

+ Disposition string

+ Name string

+ Payload map[string]any

+ Text string

type ThreadDetailToolCall

+ ControlSignal *ThreadDetailControlSignal

type ThreadMaintenanceHost

+ func (h *ThreadMaintenanceHost) ListThreadTurns(ctx context.Context, req ListThreadTurnsRequest) (ThreadTurnsPage, error)

+ func (h *ThreadMaintenanceHost) ReadThread(ctx context.Context, threadID ThreadID) (ThreadSnapshot, error)

+ func (h *ThreadMaintenanceHost) ReadThreadAgentTodos(ctx context.Context, threadID ThreadID) (ThreadAgentTodoState, error)

+ func (h *ThreadMaintenanceHost) UpdateThreadAgentTodos(ctx context.Context, req UpdateThreadAgentTodosRequest) (ThreadAgentTodoState, error)

type ThreadSnapshot

+ LatestRunID RunID

+ ThroughOrdinal int64

type ThreadTurnProjectionSignal

+ ArgsHash string

+ Disposition string

+ Payload map[string]any

+ type ThreadTurnSnapshot struct

+ ControlSignals []ThreadControlSignal

+ Failure string

+ Ordinal int64

+ Projection ThreadTurnProjection

+ RunID RunID

+ StartedAt time.Time

+ Status TurnStatus

+ ThroughOrdinal int64

+ TurnID TurnID

+ UpdatedAt time.Time

+ UserEntryID string

+ UserInput string

+ type ThreadTurnsPage struct

+ GeneratedAt time.Time

+ HasMore bool

+ ThreadID ThreadID

+ ThroughOrdinal int64

+ Turns []ThreadTurnSnapshot

+ type UpdateThreadAgentTodosRequest struct

+ ExpectedVersion int64

+ Items []AgentTodo

+ RunID RunID

+ ThreadID ThreadID

+ ToolCallID string

+ TurnID TurnID

Jul 17, 2026

Changes in this version

type CompactThreadResult

+ Compaction observation.CompactionEvent

+ RequestID string

+ RunID RunID

+ func (r CompactThreadResult) Validate() error

type Host

+ func (h *Host) ReadThreadContext(ctx context.Context, threadID ThreadID) (ThreadContextSnapshot, error)

type ModelGatewayIdentity

+ StateCompatibilityKey string

type ModelMessage

+ Text string

+ ToolCalls []tools.ToolCall

+ ToolResult *ModelToolResult

+ func (m ModelMessage) Validate() error

+ type ModelMessageRole string

+ const ModelMessageRoleAssistant

+ const ModelMessageRoleSystem

+ const ModelMessageRoleTool

+ const ModelMessageRoleUser

+ func (r ModelMessageRole) Valid() bool

+ type ModelToolResult struct

+ CallID string

+ Text string

+ ToolName string

type PendingToolSettlementResult

+ func (r PendingToolSettlementResult) Validate() error

type SubAgentDetailCompaction

+ OperationID string

+ RequestID string

+ Source string

+ type ThreadContextSnapshot struct

+ Compactions []observation.CompactionEvent

+ Model string

+ Policy config.ContextPolicy

+ Provider string

+ ThreadID ThreadID

+ UpdatedAt time.Time

+ Usage *observation.ContextStatus

+ func (s ThreadContextSnapshot) Validate() error

type ThreadDetailCompaction

+ OperationID string

+ RequestID string

+ Source string

type ThreadDetailEvent

+ RunID RunID

+ Step int

type ThreadMaintenanceHost

+ func (h *ThreadMaintenanceHost) ReadThreadContext(ctx context.Context, threadID ThreadID) (ThreadContextSnapshot, error)

type TurnResult

+ ThreadID ThreadID

+ TurnID TurnID

+ func (r TurnResult) Validate() error

Jul 16, 2026

Changes in this version

type PendingToolSettlementRequest

+ Target PendingToolSettlementTarget

type PendingToolSettlementResult

+ Target PendingToolSettlementTarget

+ type PendingToolSettlementTarget struct

+ Handle string

+ RunID RunID

+ ThreadID ThreadID

+ ToolCallID string

+ ToolName string

+ TurnID TurnID

Jul 15, 2026

Changes in this version

type PendingToolSettlementResult

+ ProjectionAvailability TurnProjectionAvailability

type StreamObservation

+ func (s StreamObservation) Validate() error

type StreamObservationType

+ func (t StreamObservationType) Valid() bool

type ThreadTurnProjection

+ func (p ThreadTurnProjection) Validate() error

+ type TurnProjectionAvailability string

+ const TurnProjectionAvailabilityReady

+ const TurnProjectionAvailabilityUnavailable

+ func (a TurnProjectionAvailability) Valid() bool

type TurnResult

+ ProjectionAvailability TurnProjectionAvailability

type TurnStatus

+ const TurnStatusRunning

+ func (s TurnStatus) IsTerminal() bool

+ func (s TurnStatus) Valid() bool

Jul 15, 2026

Changes in this version

+ const CompletionReasonHookStop

+ const CompletionReasonNaturalStop

+ const CompletionReasonToolSignal

+ const ContinuationReasonCompaction

+ const ContinuationReasonHook

+ const ContinuationReasonNoProgress

+ const ContinuationReasonProviderTruncated

+ const ContinuationReasonRetryEmpty

+ const ContinuationReasonToolResults

+ const FinishReasonCancelled

+ const FinishReasonContentFilter

+ const FinishReasonError

+ const FinishReasonLength

+ const FinishReasonStop

+ const FinishReasonToolCalls

+ const FinishReasonUnknown

+ type CompletionReason = observation.CompletionReason

+ type ContinuationReason = observation.ContinuationReason

type Event

+ CompletionReason observation.CompletionReason

+ ContinuationReason observation.ContinuationReason

+ FinishInferred bool

+ RawFinishReason string

+ type FinishReason = observation.FinishReason

type HostOptions

+ ThreadTitleMode ThreadTitleMode

+ type ThreadTitleMode string

+ const ThreadTitleModeHostOwned

+ const ThreadTitleModeProvider

Jul 15, 2026

Changes in this version

+ var ErrForkDestinationConflict = errors.New("floret fork destination conflicts with operation plan")

+ var ErrForkOperationConflict = errors.New("floret fork operation conflicts with existing request")

+ var ErrForkOperationTargetMissing = errors.New("floret fork operation target is missing")

type Event

+ func (e Event) Validate() error

+ type ForkOperationID string

type ForkThreadRequest

+ OperationID ForkOperationID

type ForkThreadResult

+ OperationID ForkOperationID

type PendingToolSettlementResult

+ ProjectionError string

+ ProjectionStatus TurnProjectionStatus

+ func (r PendingToolSettlementResult) ValidateProjection() error

type ThreadTurnProjection

+ ProjectedAt time.Time

+ ThroughOrdinal int64

+ type TurnProjectionStatus string

+ const TurnProjectionStatusReady

+ const TurnProjectionStatusUnavailable

+ func (s TurnProjectionStatus) Valid() bool

type TurnResult

+ ProjectionError string

+ ProjectionStatus TurnProjectionStatus

+ func (r TurnResult) ValidateProjection() error

Jul 13, 2026

Changes in this version

type PendingApproval

+ BatchIndex int

+ BatchSize int

Jul 13, 2026

Changes in this version

+ var ErrTurnProjectionUnavailable = errors.New("floret turn projection unavailable")

type TurnLimits

+ MaxInputTokens int64

Jul 10, 2026

Changes in this version

type RunTurnRequest

+ SupplementalContext []TurnSupplementalContextItem

+ type TurnSupplementalContextItem struct

+ Kind string

+ Metadata map[string]string

+ Sensitive bool

+ Text string

+ Title string

+ Truncated bool

Jul 6, 2026

Changes in this version

+ type ForkThreadRequest struct

+ DestinationThreadID ThreadID

+ SourceThreadID ThreadID

+ type ForkThreadResult struct

+ Thread ThreadSummary

+ Turns []ForkedTurnRef

+ type ForkedTurnRef struct

+ CreatedAt time.Time

+ DestinationRunID RunID

+ DestinationTurnID TurnID

+ SourceRunID RunID

+ SourceTurnID TurnID

type Host

+ ForkThread func(context.Context, ForkThreadRequest) (ForkThreadResult, error)

type ThreadMaintenanceHost

+ ForkThread func(context.Context, ForkThreadRequest) (ForkThreadResult, error)

type ThreadTurnProjection

+ Status TurnStatus

Jul 3, 2026

Changes in this version

type SubAgentDetail

+ Context SubAgentDetailContext

+ type SubAgentDetailContext struct

+ Compactions []SubAgentDetailContextCompaction

+ Model SubAgentDetailContextModel

+ Policy SubAgentDetailContextPolicy

+ UpdatedAt time.Time

+ Usage *observation.ContextStatus

+ type SubAgentDetailContextCompaction struct

+ Error string

+ ObservedAt time.Time

+ OperationID string

+ Phase string

+ Reason string

+ RequestID string

+ RunID string

+ Source string

+ Status string

+ Step int

+ ThreadID string

+ TokensAfterEstimate int64

+ TokensBefore int64

+ Trigger string

+ TurnID string

+ type SubAgentDetailContextModel struct

+ Model string

+ Provider string

+ type SubAgentDetailContextPolicy struct

+ ContextWindowTokens int64

+ MaxOutputTokens int64

+ ReservedOutputTokens int64

type SubAgentDetailEvents

+ Context SubAgentDetailContext

Jul 2, 2026

Changes in this version

type SubAgentDetail

+ ActivityTimeline observation.ActivityTimeline

type SubAgentDetailEvents

+ ActivityTimeline observation.ActivityTimeline

Jul 1, 2026

Changes in this version

type SpawnSubAgentRequest

+ TaskDescription string

type SubAgentSnapshot

+ TaskDescription string

Jul 1, 2026

Changes in this version

type Event

+ Projection *ThreadTurnProjection

Jul 1, 2026

Changes in this version

type ThreadMaintenanceHost

+ ListSubAgentActivityTimeline func(context.Context, ListSubAgentActivityTimelineRequest) (SubAgentActivityTimelineResult, error)

+ ListSubAgentDetailEvents func(context.Context, ListSubAgentDetailEventsRequest) (SubAgentDetailEvents, error)

+ ListSubAgents func(context.Context, ThreadID) ([]SubAgentSnapshot, error)

+ ReadSubAgentDetail func(context.Context, ReadSubAgentDetailRequest) (SubAgentDetail, error)

Jul 1, 2026

Changes in this version

type HostOptions

+ ModelGatewayIdentity ModelGatewayIdentity

+ type ModelGatewayIdentity struct

+ Model string

+ Provider string

+ type ThreadMaintenanceHost interface

+ Close func() error

+ CloseSubAgents func(context.Context, CloseSubAgentsRequest) (CloseSubAgentsResult, error)

+ DeleteThread func(context.Context, ThreadID) error

+ EnsureThread func(context.Context, EnsureThreadRequest) (ThreadSummary, error)

+ ReadTurnProjection func(context.Context, ReadTurnProjectionRequest) (ThreadTurnProjection, error)

+ SettlePendingTool func(context.Context, PendingToolSettlementRequest) (PendingToolSettlementResult, error)

+ func NewThreadMaintenanceHost(opts ThreadMaintenanceHostOptions) (ThreadMaintenanceHost, error)

+ type ThreadMaintenanceHostOptions struct

+ Sink EventSink

+ Store *Store

Jun 30, 2026

Changes in this version

type LifecycleHost

+ ReadTurnProjection func(context.Context, ReadTurnProjectionRequest) (ThreadTurnProjection, error)

+ SettlePendingTool func(context.Context, PendingToolSettlementRequest) (PendingToolSettlementResult, error)

Jun 30, 2026

Changes in this version

+ var ErrRunNotFound = errors.New("floret run not found")

+ var ErrTurnNotFound = errors.New("floret turn not found")

type Host

+ ReadTurnProjection func(context.Context, ReadTurnProjectionRequest) (ThreadTurnProjection, error)

+ type LifecycleHost interface

+ Close func() error

+ CloseSubAgents func(context.Context, CloseSubAgentsRequest) (CloseSubAgentsResult, error)

+ DeleteThread func(context.Context, ThreadID) error

+ EnsureThread func(context.Context, EnsureThreadRequest) (ThreadSummary, error)

+ func NewLifecycleHost(opts LifecycleHostOptions) (LifecycleHost, error)

+ type LifecycleHostOptions struct

+ Sink EventSink

+ Store *Store

+ type ReadTurnProjectionRequest struct

+ RunID RunID

+ ThreadID ThreadID

+ TurnID TurnID

Jun 30, 2026

Changes in this version

type SubAgentDetailEventKind

+ const SubAgentDetailEventToolActivity

type ThreadDetailEventKind

+ const ThreadDetailEventToolActivity

Jun 30, 2026

Changes in this version

type SubAgentDetailEventKind

+ const SubAgentDetailEventToolDispatch

type ThreadDetailEventKind

+ const ThreadDetailEventToolDispatch

Jun 29, 2026

Changes in this version

type Event

+ ActivityTimeline *observation.ActivityTimeline

type ThreadDetailMessage

+ Activity *observation.ActivityPresentation

Jun 29, 2026

Changes in this version

type Host

+ SettlePendingTool func(context.Context, PendingToolSettlementRequest) (PendingToolSettlementResult, error)

+ type PendingToolSettlementRequest struct

+ Activity *observation.ActivityPresentation

+ Handle string

+ Output string

+ RunID RunID

+ Status PendingToolSettlementStatus

+ Summary string

+ ThreadID ThreadID

+ ToolCallID string

+ ToolName string

+ TurnID TurnID

+ type PendingToolSettlementResult struct

+ Event ThreadDetailEvent

+ Projection ThreadTurnProjection

+ RunID RunID

+ ThreadID ThreadID

+ TurnID TurnID

+ type PendingToolSettlementStatus string

+ const PendingToolSettlementCanceled

+ const PendingToolSettlementCompleted

+ const PendingToolSettlementFailed

Jun 29, 2026

Changes in this version

+ var ErrSubAgentNotFound = errors.New("floret subagent not found")

+ var ErrThreadNotFound = errors.New("floret thread not found")

Jun 28, 2026

Changes in this version

+ type ProjectThreadTurnRequest struct

+ ActivityTimeline observation.ActivityTimeline

+ Events []ThreadDetailEvent

+ RunID RunID

+ ThreadID ThreadID

+ TraceID TraceID

+ TurnID TurnID

type SubAgentDetailMessage

+ Kind string

type ThreadDetailMessage

+ Kind string

+ type ThreadTurnProjection struct

+ Projected time.Time

+ RunID RunID

+ Segments []ThreadTurnProjectionSegment

+ ThreadID ThreadID

+ TraceID TraceID

+ TurnID TurnID

+ func ProjectThreadTurn(req ProjectThreadTurnRequest) ThreadTurnProjection

+ type ThreadTurnProjectionSegment struct

+ ActivityTimeline *observation.ActivityTimeline

+ EventIDs []string

+ Kind ThreadTurnProjectionSegmentKind

+ Signal *ThreadTurnProjectionSignal

+ Text string

+ type ThreadTurnProjectionSegmentKind string

+ const ThreadTurnProjectionSegmentActivityTimeline

+ const ThreadTurnProjectionSegmentAssistantText

+ const ThreadTurnProjectionSegmentControlSignal

+ type ThreadTurnProjectionSignal struct

+ CallID string

+ Name string

+ Text string

type TurnResult

+ Projection ThreadTurnProjection

Jun 28, 2026

Changes in this version

type RunTurnRequest

+ RunID RunID

type TurnResult

+ RunID RunID

Jun 28, 2026

Changes in this version

type SubAgentDetailEvent

+ ActivityTimeline *observation.ActivityTimeline

type SubAgentDetailToolResult

+ Status string

type ThreadDetailEvent

+ ActivityTimeline *observation.ActivityTimeline

type ThreadDetailToolResult

+ Status string

Jun 28, 2026

Changes in this version

type Host

+ ListPendingApprovals func(context.Context, ListPendingApprovalsRequest) (PendingApprovals, error)

+ type ListPendingApprovalsRequest struct

+ ThreadID ThreadID

+ type PendingApproval struct

+ ApprovalID string

+ ArgsHash string

+ Destructive bool

+ Effects []string

+ Epoch int64

+ HostContext map[string]string

+ Labels map[string]string

+ OpenWorld bool

+ ReadOnly bool

+ Reason string

+ RequestedAt time.Time

+ ResolvedAt time.Time

+ Resources []PendingApprovalResource

+ Revision int64

+ RunID RunID

+ State string

+ Step int

+ ThreadID ThreadID

+ ToolCallID string

+ ToolKind string

+ ToolName string

+ TurnID TurnID

+ type PendingApprovalResource struct

+ Kind string

+ Value string

+ type PendingApprovals struct

+ Approvals []PendingApproval

+ GeneratedAt time.Time

+ ThreadID ThreadID

type TurnResult

+ PendingApprovals []PendingApproval

Jun 28, 2026

Changes in this version

type CloseSubAgentRequest

+ Reason string

+ type CloseSubAgentsRequest struct

+ ParentThreadID ThreadID

+ Reason string

+ type CloseSubAgentsResult struct

+ Closed int

+ Snapshots []SubAgentSnapshot

type Host

+ CloseSubAgents func(context.Context, CloseSubAgentsRequest) (CloseSubAgentsResult, error)

type SubAgentSnapshot

+ ForkMode SubAgentForkMode

Jun 28, 2026

Changes in this version

+ type EnsureThreadRequest struct

+ ThreadID ThreadID

type Host

+ EnsureThread func(context.Context, EnsureThreadRequest) (ThreadSummary, error)

+ ListSubAgentActivityTimeline func(context.Context, ListSubAgentActivityTimelineRequest) (SubAgentActivityTimelineResult, error)

+ type ListSubAgentActivityTimelineRequest struct

+ Meta observation.ActivityRunMeta

+ ParentThreadID ThreadID

+ type SubAgentActivityTimelineResult struct

+ GeneratedAt time.Time

+ Timeline observation.ActivityTimeline

+ type ThreadSummary struct

+ CanAppendMessage bool

+ CanRetry bool

+ CreatedAt time.Time

+ ID ThreadID

+ LatestTurnID TurnID

+ Phase ThreadPhase

+ Recoverable bool

+ Status ThreadStatus

+ Title string

+ TitleError string

+ TitleSource string

+ TitleStatus string

+ TitleUpdatedAt time.Time

+ UpdatedAt time.Time

+ WaitingPrompt string

Jun 27, 2026

Changes in this version

type Event

+ Committed *ThreadDetailEvent

type Host

+ ListThreadDetailEvents func(context.Context, ListThreadDetailEventsRequest) (ThreadDetailEvents, error)

+ type ListThreadDetailEventsRequest struct

+ AfterOrdinal int64

+ IncludeRaw bool

+ Limit int

+ ThreadID ThreadID

+ type ThreadDetailApproval struct

+ ArgsHash string

+ Metadata map[string]string

+ Reason string

+ State string

+ ToolID string

+ ToolKind string

+ ToolName string

+ type ThreadDetailCompaction struct

+ CompactedThroughEntryID string

+ CompactionGeneration int

+ CompactionID string

+ CompactionWindowID string

+ FirstKeptEntryID string

+ KeptUserEntryIDs []string

+ Metadata map[string]string

+ Phase string

+ PreviousCompactionID string

+ Reason string

+ Summary string

+ SummarySchemaVersion string

+ TokensAfterEstimate int64

+ TokensBefore int64

+ Trigger string

+ type ThreadDetailEvent struct

+ Approval *ThreadDetailApproval

+ Compaction *ThreadDetailCompaction

+ CreatedAt time.Time

+ Error string

+ ID string

+ Kind ThreadDetailEventKind

+ Message *ThreadDetailMessage

+ Metadata map[string]string

+ Ordinal int64

+ ParentID string

+ ThreadID ThreadID

+ ToolCall *ThreadDetailToolCall

+ ToolResult *ThreadDetailToolResult

+ TurnID TurnID

+ TurnMarker *ThreadDetailTurnMarker

+ Type string

+ type ThreadDetailEventKind string

+ const ThreadDetailEventApproval

+ const ThreadDetailEventAssistantMessage

+ const ThreadDetailEventCompaction

+ const ThreadDetailEventCustom

+ const ThreadDetailEventError

+ const ThreadDetailEventInput

+ const ThreadDetailEventToolCall

+ const ThreadDetailEventToolResult

+ const ThreadDetailEventTurnMarker

+ const ThreadDetailEventUserMessage

+ type ThreadDetailEvents struct

+ Events []ThreadDetailEvent

+ GeneratedAt time.Time

+ HasMore bool

+ NextOrdinal int64

+ RetainedFrom int64

+ type ThreadDetailMessage struct

+ Content string

+ Preview string

+ Reasoning string

+ Role string

+ type ThreadDetailToolCall struct

+ ArgsHash string

+ ArgsJSON string

+ ArgsPreview string

+ ID string

+ Name string

+ type ThreadDetailToolResult struct

+ CallID string

+ Content string

+ ContentSHA256 string

+ FullOutput *ArtifactRef

+ OriginalBytes int

+ OriginalLines int

+ Preview string

+ Strategy string

+ ToolName string

+ Truncated bool

+ VisibleBytes int

+ VisibleLines int

+ type ThreadDetailTurnMarker struct

+ Metadata map[string]string

+ Status string

Jun 27, 2026

Changes in this version

type HostOptions

+ ToolSurfaceProvider ToolSurfaceProvider

+ type HostedToolDefinition struct

+ Description string

+ Name string

+ Options map[string]any

+ Parameters map[string]any

+ Type string

type ModelRequest

+ HostedTools []HostedToolDefinition

type RunTurnRequest

+ ToolSurfaceProvider ToolSurfaceProvider

+ type ToolSurface struct

+ Epoch string

+ HostContext map[string]string

+ HostedToolDefinitions []HostedToolDefinition

+ Reason string

+ SystemPrompt string

+ ToolDefinitions []tools.ToolDefinition

+ Tools *tools.Registry

+ type ToolSurfaceProvider func(context.Context, ToolSurfaceRequest) (ToolSurface, error)

+ type ToolSurfaceRequest struct

+ HostContext map[string]string

+ Labels RunLabels

+ Phase string

+ PromptScopeID PromptScopeID

+ RunID RunID

+ Step int

+ ThreadID ThreadID

+ TraceID TraceID

+ TurnID TurnID

Jun 26, 2026

Changes in this version

+ type CompactThreadRequest struct

+ Labels RunLabels

+ Limits TurnLimits

+ PreviousProviderState *ModelState

+ Reasoning ReasoningSelection

+ RequestID string

+ Source string

+ ThreadID ThreadID

+ type CompactThreadResult struct

+ ActivityTimeline observation.ActivityTimeline

+ Diagnostics map[string]string

+ Error string

+ Metrics RunMetrics

+ ProviderState *ModelState

+ Status string

+ ThreadID ThreadID

type Host

+ CompactThread func(context.Context, CompactThreadRequest) (CompactThreadResult, error)

type RunTurnRequest

+ Completion TurnCompletionPolicy

+ Limits TurnLimits

+ ManualCompactions ManualCompactionSource

+ PreviousProviderState *ModelState

+ Reasoning ReasoningSelection

+ Signals TurnSignalSpec

type TurnResult

+ ActivityTimeline observation.ActivityTimeline

+ Metrics RunMetrics

+ ProviderState *ModelState

+ Signal *TurnSignal

Jun 25, 2026

Changes in this version

+ func ManualCompactionOperationID(runID RunID, step int, requestID string) string

Jun 25, 2026

Changes in this version

type Event

+ CompactionDebug *observation.CompactionDebugEvent

Jun 24, 2026

Changes in this version

+ const TranscriptMessageKindCompactionSummary

+ type ManualCompactionPollRequest struct

+ PromptScopeID PromptScopeID

+ RunID RunID

+ Step int

+ ThreadID ThreadID

+ TraceID TraceID

+ TurnID TurnID

+ type ManualCompactionRequest struct

+ RequestID string

+ RequestedAt time.Time

+ Source string

+ type ManualCompactionSource interface

+ PollManualCompaction func(context.Context, ManualCompactionPollRequest) (ManualCompactionRequest, bool, error)

+ type ProjectedContextCompaction struct

+ CompactedThroughEntryID string

+ CompactionGeneration int

+ CompactionID string

+ CompactionWindowID string

+ CreatedAt time.Time

+ Details map[string]string

+ FirstKeptEntryID string

+ KeptUserEntryIDs []string

+ OperationID string

+ Phase string

+ PreviousCompactionID string

+ Reason string

+ RequestID string

+ Source string

+ Summary string

+ SummarySchemaVersion string

+ TokensAfterEstimate int64

+ TokensBefore int64

+ Trigger string

+ UsageAfter config.ContextUsage

+ UsageBefore config.ContextUsage

+ type ProjectedContextCompactionRequest struct

+ History []TranscriptMessage

+ Labels RunLabels

+ ManualCompaction ManualCompactionRequest

+ PreviousProviderState *ModelState

+ PromptScopeID PromptScopeID

+ Reasoning ReasoningSelection

+ RunID RunID

+ ThreadID ThreadID

+ TraceID TraceID

+ TurnID TurnID

+ type ProjectedContextCompactionResult struct

+ ActiveTranscript []TranscriptMessage

+ ActivityTimeline observation.ActivityTimeline

+ Compaction *ProjectedContextCompaction

+ Error string

+ Metrics RunMetrics

+ ProviderState *ModelState

+ RunID RunID

+ Status string

+ ThreadID ThreadID

+ TurnID TurnID

+ func CompactProjectedContext(ctx context.Context, opts ProjectedTurnOptions, ...) (ProjectedContextCompactionResult, error)

type ProjectedTurnOptions

+ ManualCompactions ManualCompactionSource

type TranscriptMessage

+ CompactionGeneration int

+ CompactionID string

+ CompactionWindowID string

+ EntryID string

+ Kind string

+ ParentEntryID string

Jun 24, 2026

Changes in this version

type SubAgentDetailMessage

+ Preview string

type SubAgentDetailToolCall

+ ArgsPreview string

type SubAgentDetailToolResult

+ Preview string

Jun 24, 2026

Changes in this version

+ type ArtifactRef struct

+ ID string

+ Kind string

+ MIME string

+ SHA256 string

+ SafeLabel string

+ SizeBytes int64

+ URL string

type Host

+ ListSubAgentDetailEvents func(context.Context, ListSubAgentDetailEventsRequest) (SubAgentDetailEvents, error)

+ ReadSubAgentDetail func(context.Context, ReadSubAgentDetailRequest) (SubAgentDetail, error)

type HostOptions

+ SubAgentRunTimeout time.Duration

+ type ListSubAgentDetailEventsRequest struct

+ AfterOrdinal int64

+ ChildThreadID ThreadID

+ IncludeRaw bool

+ Limit int

+ ParentThreadID ThreadID

+ type ReadSubAgentDetailRequest struct

+ AfterOrdinal int64

+ ChildThreadID ThreadID

+ IncludeRaw bool

+ Limit int

+ ParentThreadID ThreadID

+ type SubAgentDetail struct

+ Events []SubAgentDetailEvent

+ GeneratedAt time.Time

+ HasMore bool

+ NextOrdinal int64

+ RetainedFrom int64

+ Snapshot SubAgentSnapshot

+ type SubAgentDetailApproval struct

+ ArgsHash string

+ Metadata map[string]string

+ Reason string

+ State string

+ ToolID string

+ ToolKind string

+ ToolName string

+ type SubAgentDetailCompaction struct

+ CompactedThroughEntryID string

+ CompactionGeneration int

+ CompactionID string

+ CompactionWindowID string

+ FirstKeptEntryID string

+ KeptUserEntryIDs []string

+ Metadata map[string]string

+ Phase string

+ PreviousCompactionID string

+ Reason string

+ Summary string

+ SummarySchemaVersion string

+ TokensAfterEstimate int64

+ TokensBefore int64

+ Trigger string

+ type SubAgentDetailEvent struct

+ Approval *SubAgentDetailApproval

+ Compaction *SubAgentDetailCompaction

+ CreatedAt time.Time

+ Error string

+ ID string

+ Kind SubAgentDetailEventKind

+ Message *SubAgentDetailMessage

+ Metadata map[string]string

+ Ordinal int64

+ ParentID string

+ ThreadID ThreadID

+ ToolCall *SubAgentDetailToolCall

+ ToolResult *SubAgentDetailToolResult

+ TurnID TurnID

+ TurnMarker *SubAgentDetailTurnMarker

+ Type string

+ type SubAgentDetailEventKind string

+ const SubAgentDetailEventApproval

+ const SubAgentDetailEventAssistantMessage

+ const SubAgentDetailEventCompaction

+ const SubAgentDetailEventCustom

+ const SubAgentDetailEventError

+ const SubAgentDetailEventInput

+ const SubAgentDetailEventToolCall

+ const SubAgentDetailEventToolResult

+ const SubAgentDetailEventTurnMarker

+ const SubAgentDetailEventUserMessage

+ type SubAgentDetailEvents struct

+ Events []SubAgentDetailEvent

+ GeneratedAt time.Time

+ HasMore bool

+ NextOrdinal int64

+ RetainedFrom int64

+ type SubAgentDetailMessage struct

+ Content string

+ Reasoning string

+ Role string

+ type SubAgentDetailToolCall struct

+ ArgsHash string

+ ArgsJSON string

+ ID string

+ Name string

+ type SubAgentDetailToolResult struct

+ CallID string

+ Content string

+ ContentSHA256 string

+ FullOutput *ArtifactRef

+ OriginalBytes int

+ OriginalLines int

+ Strategy string

+ ToolName string

+ Truncated bool

+ VisibleBytes int

+ VisibleLines int

+ type SubAgentDetailTurnMarker struct

+ Metadata map[string]string

+ Status string

Jun 23, 2026

Changes in this version

type Event

+ Compaction *observation.CompactionEvent

+ ContextStatus *observation.ContextStatus

+ type ProjectedCompactionSummaryRequest struct

+ CompactedHead []TranscriptMessage

+ ContextUsage config.ContextUsage

+ Details map[string]string

+ History []TranscriptMessage

+ Phase string

+ Policy config.ContextPolicy

+ PreviousCompactionID string

+ PreviousSummary string

+ PromptScopeID PromptScopeID

+ Reason string

+ RetainedTail []TranscriptMessage

+ RunID RunID

+ Step int

+ ThreadID ThreadID

+ TraceID TraceID

+ Trigger string

+ TurnID TurnID

+ type ProjectedCompactionSummaryResult struct

+ Details map[string]string

+ Summary string

+ type ProjectedTurnCompactionSummarizer interface

+ GenerateCompactionSummary func(context.Context, ProjectedCompactionSummaryRequest) (ProjectedCompactionSummaryResult, error)

type ProjectedTurnOptions

+ CompactionSummarizer ProjectedTurnCompactionSummarizer

Jun 23, 2026

Changes in this version

+ const ReasoningLevelDefault

+ const ReasoningLevelHigh

+ const ReasoningLevelLow

+ const ReasoningLevelMax

+ const ReasoningLevelMedium

+ const ReasoningLevelMinimal

+ const ReasoningLevelOff

+ const ReasoningLevelXHigh

type ModelRequest

+ Reasoning ReasoningSelection

type ProjectedTurnRequest

+ Reasoning ReasoningSelection

+ type ReasoningBudget = config.ReasoningBudget

+ type ReasoningCapability = config.ReasoningCapability

+ type ReasoningLevel = config.ReasoningLevel

+ type ReasoningSelection = config.ReasoningSelection

Jun 23, 2026

Changes in this version

type HostOptions

+ ModelGateway ModelGateway

Jun 23, 2026

Changes in this version

+ type CloseSubAgentRequest struct

+ ChildThreadID ThreadID

+ ParentThreadID ThreadID

type Host

+ CloseSubAgent func(context.Context, CloseSubAgentRequest) (SubAgentSnapshot, error)

+ ListSubAgents func(context.Context, ThreadID) ([]SubAgentSnapshot, error)

+ SendSubAgentInput func(context.Context, SendSubAgentInputRequest) (SubAgentSnapshot, error)

+ SpawnSubAgent func(context.Context, SpawnSubAgentRequest) (SubAgentSnapshot, error)

+ WaitSubAgents func(context.Context, WaitSubAgentsRequest) (WaitSubAgentsResult, error)

+ type SendSubAgentInputRequest struct

+ ChildThreadID ThreadID

+ Interrupt bool

+ Labels RunLabels

+ Message string

+ ParentThreadID ThreadID

+ type SpawnSubAgentRequest struct

+ ForkMode SubAgentForkMode

+ HostProfileRef string

+ Labels RunLabels

+ Message string

+ ParentThreadID ThreadID

+ ParentTurnID TurnID

+ TaskName string

+ ThreadID ThreadID

+ type SubAgentForkMode string

+ const SubAgentForkFullPath

+ const SubAgentForkNone

+ type SubAgentSnapshot struct

+ CanClose bool

+ CanInterrupt bool

+ CanSendInput bool

+ Closed bool

+ CreatedAt time.Time

+ HostProfileRef string

+ LastMessage string

+ LatestTurnID TurnID

+ ParentThreadID ThreadID

+ ParentTurnID TurnID

+ Path string

+ QueuedInputs int

+ Status SubAgentStatus

+ TaskName string

+ ThreadID ThreadID

+ UpdatedAt time.Time

+ WaitingPrompt string

+ type SubAgentStatus string

+ const SubAgentStatusCancelled

+ const SubAgentStatusClosed

+ const SubAgentStatusCompleted

+ const SubAgentStatusFailed

+ const SubAgentStatusIdle

+ const SubAgentStatusInterrupted

+ const SubAgentStatusRunning

+ const SubAgentStatusWaiting

+ type WaitSubAgentsRequest struct

+ ChildThreadIDs []ThreadID

+ ParentThreadID ThreadID

+ Timeout time.Duration

+ type WaitSubAgentsResult struct

+ Snapshots []SubAgentSnapshot

+ TimedOut bool

Jun 22, 2026

Changes in this version

type ModelEvent

+ ToolCallStream *ModelToolCallStream

type ModelEventType

+ const ModelEventToolCallDelta

+ const ModelEventToolCallEnd

+ const ModelEventToolCallStart

+ type ModelToolCallStream struct

+ ID string

+ Name string

type StreamObservation

+ ToolCallStream *ModelToolCallStream

type StreamObservationType

+ const StreamObservationToolCallDelta

+ const StreamObservationToolCallEnd

+ const StreamObservationToolCallStart

Jun 19, 2026

Changes in this version

type Event

+ Sources []SourceRef

type ModelEvent

+ Sources []SourceRef

type ModelEventType

+ const ModelEventSources

+ type SourceRef struct

+ Title string

+ URL string

Jun 19, 2026

Changes in this version

type ProjectedTurnResult

+ ProviderState *ModelState

Jun 19, 2026

Changes in this version

+ const CoreControlAskUser

+ const CoreControlTaskComplete

+ func CoreControlDefinitions(includeTaskComplete bool) []tools.ToolDefinition

+ func ProviderSafeCoreControlText(signal TurnSignal) string

type Event

+ Stream *StreamObservation

type Host

+ CompletePendingTool func(context.Context, PendingToolCompletionRequest) (TurnResult, error)

+ type PendingToolCompletionRequest struct

+ Handle string

+ Labels RunLabels

+ Output string

+ RunID RunID

+ Status PendingToolCompletionStatus

+ Summary string

+ ThreadID ThreadID

+ ToolCallID string

+ ToolName string

+ TurnID TurnID

+ type PendingToolCompletionStatus string

+ const PendingToolCompletionCanceled

+ const PendingToolCompletionCompleted

+ const PendingToolCompletionFailed

+ type StreamObservation struct

+ Attempt int

+ FinishInferred bool

+ FinishReason string

+ Labels RunLabels

+ RawFinishReason string

+ Reason string

+ Text string

+ Type StreamObservationType

+ type StreamObservationType string

+ const StreamObservationAssistantDelta

+ const StreamObservationModelRetry

+ const StreamObservationModelStreamAbort

+ const StreamObservationModelStreamDone

+ const StreamObservationReasoningDelta

type TurnSignal

+ func ProjectCoreControlSignal(call tools.ToolCall) (TurnSignal, bool, error)

Jun 14, 2026

Changes in this version

type Event

+ Activity *observation.ActivityPresentation

type TurnSignal

+ Activity *observation.ActivityPresentation

Jun 13, 2026

Changes in this version

type Event

+ DurationMS int64

type ProjectedTurnResult

+ ActivityTimeline observation.ActivityTimeline

Jun 11, 2026

Changes in this version

type ProjectedTurnRequest

+ PreviousProviderState *ModelState

Jun 11, 2026

Changes in this version

+ type ModelEvent struct

+ Err error

+ Reason string

+ ResponseID string

+ ResponseState *ModelState

+ Text string

+ ToolCalls []tools.ToolCall

+ Type ModelEventType

+ Usage ProviderUsage

+ type ModelEventType string

+ const ModelEventDelta

+ const ModelEventDone

+ const ModelEventEmpty

+ const ModelEventError

+ const ModelEventReasoning

+ const ModelEventToolCalls

+ const ModelEventTruncated

+ const ModelEventUsage

+ type ModelGateway interface

+ StreamModel func(context.Context, ModelRequest) (<-chan ModelEvent, error)

+ type ModelMessage struct

+ Content string

+ Reasoning string

+ Role string

+ ToolArgs string

+ ToolCallID string

+ ToolName string

+ type ModelRequest struct

+ DisableReasoning bool

+ Labels RunLabels

+ MaxOutputTokens int64

+ Messages []ModelMessage

+ Model string

+ PreviousState *ModelState

+ PromptScopeID PromptScopeID

+ Provider string

+ RunID RunID

+ Step int

+ ThreadID ThreadID

+ Tools []tools.ToolDefinition

+ TraceID TraceID

+ TurnID TurnID

+ type ModelState struct

+ Attributes map[string]string

+ ID string

+ Kind string

+ type ProjectedTurnOptions struct

+ Approver tools.Approver

+ Capabilities CapabilityOptions

+ Config config.Config

+ LoopLimits LoopLimits

+ ModelGateway ModelGateway

+ Sink EventSink

+ Store *Store

+ Tools *tools.Registry

+ type ProjectedTurnRequest struct

+ Completion TurnCompletionPolicy

+ History []TranscriptMessage

+ Labels RunLabels

+ Limits TurnLimits

+ PromptScopeID PromptScopeID

+ RunID RunID

+ Signals TurnSignalSpec

+ ThreadID ThreadID

+ TraceID TraceID

+ TurnID TurnID

+ type ProjectedTurnResult struct

+ CompletionReason string

+ ContinuationReason string

+ Error string

+ FinishInferred bool

+ FinishReason string

+ Metrics RunMetrics

+ Output string

+ RawFinishReason string

+ RunID RunID

+ Signal *TurnSignal

+ Status TurnStatus

+ ThreadID ThreadID

+ Transcript []TranscriptMessage

+ TurnID TurnID

+ func RunProjectedTurn(ctx context.Context, opts ProjectedTurnOptions, req ProjectedTurnRequest) (ProjectedTurnResult, error)

+ type ProviderUsage struct

+ Available bool

+ CacheReadTokens int64

+ CacheWriteTokens int64

+ CostUSD float64

+ InputTokens int64

+ OutputTokens int64

+ ReasoningTokens int64

+ Source string

+ TotalTokens int64

+ WindowInputTokens int64

+ type RunMetrics struct

+ Compactions int

+ LLMRequests int

+ ProviderUsage ProviderUsage

+ Retries int

+ Steps int

+ ToolCalls int

+ WallTimeMS int64

+ type SignalDisposition string

+ const SignalContinue

+ const SignalTerminal

+ const SignalWaiting

+ type TranscriptMessage struct

+ Content string

+ Reasoning string

+ Role string

+ ToolArgs string

+ ToolCallID string

+ ToolName string

+ type TurnCompletionPolicy string

+ const TurnCompletionExplicitSignal

+ const TurnCompletionNaturalStop

+ type TurnLimits struct

+ MaxCostUSD float64

+ MaxLengthContinuations int

+ MaxStopHookContinuations int

+ MaxToolCalls int

+ MaxTotalTokens int64

+ type TurnSignal struct

+ ArgsHash string

+ CallID string

+ Disposition SignalDisposition

+ Labels map[string]string

+ Name string

+ OutputText string

+ Payload map[string]any

+ type TurnSignalSpec struct

+ Definitions []tools.ToolDefinition

+ Project func(tools.ToolCall) (TurnSignal, bool, error)

Jun 11, 2026

Changes in this version

+ type Event struct

+ ArgsHash string

+ Error string

+ FinishReason string

+ Message string

+ Metadata map[string]any

+ Model string

+ Provider string

+ Result string

+ RunID RunID

+ Step int

+ ThreadID ThreadID

+ Timestamp time.Time

+ ToolID string

+ ToolKind string

+ ToolName string

+ TraceID TraceID

+ TurnID TurnID

+ Type string

+ type EventSink interface

+ EmitEvent func(Event)

+ type Host interface

+ Close func() error

+ DeleteThread func(context.Context, ThreadID) error

+ ReadThread func(context.Context, ThreadID) (ThreadSnapshot, error)

+ RetryTurn func(context.Context, RetryTurnRequest) (TurnResult, error)

+ RunTurn func(context.Context, RunTurnRequest) (TurnResult, error)

+ StartThread func(context.Context, StartThreadRequest) (ThreadSnapshot, error)

+ func NewHost(opts HostOptions) (Host, error)

+ type HostOptions struct

+ Approver tools.Approver

+ Capabilities CapabilityOptions

+ Config config.Config

+ IDGenerator func(string) string

+ LoopLimits LoopLimits

+ Sink EventSink

+ Store *Store

+ Tools *tools.Registry

+ type LoopLimits struct

+ DuplicateToolLimit int

+ MaxEmptyProviderRetries int

+ NoProgressLimit int

+ WallTime time.Duration

+ type PromptScopeID string

+ type RetryTurnRequest struct

+ Labels RunLabels

+ Reason string

+ ThreadID ThreadID

+ type RunID string

+ type RunLabels struct

+ Correlation map[string]string

+ Host map[string]string

+ type RunTurnRequest struct

+ Input string

+ Labels RunLabels

+ ThreadID ThreadID

+ TurnID TurnID

+ type StartThreadRequest struct

+ ThreadID ThreadID

+ type Store struct

+ func NewMemoryStore() *Store

+ func OpenSQLiteStore(path string) (*Store, error)

+ func (s *Store) Close() error

+ type ThreadID string

+ type ThreadMessage struct

+ Content string

+ CreatedAt time.Time

+ Role string

+ TurnID TurnID

+ type ThreadPhase string

+ const ThreadPhaseIdle

+ const ThreadPhaseTurn

+ type ThreadSnapshot struct

+ CanAppendMessage bool

+ CanRetry bool

+ CreatedAt time.Time

+ ID ThreadID

+ LatestTurnID TurnID

+ Messages []ThreadMessage

+ Phase ThreadPhase

+ Recoverable bool

+ Status ThreadStatus

+ Title string

+ TitleError string

+ TitleSource string

+ TitleStatus string

+ TitleUpdatedAt time.Time

+ UpdatedAt time.Time

+ WaitingPrompt string

+ type ThreadStatus string

+ const ThreadStatusCancelled

+ const ThreadStatusCompleted

+ const ThreadStatusFailed

+ const ThreadStatusIdle

+ const ThreadStatusInterrupted

+ const ThreadStatusRunning

+ const ThreadStatusWaiting

+ type TraceID string

+ type TurnID string

+ type TurnResult struct

+ CompletionReason string

+ ContinuationReason string

+ Diagnostics map[string]string

+ Error string

+ FinishInferred bool

+ FinishReason string

+ ID TurnID

+ Output string

+ RawFinishReason string

+ Status TurnStatus

+ type TurnStatus string

+ const TurnStatusCancelled

+ const TurnStatusCompleted

+ const TurnStatusFailed

+ const TurnStatusWaiting

Jun 11, 2026

Changes in this version

type HarnessOptions

+ TitleGenerator agentharness.TitleGenerator

Jun 10, 2026

Changes in this version

+ func NewEngine(cfg config.Config, store session.Store, registry *tools.Registry) (*engine.Engine, error)

+ func NewEngineWithProvider(cfg config.Config, p provider.Provider, store session.Store, ...) (*engine.Engine, error)

+ func NewHarness(cfg config.Config, opts HarnessOptions) (*agentharness.AgentHarness, error)

+ func NewHarnessWithProvider(cfg config.Config, p provider.Provider, opts HarnessOptions) *agentharness.AgentHarness

+ func NewHarnessWithProviderE(cfg config.Config, p provider.Provider, opts HarnessOptions) (*agentharness.AgentHarness, error)

+ type CapabilityOptions struct

+ MCPManager *mcp.Manager

+ MCPServers []mcp.ServerConfig

+ SkillPromptBudgetBytes int

+ SkillSources []skills.Source

+ SkillsEnabled bool

+ type HarnessOptions struct

+ Approver tools.Approver

+ Artifacts artifact.Store

+ Capability CapabilityOptions

+ CompactionPrompt compaction.PromptOptions

+ LoopLimits agentharness.LoopLimits

+ NewID func(string) string

+ PromptStore cache.Store

+ Sink event.Sink

+ StopHook engine.StopHook

+ Store sessiontree.Repo

+ Tools *tools.Registry

+ TurnPolicy agentharness.TurnPolicy