Documentation
¶
Index ¶
- Constants
- Variables
- func ACPOptionSelectionsFromPayload(options []AgentACPOptionSelection) []acp.SessionConfigOptionSelection
- func ACPPromptStopReasonValues() []string
- func AgentSoulRevisionActionValues() []string
- func AttachmentMetaFromRefs(refs []PromptAttachmentRef) []session.AttachmentMeta
- func AuthoredDiagnosticSeverityValues() []string
- func AuthoredValidationStatusValues() []string
- func ContainsRawClaimTokenField(payload any) (bool, error)
- func ContainsUnsafeAuthoredContextPayload(payload any) (bool, error)
- func DiagnosticCodeCategory(code string) (string, bool)
- func DiagnosticCodes() []string
- func FilterToolOperatorFailureDetails(details map[string]json.RawMessage) map[string]json.RawMessage
- func GoalCommandOutcomeValues() []string
- func GoalContextStateValues() []string
- func GoalPromptKindValues() []string
- func GoalReasonCodeValues() []string
- func GoalSnapshotChangeCauseValues() []string
- func GoalStatusValues() []string
- func GoalTurnResultStatusValues() []string
- func GoalVerdictOutcomeValues() []string
- func HeartbeatActorKindValues() []string
- func HeartbeatRevisionOperationValues() []string
- func HeartbeatWakeReasonValues() []string
- func HeartbeatWakeResultValues() []string
- func HeartbeatWakeSourceValues() []string
- func IsDiagnosticCategory(category string) bool
- func IsDiagnosticCode(code string) bool
- func IsDiagnosticFreshness(freshness string) bool
- func IsDiagnosticSeverity(severity string) bool
- func IsTerminalErrorCode(code TerminalErrorCode) bool
- func IssueSeverityValues() []string
- func LoopCompletionStateValues() []string
- func LoopEntityKindValues() []string
- func LoopGateVerdictOutcomeValues() []string
- func LoopGenerationOriginValues() []string
- func LoopInputRefKindValues() []string
- func LoopInputTypeValues() []string
- func LoopMetricDirectionValues() []string
- func LoopNodeInventoryStateValues() []string
- func LoopParentClosePolicyValues() []string
- func LoopProvenanceRoleValues() []string
- func LoopRunEventKindValues() []string
- func LoopRunLifecycleEventKindValues() []string
- func LoopRunLiveStatusValues() []string
- func LoopRunStatusValues() []string
- func LoopRunTerminalStatusValues() []string
- func LoopRunTransitionCauseValues() []string
- func LoopWatchEventKindValues() []string
- func PromptRuntimeSelectionFromPayload(payload *PromptRuntimeSelectionPayload) *session.RuntimeSelection
- func ResolvedWorktreeModeValues() []string
- func SchedulerBacklogDomainQuery(query SchedulerBacklogQuery) taskpkg.SchedulerBacklogQuery
- func SessionFileKindValues() []string
- func SessionGoalOperationValues() []string
- func SessionHealthIneligibilityReasonValues() []string
- func SessionHealthStateValues() []string
- func SessionHealthStatusValues() []string
- func SessionInputStatusValues() []string
- func SessionMentionKindValues() []string
- func TerminalActorKindValues() []string
- func TerminalAttachModeValues() []string
- func TerminalCommandApprovalValues() []string
- func TerminalCommandDetectionValues() []string
- func TerminalCommandRowFromPayload(row TerminalCommandRowPayload) terminalpkg.CommandRow
- func TerminalErrorCodeValues() []string
- func TerminalErrorToolDetailsFromDomain(err *terminalpkg.Error) map[string]json.RawMessage
- func TerminalExitCauseValues() []string
- func TerminalInputRejectOutcomeValues() []string
- func TerminalInputResolutionOutcomeValues() []string
- func TerminalModeValues() []string
- func TerminalRecordingActionValues() []string
- func TerminalRecordingStateValues() []string
- func TerminalSignalValues() []string
- func TerminalStateValues() []string
- func ToolOperatorFailureDetails(failure *tools.OperatorFailure) map[string]json.RawMessage
- func ValidateAuthoredContextRedacted(payload any) error
- func ValidateDiagnosticItem(item DiagnosticItem) error
- func ValidateDiagnosticRegistry() error
- func ValidateNoRawClaimTokenField(payload any) error
- func ValidatePromptAttachments(refs []PromptAttachmentRef, maxCount int) error
- func ValidateTaskInboxQuery(query TaskInboxQuery, path string) error
- func ValidateTaskListQuery(query TaskListQuery, path string) error
- func WindowManagerCommandIDValues() []string
- func WindowManagerErrorCodeValues() []string
- type ACPAvailableCommandInputPayload
- type ACPAvailableCommandPayload
- type ACPCapsPayload
- type ACPPromptStopReason
- type AcknowledgeAttentionRequest
- type AddMarketplaceSourceRequest
- type AddTaskDependencyRequest
- type AdoptWorktreeRequest
- type AgentACPOptionSelection
- type AgentActivityBatchRequest
- type AgentActivityBatchResponse
- type AgentActivityResponse
- type AgentActivitySelection
- type AgentCapabilityPayload
- type AgentCapabilitySectionPayload
- type AgentCatalogFacetsPayload
- type AgentCatalogItemPayload
- type AgentCatalogResponse
- type AgentContextPayload
- type AgentContextProvenancePayload
- type AgentContextResponse
- type AgentContextSectionMetaPayload
- type AgentCoordinatorConfigResponse
- type AgentCreateScope
- type AgentDefinitionShadowPayload
- type AgentDiagnosticPayload
- type AgentDraftRuntime
- type AgentEffectiveRuntimePayload
- type AgentEffectiveRuntimeSources
- type AgentEventPayload
- type AgentFallbackRoutePayload
- type AgentIdentityPayload
- type AgentInstanceAdoptRequest
- type AgentInstanceAwayResponse
- type AgentInstanceCheckDigest
- type AgentInstanceCheckInPayload
- type AgentInstanceCheckInsResponse
- type AgentInstanceCheckRequest
- type AgentInstanceCheckResponse
- type AgentInstanceCreateRequest
- type AgentInstanceListResponse
- type AgentInstanceNextWake
- type AgentInstanceOccurrenceResponse
- type AgentInstancePayload
- type AgentInstancePeer
- type AgentInstancePickRequest
- type AgentInstancePickResponse
- type AgentInstanceProposal
- type AgentInstanceProposalAction
- type AgentInstanceProposalSource
- type AgentInstanceReportPayload
- type AgentInstanceReportSource
- type AgentInstanceReportsResponse
- type AgentInstanceResponse
- type AgentInstanceSeenResponse
- type AgentInstanceUpdateRequest
- type AgentLimitsPayload
- type AgentMCPServerInput
- type AgentMCPServerJSON
- type AgentMePayload
- type AgentMeResponse
- type AgentMemoryAddRequest
- type AgentMemoryBudget
- type AgentMemoryDocument
- type AgentMemoryHistoryResponse
- type AgentMemoryRemoveRequest
- type AgentMemoryRemoveResponse
- type AgentMemoryReplaceRequest
- type AgentMemoryRevision
- type AgentMemoryRollbackRequest
- type AgentMemorySearchRequest
- type AgentMemorySearchResponse
- type AgentMemorySearchResult
- type AgentMemoryValidateRequest
- type AgentMemoryValidateResponse
- type AgentMemoryWriteRequest
- type AgentNotifyRequest
- type AgentNotifyResponse
- type AgentOrigin
- type AgentPayload
- type AgentPermissionRulePayload
- type AgentProbeHealthPayload
- type AgentResponse
- type AgentRuntimeValueSource
- type AgentSessionMetricsPayload
- type AgentSessionPayload
- type AgentSkillAutomaticContents
- type AgentSkillDraftFile
- type AgentSkillProposeRequest
- type AgentSkillReviewDecisionRequest
- type AgentSkillReviewPayload
- type AgentSkillReviewResponse
- type AgentSkillReviewsResponse
- type AgentSoulConfigProvenancePayload
- type AgentSoulDeleteByPathRequest
- type AgentSoulDeleteRequest
- type AgentSoulFrontmatterPayload
- type AgentSoulHistoryRequest
- type AgentSoulHistoryResponse
- type AgentSoulMutationResponse
- type AgentSoulPayload
- type AgentSoulPutByPathRequest
- type AgentSoulPutRequest
- type AgentSoulRevisionAction
- type AgentSoulRevisionPayload
- type AgentSoulRollbackByPathRequest
- type AgentSoulRollbackRequest
- type AgentSoulSectionPayload
- type AgentSoulValidateByPathRequest
- type AgentSoulValidateRequest
- type AgentSpawnPayload
- type AgentSpawnRequest
- type AgentSpawnResponse
- type AgentTaskClaimNextRequest
- type AgentTaskClaimPayload
- type AgentTaskClaimResponse
- type AgentTaskCompleteRequest
- type AgentTaskContextPayload
- type AgentTaskFailRequest
- type AgentTaskHeartbeatRequest
- type AgentTaskLeaseResponse
- type AgentTaskReleaseRequest
- type AgentWorkspacePayload
- type AgentsResponse
- type AppTokenIssuedResponse
- type AppTokenPayload
- type AppTokenResponse
- type AppTokenRevokeResponse
- type AppTokensResponse
- type ApproveLoopRunRequest
- type ApproveSessionRequest
- type ArchiveProfilePlan
- type ArchiveProfileResponse
- type AttachSessionRequest
- type AttachTaskRunSessionRequest
- type AttentionNotificationPayload
- type AttentionNotificationsResponse
- type AuthoredContextActorPayload
- type AuthoredContextDiagnosticPayload
- type AuthoredContextLimitsPayload
- type AuthoredDiagnosticSeverity
- type AuthoredValidationStatus
- type AutoAcceptStatus
- type AutomationHealthPayload
- type AutomationLastRunPayload
- type AutomationResourceStatusPayload
- type AutomationSchedulerStatePayload
- type AutomationSuggestionAcceptanceResponse
- type AutomationSuggestionPayload
- type AutomationSuggestionResponse
- type AutomationSuggestionsResponse
- type BindSessionWorktreeRequest
- type BulkForceTaskRunItemPayload
- type BulkForceTaskRunRequest
- type BulkForceTaskRunResponse
- type CancelTaskRequest
- type CancelTaskRunRequest
- type CancelWorktreeExitActionRequest
- type ChangeBasePayload
- type ChangeBaseRefPayload
- type ChangeHeadPayload
- type ChangePatchPayload
- type ChangeSidePayload
- type ChangeTotalsPayload
- type ClarificationAnswerPayload
- type ClarificationAnswerRequest
- type ClarificationPendingPayload
- type ClarificationsResponse
- type ClearTaskBlockRequest
- type CmdPaletteCatalogChangedEvent
- type CmdPaletteClient
- type CmdPaletteCommand
- type CmdPaletteCommandsResponse
- type CmdPaletteError
- type CmdPaletteInvokeRequest
- type CmdPaletteInvokeResult
- type CmdPalettePersonalizationResetResponse
- type CmdPalettePersonalizationResponse
- type CmdPalettePinResponse
- type CmdPaletteRankSignalsResponse
- type CmdPaletteUsageRequest
- type CmdPaletteViewEnvelope
- type CmdPaletteViewPatch
- type CmdPaletteViewSessionAccepted
- type CmdPaletteViewSessionClosed
- type CmdPaletteViewSessionEventRequest
- type CmdPaletteViewSessionOpenRequest
- type CmdPaletteViewSessionOpenResponse
- type CompactionSnapshotPayload
- type CompleteTaskRunRequest
- type ConfigApplyRecordPayload
- type ConfigApplyRecordsResponse
- type ConfigApplyStatus
- type ConfigLayerDiagnosticPayload
- type ConfigRuntimeStatusPayload
- type ConsentArea
- type ContinueSessionRequest
- type CoordinatorConfigPayload
- type CoordinatorConfigSource
- type CostSource
- type CostStatus
- type CountedCursorPagePayload
- type CreateAgentPayload
- type CreateAgentRequest
- type CreateAgentSkillsConfig
- type CreateAppTokenRequest
- type CreateJobRequest
- type CreateLoopRequest
- type CreateProfileRequest
- type CreateSessionFolderRequest
- type CreateSessionRequest
- type CreateSupportBundleRequest
- type CreateTaskBlockRequest
- type CreateTaskChildRequest
- type CreateTaskRequest
- type CreateTaskRunReviewRequest
- type CreateTriggerRequest
- type CreateWorkspaceFolderRequest
- type CreateWorkspaceRequest
- type CreateWorktreeRequest
- type CursorPagePayload
- type DaemonIdentityPayload
- type DaemonStatusPayload
- type DeleteAgentResponse
- type DeleteLoopInputDefaultResponse
- type DeleteProfilePlan
- type DeleteProfileResponse
- type DeleteResourceRequest
- type DevLinkExtensionRequest
- type DiagnosticCodeSpec
- type DiagnosticItem
- type DiscoveredWorktreePayload
- type DoctorPayload
- type DoctorSummaryPayload
- type DraftAgentInstructionsRequest
- type DraftAgentInstructionsResponse
- type DrainState
- type DrainStatusResponse
- type DuplicateAgentOverrides
- type DuplicateAgentRequest
- type EnableExtensionRequest
- type EnqueueTaskRunRequest
- type ErrorPayload
- type ExtensionCommandGroupPayload
- type ExtensionCommandPayload
- type ExtensionCommandsResponse
- type ExtensionContentsPayload
- type ExtensionDeclaredProfilePayload
- type ExtensionEnableError
- type ExtensionEnablePreviewPayload
- type ExtensionEnableResult
- type ExtensionEnablementPayload
- type ExtensionInputStatePayload
- type ExtensionInstallDeclaredProfilePayload
- type ExtensionInstallPreviewPayload
- type ExtensionInventoryPayload
- type ExtensionKitChange
- type ExtensionKitChangePayload
- type ExtensionKitItemPayload
- type ExtensionLogPayload
- type ExtensionLogsResponse
- type ExtensionManifestSummary
- type ExtensionOperationErrorPayload
- type ExtensionPayload
- type ExtensionPlacementPayload
- type ExtensionProvenancePayload
- type ExtensionProvenanceResponse
- type ExtensionRemoveResponse
- type ExtensionResponse
- type ExtensionSearchItem
- type ExtensionSearchRequest
- type ExtensionSearchResponse
- type ExtensionSecretBindingInput
- type ExtensionSecretBindingPayload
- type ExtensionSecretsPayload
- type ExtensionTrustReportPayload
- type ExtensionUpdateBatchResponse
- type ExtensionUpdateResponse
- type ExtensionValidatePayload
- type ExtensionValidationComponent
- type ExtensionValidationErrorPayload
- type ExtensionsResponse
- type FSBrowseResponse
- type FSEntryPayload
- type FailTaskRunRequest
- type FanOutTaskRunsRequest
- type FanOutTaskRunsResponse
- type FileChangePayload
- type FileContentResponse
- type FileEntriesResponse
- type FileEntryPayload
- type FileFindMatch
- type FileFindResponse
- type FileRootPayload
- type FileSearchFile
- type FileSearchMatch
- type FileSearchQuery
- type FileSearchResponse
- type FileSearchTotals
- type ForceFailTaskRunRequest
- type ForceReleaseTaskRunRequest
- type ForkLoopRequest
- type ForkLoopResponse
- type ForkSessionRequest
- type ForkSessionWorktreeRequest
- type GatewayAddressPayload
- type GatewayAuditAuthPayload
- type GatewayAuditFindingPayload
- type GatewayAuditPayload
- type GatewayDeviceHighlights
- type GatewayDevicePayload
- type GatewayDeviceRenameRequest
- type GatewayDevicesResponse
- type GatewayIngressBindRequest
- type GatewayIngressBindingResponse
- type GatewayIngressPayload
- type GatewayIngressUnbindResponse
- type GatewayIssuedCredentialPayload
- type GatewayPairingArtifactPayload
- type GatewayPairingRedeemRequest
- type GatewayProviderEnableRequest
- type GatewayProviderPayload
- type GatewayRefusalPayload
- type GatewayRevokePayload
- type GatewayStatusPayload
- type GatewayStreamTicketPayload
- type GatewaySurfacePayload
- type GatewaySurfaceRequest
- type GatewayTierPayload
- type GoalBlockingIssue
- type GoalCommandOutcome
- type GoalCommandResult
- type GoalContextSnapshot
- type GoalContextState
- type GoalCriterionResult
- type GoalDiagnosticWarning
- type GoalPromptKind
- type GoalPromptMeta
- type GoalReasonCode
- type GoalSnapshot
- type GoalSnapshotChangeCause
- type GoalSnapshotChangedPayload
- type GoalStatus
- type GoalTurn
- type GoalTurnPage
- type GoalTurnResultStatus
- type GoalVerdictOutcome
- type GoalVerdictSummary
- type GroupedAgentCatalogItemPayload
- type HeartbeatActorKind
- type HeartbeatActorPayload
- type HeartbeatAuthorityPayload
- type HeartbeatConfigProvenancePayload
- type HeartbeatConfigSubsetPayload
- type HeartbeatContextProjectionPayload
- type HeartbeatDeleteByPathRequest
- type HeartbeatDeleteRequest
- type HeartbeatFrontmatterPayload
- type HeartbeatFrontmatterPreferencesPayload
- type HeartbeatHistoryRequest
- type HeartbeatHistoryResponse
- type HeartbeatMutationResponse
- type HeartbeatPolicyPayload
- type HeartbeatPreferencesPayload
- type HeartbeatPromptContributionPayload
- type HeartbeatPutByPathRequest
- type HeartbeatPutRequest
- type HeartbeatRevisionOperation
- type HeartbeatRevisionPayload
- type HeartbeatRollbackByPathRequest
- type HeartbeatRollbackRequest
- type HeartbeatScriptApprovalPayload
- type HeartbeatScriptApprovalRequest
- type HeartbeatSourceCatalogPayload
- type HeartbeatSourceDeclPayload
- type HeartbeatSourceLimitsPayload
- type HeartbeatSourceOutcomePayload
- type HeartbeatSourceScriptPayload
- type HeartbeatStatusRequest
- type HeartbeatStatusResponse
- type HeartbeatTimeWindowPayload
- type HeartbeatValidateByPathRequest
- type HeartbeatValidateRequest
- type HeartbeatWakeByPathRequest
- type HeartbeatWakeDecisionPayload
- type HeartbeatWakeEventPayload
- type HeartbeatWakeReason
- type HeartbeatWakeRequest
- type HeartbeatWakeResponse
- type HeartbeatWakeResult
- type HeartbeatWakeSource
- type HeartbeatWakeStatePayload
- type HookCatalogPayload
- type HookCatalogQuery
- type HookCatalogResponse
- type HookEventPayload
- type HookEventsQuery
- type HookEventsResponse
- type HookRunPayload
- type HookRunsQuery
- type HookRunsResponse
- type InstallExtensionRequest
- type InstallExtensionResponse
- type InstallExtensionSource
- type IssueSeverity
- type JobPayload
- type JobResponse
- type JobsResponse
- type LogEventPayload
- type LogTailStatusPayload
- type LogsListResponse
- type LoopAmendmentValueSummary
- type LoopAnnotationPayload
- type LoopAnnotationsResponse
- type LoopBackoffSpec
- type LoopBriefingResponse
- type LoopBudget
- type LoopBudgetExceeded
- type LoopCatalogAggregateEntryPayload
- type LoopCatalogAggregatePayload
- type LoopCatalogBatchResponse
- type LoopCatalogEntryPayload
- type LoopCatalogFacetsPayload
- type LoopCatalogLastRunPayload
- type LoopCatalogResourceSpec
- type LoopCatalogSourcePayload
- type LoopCatalogWorkspaceError
- type LoopCompletionState
- type LoopConfig
- type LoopConfigResponse
- type LoopContract
- type LoopContractLifecycleState
- type LoopControlProvenancePayload
- type LoopDefinitionDocument
- type LoopDefinitionPayload
- type LoopDiffEndpoint
- type LoopDiffInputRow
- type LoopDiffNodeRow
- type LoopDiffResponse
- type LoopDiffTerminalRow
- type LoopDiffValue
- type LoopEffectSpec
- type LoopEffectiveConfig
- type LoopEmitSpec
- type LoopEnvironment
- type LoopEnvironmentMode
- type LoopErrorPolicy
- type LoopForkRef
- type LoopGateBlockingIssuePayload
- type LoopGateCriterion
- type LoopGateCriterionDetailPayload
- type LoopGateCriterionEventPayload
- type LoopGateDecision
- type LoopGateDiagnosticWarning
- type LoopGateVerdictEventPayload
- type LoopGateVerdictOutcome
- type LoopGateVerdictPayload
- type LoopGateVerdictRunEventPayload
- type LoopGenerationOrigin
- type LoopGenerationOutput
- type LoopGenerationPayload
- type LoopGenerationStartedEventPayload
- type LoopGenerationStartedRunEventPayload
- type LoopInput
- type LoopInputDefaultResponse
- type LoopInputDefaultsResponse
- type LoopInputDefaultsScope
- type LoopInputOrigin
- type LoopInputRef
- type LoopInputValidationErrorPayload
- type LoopLintErrorPayload
- type LoopLintSeverity
- type LoopMetricDirection
- type LoopMetricSpec
- type LoopMutationResponse
- type LoopNoProgress
- type LoopNodeAmendRequest
- type LoopNodeAmendResponse
- type LoopNodeAmendmentPayload
- type LoopNodeClass
- type LoopNodeControlPayload
- type LoopNodeInventoryItem
- type LoopNodeInventoryResponse
- type LoopNodeInventoryState
- type LoopNodeLifecycleState
- type LoopNodeMutationRequest
- type LoopNodePauseRequest
- type LoopNodeResumeRequest
- type LoopNodeWaitPayload
- type LoopParentClosePolicy
- type LoopPlanNodePreview
- type LoopPlanPayload
- type LoopProvenance
- type LoopProvenanceRole
- type LoopReattemptStrategy
- type LoopRequestAggregates
- type LoopRequestPayload
- type LoopRequestProvenance
- type LoopRequestsResponse
- type LoopResolvedLifecycleConfig
- type LoopResolvedRuntime
- type LoopResponse
- type LoopResultContract
- type LoopRetrySpec
- type LoopRouteCausePayload
- type LoopRouteTakenEventPayload
- type LoopRouteTakenRunEventPayload
- type LoopRunAttention
- type LoopRunEventKind
- type LoopRunEventPayload
- type LoopRunNodesResponse
- type LoopRunPayload
- type LoopRunProgress
- type LoopRunResponse
- type LoopRunStatus
- type LoopRunTransitionCause
- type LoopRunsAggregatePayload
- type LoopRunsResponse
- type LoopRuntimeDefaults
- type LoopRuntimeMatch
- type LoopRuntimeProvenance
- type LoopRuntimeRule
- type LoopRuntimeSpec
- type LoopRuntimeValidationItemPayload
- type LoopSource
- type LoopStartBinding
- type LoopTimelineResponse
- type LoopUnprocessableResponse
- type LoopValidationResponse
- type LoopVersionConflictResponse
- type LoopWaitExpiry
- type LoopWatchEventKind
- type LoopWatchEventSubscription
- type LoopWatchEventsState
- type LoopsResponse
- type MCPAuthSummary
- type MCPServerStatusPayload
- type ManagedExtensionRemovePayload
- type ManagedExtensionUpdatePayload
- type MarketplaceCategoriesResponse
- type MarketplaceCategoryCount
- type MarketplaceCursorStalePayload
- type MarketplaceEntryResponse
- type MarketplaceExtensionDetailPayload
- type MarketplaceInputBindingPayload
- type MarketplaceInputPayload
- type MarketplaceListResponse
- type MarketplaceListingPayload
- type MarketplaceOriginPayload
- type MarketplaceRefreshResponse
- type MarketplaceRefreshSourcePayload
- type MarketplaceSection
- type MarketplaceSectionsResponse
- type MarketplaceServerPayload
- type MarketplaceSourceErrorPayload
- type MarketplaceSourcePayload
- type MarketplaceSourcePreviewPayload
- type MarketplaceSourceResponse
- type MarketplaceSourceSummary
- type MarketplaceSourcesResponse
- type ModelCatalogCostPayload
- type ModelCatalogSourceRefPayload
- type ModelCatalogSourceStatusPayload
- type MoveSessionRequest
- type MoveSessionToLaterRequest
- type MoveSessionToProfileRequest
- type MoveSessionToProfileResponse
- type MoveWorkspaceRequest
- type NewSessionWorktreeRequest
- type ObserveFailureHealthPayload
- type ObserveHealthPayload
- type ObserveOverviewPayload
- type ObserveOverviewResponse
- type ObservePersistenceHealthPayload
- type ObserveRetentionHealthPayload
- type OnboardingStatusPayload
- type OnboardingStatusResponse
- type OpenAIErrorPayload
- type OpenAIErrorResponse
- type OpenAIModelCompozyPayload
- type OpenAIModelListResponse
- type OpenAIModelPayload
- type OperatorNotificationEventPayload
- type OptionalStringList
- type OverviewAgentSharePayload
- type OverviewAttentionItemPayload
- type OverviewAttentionPayload
- type OverviewLongestSessionPayload
- type OverviewOutcomeDayPayload
- type OverviewOutcomesPayload
- type OverviewProfileUsagePayload
- type OverviewPulseBucketPayload
- type OverviewPulsePayload
- type OverviewSystemPayload
- type OverviewTodayPayload
- type OverviewUsageDayPayload
- type OverviewUsagePayload
- type PatchLoopRequest
- type PauseTaskRequest
- type PendingInteractionPayload
- type PermissionDailyRollupPayload
- type PermissionEntriesResponse
- type PermissionEntryPayload
- type PermissionRollupResponse
- type ProcessesResponse
- type Profile
- type ProfileCredentialRequirement
- type ProfileError
- type ProfileErrorPayload
- type ProfileFolderRef
- type ProfileOperation
- type ProfilePlacement
- type ProfilePlanRequest
- type ProfileRemovalSummary
- type ProfileRepoRenameOutcome
- type ProfileSelection
- type ProfileSelectionScope
- type PromoteSessionInputRequest
- type PromptAttachmentRef
- type PromptDelivery
- type PromptInput
- type PromptMode
- type PromptOriginMeta
- type PromptRuntimeSelectionPayload
- type PromptStreamChunk
- type PromptUIMessage
- type PromptUITextPart
- type ProvenancePayload
- type ProviderAuthProbeResponse
- type ProviderAuthProbeResult
- type ProviderAuthStatusPayload
- type ProviderListResponse
- type ProviderLoginDescriptorPayload
- type ProviderLoginPresence
- type ProviderLoginSource
- type ProviderModelConfigurationPayload
- type ProviderModelCurationRequest
- type ProviderModelCurationResponse
- type ProviderModelListResponse
- type ProviderModelPayload
- type ProviderModelRefreshRequest
- type ProviderModelRefreshResponse
- type ProviderModelStatusResponse
- type ProviderRecommendedAction
- type ProviderRuntimeLiveApply
- type ProviderRuntimeStrategy
- type ProviderStatusPayload
- type ProviderSummaryPayload
- type ProviderUsageAccount
- type ProviderUsageAmount
- type ProviderUsageBalance
- type ProviderUsageEnvelope
- type ProviderUsageError
- type ProviderUsageRefreshRequest
- type ProviderUsageSource
- type ProviderUsageSpendCap
- type ProviderUsageStreamEvent
- type ProviderUsageTarget
- type ProviderUsageTraySignal
- type ProviderUsageWindow
- type PutLoopAnnotationsRequest
- type PutLoopConfigRequest
- type PutLoopInputDefaultRequest
- type PutLoopInputDefaultsRequest
- type PutResourceRequest
- type PutSettingsHookRequest
- type PutSettingsMCPServerRequest
- type PutSettingsProviderRequest
- type PutVaultSecretRequest
- type ReasoningEffort
- type ReasoningSource
- type RecapPayload
- type RecapSnapshotPayload
- type RecoverTaskRequest
- type RecoverTaskRunRequest
- type ReloadExtensionRequest
- type RemoveDiscoveredWorktreeRequest
- type RenameProfilePlan
- type RenameProfileRequest
- type RenameProfileResponse
- type RenameSessionFolderRequest
- type RenameSessionRequest
- type RenameWorkspaceFolderRequest
- type ReorderSessionFoldersRequest
- type ReorderSessionsRequest
- type ReorderWorkspaceFoldersRequest
- type ReorderWorkspacesRequest
- type ReplaceSessionInputRequest
- type ReplyWatchPayload
- type ReplyWatchRefPayload
- type RerunLoopRequest
- type RerunLoopResponse
- type ResolveToolApprovalRequest
- type ResolveWorkspaceRequest
- type ResolvedWorktreeMode
- type ResourceRecordPayload
- type ResourceResponse
- type ResourcesResponse
- type RespondLoopRequest
- type RespondLoopRequestResponse
- type RestartActionResponse
- type RestartActionStatus
- type RestartOperationStatus
- type RestartProgress
- type RestartProgressPhase
- type ResumeSessionFromLaterRequest
- type ResumeTaskRequest
- type RetryTaskRunRequest
- type RetryTaskRunResponse
- type RoleDiagnostic
- type RoleFallbackStatus
- type RoleResolutionMode
- type RoleStatus
- type RoleStatusResponse
- type RolesResponse
- type RunLoopRequest
- type RunLoopResponse
- type RunPayload
- type RunResponse
- type RunWorktreeExitActionRequest
- type RunsResponse
- type RuntimeActivityPayload
- type RuntimeIdentityPayload
- type RuntimeSelectionPayload
- type SchedulerBacklogPayload
- type SchedulerBacklogQuery
- type SchedulerBacklogResponse
- type SchedulerBacklogRunPayload
- type SchedulerCountersPayload
- type SchedulerDrainRequest
- type SchedulerDrainResponse
- type SchedulerPauseRequest
- type SchedulerResumeRequest
- type SchedulerStatusPayload
- type SchedulerStatusResponse
- type SchemaStreamStatus
- type SendPromptRequest
- type SendPromptResultPayload
- type SendPromptResultResponse
- type SessionActivityHealthPayload
- type SessionAggregatePayload
- type SessionApprovalResponse
- type SessionAttachPayload
- type SessionAttachResponse
- type SessionAttachmentPayload
- type SessionAttachmentUploadResponse
- type SessionAttentionEventPayload
- type SessionAttentionSummaryPayload
- type SessionBoardCountsPayload
- type SessionCatalogEventPayload
- type SessionCatalogFacetsPayload
- type SessionCatalogFacetsResponse
- type SessionCatalogPagePayload
- type SessionCatalogResponse
- type SessionChangeBasesResponse
- type SessionChangeContentsResponse
- type SessionChangePatchesResponse
- type SessionChangesResponse
- type SessionChildrenPayload
- type SessionCommandPayload
- type SessionCommandSource
- type SessionCommandsChangedPayload
- type SessionCommandsResponse
- type SessionCompactRequest
- type SessionCompactResponse
- type SessionCompactionContextAfterPayload
- type SessionCompactionPayload
- type SessionConfigOptionPayload
- type SessionConfigOptionValuePayload
- type SessionConsumerDegradedPayload
- type SessionContextClearedByPayload
- type SessionContextInjectedPayload
- type SessionContextPayload
- type SessionContextRowPayload
- type SessionContextSpanPayload
- type SessionContextState
- type SessionConversationRewindPayload
- type SessionConversationRewindRequest
- type SessionConversationRewindResponse
- type SessionDerivationPayload
- type SessionDeriveCutPayload
- type SessionDeriveErrorPayload
- type SessionDerivePreviewResponse
- type SessionDeriveResponse
- type SessionDerivedPayload
- type SessionEnvBindingPayload
- type SessionEventPayload
- type SessionEventsResponse
- type SessionFailureHealthPayload
- type SessionFailurePayload
- type SessionFileEntryPayload
- type SessionFileKind
- type SessionFilesResponse
- type SessionFolderPayload
- type SessionFolderResponse
- type SessionFoldersResponse
- type SessionGoalCommandRequest
- type SessionGoalOperation
- type SessionGoalResponse
- type SessionHealthIneligibilityReason
- type SessionHealthPayload
- type SessionHealthResponse
- type SessionHealthState
- type SessionHealthStatus
- type SessionHistoryResponse
- type SessionInputClearResponse
- type SessionInputListResponse
- type SessionInputMentionPayload
- type SessionInputPayload
- type SessionInputResponse
- type SessionInputStatus
- type SessionInspectResponse
- type SessionInteractionsResponse
- type SessionLaterPayload
- type SessionLineagePayload
- type SessionLinkedWorkItem
- type SessionLinkedWorkResponse
- type SessionLinkedWorkSummary
- type SessionMentionKind
- type SessionMonitorPayload
- type SessionMonitorResponse
- type SessionMonitorSummaryPayload
- type SessionMonitorTargetPayload
- type SessionMonitorsResponse
- type SessionOwner
- type SessionPayload
- type SessionPayloadHealth
- type SessionPresenceRequest
- type SessionPresenceResponse
- type SessionProcessAttribution
- type SessionProcessGroupPayload
- type SessionProcessKind
- type SessionProcessOutcome
- type SessionProcessPayload
- type SessionProcessPolicy
- type SessionProcessResult
- type SessionProcessSummaryPayload
- type SessionProcessTarget
- type SessionProcessTreePayload
- type SessionProcessesResponse
- type SessionProfileFacetsPayload
- type SessionPromptCancelResponse
- type SessionProviderOptionPayload
- type SessionPullRequestChecksPayload
- type SessionPullRequestErrorPayload
- type SessionPullRequestLookupPayload
- type SessionPullRequestPayload
- type SessionPullRequestResponse
- type SessionQueueSummaryPayload
- type SessionRecapResponse
- type SessionRepairActionPayload
- type SessionRepairIssuePayload
- type SessionRepairPayload
- type SessionRepairResponse
- type SessionResponse
- type SessionRuntimePayload
- type SessionRuntimeRecoveryPayload
- type SessionSkillInvocationPayload
- type SessionSoulRefreshRequest
- type SessionStatusResponse
- type SessionStopPayload
- type SessionTranscriptFences
- type SessionTranscriptOutlineResponse
- type SessionTranscriptResponse
- type SessionTranscriptSearchResponse
- type SessionTurnInjectedPayload
- type SessionUsageChangedPayload
- type SessionUsagePayload
- type SessionUsageResponse
- type SessionUsageTurnPayload
- type SessionUsageTurnsResponse
- type SessionWaitRequest
- type SessionWaitResponse
- type SessionWorkLinkRequest
- type SessionWorkTimePayload
- type SessionWorkspaceFacetsPayload
- type SessionsResponse
- type SetExtensionEnablementRequest
- type SetExtensionSecretsRequest
- type SetSessionParentRequest
- type SetSessionRuntimeRequest
- type SetSettingsProviderEnabledRequest
- type SetTaskExecutionProfileRequest
- type SetTaskWorktreePolicyRequest
- type SettingsActionMetadataPayload
- type SettingsAgentScopeKind
- type SettingsApplyFailurePayload
- type SettingsApplyLifecycle
- type SettingsApplyNextAction
- type SettingsApplyResponse
- type SettingsApplyTargetName
- type SettingsAttentionPayload
- type SettingsAttentionResponse
- type SettingsAutomationConfigPayload
- type SettingsAutomationResponse
- type SettingsAutomationRuntimePayload
- type SettingsBusyInputPayload
- type SettingsCmdPaletteResponse
- type SettingsCollectionName
- type SettingsConfigPathsPayload
- type SettingsCoordinatorRoleConfigPayload
- type SettingsDaemonPayload
- type SettingsDaemonReloadTimeoutsPayload
- type SettingsDaemonRuntimePayload
- type SettingsDefaultsPayload
- type SettingsDesktopPayload
- type SettingsExtensionDevPayload
- type SettingsExtensionGitHubSourcePayload
- type SettingsExtensionGitSourcePayload
- type SettingsExtensionRateLimitPayload
- type SettingsExtensionResourcesPayload
- type SettingsExtensionSourcesPayload
- type SettingsExtensionTrustPayload
- type SettingsExtensionsConfigPayload
- type SettingsGeneralActionsPayload
- type SettingsGeneralConfigPayload
- type SettingsGeneralResponse
- type SettingsGlobalShortcutPayload
- type SettingsGlobalShortcutStatus
- type SettingsHTTPPayload
- type SettingsHookDeclarationPayload
- type SettingsHookItemPayload
- type SettingsHookResponse
- type SettingsHooksExtensionsResponse
- type SettingsHooksResponse
- type SettingsInstalledExtensionPaletteCommandPayload
- type SettingsInstalledExtensionPalettePayload
- type SettingsInstalledExtensionPaletteViewPayload
- type SettingsInstalledExtensionPayload
- type SettingsLayeredCollectionMutationResult
- type SettingsLayeredCollectionResponseMetaPayload
- type SettingsLayeredScopeKind
- type SettingsLayeredSectionMutationResult
- type SettingsLayeredSectionResponseMetaPayload
- type SettingsLimitsPayload
- type SettingsLogTailCapabilityPayload
- type SettingsLogTailEventPayload
- type SettingsMCPAuthBeginMode
- type SettingsMCPAuthBeginRequest
- type SettingsMCPAuthBeginResponse
- type SettingsMCPAuthConfigPayload
- type SettingsMCPAuthConfigViewPayload
- type SettingsMCPAuthExchangeRequest
- type SettingsMCPAuthStatusPayload
- type SettingsMCPExtensionOverridePayload
- type SettingsMCPSecretPreservationPayload
- type SettingsMCPSecretValuesPayload
- type SettingsMCPServerItemPayload
- type SettingsMCPServerPayload
- type SettingsMCPServerResponse
- type SettingsMCPServerRuntimeStatusPayload
- type SettingsMCPServersResponse
- type SettingsMarketplaceCatalogPayload
- type SettingsMarketplaceResponse
- type SettingsMutationBehavior
- type SettingsObservabilityConfigPayload
- type SettingsObservabilityResponse
- type SettingsObservabilityRuntimePayload
- type SettingsObservabilityTranscriptPayload
- type SettingsOperationalLinkPayload
- type SettingsPermissionMode
- type SettingsPermissionsPayload
- type SettingsPersonaResponse
- type SettingsProviderAuthStatusPayload
- type SettingsProviderCredentialSlotPayload
- type SettingsProviderCredentialStatusPayload
- type SettingsProviderEnabledResponse
- type SettingsProviderFallbackPayload
- type SettingsProviderItemPayload
- type SettingsProviderModelPayload
- type SettingsProviderModelsDiscoveryPayload
- type SettingsProviderModelsPayload
- type SettingsProviderReasoningPayload
- type SettingsProviderResponse
- type SettingsProviderSecretWritePayload
- type SettingsProviderSettingsPayload
- type SettingsProviderUsagePayload
- type SettingsProviderUsageProviderPayload
- type SettingsProviderUsageResponse
- type SettingsProviderUsageUpdateRequest
- type SettingsProviderWritePayload
- type SettingsProvidersResponse
- type SettingsRedactPayload
- type SettingsRoleConfigPayload
- type SettingsRoleFallbackPayload
- type SettingsRolesConfigPayload
- type SettingsRolesResponse
- type SettingsScopeKind
- type SettingsSectionName
- type SettingsShellAppearancePayload
- type SettingsShellLegacyScopePayload
- type SettingsShellMutationResponse
- type SettingsShellPayload
- type SettingsShellResponse
- type SettingsShellSessionGroupBy
- type SettingsShellSessionScope
- type SettingsShellSessionSort
- type SettingsShellSessionsPayload
- type SettingsSkillSourceCollisionPayload
- type SettingsSkillSourceInheritancePayload
- type SettingsSkillSourcePayload
- type SettingsSkillSourceRootPayload
- type SettingsSkillSourceSkippedLinkPayload
- type SettingsSkillSourceVerificationPayload
- type SettingsSkillsConfigPayload
- type SettingsSkillsMutationResponse
- type SettingsSkillsMutationResult
- type SettingsSkillsOverridePayload
- type SettingsSkillsResponse
- type SettingsSkillsSectionResponseMetaPayload
- type SettingsSourceKind
- type SettingsSourceMetadataPayload
- type SettingsSourceRefPayload
- type SettingsStreamTransport
- type SettingsTargetSelector
- type SettingsTerminalPayload
- type SettingsTransportParityPayload
- type SettingsUpdateActor
- type SettingsUpdateAppPayload
- type SettingsUpdateApplyRequest
- type SettingsUpdateApplyResponse
- type SettingsUpdateApplyStatus
- type SettingsUpdateCancelResponse
- type SettingsUpdateHolderPayload
- type SettingsUpdateInstallMethod
- type SettingsUpdateOperationPayload
- type SettingsUpdatePhase
- type SettingsUpdateResponse
- type SettingsUpdateRuntimePayload
- type SettingsUpdateStatusKind
- type SettingsUpdateTarget
- type SettingsUpdateWaitingState
- type SettingsUserCollectionMutationResult
- type SettingsUserCollectionResponseMetaPayload
- type SettingsUserScopeKind
- type SettingsUserSectionMutationResult
- type SettingsUserSectionResponseMetaPayload
- type SettingsWindowBindingAction
- type SettingsWindowDesktopTransition
- type SettingsWindowDragAwayPolicy
- type SettingsWindowDragModifier
- type SettingsWindowFocusPolicy
- type SettingsWindowManagerBindingPayload
- type SettingsWindowManagerCommandPayload
- type SettingsWindowManagerConfigPayload
- type SettingsWindowManagerDefaultPayload
- type SettingsWindowManagerDiagnosticPayload
- type SettingsWindowManagerGapsPayload
- type SettingsWindowManagerMutationError
- type SettingsWindowManagerMutationResponse
- type SettingsWindowManagerResponse
- type SettingsWindowManagerSnapPayload
- type SettingsWindowNewPolicy
- type SettingsWindowSmallViewportPolicy
- type SettingsWorkspaceScopeKind
- type SettingsWorkspaceSectionMutationResult
- type SettingsWorkspaceSectionResponseMetaPayload
- type SettingsWriteTargetKind
- type SkillActionResponse
- type SkillActivationPayload
- type SkillActivationReasonCode
- type SkillActivationReasonPayload
- type SkillContentResponse
- type SkillDiagnosticPayload
- type SkillDiagnosticState
- type SkillExposeResponse
- type SkillExposureErrorPayload
- type SkillExposureFailureErrorPayload
- type SkillExposureFailureResponse
- type SkillExposurePayload
- type SkillExposureRequest
- type SkillExposureStatus
- type SkillExposureTargetResultPayload
- type SkillPayload
- type SkillResponse
- type SkillRuntimeStatusPayload
- type SkillShadowEntryPayload
- type SkillShadowsResponse
- type SkillSourceValidationErrorPayload
- type SkillSourceValidationErrorResponse
- type SkillUnexposeResponse
- type SkillVerificationFailurePayload
- type SkillVerificationStatus
- type SkillVerificationWarningPayload
- type SkillsResponse
- type SpawnBudgetPayload
- type SpawnNewWorktreeRequest
- type SpawnPermissionPolicyPayload
- type SpawnPermissionRequestPayload
- type SpawnPromptPayload
- type SpawnWorktreePayload
- type Speed
- type SpeedResolution
- type SpeedResolutionReason
- type SpeedResolutionStatus
- type StartTaskRunRequest
- type StatusPayload
- type SteerPromptRequest
- type StopSessionRequest
- type StuckTaskRunPayload
- type SubagentCancelPayload
- type SubagentCancelRequest
- type SubagentChildActivity
- type SubagentListPayload
- type SubagentPayload
- type SubagentPullRequestPayload
- type SubagentRuntimePayload
- type SubagentSummaryPayload
- type SubagentUpdatedEvent
- type SubagentUsagePayload
- type SubagentWorktreePayload
- type SubagentsSnapshotEvent
- type SubmitTaskRunReviewVerdictRequest
- type SubprocessHealthAggregatePayload
- type SubprocessHealthSessionPayload
- type SupportBundleManifestArtifactPayload
- type SupportBundleManifestPayload
- type SupportBundleOperationPayload
- type SupportBundleOperationResponse
- type TaskBlockPayload
- type TaskBlockResponse
- type TaskBlocksResponse
- type TaskCatalogFacetsPayload
- type TaskCatalogItemPayload
- type TaskCatalogOwnerFacetPayload
- type TaskCatalogRunPayload
- type TaskCatalogStatusFacetPayload
- type TaskDashboardActiveRunPayload
- type TaskDashboardActiveRunsPayload
- type TaskDashboardBlockedCardPayload
- type TaskDashboardCardsPayload
- type TaskDashboardFailedCardPayload
- type TaskDashboardFreshnessPayload
- type TaskDashboardHealthPayload
- type TaskDashboardInProgressCardPayload
- type TaskDashboardLatencyCardPayload
- type TaskDashboardPayload
- type TaskDashboardQuery
- type TaskDashboardQueueDepthPayload
- type TaskDashboardQueuePayload
- type TaskDashboardResponse
- type TaskDashboardStatusBreakdownPayload
- type TaskDashboardTotalsPayload
- type TaskDependencyPayload
- type TaskDependencyReferencePayload
- type TaskDesignationRollupPayload
- type TaskDetailPayload
- type TaskDetailResponse
- type TaskEventPayload
- type TaskExecutionProfilePayload
- type TaskExecutionProfileResponse
- type TaskExecutionRequest
- type TaskExecutionResponse
- type TaskFanOutRunDesignationRequest
- type TaskHealthPayload
- type TaskInboxFacetsPayload
- type TaskInboxItemPayload
- type TaskInboxLane
- type TaskInboxLaneGroupPayload
- type TaskInboxPayload
- type TaskInboxPriorityFacetPayload
- type TaskInboxQuery
- type TaskInboxResponse
- type TaskInboxStatusFacetPayload
- type TaskInboxTaskPayload
- type TaskInspectEventPayload
- type TaskInspectPayload
- type TaskInspectResponse
- type TaskInspectRunPayload
- type TaskInspectSchedulerPayload
- type TaskInspectSessionPayload
- type TaskLatencyMetricPayload
- type TaskListQuery
- type TaskOwnerTotalPayload
- type TaskPayload
- type TaskQueryErrorPayload
- type TaskQueueDepthPayload
- type TaskRecoveryTotalsPayload
- type TaskReferencePayload
- type TaskResponse
- type TaskRunDetailPayload
- type TaskRunDetailResponse
- type TaskRunLeaseSummaryPayload
- type TaskRunListQuery
- type TaskRunOperationalSummaryPayload
- type TaskRunPayload
- type TaskRunResponse
- type TaskRunResultPageResponse
- type TaskRunReviewListQuery
- type TaskRunReviewPayload
- type TaskRunReviewRequestResponse
- type TaskRunReviewResponse
- type TaskRunReviewVerdictResponse
- type TaskRunReviewsResponse
- type TaskRunSessionPayload
- type TaskRunSummaryPayload
- type TaskRunTotalPayload
- type TaskRunsResponse
- type TaskStatusTotalPayload
- type TaskStreamEventPayload
- type TaskStreamQuery
- type TaskSummaryPayload
- type TaskTimelineItemPayload
- type TaskTimelineQuery
- type TaskTimelineResponse
- type TaskTreeNodePayload
- type TaskTreePayload
- type TaskTreeResponse
- type TaskTriageStatePayload
- type TaskTriageStateResponse
- type TasksResponse
- type TerminalActorKind
- type TerminalAnswerInputRequest
- type TerminalApprovalCountPayload
- type TerminalAttachMode
- type TerminalAttachTicketRequest
- type TerminalAttachTicketResponse
- type TerminalCapabilitiesPayload
- type TerminalCatalogSnapshot
- type TerminalCloseRequest
- type TerminalCommandActorPayload
- type TerminalCommandApproval
- type TerminalCommandDetection
- type TerminalCommandRowPayload
- type TerminalCreateRequest
- type TerminalDeliveredResponse
- type TerminalErrorCode
- type TerminalErrorDetail
- type TerminalErrorDetails
- type TerminalErrorResponse
- type TerminalExecRequest
- type TerminalExecResponse
- type TerminalExitCause
- type TerminalExitPayload
- type TerminalExitResponse
- type TerminalID
- type TerminalInfoPayload
- type TerminalInputActorPayload
- type TerminalInputAnswerResponse
- type TerminalInputRejectOutcome
- type TerminalInputRejectResponse
- type TerminalInputRequestsResponse
- type TerminalInputResolutionOutcome
- type TerminalJournalResponse
- type TerminalListResponse
- type TerminalMode
- type TerminalOutputShape
- type TerminalPendingInputRequest
- type TerminalReadResponse
- type TerminalRecordingAction
- type TerminalRecordingPayload
- type TerminalRecordingRequest
- type TerminalRecordingResponse
- type TerminalRecordingState
- type TerminalRejectInputRequest
- type TerminalResolvedInputRequest
- type TerminalResponse
- type TerminalRunPayload
- type TerminalSequence
- type TerminalSignal
- type TerminalSignalRequest
- type TerminalSpillPayload
- type TerminalState
- type TerminalWaitRequest
- type TerminalWaitResponse
- type TerminateProcessesRequest
- type TerminateSessionProcessesRequest
- type TerminateSessionProcessesResponse
- type TokenUsagePayload
- type ToolApprovalGrantListResponse
- type ToolApprovalGrantPayload
- type ToolApprovalGrantResponse
- type ToolApprovalGrantSetRequest
- type ToolApprovalPayload
- type ToolApprovalRequest
- type ToolApprovalResponse
- type ToolApprovalStatusResponse
- type ToolArtifactPageResponse
- type ToolAvailabilityPayload
- type ToolBackendRefPayload
- type ToolCallEventPayload
- type ToolDescriptorPayload
- type ToolErrorPayload
- type ToolErrorResponse
- type ToolInvokeRequest
- type ToolInvokeResponse
- type ToolPayload
- type ToolPolicyDecisionPayload
- type ToolResponse
- type ToolSearchRequest
- type ToolSourceRefPayload
- type ToolsResponse
- type ToolsetPayload
- type ToolsetResponse
- type ToolsetsResponse
- type TranscriptDeltaPayload
- type TranscriptMarkerPayload
- type TranscriptSnapshotPayload
- type TriggerPayload
- type TriggerResponse
- type TriggersResponse
- type TurnHistoryPayload
- type UnarchiveProfileResponse
- type UpdateAgentRequest
- type UpdateAppTokenRequest
- type UpdateExtensionRequest
- type UpdateExtensionsRequest
- type UpdateJobRequest
- type UpdateMarketplaceSourceRequest
- type UpdateProfileRequest
- type UpdateSettingsAttentionPayload
- type UpdateSettingsAttentionRequest
- type UpdateSettingsAutomationRequest
- type UpdateSettingsCmdPaletteRequest
- type UpdateSettingsGeneralRequest
- type UpdateSettingsHooksExtensionsRequest
- type UpdateSettingsMarketplaceRequest
- type UpdateSettingsObservabilityRequest
- type UpdateSettingsPersonaRequest
- type UpdateSettingsRolesRequest
- type UpdateSettingsShellRequest
- type UpdateSettingsSkillsRequest
- type UpdateSettingsWindowManagerRequest
- type UpdateTaskRequest
- type UpdateTriggerRequest
- type UpdateWorkspaceRequest
- type ValidateLoopRequest
- type ValidationIssue
- type VaultSecretPayload
- type VaultSecretResponse
- type VaultSecretsResponse
- type ViewFrame
- type WebhookDeliveryPayload
- type WebhookDeliveryResponse
- type WindowManagerActor
- type WindowManagerArrangeLayoutPayload
- type WindowManagerBalanceLayoutPayload
- type WindowManagerClientCommandAckFrame
- type WindowManagerClientCommandFrame
- type WindowManagerClientCommandResultFrame
- type WindowManagerClientContextFrame
- type WindowManagerClientContextInput
- type WindowManagerClientFrame
- type WindowManagerClientRegistration
- type WindowManagerClientView
- type WindowManagerClientsResponse
- type WindowManagerCloseWindowPayload
- type WindowManagerCommandID
- type WindowManagerCommandRequest
- type WindowManagerCreateDesktopPayload
- type WindowManagerDeleteDesktopPayload
- type WindowManagerDesktop
- type WindowManagerErrorCode
- type WindowManagerErrorFrame
- type WindowManagerErrorPayload
- type WindowManagerEvent
- type WindowManagerEventFrame
- type WindowManagerFloatingStack
- type WindowManagerFocusWindowPayload
- type WindowManagerFrameResizeLayoutPayload
- type WindowManagerGroupFrameEditPayload
- type WindowManagerGroupWindowsPayload
- type WindowManagerHeartbeatFrame
- type WindowManagerLayoutDocument
- type WindowManagerLayoutGroup
- type WindowManagerLayoutNode
- type WindowManagerLayoutReplaceRequest
- type WindowManagerLayoutValidationRequest
- type WindowManagerLayoutValidationResponse
- type WindowManagerMoveWindowPayload
- type WindowManagerNavigateWindowPayload
- type WindowManagerOpenWindowPayload
- type WindowManagerPaletteContext
- type WindowManagerPinWindowPayload
- type WindowManagerPreview
- type WindowManagerRebaseGuard
- type WindowManagerRedoLayoutPayload
- type WindowManagerReopenWindowPayload
- type WindowManagerReorderDesktopPayload
- type WindowManagerReorderStackPayload
- type WindowManagerReplaceLayoutPayload
- type WindowManagerResizeLayoutPayload
- type WindowManagerResizeWindowPayload
- type WindowManagerResult
- type WindowManagerReturnAnchor
- type WindowManagerRevision
- type WindowManagerSetStackActivePayload
- type WindowManagerSnapshot
- type WindowManagerSnapshotFrame
- type WindowManagerSwapWindowsPayload
- type WindowManagerSwitchDesktopPayload
- type WindowManagerToggleFloatingPayload
- type WindowManagerUndoLayoutPayload
- type WindowManagerUpdateDesktopPayload
- type WindowManagerWindow
- type WindowManagerWindowSpecPayload
- type WindowManagerZoomWindowPayload
- type WorkspaceArchiveBlocker
- type WorkspaceAttentionSummaryPayload
- type WorkspaceDetailPayload
- type WorkspaceFolderPayload
- type WorkspaceFolderResponse
- type WorkspaceLayoutResponse
- type WorkspacePayload
- type WorkspacePlacementPayload
- type WorkspaceProfileHintPayload
- type WorkspaceResponse
- type WorkspaceSkillPayload
- type WorkspacesResponse
- type WorktreeBindingsPayload
- type WorktreeBranchOutcomePayload
- type WorktreeCatalogEventPayload
- type WorktreeCleanupResponse
- type WorktreeExitAction
- type WorktreeExitActionPlan
- type WorktreeExitCleanupEvidence
- type WorktreeExitCommitScope
- type WorktreeExitForgeCapabilities
- type WorktreeExitOperationResponse
- type WorktreeExitPRPrefill
- type WorktreeExitPlanResponse
- type WorktreeForgeStatusPayload
- type WorktreeInspectionResponse
- type WorktreePayload
- type WorktreeRemovalRefusalPayload
- type WorktreeRemovalRiskPayload
- type WorktreeRepoPayload
- type WorktreeResponse
- type WorktreeStatusPayload
- type WorktreeStatusResponse
- type WorktreesResponse
Constants ¶
const ( CodeExtensionGatewayConfirmRequired = diagnosticcontract.CodeExtensionGatewayConfirmRequired SeverityOK = diagnosticcontract.SeverityOK SeverityInfo = diagnosticcontract.SeverityInfo SeverityWarn = diagnosticcontract.SeverityWarn SeverityError = diagnosticcontract.SeverityError SeverityCritical = diagnosticcontract.SeverityCritical )
const ( FreshnessLive = diagnosticcontract.FreshnessLive FreshnessOffline = diagnosticcontract.FreshnessOffline FreshnessStale = diagnosticcontract.FreshnessStale )
const ( CategoryProvider = diagnosticcontract.CategoryProvider CategoryDaemon = diagnosticcontract.CategoryDaemon CategoryConfig = diagnosticcontract.CategoryConfig CategoryVault = diagnosticcontract.CategoryVault CategoryMCP = diagnosticcontract.CategoryMCP CategoryExtension = diagnosticcontract.CategoryExtension CategorySession = diagnosticcontract.CategorySession CategoryTask = diagnosticcontract.CategoryTask CategoryHome = diagnosticcontract.CategoryHome CategorySecrets = diagnosticcontract.CategorySecrets CategoryMigrations = diagnosticcontract.CategoryMigrations )
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 CodeDaemonDraining = diagnosticcontract.CodeDaemonDraining CodeDaemonStateSuspect = diagnosticcontract.CodeDaemonStateSuspect CodeDaemonStatusOK = diagnosticcontract.CodeDaemonStatusOK 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 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 CodeIdentityMismatch = diagnosticcontract.CodeIdentityMismatch CodeIdentityRequired = diagnosticcontract.CodeIdentityRequired CodeIdentityStale = diagnosticcontract.CodeIdentityStale CodeModelNotFound = diagnosticcontract.CodeModelNotFound CodeMCPAuthRequired = diagnosticcontract.CodeMCPAuthRequired CodeMCPServerReady = diagnosticcontract.CodeMCPServerReady 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 CodeProviderDefaultDisableRejected = diagnosticcontract.CodeProviderDefaultDisableRejected CodeProviderDisabled = diagnosticcontract.CodeProviderDisabled 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 )
const ( CodeExtensionArchiveDigestMismatch = diagnosticcontract.CodeExtensionArchiveDigestMismatch CodeExtensionUnverifiedPolicyBlocked = diagnosticcontract.CodeExtensionUnverifiedPolicyBlocked )
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 )
const ( MarketplaceScopeGlobal = "global" MarketplaceScopeProfile = "profile" MarketplaceScopeWorkspace = "workspace" )
const ( PromptAttachmentKindImage = session.AttachmentKindImage PromptAttachmentKindFile = session.AttachmentKindFile // DefaultPromptAttachmentLimit applies when no configured cap is supplied. DefaultPromptAttachmentLimit = 10 )
const ( ProviderAuthStateAuthenticated = "authenticated" ProviderAuthStateNeedsLogin = "needs_login" ProviderAuthStateMissingCLI = "missing_cli" ProviderAuthStateMissingCredential = "missing_credential" ProviderAuthStatePermissionDenied = "permission_denied" ProviderAuthStateRateLimited = "rate_limited" ProviderAuthStateTransient = "transient" ProviderAuthStateNone = "none" ProviderAuthStateUnknown = "unknown" )
const ( SessionFilesDefaultLimit = 50 SessionFilesMaxLimit = 200 )
Session file search limit bounds for the searchSessionFiles limit query parameter.
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 )
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" )
const ( SpeedNormal = speedpkg.SpeedNormal SpeedFast = speedpkg.SpeedFast )
const ( SpeedResolutionApplied = speedpkg.ResolutionApplied SpeedResolutionUnsupported = speedpkg.ResolutionUnsupported SpeedResolutionRejected = speedpkg.ResolutionRejected )
const ( SpeedResolutionReasonCapabilityAbsent = speedpkg.ReasonCapabilityAbsent SpeedResolutionReasonCapabilityAmbiguous = speedpkg.ReasonCapabilityAmbiguous SpeedResolutionReasonValueAmbiguous = speedpkg.ReasonValueAmbiguous SpeedResolutionReasonProviderRejected = speedpkg.ReasonProviderRejected )
const ( SessionStreamEventSubagentsSnapshot = "subagents_snapshot" SessionStreamEventSubagentUpdated = "subagent_updated" )
const ( ToolOperatorCauseDetailKey = "operator_cause" ToolOperatorRecoveryDetailKey = "operator_recovery" )
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" )
const LoopRunWebRoute = "/loop-runs/%s"
LoopRunWebRoute is the public SPA route for one persisted Loop run.
const ObserveOverviewSchemaVersion = "observe-overview/v1"
ObserveOverviewSchemaVersion identifies the home overview payload contract revision.
const ProviderUsageCollectionProfileQuery = "collection_profile"
ProviderUsageCollectionProfileQuery selects the login to collect after a user-scoped consent change.
SchedulerDrainTimeoutMaxSeconds is the largest whole-second timeout that can be represented by time.Duration.
const (
// StatusSchemaVersion identifies the public status/doctor payload contract.
StatusSchemaVersion = "2026-10-07"
)
Variables ¶
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") )
var ErrRawClaimTokenMetadata = errors.New("contract: public payload must not contain raw lease credentials")
ErrRawClaimTokenMetadata reports raw lease credentials in a public payload.
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 ¶
ContainsRawClaimTokenField reports whether a JSON payload includes a raw claim_token field.
func ContainsUnsafeAuthoredContextPayload ¶
ContainsUnsafeAuthoredContextPayload reports whether a payload includes raw credentials or prompt data.
func DiagnosticCodeCategory ¶
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 ¶
IsDiagnosticCategory reports whether category belongs to the closed set.
func IsDiagnosticCode ¶
IsDiagnosticCode reports whether code belongs to the canonical registry.
func IsDiagnosticFreshness ¶
IsDiagnosticFreshness reports whether freshness belongs to the closed set.
func IsDiagnosticSeverity ¶
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 TerminalCommandRowFromPayload ¶
func TerminalCommandRowFromPayload(row TerminalCommandRowPayload) terminalpkg.CommandRow
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 ¶
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 ¶
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 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 AgentActivityBatchRequest ¶
type AgentActivityBatchRequest struct {
Days int `json:"days,omitempty"`
Items []AgentActivitySelection `json:"items"`
}
AgentActivityBatchRequest retains each item's scope independently, including same-named definitions.
type AgentActivityBatchResponse ¶
type AgentActivityBatchResponse struct {
Activities []AgentActivityResponse `json:"activities"`
}
AgentActivityBatchResponse returns one unchanged activity payload per request item, in order.
type AgentActivityResponse ¶
type AgentActivityResponse agentinstance.Activity
type AgentActivitySelection ¶
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 ¶
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 AgentEffectiveRuntimePayload ¶
type AgentEffectiveRuntimePayload struct {
SessionEnvStatus []SettingsProviderCredentialStatusPayload `json:"session_env_status,omitempty"`
SessionEnv map[string]SessionEnvBindingPayload `json:"session_env,omitempty"`
AutoCompactWindow *int `json:"auto_compact_window,omitempty"`
LeanEnvironment *bool `json:"lean_environment,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"`
// PolicyExcludedACPOptions lists the acp_options entries a new non-instance session does
// not inherit because its permission level forbids unrestricted provider access.
PolicyExcludedACPOptions []AgentACPOptionSelection `json:"policy_excluded_acp_options,omitempty"`
// Permissions is the level a new session of the definition starts at: the operator override,
// then the authored level, then [permissions].mode. An always-on definition with neither
// reports the level its main instance session runs at (source always_on_default); its
// non-instance sessions still fall back to [permissions].mode.
Permissions string `json:"permissions,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"`
Permissions AgentRuntimeValueSource `json:"permissions,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 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 {
Source *AgentInstanceProposalSource `json:"source,omitempty"`
Key string `json:"key"`
Summary string `json:"summary"`
}
type AgentInstanceCheckInPayload ¶
type AgentInstanceCheckInPayload struct {
Proposals agentinstance.CheckInProposalSummary `json:"proposals"`
OccurrenceID string `json:"occurrence_id"`
ToolsStatus string `json:"tools_status"`
ToolCalls []agentinstance.CheckInToolCall `json:"tool_calls"`
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 {
Sources []HeartbeatSourceOutcomePayload `json:"sources,omitempty"`
Gate string `json:"gate,omitempty"`
OccurrenceID string `json:"occurrence_id,omitempty"`
Digest []AgentInstanceCheckDigest `json:"digest"`
}
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 AgentInstancePayload ¶
type AgentInstancePayload struct {
AuthorityStatus string `json:"authority_status"`
Sources []heartbeat.HeartbeatSourceStatus `json:"sources"`
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"`
AttentionDismissible bool `json:"attention_dismissible"`
NeedsAttention bool `json:"needs_attention"`
ID string `json:"id"`
ProfileID string `json:"profile_id"`
ProfileName string `json:"profile_name"`
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 AgentInstancePickRequest ¶
type AgentInstancePickRequest struct {
Proposal *int `json:"proposal"`
}
type AgentInstancePickResponse ¶
type AgentInstancePickResponse struct {
Pick agentinstance.Pick `json:"pick"`
}
type AgentInstanceProposal ¶
type AgentInstanceProposal struct {
Action *AgentInstanceProposalAction `json:"action,omitempty"`
AutoAcceptStatus AutoAcceptStatus `json:"auto_accept_status"`
Sources []AgentInstanceProposalSource `json:"sources,omitempty"`
Title string `json:"title"`
Body string `json:"body"`
ItemKeys []string `json:"item_keys"`
}
type AgentInstanceProposalSource ¶
type AgentInstanceProposalSource struct {
SourceID string `json:"source_id,omitempty"`
SourceRef string `json:"source_ref,omitempty"`
ItemKey string `json:"item_key,omitempty"`
URL string `json:"url,omitempty"`
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 {
Diagnostics []string `json:"diagnostics,omitempty"`
OccurrenceID string `json:"occurrence_id,omitempty"`
PicksTracked bool `json:"picks_tracked"`
Picks []agentinstance.Pick `json:"picks"`
ToolCalls agentinstance.CheckInToolSummary `json:"tool_calls"`
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 {
SourceID string `json:"source_id,omitempty"`
SourceRef string `json:"source_ref,omitempty"`
ItemKey string `json:"item_key,omitempty"`
URL string `json:"url,omitempty"`
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 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 AgentMCPServerInput ¶
type AgentMCPServerInput struct {
ReadOnlyTools []string `json:"read_only_tools,omitempty"`
SecretHeaderValues map[string]string `json:"secret_header_values,omitempty"`
SecretEnvValues map[string]string `json:"secret_env_values,omitempty"`
Name string `json:"name"`
Reference bool `json:"reference,omitzero"`
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"`
SecretHeaders map[string]string `json:"secret_headers,omitempty"`
Auth *SettingsMCPAuthConfigPayload `json:"auth,omitzero"`
}
AgentMCPServerInput attaches a name reference or an agent-local definition with Vault bindings.
type AgentMCPServerJSON ¶
type AgentMCPServerJSON struct {
ReadOnlyTools []string `json:"read_only_tools,omitempty"`
Reference bool `json:"reference,omitzero"`
BrokenReference bool `json:"broken_reference,omitzero"`
SecretHeaders map[string]string `json:"secret_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 *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 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 AgentMemoryRevision ¶
type AgentMemoryRollbackRequest ¶
type AgentMemoryRollbackRequest struct {
Revision string `json:"revision"`
}
type AgentMemorySearchResponse ¶
type AgentMemorySearchResponse struct {
Results []AgentMemorySearchResult `json:"results"`
}
type AgentMemorySearchResult ¶
type AgentMemoryValidateRequest ¶
type AgentMemoryValidateRequest struct {
Content string `json:"content"`
}
type AgentMemoryWriteRequest ¶
type AgentNotifyRequest ¶
type AgentNotifyResponse ¶
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"`
AutoCompactWindow *int `json:"auto_compact_window,omitempty"`
LeanEnvironment *bool `json:"lean_environment,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" // AgentRuntimeValueSourceConfigOverride is an operator [agents.overrides.<name>] value. AgentRuntimeValueSourceConfigOverride AgentRuntimeValueSource = "config_override" // AgentRuntimeValueSourceAlwaysOnDefault is the level an always-on instance runs at when // nothing sets one. AgentRuntimeValueSourceAlwaysOnDefault AgentRuntimeValueSource = "always_on_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 AgentSkillDraftFile ¶
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 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"`
// SessionType and InstanceID let a session row name a non-operator origin, as the session
// payload's type and instance_id do.
SessionType string `json:"session_type,omitempty"`
InstanceID string `json:"instance_id,omitempty"`
}
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 AutoAcceptStatus ¶
type AutoAcceptStatus string
const ( AutoAcceptPicked AutoAcceptStatus = "picked" AutoAcceptLimit AutoAcceptStatus = "limit" AutoAcceptQueueFull AutoAcceptStatus = "queue_full" AutoAcceptUnapproved AutoAcceptStatus = "unapproved" AutoAcceptNoMain AutoAcceptStatus = "no_main" AutoAcceptInactive AutoAcceptStatus = "inactive" AutoAcceptNone AutoAcceptStatus = "none" )
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 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 ChangeBasePayload ¶
type ChangeBaseRefPayload ¶
type ChangeHeadPayload ¶
type ChangePatchPayload ¶
type ChangeSidePayload ¶
type ChangeTotalsPayload ¶
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 CmdPaletteInvokeRequest ¶
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"`
}
func CmdPalettePersonalizationFromDomain ¶
func CmdPalettePersonalizationFromDomain( summary cmdpalette.PersonalizationSummary, ) CmdPalettePersonalizationResponse
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 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 ¶
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 {
// MCPServers adds or replaces sidecar entries by name; omitted and empty preserve existing entries.
MCPServers []AgentMCPServerInput `json:"mcp_servers,omitempty"`
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"`
AutoCompactWindow *int `json:"auto_compact_window,omitempty"`
LeanEnvironment *bool `json:"lean_environment,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 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 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 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 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"`
AutoCompactWindow *int `json:"auto_compact_window,omitempty"`
LeanEnvironment *bool `json:"lean_environment,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 ExtensionEnableError ¶
ExtensionEnableError reports an activation failure after a successful install.
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 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 {
// InstallEnableError carries the install outcome to transport envelopes without changing inventory JSON.
InstallEnableError *ExtensionEnableError `json:"-"`
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 ¶
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 {
Inputs []MarketplaceInputPayload `json:"inputs,omitempty"`
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 FileChangePayload ¶
type FileChangePayload struct {
Path string `json:"path"`
OldPath string `json:"old_path,omitempty"`
Status string `json:"status"`
Additions int `json:"additions"`
Deletions int `json:"deletions"`
Binary bool `json:"binary,omitzero"`
Generated bool `json:"generated,omitzero"`
Sensitive bool `json:"sensitive,omitzero"`
Fingerprint string `json:"fingerprint"`
}
type FileContentResponse ¶
type FileContentResponse struct {
Root FileRootPayload `json:"root"`
Path string `json:"path"`
Kind string `json:"kind"`
Size int64 `json:"size"`
Language string `json:"language,omitempty"`
Text *string `json:"text,omitempty"`
ImageMIME string `json:"image_mime,omitempty"`
ImageBase64 string `json:"image_base64,omitempty"`
Sensitive bool `json:"sensitive,omitzero"`
Truncated bool `json:"truncated"`
Revision string `json:"revision,omitempty"`
}
type FileEntriesResponse ¶
type FileEntriesResponse struct {
Root FileRootPayload `json:"root"`
Path string `json:"path"`
Entries []FileEntryPayload `json:"entries"`
Truncated bool `json:"truncated"`
}
type FileEntryPayload ¶
type FileEntryPayload struct {
Name string `json:"name"`
Path string `json:"path"`
Kind string `json:"kind"`
Size int64 `json:"size,omitzero"`
Symlink bool `json:"symlink,omitzero"`
Ignored bool `json:"ignored,omitzero"`
Sensitive bool `json:"sensitive,omitzero"`
GitStatus string `json:"git_status,omitempty"`
ContainsChanges bool `json:"contains_changes,omitzero"`
}
type FileFindMatch ¶
type FileFindResponse ¶
type FileFindResponse struct {
Root FileRootPayload `json:"root"`
Query string `json:"query"`
Results []FileFindMatch `json:"results"`
IndexedFiles int `json:"indexed_files"`
IndexTruncated bool `json:"index_truncated"`
}
type FileRootPayload ¶
type FileSearchFile ¶
type FileSearchFile struct {
Path string `json:"path"`
Matches []FileSearchMatch `json:"matches"`
TruncatedMatches bool `json:"truncated_matches,omitzero"`
}
type FileSearchMatch ¶
type FileSearchQuery ¶
type FileSearchResponse ¶
type FileSearchResponse struct {
Root FileRootPayload `json:"root"`
Query FileSearchQuery `json:"query"`
Engine string `json:"engine"`
Files []FileSearchFile `json:"files"`
Totals FileSearchTotals `json:"totals"`
Truncated bool `json:"truncated"`
TimedOut bool `json:"timed_out"`
SensitiveExcluded int `json:"sensitive_excluded"`
}
type FileSearchTotals ¶
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 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 ¶
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 ¶
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 ¶
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" 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" 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" 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" )
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 HeartbeatAuthorityPayload ¶
type HeartbeatAuthorityPayload struct {
ReadOnlyTools map[string][]string `json:"read_only_tools,omitempty"`
Actions []heartbeatpkg.ActionDecl `json:"actions"`
Digest string `json:"digest"`
Status string `json:"status"`
CheckIns heartbeatpkg.CheckInsPolicy `json:"check_ins"`
}
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 {
Sources []HeartbeatSourceDeclPayload `json:"sources,omitempty"`
Include []string `json:"include,omitzero"`
}
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 {
Actions []heartbeatpkg.ActionDecl `json:"actions"`
CheckIns heartbeatpkg.CheckInsPolicy `json:"check_ins"`
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 {
Actions []heartbeatpkg.ActionDecl `json:"actions"`
Authority HeartbeatAuthorityPayload `json:"authority"`
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 {
ApproveAuthoritySHA256 string `json:"approve_authority_sha256,omitempty"`
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 {
ApproveAuthoritySHA256 string `json:"approve_authority_sha256,omitempty"`
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 HeartbeatScriptApprovalRequest ¶
type HeartbeatScriptApprovalRequest struct {
SHA256 string `json:"sha256"`
}
type HeartbeatSourceCatalogPayload ¶
type HeartbeatSourceCatalogPayload struct {
Agent string `json:"agent"`
ScriptsEnabled bool `json:"scripts_enabled"`
Limits HeartbeatSourceLimitsPayload `json:"limits"`
Kinds []source.KindDescriptor `json:"kinds"`
Scripts []HeartbeatSourceScriptPayload `json:"scripts"`
}
type HeartbeatSourceDeclPayload ¶
HeartbeatContextProjectionPayload captures authored context projection hints.
type HeartbeatSourceOutcomePayload ¶
type HeartbeatSourceOutcomePayload = heartbeat.SourceOutcome
type HeartbeatSourceScriptPayload ¶
type HeartbeatSourceScriptPayload struct {
LineCount int `json:"line_count,omitzero"`
LastModified *time.Time `json:"last_modified,omitempty"`
Name string `json:"name"`
// Path is the script's absolute file path, for opening it in the operator's editor.
Path string `json:"path,omitempty"`
Executable bool `json:"executable"`
SHA256 string `json:"sha256"`
Approved bool `json:"approved"`
ApprovedSHA256 *string `json:"approved_sha256"`
}
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 ( HeartbeatWakeReasonSourcePollInFlight HeartbeatWakeReason = "source_poll_in_flight" 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" HeartbeatWakeReasonQuiet HeartbeatWakeReason = "quiet" HeartbeatWakeReasonReported HeartbeatWakeReason = "reported" HeartbeatWakeReasonCancelled HeartbeatWakeReason = "cancelled" //nolint:misspell // Stored spelling. HeartbeatWakeReasonDigestEmpty HeartbeatWakeReason = "digest_empty" HeartbeatWakeReasonDigestUnchanged HeartbeatWakeReason = "digest_unchanged" HeartbeatWakeReasonPolicyDisabled HeartbeatWakeReason = "policy_disabled" HeartbeatWakeReasonDefinitionNotAlwaysOn HeartbeatWakeReason = "definition_not_always_on" HeartbeatWakeReasonDefinitionMissing HeartbeatWakeReason = "definition_missing" HeartbeatWakeReasonNoSlot HeartbeatWakeReason = "no_slot" HeartbeatWakeReasonHookCancelled HeartbeatWakeReason = "hook_cancelled" //nolint:misspell // Stored spelling. HeartbeatWakeReasonDuplicateSuppressed HeartbeatWakeReason = "duplicate_suppressed" HeartbeatWakeReasonTriageUnsupported HeartbeatWakeReason = "triage_unsupported" HeartbeatWakeReasonTriageOutputInvalid HeartbeatWakeReason = "triage_output_invalid" HeartbeatWakeReasonTriageTimeout HeartbeatWakeReason = "triage_timeout" HeartbeatWakeReasonTriageInterrupted HeartbeatWakeReason = "triage_interrupted" HeartbeatWakeReasonTriageFailed HeartbeatWakeReason = "triage_failed" )
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" HeartbeatWakeResultQuiet HeartbeatWakeResult = "quiet" HeartbeatWakeResultCancelled HeartbeatWakeResult = "cancelled" //nolint:misspell // Stored spelling. HeartbeatWakeResultReported HeartbeatWakeResult = "reported" )
type HeartbeatWakeSource ¶
type HeartbeatWakeSource string
HeartbeatWakeSource classifies who requested an advisory Heartbeat wake.
const ( HeartbeatWakeSourceScheduler HeartbeatWakeSource = "scheduler" HeartbeatWakeSourceManual HeartbeatWakeSource = "manual" HeartbeatWakeSourceHarnessReentry HeartbeatWakeSource = "harness_reentry" HeartbeatWakeSourceTimer HeartbeatWakeSource = "timer" HeartbeatWakeSourceInstanceCheck HeartbeatWakeSource = "instance_check" )
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 ¶
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 ¶
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 {
Enable bool `json:"enable,omitzero"`
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 InstallExtensionResponse ¶
type InstallExtensionResponse struct {
EnableError *ExtensionEnableError `json:"enable_error,omitzero"`
Extension ExtensionPayload `json:"extension"`
}
InstallExtensionResponse includes the outcome of the optional enable step.
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" // IssueSeverityInfo reports discovery notices. IssueSeverityInfo IssueSeverity = "info" // 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 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 ¶
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 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 LoopGateBlockingIssuePayload ¶
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 ¶
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 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 MarketplaceCategoriesResponse ¶
type MarketplaceCategoriesResponse struct {
Revision string `json:"revision"`
Categories []MarketplaceCategoryCount `json:"categories"`
}
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 ¶
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 {
Categories []MarketplaceCategoryCount `json:"categories"`
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 {
Category string `json:"category"`
CategoryLabel string `json:"category_label"`
Featured bool `json:"featured"`
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 MarketplaceSection ¶
type MarketplaceSection struct {
ID string `json:"id"`
Label string `json:"label"`
Total int `json:"total"`
Items []MarketplaceListingPayload `json:"items"`
}
type MarketplaceSectionsResponse ¶
type MarketplaceSectionsResponse struct {
Sections []MarketplaceSection `json:"sections"`
Revision string `json:"revision"`
Stale bool `json:"stale"`
Refreshing bool `json:"refreshing,omitzero"`
ErrorClass string `json:"error_class,omitempty"`
Error string `json:"error,omitempty"`
Sources []MarketplaceSourceSummary `json:"sources"`
}
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 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 MarketplaceSourceResponse ¶
type MarketplaceSourceResponse struct {
Source MarketplaceSourcePayload `json:"source"`
}
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 MoveSessionToProfileRequest ¶
type MoveSessionToProfileRequest struct {
TargetProfile string `json:"target_profile"`
}
MoveSessionToProfileRequest copies a stopped user session into another profile and archives the original. TargetProfile is the target profile's name.
type MoveSessionToProfileResponse ¶
type MoveSessionToProfileResponse struct {
Session SessionPayload `json:"session"`
Original SessionPayload `json:"original"`
WorktreeID string `json:"worktree_id,omitempty"`
Branch string `json:"branch,omitempty"`
}
MoveSessionToProfileResponse is a completed move: the copy in the target profile, the archived original, and the copy's new worktree when the original had one.
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 {
}
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 ¶
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"`
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 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"`
// Enabled reports providers.<name>.enabled; disabled providers stay listed (inventory surface).
Enabled bool `json:"enabled"`
AuthStatus ProviderAuthStatusPayload `json:"auth_status"`
}
ProviderSummaryPayload describes one canonical provider and its declared auth state.
type ProviderUsageAccount ¶
type ProviderUsageAmount ¶
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 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 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 ProviderUsageTarget ¶
type ProviderUsageTarget struct {
ProviderID string `json:"provider_id"`
CollectorID string `json:"collector_id,omitempty"`
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 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"`
PreserveHeaders bool `json:"preserve_headers,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 ¶
func (r PutVaultSecretRequest) Normalize() PutVaultSecretRequest
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 ¶
SendPromptResultPayload reports non-streaming busy-input outcomes.
type RerunLoopRequest ¶
type RerunLoopResponse ¶
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 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"`
// Progress is present while the replacement daemon upgrades persisted data before readiness.
Progress *RestartProgress `json:"progress,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 RestartProgress ¶
type RestartProgress struct {
Phase RestartProgressPhase `json:"phase"`
Stage string `json:"stage"`
Completed int64 `json:"completed"`
Total int64 `json:"total"`
UpdatedAt time.Time `json:"updated_at"`
}
RestartProgress reports a replacement daemon's data migration; observers keep waiting while it advances.
type RestartProgressPhase ¶
type RestartProgressPhase string
RestartProgressPhase names a replacement daemon's pre-readiness phase. It may gain values; clients should treat an unknown phase as generic in-progress work.
const (
RestartProgressMigrating RestartProgressPhase = "migrating"
)
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 {
HeldReason string `json:"held_reason,omitempty"`
HeldInstanceID string `json:"held_instance_id,omitempty"`
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 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 SessionChangeBasesResponse ¶
type SessionChangeBasesResponse struct {
Default *ChangeBaseRefPayload `json:"default"`
Resolvable bool `json:"resolvable"`
Refs []ChangeBaseRefPayload `json:"refs"`
Truncated bool `json:"truncated"`
}
type SessionChangeContentsResponse ¶
type SessionChangeContentsResponse struct {
Revision string `json:"revision"`
Path string `json:"path"`
OldPath string `json:"old_path,omitempty"`
Fingerprint string `json:"fingerprint"`
Old *ChangeSidePayload `json:"old,omitempty"`
New *ChangeSidePayload `json:"new,omitempty"`
}
type SessionChangePatchesResponse ¶
type SessionChangePatchesResponse struct {
Revision string `json:"revision"`
Patches []ChangePatchPayload `json:"patches"`
}
type SessionChangesResponse ¶
type SessionChangesResponse struct {
Scope string `json:"scope"`
Root FileRootPayload `json:"root"`
Head ChangeHeadPayload `json:"head"`
Base ChangeBasePayload `json:"base"`
PullRequest *SessionPullRequestPayload `json:"pull_request,omitempty"`
Totals ChangeTotalsPayload `json:"totals"`
Files []FileChangePayload `json:"files"`
Truncated bool `json:"truncated"`
Revision string `json:"revision"`
}
type SessionChildrenPayload ¶
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"`
}
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" 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 ¶
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 {
HeldReason string `json:"held_reason,omitempty"`
HeldInstanceID string `json:"held_instance_id,omitempty"`
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"`
WorkingDir string `json:"working_dir,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"`
// AttentionDismissible reports a Needs you the operator can mark as seen; it is
// false while the session waits on an answer, a sign-in, or a stop.
AttentionDismissible bool `json:"attention_dismissible,omitzero"`
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 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 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"`
// RetryAfter is when a rate-limited forge accepts lookups again; until then refreshes return the
// cached facts above. Absent unless Cause is rate_limited.
RetryAfter *time.Time `json:"retry_after,omitempty"`
}
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 ¶
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 {
// Reason is runtime_exit while a replacement runtime starts, or provider_auth while the
// provider sign-in is missing; absent on recoveries recorded before the field existed.
Reason store.SessionRuntimeRecoveryReason `json:"reason,omitempty"`
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 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 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 SetSettingsProviderEnabledRequest ¶
type SetSettingsProviderEnabledRequest struct {
Enabled bool `json:"enabled"`
}
SetSettingsProviderEnabledRequest toggles providers.<name>.enabled only.
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 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 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 SettingsDesktopPayload ¶
type SettingsDesktopPayload struct {
EditorCommand string `json:"editor_command"`
}
SettingsDesktopPayload projects the [desktop] block read by the desktop app.
type SettingsExtensionDevPayload ¶
type SettingsExtensionDevPayload struct {
WatchInterval string `json:"watch_interval"`
}
type SettingsExtensionGitSourcePayload ¶
type SettingsExtensionGitSourcePayload struct {
Enabled bool `json:"enabled"`
}
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"`
// Desktop mirrors the machine-only [desktop] block. Omitted on update to keep the current value.
Desktop *SettingsDesktopPayload `json:"desktop,omitzero"`
}
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 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 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 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 SettingsMCPServerItemPayload ¶
type SettingsMCPServerItemPayload struct {
ReadOnlyTools []string `json:"read_only_tools,omitempty"`
HeadersConfigured bool `json:"headers_configured,omitzero"`
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 {
ReadOnlyTools []string `json:"read_only_tools,omitempty"`
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 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 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"`
// LastProbeAt is when the reported sign-in state was last verified live; absent when never.
LastProbeAt *time.Time `json:"last_probe_at,omitempty"`
}
type SettingsProviderEnabledResponse ¶
type SettingsProviderEnabledResponse struct {
Provider SettingsProviderItemPayload `json:"provider"`
Apply SettingsApplyResponse `json:"apply"`
}
SettingsProviderEnabledResponse returns the toggled provider and its live apply result.
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 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 SettingsProviderSettingsPayload ¶
type SettingsProviderSettingsPayload struct {
SessionEnv map[string]SessionEnvBindingPayload `json:"session_env,omitempty"`
AutoCompactWindow *int `json:"auto_compact_window,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"`
// Enabled is the effective providers.<name>.enabled value; read only (PATCH .../enabled toggles it).
Enabled bool `json:"enabled"`
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 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"`
AutoCompactWindow *int `json:"auto_compact_window,omitempty"`
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 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 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 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"`
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 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 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 SkillActivationReasonCode = "environment_context_unavailable" // SkillActivationReasonEnvironmentMismatch means the current environment fails the skill gate. SkillActivationReasonEnvironmentMismatch SkillActivationReasonCode = "environment_mismatch" SkillActivationReasonToolContextUnavailable SkillActivationReasonCode = "tool_context_unavailable" // SkillActivationReasonMissingTool means one or more required tools are unavailable. SkillActivationReasonMissingTool SkillActivationReasonCode = "missing_tool" 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 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 SkillVerificationStatus ¶
type SkillVerificationStatus string
const ( SkillVerificationStatusPassed SkillVerificationStatus = "passed" SkillVerificationStatusWarning SkillVerificationStatus = "warning" SkillVerificationStatusFailed SkillVerificationStatus = "failed" )
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 ¶
func (p SpawnPermissionRequestPayload) Policy() SpawnPermissionPolicyPayload
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 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 SubagentCancelPayload ¶
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 SubagentRuntimePayload ¶
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 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"`
}
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 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 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 TaskRunsResponse ¶
type TaskRunsResponse struct {
Runs []TaskRunPayload `json:"runs"`
}
TaskRunsResponse wraps the shared task-run list payload.
type TaskStatusTotalPayload ¶
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 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) TerminalErrorLimitReached TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeLimitReached) TerminalErrorSubscriberLimitReached TerminalErrorCode = TerminalErrorCode( terminalpkg.ErrorCodeSubscriberLimitReached, ) TerminalErrorExited TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeExited) TerminalErrorExpired TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeExpired) 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) terminalpkg.ErrorCodeRecordingUnavailable, ) TerminalErrorSlowConsumer TerminalErrorCode = TerminalErrorCode(terminalpkg.ErrorCodeSlowConsumer) 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 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"`
}
func TerminalInputRequestsResponseFromDomain ¶
func TerminalInputRequestsResponseFromDomain( pending []terminalpkg.PendingInputRequest, resolved []terminalpkg.ResolvedInputRequest, ) (TerminalInputRequestsResponse, error)
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 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 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 TerminalState ¶
type TerminalState string
const ( TerminalStateRunning TerminalState = "running" TerminalStateExited TerminalState = "exited" )
type TerminalWaitRequest ¶
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"`
// AccessScope names the target scope a remembered cross-workspace or cross-profile read
// covers: read:workspace:<id>@<profile>, read:user@<profile>, or read:all-projects@<profile>,
// with "*" for every profile. It is empty for tool approval decisions.
AccessScope string `json:"access_scope,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 ¶
func (r ToolApprovalGrantSetRequest) Domain() toolspkg.ApprovalGrantSetRequest
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 {
CheckInWritable bool `json:"check_in_writable"`
Access string `json:"access"`
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"`
OutputViews *tools.ResultViews `json:"output_views,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 {
Offset int `json:"offset,omitzero"`
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"`
Offset int `json:"offset,omitzero"`
Count int `json:"count"`
Total int `json:"total"`
NextOffset int `json:"next_offset,omitzero"`
HasMore bool `json:"has_more"`
}
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 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 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 {
Code string `json:"code,omitempty"`
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" 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 ¶
func (request WindowManagerCommandRequest) Domain( pathWorkspace windowmanager.WorkspaceID, ) (windowmanager.CommandRequest, error)
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" )
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 ¶
func (document WindowManagerLayoutDocument) Domain() windowmanager.LayoutDocument
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 {
}
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.
const WindowManagerMaxSafeRevision WindowManagerRevision = WindowManagerRevision(windowmanager.MaxWireRevision)
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"`
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 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 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 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 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 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
¶
- acp_observations.go
- agent_activity.go
- agent_catalog.go
- agent_definitions.go
- agent_draft.go
- agent_instances.go
- agent_memory.go
- agent_notify.go
- agent_observe_payloads.go
- agent_runtime.go
- agent_session.go
- agent_skill_reviews.go
- agent_tasks.go
- agents.go
- agents_normalize.go
- agents_security.go
- app_tokens.go
- attention_notifications.go
- authored_context.go
- authored_context_heartbeat.go
- authored_context_helpers.go
- authored_context_mapping.go
- authored_context_revision.go
- authored_context_validation.go
- automation.go
- clarify.go
- cmd_palette.go
- cost.go
- diagnostics.go
- drain.go
- extension_authoring.go
- extension_enablement.go
- extension_install_preview.go
- extensions.go
- extensions_search.go
- fs.go
- gateway.go
- generic_error_payload.go
- goal_enums.go
- goals.go
- heartbeat_sources.go
- hook_payloads.go
- json_safety.go
- loop_catalog.go
- loop_definition.go
- loop_enums.go
- loop_lifecycle.go
- loop_nodes.go
- loop_provenance.go
- loop_reads.go
- loop_requests.go
- loop_runs.go
- loop_timetravel.go
- loop_watch_events.go
- loops.go
- loops_input_defaults.go
- loops_runtime.go
- marketplace.go
- marketplace_sources.go
- model_catalog.go
- observe_overview.go
- onboarding.go
- openai_compat_payloads.go
- pagination.go
- permission_rollup.go
- profiles.go
- project_changes.go
- project_files.go
- project_search.go
- prompt.go
- prompt_attachment.go
- prompt_input.go
- prompt_origin.go
- prompt_runtime_selection.go
- provider_runtime.go
- provider_usage.go
- providers.go
- reasoning.go
- resources.go
- responses.go
- roles.go
- runtime_identity.go
- scheduler.go
- scheduler_counters.go
- session_attachment.go
- session_attention.go
- session_catalog.go
- session_commands.go
- session_compact.go
- session_context.go
- session_derive.go
- session_environment.go
- session_event_payloads.go
- session_files.go
- session_input_clear.go
- session_later.go
- session_layout.go
- session_lineage.go
- session_linked_work.go
- session_monitors.go
- session_owner.go
- session_processes.go
- session_prompt_cancel.go
- session_pull_request.go
- session_rewind.go
- session_runtime_payloads.go
- session_stop.go
- session_transcript.go
- session_usage.go
- session_worktree_binding.go
- settings.go
- settings_attention.go
- settings_cmd_palette.go
- settings_collection_payloads.go
- settings_config_payloads.go
- settings_marketplace.go
- settings_mcp_auth.go
- settings_mutations.go
- settings_provider_models.go
- settings_provider_usage.go
- settings_response_meta.go
- settings_shell.go
- settings_skill_source_status.go
- settings_skill_sources.go
- settings_source_payloads.go
- settings_terminal_payload.go
- settings_window_manager.go
- skill_diagnostics.go
- skill_payloads.go
- speed.go
- status.go
- strict_json.go
- subagents.go
- support.go
- task_catalog.go
- task_catalog_validation.go
- task_query_error.go
- task_run_operational_summary.go
- task_run_payloads.go
- tasks.go
- tasks_dashboard.go
- tasks_requests.go
- tasks_run_requests.go
- terminal.go
- terminal_enums.go
- terminal_errors.go
- terminal_projection_enums.go
- terminal_sequence.go
- tool_approval_grants.go
- tools.go
- vault.go
- windowmanager_command_payloads.go
- windowmanager_commands.go
- windowmanager_conversions.go
- windowmanager_layout.go
- windowmanager_stream.go
- windowmanager_types.go
- workspace_layout.go
- workspace_payloads.go
- worktree_exit.go
- worktrees.go