Versions in this module Expand all Collapse all v1 v1.0.5 Aug 22, 2026 v1.0.4 Aug 22, 2026 Changes in this version + const AccountTypeChatGPT + const AdapterCodexSubscription + const ApprovalPolicyNever + const AuthorityChatSubscriptionIsolatedV1 + const MaxGroupAgentMessages + const MaxGroupAgents + const MaxGroupHandoffDepth + const MaxHandoffContextReferences + const MinGroupAgents + const PolicyCodexSubscriptionChatV1 + const ResourcePolicyDenyAndFail + const RoutineApprovalBeforeExternalSideEffect + const RoutineApprovalNone + const RoutineLatenessNone + const RoutineLatenessWithin90Seconds + const RoutineTriggerEvent + const RoutineTriggerSchedule + const RuntimeContractCodexSubscriptionExecV1 + const SandboxModeReadOnly + const ThreadModeEphemeral + const ToolsModeNone + const UnknownProviderIdentity + const UsageSourceCodexExecJSONL + const WorkdirModeEmptyPerTarget + var ErrConversationActive = errors.New("conversation has active targets") + var ErrGroupNeedsYou = errors.New("Group Turn needs human attention") + var ErrHandoffNeedsYou = errors.New("Handoff needs human attention") + func AgentChannelID(binding AgentBinding) (string, error) + func NewBoundedError(code ErrorCode, err error) error + func ValidateAgentRevisionSet(agent Agent, profile AgentProfileRevision, behavior AgentBehaviorRevision, ...) error + func ValidateContextManifest(accountID string, rootGrant AuthorityGrant, manifest ContextManifest) error + func ValidateRoutineSchedule(expression, timezone string) error + type Agent struct + AccountID string + CanonicalConversationID string + CreatedAt time.Time + CurrentBehaviorRevisionID string + CurrentBindingRevisionID string + CurrentProfileRevisionID string + ID string + State AgentState + func (a Agent) Validate() error + type AgentAuthoritySnapshot struct + AdapterID string + AdapterRevision string + Authority string + ExecutionPolicy map[string]string + MemoryMode string + PolicyID string + PolicyRevision string + RequestedModel string + ResolvedModel string + RuntimeContract string + SessionMode string + type AgentBehaviorRevision struct + AgentID string + CreatedAt time.Time + EnabledSkills []string + EnabledTools []string + ID string + PromptMaterial string + Revision int + Role string + StandingInstructions string + func (r AgentBehaviorRevision) Validate() error + type AgentBinding struct + Authority AgentAuthoritySnapshot + Seat AgentSeatIdentity + func (binding AgentBinding) Validate() error + type AgentBindingRevision struct + ActivatedAt time.Time + AdapterID string + AdapterRevision string + AgentID string + AuthorityID string + AuthorityRevision string + BehaviorRevisionID string + CapabilityEvidence []string + CloudRuntime string + ComputerID string + ExecutionSourceID string + FortProfile string + ID string + MemoryBehavior string + PolicyID string + PolicyRevision string + Provider string + ReadinessContractID string + ReadinessContractRevision string + RequestedModel string + ResolvedModel string + RetiredAt time.Time + Revision int + SeatID string + SessionBehavior string + SourceAgentID string + SourceConfigDigest string + SupersedesRevisionID string + func (r AgentBindingRevision) Validate() error + type AgentChannel struct + Binding AgentBinding + CreatedAt time.Time + ID string + Name string + OptionID string + State AgentChannelState + func (channel AgentChannel) Validate() error + type AgentChannelConversation struct + AgentChannelID string + ConversationID string + CreatedAt time.Time + type AgentChannelDetail struct + Channel AgentChannel + Conversations []AgentConversationSummary + type AgentChannelState string + const AgentChannelArchived + const AgentChannelOpen + const AgentMemoryEphemeral + type AgentConversation struct + AgentID string + ConversationID string + CreatedAt time.Time + Kind AgentConversationKind + func (c AgentConversation) Validate() error + type AgentConversationKind string + const AgentConversationCanonical + const AgentConversationSecondary + type AgentConversationPin struct + ConversationID string + PinnedAt time.Time + type AgentConversationSummary struct + Conversation Conversation + Participant Participant + Pinned bool + PinnedAt time.Time + type AgentProfileRevision struct + AgentID string + AvatarURL string + CreatedAt time.Time + Hidden bool + ID string + Name string + Pinned bool + Revision int + SortOrder int + Title string + func (r AgentProfileRevision) Validate() error + type AgentSeatIdentity struct + Agent string + ID string + Machine string + Model string + Profile string + type AgentState string + const AgentArchived + const AgentOpen + type AuthorityGrant struct + ContextRecordIDs []string + ID string + Permissions []string + func ComputeEffectiveAuthority(requested []string, layers ...AuthorityGrant) (AuthorityGrant, error) + func (g AuthorityGrant) Validate() error + type BoundedError struct + Code ErrorCode + Err error + func (e *BoundedError) Error() string + func (e *BoundedError) Unwrap() error + type ContextManifest struct + References []ContextReference + type ContextReference struct + AccountID string + Digest string + Finalized bool + ID string + Immutable bool + Kind ContextReferenceKind + ObservedDigest string + ObservedSize int64 + Size int64 + func (r ContextReference) Key() string + type ContextReferenceKind string + const ContextArtifact + const ContextMessage + const ContextOutputArtifact + type ErrorCode string + const ErrorConversationActive + const ErrorParticipantRemoved + const ErrorParticipantUnknown + const ErrorSeatUnknown + const ErrorSeatUnready + type ExecutionSource struct + AccountID string + DisplayName string + Framework string + GatewayID string + ID string + InstanceID string + LastSeenAt time.Time + ResourceSharing ResourceSharingDisclosure + func (s ExecutionSource) Validate() error + type GroupConcurrencyPolicy string + const GroupConcurrent + const GroupSequential + type GroupConversation struct + AccountID string + ConversationID string + CreatedAt time.Time + CurrentMembershipRevisionID string + ID string + State ConversationState + func (g GroupConversation) Validate() error + type GroupInitialTarget struct + AgentID string + BehaviorRevisionID string + BindingRevisionID string + GroupTurnID string + ParticipantID string + Wave int + type GroupMember struct + AgentID string + Position int + type GroupMembershipRevision struct + CreatedAt time.Time + GroupID string + ID string + Members []GroupMember + Revision int + func (r GroupMembershipRevision) Validate(group GroupConversation) error + type GroupRecipient struct + AgentID string + BehaviorRevisionID string + BindingRevisionID string + ParticipantID string + type GroupRecipientSelection string + const GroupRecipientSelectionEveryone + const GroupRecipientSelectionExplicit + type GroupTurnEnvelope struct + ApprovalPolicyID string + ApprovalPolicyRevision string + CancellationPolicyID string + CancellationPolicyRevision string + ClientTurnID string + ConcurrencyPolicy GroupConcurrencyPolicy + ContextSnapshotID string + ConversationID string + CostLimitClass LimitClassification + CostLimitEvidenceID string + CreatedAt time.Time + Deadline time.Time + GroupID string + ID string + IdempotencyKey string + MaxAgentMessages int + MaxHandoffDepth int + MembershipRevisionID string + Recipients []GroupRecipient + RootDelegationGrant AuthorityGrant + Selection GroupRecipientSelection + TokenLimitClass LimitClassification + TokenLimitEvidenceID string + func (e GroupTurnEnvelope) CanStart(group GroupConversation, membership GroupMembershipRevision, now time.Time, ...) error + func (e GroupTurnEnvelope) InitialTargets(group GroupConversation, membership GroupMembershipRevision) ([]GroupInitialTarget, error) + func (e GroupTurnEnvelope) Validate(group GroupConversation, membership GroupMembershipRevision) error + type Handoff struct + AccountID string + AncestorAgentIDs []string + ApprovalReceipt *AuthorityGrant + ApprovalRequired bool + BudgetClass LimitClassification + BudgetLimitEvidenceID string + Context ContextManifest + CreatedAt time.Time + CreatedByID string + CreatedByKind HandoffActorKind + Deadline time.Time + Depth int + EffectiveAuthority AuthorityGrant + EmitterRequest *AuthorityGrant + GroupTurnID string + HandoffPolicy AuthorityGrant + ID string + IdempotencyKey string + MaxAgentMessages int + MaxDepth int + OutputConversationID string + ParentHandoffID string + ParentStageAuthority *AuthorityGrant + RecipientAgentID string + RecipientBehaviorRevisionID string + RecipientBindingPolicy AuthorityGrant + RecipientBindingRevisionID string + ReplyToMessageID string + RequestedAuthority []string + RequestedResult string + RootDelegationGrant AuthorityGrant + SourceAgentID string + SourceBehaviorRevisionID string + SourceBindingRevisionID string + SourceConversationID string + SourceMessageID string + State HandoffState + StructuredEmitterID string + func (h Handoff) CanStart(now time.Time, agentMessages int) error + func (h Handoff) ReferenceProjection(conversationID string, result HandoffResult) (HandoffProjection, error) + func (h Handoff) Validate() error + type HandoffActorKind string + const HandoffActorAgent + const HandoffActorHuman + type HandoffProjection struct + AuthoritativeMessageID string + ConversationID string + HandoffID string + OutputConversationID string + State HandoffState + type HandoffResult struct + Body string + HandoffID string + MessageID string + OutputConversationID string + func (r HandoffResult) ValidateFor(h Handoff) error + type HandoffState string + const HandoffCanceled + const HandoffCompleted + const HandoffFailed + const HandoffNeedsYou + const HandoffQueued + const HandoffWorking + func (s HandoffState) Valid() bool + type LimitClassification string + const LimitHard + const LimitUnknown + func (c LimitClassification) Valid() bool + type PrimaryAgentSetting struct + Authority string + OptionID string + Policy SubscriptionPolicy + Seat Seat + UpdatedAt time.Time + func (s PrimaryAgentSetting) Validate() error + type PrimaryChannel struct + Authority string + ConversationID string + CreatedAt time.Time + ParticipantID string + Policy SubscriptionPolicy + func (c PrimaryChannel) Validate() error + type PrimaryChannelSummary struct + Conversation Conversation + Identity PrimaryChannel + Participant Participant + Pinned bool + PinnedAt time.Time + type ResourceSharingDisclosure struct + BrowserSessions ResourceSharingScope + Filesystem ResourceSharingScope + FrameworkSessions ResourceSharingScope + ProviderCredentials ResourceSharingScope + SourceMemory ResourceSharingScope + ToolConfiguration ResourceSharingScope + type ResourceSharingScope string + const ResourceAccountShared + const ResourceMachineShared + const ResourceProfileScoped + const ResourceUnknown + func (s ResourceSharingScope) Valid() bool + type Routine struct + AccountID string + AgentID string + CreatedAt time.Time + CurrentRevisionID string + ID string + State RoutineState + func (r Routine) Validate(revision RoutineRevision) error + type RoutineAuthority string + const RoutineAuthorityFortCloud + type RoutineRevision struct + AgentID string + ApprovalBoundary string + Authority RoutineAuthority + BehaviorRevisionID string + BindingRevisionID string + CatchUpPolicy string + CreatedAt time.Time + ExpectedResult string + FreshnessSeconds int64 + ID string + InputSource string + LatenessPolicy string + MissingInputBehavior string + NextOccurrence time.Time + ResultConversationID string + RetryPolicy string + Revision int + RoutineID string + Schedule string + Timezone string + Trigger RoutineTrigger + func (r RoutineRevision) NeedsRevalidation(agent Agent) bool + func (r RoutineRevision) Validate() error + type RoutineRun struct + AgentID string + BehaviorRevisionID string + BindingRevisionID string + CreatedAt time.Time + ID string + Kind RoutineRunKind + NormalizedResult string + OccurrenceID string + ResultMessageID string + RoutineID string + RoutineRevisionID string + State RoutineRunState + func (r RoutineRun) ValidateFor(routine Routine, revision RoutineRevision) error + type RoutineRunKind string + const RoutineRunScheduled + const RoutineRunTest + type RoutineRunState string + const RoutineRunCanceled + const RoutineRunFailed + const RoutineRunNeedsYou + const RoutineRunQueued + const RoutineRunSucceeded + const RoutineRunWorking + func (s RoutineRunState) Valid() bool + type RoutineState string + const RoutineActive + const RoutineArchived + const RoutinePaused + type RoutineTrigger string + type ScheduleChannelLink struct + ConversationID string + CreatedAt time.Time + ScheduleID string + type SourceAgent struct + DisplayName string + ExecutionSourceID string + ID string + LastSeenAt time.Time + OpaqueSourceAgentID string + func (a SourceAgent) Identity() (SourceAgentIdentity, error) + func (a SourceAgent) Validate() error + type SourceAgentIdentity struct + ExecutionSourceID string + OpaqueSourceAgentID string + type SubscriptionPolicy struct + AccountPlan string + AccountType string + AdapterID string + AdapterRevision string + ApprovalPolicy string + CodexExecutableRevision string + CodexSchemaRevision string + CodexVersion string + CommandPolicy string + DeveloperInstructionRevision string + DynamicToolsMode string + FileReadPolicy string + IsolationRevision string + MCPMode string + PolicyID string + PolicyRevision string + ReasoningContext string + ReasoningEffort string + RequestTimeoutMillis int + RuntimeContract string + SandboxMode string + ThreadMode string + WorkdirMode string + func (p SubscriptionPolicy) Validate(authority string) error type Target + Authority *TargetAuthority + Receipt *TargetReceipt + type TargetAuthority struct + Authority string + Policy SubscriptionPolicy + RequestedModel string + func (a TargetAuthority) Validate() error + type TargetReceipt struct + CachedInputTokens int64 + InputTokens int64 + ObservedAdapterID string + ObservedAdapterRevision string + ObservedCodexExecutableRevision string + ObservedCodexSchemaRevision string + ObservedCodexVersion string + OutputTokens int64 + ProviderTerminalStatus string + ProviderThreadID string + ReasoningTokens int64 + ResolvedModel string + UsageSource string + func (r TargetReceipt) ValidateFor(authority TargetAuthority) error v0 v0.13.0 Aug 1, 2026 Changes in this version + const MaxContextBytes + var ErrContextTooLarge = errors.New("conversation context exceeds 65536 bytes") + func CanTransition(from, to TargetState) bool + func CompileContext(conversationID string, throughMessageID int64, messages []Message) (string, error) + func CompileParticipantPrompt(contextJSON string, participant Participant) (string, error) + func ValidateProjectName(name string) (string, error) + type AuthorKind string + const AuthorAssistant + const AuthorHuman + const AuthorSystem + type Conversation struct + CreatedAt time.Time + ID string + ProjectID string + State ConversationState + Title string + UpdatedAt time.Time + type ConversationState string + const ConversationArchived + const ConversationOpen + type Message struct + AuthorID string + AuthorKind AuthorKind + Body string + ConversationID string + CreatedAt time.Time + ID int64 + TargetID string + TurnID string + type Participant struct + Agent string + ConversationID string + CreatedAt time.Time + DisplayName string + ID string + Machine string + Model string + Position int + Profile string + RemovedAt time.Time + SeatID string + State ParticipantState + type ParticipantState string + const ParticipantActive + const ParticipantRemoved + type Project struct + CreatedAt time.Time + ID string + Name string + UpdatedAt time.Time + type Seat struct + Agent string + DisplayName string + ID string + Machine string + Model string + Profile string + Reason string + State string + type Target struct + Attempt int + CreatedAt time.Time + Error string + ErrorCode string + ID string + ParticipantID string + RunID string + State TargetState + TurnID string + UpdatedAt time.Time + type TargetState string + const TargetAnswered + const TargetCanceled + const TargetFailed + const TargetQueued + const TargetWorking + type Turn struct + ClientTurnID string + ConversationID string + Created bool + CreatedAt time.Time + ID string + PromptMessageID int64 + ThroughMessageID int64 + type TurnResult struct + Targets []Target + Turn Turn