contract

package
v0.5.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 3, 2026 License: MIT Imports: 44 Imported by: 0

Documentation

Index

Constants

View Source
const (
	CodeAgentNameReserved     = diagnosticcontract.CodeAgentNameReserved
	CodeBinaryVersionMismatch = diagnosticcontract.CodeBinaryVersionMismatch

	CodeBulkTooLarge                  = diagnosticcontract.CodeBulkTooLarge
	CodeBundleConsentRequired         = diagnosticcontract.CodeBundleConsentRequired
	CodeBundlePartialFailure          = diagnosticcontract.CodeBundlePartialFailure
	CodeBundleSizeExceeded            = diagnosticcontract.CodeBundleSizeExceeded
	CodeConfigActiveSessionsBlock     = diagnosticcontract.CodeConfigActiveSessionsBlock
	CodeConfigApplyUnsupported        = diagnosticcontract.CodeConfigApplyUnsupported
	CodeConfigDriftPresent            = diagnosticcontract.CodeConfigDriftPresent
	CodeConfigDriftStale              = diagnosticcontract.CodeConfigDriftStale
	CodeConfigInvalid                 = diagnosticcontract.CodeConfigInvalid
	CodeConfigPartialFailure          = diagnosticcontract.CodeConfigPartialFailure
	CodeConfigProfileLayerOrphaned    = diagnosticcontract.CodeConfigProfileLayerOrphaned
	CodeConfigReloadTimeout           = diagnosticcontract.CodeConfigReloadTimeout
	CodeConfigRestartRequired         = diagnosticcontract.CodeConfigRestartRequired
	CodeConfigValidateFailed          = diagnosticcontract.CodeConfigValidateFailed
	CodeConfigValidated               = diagnosticcontract.CodeConfigValidated
	CodeCursorConflict                = diagnosticcontract.CodeCursorConflict
	CodeDaemonHealthUnavailable       = diagnosticcontract.CodeDaemonHealthUnavailable
	CodeDaemonDraining                = diagnosticcontract.CodeDaemonDraining
	CodeDaemonStateSuspect            = diagnosticcontract.CodeDaemonStateSuspect
	CodeDaemonStatusOK                = diagnosticcontract.CodeDaemonStatusOK
	CodeDaemonUnavailable             = diagnosticcontract.CodeDaemonUnavailable
	CodeDiskWriteFailed               = diagnosticcontract.CodeDiskWriteFailed
	CodeExtensionChecksumUnverified   = diagnosticcontract.CodeExtensionChecksumUnverified
	CodeExtensionAgentConflict        = diagnosticcontract.CodeExtensionAgentConflict
	CodeExtensionEnvBindingDangling   = diagnosticcontract.CodeExtensionEnvBindingDangling
	CodeExtensionEnvBindingInvalid    = diagnosticcontract.CodeExtensionEnvBindingInvalid
	CodeExtensionEnvBindingUndeclared = diagnosticcontract.CodeExtensionEnvBindingUndeclared

	CodeExtensionInstallFailed        = diagnosticcontract.CodeExtensionInstallFailed
	CodeExtensionUpdateCleanupFailed  = diagnosticcontract.CodeExtensionUpdateCleanupFailed
	CodeExtensionInUse                = diagnosticcontract.CodeExtensionInUse
	CodeExtensionNotFound             = diagnosticcontract.CodeExtensionNotFound
	CodeExtensionRuntimeUnavailable   = diagnosticcontract.CodeExtensionRuntimeUnavailable
	CodeExtensionMCPServerUnhealthy   = diagnosticcontract.CodeExtensionMCPServerUnhealthy
	CodeFlagNotApplicable             = diagnosticcontract.CodeFlagNotApplicable
	CodeForbiddenOperatorAction       = diagnosticcontract.CodeForbiddenOperatorAction
	CodeForceOpRateLimited            = diagnosticcontract.CodeForceOpRateLimited
	CodeForceOpRequiresReason         = diagnosticcontract.CodeForceOpRequiresReason
	CodeHomeDiskSpaceCritical         = diagnosticcontract.CodeHomeDiskSpaceCritical
	CodeHomeDiskSpaceLow              = diagnosticcontract.CodeHomeDiskSpaceLow
	CodeHomePathMissing               = diagnosticcontract.CodeHomePathMissing
	CodeHomePermsWrong                = diagnosticcontract.CodeHomePermsWrong
	CodeIDFormatUnknown               = diagnosticcontract.CodeIDFormatUnknown
	CodeIdentityLookupUnavailable     = diagnosticcontract.CodeIdentityLookupUnavailable
	CodeIdentityMismatch              = diagnosticcontract.CodeIdentityMismatch
	CodeIdentityRequired              = diagnosticcontract.CodeIdentityRequired
	CodeIdentityStale                 = diagnosticcontract.CodeIdentityStale
	CodeIdentityUnauthorized          = diagnosticcontract.CodeIdentityUnauthorized
	CodeMarketplaceUnavailable        = diagnosticcontract.CodeMarketplaceUnavailable
	CodeModelNotFound                 = diagnosticcontract.CodeModelNotFound
	CodeModelUnavailable              = diagnosticcontract.CodeModelUnavailable
	CodeMCPAuthRequired               = diagnosticcontract.CodeMCPAuthRequired
	CodeMCPServerReady                = diagnosticcontract.CodeMCPServerReady
	CodeMCPServerUnavailable          = diagnosticcontract.CodeMCPServerUnavailable
	CodeMigrationsPending             = diagnosticcontract.CodeMigrationsPending
	CodeProbeFailed                   = diagnosticcontract.CodeProbeFailed
	CodeProbeTimeout                  = diagnosticcontract.CodeProbeTimeout
	CodePromptDispatchIndeterminate   = diagnosticcontract.CodePromptDispatchIndeterminate
	CodePromptIdempotencyConflict     = diagnosticcontract.CodePromptIdempotencyConflict
	CodePromptMessageIdentityConflict = diagnosticcontract.CodePromptMessageIdentityConflict
	CodeProviderClassificationUnknown = diagnosticcontract.CodeProviderClassificationUnknown
	CodeProviderCLIMissing            = diagnosticcontract.CodeProviderCLIMissing
	CodeProviderCredentialUnresolved  = diagnosticcontract.CodeProviderCredentialUnresolved
	CodeProviderLoginRequiresLocalTTY = diagnosticcontract.CodeProviderLoginRequiresLocalTTY
	CodeProviderAuthenticated         = diagnosticcontract.CodeProviderAuthenticated
	CodeProviderNotAuthenticated      = diagnosticcontract.CodeProviderNotAuthenticated
	CodeProviderNotInstalled          = diagnosticcontract.CodeProviderNotInstalled
	CodeProviderPermissionDenied      = diagnosticcontract.CodeProviderPermissionDenied
	CodeProviderRateLimited           = diagnosticcontract.CodeProviderRateLimited
	CodeProviderTransientFailure      = diagnosticcontract.CodeProviderTransientFailure
	CodeReasoningEffortUnsupported    = diagnosticcontract.CodeReasoningEffortUnsupported
	CodeReasoningOptionMissing        = diagnosticcontract.CodeReasoningOptionMissing
	CodeSpeedRejected                 = diagnosticcontract.CodeSpeedRejected
	CodeRoleAgentNotFound             = diagnosticcontract.CodeRoleAgentNotFound
	CodeRoleResolutionFailed          = diagnosticcontract.CodeRoleResolutionFailed
	CodeRoleUnknown                   = diagnosticcontract.CodeRoleUnknown
	CodeRetryChainTooDeep             = diagnosticcontract.CodeRetryChainTooDeep
	CodeSchedulerReady                = diagnosticcontract.CodeSchedulerReady
	CodeSchedulerPaused               = diagnosticcontract.CodeSchedulerPaused
	CodeSecretsPermsWrong             = diagnosticcontract.CodeSecretsPermsWrong
	CodeSessionBusy                   = diagnosticcontract.CodeSessionBusy
	CodeSessionLocked                 = diagnosticcontract.CodeSessionLocked
	CodeSessionQueueFull              = diagnosticcontract.CodeSessionQueueFull
	CodeSessionResumeAmbiguous        = diagnosticcontract.CodeSessionResumeAmbiguous
	CodeSkillRegistryReady            = diagnosticcontract.CodeSkillRegistryReady
	CodeSkillNotFound                 = diagnosticcontract.CodeSkillNotFound
	CodeSocketPathUnwritable          = diagnosticcontract.CodeSocketPathUnwritable
	CodeTaskRunAlreadyTerminal        = diagnosticcontract.CodeTaskRunAlreadyTerminal
	CodeTaskRunCrashed                = diagnosticcontract.CodeTaskRunCrashed
	CodeTaskRunNotReleasable          = diagnosticcontract.CodeTaskRunNotReleasable
	CodeTaskRunOrphan                 = diagnosticcontract.CodeTaskRunOrphan
	CodeTaskRunStaleLease             = diagnosticcontract.CodeTaskRunStaleLease
	CodeTaskRunStillActive            = diagnosticcontract.CodeTaskRunStillActive
	CodeTaskRunStranded               = diagnosticcontract.CodeTaskRunStranded
	CodeTaskRunStuck                  = diagnosticcontract.CodeTaskRunStuck
	CodeUnknownActorFormat            = diagnosticcontract.CodeUnknownActorFormat
	CodeUnknownComponent              = diagnosticcontract.CodeUnknownComponent
	CodeVaultRefUnresolved            = diagnosticcontract.CodeVaultRefUnresolved
)
View Source
const (
	CodeExtensionArchiveDigestMismatch   = diagnosticcontract.CodeExtensionArchiveDigestMismatch
	CodeExtensionUnverifiedPolicyBlocked = diagnosticcontract.CodeExtensionUnverifiedPolicyBlocked
)
View Source
const (
	LoopRunEventNodeRunning          = looppkg.RunEventNodeRunning
	LoopRunEventNodeSucceeded        = looppkg.RunEventNodeSucceeded
	LoopRunEventNodeFailed           = looppkg.RunEventNodeFailed
	LoopRunEventGateVerdict          = looppkg.RunEventGateVerdict
	LoopRunEventGenerationStarted    = looppkg.RunEventGenerationStarted
	LoopRunEventTokenTick            = looppkg.RunEventTokenTick
	LoopRunEventNeedsApproval        = looppkg.RunEventNeedsApproval
	LoopRunEventStatusChanged        = looppkg.RunEventStatusChanged
	LoopRunEventGoalTurnStarted      = looppkg.RunEventGoalTurnStarted
	LoopRunEventGoalTurnCompleted    = looppkg.RunEventGoalTurnCompleted
	LoopRunEventGoalStatusChanged    = looppkg.RunEventGoalStatusChanged
	LoopRunEventRuntimeApplied       = looppkg.RunEventRuntimeApplied
	LoopRunEventPredicateDiagnostic  = looppkg.RunEventPredicateDiagnostic
	LoopRunEventRouteTaken           = looppkg.RunEventRouteTaken
	LoopRunEventNodeRetryScheduled   = looppkg.RunEventNodeRetryScheduled
	LoopRunEventNodePaused           = looppkg.RunEventNodePaused
	LoopRunEventNodeResumed          = looppkg.RunEventNodeResumed
	LoopRunEventNodeCanceled         = looppkg.RunEventNodeCanceled
	LoopRunEventNodeQuarantined      = looppkg.RunEventNodeQuarantined
	LoopRunEventNodeRequeued         = looppkg.RunEventNodeRequeued
	LoopRunEventNodeWaitStarted      = looppkg.RunEventNodeWaitStarted
	LoopRunEventNodeWaitResumed      = looppkg.RunEventNodeWaitResumed
	LoopRunEventNodeAttentionFlagged = looppkg.RunEventNodeAttentionFlagged
	LoopRunEventNodeAttentionCleared = looppkg.RunEventNodeAttentionCleared
	LoopRunEventEffectResults        = looppkg.RunEventEffectResults
	LoopRunEventCustomEvent          = looppkg.RunEventCustomEvent
	LoopRunEventDuplicateSuppressed  = looppkg.RunEventDuplicateSuppressed
	LoopRunEventTargetBreaker        = looppkg.RunEventTargetBreaker
	LoopRunEventStaleScheduleDropped = looppkg.RunEventStaleScheduleDropped
	LoopRunEventLateArrival          = looppkg.RunEventLateArrival
	LoopRunEventRequestOpened        = looppkg.RunEventRequestOpened
	LoopRunEventRequestAnswered      = looppkg.RunEventRequestAnswered
	LoopRunEventRequestExpired       = looppkg.RunEventRequestExpired
	LoopRunEventRequestCanceled      = looppkg.RunEventRequestCanceled
	LoopRunEventNodeAmended          = looppkg.RunEventNodeAmended
	LoopRunEventBranchPruned         = looppkg.RunEventBranchPruned
	LoopRunEventRunForked            = looppkg.RunEventRunForked
)
View Source
const (
	MarketplaceScopeGlobal    = "global"
	MarketplaceScopeProfile   = "profile"
	MarketplaceScopeWorkspace = "workspace"
)
View Source
const (
	PromptAttachmentKindImage = session.AttachmentKindImage
	PromptAttachmentKindFile  = session.AttachmentKindFile

	// DefaultPromptAttachmentLimit applies when no configured cap is supplied.
	DefaultPromptAttachmentLimit = 10
)
View Source
const (
	ProviderAuthStateAuthenticated     = "authenticated"
	ProviderAuthStateNeedsLogin        = "needs_login"
	ProviderAuthStateMissingCLI        = "missing_cli"
	ProviderAuthStateMissingCredential = "missing_credential"
	ProviderAuthStatePermissionDenied  = "permission_denied"
	ProviderAuthStateRateLimited       = "rate_limited"
	ProviderAuthStateTransient         = "transient"
	ProviderAuthStateNone              = "none"
	ProviderAuthStateUnknown           = "unknown"
)
View Source
const (
	SessionFilesDefaultLimit = 50
	SessionFilesMaxLimit     = 200
)

Session file search limit bounds for the searchSessionFiles limit query parameter.

View Source
const (
	// SessionAttachDefaultTTLSeconds is the lease duration used when attach omits a positive TTL.
	SessionAttachDefaultTTLSeconds = 15 * 60
	// SessionAttachMaxTTLSeconds is the largest attach lease accepted by the daemon.
	SessionAttachMaxTTLSeconds = 24 * 60 * 60
)
View Source
const (
	SessionStreamFrameRaw        = "raw"
	SessionStreamFrameTranscript = "transcript"

	SessionStreamEventTranscriptSnapshot  = "transcript_snapshot"
	SessionStreamEventTranscriptDelta     = "transcript_delta"
	SessionStreamEventGoalSnapshotChanged = "goal_snapshot_changed"
	SessionStreamEventCommandsChanged     = "session_commands_changed"
	SessionStreamEventConsumerDegraded    = "stream.consumer_degraded"

	TranscriptSnapshotReasonFenceMissing       = "fence_missing"
	TranscriptSnapshotReasonEpochMismatch      = "epoch_mismatch"
	TranscriptSnapshotReasonGenerationMismatch = "generation_mismatch"
	TranscriptSnapshotReasonSequenceReset      = "sequence_reset"
	TranscriptSnapshotReasonCursorExpired      = "cursor_expired"
)
View Source
const (
	SpeedNormal = speedpkg.SpeedNormal
	SpeedFast   = speedpkg.SpeedFast
)
View Source
const (
	SpeedResolutionApplied     = speedpkg.ResolutionApplied
	SpeedResolutionUnsupported = speedpkg.ResolutionUnsupported
	SpeedResolutionRejected    = speedpkg.ResolutionRejected
)
View Source
const (
	SpeedResolutionReasonCapabilityAbsent    = speedpkg.ReasonCapabilityAbsent
	SpeedResolutionReasonCapabilityAmbiguous = speedpkg.ReasonCapabilityAmbiguous
	SpeedResolutionReasonValueAmbiguous      = speedpkg.ReasonValueAmbiguous
	SpeedResolutionReasonProviderRejected    = speedpkg.ReasonProviderRejected
)
View Source
const (
	SessionStreamEventSubagentsSnapshot = "subagents_snapshot"
	SessionStreamEventSubagentUpdated   = "subagent_updated"
)
View Source
const (
	ToolOperatorCauseDetailKey    = "operator_cause"
	ToolOperatorRecoveryDetailKey = "operator_recovery"
)
View Source
const (
	WindowManagerFrameSnapshot            = "snapshot"
	WindowManagerFrameEvent               = "event"
	WindowManagerFrameClient              = "client"
	WindowManagerFrameClientCommand       = "client_command"
	WindowManagerFrameClientCommandAck    = "client_command_ack"
	WindowManagerFrameClientCommandResult = "client_command_result"
	WindowManagerFrameClientContext       = "client_context"
	WindowManagerFrameHeartbeat           = "heartbeat"
	WindowManagerFrameError               = "error"
)
View Source
const LoopRunWebRoute = "/loop-runs/%s"

LoopRunWebRoute is the public SPA route for one persisted Loop run.

View Source
const ObserveOverviewSchemaVersion = "observe-overview/v1"

ObserveOverviewSchemaVersion identifies the home overview payload contract revision.

View Source
const ProviderUsageCollectionProfileQuery = "collection_profile"

ProviderUsageCollectionProfileQuery selects the login to collect after a user-scoped consent change.

View Source
const SchedulerDrainTimeoutMaxSeconds int64 = math.MaxInt64 / int64(time.Second)

SchedulerDrainTimeoutMaxSeconds is the largest whole-second timeout that can be represented by time.Duration.

View Source
const (
	// StatusSchemaVersion identifies the public status/doctor payload contract.
	StatusSchemaVersion = "2026-10-07"
)

Variables

View Source
var (
	// ErrUnsafeAuthoredContextPayload reports raw credentials or disallowed prompt data in a public DTO.
	ErrUnsafeAuthoredContextPayload = errors.New(
		"contract: authored context payload contains unsafe token or prompt data",
	)
	// ErrInvalidAuthoredContextEnum reports a value outside a closed public contract enum.
	ErrInvalidAuthoredContextEnum = errors.New("contract: invalid authored context enum")
)
View Source
var ErrRawClaimTokenMetadata = errors.New("contract: public payload must not contain raw lease credentials")

ErrRawClaimTokenMetadata reports raw lease credentials in a public payload.

View Source
var ErrWindowManagerUnsafeRevision = errors.New("window manager revision exceeds the JSON safe integer range")

ErrWindowManagerUnsafeRevision identifies a domain revision that cannot be represented on the wire.

Functions

func ACPOptionSelectionsFromPayload

func ACPOptionSelectionsFromPayload(
	options []AgentACPOptionSelection,
) []acp.SessionConfigOptionSelection

ACPOptionSelectionsFromPayload converts public typed ACP options into the internal selection shape without exposing ACP wire fields.

func ACPPromptStopReasonValues

func ACPPromptStopReasonValues() []string

ACPPromptStopReasonValues returns the closed ACP prompt stop vocabulary.

func AgentSoulRevisionActionValues

func AgentSoulRevisionActionValues() []string

AgentSoulRevisionActionValues returns the closed Soul revision action enum values.

func AttachmentMetaFromRefs

func AttachmentMetaFromRefs(refs []PromptAttachmentRef) []session.AttachmentMeta

AttachmentMetaFromRefs converts wire refs into session attachment metadata.

func AuthoredDiagnosticSeverityValues

func AuthoredDiagnosticSeverityValues() []string

AuthoredDiagnosticSeverityValues returns the closed diagnostic severity enum values.

func AuthoredValidationStatusValues

func AuthoredValidationStatusValues() []string

AuthoredValidationStatusValues returns the closed authored validation status enum values.

func ContainsRawClaimTokenField

func ContainsRawClaimTokenField(payload any) (bool, error)

ContainsRawClaimTokenField reports whether a JSON payload includes a raw claim_token field.

func ContainsUnsafeAuthoredContextPayload

func ContainsUnsafeAuthoredContextPayload(payload any) (bool, error)

ContainsUnsafeAuthoredContextPayload reports whether a payload includes raw credentials or prompt data.

func DiagnosticCodeCategory

func DiagnosticCodeCategory(code string) (string, bool)

DiagnosticCodeCategory returns the canonical category for code.

func DiagnosticCodes

func DiagnosticCodes() []string

DiagnosticCodes returns all registered deterministic diagnostic codes.

func FilterToolOperatorFailureDetails

func FilterToolOperatorFailureDetails(details map[string]json.RawMessage) map[string]json.RawMessage

FilterToolOperatorFailureDetails retains only the two explicitly safe remediation fields.

func GoalCommandOutcomeValues

func GoalCommandOutcomeValues() []string

GoalCommandOutcomeValues returns the closed structured Goal result vocabulary.

func GoalContextStateValues

func GoalContextStateValues() []string

GoalContextStateValues returns the closed context freshness vocabulary.

func GoalPromptKindValues

func GoalPromptKindValues() []string

GoalPromptKindValues returns the closed transcript Goal prompt vocabulary.

func GoalReasonCodeValues

func GoalReasonCodeValues() []string

GoalReasonCodeValues returns the stable public Goal reason vocabulary.

func GoalSnapshotChangeCauseValues

func GoalSnapshotChangeCauseValues() []string

GoalSnapshotChangeCauseValues returns the closed session projection cause vocabulary.

func GoalStatusValues

func GoalStatusValues() []string

GoalStatusValues returns the closed public Goal lifecycle vocabulary.

func GoalTurnResultStatusValues

func GoalTurnResultStatusValues() []string

GoalTurnResultStatusValues returns the closed Goal turn result vocabulary.

func GoalVerdictOutcomeValues

func GoalVerdictOutcomeValues() []string

GoalVerdictOutcomeValues returns the closed Goal judge outcome vocabulary.

func HeartbeatActorKindValues

func HeartbeatActorKindValues() []string

HeartbeatActorKindValues returns the closed Heartbeat actor kind enum values.

func HeartbeatRevisionOperationValues

func HeartbeatRevisionOperationValues() []string

HeartbeatRevisionOperationValues returns the closed Heartbeat revision operation enum values.

func HeartbeatWakeReasonValues

func HeartbeatWakeReasonValues() []string

HeartbeatWakeReasonValues returns the closed wake reason enum values.

func HeartbeatWakeResultValues

func HeartbeatWakeResultValues() []string

HeartbeatWakeResultValues returns the closed wake result enum values.

func HeartbeatWakeSourceValues

func HeartbeatWakeSourceValues() []string

HeartbeatWakeSourceValues returns the closed wake source enum values.

func IsDiagnosticCategory

func IsDiagnosticCategory(category string) bool

IsDiagnosticCategory reports whether category belongs to the closed set.

func IsDiagnosticCode

func IsDiagnosticCode(code string) bool

IsDiagnosticCode reports whether code belongs to the canonical registry.

func IsDiagnosticFreshness

func IsDiagnosticFreshness(freshness string) bool

IsDiagnosticFreshness reports whether freshness belongs to the closed set.

func IsDiagnosticSeverity

func IsDiagnosticSeverity(severity string) bool

IsDiagnosticSeverity reports whether severity belongs to the closed set.

func IsTerminalErrorCode

func IsTerminalErrorCode(code TerminalErrorCode) bool

IsTerminalErrorCode reports whether code belongs to the frozen public vocabulary.

func IssueSeverityValues

func IssueSeverityValues() []string

IssueSeverityValues returns the closed validation-severity set.

func LoopCompletionStateValues

func LoopCompletionStateValues() []string

LoopCompletionStateValues returns the closed completion coverage vocabulary.

func LoopEntityKindValues

func LoopEntityKindValues() []string

LoopEntityKindValues returns the closed x-compozy-kind vocabulary.

func LoopGateVerdictOutcomeValues

func LoopGateVerdictOutcomeValues() []string

LoopGateVerdictOutcomeValues returns the closed machine-verdict vocabulary.

func LoopGenerationOriginValues

func LoopGenerationOriginValues() []string

LoopGenerationOriginValues returns the closed generation provenance vocabulary.

func LoopInputRefKindValues

func LoopInputRefKindValues() []string

LoopInputRefKindValues returns the closed ref-backed input kind vocabulary.

func LoopInputTypeValues

func LoopInputTypeValues() []string

LoopInputTypeValues returns the closed Loop input type vocabulary.

func LoopMetricDirectionValues

func LoopMetricDirectionValues() []string

LoopMetricDirectionValues returns the closed gate metric direction vocabulary.

func LoopNodeInventoryStateValues

func LoopNodeInventoryStateValues() []string

LoopNodeInventoryStateValues returns the closed inventory-state vocabulary.

func LoopParentClosePolicyValues

func LoopParentClosePolicyValues() []string

LoopParentClosePolicyValues returns the closed parent-close vocabulary.

func LoopProvenanceRoleValues

func LoopProvenanceRoleValues() []string

LoopProvenanceRoleValues returns every supported wire role.

func LoopRunEventKindValues

func LoopRunEventKindValues() []string

LoopRunEventKindValues returns the closed public loop run event vocabulary.

func LoopRunLifecycleEventKindValues

func LoopRunLifecycleEventKindValues() []string

LoopRunLifecycleEventKindValues returns event kinds that mutate durable run state.

func LoopRunLiveStatusValues

func LoopRunLiveStatusValues() []string

LoopRunLiveStatusValues returns the non-terminal loop run statuses.

func LoopRunStatusValues

func LoopRunStatusValues() []string

LoopRunStatusValues returns the closed public loop run status vocabulary.

func LoopRunTerminalStatusValues

func LoopRunTerminalStatusValues() []string

LoopRunTerminalStatusValues returns the terminal loop run statuses.

func LoopRunTransitionCauseValues

func LoopRunTransitionCauseValues() []string

LoopRunTransitionCauseValues returns the closed public transition-cause vocabulary.

func LoopWatchEventKindValues

func LoopWatchEventKindValues() []string

LoopWatchEventKindValues returns the closed watch-events kind vocabulary in ADR-004 order. It is the single source consumed by the OpenAPI enum registration and the generated web `LOOP_WATCH_EVENT_KINDS` array, so the authoring kind-select never hand-authors the enum in TypeScript.

func PromptRuntimeSelectionFromPayload

func PromptRuntimeSelectionFromPayload(
	payload *PromptRuntimeSelectionPayload,
) *session.RuntimeSelection

PromptRuntimeSelectionFromPayload converts an optional prompt runtime snapshot.

func ResolvedWorktreeModeValues

func ResolvedWorktreeModeValues() []string

func SchedulerBacklogDomainQuery

func SchedulerBacklogDomainQuery(query SchedulerBacklogQuery) taskpkg.SchedulerBacklogQuery

SchedulerBacklogDomainQuery converts API filters into task-domain filters.

func SessionFileKindValues

func SessionFileKindValues() []string

SessionFileKindValues lists the public session file kinds.

func SessionGoalOperationValues

func SessionGoalOperationValues() []string

SessionGoalOperationValues returns the closed structured Goal operation vocabulary.

func SessionHealthIneligibilityReasonValues

func SessionHealthIneligibilityReasonValues() []string

SessionHealthIneligibilityReasonValues returns closed wake-ineligibility reason enum values.

func SessionHealthStateValues

func SessionHealthStateValues() []string

SessionHealthStateValues returns the closed session health state enum values.

func SessionHealthStatusValues

func SessionHealthStatusValues() []string

SessionHealthStatusValues returns the closed session health status enum values.

func SessionInputStatusValues

func SessionInputStatusValues() []string

func SessionMentionKindValues

func SessionMentionKindValues() []string

SessionMentionKindValues lists the public mention kinds.

func TerminalActorKindValues

func TerminalActorKindValues() []string

func TerminalAttachModeValues

func TerminalAttachModeValues() []string

func TerminalCommandApprovalValues

func TerminalCommandApprovalValues() []string

func TerminalCommandDetectionValues

func TerminalCommandDetectionValues() []string

func TerminalErrorCodeValues

func TerminalErrorCodeValues() []string

TerminalErrorCodeValues returns the frozen terminal error vocabulary in contract order.

func TerminalErrorToolDetailsFromDomain

func TerminalErrorToolDetailsFromDomain(err *terminalpkg.Error) map[string]json.RawMessage

TerminalErrorToolDetailsFromDomain projects terminal metadata into the generic tool-error details object without deriving fields from message text.

func TerminalExitCauseValues

func TerminalExitCauseValues() []string

func TerminalInputRejectOutcomeValues

func TerminalInputRejectOutcomeValues() []string

func TerminalInputResolutionOutcomeValues

func TerminalInputResolutionOutcomeValues() []string

func TerminalModeValues

func TerminalModeValues() []string

func TerminalRecordingActionValues

func TerminalRecordingActionValues() []string

func TerminalRecordingStateValues

func TerminalRecordingStateValues() []string

func TerminalSignalValues

func TerminalSignalValues() []string

func TerminalStateValues

func TerminalStateValues() []string

func ToolOperatorFailureDetails

func ToolOperatorFailureDetails(failure *tools.OperatorFailure) map[string]json.RawMessage

ToolOperatorFailureDetails projects explicitly authored operator-safe remediation.

func ValidateAuthoredContextRedacted

func ValidateAuthoredContextRedacted(payload any) error

ValidateAuthoredContextRedacted rejects raw credentials or disallowed prompt data in public DTOs.

func ValidateDiagnosticItem

func ValidateDiagnosticItem(item DiagnosticItem) error

ValidateDiagnosticItem checks the public contract without mutating it.

func ValidateDiagnosticRegistry

func ValidateDiagnosticRegistry() error

ValidateDiagnosticRegistry checks duplicate codes and unknown categories.

func ValidateNoRawClaimTokenField

func ValidateNoRawClaimTokenField(payload any) error

ValidateNoRawClaimTokenField rejects payloads that include a raw claim_token JSON field.

func ValidatePromptAttachments

func ValidatePromptAttachments(refs []PromptAttachmentRef, maxCount int) error

ValidatePromptAttachments checks identity, kind, and the caller-provided count cap.

func ValidateTaskInboxQuery

func ValidateTaskInboxQuery(query TaskInboxQuery, path string) error

ValidateTaskInboxQuery validates transport-owned fields before workspace resolution or storage access.

func ValidateTaskListQuery

func ValidateTaskListQuery(query TaskListQuery, path string) error

ValidateTaskListQuery validates transport-owned fields before workspace resolution or storage access.

func WindowManagerCommandIDValues

func WindowManagerCommandIDValues() []string

WindowManagerCommandIDValues returns every supported semantic command id.

func WindowManagerErrorCodeValues

func WindowManagerErrorCodeValues() []string

WindowManagerErrorCodeValues returns every public window-manager error code.

Types

type ACPAvailableCommandInputPayload

type ACPAvailableCommandInputPayload struct {
	Hint string `json:"hint"`
}

ACPAvailableCommandInputPayload describes the optional unstructured command argument.

type ACPAvailableCommandPayload

type ACPAvailableCommandPayload struct {
	Name        string                           `json:"name"`
	Description string                           `json:"description"`
	Input       *ACPAvailableCommandInputPayload `json:"input,omitzero"`
}

ACPAvailableCommandPayload is one command in the session's current replacement set.

type ACPCapsPayload

type ACPCapsPayload struct {
	SupportsLoadSession   bool                         `json:"supports_load_session"`
	SupportsForkSession   bool                         `json:"supports_fork_session"`
	SupportsResumeSession bool                         `json:"supports_resume_session"`
	PromptImage           bool                         `json:"prompt_image"`
	PromptAudio           bool                         `json:"prompt_audio"`
	PromptEmbeddedContext bool                         `json:"prompt_embedded_context"`
	SupportedModes        []string                     `json:"supported_modes,omitempty"`
	ConfigOptions         []SessionConfigOptionPayload `json:"config_options,omitempty"`
}

ACPCapsPayload is the JSON representation of ACP capabilities.

func ACPCapsPayloadFromACP

func ACPCapsPayloadFromACP(caps acp.Caps, known bool) *ACPCapsPayload

ACPCapsPayloadFromACP projects negotiated ACP capabilities into the wire contract.

type ACPPromptStopReason

type ACPPromptStopReason string

ACPPromptStopReason is the closed turn-completion vocabulary exposed by ACP sessions.

const (
	ACPStopReasonEndTurn         ACPPromptStopReason = "end_turn"
	ACPStopReasonMaxTokens       ACPPromptStopReason = "max_tokens"
	ACPStopReasonMaxTurnRequests ACPPromptStopReason = "max_turn_requests"
	ACPStopReasonRefusal         ACPPromptStopReason = "refusal"
	// ACP spells the cancellation wire value with a doubled l.
	ACPStopReasonCancelled ACPPromptStopReason = "cancel" + "led"
)

type AcknowledgeAttentionRequest

type AcknowledgeAttentionRequest struct {
	Snapshot string `json:"snapshot"     binding:"required"`
	ID       string `json:"id,omitempty"`
}

AcknowledgeAttentionRequest acknowledges one snapshot member, or every member when id is omitted.

type AddMarketplaceSourceRequest

type AddMarketplaceSourceRequest struct {
	Ref  string `json:"ref"`
	Name string `json:"name,omitempty"`
}

type AddTaskDependencyRequest

type AddTaskDependencyRequest struct {
	DependsOnTaskID string                 `json:"depends_on_task_id"`
	Kind            taskpkg.DependencyKind `json:"kind,omitempty"`
}

AddTaskDependencyRequest is the shared dependency-create request payload.

type AdoptWorktreeRequest

type AdoptWorktreeRequest struct {
	Path string `json:"path"`
}

type AgentACPOptionSelection

type AgentACPOptionSelection struct {
	ID        string `json:"id"`
	ValueID   string `json:"value_id,omitempty"`
	BoolValue *bool  `json:"bool_value,omitempty"`
}

AgentACPOptionSelection captures one typed ACP option selection in a public runtime contract. Exactly one of ValueID or BoolValue must be set.

func ACPOptionSelectionPayloadsFromACP

func ACPOptionSelectionPayloadsFromACP(
	options []acp.SessionConfigOptionSelection,
) []AgentACPOptionSelection

ACPOptionSelectionPayloadsFromACP converts internal typed ACP options into their provider-neutral public representation.

type AgentActivityResponse

type AgentActivityResponse agentinstance.Activity

type AgentCapabilityPayload

type AgentCapabilityPayload struct {
	ID      string `json:"id"`
	Summary string `json:"summary,omitempty"`
	Source  string `json:"source,omitempty"`
}

AgentCapabilityPayload describes one caller capability atom.

type AgentCapabilitySectionPayload

type AgentCapabilitySectionPayload struct {
	Section      AgentContextSectionMetaPayload `json:"section"`
	Capabilities []AgentCapabilityPayload       `json:"capabilities"`
}

AgentCapabilitySectionPayload is the bounded capability section in `/agent/context`.

type AgentCatalogFacetsPayload

type AgentCatalogFacetsPayload struct {
	Categories []string `json:"categories"`
	Total      int      `json:"total"`
	Active     int      `json:"active"`
	Idle       int      `json:"idle"`
}

AgentCatalogFacetsPayload contains fleet-wide values before search, filters, and cursor pagination. Active and Idle are exact only when the enclosing response reports SessionsAvailable.

type AgentCatalogItemPayload

type AgentCatalogItemPayload struct {
	Scopes   []string                    `json:"scopes,omitempty"`
	Agent    AgentPayload                `json:"agent"`
	Sessions *AgentSessionMetricsPayload `json:"sessions,omitzero"`
}

AgentCatalogItemPayload combines one effective definition with its optional runtime session aggregate. Sessions is nil when the session authority is temporarily unavailable.

type AgentCatalogResponse

type AgentCatalogResponse struct {
	Items             []GroupedAgentCatalogItemPayload `json:"items,omitempty"`
	NextCursor        string                           `json:"next_cursor"`
	Diagnostics       []DiagnosticItem                 `json:"diagnostics,omitempty"`
	Agents            []AgentCatalogItemPayload        `json:"agents"`
	Page              CountedCursorPagePayload         `json:"page"`
	Facets            AgentCatalogFacetsPayload        `json:"facets"`
	SessionsAvailable bool                             `json:"sessions_available"`
}

AgentCatalogResponse is one bounded Global or workspace agent fleet page.

type AgentContextPayload

type AgentContextPayload struct {
	Soul         AgentSoulSectionPayload       `json:"soul"`
	Self         AgentIdentityPayload          `json:"self"`
	Workspace    AgentWorkspacePayload         `json:"workspace"`
	Session      AgentSessionPayload           `json:"session"`
	Task         AgentTaskContextPayload       `json:"task"`
	Capabilities AgentCapabilitySectionPayload `json:"capabilities"`
	Limits       AgentLimitsPayload            `json:"limits"`
	Provenance   AgentContextProvenancePayload `json:"provenance"`
}

AgentContextPayload is the stable bounded situation payload returned by `/agent/context`.

func NormalizeAgentContextPayload

func NormalizeAgentContextPayload(source *AgentContextPayload) AgentContextPayload

NormalizeAgentContextPayload returns a context payload with stable bounded list sections.

type AgentContextProvenancePayload

type AgentContextProvenancePayload struct {
	GeneratedAt time.Time `json:"generated_at"`
	Source      string    `json:"source"`
}

AgentContextProvenancePayload describes when and how an agent context was assembled.

type AgentContextResponse

type AgentContextResponse struct {
	Context AgentContextPayload `json:"context"`
}

AgentContextResponse wraps the bounded caller situation payload.

type AgentContextSectionMetaPayload

type AgentContextSectionMetaPayload struct {
	Limit     int  `json:"limit"`
	Returned  int  `json:"returned"`
	Truncated bool `json:"truncated"`
}

AgentContextSectionMetaPayload reports bounding/truncation metadata for context sections.

type AgentCoordinatorConfigResponse

type AgentCoordinatorConfigResponse struct {
	Coordinator CoordinatorConfigPayload `json:"coordinator"`
}

AgentCoordinatorConfigResponse wraps coordinator config read state.

type AgentCreateScope

type AgentCreateScope string

AgentCreateScope identifies where a newly authored AGENT.md definition is stored.

const (
	// AgentCreateScopeWorkspace writes the agent under one workspace's .compozy directory.
	AgentCreateScopeWorkspace AgentCreateScope = "workspace"
	// AgentCreateScopeGlobal writes the agent under COMPOZY_HOME.
	AgentCreateScopeGlobal AgentCreateScope = "global"
)

type AgentDefinitionShadowPayload

type AgentDefinitionShadowPayload struct {
	Layer string `json:"layer"`
	Path  string `json:"path"`
}

AgentDefinitionShadowPayload reports one lower-precedence authored definition.

type AgentDiagnosticPayload

type AgentDiagnosticPayload struct {
	Path      string `json:"path"`
	ErrorKind string `json:"error_kind"`
	Message   string `json:"message"`
}

AgentDiagnosticPayload reports one malformed agent definition encountered during discovery.

type AgentDraftRuntime

type AgentDraftRuntime struct {
	Provider        string `json:"provider"`
	Model           string `json:"model,omitempty"`
	ReasoningEffort string `json:"reasoning_effort,omitempty"`
}

type AgentEffectiveRuntimePayload

type AgentEffectiveRuntimePayload struct {
	SessionEnvStatus []SettingsProviderCredentialStatusPayload `json:"session_env_status,omitempty"`
	SessionEnv       map[string]SessionEnvBindingPayload       `json:"session_env,omitempty"`
	Provider         string                                    `json:"provider"`
	Model            string                                    `json:"model,omitempty"`
	ReasoningEffort  ReasoningEffort                           `json:"reasoning_effort,omitempty"`
	Speed            Speed                                     `json:"speed,omitempty"`
	ACPOptions       []AgentACPOptionSelection                 `json:"acp_options,omitempty"`
	Sources          AgentEffectiveRuntimeSources              `json:"sources"`
}

AgentEffectiveRuntimePayload is the workspace-scoped runtime projection for one authored agent definition.

type AgentEffectiveRuntimeSources

type AgentEffectiveRuntimeSources struct {
	Provider        AgentRuntimeValueSource `json:"provider"`
	Model           AgentRuntimeValueSource `json:"model,omitempty"`
	ReasoningEffort AgentRuntimeValueSource `json:"reasoning_effort,omitempty"`
	Speed           AgentRuntimeValueSource `json:"speed,omitempty"`
}

AgentEffectiveRuntimeSources reports provenance for effective agent runtime values.

type AgentEventPayload

type AgentEventPayload struct {
	Origin            *PromptOriginMeta            `json:"origin,omitzero"`
	Type              string                       `json:"type"`
	SessionID         string                       `json:"session_id,omitempty"`
	TurnID            string                       `json:"turn_id,omitempty"`
	MessageID         string                       `json:"message_id,omitempty"`
	RequestID         string                       `json:"request_id,omitempty"`
	Timestamp         time.Time                    `json:"timestamp"`
	Text              string                       `json:"text,omitempty"`
	Title             string                       `json:"title,omitempty"`
	ToolCallID        string                       `json:"tool_call_id,omitempty"`
	StopReason        string                       `json:"stop_reason,omitempty"`
	PromptStopReason  ACPPromptStopReason          `json:"prompt_stop_reason,omitempty"`
	AvailableCommands []ACPAvailableCommandPayload `json:"available_commands,omitempty"`
	Action            string                       `json:"action,omitempty"`
	Resource          string                       `json:"resource,omitempty"`
	Decision          string                       `json:"decision,omitempty"`
	Error             string                       `json:"error,omitempty"`
	Failure           *SessionFailurePayload       `json:"failure,omitzero"`
	ProviderError     *acp.ProviderErrorDiagnostic `json:"provider_error,omitzero"`
	Goal              *GoalPromptMeta              `json:"goal,omitzero"`
	Delivery          *acp.DeliveryManifest        `json:"delivery,omitzero"`
	Usage             *TokenUsagePayload           `json:"usage,omitzero"`
	Compaction        *CompactionSnapshotPayload   `json:"compaction,omitzero"`
	Runtime           *RuntimeActivityPayload      `json:"runtime,omitzero"`
	PromptRuntime     *RuntimeSelectionPayload     `json:"prompt_runtime,omitzero"`
	Raw               json.RawMessage              `json:"raw,omitempty"`
}

AgentEventPayload is the shared raw agent-event streaming payload.

type AgentFallbackRoutePayload

type AgentFallbackRoutePayload struct {
	SessionEnv      map[string]SessionEnvBindingPayload `json:"session_env,omitempty"`
	Provider        string                              `json:"provider"`
	Model           string                              `json:"model"`
	ReasoningEffort ReasoningEffort                     `json:"reasoning_effort,omitempty"`
	Speed           Speed                               `json:"speed,omitempty"`
	ACPOptions      []AgentACPOptionSelection           `json:"acp_options,omitempty"`
	Command         string                              `json:"command,omitempty"`
}

AgentFallbackRoutePayload is one authored agent fallback route.

type AgentIdentityPayload

type AgentIdentityPayload struct {
	SessionID string `json:"session_id"`
	AgentName string `json:"agent_name"`
	Provider  string `json:"provider"`
	Model     string `json:"model,omitempty"`
}

AgentIdentityPayload describes the daemon-authenticated caller identity.

type AgentInstanceAdoptRequest

type AgentInstanceAdoptRequest struct {
	Agent     string `json:"agent"`
	SessionID string `json:"session_id"`
}

type AgentInstanceAwayResponse

type AgentInstanceAwayResponse struct {
	LastSeenAt    *time.Time                   `json:"last_seen_at"`
	QuietCheckIns int                          `json:"quiet_check_ins"`
	Reports       []AgentInstanceReportPayload `json:"reports"`
}

type AgentInstanceCheckDigest

type AgentInstanceCheckDigest struct {
	Key     string `json:"key"`
	Summary string `json:"summary"`
}

type AgentInstanceCheckInPayload

type AgentInstanceCheckInPayload struct {
	ID        string    `json:"id"`
	Result    string    `json:"result"`
	Reason    string    `json:"reason"`
	Detail    string    `json:"detail,omitempty"`
	CreatedAt time.Time `json:"created_at"`
}

type AgentInstanceCheckInsResponse

type AgentInstanceCheckInsResponse struct {
	CheckIns   []AgentInstanceCheckInPayload `json:"check_ins"`
	NextCursor string                        `json:"next_cursor"`
}

type AgentInstanceCheckRequest

type AgentInstanceCheckRequest struct {
	DryRun bool `json:"dry_run"`
}

type AgentInstanceCheckResponse

type AgentInstanceCheckResponse struct {
	Gate         string                     `json:"gate,omitempty"`
	OccurrenceID string                     `json:"occurrence_id,omitempty"`
	Digest       []AgentInstanceCheckDigest `json:"digest"`
}

type AgentInstanceCreateRequest

type AgentInstanceCreateRequest struct {
	Agent     string `json:"agent"`
	Workspace string `json:"workspace"`
}

type AgentInstanceListResponse

type AgentInstanceListResponse struct {
	Peers              []AgentInstancePeer    `json:"peers,omitempty"`
	MaxActiveInstances int                    `json:"max_active_instances"`
	ActiveCount        int64                  `json:"active_count"`
	Instances          []AgentInstancePayload `json:"instances"`
	NextCursor         string                 `json:"next_cursor"`
}

type AgentInstanceNextWake

type AgentInstanceNextWake struct {
	Kind        string `json:"kind"`
	At          string `json:"at,omitempty"`
	Description string `json:"description"`
}

type AgentInstanceOccurrenceResponse

type AgentInstanceOccurrenceResponse struct {
	State    string `json:"state"`
	Result   string `json:"result,omitempty"`
	Reason   string `json:"reason,omitempty"`
	ReportID string `json:"report_id,omitempty"`
}

type AgentInstancePayload

type AgentInstancePayload struct {
	UnattendedTurns     int64                  `json:"unattended_turns"`
	UnattendedTurnLimit int64                  `json:"unattended_turn_limit"`
	HeldWakes           int64                  `json:"held_wakes"`
	NextWake            *AgentInstanceNextWake `json:"next_wake,omitempty"`
	Created             bool                   `json:"created"`
	ChecksEnabled       bool                   `json:"checks_enabled"`
	LastWakeAt          string                 `json:"last_wake_at"`
	NextWakeAt          string                 `json:"next_wake_at"`
	QuietStreak         int64                  `json:"quiet_streak"`
	FailureStreak       int64                  `json:"failure_streak"`
	FatigueLimit        int                    `json:"fatigue_limit"`
	Label               string                 `json:"label"`
	Provider            string                 `json:"provider"`
	ResolvedAppearance  map[string]any         `json:"resolved_appearance"`
	Scope               string                 `json:"scope"`
	Activity            string                 `json:"activity"`
	Now                 string                 `json:"now"`
	NeedsAttention      bool                   `json:"needs_attention"`
	ID                  string                 `json:"id"`
	ProfileID           string                 `json:"profile_id"`
	AgentName           string                 `json:"agent_name"`
	WorkspaceID         string                 `json:"workspace_id"`
	State               string                 `json:"state"`
	PauseReason         string                 `json:"pause_reason"`
	MainSessionID       string                 `json:"main_session_id"`
	CreatedAt           time.Time              `json:"created_at"`
	UpdatedAt           time.Time              `json:"updated_at"`
}

type AgentInstancePeer

type AgentInstancePeer struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Scope       string `json:"scope"`
	State       string `json:"state"`
}

type AgentInstanceProposal

type AgentInstanceProposal struct {
	Sources  []AgentInstanceProposalSource `json:"sources,omitempty"`
	Title    string                        `json:"title"`
	Body     string                        `json:"body"`
	ItemKeys []string                      `json:"item_keys"`
}

type AgentInstanceProposalSource

type AgentInstanceProposalSource struct {
	Kind       string `json:"kind"`
	EventID    string `json:"event_id"`
	TriggerID  string `json:"trigger_id"`
	RunID      string `json:"run_id"`
	ReceivedAt string `json:"received_at"`
}

AgentInstanceProposalSource identifies daemon-observed input to a proactive proposal.

type AgentInstanceReportPayload

type AgentInstanceReportPayload struct {
	Source        *AgentInstanceReportSource `json:"source,omitempty"`
	Action        string                     `json:"action,omitempty"`
	Resource      string                     `json:"resource,omitempty"`
	SkillReviewID string                     `json:"skill_review_id,omitempty"`
	ID            string                     `json:"id"`
	Kind          string                     `json:"kind"`
	State         string                     `json:"state"`
	Proposals     []AgentInstanceProposal    `json:"proposals,omitempty"`
	Reason        string                     `json:"reason,omitempty"`
	Detail        string                     `json:"detail,omitempty"`
	SessionID     string                     `json:"session_id,omitempty"`
	Tool          string                     `json:"tool,omitempty"`
	ExpiredBy     string                     `json:"expired_by,omitempty"`
	Cause         string                     `json:"cause,omitempty"`
	Since         string                     `json:"since,omitempty"`
	CreatedAt     time.Time                  `json:"created_at"`
}

type AgentInstanceReportSource

type AgentInstanceReportSource struct {
	Kind        string `json:"kind"`
	TriggerName string `json:"trigger_name"`
	Event       string `json:"event"`
	Summary     string `json:"summary,omitempty"`
}

AgentInstanceReportSource is daemon-owned provenance for an event-derived proposal.

type AgentInstanceReportsResponse

type AgentInstanceReportsResponse struct {
	Reports    []AgentInstanceReportPayload `json:"reports"`
	NextCursor string                       `json:"next_cursor"`
}

type AgentInstanceResponse

type AgentInstanceResponse struct {
	Instance AgentInstancePayload `json:"instance"`
}

type AgentInstanceSeenResponse

type AgentInstanceSeenResponse struct {
	LastSeenAt time.Time `json:"last_seen_at"`
}

type AgentInstanceUpdateRequest

type AgentInstanceUpdateRequest struct {
	ChecksEnabled *bool `json:"checks_enabled"`
}

type AgentLimitsPayload

type AgentLimitsPayload struct {
	MaxChildren           int    `json:"max_children"`
	MaxSpawnDepth         int    `json:"max_spawn_depth"`
	MaxActivePerWorkspace int    `json:"max_active_per_workspace,omitempty"`
	GovernedSpawnDepth    int    `json:"governed_spawn_depth"`
	CanSpawnChildren      bool   `json:"can_spawn_children"`
	SpawnBlockedReason    string `json:"spawn_blocked_reason,omitempty"`
	MaxActiveTaskLeases   int    `json:"max_active_task_leases"`
	ContextSectionLimit   int    `json:"context_section_limit"`
}

AgentLimitsPayload reports safe runtime limits relevant to agent decisions. The spawn fields describe the calling session's own effective budget for governed children; GovernedSpawnDepth is the depth compared to MaxSpawnDepth, not lineage spawn_depth.

type AgentMCPServerJSON

type AgentMCPServerJSON struct {
	Name      string                            `json:"name"`
	Transport string                            `json:"transport,omitempty"`
	Command   string                            `json:"command,omitempty"`
	Args      []string                          `json:"args,omitempty"`
	Env       map[string]string                 `json:"env,omitempty"`
	SecretEnv map[string]string                 `json:"secret_env,omitempty"`
	URL       string                            `json:"url,omitempty"`
	Auth      *SettingsMCPAuthConfigViewPayload `json:"auth,omitzero"`
}

AgentMCPServerJSON is the shared MCP server response payload.

type AgentMePayload

type AgentMePayload struct {
	Self             AgentIdentityPayload         `json:"self"`
	Workspace        AgentWorkspacePayload        `json:"workspace"`
	Session          AgentSessionPayload          `json:"session"`
	Capabilities     []AgentCapabilityPayload     `json:"capabilities"`
	ActiveTaskLeases []TaskRunLeaseSummaryPayload `json:"active_task_leases"`
	Coordinator      CoordinatorConfigPayload     `json:"coordinator"`
	Limits           AgentLimitsPayload           `json:"limits"`
}

AgentMePayload is the compact caller state returned by `/agent/me`.

func NormalizeAgentMePayload

func NormalizeAgentMePayload(payload AgentMePayload) AgentMePayload

NormalizeAgentMePayload returns a payload with nil list sections converted to empty arrays.

type AgentMeResponse

type AgentMeResponse struct {
	Me AgentMePayload `json:"me"`
}

AgentMeResponse wraps the resolved caller payload.

type AgentMemoryAddRequest

type AgentMemoryAddRequest struct {
	Text  string `json:"text"`
	Until string `json:"until,omitempty"`
}

type AgentMemoryBudget

type AgentMemoryBudget struct {
	Lines    int `json:"lines"`
	MaxLines int `json:"max_lines"`
	Bytes    int `json:"bytes"`
	MaxBytes int `json:"max_bytes"`
}

Agent memory surfaces are experimental for one release.

type AgentMemoryDocument

type AgentMemoryDocument struct {
	Content string            `json:"content"`
	Digest  string            `json:"digest"`
	Budget  AgentMemoryBudget `json:"budget"`
}

type AgentMemoryHistoryResponse

type AgentMemoryHistoryResponse struct {
	Revisions []AgentMemoryRevision `json:"revisions"`
}

type AgentMemoryRemoveRequest

type AgentMemoryRemoveRequest struct {
	Match string `json:"match"`
}

type AgentMemoryRemoveResponse

type AgentMemoryRemoveResponse struct {
	Digest  string `json:"digest"`
	Removed int    `json:"removed"`
}

type AgentMemoryReplaceRequest

type AgentMemoryReplaceRequest struct {
	Match string `json:"match"`
	Text  string `json:"text"`
}

type AgentMemoryRevision

type AgentMemoryRevision struct {
	ID     string `json:"id"`
	Digest string `json:"digest"`
}

type AgentMemoryRollbackRequest

type AgentMemoryRollbackRequest struct {
	Revision string `json:"revision"`
}

type AgentMemorySearchRequest

type AgentMemorySearchRequest struct {
	Query           string `json:"query"`
	IncludeSessions bool   `json:"include_sessions,omitempty"`
}

type AgentMemorySearchResponse

type AgentMemorySearchResponse struct {
	Results []AgentMemorySearchResult `json:"results"`
}

type AgentMemorySearchResult

type AgentMemorySearchResult struct {
	Source    string  `json:"source"`
	Text      string  `json:"text"`
	File      string  `json:"file,omitempty"`
	Line      int     `json:"line,omitempty"`
	Score     float64 `json:"score,omitempty"`
	SessionID string  `json:"session_id,omitempty"`
}

type AgentMemoryValidateRequest

type AgentMemoryValidateRequest struct {
	Content string `json:"content"`
}

type AgentMemoryValidateResponse

type AgentMemoryValidateResponse struct {
	Valid       bool     `json:"valid"`
	Diagnostics []string `json:"diagnostics"`
}

type AgentMemoryWriteRequest

type AgentMemoryWriteRequest struct {
	Content        string `json:"content"`
	ExpectedDigest string `json:"expected_digest"`
}

type AgentNotifyRequest

type AgentNotifyRequest struct {
	Title string `json:"title"`
	Body  string `json:"body,omitempty"`
}

type AgentNotifyResponse

type AgentNotifyResponse struct {
	Outcome      string `json:"outcome"`
	RetryAfterMS int64  `json:"retry_after_ms,omitzero"`
}

type AgentOrigin

type AgentOrigin string

AgentOrigin identifies the authored root that owns an effective definition.

const (
	// AgentOriginGlobal identifies a definition stored under COMPOZY_HOME.
	AgentOriginGlobal AgentOrigin = "global"
	// AgentOriginWorkspace identifies a definition stored under a workspace root.
	AgentOriginWorkspace AgentOrigin = "workspace"
)

type AgentPayload

type AgentPayload struct {
	DisplayName string         `json:"display_name,omitempty"`
	Description string         `json:"description,omitempty"`
	Kind        string         `json:"kind,omitempty"`
	Appearance  map[string]any `json:"appearance,omitempty"`

	Label              string         `json:"label"`
	ResolvedAppearance map[string]any `json:"resolved_appearance"`

	SessionEnv       map[string]SessionEnvBindingPayload `json:"session_env,omitempty"`
	Name             string                              `json:"name"`
	Provider         string                              `json:"provider"`
	Command          string                              `json:"command,omitempty"`
	Model            string                              `json:"model,omitempty"`
	ReasoningEffort  ReasoningEffort                     `json:"reasoning_effort,omitempty"`
	Speed            Speed                               `json:"speed,omitempty"`
	ACPOptions       []AgentACPOptionSelection           `json:"acp_options,omitempty"`
	Tools            []string                            `json:"tools,omitempty"`
	Toolsets         []string                            `json:"toolsets,omitempty"`
	DenyTools        []string                            `json:"deny_tools,omitempty"`
	SessionApproval  string                              `json:"session_approval,omitempty"`
	PermissionRules  []AgentPermissionRulePayload        `json:"permission_rules,omitempty"`
	WorkspaceAccess  string                              `json:"workspace_access,omitempty"`
	Permissions      string                              `json:"permissions,omitempty"`
	CategoryPath     []string                            `json:"category_path,omitempty"`
	MCPServers       []AgentMCPServerJSON                `json:"mcp_servers,omitempty"`
	Origin           AgentOrigin                         `json:"origin"`
	PackageOwned     bool                                `json:"package_owned,omitempty"`
	WorkspaceID      string                              `json:"workspace_id,omitempty"`
	Layer            string                              `json:"layer,omitempty"`
	Shadows          []AgentDefinitionShadowPayload      `json:"shadows,omitempty"`
	Skills           *CreateAgentSkillsConfig            `json:"skills,omitzero"`
	FallbackChain    []RoleFallbackStatus                `json:"fallback_chain,omitempty"`
	DefinitionDigest string                              `json:"definition_digest"`
	Prompt           string                              `json:"prompt"`
	Diagnostics      []AgentDiagnosticPayload            `json:"diagnostics,omitempty"`
	EffectiveRuntime *AgentEffectiveRuntimePayload       `json:"effective_runtime,omitzero"`
}

AgentPayload is the shared agent definition response payload.

type AgentPermissionRulePayload

type AgentPermissionRulePayload struct {
	Kind     string `json:"kind,omitempty"`
	Path     string `json:"path,omitempty"`
	Decision string `json:"decision"`
}

AgentPermissionRulePayload matches only provider actions submitted for approval.

type AgentProbeHealthPayload

type AgentProbeHealthPayload struct {
	AgentName  string    `json:"agent_name,omitempty"`
	Provider   string    `json:"provider,omitempty"`
	Command    string    `json:"command,omitempty"`
	Executable string    `json:"executable,omitempty"`
	Status     string    `json:"status"`
	Error      string    `json:"error,omitempty"`
	CheckedAt  time.Time `json:"checked_at"`
	DurationMS int64     `json:"duration_ms"`
}

AgentProbeHealthPayload exposes one downstream ACP command probe result.

type AgentResponse

type AgentResponse struct {
	Agent AgentPayload `json:"agent"`
}

AgentResponse wraps one shared agent payload.

type AgentRuntimeValueSource

type AgentRuntimeValueSource string

AgentRuntimeValueSource identifies the authored/default layer that supplied one effective runtime value.

const (
	AgentRuntimeValueSourceAgent           AgentRuntimeValueSource = "agent"
	AgentRuntimeValueSourceProjectDefault  AgentRuntimeValueSource = "project_default"
	AgentRuntimeValueSourceProviderDefault AgentRuntimeValueSource = "provider_default"
	AgentRuntimeValueSourceModelDefault    AgentRuntimeValueSource = "model_default"
)

type AgentSessionMetricsPayload

type AgentSessionMetricsPayload struct {
	Total          int        `json:"total"`
	Active         int        `json:"active"`
	Failed         int        `json:"failed"`
	RuntimeSeconds int64      `json:"runtime_seconds"`
	LastActivityAt *time.Time `json:"last_activity_at,omitempty"`
}

AgentSessionMetricsPayload contains exact visible-session aggregates for one agent.

type AgentSessionPayload

type AgentSessionPayload struct {
	ID        string                 `json:"id"`
	Name      string                 `json:"name,omitempty"`
	Type      session.Type           `json:"type,omitempty"`
	State     session.State          `json:"state"`
	Lineage   *SessionLineagePayload `json:"lineage,omitzero"`
	CreatedAt time.Time              `json:"created_at"`
	UpdatedAt time.Time              `json:"updated_at"`
}

AgentSessionPayload is the compact session context used by agent endpoints.

func NormalizeAgentSessionPayload

func NormalizeAgentSessionPayload(payload AgentSessionPayload) AgentSessionPayload

NormalizeAgentSessionPayload clones nested snapshots and normalizes lineage lists.

type AgentSkillAutomaticContents

type AgentSkillAutomaticContents struct {
	Hooks      int `json:"hooks"`
	MCPServers int `json:"mcp_servers"`
	Scripts    int `json:"scripts"`
}

type AgentSkillDraftFile

type AgentSkillDraftFile struct {
	Path    string `json:"path"`
	Content string `json:"content"`
}

Agent skill review surfaces are experimental.

type AgentSkillProposeRequest

type AgentSkillProposeRequest struct {
	Name               string                `json:"name"`
	Description        string                `json:"description"`
	Body               string                `json:"body"`
	Files              []AgentSkillDraftFile `json:"files,omitempty"`
	EvidenceSessionIDs []string              `json:"evidence_session_ids,omitempty"`
}

type AgentSkillReviewDecisionRequest

type AgentSkillReviewDecisionRequest struct {
	Digest string `json:"digest"`
}

type AgentSkillReviewPayload

type AgentSkillReviewPayload struct {
	ID                string                      `json:"id"`
	InstanceID        string                      `json:"instance_id"`
	ProfileID         string                      `json:"profile_id"`
	WorkspaceID       string                      `json:"workspace_id"`
	Agent             string                      `json:"agent"`
	Name              string                      `json:"name"`
	State             string                      `json:"state"`
	Digest            string                      `json:"digest"`
	RunsAutomatically AgentSkillAutomaticContents `json:"runs_automatically"`
	Files             []AgentSkillDraftFile       `json:"files,omitempty"`
	CreatedAt         time.Time                   `json:"created_at"`
	DecidedAt         *time.Time                  `json:"decided_at,omitempty"`
	DecidedBy         string                      `json:"decided_by,omitempty"`
	// Problem is set when the stored draft no longer verifies: `skill_review_invalid`. The review then
	// carries no files and no automatic contents, and it can only be rejected.
	Problem string `json:"problem,omitempty"`
}

type AgentSkillReviewResponse

type AgentSkillReviewResponse struct {
	Review AgentSkillReviewPayload `json:"review"`
}

type AgentSkillReviewsResponse

type AgentSkillReviewsResponse struct {
	Reviews    []AgentSkillReviewPayload `json:"reviews"`
	NextCursor string                    `json:"next_cursor,omitempty"`
}

type AgentSoulConfigProvenancePayload

type AgentSoulConfigProvenancePayload struct {
	Digest                 string `json:"digest"`
	Source                 string `json:"source,omitempty"`
	Enabled                bool   `json:"enabled"`
	MaxBodyBytes           int64  `json:"max_body_bytes"`
	ContextProjectionBytes int64  `json:"context_projection_bytes"`
}

AgentSoulConfigProvenancePayload reports the Soul config subset that shaped a read model.

func AgentSoulConfigProvenancePayloadFromDomain

func AgentSoulConfigProvenancePayloadFromDomain(
	provenance soulpkg.ConfigProvenance,
) AgentSoulConfigProvenancePayload

AgentSoulConfigProvenancePayloadFromDomain converts Soul config provenance into the public DTO.

type AgentSoulDeleteByPathRequest

type AgentSoulDeleteByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	ExpectedDigest string `json:"expected_digest"`
}

AgentSoulDeleteByPathRequest removes SOUL.md for the route agent.

type AgentSoulDeleteRequest

type AgentSoulDeleteRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	ExpectedDigest string `json:"expected_digest"`
}

AgentSoulDeleteRequest removes SOUL.md through the managed authoring service.

type AgentSoulFrontmatterPayload

type AgentSoulFrontmatterPayload struct {
	Version       string   `json:"version,omitempty"`
	Role          string   `json:"role,omitempty"`
	Tone          []string `json:"tone,omitempty"`
	Principles    []string `json:"principles,omitempty"`
	Constraints   []string `json:"constraints,omitempty"`
	Collaboration []string `json:"collaboration,omitempty"`
	Tags          []string `json:"tags,omitempty"`
}

AgentSoulFrontmatterPayload is the allowlisted strict SOUL.md metadata projection.

type AgentSoulHistoryRequest

type AgentSoulHistoryRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	AgentName   string `json:"agent_name"`
	Limit       int    `json:"limit,omitempty"`
	Cursor      string `json:"cursor,omitempty"`
}

AgentSoulHistoryRequest lists managed SOUL.md authoring revisions.

type AgentSoulHistoryResponse

type AgentSoulHistoryResponse struct {
	Revisions  []AgentSoulRevisionPayload `json:"revisions"`
	NextCursor string                     `json:"next_cursor,omitempty"`
}

AgentSoulHistoryResponse returns bounded SOUL.md authoring history.

type AgentSoulMutationResponse

type AgentSoulMutationResponse struct {
	Soul     AgentSoulPayload         `json:"soul"`
	Revision AgentSoulRevisionPayload `json:"revision"`
}

AgentSoulMutationResponse returns the post-mutation read model and audit row.

type AgentSoulPayload

type AgentSoulPayload struct {
	AgentName        string                             `json:"agent_name,omitempty"`
	Enabled          bool                               `json:"enabled"`
	Present          bool                               `json:"present"`
	Active           bool                               `json:"active"`
	Valid            bool                               `json:"valid"`
	ValidationStatus AuthoredValidationStatus           `json:"validation_status"`
	SnapshotID       string                             `json:"snapshot_id,omitempty"`
	RevisionID       string                             `json:"revision_id,omitempty"`
	Digest           string                             `json:"digest,omitempty"`
	SourcePath       string                             `json:"source_path,omitempty"`
	Frontmatter      AgentSoulFrontmatterPayload        `json:"frontmatter"`
	Body             string                             `json:"body,omitempty"`
	Truncated        bool                               `json:"truncated,omitempty"`
	Limits           AuthoredContextLimitsPayload       `json:"limits"`
	ConfigProvenance AgentSoulConfigProvenancePayload   `json:"config_provenance"`
	Diagnostics      []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
	CreatedAt        *time.Time                         `json:"created_at,omitempty"`
}

AgentSoulPayload is the full resolved Soul read model for dedicated inspect/authoring surfaces.

func AgentSoulPayloadFromResolved

func AgentSoulPayloadFromResolved(
	agentName string,
	resolved *soulpkg.ResolvedSoul,
	snapshotID string,
	configProvenance soulpkg.ConfigProvenance,
) AgentSoulPayload

AgentSoulPayloadFromResolved converts a resolver result into the full Soul read model.

type AgentSoulPutByPathRequest

type AgentSoulPutByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	Body           string `json:"body"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

AgentSoulPutByPathRequest creates or replaces SOUL.md for the route agent.

type AgentSoulPutRequest

type AgentSoulPutRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	Body           string `json:"body"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

AgentSoulPutRequest creates or replaces SOUL.md through the managed authoring service.

type AgentSoulRevisionAction

type AgentSoulRevisionAction string

AgentSoulRevisionAction describes one managed SOUL.md authoring mutation.

const (
	AgentSoulRevisionPut      AgentSoulRevisionAction = "put"
	AgentSoulRevisionDelete   AgentSoulRevisionAction = "delete"
	AgentSoulRevisionRollback AgentSoulRevisionAction = "rollback"
)

type AgentSoulRevisionPayload

type AgentSoulRevisionPayload struct {
	ID             string                             `json:"id"`
	AgentName      string                             `json:"agent_name"`
	SourcePath     string                             `json:"source_path"`
	Action         AgentSoulRevisionAction            `json:"action"`
	PreviousDigest string                             `json:"previous_digest,omitempty"`
	NewDigest      string                             `json:"new_digest,omitempty"`
	Diagnostics    []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
	Actor          AuthoredContextActorPayload        `json:"actor"`
	Origin         *AuthoredContextActorPayload       `json:"origin,omitempty"`
	CreatedAt      time.Time                          `json:"created_at"`
}

AgentSoulRevisionPayload is a redacted SOUL.md authoring history row.

func AgentSoulRevisionPayloadFromDomain

func AgentSoulRevisionPayloadFromDomain(revision soulpkg.Revision) (AgentSoulRevisionPayload, error)

AgentSoulRevisionPayloadFromDomain converts a Soul authoring revision into the public DTO.

type AgentSoulRollbackByPathRequest

type AgentSoulRollbackByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	RevisionID     string `json:"revision_id"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

AgentSoulRollbackByPathRequest restores a prior SOUL.md revision for the route agent.

type AgentSoulRollbackRequest

type AgentSoulRollbackRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	RevisionID     string `json:"revision_id"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

AgentSoulRollbackRequest restores a prior SOUL.md revision through the managed authoring service.

type AgentSoulSectionPayload

type AgentSoulSectionPayload struct {
	Enabled          bool                     `json:"enabled"`
	Present          bool                     `json:"present"`
	Active           bool                     `json:"active"`
	Valid            bool                     `json:"valid"`
	ValidationStatus AuthoredValidationStatus `json:"validation_status,omitempty"`
	SnapshotID       string                   `json:"snapshot_id,omitempty"`
	Digest           string                   `json:"digest,omitempty"`
	ConfigDigest     string                   `json:"config_digest,omitempty"`
	SourcePath       string                   `json:"source_path,omitempty"`
	Role             string                   `json:"role,omitempty"`
	Tone             []string                 `json:"tone"`
	Principles       []string                 `json:"principles"`
	Truncated        bool                     `json:"truncated,omitempty"`
	MaxBytes         int64                    `json:"max_bytes,omitempty"`
	MaxBodyBytes     int64                    `json:"max_body_bytes,omitempty"`
}

AgentSoulSectionPayload is the compact, context-safe Soul projection for `/agent/context`.

func AgentSoulSectionPayloadFromResolved

func AgentSoulSectionPayloadFromResolved(
	resolved *soulpkg.ResolvedSoul,
	snapshotID string,
	configProvenance soulpkg.ConfigProvenance,
) AgentSoulSectionPayload

AgentSoulSectionPayloadFromResolved converts a resolver result into the compact context projection.

type AgentSoulValidateByPathRequest

type AgentSoulValidateByPathRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	Body        string `json:"body,omitempty"`
}

AgentSoulValidateByPathRequest validates SOUL.md for the route agent.

type AgentSoulValidateRequest

type AgentSoulValidateRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	AgentName   string `json:"agent_name,omitempty"`
	Body        string `json:"body,omitempty"`
}

AgentSoulValidateRequest validates a proposed SOUL.md body or the current file.

type AgentSpawnPayload

type AgentSpawnPayload struct {
	Session     SessionPayload               `json:"session"`
	Lineage     SessionLineagePayload        `json:"lineage"`
	Permissions SpawnPermissionPolicyPayload `json:"permissions"`
	Worktree    *SpawnWorktreePayload        `json:"worktree,omitzero"`
	Prompt      *SpawnPromptPayload          `json:"prompt,omitzero"`
}

AgentSpawnPayload is the safe spawn response projection.

type AgentSpawnRequest

type AgentSpawnRequest struct {
	AgentName        string                        `json:"agent_name"`
	Provider         string                        `json:"provider,omitempty"`
	Model            string                        `json:"model,omitempty"`
	ReasoningEffort  ReasoningEffort               `json:"reasoning_effort,omitempty"`
	Speed            Speed                         `json:"speed,omitempty"`
	ACPOptions       []AgentACPOptionSelection     `json:"acp_options,omitempty"`
	Name             string                        `json:"name,omitempty"`
	Workspace        string                        `json:"workspace,omitempty"`
	PromptOverlay    string                        `json:"prompt_overlay,omitempty"`
	SpawnRole        string                        `json:"spawn_role"`
	TTLSeconds       int64                         `json:"ttl_seconds"`
	AutoStopOnParent bool                          `json:"auto_stop_on_parent"`
	NotifyCreator    *bool                         `json:"notify_creator,omitzero"`
	Permissions      SpawnPermissionRequestPayload `json:"permissions"`
	// InheritPermissions starts from the caller's grant; permission lists that are
	// present replace only their own category.
	InheritPermissions bool `json:"inherit_permissions,omitempty"`
	// Toolsets selects caller-granted tools by toolset ID.
	Toolsets []string `json:"toolsets,omitempty"`
	// Worktree binds an existing ready worktree of the child workspace.
	Worktree string `json:"worktree,omitempty"`
	// NewWorktree creates and binds a managed worktree; exclusive with Worktree.
	NewWorktree *SpawnNewWorktreeRequest `json:"new_worktree,omitzero"`
	// Prompt is the child's first prompt, sent from the caller with notify_on_complete.
	Prompt         string `json:"prompt,omitempty"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

AgentSpawnRequest asks the daemon to create a narrowed child session.

type AgentSpawnResponse

type AgentSpawnResponse struct {
	Spawn AgentSpawnPayload `json:"spawn"`
}

AgentSpawnResponse wraps a safe spawn result.

type AgentTaskClaimNextRequest

type AgentTaskClaimNextRequest struct {
	RunID                string   `json:"run_id,omitempty"`
	WorkspaceID          string   `json:"workspace_id,omitempty"`
	RequiredCapabilities []string `json:"required_capabilities,omitempty"`
	PriorityMin          int      `json:"priority_min,omitzero"`
	LeaseSeconds         int64    `json:"lease_seconds,omitzero"`
	Wait                 bool     `json:"wait,omitzero"`
	IdempotencyKey       string   `json:"idempotency_key,omitempty"`
}

AgentTaskClaimNextRequest captures the agent-initiated atomic next-work request.

type AgentTaskClaimPayload

type AgentTaskClaimPayload struct {
	Task  TaskReferencePayload       `json:"task"`
	Run   TaskRunPayload             `json:"run"`
	Lease TaskRunLeaseSummaryPayload `json:"lease"`
}

AgentTaskClaimPayload is the synchronous claim response for the session-bound lease.

type AgentTaskClaimResponse

type AgentTaskClaimResponse struct {
	Claim AgentTaskClaimPayload `json:"claim"`
}

AgentTaskClaimResponse wraps the synchronous task claim response.

type AgentTaskCompleteRequest

type AgentTaskCompleteRequest struct {
	Result         json.RawMessage `json:"result,omitempty"`
	CreatedTaskIDs []string        `json:"created_task_ids,omitempty"`
}

AgentTaskCompleteRequest completes the caller session's claimed task run.

type AgentTaskContextPayload

type AgentTaskContextPayload struct {
	Available bool                        `json:"available"`
	Task      *TaskReferencePayload       `json:"task,omitzero"`
	Lease     *TaskRunLeaseSummaryPayload `json:"lease,omitzero"`
	Bundle    *taskpkg.ContextBundle      `json:"bundle,omitzero"`
}

AgentTaskContextPayload is the bounded active-task section in `/agent/context`.

type AgentTaskFailRequest

type AgentTaskFailRequest struct {
	Error    string          `json:"error"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

AgentTaskFailRequest fails the caller session's claimed task run.

type AgentTaskHeartbeatRequest

type AgentTaskHeartbeatRequest struct {
	LeaseSeconds int64 `json:"lease_seconds,omitzero"`
}

AgentTaskHeartbeatRequest extends the caller session's task-run lease.

type AgentTaskLeaseResponse

type AgentTaskLeaseResponse struct {
	Lease TaskRunLeaseSummaryPayload `json:"lease"`
}

AgentTaskLeaseResponse wraps a safe task-run lease projection.

type AgentTaskReleaseRequest

type AgentTaskReleaseRequest struct {
	Reason string `json:"reason,omitempty"`
}

AgentTaskReleaseRequest releases the caller session's claimed task run.

type AgentWorkspacePayload

type AgentWorkspacePayload struct {
	ID      string `json:"id,omitempty"`
	Name    string `json:"name,omitempty"`
	RootDir string `json:"root_dir,omitempty"`
}

AgentWorkspacePayload is the compact workspace context used by agent endpoints.

type AgentsResponse

type AgentsResponse struct {
	Agents []AgentPayload `json:"agents"`
}

AgentsResponse wraps the shared agent list payload.

type AppTokenIssuedResponse

type AppTokenIssuedResponse struct {
	AppToken AppTokenPayload `json:"app_token"`
	Token    string          `json:"token"`
}

type AppTokenPayload

type AppTokenPayload struct {
	ID         string     `json:"id"`
	Name       string     `json:"name"`
	Origins    []string   `json:"origins"`
	CreatedAt  time.Time  `json:"created_at"`
	LastUsedAt *time.Time `json:"last_used_at"`
	RevokedAt  *time.Time `json:"revoked_at"`
}

type AppTokenResponse

type AppTokenResponse struct {
	AppToken AppTokenPayload `json:"app_token"`
}

type AppTokenRevokeResponse

type AppTokenRevokeResponse struct {
	AppToken AppTokenPayload `json:"app_token"`
	Changed  bool            `json:"changed"`
	Canceled int             `json:"canceled"`
}

type AppTokensResponse

type AppTokensResponse struct {
	AppTokens []AppTokenPayload `json:"app_tokens"`
}

type ApproveLoopRunRequest

type ApproveLoopRunRequest struct {
	GateID   string           `json:"gate_id"`
	Decision LoopGateDecision `json:"decision"`
}

ApproveLoopRunRequest applies a human-gate decision.

type ApproveSessionRequest

type ApproveSessionRequest struct {
	RequestID string `json:"request_id"`
	TurnID    string `json:"turn_id"`
	Decision  string `json:"decision"`
}

ApproveSessionRequest is the interactive permission approval payload.

type ArchiveProfilePlan

type ArchiveProfilePlan struct {
	Revision           string   `json:"revision"`
	RunningSessions    []string `json:"running_sessions"`
	ApprovalBlockers   []string `json:"approval_blockers"`
	LeasedRuns         int      `json:"leased_runs"`
	QueuedRunsToFreeze int      `json:"queued_runs_to_freeze"`
	AutomationsToPause []string `json:"automations_to_pause"`
}

ArchiveProfilePlan previews the resources affected by archiving a profile.

type ArchiveProfileResponse

type ArchiveProfileResponse struct {
	State             string   `json:"state"`
	PausedAutomations []string `json:"paused_automations"`
	FrozenQueuedRuns  int      `json:"frozen_queued_runs"`
}

ArchiveProfileResponse reports the outcome of archiving a profile.

type AttachSessionRequest

type AttachSessionRequest struct {
	AttachedTo string `json:"attached_to,omitempty"`
	TTLSeconds int    `json:"ttl_seconds,omitzero"`
}

AttachSessionRequest captures explicit attach-lock options.

type AttachTaskRunSessionRequest

type AttachTaskRunSessionRequest struct {
	SessionID string `json:"session_id"`
}

AttachTaskRunSessionRequest is the shared run-session attach request payload.

type AttentionNotificationPayload

type AttentionNotificationPayload struct {
	ID             string    `json:"id"`
	Kind           string    `json:"kind"`
	SourceID       string    `json:"source_id"`
	WorkspaceID    string    `json:"workspace_id"`
	WorkspaceLabel string    `json:"workspace_label"`
	Title          string    `json:"title"`
	Detail         string    `json:"detail"`
	OccurredAt     time.Time `json:"occurred_at"`
	Finished       bool      `json:"finished"`
	Badge          string    `json:"badge,omitempty"`
	AgentName      string    `json:"agent_name,omitempty"`
	RunID          string    `json:"run_id,omitempty"`
	NodeID         string    `json:"node_id,omitempty"`
	ItemIndex      int       `json:"item_index"`
	Generation     int       `json:"generation"`
	LoopName       string    `json:"loop_name,omitempty"`
	RequestKind    string    `json:"request_kind,omitempty"`
	TerminalID     string    `json:"terminal_id,omitempty"`
	Redacted       bool      `json:"redacted"`
}

AttentionNotificationPayload describes one occurrence without changing its source's attention state.

type AttentionNotificationsResponse

type AttentionNotificationsResponse struct {
	Snapshot string                         `json:"snapshot"`
	Total    int                            `json:"total"`
	NeedsYou int                            `json:"needs_you"`
	Finished int                            `json:"finished"`
	Items    []AttentionNotificationPayload `json:"items"`
}

AttentionNotificationsResponse carries exact unread counts and a snapshot covering every page.

type AuthoredContextActorPayload

type AuthoredContextActorPayload struct {
	Kind string `json:"kind"`
	Ref  string `json:"ref,omitempty"`
}

AuthoredContextActorPayload records redacted actor or origin identity.

type AuthoredContextDiagnosticPayload

type AuthoredContextDiagnosticPayload struct {
	Code         string                     `json:"code"`
	Severity     AuthoredDiagnosticSeverity `json:"severity"`
	Message      string                     `json:"message"`
	Field        string                     `json:"field,omitempty"`
	Section      string                     `json:"section,omitempty"`
	SourcePath   string                     `json:"source_path,omitempty"`
	Line         int                        `json:"line,omitempty"`
	Column       int                        `json:"column,omitempty"`
	OwnerSurface string                     `json:"owner_surface,omitempty"`
}

AuthoredContextDiagnosticPayload is a redacted, deterministic authored-context diagnostic.

type AuthoredContextLimitsPayload

type AuthoredContextLimitsPayload struct {
	MaxBodyBytes           int64 `json:"max_body_bytes"`
	ContextProjectionBytes int64 `json:"context_projection_bytes,omitempty"`
	MaxBytes               int64 `json:"max_bytes,omitempty"`
}

AuthoredContextLimitsPayload reports stable parser/projection limits.

type AuthoredDiagnosticSeverity

type AuthoredDiagnosticSeverity string

AuthoredDiagnosticSeverity is the closed diagnostic severity shared by Soul and Heartbeat DTOs.

const (
	AuthoredDiagnosticInfo    AuthoredDiagnosticSeverity = "info"
	AuthoredDiagnosticWarning AuthoredDiagnosticSeverity = "warning"
	AuthoredDiagnosticError   AuthoredDiagnosticSeverity = "error"
)

func (AuthoredDiagnosticSeverity) Valid

func (s AuthoredDiagnosticSeverity) Valid() bool

Valid reports whether the diagnostic severity is a closed enum member.

func (AuthoredDiagnosticSeverity) Validate

func (s AuthoredDiagnosticSeverity) Validate() error

Validate reports an error for values outside the closed diagnostic severity enum.

type AuthoredValidationStatus

type AuthoredValidationStatus string

AuthoredValidationStatus is the closed validation state shared by authored-context surfaces.

const (
	AuthoredValidationMissing  AuthoredValidationStatus = "missing"
	AuthoredValidationInactive AuthoredValidationStatus = "inactive"
	AuthoredValidationValid    AuthoredValidationStatus = "valid"
	AuthoredValidationInvalid  AuthoredValidationStatus = "invalid"
)

func (AuthoredValidationStatus) Valid

func (s AuthoredValidationStatus) Valid() bool

Valid reports whether the validation status is a closed enum member.

func (AuthoredValidationStatus) Validate

func (s AuthoredValidationStatus) Validate() error

Validate reports an error for values outside the closed validation status enum.

type AutomationHealthPayload

type AutomationHealthPayload struct {
	Enabled          bool                              `json:"enabled"`
	Jobs             AutomationResourceStatusPayload   `json:"jobs"`
	Triggers         AutomationResourceStatusPayload   `json:"triggers"`
	SchedulerRunning bool                              `json:"scheduler_running"`
	NextFire         *time.Time                        `json:"next_fire,omitempty"`
	ScheduledJobs    []AutomationSchedulerStatePayload `json:"scheduled_jobs,omitempty"`
}

AutomationHealthPayload describes additive automation health state inside the runtime status response.

type AutomationLastRunPayload

type AutomationLastRunPayload struct {
	ID         string                            `json:"id"`
	Status     automationpkg.RunStatus           `json:"status"`
	StartedAt  *time.Time                        `json:"started_at,omitzero"`
	EndedAt    *time.Time                        `json:"ended_at,omitzero"`
	SkipReason automationpkg.SchedulerSkipReason `json:"skip_reason,omitempty"`
}

AutomationLastRunPayload summarizes the newest run of one job or trigger. It equals the first run of the owner's run list; skipped scheduled fires carry the reason stored in the run metadata.

type AutomationResourceStatusPayload

type AutomationResourceStatusPayload struct {
	Total   int `json:"total"`
	Enabled int `json:"enabled"`
}

AutomationResourceStatusPayload reports total and enabled counts for one automation definition family.

type AutomationSchedulerStatePayload

type AutomationSchedulerStatePayload struct {
	JobID                     string                               `json:"job_id"`
	Registered                bool                                 `json:"registered"`
	NextRunAt                 *time.Time                           `json:"next_run_at,omitempty"`
	LastRunAt                 *time.Time                           `json:"last_run_at,omitempty"`
	LastScheduledAt           *time.Time                           `json:"last_scheduled_at,omitempty"`
	LastFireID                string                               `json:"last_fire_id,omitempty"`
	CatchUpPolicy             automationpkg.SchedulerCatchUpPolicy `json:"catch_up_policy,omitempty"`
	MisfireGraceSeconds       int                                  `json:"misfire_grace_seconds,omitzero"`
	ConsecutiveResumeFailures int                                  `json:"consecutive_resume_failures,omitzero"`
	LastMisfireAt             *time.Time                           `json:"last_misfire_at,omitempty"`
	MisfireCount              int                                  `json:"misfire_count,omitzero"`
	UpdatedAt                 *time.Time                           `json:"updated_at,omitempty"`
}

AutomationSchedulerStatePayload exposes durable scheduler cursor diagnostics for one scheduled automation job.

type AutomationSuggestionAcceptanceResponse

type AutomationSuggestionAcceptanceResponse struct {
	Suggestion AutomationSuggestionPayload `json:"suggestion"`
	Job        JobPayload                  `json:"job"`
}

AutomationSuggestionAcceptanceResponse wraps an accepted suggestion and its Job.

type AutomationSuggestionPayload

type AutomationSuggestionPayload struct {
	ID          string                         `json:"id"`
	ProfileID   string                         `json:"profile_id"`
	WorkspaceID string                         `json:"workspace_id"`
	Source      automationpkg.SuggestionSource `json:"source"`
	DedupKey    string                         `json:"dedup_key"`
	Status      automationpkg.SuggestionStatus `json:"status"`
	Payload     JobPayload                     `json:"payload"`
	CreatedAt   time.Time                      `json:"created_at"`
	ResolvedAt  *time.Time                     `json:"resolved_at,omitempty"`
}

AutomationSuggestionPayload is a workspace-scoped, consent-first Job proposal.

type AutomationSuggestionResponse

type AutomationSuggestionResponse struct {
	Suggestion AutomationSuggestionPayload `json:"suggestion"`
}

AutomationSuggestionResponse wraps one resolved automation suggestion.

type AutomationSuggestionsResponse

type AutomationSuggestionsResponse struct {
	Suggestions []AutomationSuggestionPayload `json:"suggestions"`
}

AutomationSuggestionsResponse wraps an exact-workspace suggestion list.

type BindSessionWorktreeRequest

type BindSessionWorktreeRequest struct {
	Worktree           string  `json:"worktree"                       binding:"required"`
	ExpectedWorktreeID *string `json:"expected_worktree_id,omitempty"`
}

type BulkForceTaskRunItemPayload

type BulkForceTaskRunItemPayload struct {
	RunID string          `json:"run_id"`
	OK    bool            `json:"ok"`
	Run   *TaskRunPayload `json:"run,omitzero"`
	Error *ErrorPayload   `json:"error,omitzero"`
}

BulkForceTaskRunItemPayload records one per-row bulk force-operation outcome.

type BulkForceTaskRunRequest

type BulkForceTaskRunRequest struct {
	RunIDs   []string        `json:"run_ids"`
	Reason   string          `json:"reason,omitempty"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

BulkForceTaskRunRequest is the shared bounded bulk force-operation payload.

type BulkForceTaskRunResponse

type BulkForceTaskRunResponse struct {
	Results []BulkForceTaskRunItemPayload `json:"results"`
}

BulkForceTaskRunResponse wraps bounded per-row force-operation results.

type CancelTaskRequest

type CancelTaskRequest struct {
	Reason   string          `json:"reason,omitempty"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

CancelTaskRequest is the shared task-cancel request payload.

type CancelTaskRunRequest

type CancelTaskRunRequest struct {
	Reason   string          `json:"reason,omitempty"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

CancelTaskRunRequest is the shared run-cancel request payload.

type CancelWorktreeExitActionRequest

type CancelWorktreeExitActionRequest struct {
	OperationID string `json:"op_id"`
}

type ClarificationAnswerPayload

type ClarificationAnswerPayload = toolspkg.ClarifyAnswerResult

ClarificationAnswerPayload is the exact public clarification result.

type ClarificationAnswerRequest

type ClarificationAnswerRequest struct {
	ChoiceIndex *int   `json:"choice_index,omitzero"`
	Text        string `json:"text,omitempty"`
}

ClarificationAnswerRequest resolves one live clarification through a public transport.

type ClarificationPendingPayload

type ClarificationPendingPayload struct {
	RequestID string     `json:"request_id"`
	SessionID string     `json:"session_id"`
	AgentName string     `json:"agent_name"`
	Question  string     `json:"question"`
	Choices   []string   `json:"choices,omitempty"`
	AskedAt   time.Time  `json:"asked_at"`
	Deadline  *time.Time `json:"deadline"`
}

ClarificationPendingPayload is the public live pending projection (nil Deadline is unbounded).

func ClarificationPendingPayloadFromDomain

func ClarificationPendingPayloadFromDomain(pending toolspkg.ClarifyPending) ClarificationPendingPayload

ClarificationPendingPayloadFromDomain removes internal workspace ownership from the response body.

type ClarificationsResponse

type ClarificationsResponse struct {
	Clarifications []ClarificationPendingPayload `json:"clarifications"`
}

ClarificationsResponse lists the complete live pending projection for one session.

type ClearTaskBlockRequest

type ClearTaskBlockRequest struct {
	Note string `json:"note,omitempty"`
}

ClearTaskBlockRequest captures one task-block clear request.

type CmdPaletteCatalogChangedEvent

type CmdPaletteCatalogChangedEvent struct {
	ProfileLens     cmdpalette.ProfileLens `json:"profile_lens"`
	Workspace       cmdpalette.WorkspaceID `json:"workspace"`
	CatalogRevision string                 `json:"catalog_revision"`
}

type CmdPaletteClient

type CmdPaletteClient struct {
	ClientID   cmdpalette.ClientID    `json:"client_id"`
	Kind       string                 `json:"kind"`
	Workspace  cmdpalette.WorkspaceID `json:"workspace"`
	AttachedAt time.Time              `json:"attached_at"`
}

func CmdPaletteClientsFromDomain

func CmdPaletteClientsFromDomain(clients []cmdpalette.Client) []CmdPaletteClient

type CmdPaletteCommand

type CmdPaletteCommand struct {
	ID                 cmdpalette.CommandID       `json:"id"`
	Title              string                     `json:"title"`
	Source             string                     `json:"source"`
	Section            string                     `json:"section"`
	Icon               string                     `json:"icon"`
	Keywords           []string                   `json:"keywords,omitempty"`
	Available          bool                       `json:"available"`
	Reason             string                     `json:"reason,omitempty"`
	Bindings           []string                   `json:"bindings"`
	Alias              *string                    `json:"alias"`
	Destructive        bool                       `json:"destructive"`
	Confirmation       *cmdpalette.Confirmation   `json:"confirmation,omitzero"`
	Arguments          []cmdpalette.Argument      `json:"arguments"`
	Action             cmdpalette.Action          `json:"action"`
	Execution          cmdpalette.ExecutionPolicy `json:"execution"`
	When               []cmdpalette.Predicate     `json:"when,omitempty"`
	AvailabilityExempt bool                       `json:"availability_exempt"`
	GlobalShortcut     *cmdpalette.GlobalShortcut `json:"global_shortcut,omitzero"`
}

type CmdPaletteCommandsResponse

type CmdPaletteCommandsResponse struct {
	ProfileLens     cmdpalette.ProfileLens    `json:"profile_lens"`
	Commands        []CmdPaletteCommand       `json:"commands"`
	Sources         []cmdpalette.SourceStatus `json:"sources"`
	CatalogRevision string                    `json:"catalog_revision"`
	ContextRevision string                    `json:"context_revision,omitempty"`
}

func CmdPaletteCommandsFromDomain

func CmdPaletteCommandsFromDomain(catalog cmdpalette.Catalog) CmdPaletteCommandsResponse

type CmdPaletteError

type CmdPaletteError struct {
	Error   string                `json:"error"`
	Message string                `json:"message,omitempty"`
	Reason  string                `json:"reason,omitempty"`
	Fields  map[string]string     `json:"fields,omitempty"`
	Clients []cmdpalette.ClientID `json:"clients,omitempty"`
}

type CmdPaletteInvokeRequest

type CmdPaletteInvokeRequest struct {
	Workspace string         `json:"workspace"`
	Args      map[string]any `json:"args"`
	Client    string         `json:"client,omitempty"`
}

type CmdPaletteInvokeResult

type CmdPaletteInvokeResult struct {
	ProfileLens  cmdpalette.ProfileLens  `json:"profile_lens"`
	Status       cmdpalette.InvokeStatus `json:"status"`
	Result       json.RawMessage         `json:"result,omitempty"`
	ApprovalID   string                  `json:"approval_id,omitempty"`
	InvocationID string                  `json:"invocation_id"`
}

func CmdPaletteInvokeFromDomain

func CmdPaletteInvokeFromDomain(result cmdpalette.InvokeResult) CmdPaletteInvokeResult

type CmdPalettePersonalizationResetResponse

type CmdPalettePersonalizationResetResponse struct {
	Status string `json:"status"`
}

type CmdPalettePersonalizationResponse

type CmdPalettePersonalizationResponse struct {
	ProfileLens       cmdpalette.ProfileLens `json:"profile_lens"`
	Workspace         cmdpalette.WorkspaceID `json:"workspace"`
	Pins              []cmdpalette.CommandID `json:"pins"`
	Recents           int                    `json:"recents"`
	FrecencyEntries   int                    `json:"frecency_entries"`
	QueryAssociations int                    `json:"query_associations"`
}

type CmdPalettePinResponse

type CmdPalettePinResponse struct {
	Pinned bool `json:"pinned"`
}

type CmdPaletteRankSignalsResponse

type CmdPaletteRankSignalsResponse struct {
	ProfileLens cmdpalette.ProfileLens   `json:"profile_lens"`
	Weights     cmdpalette.Weights       `json:"weights"`
	Usage       []cmdpalette.UsageSignal `json:"usage"`
	QueryHits   []cmdpalette.QueryHit    `json:"query_hits"`
	Pins        []cmdpalette.CommandID   `json:"pins"`
	Revision    string                   `json:"revision"`
}

func CmdPaletteRankSignalsFromDomain

func CmdPaletteRankSignalsFromDomain(snapshot cmdpalette.Snapshot) CmdPaletteRankSignalsResponse

type CmdPaletteUsageRequest

type CmdPaletteUsageRequest struct {
	Workspace string               `json:"workspace"`
	CommandID cmdpalette.CommandID `json:"command_id"`
	Query     string               `json:"query"`
}

type CmdPaletteViewEnvelope

type CmdPaletteViewEnvelope struct {
	ProfileLens cmdpalette.ProfileLens `json:"profile_lens"`
	ViewID      string                 `json:"view_id"`
	Title       string                 `json:"title"`
	Kind        cmdpalette.ViewKind    `json:"kind"`
	Revision    string                 `json:"revision"`
	StreamEpoch string                 `json:"stream_epoch"`
	Payload     cmdpalette.ViewPayload `json:"payload"`
}

func CmdPaletteViewFromDomain

func CmdPaletteViewFromDomain(snapshot cmdpalette.ViewSnapshot) CmdPaletteViewEnvelope

type CmdPaletteViewPatch

type CmdPaletteViewPatch struct {
	Sequence    int64                   `json:"sequence"`
	StreamEpoch string                  `json:"stream_epoch"`
	Patch       *cmdpalette.ViewPatch   `json:"patch,omitzero"`
	Payload     *cmdpalette.ViewPayload `json:"payload,omitzero"`
	Revision    string                  `json:"revision"`
	Reset       bool                    `json:"reset,omitzero"`
}

type CmdPaletteViewSessionAccepted

type CmdPaletteViewSessionAccepted struct {
	Accepted bool `json:"accepted"`
}

type CmdPaletteViewSessionClosed

type CmdPaletteViewSessionClosed struct {
	Closed bool `json:"closed"`
}

type CmdPaletteViewSessionEventRequest

type CmdPaletteViewSessionEventRequest struct {
	Handler      string                   `json:"handler"`
	Args         []any                    `json:"args,omitempty"`
	Revision     string                   `json:"revision"`
	Seq          int64                    `json:"seq"`
	AckEffects   []string                 `json:"ack_effects,omitempty"`
	EffectResult *cmdpalette.EffectResult `json:"effect_result,omitzero"`
}

type CmdPaletteViewSessionOpenRequest

type CmdPaletteViewSessionOpenRequest struct {
	Workspace string         `json:"workspace"`
	Args      map[string]any `json:"args,omitempty"`
}

type CmdPaletteViewSessionOpenResponse

type CmdPaletteViewSessionOpenResponse struct {
	ProfileLens cmdpalette.ProfileLens `json:"profile_lens"`
	ViewSession string                 `json:"view_session"`
	StreamToken string                 `json:"stream_token"`
	FirstFrame  cmdpalette.ViewFrame   `json:"first_frame"`
}

type CompactionSnapshotPayload

type CompactionSnapshotPayload struct {
	CompactionID string `json:"compaction_id"`
	Status       string `json:"status"`
	Summary      string `json:"summary,omitempty"`
	Error        string `json:"error,omitempty"`
}

CompactionSnapshotPayload is the current redacted native compaction observation.

type CompleteTaskRunRequest

type CompleteTaskRunRequest struct {
	Result         json.RawMessage `json:"result,omitempty"`
	CreatedTaskIDs []string        `json:"created_task_ids,omitempty"`
}

CompleteTaskRunRequest is the shared run-complete request payload.

type ConfigApplyRecordPayload

type ConfigApplyRecordPayload struct {
	ID                string                  `json:"id"`
	DesiredConfigHash string                  `json:"desired_config_hash"`
	ActiveConfigHash  string                  `json:"active_config_hash"`
	Generation        int64                   `json:"generation"`
	Actor             string                  `json:"actor"`
	WriteTarget       SettingsWriteTargetKind `json:"write_target,omitempty"`
	WritePath         string                  `json:"write_path,omitempty"`
	DiffClass         SettingsApplyLifecycle  `json:"diff_class"`
	Status            ConfigApplyStatus       `json:"status"`
	Lifecycle         SettingsApplyLifecycle  `json:"lifecycle"`
	NextAction        SettingsApplyNextAction `json:"next_action"`
	Diagnostics       []DiagnosticItem        `json:"diagnostics,omitempty"`
	CreatedAt         time.Time               `json:"created_at"`
	AppliedAt         *time.Time              `json:"applied_at,omitempty"`
	UpdatedAt         time.Time               `json:"updated_at"`
}

type ConfigApplyRecordsResponse

type ConfigApplyRecordsResponse struct {
	Entries []ConfigApplyRecordPayload `json:"entries"`
}

type ConfigApplyStatus

type ConfigApplyStatus string
const (
	ConfigApplyStatusPendingApply ConfigApplyStatus = "pending_apply"
	ConfigApplyStatusApplied      ConfigApplyStatus = "applied"
	ConfigApplyStatusBlocked      ConfigApplyStatus = "blocked"
	ConfigApplyStatusFailed       ConfigApplyStatus = "failed"
)

type ConfigLayerDiagnosticPayload

type ConfigLayerDiagnosticPayload struct {
	Code    string `json:"code"`
	Layer   string `json:"layer"`
	Profile string `json:"profile"`
	Path    string `json:"path"`
	Message string `json:"message"`
}

ConfigLayerDiagnosticPayload reports a dormant profile-owned config artifact.

type ConfigRuntimeStatusPayload

type ConfigRuntimeStatusPayload struct {
	Status          string                         `json:"status"`
	Validated       bool                           `json:"validated"`
	ValidationError string                         `json:"validation_error,omitempty"`
	HomeDir         string                         `json:"home_dir,omitempty"`
	ConfigFile      string                         `json:"config_file,omitempty"`
	RestartRequired bool                           `json:"restart_required"`
	ApplyState      string                         `json:"apply_state"`
	Diagnostics     []ConfigLayerDiagnosticPayload `json:"diagnostics,omitempty"`
}

ConfigRuntimeStatusPayload reports daemon config validation and apply lifecycle state.

type ConsentArea

type ConsentArea struct {
	Area   string `json:"area"`
	Access string `json:"access"`
}

ConsentArea is one operator-facing permission summary derived from Host API methods.

type ContinueSessionRequest

type ContinueSessionRequest struct {
	AgentName           string                         `json:"agent_name"`
	Runtime             *PromptRuntimeSelectionPayload `json:"runtime,omitzero"`
	Route               int                            `json:"route,omitzero"`
	Name                string                         `json:"name,omitempty"`
	Message             string                         `json:"message,omitempty"`
	IdempotencyKey      string                         `json:"idempotency_key"`
	ExpectedEpoch       *int64                         `json:"expected_epoch,omitzero"`
	ExpectedGeneration  *int64                         `json:"expected_generation,omitzero"`
	ExpectedMaxSequence *int64                         `json:"expected_max_sequence,omitzero"`
}

ContinueSessionRequest continues a user session with another agent, runtime, or declared route. Runtime and Route are mutually exclusive; the three fences are optional and must be sent together.

type CoordinatorConfigPayload

type CoordinatorConfigPayload struct {
	Enabled                       bool                    `json:"enabled"`
	AgentName                     string                  `json:"agent_name"`
	Provider                      string                  `json:"provider,omitempty"`
	Model                         string                  `json:"model,omitempty"`
	DefaultTTLSeconds             int64                   `json:"default_ttl_seconds"`
	MaxChildren                   int                     `json:"max_children"`
	MaxActiveSessionsPerWorkspace int                     `json:"max_active_sessions_per_workspace"`
	Source                        CoordinatorConfigSource `json:"source"`
	WorkspaceID                   string                  `json:"workspace_id,omitempty"`
}

CoordinatorConfigPayload is the safe coordinator config read model.

type CoordinatorConfigSource

type CoordinatorConfigSource string

CoordinatorConfigSource identifies where a coordinator config read model came from.

const (
	// CoordinatorConfigSourceWorkspace identifies a workspace override.
	CoordinatorConfigSourceWorkspace CoordinatorConfigSource = "workspace"
	// CoordinatorConfigSourceGlobal identifies global config.
	CoordinatorConfigSourceGlobal CoordinatorConfigSource = "global"
	// CoordinatorConfigSourceDefault identifies bundled defaults or agent fallback.
	CoordinatorConfigSourceDefault CoordinatorConfigSource = "default"
)

type CostSource

type CostSource = modelcatalog.CostSource

CostSource is the canonical model-catalog cost provenance exposed by API contracts.

type CostStatus

type CostStatus = modelcatalog.CostStatus

CostStatus is the canonical model-catalog cost classification exposed by API contracts.

type CountedCursorPagePayload

type CountedCursorPagePayload struct {
	NextCursor string `json:"next_cursor,omitempty"`
	HasMore    bool   `json:"has_more"`
	Total      int    `json:"total"`
	Limit      int    `json:"limit"`
}

CountedCursorPagePayload describes a bounded catalog page. Total is the number of rows matching the workspace-scoped filters before the cursor is applied, including zero for an empty catalog.

type CreateAgentPayload

type CreateAgentPayload struct {
	DisplayName *string        `json:"display_name,omitempty"`
	Description *string        `json:"description,omitempty"`
	Kind        string         `json:"kind,omitempty"`
	Appearance  map[string]any `json:"appearance,omitempty"`

	Label              string         `json:"label,omitempty"`
	ResolvedAppearance map[string]any `json:"resolved_appearance,omitempty"`

	SessionEnv      map[string]SessionEnvBindingPayload `json:"session_env,omitempty"`
	Name            string                              `json:"name"`
	Provider        string                              `json:"provider,omitempty"`
	Command         string                              `json:"command,omitempty"`
	Model           string                              `json:"model,omitempty"`
	ReasoningEffort ReasoningEffort                     `json:"reasoning_effort,omitempty"`
	Speed           Speed                               `json:"speed,omitempty"`
	ACPOptions      []AgentACPOptionSelection           `json:"acp_options,omitempty"`
	Tools           []string                            `json:"tools,omitempty"`
	Toolsets        []string                            `json:"toolsets,omitempty"`
	DenyTools       []string                            `json:"deny_tools,omitempty"`
	SessionApproval string                              `json:"session_approval,omitempty"`
	PermissionRules []AgentPermissionRulePayload        `json:"permission_rules,omitempty"`
	WorkspaceAccess string                              `json:"workspace_access,omitempty"`
	Permissions     SettingsPermissionMode              `json:"permissions,omitempty"`
	CategoryPath    []string                            `json:"category_path,omitempty"`
	Skills          *CreateAgentSkillsConfig            `json:"skills,omitzero"`
	// FallbackChain declares ordered pre-acceptance routes; omitted keeps no chain on
	// create and replaces the whole chain on update.
	FallbackChain []AgentFallbackRoutePayload `json:"fallback_chain,omitempty"`
	Prompt        string                      `json:"prompt"`
}

CreateAgentPayload captures the simple AGENT.md fields supported by v1 authoring.

type CreateAgentRequest

type CreateAgentRequest struct {
	Scope     AgentCreateScope   `json:"scope"`
	Workspace string             `json:"workspace,omitempty"`
	Agent     CreateAgentPayload `json:"agent"`
}

CreateAgentRequest is the shared agent definition authoring request payload.

type CreateAgentSkillsConfig

type CreateAgentSkillsConfig struct {
	Disabled []string `json:"disabled,omitempty"`
}

CreateAgentSkillsConfig captures agent-local skill policy stored in AGENT.md.

type CreateAppTokenRequest

type CreateAppTokenRequest struct {
	Name    string   `json:"name"`
	Origins []string `json:"origins,omitempty"`
}

type CreateJobRequest

type CreateJobRequest struct {
	Scope       automationpkg.Scope            `json:"scope"`
	Name        string                         `json:"name"`
	TargetKind  automationpkg.TargetKind       `json:"target_kind,omitempty"`
	AgentName   string                         `json:"agent_name"`
	WorkspaceID string                         `json:"workspace_id,omitempty"`
	Prompt      string                         `json:"prompt"`
	Schedule    automationpkg.ScheduleSpec     `json:"schedule"`
	Task        *automationpkg.JobTaskConfig   `json:"task,omitempty"`
	LoopTarget  *automationpkg.LoopTarget      `json:"loop_target,omitempty"`
	Enabled     *bool                          `json:"enabled,omitempty"`
	Retry       *automationpkg.RetryConfig     `json:"retry,omitempty"`
	FireLimit   *automationpkg.FireLimitConfig `json:"fire_limit,omitempty"`
}

CreateJobRequest is the shared automation job create payload.

type CreateLoopRequest

type CreateLoopRequest struct {
	Definition   *LoopDefinitionDocument `json:"definition,omitzero"`
	ForkFromName string                  `json:"fork_from_name,omitempty"`
}

CreateLoopRequest creates a writable Loop definition or forks a read-only Loop by name.

type CreateProfileRequest

type CreateProfileRequest struct {
	Name     string            `json:"name"              binding:"required"`
	Color    string            `json:"color,omitempty"`
	Icon     string            `json:"icon,omitempty"`
	Emoji    string            `json:"emoji,omitempty"`
	Activate *ProfileSelection `json:"activate,omitzero"`
}

CreateProfileRequest creates one profile and may activate it immediately.

type CreateSessionFolderRequest

type CreateSessionFolderRequest struct {
	Name string `json:"name"`
}

CreateSessionFolderRequest creates a folder at the top of the folder order.

type CreateSessionRequest

type CreateSessionRequest struct {
	Scope         string                     `json:"scope,omitempty"`
	AgentName     string                     `json:"agent_name,omitempty"`
	Name          string                     `json:"name,omitempty"`
	Workspace     string                     `json:"workspace,omitempty"`
	WorkspacePath string                     `json:"workspace_path,omitempty"`
	Worktree      string                     `json:"worktree,omitempty"`
	NewWorktree   *NewSessionWorktreeRequest `json:"new_worktree,omitzero"`
	// ParentSessionID records creation provenance; the parent must live in the
	// target workspace and the link never narrows the child's lifecycle.
	ParentSessionID string `json:"parent_session_id,omitempty"`
	// LineageKind names the relation to ParentSessionID: "provenance" (default)
	// or "recovery". It is accepted only together with parent_session_id.
	LineageKind string `json:"lineage_kind,omitempty"`
	// FolderID places the new session at the end of one of the caller's
	// session folders in the target workspace.
	FolderID string `json:"folder_id,omitempty"`
}

CreateSessionRequest is the shared session creation request payload.

type CreateSupportBundleRequest

type CreateSupportBundleRequest struct {
	Yes           bool  `json:"yes"`
	IncludeStatus *bool `json:"include_status,omitzero"`
}

type CreateTaskBlockRequest

type CreateTaskBlockRequest struct {
	Kind      taskpkg.BlockKind `json:"kind"`
	Reason    string            `json:"reason"`
	Details   json.RawMessage   `json:"details,omitempty"`
	ExpiresAt *time.Time        `json:"expires_at,omitempty"`
	RunID     string            `json:"run_id,omitempty"`
}

CreateTaskBlockRequest captures one task-block create request.

type CreateTaskChildRequest

type CreateTaskChildRequest struct {
	ID                 string                 `json:"id,omitempty"`
	Identifier         string                 `json:"identifier,omitempty"`
	Scope              taskpkg.Scope          `json:"scope"`
	Workspace          string                 `json:"workspace,omitempty"`
	Title              string                 `json:"title"`
	Description        string                 `json:"description,omitempty"`
	Priority           taskpkg.Priority       `json:"priority,omitempty"`
	MaxAttempts        *int                   `json:"max_attempts,omitzero"`
	AutoEnqueueOnReady bool                   `json:"auto_enqueue_on_ready,omitzero"`
	Draft              bool                   `json:"draft,omitzero"`
	ApprovalPolicy     taskpkg.ApprovalPolicy `json:"approval_policy,omitempty"`
	Owner              *taskpkg.Ownership     `json:"owner,omitempty"`
	WakeCreator        *bool                  `json:"wake_creator,omitzero"`
	Metadata           json.RawMessage        `json:"metadata,omitempty"`
}

CreateTaskChildRequest is the shared child-task create payload.

type CreateTaskRequest

type CreateTaskRequest struct {
	ID                 string                 `json:"id,omitempty"`
	Identifier         string                 `json:"identifier,omitempty"`
	Scope              taskpkg.Scope          `json:"scope"`
	Workspace          string                 `json:"workspace,omitempty"`
	Title              string                 `json:"title"`
	Description        string                 `json:"description,omitempty"`
	Priority           taskpkg.Priority       `json:"priority,omitempty"`
	MaxAttempts        *int                   `json:"max_attempts,omitempty"`
	AutoEnqueueOnReady bool                   `json:"auto_enqueue_on_ready,omitempty"`
	Draft              bool                   `json:"draft,omitempty"`
	ApprovalPolicy     taskpkg.ApprovalPolicy `json:"approval_policy,omitempty"`
	Owner              *taskpkg.Ownership     `json:"owner,omitempty"`
	WakeCreator        *bool                  `json:"wake_creator,omitempty"`
	Metadata           json.RawMessage        `json:"metadata,omitempty"`
}

CreateTaskRequest is the shared task-create request payload.

type CreateTaskRunReviewRequest

type CreateTaskRunReviewRequest = taskpkg.RunReviewRequest

CreateTaskRunReviewRequest captures one request to review a terminal task run.

type CreateTriggerRequest

type CreateTriggerRequest struct {
	TargetInstanceScope string                   `json:"target_instance_scope,omitempty"`
	Scope               automationpkg.Scope      `json:"scope"`
	Name                string                   `json:"name"`
	TargetKind          automationpkg.TargetKind `json:"target_kind,omitempty"`
	AgentName           string                   `json:"agent_name"`
	WorkspaceID         string                   `json:"workspace_id,omitempty"`
	// Prompt is required for an agent target and optional for an agent_instance target.
	Prompt             string                         `json:"prompt,omitempty"`
	Event              string                         `json:"event"`
	Filter             map[string]string              `json:"filter,omitempty"`
	LoopTarget         *automationpkg.LoopTarget      `json:"loop_target,omitempty"`
	Enabled            *bool                          `json:"enabled,omitempty"`
	Retry              *automationpkg.RetryConfig     `json:"retry,omitempty"`
	FireLimit          *automationpkg.FireLimitConfig `json:"fire_limit,omitempty"`
	WebhookID          string                         `json:"webhook_id,omitempty"`
	EndpointSlug       string                         `json:"endpoint_slug,omitempty"`
	WebhookSecretValue string                         `json:"webhook_secret_value,omitempty"`
}

CreateTriggerRequest is the shared automation trigger create payload.

type CreateWorkspaceFolderRequest

type CreateWorkspaceFolderRequest struct {
	Name string `json:"name"`
}

CreateWorkspaceFolderRequest creates a root folder at the top of the folder order.

type CreateWorkspaceRequest

type CreateWorkspaceRequest struct {
	RootDir      string   `json:"root_dir"`
	Name         string   `json:"name,omitempty"`
	AddDirs      []string `json:"add_dirs,omitempty"`
	DefaultAgent string   `json:"default_agent,omitempty"`
}

CreateWorkspaceRequest is the shared workspace creation request payload.

type CreateWorktreeRequest

type CreateWorktreeRequest struct {
	Name           string `json:"name,omitempty"`
	Branch         string `json:"branch,omitempty"`
	BaseRef        string `json:"base_ref,omitempty"`
	ExistingBranch string `json:"existing_branch,omitempty"`
	Path           string `json:"path,omitempty"`
}

type CursorPagePayload

type CursorPagePayload struct {
	NextCursor string `json:"next_cursor,omitempty"`
	HasMore    bool   `json:"has_more"`
	Limit      int    `json:"limit"`
}

CursorPagePayload describes one bounded stable-cursor page. NextCursor continues in the direction of the request. Limit is the normalized bound applied by the server.

type DaemonIdentityPayload

type DaemonIdentityPayload struct {
	PID         int       `json:"pid"`
	StartedAt   time.Time `json:"started_at"`
	HTTPHost    string    `json:"http_host"`
	HTTPPort    int       `json:"http_port"`
	UserHomeDir string    `json:"user_home_dir"`
	Version     string    `json:"version"`
}

DaemonIdentityPayload identifies one concrete daemon process and listener.

type DaemonStatusPayload

type DaemonStatusPayload struct {
	Status         string                `json:"status"`
	PID            int                   `json:"pid"`
	StartedAt      time.Time             `json:"started_at"`
	Socket         string                `json:"socket"`
	HTTPHost       string                `json:"http_host"`
	HTTPPort       int                   `json:"http_port"`
	UserHomeDir    string                `json:"user_home_dir"`
	ActiveSessions int                   `json:"active_sessions"`
	TotalSessions  int                   `json:"total_sessions"`
	Version        string                `json:"version,omitempty"`
	MinAppVersion  string                `json:"min_app_version"`
	Gateway        *GatewayStatusPayload `json:"gateway,omitzero"`
	SchemaStreams  []SchemaStreamStatus  `json:"schema_streams"`
}

DaemonStatusPayload is the shared daemon status response payload.

type DeleteAgentResponse

type DeleteAgentResponse struct {
	Name             string      `json:"name"`
	Origin           AgentOrigin `json:"origin"`
	UnshadowedOrigin AgentOrigin `json:"unshadowed_origin,omitempty"`
}

DeleteAgentResponse reports the effective definition removed from disk.

type DeleteLoopInputDefaultResponse

type DeleteLoopInputDefaultResponse struct {
	LoopName string                 `json:"loop_name"`
	Key      string                 `json:"key"`
	Scope    LoopInputDefaultsScope `json:"scope"`
	Deleted  bool                   `json:"deleted"`
}

DeleteLoopInputDefaultResponse reports whether one configured key was present before deletion.

type DeleteProfilePlan

type DeleteProfilePlan struct {
	Revision          string                `json:"revision"`
	Removed           ProfileRemovalSummary `json:"removed"`
	SelectionsToSweep int                   `json:"selections_to_sweep"`
	ApprovalBlockers  []string              `json:"approval_blockers"`
}

DeleteProfilePlan previews the resources removed with a profile.

type DeleteProfileResponse

type DeleteProfileResponse struct {
	Deleted bool                  `json:"deleted"`
	Removed ProfileRemovalSummary `json:"removed"`
}

DeleteProfileResponse reports the outcome of deleting a profile.

type DeleteResourceRequest

type DeleteResourceRequest struct {
	ExpectedVersion int64 `json:"expected_version"`
}

DeleteResourceRequest is the shared desired-state delete payload.

type DevLinkExtensionRequest

type DevLinkExtensionRequest struct {
	OriginPath           string `json:"origin_path"`
	GenerationHash       string `json:"generation_hash"`
	ConfirmGatewayDigest string `json:"confirm_gateway_digest,omitempty"`
}

DevLinkExtensionRequest links one immutable generation under the caller's trusted workspace.

type DiagnosticCodeSpec

type DiagnosticCodeSpec = diagnosticcontract.DiagnosticCodeSpec

DiagnosticCodeSpec records the canonical owner metadata for one code.

func DiagnosticCodeSpecs

func DiagnosticCodeSpecs() []DiagnosticCodeSpec

DiagnosticCodeSpecs returns the sorted canonical diagnostic code registry.

type DiagnosticItem

type DiagnosticItem = diagnosticcontract.DiagnosticItem

DiagnosticItem is the canonical actionable-diagnostic wire shape.

type DiscoveredWorktreePayload

type DiscoveredWorktreePayload struct {
	Name        string `json:"name"`
	Branch      string `json:"branch"`
	Path        string `json:"path"`
	Detached    bool   `json:"detached"`
	Stale       bool   `json:"stale"`
	Selectable  bool   `json:"selectable"`
	Unavailable bool   `json:"unavailable"`
	Reason      string `json:"reason,omitempty"`
}

type DoctorPayload

type DoctorPayload struct {
	SchemaVersion string               `json:"schema_version"`
	GeneratedAt   time.Time            `json:"generated_at"`
	DurationMS    int64                `json:"duration_ms"`
	Status        string               `json:"status"`
	Summary       DoctorSummaryPayload `json:"summary"`
	Items         []DiagnosticItem     `json:"items"`
}

DoctorPayload is the diagnostic probe result shared by HTTP, UDS, and CLI JSON.

type DoctorSummaryPayload

type DoctorSummaryPayload struct {
	Total            int            `json:"total"`
	CountsBySeverity map[string]int `json:"counts_by_severity"`
}

DoctorSummaryPayload provides stable severity counters for agents.

type DraftAgentInstructionsRequest

type DraftAgentInstructionsRequest struct {
	Goal    string            `json:"goal"`
	Runtime AgentDraftRuntime `json:"runtime"`
}

type DraftAgentInstructionsResponse

type DraftAgentInstructionsResponse struct {
	Instructions string `json:"instructions"`
}

type DrainState

type DrainState string

DrainState is the closed daemon new-work admission state.

const (
	DrainStateActive   DrainState = "active"
	DrainStateDraining DrainState = "draining"
)

type DrainStatusResponse

type DrainStatusResponse struct {
	State                      DrainState `json:"state"`
	AdmissionClosed            bool       `json:"admission_closed"`
	ActiveSessionExecutions    int        `json:"active_session_executions"`
	ActiveTaskClaims           int        `json:"active_task_claims"`
	AuthoritativeClaimsSettled bool       `json:"authoritative_claims_settled"`
	SessionExecutionSettled    bool       `json:"session_execution_settled"`
	SafeToStop                 bool       `json:"safe_to_stop"`
}

DrainStatusResponse is shared by HTTP, UDS, and CLI control surfaces.

type DuplicateAgentOverrides

type DuplicateAgentOverrides struct {
	DisplayName *string        `json:"display_name,omitempty"`
	Description *string        `json:"description,omitempty"`
	Kind        string         `json:"kind,omitempty"`
	Appearance  map[string]any `json:"appearance,omitempty"`

	SessionEnv      map[string]SessionEnvBindingPayload `json:"session_env,omitempty"`
	Provider        string                              `json:"provider,omitempty"`
	Command         string                              `json:"command,omitempty"`
	Model           string                              `json:"model,omitempty"`
	ReasoningEffort ReasoningEffort                     `json:"reasoning_effort,omitempty"`
	Speed           Speed                               `json:"speed,omitempty"`
	ACPOptions      []AgentACPOptionSelection           `json:"acp_options,omitempty"`
	ClearSpeed      bool                                `json:"clear_speed,omitzero"`
	ClearACPOptions bool                                `json:"clear_acp_options,omitzero"`
	Tools           []string                            `json:"tools,omitempty"`
	Toolsets        []string                            `json:"toolsets,omitempty"`
	DenyTools       []string                            `json:"deny_tools,omitempty"`
	SessionApproval string                              `json:"session_approval,omitempty"`
	PermissionRules []AgentPermissionRulePayload        `json:"permission_rules,omitempty"`
	WorkspaceAccess string                              `json:"workspace_access,omitempty"`
	Permissions     SettingsPermissionMode              `json:"permissions,omitempty"`
	CategoryPath    []string                            `json:"category_path,omitempty"`
	Skills          *CreateAgentSkillsConfig            `json:"skills,omitzero"`
	Prompt          string                              `json:"prompt,omitempty"`
}

DuplicateAgentOverrides captures caller-editable fields applied to a clone.

type DuplicateAgentRequest

type DuplicateAgentRequest struct {
	Kind string `json:"kind,omitempty"`

	Name      string                   `json:"name"`
	Scope     AgentCreateScope         `json:"scope,omitempty"`
	Workspace string                   `json:"workspace,omitempty"`
	Overrides *DuplicateAgentOverrides `json:"overrides,omitzero"`
}

DuplicateAgentRequest clones the effective route agent definition.

type EnableExtensionRequest

type EnableExtensionRequest struct {
	ConfirmGatewayDigest string `json:"confirm_gateway_digest,omitempty"`
}

EnableExtensionRequest carries digest-exact gateway permission consent.

type EnqueueTaskRunRequest

type EnqueueTaskRunRequest struct {
	IdempotencyKey string          `json:"idempotency_key,omitempty"`
	Metadata       json.RawMessage `json:"metadata,omitempty"`
}

EnqueueTaskRunRequest is the shared run-enqueue request payload.

type ErrorPayload

type ErrorPayload struct {
	Blockers      []WorkspaceArchiveBlocker `json:"blockers,omitempty"`
	Error         string                    `json:"error"`
	Code          string                    `json:"code,omitempty"`
	CurrentTurnID string                    `json:"current_turn_id,omitempty"`
	Details       map[string]string         `json:"details,omitempty"`
	Diagnostic    *DiagnosticItem           `json:"diagnostic,omitzero"`
	ConfigPath    string                    `json:"config_path,omitempty"`
	UnknownKeys   []string                  `json:"unknown_keys,omitempty"`
}

ErrorPayload is the shared error response payload.

type ExtensionCommandGroupPayload

type ExtensionCommandGroupPayload struct {
	Extension string `json:"extension"`
	Path      string `json:"path"`
	Summary   string `json:"summary"`
}

ExtensionCommandGroupPayload is one non-executable command presentation group.

type ExtensionCommandPayload

type ExtensionCommandPayload struct {
	Extension        string                 `json:"extension"`
	Verb             string                 `json:"verb"`
	ToolID           string                 `json:"tool_id"`
	Summary          string                 `json:"summary"`
	Example          string                 `json:"example,omitempty"`
	Flags            []toolspkg.CommandFlag `json:"flags"`
	RiskClass        toolspkg.RiskClass     `json:"risk_class"`
	ApprovalRequired bool                   `json:"approval_required"`
}

ExtensionCommandPayload is one executable command leaf projected from an active extension tool.

type ExtensionCommandsResponse

type ExtensionCommandsResponse struct {
	Commands []ExtensionCommandPayload      `json:"commands"`
	Groups   []ExtensionCommandGroupPayload `json:"groups"`
}

ExtensionCommandsResponse wraps the storage-free contributed-command projection.

type ExtensionContentsPayload

type ExtensionContentsPayload struct {
	Skills     int `json:"skills"`
	MCPServers int `json:"mcp_servers"`
	Hooks      int `json:"hooks"`
	Loops      int `json:"loops"`
	Agents     int `json:"agents"`
}

ExtensionContentsPayload summarizes the resources shipped by one extension.

type ExtensionDeclaredProfilePayload

type ExtensionDeclaredProfilePayload struct {
	Name   string `json:"name"`
	Exists bool   `json:"exists"`
	// CreatedByExtension requires confirmed creation provenance; unknown historical origin is false.
	CreatedByExtension     bool                           `json:"created_by_extension"`
	NeedsSetup             bool                           `json:"needs_setup"`
	CredentialRequirements []ProfileCredentialRequirement `json:"credential_requirements,omitempty"`
}

ExtensionDeclaredProfilePayload reports one manifest-declared profile and its live setup state.

type ExtensionEnablePreviewPayload

type ExtensionEnablePreviewPayload struct {
	MissingInputs               []string                    `json:"missing_inputs"`
	Extension                   string                      `json:"extension"`
	Changes                     []ExtensionKitChangePayload `json:"changes"`
	AgentConflicts              []string                    `json:"agent_conflicts"`
	MissingEnv                  []string                    `json:"missing_env"`
	AutomationStarting          []string                    `json:"automation_starting"`
	GatewayRequirementDigest    string                      `json:"gateway_requirement_digest"`
	GatewayConfirmationRequired bool                        `json:"gateway_confirmation_required"`
}

ExtensionEnablePreviewPayload is the mutation-free enable projection.

type ExtensionEnableResult

type ExtensionEnableResult struct {
	Extension         ExtensionPayload `json:"extension"`
	AutomationStarted []string         `json:"automation_started"`
}

ExtensionEnableResult is the committed enable action result.

type ExtensionEnablementPayload

type ExtensionEnablementPayload struct {
	Profile string `json:"profile"`
	Enabled bool   `json:"enabled"`
}

ExtensionEnablementPayload is the effective state for one named profile.

type ExtensionInputStatePayload

type ExtensionInputStatePayload struct {
	ID     string `json:"id"`
	Type   string `json:"type"`
	Set    bool   `json:"set"`
	Active bool   `json:"active"`
}

type ExtensionInstallDeclaredProfilePayload

type ExtensionInstallDeclaredProfilePayload struct {
	Name        string                         `json:"name"`
	Create      bool                           `json:"create"`
	Credentials []ProfileCredentialRequirement `json:"credentials,omitempty"`
}

ExtensionInstallDeclaredProfilePayload describes one profile bind or creation before install.

type ExtensionInstallPreviewPayload

type ExtensionInstallPreviewPayload struct {
	DigestSHA256             string                                   `json:"digest_sha256,omitempty"`
	Inputs                   []MarketplaceInputPayload                `json:"inputs"`
	Name                     string                                   `json:"name"`
	DeclaredProfiles         []ExtensionInstallDeclaredProfilePayload `json:"declared_profiles"`
	Placements               []ExtensionPlacementPayload              `json:"placements"`
	GatewayRequirementDigest string                                   `json:"gateway_requirement_digest,omitempty"`
}

ExtensionInstallPreviewPayload is the mutation-free install confirmation contract.

type ExtensionInventoryPayload

type ExtensionInventoryPayload struct {
	Extension   string                    `json:"extension"`
	Format      string                    `json:"format"`
	Enabled     bool                      `json:"enabled"`
	Items       []ExtensionKitItemPayload `json:"items"`
	Diagnostics []DiagnosticItem          `json:"diagnostics,omitempty"`
}

ExtensionInventoryPayload is the shipped/live union for one extension.

type ExtensionKitChange

type ExtensionKitChange string

ExtensionKitChange identifies how enable reconciliation will mutate one resource.

const (
	ExtensionKitChangeAdded   ExtensionKitChange = "added"
	ExtensionKitChangeChanged ExtensionKitChange = "changed"
	ExtensionKitChangeRemoved ExtensionKitChange = "removed"
)

type ExtensionKitChangePayload

type ExtensionKitChangePayload struct {
	Kind   resources.ResourceKind `json:"kind"`
	ID     string                 `json:"id"`
	Name   string                 `json:"name"`
	Change ExtensionKitChange     `json:"change"`
}

ExtensionKitChangePayload is one resource delta in an enable preview.

type ExtensionKitItemPayload

type ExtensionKitItemPayload struct {
	Kind resources.ResourceKind `json:"kind"`
	ID   string                 `json:"id"`
	Name string                 `json:"name"`
	Live bool                   `json:"live"`
}

ExtensionKitItemPayload is one shipped or live extension resource.

type ExtensionLogPayload

type ExtensionLogPayload struct {
	Sequence       int64     `json:"sequence"`
	Timestamp      time.Time `json:"timestamp"`
	Message        string    `json:"message"`
	GenerationHash string    `json:"generation_hash,omitempty"`
	StreamEpoch    string    `json:"stream_epoch"`
}

ExtensionLogPayload is one redacted per-instance stderr record.

type ExtensionLogsResponse

type ExtensionLogsResponse struct {
	Logs        []ExtensionLogPayload `json:"logs"`
	StreamEpoch string                `json:"stream_epoch"`
}

ExtensionLogsResponse wraps a bounded snapshot of redacted extension logs.

type ExtensionManifestSummary

type ExtensionManifestSummary struct {
	Name              string   `json:"name"`
	Version           string   `json:"version"`
	Description       string   `json:"description,omitempty"`
	MinCompozyVersion string   `json:"min_compozy_version"`
	Provides          []string `json:"provides"`
	Permissions       []string `json:"permissions"`
}

ExtensionManifestSummary is the stable authoring-facing subset of a validated manifest.

type ExtensionOperationErrorPayload

type ExtensionOperationErrorPayload struct {
	InputDefinitions []MarketplaceInputPayload `json:"input_definitions,omitempty"`
	InstalledOrigin  *MarketplaceOriginPayload `json:"installed_origin,omitzero"`
	ListedDigest     string                    `json:"listed_digest,omitempty"`
	FetchedDigest    string                    `json:"fetched_digest,omitempty"`
	InputID          string                    `json:"input_id,omitempty"`
	Inputs           []string                  `json:"inputs,omitempty"`
	MissingEnv       []string                  `json:"missing_env,omitempty"`
	Error            string                    `json:"error"`
	Code             string                    `json:"code"`
	Diagnostic       *DiagnosticItem           `json:"diagnostic,omitzero"`
	CurrentDigest    string                    `json:"current_digest,omitempty"`
	Agents           []string                  `json:"agents,omitempty"`
	EnvName          string                    `json:"env_name,omitempty"`
	DeclaredEnv      []string                  `json:"declared_env,omitempty"`
}

ExtensionOperationErrorPayload is the deterministic extension lifecycle error envelope.

type ExtensionPayload

type ExtensionPayload struct {
	Description                 string                            `json:"description,omitempty"`
	InstallationProfile         string                            `json:"installation_profile,omitempty"`
	Layout                      string                            `json:"layout,omitempty"`
	MCPServers                  []MarketplaceServerPayload        `json:"mcp_servers,omitempty"`
	Inputs                      []ExtensionInputStatePayload      `json:"inputs,omitempty"`
	MissingInputs               []string                          `json:"missing_inputs,omitempty"`
	Contents                    ExtensionContentsPayload          `json:"contents"`
	Origin                      *MarketplaceOriginPayload         `json:"origin,omitzero"`
	Name                        string                            `json:"name"`
	Profile                     string                            `json:"profile"`
	WorkspaceID                 string                            `json:"workspace_id,omitempty"`
	Version                     string                            `json:"version"`
	Type                        string                            `json:"type"`
	Format                      string                            `json:"format"`
	Source                      string                            `json:"source"`
	Enabled                     bool                              `json:"enabled"`
	State                       string                            `json:"state"`
	Capabilities                []string                          `json:"capabilities,omitempty"`
	Permissions                 []string                          `json:"permissions,omitempty"`
	RequiresEnv                 []string                          `json:"requires_env,omitempty"`
	MissingEnv                  []string                          `json:"missing_env,omitempty"`
	BoundEnvKeys                []string                          `json:"bound_env_keys,omitempty"`
	GatewayRequirementDigest    string                            `json:"gateway_requirement_digest,omitempty"`
	GatewayConfirmationRequired bool                              `json:"gateway_confirmation_required"`
	PID                         int                               `json:"pid,omitzero"`
	UptimeSeconds               int64                             `json:"uptime_seconds,omitzero"`
	Health                      string                            `json:"health,omitempty"`
	HealthMessage               string                            `json:"health_message,omitempty"`
	LastError                   string                            `json:"last_error,omitempty"`
	FailureCode                 string                            `json:"failure_code,omitempty"`
	ConsecutiveFailures         int                               `json:"consecutive_failures"`
	RestartBackoffMS            int64                             `json:"restart_backoff_ms"`
	GenerationHash              string                            `json:"generation_hash,omitempty"`
	Dev                         bool                              `json:"dev,omitzero"`
	OverridesPublished          bool                              `json:"overrides_published,omitzero"`
	OriginPath                  string                            `json:"origin_path,omitempty"`
	UpdateAvailable             bool                              `json:"update_available"`
	RemoteVersion               string                            `json:"remote_version,omitempty"`
	DigestMatched               bool                              `json:"digest_matched"`
	DaemonRunning               bool                              `json:"daemon_running"`
	Provenance                  *ExtensionProvenancePayload       `json:"provenance,omitzero"`
	Marketplace                 *MarketplaceListingPayload        `json:"marketplace,omitzero"`
	Trust                       *ExtensionTrustReportPayload      `json:"trust,omitzero"`
	Diagnostics                 []DiagnosticItem                  `json:"diagnostics,omitempty"`
	DeclaredProfiles            []ExtensionDeclaredProfilePayload `json:"declared_profiles,omitempty"`
	Placements                  []ExtensionPlacementPayload       `json:"placements,omitempty"`
	DormantPlacements           []ExtensionPlacementPayload       `json:"dormant_placements,omitempty"`
}

ExtensionPayload is the shared extension response payload surfaced by CLI APIs.

type ExtensionPlacementPayload

type ExtensionPlacementPayload struct {
	Kind         string `json:"kind"`
	Resource     string `json:"resource"`
	Profile      string `json:"profile,omitempty"`
	Dormant      bool   `json:"dormant"`
	CreateAction string `json:"create_action,omitempty"`
}

ExtensionPlacementPayload is one row in the extension resource placement matrix.

type ExtensionProvenancePayload

type ExtensionProvenancePayload struct {
	SourceName          string                       `json:"source_name,omitempty"`
	SourceRef           string                       `json:"source_ref,omitempty"`
	EntryID             string                       `json:"entry_id,omitempty"`
	ResolvedRef         string                       `json:"resolved_ref,omitempty"`
	Layout              string                       `json:"layout,omitempty"`
	Slug                string                       `json:"slug,omitempty"`
	CatalogEntryID      string                       `json:"catalog_entry_id,omitempty"`
	InstalledFrom       string                       `json:"installed_from"`
	SourceURL           string                       `json:"source_url,omitempty"`
	ChecksumSHA256      string                       `json:"checksum_sha256"`
	ArchiveDigestSHA256 string                       `json:"archive_digest_sha256,omitempty"`
	DigestMatched       bool                         `json:"digest_matched"`
	ChecksumVerified    bool                         `json:"checksum_verified"`
	RegistryTier        string                       `json:"registry_tier"`
	Permissions         []string                     `json:"permissions,omitempty"`
	InstalledAt         time.Time                    `json:"installed_at"`
	InstalledBy         string                       `json:"installed_by"`
	AllowUnverified     bool                         `json:"allow_unverified"`
	Warnings            []DiagnosticItem             `json:"warnings,omitempty"`
	Trust               *ExtensionTrustReportPayload `json:"trust,omitzero"`
}

ExtensionProvenancePayload contains the persisted source and trust record.

type ExtensionProvenanceResponse

type ExtensionProvenanceResponse struct {
	Provenance ExtensionProvenancePayload `json:"provenance"`
}

ExtensionProvenanceResponse wraps one installed extension provenance record.

type ExtensionRemoveResponse

type ExtensionRemoveResponse struct {
	Extension ManagedExtensionRemovePayload `json:"extension"`
}

ExtensionRemoveResponse wraps one removed extension result.

type ExtensionResponse

type ExtensionResponse struct {
	Extension ExtensionPayload `json:"extension"`
}

ExtensionResponse wraps one extension payload.

type ExtensionSearchItem

type ExtensionSearchItem struct {
	Slug             string `json:"slug"`
	Name             string `json:"name"`
	Description      string `json:"description,omitempty"`
	Author           string `json:"author,omitempty"`
	Version          string `json:"version,omitempty"`
	Downloads        int    `json:"downloads,omitzero"`
	Source           string `json:"source"`
	Tier             string `json:"tier"`
	Integrity        string `json:"integrity"`
	DigestMatched    bool   `json:"digest_matched"`
	Installed        bool   `json:"installed"`
	InstalledVersion string `json:"installed_version,omitempty"`
	UpdateAvailable  bool   `json:"update_available"`
}

ExtensionSearchItem is one source-tagged extension discovery result.

type ExtensionSearchRequest

type ExtensionSearchRequest struct {
	Query   string
	Sources []string
	Limit   int
	Cursor  string
}

ExtensionSearchRequest selects global extension discovery sources.

type ExtensionSearchResponse

type ExtensionSearchResponse struct {
	Items           []ExtensionSearchItem `json:"items"`
	NextCursor      string                `json:"next_cursor,omitempty"`
	SourcesDegraded []string              `json:"sources_degraded,omitempty"`
}

ExtensionSearchResponse is a stable page from a cached source-union snapshot.

type ExtensionSecretBindingInput

type ExtensionSecretBindingInput struct {
	EnvName    string  `json:"env_name"`
	Value      *string `json:"value,omitzero"`
	VaultRef   *string `json:"vault_ref,omitzero"`
	MCPServer  string  `json:"mcp_server,omitempty"`
	HeaderName string  `json:"header_name,omitempty"`
}

ExtensionSecretBindingInput is one write-only value or existing Vault binding.

type ExtensionSecretBindingPayload

type ExtensionSecretBindingPayload struct {
	EnvName    string `json:"env_name"`
	Stale      bool   `json:"stale"`
	MCPServer  string `json:"mcp_server,omitempty"`
	HeaderName string `json:"header_name,omitempty"`
}

ExtensionSecretBindingPayload reports one bound key without exposing its Vault ref or value.

type ExtensionSecretsPayload

type ExtensionSecretsPayload struct {
	DeclaredEnv  []string                        `json:"declared_env"`
	BoundEnvKeys []string                        `json:"bound_env_keys"`
	Bindings     []ExtensionSecretBindingPayload `json:"bindings"`
}

ExtensionSecretsPayload exposes binding presence without refs or values.

type ExtensionTrustReportPayload

type ExtensionTrustReportPayload struct {
	Decision         string           `json:"decision"`
	RegistryTier     string           `json:"registry_tier"`
	ChecksumVerified bool             `json:"checksum_verified"`
	AllowUnverified  bool             `json:"allow_unverified"`
	Warnings         []DiagnosticItem `json:"warnings,omitempty"`
}

ExtensionTrustReportPayload records the trust decision for an extension.

type ExtensionUpdateBatchResponse

type ExtensionUpdateBatchResponse struct {
	Updates []ManagedExtensionUpdatePayload `json:"updates"`
}

ExtensionUpdateBatchResponse wraps per-item extension update outcomes.

type ExtensionUpdateResponse

type ExtensionUpdateResponse struct {
	Update ManagedExtensionUpdatePayload `json:"update"`
}

ExtensionUpdateResponse wraps one marketplace extension update result.

type ExtensionValidatePayload

type ExtensionValidatePayload struct {
	Status       string                         `json:"status"`
	Format       string                         `json:"format"`
	Name         string                         `json:"name,omitempty"`
	Version      string                         `json:"version,omitempty"`
	WouldIngest  []ExtensionValidationComponent `json:"would_ingest,omitempty"`
	Manifest     *ExtensionManifestSummary      `json:"manifest,omitempty"`
	Issues       []ValidationIssue              `json:"issues"`
	ConsentAreas []ConsentArea                  `json:"consent_areas,omitempty"`
	DualManifest bool                           `json:"-"`
}

ExtensionValidatePayload is the shared result for extension-package validation surfaces.

type ExtensionValidationComponent

type ExtensionValidationComponent struct {
	Kind      string `json:"kind"`
	Name      string `json:"name"`
	Transport string `json:"transport,omitempty"`
	Detail    string `json:"-"`
}

ExtensionValidationComponent is one resource a valid portable package would ingest.

type ExtensionValidationErrorPayload

type ExtensionValidationErrorPayload struct {
	Error      string            `json:"error"`
	Diagnostic *DiagnosticItem   `json:"diagnostic,omitzero"`
	Issues     []ValidationIssue `json:"issues"`
}

ExtensionValidationErrorPayload reports positioned extension validation failures.

type ExtensionsResponse

type ExtensionsResponse struct {
	Extensions []ExtensionPayload `json:"extensions"`
}

ExtensionsResponse wraps the extension list payload.

type FSBrowseResponse

type FSBrowseResponse struct {
	Path    string           `json:"path"`
	Parent  string           `json:"parent,omitempty"`
	Home    string           `json:"home,omitempty"`
	Roots   []string         `json:"roots"`
	Entries []FSEntryPayload `json:"entries"`
}

FSBrowseResponse lists the contents of one directory plus navigation anchors.

type FSEntryPayload

type FSEntryPayload struct {
	Name  string `json:"name"`
	Path  string `json:"path"`
	IsDir bool   `json:"is_dir"`
}

FSEntryPayload describes one filesystem entry returned by the directory browser.

type FailTaskRunRequest

type FailTaskRunRequest struct {
	Error    string          `json:"error"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

FailTaskRunRequest is the shared run-fail request payload.

type FanOutTaskRunsRequest

type FanOutTaskRunsRequest struct {
	Designations   []TaskFanOutRunDesignationRequest `json:"designations"`
	IdempotencyKey string                            `json:"idempotency_key,omitempty"`
	WorktreePerRun bool                              `json:"worktree_per_run,omitzero"`
}

FanOutTaskRunsRequest captures one designated fan-out enqueue request.

type FanOutTaskRunsResponse

type FanOutTaskRunsResponse struct {
	DesignationGroupID string           `json:"designation_group_id"`
	Runs               []TaskRunPayload `json:"runs"`
}

FanOutTaskRunsResponse wraps designated sibling runs enqueued for one task.

type ForceFailTaskRunRequest

type ForceFailTaskRunRequest struct {
	Reason   string          `json:"reason"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

ForceFailTaskRunRequest is the shared forced-failure request payload.

type ForceReleaseTaskRunRequest

type ForceReleaseTaskRunRequest struct {
	Reason   string          `json:"reason,omitempty"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

ForceReleaseTaskRunRequest is the shared force-release request payload.

type ForkLoopRequest

type ForkLoopRequest struct {
	Generation int64          `json:"generation"`
	Inputs     map[string]any `json:"inputs,omitempty"`
	Reason     string         `json:"reason,omitempty"`
	RequestID  string         `json:"request_id,omitempty"`
}

type ForkLoopResponse

type ForkLoopResponse struct {
	Run      LoopRunPayload `json:"run"`
	Replayed bool           `json:"replayed,omitzero"`
}

type ForkSessionRequest

type ForkSessionRequest struct {
	MessageID           string `json:"message_id,omitempty"`
	Name                string `json:"name,omitempty"`
	IdempotencyKey      string `json:"idempotency_key"`
	ExpectedEpoch       *int64 `json:"expected_epoch,omitzero"`
	ExpectedGeneration  *int64 `json:"expected_generation,omitzero"`
	ExpectedMaxSequence *int64 `json:"expected_max_sequence,omitzero"`
}

ForkSessionRequest forks a user session with the same agent, runtime, and account. MessageID cuts through that durable user message and its turn; absent forks the whole session. The three fences are optional and must be sent together.

type ForkSessionWorktreeRequest

type ForkSessionWorktreeRequest struct {
	Worktree    string                     `json:"worktree,omitempty"`
	NewWorktree *NewSessionWorktreeRequest `json:"new_worktree,omitzero"`
	Confirmed   bool                       `json:"confirmed"`
}

ForkSessionWorktreeRequest creates a clean child session in one worktree. Confirmed is mandatory because the origin session is never moved in place.

type GatewayAddressPayload

type GatewayAddressPayload struct {
	Tier    string `json:"tier"`
	Address string `json:"address"`
	Live    bool   `json:"live"`
}

GatewayAddressPayload reports one listener address without credential material.

type GatewayAuditAuthPayload

type GatewayAuditAuthPayload struct {
	Mode              string `json:"mode"`
	RequiredRemotely  bool   `json:"required_remotely"`
	ActiveDeviceCount int    `json:"active_device_count"`
}

GatewayAuditAuthPayload describes the active remote authentication boundary.

type GatewayAuditFindingPayload

type GatewayAuditFindingPayload struct {
	ID          string `json:"id"`
	Severity    string `json:"severity"`
	Summary     string `json:"summary"`
	Remediation string `json:"remediation"`
	Tier        string `json:"tier,omitempty"`
	Resource    string `json:"resource,omitempty"`
}

GatewayAuditFindingPayload is one stable, ranked, actionable finding.

type GatewayAuditPayload

type GatewayAuditPayload struct {
	Ran              bool                         `json:"ran"`
	NoFindings       bool                         `json:"no_findings"`
	LocalOnly        bool                         `json:"local_only"`
	Status           GatewayStatusPayload         `json:"status"`
	Auth             GatewayAuditAuthPayload      `json:"auth"`
	DeviceHighlights GatewayDeviceHighlights      `json:"device_highlights"`
	Findings         []GatewayAuditFindingPayload `json:"findings"`
}

GatewayAuditPayload is one completed, redacted security posture audit.

type GatewayDeviceHighlights

type GatewayDeviceHighlights struct {
	Active         int      `json:"active"`
	Revoked        int      `json:"revoked"`
	Stale          int      `json:"stale"`
	RecentlyPaired int      `json:"recently_paired"`
	StaleDeviceIDs []string `json:"stale_device_ids"`
}

GatewayDeviceHighlights summarizes inventory signals without credential material.

type GatewayDevicePayload

type GatewayDevicePayload struct {
	ID            string     `json:"id"`
	Name          string     `json:"name"`
	ActorKind     string     `json:"actor_kind"`
	PairingOrigin string     `json:"pairing_origin"`
	RevokeEpoch   uint64     `json:"revoke_epoch"`
	CreatedAt     time.Time  `json:"created_at"`
	LastSeenAt    *time.Time `json:"last_seen_at,omitempty"`
	RevokedAt     *time.Time `json:"revoked_at,omitempty"`
}

GatewayDevicePayload is the redacted representation of one paired device.

type GatewayDeviceRenameRequest

type GatewayDeviceRenameRequest struct {
	Name string `json:"name" binding:"required"`
}

GatewayDeviceRenameRequest changes a paired device's operator-visible name.

type GatewayDevicesResponse

type GatewayDevicesResponse struct {
	Devices []GatewayDevicePayload `json:"devices"`
}

GatewayDevicesResponse wraps the redacted paired-device inventory.

type GatewayIngressBindRequest

type GatewayIngressBindRequest struct {
	SubjectKind string `json:"subject_kind" binding:"required"`
	SubjectID   string `json:"subject_id"   binding:"required"`
	Confirmed   bool   `json:"confirmed"    binding:"required"`
}

GatewayIngressBindRequest confirms public ingress for one supported subject.

type GatewayIngressBindingResponse

type GatewayIngressBindingResponse struct {
	Binding GatewayIngressPayload `json:"binding"`
	Changed bool                  `json:"changed"`
}

GatewayIngressBindingResponse reports the projected binding and whether it changed.

type GatewayIngressPayload

type GatewayIngressPayload struct {
	SubjectKind                 string     `json:"subject_kind"`
	SubjectID                   string     `json:"subject_id"`
	ScopeKind                   string     `json:"scope_kind"`
	WorkspaceID                 string     `json:"workspace_id,omitempty"`
	URL                         string     `json:"url,omitempty"`
	Reachability                string     `json:"reachability"`
	EndpointGeneration          uint64     `json:"endpoint_generation"`
	ConfirmedEndpointGeneration uint64     `json:"confirmed_endpoint_generation,omitempty"`
	ConfirmedAt                 *time.Time `json:"confirmed_at,omitempty"`
	EnablePath                  string     `json:"enable_path,omitempty"`
}

GatewayIngressPayload is the redacted reachability projection for one subject.

type GatewayIngressUnbindResponse

type GatewayIngressUnbindResponse struct {
	SubjectKind string `json:"subject_kind"`
	SubjectID   string `json:"subject_id"`
	Changed     bool   `json:"changed"`
}

GatewayIngressUnbindResponse reports the subject removed from public ingress.

type GatewayIssuedCredentialPayload

type GatewayIssuedCredentialPayload struct {
	Device     GatewayDevicePayload `json:"device"`
	Credential string               `json:"credential,omitempty"`
}

GatewayIssuedCredentialPayload carries a paired device and its one-time credential.

type GatewayPairingArtifactPayload

type GatewayPairingArtifactPayload struct {
	Artifact  string    `json:"artifact"`
	ExpiresAt time.Time `json:"expires_at"`
}

GatewayPairingArtifactPayload carries one short-lived, single-use pairing artifact.

type GatewayPairingRedeemRequest

type GatewayPairingRedeemRequest struct {
	Artifact   string `json:"artifact"             binding:"required"`
	Name       string `json:"name"                 binding:"required"`
	ActorKind  string `json:"actor_kind"           binding:"required"`
	Credential string `json:"credential,omitempty"`
}

GatewayPairingRedeemRequest exchanges a pairing artifact for a device credential.

type GatewayProviderEnableRequest

type GatewayProviderEnableRequest struct {
	Tier               string `json:"tier"                       binding:"required"`
	InstallSource      string `json:"install_source"             binding:"required"`
	DigestConfirmed    string `json:"digest_confirmed,omitempty"`
	ExpectedGeneration uint64 `json:"expected_generation"`
}

GatewayProviderEnableRequest enables one provider from a confirmed install source.

type GatewayProviderPayload

type GatewayProviderPayload struct {
	Name       string `json:"name"`
	Tier       string `json:"tier"`
	Desired    string `json:"desired"`
	Observed   string `json:"observed"`
	Generation uint64 `json:"generation"`
	Health     string `json:"health"`
	Cause      string `json:"cause,omitempty"`
}

GatewayProviderPayload reports lifecycle and health for one connectivity provider.

type GatewayRefusalPayload

type GatewayRefusalPayload struct {
	Cause string `json:"cause"`
	Fix   string `json:"fix"`
}

GatewayRefusalPayload explains why exposure was refused and how to resolve it.

type GatewayRevokePayload

type GatewayRevokePayload struct {
	Device   GatewayDevicePayload `json:"device"`
	Changed  bool                 `json:"changed"`
	Canceled int                  `json:"canceled"`
}

GatewayRevokePayload reports the result of revoking a paired device.

type GatewayStatusPayload

type GatewayStatusPayload struct {
	Enabled   bool                     `json:"enabled"`
	Changed   bool                     `json:"changed"`
	Tiers     []GatewayTierPayload     `json:"tiers"`
	Surfaces  []GatewaySurfacePayload  `json:"surfaces"`
	Providers []GatewayProviderPayload `json:"providers"`
	Addresses []GatewayAddressPayload  `json:"addresses"`
	Devices   []GatewayDevicePayload   `json:"devices"`
	Bindings  []GatewayIngressPayload  `json:"bindings"`
	Refusal   *GatewayRefusalPayload   `json:"refusal,omitzero"`
}

GatewayStatusPayload is the redacted operator-global exposure projection.

type GatewayStreamTicketPayload

type GatewayStreamTicketPayload struct {
	Ticket    string    `json:"ticket"`
	ExpiresAt time.Time `json:"expires_at"`
}

GatewayStreamTicketPayload carries one short-lived, single-use stream ticket.

type GatewaySurfacePayload

type GatewaySurfacePayload struct {
	Surface    string `json:"surface"`
	Tier       string `json:"tier"`
	Desired    string `json:"desired"`
	Observed   string `json:"observed"`
	Generation uint64 `json:"generation"`
}

GatewaySurfacePayload reports exposure state for one gateway surface.

type GatewaySurfaceRequest

type GatewaySurfaceRequest struct {
	Surface            string `json:"surface"             binding:"required"`
	Tier               string `json:"tier"                binding:"required"`
	Desired            string `json:"desired"             binding:"required"`
	ExpectedGeneration uint64 `json:"expected_generation"`
	Consent            bool   `json:"consent"`
}

GatewaySurfaceRequest changes one gateway surface using optimistic concurrency.

type GatewayTierPayload

type GatewayTierPayload struct {
	Tier            string `json:"tier"`
	Desired         string `json:"desired"`
	Observed        string `json:"observed"`
	ListenerAddress string `json:"listener_address,omitempty"`
	Advertised      bool   `json:"advertised"`
}

GatewayTierPayload reports desired and observed state for one gateway tier.

type GoalBlockingIssue

type GoalBlockingIssue struct {
	ID   string `json:"id"`
	Note string `json:"note"`
}

GoalBlockingIssue is one public verdict blocker.

type GoalCommandOutcome

type GoalCommandOutcome string

GoalCommandOutcome is the structured Goal command result vocabulary.

const (
	GoalOutcomeStarted  GoalCommandOutcome = "started"
	GoalOutcomeReplaced GoalCommandOutcome = "replaced"
	GoalOutcomeStatus   GoalCommandOutcome = "status"
	GoalOutcomePaused   GoalCommandOutcome = "paused"
	GoalOutcomeStopped  GoalCommandOutcome = "stopped"
	GoalOutcomeResumed  GoalCommandOutcome = "resumed"
	GoalOutcomeCleared  GoalCommandOutcome = "cleared"
	GoalOutcomeError    GoalCommandOutcome = "error"
)

type GoalCommandResult

type GoalCommandResult struct {
	Outcome       GoalCommandOutcome `json:"outcome"`
	ReasonCode    *GoalReasonCode    `json:"reason_code"`
	Snapshot      *GoalSnapshot      `json:"snapshot"`
	ReplacedRunID *string            `json:"replaced_run_id"`
}

GoalCommandResult is the shared structured success/error envelope for Goal operations.

type GoalContextSnapshot

type GoalContextSnapshot struct {
	State      GoalContextState `json:"state"`
	Diagnostic string           `json:"diagnostic,omitempty"`
	Used       *int64           `json:"used"`
	Size       *int64           `json:"size"`
	Ratio      *float64         `json:"ratio"`
	NudgeRatio float64          `json:"nudge_ratio"`
	ReportedAt *time.Time       `json:"reported_at"`
}

GoalContextSnapshot is checkpoint-pinned context telemetry.

type GoalContextState

type GoalContextState string

GoalContextState is the closed public context freshness vocabulary.

const (
	GoalContextKnown   GoalContextState = "known"
	GoalContextUnknown GoalContextState = "unknown"
	GoalContextPending GoalContextState = "pending"
)

type GoalCriterionResult

type GoalCriterionResult struct {
	ID             string                  `json:"id"`
	Type           string                  `json:"type"`
	Outcome        GoalVerdictOutcome      `json:"outcome"`
	Passed         bool                    `json:"passed"`
	Broken         bool                    `json:"broken,omitzero"`
	ExitCode       *int                    `json:"exit_code,omitzero"`
	Stdout         string                  `json:"stdout,omitempty"`
	Stderr         string                  `json:"stderr,omitempty"`
	Score          *float64                `json:"score,omitzero"`
	Evidence       json.RawMessage         `json:"evidence,omitempty"`
	BlockingIssues []GoalBlockingIssue     `json:"blocking_issues,omitempty"`
	Warnings       []GoalDiagnosticWarning `json:"warnings,omitempty"`
	Payload        json.RawMessage         `json:"payload,omitempty"`
}

GoalCriterionResult is one sanitized Goal judge criterion result.

type GoalDiagnosticWarning

type GoalDiagnosticWarning struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}

GoalDiagnosticWarning is one non-terminal Goal judge diagnostic.

type GoalPromptKind

type GoalPromptKind string

GoalPromptKind is the public transcript classification for engine-owned Goal prompts.

const (
	GoalPromptWork         GoalPromptKind = "goal-work"
	GoalPromptContinuation GoalPromptKind = "goal-continuation"
	GoalPromptCompaction   GoalPromptKind = "goal-compaction"
)

type GoalPromptMeta

type GoalPromptMeta struct {
	Kind          GoalPromptKind `json:"kind"`
	RunID         string         `json:"run_id"`
	NodeID        string         `json:"node_id"`
	Generation    int64          `json:"generation"`
	ItemIndex     int            `json:"item_index"`
	Turn          *int           `json:"turn"`
	PromptAttempt int            `json:"prompt_attempt"`
	PromptID      string         `json:"prompt_id"`
}

GoalPromptMeta classifies one engine-owned Goal prompt in persisted transcript events.

type GoalReasonCode

type GoalReasonCode string

GoalReasonCode is the stable public Goal error and transition vocabulary.

const (
	GoalReasonWaitDeferred               GoalReasonCode = "goal_wait_deferred"
	GoalReasonWaitTimeout                GoalReasonCode = "goal_wait_timeout"
	GoalReasonWaitUnavailable            GoalReasonCode = "goal_wait_unavailable"
	GoalReasonOnInstanceMain             GoalReasonCode = "goal_on_instance_main"
	GoalReasonNotActive                  GoalReasonCode = "goal_not_active"
	GoalReasonReplaceRequired            GoalReasonCode = "goal_replace_required"
	GoalReasonReplaceStale               GoalReasonCode = "goal_replace_stale"
	GoalReasonObjectiveRequired          GoalReasonCode = "goal_objective_required"
	GoalReasonObjectiveTooLarge          GoalReasonCode = "goal_objective_too_large"
	GoalReasonContractClauseEmpty        GoalReasonCode = "goal_contract_clause_empty"
	GoalReasonCommandInvalid             GoalReasonCode = "goal_command_invalid"
	GoalReasonDraftRequiresIdle          GoalReasonCode = "goal_draft_requires_idle"
	GoalReasonEvidenceTooLarge           GoalReasonCode = "goal_evidence_too_large"
	GoalReasonReportConflict             GoalReasonCode = "goal_report_conflict"
	GoalReasonSessionBusyQueueFull       GoalReasonCode = "goal_session_busy_queue_full"
	GoalReasonTurnFilterInvalid          GoalReasonCode = "goal_turn_filter_invalid"
	GoalReasonJudgeUnavailable           GoalReasonCode = "goal_judge_unavailable"
	GoalReasonJudgeBroken                GoalReasonCode = "goal_judge_broken"
	GoalReasonJudgeOutcomeInvalid        GoalReasonCode = "goal_judge_outcome_invalid"
	GoalReasonActionControlInvalid       GoalReasonCode = "goal_action_control_invalid"
	GoalReasonStopReasonInvalid          GoalReasonCode = "goal_stop_reason_invalid"
	GoalReasonPromptRequestFailed        GoalReasonCode = "goal_prompt_request_failed"
	GoalReasonAgentRefused               GoalReasonCode = "goal_agent_refused"
	GoalReasonCompactionCancelled        GoalReasonCode = "goal_compaction_cancel" + "led"
	GoalReasonRecoveryAmbiguous          GoalReasonCode = "goal_recovery_ambiguous"
	GoalReasonControlRevokedInFlight     GoalReasonCode = "goal_control_revoked_in_flight"
	GoalReasonReseedConfirmationRequired GoalReasonCode = "goal_reseed_confirmation_required"
	GoalReasonPresubmitRetriesExhausted  GoalReasonCode = "goal_presubmit_retries_exhausted"
	GoalReasonBudgetFenced               GoalReasonCode = "goal_budget_fenced"
	GoalReasonOriginInvalid              GoalReasonCode = "goal_origin_invalid"
	GoalReasonOriginWorkspaceMismatch    GoalReasonCode = "goal_origin_workspace_mismatch"
	GoalReasonOriginProfileUnavailable   GoalReasonCode = "goal_origin_profile_unavailable"
	GoalReasonControlStale               GoalReasonCode = "goal_control_stale"
	GoalReasonPromptFenced               GoalReasonCode = "goal_prompt_fenced"
	GoalReasonSessionCreationMismatch    GoalReasonCode = "session_creation_identity_mismatch"
	GoalReasonContinuousBindingMismatch  GoalReasonCode = "continuous_binding_mismatch"
	GoalReasonRuntimeInvalid             GoalReasonCode = "goal_runtime_invalid"
	GoalReasonCallerUnauthorized         GoalReasonCode = "goal_caller_unauthorized"
)

type GoalSnapshot

type GoalSnapshot struct {
	RunID           string              `json:"run_id"`
	NodeID          string              `json:"node_id"`
	Objective       string              `json:"objective"`
	OriginSessionID string              `json:"origin_session_id"`
	BoundSessionID  string              `json:"bound_session_id"`
	Status          GoalStatus          `json:"status"`
	RunStatus       LoopRunStatus       `json:"run_status"`
	Cause           *GoalReasonCode     `json:"cause"`
	TurnsUsed       int                 `json:"turns_used"`
	TurnLimit       int                 `json:"turn_limit"`
	Live            bool                `json:"live"`
	PauseRequested  bool                `json:"pause_requested,omitzero"`
	ContractSummary string              `json:"contract_summary"`
	LastVerdict     *GoalVerdictSummary `json:"last_verdict"`
	Context         GoalContextSnapshot `json:"context"`
}

GoalSnapshot is the canonical newest session-origin Goal projection.

type GoalSnapshotChangeCause

type GoalSnapshotChangeCause string

GoalSnapshotChangeCause classifies session Goal discovery signals.

const (
	GoalSnapshotCauseStart   GoalSnapshotChangeCause = "start"
	GoalSnapshotCauseReplace GoalSnapshotChangeCause = "replace"
	GoalSnapshotCauseStatus  GoalSnapshotChangeCause = "status"
	GoalSnapshotCauseClear   GoalSnapshotChangeCause = "clear"
	GoalSnapshotCauseReseed  GoalSnapshotChangeCause = "reseed"
)

type GoalSnapshotChangedPayload

type GoalSnapshotChangedPayload struct {
	SessionID      string                  `json:"session_id"`
	RunID          *string                 `json:"run_id"`
	BoundSessionID *string                 `json:"bound_session_id"`
	Revision       int64                   `json:"revision"`
	Cause          GoalSnapshotChangeCause `json:"cause"`
}

GoalSnapshotChangedPayload is the persisted session stream discovery signal.

type GoalStatus

type GoalStatus string

GoalStatus is the closed public Goal lifecycle vocabulary.

const (
	GoalStatusActive        GoalStatus = "active"
	GoalStatusWaiting       GoalStatus = "waiting"
	GoalStatusPaused        GoalStatus = "paused"
	GoalStatusBlocked       GoalStatus = "blocked"
	GoalStatusUsageLimited  GoalStatus = "usage-limited"
	GoalStatusBudgetLimited GoalStatus = "budget-limited"
	GoalStatusComplete      GoalStatus = "complete"
)

type GoalTurn

type GoalTurn struct {
	Seq            int64                   `json:"seq"`
	Generation     int64                   `json:"generation"`
	NodeID         string                  `json:"node_id"`
	ItemIndex      int                     `json:"item_index"`
	Turn           int                     `json:"turn"`
	PromptAttempt  int                     `json:"prompt_attempt"`
	SessionID      string                  `json:"session_id"`
	BindingHandle  string                  `json:"binding_handle"`
	BindingEpoch   int64                   `json:"binding_epoch"`
	PromptID       string                  `json:"prompt_id"`
	ResultStatus   *GoalTurnResultStatus   `json:"result_status"`
	ReasonCode     *GoalReasonCode         `json:"reason_code"`
	StopReason     *ACPPromptStopReason    `json:"stop_reason"`
	VerdictOutcome *GoalVerdictOutcome     `json:"verdict_outcome"`
	BlockingIssues []GoalBlockingIssue     `json:"blocking_issues"`
	Criteria       []GoalCriterionResult   `json:"criteria"`
	Warnings       []GoalDiagnosticWarning `json:"warnings"`
	EvidenceRef    *string                 `json:"evidence_ref"`
	PromptRef      *string                 `json:"prompt_ref"`
	TokensUsed     *int64                  `json:"tokens_used"`
	ActorKind      string                  `json:"actor_kind"`
	ActorID        string                  `json:"actor_id"`
	StartedAt      time.Time               `json:"started_at"`
	EndedAt        *time.Time              `json:"ended_at"`
}

GoalTurn is one immutable-start, optionally terminal Goal audit row.

type GoalTurnPage

type GoalTurnPage struct {
	Turns        []GoalTurn `json:"turns"`
	NextAfterSeq *int64     `json:"next_after_seq"`
}

GoalTurnPage is one run-wide monotonic cursor page.

type GoalTurnResultStatus

type GoalTurnResultStatus string

GoalTurnResultStatus is the closed terminal classification for one Goal turn.

const (
	GoalTurnResultCompleted     GoalTurnResultStatus = "completed"
	GoalTurnResultInvalidResult GoalTurnResultStatus = "invalid-result"
	GoalTurnResultFailed        GoalTurnResultStatus = "failed"
	GoalTurnResultAmbiguous     GoalTurnResultStatus = "ambiguous"
)

type GoalVerdictOutcome

type GoalVerdictOutcome string

GoalVerdictOutcome is the closed Goal judge outcome vocabulary.

const (
	GoalVerdictApproved         GoalVerdictOutcome = "approved"
	GoalVerdictRejected         GoalVerdictOutcome = "rejected"
	GoalVerdictAwaitingApproval GoalVerdictOutcome = "awaiting_approval"
	GoalVerdictBlocked          GoalVerdictOutcome = "blocked"
	GoalVerdictError            GoalVerdictOutcome = "error"
	GoalVerdictTimeout          GoalVerdictOutcome = "timeout"
	GoalVerdictInvalidOutput    GoalVerdictOutcome = "invalid_output"
)

type GoalVerdictSummary

type GoalVerdictSummary struct {
	Outcome        GoalVerdictOutcome  `json:"outcome"`
	BlockingIssues []GoalBlockingIssue `json:"blocking_issues"`
	EvidenceRef    *string             `json:"evidence_ref"`
	EvaluatedAt    time.Time           `json:"evaluated_at"`
}

GoalVerdictSummary is the latest evaluated Goal verdict.

type GroupedAgentCatalogItemPayload

type GroupedAgentCatalogItemPayload struct {
	Name             string       `json:"name"`
	Label            string       `json:"label"`
	Kind             string       `json:"kind"`
	DefinitionDigest string       `json:"definition_digest"`
	Scopes           []string     `json:"scopes"`
	Active           int          `json:"active"`
	Agent            AgentPayload `json:"agent"`
}

GroupedAgentCatalogItemPayload is one identity shared by identical scoped definitions.

type HeartbeatActorKind

type HeartbeatActorKind string

HeartbeatActorKind describes a redacted Heartbeat authoring actor class.

const (
	HeartbeatActorUser      HeartbeatActorKind = "user"
	HeartbeatActorAgent     HeartbeatActorKind = "agent"
	HeartbeatActorExtension HeartbeatActorKind = "extension"
	HeartbeatActorSystem    HeartbeatActorKind = "system"
)

type HeartbeatActorPayload

type HeartbeatActorPayload struct {
	Kind HeartbeatActorKind `json:"kind"`
	Ref  string             `json:"ref,omitempty"`
}

HeartbeatActorPayload records a redacted Heartbeat authoring actor.

type HeartbeatConfigProvenancePayload

type HeartbeatConfigProvenancePayload struct {
	Digest string                       `json:"digest"`
	Subset HeartbeatConfigSubsetPayload `json:"subset"`
}

HeartbeatConfigProvenancePayload reports the Heartbeat config subset that shaped a policy.

type HeartbeatConfigSubsetPayload

type HeartbeatConfigSubsetPayload struct {
	Enabled                      bool   `json:"enabled"`
	MaxBodyBytes                 int64  `json:"max_body_bytes"`
	ContextProjectionBytes       int64  `json:"context_projection_bytes"`
	MinInterval                  string `json:"min_interval"`
	DefaultInterval              string `json:"default_interval"`
	WakeCooldown                 string `json:"wake_cooldown"`
	MaxWakesPerCycle             int    `json:"max_wakes_per_cycle"`
	ActiveSessionOnly            bool   `json:"active_session_only"`
	AllowActiveHoursPreferences  bool   `json:"allow_active_hours_preferences"`
	WakeEventRetention           string `json:"wake_event_retention"`
	SessionHealthStaleAfter      string `json:"session_health_stale_after"`
	SessionHealthHookMinInterval string `json:"session_health_hook_min_interval"`
}

HeartbeatConfigSubsetPayload is the canonical config authority subset for Heartbeat.

type HeartbeatContextProjectionPayload

type HeartbeatContextProjectionPayload struct {
	Include []string `json:"include,omitzero"`
}

HeartbeatContextProjectionPayload captures authored context projection hints.

type HeartbeatDeleteByPathRequest

type HeartbeatDeleteByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	ExpectedDigest string `json:"expected_digest"`
}

HeartbeatDeleteByPathRequest removes HEARTBEAT.md for the route agent.

type HeartbeatDeleteRequest

type HeartbeatDeleteRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	ExpectedDigest string `json:"expected_digest"`
}

HeartbeatDeleteRequest removes HEARTBEAT.md through the managed authoring service.

type HeartbeatFrontmatterPayload

type HeartbeatFrontmatterPayload struct {
	Version     int                                    `json:"version"`
	Enabled     bool                                   `json:"enabled"`
	Summary     string                                 `json:"summary,omitempty"`
	Preferences HeartbeatFrontmatterPreferencesPayload `json:"preferences"`
	Context     HeartbeatContextProjectionPayload      `json:"context"`
}

HeartbeatFrontmatterPayload is the allowlisted strict HEARTBEAT.md metadata projection.

type HeartbeatFrontmatterPreferencesPayload

type HeartbeatFrontmatterPreferencesPayload struct {
	MinInterval  string                       `json:"min_interval,omitempty"`
	ActiveHours  []HeartbeatTimeWindowPayload `json:"active_hours,omitempty"`
	QuietWindows []HeartbeatTimeWindowPayload `json:"quiet_windows,omitempty"`
}

HeartbeatFrontmatterPreferencesPayload captures authored preference hints before config bounds.

type HeartbeatHistoryRequest

type HeartbeatHistoryRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	AgentName   string `json:"agent_name"`
	Limit       int    `json:"limit,omitempty"`
	Cursor      string `json:"cursor,omitempty"`
}

HeartbeatHistoryRequest lists managed HEARTBEAT.md authoring revisions.

type HeartbeatHistoryResponse

type HeartbeatHistoryResponse struct {
	Revisions  []HeartbeatRevisionPayload `json:"revisions"`
	NextCursor string                     `json:"next_cursor,omitempty"`
}

HeartbeatHistoryResponse returns bounded HEARTBEAT.md authoring history.

type HeartbeatMutationResponse

type HeartbeatMutationResponse struct {
	Heartbeat HeartbeatPolicyPayload   `json:"heartbeat"`
	Revision  HeartbeatRevisionPayload `json:"revision"`
}

HeartbeatMutationResponse returns the post-mutation read model and audit row.

type HeartbeatPolicyPayload

type HeartbeatPolicyPayload struct {
	AgentName        string                             `json:"agent_name,omitempty"`
	Enabled          bool                               `json:"enabled"`
	Present          bool                               `json:"present"`
	Active           bool                               `json:"active"`
	Valid            bool                               `json:"valid"`
	ValidationStatus AuthoredValidationStatus           `json:"validation_status"`
	SourcePath       string                             `json:"source_path,omitempty"`
	Digest           string                             `json:"digest,omitempty"`
	ConfigDigest     string                             `json:"config_digest,omitempty"`
	SnapshotID       string                             `json:"snapshot_id,omitempty"`
	SchemaVersion    int                                `json:"schema_version"`
	Summary          string                             `json:"summary,omitempty"`
	GuidanceMarkdown string                             `json:"guidance_markdown,omitempty"`
	Frontmatter      HeartbeatFrontmatterPayload        `json:"frontmatter"`
	Preferences      HeartbeatPreferencesPayload        `json:"preferences"`
	ConfigProvenance HeartbeatConfigProvenancePayload   `json:"config_provenance"`
	Prompt           HeartbeatPromptContributionPayload `json:"prompt"`
	Diagnostics      []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
	Limits           AuthoredContextLimitsPayload       `json:"limits"`
	CreatedAt        *time.Time                         `json:"created_at,omitempty"`
}

HeartbeatPolicyPayload is the full resolved HEARTBEAT.md read model.

func HeartbeatPolicyPayloadFromResolved

func HeartbeatPolicyPayloadFromResolved(
	agentName string,
	policy *heartbeatpkg.ResolvedPolicy,
	snapshotID string,
) (HeartbeatPolicyPayload, error)

HeartbeatPolicyPayloadFromResolved converts a resolver result into the full Heartbeat read model.

type HeartbeatPreferencesPayload

type HeartbeatPreferencesPayload struct {
	MinInterval  string                            `json:"min_interval"`
	ActiveHours  []HeartbeatTimeWindowPayload      `json:"active_hours,omitempty"`
	QuietWindows []HeartbeatTimeWindowPayload      `json:"quiet_windows,omitempty"`
	Context      HeartbeatContextProjectionPayload `json:"context"`
}

HeartbeatPreferencesPayload captures config-bound wake policy hints.

type HeartbeatPromptContributionPayload

type HeartbeatPromptContributionPayload struct {
	Active           bool                               `json:"active"`
	Digest           string                             `json:"digest,omitempty"`
	ConfigDigest     string                             `json:"config_digest,omitempty"`
	SourcePath       string                             `json:"source_path,omitempty"`
	Summary          string                             `json:"summary,omitempty"`
	GuidanceMarkdown string                             `json:"guidance_markdown,omitempty"`
	Preferences      HeartbeatPreferencesPayload        `json:"preferences"`
	Truncated        bool                               `json:"truncated"`
	MaxBytes         int64                              `json:"max_bytes"`
	MaxBodyBytes     int64                              `json:"max_body_bytes"`
	Diagnostics      []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
	Context          HeartbeatContextProjectionPayload  `json:"context"`
}

HeartbeatPromptContributionPayload is the bounded synthetic-wake prompt contribution.

type HeartbeatPutByPathRequest

type HeartbeatPutByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	Body           string `json:"body"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

HeartbeatPutByPathRequest creates or replaces HEARTBEAT.md for the route agent.

type HeartbeatPutRequest

type HeartbeatPutRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	Body           string `json:"body"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

HeartbeatPutRequest creates or replaces HEARTBEAT.md through the managed authoring service.

type HeartbeatRevisionOperation

type HeartbeatRevisionOperation string

HeartbeatRevisionOperation describes one managed HEARTBEAT.md authoring mutation.

const (
	HeartbeatRevisionWrite    HeartbeatRevisionOperation = "write"
	HeartbeatRevisionDelete   HeartbeatRevisionOperation = "delete"
	HeartbeatRevisionRollback HeartbeatRevisionOperation = "rollback"
)

type HeartbeatRevisionPayload

type HeartbeatRevisionPayload struct {
	ID             string                     `json:"id"`
	AgentName      string                     `json:"agent_name"`
	SourcePath     string                     `json:"source_path"`
	Operation      HeartbeatRevisionOperation `json:"operation"`
	PreviousDigest string                     `json:"previous_digest,omitempty"`
	NewDigest      string                     `json:"new_digest,omitempty"`
	NewSnapshotID  string                     `json:"new_snapshot_id,omitempty"`
	Actor          HeartbeatActorPayload      `json:"actor"`
	CreatedAt      time.Time                  `json:"created_at"`
}

HeartbeatRevisionPayload is a redacted HEARTBEAT.md authoring history row.

func HeartbeatRevisionPayloadFromDomain

func HeartbeatRevisionPayloadFromDomain(revision heartbeatpkg.Revision) (HeartbeatRevisionPayload, error)

HeartbeatRevisionPayloadFromDomain converts a Heartbeat authoring revision into the public DTO.

type HeartbeatRollbackByPathRequest

type HeartbeatRollbackByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	RevisionID     string `json:"revision_id,omitempty"`
	TargetDigest   string `json:"target_digest,omitempty"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

HeartbeatRollbackByPathRequest restores a HEARTBEAT.md revision for the route agent.

type HeartbeatRollbackRequest

type HeartbeatRollbackRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	RevisionID     string `json:"revision_id,omitempty"`
	TargetDigest   string `json:"target_digest,omitempty"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

HeartbeatRollbackRequest restores a prior HEARTBEAT.md revision or snapshot body.

type HeartbeatStatusRequest

type HeartbeatStatusRequest struct {
	WorkspaceID             string `json:"workspace_id,omitempty"`
	AgentName               string `json:"agent_name"`
	SessionID               string `json:"session_id,omitempty"`
	IncludeSessionHealth    bool   `json:"include_session_health,omitempty"`
	IncludeRecentWakeEvents bool   `json:"include_recent_wake_events,omitempty"`
}

HeartbeatStatusRequest composes policy, wake state, and optional session health.

type HeartbeatStatusResponse

type HeartbeatStatusResponse struct {
	AgentName        string                             `json:"agent_name"`
	SourcePath       string                             `json:"source_path,omitempty"`
	Enabled          bool                               `json:"enabled"`
	Present          bool                               `json:"present"`
	Active           bool                               `json:"active"`
	Valid            bool                               `json:"valid"`
	ValidationStatus AuthoredValidationStatus           `json:"validation_status"`
	Digest           string                             `json:"digest,omitempty"`
	ConfigDigest     string                             `json:"config_digest,omitempty"`
	SnapshotID       string                             `json:"snapshot_id,omitempty"`
	Summary          string                             `json:"summary,omitempty"`
	Preferences      HeartbeatPreferencesPayload        `json:"preferences"`
	Diagnostics      []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
	WakeState        *HeartbeatWakeStatePayload         `json:"wake_state,omitempty"`
	WakeEvents       []HeartbeatWakeEventPayload        `json:"wake_events,omitempty"`
	SessionHealth    *SessionHealthPayload              `json:"session_health,omitempty"`
	RevisionCursor   string                             `json:"revision_cursor,omitempty"`
}

HeartbeatStatusResponse composes policy status, wake state, recent wake audit, and optional health.

func HeartbeatStatusResponseFromResult

func HeartbeatStatusResponseFromResult(result *heartbeatpkg.StatusResult) (HeartbeatStatusResponse, error)

HeartbeatStatusResponseFromResult converts composed Heartbeat status into the public DTO.

type HeartbeatTimeWindowPayload

type HeartbeatTimeWindowPayload struct {
	Timezone string `json:"timezone"`
	Start    string `json:"start"`
	End      string `json:"end"`
}

HeartbeatTimeWindowPayload is one authored local wall-clock active or quiet window.

type HeartbeatValidateByPathRequest

type HeartbeatValidateByPathRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	Body        string `json:"body"`
}

HeartbeatValidateByPathRequest validates HEARTBEAT.md for the route agent.

type HeartbeatValidateRequest

type HeartbeatValidateRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	AgentName   string `json:"agent_name,omitempty"`
	Body        string `json:"body"`
}

HeartbeatValidateRequest validates a proposed HEARTBEAT.md body.

type HeartbeatWakeByPathRequest

type HeartbeatWakeByPathRequest struct {
	WorkspaceID    string              `json:"workspace_id,omitempty"`
	SessionID      string              `json:"session_id"`
	Source         HeartbeatWakeSource `json:"source"`
	DryRun         bool                `json:"dry_run,omitzero"`
	IdempotencyKey string              `json:"idempotency_key,omitempty"`
}

HeartbeatWakeByPathRequest asks for one wake decision for the route agent.

type HeartbeatWakeDecisionPayload

type HeartbeatWakeDecisionPayload struct {
	WakeEventID       string                             `json:"wake_event_id,omitempty"`
	Result            HeartbeatWakeResult                `json:"result"`
	Reason            HeartbeatWakeReason                `json:"reason"`
	PolicySnapshotID  string                             `json:"policy_snapshot_id,omitempty"`
	PolicyDigest      string                             `json:"policy_digest,omitempty"`
	ConfigDigest      string                             `json:"config_digest,omitempty"`
	SyntheticPromptID string                             `json:"synthetic_prompt_id,omitempty"`
	Diagnostics       []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
}

HeartbeatWakeDecisionPayload reports the auditable result of one wake decision.

func HeartbeatWakeDecisionPayloadFromDomain

func HeartbeatWakeDecisionPayloadFromDomain(
	decision heartbeatpkg.WakeDecision,
) (HeartbeatWakeDecisionPayload, error)

HeartbeatWakeDecisionPayloadFromDomain converts one wake decision into the public DTO.

type HeartbeatWakeEventPayload

type HeartbeatWakeEventPayload struct {
	ID                string              `json:"id"`
	WorkspaceID       string              `json:"workspace_id,omitempty"`
	AgentName         string              `json:"agent_name,omitempty"`
	SessionID         string              `json:"session_id,omitempty"`
	PolicySnapshotID  string              `json:"policy_snapshot_id,omitempty"`
	Source            HeartbeatWakeSource `json:"source"`
	Result            HeartbeatWakeResult `json:"result"`
	Reason            HeartbeatWakeReason `json:"reason"`
	Detail            string              `json:"detail,omitempty"`
	SyntheticPromptID string              `json:"synthetic_prompt_id,omitempty"`
	CreatedAt         time.Time           `json:"created_at"`
	ExpiresAt         time.Time           `json:"expires_at"`
}

HeartbeatWakeEventPayload is one retained Heartbeat wake audit row.

func HeartbeatWakeEventPayloadFromDomain

func HeartbeatWakeEventPayloadFromDomain(event heartbeatpkg.WakeEvent) (HeartbeatWakeEventPayload, error)

HeartbeatWakeEventPayloadFromDomain converts one wake audit row into the public DTO.

type HeartbeatWakeReason

type HeartbeatWakeReason string

HeartbeatWakeReason is the closed deterministic reason for Heartbeat wake audit.

const (
	HeartbeatWakeReasonSent                  HeartbeatWakeReason = "wake_sent"
	HeartbeatWakeReasonDisabled              HeartbeatWakeReason = "heartbeat_disabled"
	HeartbeatWakeReasonInvalid               HeartbeatWakeReason = "heartbeat_invalid"
	HeartbeatWakeReasonNoPolicy              HeartbeatWakeReason = "heartbeat_no_policy"
	HeartbeatWakeReasonRateLimited           HeartbeatWakeReason = "heartbeat_rate_limited"
	HeartbeatWakeReasonNoEligibleSession     HeartbeatWakeReason = "heartbeat_no_eligible_session"
	HeartbeatWakeReasonCooldownActive        HeartbeatWakeReason = "cooldown_active"
	HeartbeatWakeReasonQuietWindow           HeartbeatWakeReason = "quiet_window"
	HeartbeatWakeReasonSessionNotFound       HeartbeatWakeReason = "session_not_found"
	HeartbeatWakeReasonSessionUnhealthy      HeartbeatWakeReason = "session_unhealthy"
	HeartbeatWakeReasonSessionNotAttachable  HeartbeatWakeReason = "session_not_attachable"
	HeartbeatWakeReasonSessionPromptActive   HeartbeatWakeReason = "session_prompt_active"
	HeartbeatWakeReasonSessionPromptRace     HeartbeatWakeReason = "session_prompt_active_race"
	HeartbeatWakeReasonSyntheticPromptFailed HeartbeatWakeReason = "synthetic_prompt_failed"
	HeartbeatWakeReasonCoalesced             HeartbeatWakeReason = "wake_coalesced"
)

func (HeartbeatWakeReason) Valid

func (r HeartbeatWakeReason) Valid() bool

Valid reports whether the wake reason is a closed enum member.

func (HeartbeatWakeReason) Validate

func (r HeartbeatWakeReason) Validate() error

Validate reports an error for values outside the closed wake reason enum.

type HeartbeatWakeRequest

type HeartbeatWakeRequest struct {
	WorkspaceID    string              `json:"workspace_id,omitempty"`
	AgentName      string              `json:"agent_name"`
	SessionID      string              `json:"session_id"`
	Source         HeartbeatWakeSource `json:"source"`
	DryRun         bool                `json:"dry_run,omitempty"`
	IdempotencyKey string              `json:"idempotency_key,omitempty"`
}

HeartbeatWakeRequest asks for one manual advisory Heartbeat wake decision.

type HeartbeatWakeResponse

type HeartbeatWakeResponse struct {
	Decision HeartbeatWakeDecisionPayload `json:"decision"`
}

HeartbeatWakeResponse wraps one advisory wake decision.

type HeartbeatWakeResult

type HeartbeatWakeResult string

HeartbeatWakeResult classifies the outcome of an advisory Heartbeat wake attempt.

const (
	HeartbeatWakeResultSent        HeartbeatWakeResult = "sent"
	HeartbeatWakeResultSkipped     HeartbeatWakeResult = "skipped"
	HeartbeatWakeResultCoalesced   HeartbeatWakeResult = "coalesced"
	HeartbeatWakeResultRateLimited HeartbeatWakeResult = "rate_limited"
	HeartbeatWakeResultFailed      HeartbeatWakeResult = "failed"
)

type HeartbeatWakeSource

type HeartbeatWakeSource string

HeartbeatWakeSource classifies who requested an advisory Heartbeat wake.

const (
	HeartbeatWakeSourceScheduler      HeartbeatWakeSource = "scheduler"
	HeartbeatWakeSourceManual         HeartbeatWakeSource = "manual"
	HeartbeatWakeSourceHarnessReentry HeartbeatWakeSource = "harness_reentry"
)

type HeartbeatWakeStatePayload

type HeartbeatWakeStatePayload struct {
	WorkspaceID      string              `json:"workspace_id,omitempty"`
	AgentName        string              `json:"agent_name,omitempty"`
	SessionID        string              `json:"session_id"`
	PolicySnapshotID string              `json:"policy_snapshot_id,omitempty"`
	LastWakeAt       *time.Time          `json:"last_wake_at,omitempty"`
	NextAllowedAt    *time.Time          `json:"next_allowed_at,omitempty"`
	CoalescedCount   int                 `json:"coalesced_count"`
	LastResult       HeartbeatWakeResult `json:"last_result"`
	LastReason       HeartbeatWakeReason `json:"last_reason,omitempty"`
	UpdatedAt        time.Time           `json:"updated_at"`
}

HeartbeatWakeStatePayload is the per-session cooldown/coalescing summary.

func HeartbeatWakeStatePayloadFromDomain

func HeartbeatWakeStatePayloadFromDomain(state heartbeatpkg.WakeState) (HeartbeatWakeStatePayload, error)

HeartbeatWakeStatePayloadFromDomain converts wake coalescing state into the public DTO.

type HookCatalogPayload

type HookCatalogPayload struct {
	Order        int                  `json:"order"`
	Name         string               `json:"name"`
	Event        string               `json:"event"`
	Source       string               `json:"source"`
	SkillSource  string               `json:"skill_source,omitempty"`
	Mode         string               `json:"mode"`
	Required     bool                 `json:"required"`
	Priority     int                  `json:"priority"`
	TimeoutMS    int64                `json:"timeout_ms,omitzero"`
	ExecutorKind string               `json:"executor_kind,omitempty"`
	Matcher      hookspkg.HookMatcher `json:"matcher"`
	Metadata     map[string]string    `json:"metadata,omitempty"`
}

HookCatalogPayload is the shared resolved-hook catalog response payload.

type HookCatalogQuery

type HookCatalogQuery struct {
	Workspace string
	Agent     string
	Event     string
	Source    string
	Mode      string
}

HookCatalogQuery captures the shared resolved-hook catalog filters.

type HookCatalogResponse

type HookCatalogResponse struct {
	Hooks []HookCatalogPayload `json:"hooks"`
}

HookCatalogResponse wraps the resolved hook catalog payload.

type HookEventPayload

type HookEventPayload struct {
	Event         string `json:"event"`
	Family        string `json:"family"`
	SyncEligible  bool   `json:"sync_eligible"`
	PayloadSchema string `json:"payload_schema"`
	PatchSchema   string `json:"patch_schema,omitempty"`
}

HookEventPayload is the shared hook taxonomy response payload.

type HookEventsQuery

type HookEventsQuery struct {
	Family   string
	SyncOnly bool
}

HookEventsQuery captures the shared hook taxonomy filters.

type HookEventsResponse

type HookEventsResponse struct {
	Events []HookEventPayload `json:"events"`
}

HookEventsResponse wraps the hook taxonomy payload.

type HookRunPayload

type HookRunPayload struct {
	HookName      string          `json:"hook_name"`
	Event         string          `json:"event"`
	Source        string          `json:"source"`
	Mode          string          `json:"mode"`
	DurationMS    int64           `json:"duration_ms"`
	Outcome       string          `json:"outcome"`
	DispatchDepth int             `json:"dispatch_depth"`
	PatchApplied  json.RawMessage `json:"patch_applied,omitempty"`
	Error         string          `json:"error,omitempty"`
	Required      bool            `json:"required,omitzero"`
	RecordedAt    time.Time       `json:"recorded_at"`
}

HookRunPayload is the shared hook execution history response payload.

type HookRunsQuery

type HookRunsQuery struct {
	Session string
	Event   string
	Outcome string
	Since   string
	Last    int
}

HookRunsQuery captures the shared hook execution history filters.

type HookRunsResponse

type HookRunsResponse struct {
	Runs []HookRunPayload `json:"runs"`
}

HookRunsResponse wraps the hook run history payload.

type InstallExtensionRequest

type InstallExtensionRequest struct {
	Scope                string                          `json:"scope,omitempty"`
	WorkspaceID          string                          `json:"workspace_id,omitempty"`
	Profile              string                          `json:"profile,omitempty"`
	Inputs               map[string]extensioninput.Value `json:"inputs,omitempty"`
	ExpectedDigest       string                          `json:"expected_digest,omitempty"`
	Source               InstallExtensionSource          `json:"source"`
	Ref                  string                          `json:"ref"`
	Version              string                          `json:"version,omitempty"`
	Asset                string                          `json:"asset,omitempty"`
	AllowUnverified      bool                            `json:"allow_unverified,omitzero"`
	ConfirmGatewayDigest string                          `json:"confirm_gateway_digest,omitempty"`
}

InstallExtensionRequest is the shared extension install request payload.

type InstallExtensionSource

type InstallExtensionSource string

InstallExtensionSource is the closed distribution-source union.

const (
	InstallExtensionSourceCurated     InstallExtensionSource = "curated"
	InstallExtensionSourceMarketplace InstallExtensionSource = "marketplace"
	InstallExtensionSourceGitHub      InstallExtensionSource = "github"
	InstallExtensionSourceGit         InstallExtensionSource = "git"
	InstallExtensionSourceLocalPath   InstallExtensionSource = "local_path"
)

type IssueSeverity

type IssueSeverity string

IssueSeverity classifies one extension-package validation issue.

const (
	// IssueSeverityError blocks extension-package use.
	IssueSeverityError IssueSeverity = "error"
	// IssueSeverityWarning reports non-blocking authoring guidance.
	IssueSeverityWarning IssueSeverity = "warning"
	// IssueSeverityWarn reports one non-blocking portable-package skip.
	IssueSeverityWarn IssueSeverity = "warn"
)

type JobPayload

type JobPayload struct {
	ID           string                           `json:"id"`
	ProfileID    string                           `json:"profile_id"`
	ProfileName  string                           `json:"profile_name"`
	ProfileColor string                           `json:"profile_color,omitempty"`
	ProfileIcon  string                           `json:"profile_icon,omitempty"`
	Scope        automationpkg.Scope              `json:"scope"`
	Name         string                           `json:"name"`
	TargetKind   automationpkg.TargetKind         `json:"target_kind"`
	AgentName    string                           `json:"agent_name"`
	WorkspaceID  string                           `json:"workspace_id,omitempty"`
	Prompt       string                           `json:"prompt"`
	Schedule     *automationpkg.ScheduleSpec      `json:"schedule,omitzero"`
	Task         *automationpkg.JobTaskConfig     `json:"task,omitzero"`
	LoopTarget   *automationpkg.LoopTarget        `json:"loop_target,omitzero"`
	Enabled      bool                             `json:"enabled"`
	Retry        automationpkg.RetryConfig        `json:"retry"`
	FireLimit    automationpkg.FireLimitConfig    `json:"fire_limit"`
	Source       automationpkg.JobSource          `json:"source"`
	CreatedAt    time.Time                        `json:"created_at"`
	UpdatedAt    time.Time                        `json:"updated_at"`
	NextRun      *time.Time                       `json:"next_run,omitempty"`
	Scheduler    *AutomationSchedulerStatePayload `json:"scheduler,omitzero"`
	LastRun      *AutomationLastRunPayload        `json:"last_run,omitzero"`
}

JobPayload is the shared automation job response payload.

type JobResponse

type JobResponse struct {
	Job JobPayload `json:"job"`
}

JobResponse wraps one shared automation job payload.

type JobsResponse

type JobsResponse struct {
	Jobs []JobPayload             `json:"jobs"`
	Page CountedCursorPagePayload `json:"page"`
}

JobsResponse wraps the shared automation job list payload.

type LogEventPayload

type LogEventPayload struct {
	ID              string          `json:"id"`
	ProfileID       string          `json:"profile_id"`
	ProfileName     string          `json:"profile_name"`
	ProfileColor    string          `json:"profile_color"`
	ProfileIcon     string          `json:"profile_icon,omitempty"`
	ProfileEmoji    string          `json:"profile_emoji,omitempty"`
	ProfileArchived bool            `json:"profile_archived"`
	SessionID       string          `json:"session_id"`
	WorkspaceID     string          `json:"workspace_id,omitempty"`
	Type            string          `json:"type"`
	AgentName       string          `json:"agent_name"`
	Provider        string          `json:"provider,omitempty"`
	Component       string          `json:"component,omitempty"`
	Outcome         string          `json:"outcome,omitempty"`
	Content         json.RawMessage `json:"content,omitempty"`
	store.EventCorrelation
	ParentSessionID string    `json:"parent_session_id,omitempty"`
	RootSessionID   string    `json:"root_session_id,omitempty"`
	SpawnDepth      int       `json:"spawn_depth"`
	Summary         string    `json:"summary,omitempty"`
	Timestamp       time.Time `json:"timestamp"`
}

LogEventPayload is the shared runtime log response payload.

type LogTailStatusPayload

type LogTailStatusPayload struct {
	Available bool   `json:"available"`
	Status    string `json:"status"`
}

LogTailStatusPayload reports the log-tail capability advertised by settings.

type LogsListResponse

type LogsListResponse struct {
	Events []LogEventPayload `json:"events"`
}

LogsListResponse wraps the runtime logs payload.

type LoopAmendmentValueSummary

type LoopAmendmentValueSummary struct {
	ByteSize    int    `json:"byte_size"`
	ContentHash string `json:"content_hash"`
}

type LoopAnnotationPayload

type LoopAnnotationPayload struct {
	NodeID string  `json:"node_id"`
	X      float64 `json:"x"`
	Y      float64 `json:"y"`
}

LoopAnnotationPayload is one editor node position.

type LoopAnnotationsResponse

type LoopAnnotationsResponse struct {
	Annotations []LoopAnnotationPayload `json:"annotations"`
}

LoopAnnotationsResponse returns editor sidecar positions.

type LoopBackoffSpec

type LoopBackoffSpec struct {
	Base string `json:"base,omitempty"`
	Max  string `json:"max,omitempty"`
}

LoopBackoffSpec bounds retry delays.

type LoopBriefingResponse

type LoopBriefingResponse = looppkg.Briefing

LoopBriefingResponse is the public server-owned run verdict.

type LoopBudget

type LoopBudget struct {
	Tokens       int                `json:"tokens"`
	WallClockSec int                `json:"wall_clock_sec"`
	OnExceeded   LoopBudgetExceeded `json:"on_exceeded,omitempty"`
}

type LoopBudgetExceeded

type LoopBudgetExceeded string

LoopBudgetExceeded controls the outcome for a budget breach.

const (
	LoopBudgetExceededHalt     LoopBudgetExceeded = "halt"
	LoopBudgetExceededEscalate LoopBudgetExceeded = "escalate"
)

type LoopCatalogAggregateEntryPayload

type LoopCatalogAggregateEntryPayload struct {
	WorkspaceID   string                      `json:"workspace_id,omitempty"`
	Name          string                      `json:"name"`
	Version       int                         `json:"version"`
	Description   string                      `json:"description,omitempty"`
	Source        LoopCatalogSourcePayload    `json:"source"`
	Catalog       LoopCatalogResourceSpec     `json:"catalog"`
	Inputs        map[string]LoopInput        `json:"inputs,omitempty"`
	Start         []LoopStartBinding          `json:"start,omitempty"`
	Contract      LoopContract                `json:"contract"`
	LastRun       *LoopCatalogLastRunPayload  `json:"last_run,omitzero"`
	Aggregate30d  LoopCatalogAggregatePayload `json:"aggregate_30d"`
	SuccessRate30 float64                     `json:"success_rate_30d"`
}

LoopCatalogAggregateEntryPayload is one catalog entry of the cross-workspace batch. It repeats the LoopCatalogEntryPayload fields instead of embedding them because its source is an object ({kind, layer}) rather than the plain source kind; embedding would shadow the field and break the generated SDK clients.

func NewLoopCatalogAggregateEntry

func NewLoopCatalogAggregateEntry(entry LoopCatalogEntryPayload, layer string) LoopCatalogAggregateEntryPayload

NewLoopCatalogAggregateEntry builds a batch entry from a workspace catalog entry and its layer.

type LoopCatalogAggregatePayload

type LoopCatalogAggregatePayload struct {
	Runs      int `json:"runs"`
	Succeeded int `json:"succeeded"`
	Failed    int `json:"failed"`
}

LoopCatalogAggregatePayload summarizes recent loop activity.

type LoopCatalogBatchResponse

type LoopCatalogBatchResponse struct {
	Entries   []LoopCatalogAggregateEntryPayload `json:"entries"`
	Errors    []LoopCatalogWorkspaceError        `json:"errors"`
	Truncated bool                               `json:"truncated"`
}

LoopCatalogBatchResponse reports bounded, independently resolved definition populations.

type LoopCatalogEntryPayload

type LoopCatalogEntryPayload struct {
	WorkspaceID   string                      `json:"workspace_id,omitempty"`
	Name          string                      `json:"name"`
	Version       int                         `json:"version"`
	Description   string                      `json:"description,omitempty"`
	Source        LoopSource                  `json:"source"`
	Catalog       LoopCatalogResourceSpec     `json:"catalog"`
	Inputs        map[string]LoopInput        `json:"inputs,omitempty"`
	Start         []LoopStartBinding          `json:"start,omitempty"`
	Contract      LoopContract                `json:"contract"`
	LastRun       *LoopCatalogLastRunPayload  `json:"last_run,omitzero"`
	Aggregate30d  LoopCatalogAggregatePayload `json:"aggregate_30d"`
	SuccessRate30 float64                     `json:"success_rate_30d"`
}

LoopCatalogEntryPayload is one fully hydrated row from a bounded catalog page.

type LoopCatalogFacetsPayload

type LoopCatalogFacetsPayload struct {
	Kinds      map[string]int `json:"kinds"`
	Categories map[string]int `json:"categories"`
	Statuses   map[string]int `json:"statuses"`
}

LoopCatalogFacetsPayload contains exact self-filtered catalog counts.

type LoopCatalogLastRunPayload

type LoopCatalogLastRunPayload struct {
	ID             string        `json:"id"`
	Status         LoopRunStatus `json:"status"`
	BestGeneration *int64        `json:"best_generation,omitzero"`
	BestScore      *float64      `json:"best_score,omitzero"`
	CreatedAt      time.Time     `json:"created_at"`
}

LoopCatalogLastRunPayload identifies the latest run shown in a catalog entry.

type LoopCatalogResourceSpec

type LoopCatalogResourceSpec struct {
	UseWhen  string   `json:"use_when,omitempty"`
	Keywords []string `json:"keywords,omitempty"`
	Category string   `json:"category,omitempty"`
}

LoopCatalogResourceSpec is the public catalog metadata projection.

type LoopCatalogSourcePayload

type LoopCatalogSourcePayload struct {
	Kind  LoopSource `json:"kind"`
	Layer string     `json:"layer"`
}

type LoopCatalogWorkspaceError

type LoopCatalogWorkspaceError struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	Code        string `json:"code"`
	Message     string `json:"message"`
}

type LoopCompletionState

type LoopCompletionState string

LoopCompletionState distinguishes full success from accepted partial completion.

const (
	LoopCompletionStateComplete LoopCompletionState = "complete"
	LoopCompletionStatePartial  LoopCompletionState = "partial"
)

type LoopConfig

type LoopConfig struct {
	HumanGateEnabled  *bool                  `json:"human_gate_enabled,omitzero"`
	ReattemptStrategy *LoopReattemptStrategy `json:"reattempt_strategy,omitzero"`
	EnabledChecks     json.RawMessage        `json:"enabled_checks_json,omitempty"`
	IterationCap      *int                   `json:"iteration_cap,omitzero"`
	BudgetTokens      *int                   `json:"budget_tokens,omitzero"`
	BudgetWallSec     *int                   `json:"budget_wall_sec,omitzero"`
	BudgetOnExceeded  *LoopBudgetExceeded    `json:"budget_on_exceeded,omitzero"`
	NoProgressWindow  *int                   `json:"no_progress_window,omitzero"`
	FanOutWidth       *int                   `json:"fan_out_width,omitzero"`
	GateMaxRevisions  *int                   `json:"gate_max_revisions,omitzero"`
	RuntimeDefaults   *LoopRuntimeDefaults   `json:"runtime_defaults,omitzero"`
	RuntimeRules      []LoopRuntimeRule      `json:"runtime_rules,omitempty"`
	Environment       *LoopEnvironment       `json:"environment,omitzero"`
}

LoopConfig is the public per-loop or per-run override layer.

type LoopConfigResponse

type LoopConfigResponse struct {
	Config          *LoopConfig         `json:"config"`
	EffectiveConfig LoopEffectiveConfig `json:"effective_config"`
}

LoopConfigResponse returns the stored override and daemon-resolved runtime config.

type LoopContract

type LoopContract struct {
	Goal             string               `json:"goal"`
	DefinitionOfDone string               `json:"definition_of_done"`
	Constraints      []string             `json:"constraints,omitempty"`
	Boundaries       []string             `json:"boundaries,omitempty"`
	StopWhen         dsl.StopWhenSpec     `json:"stop_when,omitzero"`
	Verification     []LoopGateCriterion  `json:"verification,omitempty"`
	TerminalStates   []string             `json:"terminal_states,omitempty"`
	IterationCap     int                  `json:"iteration_cap"`
	NoProgress       LoopNoProgress       `json:"no_progress"`
	Budget           LoopBudget           `json:"budget"`
	RuntimeDefaults  *LoopRuntimeDefaults `json:"runtime_defaults,omitzero"`
	RuntimeRules     []LoopRuntimeRule    `json:"runtime_rules,omitempty"`
	*LoopContractLifecycleState
}

type LoopContractLifecycleState

type LoopContractLifecycleState struct {
	OnDone      []LoopEffectSpec `json:"on_done,omitempty"`
	OnNoOp      []LoopEffectSpec `json:"on_noop,omitempty"`
	OnBlocked   []LoopEffectSpec `json:"on_blocked,omitempty"`
	OnFailed    []LoopEffectSpec `json:"on_failed,omitempty"`
	OnExhausted []LoopEffectSpec `json:"on_exhausted,omitempty"`
	OnStalled   []LoopEffectSpec `json:"on_stalled,omitempty"`
	OnCanceled  []LoopEffectSpec `json:"on_canceled,omitempty"`
}

LoopContractLifecycleState carries optional terminal reactions.

type LoopControlProvenancePayload

type LoopControlProvenancePayload struct {
	ActorKind   string    `json:"actor_kind"`
	ActorID     string    `json:"actor_id"`
	Reason      string    `json:"reason,omitempty"`
	RuleID      string    `json:"rule_id,omitempty"`
	RequestedAt time.Time `json:"requested_at"`
}

LoopControlProvenancePayload attributes one node-control mutation.

type LoopDefinitionDocument

type LoopDefinitionDocument dsl.Definition

LoopDefinitionDocument is the public compozy.loop/v1 authoring document. It deliberately shares the DSL's complete authoring shape so public transports cannot lag behind fields accepted by the parser.

func NewLoopDefinitionDocument

func NewLoopDefinitionDocument(definition dsl.Definition) (LoopDefinitionDocument, error)

NewLoopDefinitionDocument returns a caller-owned public authoring document.

func (LoopDefinitionDocument) Decode

func (d LoopDefinitionDocument) Decode(target *dsl.Definition) error

Decode returns a caller-owned canonical DSL definition.

func (LoopDefinitionDocument) MarshalJSON

func (d LoopDefinitionDocument) MarshalJSON() ([]byte, error)

MarshalJSON keeps YAML-inline extension fields on every DSL object visible on JSON transports instead of dropping them through their json:"-" struct tags.

func (*LoopDefinitionDocument) UnmarshalJSON

func (d *LoopDefinitionDocument) UnmarshalJSON(data []byte) error

UnmarshalJSON accepts the same document shape as dsl.Parse, including inline extension fields and polymorphic authoring values.

type LoopDefinitionPayload

type LoopDefinitionPayload struct {
	Name               string                       `json:"name"`
	Version            int                          `json:"version"`
	Description        string                       `json:"description,omitempty"`
	Source             LoopSource                   `json:"source"`
	Catalog            LoopCatalogResourceSpec      `json:"catalog"`
	Definition         LoopDefinitionDocument       `json:"definition"`
	EffectiveConfig    *LoopEffectiveConfig         `json:"effective_config,omitzero"`
	EffectiveLifecycle *LoopResolvedLifecycleConfig `json:"effective_lifecycle,omitzero"`
}

LoopDefinitionPayload is the inspect/publish response for one Loop definition.

type LoopDiffEndpoint

type LoopDiffEndpoint struct {
	RunID      string        `json:"run_id"`
	Generation int64         `json:"generation"`
	Status     LoopRunStatus `json:"status"`
	AsOf       bool          `json:"as_of,omitzero"`
}

type LoopDiffInputRow

type LoopDiffInputRow struct {
	Key     string        `json:"key"`
	Base    LoopDiffValue `json:"base"`
	Against LoopDiffValue `json:"against"`
}

type LoopDiffNodeRow

type LoopDiffNodeRow struct {
	NodeID    string        `json:"node_id"`
	ItemIndex int           `json:"item_index,omitzero"`
	Change    string        `json:"change"`
	Base      LoopDiffValue `json:"base,omitzero"`
	Against   LoopDiffValue `json:"against,omitzero"`
	Cause     string        `json:"cause,omitempty"`
}

type LoopDiffResponse

type LoopDiffResponse struct {
	Kind                 string               `json:"kind"`
	Base                 LoopDiffEndpoint     `json:"base"`
	Against              LoopDiffEndpoint     `json:"against"`
	Inputs               []LoopDiffInputRow   `json:"inputs"`
	Nodes                []LoopDiffNodeRow    `json:"nodes"`
	Terminal             *LoopDiffTerminalRow `json:"terminal,omitzero"`
	DefinitionDivergence bool                 `json:"definition_divergence,omitzero"`
}

type LoopDiffTerminalRow

type LoopDiffTerminalRow struct {
	Base    LoopRunStatus `json:"base"`
	Against LoopRunStatus `json:"against"`
}

type LoopDiffValue

type LoopDiffValue struct {
	Inline json.RawMessage `json:"inline,omitempty"`
	Size   int             `json:"size,omitzero"`
	Hash   string          `json:"hash,omitempty"`
}

type LoopEffectSpec

type LoopEffectSpec struct {
	Emit *LoopEmitSpec  `json:"emit,omitzero"`
	Tool string         `json:"tool,omitempty"`
	With map[string]any `json:"with,omitempty"`
}

LoopEffectSpec describes one emitted event or tool call.

type LoopEffectiveConfig

type LoopEffectiveConfig struct {
	HumanGateEnabled   bool                  `json:"human_gate_enabled"`
	ReattemptStrategy  LoopReattemptStrategy `json:"reattempt_strategy"`
	EnabledChecks      json.RawMessage       `json:"enabled_checks_json"`
	IterationCap       int                   `json:"iteration_cap"`
	BudgetTokens       int                   `json:"budget_tokens"`
	BudgetWallSec      int                   `json:"budget_wall_sec"`
	BudgetOnExceeded   LoopBudgetExceeded    `json:"budget_on_exceeded"`
	NoProgressWindow   int                   `json:"no_progress_window"`
	FanOutWidth        int                   `json:"fan_out_width"`
	GateMaxRevisions   int                   `json:"gate_max_revisions"`
	RuntimeDefaults    LoopRuntimeDefaults   `json:"runtime_defaults"`
	RuntimeRules       []LoopRuntimeRule     `json:"runtime_rules"`
	RunRuntimeRules    []LoopRuntimeRule     `json:"run_runtime_rules,omitempty"`
	Environment        LoopEnvironment       `json:"environment"`
	RequestExpireAfter string                `json:"request_expire_after"`
	Sources            map[string]string     `json:"sources,omitempty"`
}

LoopEffectiveConfig is the public fully resolved runtime config.

type LoopEmitSpec

type LoopEmitSpec struct {
	Kind    string         `json:"kind"`
	Payload map[string]any `json:"payload,omitempty"`
}

LoopEmitSpec describes an emitted internal event.

type LoopEnvironment

type LoopEnvironment struct {
	Mode        LoopEnvironmentMode `json:"mode"`
	WorktreeRef string              `json:"worktree_ref,omitempty"`
	Directory   string              `json:"directory,omitempty"`
}

LoopEnvironment is one loop-level execution environment default.

type LoopEnvironmentMode

type LoopEnvironmentMode string

LoopEnvironmentMode selects the execution root for Loop agent actions.

const (
	LoopEnvironmentModeRoot      LoopEnvironmentMode = "root"
	LoopEnvironmentModeWorktree  LoopEnvironmentMode = "worktree"
	LoopEnvironmentModePerRun    LoopEnvironmentMode = "per_run"
	LoopEnvironmentModeDirectory LoopEnvironmentMode = "directory"
)

type LoopErrorPolicy

type LoopErrorPolicy struct {
	Route     string           `json:"route,omitempty"`
	AllowFail bool             `json:"allow_fail,omitzero"`
	Effects   []LoopEffectSpec `json:"effects,omitempty"`
}

LoopErrorPolicy combines error flow with observational effects.

type LoopForkRef

type LoopForkRef struct {
	RunID      string `json:"run_id"`
	Generation int64  `json:"generation"`
}

type LoopGateBlockingIssuePayload

type LoopGateBlockingIssuePayload struct {
	ID   string `json:"id"`
	Note string `json:"note"`
}

LoopGateBlockingIssuePayload is one sanitized gate_verdict blocker.

type LoopGateCriterion

type LoopGateCriterion struct {
	ID       string `json:"id"`
	Type     string `json:"type"`
	Check    string `json:"check,omitempty"`
	Expect   string `json:"expect,omitempty"`
	Contains string `json:"contains,omitempty"`
	Agent    string `json:"agent,omitempty"`
	//nolint:modernize // OpenAPI requires omitempty; JSON uses omitzero.
	Runtime LoopRuntimeSpec `json:"runtime,omitempty,omitzero"`
	Rubric  string          `json:"rubric,omitempty"`
	Prompt  string          `json:"prompt,omitempty"`
	Tool    string          `json:"tool,omitempty"`
	Inputs  map[string]any  `json:"inputs,omitempty"`
	Metric  *LoopMetricSpec `json:"metric,omitzero"`
}

type LoopGateCriterionDetailPayload

type LoopGateCriterionDetailPayload struct {
	ID             string                         `json:"id"`
	Type           string                         `json:"type"`
	Prompt         string                         `json:"prompt,omitempty"`
	Outcome        LoopGateVerdictOutcome         `json:"outcome"`
	Passed         bool                           `json:"passed"`
	Broken         bool                           `json:"broken,omitzero"`
	ExitCode       *int                           `json:"exit_code,omitzero"`
	Stdout         string                         `json:"stdout,omitempty"`
	Stderr         string                         `json:"stderr,omitempty"`
	Score          *float64                       `json:"score,omitzero"`
	Evidence       json.RawMessage                `json:"evidence,omitempty"`
	BlockingIssues []LoopGateBlockingIssuePayload `json:"blocking_issues,omitempty"`
	Warnings       []LoopGateDiagnosticWarning    `json:"warnings,omitempty"`
	Payload        json.RawMessage                `json:"payload,omitempty"`
}

LoopGateCriterionDetailPayload is one durable criterion diagnostic in generation detail.

type LoopGateCriterionEventPayload

type LoopGateCriterionEventPayload struct {
	ID     string   `json:"id"`
	Type   string   `json:"type"`
	Status string   `json:"status"`
	Note   string   `json:"note"`
	Score  *float64 `json:"score,omitzero"`
}

LoopGateCriterionEventPayload is one sanitized gate_verdict criterion result.

type LoopGateDecision

type LoopGateDecision string

LoopGateDecision is the human gate approval decision vocabulary.

const (
	LoopGateDecisionApprove        LoopGateDecision = "approve"
	LoopGateDecisionRequestChanges LoopGateDecision = "request_changes"
	LoopGateDecisionReject         LoopGateDecision = "reject"
)

type LoopGateDiagnosticWarning

type LoopGateDiagnosticWarning struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}

LoopGateDiagnosticWarning is one non-terminal criterion diagnostic.

type LoopGateVerdictEventPayload

type LoopGateVerdictEventPayload struct {
	NodeID         string                          `json:"node_id"`
	Generation     int64                           `json:"generation"`
	GateID         string                          `json:"gate_id"`
	ItemIndex      int                             `json:"item_index"`
	Verdict        string                          `json:"verdict"`
	Reason         string                          `json:"reason"`
	Route          string                          `json:"route"`
	BlockingIssues []LoopGateBlockingIssuePayload  `json:"blocking_issues"`
	Criteria       []LoopGateCriterionEventPayload `json:"criteria"`
	Score          *float64                        `json:"score,omitzero"`
	BestGeneration *int64                          `json:"best_generation,omitzero"`
}

LoopGateVerdictEventPayload is the exact gate_verdict SSE payload.

type LoopGateVerdictOutcome

type LoopGateVerdictOutcome string

LoopGateVerdictOutcome is the machine gate verdict vocabulary.

const (
	LoopGateVerdictApproved         LoopGateVerdictOutcome = "approved"
	LoopGateVerdictRejected         LoopGateVerdictOutcome = "rejected"
	LoopGateVerdictAwaitingApproval LoopGateVerdictOutcome = "awaiting_approval"
	LoopGateVerdictBlocked          LoopGateVerdictOutcome = "blocked"
	LoopGateVerdictError            LoopGateVerdictOutcome = "error"
	LoopGateVerdictTimeout          LoopGateVerdictOutcome = "timeout"
	LoopGateVerdictInvalidOutput    LoopGateVerdictOutcome = "invalid_output"
)

type LoopGateVerdictPayload

type LoopGateVerdictPayload struct {
	GateID         string                           `json:"gate_id"`
	ItemIndex      int                              `json:"item_index"`
	Outcome        LoopGateVerdictOutcome           `json:"outcome"`
	Score          *float64                         `json:"score,omitzero"`
	RouteCauseRank *int                             `json:"route_cause_rank,omitzero"`
	BlockingIssues []LoopGateBlockingIssuePayload   `json:"blocking_issues"`
	Criteria       []LoopGateCriterionDetailPayload `json:"criteria"`
}

LoopGateVerdictPayload is one queryable machine verdict in generation detail.

type LoopGateVerdictRunEventPayload

type LoopGateVerdictRunEventPayload struct {
	ID          string                      `json:"id"`
	LoopRunID   string                      `json:"loop_run_id"`
	WorkspaceID string                      `json:"workspace_id"`
	Seq         int64                       `json:"seq"`
	Kind        LoopRunEventKind            `json:"kind"`
	Payload     LoopGateVerdictEventPayload `json:"payload"`
	At          time.Time                   `json:"at"`
}

LoopGateVerdictRunEventPayload is the typed gate_verdict event envelope.

type LoopGenerationOrigin

type LoopGenerationOrigin string

LoopGenerationOrigin identifies why a generation exists.

const (
	LoopGenerationOriginInitial            LoopGenerationOrigin = "initial"
	LoopGenerationOriginStopWhen           LoopGenerationOrigin = "stop_when"
	LoopGenerationOriginReattempt          LoopGenerationOrigin = "reattempt"
	LoopGenerationOriginGateRevise         LoopGenerationOrigin = "gate_revise"
	LoopGenerationOriginGateNextGeneration LoopGenerationOrigin = "gate_next_generation"
	LoopGenerationOriginDoDRetry           LoopGenerationOrigin = "dod_retry"
	LoopGenerationOriginRatchetRestore     LoopGenerationOrigin = "ratchet_restore"
	LoopGenerationOriginRequeue            LoopGenerationOrigin = "requeue"
	LoopGenerationOriginOperatorRerun      LoopGenerationOrigin = "operator_rerun"
	LoopGenerationOriginForkSeed           LoopGenerationOrigin = "fork_seed"
)

type LoopGenerationOutput

type LoopGenerationOutput struct {
	Generation      int64                `json:"generation,omitzero"`
	NodeID          string               `json:"node_id"`
	ItemIndex       int                  `json:"item_index,omitzero"`
	Status          string               `json:"status"`
	OutputRef       string               `json:"output_ref,omitempty"`
	TaskRunID       string               `json:"task_run_id,omitempty"`
	SessionID       string               `json:"session_id,omitempty"`
	ChildLoopRunID  string               `json:"child_loop_run_id,omitempty"`
	ResolvedRuntime *LoopResolvedRuntime `json:"resolved_runtime,omitzero"`
	Attempt         int                  `json:"attempt,omitzero"`
	NextAttemptAt   *time.Time           `json:"next_attempt_at,omitempty"`
	FailureClass    string               `json:"failure_class,omitempty"`
	Disposition     string               `json:"disposition,omitempty"`
}

LoopGenerationOutput is one public generation output row.

type LoopGenerationPayload

type LoopGenerationPayload struct {
	Generation       int64                    `json:"generation"`
	ParentGeneration int64                    `json:"parent_generation"`
	Origin           LoopGenerationOrigin     `json:"origin"`
	RouteCauses      []LoopRouteCausePayload  `json:"route_causes"`
	Verdicts         []LoopGateVerdictPayload `json:"verdicts"`
	Outputs          []LoopGenerationOutput   `json:"outputs"`
}

LoopGenerationPayload groups durable provenance, verdicts, and node state by generation.

type LoopGenerationStartedEventPayload

type LoopGenerationStartedEventPayload struct {
	Generation        int64                 `json:"generation"`
	ParentGeneration  int64                 `json:"parent_generation"`
	Origin            LoopGenerationOrigin  `json:"origin"`
	ReattemptStrategy LoopReattemptStrategy `json:"reattempt_strategy"`
	LoopName          string                `json:"loop_name"`
}

LoopGenerationStartedEventPayload is the exact generation_started SSE payload.

type LoopGenerationStartedRunEventPayload

type LoopGenerationStartedRunEventPayload struct {
	ID          string                            `json:"id"`
	LoopRunID   string                            `json:"loop_run_id"`
	WorkspaceID string                            `json:"workspace_id"`
	Seq         int64                             `json:"seq"`
	Kind        LoopRunEventKind                  `json:"kind"`
	Payload     LoopGenerationStartedEventPayload `json:"payload"`
	At          time.Time                         `json:"at"`
}

LoopGenerationStartedRunEventPayload is the typed generation_started event envelope.

type LoopInput

type LoopInput struct {
	Type        dsl.InputType `json:"type"`
	Required    bool          `json:"required,omitzero"`
	Description string        `json:"description,omitempty"`
	Ref         *LoopInputRef `json:"ref,omitzero"`
	Enum        []string      `json:"enum,omitempty"`
	Default     any           `json:"default,omitempty"`
}

LoopInput is the bounded input projection returned by the Loop catalog.

type LoopInputDefaultResponse

type LoopInputDefaultResponse struct {
	LoopName string                 `json:"loop_name"`
	Key      string                 `json:"key"`
	Scope    LoopInputDefaultsScope `json:"scope"`
	Present  bool                   `json:"present"`
	Value    any                    `json:"value,omitempty"`
}

LoopInputDefaultResponse returns one configured key without collapsing explicit zero values.

type LoopInputDefaultsResponse

type LoopInputDefaultsResponse struct {
	LoopName string                 `json:"loop_name"`
	Scope    LoopInputDefaultsScope `json:"scope"`
	Values   map[string]any         `json:"values"`
}

LoopInputDefaultsResponse returns one Loop's configured values at one explicit scope.

type LoopInputDefaultsScope

type LoopInputDefaultsScope string

LoopInputDefaultsScope selects the file-backed config layer managed by an input-default request.

const (
	LoopInputDefaultsScopeUser      LoopInputDefaultsScope = "user"
	LoopInputDefaultsScopeWorkspace LoopInputDefaultsScope = "workspace"
)

type LoopInputOrigin

type LoopInputOrigin string

LoopInputOrigin is the public effective-input provenance vocabulary.

const (
	LoopInputOriginRun        LoopInputOrigin = "run"
	LoopInputOriginWorkspace  LoopInputOrigin = "workspace"
	LoopInputOriginGlobal     LoopInputOrigin = "global"
	LoopInputOriginDefinition LoopInputOrigin = "definition"
)

type LoopInputRef

type LoopInputRef struct {
	Kind dsl.InputRefKind `json:"kind"`
}

type LoopInputValidationErrorPayload

type LoopInputValidationErrorPayload struct {
	Loop   string `json:"loop"`
	Field  string `json:"field"`
	Kind   string `json:"kind,omitempty"`
	Value  string `json:"value,omitempty"`
	Origin string `json:"origin"`
	Reason string `json:"reason"`
}

LoopInputValidationErrorPayload reports one field-addressed input failure.

type LoopLintErrorPayload

type LoopLintErrorPayload struct {
	NodeID   string           `json:"node_id,omitempty"`
	Path     string           `json:"path,omitempty"`
	Code     string           `json:"code"`
	Message  string           `json:"message"`
	Severity LoopLintSeverity `json:"severity"`
}

LoopLintErrorPayload is the per-node 422 payload surfaced to authoring clients.

type LoopLintSeverity

type LoopLintSeverity string

LoopLintSeverity classifies a lint diagnostic.

const (
	LoopLintSeverityError   LoopLintSeverity = "error"
	LoopLintSeverityWarning LoopLintSeverity = "warning"
)

type LoopMetricDirection

type LoopMetricDirection string

LoopMetricDirection determines whether a gate metric should increase or decrease.

const (
	LoopMetricMaximize LoopMetricDirection = "maximize"
	LoopMetricMinimize LoopMetricDirection = "minimize"
)

type LoopMetricSpec

type LoopMetricSpec struct {
	Direction LoopMetricDirection `json:"direction"`
	MinDelta  *float64            `json:"min_delta,omitzero"`
}

LoopMetricSpec declares the score contract for one machine criterion.

type LoopMutationResponse

type LoopMutationResponse struct {
	OK         bool                          `json:"ok"`
	RunID      string                        `json:"run_id"`
	NodeID     string                        `json:"node_id,omitempty"`
	ItemIndex  *int                          `json:"item_index,omitzero"`
	Status     string                        `json:"status,omitempty"`
	Provenance *LoopControlProvenancePayload `json:"provenance,omitzero"`
	Control    *LoopNodeControlPayload       `json:"control,omitzero"`
}

LoopMutationResponse is the shared structured answer for lifecycle verbs.

type LoopNoProgress

type LoopNoProgress struct {
	Window int `json:"window"`
}

type LoopNodeAmendRequest

type LoopNodeAmendRequest struct {
	Generation int             `json:"generation,omitzero"`
	ItemIndex  int             `json:"item_index,omitzero"`
	Payload    json.RawMessage `json:"payload"`
	Reason     string          `json:"reason,omitempty"`
}

type LoopNodeAmendResponse

type LoopNodeAmendResponse struct {
	OK        bool                     `json:"ok"`
	Amendment LoopNodeAmendmentPayload `json:"amendment"`
}

type LoopNodeAmendmentPayload

type LoopNodeAmendmentPayload struct {
	LoopRunID       string                     `json:"loop_run_id"`
	Generation      int                        `json:"generation"`
	NodeID          string                     `json:"node_id"`
	ItemIndex       int                        `json:"item_index"`
	Sequence        int                        `json:"amendment_seq"`
	Original        json.RawMessage            `json:"original,omitempty"`
	Amended         json.RawMessage            `json:"amended,omitempty"`
	OriginalSummary *LoopAmendmentValueSummary `json:"original_summary,omitzero"`
	AmendedSummary  *LoopAmendmentValueSummary `json:"amended_summary,omitzero"`
	ActorKind       string                     `json:"actor_kind"`
	ActorID         string                     `json:"actor_id"`
	Reason          string                     `json:"reason,omitempty"`
	CreatedAt       time.Time                  `json:"created_at"`
}

type LoopNodeClass

type LoopNodeClass string

LoopNodeClass is the public loop graph node class vocabulary.

const (
	LoopNodeClassAction  LoopNodeClass = "action"
	LoopNodeClassControl LoopNodeClass = "control"
	LoopNodeClassSource  LoopNodeClass = "source"
)

type LoopNodeControlPayload

type LoopNodeControlPayload struct {
	LoopRunID       string                        `json:"loop_run_id"`
	NodeID          string                        `json:"node_id"`
	Paused          bool                          `json:"paused"`
	PauseProvenance *LoopControlProvenancePayload `json:"pause_provenance,omitzero"`
	Quarantined     bool                          `json:"quarantined"`
	QuarantineEntry json.RawMessage               `json:"quarantine_entry,omitempty"`
	QuarantinedAt   *time.Time                    `json:"quarantined_at,omitempty"`
	AttentionFlag   string                        `json:"attention_flag,omitempty"`
	AttentionReason string                        `json:"attention_reason,omitempty"`
	// AttentionProducerNodeID routes a dependency-parked consumer to the
	// quarantined producer that owns the repair record.
	AttentionProducerNodeID string                        `json:"attention_producer_node_id,omitempty"`
	CancelState             string                        `json:"cancel_state,omitempty"`
	CancelProvenance        *LoopControlProvenancePayload `json:"cancel_provenance,omitzero"`
	LastEvidenceAt          *time.Time                    `json:"last_evidence_at,omitempty"`
	DeathResumeStreak       int                           `json:"death_resume_streak"`
	Revision                int64                         `json:"revision"`
	UpdatedAt               time.Time                     `json:"updated_at"`
}

LoopNodeControlPayload is the public durable control state for one authored node.

type LoopNodeInventoryItem

type LoopNodeInventoryItem struct {
	WorkspaceID string                  `json:"workspace_id,omitempty"`
	State       LoopNodeInventoryState  `json:"state"`
	LoopRunID   string                  `json:"loop_run_id"`
	LoopName    string                  `json:"loop_name"`
	Generation  int                     `json:"generation"`
	NodeID      string                  `json:"node_id"`
	ItemIndex   int                     `json:"item_index"`
	StateAt     time.Time               `json:"state_at"`
	Wait        *LoopNodeWaitPayload    `json:"wait,omitzero"`
	Control     *LoopNodeControlPayload `json:"control,omitzero"`
	Output      *LoopGenerationOutput   `json:"output,omitzero"`
}

LoopNodeInventoryItem is one stable-ordered workspace inventory row.

type LoopNodeInventoryResponse

type LoopNodeInventoryResponse struct {
	Items      []LoopNodeInventoryItem `json:"items"`
	NextCursor string                  `json:"next_cursor,omitempty"`
}

LoopNodeInventoryResponse is one page of workspace-scoped node state.

type LoopNodeInventoryState

type LoopNodeInventoryState string

LoopNodeInventoryState is the closed workspace inventory vocabulary.

const (
	LoopNodeInventoryWaiting     LoopNodeInventoryState = "waiting"
	LoopNodeInventoryQuarantined LoopNodeInventoryState = "quarantined"
	LoopNodeInventoryAttention   LoopNodeInventoryState = "attention"
	LoopNodeInventoryRetrying    LoopNodeInventoryState = "retrying"
)

type LoopNodeLifecycleState

type LoopNodeLifecycleState struct {
	Deadline       string                `json:"deadline,omitempty"`
	ResultContract *LoopResultContract   `json:"result_contract,omitzero"`
	OnError        *LoopErrorPolicy      `json:"on_error,omitzero"`
	OnRetry        []LoopEffectSpec      `json:"on_retry,omitempty"`
	OnSuccess      []LoopEffectSpec      `json:"on_success,omitempty"`
	OnPause        []LoopEffectSpec      `json:"on_pause,omitempty"`
	OnTimeout      []LoopEffectSpec      `json:"on_timeout,omitempty"`
	OnCancel       []LoopEffectSpec      `json:"on_cancel,omitempty"`
	OnQuarantine   []LoopEffectSpec      `json:"on_quarantine,omitempty"`
	OnParentClose  LoopParentClosePolicy `json:"on_parent_close,omitempty"`
	Expires        *LoopWaitExpiry       `json:"expires,omitzero"`
}

LoopNodeLifecycleState carries optional node reliability fields.

type LoopNodeMutationRequest

type LoopNodeMutationRequest struct {
	Reason    string `json:"reason,omitempty"`
	ItemIndex *int   `json:"item_index,omitzero"`
}

LoopNodeMutationRequest carries optional operator context for a node mutation.

type LoopNodePauseRequest

type LoopNodePauseRequest struct {
	Mode      string `json:"mode"`
	Reason    string `json:"reason,omitempty"`
	ItemIndex *int   `json:"item_index,omitzero"`
}

LoopNodePauseRequest parks one authored node.

type LoopNodeResumeRequest

type LoopNodeResumeRequest struct {
	Mode      string          `json:"mode"`
	ItemIndex *int            `json:"item_index,omitzero"`
	Payload   json.RawMessage `json:"payload,omitempty"`
}

LoopNodeResumeRequest releases one authored node pause or manual wait.

type LoopNodeWaitPayload

type LoopNodeWaitPayload struct {
	LoopRunID         string          `json:"loop_run_id"`
	Generation        int             `json:"generation"`
	NodeID            string          `json:"node_id"`
	ItemIndex         int             `json:"item_index"`
	Kind              string          `json:"kind"`
	ResumeAt          *time.Time      `json:"resume_at,omitempty"`
	NextEscalationAt  *time.Time      `json:"next_escalation_at,omitempty"`
	EscalationCursor  int             `json:"escalation_cursor"`
	ClaimState        string          `json:"claim_state"`
	ClaimedByKind     string          `json:"claimed_by_kind,omitempty"`
	ClaimedByID       string          `json:"claimed_by_id,omitempty"`
	ClaimedAt         *time.Time      `json:"claimed_at,omitempty"`
	AdmissionFailures int             `json:"admission_failures"`
	Expect            json.RawMessage `json:"expect,omitempty"`
	IssuedEpoch       int64           `json:"issued_epoch"`
	CreatedAt         time.Time       `json:"created_at"`
	AgeSeconds        int64           `json:"age_seconds"`
}

LoopNodeWaitPayload is one public durable wait cell.

type LoopParentClosePolicy

type LoopParentClosePolicy string

LoopParentClosePolicy is the closed run-loop parent-close vocabulary.

const (
	// LoopParentCloseTerminate closes the child with its parent.
	LoopParentCloseTerminate LoopParentClosePolicy = "terminate"
	// LoopParentCloseAbandon leaves the child running independently.
	LoopParentCloseAbandon LoopParentClosePolicy = "abandon"
)

type LoopPlanNodePreview

type LoopPlanNodePreview struct {
	ID        string        `json:"id"`
	Class     LoopNodeClass `json:"class"`
	Kind      string        `json:"kind"`
	DependsOn []string      `json:"depends_on,omitempty"`
}

LoopPlanNodePreview is one gen-1 node materialized by dry-run.

type LoopPlanPayload

type LoopPlanPayload struct {
	LoopName             string                     `json:"loop_name"`
	ResolvedInputs       map[string]any             `json:"resolved_inputs"`
	InputOrigins         map[string]LoopInputOrigin `json:"input_origins"`
	Generation           int                        `json:"generation"`
	Nodes                []LoopPlanNodePreview      `json:"nodes"`
	Contract             LoopContract               `json:"contract"`
	MaterializedContract LoopContract               `json:"materialized_contract"`
	EffectiveConfig      LoopEffectiveConfig        `json:"effective_config"`
}

LoopPlanPayload is the public dry-run preview.

type LoopProvenance

type LoopProvenance struct {
	RunID      string             `json:"run_id"`
	LoopName   string             `json:"loop_name,omitempty"`
	Role       LoopProvenanceRole `json:"role"`
	Generation *int               `json:"generation,omitempty"`
	NodeID     string             `json:"node_id,omitempty"`
	ItemIndex  *int               `json:"item_index,omitempty"`
}

LoopProvenance is the shared structured origin projected by task reads.

func LoopProvenanceFromRun

func LoopProvenanceFromRun(record *taskpkg.RunProvenance) *LoopProvenance

LoopProvenanceFromRun builds the public projection from relational run provenance.

func LoopProvenanceFromView

func LoopProvenanceFromView(view *taskpkg.View) *LoopProvenance

LoopProvenanceFromView selects the newest related run for one task detail.

type LoopProvenanceRole

type LoopProvenanceRole string

LoopProvenanceRole identifies how a task participates in one Loop run.

const (
	// LoopProvenanceRoleCoordinator identifies the run's coordinator task.
	LoopProvenanceRoleCoordinator LoopProvenanceRole = "coordinator"
	// LoopProvenanceRoleCell identifies one executable Loop cell task.
	LoopProvenanceRoleCell LoopProvenanceRole = "cell"
)

type LoopReattemptStrategy

type LoopReattemptStrategy string

LoopReattemptStrategy configures generation re-attempt breadth.

const (
	LoopReattemptFailedOnly LoopReattemptStrategy = "failed_only"
	LoopReattemptFullBody   LoopReattemptStrategy = "full_body"
	LoopReattemptHalt       LoopReattemptStrategy = "halt"
)

type LoopRequestAggregates

type LoopRequestAggregates struct {
	Pending int `json:"pending"`
}

type LoopRequestPayload

type LoopRequestPayload struct {
	WorkspaceID      string          `json:"workspace_id,omitempty"`
	ProfileID        string          `json:"profile_id"`
	LoopRunID        string          `json:"loop_run_id"`
	LoopName         string          `json:"loop_name,omitempty"`
	Generation       int             `json:"generation"`
	NodeID           string          `json:"node_id"`
	ItemIndex        int             `json:"item_index"`
	Kind             string          `json:"kind"`
	State            string          `json:"state"`
	Prompt           string          `json:"prompt"`
	Context          json.RawMessage `json:"context"`
	Expect           json.RawMessage `json:"expect,omitempty"`
	EditSchema       json.RawMessage `json:"edit_schema,omitempty"`
	RespondSchema    json.RawMessage `json:"respond_schema,omitempty"`
	ProposedPreview  json.RawMessage `json:"proposed_preview,omitempty"`
	Decisions        []string        `json:"decisions"`
	Agents           string          `json:"agents"`
	AnsweredDecision string          `json:"answered_decision,omitempty"`
	ActorKind        string          `json:"actor_kind,omitempty"`
	ActorID          string          `json:"actor_id,omitempty"`
	OpenedAt         time.Time       `json:"opened_at"`
	AnsweredAt       *time.Time      `json:"answered_at,omitempty"`
	ResolvedAt       *time.Time      `json:"resolved_at,omitempty"`
	ExpiresAt        *time.Time      `json:"expires_at,omitempty"`
}

LoopRequestPayload is the public request projection; private execution refs never appear here.

type LoopRequestProvenance

type LoopRequestProvenance struct {
	ActorKind  string    `json:"actor_kind"`
	ActorID    string    `json:"actor_id"`
	AnsweredAt time.Time `json:"answered_at"`
}

type LoopRequestsResponse

type LoopRequestsResponse struct {
	Items      []LoopRequestPayload  `json:"items"`
	Aggregates LoopRequestAggregates `json:"aggregates"`
	NextCursor string                `json:"next_cursor"`
}

type LoopResolvedLifecycleConfig

type LoopResolvedLifecycleConfig struct {
	RetryMaxAttempts       int               `json:"retry_max_attempts"`
	RetryBackoffBase       string            `json:"retry_backoff_base"`
	RetryBackoffMax        string            `json:"retry_backoff_max"`
	RetryNonRetryable      []string          `json:"retry_non_retryable"`
	LivenessSilenceWindow  string            `json:"liveness_silence_window"`
	ResumeDeathStreakLimit int               `json:"resume_death_streak_limit"`
	PredicateCostLimit     uint64            `json:"predicate_cost_limit"`
	WaitAdmissionAttempts  int               `json:"wait_admission_attempts"`
	WaitAdmissionInterval  string            `json:"wait_admission_interval"`
	AdmissionHorizon       string            `json:"admission_horizon"`
	Sources                map[string]string `json:"sources"`
}

LoopResolvedLifecycleConfig reports effective node-family defaults and their source layer.

type LoopResolvedRuntime

type LoopResolvedRuntime struct {
	Provider        string                    `json:"provider,omitempty"`
	Model           string                    `json:"model,omitempty"`
	Reasoning       string                    `json:"reasoning,omitempty"`
	Speed           Speed                     `json:"speed,omitempty"`
	ACPOptions      []AgentACPOptionSelection `json:"acp_options,omitempty"`
	SpeedResolution *SpeedResolution          `json:"speed_resolution,omitzero"`
	Source          LoopRuntimeProvenance     `json:"source"`
}

LoopResolvedRuntime is the runtime applied by the daemon plus field provenance.

type LoopResponse

type LoopResponse struct {
	Loop LoopDefinitionPayload `json:"loop"`
}

LoopResponse wraps one Loop definition.

type LoopResultContract

type LoopResultContract struct {
	FailureField string `json:"failure_field"`
	MessageField string `json:"message_field,omitempty"`
}

LoopResultContract identifies application-failure fields in a node result.

type LoopRetrySpec

type LoopRetrySpec struct {
	MaxAttempts  int              `json:"max_attempts,omitzero"`
	OnFailure    string           `json:"on_failure,omitempty"`
	Backoff      *LoopBackoffSpec `json:"backoff,omitzero"`
	NonRetryable []string         `json:"non_retryable,omitempty"`
}

LoopRetrySpec configures node retry policy.

type LoopRouteCausePayload

type LoopRouteCausePayload struct {
	NodeID      string    `json:"node_id"`
	ItemIndex   int       `json:"item_index"`
	Route       string    `json:"route"`
	Cause       string    `json:"cause"`
	MatchedWhen string    `json:"matched_when,omitempty"`
	Default     bool      `json:"default,omitzero"`
	At          time.Time `json:"at"`
}

LoopRouteCausePayload is one durable route decision in a generation.

type LoopRouteTakenEventPayload

type LoopRouteTakenEventPayload struct {
	Generation  int64  `json:"generation"`
	NodeID      string `json:"node_id"`
	ItemIndex   int    `json:"item_index"`
	Route       string `json:"route"`
	Cause       string `json:"cause"`
	MatchedWhen string `json:"matched_when,omitempty"`
	Default     bool   `json:"default,omitzero"`
}

LoopRouteTakenEventPayload is the exact route_taken SSE payload.

type LoopRouteTakenRunEventPayload

type LoopRouteTakenRunEventPayload struct {
	ID          string                     `json:"id"`
	LoopRunID   string                     `json:"loop_run_id"`
	WorkspaceID string                     `json:"workspace_id"`
	Seq         int64                      `json:"seq"`
	Kind        LoopRunEventKind           `json:"kind"`
	Payload     LoopRouteTakenEventPayload `json:"payload"`
	At          time.Time                  `json:"at"`
}

LoopRouteTakenRunEventPayload is the typed route_taken event envelope.

type LoopRunAttention

type LoopRunAttention struct {
	Kind  string    `json:"kind"`
	Count int       `json:"count"`
	Since time.Time `json:"since"`
}

LoopRunAttention summarizes operator action required by one run.

type LoopRunEventKind

type LoopRunEventKind = looppkg.RunEventKind

LoopRunEventKind is the public loop run event stream vocabulary.

type LoopRunEventPayload

type LoopRunEventPayload struct {
	ID          string           `json:"id"`
	LoopRunID   string           `json:"loop_run_id"`
	WorkspaceID string           `json:"workspace_id"`
	Seq         int64            `json:"seq"`
	Kind        LoopRunEventKind `json:"kind"`
	Payload     json.RawMessage  `json:"payload"`
	At          time.Time        `json:"at"`
}

LoopRunEventPayload is one SSE/audit event for a loop run.

type LoopRunNodesResponse

type LoopRunNodesResponse = looppkg.RosterPage

LoopRunNodesResponse is the public computed roster page.

type LoopRunPayload

type LoopRunPayload struct {
	ID                string                `json:"id"`
	ProfileID         string                `json:"profile_id"`
	ProfileName       string                `json:"profile_name"`
	ProfileColor      string                `json:"profile_color,omitempty"`
	ProfileIcon       string                `json:"profile_icon,omitempty"`
	WorkspaceID       string                `json:"workspace_id"`
	LoopName          string                `json:"loop_name"`
	Status            LoopRunStatus         `json:"status"`
	Historical        bool                  `json:"historical"`
	CompletionState   LoopCompletionState   `json:"completion_state"`
	Generation        int64                 `json:"generation"`
	BestGeneration    *int64                `json:"best_generation,omitzero"`
	BestScore         *float64              `json:"best_score,omitzero"`
	ForkedFrom        *LoopForkRef          `json:"forked_from,omitzero"`
	Forks             []LoopForkRef         `json:"forks"`
	ReattemptStrategy LoopReattemptStrategy `json:"reattempt_strategy"`
	CreatedAt         time.Time             `json:"created_at"`
	StartedAt         time.Time             `json:"started_at"`
	LastProgressAt    time.Time             `json:"last_progress_at"`
	CompletedAt       *time.Time            `json:"completed_at,omitempty"`
	StartedByKind     string                `json:"started_by_kind,omitempty"`
	StartedByRef      string                `json:"started_by_ref,omitempty"`
	StartedOriginKind string                `json:"started_origin_kind,omitempty"`
	StartedOriginRef  string                `json:"started_origin_ref,omitempty"`
	DefinitionVersion int                   `json:"definition_version"`
	DefinitionDigest  string                `json:"definition_digest,omitempty"`
	ActiveGateID      string                `json:"active_gate_id,omitempty"`
	BudgetApprovalSeq int                   `json:"budget_approval_seq,omitzero"`
	StartMetadata     map[string]any        `json:"start_metadata,omitempty"`
	IterationCap      int                   `json:"iteration_cap"`
	BudgetTokens      int                   `json:"budget_tokens"`
	BudgetWallSec     int                   `json:"budget_wall_sec"`
	BudgetOnExceeded  LoopBudgetExceeded    `json:"budget_on_exceeded"`
	TokensUsed        int64                 `json:"tokens_used"`
	ParentLoopRunID   string                `json:"parent_loop_run_id,omitempty"`
	PauseRequested    bool                  `json:"pause_requested"`
	Inputs            map[string]any        `json:"inputs,omitempty"`
	Attention         *LoopRunAttention     `json:"attention,omitzero"`
	Progress          LoopRunProgress       `json:"progress"`
}

LoopRunPayload is the public loop_run aggregate projection.

type LoopRunProgress

type LoopRunProgress struct {
	Round      int `json:"round"`
	StepsDone  int `json:"steps_done"`
	StepsTotal int `json:"steps_total"`
}

LoopRunProgress summarizes the current round's completed steps.

type LoopRunResponse

type LoopRunResponse struct {
	Run                  LoopRunPayload             `json:"run"`
	ExecutedDefinition   *LoopDefinitionDocument    `json:"executed_definition,omitzero"`
	MaterializedContract LoopContract               `json:"materialized_contract"`
	EffectiveConfig      LoopEffectiveConfig        `json:"effective_config"`
	Generations          []LoopGenerationPayload    `json:"generations,omitempty"`
	NodeControls         []LoopNodeControlPayload   `json:"node_controls"`
	Waits                []LoopNodeWaitPayload      `json:"waits"`
	Requests             []LoopRequestPayload       `json:"requests"`
	Amendments           []LoopNodeAmendmentPayload `json:"amendments"`
	// WatchEvents is the parked watch-events read-model (present only while dormant).
	WatchEvents *LoopWatchEventsState `json:"watch_events,omitzero"`
}

LoopRunResponse returns one run with generation detail.

type LoopRunStatus

type LoopRunStatus string

LoopRunStatus is the public loop run state vocabulary.

const (
	LoopRunStatusQueued        LoopRunStatus = "queued"
	LoopRunStatusRunning       LoopRunStatus = "running"
	LoopRunStatusWatching      LoopRunStatus = "watching"
	LoopRunStatusNeedsApproval LoopRunStatus = "needs-approval"
	LoopRunStatusPaused        LoopRunStatus = "paused"
	LoopRunStatusDone          LoopRunStatus = "done"
	LoopRunStatusNoOp          LoopRunStatus = "no-op"
	LoopRunStatusBlocked       LoopRunStatus = "blocked"
	LoopRunStatusFailed        LoopRunStatus = "failed"
	LoopRunStatusExhausted     LoopRunStatus = "exhausted"
	LoopRunStatusStalled       LoopRunStatus = "stalled"
	LoopRunStatusCanceled      LoopRunStatus = "canceled"
)

type LoopRunTransitionCause

type LoopRunTransitionCause string

LoopRunTransitionCause identifies why a run status changed.

const (
	LoopRunTransitionCauseStart              LoopRunTransitionCause = "start"
	LoopRunTransitionCausePromote            LoopRunTransitionCause = "promote"
	LoopRunTransitionCauseOperatorCancel     LoopRunTransitionCause = "operator_cancel"
	LoopRunTransitionCauseGoalReplace        LoopRunTransitionCause = "goal_replace"
	LoopRunTransitionCauseGoalClear          LoopRunTransitionCause = "goal_clear"
	LoopRunTransitionCausePauseBoundary      LoopRunTransitionCause = "pause_boundary"
	LoopRunTransitionCauseOperatorResume     LoopRunTransitionCause = "operator_resume"
	LoopRunTransitionCauseApproval           LoopRunTransitionCause = "approval"
	LoopRunTransitionCauseWaitExpired        LoopRunTransitionCause = "wait_expired"
	LoopRunTransitionCauseGateRejected       LoopRunTransitionCause = "gate_rejected"
	LoopRunTransitionCauseContract           LoopRunTransitionCause = "contract"
	LoopRunTransitionCauseBudget             LoopRunTransitionCause = "budget"
	LoopRunTransitionCauseIterationCap       LoopRunTransitionCause = "iteration_cap"
	LoopRunTransitionCauseNoProgress         LoopRunTransitionCause = "no_progress"
	LoopRunTransitionCauseWatchPoll          LoopRunTransitionCause = "watch_poll"
	LoopRunTransitionCauseWatchEvents        LoopRunTransitionCause = "watch_events"
	LoopRunTransitionCauseCoordinatorFailure LoopRunTransitionCause = "coordinator_failure"
	LoopRunTransitionCauseOperatorRerun      LoopRunTransitionCause = "operator_rerun"
)

type LoopRunsAggregatePayload

type LoopRunsAggregatePayload struct {
	Total      int `json:"total"`
	Live       int `json:"live"`
	Terminal   int `json:"terminal"`
	Succeeded  int `json:"succeeded"`
	Failed     int `json:"failed"`
	Historical int `json:"historical"`
}

LoopRunsAggregatePayload summarizes the returned run set.

type LoopRunsResponse

type LoopRunsResponse struct {
	Runs       []LoopRunPayload         `json:"runs"`
	Aggregates LoopRunsAggregatePayload `json:"aggregates"`
	NextCursor string                   `json:"next_cursor,omitempty"`
}

LoopRunsResponse lists workspace-scoped loop runs.

type LoopRuntimeDefaults

type LoopRuntimeDefaults struct {
	//nolint:modernize // OpenAPI requires omitempty; JSON uses omitzero.
	Worker LoopRuntimeSpec `json:"worker,omitempty,omitzero"`
	//nolint:modernize // OpenAPI requires omitempty; JSON uses omitzero.
	Judge LoopRuntimeSpec `json:"judge,omitempty,omitzero"`
}

LoopRuntimeDefaults contains worker and judge runtime intent.

type LoopRuntimeMatch

type LoopRuntimeMatch struct {
	ID         string `json:"id,omitempty"`
	Type       string `json:"type,omitempty"`
	Complexity string `json:"complexity,omitempty"`
}

LoopRuntimeMatch selects exactly one task id, one task type, one complexity, or a type and complexity conjunction. The conjunction is AND and id is exclusive.

type LoopRuntimeProvenance

type LoopRuntimeProvenance struct {
	Provider   string            `json:"provider,omitempty"`
	Model      string            `json:"model,omitempty"`
	Reasoning  string            `json:"reasoning,omitempty"`
	Speed      string            `json:"speed,omitempty"`
	ACPOptions map[string]string `json:"acp_options,omitempty"`
}

LoopRuntimeProvenance identifies the source of each applied field.

type LoopRuntimeRule

type LoopRuntimeRule struct {
	Match   LoopRuntimeMatch `json:"match"`
	Runtime LoopRuntimeSpec  `json:"runtime"`
}

LoopRuntimeRule applies field-merged runtime intent with specificity id > type+complexity > type > complexity; later equal-specificity rules win per field.

type LoopRuntimeSpec

type LoopRuntimeSpec struct {
	Provider   string                    `json:"provider,omitempty"`
	Model      string                    `json:"model,omitempty"`
	Reasoning  string                    `json:"reasoning,omitempty"`
	Speed      Speed                     `json:"speed,omitempty"`
	ACPOptions []AgentACPOptionSelection `json:"acp_options,omitempty"`
}

LoopRuntimeSpec is one provider/model/reasoning/speed/ACP-option selection layer.

func (*LoopRuntimeSpec) UnmarshalJSON

func (s *LoopRuntimeSpec) UnmarshalJSON(data []byte) error

UnmarshalJSON keeps runtime objects closed while the surrounding Loop DSL remains extensible.

type LoopRuntimeValidationItemPayload

type LoopRuntimeValidationItemPayload struct {
	TaskID string `json:"task_id,omitempty"`
	Field  string `json:"field"`
	Value  string `json:"value"`
	Reason string `json:"reason"`
}

LoopRuntimeValidationItemPayload is one deterministic runtime preflight diagnostic.

type LoopSource

type LoopSource string

LoopSource is the public source-provenance tier for a Loop definition.

const (
	LoopSourceMarketplace LoopSource = "marketplace"
	LoopSourceUser        LoopSource = "user"
	LoopSourceAdditional  LoopSource = "additional"
	LoopSourceWorkspace   LoopSource = "workspace"
)

type LoopStartBinding

type LoopStartBinding struct {
	Kind         string            `json:"kind"`
	Inputs       map[string]any    `json:"inputs,omitempty"`
	InputMapping map[string]string `json:"input_mapping,omitempty"`
}

LoopStartBinding is the bounded start projection returned by the Loop catalog.

type LoopTimelineResponse

type LoopTimelineResponse = looppkg.TimelinePage

LoopTimelineResponse is the public durable timeline page.

type LoopUnprocessableResponse

type LoopUnprocessableResponse struct {
	Error           string                           `json:"error,omitempty"`
	Code            string                           `json:"code,omitempty"`
	Details         map[string]string                `json:"details,omitempty"`
	Valid           bool                             `json:"valid,omitzero"`
	InputValidation *LoopInputValidationErrorPayload `json:"input_validation,omitzero"`
}

LoopUnprocessableResponse preserves either a reason envelope or a field-addressed input failure.

type LoopValidationResponse

type LoopValidationResponse struct {
	Valid             bool                               `json:"valid"`
	Errors            []LoopLintErrorPayload             `json:"errors,omitempty"`
	RuntimeValidation []LoopRuntimeValidationItemPayload `json:"runtime_validation,omitempty"`
	InputValidation   *LoopInputValidationErrorPayload   `json:"input_validation,omitzero"`
}

LoopValidationResponse reports lint/compile diagnostics.

type LoopVersionConflictResponse

type LoopVersionConflictResponse struct {
	Error          string `json:"error"`
	CurrentVersion int    `json:"current_version"`
}

LoopVersionConflictResponse reports the current published version after a CAS miss.

type LoopWaitExpiry

type LoopWaitExpiry struct {
	After    string           `json:"after"`
	Escalate []LoopEffectSpec `json:"escalate,omitempty"`
	Route    string           `json:"route,omitempty"`
}

LoopWaitExpiry describes an optional expiry path for waits and gates.

type LoopWatchEventKind

type LoopWatchEventKind string

LoopWatchEventKind is the closed public vocabulary of subscribable watch-events hook kinds. It mirrors the shipped rows of the loop engine's watch-events family registry (internal/loop.SupportedWatchEvents); a drift test in internal/daemon keeps this contract enum and the registry in lockstep. ADR-004 governs the phased matrix — phases B/C append rows here as they land.

const (
	LoopWatchEventTaskStatusChanged LoopWatchEventKind = "task.status_changed"
	LoopWatchEventTaskBlocked       LoopWatchEventKind = "task.blocked"
	LoopWatchEventTaskUnblocked     LoopWatchEventKind = "task.unblocked"
	LoopWatchEventTaskNeedsAttn     LoopWatchEventKind = "task.needs_attention"
	LoopWatchEventTaskRecovered     LoopWatchEventKind = "task.recovered"
	LoopWatchEventTaskRunCompleted  LoopWatchEventKind = "task.run.completed" // #nosec G101 -- event enum.
	LoopWatchEventTaskRunFailed     LoopWatchEventKind = "task.run.failed"
	LoopWatchEventLoopTerminal      LoopWatchEventKind = "loop.terminal"
	LoopWatchEventLoopNodeTerminal  LoopWatchEventKind = "loop.node.terminal"       // #nosec G101 -- event enum.
	LoopWatchEventAutomationDone    LoopWatchEventKind = "automation.run.completed" // #nosec G101 -- event enum.
	LoopWatchEventAutomationFailed  LoopWatchEventKind = "automation.run.failed"    // #nosec G101 -- event enum.

	LoopWatchEventCoordinatorSpawn  LoopWatchEventKind = "coordinator.spawned"
	LoopWatchEventCoordinatorDecide LoopWatchEventKind = "coordinator.decision"
	LoopWatchEventCoordinatorStop   LoopWatchEventKind = "coordinator.stopped"
	LoopWatchEventCoordinatorFail   LoopWatchEventKind = "coordinator.failed"
	LoopWatchEventPostRecord        LoopWatchEventKind = "event.post_record" // #nosec G101 -- event enum.
)

type LoopWatchEventSubscription

type LoopWatchEventSubscription struct {
	Kind   LoopWatchEventKind `json:"kind"`
	Filter string             `json:"filter,omitempty"`
}

LoopWatchEventSubscription is one parked watch-events subscription projected for a loop-run detail read-model. Kind names a subscribable hook event; Filter is the CEL expression evaluated at wake (empty = match every event of this kind in the run's workspace).

type LoopWatchEventsState

type LoopWatchEventsState struct {
	Subscriptions []LoopWatchEventSubscription `json:"subscriptions"`
	Cursors       map[string]int64             `json:"cursors,omitempty"`
	LastWakeAt    *time.Time                   `json:"last_wake_at,omitempty"`
}

LoopWatchEventsState is the parked watch-events node read-model surfaced on a loop-run detail response. It is present only while the run's current generation is dormant at a watch-events node; an absent value means the run is not currently parked on events, so clients render nothing (truthful UI). Subscriptions and Cursors project the durable pending output_ref; LastWakeAt is the run's last coordinator-progress timestamp.

type LoopsResponse

type LoopsResponse struct {
	Aggregate *LoopCatalogBatchResponse `json:"-"`
	Loops     []LoopCatalogEntryPayload `json:"loops"`
	Facets    LoopCatalogFacetsPayload  `json:"facets"`
	Page      CountedCursorPagePayload  `json:"page"`
}

LoopsResponse is returned by GET /workspaces/{workspace_id}/loops.

type MCPAuthSummary

type MCPAuthSummary struct {
	Method       string   `json:"method"`
	Registration string   `json:"registration,omitempty"`
	IssuerURL    string   `json:"issuer_url,omitempty"`
	Scopes       []string `json:"scopes,omitempty"`
}

MCPAuthSummary excludes credentials and credential references.

type MCPServerStatusPayload

type MCPServerStatusPayload struct {
	Name          string `json:"name"`
	Scope         string `json:"scope"`
	WorkspaceID   string `json:"workspace_id,omitempty"`
	AuthStatus    string `json:"auth_status,omitempty"`
	Configured    bool   `json:"configured"`
	Initialized   bool   `json:"initialized"`
	State         string `json:"state"`
	Probe         string `json:"probe,omitempty"`
	ToolCount     int    `json:"tool_count,omitzero"`
	Reason        string `json:"reason,omitempty"`
	Diagnostic    string `json:"diagnostic,omitempty"`
	Transport     string `json:"transport,omitempty"`
	RuntimeStatus string `json:"runtime_status"`
}

MCPServerStatusPayload reports configured MCP server availability.

type ManagedExtensionRemovePayload

type ManagedExtensionRemovePayload struct {
	Name           string           `json:"name"`
	Path           string           `json:"path"`
	DataPath       string           `json:"data_path,omitempty"`
	QuarantinePath string           `json:"quarantine_path,omitempty"`
	Status         string           `json:"status"`
	Warnings       []DiagnosticItem `json:"warnings,omitempty"`
}

ManagedExtensionRemovePayload describes one daemon-owned extension removal.

type ManagedExtensionUpdatePayload

type ManagedExtensionUpdatePayload struct {
	Name           string           `json:"name"`
	Slug           string           `json:"slug"`
	Registry       string           `json:"registry"`
	CurrentVersion string           `json:"current_version,omitempty"`
	LatestVersion  string           `json:"latest_version,omitempty"`
	Path           string           `json:"path"`
	Status         string           `json:"status"`
	Warnings       []DiagnosticItem `json:"warnings,omitempty"`
	Error          *DiagnosticItem  `json:"error,omitzero"`
}

ManagedExtensionUpdatePayload describes one daemon-owned extension update.

type MarketplaceCursorStalePayload

type MarketplaceCursorStalePayload struct {
	Error   string `json:"error"`
	Code    string `json:"code"`
	Restart bool   `json:"restart"`
}

type MarketplaceEntryResponse

type MarketplaceEntryResponse struct {
	Entry     MarketplaceListingPayload          `json:"entry"`
	Extension *MarketplaceExtensionDetailPayload `json:"extension,omitzero"`
}

MarketplaceEntryResponse is one exact detail resolved by entry_id.

type MarketplaceExtensionDetailPayload

type MarketplaceExtensionDetailPayload struct {
	ResolvedRef  string                     `json:"resolved_ref,omitempty"`
	Layout       string                     `json:"layout,omitempty"`
	Inputs       []MarketplaceInputPayload  `json:"inputs"`
	MCPServers   []MarketplaceServerPayload `json:"mcp_servers"`
	Contents     ExtensionContentsPayload   `json:"contents"`
	Diagnostics  []DiagnosticItem           `json:"diagnostics,omitempty"`
	InstallSlug  string                     `json:"install_slug"`
	ArtifactURL  string                     `json:"artifact_url,omitempty"`
	DigestSHA256 string                     `json:"digest_sha256"`
	Repository   string                     `json:"repository,omitempty"`
}

MarketplaceExtensionDetailPayload contains curated extension acquisition metadata.

type MarketplaceInputBindingPayload

type MarketplaceInputBindingPayload struct {
	Type string `json:"type"`
	Name string `json:"name"`
}

MarketplaceInputBindingPayload identifies the sole allowed materialization target.

type MarketplaceInputPayload

type MarketplaceInputPayload struct {
	ID       string                         `json:"id"`
	Prompt   string                         `json:"prompt"`
	Type     string                         `json:"type"`
	Required bool                           `json:"required"`
	Binding  MarketplaceInputBindingPayload `json:"binding"`
	Default  json.RawMessage                `json:"default,omitempty"`
}

type MarketplaceListResponse

type MarketplaceListResponse struct {
	Refreshing bool                        `json:"refreshing,omitzero"`
	Total      int                         `json:"total"`
	NextCursor string                      `json:"next_cursor,omitempty"`
	Revision   string                      `json:"revision"`
	Stale      bool                        `json:"stale"`
	ErrorClass string                      `json:"error_class,omitempty"`
	Error      string                      `json:"error,omitempty"`
	Sources    []MarketplaceSourceSummary  `json:"sources"`
	Items      []MarketplaceListingPayload `json:"items"`
}

MarketplaceListResponse preserves the source and cursor metadata of the catalog page.

type MarketplaceListingPayload

type MarketplaceListingPayload struct {
	SourceRef        string                       `json:"source_ref,omitempty"`
	Icon             string                       `json:"icon,omitempty"`
	Layout           string                       `json:"layout,omitempty"`
	Installable      bool                         `json:"installable"`
	InstallBlocker   string                       `json:"install_blocker,omitempty"`
	DigestSHA256     string                       `json:"digest_sha256"`
	NameConflict     *MarketplaceOriginPayload    `json:"name_conflict,omitzero"`
	EntryID          string                       `json:"entry_id"`
	Name             string                       `json:"name"`
	Description      string                       `json:"description"`
	Version          string                       `json:"version,omitempty"`
	Author           string                       `json:"author,omitempty"`
	InstallSlug      string                       `json:"install_slug"`
	Source           string                       `json:"source"`
	Tier             string                       `json:"tier,omitempty"`
	Format           string                       `json:"format,omitempty"`
	PublishedAt      *time.Time                   `json:"published_at,omitempty"`
	UpdatedAt        *time.Time                   `json:"updated_at,omitempty"`
	Installed        bool                         `json:"installed"`
	InstalledName    string                       `json:"installed_name,omitempty"`
	InstalledVersion string                       `json:"installed_version,omitempty"`
	UpdateAvailable  bool                         `json:"update_available"`
	ManagePath       string                       `json:"manage_path,omitempty"`
	Trust            *ExtensionTrustReportPayload `json:"trust,omitzero"`
}

MarketplaceListingPayload is one extension catalog discovery row.

type MarketplaceOriginPayload

type MarketplaceOriginPayload struct {
	Source    string `json:"source"`
	SourceRef string `json:"source_ref"`
	EntryID   string `json:"entry_id"`
}

MarketplaceOriginPayload identifies acquisition independently of its display name.

type MarketplaceRefreshResponse

type MarketplaceRefreshResponse struct {
	Sources []MarketplaceRefreshSourcePayload `json:"sources"`
}

MarketplaceRefreshResponse reports deterministic per-source refresh outcomes.

type MarketplaceRefreshSourcePayload

type MarketplaceRefreshSourcePayload struct {
	Source     string `json:"source"`
	Outcome    string `json:"outcome"`
	EntryCount int    `json:"entry_count"`
	Stale      bool   `json:"stale"`
	ErrorClass string `json:"error_class,omitempty"`
}

MarketplaceRefreshSourcePayload reports one feed-backed refresh outcome.

type MarketplaceServerPayload

type MarketplaceServerPayload struct {
	Name        string          `json:"name"`
	Owner       string          `json:"owner"`
	Scope       string          `json:"scope,omitempty"`
	Transport   string          `json:"transport"`
	Launch      string          `json:"launch"`
	Status      string          `json:"status,omitempty"`
	RuntimeName string          `json:"runtime_name,omitempty"`
	Auth        *MCPAuthSummary `json:"auth,omitzero"`
	Profile     string          `json:"profile,omitempty"`
	WorkspaceID string          `json:"workspace_id,omitempty"`
}

type MarketplaceSourceErrorPayload

type MarketplaceSourceErrorPayload struct {
	Error         string   `json:"error"`
	Code          string   `json:"code"`
	SuggestedName string   `json:"suggested_name,omitempty"`
	RetainedBy    []string `json:"retained_by,omitempty"`
	Checked       []string `json:"checked,omitempty"`
}

type MarketplaceSourcePayload

type MarketplaceSourcePayload struct {
	Name         string           `json:"name"`
	Kind         string           `json:"kind"`
	Source       string           `json:"source"`
	Enabled      bool             `json:"enabled"`
	State        string           `json:"state"`
	Plugins      int              `json:"plugins"`
	Installable  int              `json:"installable"`
	LastReadAt   *time.Time       `json:"last_read_at,omitempty"`
	ErrorClass   string           `json:"error_class,omitempty"`
	Error        string           `json:"error,omitempty"`
	DocumentPath string           `json:"document_path,omitempty"`
	Owner        string           `json:"owner,omitempty"`
	Stability    string           `json:"stability"`
	Diagnostics  []DiagnosticItem `json:"diagnostics"`
}

MarketplaceSourcePayload reports one global source, including disabled presets.

type MarketplaceSourcePreviewPayload

type MarketplaceSourcePreviewPayload struct {
	Name         string           `json:"name"`
	Owner        string           `json:"owner,omitempty"`
	DocumentPath string           `json:"document_path"`
	Plugins      int              `json:"plugins"`
	Installable  int              `json:"installable"`
	Diagnostics  []DiagnosticItem `json:"diagnostics"`
}

type MarketplaceSourceResponse

type MarketplaceSourceResponse struct {
	Source MarketplaceSourcePayload `json:"source"`
}

type MarketplaceSourceSummary

type MarketplaceSourceSummary struct {
	Name       string     `json:"name"`
	Kind       string     `json:"kind"`
	State      string     `json:"state"`
	Count      int        `json:"count"`
	LastReadAt *time.Time `json:"last_read_at,omitempty"`
}

type MarketplaceSourcesResponse

type MarketplaceSourcesResponse struct {
	Sources []MarketplaceSourcePayload `json:"sources"`
}

type ModelCatalogCostPayload

type ModelCatalogCostPayload struct {
	InputPerMillion      *float64 `json:"input_per_million,omitempty"`
	OutputPerMillion     *float64 `json:"output_per_million,omitempty"`
	CacheReadPerMillion  *float64 `json:"cache_read_per_million,omitempty"`
	CacheWritePerMillion *float64 `json:"cache_write_per_million,omitempty"`
	ReasoningPerMillion  *float64 `json:"reasoning_per_million,omitempty"`
}

ModelCatalogCostPayload reports normalized model price hints.

type ModelCatalogSourceRefPayload

type ModelCatalogSourceRefPayload struct {
	SourceID    string `json:"source_id"`
	SourceKind  string `json:"source_kind"`
	Priority    int    `json:"priority"`
	RefreshedAt string `json:"refreshed_at,omitempty"`
	Stale       bool   `json:"stale"`
	LastError   string `json:"last_error,omitempty"`
}

ModelCatalogSourceRefPayload identifies one source used by a merged model.

type ModelCatalogSourceStatusPayload

type ModelCatalogSourceStatusPayload struct {
	FailureReason string `json:"failure_reason,omitempty"`
	SourceID      string `json:"source_id"`
	SourceKind    string `json:"source_kind"`
	ProviderID    string `json:"provider_id"`
	Priority      int    `json:"priority"`
	LastRefresh   string `json:"last_refresh,omitempty"`
	NextRefresh   string `json:"next_refresh,omitempty"`
	LastSuccess   string `json:"last_success,omitempty"`
	LastError     string `json:"last_error,omitempty"`
	RefreshState  string `json:"refresh_state"`
	RowCount      int    `json:"row_count"`
	Stale         bool   `json:"stale"`
}

ModelCatalogSourceStatusPayload reports provider-scoped catalog source health.

type MoveSessionRequest

type MoveSessionRequest struct {
	FolderID string `json:"folder_id,omitempty"`
}

MoveSessionRequest moves one session to the end of a folder, or back to the workspace root when FolderID is empty.

type MoveSessionToLaterRequest

type MoveSessionToLaterRequest struct {
	Reason   string     `json:"reason,omitempty"`
	ReturnAt *time.Time `json:"return_at,omitempty"`
}

MoveSessionToLaterRequest parks a session with an optional Markdown reason and an optional return time.

type MoveWorkspaceRequest

type MoveWorkspaceRequest struct {
	WorkspaceID string `json:"workspace_id"`
	FolderID    string `json:"folder_id,omitempty"`
}

MoveWorkspaceRequest moves one workspace (id, name, or "@user") to the end of a folder, or to the end of the root when FolderID is empty. A workspace already in that container keeps its position.

type NewSessionWorktreeRequest

type NewSessionWorktreeRequest struct {
	Name string `json:"name,omitempty"`
}

NewSessionWorktreeRequest materializes one worktree before the session starts.

type ObserveFailureHealthPayload

type ObserveFailureHealthPayload struct {
	Status string                        `json:"status"`
	Total  int                           `json:"total"`
	ByKind map[store.FailureKind]int     `json:"by_kind,omitempty"`
	Recent []SessionFailureHealthPayload `json:"recent,omitempty"`
}

ObserveFailureHealthPayload summarizes persisted lifecycle failures.

type ObserveHealthPayload

type ObserveHealthPayload struct {
	Status             string                          `json:"status"`
	UptimeSeconds      int64                           `json:"uptime_seconds"`
	ActiveSessions     int                             `json:"active_sessions"`
	ActiveAgents       int                             `json:"active_agents"`
	GlobalDBSizeBytes  int64                           `json:"global_db_size_bytes"`
	SessionDBSizeBytes int64                           `json:"session_db_size_bytes"`
	Persistence        ObservePersistenceHealthPayload `json:"persistence"`
	Retention          ObserveRetentionHealthPayload   `json:"retention"`
	Failures           ObserveFailureHealthPayload     `json:"failures"`
	AgentProbes        []AgentProbeHealthPayload       `json:"agent_probes,omitempty"`
	Activities         []SessionActivityHealthPayload  `json:"activities,omitempty"`
	Version            string                          `json:"version"`
}

ObserveHealthPayload is the shared observability health response payload.

type ObserveOverviewPayload

type ObserveOverviewPayload struct {
	SchemaVersion string                        `json:"schema_version"`
	GeneratedAt   time.Time                     `json:"generated_at"`
	Attention     OverviewAttentionPayload      `json:"attention"`
	Today         OverviewTodayPayload          `json:"today"`
	Outcomes      OverviewOutcomesPayload       `json:"outcomes"`
	Usage         OverviewUsagePayload          `json:"usage"`
	Pulse         OverviewPulsePayload          `json:"pulse"`
	System        OverviewSystemPayload         `json:"system"`
	Freshness     TaskDashboardFreshnessPayload `json:"freshness"`
}

ObserveOverviewPayload is the home overview read model (global by default; optional workspace scope).

type ObserveOverviewResponse

type ObserveOverviewResponse struct {
	Overview ObserveOverviewPayload `json:"overview"`
}

ObserveOverviewResponse wraps the shared home overview payload.

type ObservePersistenceHealthPayload

type ObservePersistenceHealthPayload struct {
	Status             string `json:"status"`
	GlobalDBSizeBytes  int64  `json:"global_db_size_bytes"`
	SessionDBSizeBytes int64  `json:"session_db_size_bytes"`
}

ObservePersistenceHealthPayload captures store health fields shared by lifecycle and operator diagnostics.

type ObserveRetentionHealthPayload

type ObserveRetentionHealthPayload struct {
	Enabled                  bool       `json:"enabled"`
	RetentionDays            int        `json:"retention_days"`
	SweepIntervalSeconds     int64      `json:"sweep_interval_seconds"`
	LastSweepStatus          string     `json:"last_sweep_status"`
	LastSweepAt              *time.Time `json:"last_sweep_at,omitempty"`
	LastCutoffAt             *time.Time `json:"last_cutoff_at,omitempty"`
	LastSweepError           string     `json:"last_sweep_error,omitempty"`
	DeletedEventSummaries    int64      `json:"deleted_event_summaries"`
	DeletedTokenStats        int64      `json:"deleted_token_stats"`
	DeletedTokenUsageDaily   int64      `json:"deleted_token_usage_daily"`
	DeletedPermissionLogRows int64      `json:"deleted_permission_log_rows"`
}

ObserveRetentionHealthPayload captures the observable state of configured retention sweeps.

type OnboardingStatusPayload

type OnboardingStatusPayload struct {
	Completed   bool   `json:"completed"`
	CompletedAt string `json:"completed_at,omitempty"`
}

OnboardingStatusPayload describes the global first-run onboarding completion state.

type OnboardingStatusResponse

type OnboardingStatusResponse struct {
	Onboarding OnboardingStatusPayload `json:"onboarding"`
}

OnboardingStatusResponse wraps the onboarding completion state.

type OpenAIErrorPayload

type OpenAIErrorPayload struct {
	Message string  `json:"message"`
	Type    string  `json:"type"`
	Param   *string `json:"param"`
	Code    string  `json:"code"`
}

OpenAIErrorPayload carries OpenAI-style error details.

type OpenAIErrorResponse

type OpenAIErrorResponse struct {
	Error OpenAIErrorPayload `json:"error"`
}

OpenAIErrorResponse is the OpenAI-compatible error envelope.

type OpenAIModelCompozyPayload

type OpenAIModelCompozyPayload struct {
	ProviderID             string                   `json:"provider_id"`
	ModelID                string                   `json:"model_id"`
	DisplayName            string                   `json:"display_name,omitempty"`
	Sources                []string                 `json:"sources"`
	Available              *bool                    `json:"available"`
	AvailabilityState      string                   `json:"availability_state"`
	Stale                  bool                     `json:"stale"`
	RefreshedAt            string                   `json:"refreshed_at,omitempty"`
	ContextWindow          *int64                   `json:"context_window,omitzero"`
	MaxInputTokens         *int64                   `json:"max_input_tokens,omitzero"`
	MaxOutputTokens        *int64                   `json:"max_output_tokens,omitzero"`
	SupportsTools          *bool                    `json:"supports_tools,omitzero"`
	SupportsReasoning      *bool                    `json:"supports_reasoning,omitzero"`
	ReasoningEfforts       []ReasoningEffort        `json:"reasoning_efforts,omitempty"`
	DefaultReasoningEffort *ReasoningEffort         `json:"default_reasoning_effort,omitzero"`
	Cost                   *ModelCatalogCostPayload `json:"cost,omitzero"`
	LastError              string                   `json:"last_error,omitempty"`
}

OpenAIModelCompozyPayload carries Compozy-specific model metadata under the `compozy` key.

type OpenAIModelListResponse

type OpenAIModelListResponse struct {
	Object string               `json:"object"`
	Data   []OpenAIModelPayload `json:"data"`
}

OpenAIModelListResponse is the OpenAI-compatible model list projection.

type OpenAIModelPayload

type OpenAIModelPayload struct {
	ID      string                    `json:"id"`
	Object  string                    `json:"object"`
	Created int64                     `json:"created"`
	OwnedBy string                    `json:"owned_by"`
	Compozy OpenAIModelCompozyPayload `json:"compozy"`
}

OpenAIModelPayload is one OpenAI-compatible model object with Compozy metadata.

type OperatorNotificationEventPayload

type OperatorNotificationEventPayload struct {
	Kind           string    `json:"kind,omitempty"`
	Action         string    `json:"action,omitempty"`
	Resource       string    `json:"resource,omitempty"`
	NotificationID string    `json:"notification_id"`
	SessionID      string    `json:"session_id"`
	ProfileID      string    `json:"profile_id"`
	ProfileName    string    `json:"profile_name"`
	WorkspaceID    string    `json:"workspace_id"`
	Title          string    `json:"title"`
	Body           string    `json:"body"`
	At             time.Time `json:"at"`
}

type OptionalStringList

type OptionalStringList struct {
	Present bool     `json:"-"`
	Null    bool     `json:"-"`
	Value   []string `json:"-"`
}

OptionalStringList preserves absent, null, empty, and populated JSON list states.

func (OptionalStringList) MarshalJSON

func (o OptionalStringList) MarshalJSON() ([]byte, error)

MarshalJSON writes null or the replacement list for a present field.

func (*OptionalStringList) UnmarshalJSON

func (o *OptionalStringList) UnmarshalJSON(data []byte) error

UnmarshalJSON records whether the field was explicitly cleared or replaced.

type OverviewAgentSharePayload

type OverviewAgentSharePayload struct {
	AgentName string  `json:"agent_name"`
	Tokens    int64   `json:"tokens"`
	Fraction  float64 `json:"fraction"`
}

OverviewAgentSharePayload is one agent's fraction of window token usage.

type OverviewAttentionItemPayload

type OverviewAttentionItemPayload struct {
	NotificationID string `json:"notification_id,omitempty"`
	Kind           string `json:"kind"`
	Title          string `json:"title"`
	Detail         string `json:"detail,omitempty"`
	TaskID         string `json:"task_id,omitempty"`
	RunID          string `json:"run_id,omitempty"`
	SessionID      string `json:"session_id,omitempty"`
	// WorkspaceID owns the item; empty is the User scope. Home opens the item bound to it.
	WorkspaceID string    `json:"workspace_id"`
	OccurredAt  time.Time `json:"occurred_at"`
	Actions     []string  `json:"actions"`
}

OverviewAttentionItemPayload is one actionable attention row.

type OverviewAttentionPayload

type OverviewAttentionPayload struct {
	Snapshot string                         `json:"snapshot,omitempty"`
	Total    int                            `json:"total"`
	ByKind   map[string]int                 `json:"by_kind"`
	Items    []OverviewAttentionItemPayload `json:"items"`
}

OverviewAttentionPayload lists everything currently waiting on the user.

type OverviewLongestSessionPayload

type OverviewLongestSessionPayload struct {
	SessionID       string `json:"session_id"`
	AgentName       string `json:"agent_name"`
	DurationSeconds int64  `json:"duration_seconds"`
	Date            string `json:"date"`
}

OverviewLongestSessionPayload is the longest user session inside the pulse window.

type OverviewOutcomeDayPayload

type OverviewOutcomeDayPayload struct {
	Date      string `json:"date"`
	Completed int    `json:"completed"`
	Failed    int    `json:"failed"`
	Canceled  int    `json:"canceled"`
}

OverviewOutcomeDayPayload is one daemon-local day of run outcomes.

type OverviewOutcomesPayload

type OverviewOutcomesPayload struct {
	WindowDays int                         `json:"window_days"`
	Days       []OverviewOutcomeDayPayload `json:"days"`
	Completed  int                         `json:"completed"`
	Failed     int                         `json:"failed"`
	Canceled   int                         `json:"canceled"`
	SuccessPct float64                     `json:"success_pct"`
}

OverviewOutcomesPayload summarizes terminal run outcomes for the fixed window.

type OverviewProfileUsagePayload

type OverviewProfileUsagePayload struct {
	ProfileID   string `json:"profile_id"`
	ProfileName string `json:"profile_name"`
	Color       string `json:"profile_color"`
	Icon        string `json:"profile_icon,omitempty"`
	Emoji       string `json:"profile_emoji,omitempty"`
	Archived    bool   `json:"profile_archived"`
	Tokens      int64  `json:"tokens"`
}

OverviewProfileUsagePayload is one owner-labeled profile usage bucket.

type OverviewPulseBucketPayload

type OverviewPulseBucketPayload struct {
	Weekday int `json:"weekday"`
	Hour    int `json:"hour"`
	Events  int `json:"events"`
}

OverviewPulseBucketPayload is one hour-by-weekday event count; weekday 0 is Sunday.

type OverviewPulsePayload

type OverviewPulsePayload struct {
	WindowDays     int                            `json:"window_days"`
	Buckets        []OverviewPulseBucketPayload   `json:"buckets"`
	Busiest        *OverviewPulseBucketPayload    `json:"busiest,omitzero"`
	LongestSession *OverviewLongestSessionPayload `json:"longest_session,omitzero"`
}

OverviewPulsePayload summarizes hour-by-weekday activity plus derived insights.

type OverviewSystemPayload

type OverviewSystemPayload struct {
	HookRunsToday     int `json:"hook_runs_today"`
	HookFailuresToday int `json:"hook_failures_today"`
	RetentionDays     int `json:"retention_days"`
}

OverviewSystemPayload carries today-windowed system counters plus retention truth.

type OverviewTodayPayload

type OverviewTodayPayload struct {
	RunsCompleted int `json:"runs_completed"`
	RunsFailed    int `json:"runs_failed"`
	TasksClosed   int `json:"tasks_closed"`
}

OverviewTodayPayload summarizes today's terminal work.

type OverviewUsageDayPayload

type OverviewUsageDayPayload struct {
	Date   string `json:"date"`
	Tokens int64  `json:"tokens"`
}

OverviewUsageDayPayload is one daemon-local day of token usage.

type OverviewUsagePayload

type OverviewUsagePayload struct {
	WindowDays    int                           `json:"window_days"`
	RetentionDays int                           `json:"retention_days"`
	Truncated     bool                          `json:"truncated"`
	TotalTokens   int64                         `json:"total_tokens"`
	EstimatedCost *float64                      `json:"estimated_cost,omitzero"`
	CostCurrency  string                        `json:"cost_currency,omitempty"`
	CostStatus    string                        `json:"cost_status,omitempty"`
	Days          []OverviewUsageDayPayload     `json:"days"`
	AgentShare    []OverviewAgentSharePayload   `json:"agent_share"`
	Profiles      []OverviewProfileUsagePayload `json:"profiles"`
}

OverviewUsagePayload summarizes token usage and estimated cost for the selected window.

type PatchLoopRequest

type PatchLoopRequest struct {
	ExpectedVersion *int                   `json:"expected_version,omitzero"`
	Definition      LoopDefinitionDocument `json:"definition"`
}

PatchLoopRequest atomically lints, compiles, and publishes a Loop definition.

type PauseTaskRequest

type PauseTaskRequest struct {
	Reason   string          `json:"reason"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

PauseTaskRequest captures one per-task pause request.

type PendingInteractionPayload

type PendingInteractionPayload struct {
	ExpiresAt         *time.Time `json:"expires_at,omitempty"`
	SessionID         string     `json:"session_id"`
	InteractionID     string     `json:"interaction_id"`
	Kind              string     `json:"kind"`
	ProviderRequestID string     `json:"provider_request_id"`
	TurnID            string     `json:"turn_id,omitempty"`
	Title             string     `json:"title,omitempty"`
	Choices           []string   `json:"choices,omitempty"`
	Decisions         []string   `json:"decisions,omitempty"`
	ToolID            string     `json:"tool_id,omitempty"`
	Status            string     `json:"status"`
	CreatedAt         time.Time  `json:"created_at"`
	ResolvedAt        *time.Time `json:"resolved_at,omitempty"`
	Resolution        string     `json:"resolution,omitempty"`
	ResolvedBy        string     `json:"resolved_by,omitempty"`
}

PendingInteractionPayload is the sanitized public interaction projection.

type PermissionDailyRollupPayload

type PermissionDailyRollupPayload struct {
	Day       string `json:"day"`
	AgentName string `json:"agent_name"`
	Decision  string `json:"decision"`
	Count     int64  `json:"count"`
}

type PermissionEntriesResponse

type PermissionEntriesResponse struct {
	Entries []PermissionEntryPayload `json:"entries"`
}

type PermissionEntryPayload

type PermissionEntryPayload struct {
	ID            string    `json:"id"`
	SessionID     string    `json:"session_id"`
	AgentName     string    `json:"agent_name"`
	Action        string    `json:"action"`
	Resource      string    `json:"resource"`
	Decision      string    `json:"decision"`
	InitiatorKind string    `json:"initiator_kind"`
	InitiatorID   string    `json:"initiator_id"`
	Timestamp     time.Time `json:"timestamp"`
}

PermissionEntryPayload is one permission decision and who started the work behind it. An empty initiator means the row predates initiator tracking.

type PermissionRollupResponse

type PermissionRollupResponse struct {
	Since   time.Time                      `json:"since"`
	Until   time.Time                      `json:"until"`
	Rollups []PermissionDailyRollupPayload `json:"rollups"`
}

type ProcessesResponse

type ProcessesResponse struct {
	Supported bool                         `json:"supported"`
	ScannedAt time.Time                    `json:"scanned_at"`
	Groups    []SessionProcessGroupPayload `json:"groups"`
}

type Profile

type Profile struct {
	ID                     string                         `json:"id"`
	Name                   string                         `json:"name"`
	Color                  string                         `json:"color"`
	Icon                   *string                        `json:"icon"`
	Emoji                  *string                        `json:"emoji"`
	State                  string                         `json:"state"`
	CreatedAt              time.Time                      `json:"created_at"`
	ArchivedAt             *time.Time                     `json:"archived_at,omitempty"`
	WorkItems              int                            `json:"work_items,omitzero"`
	NeedsSetup             bool                           `json:"needs_setup,omitzero"`
	CredentialRequirements []ProfileCredentialRequirement `json:"credential_requirements,omitempty"`
}

Profile is the public identity record shared by the profile API surfaces.

type ProfileCredentialRequirement

type ProfileCredentialRequirement struct {
	Provider        string `json:"provider"`
	Slot            string `json:"slot"`
	SourceExtension string `json:"source_extension"`
	Missing         bool   `json:"missing"`
}

ProfileCredentialRequirement is one missing vault-backed setup item.

type ProfileError

type ProfileError struct {
	Code    string `json:"code"`
	Message string `json:"message"`
	Action  string `json:"action"`
}

ProfileError is the stable profile error contract.

type ProfileErrorPayload

type ProfileErrorPayload struct {
	Error ProfileError `json:"error"`
}

ProfileErrorPayload wraps one public profile error.

type ProfileFolderRef

type ProfileFolderRef struct {
	WorkspaceID   string `json:"workspace_id"`
	WorkspaceName string `json:"workspace"`
	Path          string `json:"path"`
}

ProfileFolderRef identifies one repository candidate for profile migration.

type ProfileOperation

type ProfileOperation struct {
	ID      string `json:"id"`
	Kind    string `json:"kind"`
	Profile string `json:"profile"`
	Status  string `json:"status"`
	Step    string `json:"step"`
	Error   string `json:"error,omitempty"`
}

ProfileOperation describes one asynchronous profile lifecycle operation.

type ProfilePlacement

type ProfilePlacement struct {
	Extension string `json:"extension"`
	Resource  string `json:"resource"`
	Profile   string `json:"profile"`
}

ProfilePlacement identifies one dormant profile-scoped resource.

type ProfilePlanRequest

type ProfilePlanRequest struct {
	PlanRevision string `json:"plan_revision" binding:"required"`
}

ProfilePlanRequest carries the revision that authorizes a lifecycle action.

type ProfileRemovalSummary

type ProfileRemovalSummary struct {
	AgentInstances      int `json:"agent_instances"`
	AgentMemoryFiles    int `json:"agent_memory_files"`
	Agents              int `json:"agents"`
	Skills              int `json:"skills"`
	Loops               int `json:"loops"`
	MCPServers          int `json:"mcp_servers"`
	ConfigKeys          int `json:"config_keys"`
	CredentialOverrides int `json:"credential_overrides"`
	DesktopPartitions   int `json:"desktop_partitions"`
	PaletteUsage        int `json:"palette_usage"`
	PaletteQueryHits    int `json:"palette_query_hits"`
	PalettePins         int `json:"palette_pins"`
	TerminalApprovals   int `json:"terminal_approvals"`
	EventSummaries      int `json:"event_summaries"`
}

ProfileRemovalSummary counts resources removed with a profile.

type ProfileRepoRenameOutcome

type ProfileRepoRenameOutcome struct {
	WorkspaceID string `json:"workspace_id"`
	Renamed     bool   `json:"renamed"`
	Reason      string `json:"reason,omitempty"`
}

ProfileRepoRenameOutcome reports one repository rename result.

type ProfileSelection

type ProfileSelection struct {
	Scope       ProfileSelectionScope `json:"scope"`
	WorkspaceID string                `json:"workspace_id,omitempty"`
	Profile     string                `json:"profile"`
	Note        string                `json:"note,omitempty"`
}

ProfileSelection describes one remembered profile selection for a lens.

type ProfileSelectionScope

type ProfileSelectionScope string

ProfileSelectionScope identifies the lens whose profile selection is stored.

const (
	ProfileSelectionScopeGlobal    ProfileSelectionScope = "global"
	ProfileSelectionScopeWorkspace ProfileSelectionScope = "workspace"
)

type PromoteSessionInputRequest

type PromoteSessionInputRequest struct {
	Text           string `json:"text"`
	MessageID      string `json:"message_id"`
	IdempotencyKey string `json:"idempotency_key"`
	ExpectedTurnID string `json:"expected_turn_id,omitempty"`
}

PromoteSessionInputRequest atomically replaces queued input with steering input.

func (PromoteSessionInputRequest) Validate

func (r PromoteSessionInputRequest) Validate() error

Validate checks one atomic queue-to-steer replacement and its active-turn fence.

type PromptAttachmentRef

type PromptAttachmentRef struct {
	ID       string `json:"id"`
	Name     string `json:"name"`
	MIMEType string `json:"mime_type"`
	Bytes    int64  `json:"bytes"`
	SHA256   string `json:"sha256"`
	Kind     string `json:"kind"`
	Width    int    `json:"width"`
	Height   int    `json:"height"`
}

PromptAttachmentRef is one provider-neutral attachment on a prompt request.

func PromptAttachmentRefsFromMeta

func PromptAttachmentRefsFromMeta(items []session.AttachmentMeta) []PromptAttachmentRef

PromptAttachmentRefsFromMeta converts session attachment metadata into wire refs.

func (PromptAttachmentRef) Validate

func (r PromptAttachmentRef) Validate() error

Validate checks one attachment reference.

type PromptDelivery

type PromptDelivery string

PromptDelivery describes when the daemon will submit accepted input.

const (
	PromptDeliveryHeld                PromptDelivery = "held"
	PromptDeliveryQueued              PromptDelivery = "queued"
	PromptDeliveryNone                PromptDelivery = "none"
	PromptDeliveryDirect              PromptDelivery = "direct"
	PromptDeliveryAfterTurn           PromptDelivery = "after_turn"
	PromptDeliveryInterruptThenPrompt PromptDelivery = "interrupt_then_prompt"
)

type PromptInput

type PromptInput struct {
	Message        string
	MessageID      string
	IdempotencyKey string
	Attachments    []PromptAttachmentRef
}

PromptInput is the canonical authored prompt extracted from one transport request.

func ExtractPromptInput

func ExtractPromptInput(req SendPromptRequest) (PromptInput, error)

ExtractPromptInput validates explicit command identity and AI SDK message correlation.

func ExtractPromptInputWithAttachmentLimit

func ExtractPromptInputWithAttachmentLimit(req SendPromptRequest, maxAttachments int) (PromptInput, error)

ExtractPromptInputWithAttachmentLimit validates prompt input against the effective attachment limit.

type PromptMode

type PromptMode string

PromptMode selects how prompt input is handled while the session is busy.

const (
	PromptModeQueue     PromptMode = "queue"
	PromptModeInterrupt PromptMode = "interrupt"
	PromptModeSteer     PromptMode = "steer"
)

type PromptOriginMeta

type PromptOriginMeta struct {
	Kind             string `json:"kind"`
	SessionID        string `json:"session_id"`
	WorkspaceID      string `json:"workspace_id"`
	AgentName        string `json:"agent_name,omitempty"`
	TitleAtSend      string `json:"title_at_send,omitempty"`
	Hop              int    `json:"hop"`
	NotifyOnComplete bool   `json:"notify_on_complete,omitempty"`
	ReplyWatchID     string `json:"reply_watch_id,omitempty"`
	InReplyTo        string `json:"in_reply_to,omitempty"`
}

type PromptRuntimeSelectionPayload

type PromptRuntimeSelectionPayload struct {
	Provider        string                    `json:"provider"`
	Model           string                    `json:"model,omitempty"`
	ReasoningEffort ReasoningEffort           `json:"reasoning_effort,omitempty"`
	Speed           Speed                     `json:"speed,omitempty"`
	ACPOptions      []AgentACPOptionSelection `json:"acp_options,omitempty"`
}

PromptRuntimeSelectionPayload is the caller-selected runtime for one prompt.

func PromptRuntimeSelectionPayloadFromSelection

func PromptRuntimeSelectionPayloadFromSelection(
	selection *session.RuntimeSelection,
) *PromptRuntimeSelectionPayload

PromptRuntimeSelectionPayloadFromSelection converts an optional runtime selection into its wire shape.

type PromptStreamChunk

type PromptStreamChunk struct {
	Type string `json:"type"`
}

PromptStreamChunk carries the extensible AI SDK UI message stream discriminator.

type PromptUIMessage

type PromptUIMessage struct {
	ID      string             `json:"id,omitempty"`
	Role    string             `json:"role"`
	Content string             `json:"content,omitempty"`
	Parts   []PromptUITextPart `json:"parts,omitempty"`
}

PromptUIMessage carries Vercel AI SDK compatible message input.

type PromptUITextPart

type PromptUITextPart struct {
	Type string `json:"type,omitempty"`
	Text string `json:"text,omitempty"`
}

PromptUITextPart carries one text part from a Vercel AI SDK message.

type ProvenancePayload

type ProvenancePayload struct {
	Slug                   string                    `json:"slug,omitempty"`
	Registry               string                    `json:"registry,omitempty"`
	Version                string                    `json:"version,omitempty"`
	InstalledAt            *time.Time                `json:"installed_at,omitempty"`
	InstalledFromExtension string                    `json:"installed_from_extension,omitempty"`
	PrecedenceTier         string                    `json:"precedence_tier"`
	ShadowedBy             []SkillShadowEntryPayload `json:"shadowed_by,omitempty"`
}

ProvenancePayload is the nested provenance metadata for marketplace skills.

type ProviderAuthProbeResponse

type ProviderAuthProbeResponse struct {
	Provider   string                    `json:"provider"`
	AuthStatus ProviderAuthStatusPayload `json:"auth_status"`
	Probe      *ProviderAuthProbeResult  `json:"probe,omitzero"`
}

ProviderAuthProbeResponse reports one live provider-auth probe result.

type ProviderAuthProbeResult

type ProviderAuthProbeResult struct {
	ExitCode   int    `json:"exit_code"`
	Stdout     string `json:"stdout,omitempty"`
	Stderr     string `json:"stderr,omitempty"`
	DurationMs int64  `json:"duration_ms"`
}

ProviderAuthProbeResult is the redacted raw output from a provider auth probe.

type ProviderAuthStatusPayload

type ProviderAuthStatusPayload struct {
	Mode        string                         `json:"mode"`
	EnvPolicy   string                         `json:"env_policy"`
	HomePolicy  string                         `json:"home_policy"`
	State       string                         `json:"state"`
	Code        string                         `json:"code,omitempty"`
	Message     string                         `json:"message,omitempty"`
	StatusCmd   string                         `json:"status_command,omitempty"`
	Login       ProviderLoginDescriptorPayload `json:"login"`
	LastProbeAt *time.Time                     `json:"last_probe_at,omitempty"`
}

ProviderAuthStatusPayload is the shared provider-auth readiness payload.

type ProviderListResponse

type ProviderListResponse struct {
	Providers []ProviderSummaryPayload `json:"providers"`
}

ProviderListResponse is the canonical provider inventory payload.

type ProviderLoginDescriptorPayload

type ProviderLoginDescriptorPayload struct {
	Configured        bool                      `json:"configured"`
	Source            ProviderLoginSource       `json:"source,omitempty"`
	Executable        string                    `json:"executable,omitempty"`
	Presence          ProviderLoginPresence     `json:"presence"`
	RecommendedAction ProviderRecommendedAction `json:"recommended_action,omitempty"`
}

ProviderLoginDescriptorPayload is the only public projection of auth_login_command.

type ProviderLoginPresence

type ProviderLoginPresence string

ProviderLoginPresence reports only the availability truth established by the current probe.

const (
	ProviderLoginPresencePresent ProviderLoginPresence = "present"
	ProviderLoginPresenceMissing ProviderLoginPresence = "missing"
	ProviderLoginPresenceUnknown ProviderLoginPresence = "unknown"
)

type ProviderLoginSource

type ProviderLoginSource string

ProviderLoginSource identifies the safe source of configured login metadata.

const (
	ProviderLoginSourceAuthLoginCommand ProviderLoginSource = "auth_login_command"
	ProviderLoginSourceAuthACPMethod    ProviderLoginSource = "auth_acp_method"
)

type ProviderModelConfigurationPayload

type ProviderModelConfigurationPayload struct {
	ReasoningEffort *ReasoningEffort `json:"reasoning_effort,omitempty"`
	Fast            *bool            `json:"fast,omitempty"`
	Thinking        *bool            `json:"thinking,omitempty"`
}

ProviderModelConfigurationPayload is one public valid runtime-option combination. Provider transport identifiers remain daemon-private.

type ProviderModelCurationRequest

type ProviderModelCurationRequest struct {
	ModelID                string           `json:"model_id"`
	Hidden                 *bool            `json:"hidden,omitzero"`
	Featured               *bool            `json:"featured,omitzero"`
	Deprecated             *bool            `json:"deprecated,omitzero"`
	DefaultReasoningEffort *ReasoningEffort `json:"default_effort,omitzero"`
	DefaultSpeed           *Speed           `json:"default_speed,omitzero"`
}

ProviderModelCurationRequest captures one model-only provider config mutation.

type ProviderModelCurationResponse

type ProviderModelCurationResponse struct {
	Model        ProviderModelPayload  `json:"model"`
	Apply        SettingsApplyResponse `json:"apply"`
	DefaultSpeed Speed                 `json:"default_speed,omitempty"`
}

ProviderModelCurationResponse reports the effective model and live config-apply result.

type ProviderModelListResponse

type ProviderModelListResponse struct {
	Models []ProviderModelPayload `json:"models"`
}

ProviderModelListResponse is the native provider model catalog list payload.

type ProviderModelPayload

type ProviderModelPayload struct {
	ProviderID             string                              `json:"provider_id"`
	ModelID                string                              `json:"model_id"`
	DisplayName            string                              `json:"display_name,omitempty"`
	Sources                []ModelCatalogSourceRefPayload      `json:"sources"`
	Available              *bool                               `json:"available"`
	AvailabilityState      string                              `json:"availability_state"`
	Stale                  bool                                `json:"stale"`
	RefreshedAt            string                              `json:"refreshed_at,omitempty"`
	ContextWindow          *int64                              `json:"context_window,omitempty"`
	MaxInputTokens         *int64                              `json:"max_input_tokens,omitempty"`
	MaxOutputTokens        *int64                              `json:"max_output_tokens,omitempty"`
	SupportsTools          *bool                               `json:"supports_tools,omitempty"`
	SupportsReasoning      *bool                               `json:"supports_reasoning,omitempty"`
	ReasoningEfforts       []ReasoningEffort                   `json:"reasoning_efforts,omitempty"`
	DefaultReasoningEffort *ReasoningEffort                    `json:"default_reasoning_effort,omitempty"`
	ConfigOptions          []SessionConfigOptionPayload        `json:"config_options,omitempty"`
	Configurations         []ProviderModelConfigurationPayload `json:"configurations,omitempty"`
	Cost                   *ModelCatalogCostPayload            `json:"cost,omitempty"`
	Curated                bool                                `json:"curated"`
	Deprecated             bool                                `json:"deprecated"`
	Hidden                 bool                                `json:"hidden"`
	Featured               bool                                `json:"featured"`
	ReleaseDate            string                              `json:"release_date,omitempty"`
	// ReasoningKnown distinguishes confirmed model options from reasoning-support enrichment.
	ReasoningKnown bool `json:"reasoning_known,omitempty"`
	// ReasoningApply reports whether live ACP options may configure effort (acp_option or none).
	ReasoningApply  string          `json:"reasoning_apply,omitempty"`
	ReasoningSource ReasoningSource `json:"reasoning_source,omitempty"`
	LastError       string          `json:"last_error,omitempty"`
}

ProviderModelPayload is one merged provider model catalog projection.

type ProviderModelRefreshRequest

type ProviderModelRefreshRequest struct {
	SourceID  string `json:"source_id,omitempty"`
	Force     bool   `json:"force,omitzero"`
	RequestID string `json:"request_id,omitempty"`
}

ProviderModelRefreshRequest captures one provider model catalog refresh request.

type ProviderModelRefreshResponse

type ProviderModelRefreshResponse struct {
	Sources []ModelCatalogSourceStatusPayload `json:"sources"`
	Error   string                            `json:"error,omitempty"`
}

ProviderModelRefreshResponse reports provider model catalog refresh source status.

type ProviderModelStatusResponse

type ProviderModelStatusResponse struct {
	Sources []ModelCatalogSourceStatusPayload `json:"sources"`
}

ProviderModelStatusResponse reports provider model catalog source status.

type ProviderRecommendedAction

type ProviderRecommendedAction string

ProviderRecommendedAction is the safe agent-facing recovery action.

const (
	ProviderRecommendedActionNone       ProviderRecommendedAction = ""
	ProviderRecommendedActionInstallCLI ProviderRecommendedAction = "install_cli"
	ProviderRecommendedActionLogin      ProviderRecommendedAction = "login"
	ProviderRecommendedActionBindSecret ProviderRecommendedAction = "bind_secret"
	ProviderRecommendedActionRetry      ProviderRecommendedAction = "retry"
	ProviderRecommendedActionInspect    ProviderRecommendedAction = "inspect"
	ProviderRecommendedActionNoRetry    ProviderRecommendedAction = "no_retry"
)

type ProviderRuntimeLiveApply

type ProviderRuntimeLiveApply string

ProviderRuntimeLiveApply identifies when a runtime selection change sent to a live session_config process takes effect.

const (
	// ProviderRuntimeLiveApplyNextStep means a running turn uses the change from the agent's next step.
	ProviderRuntimeLiveApplyNextStep ProviderRuntimeLiveApply = "next_step"
	// ProviderRuntimeLiveApplyNextTurn means the provider honors the change from its next turn.
	ProviderRuntimeLiveApplyNextTurn ProviderRuntimeLiveApply = "next_turn"
)

type ProviderRuntimeStrategy

type ProviderRuntimeStrategy string

ProviderRuntimeStrategy identifies how a provider applies runtime controls.

const (
	ProviderRuntimeStrategySessionConfig   ProviderRuntimeStrategy = "session_config"
	ProviderRuntimeStrategyLaunchArg       ProviderRuntimeStrategy = "launch_arg"
	ProviderRuntimeStrategyProviderManaged ProviderRuntimeStrategy = "provider_managed"
)

type ProviderStatusPayload

type ProviderStatusPayload struct {
	Name          string                         `json:"name"`
	DisplayName   string                         `json:"display_name,omitempty"`
	Default       bool                           `json:"default"`
	Mode          string                         `json:"mode,omitempty"`
	EnvPolicy     string                         `json:"env_policy,omitempty"`
	HomePolicy    string                         `json:"home_policy,omitempty"`
	State         string                         `json:"state"`
	Code          string                         `json:"code,omitempty"`
	Message       string                         `json:"message,omitempty"`
	StatusCommand string                         `json:"status_command,omitempty"`
	Login         ProviderLoginDescriptorPayload `json:"login"`
	LastProbeAt   *time.Time                     `json:"last_probe_at,omitempty"`
}

ProviderStatusPayload reports one provider's auth readiness in the status surface.

type ProviderSummaryPayload

type ProviderSummaryPayload struct {
	// ReviewerMode is always present; an empty value means the provider declares no reviewer.
	ReviewerMode     string                                    `json:"reviewer_mode"`
	SessionEnvStatus []SettingsProviderCredentialStatusPayload `json:"session_env_status,omitempty"`
	Name             string                                    `json:"name"`
	DisplayName      string                                    `json:"display_name,omitempty"`
	RuntimeStrategy  ProviderRuntimeStrategy                   `json:"runtime_strategy,omitempty"`
	Default          bool                                      `json:"default"`
	AuthStatus       ProviderAuthStatusPayload                 `json:"auth_status"`
}

ProviderSummaryPayload describes one canonical provider and its declared auth state.

type ProviderUsageAccount

type ProviderUsageAccount struct {
	Label string `json:"label"`
	Plan  string `json:"plan"`
}

type ProviderUsageAmount

type ProviderUsageAmount struct {
	Value string `json:"value"`
	Unit  string `json:"unit"`
}

type ProviderUsageBalance

type ProviderUsageBalance struct {
	ID        string              `json:"id"`
	Label     string              `json:"label"`
	Remaining ProviderUsageAmount `json:"remaining"`
	ExpiresAt *time.Time          `json:"expires_at"`
}

type ProviderUsageEnvelope

type ProviderUsageEnvelope struct {
	KeychainSupported bool                     `json:"keychain_supported"`
	ProfileID         string                   `json:"profile_id"`
	Revision          uint64                   `json:"revision"`
	GeneratedAt       time.Time                `json:"generated_at"`
	Enabled           bool                     `json:"enabled"`
	Tray              *ProviderUsageTraySignal `json:"tray"`
	Targets           []ProviderUsageTarget    `json:"targets"`
}

type ProviderUsageError

type ProviderUsageError struct {
	Code       string     `json:"code"`
	Message    string     `json:"message"`
	Action     string     `json:"action"`
	RetryAfter *time.Time `json:"retry_after"`
}

type ProviderUsageRefreshRequest

type ProviderUsageRefreshRequest struct {
	Profile       string   `json:"profile,omitempty"`
	ProviderIDs   []string `json:"provider_ids,omitempty"`
	MaxAgeSeconds int64    `json:"max_age_seconds,omitempty"`
	WaitMS        *int64   `json:"wait_ms,omitempty"`
	Intent        string   `json:"intent,omitempty"`
}

ProviderUsageRefreshRequest selects one profile and bounded refresh wait.

type ProviderUsageSource

type ProviderUsageSource struct {
	Kind  string `json:"kind"`
	Label string `json:"label"`
}

type ProviderUsageSpendCap

type ProviderUsageSpendCap struct {
	ID          string               `json:"id"`
	Label       string               `json:"label"`
	Used        ProviderUsageAmount  `json:"used"`
	Limit       *ProviderUsageAmount `json:"limit"`
	UsedPercent *float64             `json:"used_percent"`
	ResetsAt    *time.Time           `json:"resets_at"`
	Enabled     *bool                `json:"enabled"`
}

type ProviderUsageStreamEvent

type ProviderUsageStreamEvent struct {
	Revision uint64 `json:"revision"`
	BootID   string `json:"boot_id"`
}

type ProviderUsageTarget

type ProviderUsageTarget struct {
	ProviderID    string                  `json:"provider_id"`
	ProviderName  string                  `json:"provider_name"`
	Status        string                  `json:"status"`
	Source        *ProviderUsageSource    `json:"source"`
	Account       *ProviderUsageAccount   `json:"account"`
	Windows       []ProviderUsageWindow   `json:"windows"`
	Balances      []ProviderUsageBalance  `json:"balances"`
	SpendCaps     []ProviderUsageSpendCap `json:"spend_caps"`
	Confidence    string                  `json:"confidence"`
	MeasuredAt    *time.Time              `json:"measured_at"`
	CheckedAt     *time.Time              `json:"checked_at"`
	NextRefreshAt *time.Time              `json:"next_refresh_at"`
	Refreshing    bool                    `json:"refreshing"`
	Error         *ProviderUsageError     `json:"error"`
}

type ProviderUsageTraySignal

type ProviderUsageTraySignal struct {
	ProviderID  string     `json:"provider_id"`
	WindowID    string     `json:"window_id"`
	Label       string     `json:"label"`
	UsedPercent float64    `json:"used_percent"`
	ResetsAt    *time.Time `json:"resets_at"`
	Severity    string     `json:"severity"`
	Stale       bool       `json:"stale"`
}

type ProviderUsageWindow

type ProviderUsageWindow struct {
	ID              string               `json:"id"`
	Label           string               `json:"label"`
	Kind            string               `json:"kind"`
	DurationSeconds *int64               `json:"duration_seconds"`
	UsedPercent     *float64             `json:"used_percent"`
	Used            *ProviderUsageAmount `json:"used"`
	Limit           *ProviderUsageAmount `json:"limit"`
	ResetsAt        *time.Time           `json:"resets_at"`
	ResetText       string               `json:"reset_text"`
}

type PutLoopAnnotationsRequest

type PutLoopAnnotationsRequest struct {
	Annotations []LoopAnnotationPayload `json:"annotations"`
}

PutLoopAnnotationsRequest replaces editor sidecar positions for one Loop.

type PutLoopConfigRequest

type PutLoopConfigRequest struct {
	Config LoopConfig `json:"config"`
}

PutLoopConfigRequest replaces the stored no-fork config override.

type PutLoopInputDefaultRequest

type PutLoopInputDefaultRequest struct {
	Scope LoopInputDefaultsScope `json:"scope"`
	Value any                    `json:"value"`
}

PutLoopInputDefaultRequest sets one configured Loop input at one scope.

type PutLoopInputDefaultsRequest

type PutLoopInputDefaultsRequest struct {
	Scope  LoopInputDefaultsScope `json:"scope"`
	Values map[string]any         `json:"values"`
}

PutLoopInputDefaultsRequest replaces one Loop's complete configured table at one scope.

type PutResourceRequest

type PutResourceRequest struct {
	Scope           resources.ResourceScope `json:"scope"`
	ExpectedVersion int64                   `json:"expected_version,omitzero"`
	Spec            json.RawMessage         `json:"spec"`
}

PutResourceRequest is the shared desired-state upsert payload.

type PutSettingsHookRequest

type PutSettingsHookRequest struct {
	Declaration SettingsHookDeclarationPayload `json:"declaration"`
}

type PutSettingsMCPServerRequest

type PutSettingsMCPServerRequest struct {
	Server          SettingsMCPServerPayload              `json:"server"`
	SecretValues    *SettingsMCPSecretValuesPayload       `json:"secret_values,omitzero"`
	PreserveSecrets *SettingsMCPSecretPreservationPayload `json:"preserve_secrets,omitzero"`
	PreserveEnv     []string                              `json:"preserve_env,omitempty"`
}

type PutSettingsProviderRequest

type PutSettingsProviderRequest struct {
	Settings      SettingsProviderWritePayload         `json:"settings"`
	ModelCuration *ProviderModelCurationRequest        `json:"model_curation,omitzero"`
	Secrets       []SettingsProviderSecretWritePayload `json:"secrets,omitempty"`
}

type PutVaultSecretRequest

type PutVaultSecretRequest struct {
	Ref         string `json:"ref"`
	Kind        string `json:"kind,omitempty"`
	SecretValue string `json:"secret_value"`
}

PutVaultSecretRequest writes one vault-backed secret. SecretValue is write-only.

func (PutVaultSecretRequest) Normalize

Normalize returns the canonical write request without exposing plaintext in errors.

func (PutVaultSecretRequest) Validate

func (r PutVaultSecretRequest) Validate() error

Validate verifies a public vault write request.

type ReasoningEffort

type ReasoningEffort = modelcatalog.ReasoningEffort

ReasoningEffort is the canonical model-catalog reasoning level exposed by API contracts.

type ReasoningSource

type ReasoningSource = modelcatalog.ReasoningSource

ReasoningSource is the canonical model-catalog reasoning provenance exposed by API contracts.

type RecapPayload

type RecapPayload struct {
	Session        SessionPayload            `json:"session"`
	ActiveRun      *TaskRunPayload           `json:"active_run,omitzero"`
	RecentMarkers  []TranscriptMarkerPayload `json:"recent_markers"`
	RecentMessages []transcript.UIMessage    `json:"recent_messages"`
	PendingInputs  int                       `json:"pending_inputs"`
	PendingMarkers int                       `json:"pending_markers"`
	Snapshot       RecapSnapshotPayload      `json:"snapshot"`
}

RecapPayload is a deterministic session recap composed from persisted daemon state.

type RecapSnapshotPayload

type RecapSnapshotPayload struct {
	GeneratedAt      time.Time `json:"generated_at"`
	EventCursor      int64     `json:"event_cursor"`
	TranscriptCursor int64     `json:"transcript_cursor"`
	QueueGeneration  int64     `json:"queue_generation"`
	Consistency      string    `json:"consistency"`
}

RecapSnapshotPayload records the consistent read boundary for one recap.

type RecoverTaskRequest

type RecoverTaskRequest struct {
	Note string `json:"note,omitempty"`
}

RecoverTaskRequest captures one task-level needs_attention recovery request.

type RecoverTaskRunRequest

type RecoverTaskRunRequest struct {
	Reason   string          `json:"reason,omitempty"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

RecoverTaskRunRequest is the shared recovery request payload for a needs_attention run.

type ReloadExtensionRequest

type ReloadExtensionRequest struct {
	GenerationHash       string `json:"generation_hash"`
	ConfirmGatewayDigest string `json:"confirm_gateway_digest,omitempty"`
}

ReloadExtensionRequest swaps one dev-linked extension to an immutable generation.

type RemoveDiscoveredWorktreeRequest

type RemoveDiscoveredWorktreeRequest struct {
	Path        string `json:"path"`
	Force       bool   `json:"force,omitempty"`
	ExpectStale bool   `json:"expect_stale,omitempty"`
}

RemoveDiscoveredWorktreeRequest names a Git-only linked worktree by the path exactly as the listing reports it. Force acknowledges dirty or unpushed loss. ExpectStale confirms only clearing a stale Git entry; a checkout that is present again is refused with worktree_discovered_changed.

type RenameProfilePlan

type RenameProfilePlan struct {
	Revision          string             `json:"revision"`
	MachineFolders    []string           `json:"machine_folders"`
	RepoCandidates    []ProfileFolderRef `json:"repo_candidates"`
	DormantPlacements []ProfilePlacement `json:"dormant_placements"`
	VaultRefRewrites  int                `json:"vault_ref_rewrites"`
}

RenameProfilePlan previews the folders and references affected by a rename.

type RenameProfileRequest

type RenameProfileRequest struct {
	NewName      string   `json:"new_name"        binding:"required"`
	Repos        []string `json:"repos,omitempty"`
	PlanRevision string   `json:"plan_revision"   binding:"required"`
}

RenameProfileRequest requests a profile rename using a prepared plan.

type RenameProfileResponse

type RenameProfileResponse struct {
	Renamed           bool                       `json:"renamed"`
	RepoResults       []ProfileRepoRenameOutcome `json:"repo_results"`
	DormantPlacements []ProfilePlacement         `json:"dormant_placements"`
}

RenameProfileResponse reports the outcome of a profile rename.

type RenameSessionFolderRequest

type RenameSessionFolderRequest struct {
	Name string `json:"name"`
}

RenameSessionFolderRequest changes a folder's display name.

type RenameSessionRequest

type RenameSessionRequest struct {
	Name string `json:"name"`
}

RenameSessionRequest changes the durable display name of one user session.

type RenameWorkspaceFolderRequest

type RenameWorkspaceFolderRequest struct {
	Name string `json:"name"`
}

RenameWorkspaceFolderRequest changes a workspace folder's display name.

type ReorderSessionFoldersRequest

type ReorderSessionFoldersRequest struct {
	FolderIDs []string `json:"folder_ids"`
}

ReorderSessionFoldersRequest lists every folder of the scope exactly once, in order.

type ReorderSessionsRequest

type ReorderSessionsRequest struct {
	FolderID   string   `json:"folder_id,omitempty"`
	SessionIDs []string `json:"session_ids"`
}

ReorderSessionsRequest pins a manual order inside one container: a folder, or the workspace root when FolderID is empty. Listed sessions move into the container; existing members that are not listed keep their order after them.

type ReorderWorkspaceFoldersRequest

type ReorderWorkspaceFoldersRequest struct {
	FolderIDs []string `json:"folder_ids"`
}

ReorderWorkspaceFoldersRequest lists every workspace folder of the profile exactly once, in order.

type ReorderWorkspacesRequest

type ReorderWorkspacesRequest struct {
	FolderID     string   `json:"folder_id,omitempty"`
	WorkspaceIDs []string `json:"workspace_ids"`
}

ReorderWorkspacesRequest pins a manual order inside one container: a folder, or the root when FolderID is empty. Listed workspaces move into the container; existing members that are not listed keep their order after them.

type ReplaceSessionInputRequest

type ReplaceSessionInputRequest struct {
	Text           string `json:"text"`
	MessageID      string `json:"message_id"`
	IdempotencyKey string `json:"idempotency_key"`
}

ReplaceSessionInputRequest atomically replaces one queued input.

func (ReplaceSessionInputRequest) Validate

func (r ReplaceSessionInputRequest) Validate() error

Validate checks one atomic queued-input replacement.

type ReplyWatchPayload

type ReplyWatchPayload struct {
	ID              string    `json:"id"`
	TargetSessionID string    `json:"target_session_id"`
	MessageID       string    `json:"message_id"`
	State           string    `json:"state"`
	CreatedAt       time.Time `json:"created_at"`
}

SessionPayload is the shared session response payload.

type ReplyWatchRefPayload

type ReplyWatchRefPayload struct {
	ID    string `json:"id"`
	State string `json:"state"`
}

SendPromptResultPayload reports non-streaming busy-input outcomes.

type RerunLoopRequest

type RerunLoopRequest struct {
	FromNode  string `json:"from_node"`
	ItemIndex *int   `json:"item_index,omitzero"`
	Reason    string `json:"reason,omitempty"`
	RequestID string `json:"request_id,omitempty"`
}

type RerunLoopResponse

type RerunLoopResponse struct {
	RunID            string   `json:"run_id"`
	Generation       int64    `json:"generation"`
	ParentGeneration int64    `json:"parent_generation"`
	RerunNodes       []string `json:"rerun_nodes"`
	Carried          int      `json:"carried"`
	Replayed         bool     `json:"replayed,omitzero"`
}

type ResolveToolApprovalRequest

type ResolveToolApprovalRequest struct {
	Decision toolspkg.ApprovalOutcome `json:"decision"`
}

type ResolveWorkspaceRequest

type ResolveWorkspaceRequest struct {
	Path string `json:"path"`
}

ResolveWorkspaceRequest is the shared workspace resolve request payload.

type ResolvedWorktreeMode

type ResolvedWorktreeMode string

ResolvedWorktreeMode is the immutable runtime choice after inheritance has been resolved. Unlike a profile mode, it can never be "inherit".

const (
	ResolvedWorktreeModeNone   ResolvedWorktreeMode = "none"
	ResolvedWorktreeModeRef    ResolvedWorktreeMode = "ref"
	ResolvedWorktreeModePerRun ResolvedWorktreeMode = "per_run"
)

type ResourceRecordPayload

type ResourceRecordPayload struct {
	Kind      resources.ResourceKind   `json:"kind"`
	ID        string                   `json:"id"`
	Version   int64                    `json:"version"`
	Scope     resources.ResourceScope  `json:"scope"`
	Owner     resources.ResourceOwner  `json:"owner"`
	Source    resources.ResourceSource `json:"source"`
	Spec      json.RawMessage          `json:"spec"`
	CreatedAt time.Time                `json:"created_at"`
	UpdatedAt time.Time                `json:"updated_at"`
}

ResourceRecordPayload is the shared desired-state record response shape.

type ResourceResponse

type ResourceResponse struct {
	Record ResourceRecordPayload `json:"record"`
}

ResourceResponse wraps one desired-state resource payload.

type ResourcesResponse

type ResourcesResponse struct {
	Records []ResourceRecordPayload `json:"records"`
}

ResourcesResponse wraps the shared desired-state resource list payload.

type RespondLoopRequest

type RespondLoopRequest struct {
	Generation int             `json:"generation"`
	ItemIndex  int             `json:"item_index,omitzero"`
	Decision   string          `json:"decision,omitempty"`
	Payload    json.RawMessage `json:"payload"`
	Note       string          `json:"note,omitempty"`
}

type RespondLoopRequestResponse

type RespondLoopRequestResponse struct {
	OK         bool                  `json:"ok"`
	RunID      string                `json:"run_id"`
	NodeID     string                `json:"node_id"`
	Decision   string                `json:"decision"`
	State      string                `json:"state"`
	Provenance LoopRequestProvenance `json:"provenance"`
}

type RestartActionResponse

type RestartActionResponse struct {
	OperationID        string                 `json:"operation_id"`
	Status             RestartOperationStatus `json:"status"`
	StatusURL          string                 `json:"status_url"`
	ActiveSessionCount int                    `json:"active_session_count"`
}

type RestartActionStatus

type RestartActionStatus struct {
	OperationID        string                 `json:"operation_id"`
	Status             RestartOperationStatus `json:"status"`
	OldPID             int                    `json:"old_pid"`
	OldStartedAt       time.Time              `json:"old_started_at"`
	OldSocketPath      string                 `json:"old_socket_path"`
	NewPID             int                    `json:"new_pid,omitzero"`
	ActiveSessionCount int                    `json:"active_session_count"`
	FailureReason      string                 `json:"failure_reason,omitempty"`
	StartedAt          time.Time              `json:"started_at"`
	UpdatedAt          time.Time              `json:"updated_at"`
	CompletedAt        *time.Time             `json:"completed_at,omitempty"`
}

type RestartOperationStatus

type RestartOperationStatus string
const (
	RestartOperationPending        RestartOperationStatus = "pending"
	RestartOperationStopping       RestartOperationStatus = "stopping"
	RestartOperationWaitingRelease RestartOperationStatus = "waiting_release"
	RestartOperationStarting       RestartOperationStatus = "starting"
	RestartOperationReady          RestartOperationStatus = "ready"
	RestartOperationFailed         RestartOperationStatus = "failed"
)

type ResumeSessionFromLaterRequest

type ResumeSessionFromLaterRequest struct {
	// WithChildren also takes parked descendants out of Later.
	WithChildren bool `json:"with_children,omitempty"`
}

ResumeSessionFromLaterRequest returns a parked session to the normal flow.

type ResumeTaskRequest

type ResumeTaskRequest struct {
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

ResumeTaskRequest captures one per-task resume request.

type RetryTaskRunRequest

type RetryTaskRunRequest struct {
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

RetryTaskRunRequest is the shared retry request payload.

type RetryTaskRunResponse

type RetryTaskRunResponse struct {
	PreviousRun TaskRunPayload `json:"previous_run"`
	Run         TaskRunPayload `json:"run"`
}

RetryTaskRunResponse wraps one retry source and newly queued run payload.

type RoleDiagnostic

type RoleDiagnostic struct {
	Code    string `json:"code"`
	Message string `json:"message"`
	Agent   string `json:"agent,omitempty"`
}

RoleDiagnostic reports a current configuration-resolution problem without simulating an invocation.

type RoleFallbackStatus

type RoleFallbackStatus struct {
	SessionEnv      map[string]SessionEnvBindingPayload `json:"session_env,omitempty"`
	Provider        string                              `json:"provider"`
	Model           string                              `json:"model"`
	ReasoningEffort string                              `json:"reasoning_effort,omitempty"`
	Speed           Speed                               `json:"speed,omitempty"`
	ACPOptions      []AgentACPOptionSelection           `json:"acp_options,omitempty"`
	// Command is the configured route account (operator configuration surface).
	Command string `json:"command,omitempty"`
	// CommandFingerprint is `sha256:` over Command, the same value fallback events and
	// transcript markers carry; present exactly when Command is set so clients can label
	// a route without printing the command.
	CommandFingerprint string `json:"command_fingerprint,omitempty"`
}

RoleFallbackStatus is one configured fallback route in declaration order. Agent payloads reuse it for `fallback_chain` so both projections share one route shape.

type RoleResolutionMode

type RoleResolutionMode string

RoleResolutionMode identifies how one configured background role finds its identity.

const (
	RoleResolutionModeBuiltin RoleResolutionMode = "builtin"
	RoleResolutionModeCatalog RoleResolutionMode = "catalog"
	RoleResolutionModeInherit RoleResolutionMode = "inherit"
)

type RoleStatus

type RoleStatus struct {
	Role            string                    `json:"role"`
	Enabled         bool                      `json:"enabled"`
	ResolutionMode  RoleResolutionMode        `json:"resolution_mode"`
	Agent           *string                   `json:"agent"`
	Provider        *string                   `json:"provider"`
	Model           *string                   `json:"model"`
	ReasoningEffort *string                   `json:"reasoning_effort"`
	Speed           *Speed                    `json:"speed"`
	ACPOptions      []AgentACPOptionSelection `json:"acp_options"`
	Timeout         *string                   `json:"timeout,omitzero"`
	FallbackChain   []RoleFallbackStatus      `json:"fallback_chain"`
	Provenance      map[string]string         `json:"provenance"`
	Diagnostics     []RoleDiagnostic          `json:"diagnostics"`
}

RoleStatus is the effective configuration projection for one background role.

type RoleStatusResponse

type RoleStatusResponse struct {
	Role RoleStatus `json:"role"`
}

RoleStatusResponse wraps one role projection.

type RolesResponse

type RolesResponse struct {
	Roles []RoleStatus `json:"roles"`
}

RolesResponse wraps the closed role roster.

type RunLoopRequest

type RunLoopRequest struct {
	Inputs          map[string]any `json:"inputs,omitempty"`
	ParentLoopRunID string         `json:"parent_loop_run_id,omitempty"`
	ConfigOverrides *LoopConfig    `json:"config_overrides,omitzero"`
}

RunLoopRequest starts a Loop, or previews it when dry=true.

type RunLoopResponse

type RunLoopResponse struct {
	Run    *LoopRunPayload  `json:"run,omitzero"`
	DryRun *LoopPlanPayload `json:"dry_run,omitzero"`
	WebURL string           `json:"web_url,omitempty"`
}

RunLoopResponse returns either a persisted run or a dry-run plan preview.

type RunPayload

type RunPayload struct {
	WorkspaceID     *string                 `json:"workspace_id,omitempty"`
	Attribution     string                  `json:"attribution"`
	ID              string                  `json:"id"`
	ProfileID       string                  `json:"profile_id"`
	ProfileName     string                  `json:"profile_name"`
	ProfileColor    string                  `json:"profile_color,omitempty"`
	ProfileIcon     string                  `json:"profile_icon,omitempty"`
	JobID           string                  `json:"job_id,omitempty"`
	TriggerID       string                  `json:"trigger_id,omitempty"`
	SessionID       string                  `json:"session_id,omitempty"`
	TaskID          string                  `json:"task_id,omitempty"`
	TaskRunID       string                  `json:"task_run_id,omitempty"`
	LoopRunID       string                  `json:"loop_run_id,omitempty"`
	FireID          string                  `json:"fire_id,omitempty"`
	Status          automationpkg.RunStatus `json:"status"`
	Attempt         int                     `json:"attempt"`
	ScheduledAt     *time.Time              `json:"scheduled_at,omitempty"`
	StartedAt       *time.Time              `json:"started_at,omitempty"`
	EndedAt         *time.Time              `json:"ended_at,omitempty"`
	Error           string                  `json:"error,omitempty"`
	DeliveryError   string                  `json:"delivery_error,omitempty"`
	DeliveryErrorAt *time.Time              `json:"delivery_error_at,omitempty"`
	Metadata        map[string]any          `json:"metadata,omitempty"`
}

RunPayload is the shared automation run response payload.

type RunResponse

type RunResponse struct {
	Run RunPayload `json:"run"`
}

RunResponse wraps one shared automation run payload.

type RunWorktreeExitActionRequest

type RunWorktreeExitActionRequest struct {
	DeliveryID    string             `json:"delivery_id,omitempty"`
	ExpectedHead  string             `json:"expected_head,omitempty"`
	IncludePaths  []string           `json:"include_paths,omitempty"`
	ExpectedScope string             `json:"expected_scope,omitempty"`
	Action        WorktreeExitAction `json:"action"`
	Message       string             `json:"message,omitempty"`
	Title         string             `json:"title,omitempty"`
	Body          string             `json:"body,omitempty"`
	Draft         bool               `json:"draft,omitzero"`
	Base          string             `json:"base,omitempty"`
}

type RunsResponse

type RunsResponse struct {
	Page *CursorPagePayload `json:"page,omitempty"`
	Runs []RunPayload       `json:"runs"`
}

RunsResponse wraps the shared automation run list payload.

type RuntimeActivityPayload

type RuntimeActivityPayload struct {
	TurnID             string     `json:"turn_id,omitempty"`
	TurnSource         string     `json:"turn_source,omitempty"`
	TurnStartedAt      *time.Time `json:"turn_started_at,omitempty"`
	DeadlineAt         *time.Time `json:"deadline_at,omitempty"`
	LastActivityAt     *time.Time `json:"last_activity_at,omitempty"`
	LastActivityKind   string     `json:"last_activity_kind,omitempty"`
	LastActivityDetail string     `json:"last_activity_detail,omitempty"`
	CurrentTool        string     `json:"current_tool,omitempty"`
	ToolCallID         string     `json:"tool_call_id,omitempty"`
	LastProgressAt     *time.Time `json:"last_progress_at,omitempty"`
	IterationCurrent   int        `json:"iteration_current"`
	IterationMax       int        `json:"iteration_max"`
	IdleSeconds        int64      `json:"idle_seconds"`
	ElapsedSeconds     int64      `json:"elapsed_seconds"`
	ElapsedMS          int64      `json:"elapsed_ms"`
}

RuntimeActivityPayload is the shared JSON representation of active prompt supervision state.

type RuntimeIdentityPayload

type RuntimeIdentityPayload struct {
	SchemaVersion string                `json:"schema_version"`
	Daemon        DaemonIdentityPayload `json:"daemon"`
}

RuntimeIdentityPayload is the bounded daemon identity used by local liveness clients.

type RuntimeSelectionPayload

type RuntimeSelectionPayload struct {
	Provider        string                    `json:"provider"`
	Model           string                    `json:"model,omitempty"`
	ReasoningEffort ReasoningEffort           `json:"reasoning_effort,omitempty"`
	Speed           Speed                     `json:"speed,omitempty"`
	ACPOptions      []AgentACPOptionSelection `json:"acp_options,omitempty"`
	SpeedResolution *SpeedResolution          `json:"speed_resolution,omitempty"`
}

RuntimeSelectionPayload is the effective runtime bound to a logical session.

type SchedulerBacklogPayload

type SchedulerBacklogPayload struct {
	Runs  []SchedulerBacklogRunPayload `json:"runs"`
	Total int                          `json:"total"`
}

SchedulerBacklogPayload reports queued scheduler backlog rows.

type SchedulerBacklogQuery

type SchedulerBacklogQuery struct {
	Limit         int           `form:"limit"          json:"limit,omitzero"`
	Scope         taskpkg.Scope `form:"scope"          json:"scope,omitempty"`
	WorkspaceID   string        `form:"workspace"      json:"workspace,omitempty"`
	IncludePaused bool          `form:"include_paused" json:"include_paused,omitzero"`
}

SchedulerBacklogQuery captures transport query filters.

type SchedulerBacklogResponse

type SchedulerBacklogResponse struct {
	Backlog SchedulerBacklogPayload `json:"backlog"`
}

SchedulerBacklogResponse wraps scheduler backlog.

type SchedulerBacklogRunPayload

type SchedulerBacklogRunPayload struct {
	Task TaskSummaryPayload `json:"task"`
	Run  TaskRunPayload     `json:"run"`
}

SchedulerBacklogRunPayload exposes one queued run with task identity.

type SchedulerCountersPayload

type SchedulerCountersPayload struct {
	Cycles              int        `json:"cycles"`
	WakeAttempts        int        `json:"wake_attempts"`
	WakeSkipped         int        `json:"wake_skipped"`
	WakeSucceeded       int        `json:"wake_succeeded"`
	WakeFailed          int        `json:"wake_failed"`
	CapacityWaitingRuns int        `json:"capacity_waiting_runs"`
	SpawnRequested      int        `json:"spawn_requested"`
	NeedsAttention      int        `json:"needs_attention"`
	LastCycleAt         *time.Time `json:"last_cycle_at,omitempty"`
}

SchedulerCountersPayload reports cumulative decisions for this daemon lifetime.

type SchedulerDrainRequest

type SchedulerDrainRequest struct {
	Reason         string `json:"reason,omitempty"`
	TimeoutSeconds *int64 `json:"timeout_seconds,omitzero"`
}

SchedulerDrainRequest captures scheduler drain input.

type SchedulerDrainResponse

type SchedulerDrainResponse struct {
	Scheduler       SchedulerStatusPayload `json:"scheduler"`
	Completed       bool                   `json:"completed"`
	TimedOut        bool                   `json:"timed_out,omitzero"`
	RemainingClaims int                    `json:"remaining_claims"`
	StartedAt       time.Time              `json:"started_at"`
	CompletedAt     time.Time              `json:"completed_at"`
}

SchedulerDrainResponse wraps the final drain result.

type SchedulerPauseRequest

type SchedulerPauseRequest struct {
	Reason string `json:"reason,omitempty"`
}

SchedulerPauseRequest captures scheduler-wide pause input.

type SchedulerResumeRequest

type SchedulerResumeRequest struct {
	Reason string `json:"reason,omitempty"`
}

SchedulerResumeRequest captures scheduler-wide resume input.

type SchedulerStatusPayload

type SchedulerStatusPayload struct {
	Counters               *SchedulerCountersPayload `json:"counters,omitzero"`
	Paused                 bool                      `json:"paused"`
	PausedBy               string                    `json:"paused_by,omitempty"`
	PausedAt               *time.Time                `json:"paused_at,omitempty"`
	PausedReason           string                    `json:"paused_reason,omitempty"`
	ActiveClaimCount       int                       `json:"active_claim_count"`
	QueuedRunCount         int                       `json:"queued_run_count"`
	PausedTaskCount        int                       `json:"paused_task_count"`
	StarvedRunCount        int                       `json:"starved_run_count"`
	NeedsAttentionRunCount int                       `json:"needs_attention_run_count"`
	AsOf                   time.Time                 `json:"as_of"`
}

SchedulerStatusPayload exposes scheduler-wide pause state and queue pressure.

type SchedulerStatusResponse

type SchedulerStatusResponse struct {
	Scheduler SchedulerStatusPayload `json:"scheduler"`
}

SchedulerStatusResponse wraps scheduler status.

type SchemaStreamStatus

type SchemaStreamStatus struct {
	Stream       string `json:"stream"`
	Version      int64  `json:"version"`
	AppliedCount int    `json:"applied_count"`
	SumDigest    string `json:"sum_digest"`
}

SchemaStreamStatus reports one daemon-global migration stream's applied state.

type SendPromptRequest

type SendPromptRequest struct {
	Message        string                         `json:"message,omitempty"`
	Messages       []PromptUIMessage              `json:"messages,omitempty"`
	MessageID      string                         `json:"message_id"`
	IdempotencyKey string                         `json:"idempotency_key"`
	Mode           PromptMode                     `json:"mode,omitempty"`
	ExpectedTurnID string                         `json:"expected_turn_id,omitempty"`
	Runtime        *PromptRuntimeSelectionPayload `json:"runtime,omitzero"`
	Attachments    []PromptAttachmentRef          `json:"attachments,omitempty"`
	// InReplyTo names the message id this prompt answers. It requires a calling agent session.
	InReplyTo string `json:"in_reply_to,omitempty"`
	// Supersede replaces the caller's own older queued prompt to the same session.
	Supersede bool `json:"supersede,omitempty"`
}

SendPromptRequest captures user-facing prompt input plus optional busy-input mode.

type SendPromptResultPayload

type SendPromptResultPayload struct {
	TargetSessionID       string                  `json:"target_session_id,omitempty"`
	ReplyWatch            *ReplyWatchRefPayload   `json:"reply_watch,omitempty"`
	TargetWorkspaceID     string                  `json:"target_workspace_id,omitempty"`
	Disposition           session.Disposition     `json:"disposition,omitempty"`
	SteerDelivery         store.SteerDeliveryMode `json:"steer_delivery,omitempty"`
	TurnID                string                  `json:"turn_id,omitempty"`
	EntryID               string                  `json:"entry_id,omitempty"`
	Status                string                  `json:"status"`
	Mode                  PromptMode              `json:"mode,omitempty"`
	Delivery              PromptDelivery          `json:"delivery"`
	MessageID             string                  `json:"message_id"`
	IdempotencyKey        string                  `json:"idempotency_key"`
	Replayed              bool                    `json:"replayed"`
	QueueEntryID          string                  `json:"queue_entry_id,omitempty"`
	QueuePosition         int                     `json:"queue_position"`
	QueueGeneration       int64                   `json:"queue_generation,omitzero"`
	EstimatedSendAt       *time.Time              `json:"estimated_send_at,omitempty"`
	PreviousTurnID        string                  `json:"previous_turn_id,omitempty"`
	NewTurnID             string                  `json:"new_turn_id,omitempty"`
	CanceledQueuedEntries int                     `json:"canceled_queued_entries,omitzero"`
	Goal                  *GoalCommandResult      `json:"goal,omitzero"`
}

type SendPromptResultResponse

type SendPromptResultResponse struct {
	Prompt SendPromptResultPayload `json:"prompt"`
}

SendPromptResultResponse wraps non-streaming busy-input prompt outcomes.

type SessionActivityHealthPayload

type SessionActivityHealthPayload struct {
	SessionID          string     `json:"session_id"`
	TurnID             string     `json:"turn_id,omitempty"`
	TurnSource         string     `json:"turn_source,omitempty"`
	TurnStartedAt      *time.Time `json:"turn_started_at,omitempty"`
	DeadlineAt         *time.Time `json:"deadline_at,omitempty"`
	LastActivityAt     *time.Time `json:"last_activity_at,omitempty"`
	LastActivityKind   string     `json:"last_activity_kind,omitempty"`
	LastActivityDetail string     `json:"last_activity_detail,omitempty"`
	CurrentTool        string     `json:"current_tool,omitempty"`
	ToolCallID         string     `json:"tool_call_id,omitempty"`
	LastProgressAt     *time.Time `json:"last_progress_at,omitempty"`
	IterationCurrent   int        `json:"iteration_current"`
	IterationMax       int        `json:"iteration_max"`
	IdleSeconds        int64      `json:"idle_seconds"`
	ElapsedSeconds     int64      `json:"elapsed_seconds"`
	ElapsedMS          int64      `json:"elapsed_ms"`
	Status             string     `json:"status"`
	StallState         string     `json:"stall_state,omitempty"`
	StallReason        string     `json:"stall_reason,omitempty"`
}

SessionActivityHealthPayload exposes active runtime supervision state in the observability health response.

type SessionAggregatePayload

type SessionAggregatePayload struct {
	Active   int            `json:"active"`
	Total    int            `json:"total"`
	ByStatus map[string]int `json:"by_status,omitempty"`
	ByBadge  map[string]int `json:"by_badge,omitempty"`
}

SessionAggregatePayload summarizes current session state.

type SessionApprovalResponse

type SessionApprovalResponse struct {
	Outcome          string `json:"outcome"`
	InteractionID    string `json:"interaction_id,omitempty"`
	RequestID        string `json:"request_id"`
	Decision         string `json:"decision"`
	ResolvedDecision string `json:"resolved_decision,omitempty"`
}

SessionApprovalResponse wraps the approve-session success payload.

type SessionAttachPayload

type SessionAttachPayload struct {
	SessionID       string    `json:"session_id"`
	AttachedTo      string    `json:"attached_to"`
	AttachExpiresAt time.Time `json:"attach_expires_at"`
	AttachedAt      time.Time `json:"attached_at"`
}

SessionAttachPayload reports the attach lease acquired by one caller.

type SessionAttachResponse

type SessionAttachResponse struct {
	Session SessionPayload       `json:"session"`
	Attach  SessionAttachPayload `json:"attach"`
}

SessionAttachResponse wraps one explicit session attach lease.

type SessionAttachmentPayload

type SessionAttachmentPayload struct {
	ID        string    `json:"id"`
	Name      string    `json:"name"`
	MIMEType  string    `json:"mime_type"`
	Bytes     int64     `json:"bytes"`
	SHA256    string    `json:"sha256"`
	Kind      string    `json:"kind"`
	Width     int       `json:"width"`
	Height    int       `json:"height"`
	CreatedAt time.Time `json:"created_at"`
}

SessionAttachmentPayload is the metadata returned for one stored session attachment.

func SessionAttachmentPayloadFromRef

func SessionAttachmentPayloadFromRef(ref attachmentspkg.AttachmentRef) SessionAttachmentPayload

SessionAttachmentPayloadFromRef converts store metadata to its API form.

type SessionAttachmentUploadResponse

type SessionAttachmentUploadResponse struct {
	Attachment SessionAttachmentPayload `json:"attachment"`
}

SessionAttachmentUploadResponse is returned after an attachment is stored.

type SessionAttentionEventPayload

type SessionAttentionEventPayload struct {
	SessionID   string                 `json:"session_id"`
	ProfileID   string                 `json:"profile_id"`
	ProfileName string                 `json:"profile_name"`
	WorkspaceID string                 `json:"workspace_id"`
	From        session.Badge          `json:"from"`
	To          session.Badge          `json:"to"`
	Class       session.AttentionClass `json:"class"`
	At          time.Time              `json:"at"`
}

SessionAttentionEventPayload is the post-commit attention edge carried by the catalog stream.

type SessionAttentionSummaryPayload

type SessionAttentionSummaryPayload struct {
	TerminalApprovals []TerminalApprovalCountPayload     `json:"terminal_approvals,omitempty"`
	NeedsYou          int                                `json:"needs_you"`
	Finished          int                                `json:"finished"`
	ByWorkspace       []WorkspaceAttentionSummaryPayload `json:"by_workspace"`
}

SessionAttentionSummaryPayload carries exact operator-wide attention counts.

type SessionBoardCountsPayload

type SessionBoardCountsPayload struct {
	NeedsYou int `json:"needs_you"`
	Working  int `json:"working"`
	Waiting  int `json:"waiting"`
	InReview int `json:"in_review"`
	Done     int `json:"done"`
}

type SessionCatalogEventPayload

type SessionCatalogEventPayload struct {
	ExecutionLocationChanged bool   `json:"execution_location_changed,omitempty"`
	Kind                     string `json:"kind"`
	ProfileID                string `json:"profile_id"`
	ProfileName              string `json:"profile_name"`
	WorkspaceID              string `json:"workspace_id"`
	SessionID                string `json:"session_id"`
}

SessionCatalogEventPayload is a workspace-identified wake signal. Clients must reconcile the authoritative catalog snapshot instead of counting events.

type SessionCatalogFacetsPayload

type SessionCatalogFacetsPayload struct {
	InstancesNeedingAttention int                       `json:"instances_needing_attention"`
	Board                     SessionBoardCountsPayload `json:"board"`
	All                       int                       `json:"all"`
	NeedsYou                  int                       `json:"needs_you"`
	Working                   int                       `json:"working"`
	Finished                  int                       `json:"finished"`
	Idle                      int                       `json:"idle"`
	TerminalApprovals         int                       `json:"terminal_approvals"`
}

SessionCatalogFacetsPayload counts the entire eligible scope, independently of the selected badge and text query used to page visible rows.

type SessionCatalogFacetsResponse

type SessionCatalogFacetsResponse struct {
	ByProfile   []SessionProfileFacetsPayload   `json:"by_profile"`
	Facets      SessionCatalogFacetsPayload     `json:"facets"`
	ByWorkspace []SessionWorkspaceFacetsPayload `json:"by_workspace"`
	// Later counts the scope's sessions parked in Later regardless of the
	// request's `later` filter; omitted when none are parked.
	Later int `json:"later,omitempty"`
}

type SessionCatalogPagePayload

type SessionCatalogPagePayload struct {
	NextCursor string `json:"next_cursor,omitempty"`
	HasMore    bool   `json:"has_more"`
	Total      *int   `json:"total,omitzero"`
	Limit      int    `json:"limit"`
}

SessionCatalogPagePayload preserves exact totals by default. Clients may opt out with skip_total=true to read bounded cursor pages without a catalog count.

type SessionCatalogResponse

type SessionCatalogResponse struct {
	Sessions []SessionPayload          `json:"sessions"`
	Page     SessionCatalogPagePayload `json:"page"`
}

SessionCatalogResponse wraps one bounded public session catalog page.

type SessionChildrenPayload

type SessionChildrenPayload struct {
	Total    int `json:"total"`
	NeedsYou int `json:"needs_you"`
	Working  int `json:"working"`
	Waiting  int `json:"waiting"`
	InReview int `json:"in_review"`
	Done     int `json:"done"`
}

type SessionCommandPayload

type SessionCommandPayload struct {
	ID                string               `json:"id"`
	CanonicalToken    string               `json:"canonical_token"`
	DisplayName       string               `json:"display_name"`
	Description       string               `json:"description"`
	Lane              string               `json:"lane"`
	Source            SessionCommandSource `json:"source"`
	Placements        []string             `json:"placements"`
	InputHint         string               `json:"input_hint,omitempty"`
	Available         bool                 `json:"available"`
	UnavailableReason string               `json:"unavailable_reason,omitempty"`
}

SessionCommandPayload is one command available in a session composer.

type SessionCommandSource

type SessionCommandSource struct {
	Kind   string `json:"kind"`
	ID     string `json:"id,omitempty"`
	Key    string `json:"key,omitempty"`
	Scope  string `json:"scope"`
	Origin string `json:"origin,omitempty"`
}

SessionCommandSource identifies one command owner without exposing filesystem paths.

type SessionCommandsChangedPayload

type SessionCommandsChangedPayload struct {
	SessionID string `json:"session_id"`
	Revision  string `json:"revision"`
}

SessionCommandsChangedPayload invalidates one session command catalog revision.

type SessionCommandsResponse

type SessionCommandsResponse struct {
	Commands []SessionCommandPayload `json:"commands"`
	Revision string                  `json:"revision"`
}

SessionCommandsResponse is the session-scoped command catalog projection.

type SessionCompactRequest

type SessionCompactRequest struct{}

SessionCompactRequest requests one advertised native compaction turn.

type SessionCompactResponse

type SessionCompactResponse struct {
	SessionID string `json:"session_id"`
	PromptID  string `json:"prompt_id"`
	Command   string `json:"command"`
	Status    string `json:"status"`
}

SessionCompactResponse is the experimental compaction acceptance receipt.

type SessionCompactionContextAfterPayload

type SessionCompactionContextAfterPayload struct {
	Used     int64  `json:"used"`
	Size     *int64 `json:"size,omitzero"`
	Sequence int64  `json:"sequence"`
}

SessionCompactionContextAfterPayload is the first experimental occupancy report after a compaction.

type SessionCompactionPayload

type SessionCompactionPayload struct {
	ContextAfter *SessionCompactionContextAfterPayload `json:"context_after,omitzero"`
	TurnID       string                                `json:"turn_id"`
	Sequence     int64                                 `json:"sequence"`
	At           time.Time                             `json:"at"`
	CompactionID string                                `json:"compaction_id"`
	Trigger      string                                `json:"trigger"`
	Status       string                                `json:"status"`
	ContextUsed  *int64                                `json:"context_used,omitzero"`
	ContextSize  *int64                                `json:"context_size,omitzero"`
}

type SessionConfigOptionPayload

type SessionConfigOptionPayload struct {
	ID             string                            `json:"id"`
	Label          string                            `json:"label,omitempty"`
	Description    string                            `json:"description,omitempty"`
	Category       string                            `json:"category,omitempty"`
	Kind           string                            `json:"kind"`
	CurrentValueID string                            `json:"current_value_id,omitempty"`
	CurrentBool    *bool                             `json:"current_bool,omitempty"`
	Values         []SessionConfigOptionValuePayload `json:"values,omitempty"`
}

SessionConfigOptionPayload is one active ACP session config option.

type SessionConfigOptionValuePayload

type SessionConfigOptionValuePayload struct {
	Value       string `json:"value"`
	Label       string `json:"label,omitempty"`
	Description string `json:"description,omitempty"`
	GroupID     string `json:"group_id,omitempty"`
	GroupLabel  string `json:"group_label,omitempty"`
}

SessionConfigOptionValuePayload is one selectable value for an active ACP config option.

type SessionConsumerDegradedPayload

type SessionConsumerDegradedPayload struct {
	SessionID       string `json:"session_id"`
	AfterSequence   int64  `json:"after_sequence"`
	ThroughSequence int64  `json:"through_sequence"`
	Refresh         bool   `json:"refresh"`
}

SessionConsumerDegradedPayload tells the client to catch up from its last delivered cursor.

type SessionContextClearedByPayload

type SessionContextClearedByPayload struct {
	CompactionID string `json:"compaction_id"`
	Sequence     int64  `json:"sequence"`
}

SessionContextClearedByPayload identifies an experimental compaction freshness boundary.

type SessionContextInjectedPayload

type SessionContextInjectedPayload struct {
	Estimate string                     `json:"estimate"`
	Tokens   int64                      `json:"tokens"`
	Stale    bool                       `json:"stale"`
	Rows     []SessionContextRowPayload `json:"rows"`
}

type SessionContextPayload

type SessionContextPayload struct {
	ClearedBy      *SessionContextClearedByPayload `json:"cleared_by,omitzero"`
	State          SessionContextState             `json:"state"`
	Used           *int64                          `json:"used,omitzero"`
	Size           *int64                          `json:"size,omitzero"`
	Ratio          *float64                        `json:"ratio,omitzero"`
	SizeSource     string                          `json:"size_source,omitempty"`
	Stale          *bool                           `json:"stale,omitzero"`
	Sequence       *int64                          `json:"sequence,omitzero"`
	ReportedTurnID string                          `json:"reported_turn_id,omitempty"`
	ReportedAt     *time.Time                      `json:"reported_at,omitempty"`
	Injected       *SessionContextInjectedPayload  `json:"injected,omitzero"`
}

type SessionContextRowPayload

type SessionContextRowPayload struct {
	Key              string    `json:"key"`
	Label            string    `json:"label"`
	Kind             string    `json:"kind"`       // text | binary
	OwnerKind        string    `json:"owner_kind"` // full | startup_opaque
	Bytes            int64     `json:"bytes"`
	Tokens           *int64    `json:"tokens,omitzero"` // absent for binary and startup_opaque
	DeliveredTurnID  string    `json:"delivered_turn_id"`
	DeliverySequence int64     `json:"delivery_sequence"`
	SentAt           time.Time `json:"sent_at"`
	LastSeenTurnID   string    `json:"last_seen_turn_id,omitempty"`
	Unchanged        bool      `json:"unchanged"`
	Stale            bool      `json:"stale"`
	Delivery         string    `json:"delivery,omitempty"`
	HookModified     bool      `json:"hook_modified,omitzero"`
	Name             string    `json:"name,omitempty"`
}

type SessionContextSpanPayload

type SessionContextSpanPayload struct {
	Key          string `json:"key"`
	Kind         string `json:"kind"`
	Bytes        int64  `json:"bytes"`
	Tokens       *int64 `json:"tokens,omitzero"`
	Unchanged    bool   `json:"unchanged"`
	StartupDedup bool   `json:"startup_dedup,omitzero"`
	Delivery     string `json:"delivery,omitempty"`
	HookModified bool   `json:"hook_modified,omitzero"`
	Name         string `json:"name,omitempty"`
}

type SessionContextState

type SessionContextState string
const (
	SessionContextStateReported      SessionContextState = "reported"
	SessionContextStateEstimatedSize SessionContextState = "estimated_size"
	SessionContextStateUnknown       SessionContextState = "unknown"
	SessionContextStateUnavailable   SessionContextState = "unavailable"
	SessionStreamEventUsageChanged                       = "session_usage_changed"
)

type SessionConversationRewindPayload

type SessionConversationRewindPayload struct {
	TranscriptEpoch int64  `json:"transcript_epoch"`
	TargetMessageID string `json:"target_message_id"`
	ArchivedFrom    int64  `json:"archived_from_sequence"`
	ArchivedThrough int64  `json:"archived_through_sequence"`
	ArchivedEvents  int64  `json:"archived_event_count"`
	Generation      int64  `json:"generation"`
	MaxSequence     int64  `json:"max_sequence"`
	DraftText       string `json:"draft_text"`
	Replayed        bool   `json:"replayed"`
}

SessionConversationRewindPayload describes the committed transcript cut.

type SessionConversationRewindRequest

type SessionConversationRewindRequest struct {
	MessageID           string `json:"message_id"`
	IdempotencyKey      string `json:"idempotency_key"`
	ExpectedEpoch       *int64 `json:"expected_epoch"`
	ExpectedGeneration  *int64 `json:"expected_generation"`
	ExpectedMaxSequence *int64 `json:"expected_max_sequence"`
}

SessionConversationRewindRequest carries the durable message identity and transcript fences observed by the caller.

type SessionConversationRewindResponse

type SessionConversationRewindResponse struct {
	Session SessionPayload                   `json:"session"`
	Rewind  SessionConversationRewindPayload `json:"rewind"`
}

SessionConversationRewindResponse returns the restarted session, the new transcript coordinates, and the selected prompt text for composer prefill.

type SessionDerivationPayload

type SessionDerivationPayload struct {
	Kind            store.LineageKind `json:"kind"`
	SourceSessionID string            `json:"source_session_id"`
	Seed            string            `json:"seed"`
	NativeState     string            `json:"native_state,omitempty"`
	NativeForkError string            `json:"native_fork_error,omitempty"`
	FirstPrompt     string            `json:"first_prompt"`
}

SessionDerivationPayload summarizes how a continued or forked session was seeded. It is present only on sessions whose lineage kind is continue or fork.

type SessionDeriveCutPayload

type SessionDeriveCutPayload struct {
	MessageID   string `json:"message_id"`
	TurnID      string `json:"turn_id"`
	TurnSettled bool   `json:"turn_settled"`
}

SessionDeriveCutPayload is the turn-resolved cut of a fork anchor.

type SessionDeriveErrorPayload

type SessionDeriveErrorPayload struct {
	ErrorPayload
	ChildSessionID string `json:"child_session_id,omitempty"`
}

SessionDeriveErrorPayload is a continue/fork error. ChildSessionID is set when the failure happened after the new session was committed (for example its first message could not be admitted): the child exists and can be opened, and a retry with the same idempotency_key returns it instead of creating another.

type SessionDerivePreviewResponse

type SessionDerivePreviewResponse struct {
	MessageCount int `json:"message_count"`
	// SourceMessageCount is the whole source transcript's message count, so a fork cut
	// or a truncated carry reads "k of n".
	SourceMessageCount   int                      `json:"source_message_count"`
	ReplayBytes          int                      `json:"replay_bytes"`
	Truncated            bool                     `json:"truncated"`
	OmittedCount         int                      `json:"omitted_count"`
	SourceTurnInProgress bool                     `json:"source_turn_in_progress"`
	NativeForkPossible   bool                     `json:"native_fork_possible"`
	Cut                  *SessionDeriveCutPayload `json:"cut,omitzero"`
	Transcript           SessionTranscriptFences  `json:"transcript"`
}

SessionDerivePreviewResponse reports what a continue or fork would carry right now.

type SessionDeriveResponse

type SessionDeriveResponse struct {
	Session *SessionPayload       `json:"session,omitzero"`
	Derived SessionDerivedPayload `json:"derived"`
}

SessionDeriveResponse returns the derived session and the derive outcome. Session is omitted when the child was deleted since the recorded derivation.

type SessionDerivedPayload

type SessionDerivedPayload struct {
	Kind                 string `json:"kind"`
	SourceSessionID      string `json:"source_session_id"`
	OriginAgentName      string `json:"origin_agent_name"`
	OriginMessageID      string `json:"origin_message_id,omitempty"`
	ThroughTurnID        string `json:"through_turn_id"`
	Seed                 string `json:"seed"`
	NativeState          string `json:"native_state,omitempty"`
	ACPSessionID         string `json:"acp_session_id,omitempty"`
	NativeForkError      string `json:"native_fork_error,omitempty"`
	ReplayMessageCount   *int   `json:"replay_message_count,omitzero"`
	ReplayBytes          *int   `json:"replay_bytes,omitzero"`
	Truncated            bool   `json:"truncated"`
	OmittedCount         int    `json:"omitted_count"`
	SourceTurnInProgress bool   `json:"source_turn_in_progress"`
	FirstPrompt          string `json:"first_prompt"`
	Replayed             bool   `json:"replayed"`
	ChildDeleted         bool   `json:"child_deleted,omitzero"`
	// ChildSessionID names the derived session; it stays set after the child was deleted.
	ChildSessionID string `json:"child_session_id"`
}

SessionDerivedPayload is the recorded outcome of one continue or fork.

type SessionEnvBindingPayload

type SessionEnvBindingPayload struct {
	Ref      string `json:"ref"`
	Required bool   `json:"required"`
}

SessionEnvBindingPayload contains an authored reference, never its resolved value.

type SessionEventPayload

type SessionEventPayload struct {
	Origin        *PromptOriginMeta `json:"origin,omitzero"`
	ID            string            `json:"id"`
	SessionID     string            `json:"session_id"`
	Sequence      int64             `json:"sequence"`
	TurnID        string            `json:"turn_id"`
	Type          string            `json:"type"`
	AgentName     string            `json:"agent_name"`
	WorkspaceID   string            `json:"workspace_id,omitempty"`
	WorkspacePath string            `json:"workspace_path,omitempty"`
	store.EventCorrelation
	ParentSessionID string                       `json:"parent_session_id,omitempty"`
	RootSessionID   string                       `json:"root_session_id,omitempty"`
	SpawnDepth      int                          `json:"spawn_depth"`
	Content         json.RawMessage              `json:"content"`
	Goal            *GoalPromptMeta              `json:"goal,omitzero"`
	StopReason      store.StopReason             `json:"stop_reason,omitempty"`
	StopDetail      string                       `json:"stop_detail,omitempty"`
	Failure         *SessionFailurePayload       `json:"failure,omitzero"`
	ProviderError   *acp.ProviderErrorDiagnostic `json:"provider_error,omitzero"`
	Timestamp       time.Time                    `json:"timestamp"`
}

SessionEventPayload is the shared session event response payload.

type SessionEventsResponse

type SessionEventsResponse struct {
	Events []SessionEventPayload `json:"events"`
}

SessionEventsResponse wraps the shared session events payload.

type SessionFailureHealthPayload

type SessionFailureHealthPayload struct {
	SessionID       string            `json:"session_id"`
	AgentName       string            `json:"agent_name,omitempty"`
	Provider        string            `json:"provider,omitempty"`
	WorkspaceID     string            `json:"workspace_id,omitempty"`
	State           string            `json:"state,omitempty"`
	FailureKind     store.FailureKind `json:"failure_kind"`
	Summary         string            `json:"summary,omitempty"`
	CrashBundlePath string            `json:"crash_bundle_path,omitempty"`
	UpdatedAt       time.Time         `json:"updated_at"`
}

SessionFailureHealthPayload exposes one compact lifecycle failure health row.

type SessionFailurePayload

type SessionFailurePayload struct {
	Kind            store.FailureKind       `json:"kind"`
	ReasonCode      store.FailureReasonCode `json:"reason_code,omitempty"`
	Summary         string                  `json:"summary,omitempty"`
	CrashBundlePath string                  `json:"crash_bundle_path,omitempty"`
}

SessionFailurePayload is the redacted lifecycle failure diagnostic shared by session read paths, event streams, and health summaries.

type SessionFileEntryPayload

type SessionFileEntryPayload struct {
	// Path is relative to the session's working directory; folder paths end in "/".
	Path string          `json:"path"`
	Name string          `json:"name"`
	Kind SessionFileKind `json:"kind"`
}

SessionFileEntryPayload is one ranked file or folder under a session's working directory.

type SessionFileKind

type SessionFileKind string

SessionFileKind distinguishes files from folders in session file search results.

const (
	SessionFileKindFile   SessionFileKind = "file"
	SessionFileKindFolder SessionFileKind = "folder"
)

type SessionFilesResponse

type SessionFilesResponse struct {
	Entries []SessionFileEntryPayload `json:"entries"`
	// Truncated reports that the working directory exceeded the index cap.
	Truncated bool `json:"truncated"`
}

SessionFilesResponse lists ranked files and folders for the composer mention picker.

type SessionFolderPayload

type SessionFolderPayload struct {
	ID          string `json:"id"`
	WorkspaceID string `json:"workspace_id"`
	ProfileID   string `json:"profile_id"`
	Name        string `json:"name"`
	Position    int    `json:"position"`
	// SessionCount counts the folder's unarchived sessions.
	SessionCount int       `json:"session_count"`
	CreatedAt    time.Time `json:"created_at"`
	UpdatedAt    time.Time `json:"updated_at"`
}

SessionFolderPayload is one named group of sessions in a workspace sidebar.

type SessionFolderResponse

type SessionFolderResponse struct {
	Folder SessionFolderPayload `json:"folder"`
}

SessionFolderResponse returns one created or renamed folder.

type SessionFoldersResponse

type SessionFoldersResponse struct {
	Folders []SessionFolderPayload `json:"folders"`
}

SessionFoldersResponse lists one profile's folders in a workspace in manual order.

type SessionGoalCommandRequest

type SessionGoalCommandRequest struct {
	Operation     SessionGoalOperation           `json:"operation"`
	Objective     string                         `json:"objective,omitempty"`
	ExpectedRunID string                         `json:"expected_run_id,omitempty"`
	Runtime       *PromptRuntimeSelectionPayload `json:"runtime,omitzero"`
}

SessionGoalCommandRequest is the typed ingress contract for Goal control.

func (SessionGoalCommandRequest) Validate

func (r SessionGoalCommandRequest) Validate() error

Validate enforces operation-specific fields before the command reaches the daemon aggregate.

type SessionGoalOperation

type SessionGoalOperation string

SessionGoalOperation is one authenticated structured mutation for a session-origin Goal.

const (
	SessionGoalOperationSet     SessionGoalOperation = "set"
	SessionGoalOperationReplace SessionGoalOperation = "replace"
	SessionGoalOperationStatus  SessionGoalOperation = "status"
	SessionGoalOperationPause   SessionGoalOperation = "pause"
	SessionGoalOperationStop    SessionGoalOperation = "stop"
	SessionGoalOperationResume  SessionGoalOperation = "resume"
	SessionGoalOperationClear   SessionGoalOperation = "clear"
)

type SessionGoalResponse

type SessionGoalResponse struct {
	Goal *GoalSnapshot `json:"goal"`
}

SessionGoalResponse preserves explicit null when no visible Goal exists.

type SessionHealthIneligibilityReason

type SessionHealthIneligibilityReason string

SessionHealthIneligibilityReason is the closed reason for wake-ineligible health rows.

const (
	SessionHealthReasonPromptActive  SessionHealthIneligibilityReason = "session_prompt_active"
	SessionHealthReasonNotAttachable SessionHealthIneligibilityReason = "session_not_attachable"
	SessionHealthReasonUnhealthy     SessionHealthIneligibilityReason = "session_unhealthy"
	SessionHealthReasonStale         SessionHealthIneligibilityReason = "session_health_stale"
	SessionHealthReasonHung          SessionHealthIneligibilityReason = "session_health_hung"
	SessionHealthReasonDead          SessionHealthIneligibilityReason = "session_health_dead"
	SessionHealthReasonUnknown       SessionHealthIneligibilityReason = "session_health_unknown"
)

type SessionHealthPayload

type SessionHealthPayload struct {
	LifecycleState      session.State                    `json:"lifecycle_state,omitempty"`
	Verified            *bool                            `json:"verified,omitempty"`
	Escalated           *bool                            `json:"escalated,omitempty"`
	Attention           string                           `json:"attention,omitempty"`
	SessionID           string                           `json:"session_id"`
	WorkspaceID         string                           `json:"workspace_id"`
	AgentName           string                           `json:"agent_name"`
	State               SessionHealthState               `json:"state"`
	Health              SessionHealthStatus              `json:"health"`
	ActivePrompt        bool                             `json:"active_prompt"`
	Attachable          bool                             `json:"attachable"`
	EligibleForWake     bool                             `json:"eligible_for_wake"`
	IneligibilityReason SessionHealthIneligibilityReason `json:"ineligibility_reason,omitempty"`
	LastActivityAt      *time.Time                       `json:"last_activity_at,omitempty"`
	LastPresenceAt      *time.Time                       `json:"last_presence_at,omitempty"`
	LastError           string                           `json:"last_error,omitempty"`
	UpdatedAt           time.Time                        `json:"updated_at"`
}

SessionHealthPayload is the metadata-only runtime health row for one session.

func SessionHealthPayloadFromDomain

func SessionHealthPayloadFromDomain(health heartbeatpkg.SessionHealth) (SessionHealthPayload, error)

SessionHealthPayloadFromDomain converts daemon-owned session health into the public DTO.

type SessionHealthResponse

type SessionHealthResponse struct {
	Health SessionHealthPayload `json:"health"`
}

SessionHealthResponse wraps one session health read model.

type SessionHealthState

type SessionHealthState string

SessionHealthState describes daemon-owned runtime state for wake eligibility.

const (
	SessionHealthStateIdle      SessionHealthState = "idle"
	SessionHealthStatePrompting SessionHealthState = "prompting"
	SessionHealthStateStopped   SessionHealthState = "stopped"
	SessionHealthStateDetached  SessionHealthState = "detached"
)

func (SessionHealthState) Valid

func (s SessionHealthState) Valid() bool

Valid reports whether the health state is a closed enum member.

func (SessionHealthState) Validate

func (s SessionHealthState) Validate() error

Validate reports an error for values outside the closed health state enum.

type SessionHealthStatus

type SessionHealthStatus string

SessionHealthStatus classifies metadata-only session health.

const (
	SessionHealthHealthy  SessionHealthStatus = "healthy"
	SessionHealthDegraded SessionHealthStatus = "degraded"
	SessionHealthStale    SessionHealthStatus = "stale"
	SessionHealthDead     SessionHealthStatus = "dead"
	SessionHealthUnknown  SessionHealthStatus = "unknown"
)

func (SessionHealthStatus) Valid

func (s SessionHealthStatus) Valid() bool

Valid reports whether the health status is a closed enum member.

func (SessionHealthStatus) Validate

func (s SessionHealthStatus) Validate() error

Validate reports an error for values outside the closed health status enum.

type SessionHistoryResponse

type SessionHistoryResponse struct {
	History []TurnHistoryPayload `json:"history"`
}

SessionHistoryResponse wraps the shared grouped turn history payload.

type SessionInputClearResponse

type SessionInputClearResponse struct {
	Inputs          []SessionInputPayload `json:"inputs"`
	ClearedCount    int                   `json:"cleared_count"`
	QueueGeneration int64                 `json:"queue_generation"`
}

type SessionInputListResponse

type SessionInputListResponse struct {
	Inputs []SessionInputPayload       `json:"inputs"`
	Queue  *SessionQueueSummaryPayload `json:"queue,omitzero"`
}

SessionInputListResponse returns current-generation pending input in dispatch order.

type SessionInputMentionPayload

type SessionInputMentionPayload struct {
	Kind   SessionMentionKind `json:"kind"`
	Token  string             `json:"token"`
	Target string             `json:"target"`
	Label  string             `json:"label"`
	Start  int                `json:"start"`
	End    int                `json:"end"`
}

SessionInputMentionPayload is one verified @-mention on queued input. Target is relative to the session working directory (folders end in "/") or a session id; offsets are UTF-16 code units in Text, end exclusive.

type SessionInputPayload

type SessionInputPayload struct {
	Held             bool                            `json:"held"`
	Origin           *PromptOriginMeta               `json:"origin,omitzero"`
	ID               string                          `json:"id"`
	SessionID        string                          `json:"session_id"`
	OwnerKind        string                          `json:"owner_kind,omitempty"`
	OwnerID          string                          `json:"owner_id,omitempty"`
	MessageID        string                          `json:"message_id,omitempty"`
	IdempotencyKey   string                          `json:"idempotency_key,omitempty"`
	TargetTurnID     string                          `json:"target_turn_id,omitempty"`
	Status           SessionInputStatus              `json:"status"`
	Mode             PromptMode                      `json:"mode"`
	Delivery         PromptDelivery                  `json:"delivery"`
	SteerDelivery    store.SteerDeliveryMode         `json:"steer_delivery,omitempty"`
	Text             string                          `json:"text"`
	QueueGeneration  int64                           `json:"queue_generation"`
	EnqueuedAt       time.Time                       `json:"enqueued_at"`
	Runtime          *PromptRuntimeSelectionPayload  `json:"runtime,omitzero"`
	SkillInvocations []SessionSkillInvocationPayload `json:"skill_invocations,omitempty"`
	Mentions         []SessionInputMentionPayload    `json:"mentions,omitempty"`
	Attachments      []PromptAttachmentRef           `json:"attachments,omitempty"`
	// CoalescedWakes counts the daemon wakes merged into this entry.
	CoalescedWakes int `json:"coalesced_wakes,omitempty"`
}

SessionInputPayload is one durable operator input waiting for session dispatch.

type SessionInputResponse

type SessionInputResponse struct {
	Input SessionInputPayload `json:"input"`
}

SessionInputResponse returns one durable pending input.

type SessionInputStatus

type SessionInputStatus string
const (
	SessionInputQueued      SessionInputStatus = "queued"
	SessionInputDispatching SessionInputStatus = "dispatching"
	SessionInputSent        SessionInputStatus = "sent"
	SessionInputFailed      SessionInputStatus = "failed"
	SessionInputCanceled    SessionInputStatus = "canceled"
)

type SessionInspectResponse

type SessionInspectResponse struct {
	SessionID    string                             `json:"session_id"`
	Health       SessionHealthPayload               `json:"health"`
	WakeState    *HeartbeatWakeStatePayload         `json:"wake_state,omitempty"`
	WakeEvents   []HeartbeatWakeEventPayload        `json:"wake_events,omitempty"`
	PolicyDigest string                             `json:"policy_digest,omitempty"`
	ConfigDigest string                             `json:"config_digest,omitempty"`
	Diagnostics  []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
}

SessionInspectResponse returns detailed health, wake audit, and policy diagnostics.

type SessionInteractionsResponse

type SessionInteractionsResponse struct {
	Interactions []PendingInteractionPayload `json:"interactions"`
}

SessionInteractionsResponse lists restart-durable actionable interactions.

type SessionLaterPayload

type SessionLaterPayload struct {
	ParkedAt time.Time `json:"parked_at"`
	// Reason is the operator's Markdown note; plain text is valid Markdown.
	Reason   string     `json:"reason,omitempty"`
	ReturnAt *time.Time `json:"return_at,omitempty"`
	// PendingMessages counts agent messages queued while the session is parked.
	PendingMessages int `json:"pending_messages"`
}

SessionLaterPayload is the Later state of a parked session.

type SessionLineagePayload

type SessionLineagePayload struct {
	ParentSessionID  string                       `json:"parent_session_id,omitempty"`
	RootSessionID    string                       `json:"root_session_id,omitempty"`
	SpawnDepth       int                          `json:"spawn_depth"`
	SpawnRole        string                       `json:"spawn_role,omitempty"`
	Kind             store.LineageKind            `json:"kind,omitempty"`
	OriginMessageID  string                       `json:"origin_message_id,omitempty"`
	OriginAgentName  string                       `json:"origin_agent_name,omitempty"`
	TTLExpiresAt     *time.Time                   `json:"ttl_expires_at,omitempty"`
	AutoStopOnParent bool                         `json:"auto_stop_on_parent"`
	NotifyCreator    bool                         `json:"notify_creator"`
	SpawnBudget      SpawnBudgetPayload           `json:"spawn_budget"`
	PermissionPolicy SpawnPermissionPolicyPayload `json:"permission_policy"`
}

SessionLineagePayload exposes safe parent/child lineage metadata for spawned sessions.

func NormalizeSessionLineagePayload

func NormalizeSessionLineagePayload(payload *SessionLineagePayload) *SessionLineagePayload

NormalizeSessionLineagePayload returns a lineage payload with stable nested permission arrays.

func SessionLineagePayloadFromStore

func SessionLineagePayloadFromStore(lineage *store.SessionLineage) *SessionLineagePayload

SessionLineagePayloadFromStore converts durable session lineage metadata into the safe public payload used across daemon read surfaces.

type SessionLinkedWorkItem

type SessionLinkedWorkItem struct {
	Repository         string                           `json:"repository"`
	Branch             string                           `json:"branch"`
	PRNumber           int                              `json:"pr_number,omitempty"`
	WorktreeID         string                           `json:"worktree_id,omitempty"`
	WorktreeName       string                           `json:"worktree_name,omitempty"`
	WorktreeRemoved    bool                             `json:"worktree_removed"`
	Provenance         string                           `json:"provenance"`
	RunsHere           bool                             `json:"runs_here"`
	SourceSessionID    string                           `json:"source_session_id,omitempty"`
	SourceSessionTitle string                           `json:"source_session_title,omitempty"`
	PullRequest        *SessionPullRequestPayload       `json:"pull_request"`
	PullRequestLookup  *SessionPullRequestLookupPayload `json:"pull_request_lookup"`
}

type SessionLinkedWorkResponse

type SessionLinkedWorkResponse struct {
	Items []SessionLinkedWorkItem `json:"items"`
}

type SessionLinkedWorkSummary

type SessionLinkedWorkSummary struct {
	PullRequests int                    `json:"pull_requests"`
	Total        int                    `json:"total"`
	NeedsYou     int                    `json:"needs_you"`
	Lead         *SessionLinkedWorkItem `json:"lead,omitempty"`
}

type SessionMentionKind

type SessionMentionKind string

SessionMentionKind is the closed kind vocabulary of verified @-mentions.

const (
	SessionMentionKindFile    SessionMentionKind = "file"
	SessionMentionKindFolder  SessionMentionKind = "folder"
	SessionMentionKindSession SessionMentionKind = "session"
)

type SessionMonitorPayload

type SessionMonitorPayload struct {
	MonitorID   string     `json:"monitor_id"`
	SessionID   string     `json:"session_id"`
	Kind        string     `json:"kind"`
	Description string     `json:"description"`
	TerminalID  string     `json:"terminal_id,omitempty"`
	Until       string     `json:"until,omitempty"`
	Pattern     string     `json:"pattern,omitempty"`
	Branch      string     `json:"branch,omitempty"`
	Status      string     `json:"status"`
	CreatedAt   time.Time  `json:"created_at"`
	DeadlineAt  time.Time  `json:"deadline_at"`
	FiredAt     *time.Time `json:"fired_at,omitempty"`
	Reason      string     `json:"reason,omitempty"`
	ExitCode    *int       `json:"exit_code,omitempty"`
	FireCount   int        `json:"fire_count,omitempty"`
	LastFiredAt *time.Time `json:"last_fired_at,omitempty"`
	// TargetSessionIDs and States define a session monitor.
	TargetSessionIDs []string `json:"target_session_ids,omitempty"`
	States           []string `json:"states,omitempty"`
	// Targets is each target's state when a session monitor fired.
	Targets []SessionMonitorTargetPayload `json:"targets,omitempty"`
}

SessionMonitorPayload is one daemon-owned monitor registered by a session.

func SessionMonitorFromDomain

func SessionMonitorFromDomain(item monitorpkg.Monitor) SessionMonitorPayload

SessionMonitorFromDomain maps one monitor to its wire payload.

func SessionMonitorsFromDomain

func SessionMonitorsFromDomain(items []monitorpkg.Monitor) []SessionMonitorPayload

SessionMonitorsFromDomain maps a monitor list, never returning nil.

type SessionMonitorResponse

type SessionMonitorResponse struct {
	Monitor SessionMonitorPayload `json:"monitor"`
}

SessionMonitorResponse returns one monitor after a mutation.

type SessionMonitorSummaryPayload

type SessionMonitorSummaryPayload struct {
	Active int `json:"active"`
}

SessionMonitorSummaryPayload reports the session's monitors still waiting to wake it. A session whose turn ended but still has active monitors is not done.

func SessionMonitorSummaryFromCount

func SessionMonitorSummaryFromCount(active int) *SessionMonitorSummaryPayload

SessionMonitorSummaryFromCount omits the summary for a session with no active monitors.

type SessionMonitorTargetPayload

type SessionMonitorTargetPayload struct {
	SessionID string `json:"session_id"`
	Name      string `json:"name,omitempty"`
	State     string `json:"state"`
	Matched   bool   `json:"matched"`
}

SessionMonitorTargetPayload is one watched session's state when its monitor fired.

type SessionMonitorsResponse

type SessionMonitorsResponse struct {
	Monitors []SessionMonitorPayload `json:"monitors"`
}

SessionMonitorsResponse lists a session's monitors, active first, newest first.

type SessionOwner

type SessionOwner struct {
	SessionID     string `json:"session_id"`
	WorkspaceID   string `json:"workspace_id"`
	WorkspaceName string `json:"workspace_name"`
}

SessionOwner is the minimal catalog ownership projection for one session. User history has an empty workspace_id and the workspace_name "User".

type SessionPayload

type SessionPayload struct {
	EffectivePermissions     string                               `json:"effective_permissions"`
	PermissionModeDegraded   bool                                 `json:"permission_mode_degraded"`
	LinkedWork               *SessionLinkedWorkSummary            `json:"linked_work,omitempty"`
	InstanceID               string                               `json:"instance_id,omitempty"`
	Diagnostics              []DiagnosticItem                     `json:"diagnostics,omitempty"`
	WorktreeBinding          *session.WorktreeBindingAvailability `json:"worktree_binding,omitempty"`
	Branch                   string                               `json:"branch,omitempty"`
	PullRequest              *SessionPullRequestPayload           `json:"pull_request"`
	PullRequestLookup        *SessionPullRequestLookupPayload     `json:"pull_request_lookup"`
	BoardColumn              session.BoardColumn                  `json:"board_column"`
	ParentTitle              string                               `json:"parent_title,omitempty"`
	WaitingOn                session.WaitingOn                    `json:"waiting_on,omitempty"`
	Children                 *SessionChildrenPayload              `json:"children,omitzero"`
	EffectiveWorkspaceAccess string                               `json:"effective_workspace_access"`
	Scope                    string                               `json:"scope"`
	ReplyWatches             []ReplyWatchPayload                  `json:"reply_watches,omitempty"`
	SubagentSummary          *SubagentSummaryPayload              `json:"subagent_summary,omitzero"`
	ProcessSummary           *SessionProcessSummaryPayload        `json:"process_summary,omitzero"`
	MonitorSummary           *SessionMonitorSummaryPayload        `json:"monitor_summary,omitzero"`
	Queue                    *SessionQueueSummaryPayload          `json:"queue,omitzero"`
	Supervision              *session.SupervisionState            `json:"supervision"`
	BusyInput                *session.BusyInputState              `json:"busy_input,omitzero"`
	ID                       string                               `json:"id"`
	ProfileID                string                               `json:"profile_id"`
	ProfileName              string                               `json:"profile_name"`
	ProfileColor             string                               `json:"profile_color,omitempty"`
	ProfileIcon              string                               `json:"profile_icon,omitempty"`
	ProfileEmoji             string                               `json:"profile_emoji,omitempty"`
	ProfileArchived          bool                                 `json:"profile_archived,omitzero"`
	Name                     string                               `json:"name,omitempty"`
	AgentName                string                               `json:"agent_name"`
	Runtime                  SessionRuntimePayload                `json:"runtime"`
	WorkspaceID              string                               `json:"workspace_id,omitempty"`
	WorkspacePath            string                               `json:"workspace_path,omitempty"`
	WorktreeID               string                               `json:"worktree_id,omitempty"`
	Type                     session.Type                         `json:"type,omitempty"`
	State                    session.State                        `json:"state"`
	Badge                    session.Badge                        `json:"badge"`
	Attachable               bool                                 `json:"attachable"`
	AttachedTo               string                               `json:"attached_to,omitempty"`
	AttachExpiresAt          *time.Time                           `json:"attach_expires_at,omitempty"`
	TranscriptEpoch          int64                                `json:"transcript_epoch,omitzero"`
	AttentionChangedAt       *time.Time                           `json:"attention_changed_at,omitempty"`
	PendingInteractions      []PendingInteractionPayload          `json:"pending_interactions"`
	ArchivedAt               *time.Time                           `json:"archived_at"`
	Later                    *SessionLaterPayload                 `json:"later,omitempty"`
	ReturnedFromLaterAt      *time.Time                           `json:"returned_from_later_at,omitempty"`
	// StopReason is the session-level stop classification, distinct from AgentEventPayload.StopReason.
	StopReason store.StopReason `json:"stop_reason,omitempty"`
	StopCause  string           `json:"stop_cause,omitempty"`
	Attention  string           `json:"attention,omitempty"`
	Verified   *bool            `json:"verified,omitzero"`
	Escalated  *bool            `json:"escalated,omitzero"`
	// StopDetail is the session-level stop context paired with StopReason.
	StopDetail        string                       `json:"stop_detail,omitempty"`
	Failure           *SessionFailurePayload       `json:"failure,omitzero"`
	AvailableCommands []ACPAvailableCommandPayload `json:"available_commands"`
	Activity          *RuntimeActivityPayload      `json:"activity,omitzero"`
	Lineage           *SessionLineagePayload       `json:"lineage,omitzero"`
	Derivation        *SessionDerivationPayload    `json:"derivation,omitzero"`
	// FolderID is the session folder holding this session in catalog list
	// responses; it is omitted for sessions in the workspace root.
	FolderID  string                `json:"folder_id,omitempty"`
	Health    *SessionHealthPayload `json:"health,omitzero"`
	CreatedAt time.Time             `json:"created_at"`
	UpdatedAt time.Time             `json:"updated_at"`
}

type SessionPayloadHealth

type SessionPayloadHealth = SessionHealthPayload

SessionPayloadHealth attaches optional health to session list/read responses when requested.

type SessionPresenceRequest

type SessionPresenceRequest struct {
	Visible bool   `json:"visible"`
	LeaseID string `json:"lease_id,omitempty"`
}

SessionPresenceRequest acquires, renews, or releases one operator presence lease.

type SessionPresenceResponse

type SessionPresenceResponse struct {
	LeaseID string `json:"lease_id"`
}

SessionPresenceResponse identifies a newly acquired presence lease.

type SessionProcessAttribution

type SessionProcessAttribution string

type SessionProcessGroupPayload

type SessionProcessGroupPayload struct {
	SessionID   string                      `json:"session_id"`
	WorkspaceID string                      `json:"workspace_id"`
	Profile     string                      `json:"profile"`
	SessionName string                      `json:"session_name"`
	Orphaned    bool                        `json:"orphaned"`
	Items       []SessionProcessPayload     `json:"items"`
	Trees       []SessionProcessTreePayload `json:"trees,omitempty"`
}

type SessionProcessKind

type SessionProcessKind string

type SessionProcessOutcome

type SessionProcessOutcome string

type SessionProcessPayload

type SessionProcessPayload struct {
	Attribution SessionProcessAttribution `json:"attribution"`
	PID         int                       `json:"pid"`
	PGID        int                       `json:"pgid"`
	StartedAt   time.Time                 `json:"started_at"`
	Kind        SessionProcessKind        `json:"kind"`
	Command     string                    `json:"command"`
	Argv0       string                    `json:"argv0"`
	CWD         string                    `json:"cwd"`
	Ports       []int                     `json:"ports"`
	AgeSeconds  float64                   `json:"age_seconds"`
	CPUPercent  *float64                  `json:"cpu_percent,omitempty"`
	RSSKB       *int64                    `json:"rss_kb,omitempty"`
	ParentAlive bool                      `json:"parent_alive"`
	TerminalID  string                    `json:"terminal_id,omitempty"`
	// TreeID names the process tree this process belongs to; see SessionProcessTreePayload.ID.
	TreeID string `json:"tree_id,omitempty"`
}

type SessionProcessPolicy

type SessionProcessPolicy string
const (
	SessionProcessesKeep      SessionProcessPolicy = "keep"
	SessionProcessesTerminate SessionProcessPolicy = "terminate"
)

type SessionProcessResult

type SessionProcessResult struct {
	PID       int                   `json:"pid"`
	StartedAt time.Time             `json:"started_at"`
	Outcome   SessionProcessOutcome `json:"outcome"`
	Error     string                `json:"error,omitempty"`
}

type SessionProcessSummaryPayload

type SessionProcessSummaryPayload struct {
	Supported  bool  `json:"supported"`
	Background int   `json:"background"`
	Terminals  int   `json:"terminals"`
	Total      int   `json:"total"`
	Ports      []int `json:"ports"`
	// Trees counts the Background and Terminal process trees the session left running; the
	// per-process background and terminals counts stay for compatibility.
	Trees int `json:"trees,omitempty"`
}

type SessionProcessTarget

type SessionProcessTarget struct {
	PID       int       `json:"pid"`
	StartedAt time.Time `json:"started_at"`
}

type SessionProcessTreePayload

type SessionProcessTreePayload struct {
	ID       string                 `json:"id"`
	Kind     SessionProcessKind     `json:"kind"`
	Root     SessionProcessTarget   `json:"root"`
	Lead     SessionProcessTarget   `json:"lead"`
	Wrappers []SessionProcessTarget `json:"wrappers"`
	Members  []SessionProcessTarget `json:"members"`
	Ports    []int                  `json:"ports"`
}

SessionProcessTreePayload is one logical thing a session started: its root, the lead process that names it, the wrappers that launched the lead, and every member a stop signals.

type SessionProcessesResponse

type SessionProcessesResponse struct {
	Supported bool                        `json:"supported"`
	ScannedAt time.Time                   `json:"scanned_at"`
	Items     []SessionProcessPayload     `json:"items"`
	Trees     []SessionProcessTreePayload `json:"trees,omitempty"`
}

type SessionProfileFacetsPayload

type SessionProfileFacetsPayload struct {
	ProfileID string                      `json:"profile_id"`
	Facets    SessionCatalogFacetsPayload `json:"facets"`
}

type SessionPromptCancelResponse

type SessionPromptCancelResponse struct {
	SessionID string `json:"session_id"`
	Outcome   string `json:"outcome"`
	TurnID    string `json:"turn_id,omitempty"`
}

SessionPromptCancelResponse reports the idempotent prompt cancellation result.

type SessionProviderOptionPayload

type SessionProviderOptionPayload struct {
	Name            string                  `json:"name"`
	DisplayName     string                  `json:"display_name,omitempty"`
	Harness         string                  `json:"harness,omitempty"`
	RuntimeProvider string                  `json:"runtime_provider,omitempty"`
	RuntimeStrategy ProviderRuntimeStrategy `json:"runtime_strategy,omitempty"`
	// RuntimeLiveApply is omitted when runtime changes wait for the next prompt's process.
	RuntimeLiveApply ProviderRuntimeLiveApply `json:"runtime_live_apply,omitempty"`
	AuthMode         string                   `json:"auth_mode,omitempty"`
	EnvPolicy        string                   `json:"env_policy,omitempty"`
	HomePolicy       string                   `json:"home_policy,omitempty"`
}

SessionProviderOptionPayload is one workspace-visible session provider option.

type SessionPullRequestChecksPayload

type SessionPullRequestChecksPayload struct {
	State       session.ChecksState `json:"state"`
	Passed      int                 `json:"passed"`
	Failed      int                 `json:"failed"`
	Pending     int                 `json:"pending"`
	FailedNames []string            `json:"failed_names"`
}

type SessionPullRequestErrorPayload

type SessionPullRequestErrorPayload struct {
	ErrorPayload
	Message string `json:"message"`
	Cause   string `json:"cause,omitempty"`
}

SessionPullRequestErrorPayload keeps the common CLI error while exposing the refresh-specific cause and message to structured clients.

type SessionPullRequestLookupPayload

type SessionPullRequestLookupPayload struct {
	State      session.LookupState `json:"state"`
	Cause      string              `json:"cause"`
	ObservedAt *time.Time          `json:"observed_at"`
	Stale      bool                `json:"stale"`
}

type SessionPullRequestPayload

type SessionPullRequestPayload struct {
	Title          string                          `json:"title,omitempty"`
	Provider       string                          `json:"provider"`
	Number         int                             `json:"number"`
	URL            string                          `json:"url"`
	State          session.PullRequestState        `json:"state"`
	Draft          *bool                           `json:"draft"`
	HeadSHA        string                          `json:"head_sha"`
	Checks         SessionPullRequestChecksPayload `json:"checks"`
	ReviewDecision session.ReviewDecision          `json:"review_decision"`
	Mergeable      session.Mergeable               `json:"mergeable"`
	ReadyToMerge   bool                            `json:"ready_to_merge"`
}

type SessionPullRequestResponse

type SessionPullRequestResponse struct {
	SessionID         string                           `json:"session_id"`
	Branch            string                           `json:"branch"`
	PullRequest       *SessionPullRequestPayload       `json:"pull_request"`
	PullRequestLookup *SessionPullRequestLookupPayload `json:"pull_request_lookup"`
}

type SessionQueueSummaryPayload

type SessionQueueSummaryPayload struct {
	Entries int `json:"entries"`
	Cap     int `json:"cap"`
}

SessionQueueSummaryPayload exposes the daemon's current admission capacity. Entries counts every pending row; Cap bounds operator input, whose pool excludes agent messages and daemon wakes.

type SessionRecapResponse

type SessionRecapResponse struct {
	Recap RecapPayload `json:"recap"`
}

SessionRecapResponse wraps one deterministic session recap.

type SessionRepairActionPayload

type SessionRepairActionPayload struct {
	Code       string `json:"code"`
	TurnID     string `json:"turn_id"`
	EventID    string `json:"event_id,omitempty"`
	ToolCallID string `json:"tool_call_id,omitempty"`
	ToolName   string `json:"tool_name,omitempty"`
	Persisted  bool   `json:"persisted"`
}

SessionRepairActionPayload is one append-only repair action.

type SessionRepairIssuePayload

type SessionRepairIssuePayload struct {
	Code     string `json:"code"`
	Severity string `json:"severity"`
	TurnID   string `json:"turn_id,omitempty"`
	EventID  string `json:"event_id,omitempty"`
	Detail   string `json:"detail,omitempty"`
}

SessionRepairIssuePayload is one inconsistency found during session repair.

type SessionRepairPayload

type SessionRepairPayload struct {
	SessionID string                       `json:"session_id"`
	Issues    []SessionRepairIssuePayload  `json:"issues"`
	Actions   []SessionRepairActionPayload `json:"actions"`
	Persisted bool                         `json:"persisted"`
}

SessionRepairPayload reports one dry-run or persisted session repair pass.

type SessionRepairResponse

type SessionRepairResponse struct {
	Repair SessionRepairPayload `json:"repair"`
}

SessionRepairResponse wraps the repair report for one session.

type SessionResponse

type SessionResponse struct {
	Session SessionPayload `json:"session"`
}

SessionResponse wraps one shared session payload.

type SessionRuntimePayload

type SessionRuntimePayload struct {
	Status            session.RuntimeStatus             `json:"status"`
	Transition        session.RuntimeTransitionStrategy `json:"transition,omitempty"`
	Failure           string                            `json:"failure,omitempty"`
	Generation        int64                             `json:"generation,omitempty"`
	Recovery          *SessionRuntimeRecoveryPayload    `json:"recovery,omitempty"`
	Selected          *PromptRuntimeSelectionPayload    `json:"selected,omitempty"`
	SelectionRevision int64                             `json:"selection_revision"`
	Effective         *RuntimeSelectionPayload          `json:"effective,omitempty"`
	// Requested preserves binding intent when the provider reports a different effective value.
	Requested *PromptRuntimeSelectionPayload `json:"requested,omitempty"`
	// LastKnown preserves the recorded runtime identity independently of the current ACP binding.
	LastKnown    *RuntimeSelectionPayload `json:"last_known,omitempty"`
	ACPSessionID string                   `json:"acp_session_id,omitempty"`
	ACPCaps      *ACPCapsPayload          `json:"acp_caps,omitempty"`
}

SessionRuntimePayload reports the current ACP binding and its effective runtime.

type SessionRuntimeRecoveryPayload

type SessionRuntimeRecoveryPayload struct {
	Attempt       int        `json:"attempt"`
	MaxAttempts   int        `json:"max_attempts"`
	Generation    int64      `json:"generation"`
	StartedAt     time.Time  `json:"started_at"`
	LastAttemptAt time.Time  `json:"last_attempt_at"`
	NextAttemptAt *time.Time `json:"next_attempt_at,omitempty"`
	LastError     string     `json:"last_error,omitempty"`
}

SessionRuntimeRecoveryPayload reports bounded automatic recovery progress.

type SessionSkillInvocationPayload

type SessionSkillInvocationPayload struct {
	CommandID string               `json:"command_id"`
	Token     string               `json:"token"`
	Name      string               `json:"name"`
	Source    SessionCommandSource `json:"source"`
	Start     int                  `json:"start"`
	End       int                  `json:"end"`
}

SessionSkillInvocationPayload identifies one admitted inline skill marker.

type SessionSoulRefreshRequest

type SessionSoulRefreshRequest struct {
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

SessionSoulRefreshRequest refreshes an idle session Soul snapshot through body-level CAS.

type SessionStatusResponse

type SessionStatusResponse struct {
	Diagnostics         []DiagnosticItem                 `json:"diagnostics,omitempty"`
	ReplyWatches        []ReplyWatchPayload              `json:"reply_watches,omitempty"`
	Queue               *SessionQueueSummaryPayload      `json:"queue,omitempty"`
	LifecycleState      session.State                    `json:"lifecycle_state,omitempty"`
	Verified            *bool                            `json:"verified,omitempty"`
	Escalated           *bool                            `json:"escalated,omitempty"`
	Attention           string                           `json:"attention,omitempty"`
	SessionID           string                           `json:"session_id"`
	WorkspaceID         string                           `json:"workspace_id"`
	AgentName           string                           `json:"agent_name"`
	State               SessionHealthState               `json:"state"`
	Badge               session.Badge                    `json:"badge"`
	Health              SessionHealthStatus              `json:"health"`
	ActivePrompt        bool                             `json:"active_prompt"`
	Attachable          bool                             `json:"attachable"`
	EligibleForWake     bool                             `json:"eligible_for_wake"`
	IneligibilityReason SessionHealthIneligibilityReason `json:"ineligibility_reason,omitempty"`
	WakeState           *HeartbeatWakeStatePayload       `json:"wake_state,omitempty"`
	PendingInteractions []PendingInteractionPayload      `json:"pending_interactions"`
	// Lineage is present for every parented session (provenance, recovery, spawn,
	// continue, fork); Derivation only for continued or forked sessions.
	Lineage    *SessionLineagePayload    `json:"lineage,omitempty"`
	Derivation *SessionDerivationPayload `json:"derivation,omitempty"`
	UpdatedAt  time.Time                 `json:"updated_at"`
}

SessionStatusResponse returns compact session status plus wake eligibility.

type SessionStopPayload

type SessionStopPayload struct {
	SessionID    string            `json:"session_id"`
	Status       string            `json:"status"`
	State        session.State     `json:"state"`
	Verified     bool              `json:"verified"`
	Escalated    bool              `json:"escalated"`
	StopCause    string            `json:"stop_cause,omitempty"`
	Phase        session.StopPhase `json:"phase,omitempty"`
	StoppedAfter string            `json:"stopped_after,omitempty"`
	Attention    string            `json:"attention,omitempty"`
}

SessionStopPayload reports acceptance or the settled termination outcome.

type SessionTranscriptFences

type SessionTranscriptFences struct {
	Epoch       int64 `json:"epoch"`
	Generation  int64 `json:"generation"`
	MaxSequence int64 `json:"max_sequence"`
}

SessionTranscriptFences are the transcript coordinates a derive snapshot was taken at.

type SessionTranscriptOutlineResponse

type SessionTranscriptOutlineResponse = transcript.OutlineResult

SessionTranscriptOutlineResponse is the full retained operator-message trail.

type SessionTranscriptResponse

type SessionTranscriptResponse struct {
	Entries            []transcript.Entry `json:"entries"`
	Epoch              int64              `json:"epoch"`
	Generation         int64              `json:"generation"`
	MaxSequence        int64              `json:"max_sequence"`
	HasOlder           bool               `json:"has_older"`
	NextBeforeSequence int64              `json:"next_before_sequence,omitzero"`
	Limit              int                `json:"limit"`
}

SessionTranscriptResponse wraps one bounded chronological transcript page.

type SessionTranscriptSearchResponse

type SessionTranscriptSearchResponse = transcript.SearchResult

SessionTranscriptSearchResponse is the bounded full-history search result.

type SessionTurnInjectedPayload

type SessionTurnInjectedPayload struct {
	Estimate string                      `json:"estimate"`
	Tokens   int64                       `json:"tokens"`
	Sequence int64                       `json:"sequence"`
	SentAt   time.Time                   `json:"sent_at"`
	Spans    []SessionContextSpanPayload `json:"spans"`
}

type SessionUsageChangedPayload

type SessionUsageChangedPayload struct {
	Sequence int64  `json:"sequence"`
	TurnID   string `json:"turn_id,omitempty"`
	Kind     string `json:"kind"`
}

type SessionUsagePayload

type SessionUsagePayload struct {
	WorkTime         *SessionWorkTimePayload `json:"work_time,omitzero"`
	CacheReadTokens  *int64                  `json:"cache_read_tokens,omitzero"`
	CacheWriteTokens *int64                  `json:"cache_write_tokens,omitzero"`
	Context          SessionContextPayload   `json:"context"`
	InputTokens      *int64                  `json:"input_tokens,omitzero"`
	OutputTokens     *int64                  `json:"output_tokens,omitzero"`
	TotalTokens      *int64                  `json:"total_tokens,omitzero"`
	TotalCost        *float64                `json:"total_cost,omitzero"`
	CostCurrency     string                  `json:"cost_currency,omitempty"`
	CostStatus       CostStatus              `json:"cost_status,omitempty"`
	CostSource       CostSource              `json:"cost_source,omitempty"`
	TurnCount        int64                   `json:"turn_count"`
}

SessionUsagePayload is the aggregated per-session token-usage summary sourced from the daemon's authoritative token-stats aggregate. Pointer metrics remain absent when the runtime has no truthful value.

type SessionUsageResponse

type SessionUsageResponse struct {
	Usage SessionUsagePayload `json:"usage"`
}

SessionUsageResponse wraps the aggregated token-usage summary for one session.

type SessionUsageTurnPayload

type SessionUsageTurnPayload struct {
	TurnID   string                      `json:"turn_id"`
	Sequence int64                       `json:"sequence"`
	Usage    *TokenUsagePayload          `json:"usage,omitzero"`
	Injected *SessionTurnInjectedPayload `json:"injected,omitzero"`
}

type SessionUsageTurnsResponse

type SessionUsageTurnsResponse struct {
	Turns       []SessionUsageTurnPayload  `json:"turns"`
	Compactions []SessionCompactionPayload `json:"compactions"`
}

type SessionWaitRequest

type SessionWaitRequest struct {
	Until     []string `json:"until,omitempty"`
	TimeoutMS int64    `json:"timeout_ms"`
	Epoch     int64    `json:"epoch,omitzero"`
	ResumeID  string   `json:"resume_id,omitempty"`
}

SessionWaitRequest starts or resumes one bounded session badge wait.

type SessionWaitResponse

type SessionWaitResponse struct {
	SessionID string   `json:"session_id"`
	Outcome   string   `json:"outcome"`
	State     string   `json:"state,omitempty"`
	WaitedMS  int64    `json:"waited_ms"`
	Until     []string `json:"until,omitempty"`
	Revision  int64    `json:"revision"`
	ResumeID  string   `json:"resume_id,omitempty"`
}

SessionWaitResponse reports one bounded wait outcome and its catalog fence.

type SessionWorkLinkRequest

type SessionWorkLinkRequest struct {
	Repository string `json:"repository,omitempty"`
	Branch     string `json:"branch"`
	PRNumber   int    `json:"pr_number,omitempty"`
}

type SessionWorkTimePayload

type SessionWorkTimePayload struct {
	ActiveDurationMS    int64  `json:"active_duration_ms"`
	TurnCount           int64  `json:"turn_count"`
	LastCompletedTurnID string `json:"last_completed_turn_id,omitempty"`
}

SessionWorkTimePayload sums this session's settled delivery-to-terminal intervals, excluding idle gaps.

type SessionWorkspaceFacetsPayload

type SessionWorkspaceFacetsPayload struct {
	WorkspaceID string                      `json:"workspace_id"`
	Facets      SessionCatalogFacetsPayload `json:"facets"`
}

type SessionsResponse

type SessionsResponse struct {
	Sessions []SessionPayload `json:"sessions"`
}

SessionsResponse wraps the shared session list payload.

type SetExtensionEnablementRequest

type SetExtensionEnablementRequest struct {
	Profile string `json:"profile"`
	Enabled bool   `json:"enabled"`
}

SetExtensionEnablementRequest changes one profile-specific exception state.

type SetExtensionSecretsRequest

type SetExtensionSecretsRequest struct {
	Bindings []ExtensionSecretBindingInput `json:"bindings"`
}

SetExtensionSecretsRequest updates one or more declared environment bindings.

type SetSessionParentRequest

type SetSessionParentRequest struct {
	ParentSessionID string `json:"parent_session_id"`
}

SetSessionParentRequest adopts a parentless user session as a provenance child of another user session in the same workspace and profile.

type SetSessionRuntimeRequest

type SetSessionRuntimeRequest struct {
	Runtime          PromptRuntimeSelectionPayload `json:"runtime"`
	ExpectedRevision *int64                        `json:"expected_revision"`
}

SetSessionRuntimeRequest durably selects the default runtime for future prompts.

type SetTaskExecutionProfileRequest

type SetTaskExecutionProfileRequest = taskpkg.ExecutionProfile

SetTaskExecutionProfileRequest captures one profile replacement request.

type SetTaskWorktreePolicyRequest

type SetTaskWorktreePolicyRequest = taskpkg.WorktreePolicy

SetTaskWorktreePolicyRequest captures one worktree-only profile patch.

type SettingsActionMetadataPayload

type SettingsActionMetadataPayload struct {
	Name      string                   `json:"name"`
	Available bool                     `json:"available"`
	Behavior  SettingsMutationBehavior `json:"behavior"`
}

type SettingsAgentScopeKind

type SettingsAgentScopeKind string
const (
	SettingsAgentScopeUser  SettingsAgentScopeKind = "user"
	SettingsAgentScopeAgent SettingsAgentScopeKind = "agent"
)

type SettingsApplyFailurePayload

type SettingsApplyFailurePayload struct {
	Subsystem  string         `json:"subsystem"`
	Diagnostic DiagnosticItem `json:"diagnostic"`
}

type SettingsApplyLifecycle

type SettingsApplyLifecycle string
const (
	SettingsApplyLifecycleLive               SettingsApplyLifecycle = "live"
	SettingsApplyLifecycleLiveAdd            SettingsApplyLifecycle = "live-add"
	SettingsApplyLifecycleLiveRemoveIfUnused SettingsApplyLifecycle = "live-remove-if-unused"
	SettingsApplyLifecycleRestartRequired    SettingsApplyLifecycle = "restart-required"
	SettingsApplyLifecycleSessionRebind      SettingsApplyLifecycle = "session-rebind"
)

type SettingsApplyNextAction

type SettingsApplyNextAction string
const (
	SettingsApplyNextActionNone          SettingsApplyNextAction = "none"
	SettingsApplyNextActionRestartDaemon SettingsApplyNextAction = "restart-daemon"
	SettingsApplyNextActionNewSession    SettingsApplyNextAction = "new-session"
	SettingsApplyNextActionRetry         SettingsApplyNextAction = "retry"
)

type SettingsApplyResponse

type SettingsApplyResponse struct {
	Section          SettingsApplyTargetName       `json:"section,omitempty"`
	Scope            SettingsScopeKind             `json:"scope,omitempty"`
	WriteTarget      SettingsWriteTargetKind       `json:"write_target,omitempty"`
	WorkspaceID      string                        `json:"workspace_id,omitempty"`
	Profile          string                        `json:"profile,omitempty"`
	AgentName        string                        `json:"agent_name,omitempty"`
	Applied          bool                          `json:"applied"`
	Lifecycle        SettingsApplyLifecycle        `json:"lifecycle"`
	ApplyRecordID    string                        `json:"apply_record_id"`
	ActiveGeneration int64                         `json:"active_generation"`
	ActiveConfigHash string                        `json:"active_config_hash"`
	NextAction       SettingsApplyNextAction       `json:"next_action"`
	RestartRequired  bool                          `json:"restart_required,omitzero"`
	RestartScope     string                        `json:"restart_scope,omitempty"`
	Warnings         []string                      `json:"warnings,omitempty"`
	PartialFailures  []SettingsApplyFailurePayload `json:"partial_failures,omitempty"`
	Skipped          bool                          `json:"skipped,omitzero"`
	SkippedReason    string                        `json:"skipped_reason,omitempty"`
}

type SettingsApplyTargetName

type SettingsApplyTargetName string
const (
	SettingsApplyTargetGeneral    SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionGeneral)
	SettingsApplyTargetPersona    SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionPersona)
	SettingsApplyTargetRoles      SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionRoles)
	SettingsApplyTargetSkills     SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionSkills)
	SettingsApplyTargetAutomation SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionAutomation)

	SettingsApplyTargetWindowManager   SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionWindowManager)
	SettingsApplyTargetCmdPalette      SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionCmdPalette)
	SettingsApplyTargetAttention       SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionAttention)
	SettingsApplyTargetShell           SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionShell)
	SettingsApplyTargetProviderUsage   SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionProviderUsage)
	SettingsApplyTargetObservability   SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionObservability)
	SettingsApplyTargetHooksExtensions SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionHooksExtensions)
	SettingsApplyTargetMarketplace     SettingsApplyTargetName = SettingsApplyTargetName(SettingsSectionMarketplace)
	SettingsApplyTargetProviders       SettingsApplyTargetName = SettingsApplyTargetName(SettingsCollectionProviders)
	SettingsApplyTargetMCPServers      SettingsApplyTargetName = SettingsApplyTargetName(SettingsCollectionMCPServers)

	SettingsApplyTargetHooks SettingsApplyTargetName = SettingsApplyTargetName(SettingsCollectionHooks)
)

type SettingsAttentionPayload

type SettingsAttentionPayload struct {
	Toasts          bool     `json:"toasts"`
	Sound           bool     `json:"sound"`
	System          bool     `json:"system"`
	MutedWorkspaces []string `json:"muted_workspaces"`
}

SettingsAttentionPayload is the stable operator attention settings contract.

type SettingsAttentionResponse

type SettingsAttentionResponse struct {
	SettingsLayeredSectionResponseMetaPayload
	Config SettingsAttentionPayload `json:"config"`
}

SettingsAttentionResponse returns global delivery channels plus the selected profile's mutes.

type SettingsAutomationConfigPayload

type SettingsAutomationConfigPayload struct {
	Enabled           bool                            `json:"enabled"`
	Timezone          string                          `json:"timezone"`
	MaxConcurrentJobs int                             `json:"max_concurrent_jobs"`
	DefaultFireLimit  automationmodel.FireLimitConfig `json:"default_fire_limit"`
}

type SettingsAutomationResponse

type SettingsAutomationResponse struct {
	SettingsUserSectionResponseMetaPayload
	Config  SettingsAutomationConfigPayload  `json:"config"`
	Runtime SettingsAutomationRuntimePayload `json:"runtime"`
	Links   []SettingsOperationalLinkPayload `json:"links,omitempty"`
}

type SettingsAutomationRuntimePayload

type SettingsAutomationRuntimePayload struct {
	HostTimezone     string     `json:"host_timezone,omitempty"`
	Available        bool       `json:"available"`
	Running          bool       `json:"running"`
	SchedulerRunning bool       `json:"scheduler_running"`
	JobTotal         int        `json:"job_total"`
	JobEnabled       int        `json:"job_enabled"`
	TriggerTotal     int        `json:"trigger_total"`
	TriggerEnabled   int        `json:"trigger_enabled"`
	NextFire         *time.Time `json:"next_fire,omitempty"`
	LastSyncedAt     *time.Time `json:"last_synced_at,omitempty"`
}

type SettingsBusyInputPayload

type SettingsBusyInputPayload struct {
	DefaultMode string `json:"default_mode"`
}

type SettingsCmdPaletteResponse

type SettingsCmdPaletteResponse struct {
	SettingsLayeredSectionResponseMetaPayload
	FallbackAgentEnabled bool              `json:"fallback_agent_enabled"`
	Personalization      bool              `json:"personalization"`
	Aliases              map[string]string `json:"aliases"`
}

type SettingsCollectionName

type SettingsCollectionName string
const (
	SettingsCollectionProviders  SettingsCollectionName = "providers"
	SettingsCollectionMCPServers SettingsCollectionName = "mcp-servers"

	SettingsCollectionHooks SettingsCollectionName = "hooks"
)

type SettingsConfigPathsPayload

type SettingsConfigPathsPayload struct {
	HomeDir          string `json:"home_dir"`
	GlobalConfig     string `json:"global_config"`
	GlobalMCPSidecar string `json:"global_mcp_sidecar"`
	LogFile          string `json:"log_file"`
	DaemonInfo       string `json:"daemon_info"`
}

type SettingsCoordinatorRoleConfigPayload

type SettingsCoordinatorRoleConfigPayload struct {
	SettingsRoleConfigPayload
	TTL                           string `json:"ttl"`
	MaxChildren                   int    `json:"max_children"`
	MaxActiveSessionsPerWorkspace int    `json:"max_active_sessions_per_workspace"`
}

type SettingsDaemonPayload

type SettingsDaemonPayload struct {
	Socket               string                              `json:"socket"`
	MemoryReportInterval string                              `json:"memory_report_interval"`
	ReloadTimeouts       SettingsDaemonReloadTimeoutsPayload `json:"reload_timeouts"`
}

type SettingsDaemonReloadTimeoutsPayload

type SettingsDaemonReloadTimeoutsPayload struct {
	Providers string `json:"providers"`
	MCP       string `json:"mcp"`
}

type SettingsDaemonRuntimePayload

type SettingsDaemonRuntimePayload struct {
	Available      bool       `json:"available"`
	Status         string     `json:"status,omitempty"`
	PID            int        `json:"pid,omitzero"`
	StartedAt      *time.Time `json:"started_at,omitempty"`
	UptimeSeconds  int64      `json:"uptime_seconds"`
	Socket         string     `json:"socket,omitempty"`
	HTTPHost       string     `json:"http_host,omitempty"`
	HTTPPort       int        `json:"http_port,omitzero"`
	ActiveSessions int        `json:"active_sessions"`
	ActiveAgents   int        `json:"active_agents"`
	TotalSessions  int        `json:"total_sessions"`
	Version        string     `json:"version,omitempty"`
}

type SettingsDefaultsPayload

type SettingsDefaultsPayload struct {
	Agent    string `json:"agent"`
	Provider string `json:"provider,omitempty"`
	// Model and ReasoningEffort refine Provider for sessions that do not pick a
	// runtime; both require Provider. Omitted means the provider's own default.
	Model           string `json:"model,omitempty"`
	ReasoningEffort string `json:"reasoning_effort,omitempty"`
}

type SettingsExtensionDevPayload

type SettingsExtensionDevPayload struct {
	WatchInterval string `json:"watch_interval"`
}

type SettingsExtensionGitHubSourcePayload

type SettingsExtensionGitHubSourcePayload struct {
	Enabled bool   `json:"enabled"`
	BaseURL string `json:"base_url"`
}

type SettingsExtensionGitSourcePayload

type SettingsExtensionGitSourcePayload struct {
	Enabled bool `json:"enabled"`
}

type SettingsExtensionRateLimitPayload

type SettingsExtensionRateLimitPayload struct {
	Requests int    `json:"requests"`
	Window   string `json:"window"`
	Queue    int    `json:"queue"`
}

type SettingsExtensionResourcesPayload

type SettingsExtensionResourcesPayload struct {
	AllowedKinds           []string                          `json:"allowed_kinds,omitempty"`
	MaxScope               resources.ResourceScopeKind       `json:"max_scope,omitempty"`
	SnapshotRateLimit      SettingsExtensionRateLimitPayload `json:"snapshot_rate_limit"`
	OperatorWriteRateLimit SettingsExtensionRateLimitPayload `json:"operator_write_rate_limit"`
}

type SettingsExtensionSourcesPayload

type SettingsExtensionSourcesPayload struct {
	GitHub SettingsExtensionGitHubSourcePayload `json:"github"`
	Git    SettingsExtensionGitSourcePayload    `json:"git"`
}

type SettingsExtensionTrustPayload

type SettingsExtensionTrustPayload struct {
	AllowUnverified bool `json:"allow_unverified"`
}

type SettingsExtensionsConfigPayload

type SettingsExtensionsConfigPayload struct {
	Trust     SettingsExtensionTrustPayload     `json:"trust"`
	Sources   SettingsExtensionSourcesPayload   `json:"sources"`
	Dev       SettingsExtensionDevPayload       `json:"dev"`
	Resources SettingsExtensionResourcesPayload `json:"resources"`
}

type SettingsGeneralActionsPayload

type SettingsGeneralActionsPayload struct {
	Restart SettingsActionMetadataPayload `json:"restart"`
}

type SettingsGeneralConfigPayload

type SettingsGeneralConfigPayload struct {
	BusyInput   *SettingsBusyInputPayload  `json:"busy_input,omitzero"`
	Limits      SettingsLimitsPayload      `json:"limits"`
	Permissions SettingsPermissionsPayload `json:"permissions"`
	// SessionTimeout is the deprecated mirror of session.limits.timeout, which no
	// session enforces; IdleReleaseAfter replaces it. Removed in v0.5.0.
	SessionTimeout string `json:"session_timeout"`
	// IdleReleaseAfter mirrors session.supervision.idle_release_after. Omitted on
	// update to keep the current value.
	IdleReleaseAfter string                  `json:"idle_release_after,omitempty"`
	HTTP             SettingsHTTPPayload     `json:"http"`
	Daemon           SettingsDaemonPayload   `json:"daemon"`
	Redact           SettingsRedactPayload   `json:"redact"`
	Terminal         SettingsTerminalPayload `json:"terminal"`
}

type SettingsGeneralResponse

type SettingsGeneralResponse struct {
	SettingsUserSectionResponseMetaPayload
	ConfigPaths SettingsConfigPathsPayload    `json:"config_paths"`
	Config      SettingsGeneralConfigPayload  `json:"config"`
	Runtime     SettingsDaemonRuntimePayload  `json:"runtime"`
	Actions     SettingsGeneralActionsPayload `json:"actions"`
}

type SettingsGlobalShortcutPayload

type SettingsGlobalShortcutPayload struct {
	CommandID     string                       `json:"command_id"`
	IntendedChord string                       `json:"intended_chord"`
	ActiveChord   string                       `json:"active_chord,omitempty"`
	Status        SettingsGlobalShortcutStatus `json:"status,omitempty"`
	Reason        string                       `json:"reason,omitempty"`
	SettingsURL   string                       `json:"settings_url,omitempty"`
}

type SettingsGlobalShortcutStatus

type SettingsGlobalShortcutStatus string
const (
	SettingsGlobalShortcutRegistered       SettingsGlobalShortcutStatus = "registered"
	SettingsGlobalShortcutFailedInUse      SettingsGlobalShortcutStatus = "failed_in_use"
	SettingsGlobalShortcutFailedPermission SettingsGlobalShortcutStatus = "failed_permission"
	SettingsGlobalShortcutUnsupported      SettingsGlobalShortcutStatus = "unsupported"
)

type SettingsHTTPPayload

type SettingsHTTPPayload struct {
	Host string `json:"host"`
	Port int    `json:"port"`
}

type SettingsHookDeclarationPayload

type SettingsHookDeclarationPayload struct {
	Name         string                    `json:"name"`
	Event        hookspkg.HookEvent        `json:"event"`
	Mode         hookspkg.HookMode         `json:"mode,omitempty"`
	Required     bool                      `json:"required,omitzero"`
	Enabled      *bool                     `json:"enabled,omitzero"`
	Priority     int                       `json:"priority,omitzero"`
	Timeout      string                    `json:"timeout,omitempty"`
	Matcher      hookspkg.HookMatcher      `json:"matcher"`
	ExecutorKind hookspkg.HookExecutorKind `json:"executor_kind,omitempty"`
	Command      string                    `json:"command,omitempty"`
	Args         []string                  `json:"args,omitempty"`
	Env          map[string]string         `json:"env,omitempty"`
	SecretEnv    map[string]string         `json:"secret_env,omitempty"`
	Metadata     map[string]string         `json:"metadata,omitempty"`
}

type SettingsHookItemPayload

type SettingsHookItemPayload struct {
	Name           string                         `json:"name"`
	Declaration    SettingsHookDeclarationPayload `json:"declaration"`
	SourceMetadata SettingsSourceMetadataPayload  `json:"source_metadata"`
}

type SettingsHookResponse

type SettingsHookResponse struct {
	Hook SettingsHookItemPayload `json:"hook"`
}

type SettingsHooksExtensionsResponse

type SettingsHooksExtensionsResponse struct {
	SettingsUserSectionResponseMetaPayload
	Hooks           []SettingsHookItemPayload           `json:"hooks,omitempty"`
	Config          SettingsExtensionsConfigPayload     `json:"config"`
	Installed       []SettingsInstalledExtensionPayload `json:"installed,omitempty"`
	TransportParity SettingsTransportParityPayload      `json:"transport_parity"`
}

type SettingsHooksResponse

type SettingsHooksResponse struct {
	SettingsLayeredCollectionResponseMetaPayload
	Hooks []SettingsHookItemPayload `json:"hooks"`
}

type SettingsInstalledExtensionPaletteCommandPayload

type SettingsInstalledExtensionPaletteCommandPayload struct {
	ID             string   `json:"id"`
	Title          string   `json:"title"`
	Bindings       []string `json:"bindings"`
	DefaultBinding string   `json:"default_binding,omitempty"`
	DefaultDormant bool     `json:"default_dormant"`
	ConflictWith   string   `json:"conflict_with,omitempty"`
	Available      bool     `json:"available"`
	Reason         string   `json:"reason,omitempty"`
}

type SettingsInstalledExtensionPalettePayload

type SettingsInstalledExtensionPalettePayload struct {
	Commands []SettingsInstalledExtensionPaletteCommandPayload `json:"commands"`
	Views    []SettingsInstalledExtensionPaletteViewPayload    `json:"views"`
}

type SettingsInstalledExtensionPaletteViewPayload

type SettingsInstalledExtensionPaletteViewPayload struct {
	ID        string `json:"id"`
	Title     string `json:"title"`
	Available bool   `json:"available"`
	Reason    string `json:"reason,omitempty"`
}

type SettingsInstalledExtensionPayload

type SettingsInstalledExtensionPayload struct {
	Name          string                                    `json:"name"`
	Version       string                                    `json:"version,omitempty"`
	Enabled       bool                                      `json:"enabled"`
	State         string                                    `json:"state,omitempty"`
	Health        string                                    `json:"health,omitempty"`
	HealthMessage string                                    `json:"health_message,omitempty"`
	LastError     string                                    `json:"last_error,omitempty"`
	RequiresEnv   []string                                  `json:"requires_env,omitempty"`
	MissingEnv    []string                                  `json:"missing_env,omitempty"`
	Palette       *SettingsInstalledExtensionPalettePayload `json:"palette,omitzero"`
}

type SettingsLayeredCollectionMutationResult

type SettingsLayeredCollectionMutationResult struct {
	Section         SettingsCollectionName   `json:"section"`
	Scope           SettingsLayeredScopeKind `json:"scope"`
	WriteTarget     SettingsWriteTargetKind  `json:"write_target,omitempty"`
	WorkspaceID     string                   `json:"workspace_id,omitempty"`
	Profile         string                   `json:"profile,omitempty"`
	Behavior        SettingsMutationBehavior `json:"behavior"`
	Applied         bool                     `json:"applied"`
	RestartRequired bool                     `json:"restart_required"`
	RestartScope    string                   `json:"restart_scope,omitempty"`
	Warnings        []string                 `json:"warnings,omitempty"`
}

type SettingsLayeredCollectionResponseMetaPayload

type SettingsLayeredCollectionResponseMetaPayload struct {
	Collection      SettingsCollectionName     `json:"collection"`
	Scope           SettingsLayeredScopeKind   `json:"scope"`
	WorkspaceID     string                     `json:"workspace_id,omitempty"`
	Profile         string                     `json:"profile,omitempty"`
	AvailableScopes []SettingsLayeredScopeKind `json:"available_scopes"`
}

type SettingsLayeredScopeKind

type SettingsLayeredScopeKind string
const (
	SettingsLayeredScopeUser      SettingsLayeredScopeKind = "user"
	SettingsLayeredScopeProfile   SettingsLayeredScopeKind = "profile"
	SettingsLayeredScopeWorkspace SettingsLayeredScopeKind = "workspace"
)

type SettingsLayeredSectionMutationResult

type SettingsLayeredSectionMutationResult struct {
	Section         SettingsSectionName      `json:"section"`
	Scope           SettingsLayeredScopeKind `json:"scope"`
	WriteTarget     SettingsWriteTargetKind  `json:"write_target,omitempty"`
	WorkspaceID     string                   `json:"workspace_id,omitempty"`
	Profile         string                   `json:"profile,omitempty"`
	Behavior        SettingsMutationBehavior `json:"behavior"`
	Applied         bool                     `json:"applied"`
	RestartRequired bool                     `json:"restart_required"`
	RestartScope    string                   `json:"restart_scope,omitempty"`
	Warnings        []string                 `json:"warnings,omitempty"`
}

type SettingsLayeredSectionResponseMetaPayload

type SettingsLayeredSectionResponseMetaPayload struct {
	Section         SettingsSectionName        `json:"section"`
	Scope           SettingsLayeredScopeKind   `json:"scope"`
	WorkspaceID     string                     `json:"workspace_id,omitempty"`
	Profile         string                     `json:"profile,omitempty"`
	AvailableScopes []SettingsLayeredScopeKind `json:"available_scopes"`
}

type SettingsLimitsPayload

type SettingsLimitsPayload struct {
	MaxConcurrentAgents int `json:"max_concurrent_agents"`
}

type SettingsLogTailCapabilityPayload

type SettingsLogTailCapabilityPayload struct {
	Available bool                    `json:"available"`
	StreamURL string                  `json:"stream_url,omitempty"`
	Transport SettingsStreamTransport `json:"transport,omitempty"`
}

type SettingsLogTailEventPayload

type SettingsLogTailEventPayload struct {
	Line string `json:"line"`
}

SettingsLogTailEventPayload is the shared SSE payload for daemon log tailing.

type SettingsMCPAuthBeginMode

type SettingsMCPAuthBeginMode string

SettingsMCPAuthBeginMode selects callback delivery for one OAuth session.

const (
	// SettingsMCPAuthBeginModeAutomatic completes through the daemon loopback callback.
	SettingsMCPAuthBeginModeAutomatic SettingsMCPAuthBeginMode = "automatic"
	// SettingsMCPAuthBeginModeManual returns a copy/paste callback without requiring a listener.
	SettingsMCPAuthBeginModeManual SettingsMCPAuthBeginMode = "manual"
)

type SettingsMCPAuthBeginRequest

type SettingsMCPAuthBeginRequest struct {
	Mode                   SettingsMCPAuthBeginMode `json:"mode"`
	ApprovedScopes         []string                 `json:"approved_scopes,omitempty"`
	ApproveScopeEscalation bool                     `json:"approve_scope_escalation,omitzero"`
}

SettingsMCPAuthBeginRequest selects automatic or manual callback delivery.

type SettingsMCPAuthBeginResponse

type SettingsMCPAuthBeginResponse struct {
	AuthorizationURL string    `json:"authorization_url"`
	State            string    `json:"state"`
	ExpiresAt        time.Time `json:"expires_at"`
	CallbackURL      string    `json:"callback_url"`
	ManualSupported  bool      `json:"manual_supported"`
}

SettingsMCPAuthBeginResponse returns the verifier-free PKCE handoff.

type SettingsMCPAuthConfigPayload

type SettingsMCPAuthConfigPayload struct {
	Registration    string   `json:"registration,omitempty"`
	IssuerURL       string   `json:"issuer_url,omitempty"`
	ClientID        string   `json:"client_id,omitempty"`
	ClientSecretRef string   `json:"client_secret_ref,omitempty"`
	Scopes          []string `json:"scopes,omitempty"`
}

type SettingsMCPAuthConfigViewPayload

type SettingsMCPAuthConfigViewPayload struct {
	Registration           string   `json:"registration,omitempty"`
	IssuerURL              string   `json:"issuer_url,omitempty"`
	ClientID               string   `json:"client_id,omitempty"`
	ClientSecretConfigured bool     `json:"client_secret_configured"`
	Scopes                 []string `json:"scopes,omitempty"`
}

SettingsMCPAuthConfigViewPayload is the public, binding-free OAuth configuration projection.

type SettingsMCPAuthExchangeRequest

type SettingsMCPAuthExchangeRequest struct {
	RedirectURL string `json:"redirect_url"`
}

SettingsMCPAuthExchangeRequest completes one login with the full redirect URL.

type SettingsMCPAuthStatusPayload

type SettingsMCPAuthStatusPayload struct {
	ServerName   string     `json:"server_name"`
	Owner        string     `json:"owner"`
	Scope        string     `json:"scope"`
	WorkspaceID  string     `json:"workspace_id,omitempty"`
	Profile      string     `json:"profile,omitempty"`
	Status       string     `json:"status"`
	RemoteURL    string     `json:"remote_url,omitempty"`
	AuthType     string     `json:"auth_type,omitempty"`
	ClientID     string     `json:"client_id,omitempty"`
	Issuer       string     `json:"issuer,omitempty"`
	Scopes       []string   `json:"scopes,omitempty"`
	ExpiresAt    *time.Time `json:"expires_at,omitempty"`
	UpdatedAt    *time.Time `json:"updated_at,omitempty"`
	Refreshable  bool       `json:"refreshable"`
	TokenPresent bool       `json:"token_present"`
	Diagnostic   string     `json:"diagnostic,omitempty"`
	// Inherited is true when the requested scope has no own definition and this record belongs
	// to the broader scope that declares the effective definition and owns its credential.
	Inherited bool `json:"inherited,omitempty"`
}

type SettingsMCPExtensionOverridePayload

type SettingsMCPExtensionOverridePayload struct {
	Env     map[string]string `json:"env,omitempty"`
	Headers map[string]string `json:"headers,omitempty"`
	URL     string            `json:"url,omitempty"`
}

SettingsMCPExtensionOverridePayload exposes only validated non-secret override fields.

type SettingsMCPSecretPreservationPayload

type SettingsMCPSecretPreservationPayload struct {
	SecretEnv         []string `json:"secret_env,omitempty"`
	OAuthClientSecret bool     `json:"oauth_client_secret,omitzero"`
}

SettingsMCPSecretPreservationPayload identifies existing bindings to retain without exposing their refs.

type SettingsMCPSecretValuesPayload

type SettingsMCPSecretValuesPayload struct {
	SecretEnv         map[string]string `json:"secret_env,omitempty"`
	OAuthClientSecret *string           `json:"oauth_client_secret,omitzero"`
}

type SettingsMCPServerItemPayload

type SettingsMCPServerItemPayload struct {
	Owner          string                                 `json:"owner,omitempty"`
	RuntimeName    string                                 `json:"runtime_name,omitempty"`
	Override       *SettingsMCPExtensionOverridePayload   `json:"override,omitzero"`
	Name           string                                 `json:"name"`
	Transport      string                                 `json:"transport"`
	Command        string                                 `json:"command,omitempty"`
	Args           []string                               `json:"args,omitempty"`
	EnvKeys        []string                               `json:"env_keys,omitempty"`
	SecretEnvKeys  []string                               `json:"secret_env_keys,omitempty"`
	URL            string                                 `json:"url,omitempty"`
	Auth           *SettingsMCPAuthConfigViewPayload      `json:"auth,omitzero"`
	AuthStatus     *SettingsMCPAuthStatusPayload          `json:"auth_status,omitzero"`
	RuntimeStatus  *SettingsMCPServerRuntimeStatusPayload `json:"runtime_status,omitzero"`
	Scope          SettingsScopeKind                      `json:"scope"`
	WorkspaceID    string                                 `json:"workspace_id,omitempty"`
	Profile        string                                 `json:"profile,omitempty"`
	CatalogEntry   string                                 `json:"catalog_entry,omitempty"`
	CatalogVersion string                                 `json:"catalog_version,omitempty"`
	SourceMetadata SettingsSourceMetadataPayload          `json:"source_metadata"`
}

type SettingsMCPServerPayload

type SettingsMCPServerPayload struct {
	Headers   map[string]string             `json:"headers,omitempty"`
	Name      string                        `json:"name"`
	Transport string                        `json:"transport,omitempty"`
	Command   string                        `json:"command,omitempty"`
	Args      []string                      `json:"args,omitempty"`
	Env       map[string]string             `json:"env,omitempty"`
	SecretEnv map[string]string             `json:"secret_env,omitempty"`
	URL       string                        `json:"url,omitempty"`
	Auth      *SettingsMCPAuthConfigPayload `json:"auth,omitzero"`
}

type SettingsMCPServerResponse

type SettingsMCPServerResponse struct {
	Server SettingsMCPServerItemPayload `json:"server"`
}

type SettingsMCPServerRuntimeStatusPayload

type SettingsMCPServerRuntimeStatusPayload struct {
	Configured      bool   `json:"configured"`
	Initialized     bool   `json:"initialized"`
	State           string `json:"state"`
	Probe           string `json:"probe"`
	ToolCount       int    `json:"tool_count"`
	ProtocolVersion string `json:"protocol_version,omitempty"`
	Reason          string `json:"reason,omitempty"`
	Diagnostic      string `json:"diagnostic,omitempty"`
}

type SettingsMCPServersResponse

type SettingsMCPServersResponse struct {
	SettingsLayeredCollectionResponseMetaPayload
	MCPServers []SettingsMCPServerItemPayload `json:"mcp_servers"`
}

type SettingsMarketplaceCatalogPayload

type SettingsMarketplaceCatalogPayload struct {
	BaseURL string `json:"base_url"`
	TTL     string `json:"ttl"`
	Timeout string `json:"timeout"`
}

type SettingsMarketplaceResponse

type SettingsMarketplaceResponse struct {
	SettingsUserSectionResponseMetaPayload
	Config SettingsMarketplaceCatalogPayload `json:"config"`
}

type SettingsMutationBehavior

type SettingsMutationBehavior string
const (
	SettingsMutationBehaviorAppliedNow      SettingsMutationBehavior = "applied_now"
	SettingsMutationBehaviorRestartRequired SettingsMutationBehavior = "restart_required"
	SettingsMutationBehaviorActionTrigger   SettingsMutationBehavior = "action_trigger"
)

type SettingsObservabilityConfigPayload

type SettingsObservabilityConfigPayload struct {
	Enabled        bool                                   `json:"enabled"`
	RetentionDays  int                                    `json:"retention_days"`
	MaxGlobalBytes int64                                  `json:"max_global_bytes"`
	Transcripts    SettingsObservabilityTranscriptPayload `json:"transcripts"`
}

type SettingsObservabilityResponse

type SettingsObservabilityResponse struct {
	SettingsUserSectionResponseMetaPayload
	Config  SettingsObservabilityConfigPayload  `json:"config"`
	Runtime SettingsObservabilityRuntimePayload `json:"runtime"`
	LogTail SettingsLogTailCapabilityPayload    `json:"log_tail"`
}

type SettingsObservabilityRuntimePayload

type SettingsObservabilityRuntimePayload struct {
	Available          bool   `json:"available"`
	Status             string `json:"status,omitempty"`
	GlobalDBSizeBytes  int64  `json:"global_db_size_bytes"`
	SessionDBSizeBytes int64  `json:"session_db_size_bytes"`
	ActiveSessions     int    `json:"active_sessions"`
	ActiveAgents       int    `json:"active_agents"`
	UptimeSeconds      int64  `json:"uptime_seconds"`
}

type SettingsObservabilityTranscriptPayload

type SettingsObservabilityTranscriptPayload struct {
	Enabled            bool  `json:"enabled"`
	SegmentBytes       int   `json:"segment_bytes"`
	MaxBytesPerSession int64 `json:"max_bytes_per_session"`
}

type SettingsOperationalLinkPayload

type SettingsOperationalLinkPayload struct {
	Label string `json:"label"`
	Path  string `json:"path"`
}

type SettingsPermissionMode

type SettingsPermissionMode string
const (
	SettingsPermissionModeDenyAll      SettingsPermissionMode = "deny-all"
	SettingsPermissionModeApproveReads SettingsPermissionMode = "approve-reads"
	SettingsPermissionModeApproveAll   SettingsPermissionMode = "approve-all"
	SettingsPermissionModeApproveEdits SettingsPermissionMode = "approve-edits"
	SettingsPermissionModeAuto         SettingsPermissionMode = "auto"
)

type SettingsPermissionsPayload

type SettingsPermissionsPayload struct {
	Mode SettingsPermissionMode `json:"mode"`
}

type SettingsPersonaResponse

type SettingsPersonaResponse struct {
	SettingsLayeredSectionResponseMetaPayload
	Config SettingsDefaultsPayload `json:"config"`
}

type SettingsProviderAuthStatusPayload

type SettingsProviderAuthStatusPayload struct {
	Mode       string                         `json:"mode"`
	EnvPolicy  string                         `json:"env_policy"`
	HomePolicy string                         `json:"home_policy"`
	State      string                         `json:"state"`
	Code       string                         `json:"code,omitempty"`
	Message    string                         `json:"message,omitempty"`
	StatusCmd  string                         `json:"status_command,omitempty"`
	Login      ProviderLoginDescriptorPayload `json:"login"`
}

type SettingsProviderCredentialSlotPayload

type SettingsProviderCredentialSlotPayload struct {
	Name      string `json:"name"`
	TargetEnv string `json:"target_env"`
	SecretRef string `json:"secret_ref"`
	Kind      string `json:"kind,omitempty"`
	Required  bool   `json:"required"`
}

type SettingsProviderCredentialStatusPayload

type SettingsProviderCredentialStatusPayload struct {
	Name      string `json:"name"`
	TargetEnv string `json:"target_env"`
	SecretRef string `json:"secret_ref"`
	Kind      string `json:"kind,omitempty"`
	Required  bool   `json:"required"`
	Present   bool   `json:"present"`
	Source    string `json:"source,omitempty"`
}

type SettingsProviderFallbackPayload

type SettingsProviderFallbackPayload struct {
	Source   SettingsSourceRefPayload        `json:"source"`
	Settings SettingsProviderSettingsPayload `json:"settings"`
}

type SettingsProviderItemPayload

type SettingsProviderItemPayload struct {
	SessionEnvStatus []SettingsProviderCredentialStatusPayload `json:"session_env_status,omitempty"`
	Name             string                                    `json:"name"`
	Settings         SettingsProviderSettingsPayload           `json:"settings"`
	RuntimeStrategy  ProviderRuntimeStrategy                   `json:"runtime_strategy,omitempty"`
	Default          bool                                      `json:"default"`
	CommandAvailable bool                                      `json:"command_available"`
	Credentials      []SettingsProviderCredentialStatusPayload `json:"credentials,omitempty"`
	AuthStatus       *SettingsProviderAuthStatusPayload        `json:"auth_status,omitzero"`
	SourceMetadata   SettingsSourceMetadataPayload             `json:"source_metadata"`
	Fallback         *SettingsProviderFallbackPayload          `json:"fallback,omitzero"`
}

type SettingsProviderModelPayload

type SettingsProviderModelPayload struct {
	ID                       string            `json:"id"`
	DisplayName              string            `json:"display_name,omitempty"`
	ContextWindow            *int64            `json:"context_window,omitzero"`
	MaxInputTokens           *int64            `json:"max_input_tokens,omitzero"`
	MaxOutputTokens          *int64            `json:"max_output_tokens,omitzero"`
	SupportsTools            *bool             `json:"supports_tools,omitzero"`
	SupportsReasoning        *bool             `json:"supports_reasoning,omitzero"`
	ReasoningEfforts         []ReasoningEffort `json:"reasoning_efforts,omitempty"`
	DefaultReasoningEffort   ReasoningEffort   `json:"default_reasoning_effort,omitempty"`
	DefaultSpeed             Speed             `json:"default_speed,omitempty"`
	CostInputPerMillion      *float64          `json:"cost_input_per_million,omitzero"`
	CostOutputPerMillion     *float64          `json:"cost_output_per_million,omitzero"`
	CostCacheReadPerMillion  *float64          `json:"cost_cache_read_per_million,omitzero"`
	CostCacheWritePerMillion *float64          `json:"cost_cache_write_per_million,omitzero"`
	CostReasoningPerMillion  *float64          `json:"cost_reasoning_per_million,omitzero"`
	Deprecated               *bool             `json:"deprecated,omitzero"`
	Hidden                   *bool             `json:"hidden,omitzero"`
	Featured                 *bool             `json:"featured,omitzero"`
	ReleaseDate              string            `json:"release_date,omitempty"`
}

type SettingsProviderModelsDiscoveryPayload

type SettingsProviderModelsDiscoveryPayload struct {
	Enabled  *bool  `json:"enabled,omitzero"`
	Command  string `json:"command,omitempty"`
	Endpoint string `json:"endpoint,omitempty"`
	Timeout  string `json:"timeout,omitempty"`
}

type SettingsProviderModelsPayload

type SettingsProviderModelsPayload struct {
	Default   string                                  `json:"default,omitempty"`
	Curated   []SettingsProviderModelPayload          `json:"curated,omitempty"`
	Discovery *SettingsProviderModelsDiscoveryPayload `json:"discovery,omitzero"`
	Reasoning *SettingsProviderReasoningPayload       `json:"reasoning,omitzero"`
}

type SettingsProviderReasoningPayload

type SettingsProviderReasoningPayload struct {
	Apply string `json:"apply"`
}

type SettingsProviderResponse

type SettingsProviderResponse struct {
	Provider SettingsProviderItemPayload `json:"provider"`
}

type SettingsProviderSecretWritePayload

type SettingsProviderSecretWritePayload struct {
	Name      string `json:"name,omitempty"`
	SecretRef string `json:"secret_ref"`
	Kind      string `json:"kind,omitempty"`
	Value     string `json:"value"`
}

type SettingsProviderSettingsPayload

type SettingsProviderSettingsPayload struct {
	SessionEnv       map[string]SessionEnvBindingPayload     `json:"session_env,omitempty"`
	SteerCapability  config.SteerCapability                  `json:"steer_capability,omitempty"`
	Command          string                                  `json:"command,omitempty"`
	CommandInherited bool                                    `json:"command_inherited,omitempty"`
	DisplayName      string                                  `json:"display_name,omitempty"`
	Models           *SettingsProviderModelsPayload          `json:"models,omitzero"`
	Harness          string                                  `json:"harness,omitempty"`
	RuntimeProvider  string                                  `json:"runtime_provider,omitempty"`
	Transport        string                                  `json:"transport,omitempty"`
	BaseURL          string                                  `json:"base_url,omitempty"`
	AuthMode         string                                  `json:"auth_mode,omitempty"`
	EnvPolicy        string                                  `json:"env_policy,omitempty"`
	HomePolicy       string                                  `json:"home_policy,omitempty"`
	AuthStatusCmd    string                                  `json:"auth_status_command,omitempty"`
	AuthACPMethod    string                                  `json:"auth_acp_method,omitempty"`
	CredentialSlots  []SettingsProviderCredentialSlotPayload `json:"credential_slots,omitempty"`
}

type SettingsProviderUsagePayload

type SettingsProviderUsagePayload struct {
	Enabled         bool                                            `json:"enabled"`
	RefreshInterval string                                          `json:"refresh_interval"`
	Providers       map[string]SettingsProviderUsageProviderPayload `json:"providers"`
}

type SettingsProviderUsageProviderPayload

type SettingsProviderUsageProviderPayload struct {
	Enabled        *bool `json:"enabled,omitempty"`
	KeychainAccess *bool `json:"keychain_access,omitempty"`
}

type SettingsProviderUsageResponse

type SettingsProviderUsageResponse struct {
	KeychainSupported bool `json:"keychain_supported"`
	SettingsUserSectionResponseMetaPayload
	Config SettingsProviderUsagePayload `json:"config"`
}

type SettingsProviderUsageUpdateRequest

type SettingsProviderUsageUpdateRequest struct {
	Config SettingsProviderUsagePayload `json:"config"`
}

type SettingsProviderWritePayload

type SettingsProviderWritePayload struct {
	SessionEnv      map[string]SessionEnvBindingPayload     `json:"session_env,omitzero"`
	SteerCapability config.SteerCapability                  `json:"steer_capability,omitempty"`
	Command         string                                  `json:"command,omitempty"`
	DisplayName     string                                  `json:"display_name,omitempty"`
	Models          *SettingsProviderModelsPayload          `json:"models,omitzero"`
	Harness         string                                  `json:"harness,omitempty"`
	RuntimeProvider string                                  `json:"runtime_provider,omitempty"`
	Transport       string                                  `json:"transport,omitempty"`
	BaseURL         string                                  `json:"base_url,omitempty"`
	AuthMode        string                                  `json:"auth_mode,omitempty"`
	EnvPolicy       string                                  `json:"env_policy,omitempty"`
	HomePolicy      string                                  `json:"home_policy,omitempty"`
	AuthStatusCmd   string                                  `json:"auth_status_command,omitempty"`
	AuthLoginCmd    *string                                 `json:"auth_login_command,omitzero"`
	AuthACPMethod   *string                                 `json:"auth_acp_method,omitzero"`
	CredentialSlots []SettingsProviderCredentialSlotPayload `json:"credential_slots,omitempty"`
}

SettingsProviderWritePayload accepts auth_login_command without exposing it on reads.

type SettingsProvidersResponse

type SettingsProvidersResponse struct {
	SettingsUserCollectionResponseMetaPayload
	Providers []SettingsProviderItemPayload `json:"providers"`
}

type SettingsRedactPayload

type SettingsRedactPayload struct {
	Enabled bool `json:"enabled"`
}

type SettingsRoleConfigPayload

type SettingsRoleConfigPayload struct {
	Enabled         bool                          `json:"enabled"`
	Agent           string                        `json:"agent"`
	Provider        string                        `json:"provider"`
	Model           string                        `json:"model"`
	ReasoningEffort string                        `json:"reasoning_effort"`
	Speed           *Speed                        `json:"speed,omitzero"`
	ACPOptions      []AgentACPOptionSelection     `json:"acp_options"`
	FallbackChain   []SettingsRoleFallbackPayload `json:"fallback_chain"`
}

type SettingsRoleFallbackPayload

type SettingsRoleFallbackPayload struct {
	SessionEnv      map[string]SessionEnvBindingPayload `json:"session_env,omitempty"`
	Provider        string                              `json:"provider"`
	Model           string                              `json:"model"`
	ReasoningEffort string                              `json:"reasoning_effort"`
	Speed           *Speed                              `json:"speed,omitzero"`
	ACPOptions      []AgentACPOptionSelection           `json:"acp_options"`
	// Command is the route account; always present on the settings surface, empty inherits.
	Command string `json:"command"`
}

type SettingsRolesConfigPayload

type SettingsRolesConfigPayload struct {
	Coordinator SettingsCoordinatorRoleConfigPayload `json:"coordinator"`
	AutoTitle   SettingsRoleConfigPayload            `json:"auto_title"`
}

type SettingsRolesResponse

type SettingsRolesResponse struct {
	SettingsWorkspaceSectionResponseMetaPayload
	Config SettingsRolesConfigPayload `json:"config"`
}

type SettingsScopeKind

type SettingsScopeKind string
const (
	SettingsScopeUser      SettingsScopeKind = "user"
	SettingsScopeProfile   SettingsScopeKind = "profile"
	SettingsScopeWorkspace SettingsScopeKind = "workspace"
	SettingsScopeAgent     SettingsScopeKind = "agent"
)

type SettingsSectionName

type SettingsSectionName string
const (
	SettingsSectionGeneral    SettingsSectionName = "general"
	SettingsSectionPersona    SettingsSectionName = "persona"
	SettingsSectionRoles      SettingsSectionName = "roles"
	SettingsSectionSkills     SettingsSectionName = "skills"
	SettingsSectionAutomation SettingsSectionName = "automation"

	SettingsSectionWindowManager   SettingsSectionName = "window-manager"
	SettingsSectionCmdPalette      SettingsSectionName = "cmd-palette"
	SettingsSectionAttention       SettingsSectionName = "attention"
	SettingsSectionShell           SettingsSectionName = "shell"
	SettingsSectionProviderUsage   SettingsSectionName = "provider-usage"
	SettingsSectionObservability   SettingsSectionName = "observability"
	SettingsSectionHooksExtensions SettingsSectionName = "hooks-extensions"
	SettingsSectionMarketplace     SettingsSectionName = "marketplace"
)

type SettingsShellAppearancePayload

type SettingsShellAppearancePayload struct {
	UIFont   *string `json:"ui_font,omitempty"`
	MonoFont *string `json:"mono_font,omitempty"`
}

SettingsShellAppearancePayload carries shell font family preferences. On update, an omitted field preserves the stored family and "" resets it to the default. Responses always populate both fields.

type SettingsShellLegacyScopePayload

type SettingsShellLegacyScopePayload struct {
	Value    SettingsShellSessionScope `json:"value"`
	Explicit bool                      `json:"explicit"`
	Revision uint64                    `json:"revision"`
}

type SettingsShellMutationResponse

type SettingsShellMutationResponse struct {
	SettingsApplyResponse
	Config      SettingsShellPayload            `json:"config"`
	LegacyScope SettingsShellLegacyScopePayload `json:"legacy_scope"`
}

SettingsShellMutationResponse preserves apply receipts and returns the updated preferences.

type SettingsShellPayload

type SettingsShellPayload struct {
	Sessions   SettingsShellSessionsPayload    `json:"sessions"`
	Appearance *SettingsShellAppearancePayload `json:"appearance,omitempty"`
}

SettingsShellPayload is the stable operator shell settings contract.

type SettingsShellResponse

type SettingsShellResponse struct {
	Warnings    []string                        `json:"warnings"`
	LegacyScope SettingsShellLegacyScopePayload `json:"legacy_scope"`
	SettingsUserSectionResponseMetaPayload
	Config SettingsShellPayload `json:"config"`
}

SettingsShellResponse returns the effective global shell settings.

type SettingsShellSessionGroupBy

type SettingsShellSessionGroupBy string
const (
	SettingsShellSessionGroupByNone    SettingsShellSessionGroupBy = "none"
	SettingsShellSessionGroupByProject SettingsShellSessionGroupBy = "project"
	SettingsShellSessionGroupByProfile SettingsShellSessionGroupBy = "profile"
)

type SettingsShellSessionScope

type SettingsShellSessionScope string

SettingsShellSessionScope identifies the operator's preferred session list breadth.

const (
	SettingsShellSessionScopeWorkspace     SettingsShellSessionScope = "workspace"
	SettingsShellSessionScopeAllWorkspaces SettingsShellSessionScope = "all-workspaces"
)

type SettingsShellSessionSort

type SettingsShellSessionSort string

SettingsShellSessionSort identifies the operator's preferred session ordering.

const (
	SettingsShellSessionSortCreated      SettingsShellSessionSort = "created"
	SettingsShellSessionSortName         SettingsShellSessionSort = "name"
	SettingsShellSessionSortLastActivity SettingsShellSessionSort = "last_activity"
	SettingsShellSessionSortAttention    SettingsShellSessionSort = "attention"
	SettingsShellSessionSortManual       SettingsShellSessionSort = "manual"
)

type SettingsShellSessionsPayload

type SettingsShellSessionsPayload struct {
	GroupBy SettingsShellSessionGroupBy `json:"group_by,omitempty"`
	Sort    SettingsShellSessionSort    `json:"sort,omitempty"`
	Scope   SettingsShellSessionScope   `json:"scope,omitempty"`
}

SettingsShellSessionsPayload carries persistent session-list preferences.

type SettingsSkillSourceCollisionPayload

type SettingsSkillSourceCollisionPayload struct {
	Name          string `json:"name"`
	WinnerRootID  string `json:"winner_root_id"`
	QualifiedForm string `json:"qualified_form"`
}

SettingsSkillSourceCollisionPayload reports a lower-precedence definition.

type SettingsSkillSourceInheritancePayload

type SettingsSkillSourceInheritancePayload struct {
	Sources       bool `json:"sources"`
	CustomSources bool `json:"custom_sources"`
}

SettingsSkillSourceInheritancePayload reports workspace source-key inheritance.

type SettingsSkillSourcePayload

type SettingsSkillSourcePayload struct {
	Slug          string                           `json:"slug"`
	Label         string                           `json:"label"`
	Kind          string                           `json:"kind"`
	Enabled       bool                             `json:"enabled"`
	AlwaysOn      bool                             `json:"always_on"`
	Default       bool                             `json:"default,omitzero"`
	WorkspacePath string                           `json:"workspace_path,omitempty"`
	GlobalPath    string                           `json:"global_path,omitempty"`
	Path          string                           `json:"path,omitempty"`
	Roots         []SettingsSkillSourceRootPayload `json:"roots"`
}

SettingsSkillSourcePayload describes one configured skill source convention.

type SettingsSkillSourceRootPayload

type SettingsSkillSourceRootPayload struct {
	RootID        string                                  `json:"root_id"`
	Path          string                                  `json:"path"`
	Exists        bool                                    `json:"exists"`
	Readable      bool                                    `json:"readable"`
	ScannedCount  *int                                    `json:"scanned_count,omitzero"`
	SkillCount    *int                                    `json:"skill_count,omitzero"`
	Truncated     bool                                    `json:"truncated"`
	SkippedLinks  []SettingsSkillSourceSkippedLinkPayload `json:"skipped_links"`
	Collisions    []SettingsSkillSourceCollisionPayload   `json:"collisions"`
	Verification  SettingsSkillSourceVerificationPayload  `json:"verification"`
	NativeReaders []string                                `json:"native_readers"`
}

SettingsSkillSourceRootPayload carries daemon-measured diagnostics for one root.

type SettingsSkillSourceSkippedLinkPayload

type SettingsSkillSourceSkippedLinkPayload struct {
	Path   string `json:"path"`
	Reason string `json:"reason"`
}

SettingsSkillSourceSkippedLinkPayload explains why a first-level link was excluded.

type SettingsSkillSourceVerificationPayload

type SettingsSkillSourceVerificationPayload struct {
	Blocked int `json:"blocked"`
	Warned  int `json:"warned"`
}

SettingsSkillSourceVerificationPayload summarizes verifier outcomes for one root.

type SettingsSkillsConfigPayload

type SettingsSkillsConfigPayload struct {
	Enabled                 bool     `json:"enabled"`
	Sources                 []string `json:"sources"`
	CustomSources           []string `json:"custom_sources"`
	DisabledSkills          []string `json:"disabled_skills,omitempty"`
	PollInterval            string   `json:"poll_interval"`
	AllowedMarketplaceHooks []string `json:"allowed_marketplace_hooks,omitempty"`
}

type SettingsSkillsMutationResponse

type SettingsSkillsMutationResponse struct {
	SettingsSkillsResponse
	WriteTarget      SettingsWriteTargetKind       `json:"write_target,omitempty"`
	Applied          bool                          `json:"applied"`
	Lifecycle        SettingsApplyLifecycle        `json:"lifecycle"`
	ApplyRecordID    string                        `json:"apply_record_id"`
	ActiveGeneration int64                         `json:"active_generation"`
	ActiveConfigHash string                        `json:"active_config_hash"`
	NextAction       SettingsApplyNextAction       `json:"next_action"`
	RestartRequired  bool                          `json:"restart_required,omitzero"`
	RestartScope     string                        `json:"restart_scope,omitempty"`
	Warnings         []string                      `json:"warnings,omitempty"`
	PartialFailures  []SettingsApplyFailurePayload `json:"partial_failures,omitempty"`
	Skipped          bool                          `json:"skipped,omitzero"`
	SkippedReason    string                        `json:"skipped_reason,omitempty"`
}

SettingsSkillsMutationResponse returns the refreshed skills read model with apply metadata.

type SettingsSkillsMutationResult

type SettingsSkillsMutationResult struct {
	Section         SettingsSectionName      `json:"section"`
	Scope           SettingsScopeKind        `json:"scope"`
	WriteTarget     SettingsWriteTargetKind  `json:"write_target,omitempty"`
	WorkspaceID     string                   `json:"workspace_id,omitempty"`
	Profile         string                   `json:"profile,omitempty"`
	AgentName       string                   `json:"agent_name,omitempty"`
	Behavior        SettingsMutationBehavior `json:"behavior"`
	Applied         bool                     `json:"applied"`
	RestartRequired bool                     `json:"restart_required"`
	RestartScope    string                   `json:"restart_scope,omitempty"`
	Warnings        []string                 `json:"warnings,omitempty"`
}

type SettingsSkillsOverridePayload

type SettingsSkillsOverridePayload struct {
	Sources       OptionalStringList `json:"sources,omitzero"`
	CustomSources OptionalStringList `json:"custom_sources,omitzero"`
}

SettingsSkillsOverridePayload carries independent workspace source overrides.

func (SettingsSkillsOverridePayload) MarshalJSON

func (p SettingsSkillsOverridePayload) MarshalJSON() ([]byte, error)

MarshalJSON omits untouched overlay fields while preserving explicit null.

type SettingsSkillsResponse

type SettingsSkillsResponse struct {
	SettingsSkillsSectionResponseMetaPayload
	Config           SettingsSkillsConfigPayload            `json:"config"`
	DiscoveredCount  int                                    `json:"discovered_count"`
	DisabledCount    int                                    `json:"disabled_count"`
	RuntimeAvailable bool                                   `json:"runtime_available"`
	Diagnostics      []SkillDiagnosticPayload               `json:"diagnostics,omitempty"`
	Sources          []SettingsSkillSourcePayload           `json:"sources"`
	Inherits         *SettingsSkillSourceInheritancePayload `json:"inherits,omitzero"`
	Links            []SettingsOperationalLinkPayload       `json:"links,omitempty"`
}

type SettingsSkillsSectionResponseMetaPayload

type SettingsSkillsSectionResponseMetaPayload struct {
	Section         SettingsSectionName `json:"section"`
	Scope           SettingsScopeKind   `json:"scope"`
	WorkspaceID     string              `json:"workspace_id,omitempty"`
	Profile         string              `json:"profile,omitempty"`
	AgentName       string              `json:"agent_name,omitempty"`
	AvailableScopes []SettingsScopeKind `json:"available_scopes"`
}

type SettingsSourceKind

type SettingsSourceKind string
const (
	SettingsSourceExtension                  SettingsSourceKind = "extension"
	SettingsSourceBuiltinProvider            SettingsSourceKind = "builtin-provider"
	SettingsSourceGlobalConfig               SettingsSourceKind = "global-config"
	SettingsSourceProfileConfig              SettingsSourceKind = "profile-config"
	SettingsSourceWorkspaceConfig            SettingsSourceKind = "workspace-config"
	SettingsSourceWorkspaceProfileConfig     SettingsSourceKind = "workspace-profile-config"
	SettingsSourceGlobalMCPSidecar           SettingsSourceKind = "global-mcp-sidecar"
	SettingsSourceProfileMCPSidecar          SettingsSourceKind = "profile-mcp-sidecar"
	SettingsSourceWorkspaceMCPSidecar        SettingsSourceKind = "workspace-mcp-sidecar"
	SettingsSourceWorkspaceProfileMCPSidecar SettingsSourceKind = "workspace-profile-mcp-sidecar"
	SettingsSourceGlobalAgentFile            SettingsSourceKind = "global-agent-file"
	SettingsSourceWorkspaceAgentFile         SettingsSourceKind = "workspace-agent-file"
)

type SettingsSourceMetadataPayload

type SettingsSourceMetadataPayload struct {
	EffectiveSource  SettingsSourceRefPayload   `json:"effective_source"`
	ShadowedSources  []SettingsSourceRefPayload `json:"shadowed_sources,omitempty"`
	AvailableTargets []SettingsWriteTargetKind  `json:"available_targets"`
}

type SettingsSourceRefPayload

type SettingsSourceRefPayload struct {
	Kind        SettingsSourceKind `json:"kind"`
	Scope       SettingsScopeKind  `json:"scope"`
	WorkspaceID string             `json:"workspace_id,omitempty"`
	Profile     string             `json:"profile,omitempty"`
	AgentName   string             `json:"agent_name,omitempty"`
}

type SettingsStreamTransport

type SettingsStreamTransport string
const (
	SettingsStreamTransportSSE SettingsStreamTransport = "sse"
)

type SettingsTargetSelector

type SettingsTargetSelector string
const (
	SettingsTargetAuto    SettingsTargetSelector = "auto"
	SettingsTargetConfig  SettingsTargetSelector = "config"
	SettingsTargetSidecar SettingsTargetSelector = "sidecar"
)

type SettingsTerminalPayload

type SettingsTerminalPayload struct {
	DefaultShell           string `json:"default_shell"`
	ShellIntegration       bool   `json:"shell_integration"`
	ScrollbackBytes        int    `json:"scrollback_bytes"`
	DetachedTTL            string `json:"detached_ttl"`
	ExitRetention          string `json:"exit_retention"`
	Recording              bool   `json:"recording"`
	RecordingRetentionDays int    `json:"recording_retention_days"`
	MaxPerWorkspace        int    `json:"max_per_workspace"`
	MaxPerDaemon           int    `json:"max_per_daemon"`
	MaxSubscribers         int    `json:"max_subscribers"`
}

SettingsTerminalPayload projects the complete [terminal] policy block.

type SettingsTransportParityPayload

type SettingsTransportParityPayload struct {
	Known          bool `json:"known"`
	SettingsHTTP   bool `json:"settings_http"`
	SettingsUDS    bool `json:"settings_uds"`
	ExtensionsHTTP bool `json:"extensions_http"`
	ExtensionsUDS  bool `json:"extensions_uds"`
}

type SettingsUpdateActor

type SettingsUpdateActor string
const (
	SettingsUpdateActorCLI    SettingsUpdateActor = "cli"
	SettingsUpdateActorDaemon SettingsUpdateActor = "daemon"
	SettingsUpdateActorWeb    SettingsUpdateActor = "web"
	SettingsUpdateActorShell  SettingsUpdateActor = "shell"
)

type SettingsUpdateAppPayload

type SettingsUpdateAppPayload struct {
	Status         SettingsUpdateStatusKind `json:"status"`
	Running        bool                     `json:"running"`
	CurrentVersion string                   `json:"current_version"`
	LatestVersion  string                   `json:"latest_version"`
	ReleaseURL     string                   `json:"release_url"`
	AttemptID      string                   `json:"attempt_id"`
	LastError      string                   `json:"last_error"`
	Message        string                   `json:"message"`
}

type SettingsUpdateApplyRequest

type SettingsUpdateApplyRequest struct {
	Targets []SettingsUpdateTarget `json:"targets"`
}

type SettingsUpdateApplyResponse

type SettingsUpdateApplyResponse struct {
	Targets     []SettingsUpdateTarget       `json:"targets"`
	Status      SettingsUpdateApplyStatus    `json:"status"`
	OperationID string                       `json:"operation_id,omitempty"`
	Message     string                       `json:"message"`
	Holder      *SettingsUpdateHolderPayload `json:"holder,omitzero"`
}

type SettingsUpdateApplyStatus

type SettingsUpdateApplyStatus string
const (
	SettingsUpdateApplyAccepted SettingsUpdateApplyStatus = "accepted"
	SettingsUpdateApplyBlocked  SettingsUpdateApplyStatus = "blocked"
	SettingsUpdateApplyFailed   SettingsUpdateApplyStatus = "failed"
)

type SettingsUpdateCancelResponse

type SettingsUpdateCancelResponse struct {
	Status      SettingsUpdateStatusKind     `json:"status"`
	OperationID string                       `json:"operation_id,omitempty"`
	Message     string                       `json:"message"`
	Holder      *SettingsUpdateHolderPayload `json:"holder,omitzero"`
}

type SettingsUpdateHolderPayload

type SettingsUpdateHolderPayload struct {
	PID                int                 `json:"pid"`
	PIDStartTime       time.Time           `json:"pid_start_time"`
	Surface            SettingsUpdateActor `json:"surface"`
	ExecutorGeneration string              `json:"executor_generation"`
	LeaseExpiresAt     time.Time           `json:"lease_expires_at"`
}

type SettingsUpdateInstallMethod

type SettingsUpdateInstallMethod string
const (
	SettingsUpdateInstallDirectBinary SettingsUpdateInstallMethod = "direct-binary"
	SettingsUpdateInstallHomebrew     SettingsUpdateInstallMethod = "homebrew"
	SettingsUpdateInstallNPM          SettingsUpdateInstallMethod = "npm"
	SettingsUpdateInstallAPT          SettingsUpdateInstallMethod = "apt"
	SettingsUpdateInstallDNF          SettingsUpdateInstallMethod = "dnf"
	SettingsUpdateInstallRPM          SettingsUpdateInstallMethod = "rpm"
	SettingsUpdateInstallScoop        SettingsUpdateInstallMethod = "scoop"
	SettingsUpdateInstallGo           SettingsUpdateInstallMethod = "go-install"
	SettingsUpdateInstallDesktopApp   SettingsUpdateInstallMethod = "desktop-app"
	SettingsUpdateInstallUnknown      SettingsUpdateInstallMethod = "unknown"
)

type SettingsUpdateOperationPayload

type SettingsUpdateOperationPayload struct {
	ID           string                       `json:"id"`
	Revision     int64                        `json:"revision"`
	Targets      []SettingsUpdateTarget       `json:"targets"`
	ActiveTarget *SettingsUpdateTarget        `json:"active_target,omitzero"`
	Phase        SettingsUpdatePhase          `json:"phase"`
	Percent      int                          `json:"percent"`
	Holder       *SettingsUpdateHolderPayload `json:"holder"`
	Waiting      SettingsUpdateWaitingState   `json:"waiting"`
	StartedAt    time.Time                    `json:"started_at"`
	LastError    string                       `json:"last_error"`
}

type SettingsUpdatePhase

type SettingsUpdatePhase string
const (
	SettingsUpdatePhasePending          SettingsUpdatePhase = "pending"
	SettingsUpdatePhaseDownloading      SettingsUpdatePhase = "downloading"
	SettingsUpdatePhaseVerifying        SettingsUpdatePhase = "verifying"
	SettingsUpdatePhaseSwapping         SettingsUpdatePhase = "swapping"
	SettingsUpdatePhaseRestarting       SettingsUpdatePhase = "restarting"
	SettingsUpdatePhaseHealthChecking   SettingsUpdatePhase = "health-checking"
	SettingsUpdatePhaseFinalized        SettingsUpdatePhase = "finalized"
	SettingsUpdatePhaseRolledBack       SettingsUpdatePhase = "rolled-back"
	SettingsUpdatePhaseFailed           SettingsUpdatePhase = "failed"
	SettingsUpdatePhaseStaged           SettingsUpdatePhase = "staged"
	SettingsUpdatePhaseApplying         SettingsUpdatePhase = "applying"
	SettingsUpdatePhaseInstallerHandoff SettingsUpdatePhase = "installer-handoff"
	SettingsUpdatePhaseRestarted        SettingsUpdatePhase = "restarted"
	SettingsUpdatePhaseVerified         SettingsUpdatePhase = "verified"
)

type SettingsUpdateResponse

type SettingsUpdateResponse struct {
	Aggregate SettingsUpdateStatusKind        `json:"aggregate"`
	Operation *SettingsUpdateOperationPayload `json:"operation"`
	Runtime   SettingsUpdateRuntimePayload    `json:"runtime"`
	App       *SettingsUpdateAppPayload       `json:"app"`
}

type SettingsUpdateRuntimePayload

type SettingsUpdateRuntimePayload struct {
	CheckedAt       *time.Time                  `json:"checked_at,omitempty"`
	Status          SettingsUpdateStatusKind    `json:"status"`
	InstallMethod   SettingsUpdateInstallMethod `json:"install_method"`
	Managed         bool                        `json:"managed"`
	CurrentVersion  string                      `json:"current_version"`
	LatestVersion   string                      `json:"latest_version"`
	ReleaseURL      string                      `json:"release_url"`
	Recommendation  string                      `json:"recommendation"`
	RestoredVersion string                      `json:"restored_version"`
	DaemonRestarted bool                        `json:"daemon_restarted"`
	Message         string                      `json:"message"`
	LastError       string                      `json:"last_error"`
}

type SettingsUpdateStatusKind

type SettingsUpdateStatusKind string
const (
	SettingsUpdateStatusUpToDate    SettingsUpdateStatusKind = "up-to-date"
	SettingsUpdateStatusAvailable   SettingsUpdateStatusKind = "available"
	SettingsUpdateStatusAccepted    SettingsUpdateStatusKind = "accepted"
	SettingsUpdateStatusApplying    SettingsUpdateStatusKind = "applying"
	SettingsUpdateStatusStaged      SettingsUpdateStatusKind = "staged"
	SettingsUpdateStatusUpdated     SettingsUpdateStatusKind = "updated"
	SettingsUpdateStatusBlocked     SettingsUpdateStatusKind = "blocked"
	SettingsUpdateStatusUnsupported SettingsUpdateStatusKind = "unsupported"
	SettingsUpdateStatusFailed      SettingsUpdateStatusKind = "failed"
	SettingsUpdateStatusCanceled    SettingsUpdateStatusKind = "canceled"
)

type SettingsUpdateTarget

type SettingsUpdateTarget string
const (
	SettingsUpdateTargetRuntime SettingsUpdateTarget = "runtime"
	SettingsUpdateTargetApp     SettingsUpdateTarget = "app"
)

type SettingsUpdateWaitingState

type SettingsUpdateWaitingState string
const (
	SettingsUpdateWaitingNone   SettingsUpdateWaitingState = ""
	SettingsUpdateWaitingForApp SettingsUpdateWaitingState = "waiting-for-app"
)

type SettingsUserCollectionMutationResult

type SettingsUserCollectionMutationResult struct {
	Section         SettingsCollectionName   `json:"section"`
	Scope           SettingsUserScopeKind    `json:"scope"`
	WriteTarget     SettingsWriteTargetKind  `json:"write_target,omitempty"`
	Behavior        SettingsMutationBehavior `json:"behavior"`
	Applied         bool                     `json:"applied"`
	RestartRequired bool                     `json:"restart_required"`
	RestartScope    string                   `json:"restart_scope,omitempty"`
	Warnings        []string                 `json:"warnings,omitempty"`
}

type SettingsUserCollectionResponseMetaPayload

type SettingsUserCollectionResponseMetaPayload struct {
	Collection      SettingsCollectionName  `json:"collection"`
	Scope           SettingsUserScopeKind   `json:"scope"`
	AvailableScopes []SettingsUserScopeKind `json:"available_scopes"`
}

type SettingsUserScopeKind

type SettingsUserScopeKind string
const (
	SettingsUserScope SettingsUserScopeKind = "user"
)

type SettingsUserSectionMutationResult

type SettingsUserSectionMutationResult struct {
	Section         SettingsSectionName      `json:"section"`
	Scope           SettingsUserScopeKind    `json:"scope"`
	WriteTarget     SettingsWriteTargetKind  `json:"write_target,omitempty"`
	Behavior        SettingsMutationBehavior `json:"behavior"`
	Applied         bool                     `json:"applied"`
	RestartRequired bool                     `json:"restart_required"`
	RestartScope    string                   `json:"restart_scope,omitempty"`
	Warnings        []string                 `json:"warnings,omitempty"`
}

type SettingsUserSectionResponseMetaPayload

type SettingsUserSectionResponseMetaPayload struct {
	Section         SettingsSectionName     `json:"section"`
	Scope           SettingsUserScopeKind   `json:"scope"`
	AvailableScopes []SettingsUserScopeKind `json:"available_scopes"`
}

type SettingsWindowBindingAction

type SettingsWindowBindingAction string
const (
	SettingsWindowBindingActionNone     SettingsWindowBindingAction = "none"
	SettingsWindowBindingActionReserved SettingsWindowBindingAction = "reserved"
	SettingsWindowBindingActionZoom     SettingsWindowBindingAction = "zoom"
)

type SettingsWindowDesktopTransition

type SettingsWindowDesktopTransition string
const (
	SettingsWindowDesktopTransitionSlide     SettingsWindowDesktopTransition = "slide"
	SettingsWindowDesktopTransitionCrossfade SettingsWindowDesktopTransition = "crossfade"
	SettingsWindowDesktopTransitionInstant   SettingsWindowDesktopTransition = "instant"
)

type SettingsWindowDragAwayPolicy

type SettingsWindowDragAwayPolicy string
const (
	SettingsWindowDragAwayPolicyWindow SettingsWindowDragAwayPolicy = "window"
	SettingsWindowDragAwayPolicyGroup  SettingsWindowDragAwayPolicy = "group"
)

type SettingsWindowDragModifier

type SettingsWindowDragModifier string
const (
	SettingsWindowDragModifierAlt     SettingsWindowDragModifier = "alt"
	SettingsWindowDragModifierControl SettingsWindowDragModifier = "control"
	SettingsWindowDragModifierMeta    SettingsWindowDragModifier = "meta"
	SettingsWindowDragModifierShift   SettingsWindowDragModifier = "shift"
	SettingsWindowDragModifierNone    SettingsWindowDragModifier = "none"
)

type SettingsWindowFocusPolicy

type SettingsWindowFocusPolicy string
const (
	SettingsWindowFocusPolicyClickDirectional SettingsWindowFocusPolicy = "click_directional"
	SettingsWindowFocusPolicyDirectional      SettingsWindowFocusPolicy = "directional"
)

type SettingsWindowManagerBindingPayload

type SettingsWindowManagerBindingPayload struct {
	TopCenter    SettingsWindowBindingAction `json:"top_center"`
	BottomCenter SettingsWindowBindingAction `json:"bottom_center"`
}

type SettingsWindowManagerCommandPayload

type SettingsWindowManagerCommandPayload struct {
	ID      string `json:"id"`
	Title   string `json:"title"`
	Section string `json:"section"`
	Source  string `json:"source"`
}

type SettingsWindowManagerConfigPayload

type SettingsWindowManagerConfigPayload struct {
	NewWindowPolicy     SettingsWindowNewPolicy                  `json:"new_window_policy"`
	SmallViewportPolicy SettingsWindowSmallViewportPolicy        `json:"small_viewport_policy"`
	FocusPolicy         SettingsWindowFocusPolicy                `json:"focus_policy"`
	FocusWrap           bool                                     `json:"focus_wrap"`
	FocusFollowsPointer bool                                     `json:"focus_follows_pointer"`
	RaiseOnFocus        bool                                     `json:"raise_on_focus"`
	DragAwayPolicy      SettingsWindowDragAwayPolicy             `json:"drag_away_policy"`
	GroupMoveModifier   SettingsWindowDragModifier               `json:"group_move_modifier"`
	SwapModifier        SettingsWindowDragModifier               `json:"swap_modifier"`
	HistoryLimit        int                                      `json:"history_limit"`
	NavStackLimit       int                                      `json:"nav_stack_limit"`
	ClosedEntryLimit    int                                      `json:"closed_entry_limit"`
	DesktopTransition   SettingsWindowDesktopTransition          `json:"desktop_transition"`
	Gaps                SettingsWindowManagerGapsPayload         `json:"gaps"`
	Snap                SettingsWindowManagerSnapPayload         `json:"snap"`
	Bindings            SettingsWindowManagerBindingPayload      `json:"bindings"`
	Shortcuts           map[string]windowmanager.ShortcutBinding `json:"shortcuts"`
	GlobalShortcuts     map[string]string                        `json:"global_shortcuts"`
}

type SettingsWindowManagerDefaultPayload

type SettingsWindowManagerDefaultPayload struct {
	CommandID    string                        `json:"command"`
	Binding      windowmanager.ShortcutBinding `json:"binding"`
	Dormant      bool                          `json:"dormant"`
	ConflictWith string                        `json:"conflict_with,omitempty"`
}

type SettingsWindowManagerDiagnosticPayload

type SettingsWindowManagerDiagnosticPayload struct {
	CommandID string `json:"command_id"`
	Message   string `json:"message"`
}

type SettingsWindowManagerGapsPayload

type SettingsWindowManagerGapsPayload struct {
	Inner  int `json:"inner"`
	Top    int `json:"top"`
	Right  int `json:"right"`
	Bottom int `json:"bottom"`
	Left   int `json:"left"`
}

type SettingsWindowManagerMutationError

type SettingsWindowManagerMutationError struct {
	Error   string `json:"error"`
	Owner   string `json:"owner,omitempty"`
	Chord   string `json:"chord,omitempty"`
	Alias   string `json:"alias,omitempty"`
	Message string `json:"message,omitempty"`
}

type SettingsWindowManagerMutationResponse

type SettingsWindowManagerMutationResponse struct {
	SettingsWindowManagerResponse
	Apply SettingsApplyResponse `json:"apply"`
}

SettingsWindowManagerMutationResponse preserves the section echo alongside live apply truth.

type SettingsWindowManagerResponse

type SettingsWindowManagerResponse struct {
	SettingsWorkspaceSectionResponseMetaPayload
	Config             SettingsWindowManagerConfigPayload       `json:"config"`
	Defaults           map[string]windowmanager.ShortcutBinding `json:"defaults"`
	EffectiveShortcuts map[string]windowmanager.ShortcutBinding `json:"effective_shortcuts"`
	Aliases            map[string]string                        `json:"aliases"`
	Commands           []SettingsWindowManagerCommandPayload    `json:"commands"`
	ExtensionDefaults  []SettingsWindowManagerDefaultPayload    `json:"extension_defaults"`
	Diagnostics        []SettingsWindowManagerDiagnosticPayload `json:"diagnostics"`
	GlobalShortcuts    []SettingsGlobalShortcutPayload          `json:"global_shortcuts"`
}

type SettingsWindowManagerSnapPayload

type SettingsWindowManagerSnapPayload struct {
	EdgeBand     int       `json:"edge_band"`
	CornerReach  int       `json:"corner_reach"`
	ExitSlack    int       `json:"exit_slack"`
	RepeatRatios []float64 `json:"repeat_ratios"`
}

type SettingsWindowNewPolicy

type SettingsWindowNewPolicy string
const (
	SettingsWindowNewPolicyFloating    SettingsWindowNewPolicy = "floating"
	SettingsWindowNewPolicyBesideFocus SettingsWindowNewPolicy = "beside_focus"
	SettingsWindowNewPolicyTab         SettingsWindowNewPolicy = "tab"
)

type SettingsWindowSmallViewportPolicy

type SettingsWindowSmallViewportPolicy string
const (
	SettingsWindowSmallViewportPolicyStack  SettingsWindowSmallViewportPolicy = "stack"
	SettingsWindowSmallViewportPolicyReject SettingsWindowSmallViewportPolicy = "reject"
)

type SettingsWorkspaceScopeKind

type SettingsWorkspaceScopeKind string
const (
	SettingsWorkspaceScopeUser      SettingsWorkspaceScopeKind = "user"
	SettingsWorkspaceScopeWorkspace SettingsWorkspaceScopeKind = "workspace"
)

type SettingsWorkspaceSectionMutationResult

type SettingsWorkspaceSectionMutationResult struct {
	Section         SettingsSectionName        `json:"section"`
	Scope           SettingsWorkspaceScopeKind `json:"scope"`
	WriteTarget     SettingsWriteTargetKind    `json:"write_target,omitempty"`
	WorkspaceID     string                     `json:"workspace_id,omitempty"`
	Behavior        SettingsMutationBehavior   `json:"behavior"`
	Applied         bool                       `json:"applied"`
	RestartRequired bool                       `json:"restart_required"`
	RestartScope    string                     `json:"restart_scope,omitempty"`
	Warnings        []string                   `json:"warnings,omitempty"`
}

type SettingsWorkspaceSectionResponseMetaPayload

type SettingsWorkspaceSectionResponseMetaPayload struct {
	Section         SettingsSectionName          `json:"section"`
	Scope           SettingsWorkspaceScopeKind   `json:"scope"`
	WorkspaceID     string                       `json:"workspace_id,omitempty"`
	AvailableScopes []SettingsWorkspaceScopeKind `json:"available_scopes"`
}

type SettingsWriteTargetKind

type SettingsWriteTargetKind string
const (
	SettingsWriteTargetGlobalConfig        SettingsWriteTargetKind = "global-config"
	SettingsWriteTargetProfileConfig       SettingsWriteTargetKind = "profile-config"
	SettingsWriteTargetWorkspaceConfig     SettingsWriteTargetKind = "workspace-config"
	SettingsWriteTargetGlobalMCPSidecar    SettingsWriteTargetKind = "global-mcp-sidecar"
	SettingsWriteTargetProfileMCPSidecar   SettingsWriteTargetKind = "profile-mcp-sidecar"
	SettingsWriteTargetWorkspaceMCPSidecar SettingsWriteTargetKind = "workspace-mcp-sidecar"
	SettingsWriteTargetGlobalAgentFile     SettingsWriteTargetKind = "global-agent-file"
	SettingsWriteTargetWorkspaceAgentFile  SettingsWriteTargetKind = "workspace-agent-file"
)

type SkillActionResponse

type SkillActionResponse struct {
	OK bool `json:"ok"`
}

SkillActionResponse is the shared skill enable/disable response payload.

type SkillActivationPayload

type SkillActivationPayload struct {
	Active  bool                           `json:"active"`
	Reasons []SkillActivationReasonPayload `json:"reasons,omitempty"`
}

SkillActivationPayload reports whether a skill can activate and why it cannot.

type SkillActivationReasonCode

type SkillActivationReasonCode string

SkillActivationReasonCode identifies a machine-stable reason a skill cannot activate.

const (
	// SkillActivationReasonPlatformMismatch means the current platform fails the skill gate.
	SkillActivationReasonPlatformMismatch SkillActivationReasonCode = "platform_mismatch"
	// SkillActivationReasonEnvironmentContextUnavailable means environment facts could not be evaluated.
	SkillActivationReasonEnvironmentContextUnavailable SkillActivationReasonCode = "environment_context_unavailable"
	// SkillActivationReasonEnvironmentMismatch means the current environment fails the skill gate.
	SkillActivationReasonEnvironmentMismatch SkillActivationReasonCode = "environment_mismatch"
	// SkillActivationReasonToolContextUnavailable means installed-tool facts could not be evaluated.
	SkillActivationReasonToolContextUnavailable SkillActivationReasonCode = "tool_context_unavailable"
	// SkillActivationReasonMissingTool means one or more required tools are unavailable.
	SkillActivationReasonMissingTool SkillActivationReasonCode = "missing_tool"
	// SkillActivationReasonCapabilityContextUnavailable means capability facts could not be evaluated.
	SkillActivationReasonCapabilityContextUnavailable SkillActivationReasonCode = "capability_context_unavailable"
	// SkillActivationReasonMissingCapability means one or more required capabilities are unavailable.
	SkillActivationReasonMissingCapability SkillActivationReasonCode = "missing_capability"
)

type SkillActivationReasonPayload

type SkillActivationReasonPayload struct {
	Gate string `json:"gate"`
	// Code is the machine-stable reason identifier.
	Code SkillActivationReasonCode `json:"code"`
	// Missing lists the required tools or capabilities absent for applicable reason codes.
	Missing []string `json:"missing,omitempty"`
	// Message is operator-facing diagnostic text and is not a stable identifier.
	Message string `json:"message"`
}

SkillActivationReasonPayload describes one failed activation gate.

type SkillContentResponse

type SkillContentResponse struct {
	Content string `json:"content"`
}

SkillContentResponse is the explicit response type for one skill body.

type SkillDiagnosticPayload

type SkillDiagnosticPayload struct {
	Name               string                            `json:"name"`
	State              SkillDiagnosticState              `json:"state"`
	Source             string                            `json:"source,omitempty"`
	Path               string                            `json:"path,omitempty"`
	WinningSource      string                            `json:"winning_source,omitempty"`
	WinningPath        string                            `json:"winning_path,omitempty"`
	VerificationStatus SkillVerificationStatus           `json:"verification_status"`
	Warnings           []SkillVerificationWarningPayload `json:"warnings,omitempty"`
	Failure            *SkillVerificationFailurePayload  `json:"failure,omitzero"`
	ActivationReasons  []SkillActivationReasonPayload    `json:"activation_reasons,omitempty"`
}

type SkillDiagnosticState

type SkillDiagnosticState string
const (
	SkillDiagnosticStateValid              SkillDiagnosticState = "valid"
	SkillDiagnosticStateShadowed           SkillDiagnosticState = "shadowed"
	SkillDiagnosticStateVerificationFailed SkillDiagnosticState = "verification_failed"
	SkillDiagnosticStateInactive           SkillDiagnosticState = "inactive"
)

type SkillExposeResponse

type SkillExposeResponse struct {
	Name        string                             `json:"name"`
	WorkspaceID string                             `json:"workspace_id,omitempty"`
	Results     []SkillExposureTargetResultPayload `json:"results"`
	RolledBack  bool                               `json:"rolled_back"`
}

SkillExposeResponse is the successful expose result.

type SkillExposureErrorPayload

type SkillExposureErrorPayload struct {
	Code       string `json:"code"`
	Message    string `json:"message,omitempty"`
	OccupiedBy string `json:"occupied_by,omitempty"`
}

SkillExposureErrorPayload is one deterministic public exposure failure.

type SkillExposureFailureErrorPayload

type SkillExposureFailureErrorPayload struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}

SkillExposureFailureErrorPayload is the required top-level failure summary.

type SkillExposureFailureResponse

type SkillExposureFailureResponse struct {
	Error       SkillExposureFailureErrorPayload   `json:"error"`
	Name        string                             `json:"name"`
	WorkspaceID string                             `json:"workspace_id,omitempty"`
	Results     []SkillExposureTargetResultPayload `json:"results"`
	RolledBack  *bool                              `json:"rolled_back,omitzero"`
}

SkillExposureFailureResponse is the only expose/unexpose failure envelope.

type SkillExposurePayload

type SkillExposurePayload struct {
	Target string              `json:"target"`
	Path   string              `json:"path"`
	Status SkillExposureStatus `json:"status"`
}

SkillExposurePayload is one provider-root link and its reconciled health.

type SkillExposureRequest

type SkillExposureRequest struct {
	Targets     []string `json:"targets"                binding:"required,min=1,dive,required"`
	WorkspaceID string   `json:"workspace_id,omitempty"`
}

SkillExposureRequest mutates exposure links for one skill.

type SkillExposureStatus

type SkillExposureStatus string

SkillExposureStatus is the reconciled provider-link health vocabulary.

const (
	SkillExposureStatusHealthy         SkillExposureStatus = "healthy"
	SkillExposureStatusMissing         SkillExposureStatus = "missing"
	SkillExposureStatusBroken          SkillExposureStatus = "broken"
	SkillExposureStatusForeignConflict SkillExposureStatus = "foreign_conflict"
)

type SkillExposureTargetResultPayload

type SkillExposureTargetResultPayload struct {
	Target       string                     `json:"target"`
	OK           bool                       `json:"ok"`
	Exposure     *SkillExposurePayload      `json:"exposure,omitzero"`
	Error        *SkillExposureErrorPayload `json:"error,omitzero"`
	CleanupError *SkillExposureErrorPayload `json:"cleanup_error,omitzero"`
}

SkillExposureTargetResultPayload reports one target without hiding partial outcomes.

type SkillPayload

type SkillPayload struct {
	Name        string                   `json:"name"`
	Description string                   `json:"description"`
	Version     string                   `json:"version,omitempty"`
	Source      string                   `json:"source"`
	Origin      string                   `json:"origin"`
	OwnerScope  string                   `json:"owner_scope"`
	OwnerID     string                   `json:"owner_id,omitempty"`
	Enabled     bool                     `json:"enabled"`
	Activation  SkillActivationPayload   `json:"activation"`
	Dir         string                   `json:"dir"`
	Metadata    map[string]any           `json:"metadata,omitempty"`
	Provenance  *ProvenancePayload       `json:"provenance,omitzero"`
	Diagnostics []SkillDiagnosticPayload `json:"diagnostics,omitempty"`
	Exposures   *[]SkillExposurePayload  `json:"exposures,omitzero"`
}

SkillPayload is the HTTP response type for a skill.

type SkillResponse

type SkillResponse struct {
	Skill SkillPayload `json:"skill"`
}

SkillResponse wraps one shared skill payload.

type SkillRuntimeStatusPayload

type SkillRuntimeStatusPayload struct {
	RuntimeAvailable bool                     `json:"runtime_available"`
	DiscoveredCount  int                      `json:"discovered_count"`
	DisabledCount    int                      `json:"disabled_count"`
	Diagnostics      []SkillDiagnosticPayload `json:"diagnostics,omitempty"`
}

SkillRuntimeStatusPayload summarizes the skill registry's availability.

type SkillShadowEntryPayload

type SkillShadowEntryPayload struct {
	Path             string    `json:"path"`
	Tier             string    `json:"tier"`
	Origin           string    `json:"origin,omitempty"`
	ResolvedToWinner bool      `json:"resolved_to_winner"`
	DetectedAt       time.Time `json:"detected_at"`
}

type SkillShadowsResponse

type SkillShadowsResponse struct {
	Name    string                    `json:"name"`
	Winner  SkillShadowEntryPayload   `json:"winner"`
	Shadows []SkillShadowEntryPayload `json:"shadows"`
}

SkillShadowsResponse wraps the resolver shadow evidence for one skill name.

type SkillSourceValidationErrorPayload

type SkillSourceValidationErrorPayload struct {
	Code           string   `json:"code"`
	Message        string   `json:"message"`
	Field          string   `json:"field,omitempty"`
	Path           string   `json:"path,omitempty"`
	ExistingSource string   `json:"existing_source,omitempty"`
	Valid          []string `json:"valid,omitempty"`
	Suggestion     string   `json:"suggestion,omitempty"`
}

SkillSourceValidationErrorPayload is one portable skill-source policy failure.

type SkillSourceValidationErrorResponse

type SkillSourceValidationErrorResponse struct {
	Error SkillSourceValidationErrorPayload `json:"error"`
}

SkillSourceValidationErrorResponse wraps a portable skill-source failure.

type SkillUnexposeResponse

type SkillUnexposeResponse struct {
	Name        string                             `json:"name"`
	WorkspaceID string                             `json:"workspace_id,omitempty"`
	Results     []SkillExposureTargetResultPayload `json:"results"`
}

SkillUnexposeResponse is the successful independent removal result.

type SkillVerificationFailurePayload

type SkillVerificationFailurePayload struct {
	Code         string `json:"code"`
	Message      string `json:"message"`
	ExpectedHash string `json:"expected_hash,omitempty"`
	ActualHash   string `json:"actual_hash,omitempty"`
}

type SkillVerificationStatus

type SkillVerificationStatus string
const (
	SkillVerificationStatusPassed  SkillVerificationStatus = "passed"
	SkillVerificationStatusWarning SkillVerificationStatus = "warning"
	SkillVerificationStatusFailed  SkillVerificationStatus = "failed"
)

type SkillVerificationWarningPayload

type SkillVerificationWarningPayload struct {
	Severity string `json:"severity"`
	Pattern  string `json:"pattern,omitempty"`
	Message  string `json:"message"`
}

type SkillsResponse

type SkillsResponse struct {
	Skills []SkillPayload `json:"skills"`
}

SkillsResponse wraps the shared skill list payload.

type SpawnBudgetPayload

type SpawnBudgetPayload struct {
	MaxChildren           int   `json:"max_children"`
	MaxDepth              int   `json:"max_depth"`
	TTLSeconds            int64 `json:"ttl_seconds"`
	MaxActivePerWorkspace int   `json:"max_active_per_workspace,omitempty"`
}

SpawnBudgetPayload is the transport read model for bounded spawn limits. It reports the effective budget the daemon enforces for this session's own governed children; unset caps resolve to the daemon defaults.

type SpawnNewWorktreeRequest

type SpawnNewWorktreeRequest struct {
	Name    string `json:"name,omitempty"`
	BaseRef string `json:"base_ref,omitempty"`
	Branch  string `json:"branch,omitempty"`
}

SpawnNewWorktreeRequest names the managed worktree created for a spawned child.

type SpawnPermissionPolicyPayload

type SpawnPermissionPolicyPayload struct {
	Tools          []string `json:"tools"`
	Skills         []string `json:"skills"`
	MCPServers     []string `json:"mcp_servers"`
	WorkspacePaths []string `json:"workspace_paths"`
}

SpawnPermissionPolicyPayload captures concrete permission atoms available to a spawned session.

func NormalizeSpawnPermissionPolicyPayload

func NormalizeSpawnPermissionPolicyPayload(payload SpawnPermissionPolicyPayload) SpawnPermissionPolicyPayload

NormalizeSpawnPermissionPolicyPayload returns a permission policy with stable empty arrays.

type SpawnPermissionRequestPayload

type SpawnPermissionRequestPayload struct {
	Tools          []string `json:"tools,omitzero"`
	Skills         []string `json:"skills,omitzero"`
	MCPServers     []string `json:"mcp_servers,omitzero"`
	WorkspacePaths []string `json:"workspace_paths,omitzero"`
}

SpawnPermissionRequestPayload is the requested spawn permission narrowing. An absent list stays distinct from an empty one: with inherit_permissions it keeps the caller's grant, while [] grants nothing.

func (SpawnPermissionRequestPayload) Policy

Policy returns the literal requested atoms as a policy payload.

type SpawnPromptPayload

type SpawnPromptPayload struct {
	MessageID       string `json:"message_id"`
	Status          string `json:"status"`
	ReplyWatchID    string `json:"reply_watch_id,omitempty"`
	ReplyWatchState string `json:"reply_watch_state,omitempty"`
	// Error explains a first prompt that failed after the child was created; the child
	// stays live, so retry with session_prompt instead of spawning again.
	Error string `json:"error,omitempty"`
}

SpawnPromptPayload reports the admitted first prompt of a spawned child.

type SpawnWorktreePayload

type SpawnWorktreePayload struct {
	ID      string `json:"id"`
	Name    string `json:"name"`
	Branch  string `json:"branch"`
	Path    string `json:"path"`
	BaseSHA string `json:"base_sha,omitempty"`
	Created bool   `json:"created"`
}

SpawnWorktreePayload identifies the worktree bound to a spawned child.

type Speed

type Speed = speedpkg.Speed

Speed is the provider-neutral runtime speed vocabulary.

type SpeedResolution

type SpeedResolution = speedpkg.Resolution

SpeedResolution is the confirmed ACP speed outcome.

type SpeedResolutionReason

type SpeedResolutionReason = speedpkg.ResolutionReason

SpeedResolutionReason explains a non-applied ACP speed outcome.

type SpeedResolutionStatus

type SpeedResolutionStatus = speedpkg.ResolutionStatus

SpeedResolutionStatus is the confirmed ACP speed outcome state.

type StartTaskRunRequest

type StartTaskRunRequest struct {
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

StartTaskRunRequest is the shared run-start request payload.

type StatusPayload

type StatusPayload struct {
	SchemaVersion    string                           `json:"schema_version"`
	GeneratedAt      time.Time                        `json:"generated_at"`
	Daemon           DaemonStatusPayload              `json:"daemon"`
	Sessions         SessionAggregatePayload          `json:"sessions"`
	SubprocessHealth SubprocessHealthAggregatePayload `json:"subprocess_health"`
	Health           ObserveHealthPayload             `json:"health"`
	Automation       AutomationHealthPayload          `json:"automation"`
	Tasks            TaskHealthPayload                `json:"tasks"`
	Providers        []ProviderStatusPayload          `json:"providers,omitempty"`
	MCPServers       []MCPServerStatusPayload         `json:"mcp_servers,omitempty"`
	Skills           SkillRuntimeStatusPayload        `json:"skills"`
	Config           ConfigRuntimeStatusPayload       `json:"config"`
	LogTail          LogTailStatusPayload             `json:"log_tail"`
}

StatusPayload is the hard-cut runtime status surface shared by HTTP, UDS, and CLI JSON.

type SteerPromptRequest

type SteerPromptRequest struct {
	Attachments    []PromptAttachmentRef `json:"attachments,omitempty"`
	Text           string                `json:"text"`
	MessageID      string                `json:"message_id"`
	IdempotencyKey string                `json:"idempotency_key"`
	ExpectedTurnID string                `json:"expected_turn_id,omitempty"`
}

SteerPromptRequest captures replacement guidance for a fenced active session turn.

func (SteerPromptRequest) Validate

func (r SteerPromptRequest) Validate() error

Validate checks the required identity and authored text for steering input.

type StopSessionRequest

type StopSessionRequest struct {
	Processes SessionProcessPolicy `json:"processes,omitempty"`
	Wait      *bool                `json:"wait,omitzero"`
}

StopSessionRequest selects asynchronous acceptance or a verified stop result.

type StuckTaskRunPayload

type StuckTaskRunPayload struct {
	TaskID     string `json:"task_id"`
	RunID      string `json:"run_id"`
	Status     string `json:"status"`
	OriginKind string `json:"origin_kind"`
	SessionID  string `json:"session_id,omitempty"`
	AgeMillis  int64  `json:"age_ms"`
}

type SubagentCancelPayload

type SubagentCancelPayload struct {
	SubagentID string `json:"subagent_id"`
	Status     string `json:"status"`
}

type SubagentCancelRequest

type SubagentCancelRequest struct {
	Reason string `json:"reason"`
}

type SubagentChildActivity

type SubagentChildActivity string

SubagentChildActivity is a delegated child session's liveness: working, idle, or stopped.

type SubagentListPayload

type SubagentListPayload struct {
	Subagents  []SubagentPayload `json:"subagents"`
	NextCursor *string           `json:"next_cursor"`
}

type SubagentPayload

type SubagentPayload struct {
	Isolation          string                   `json:"isolation"`
	Worktree           *SubagentWorktreePayload `json:"worktree,omitempty"`
	SubagentID         string                   `json:"subagent_id"`
	WorkspaceID        string                   `json:"workspace_id"`
	ParentSessionID    string                   `json:"parent_session_id"`
	ParentTurnID       string                   `json:"parent_turn_id"`
	ChildSessionID     *string                  `json:"child_session_id"`
	Origin             string                   `json:"origin"`
	ProviderToolCallID *string                  `json:"provider_tool_call_id"`
	Title              string                   `json:"title"`
	Role               string                   `json:"role"`
	Status             string                   `json:"status"`
	WorkState          string                   `json:"work_state"`
	// ChildActivity is the delegated child session's liveness (working, idle,
	// stopped), independent of the delegation's terminal status. Omitted for
	// provider-native rows and rows recorded before the field existed.
	ChildActivity SubagentChildActivity  `json:"child_activity,omitempty"`
	Runtime       SubagentRuntimePayload `json:"runtime"`
	// Usage is omitted until the provider reports one, and for delegated rows.
	Usage           *SubagentUsagePayload `json:"usage,omitempty"`
	Depth           int                   `json:"depth"`
	Progress        string                `json:"progress"`
	Result          *string               `json:"result"`
	ResultPreview   string                `json:"result_preview"`
	ResultTruncated bool                  `json:"result_truncated"`
	Error           *string               `json:"error"`
	WaitTimedOut    bool                  `json:"wait_timed_out"`
	Hint            string                `json:"hint,omitempty"`
	Delivery        string                `json:"delivery"`
	StartedAt       *time.Time            `json:"started_at"`
	SettledAt       *time.Time            `json:"settled_at"`
	CreatedAt       time.Time             `json:"created_at"`
	UpdatedAt       time.Time             `json:"updated_at"`
}

func SubagentFromDomain

func SubagentFromDomain(row *session.Subagent) SubagentPayload

type SubagentPullRequestPayload

type SubagentPullRequestPayload struct {
	URL    string `json:"url"`
	Number int    `json:"number"`
	State  string `json:"state"`
}

type SubagentRuntimePayload

type SubagentRuntimePayload struct {
	Agent           string `json:"agent"`
	Provider        string `json:"provider"`
	Model           string `json:"model"`
	ReasoningEffort string `json:"reasoning_effort"`
	Speed           string `json:"speed"`
}

type SubagentSummaryPayload

type SubagentSummaryPayload struct {
	Live       int    `json:"live"`
	Total      int    `json:"total"`
	Failed     int    `json:"failed"`
	Attention  int    `json:"attention"`
	MostUrgent string `json:"most_urgent"`
}

func SubagentSummaryFromStore

func SubagentSummaryFromStore(summary store.SubagentSummary) *SubagentSummaryPayload

type SubagentUpdatedEvent

type SubagentUpdatedEvent struct {
	SessionID string          `json:"session_id"`
	Subagent  SubagentPayload `json:"subagent"`
}

type SubagentUsagePayload

type SubagentUsagePayload struct {
	TotalTokens int64 `json:"total_tokens"`
	ToolUses    int64 `json:"tool_uses"`
}

SubagentUsagePayload is what the provider reports a subagent has spent so far.

type SubagentWorktreePayload

type SubagentWorktreePayload struct {
	ID                string                      `json:"id"`
	Name              string                      `json:"name"`
	Branch            string                      `json:"branch"`
	BaseRef           string                      `json:"base_ref"`
	BaseSHA           string                      `json:"base_sha,omitempty"`
	Path              string                      `json:"path"`
	HeadSHA           string                      `json:"head_sha,omitempty"`
	CommitsAhead      *int                        `json:"commits_ahead,omitempty"`
	DirtyFiles        *int                        `json:"dirty_files,omitempty"`
	ObservedAt        *time.Time                  `json:"observed_at,omitempty"`
	PullRequestStatus string                      `json:"pull_request_status,omitempty"`
	PullRequest       *SubagentPullRequestPayload `json:"pull_request,omitempty"`
}

type SubagentsSnapshotEvent

type SubagentsSnapshotEvent struct {
	SessionID string            `json:"session_id"`
	Subagents []SubagentPayload `json:"subagents"`
}

type SubmitTaskRunReviewVerdictRequest

type SubmitTaskRunReviewVerdictRequest struct {
	RunID   string                   `json:"run_id"`
	Verdict taskpkg.RunReviewVerdict `json:"verdict"`
}

SubmitTaskRunReviewVerdictRequest captures one persisted reviewer verdict write.

type SubprocessHealthAggregatePayload

type SubprocessHealthAggregatePayload struct {
	Status    string                           `json:"status"`
	Monitored int                              `json:"monitored"`
	Healthy   int                              `json:"healthy"`
	Unhealthy int                              `json:"unhealthy"`
	Sessions  []SubprocessHealthSessionPayload `json:"sessions,omitempty"`
}

SubprocessHealthAggregatePayload summarizes active ACP subprocess health.

type SubprocessHealthSessionPayload

type SubprocessHealthSessionPayload struct {
	SessionID           string     `json:"session_id"`
	WorkspaceID         string     `json:"workspace_id"`
	AgentName           string     `json:"agent_name"`
	ConsecutiveFailures int        `json:"consecutive_failures"`
	LastCheckedAt       *time.Time `json:"last_checked_at,omitempty"`
	Reason              string     `json:"reason,omitempty"`
}

SubprocessHealthSessionPayload identifies one active session with a failed verdict.

type SupportBundleManifestArtifactPayload

type SupportBundleManifestArtifactPayload struct {
	Path             string `json:"path"`
	Included         bool   `json:"included"`
	OmittedReason    string `json:"omitted_reason,omitempty"`
	Bytes            int64  `json:"bytes"`
	Truncated        bool   `json:"truncated"`
	RedactionVersion string `json:"redaction_version,omitempty"`
}

type SupportBundleManifestPayload

type SupportBundleManifestPayload struct {
	SchemaVersion        string                                 `json:"schema_version"`
	OperationID          string                                 `json:"operation_id"`
	CreatedAt            time.Time                              `json:"created_at"`
	BundleMaxBytes       int64                                  `json:"bundle_max_bytes"`
	ArtifactMaxBytes     int64                                  `json:"artifact_max_bytes"`
	LogTailMaxBytes      int64                                  `json:"log_tail_max_bytes"`
	EventSummaryMaxBytes int64                                  `json:"event_summary_max_bytes"`
	RedactionVersion     string                                 `json:"redaction_version"`
	Artifacts            []SupportBundleManifestArtifactPayload `json:"artifacts"`
}

type SupportBundleOperationPayload

type SupportBundleOperationPayload struct {
	OperationID   string                        `json:"operation_id"`
	Status        string                        `json:"status"`
	StatusURL     string                        `json:"status_url"`
	DownloadURL   string                        `json:"download_url,omitempty"`
	FileName      string                        `json:"file_name,omitempty"`
	SizeBytes     int64                         `json:"size_bytes,omitzero"`
	Manifest      *SupportBundleManifestPayload `json:"manifest,omitzero"`
	FailureReason string                        `json:"failure_reason,omitempty"`
	CreatedAt     time.Time                     `json:"created_at"`
	UpdatedAt     time.Time                     `json:"updated_at"`
	CompletedAt   *time.Time                    `json:"completed_at,omitempty"`
}

type SupportBundleOperationResponse

type SupportBundleOperationResponse struct {
	Operation SupportBundleOperationPayload `json:"operation"`
}

type TaskBlockPayload

type TaskBlockPayload struct {
	ID          string                 `json:"id"`
	TaskID      string                 `json:"task_id"`
	WorkspaceID string                 `json:"workspace_id,omitempty"`
	Kind        taskpkg.BlockKind      `json:"kind"`
	Reason      string                 `json:"reason"`
	Details     json.RawMessage        `json:"details,omitempty"`
	CreatedAt   time.Time              `json:"created_at"`
	CreatedBy   taskpkg.ActorIdentity  `json:"created_by"`
	ExpiresAt   *time.Time             `json:"expires_at,omitempty"`
	ClearedAt   *time.Time             `json:"cleared_at,omitempty"`
	ClearedBy   *taskpkg.ActorIdentity `json:"cleared_by,omitempty"`
	ClearNote   string                 `json:"clear_note,omitempty"`
}

TaskBlockPayload is the public task-block read model.

type TaskBlockResponse

type TaskBlockResponse struct {
	Block TaskBlockPayload `json:"block"`
}

TaskBlockResponse wraps one task-block payload.

type TaskBlocksResponse

type TaskBlocksResponse struct {
	Blocks []TaskBlockPayload `json:"blocks"`
}

TaskBlocksResponse wraps a task-block list.

type TaskCatalogFacetsPayload

type TaskCatalogFacetsPayload struct {
	Statuses []TaskCatalogStatusFacetPayload `json:"statuses"`
	Owners   []TaskCatalogOwnerFacetPayload  `json:"owners"`
}

TaskCatalogFacetsPayload contains exact counts computed before the cursor cut.

type TaskCatalogItemPayload

type TaskCatalogItemPayload struct {
	ID                   string                 `json:"id"`
	ProfileID            string                 `json:"profile_id"`
	ProfileName          string                 `json:"profile_name"`
	ProfileColor         string                 `json:"profile_color,omitempty"`
	ProfileIcon          string                 `json:"profile_icon,omitempty"`
	Identifier           string                 `json:"identifier,omitempty"`
	Scope                taskpkg.Scope          `json:"scope"`
	WorkspaceID          string                 `json:"workspace_id,omitempty"`
	ParentTaskID         string                 `json:"parent_task_id,omitempty"`
	Title                string                 `json:"title"`
	Priority             taskpkg.Priority       `json:"priority,omitempty"`
	MaxAttempts          int                    `json:"max_attempts,omitempty"`
	AutoEnqueueOnReady   bool                   `json:"auto_enqueue_on_ready,omitempty"`
	Status               taskpkg.Status         `json:"status"`
	ApprovalPolicy       taskpkg.ApprovalPolicy `json:"approval_policy,omitempty"`
	ApprovalState        taskpkg.ApprovalState  `json:"approval_state,omitempty"`
	Draft                bool                   `json:"draft,omitempty"`
	Owner                *taskpkg.Ownership     `json:"owner,omitempty"`
	CurrentRunID         string                 `json:"current_run_id,omitempty"`
	LatestEventSeq       int64                  `json:"latest_event_seq"`
	NeedsAttention       bool                   `json:"needs_attention,omitempty"`
	NeedsAttentionReason string                 `json:"needs_attention_reason,omitempty"`
	NeedsAttentionAt     *time.Time             `json:"needs_attention_at,omitempty"`
	NeedsAttentionBy     *taskpkg.ActorIdentity `json:"needs_attention_by,omitempty"`
	WakeCreator          bool                   `json:"wake_creator"`
	CreatedBy            taskpkg.ActorIdentity  `json:"created_by"`
	Origin               taskpkg.Origin         `json:"origin"`
	CreatedAt            time.Time              `json:"created_at"`
	UpdatedAt            time.Time              `json:"updated_at"`
	ClosedAt             *time.Time             `json:"closed_at,omitempty"`
	ChildCount           int                    `json:"child_count,omitempty"`
	DependencyCount      int                    `json:"dependency_count,omitempty"`
	ActiveRun            *TaskCatalogRunPayload `json:"active_run,omitempty"`
	LastActivityAt       *time.Time             `json:"last_activity_at,omitempty"`
	Loop                 *LoopProvenance        `json:"loop,omitempty"`
}

TaskCatalogItemPayload is one lean task catalog row.

func TaskCatalogItemPayloadFromSummary

func TaskCatalogItemPayloadFromSummary(record *taskpkg.Summary) TaskCatalogItemPayload

TaskCatalogItemPayloadFromSummary converts one bounded domain catalog row.

type TaskCatalogOwnerFacetPayload

type TaskCatalogOwnerFacetPayload struct {
	Owner taskpkg.Ownership `json:"owner"`
	Count int               `json:"count"`
}

TaskCatalogOwnerFacetPayload is one exact owner count after all filters.

type TaskCatalogRunPayload

type TaskCatalogRunPayload struct {
	ID                   string                 `json:"id"`
	TaskID               string                 `json:"task_id"`
	Status               taskpkg.RunStatus      `json:"status"`
	Attempt              int                    `json:"attempt"`
	RecoveryCount        int                    `json:"recovery_count"`
	PreviousRunID        string                 `json:"previous_run_id,omitempty"`
	FailureKind          string                 `json:"failure_kind,omitempty"`
	MaxAttempts          int                    `json:"max_attempts"`
	SessionID            string                 `json:"session_id,omitempty"`
	WorktreeID           string                 `json:"worktree_id,omitempty"`
	ResolvedWorktreeMode ResolvedWorktreeMode   `json:"resolved_worktree_mode"`
	ResolvedWorktreeRef  string                 `json:"resolved_worktree_ref,omitempty"`
	ClaimedBy            *taskpkg.ActorIdentity `json:"claimed_by,omitempty"`
	LeaseUntil           *time.Time             `json:"lease_until,omitempty"`
	HeartbeatAt          *time.Time             `json:"heartbeat_at,omitempty"`
	QueuedAt             time.Time              `json:"queued_at"`
	ClaimedAt            *time.Time             `json:"claimed_at,omitempty"`
	StartedAt            *time.Time             `json:"started_at,omitempty"`
	EndedAt              *time.Time             `json:"ended_at,omitempty"`
	Error                string                 `json:"error,omitempty"`
}

TaskCatalogRunPayload is the bounded run summary embedded in catalog and inbox rows.

func TaskCatalogRunPayloadFromSummary

func TaskCatalogRunPayloadFromSummary(summary *taskpkg.RunSummary) *TaskCatalogRunPayload

TaskCatalogRunPayloadFromSummary converts one bounded catalog run summary.

type TaskCatalogStatusFacetPayload

type TaskCatalogStatusFacetPayload struct {
	Status taskpkg.Status `json:"status"`
	Count  int            `json:"count"`
}

TaskCatalogStatusFacetPayload is one exact status count after all filters.

type TaskDashboardActiveRunPayload

type TaskDashboardActiveRunPayload struct {
	TaskID         string             `json:"task_id"`
	TaskIdentifier string             `json:"task_identifier,omitempty"`
	TaskTitle      string             `json:"task_title"`
	TaskStatus     taskpkg.Status     `json:"task_status"`
	TaskPriority   taskpkg.Priority   `json:"task_priority,omitempty"`
	TaskOwner      *taskpkg.Ownership `json:"task_owner,omitempty"`
	Scope          taskpkg.Scope      `json:"scope"`
	WorkspaceID    string             `json:"workspace_id,omitempty"`
	LatestEventSeq int64              `json:"latest_event_seq"`
	RunID          string             `json:"run_id"`
	RunStatus      taskpkg.RunStatus  `json:"run_status"`
	Attempt        int                `json:"attempt"`
	MaxAttempts    int                `json:"max_attempts"`
	SessionID      string             `json:"session_id,omitempty"`
	LastActivityAt time.Time          `json:"last_activity_at"`
	AgeMilli       int64              `json:"age_ms"`
	HealthStatus   string             `json:"health_status"`
	Stuck          bool               `json:"stuck"`
	Error          string             `json:"error,omitempty"`
}

TaskDashboardActiveRunPayload exposes one recent active-run card payload.

type TaskDashboardActiveRunsPayload

type TaskDashboardActiveRunsPayload struct {
	Total    int                             `json:"total"`
	Running  int                             `json:"running"`
	Starting int                             `json:"starting"`
	Claimed  int                             `json:"claimed"`
	Queued   int                             `json:"queued"`
	Items    []TaskDashboardActiveRunPayload `json:"items,omitempty"`
}

TaskDashboardActiveRunsPayload summarizes the currently active run set and recent cards.

type TaskDashboardBlockedCardPayload

type TaskDashboardBlockedCardPayload struct {
	Tasks                int    `json:"tasks"`
	AwaitingApproval     int    `json:"awaiting_approval"`
	AwaitingDependencies int    `json:"awaiting_dependencies"`
	HealthStatus         string `json:"health_status"`
}

TaskDashboardBlockedCardPayload summarizes approval and dependency pressure.

type TaskDashboardCardsPayload

type TaskDashboardCardsPayload struct {
	InProgress TaskDashboardInProgressCardPayload `json:"in_progress"`
	Blocked    TaskDashboardBlockedCardPayload    `json:"blocked"`
	Failed     TaskDashboardFailedCardPayload     `json:"failed"`
	Latency    TaskDashboardLatencyCardPayload    `json:"latency"`
}

TaskDashboardCardsPayload exposes dashboard-ready card values.

type TaskDashboardFailedCardPayload

type TaskDashboardFailedCardPayload struct {
	Tasks        int    `json:"tasks"`
	FailedRuns   int    `json:"failed_runs"`
	ForcedStops  int    `json:"forced_stops"`
	HealthStatus string `json:"health_status"`
}

TaskDashboardFailedCardPayload summarizes failed work and disruptive run outcomes.

type TaskDashboardFreshnessPayload

type TaskDashboardFreshnessPayload struct {
	ObservedAt       time.Time `json:"observed_at"`
	LatestActivityAt time.Time `json:"latest_activity_at"`
	AgeMilli         int64     `json:"age_ms"`
	StaleAfterMilli  int64     `json:"stale_after_ms"`
	HasLiveWork      bool      `json:"has_live_work"`
	Status           string    `json:"status"`
	Stale            bool      `json:"stale"`
}

TaskDashboardFreshnessPayload exposes recency and stale-warning state for the dashboard snapshot.

type TaskDashboardHealthPayload

type TaskDashboardHealthPayload struct {
	Status           string `json:"status"`
	StuckRuns        int    `json:"stuck_runs"`
	ActiveOrphanRuns int    `json:"active_orphan_runs"`
	QueueBacklog     bool   `json:"queue_backlog"`
}

TaskDashboardHealthPayload exposes warning-oriented dashboard health indicators.

type TaskDashboardInProgressCardPayload

type TaskDashboardInProgressCardPayload struct {
	Tasks        int    `json:"tasks"`
	ActiveRuns   int    `json:"active_runs"`
	RunningRuns  int    `json:"running_runs"`
	StartingRuns int    `json:"starting_runs"`
	ClaimedRuns  int    `json:"claimed_runs"`
	QueuedRuns   int    `json:"queued_runs"`
	HealthStatus string `json:"health_status"`
}

TaskDashboardInProgressCardPayload summarizes active work and live-run pressure.

type TaskDashboardLatencyCardPayload

type TaskDashboardLatencyCardPayload struct {
	ClaimLatencyMillis TaskLatencyMetricPayload `json:"claim_latency_ms"`
	StartLatencyMillis TaskLatencyMetricPayload `json:"start_latency_ms"`
}

TaskDashboardLatencyCardPayload exposes queue and start latency summaries.

type TaskDashboardPayload

type TaskDashboardPayload struct {
	Totals          TaskDashboardTotalsPayload            `json:"totals"`
	Cards           TaskDashboardCardsPayload             `json:"cards"`
	StatusBreakdown []TaskDashboardStatusBreakdownPayload `json:"status_breakdown,omitempty"`
	Queue           TaskDashboardQueuePayload             `json:"queue"`
	Health          TaskDashboardHealthPayload            `json:"health"`
	ActiveRuns      TaskDashboardActiveRunsPayload        `json:"active_runs"`
	Freshness       TaskDashboardFreshnessPayload         `json:"freshness"`
}

TaskDashboardPayload is the observer-backed task dashboard response payload.

type TaskDashboardQuery

type TaskDashboardQuery struct {
	AllWorkspaces bool               `json:"all_workspaces,omitzero"`
	WorkspaceIDs  []string           `json:"workspace_ids,omitempty"`
	Scope         taskpkg.Scope      `json:"scope,omitempty"`
	Workspace     string             `json:"workspace,omitempty"`
	Worktree      string             `json:"worktree,omitempty"`
	OwnerKind     taskpkg.OwnerKind  `json:"owner_kind,omitempty"`
	OwnerRef      string             `json:"owner_ref,omitempty"`
	OriginKind    taskpkg.OriginKind `json:"origin_kind,omitempty"`
}

TaskDashboardQuery captures the shared observer-backed task dashboard filters.

type TaskDashboardQueueDepthPayload

type TaskDashboardQueueDepthPayload struct {
	Count               int       `json:"count"`
	OldestQueuedAt      time.Time `json:"oldest_queued_at"`
	OldestQueueAgeMilli int64     `json:"oldest_queue_age_ms"`
}

TaskDashboardQueueDepthPayload reports queued work by channel.

type TaskDashboardQueuePayload

type TaskDashboardQueuePayload struct {
	Total                 int                              `json:"total"`
	Depth                 []TaskDashboardQueueDepthPayload `json:"depth,omitempty"`
	OldestQueuedAt        time.Time                        `json:"oldest_queued_at"`
	OldestQueueAgeMilli   int64                            `json:"oldest_queue_age_ms"`
	BacklogWarning        bool                             `json:"backlog_warning"`
	BacklogStatus         string                           `json:"backlog_status"`
	BacklogThresholdMilli int64                            `json:"backlog_threshold_ms"`
}

TaskDashboardQueuePayload reports current queue backlog state.

type TaskDashboardResponse

type TaskDashboardResponse struct {
	Dashboard TaskDashboardPayload `json:"dashboard"`
}

TaskDashboardResponse wraps the shared task dashboard payload.

type TaskDashboardStatusBreakdownPayload

type TaskDashboardStatusBreakdownPayload struct {
	Status       taskpkg.Status `json:"status"`
	Count        int            `json:"count"`
	SharePercent int            `json:"share_percent"`
}

TaskDashboardStatusBreakdownPayload reports one aggregated task-status bucket.

type TaskDashboardTotalsPayload

type TaskDashboardTotalsPayload struct {
	TasksTotal             int `json:"tasks_total"`
	RunsTotal              int `json:"runs_total"`
	DraftTasks             int `json:"draft_tasks"`
	PendingTasks           int `json:"pending_tasks"`
	ReadyTasks             int `json:"ready_tasks"`
	InProgressTasks        int `json:"in_progress_tasks"`
	BlockedTasks           int `json:"blocked_tasks"`
	CompletedTasks         int `json:"completed_tasks"`
	FailedTasks            int `json:"failed_tasks"`
	CanceledTasks          int `json:"canceled_tasks"`
	AwaitingApprovalTasks  int `json:"awaiting_approval_tasks"`
	DependencyBlockedTasks int `json:"dependency_blocked_tasks"`
	QueuedRuns             int `json:"queued_runs"`
	ClaimedRuns            int `json:"claimed_runs"`
	StartingRuns           int `json:"starting_runs"`
	RunningRuns            int `json:"running_runs"`
	CompletedRuns          int `json:"completed_runs"`
	FailedRuns             int `json:"failed_runs"`
	CanceledRuns           int `json:"canceled_runs"`
	ActiveRuns             int `json:"active_runs"`
}

TaskDashboardTotalsPayload collapses current task and run totals into operator-facing counters.

type TaskDependencyPayload

type TaskDependencyPayload struct {
	TaskID          string                 `json:"task_id"`
	DependsOnTaskID string                 `json:"depends_on_task_id"`
	Kind            taskpkg.DependencyKind `json:"kind"`
	CreatedAt       time.Time              `json:"created_at"`
}

TaskDependencyPayload is the shared dependency-edge response payload.

type TaskDependencyReferencePayload

type TaskDependencyReferencePayload struct {
	TaskID          string                 `json:"task_id"`
	DependsOnTaskID string                 `json:"depends_on_task_id"`
	Kind            taskpkg.DependencyKind `json:"kind"`
	CreatedAt       time.Time              `json:"created_at"`
	DependsOn       TaskReferencePayload   `json:"depends_on"`
}

TaskDependencyReferencePayload enriches one dependency edge with the referenced blocker identity.

type TaskDesignationRollupPayload

type TaskDesignationRollupPayload struct {
	DesignationGroupID string          `json:"designation_group_id"`
	TaskID             string          `json:"task_id"`
	Summary            json.RawMessage `json:"summary"`
	CreatedAt          time.Time       `json:"created_at"`
}

TaskDesignationRollupPayload exposes the persisted summary for one designated run group.

type TaskDetailPayload

type TaskDetailPayload struct {
	Summary              TaskSummaryPayload               `json:"summary"`
	Task                 TaskPayload                      `json:"task"`
	Children             []TaskSummaryPayload             `json:"children,omitempty"`
	Dependencies         []TaskDependencyPayload          `json:"dependencies,omitempty"`
	DependencyReferences []TaskDependencyReferencePayload `json:"dependency_references,omitempty"`
	Runs                 []TaskRunPayload                 `json:"runs,omitempty"`
	DesignationRollups   []TaskDesignationRollupPayload   `json:"designation_rollups,omitempty"`
	Events               []TaskEventPayload               `json:"events,omitempty"`
}

TaskDetailPayload is the shared expanded task response payload.

type TaskDetailResponse

type TaskDetailResponse struct {
	Task TaskDetailPayload `json:"task"`
}

TaskDetailResponse wraps one shared expanded task payload.

type TaskEventPayload

type TaskEventPayload struct {
	ID        string                `json:"id"`
	TaskID    string                `json:"task_id"`
	RunID     string                `json:"run_id,omitempty"`
	EventType string                `json:"event_type"`
	Actor     taskpkg.ActorIdentity `json:"actor"`
	Origin    taskpkg.Origin        `json:"origin"`
	Payload   json.RawMessage       `json:"payload,omitempty"`
	Timestamp time.Time             `json:"timestamp"`
}

TaskEventPayload is the shared task audit-event response payload.

type TaskExecutionProfilePayload

type TaskExecutionProfilePayload = taskpkg.ExecutionProfile

TaskExecutionProfilePayload is the task-owned orchestration profile read model.

type TaskExecutionProfileResponse

type TaskExecutionProfileResponse struct {
	Profile TaskExecutionProfilePayload `json:"profile"`
}

TaskExecutionProfileResponse wraps one execution profile response.

type TaskExecutionRequest

type TaskExecutionRequest struct {
	IdempotencyKey string          `json:"idempotency_key,omitempty"`
	Metadata       json.RawMessage `json:"metadata,omitempty"`
}

TaskExecutionRequest is the shared task publish/start/approval execution payload.

type TaskExecutionResponse

type TaskExecutionResponse struct {
	Task TaskPayload    `json:"task"`
	Run  TaskRunPayload `json:"run"`
}

TaskExecutionResponse wraps one explicit task execution-boundary result.

type TaskFanOutRunDesignationRequest

type TaskFanOutRunDesignationRequest struct {
	Brief          string          `json:"brief"`
	Metadata       json.RawMessage `json:"metadata,omitempty"`
	IdempotencyKey string          `json:"idempotency_key,omitempty"`
}

TaskFanOutRunDesignationRequest describes one designated sibling run.

type TaskHealthPayload

type TaskHealthPayload struct {
	Status                string                    `json:"status"`
	QueueDepthTotal       int                       `json:"queue_depth_total"`
	OldestQueuedAt        *time.Time                `json:"oldest_queued_at,omitempty"`
	OldestQueueAgeMilli   int64                     `json:"oldest_queue_age_ms"`
	QueueDepth            []TaskQueueDepthPayload   `json:"queue_depth,omitempty"`
	StuckRuns             []StuckTaskRunPayload     `json:"stuck_runs,omitempty"`
	ActiveOrphanRuns      int                       `json:"active_orphan_runs"`
	TaskTotals            []TaskStatusTotalPayload  `json:"task_totals,omitempty"`
	RunTotals             []TaskRunTotalPayload     `json:"run_totals,omitempty"`
	OwnerTotals           []TaskOwnerTotalPayload   `json:"owner_totals,omitempty"`
	ForcedStopsSinceStart int                       `json:"forced_stops_since_start"`
	RecoverySinceStart    TaskRecoveryTotalsPayload `json:"recovery_since_start"`
}

TaskHealthPayload exposes observer-owned task health in the status surface.

type TaskInboxFacetsPayload

type TaskInboxFacetsPayload struct {
	Statuses   []TaskInboxStatusFacetPayload   `json:"statuses"`
	Priorities []TaskInboxPriorityFacetPayload `json:"priorities"`
}

TaskInboxFacetsPayload contains exact inbox counts before the cursor cut.

type TaskInboxItemPayload

type TaskInboxItemPayload struct {
	Task             TaskInboxTaskPayload   `json:"task"`
	Lane             TaskInboxLane          `json:"lane"`
	ApprovalPolicy   taskpkg.ApprovalPolicy `json:"approval_policy,omitempty"`
	ApprovalState    taskpkg.ApprovalState  `json:"approval_state,omitempty"`
	BlockingReason   string                 `json:"blocking_reason,omitempty"`
	LatestActivityAt time.Time              `json:"latest_activity_at"`
	Run              *TaskCatalogRunPayload `json:"run,omitempty"`
	Triage           TaskTriageStatePayload `json:"triage"`
}

TaskInboxItemPayload is one task inbox item with action-ready metadata.

type TaskInboxLane

type TaskInboxLane string

TaskInboxLane identifies one inbox grouping lane.

const (
	TaskInboxLaneMyWork     TaskInboxLane = "my_work"
	TaskInboxLaneApprovals  TaskInboxLane = "approvals"
	TaskInboxLaneFailedRuns TaskInboxLane = "failed_runs"
	TaskInboxLaneBlocked    TaskInboxLane = "blocked"
	TaskInboxLaneArchived   TaskInboxLane = "archived"
)

type TaskInboxLaneGroupPayload

type TaskInboxLaneGroupPayload struct {
	Lane        TaskInboxLane          `json:"lane"`
	Count       int                    `json:"count"`
	UnreadCount int                    `json:"unread_count"`
	Items       []TaskInboxItemPayload `json:"items,omitempty"`
}

TaskInboxLaneGroupPayload groups page items and exact filtered lane counts.

type TaskInboxPayload

type TaskInboxPayload struct {
	UnreadTotal   int                         `json:"unread_total"`
	ArchivedTotal int                         `json:"archived_total"`
	Groups        []TaskInboxLaneGroupPayload `json:"groups"`
	Page          CountedCursorPagePayload    `json:"page"`
	Facets        TaskInboxFacetsPayload      `json:"facets"`
}

TaskInboxPayload is the actor-scoped bounded task inbox response payload.

type TaskInboxPriorityFacetPayload

type TaskInboxPriorityFacetPayload struct {
	Priority taskpkg.Priority `json:"priority"`
	Count    int              `json:"count"`
}

TaskInboxPriorityFacetPayload is one exact inbox priority count.

type TaskInboxQuery

type TaskInboxQuery struct {
	Scope     taskpkg.CatalogScope `json:"scope,omitempty"`
	Workspace string               `json:"workspace,omitempty"`
	// WorkspaceIDs narrows the All projects inbox (with all_workspaces=true).
	WorkspaceIDs []string          `json:"workspace_ids,omitempty"`
	Worktree     string            `json:"worktree,omitempty"`
	OwnerKind    taskpkg.OwnerKind `json:"owner_kind,omitempty"`
	OwnerRef     string            `json:"owner_ref,omitempty"`
	Lane         TaskInboxLane     `json:"lane,omitempty"`
	Status       taskpkg.Status    `json:"status,omitempty"`
	Priority     taskpkg.Priority  `json:"priority,omitempty"`
	Unread       *bool             `json:"unread,omitempty"`
	Query        string            `json:"query,omitempty"`
	Cursor       string            `json:"cursor,omitempty"`
	Limit        int               `json:"limit,omitempty"`
}

TaskInboxQuery captures the shared bounded actor-scoped inbox filters.

type TaskInboxResponse

type TaskInboxResponse struct {
	Inbox TaskInboxPayload `json:"inbox"`
}

TaskInboxResponse wraps the shared task inbox payload.

type TaskInboxStatusFacetPayload

type TaskInboxStatusFacetPayload struct {
	Status taskpkg.Status `json:"status"`
	Count  int            `json:"count"`
}

TaskInboxStatusFacetPayload is one exact inbox status count.

type TaskInboxTaskPayload

type TaskInboxTaskPayload struct {
	ID             string             `json:"id"`
	Identifier     string             `json:"identifier,omitempty"`
	Title          string             `json:"title"`
	Status         taskpkg.Status     `json:"status"`
	Priority       taskpkg.Priority   `json:"priority,omitempty"`
	Owner          *taskpkg.Ownership `json:"owner,omitempty"`
	Scope          taskpkg.Scope      `json:"scope"`
	WorkspaceID    string             `json:"workspace_id,omitempty"`
	LatestEventSeq int64              `json:"latest_event_seq"`
}

TaskInboxTaskPayload is the lean task reference embedded in inbox rows.

func TaskInboxTaskPayloadFromReference

func TaskInboxTaskPayloadFromReference(record taskpkg.Reference) TaskInboxTaskPayload

TaskInboxTaskPayloadFromReference converts one bounded inbox task reference.

type TaskInspectEventPayload

type TaskInspectEventPayload struct {
	ID        string    `json:"id"`
	Type      string    `json:"type"`
	SessionID string    `json:"session_id,omitempty"`
	TaskID    string    `json:"task_id,omitempty"`
	RunID     string    `json:"run_id,omitempty"`
	Outcome   string    `json:"outcome,omitempty"`
	Summary   string    `json:"summary,omitempty"`
	Timestamp time.Time `json:"timestamp"`
}

TaskInspectEventPayload is one recent event summary returned by task inspect.

type TaskInspectPayload

type TaskInspectPayload struct {
	Target       string                      `json:"target"`
	Task         TaskSummaryPayload          `json:"task"`
	CurrentRun   *TaskInspectRunPayload      `json:"current_run,omitzero"`
	BoundSession *TaskInspectSessionPayload  `json:"bound_session,omitzero"`
	RecentRuns   []TaskInspectRunPayload     `json:"recent_runs,omitempty"`
	RecentEvents []TaskInspectEventPayload   `json:"recent_events,omitempty"`
	Scheduler    TaskInspectSchedulerPayload `json:"scheduler"`
	Diagnostics  []DiagnosticItem            `json:"diagnostics,omitempty"`
	NextAction   string                      `json:"next_action"`
	AsOf         time.Time                   `json:"as_of"`
}

TaskInspectPayload is the shared task/run inspection response payload.

type TaskInspectResponse

type TaskInspectResponse struct {
	Inspect TaskInspectPayload `json:"inspect"`
}

TaskInspectResponse wraps one task/run inspect snapshot.

type TaskInspectRunPayload

type TaskInspectRunPayload struct {
	RunID                   string            `json:"run_id"`
	TaskID                  string            `json:"task_id"`
	Status                  taskpkg.RunStatus `json:"status"`
	ClaimTokenHashTruncated string            `json:"claim_token_hash_truncated,omitempty"`
	LeaseUntil              *time.Time        `json:"lease_until,omitempty"`
	HeartbeatAt             *time.Time        `json:"heartbeat_at,omitempty"`
	HeartbeatAgeSeconds     *int64            `json:"heartbeat_age_seconds,omitzero"`
	Retries                 int               `json:"retries,omitzero"`
	LastErrorSummary        string            `json:"last_error_summary,omitempty"`
	FailureKind             string            `json:"failure_kind,omitempty"`
	BoundSessionID          string            `json:"bound_session_id,omitempty"`
	StartedAt               *time.Time        `json:"started_at,omitempty"`
	EndedAt                 *time.Time        `json:"ended_at,omitempty"`
	PreviousRunID           string            `json:"previous_run_id,omitempty"`
	QueuedAt                time.Time         `json:"queued_at"`
	Attempt                 int               `json:"attempt"`
}

TaskInspectRunPayload is the redacted run projection returned by task inspect.

type TaskInspectSchedulerPayload

type TaskInspectSchedulerPayload struct {
	Paused    bool       `json:"paused"`
	PausedBy  string     `json:"paused_by,omitempty"`
	PausedAt  *time.Time `json:"paused_at,omitempty"`
	Reason    string     `json:"reason,omitempty"`
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
}

TaskInspectSchedulerPayload is the scheduler state used for inspect diagnostics.

type TaskInspectSessionPayload

type TaskInspectSessionPayload struct {
	SessionID      string     `json:"session_id"`
	State          string     `json:"state,omitempty"`
	AgentName      string     `json:"agent_name,omitempty"`
	ProviderName   string     `json:"provider_name,omitempty"`
	WorkspaceID    string     `json:"workspace_id,omitempty"`
	StartedAt      *time.Time `json:"started_at,omitempty"`
	LastActivityAt *time.Time `json:"last_activity_at,omitempty"`
	StopReason     string     `json:"stop_reason,omitempty"`
	FailureKind    string     `json:"failure_kind,omitempty"`
}

TaskInspectSessionPayload is the bound-session projection returned by task inspect.

type TaskLatencyMetricPayload

type TaskLatencyMetricPayload struct {
	Samples       int   `json:"samples"`
	AverageMillis int64 `json:"average_ms"`
	MaximumMillis int64 `json:"maximum_ms"`
}

TaskLatencyMetricPayload exposes one task latency metric family.

type TaskListQuery

type TaskListQuery struct {
	AllWorkspaces bool                  `json:"all_workspaces,omitzero"`
	WorkspaceIDs  []string              `json:"workspace_ids,omitempty"`
	Scope         taskpkg.CatalogScope  `json:"scope,omitempty"`
	Workspace     string                `json:"workspace,omitempty"`
	Status        taskpkg.Status        `json:"status,omitempty"`
	Priority      taskpkg.Priority      `json:"priority,omitempty"`
	IncludeDrafts bool                  `json:"include_drafts,omitempty"`
	IncludeLoop   bool                  `json:"include_loop,omitempty"`
	LoopRunID     string                `json:"loop_run_id,omitempty"`
	ApprovalState taskpkg.ApprovalState `json:"approval_state,omitempty"`
	OwnerKind     taskpkg.OwnerKind     `json:"owner_kind,omitempty"`
	OwnerRef      string                `json:"owner_ref,omitempty"`
	ParentTaskID  string                `json:"parent_task_id,omitempty"`
	Worktree      string                `json:"worktree,omitempty"`
	Query         string                `json:"query,omitempty"`
	Sort          taskpkg.CatalogSort   `json:"sort,omitempty"`
	Cursor        string                `json:"cursor,omitempty"`
	Limit         int                   `json:"limit,omitempty"`
}

TaskListQuery captures the shared bounded task catalog filters.

type TaskOwnerTotalPayload

type TaskOwnerTotalPayload struct {
	OwnerKind string `json:"owner_kind"`
	OwnerRef  string `json:"owner_ref"`
	Count     int    `json:"count"`
}

type TaskPayload

type TaskPayload struct {
	ID                 string                 `json:"id"`
	ProfileID          string                 `json:"profile_id"`
	ProfileName        string                 `json:"profile_name"`
	ProfileColor       string                 `json:"profile_color,omitempty"`
	ProfileIcon        string                 `json:"profile_icon,omitempty"`
	Identifier         string                 `json:"identifier,omitempty"`
	Scope              taskpkg.Scope          `json:"scope"`
	WorkspaceID        string                 `json:"workspace_id,omitempty"`
	ParentTaskID       string                 `json:"parent_task_id,omitempty"`
	Title              string                 `json:"title"`
	Description        string                 `json:"description,omitempty"`
	Priority           taskpkg.Priority       `json:"priority,omitempty"`
	MaxAttempts        int                    `json:"max_attempts,omitempty"`
	AutoEnqueueOnReady bool                   `json:"auto_enqueue_on_ready,omitempty"`
	Status             taskpkg.Status         `json:"status"`
	ApprovalPolicy     taskpkg.ApprovalPolicy `json:"approval_policy,omitempty"`
	ApprovalState      taskpkg.ApprovalState  `json:"approval_state,omitempty"`
	Draft              bool                   `json:"draft,omitempty"`
	Owner              *taskpkg.Ownership     `json:"owner,omitempty"`
	CurrentRunID       string                 `json:"current_run_id,omitempty"`
	LatestEventSeq     int64                  `json:"latest_event_seq"`
	Paused             bool                   `json:"paused,omitempty"`
	PausedBy           string                 `json:"paused_by,omitempty"`
	PausedAt           *time.Time             `json:"paused_at,omitempty"`
	PausedReason       string                 `json:"paused_reason,omitempty"`
	EffectivePaused    bool                   `json:"effective_paused,omitempty"`
	PausedByTaskID     string                 `json:"paused_by_task_id,omitempty"`
	// BlockedReasons is populated on read/detail projections and may be omitted by mutation responses.
	BlockedReasons       []taskpkg.BlockedReason `json:"blocked_reasons,omitempty"`
	NeedsAttention       bool                    `json:"needs_attention,omitempty"`
	NeedsAttentionReason string                  `json:"needs_attention_reason,omitempty"`
	NeedsAttentionAt     *time.Time              `json:"needs_attention_at,omitempty"`
	NeedsAttentionBy     *taskpkg.ActorIdentity  `json:"needs_attention_by,omitempty"`
	WakeCreator          bool                    `json:"wake_creator"`
	CreatedBy            taskpkg.ActorIdentity   `json:"created_by"`
	Origin               taskpkg.Origin          `json:"origin"`
	CreatedAt            time.Time               `json:"created_at"`
	UpdatedAt            time.Time               `json:"updated_at"`
	ClosedAt             *time.Time              `json:"closed_at,omitempty"`
	Metadata             json.RawMessage         `json:"metadata,omitempty"`
	Loop                 *LoopProvenance         `json:"loop,omitempty"`
}

TaskPayload is the shared full task response payload.

type TaskQueryErrorPayload

type TaskQueryErrorPayload struct {
	ErrorPayload
	Field string `json:"field"`
}

TaskQueryErrorPayload reports one invalid typed task-list query field.

type TaskQueueDepthPayload

type TaskQueueDepthPayload struct {
	Count               int        `json:"count"`
	OldestQueuedAt      *time.Time `json:"oldest_queued_at,omitempty"`
	OldestQueueAgeMilli int64      `json:"oldest_queue_age_ms"`
}

type TaskRecoveryTotalsPayload

type TaskRecoveryTotalsPayload struct {
	Requeued      int `json:"requeued"`
	MarkedRunning int `json:"marked_running"`
	Failed        int `json:"failed"`
}

type TaskReferencePayload

type TaskReferencePayload struct {
	ID              string             `json:"id"`
	Identifier      string             `json:"identifier,omitempty"`
	Title           string             `json:"title"`
	Status          taskpkg.Status     `json:"status"`
	Priority        taskpkg.Priority   `json:"priority,omitempty"`
	Owner           *taskpkg.Ownership `json:"owner,omitempty"`
	Scope           taskpkg.Scope      `json:"scope"`
	WorkspaceID     string             `json:"workspace_id,omitempty"`
	LatestEventSeq  int64              `json:"latest_event_seq"`
	Paused          bool               `json:"paused,omitempty"`
	EffectivePaused bool               `json:"effective_paused,omitempty"`
	PausedByTaskID  string             `json:"paused_by_task_id,omitempty"`
}

TaskReferencePayload is the human-meaningful task identity shared across task read models.

type TaskResponse

type TaskResponse struct {
	Task TaskPayload `json:"task"`
}

TaskResponse wraps one shared task payload.

type TaskRunDetailPayload

type TaskRunDetailPayload struct {
	Run     TaskRunPayload                   `json:"run"`
	Task    *TaskReferencePayload            `json:"task,omitempty"`
	Session *TaskRunSessionPayload           `json:"session,omitempty"`
	Summary TaskRunOperationalSummaryPayload `json:"summary"`
}

TaskRunDetailPayload is the shared run-detail response payload.

type TaskRunDetailResponse

type TaskRunDetailResponse struct {
	Run TaskRunDetailPayload `json:"run"`
}

TaskRunDetailResponse wraps one shared task-run detail payload.

type TaskRunLeaseSummaryPayload

type TaskRunLeaseSummaryPayload struct {
	TaskID         string                 `json:"task_id"`
	RunID          string                 `json:"run_id"`
	Status         taskpkg.RunStatus      `json:"status"`
	SessionID      string                 `json:"session_id,omitempty"`
	ClaimedBy      *taskpkg.ActorIdentity `json:"claimed_by,omitempty"`
	ClaimTokenHash string                 `json:"claim_token_hash,omitempty"`
	LeaseUntil     *time.Time             `json:"lease_until,omitempty"`
	HeartbeatAt    *time.Time             `json:"heartbeat_at,omitempty"`
}

TaskRunLeaseSummaryPayload is the safe read projection for task-run lease state.

func NormalizeTaskRunLeaseSummaryPayload

func NormalizeTaskRunLeaseSummaryPayload(payload TaskRunLeaseSummaryPayload) TaskRunLeaseSummaryPayload

NormalizeTaskRunLeaseSummaryPayload returns a lease summary with normalized nested channel metadata.

type TaskRunListQuery

type TaskRunListQuery struct {
	Status    taskpkg.RunStatus `json:"status,omitempty"`
	SessionID string            `json:"session_id,omitempty"`
	Limit     int               `json:"limit,omitempty"`
}

TaskRunListQuery captures the shared task-run list filters.

type TaskRunOperationalSummaryPayload

type TaskRunOperationalSummaryPayload struct {
	LastActivityAt time.Time  `json:"last_activity_at"`
	LastEventType  string     `json:"last_event_type,omitempty"`
	ToolCallCount  *int64     `json:"tool_call_count,omitempty"`
	TurnCount      *int64     `json:"turn_count,omitempty"`
	InputTokens    *int64     `json:"input_tokens,omitempty"`
	OutputTokens   *int64     `json:"output_tokens,omitempty"`
	TotalTokens    *int64     `json:"total_tokens,omitempty"`
	TotalCost      *float64   `json:"total_cost,omitempty"`
	CostCurrency   *string    `json:"cost_currency,omitempty"`
	CostStatus     CostStatus `json:"cost_status,omitempty"`
	CostSource     CostSource `json:"cost_source,omitempty"`
}

TaskRunOperationalSummaryPayload captures aggregated runtime metrics for run detail.

type TaskRunPayload

type TaskRunPayload struct {
	ID                   string                         `json:"id"`
	ProfileID            string                         `json:"profile_id,omitempty"`
	ProfileName          string                         `json:"profile_name,omitempty"`
	ProfileColor         string                         `json:"profile_color,omitempty"`
	ProfileIcon          string                         `json:"profile_icon,omitempty"`
	TaskID               string                         `json:"task_id"`
	Status               taskpkg.RunStatus              `json:"status"`
	Attempt              int                            `json:"attempt"`
	RecoveryCount        int                            `json:"recovery_count"`
	PreviousRunID        string                         `json:"previous_run_id,omitempty"`
	FailureKind          string                         `json:"failure_kind,omitempty"`
	ClaimedBy            *taskpkg.ActorIdentity         `json:"claimed_by,omitempty"`
	SessionID            string                         `json:"session_id,omitempty"`
	WorktreeID           string                         `json:"worktree_id,omitempty"`
	ResolvedWorktreeMode ResolvedWorktreeMode           `json:"resolved_worktree_mode"`
	ResolvedWorktreeRef  string                         `json:"resolved_worktree_ref,omitempty"`
	Origin               taskpkg.Origin                 `json:"origin"`
	IdempotencyKey       string                         `json:"idempotency_key,omitempty"`
	DesignationGroupID   string                         `json:"designation_group_id,omitempty"`
	ClaimTokenHash       string                         `json:"claim_token_hash,omitempty"`
	LeaseUntil           *time.Time                     `json:"lease_until,omitempty"`
	HeartbeatAt          *time.Time                     `json:"heartbeat_at,omitempty"`
	Designation          *taskpkg.RunDesignationSummary `json:"designation,omitempty"`
	QueuedAt             time.Time                      `json:"queued_at"`
	ClaimedAt            *time.Time                     `json:"claimed_at,omitempty"`
	StartedAt            *time.Time                     `json:"started_at,omitempty"`
	EndedAt              *time.Time                     `json:"ended_at,omitempty"`
	Error                string                         `json:"error,omitempty"`
	Metadata             json.RawMessage                `json:"metadata,omitempty"`
	Result               json.RawMessage                `json:"result,omitempty"`
	ResultRef            string                         `json:"result_ref,omitempty"`
	ResultBytes          int64                          `json:"result_bytes,omitempty"`
}

TaskRunPayload is the shared task-run response payload.

type TaskRunResponse

type TaskRunResponse struct {
	Run TaskRunPayload `json:"run"`
}

TaskRunResponse wraps one shared task-run payload.

type TaskRunResultPageResponse

type TaskRunResultPageResponse struct {
	RunID      string `json:"run_id"`
	ResultRef  string `json:"result_ref,omitempty"`
	Offset     int64  `json:"offset"`
	Bytes      int64  `json:"bytes"`
	TotalBytes int64  `json:"total_bytes"`
	DataBase64 string `json:"data_base64"`
	NextOffset *int64 `json:"next_offset,omitempty"`
	EOF        bool   `json:"eof"`
}

TaskRunResultPageResponse is one exact bounded byte page from a task-run result.

type TaskRunReviewListQuery

type TaskRunReviewListQuery = taskpkg.RunReviewQuery

TaskRunReviewListQuery captures shared review read filters.

type TaskRunReviewPayload

type TaskRunReviewPayload struct {
	taskpkg.RunReview
	ProfileID       string `json:"profile_id"`
	ProfileName     string `json:"profile_name"`
	ProfileColor    string `json:"profile_color,omitempty"`
	ProfileIcon     string `json:"profile_icon,omitempty"`
	ProfileEmoji    string `json:"profile_emoji,omitempty"`
	ProfileArchived bool   `json:"profile_archived,omitzero"`
}

TaskRunReviewPayload is the task-run review gate read model with its profile owner.

type TaskRunReviewRequestResponse

type TaskRunReviewRequestResponse struct {
	Review  TaskRunReviewPayload `json:"review"`
	Created bool                 `json:"created"`
}

TaskRunReviewRequestResponse wraps one review request and idempotent-create marker.

type TaskRunReviewResponse

type TaskRunReviewResponse struct {
	Review TaskRunReviewPayload `json:"review"`
}

TaskRunReviewResponse wraps one task-run review payload.

type TaskRunReviewVerdictResponse

type TaskRunReviewVerdictResponse struct {
	Review          TaskRunReviewPayload `json:"review"`
	ContinuationRun *TaskRunPayload      `json:"continuation_run,omitzero"`
	CircuitOpened   bool                 `json:"circuit_opened,omitzero"`
}

TaskRunReviewVerdictResponse wraps one recorded review verdict result.

type TaskRunReviewsResponse

type TaskRunReviewsResponse struct {
	Reviews []TaskRunReviewPayload `json:"reviews"`
}

TaskRunReviewsResponse wraps a task-run review list.

type TaskRunSessionPayload

type TaskRunSessionPayload struct {
	SessionID   string    `json:"session_id"`
	WorkspaceID string    `json:"workspace_id,omitempty"`
	AgentName   string    `json:"agent_name,omitempty"`
	Name        string    `json:"name,omitempty"`
	State       string    `json:"state,omitempty"`
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
}

TaskRunSessionPayload links one task run to its backing session when available.

type TaskRunSummaryPayload

type TaskRunSummaryPayload struct {
	ID                   string                         `json:"id"`
	TaskID               string                         `json:"task_id"`
	Status               taskpkg.RunStatus              `json:"status"`
	Attempt              int                            `json:"attempt"`
	RecoveryCount        int                            `json:"recovery_count"`
	PreviousRunID        string                         `json:"previous_run_id,omitempty"`
	FailureKind          string                         `json:"failure_kind,omitempty"`
	MaxAttempts          int                            `json:"max_attempts"`
	SessionID            string                         `json:"session_id,omitempty"`
	WorktreeID           string                         `json:"worktree_id,omitempty"`
	ResolvedWorktreeMode ResolvedWorktreeMode           `json:"resolved_worktree_mode"`
	ResolvedWorktreeRef  string                         `json:"resolved_worktree_ref,omitempty"`
	ClaimedBy            *taskpkg.ActorIdentity         `json:"claimed_by,omitempty"`
	ClaimTokenHash       string                         `json:"claim_token_hash,omitempty"`
	LeaseUntil           *time.Time                     `json:"lease_until,omitempty"`
	HeartbeatAt          *time.Time                     `json:"heartbeat_at,omitempty"`
	DesignationGroupID   string                         `json:"designation_group_id,omitempty"`
	Designation          *taskpkg.RunDesignationSummary `json:"designation,omitempty"`
	QueuedAt             time.Time                      `json:"queued_at"`
	ClaimedAt            *time.Time                     `json:"claimed_at,omitempty"`
	StartedAt            *time.Time                     `json:"started_at,omitempty"`
	EndedAt              *time.Time                     `json:"ended_at,omitempty"`
	Error                string                         `json:"error,omitempty"`
}

TaskRunSummaryPayload is the shared run-chip payload reused by enriched task reads.

type TaskRunTotalPayload

type TaskRunTotalPayload struct {
	Status     string `json:"status"`
	OriginKind string `json:"origin_kind"`
	Count      int    `json:"count"`
}

type TaskRunsResponse

type TaskRunsResponse struct {
	Runs []TaskRunPayload `json:"runs"`
}

TaskRunsResponse wraps the shared task-run list payload.

type TaskStatusTotalPayload

type TaskStatusTotalPayload struct {
	Scope  string `json:"scope"`
	Status string `json:"status"`
	Count  int    `json:"count"`
}

type TaskStreamEventPayload

type TaskStreamEventPayload struct {
	Sequence int64                   `json:"sequence"`
	Type     string                  `json:"type"`
	Timeline TaskTimelineItemPayload `json:"timeline"`
}

TaskStreamEventPayload is one task-scoped replayable stream event.

type TaskStreamQuery

type TaskStreamQuery struct {
	AfterSequence int64 `json:"after_sequence,omitzero"`
}

TaskStreamQuery captures the shared task stream replay filters.

type TaskSummaryPayload

type TaskSummaryPayload struct {
	ID                   string                           `json:"id"`
	ProfileID            string                           `json:"profile_id"`
	ProfileName          string                           `json:"profile_name"`
	ProfileColor         string                           `json:"profile_color,omitempty"`
	ProfileIcon          string                           `json:"profile_icon,omitempty"`
	Identifier           string                           `json:"identifier,omitempty"`
	Scope                taskpkg.Scope                    `json:"scope"`
	WorkspaceID          string                           `json:"workspace_id,omitempty"`
	ParentTaskID         string                           `json:"parent_task_id,omitempty"`
	Title                string                           `json:"title"`
	Priority             taskpkg.Priority                 `json:"priority,omitempty"`
	MaxAttempts          int                              `json:"max_attempts,omitempty"`
	AutoEnqueueOnReady   bool                             `json:"auto_enqueue_on_ready,omitempty"`
	Status               taskpkg.Status                   `json:"status"`
	ApprovalPolicy       taskpkg.ApprovalPolicy           `json:"approval_policy,omitempty"`
	ApprovalState        taskpkg.ApprovalState            `json:"approval_state,omitempty"`
	Draft                bool                             `json:"draft,omitempty"`
	Owner                *taskpkg.Ownership               `json:"owner,omitempty"`
	CurrentRunID         string                           `json:"current_run_id,omitempty"`
	LatestEventSeq       int64                            `json:"latest_event_seq"`
	Paused               bool                             `json:"paused,omitempty"`
	PausedBy             string                           `json:"paused_by,omitempty"`
	PausedAt             *time.Time                       `json:"paused_at,omitempty"`
	PausedReason         string                           `json:"paused_reason,omitempty"`
	EffectivePaused      bool                             `json:"effective_paused,omitempty"`
	PausedByTaskID       string                           `json:"paused_by_task_id,omitempty"`
	BlockedReasons       []taskpkg.BlockedReason          `json:"blocked_reasons,omitempty"`
	NeedsAttention       bool                             `json:"needs_attention,omitempty"`
	NeedsAttentionReason string                           `json:"needs_attention_reason,omitempty"`
	NeedsAttentionAt     *time.Time                       `json:"needs_attention_at,omitempty"`
	NeedsAttentionBy     *taskpkg.ActorIdentity           `json:"needs_attention_by,omitempty"`
	WakeCreator          bool                             `json:"wake_creator"`
	CreatedBy            taskpkg.ActorIdentity            `json:"created_by"`
	Origin               taskpkg.Origin                   `json:"origin"`
	CreatedAt            time.Time                        `json:"created_at"`
	UpdatedAt            time.Time                        `json:"updated_at"`
	ClosedAt             *time.Time                       `json:"closed_at,omitempty"`
	ChildCount           int                              `json:"child_count,omitempty"`
	DependencyCount      int                              `json:"dependency_count,omitempty"`
	Dependencies         []TaskDependencyReferencePayload `json:"dependencies,omitempty"`
	ActiveRun            *TaskRunSummaryPayload           `json:"active_run,omitempty"`
	LastActivityAt       *time.Time                       `json:"last_activity_at,omitempty"`
}

TaskSummaryPayload is the shared list-oriented task response payload.

type TaskTimelineItemPayload

type TaskTimelineItemPayload struct {
	Sequence  int64                  `json:"sequence"`
	EventID   string                 `json:"event_id"`
	Task      TaskReferencePayload   `json:"task"`
	Run       *TaskRunSummaryPayload `json:"run,omitempty"`
	EventType string                 `json:"event_type"`
	Reason    string                 `json:"reason,omitempty"`
	Actor     taskpkg.ActorIdentity  `json:"actor"`
	Origin    taskpkg.Origin         `json:"origin"`
	Payload   json.RawMessage        `json:"payload,omitempty"`
	Timestamp time.Time              `json:"timestamp"`
}

TaskTimelineItemPayload is the shared task-timeline response payload.

type TaskTimelineQuery

type TaskTimelineQuery struct {
	AfterSequence int64 `json:"after_sequence,omitempty"`
	Limit         int   `json:"limit,omitempty"`
}

TaskTimelineQuery captures the shared task timeline filters.

type TaskTimelineResponse

type TaskTimelineResponse struct {
	Timeline []TaskTimelineItemPayload `json:"timeline"`
}

TaskTimelineResponse wraps the shared task timeline payload.

type TaskTreeNodePayload

type TaskTreeNodePayload struct {
	Task           TaskReferencePayload   `json:"task"`
	ParentTaskID   string                 `json:"parent_task_id,omitempty"`
	Depth          int                    `json:"depth"`
	ChildCount     int                    `json:"child_count,omitempty"`
	ActiveRun      *TaskRunSummaryPayload `json:"active_run,omitempty"`
	LastActivityAt time.Time              `json:"last_activity_at"`
}

TaskTreeNodePayload is one node inside a task-tree live snapshot.

type TaskTreePayload

type TaskTreePayload struct {
	Root        TaskTreeNodePayload   `json:"root"`
	Descendants []TaskTreeNodePayload `json:"descendants,omitempty"`
}

TaskTreePayload is the shared task-tree live snapshot.

type TaskTreeResponse

type TaskTreeResponse struct {
	Tree TaskTreePayload `json:"tree"`
}

TaskTreeResponse wraps the shared task-tree payload.

type TaskTriageStatePayload

type TaskTriageStatePayload struct {
	TaskID             string                `json:"task_id"`
	Actor              taskpkg.ActorIdentity `json:"actor"`
	Read               bool                  `json:"read"`
	Archived           bool                  `json:"archived"`
	Dismissed          bool                  `json:"dismissed"`
	LastSeenActivityAt *time.Time            `json:"last_seen_activity_at,omitempty"`
	UpdatedAt          time.Time             `json:"updated_at"`
}

TaskTriageStatePayload is the shared actor-scoped task triage state.

type TaskTriageStateResponse

type TaskTriageStateResponse struct {
	Triage TaskTriageStatePayload `json:"triage"`
}

TaskTriageStateResponse wraps the shared task triage-state payload.

type TasksResponse

type TasksResponse struct {
	Tasks  []TaskCatalogItemPayload `json:"tasks"`
	Page   CountedCursorPagePayload `json:"page"`
	Facets TaskCatalogFacetsPayload `json:"facets"`
}

TasksResponse wraps the shared task list payload.

type TerminalActorKind

type TerminalActorKind string

type TerminalAnswerInputRequest

type TerminalAnswerInputRequest struct {
	Input string `json:"input"`
}

type TerminalApprovalCountPayload

type TerminalApprovalCountPayload struct {
	WorkspaceID string `json:"workspace_id"`
	ProfileID   string `json:"profile_id"`
	Count       int    `json:"count"`
}

TerminalApprovalCountPayload is an exact count for one workspace/profile pair, including child sessions.

type TerminalAttachMode

type TerminalAttachMode string
const (
	TerminalAttachModeRead  TerminalAttachMode = "read"
	TerminalAttachModeWrite TerminalAttachMode = "write"
)

type TerminalAttachTicketRequest

type TerminalAttachTicketRequest struct {
	Mode     TerminalAttachMode `json:"mode"`
	ClientID string             `json:"client_id,omitempty"`
}

type TerminalAttachTicketResponse

type TerminalAttachTicketResponse struct {
	Ticket    string    `json:"ticket"`
	ExpiresAt time.Time `json:"expires_at"`
}

type TerminalCapabilitiesPayload

type TerminalCapabilitiesPayload struct {
	Interactive bool `json:"interactive"`
}

type TerminalCatalogSnapshot

type TerminalCatalogSnapshot struct {
	Terminals []TerminalInfoPayload `json:"terminals"`
}

type TerminalCloseRequest

type TerminalCloseRequest struct {
	Signal TerminalSignal `json:"signal"`
}

type TerminalCommandActorPayload

type TerminalCommandActorPayload struct {
	Kind TerminalActorKind `json:"kind"`
	ID   string            `json:"id"`
}

type TerminalCommandApproval

type TerminalCommandApproval string
const (
	TerminalCommandApprovalOnce        TerminalCommandApproval = "approved_once"
	TerminalCommandApprovalAlways      TerminalCommandApproval = "approved_always"
	TerminalCommandApprovalAllowlisted TerminalCommandApproval = "allowlisted"
	TerminalCommandApprovalHuman       TerminalCommandApproval = "human"
	TerminalCommandApprovalNone        TerminalCommandApproval = "none"
)

type TerminalCommandDetection

type TerminalCommandDetection string
const (
	TerminalCommandDetectionExact  TerminalCommandDetection = "exact"
	TerminalCommandDetectionMarker TerminalCommandDetection = "marker"
	TerminalCommandDetectionIdle   TerminalCommandDetection = "idle"
)

type TerminalCommandRowPayload

type TerminalCommandRowPayload struct {
	ID          string                      `json:"command_id"`
	TerminalID  *TerminalID                 `json:"terminal_id"`
	ProfileID   string                      `json:"profile_id"`
	ProfileName string                      `json:"profile_name"`
	Actor       TerminalCommandActorPayload `json:"actor"`
	Command     string                      `json:"command"`
	ArgvDigest  *string                     `json:"argv_digest,omitzero"`
	Cwd         string                      `json:"cwd"`
	StartedAt   time.Time                   `json:"started_at"`
	DurationMs  *int64                      `json:"duration_ms"`
	ExitCode    *int                        `json:"exit_code"`
	ExitSignal  *TerminalSignal             `json:"signal"`
	ExitCause   TerminalExitCause           `json:"exit_cause"`
	DetectedBy  TerminalCommandDetection    `json:"detected_by"`
	Approval    TerminalCommandApproval     `json:"approval"`
	OutputBytes int64                       `json:"output_bytes"`
	Truncated   bool                        `json:"truncated"`
	RecordingID *string                     `json:"recording,omitzero"`
}

func TerminalCommandRowPayloadFromDomain

func TerminalCommandRowPayloadFromDomain(row terminalpkg.CommandRow, profileName string) TerminalCommandRowPayload

type TerminalCreateRequest

type TerminalCreateRequest struct {
	Worktree string `json:"worktree,omitempty"`
	Cwd      string `json:"cwd,omitempty"`
	Shell    string `json:"shell,omitempty"`
	Cols     uint16 `json:"cols,omitzero"`
	Rows     uint16 `json:"rows,omitzero"`
	Title    string `json:"title,omitempty"`
	ClientID string `json:"client_id,omitempty"`
}

type TerminalDeliveredResponse

type TerminalDeliveredResponse struct {
	Delivered bool `json:"delivered"`
}

type TerminalErrorCode

type TerminalErrorCode string

TerminalErrorCode is the closed public vocabulary for terminal domain outcomes.

const (
	TerminalErrorNotFound                 TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeNotFound)
	TerminalErrorProfileSelectionConflict TerminalErrorCode = TerminalErrorCode(
		terminalpkg.ErrorCodeProfileSelectionConflict,
	)
	TerminalErrorProfileSessionConflict TerminalErrorCode = TerminalErrorCode(
		terminalpkg.ErrorCodeProfileSessionConflict,
	)
	TerminalErrorRequiresWorkspace      TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeRequiresWorkspace)
	TerminalErrorProfileArchived        TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeProfileArchived)
	TerminalErrorProfileUnavailable     TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeProfileUnavailable)
	TerminalErrorLimitReached           TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeLimitReached)
	TerminalErrorSubscriberLimitReached TerminalErrorCode = TerminalErrorCode(
		terminalpkg.ErrorCodeSubscriberLimitReached,
	)
	TerminalErrorExited                 TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeExited)
	TerminalErrorExpired                TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeExpired)
	TerminalErrorInteractiveUnavailable TerminalErrorCode = TerminalErrorCode(
		terminalpkg.ErrorCodeInteractiveUnavailable,
	)
	TerminalErrorNotInteractive       TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeNotInteractive)
	TerminalErrorInvalidCwd           TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeInvalidCwd)
	TerminalErrorTimeoutOutOfRange    TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeTimeoutOutOfRange)
	TerminalErrorGenerationFenced     TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeGenerationFenced)
	TerminalErrorApprovalRejected     TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeApprovalRejected)
	TerminalErrorTicketInvalid        TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeTicketInvalid)
	TerminalErrorTicketExpired        TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeTicketExpired)
	TerminalErrorInputRequestNotFound TerminalErrorCode = TerminalErrorCode(
		terminalpkg.ErrorCodeInputRequestNotFound,
	)
	TerminalErrorInputRequestAnswered TerminalErrorCode = TerminalErrorCode(
		terminalpkg.ErrorCodeInputRequestAnswered,
	)
	TerminalErrorInputRequestSuperseded TerminalErrorCode = TerminalErrorCode(
		terminalpkg.ErrorCodeInputRequestSuperseded,
	)
	TerminalErrorInputRequestLimitReached TerminalErrorCode = TerminalErrorCode(
		terminalpkg.ErrorCodeInputRequestLimitReached,
	)
	TerminalErrorInputRequestRequiresHidden TerminalErrorCode = TerminalErrorCode(
		terminalpkg.ErrorCodeInputRequestRequiresHidden,
	)
	TerminalErrorRecordingAlreadyStarted TerminalErrorCode = TerminalErrorCode(
		terminalpkg.ErrorCodeRecordingAlreadyStarted,
	)
	TerminalErrorRecordingNotActive   TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeRecordingNotActive)
	TerminalErrorRecordingUnavailable TerminalErrorCode = TerminalErrorCode(
		terminalpkg.ErrorCodeRecordingUnavailable,
	)
	TerminalErrorSlowConsumer       TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeSlowConsumer)
	TerminalErrorJournalUnavailable TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeJournalUnavailable)
	TerminalErrorWorktreeNotFound   TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeWorktreeNotFound)
	TerminalErrorWorktreeNotReady   TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeWorktreeNotReady)
	TerminalErrorWorktreeMissing    TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeWorktreeMissing)
)

type TerminalErrorDetail

type TerminalErrorDetail struct {
	Code    string                `json:"code"`
	Message string                `json:"message"`
	Details *TerminalErrorDetails `json:"details,omitzero"`
}

TerminalErrorDetail is the shared terminal failure envelope. Code is a TerminalErrorCode for domain outcomes and a truthful generic string for transport failures.

type TerminalErrorDetails

type TerminalErrorDetails struct {
	Current  *int         `json:"current,omitzero"`
	Max      *int         `json:"max,omitzero"`
	Path     string       `json:"path,omitempty"`
	Mode     TerminalMode `json:"mode,omitempty"`
	Platform string       `json:"platform,omitempty"`
	Action   string       `json:"action,omitempty"`
}

TerminalErrorDetails preserves actionable domain metadata without parsing messages.

func TerminalErrorDetailsFromDomain

func TerminalErrorDetailsFromDomain(err *terminalpkg.Error) *TerminalErrorDetails

TerminalErrorDetailsFromDomain projects only public, non-secret error metadata.

type TerminalErrorResponse

type TerminalErrorResponse struct {
	Error TerminalErrorDetail `json:"error"`
}

TerminalErrorResponse wraps every public terminal failure in one envelope.

type TerminalExecRequest

type TerminalExecRequest struct {
	Command string              `json:"command"`
	Args    []string            `json:"args,omitempty"`
	Cwd     string              `json:"cwd,omitempty"`
	Env     map[string]string   `json:"env,omitempty"`
	YieldMs int                 `json:"yield_ms,omitzero"`
	Visible bool                `json:"visible,omitzero"`
	Output  TerminalOutputShape `json:"output,omitzero"`
}

type TerminalExecResponse

type TerminalExecResponse struct {
	ExitCode     *int                  `json:"exit_code"`
	Signal       *TerminalSignal       `json:"signal"`
	Output       string                `json:"output"`
	Truncated    bool                  `json:"truncated"`
	Untrusted    bool                  `json:"untrusted"`
	Spill        *TerminalSpillPayload `json:"spill,omitzero"`
	DurationMs   int64                 `json:"duration_ms"`
	CommandID    string                `json:"command_id"`
	StillRunning bool                  `json:"still_running,omitzero"`
	TerminalID   *TerminalID           `json:"terminal_id"`
}

func TerminalExecResponseFromDomain

func TerminalExecResponseFromDomain(result terminalpkg.ExecResult) TerminalExecResponse

type TerminalExitCause

type TerminalExitCause string
const (
	TerminalExitCauseExited   TerminalExitCause = "exited"
	TerminalExitCauseSignaled TerminalExitCause = "signaled"
	TerminalExitCauseUnknown  TerminalExitCause = "unknown"
)

type TerminalExitPayload

type TerminalExitPayload struct {
	Cause  TerminalExitCause `json:"cause"`
	Code   *int              `json:"code,omitzero"`
	Signal *TerminalSignal   `json:"signal,omitzero"`
	At     time.Time         `json:"at"`
}

type TerminalExitResponse

type TerminalExitResponse struct {
	Exit *TerminalExitPayload `json:"exit"`
}

type TerminalID

type TerminalID string

type TerminalInfoPayload

type TerminalInfoPayload struct {
	ID           TerminalID                  `json:"id"`
	WorkspaceID  string                      `json:"workspace_id"`
	ProfileID    string                      `json:"profile_id"`
	ProfileName  string                      `json:"profile_name"`
	Title        string                      `json:"title"`
	Shell        string                      `json:"shell"`
	Cwd          string                      `json:"cwd"`
	Mode         TerminalMode                `json:"mode"`
	State        TerminalState               `json:"state"`
	Viewers      int                         `json:"viewers"`
	BoundRun     *TerminalRunPayload         `json:"bound_run"`
	Capabilities TerminalCapabilitiesPayload `json:"capabilities"`
	CreatedAt    time.Time                   `json:"created_at"`
	Exit         *TerminalExitPayload        `json:"exit,omitzero"`
}

func TerminalInfoPayloadFromDomain

func TerminalInfoPayloadFromDomain(info terminalpkg.Info, profileName string) TerminalInfoPayload

type TerminalInputActorPayload

type TerminalInputActorPayload struct {
	Kind TerminalActorKind `json:"kind"`
	ID   string            `json:"id"`
}

type TerminalInputAnswerResponse

type TerminalInputAnswerResponse struct {
	DeliveredBytes int  `json:"delivered_bytes"`
	Redacted       bool `json:"redacted"`
}

type TerminalInputRejectOutcome

type TerminalInputRejectOutcome string
const TerminalInputRejectOutcomeRejected TerminalInputRejectOutcome = "rejected"

type TerminalInputRejectResponse

type TerminalInputRejectResponse struct {
	Outcome TerminalInputRejectOutcome `json:"outcome"`
}

type TerminalInputRequestsResponse

type TerminalInputRequestsResponse struct {
	Pending  []TerminalPendingInputRequest  `json:"pending"`
	Resolved []TerminalResolvedInputRequest `json:"resolved"`
}

type TerminalInputResolutionOutcome

type TerminalInputResolutionOutcome string
const (
	TerminalInputResolutionOutcomeAnswered   TerminalInputResolutionOutcome = "answered"
	TerminalInputResolutionOutcomeRejected   TerminalInputResolutionOutcome = "rejected"
	TerminalInputResolutionOutcomeSuperseded TerminalInputResolutionOutcome = "superseded"
	TerminalInputResolutionOutcomeExpired    TerminalInputResolutionOutcome = "expired"
)

type TerminalJournalResponse

type TerminalJournalResponse struct {
	Entries []TerminalCommandRowPayload `json:"entries"`
	Next    *string                     `json:"next"`
}

type TerminalListResponse

type TerminalListResponse struct {
	Terminals []TerminalInfoPayload `json:"terminals"`
}

type TerminalMode

type TerminalMode string

type TerminalOutputShape

type TerminalOutputShape struct {
	MaxBytes int    `json:"max_bytes,omitzero"`
	Strategy string `json:"strategy,omitempty"`
	Grep     string `json:"grep,omitempty"`
}

type TerminalPendingInputRequest

type TerminalPendingInputRequest struct {
	ID            string                    `json:"id"`
	TerminalID    TerminalID                `json:"terminal_id"`
	WorkspaceID   string                    `json:"workspace_id,omitempty"`
	ProfileID     string                    `json:"profile_id"`
	ProfileName   string                    `json:"profile_name"`
	Reason        string                    `json:"reason"`
	PromptExcerpt string                    `json:"prompt_excerpt"`
	Redacted      bool                      `json:"redacted"`
	RequestedAt   time.Time                 `json:"requested_at"`
	Requester     TerminalInputActorPayload `json:"requester"`
}

type TerminalReadResponse

type TerminalReadResponse struct {
	Content   string                `json:"content"`
	Seq       TerminalSequence      `json:"seq"`
	Truncated bool                  `json:"truncated"`
	Busy      bool                  `json:"busy"`
	Untrusted bool                  `json:"untrusted"`
	Spill     *TerminalSpillPayload `json:"spill,omitzero"`
}

func TerminalReadResponseFromDomain

func TerminalReadResponseFromDomain(result terminalpkg.ReadResult) TerminalReadResponse

type TerminalRecordingAction

type TerminalRecordingAction string
const (
	TerminalRecordingActionStart TerminalRecordingAction = "start"
	TerminalRecordingActionStop  TerminalRecordingAction = "stop"
)

type TerminalRecordingPayload

type TerminalRecordingPayload struct {
	ID         string                 `json:"id"`
	State      TerminalRecordingState `json:"state"`
	TerminalID TerminalID             `json:"terminal_id"`
	ProfileID  string                 `json:"profile_id"`
	Digest     string                 `json:"digest"`
	StartedAt  time.Time              `json:"started_at"`
	StoppedAt  *time.Time             `json:"stopped_at,omitempty"`
	Bytes      int64                  `json:"bytes"`
	ExpiresAt  time.Time              `json:"expires_at"`
}

func TerminalRecordingPayloadFromDomain

func TerminalRecordingPayloadFromDomain(
	recording terminalpkg.RecordingRef,
	state TerminalRecordingState,
) TerminalRecordingPayload

type TerminalRecordingRequest

type TerminalRecordingRequest struct {
	Action TerminalRecordingAction `json:"action"`
}

type TerminalRecordingResponse

type TerminalRecordingResponse struct {
	Recording TerminalRecordingPayload `json:"recording"`
}

type TerminalRecordingState

type TerminalRecordingState string
const (
	TerminalRecordingStateRecording TerminalRecordingState = "recording"
	TerminalRecordingStateSaved     TerminalRecordingState = "saved"
)

type TerminalRejectInputRequest

type TerminalRejectInputRequest struct {
	Reason string `json:"reason"`
}

type TerminalResolvedInputRequest

type TerminalResolvedInputRequest struct {
	ID          string                         `json:"id"`
	TerminalID  TerminalID                     `json:"terminal_id"`
	WorkspaceID string                         `json:"workspace_id,omitempty"`
	ProfileID   string                         `json:"profile_id"`
	ProfileName string                         `json:"profile_name"`
	Requester   TerminalInputActorPayload      `json:"requester"`
	Outcome     TerminalInputResolutionOutcome `json:"outcome"`
	ResolvedBy  TerminalInputActorPayload      `json:"resolved_by"`
	Reason      string                         `json:"reason,omitempty"`
	Redacted    bool                           `json:"redacted"`
	Length      int                            `json:"length"`
	RequestedAt time.Time                      `json:"requested_at"`
	ResolvedAt  time.Time                      `json:"resolved_at"`
}

type TerminalResponse

type TerminalResponse struct {
	Terminal TerminalInfoPayload `json:"terminal"`
}

type TerminalRunPayload

type TerminalRunPayload struct {
	SessionID  string `json:"session_id"`
	RunID      string `json:"run_id"`
	Generation int64  `json:"generation"`
}

type TerminalSequence

type TerminalSequence string

TerminalSequence is the decimal uint64 representation used by terminal JSON contracts.

func TerminalSequenceFromUint64

func TerminalSequenceFromUint64(sequence uint64) TerminalSequence

TerminalSequenceFromUint64 returns the canonical decimal representation of sequence.

func (TerminalSequence) Uint64

func (sequence TerminalSequence) Uint64() (uint64, error)

Uint64 validates and converts a terminal sequence received from a public boundary.

type TerminalSignal

type TerminalSignal string

type TerminalSignalRequest

type TerminalSignalRequest struct {
	Signal TerminalSignal `json:"signal"`
}

type TerminalSpillPayload

type TerminalSpillPayload struct {
	ArtifactID string `json:"artifact_id"`
	Bytes      int64  `json:"bytes"`
}

type TerminalState

type TerminalState string
const (
	TerminalStateRunning TerminalState = "running"
	TerminalStateExited  TerminalState = "exited"
)

type TerminalWaitRequest

type TerminalWaitRequest struct {
	Until     string `json:"until"`
	Pattern   string `json:"pattern,omitempty"`
	TimeoutMs int    `json:"timeout_ms,omitzero"`
}

type TerminalWaitResponse

type TerminalWaitResponse struct {
	Reason    string `json:"reason"`
	ExitCode  *int   `json:"exit_code,omitzero"`
	Screen    string `json:"screen"`
	Untrusted bool   `json:"untrusted"`
}

func TerminalWaitResponseFromDomain

func TerminalWaitResponseFromDomain(result terminalpkg.WaitResult) TerminalWaitResponse

type TerminateProcessesRequest

type TerminateProcessesRequest struct {
	Targets []SessionProcessTarget `json:"targets"`
}

type TerminateSessionProcessesRequest

type TerminateSessionProcessesRequest struct {
	Targets      []SessionProcessTarget `json:"targets,omitempty"`
	All          bool                   `json:"all,omitempty"`
	IncludeTools bool                   `json:"include_tools,omitempty"`
}

TerminateSessionProcessesRequest stops each target's whole process tree. All stops every tree the session left running; tool calls still running in the agent's turn join only with IncludeTools.

type TerminateSessionProcessesResponse

type TerminateSessionProcessesResponse struct {
	Supported bool                   `json:"supported"`
	Results   []SessionProcessResult `json:"results"`
}

type TokenUsagePayload

type TokenUsagePayload struct {
	Meta             map[string]any `json:"meta,omitempty"`
	Sequence         *int64         `json:"sequence,omitzero"`
	TurnID           string         `json:"turn_id,omitempty"`
	InputTokens      *int64         `json:"input_tokens,omitzero"`
	OutputTokens     *int64         `json:"output_tokens,omitzero"`
	TotalTokens      *int64         `json:"total_tokens,omitzero"`
	ThoughtTokens    *int64         `json:"thought_tokens,omitzero"`
	CacheReadTokens  *int64         `json:"cache_read_tokens,omitzero"`
	CacheWriteTokens *int64         `json:"cache_write_tokens,omitzero"`
	ContextUsed      *int64         `json:"context_used,omitzero"`
	ContextSize      *int64         `json:"context_size,omitzero"`
	CostAmount       *float64       `json:"cost_amount,omitzero"`
	CostCurrency     *string        `json:"cost_currency,omitzero"`
	Timestamp        time.Time      `json:"timestamp"`
}

TokenUsagePayload is the shared token-usage response payload.

type ToolApprovalGrantListResponse

type ToolApprovalGrantListResponse struct {
	Grants []ToolApprovalGrantPayload `json:"grants"`
	Total  int                        `json:"total"`
}

ToolApprovalGrantListResponse wraps one workspace's remembered decisions.

type ToolApprovalGrantPayload

type ToolApprovalGrantPayload struct {
	ID              string                         `json:"id"`
	ProfileID       string                         `json:"profile_id"`
	ProfileName     string                         `json:"profile_name"`
	ProfileColor    string                         `json:"profile_color"`
	ProfileIcon     string                         `json:"profile_icon,omitempty"`
	ProfileEmoji    string                         `json:"profile_emoji,omitempty"`
	ProfileArchived bool                           `json:"profile_archived"`
	WorkspaceID     string                         `json:"workspace_id"`
	AgentName       string                         `json:"agent_name,omitempty"`
	ToolID          toolspkg.ToolID                `json:"tool_id"`
	InputDigest     string                         `json:"input_digest,omitempty"`
	Decision        toolspkg.ApprovalGrantDecision `json:"decision"`
	CreatedAt       time.Time                      `json:"created_at"`
	LastUsedAt      time.Time                      `json:"last_used_at"`
}

ToolApprovalGrantPayload is one workspace-scoped remembered native-tool approval decision.

func ToolApprovalGrantPayloadFromDomain

func ToolApprovalGrantPayloadFromDomain(grant toolspkg.ApprovalGrant) ToolApprovalGrantPayload

ToolApprovalGrantPayloadFromDomain converts one durable decision into the shared transport shape.

type ToolApprovalGrantResponse

type ToolApprovalGrantResponse struct {
	Grant ToolApprovalGrantPayload `json:"grant"`
}

ToolApprovalGrantResponse wraps one stored wider approval decision.

type ToolApprovalGrantSetRequest

type ToolApprovalGrantSetRequest struct {
	ToolID    toolspkg.ToolID                       `json:"tool_id"`
	Decision  toolspkg.ApprovalGrantDecision        `json:"decision"`
	Scope     toolspkg.ApprovalGrantManagementScope `json:"scope"`
	AgentName string                                `json:"agent_name,omitempty"`
}

ToolApprovalGrantSetRequest creates or replaces one explicit wider remembered decision.

func (ToolApprovalGrantSetRequest) Domain

Domain converts the transport request into the domain-owned validation shape.

type ToolApprovalPayload

type ToolApprovalPayload struct {
	ApprovalToken string       `json:"approval_token"`
	ExpiresAt     time.Time    `json:"expires_at"`
	ToolID        tools.ToolID `json:"tool_id"`
	InputDigest   string       `json:"input_digest"`
}

ToolApprovalPayload is the only response shape that can expose a raw approval token.

type ToolApprovalRequest

type ToolApprovalRequest struct {
	SessionID   string          `json:"session_id"`
	WorkspaceID string          `json:"workspace_id,omitempty"`
	AgentName   string          `json:"agent_name,omitempty"`
	Input       json.RawMessage `json:"input,omitempty"`
	InputDigest string          `json:"input_digest,omitempty"`
}

ToolApprovalRequest requests one local approval reference for a concrete invocation.

type ToolApprovalResponse

type ToolApprovalResponse struct {
	Approval ToolApprovalPayload `json:"approval"`
}

ToolApprovalResponse returns one approval reference.

type ToolApprovalStatusResponse

type ToolApprovalStatusResponse struct {
	ApprovalStatus  toolspkg.ApprovalOutcome         `json:"approval_status"`
	ExecutionStatus toolspkg.ApprovalExecutionStatus `json:"execution_status,omitempty"`
	Result          json.RawMessage                  `json:"result,omitempty"`
	Error           json.RawMessage                  `json:"error,omitempty"`
	ExpiresAt       *time.Time                       `json:"expires_at,omitempty"`
}

func ToolApprovalStatusFromDomain

func ToolApprovalStatusFromDomain(status toolspkg.ApprovalStatus) ToolApprovalStatusResponse

type ToolArtifactPageResponse

type ToolArtifactPageResponse struct {
	Artifact   tools.ArtifactRef `json:"artifact"`
	Offset     int64             `json:"offset"`
	Bytes      int64             `json:"bytes"`
	TotalBytes int64             `json:"total_bytes"`
	DataBase64 string            `json:"data_base64"`
	NextOffset int64             `json:"next_offset"`
	EOF        bool              `json:"eof"`
}

ToolArtifactPageResponse is one exact byte page from a retained oversized result.

type ToolAvailabilityPayload

type ToolAvailabilityPayload struct {
	Registered  bool               `json:"registered"`
	Enabled     bool               `json:"enabled"`
	Available   bool               `json:"available"`
	Authorized  bool               `json:"authorized"`
	Executable  bool               `json:"executable"`
	Conflicted  bool               `json:"conflicted"`
	ReasonCodes []tools.ReasonCode `json:"reason_codes,omitempty"`
}

ToolAvailabilityPayload records composable runtime availability diagnostics.

type ToolBackendRefPayload

type ToolBackendRefPayload struct {
	Kind                 tools.BackendKind `json:"kind"`
	ExtensionID          string            `json:"extension_id,omitempty"`
	Handler              string            `json:"handler,omitempty"`
	MCPServer            string            `json:"mcp_server,omitempty"`
	MCPTool              string            `json:"mcp_tool,omitempty"`
	NativeName           string            `json:"native_name,omitempty"`
	RequiresCapabilities []string          `json:"requires_capabilities,omitempty"`
}

ToolBackendRefPayload identifies the executable backend without leaking backend secrets.

type ToolCallEventPayload

type ToolCallEventPayload struct {
	Kind                 tools.ToolCallEventKind `json:"kind"`
	ToolID               tools.ToolID            `json:"tool_id"`
	DisplayTitle         string                  `json:"display_title,omitempty"`
	SourceKind           tools.SourceKind        `json:"source_kind,omitempty"`
	SourceOwner          string                  `json:"source_owner,omitempty"`
	WorkspaceID          string                  `json:"workspace_id,omitempty"`
	SessionID            string                  `json:"session_id,omitempty"`
	AgentName            string                  `json:"agent_name,omitempty"`
	Risk                 tools.RiskClass         `json:"risk,omitempty"`
	ReadOnly             bool                    `json:"read_only"`
	Destructive          bool                    `json:"destructive"`
	OpenWorld            bool                    `json:"open_world"`
	ApprovalMode         string                  `json:"approval_mode,omitempty"`
	Decision             string                  `json:"decision,omitempty"`
	ReasonCodes          []tools.ReasonCode      `json:"reason_codes,omitempty"`
	DurationMS           int64                   `json:"duration_ms,omitzero"`
	ResultBytes          int64                   `json:"result_bytes,omitzero"`
	Truncated            bool                    `json:"truncated"`
	CorrelationID        string                  `json:"correlation_id,omitempty"`
	ErrorCode            tools.ErrorCode         `json:"error_code,omitempty"`
	InputDigest          string                  `json:"input_digest,omitempty"`
	RedactedInputFields  []string                `json:"redacted_input_fields,omitempty"`
	ResultDigest         string                  `json:"result_digest,omitempty"`
	ResultRedactionPaths []string                `json:"result_redaction_paths,omitempty"`
}

ToolCallEventPayload is a redacted dispatch event surfaced when a handler can collect events.

type ToolDescriptorPayload

type ToolDescriptorPayload struct {
	ToolID              tools.ToolID          `json:"tool_id"`
	Backend             ToolBackendRefPayload `json:"backend"`
	DisplayTitle        string                `json:"display_title,omitempty"`
	FriendlyVerb        string                `json:"friendly_verb,omitempty"`
	Preview             string                `json:"preview,omitempty"`
	Description         string                `json:"description"`
	InputSchema         json.RawMessage       `json:"input_schema"`
	OutputSchema        json.RawMessage       `json:"output_schema,omitempty"`
	InputSchemaDigest   string                `json:"input_schema_digest"`
	OutputSchemaDigest  string                `json:"output_schema_digest,omitempty"`
	Source              ToolSourceRefPayload  `json:"source"`
	Visibility          tools.Visibility      `json:"visibility"`
	Risk                tools.RiskClass       `json:"risk"`
	ReadOnly            bool                  `json:"read_only"`
	Destructive         bool                  `json:"destructive"`
	OpenWorld           bool                  `json:"open_world"`
	RequiresInteraction bool                  `json:"requires_interaction"`
	ConcurrencySafe     bool                  `json:"concurrency_safe"`
	MaxResultBytes      int64                 `json:"max_result_bytes,omitzero"`
	Toolsets            []tools.ToolsetID     `json:"toolsets,omitempty"`
	Tags                []string              `json:"tags,omitempty"`
	SearchHints         []string              `json:"search_hints,omitempty"`
}

ToolDescriptorPayload is the public descriptor shape exposed by daemon APIs.

type ToolErrorPayload

type ToolErrorPayload struct {
	Code          tools.ErrorCode            `json:"code"`
	Message       string                     `json:"message"`
	ToolID        tools.ToolID               `json:"tool_id,omitempty"`
	ReasonCodes   []tools.ReasonCode         `json:"reason_codes,omitempty"`
	Layer         string                     `json:"layer,omitempty"`
	Details       map[string]json.RawMessage `json:"details,omitempty"`
	PartialResult *tools.ToolResult          `json:"partial_result,omitzero"`
}

ToolErrorPayload is the structured error envelope for tool registry routes.

type ToolErrorResponse

type ToolErrorResponse struct {
	Error ToolErrorPayload `json:"error"`
}

ToolErrorResponse returns one structured tool error.

type ToolInvokeRequest

type ToolInvokeRequest struct {
	SessionID            string          `json:"session_id,omitempty"`
	WorkspaceID          string          `json:"workspace_id,omitempty"`
	AgentName            string          `json:"agent_name,omitempty"`
	ToolCallID           string          `json:"tool_call_id,omitempty"`
	TurnID               string          `json:"turn_id,omitempty"`
	CorrelationID        string          `json:"correlation_id,omitempty"`
	Input                json.RawMessage `json:"input"`
	SensitiveInputFields []string        `json:"sensitive_input_fields,omitempty"`
	ApprovalToken        string          `json:"approval_token,omitempty"`
}

ToolInvokeRequest executes a concrete tool call through registry dispatch.

type ToolInvokeResponse

type ToolInvokeResponse struct {
	ToolID     tools.ToolID           `json:"tool_id"`
	Status     string                 `json:"status"`
	Result     tools.ToolResult       `json:"result"`
	Truncated  bool                   `json:"truncated"`
	DurationMS int64                  `json:"duration_ms"`
	Events     []ToolCallEventPayload `json:"events"`
}

ToolInvokeResponse is the stable result envelope returned by invoke endpoints.

type ToolPayload

type ToolPayload struct {
	Descriptor   ToolDescriptorPayload     `json:"descriptor"`
	Availability ToolAvailabilityPayload   `json:"availability"`
	Decision     ToolPolicyDecisionPayload `json:"decision"`
}

ToolPayload is one public registry projection row.

type ToolPolicyDecisionPayload

type ToolPolicyDecisionPayload struct {
	VisibleToOperator    bool               `json:"visible_to_operator"`
	VisibleToSession     bool               `json:"visible_to_session"`
	Callable             bool               `json:"callable"`
	ApprovalRequired     bool               `json:"approval_required"`
	SystemPermissionMode string             `json:"system_permission_mode,omitempty"`
	SessionPolicyResult  string             `json:"session_policy_result,omitempty"`
	AgentPolicyResult    string             `json:"agent_policy_result,omitempty"`
	RegistryPolicyResult string             `json:"registry_policy_result,omitempty"`
	SourcePolicyResult   string             `json:"source_policy_result,omitempty"`
	AvailabilityResult   string             `json:"availability_result,omitempty"`
	HookResult           string             `json:"hook_result,omitempty"`
	ReasonCodes          []tools.ReasonCode `json:"reason_codes,omitempty"`
}

ToolPolicyDecisionPayload records effective policy and availability decisions for a caller.

type ToolResponse

type ToolResponse struct {
	Tool ToolPayload `json:"tool"`
}

ToolResponse returns one registry tool projection.

type ToolSearchRequest

type ToolSearchRequest struct {
	Query       string `json:"query"`
	Limit       int    `json:"limit,omitzero"`
	WorkspaceID string `json:"workspace_id,omitempty"`
	SessionID   string `json:"session_id,omitempty"`
	AgentName   string `json:"agent_name,omitempty"`
}

ToolSearchRequest filters the scoped registry projection.

type ToolSourceRefPayload

type ToolSourceRefPayload struct {
	Kind            tools.SourceKind `json:"kind"`
	Owner           string           `json:"owner"`
	RawServerName   string           `json:"raw_server_name,omitempty"`
	RawToolName     string           `json:"raw_tool_name,omitempty"`
	ResourceID      string           `json:"resource_id,omitempty"`
	ResourceVersion string           `json:"resource_version,omitempty"`
	WorkspaceID     string           `json:"workspace_id,omitempty"`
	Scope           string           `json:"scope,omitempty"`
}

ToolSourceRefPayload preserves descriptor provenance without alternate identities.

type ToolsResponse

type ToolsResponse struct {
	Tools []ToolPayload `json:"tools"`
}

ToolsResponse returns a registry projection.

type ToolsetPayload

type ToolsetPayload struct {
	ID            tools.ToolsetID    `json:"id"`
	Tools         []string           `json:"tools,omitempty"`
	Toolsets      []tools.ToolsetID  `json:"toolsets,omitempty"`
	ExpandedTools []tools.ToolID     `json:"expanded_tools,omitempty"`
	Status        string             `json:"status"`
	ReasonCodes   []tools.ReasonCode `json:"reason_codes,omitempty"`
}

ToolsetPayload describes one named toolset and its expansion state.

type ToolsetResponse

type ToolsetResponse struct {
	Toolset ToolsetPayload `json:"toolset"`
}

ToolsetResponse returns one toolset projection.

type ToolsetsResponse

type ToolsetsResponse struct {
	Toolsets []ToolsetPayload `json:"toolsets"`
}

ToolsetsResponse returns the known toolset catalog projection.

type TranscriptDeltaPayload

type TranscriptDeltaPayload struct {
	SessionID     string             `json:"session_id"`
	WorkspaceID   string             `json:"workspace_id,omitempty"`
	WorkspacePath string             `json:"workspace_path,omitempty"`
	Epoch         int64              `json:"epoch"`
	Generation    int64              `json:"generation"`
	Entries       []transcript.Entry `json:"entries"`
	Cursor        int64              `json:"cursor"`
	MaxSequence   int64              `json:"max_sequence"`
	HasMore       bool               `json:"has_more"`
}

TranscriptDeltaPayload carries one bounded batch of materialized entry upserts.

type TranscriptMarkerPayload

type TranscriptMarkerPayload struct {
	Kind       string          `json:"kind"`
	OccurredAt time.Time       `json:"occurred_at"`
	Summary    string          `json:"summary"`
	Evidence   map[string]any  `json:"evidence,omitempty"`
	Diagnostic json.RawMessage `json:"diagnostic,omitempty"`
}

TranscriptMarkerPayload is the typed transcript marker shape shared by logs, recap, and transcript UI projections.

type TranscriptSnapshotPayload

type TranscriptSnapshotPayload struct {
	SessionID          string             `json:"session_id"`
	WorkspaceID        string             `json:"workspace_id,omitempty"`
	WorkspacePath      string             `json:"workspace_path,omitempty"`
	Epoch              int64              `json:"epoch"`
	Generation         int64              `json:"generation"`
	Entries            []transcript.Entry `json:"entries"`
	MaxSequence        int64              `json:"max_sequence"`
	HasOlder           bool               `json:"has_older"`
	NextBeforeSequence int64              `json:"next_before_sequence,omitzero"`
	Reset              bool               `json:"reset"`
	Reason             string             `json:"reason,omitempty"`
}

TranscriptSnapshotPayload seeds or explicitly resets one bounded transcript tail.

type TriggerPayload

type TriggerPayload struct {
	TargetInstanceScope  string                        `json:"target_instance_scope,omitempty"`
	ID                   string                        `json:"id"`
	ProfileID            string                        `json:"profile_id"`
	ProfileName          string                        `json:"profile_name"`
	ProfileColor         string                        `json:"profile_color,omitempty"`
	ProfileIcon          string                        `json:"profile_icon,omitempty"`
	Scope                automationpkg.Scope           `json:"scope"`
	Name                 string                        `json:"name"`
	TargetKind           automationpkg.TargetKind      `json:"target_kind"`
	AgentName            string                        `json:"agent_name"`
	WorkspaceID          string                        `json:"workspace_id,omitempty"`
	Prompt               string                        `json:"prompt"`
	Event                string                        `json:"event"`
	Filter               map[string]string             `json:"filter,omitempty"`
	LoopTarget           *automationpkg.LoopTarget     `json:"loop_target,omitempty"`
	Enabled              bool                          `json:"enabled"`
	Retry                automationpkg.RetryConfig     `json:"retry"`
	FireLimit            automationpkg.FireLimitConfig `json:"fire_limit"`
	Source               automationpkg.JobSource       `json:"source"`
	WebhookID            string                        `json:"webhook_id,omitempty"`
	EndpointSlug         string                        `json:"endpoint_slug,omitempty"`
	WebhookSecretPresent bool                          `json:"webhook_secret_present"`
	WebhookSecretHash    string                        `json:"webhook_secret_hash,omitempty"`
	Ingress              *GatewayIngressPayload        `json:"ingress,omitempty"`
	CreatedAt            time.Time                     `json:"created_at"`
	UpdatedAt            time.Time                     `json:"updated_at"`
	LastRun              *AutomationLastRunPayload     `json:"last_run,omitzero"`
}

TriggerPayload is the shared automation trigger response payload.

func TriggerPayloadFromTrigger

func TriggerPayloadFromTrigger(trigger automationpkg.Trigger) TriggerPayload

TriggerPayloadFromTrigger converts an internal automation trigger into the public redacted automation trigger payload.

func TriggerPayloadsFromTriggers

func TriggerPayloadsFromTriggers(triggers []automationpkg.Trigger) []TriggerPayload

TriggerPayloadsFromTriggers converts internal automation triggers into public redacted automation trigger payloads.

type TriggerResponse

type TriggerResponse struct {
	Trigger TriggerPayload `json:"trigger"`
}

TriggerResponse wraps one shared automation trigger payload.

type TriggersResponse

type TriggersResponse struct {
	Triggers []TriggerPayload         `json:"triggers"`
	Page     CountedCursorPagePayload `json:"page"`
}

TriggersResponse wraps the shared automation trigger list payload.

type TurnHistoryPayload

type TurnHistoryPayload struct {
	TurnID string                `json:"turn_id"`
	Events []SessionEventPayload `json:"events"`
}

TurnHistoryPayload is the shared turn history response payload.

type UnarchiveProfileResponse

type UnarchiveProfileResponse struct {
	State             string   `json:"state"`
	PausedAutomations []string `json:"paused_automations"`
}

UnarchiveProfileResponse reports the outcome of restoring a profile.

type UpdateAgentRequest

type UpdateAgentRequest struct {
	Workspace      string             `json:"workspace,omitempty"`
	Agent          CreateAgentPayload `json:"agent"`
	ExpectedDigest string             `json:"expected_digest"`
}

UpdateAgentRequest replaces the effective route agent definition.

type UpdateAppTokenRequest

type UpdateAppTokenRequest struct {
	Name    *string   `json:"name,omitempty"`
	Origins *[]string `json:"origins,omitempty"`
}

type UpdateExtensionRequest

type UpdateExtensionRequest struct {
	Scope                string                          `json:"scope,omitempty"`
	WorkspaceID          string                          `json:"workspace_id,omitempty"`
	Profile              string                          `json:"profile,omitempty"`
	Inputs               map[string]extensioninput.Value `json:"inputs,omitempty"`
	Version              string                          `json:"version,omitempty"`
	CheckOnly            bool                            `json:"check_only,omitzero"`
	AllowUnverified      bool                            `json:"allow_unverified,omitzero"`
	ConfirmGatewayDigest string                          `json:"confirm_gateway_digest,omitempty"`
}

UpdateExtensionRequest is the shared marketplace extension update payload.

type UpdateExtensionsRequest

type UpdateExtensionsRequest struct {
	Scope           string                          `json:"scope,omitempty"`
	WorkspaceID     string                          `json:"workspace_id,omitempty"`
	Profile         string                          `json:"profile,omitempty"`
	Inputs          map[string]extensioninput.Value `json:"inputs,omitempty"`
	Names           []string                        `json:"names,omitempty"`
	All             bool                            `json:"all,omitzero"`
	Version         string                          `json:"version,omitempty"`
	CheckOnly       bool                            `json:"check_only,omitzero"`
	AllowUnverified bool                            `json:"allow_unverified,omitzero"`
}

UpdateExtensionsRequest selects one or more managed extension updates.

type UpdateJobRequest

type UpdateJobRequest struct {
	Name       *string                        `json:"name,omitempty"`
	Prompt     *string                        `json:"prompt,omitempty"`
	Schedule   *automationpkg.ScheduleSpec    `json:"schedule,omitempty"`
	Task       *automationpkg.JobTaskConfig   `json:"task,omitempty"`
	LoopTarget *automationpkg.LoopTarget      `json:"loop_target,omitempty"`
	Enabled    *bool                          `json:"enabled,omitempty"`
	Retry      *automationpkg.RetryConfig     `json:"retry,omitempty"`
	FireLimit  *automationpkg.FireLimitConfig `json:"fire_limit,omitempty"`
}

UpdateJobRequest is the shared automation job patch payload.

func (UpdateJobRequest) HasChanges

func (r UpdateJobRequest) HasChanges() bool

HasChanges reports whether the patch includes any mutable field.

type UpdateMarketplaceSourceRequest

type UpdateMarketplaceSourceRequest struct {
	Enabled *bool `json:"enabled"`
}

type UpdateProfileRequest

type UpdateProfileRequest struct {
	Color *string `json:"color,omitzero"`
	Icon  *string `json:"icon,omitzero"`
	Emoji *string `json:"emoji,omitzero"`
}

UpdateProfileRequest changes mutable profile identity fields.

type UpdateSettingsAttentionPayload

type UpdateSettingsAttentionPayload struct {
	Toasts          bool      `json:"toasts"`
	Sound           bool      `json:"sound"`
	System          bool      `json:"system"`
	MutedWorkspaces *[]string `json:"muted_workspaces,omitzero"`
}

UpdateSettingsAttentionPayload updates delivery channels and optionally replaces one profile's mutes.

type UpdateSettingsAttentionRequest

type UpdateSettingsAttentionRequest struct {
	Config UpdateSettingsAttentionPayload `json:"config"`
}

UpdateSettingsAttentionRequest updates the attention section for the selected profile.

type UpdateSettingsAutomationRequest

type UpdateSettingsAutomationRequest struct {
	Config SettingsAutomationConfigPayload `json:"config"`
}

type UpdateSettingsCmdPaletteRequest

type UpdateSettingsCmdPaletteRequest struct {
	FallbackAgentEnabled *bool              `json:"fallback_agent_enabled,omitzero"`
	Personalization      *bool              `json:"personalization,omitzero"`
	Aliases              *map[string]string `json:"aliases,omitzero"`
}

type UpdateSettingsGeneralRequest

type UpdateSettingsGeneralRequest struct {
	Config SettingsGeneralConfigPayload `json:"config"`
}

type UpdateSettingsHooksExtensionsRequest

type UpdateSettingsHooksExtensionsRequest struct {
	Config SettingsExtensionsConfigPayload `json:"config"`
}

type UpdateSettingsMarketplaceRequest

type UpdateSettingsMarketplaceRequest struct {
	Config SettingsMarketplaceCatalogPayload `json:"config"`
}

type UpdateSettingsObservabilityRequest

type UpdateSettingsObservabilityRequest struct {
	Config SettingsObservabilityConfigPayload `json:"config"`
}

type UpdateSettingsPersonaRequest

type UpdateSettingsPersonaRequest struct {
	Config SettingsDefaultsPayload `json:"config"`
}

type UpdateSettingsRolesRequest

type UpdateSettingsRolesRequest struct {
	Config SettingsRolesConfigPayload `json:"config"`
}

type UpdateSettingsShellRequest

type UpdateSettingsShellRequest struct {
	Config SettingsShellPayload `json:"config"`
}

UpdateSettingsShellRequest updates supplied shell preferences and preserves omitted fields.

type UpdateSettingsSkillsRequest

type UpdateSettingsSkillsRequest struct {
	Config   SettingsSkillsConfigPayload    `json:"config,omitzero"`
	Override *SettingsSkillsOverridePayload `json:"override,omitzero"`
}

func (UpdateSettingsSkillsRequest) MarshalJSON

func (r UpdateSettingsSkillsRequest) MarshalJSON() ([]byte, error)

MarshalJSON emits the scope-specific skills request shape without a zero-value sibling object.

type UpdateSettingsWindowManagerRequest

type UpdateSettingsWindowManagerRequest struct {
	PreserveShortcuts bool                                      `json:"preserve_shortcuts,omitzero"`
	Config            *SettingsWindowManagerConfigPayload       `json:"config,omitzero"`
	Shortcuts         *map[string]windowmanager.ShortcutBinding `json:"shortcuts,omitzero"`
	Aliases           *map[string]string                        `json:"aliases,omitzero"`
	GlobalShortcuts   *map[string]string                        `json:"global_shortcuts,omitzero"`
	Overwrite         bool                                      `json:"overwrite,omitzero"`
}

type UpdateTaskRequest

type UpdateTaskRequest struct {
	Title              *string                 `json:"title,omitempty"`
	Description        *string                 `json:"description,omitempty"`
	Priority           *taskpkg.Priority       `json:"priority,omitempty"`
	MaxAttempts        *int                    `json:"max_attempts,omitempty"`
	AutoEnqueueOnReady *bool                   `json:"auto_enqueue_on_ready,omitempty"`
	ApprovalPolicy     *taskpkg.ApprovalPolicy `json:"approval_policy,omitempty"`
	Metadata           *json.RawMessage        `json:"metadata,omitempty"`
	Owner              *taskpkg.Ownership      `json:"owner,omitempty"`
	ClearOwner         bool                    `json:"clear_owner,omitempty"`
}

UpdateTaskRequest is the shared task patch payload.

func (UpdateTaskRequest) HasChanges

func (r UpdateTaskRequest) HasChanges() bool

HasChanges reports whether the patch includes any mutable task field.

type UpdateTriggerRequest

type UpdateTriggerRequest struct {
	TargetInstanceScope *string                        `json:"target_instance_scope,omitempty"`
	Name                *string                        `json:"name,omitempty"`
	Prompt              *string                        `json:"prompt,omitempty"`
	Event               *string                        `json:"event,omitempty"`
	Filter              map[string]string              `json:"filter,omitempty"`
	LoopTarget          *automationpkg.LoopTarget      `json:"loop_target,omitempty"`
	Enabled             *bool                          `json:"enabled,omitempty"`
	Retry               *automationpkg.RetryConfig     `json:"retry,omitempty"`
	FireLimit           *automationpkg.FireLimitConfig `json:"fire_limit,omitempty"`
	WebhookID           *string                        `json:"webhook_id,omitempty"`
	EndpointSlug        *string                        `json:"endpoint_slug,omitempty"`
	WebhookSecretValue  *string                        `json:"webhook_secret_value,omitempty"`
}

UpdateTriggerRequest is the shared automation trigger patch payload.

func (UpdateTriggerRequest) HasChanges

func (r UpdateTriggerRequest) HasChanges() bool

HasChanges reports whether the patch includes any mutable field.

type UpdateWorkspaceRequest

type UpdateWorkspaceRequest struct {
	Name         *string   `json:"name"`
	AddDirs      *[]string `json:"add_dirs"`
	DefaultAgent *string   `json:"default_agent"`
}

UpdateWorkspaceRequest is the shared workspace update request payload.

type ValidateLoopRequest

type ValidateLoopRequest struct {
	Definition LoopDefinitionDocument `json:"definition"`
}

ValidateLoopRequest lints and compiles a Loop definition without saving it.

type ValidationIssue

type ValidationIssue struct {
	Path     string        `json:"path"`
	Scope    string        `json:"scope,omitempty"`
	Line     int           `json:"line,omitempty"`
	Column   int           `json:"column,omitempty"`
	Field    string        `json:"field,omitempty"`
	Message  string        `json:"message"`
	Severity IssueSeverity `json:"severity"`
}

ValidationIssue is one positioned extension-package validation diagnostic.

type VaultSecretPayload

type VaultSecretPayload struct {
	Ref       string    `json:"ref"`
	Namespace string    `json:"namespace"`
	Kind      string    `json:"kind,omitempty"`
	Present   bool      `json:"present"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

VaultSecretPayload is redacted vault metadata safe for public control surfaces.

type VaultSecretResponse

type VaultSecretResponse struct {
	Secret VaultSecretPayload `json:"secret"`
}

VaultSecretResponse wraps one redacted vault metadata row.

type VaultSecretsResponse

type VaultSecretsResponse struct {
	Secrets []VaultSecretPayload `json:"secrets"`
}

VaultSecretsResponse wraps a redacted vault metadata list.

type ViewFrame

type ViewFrame = cmdpalette.ViewFrame

type WebhookDeliveryPayload

type WebhookDeliveryPayload struct {
	Matched int          `json:"matched"`
	Runs    []RunPayload `json:"runs,omitempty"`
}

WebhookDeliveryPayload is the shared webhook dispatch response payload.

type WebhookDeliveryResponse

type WebhookDeliveryResponse struct {
	Result WebhookDeliveryPayload `json:"result"`
}

WebhookDeliveryResponse wraps the shared webhook delivery result payload.

type WindowManagerActor

type WindowManagerActor struct {
	Kind string `json:"kind,omitempty"`
	ID   string `json:"id,omitempty"`
}

WindowManagerActor records a command initiator without affecting command semantics.

type WindowManagerArrangeLayoutPayload

type WindowManagerArrangeLayoutPayload struct {
	DesktopID   windowmanager.DesktopID      `json:"desktop_id"`
	WindowIDs   []windowmanager.WindowID     `json:"window_ids"`
	Arrangement windowmanager.Arrangement    `json:"arrangement"`
	Frame       windowmanager.NormalizedRect `json:"frame"`
	GroupID     windowmanager.GroupID        `json:"group_id"`
	ResourceID  string                       `json:"resource_id,omitempty"`
	// KeepFrames arranges each named window's whole tab frame as one
	// participant (deck members, active tab and identity kept); later names in
	// an already-named frame are absorbed. Omitted, each window stands alone.
	KeepFrames bool `json:"keep_frames,omitzero"`
}

type WindowManagerBalanceLayoutPayload

type WindowManagerBalanceLayoutPayload struct {
	GroupID *windowmanager.GroupID `json:"group_id,omitzero"`
	SplitID *windowmanager.NodeID  `json:"split_id,omitzero"`
}

type WindowManagerClientCommandAckFrame

type WindowManagerClientCommandAckFrame struct {
	Type      string `json:"type"`
	CommandID string `json:"command_id"`
}

WindowManagerClientCommandAckFrame acknowledges delivery before client execution completes.

type WindowManagerClientCommandFrame

type WindowManagerClientCommandFrame struct {
	Type        string                    `json:"type"`
	WorkspaceID windowmanager.WorkspaceID `json:"workspace_id"`
	CommandID   string                    `json:"command_id"`
	Op          string                    `json:"op"`
	Payload     json.RawMessage           `json:"payload,omitempty"`
}

WindowManagerClientCommandFrame carries one daemon-to-client UI operation.

type WindowManagerClientCommandResultFrame

type WindowManagerClientCommandResultFrame struct {
	Type      string          `json:"type"`
	CommandID string          `json:"command_id"`
	Result    json.RawMessage `json:"result,omitempty"`
	Error     string          `json:"error,omitempty"`
}

WindowManagerClientCommandResultFrame terminates one correlated client operation.

type WindowManagerClientContextFrame

type WindowManagerClientContextFrame struct {
	Type    string                          `json:"type"`
	Context WindowManagerClientContextInput `json:"context"`
}

WindowManagerClientContextFrame replaces the client-owned palette context on one bound stream.

type WindowManagerClientContextInput

type WindowManagerClientContextInput struct {
	ScopeGlobal         bool                                       `json:"scope_global"`
	FocusedSessionState string                                     `json:"focused_session_state,omitempty"`
	WorkspaceTrusted    bool                                       `json:"workspace_trusted"`
	DestinationIntent   *windowmanager.RouteIntent                 `json:"destination_intent,omitzero"`
	GlobalShortcuts     []windowmanager.GlobalShortcutRegistration `json:"global_shortcuts"`
}

type WindowManagerClientFrame

type WindowManagerClientFrame struct {
	Type        string                    `json:"type"`
	WorkspaceID windowmanager.WorkspaceID `json:"workspace_id"`
	Revision    WindowManagerRevision     `json:"revision"`
	Client      WindowManagerClientView   `json:"client"`
}

WindowManagerClientFrame carries one bound client's presentation change.

type WindowManagerClientRegistration

type WindowManagerClientRegistration struct {
	WorkspaceID     windowmanager.WorkspaceID       `json:"workspace_id"`
	ClientID        windowmanager.ClientID          `json:"client_id,omitempty"`
	Kind            windowmanager.ClientKind        `json:"kind,omitempty"`
	ActiveDesktopID windowmanager.DesktopID         `json:"active_desktop_id,omitempty"`
	Context         WindowManagerClientContextInput `json:"context"`
}

WindowManagerClientRegistration requests one live client view.

type WindowManagerClientView

type WindowManagerClientView struct {
	WorkspaceID          windowmanager.WorkspaceID                  `json:"workspace_id"`
	ClientID             windowmanager.ClientID                     `json:"client_id"`
	Kind                 windowmanager.ClientKind                   `json:"kind"`
	PresentationRevision WindowManagerRevision                      `json:"presentation_revision"`
	ContextRevision      WindowManagerRevision                      `json:"context_revision"`
	ActiveDesktopID      windowmanager.DesktopID                    `json:"active_desktop_id"`
	FocusedWindowID      *windowmanager.WindowID                    `json:"focused_window_id,omitzero"`
	FocusOrder           []windowmanager.WindowID                   `json:"focus_order"`
	StackActive          map[string]string                          `json:"stack_active"`
	PaletteContext       WindowManagerPaletteContext                `json:"palette_context"`
	GlobalShortcuts      []windowmanager.GlobalShortcutRegistration `json:"global_shortcuts"`
	ConnectedAt          time.Time                                  `json:"connected_at"`
	AttachmentToken      string                                     `json:"attachment_token,omitempty"`
}

WindowManagerClientView is transient presentation state for one connected client.

func WindowManagerClientFromDomain

func WindowManagerClientFromDomain(client windowmanager.ClientView) (WindowManagerClientView, error)

WindowManagerClientFromDomain converts transient client presentation state.

type WindowManagerClientsResponse

type WindowManagerClientsResponse struct {
	WorkspaceID windowmanager.WorkspaceID `json:"workspace_id"`
	Clients     []WindowManagerClientView `json:"clients"`
}

WindowManagerClientsResponse lists client-local views in one workspace partition.

type WindowManagerCloseWindowPayload

type WindowManagerCloseWindowPayload struct {
	WindowID windowmanager.WindowID   `json:"window_id"`
	Minimize bool                     `json:"minimize"`
	Scope    windowmanager.CloseScope `json:"scope,omitempty"`
}

type WindowManagerCommandID

type WindowManagerCommandID string

WindowManagerCommandID is the stable wire discriminator for semantic commands.

const (
	WindowManagerCommandDesktopCreate        WindowManagerCommandID = "desktop.create"
	WindowManagerCommandDesktopUpdate        WindowManagerCommandID = "desktop.update"
	WindowManagerCommandDesktopReorder       WindowManagerCommandID = "desktop.reorder"
	WindowManagerCommandDesktopSwitch        WindowManagerCommandID = "desktop.switch"
	WindowManagerCommandDesktopDelete        WindowManagerCommandID = "desktop.delete"
	WindowManagerCommandWindowOpen           WindowManagerCommandID = "window.open"
	WindowManagerCommandWindowNavigate       WindowManagerCommandID = "window.navigate"
	WindowManagerCommandWindowClose          WindowManagerCommandID = "window.close"
	WindowManagerCommandWindowFocus          WindowManagerCommandID = "window.focus"
	WindowManagerCommandWindowMove           WindowManagerCommandID = "window.move"
	WindowManagerCommandWindowResize         WindowManagerCommandID = "window.resize"
	WindowManagerCommandWindowSwap           WindowManagerCommandID = "window.swap"
	WindowManagerCommandWindowToggleFloating WindowManagerCommandID = "window.toggle_floating"
	WindowManagerCommandWindowZoom           WindowManagerCommandID = "window.zoom"
	WindowManagerCommandWindowStackGroup     WindowManagerCommandID = "window.stack.group"
	WindowManagerCommandWindowStackReorder   WindowManagerCommandID = "window.stack.reorder"
	WindowManagerCommandWindowStackSetActive WindowManagerCommandID = "window.stack.set_active"
	WindowManagerCommandWindowPin            WindowManagerCommandID = "window.pin"
	WindowManagerCommandWindowReopen         WindowManagerCommandID = "window.reopen"
	WindowManagerCommandLayoutArrange        WindowManagerCommandID = "layout.arrange"
	WindowManagerCommandLayoutResize         WindowManagerCommandID = "layout.resize"
	WindowManagerCommandLayoutFrameResize    WindowManagerCommandID = "layout.frame_resize"
	WindowManagerCommandLayoutBalance        WindowManagerCommandID = "layout.balance"
	WindowManagerCommandLayoutUndo           WindowManagerCommandID = "layout.undo"
	WindowManagerCommandLayoutRedo           WindowManagerCommandID = "layout.redo"
	WindowManagerCommandLayoutReplace        WindowManagerCommandID = "layout.replace"
)

type WindowManagerCommandRequest

type WindowManagerCommandRequest struct {
	WorkspaceID      windowmanager.WorkspaceID `json:"workspace_id"`
	CommandID        WindowManagerCommandID    `json:"command_id"`
	ExpectedRevision *WindowManagerRevision    `json:"expected_revision"`
	ClientID         *windowmanager.ClientID   `json:"client_id,omitzero"`
	Actor            WindowManagerActor        `json:"actor"`
	Origin           string                    `json:"origin"`
	Rebase           *WindowManagerRebaseGuard `json:"rebase,omitzero"`
	Payload          json.RawMessage           `json:"payload"`
}

WindowManagerCommandRequest binds one discriminated payload to a workspace revision.

func (WindowManagerCommandRequest) Domain

Domain validates the path/body identity and decodes the payload selected by command_id.

type WindowManagerCreateDesktopPayload

type WindowManagerCreateDesktopPayload struct {
	DesktopID windowmanager.DesktopID  `json:"desktop_id"`
	Name      string                   `json:"name"`
	AfterID   *windowmanager.DesktopID `json:"after_id,omitzero"`
}

type WindowManagerDeleteDesktopPayload

type WindowManagerDeleteDesktopPayload struct {
	DesktopID     windowmanager.DesktopID  `json:"desktop_id"`
	DestinationID *windowmanager.DesktopID `json:"destination_id,omitzero"`
}

type WindowManagerDesktop

type WindowManagerDesktop struct {
	ID             windowmanager.DesktopID      `json:"id"`
	Name           string                       `json:"name"`
	Order          int                          `json:"order"`
	Groups         []WindowManagerLayoutGroup   `json:"groups"`
	Floating       []windowmanager.WindowID     `json:"floating"`
	FloatingStacks []WindowManagerFloatingStack `json:"floating_stacks"`
}

WindowManagerDesktop is one ordered workspace desktop in the stable wire contract.

type WindowManagerErrorCode

type WindowManagerErrorCode string

WindowManagerErrorCode is a stable failure identifier shared by every transport.

const (
	WindowManagerErrorWorkspaceNotFound WindowManagerErrorCode = "window_manager_workspace_not_found"
	WindowManagerErrorRevisionConflict  WindowManagerErrorCode = "window_manager_revision_conflict"
	WindowManagerErrorBindingInvalid    WindowManagerErrorCode = "window_binding_invalid"
	WindowManagerErrorInvalidCommand    WindowManagerErrorCode = "window_manager_invalid_command"
	WindowManagerErrorInvalidTopology   WindowManagerErrorCode = "window_manager_invalid_topology"
	WindowManagerErrorDesktopNotFound   WindowManagerErrorCode = "window_manager_desktop_not_found"
	WindowManagerErrorWindowNotFound    WindowManagerErrorCode = "window_manager_window_not_found"
	WindowManagerErrorNotStacked        WindowManagerErrorCode = "window_manager_not_stacked"
	WindowManagerErrorWindowPinned      WindowManagerErrorCode = "window_manager_window_pinned"
	WindowManagerErrorClientNotFound    WindowManagerErrorCode = "window_manager_client_not_found"
	WindowManagerErrorDestination       WindowManagerErrorCode = "window_manager_destination_required"
	WindowManagerErrorFinalDesktop      WindowManagerErrorCode = "window_manager_final_desktop"
	WindowManagerErrorHistoryBoundary   WindowManagerErrorCode = "window_manager_history_boundary"
	WindowManagerErrorLayoutNotFound    WindowManagerErrorCode = "window_manager_layout_not_found"
	WindowManagerErrorSlowConsumer      WindowManagerErrorCode = "window_manager_slow_consumer"
	WindowManagerErrorUnavailable       WindowManagerErrorCode = "window_manager_unavailable"
)

type WindowManagerErrorFrame

type WindowManagerErrorFrame struct {
	Type  string                    `json:"type"`
	Error WindowManagerErrorPayload `json:"error"`
}

WindowManagerErrorFrame closes a stream with one stable structured error.

type WindowManagerErrorPayload

type WindowManagerErrorPayload struct {
	Error           string                     `json:"error"`
	Code            WindowManagerErrorCode     `json:"code"`
	WorkspaceID     windowmanager.WorkspaceID  `json:"workspace_id"`
	CurrentRevision *WindowManagerRevision     `json:"current_revision,omitzero"`
	Conflicts       []windowmanager.Conflict   `json:"conflicts,omitempty"`
	Diagnostics     []windowmanager.Diagnostic `json:"diagnostics,omitempty"`
}

WindowManagerErrorPayload is the deterministic error body shared by HTTP, UDS, CLI, and WebSocket.

type WindowManagerEvent

type WindowManagerEvent struct {
	WorkspaceID windowmanager.WorkspaceID `json:"workspace_id"`
	Revision    WindowManagerRevision     `json:"revision"`
	CommandID   WindowManagerCommandID    `json:"command_id"`
	Changes     windowmanager.ChangeSet   `json:"changes"`
	Actor       WindowManagerActor        `json:"actor"`
	Origin      string                    `json:"origin,omitempty"`
	OccurredAt  time.Time                 `json:"occurred_at"`
}

WindowManagerEvent is one committed semantic mutation.

func WindowManagerEventFromDomain

func WindowManagerEventFromDomain(event windowmanager.Event) (WindowManagerEvent, error)

WindowManagerEventFromDomain converts a committed domain event to the stable wire form.

type WindowManagerEventFrame

type WindowManagerEventFrame struct {
	Type        string                    `json:"type"`
	WorkspaceID windowmanager.WorkspaceID `json:"workspace_id"`
	Revision    WindowManagerRevision     `json:"revision"`
	Event       WindowManagerEvent        `json:"event"`
}

WindowManagerEventFrame carries one event strictly after the snapshot fence.

type WindowManagerFloatingStack

type WindowManagerFloatingStack struct {
	ID        windowmanager.NodeID         `json:"id"`
	WindowIDs []windowmanager.WindowID     `json:"window_ids"`
	ActiveID  *windowmanager.WindowID      `json:"active_id,omitzero"`
	Rect      windowmanager.NormalizedRect `json:"rect"`
	Minimized bool                         `json:"minimized"`
}

WindowManagerFloatingStack is one ordered tab frame outside the tiled tree.

type WindowManagerFocusWindowPayload

type WindowManagerFocusWindowPayload struct {
	WindowID  *windowmanager.WindowID      `json:"window_id,omitzero"`
	Direction windowmanager.FocusDirection `json:"direction,omitempty"`
}

type WindowManagerFrameResizeLayoutPayload

type WindowManagerFrameResizeLayoutPayload struct {
	DesktopID windowmanager.DesktopID              `json:"desktop_id"`
	Edits     []WindowManagerGroupFrameEditPayload `json:"edits"`
}

type WindowManagerGroupFrameEditPayload

type WindowManagerGroupFrameEditPayload struct {
	GroupID windowmanager.GroupID        `json:"group_id"`
	Frame   windowmanager.NormalizedRect `json:"frame"`
}

type WindowManagerGroupWindowsPayload

type WindowManagerGroupWindowsPayload struct {
	TargetWindowID windowmanager.WindowID   `json:"target_window_id"`
	WindowIDs      []windowmanager.WindowID `json:"window_ids"`
	InsertIndex    *int                     `json:"insert_index,omitzero"`
}

type WindowManagerHeartbeatFrame

type WindowManagerHeartbeatFrame struct {
	Type        string                    `json:"type"`
	WorkspaceID windowmanager.WorkspaceID `json:"workspace_id"`
	Revision    WindowManagerRevision     `json:"revision"`
}

WindowManagerHeartbeatFrame proves the stream is alive and names the latest committed revision so a client can detect a missed event.

type WindowManagerLayoutDocument

type WindowManagerLayoutDocument struct {
	Version     uint32                         `json:"version"`
	WorkspaceID windowmanager.WorkspaceID      `json:"workspace_id"`
	Desktops    []WindowManagerDesktop         `json:"desktops"`
	Windows     map[string]WindowManagerWindow `json:"windows"`
	Overrides   windowmanager.WorkspaceConfig  `json:"overrides"`
}

WindowManagerLayoutDocument is the stable declarative layout wire contract.

func WindowManagerLayoutFromDomain

func WindowManagerLayoutFromDomain(document windowmanager.LayoutDocument) (WindowManagerLayoutDocument, error)

WindowManagerLayoutFromDomain converts a domain layout to its stable wire form.

func (WindowManagerLayoutDocument) Domain

Domain converts a stable wire layout to the authoritative domain document.

type WindowManagerLayoutGroup

type WindowManagerLayoutGroup struct {
	ID    windowmanager.GroupID        `json:"id"`
	Frame windowmanager.NormalizedRect `json:"frame"`
	Root  WindowManagerLayoutNode      `json:"root"`
}

WindowManagerLayoutGroup is one independent tiled island in a desktop.

type WindowManagerLayoutNode

type WindowManagerLayoutNode struct {
	ID        windowmanager.NodeID      `json:"id"`
	Kind      windowmanager.NodeKind    `json:"kind"`
	WindowID  *windowmanager.WindowID   `json:"window_id,omitzero"`
	Axis      *windowmanager.Axis       `json:"axis,omitzero"`
	Children  []WindowManagerLayoutNode `json:"children,omitempty"`
	Weights   []float64                 `json:"weights,omitempty"`
	WindowIDs []windowmanager.WindowID  `json:"window_ids,omitempty"`
	ActiveID  *windowmanager.WindowID   `json:"active_id,omitzero"`
}

WindowManagerLayoutNode is a recursive leaf, weighted split, or tabbed stack.

type WindowManagerLayoutReplaceRequest

type WindowManagerLayoutReplaceRequest struct {
	WorkspaceID      windowmanager.WorkspaceID   `json:"workspace_id"`
	ExpectedRevision *WindowManagerRevision      `json:"expected_revision"`
	ClientID         *windowmanager.ClientID     `json:"client_id,omitzero"`
	Actor            WindowManagerActor          `json:"actor"`
	Origin           string                      `json:"origin"`
	Document         WindowManagerLayoutDocument `json:"document"`
}

WindowManagerLayoutReplaceRequest applies a declarative document through revision CAS.

type WindowManagerLayoutValidationRequest

type WindowManagerLayoutValidationRequest struct {
	WorkspaceID windowmanager.WorkspaceID   `json:"workspace_id"`
	Document    WindowManagerLayoutDocument `json:"document"`
}

WindowManagerLayoutValidationRequest validates a declarative document without writing it.

type WindowManagerLayoutValidationResponse

type WindowManagerLayoutValidationResponse struct {
	WorkspaceID windowmanager.WorkspaceID  `json:"workspace_id"`
	Valid       bool                       `json:"valid"`
	Diagnostics []windowmanager.Diagnostic `json:"diagnostics,omitempty"`
}

WindowManagerLayoutValidationResponse returns stable topology diagnostics.

type WindowManagerMoveWindowPayload

type WindowManagerMoveWindowPayload struct {
	WindowID             windowmanager.WindowID        `json:"window_id"`
	DestinationDesktopID windowmanager.DesktopID       `json:"destination_desktop_id"`
	TargetWindowID       *windowmanager.WindowID       `json:"target_window_id,omitzero"`
	Placement            windowmanager.DropPlacement   `json:"placement"`
	FloatingRect         *windowmanager.NormalizedRect `json:"floating_rect,omitzero"`
	MoveGroup            bool                          `json:"move_group"`
}

type WindowManagerNavigateWindowPayload

type WindowManagerNavigateWindowPayload struct {
	WindowID    windowmanager.WindowID     `json:"window_id"`
	Route       windowmanager.RouteIntent  `json:"route,omitzero"`
	InstanceKey *string                    `json:"instance_key,omitzero"`
	Mode        windowmanager.NavigateMode `json:"mode,omitempty"`
}

type WindowManagerOpenWindowPayload

type WindowManagerOpenWindowPayload struct {
	Window          WindowManagerWindowSpecPayload `json:"window"`
	RestoreWindowID *windowmanager.WindowID        `json:"restore_window_id,omitzero"`
}

type WindowManagerPaletteContext

type WindowManagerPaletteContext struct {
	WindowFocused       bool                       `json:"window_focused"`
	WindowFloating      bool                       `json:"window_floating"`
	WindowStacked       bool                       `json:"window_stacked"`
	DesktopWindowCount  int                        `json:"desktop_window_count"`
	ScopeGlobal         bool                       `json:"scope_global"`
	ShellDesktop        bool                       `json:"shell_desktop"`
	FocusedSessionState string                     `json:"focused_session_state,omitempty"`
	WorkspaceTrusted    bool                       `json:"workspace_trusted"`
	DestinationIntent   *windowmanager.RouteIntent `json:"destination_intent,omitzero"`
}

type WindowManagerPinWindowPayload

type WindowManagerPinWindowPayload struct {
	WindowID windowmanager.WindowID `json:"window_id"`
	Pinned   bool                   `json:"pinned"`
}

type WindowManagerPreview

type WindowManagerPreview struct {
	Snapshot    WindowManagerSnapshot      `json:"snapshot"`
	Changed     bool                       `json:"changed"`
	Changes     windowmanager.ChangeSet    `json:"changes"`
	Diagnostics []windowmanager.Diagnostic `json:"diagnostics,omitempty"`
	Client      *WindowManagerClientView   `json:"client,omitzero"`
}

WindowManagerPreview reports a validated proposal without a durable write.

func WindowManagerPreviewFromDomain

func WindowManagerPreviewFromDomain(preview windowmanager.Preview) (WindowManagerPreview, error)

WindowManagerPreviewFromDomain converts a command preview.

type WindowManagerRebaseGuard

type WindowManagerRebaseGuard struct {
	WindowID      *windowmanager.WindowID `json:"window_id,omitzero"`
	SourceNodeID  *windowmanager.NodeID   `json:"source_node_id,omitzero"`
	TargetNodeID  *windowmanager.NodeID   `json:"target_node_id,omitzero"`
	SplitID       *windowmanager.NodeID   `json:"split_id,omitzero"`
	BoundaryIndex *int                    `json:"boundary_index,omitzero"`
}

WindowManagerRebaseGuard proves stale source and target identities remain unambiguous.

type WindowManagerRedoLayoutPayload

type WindowManagerRedoLayoutPayload struct{}

type WindowManagerReopenWindowPayload

type WindowManagerReopenWindowPayload struct{}

type WindowManagerReorderDesktopPayload

type WindowManagerReorderDesktopPayload struct {
	DesktopID windowmanager.DesktopID `json:"desktop_id"`
	Order     int                     `json:"order"`
}

type WindowManagerReorderStackPayload

type WindowManagerReorderStackPayload struct {
	WindowID windowmanager.WindowID `json:"window_id"`
	Index    int                    `json:"index"`
}

type WindowManagerReplaceLayoutPayload

type WindowManagerReplaceLayoutPayload struct {
	Document WindowManagerLayoutDocument `json:"document"`
}

type WindowManagerResizeLayoutPayload

type WindowManagerResizeLayoutPayload struct {
	SplitID       windowmanager.NodeID `json:"split_id"`
	BoundaryIndex int                  `json:"boundary_index"`
	Delta         float64              `json:"delta"`
}

type WindowManagerResizeWindowPayload

type WindowManagerResizeWindowPayload struct {
	WindowID windowmanager.WindowID       `json:"window_id"`
	Frame    windowmanager.NormalizedRect `json:"frame"`
}

type WindowManagerResult

type WindowManagerResult struct {
	Snapshot    WindowManagerSnapshot      `json:"snapshot"`
	Applied     bool                       `json:"applied"`
	Changes     windowmanager.ChangeSet    `json:"changes"`
	Diagnostics []windowmanager.Diagnostic `json:"diagnostics,omitempty"`
	Client      *WindowManagerClientView   `json:"client,omitzero"`
	RebasedFrom *WindowManagerRevision     `json:"rebased_from,omitzero"`
}

WindowManagerResult reports one applied or no-op command.

func WindowManagerResultFromDomain

func WindowManagerResultFromDomain(result *windowmanager.Result) (WindowManagerResult, error)

WindowManagerResultFromDomain converts a semantic command result.

type WindowManagerReturnAnchor

type WindowManagerReturnAnchor struct {
	DesktopID      windowmanager.DesktopID   `json:"desktop_id"`
	GroupID        *windowmanager.GroupID    `json:"group_id,omitzero"`
	ParentSplitID  *windowmanager.NodeID     `json:"parent_split_id,omitzero"`
	ChildIndex     *int                      `json:"child_index,omitzero"`
	Weight         *float64                  `json:"weight,omitzero"`
	NeighborIDs    []windowmanager.WindowID  `json:"neighbor_ids,omitempty"`
	SourceRevision WindowManagerRevision     `json:"source_revision"`
	SourceGroup    *WindowManagerLayoutGroup `json:"source_group,omitzero"`
	Zoomed         bool                      `json:"zoomed,omitzero"`
}

WindowManagerReturnAnchor is the stable wire form of a prior structural slot.

type WindowManagerRevision

type WindowManagerRevision uint64

WindowManagerRevision is an unsigned wire integer that remains exact in JavaScript.

WindowManagerMaxSafeRevision is the largest integer exactly representable by JavaScript numbers.

func (*WindowManagerRevision) UnmarshalJSON

func (revision *WindowManagerRevision) UnmarshalJSON(data []byte) error

UnmarshalJSON rejects revision values that JavaScript clients cannot represent exactly.

type WindowManagerSetStackActivePayload

type WindowManagerSetStackActivePayload struct {
	WindowID windowmanager.WindowID `json:"window_id"`
}

type WindowManagerSnapshot

type WindowManagerSnapshot struct {
	Version          uint32                         `json:"version"`
	WorkspaceID      windowmanager.WorkspaceID      `json:"workspace_id"`
	Revision         WindowManagerRevision          `json:"revision"`
	Desktops         []WindowManagerDesktop         `json:"desktops"`
	Windows          map[string]WindowManagerWindow `json:"windows"`
	ClosedEntryCount int                            `json:"closed_entry_count"`
	Overrides        windowmanager.WorkspaceConfig  `json:"overrides"`
	UpdatedAt        time.Time                      `json:"updated_at"`
}

WindowManagerSnapshot is the complete durable workspace aggregate.

func WindowManagerSnapshotFromDomain

func WindowManagerSnapshotFromDomain(snapshot windowmanager.Snapshot) (WindowManagerSnapshot, error)

WindowManagerSnapshotFromDomain converts the authoritative domain snapshot to its stable wire form.

type WindowManagerSnapshotFrame

type WindowManagerSnapshotFrame struct {
	Type        string                    `json:"type"`
	WorkspaceID windowmanager.WorkspaceID `json:"workspace_id"`
	Revision    WindowManagerRevision     `json:"revision"`
	Snapshot    WindowManagerSnapshot     `json:"snapshot"`
	Client      *WindowManagerClientView  `json:"client,omitzero"`
}

WindowManagerSnapshotFrame is the first frame of every stream subscription.

type WindowManagerSwapWindowsPayload

type WindowManagerSwapWindowsPayload struct {
	FirstWindowID  windowmanager.WindowID `json:"first_window_id"`
	SecondWindowID windowmanager.WindowID `json:"second_window_id"`
}

type WindowManagerSwitchDesktopPayload

type WindowManagerSwitchDesktopPayload struct {
	DesktopID windowmanager.DesktopID `json:"desktop_id"`
}

type WindowManagerToggleFloatingPayload

type WindowManagerToggleFloatingPayload struct {
	WindowID     windowmanager.WindowID        `json:"window_id"`
	FloatingRect *windowmanager.NormalizedRect `json:"floating_rect,omitzero"`
}

type WindowManagerUndoLayoutPayload

type WindowManagerUndoLayoutPayload struct{}

type WindowManagerUpdateDesktopPayload

type WindowManagerUpdateDesktopPayload struct {
	DesktopID windowmanager.DesktopID `json:"desktop_id"`
	Name      string                  `json:"name"`
}

type WindowManagerWindow

type WindowManagerWindow struct {
	ID           windowmanager.WindowID        `json:"id"`
	App          string                        `json:"app"`
	InstanceKey  *string                       `json:"instance_key,omitzero"`
	Route        windowmanager.RouteIntent     `json:"route"`
	NavStack     []windowmanager.RouteIntent   `json:"nav_stack"`
	Pinned       bool                          `json:"pinned"`
	Placement    windowmanager.WindowPlacement `json:"placement"`
	DesktopID    windowmanager.DesktopID       `json:"desktop_id"`
	FloatingRect windowmanager.NormalizedRect  `json:"floating_rect"`
	Minimized    bool                          `json:"minimized"`
	Zoomed       bool                          `json:"zoomed"`
	ReturnAnchor *WindowManagerReturnAnchor    `json:"return_anchor,omitzero"`
}

WindowManagerWindow is one durable application instance.

type WindowManagerWindowSpecPayload

type WindowManagerWindowSpecPayload struct {
	ID                  windowmanager.WindowID       `json:"id,omitempty"`
	App                 string                       `json:"app"`
	InstanceKey         *string                      `json:"instance_key,omitzero"`
	Route               windowmanager.RouteIntent    `json:"route"`
	DesktopID           windowmanager.DesktopID      `json:"desktop_id"`
	FloatingRect        windowmanager.NormalizedRect `json:"floating_rect"`
	InsertTiled         bool                         `json:"insert_tiled"`
	Floating            bool                         `json:"floating,omitzero"`
	StackTargetWindowID *windowmanager.WindowID      `json:"stack_target_window_id,omitzero"`
}

type WindowManagerZoomWindowPayload

type WindowManagerZoomWindowPayload struct {
	WindowID windowmanager.WindowID `json:"window_id"`
}

type WorkspaceArchiveBlocker

type WorkspaceArchiveBlocker struct {
	Kind string `json:"kind"`
	ID   string `json:"id"`
	Name string `json:"name"`
}

type WorkspaceAttentionSummaryPayload

type WorkspaceAttentionSummaryPayload struct {
	WorkspaceID string `json:"workspace_id"`
	NeedsYou    int    `json:"needs_you"`
	Finished    int    `json:"finished"`
}

WorkspaceAttentionSummaryPayload carries exact counts for one workspace.

type WorkspaceDetailPayload

type WorkspaceDetailPayload struct {
	Workspace    WorkspacePayload               `json:"workspace"`
	Sessions     []SessionPayload               `json:"sessions,omitempty"`
	Agents       []AgentPayload                 `json:"agents,omitempty"`
	Skills       []WorkspaceSkillPayload        `json:"skills,omitempty"`
	Providers    []SessionProviderOptionPayload `json:"providers,omitempty"`
	ProfileHints []WorkspaceProfileHintPayload  `json:"profile_hints,omitempty"`
}

WorkspaceDetailPayload is the shared resolved workspace detail response payload.

type WorkspaceFolderPayload

type WorkspaceFolderPayload struct {
	ID        string `json:"id"`
	ProfileID string `json:"profile_id"`
	Name      string `json:"name"`
	Position  int    `json:"position"`
	// WorkspaceCount counts the workspaces (and User scope) placed in the folder.
	WorkspaceCount int       `json:"workspace_count"`
	CreatedAt      time.Time `json:"created_at"`
	UpdatedAt      time.Time `json:"updated_at"`
}

WorkspaceFolderPayload is one named root folder that groups workspaces in one profile's All-projects sidebar.

type WorkspaceFolderResponse

type WorkspaceFolderResponse struct {
	Folder WorkspaceFolderPayload `json:"folder"`
}

WorkspaceFolderResponse returns one created or renamed workspace folder.

type WorkspaceLayoutResponse

type WorkspaceLayoutResponse struct {
	Folders    []WorkspaceFolderPayload    `json:"folders"`
	Placements []WorkspacePlacementPayload `json:"placements"`
}

WorkspaceLayoutResponse is one profile's complete workspace layout: folders in manual order, then placements ordered by container (folders, then root).

type WorkspacePayload

type WorkspacePayload struct {
	RootMissing  bool       `json:"root_missing,omitzero"`
	ArchivedAt   *time.Time `json:"archived_at,omitzero"`
	ID           string     `json:"id"`
	RootDir      string     `json:"root_dir"`
	AddDirs      []string   `json:"add_dirs"`
	Name         string     `json:"name"`
	DefaultAgent string     `json:"default_agent,omitempty"`
	CreatedAt    time.Time  `json:"created_at"`
	UpdatedAt    time.Time  `json:"updated_at"`
}

WorkspacePayload is the shared workspace response payload.

type WorkspacePlacementPayload

type WorkspacePlacementPayload struct {
	WorkspaceID string `json:"workspace_id"`
	FolderID    string `json:"folder_id,omitempty"`
	Position    int    `json:"position"`
}

WorkspacePlacementPayload pins one workspace into a folder or the root at a manual position. WorkspaceID is "@user" for the User scope; FolderID is omitted for the root. Workspaces without a placement follow the placed root workspaces in name order.

type WorkspaceProfileHintPayload

type WorkspaceProfileHintPayload struct {
	Name    string `json:"name"`
	Path    string `json:"path"`
	Message string `json:"message"`
	Action  string `json:"action"`
}

WorkspaceProfileHintPayload reports dormant repository content for an absent profile name.

type WorkspaceResponse

type WorkspaceResponse struct {
	Workspace WorkspacePayload `json:"workspace"`
}

WorkspaceResponse wraps one shared workspace payload.

type WorkspaceSkillPayload

type WorkspaceSkillPayload struct {
	Name   string `json:"name"`
	Dir    string `json:"dir"`
	Source string `json:"source"`
}

WorkspaceSkillPayload is the shared workspace skill response payload.

type WorkspacesResponse

type WorkspacesResponse struct {
	Workspaces []WorkspacePayload `json:"workspaces"`
}

WorkspacesResponse wraps the shared workspace list payload.

type WorktreeBindingsPayload

type WorktreeBindingsPayload struct {
	AgentActivity string `json:"agent_activity"`
}

type WorktreeBranchOutcomePayload

type WorktreeBranchOutcomePayload struct {
	Name    string `json:"name"`
	Deleted bool   `json:"deleted"`
	Reason  string `json:"reason,omitempty"`
	Detail  string `json:"detail,omitempty"`
}

WorktreeBranchOutcomePayload reports an opted-in local branch deletion. A kept branch names a stable reason: no_branch, branch_absent, checkout_present, root_checkout_branch, default_branch, registration_present, checked_out_elsewhere, not_fully_merged, or delete_failed.

type WorktreeCatalogEventPayload

type WorktreeCatalogEventPayload struct {
	Kind        string `json:"kind"`
	WorkspaceID string `json:"workspace_id"`
	WorktreeID  string `json:"worktree_id"`
	Error       string `json:"error,omitempty"`
}

type WorktreeCleanupResponse

type WorktreeCleanupResponse struct {
	Branch *WorktreeBranchOutcomePayload `json:"branch,omitempty"`
}

WorktreeCleanupResponse answers a removal or dismissal that requested delete_branch; requests without it keep their 204 response, which clients decode as an absent (nil) branch outcome.

type WorktreeExitAction

type WorktreeExitAction string

type WorktreeExitActionPlan

type WorktreeExitActionPlan struct {
	Action        WorktreeExitAction `json:"action"`
	Label         string             `json:"label"`
	Enabled       bool               `json:"enabled"`
	BlockedReason string             `json:"blocked_reason,omitempty"`
	Publish       bool               `json:"publish,omitzero"`
	URL           string             `json:"url,omitempty"`
	PRNumber      int                `json:"pr_number,omitzero"`
}

type WorktreeExitCleanupEvidence

type WorktreeExitCleanupEvidence struct {
	ForgeState string `json:"forge_state,omitempty"`
	Stale      bool   `json:"stale,omitzero"`
	Safe       bool   `json:"safe"`
	Source     string `json:"source,omitempty"`
	Summary    string `json:"summary,omitempty"`
	Blocker    string `json:"blocker,omitempty"`
	Downgraded bool   `json:"downgraded,omitzero"`
}

type WorktreeExitCommitScope

type WorktreeExitCommitScope struct {
	IncludePaths       []string `json:"include_paths,omitempty"`
	Fingerprint        string   `json:"fingerprint,omitempty"`
	Complete           bool     `json:"complete,omitzero"`
	ChangedFiles       int      `json:"changed_files"`
	Insertions         int      `json:"insertions"`
	Deletions          int      `json:"deletions"`
	UntrackedFiles     []string `json:"untracked_files"`
	UntrackedTotal     int      `json:"untracked_total"`
	UntrackedTruncated bool     `json:"untracked_truncated,omitzero"`
}

type WorktreeExitForgeCapabilities

type WorktreeExitForgeCapabilities struct {
	Provider           string   `json:"provider"`
	RequestNoun        string   `json:"request_noun"`
	OpenActionLabel    string   `json:"open_action_label"`
	ViewActionLabel    string   `json:"view_action_label"`
	SupportsDraft      bool     `json:"supports_draft"`
	CompareURLTemplate string   `json:"compare_url_template,omitempty"`
	CredentialSource   string   `json:"credential_source,omitempty"`
	DefaultBranch      string   `json:"default_branch,omitempty"`
	TemplatePaths      []string `json:"template_paths,omitempty"`
}

type WorktreeExitOperationResponse

type WorktreeExitOperationResponse struct {
	OperationID string `json:"op_id"`
}

type WorktreeExitPRPrefill

type WorktreeExitPRPrefill struct {
	Title string `json:"title,omitempty"`
	Body  string `json:"body,omitempty"`
}

type WorktreeExitPlanResponse

type WorktreeExitPlanResponse struct {
	WorktreeID       string                         `json:"worktree_id"`
	Primary          WorktreeExitAction             `json:"primary,omitempty"`
	Actions          []WorktreeExitActionPlan       `json:"actions"`
	GlobalPauseCause string                         `json:"global_pause_cause,omitempty"`
	CommitScope      WorktreeExitCommitScope        `json:"commit_scope"`
	BrowserURL       string                         `json:"browser_url,omitempty"`
	Forge            *WorktreeExitForgeCapabilities `json:"forge,omitzero"`
	ForgeStatus      *WorktreeForgeStatusPayload    `json:"forge_status,omitzero"`
	PRPrefill        *WorktreeExitPRPrefill         `json:"pr_prefill,omitzero"`
	Cleanup          WorktreeExitCleanupEvidence    `json:"cleanup"`
	Base             string                         `json:"base,omitempty"`
}

type WorktreeForgeStatusPayload

type WorktreeForgeStatusPayload struct {
	Provider  string     `json:"provider"`
	PRNumber  *int       `json:"pr_number"`
	PRState   *string    `json:"pr_state"`
	PRURL     string     `json:"pr_url,omitempty"`
	Merged    *bool      `json:"merged"`
	FetchedAt *time.Time `json:"fetched_at"`
}

type WorktreeInspectionResponse

type WorktreeInspectionResponse struct {
	Worktree WorktreePayload             `json:"worktree"`
	Status   *WorktreeStatusPayload      `json:"status"`
	Forge    *WorktreeForgeStatusPayload `json:"forge"`
	Repo     WorktreeRepoPayload         `json:"repo"`
	Bindings WorktreeBindingsPayload     `json:"bindings"`
}

type WorktreePayload

type WorktreePayload struct {
	ID              string    `json:"id"`
	ProfileID       string    `json:"profile_id"`
	ProfileName     string    `json:"profile_name"`
	ProfileColor    string    `json:"profile_color,omitempty"`
	ProfileIcon     string    `json:"profile_icon,omitempty"`
	ProfileEmoji    string    `json:"profile_emoji,omitempty"`
	ProfileArchived bool      `json:"profile_archived"`
	WorkspaceID     string    `json:"workspace_id"`
	Name            string    `json:"name"`
	Branch          string    `json:"branch"`
	Path            string    `json:"path"`
	State           string    `json:"state"`
	PendingPhase    string    `json:"pending_phase,omitempty"`
	Origin          string    `json:"origin"`
	SetupState      string    `json:"setup_state"`
	SetupError      string    `json:"setup_error,omitempty"`
	CreateError     string    `json:"create_error,omitempty"`
	BaseRef         string    `json:"base_ref,omitempty"`
	CreatedBranch   bool      `json:"created_branch"`
	RunNamespace    string    `json:"run_namespace,omitempty"`
	CreatedHead     string    `json:"created_head,omitempty"`
	RunID           string    `json:"run_id,omitempty"`
	Dirty           *bool     `json:"dirty"`
	Ahead           *int      `json:"ahead"`
	Behind          *int      `json:"behind"`
	AgentActivity   string    `json:"agent_activity"`
	CreatedAt       time.Time `json:"created_at"`
	UpdatedAt       time.Time `json:"updated_at"`
}

type WorktreeRemovalRefusalPayload

type WorktreeRemovalRefusalPayload struct {
	Code string `json:"code"`
	// Error explains the refusal and its force consequence in one sentence.
	Error     string                     `json:"error,omitempty"`
	Risk      WorktreeRemovalRiskPayload `json:"risk"`
	Downgrade bool                       `json:"downgrade"`
}

type WorktreeRemovalRiskPayload

type WorktreeRemovalRiskPayload struct {
	ChangedFiles    int  `json:"changed_files"`
	Insertions      int  `json:"insertions"`
	Deletions       int  `json:"deletions"`
	UnpushedCommits int  `json:"unpushed_commits"`
	ExistsOnRemote  bool `json:"exists_on_remote"`
	// LeftoverFiles counts the files left in a worktree_checkout_orphaned
	// checkout; Git cannot tell which of them hold changes.
	LeftoverFiles int `json:"leftover_files"`
}

type WorktreeRepoPayload

type WorktreeRepoPayload struct {
	GitBacked    bool   `json:"git_backed"`
	GitAvailable bool   `json:"git_available"`
	Diagnostic   string `json:"diagnostic,omitempty"`
}

type WorktreeResponse

type WorktreeResponse struct {
	Worktree WorktreePayload `json:"worktree"`
}

type WorktreeStatusPayload

type WorktreeStatusPayload struct {
	Branch      *string    `json:"branch"`
	Detached    *bool      `json:"detached"`
	HeadSHA     *string    `json:"head_sha"`
	DirtyFiles  *int       `json:"dirty_files"`
	Insertions  *int       `json:"insertions"`
	Deletions   *int       `json:"deletions"`
	HasUpstream *bool      `json:"has_upstream"`
	Ahead       *int       `json:"ahead"`
	AheadOfBase *int       `json:"ahead_of_base"`
	Behind      *int       `json:"behind"`
	ReadError   string     `json:"read_error,omitempty"`
	RefreshedAt *time.Time `json:"refreshed_at"`
}

type WorktreeStatusResponse

type WorktreeStatusResponse struct {
	WorktreeID string                      `json:"worktree_id"`
	Status     WorktreeStatusPayload       `json:"status"`
	Forge      *WorktreeForgeStatusPayload `json:"forge"`
}

type WorktreesResponse

type WorktreesResponse struct {
	Worktrees  []WorktreePayload           `json:"worktrees"`
	Discovered []DiscoveredWorktreePayload `json:"discovered"`
	Repo       WorktreeRepoPayload         `json:"repo"`
}

Source Files

Jump to

Keyboard shortcuts

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