core

package
v0.3.0-beta.2 Latest Latest
Warning

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

Go to latest
Published: Jul 29, 2026 License: MIT Imports: 84 Imported by: 0

Documentation

Overview

Package core provides the shared transport-facing API layer used by HTTP and UDS bindings.

Index

Constants

View Source
const (
	// WebhookTimestampHeader is the required HTTP header that carries the
	// signed webhook timestamp.
	WebhookTimestampHeader = "X-Compozy-Webhook-Timestamp"
	// WebhookSignatureHeader is the required HTTP header that carries the HMAC
	// signature for webhook delivery.
	WebhookSignatureHeader = "X-Compozy-Webhook-Signature"
	// WebhookDeliveryIDHeader identifies one webhook delivery so replayed
	// requests can be rejected inside the trigger engine.
	WebhookDeliveryIDHeader = "X-Compozy-Webhook-Delivery-ID"
)

Variables

View Source
var (
	ErrMarketplaceValidation  = errors.New("marketplace: validation error")
	ErrMarketplaceNotFound    = errors.New("marketplace: not found")
	ErrMarketplaceUnavailable = errors.New("marketplace: service unavailable")
)
View Source
var (
	// ErrMemoryRejected marks controller rejections that should surface as 422.
	ErrMemoryRejected = errors.New("memory rejected")
	// ErrMemoryUnsupported marks registered Slice 1 routes whose backing runtime
	// service is intentionally not wired yet.
	ErrMemoryUnsupported = errors.New("memory operation unsupported")
)
View Source
var (
	// ErrSettingsValidation is the sentinel for settings request validation failures.
	ErrSettingsValidation = errors.New("settings validation error")
	// ErrSettingsNotFound is the sentinel for missing settings resources.
	ErrSettingsNotFound = errors.New("settings not found")
	// ErrSettingsConflict is the sentinel for conflicting settings mutations or scope combinations.
	ErrSettingsConflict = errors.New("settings conflict")
	// ErrSettingsForbidden is the sentinel for settings operations rejected by transport policy.
	ErrSettingsForbidden = errors.New("settings forbidden")
)
View Source
var ErrAutomationValidation = errors.New("automation validation error")

ErrAutomationValidation is the sentinel for automation request validation failures.

View Source
var ErrBridgeCatalogObserverUnavailable = errors.New("bridge catalog observer is not configured")

ErrBridgeCatalogObserverUnavailable reports a missing bounded bridge catalog projection.

View Source
var ErrLoopVersionConflict = errors.New("loop version conflict")

ErrLoopVersionConflict reports a failed expected_version compare-and-swap.

View Source
var ErrModelCatalogUnavailable = errors.New("model catalog service unavailable")

ErrModelCatalogUnavailable reports that the daemon model catalog surface is not configured.

View Source
var ErrModelCatalogValidation = errors.New("model catalog validation error")

ErrModelCatalogValidation is the sentinel for malformed model catalog requests.

View Source
var ErrNetworkValidation = errors.New("network validation error")

ErrNetworkValidation is the sentinel for malformed network control-plane requests.

View Source
var ErrRequestBodyTooLarge = errors.New("request body too large")

ErrRequestBodyTooLarge is the shared transport sentinel for request bodies rejected by HTTP MaxBytesReader enforcement.

View Source
var ErrSkillNotFound = errors.New("skill not found")

ErrSkillNotFound is the sentinel for a missing skill.

View Source
var ErrSkillUnprocessable = errors.New("skill unprocessable")

ErrSkillUnprocessable is the sentinel for semantically invalid skill layers.

View Source
var ErrSkillValidation = errors.New("skill validation error")

ErrSkillValidation is the sentinel for skill request validation failures.

View Source
var ErrUnknownJSONField = errors.New("unknown_field")

ErrUnknownJSONField identifies request fields that are absent from the public contract.

Functions

func ACPCapsPayloadFromInfo

func ACPCapsPayloadFromInfo(caps acp.Caps) *contract.ACPCapsPayload

ACPCapsPayloadFromInfo converts ACP capability info into the shared payload.

func AcceptedPromptStreamTurnID

func AcceptedPromptStreamTurnID(result session.SendPromptResult) (string, error)

func AgentEventPayloadFromEvent

func AgentEventPayloadFromEvent(event acp.AgentEvent) contract.AgentEventPayload

AgentEventPayloadFromEvent converts an agent event into the shared raw-stream payload.

func AgentPayloadFromDef

func AgentPayloadFromDef(agent compozyconfig.AgentDef) contract.AgentPayload

AgentPayloadFromDef converts an agent definition into the shared payload.

func AgentPayloadFromDiagnostic

func AgentPayloadFromDiagnostic(
	diagnostic workspacepkg.AgentDiagnostic,
	workspaceID ...string,
) contract.AgentPayload

AgentPayloadFromDiagnostic converts a malformed workspace agent diagnostic into a payload row.

func AgentPayloadFromEntry

func AgentPayloadFromEntry(entry AgentCatalogEntry) contract.AgentPayload

AgentPayloadFromEntry converts an origin-aware catalog entry into the shared payload.

func AgentPayloadFromEntryWithConfig

func AgentPayloadFromEntryWithConfig(
	entry AgentCatalogEntry,
	cfg *compozyconfig.Config,
) contract.AgentPayload

AgentPayloadFromEntryWithConfig attaches a runtime projection resolved from the requested workspace/global config without mutating authored fields.

func AgentPayloadsFromEntries

func AgentPayloadsFromEntries(entries []AgentCatalogEntry) []contract.AgentPayload

AgentPayloadsFromEntries converts origin-aware catalog entries into response payloads.

func AgentProbeHealthPayloadsFromACP

func AgentProbeHealthPayloadsFromACP(probes []acp.ProbeResult) []contract.AgentProbeHealthPayload

AgentProbeHealthPayloadsFromACP converts downstream ACP probe results into the shared health payload.

func AgentTaskClaimPayloadFromResult

func AgentTaskClaimPayloadFromResult(result *taskpkg.ClaimResult) contract.AgentTaskClaimPayload

AgentTaskClaimPayloadFromResult builds the public, redacted claim payload.

func AgentTaskLeasePayloadFromRun

func AgentTaskLeasePayloadFromRun(
	run *taskpkg.Run,
	channel *contract.CoordinationChannelPayload,
) contract.TaskRunLeaseSummaryPayload

AgentTaskLeasePayloadFromRun builds the public, redacted lease payload.

func ApplyAutomationJobPatch

func ApplyAutomationJobPatch(
	current automationpkg.Job,
	req contract.UpdateJobRequest,
) (automationpkg.Job, error)

ApplyAutomationJobPatch applies the shared patch payload to an automation job model.

func ApplyAutomationTriggerPatch

func ApplyAutomationTriggerPatch(
	current automationpkg.Trigger,
	req contract.UpdateTriggerRequest,
) (automationpkg.Trigger, error)

ApplyAutomationTriggerPatch applies the shared patch payload to an automation trigger model.

func AutomationHealthPayloadFromStatus

func AutomationHealthPayloadFromStatus(
	enabled bool,
	status automationpkg.ManagerStatus,
) contract.AutomationHealthPayload

AutomationHealthPayloadFromStatus converts manager status into the shared additive automation health block.

func AutomationJobFromCreateRequest

func AutomationJobFromCreateRequest(req contract.CreateJobRequest) (automationpkg.Job, error)

AutomationJobFromCreateRequest converts the shared create payload into the canonical automation job model.

func AutomationSchedulerStatePayloadFromState

func AutomationSchedulerStatePayloadFromState(
	state automationpkg.ScheduledJobState,
) contract.AutomationSchedulerStatePayload

AutomationSchedulerStatePayloadFromState converts durable scheduler metadata into the shared response payload.

func AutomationSchedulerStatePayloadsFromStates

func AutomationSchedulerStatePayloadsFromStates(
	states []automationpkg.ScheduledJobState,
) []contract.AutomationSchedulerStatePayload

AutomationSchedulerStatePayloadsFromStates converts scheduler states into response payloads.

func AutomationSuggestionPayloadFromSuggestion

func AutomationSuggestionPayloadFromSuggestion(
	suggestion automationpkg.Suggestion,
) contract.AutomationSuggestionPayload

AutomationSuggestionPayloadFromSuggestion converts one domain suggestion to its shared payload.

func AutomationSuggestionPayloadsFromSuggestions

func AutomationSuggestionPayloadsFromSuggestions(
	suggestions []automationpkg.Suggestion,
) []contract.AutomationSuggestionPayload

AutomationSuggestionPayloadsFromSuggestions converts domain suggestions to shared payloads.

func AutomationTriggerFromCreateRequest

func AutomationTriggerFromCreateRequest(req contract.CreateTriggerRequest) automationpkg.Trigger

AutomationTriggerFromCreateRequest converts the shared create payload into the canonical automation trigger model.

func BridgeAggregateHealthPayloadFromObserve

func BridgeAggregateHealthPayloadFromObserve(
	summary observepkg.BridgeAggregateHealth,
) contract.BridgeAggregateHealthPayload

BridgeAggregateHealthPayloadFromObserve converts the observer bridge summary into the shared payload.

func BridgeHealthPayloadFromObserve

func BridgeHealthPayloadFromObserve(health observepkg.BridgeInstanceHealth) contract.BridgeHealthPayload

BridgeHealthPayloadFromObserve converts the observer per-instance bridge health snapshot into the shared payload.

func BridgePayloadFromBridgeInstance

func BridgePayloadFromBridgeInstance(instance bridgepkg.BridgeInstance) contract.BridgePayload

BridgePayloadFromBridgeInstance converts the daemon-owned bridge record into the shared bridge-management payload exposed by transports and OpenAPI.

func BridgeProviderPayloadFromBridgeProvider

func BridgeProviderPayloadFromBridgeProvider(provider bridgepkg.BridgeProvider) contract.BridgeProviderPayload

BridgeProviderPayloadFromBridgeProvider converts installed provider metadata into the shared bridge-management provider catalog payload.

func BulkForceTaskRunResponseFromResult

func BulkForceTaskRunResponseFromResult(
	result taskpkg.BulkForceRunResult,
	maskInternalErrors bool,
) contract.BulkForceTaskRunResponse

BulkForceTaskRunResponseFromResult converts per-row bulk force outcomes into shared payloads.

func BundleCatalogPayloads

func BundleCatalogPayloads(items []bundlepkg.CatalogEntry) []contract.BundleCatalogPayload

func ConfigApplyRecordsResponseFromRecords

func ConfigApplyRecordsResponseFromRecords(
	records []settingspkg.ApplyRecord,
) contract.ConfigApplyRecordsResponse

ConfigApplyRecordsResponseFromRecords converts apply history rows into the public payload.

func CoordinatorConfigPayloadFromConfig

func CoordinatorConfigPayloadFromConfig(
	cfg compozyconfig.ResolvedCoordinatorRole,
	source contract.CoordinatorConfigSource,
	workspaceID string,
) contract.CoordinatorConfigPayload

CoordinatorConfigPayloadFromConfig converts resolved coordinator config into a safe read model.

func CreateAgentFromRequest

func CreateAgentFromRequest(
	ctx context.Context,
	req contract.CreateAgentRequest,
	homePaths compozyconfig.HomePaths,
	globalConfig *compozyconfig.Config,
	workspaces WorkspaceService,
	transportName string,
) (compozyconfig.AgentDef, compozyconfig.Config, error)

CreateAgentFromRequest validates and persists one AGENT.md definition from a shared create-agent request. It is the single authoring path reused by the HTTP handler and the compozy__agent_create native tool.

func DeliverPromptEventStream

func DeliverPromptEventStream(
	ctx context.Context,
	shutdown <-chan struct{},
	events <-chan acp.AgentEvent,
	cancel context.CancelFunc,
	encoder *PromptStreamEncoder,
	writer FlushWriter,
)

DeliverPromptEventStream forwards one accepted prompt until the client, daemon, provider, or stream encoder closes the delivery path.

func ErrorPayloadForError

func ErrorPayloadForError(err error) contract.ErrorPayload

ErrorPayloadForError builds a redacted error payload for stream frames and other non-status envelopes.

func ErrorPayloadForStatus

func ErrorPayloadForStatus(status int, err error, maskInternalErrors bool) contract.ErrorPayload

ErrorPayloadForStatus builds a redacted HTTP/UDS error payload for status.

func ExtensionStatusCode

func ExtensionStatusCode(err error) int

ExtensionStatusCode maps extension-domain errors onto transport status codes.

func GoalCommandHTTPStatus

func GoalCommandHTTPStatus(result contract.GoalCommandResult) int

GoalCommandHTTPStatus returns the closed transport status for one valid Goal result.

func GoalCommandResultPayloadFromSession

func GoalCommandResultPayloadFromSession(result *session.GoalCommandResult) (contract.GoalCommandResult, error)

GoalCommandResultPayloadFromSession maps and validates one structured Goal command result.

func GoalSnapshotPayloadFromSession

func GoalSnapshotPayloadFromSession(snapshot *session.GoalSnapshot) (*contract.GoalSnapshot, error)

GoalSnapshotPayloadFromSession maps the session-domain projection to the canonical public contract.

func GoalTurnPagePayloadFromSession

func GoalTurnPagePayloadFromSession(page session.GoalTurnPage) (contract.GoalTurnPage, error)

GoalTurnPagePayloadFromSession maps a session-domain audit page to the canonical public contract.

func HookCatalogPayloadsFromEntries

func HookCatalogPayloadsFromEntries(entries []hookspkg.CatalogEntry) []contract.HookCatalogPayload

HookCatalogPayloadsFromEntries converts resolved hook catalog entries into transport DTOs.

func HookEventPayloadsFromDescriptors

func HookEventPayloadsFromDescriptors(events []hookspkg.EventDescriptor) []contract.HookEventPayload

HookEventPayloadsFromDescriptors converts hook taxonomy descriptors into transport DTOs.

func HookRunPayloadsFromRecords

func HookRunPayloadsFromRecords(records []hookspkg.HookRunRecord) []contract.HookRunPayload

HookRunPayloadsFromRecords converts persisted hook audit records into transport DTOs.

func JobPayloadFromJob

func JobPayloadFromJob(
	job automationpkg.Job,
	nextRun *time.Time,
	schedulerState *contract.AutomationSchedulerStatePayload,
) contract.JobPayload

JobPayloadFromJob converts an automation job into the shared response payload, optionally enriching it with scheduler next-run metadata.

func JobPayloadsFromJobs

func JobPayloadsFromJobs(
	jobs []automationpkg.Job,
	schedulerStateByID map[string]contract.AutomationSchedulerStatePayload,
) []contract.JobPayload

JobPayloadsFromJobs converts a slice of jobs into response payloads using the supplied next-run map.

func LogEventAfterCursor

func LogEventAfterCursor(event store.EventSummary, cursor LogsCursor) bool

LogEventAfterCursor reports whether a log event should be emitted after the cursor.

func LogEventID

func LogEventID(event store.EventSummary) string

LogEventID builds a stable Last-Event-ID value for logs streaming.

func LogEventPayloadFromSummary

func LogEventPayloadFromSummary(event store.EventSummary) contract.LogEventPayload

LogEventPayloadFromSummary converts an event summary into the shared logs payload.

func MemoryDecisionPayload

func MemoryDecisionPayload(
	decision memcontract.Decision,
	appliedAt *time.Time,
) contract.MemoryDecisionPayload

MemoryDecisionPayload converts a controller decision into its redaction-safe public form.

func MemoryDecisionRecordPayload

func MemoryDecisionRecordPayload(record memory.DecisionRecord) contract.MemoryDecisionPayload

func MemoryOperationHistoryPayloads

func MemoryOperationHistoryPayloads(records []memcontract.OperationRecord) []contract.MemoryOperationHistoryPayload

MemoryOperationHistoryPayloads converts domain operation records into Memory v2 DTOs.

func MemoryOperationPayloads

func MemoryOperationPayloads(records []memcontract.OperationRecord) []contract.MemoryOperationPayload

MemoryOperationPayloads converts domain operation records into API DTOs.

func MemorySummaryPayloadFromHeader

func MemorySummaryPayloadFromHeader(header memcontract.Header) contract.MemoryEntrySummaryPayload

MemorySummaryPayloadFromHeader converts one resolved memory header for public transports.

func NetworkChannelPayloads

func NetworkChannelPayloads(
	ctx context.Context,
	service NetworkService,
	sessionsManager SessionManager,
	networkStore NetworkStore,
	workspaceID string,
) ([]contract.NetworkChannelPayload, error)

NetworkChannelPayloads builds the shared runtime channel projection used by transports and tools.

func NetworkChannelPayloadsFromInfos

func NetworkChannelPayloadsFromInfos(channels []network.ChannelInfo) []contract.NetworkChannelPayload

NetworkChannelPayloadsFromInfos converts active channel summaries into shared payloads.

func NetworkConversationMessagePayloadFromEntry

func NetworkConversationMessagePayloadFromEntry(
	entry store.NetworkMessageEntry,
	sessionsByID map[string]*session.Info,
	peersByID map[string]network.PeerInfo,
) contract.NetworkConversationMessagePayload

NetworkConversationMessagePayloadFromEntry converts one persisted timeline row into the shared payload.

func NetworkConversationMessagePayloadFromStore

func NetworkConversationMessagePayloadFromStore(
	message store.NetworkConversationMessage,
) contract.NetworkConversationMessagePayload

NetworkConversationMessagePayloadFromStore converts one stored message into a public payload.

func NetworkConversationMessagePayloadFromView

func NetworkConversationMessagePayloadFromView(
	view networkTimelineMessageView,
	sessionsByID map[string]*session.Info,
	peersByID map[string]network.PeerInfo,
) contract.NetworkConversationMessagePayload

func NetworkConversationMessagePayloadsFromStore

func NetworkConversationMessagePayloadsFromStore(
	messages []store.NetworkConversationMessage,
) []contract.NetworkConversationMessagePayload

NetworkConversationMessagePayloadsFromStore converts stored messages into public payloads.

func NetworkCoordinationCostPayloadFromStore

func NetworkCoordinationCostPayloadFromStore(
	thread store.NetworkThreadSummary,
) *contract.NetworkCoordinationCostPayload

NetworkCoordinationCostPayloadFromStore converts stored thread cost counters into public payloads.

func NetworkDirectRoomPayloadFromStore

func NetworkDirectRoomPayloadFromStore(direct store.NetworkDirectRoomSummary) contract.NetworkDirectRoomPayload

NetworkDirectRoomPayloadFromStore converts one stored direct-room summary into a public payload.

func NetworkDirectRoomPayloadsFromStore

func NetworkDirectRoomPayloadsFromStore(
	directs []store.NetworkDirectRoomSummary,
) []contract.NetworkDirectRoomPayload

NetworkDirectRoomPayloadsFromStore converts stored direct rooms into public payloads.

func NetworkEnvelopePayloadFromEnvelope

func NetworkEnvelopePayloadFromEnvelope(envelope network.Envelope) contract.NetworkEnvelopePayload

NetworkEnvelopePayloadFromEnvelope converts one surfaced envelope into the shared payload.

func NetworkEnvelopePayloadsFromEnvelopes

func NetworkEnvelopePayloadsFromEnvelopes(envelopes []network.Envelope) []contract.NetworkEnvelopePayload

NetworkEnvelopePayloadsFromEnvelopes converts surfaced envelopes into shared payloads.

func NetworkPeerDetailPayloadFromInfo

func NetworkPeerDetailPayloadFromInfo(
	peer network.PeerInfo,
	sessionsByID map[string]*session.Info,
	metrics contract.NetworkPeerMetricsPayload,
) contract.NetworkPeerDetailPayload

NetworkPeerDetailPayloadFromInfo converts one peer info plus metrics into the shared detail payload.

func NetworkPeerPayloadFromInfo

func NetworkPeerPayloadFromInfo(peer network.PeerInfo) contract.NetworkPeerPayload

NetworkPeerPayloadFromInfo converts one visible peer snapshot into the shared payload.

func NetworkPeerPayloadsFromInfos

func NetworkPeerPayloadsFromInfos(peers []network.PeerInfo) []contract.NetworkPeerPayload

NetworkPeerPayloadsFromInfos converts the visible peer snapshot into shared payloads.

func NetworkSendPayloadFromRequest

func NetworkSendPayloadFromRequest(id string, req contract.NetworkSendRequest) contract.NetworkSendPayload

NetworkSendPayloadFromRequest builds the shared send response payload from the original request plus the assigned message id.

func NetworkSendRequestFromPayload

func NetworkSendRequestFromPayload(req contract.NetworkSendRequest) (network.SendRequest, error)

NetworkSendRequestFromPayload validates and converts one shared send payload into the runtime request.

func NetworkStatusPayloadFromStatus

func NetworkStatusPayloadFromStatus(status *network.Status) *contract.NetworkStatusPayload

NetworkStatusPayloadFromStatus converts the runtime network status snapshot into the shared payload.

func NetworkSubscriptionPayloadFromStore

func NetworkSubscriptionPayloadFromStore(
	subscription store.NetworkSubscriptionEntry,
) contract.NetworkSubscriptionPayload

NetworkSubscriptionPayloadFromStore converts one delivery preference into a public payload.

func NetworkSubscriptionPayloadsFromStore

func NetworkSubscriptionPayloadsFromStore(
	subscriptions []store.NetworkSubscriptionEntry,
) []contract.NetworkSubscriptionPayload

NetworkSubscriptionPayloadsFromStore converts delivery preferences into public payloads.

func NetworkTaskThreadOriginPayloadFromStore

func NetworkTaskThreadOriginPayloadFromStore(
	origin store.NetworkTaskThreadOrigin,
) contract.NetworkTaskThreadOriginPayload

NetworkTaskThreadOriginPayloadFromStore converts one promoted-task origin link into a public payload.

func NetworkTaskThreadOriginPayloadsFromStore

func NetworkTaskThreadOriginPayloadsFromStore(
	origins []store.NetworkTaskThreadOrigin,
) []contract.NetworkTaskThreadOriginPayload

NetworkTaskThreadOriginPayloadsFromStore converts promoted-task origin links into public payloads.

func NetworkThreadSessionCostPayloadFromStore

func NetworkThreadSessionCostPayloadFromStore(
	stat store.NetworkThreadSessionTokenStats,
) contract.NetworkThreadSessionCostPayload

NetworkThreadSessionCostPayloadFromStore converts one stored thread session cost row into a public payload.

func NetworkThreadSessionCostPayloadsFromStore

func NetworkThreadSessionCostPayloadsFromStore(
	stats []store.NetworkThreadSessionTokenStats,
) []contract.NetworkThreadSessionCostPayload

NetworkThreadSessionCostPayloadsFromStore converts stored thread session cost rows into public payloads.

func NetworkThreadSummaryPayloadFromStore

func NetworkThreadSummaryPayloadFromStore(thread store.NetworkThreadSummary) contract.NetworkThreadSummaryPayload

NetworkThreadSummaryPayloadFromStore converts one stored thread summary into a public payload.

func NetworkThreadSummaryPayloadsFromStore

func NetworkThreadSummaryPayloadsFromStore(
	threads []store.NetworkThreadSummary,
) []contract.NetworkThreadSummaryPayload

NetworkThreadSummaryPayloadsFromStore converts stored thread summaries into public payloads.

func NetworkUsageResponseFromReport

func NetworkUsageResponseFromReport(
	workspaceID string,
	report store.NetworkUsageReport,
) (contract.NetworkUsageResponse, error)

NetworkUsageResponseFromReport delegates every public adapter to one response projection.

func NetworkWorkPayloadFromStore

func NetworkWorkPayloadFromStore(work store.NetworkWorkEntry) contract.NetworkWorkPayload

NetworkWorkPayloadFromStore converts one network work row into a public payload.

func NewAutomationValidationError

func NewAutomationValidationError(err error) error

NewAutomationValidationError wraps an automation validation failure with the shared sentinel.

func NewMemoryValidationError

func NewMemoryValidationError(err error) error

NewMemoryValidationError wraps a memory validation failure with the shared sentinel.

func NewModelCatalogValidationError

func NewModelCatalogValidationError(err error) error

NewModelCatalogValidationError wraps a model catalog request validation failure.

func NewNetworkValidationError

func NewNetworkValidationError(err error) error

NewNetworkValidationError wraps a network request validation failure with the shared sentinel.

func NewSettingsConflictError

func NewSettingsConflictError(err error) error

NewSettingsConflictError wraps a settings conflict with the shared sentinel.

func NewSettingsForbiddenError

func NewSettingsForbiddenError(err error) error

NewSettingsForbiddenError wraps a settings forbidden failure with the shared sentinel.

func NewSettingsNotFoundError

func NewSettingsNotFoundError(err error) error

NewSettingsNotFoundError wraps a missing settings resource failure with the shared sentinel.

func NewSettingsValidationError

func NewSettingsValidationError(err error) error

NewSettingsValidationError wraps a settings validation failure with the shared sentinel.

func NewTaskValidationError

func NewTaskValidationError(err error) error

NewTaskValidationError wraps a task validation failure with the shared sentinel.

func ObserveFailureHealthPayloadFromHealth

func ObserveFailureHealthPayloadFromHealth(
	health observepkg.FailureHealth,
) contract.ObserveFailureHealthPayload

ObserveFailureHealthPayloadFromHealth converts lifecycle failure health into the shared payload.

func ObserveHealthPayloadFromHealth

func ObserveHealthPayloadFromHealth(health *observepkg.Health) contract.ObserveHealthPayload

ObserveHealthPayloadFromHealth converts the observer health snapshot into the shared payload.

func ObserveOverviewPayloadFromView

func ObserveOverviewPayloadFromView(view *observe.OverviewView) contract.ObserveOverviewPayload

ObserveOverviewPayloadFromView converts the observe read model into the shared payload.

func ObservePersistenceHealthPayloadFromHealth

func ObservePersistenceHealthPayloadFromHealth(
	health observepkg.PersistenceHealth,
) contract.ObservePersistenceHealthPayload

ObservePersistenceHealthPayloadFromHealth converts persistence health into the shared payload.

func ObserveRetentionHealthPayloadFromHealth

func ObserveRetentionHealthPayloadFromHealth(
	health observepkg.RetentionHealth,
) contract.ObserveRetentionHealthPayload

ObserveRetentionHealthPayloadFromHealth converts retention health into the shared payload.

func OpenAIModelListPayloadFromModels

func OpenAIModelListPayloadFromModels(models []modelcatalog.Model) contract.OpenAIModelListResponse

func OpenAIModelPayloadFromModel

func OpenAIModelPayloadFromModel(model modelcatalog.Model) contract.OpenAIModelPayload

func ParseAutomationJobListQuery

func ParseAutomationJobListQuery(c *gin.Context) (automationpkg.JobListQuery, error)

ParseAutomationJobListQuery parses the shared automation job list filters.

func ParseAutomationRunQuery

func ParseAutomationRunQuery(c *gin.Context) (automationpkg.RunQuery, error)

ParseAutomationRunQuery parses the shared automation run list filters.

func ParseAutomationTriggerListQuery

func ParseAutomationTriggerListQuery(c *gin.Context) (automationpkg.TriggerListQuery, error)

ParseAutomationTriggerListQuery parses the shared automation trigger list filters.

func ParseHookCatalogFilter

func ParseHookCatalogFilter(c *gin.Context) (hookspkg.CatalogFilter, error)

ParseHookCatalogFilter parses the shared hook catalog query parameters.

func ParseHookEventFilter

func ParseHookEventFilter(c *gin.Context) (hookspkg.EventFilter, error)

ParseHookEventFilter parses the shared hook taxonomy query parameters.

func ParseHookRunsQuery

func ParseHookRunsQuery(c *gin.Context) (store.HookRunQuery, error)

ParseHookRunsQuery parses the shared hook execution history query parameters.

func ParseLogsQuery

func ParseLogsQuery(c *gin.Context) (store.EventSummaryQuery, error)

ParseLogsQuery parses the shared logs query parameters.

func ParseLoopCatalogQuery

func ParseLoopCatalogQuery(c *gin.Context) (looppkg.CatalogQuery, error)

ParseLoopCatalogQuery parses the shared HTTP/UDS catalog filters.

func ParseNetworkUsageQuery

func ParseNetworkUsageQuery(workspaceID string, values url.Values) (store.NetworkUsageQuery, error)

ParseNetworkUsageQuery delegates every public adapter to one strict query contract.

func ParseOptionalBool

func ParseOptionalBool(raw string) (bool, error)

ParseOptionalBool parses an optional boolean query value.

func ParseOptionalInt

func ParseOptionalInt(raw string) (int, error)

ParseOptionalInt parses an optional integer query value.

func ParseOptionalInt64

func ParseOptionalInt64(raw string) (int64, error)

ParseOptionalInt64 parses an optional 64-bit integer query value.

func ParseOptionalMemoryScope

func ParseOptionalMemoryScope(raw string) (memcontract.Scope, error)

ParseOptionalMemoryScope validates an optional memory scope value.

func ParseOptionalTime

func ParseOptionalTime(raw string) (time.Time, error)

ParseOptionalTime parses an optional RFC3339 or RFC3339Nano timestamp.

func ParseResourceFilter

func ParseResourceFilter(c *gin.Context) (resources.ResourceFilter, error)

ParseResourceFilter parses the shared `/api/resources` list filters.

func ParseSessionEventQuery

func ParseSessionEventQuery(c *gin.Context) (store.EventQuery, error)

ParseSessionEventQuery parses the shared session event query parameters.

func ParseTaskDashboardQuery

func ParseTaskDashboardQuery(c *gin.Context) (contract.TaskDashboardQuery, error)

ParseTaskDashboardQuery parses the shared task dashboard query parameters.

func ParseTaskInboxQuery

func ParseTaskInboxQuery(c *gin.Context) (contract.TaskInboxQuery, error)

ParseTaskInboxQuery parses the bounded actor-scoped inbox query parameters.

func ParseTaskListQuery

func ParseTaskListQuery(c *gin.Context) (contract.TaskListQuery, error)

ParseTaskListQuery parses the bounded task catalog query parameters.

func ParseTaskRunListQuery

func ParseTaskRunListQuery(c *gin.Context) (contract.TaskRunListQuery, error)

ParseTaskRunListQuery parses the shared task-run list query parameters.

func ParseTaskStreamQuery

func ParseTaskStreamQuery(c *gin.Context) (contract.TaskStreamQuery, error)

ParseTaskStreamQuery parses the shared task stream query parameters.

func ParseTaskTimelineQuery

func ParseTaskTimelineQuery(c *gin.Context) (contract.TaskTimelineQuery, error)

ParseTaskTimelineQuery parses the shared task timeline query parameters.

func PayloadJSON

func PayloadJSON(raw string) json.RawMessage

PayloadJSON coerces raw strings into valid JSON response bodies.

func PromptResponseFromSession

func PromptResponseFromSession(result session.SendPromptResult) (int, any, error)

PromptResponseFromSession selects the direct Goal body or ordinary prompt wrapper and status.

func PromptResultPayloadFromSession

func PromptResultPayloadFromSession(result session.SendPromptResult) (contract.SendPromptResultPayload, error)

PromptResultPayloadFromSession converts runtime prompt admission state into the shared DTO.

func ProviderModelListPayloadFromModels

func ProviderModelListPayloadFromModels(models []modelcatalog.Model) contract.ProviderModelListResponse

func ProviderModelPayloadFromModel

func ProviderModelPayloadFromModel(model modelcatalog.Model) contract.ProviderModelPayload

func ResolveMemoryWorkspace

func ResolveMemoryWorkspace(raw string) (string, error)

ResolveMemoryWorkspace validates and canonicalizes a workspace memory location.

func ResolveMemoryWriteScope

func ResolveMemoryWriteScope(req contract.MemoryWriteRequest) (memcontract.Scope, string, error)

ResolveMemoryWriteScope validates a write request and infers its target scope.

func ResourceRecordPayloadFromRaw

func ResourceRecordPayloadFromRaw(record resources.RawRecord) contract.ResourceRecordPayload

ResourceRecordPayloadFromRaw converts one raw resource record into a shared transport DTO.

func ResourceRecordPayloadsFromRaw

func ResourceRecordPayloadsFromRaw(records []resources.RawRecord) []contract.ResourceRecordPayload

ResourceRecordPayloadsFromRaw converts raw resource records into shared transport DTOs.

func RespondError

func RespondError(c *gin.Context, status int, err error, maskInternalErrors bool)

RespondError writes a transport error response, optionally masking internal error details.

func RespondOpenAIError

func RespondOpenAIError(c *gin.Context, status int, err error, maskInternalErrors bool)

RespondOpenAIError writes an OpenAI-compatible error response envelope.

func RespondPromptResult

func RespondPromptResult(c *gin.Context, result session.SendPromptResult, maskInternal bool) bool

RespondPromptResult writes one validated non-streaming prompt or Goal response.

func RespondToolError

func RespondToolError(c *gin.Context, err error, maskInternal bool)

RespondToolError serializes stable tool errors without backend error text.

func RetryTaskRunResponseFromResult

func RetryTaskRunResponseFromResult(result *taskpkg.RetryRunResult) contract.RetryTaskRunResponse

RetryTaskRunResponseFromResult converts one retry result into the shared payload.

func RunPayloadFromRun

func RunPayloadFromRun(run automationpkg.Run) contract.RunPayload

RunPayloadFromRun converts an automation run into the shared response payload.

func RunPayloadsFromRuns

func RunPayloadsFromRuns(runs []automationpkg.Run) []contract.RunPayload

RunPayloadsFromRuns converts a slice of runs into response payloads.

func RuntimeActivityPayloadFromSessionMeta

func RuntimeActivityPayloadFromSessionMeta(
	liveness *store.SessionLivenessMeta,
	now time.Time,
) *contract.RuntimeActivityPayload

RuntimeActivityPayloadFromSessionMeta converts persisted session activity metadata into the shared payload.

func SchedulerBacklogPayloadFromDomain

func SchedulerBacklogPayloadFromDomain(backlog taskpkg.SchedulerBacklog) contract.SchedulerBacklogPayload

SchedulerBacklogPayloadFromDomain exposes effective pause state without leaking store rows.

func SchedulerDrainResponseFromDomain

func SchedulerDrainResponseFromDomain(result taskpkg.SchedulerDrainResult) contract.SchedulerDrainResponse

SchedulerDrainResponseFromDomain preserves drain result semantics across HTTP and UDS.

func SchedulerStatusPayloadFromDomain

func SchedulerStatusPayloadFromDomain(status taskpkg.SchedulerStatus) contract.SchedulerStatusPayload

SchedulerStatusPayloadFromDomain keeps transports on one scheduler DTO shape.

func SessionActivityHealthPayloadsFromObserve

func SessionActivityHealthPayloadsFromObserve(
	activities []observepkg.SessionActivityHealth,
) []contract.SessionActivityHealthPayload

SessionActivityHealthPayloadsFromObserve converts observer activity health rows into the shared health response payload.

func SessionConfigOptionPayloadsFromInfo

func SessionConfigOptionPayloadsFromInfo(options []acp.SessionConfigOption) []contract.SessionConfigOptionPayload

SessionConfigOptionPayloadsFromInfo converts active ACP config options into the shared payload.

func SessionEventPayloadFromEvent

func SessionEventPayloadFromEvent(event store.SessionEvent, info *session.Info) contract.SessionEventPayload

SessionEventPayloadFromEvent converts a session event into the shared payload.

func SessionFailurePayloadFromStore

func SessionFailurePayloadFromStore(failure *store.SessionFailure) *contract.SessionFailurePayload

SessionFailurePayloadFromStore converts a stored failure diagnostic into the shared API payload.

func SessionPayloadFromInfo

func SessionPayloadFromInfo(info *session.Info) contract.SessionPayload

SessionPayloadFromInfo converts a session info snapshot into the shared session payload.

func SessionPayloadFromStoreInfo

func SessionPayloadFromStoreInfo(info store.SessionInfo) contract.SessionPayload

SessionPayloadFromStoreInfo converts the persisted session index row into the shared payload.

func SessionPayloadsForWorkspace

func SessionPayloadsForWorkspace(infos []*session.Info, workspaceID string) []contract.SessionPayload

SessionPayloadsForWorkspace filters and converts sessions for one workspace.

func SessionPayloadsFromInfos

func SessionPayloadsFromInfos(infos []*session.Info) []contract.SessionPayload

SessionPayloadsFromInfos converts a session list into response payloads.

func SessionPayloadsWithPageHealth

func SessionPayloadsWithPageHealth(
	ctx context.Context,
	infos []*session.Info,
	pageReader SessionHealthPageReader,
) ([]contract.SessionPayload, error)

SessionPayloadsWithPageHealth decorates one bounded session page from one batch health read. Callers must not fall back to per-session reads.

func SessionProviderOptionPayloadsFromConfig

func SessionProviderOptionPayloadsFromConfig(cfg *compozyconfig.Config) []contract.SessionProviderOptionPayload

SessionProviderOptionPayloadsFromConfig converts the merged workspace config into a stable, UI-ready list of visible provider options.

func SessionRepairPayloadFromResult

func SessionRepairPayloadFromResult(result *session.RepairResult) contract.SessionRepairPayload

SessionRepairPayloadFromResult converts a session repair report into the shared payload.

func SessionSandboxPayloadFromMeta

func SessionSandboxPayloadFromMeta(meta *store.SessionSandboxMeta) *contract.SessionSandboxPayload

SessionSandboxPayloadFromMeta converts session sandbox metadata into the shared payload.

func SettingsApplyResponseFromResult

func SettingsApplyResponseFromResult(result settingspkg.ApplyResult) contract.SettingsApplyResponse

SettingsApplyResponseFromResult converts one settings apply result into the public payload.

func SettingsCollectionMutationResultPayloadFromResult

func SettingsCollectionMutationResultPayloadFromResult(result settingspkg.MutationResult) (any, error)

SettingsCollectionMutationResultPayloadFromResult converts one settings collection mutation result into the shared payload.

func SettingsCollectionResponseFromEnvelope

func SettingsCollectionResponseFromEnvelope(envelope settingspkg.CollectionEnvelope) (any, error)

SettingsCollectionResponseFromEnvelope converts one settings collection envelope into the shared response payload.

func SettingsRestartActionResponseFromOperation

func SettingsRestartActionResponseFromOperation(operation SettingsRestartOperation) contract.RestartActionResponse

SettingsRestartActionResponseFromOperation converts one daemon restart operation into the action response payload.

func SettingsRestartActionStatusFromOperation

func SettingsRestartActionStatusFromOperation(operation SettingsRestartOperation) contract.RestartActionStatus

SettingsRestartActionStatusFromOperation converts one daemon restart operation into the polling payload.

func SettingsSectionMutationResultPayloadFromResult

func SettingsSectionMutationResultPayloadFromResult(result settingspkg.MutationResult) (any, error)

SettingsSectionMutationResultPayloadFromResult converts one settings section mutation result into the shared payload.

func SettingsSectionResponseFromEnvelope

func SettingsSectionResponseFromEnvelope(envelope settingspkg.SectionEnvelope) (any, error)

SettingsSectionResponseFromEnvelope converts one settings section envelope into the shared response payload.

func SettingsUpdateResponseFromStatus

func SettingsUpdateResponseFromStatus(status SettingsUpdateStatus) contract.SettingsUpdateResponse

SettingsUpdateResponseFromStatus converts the daemon-owned update snapshot into the transport payload.

func SkillDiagnosticPayloadsFromDiagnostics

func SkillDiagnosticPayloadsFromDiagnostics(
	diagnostics []skills.SkillDiagnostic,
) []contract.SkillDiagnosticPayload

SkillDiagnosticPayloadsFromDiagnostics converts skill registry diagnostics for API payloads.

func SkillMarketplaceInstallPayloadFromResult

func SkillMarketplaceInstallPayloadFromResult(
	result skillmarketplace.InstallResult,
) contract.SkillMarketplaceInstallPayload

SkillMarketplaceInstallPayloadFromResult converts an install result into the shared payload.

func SkillMarketplaceRemovePayloadFromResult

func SkillMarketplaceRemovePayloadFromResult(
	result skillmarketplace.RemoveResult,
) contract.SkillMarketplaceRemovePayload

SkillMarketplaceRemovePayloadFromResult converts a removal result into the shared payload.

func SkillMarketplaceUpdatePayloadsFromResults

func SkillMarketplaceUpdatePayloadsFromResults(
	results []skillmarketplace.UpdateResult,
) []contract.SkillMarketplaceUpdatePayload

SkillMarketplaceUpdatePayloadsFromResults converts update results into shared payloads.

func SkillPayloadFromSkill

func SkillPayloadFromSkill(skill *skills.Skill) contract.SkillPayload

SkillPayloadFromSkill converts a skills.Skill into the shared HTTP payload.

func SkillPayloadsFromSkills

func SkillPayloadsFromSkills(skillList []*skills.Skill) []contract.SkillPayload

SkillPayloadsFromSkills converts a slice of skills into response payloads.

func SkillShadowEntryPayloadFromDomain

func SkillShadowEntryPayloadFromDomain(entry skills.ShadowEntry) contract.SkillShadowEntryPayload

func SkillShadowEntryPayloadsFromDomain

func SkillShadowEntryPayloadsFromDomain(entries []skills.ShadowEntry) []contract.SkillShadowEntryPayload

func SkillShadowEntryPayloadsFromRefs

func SkillShadowEntryPayloadsFromRefs(refs []skills.SkillDefinitionRef) []contract.SkillShadowEntryPayload

func SkillShadowsResponseFromDomain

func SkillShadowsResponseFromDomain(snapshot skills.SkillShadows) contract.SkillShadowsResponse

SkillShadowsResponseFromDomain converts one resolver shadow snapshot into the shared API payload.

func SourceStatusPayloadsFromStatuses

func SourceStatusPayloadsFromStatuses(
	statuses []modelcatalog.SourceStatus,
) []contract.ModelCatalogSourceStatusPayload

func StatusForAgentIdentityError

func StatusForAgentIdentityError(err error) int

StatusForAgentIdentityError maps agent identity failures to transport statuses.

func StatusForAutomationError

func StatusForAutomationError(err error) int

StatusForAutomationError maps automation-domain failures to transport statuses.

func StatusForBridgeError

func StatusForBridgeError(err error) int

StatusForBridgeError maps bridge-domain and workspace-domain errors to transport statuses.

func StatusForBundleError

func StatusForBundleError(err error) int

func StatusForHeartbeatError

func StatusForHeartbeatError(err error) int

StatusForHeartbeatError maps Heartbeat authoring/status failures to deterministic transport statuses.

func StatusForLoopError

func StatusForLoopError(err error) int

StatusForLoopError maps loop-domain failures to transport statuses.

func StatusForMemoryError

func StatusForMemoryError(err error) int

StatusForMemoryError maps memory-domain errors to transport statuses.

func StatusForModelCatalogError

func StatusForModelCatalogError(err error) int

StatusForModelCatalogError maps model catalog failures to transport statuses.

func StatusForNetworkError

func StatusForNetworkError(err error) int

StatusForNetworkError maps network-domain errors to transport statuses.

func StatusForNotificationPresetError

func StatusForNotificationPresetError(err error) int

StatusForNotificationPresetError maps notification preset failures to transport statuses.

func StatusForResourceError

func StatusForResourceError(err error) int

StatusForResourceError maps desired-state resource failures to transport statuses.

func StatusForSessionError

func StatusForSessionError(err error) int

StatusForSessionError maps session and workspace-domain errors to transport statuses.

func StatusForSettingsError

func StatusForSettingsError(err error) int

StatusForSettingsError maps settings-domain failures to transport statuses.

func StatusForSkillError

func StatusForSkillError(err error) int

StatusForSkillError maps skill-domain errors to transport statuses.

func StatusForSkillMarketplaceError

func StatusForSkillMarketplaceError(err error) int

StatusForSkillMarketplaceError maps skill marketplace lifecycle failures to transport statuses.

func StatusForSoulError

func StatusForSoulError(err error) int

StatusForSoulError maps Soul/session authoring failures to deterministic transport statuses.

func StatusForTaskError

func StatusForTaskError(err error) int

StatusForTaskError maps task-domain, workspace, and session failures to transport statuses.

func StatusForToolError

func StatusForToolError(err error) int

StatusForToolError maps registry failures to stable transport statuses.

func StatusForVaultError

func StatusForVaultError(err error) int

StatusForVaultError maps vault-domain failures to transport statuses.

func StatusForWorkspaceError

func StatusForWorkspaceError(err error) int

StatusForWorkspaceError maps workspace-domain errors to transport statuses.

func StuckTaskRunPayloadsFromObserve

func StuckTaskRunPayloadsFromObserve(rows []observepkg.StuckTaskRun) []contract.StuckTaskRunPayload

StuckTaskRunPayloadsFromObserve converts stuck task-run diagnostics.

func SupportBundleManifestPayloadFromManifest

func SupportBundleManifestPayloadFromManifest(
	manifest support.Manifest,
) *contract.SupportBundleManifestPayload

func SupportBundleOperationResponseFromOperation

func SupportBundleOperationResponseFromOperation(
	op support.Operation,
) contract.SupportBundleOperationResponse

func TaskBlockPayloadFromBlock

func TaskBlockPayloadFromBlock(block taskpkg.TaskBlock) contract.TaskBlockPayload

TaskBlockPayloadFromBlock converts one task-block record into the shared payload.

func TaskBlockPayloadsFromBlocks

func TaskBlockPayloadsFromBlocks(blocks []taskpkg.TaskBlock) []contract.TaskBlockPayload

TaskBlockPayloadsFromBlocks converts task-block records into shared payloads.

func TaskBridgeNotificationCursorPayloadFromCursor

func TaskBridgeNotificationCursorPayloadFromCursor(
	cursor notifications.Cursor,
) contract.TaskBridgeNotificationCursorPayload

TaskBridgeNotificationCursorPayloadFromCursor converts persisted cursor diagnostics into the transport payload used by HTTP, UDS, CLI, and web.

func TaskBridgeNotificationCursorPayloadFromKey

func TaskBridgeNotificationCursorPayloadFromKey(
	key notifications.CursorKey,
) contract.TaskBridgeNotificationCursorPayload

TaskBridgeNotificationCursorPayloadFromKey converts a durable cursor identity into the transport diagnostics shape before any delivery has been persisted.

func TaskBridgeNotificationSubscriptionPayloadFromSubscription

func TaskBridgeNotificationSubscriptionPayloadFromSubscription(
	subscription bridgepkg.BridgeTaskSubscription,
) contract.TaskBridgeNotificationSubscriptionPayload

TaskBridgeNotificationSubscriptionPayloadFromSubscription converts one bridge task subscription into the shared task-scoped transport payload.

func TaskBridgeNotificationSubscriptionPayloadFromSubscriptionAndCursor

func TaskBridgeNotificationSubscriptionPayloadFromSubscriptionAndCursor(
	subscription bridgepkg.BridgeTaskSubscription,
	cursor notifications.Cursor,
) contract.TaskBridgeNotificationSubscriptionPayload

TaskBridgeNotificationSubscriptionPayloadFromSubscriptionAndCursor converts one bridge task subscription with its persisted cursor diagnostics.

func TaskBridgeNotificationSubscriptionPayloadsFromSubscriptions

func TaskBridgeNotificationSubscriptionPayloadsFromSubscriptions(
	subscriptions []bridgepkg.BridgeTaskSubscription,
) []contract.TaskBridgeNotificationSubscriptionPayload

TaskBridgeNotificationSubscriptionPayloadsFromSubscriptions converts bridge task subscriptions into shared task-scoped transport payloads.

func TaskCatalogResponseFromPage

func TaskCatalogResponseFromPage(page taskpkg.CatalogPage) contract.TasksResponse

TaskCatalogResponseFromPage converts one bounded catalog page into its wire envelope.

func TaskDashboardPayloadFromView

func TaskDashboardPayloadFromView(view *observepkg.TaskDashboardView) contract.TaskDashboardPayload

TaskDashboardPayloadFromView converts one observer-backed dashboard view into the shared payload.

func TaskDependencyPayloadsFromDependencies

func TaskDependencyPayloadsFromDependencies(dependencies []taskpkg.Dependency) []contract.TaskDependencyPayload

TaskDependencyPayloadsFromDependencies converts dependency records into shared payloads.

func TaskDependencyReferencePayloadsFromReferences

func TaskDependencyReferencePayloadsFromReferences(
	dependencies []taskpkg.DependencyReference,
) []contract.TaskDependencyReferencePayload

TaskDependencyReferencePayloadsFromReferences converts enriched dependency references into shared payloads.

func TaskDesignationRollupPayloadsFromStore

func TaskDesignationRollupPayloadsFromStore(
	rollups []store.TaskDesignationRollup,
) []contract.TaskDesignationRollupPayload

TaskDesignationRollupPayloadsFromStore converts persisted designation rollups into shared payloads.

func TaskDetailPayloadFromView

func TaskDetailPayloadFromView(view *taskpkg.View) contract.TaskDetailPayload

TaskDetailPayloadFromView converts one expanded task view into the shared payload.

func TaskEventPayloadsFromEvents

func TaskEventPayloadsFromEvents(events []taskpkg.Event) []contract.TaskEventPayload

TaskEventPayloadsFromEvents converts task events into shared payloads.

func TaskExecutionResponseFromExecution

func TaskExecutionResponseFromExecution(execution *taskpkg.Execution) contract.TaskExecutionResponse

TaskExecutionResponseFromExecution converts one task execution-boundary result.

func TaskHealthPayloadFromObserve

func TaskHealthPayloadFromObserve(health observepkg.TaskHealth) contract.TaskHealthPayload

TaskHealthPayloadFromObserve converts observer task health into the shared status payload.

func TaskInboxPayloadFromView

func TaskInboxPayloadFromView(view observepkg.TaskInboxView) contract.TaskInboxPayload

TaskInboxPayloadFromView converts one actor-scoped inbox page into its wire envelope.

func TaskInspectEventPayloadsFromSummaries

func TaskInspectEventPayloadsFromSummaries(
	summaries []taskpkg.InspectEventSummary,
) []contract.TaskInspectEventPayload

TaskInspectEventPayloadsFromSummaries converts inspect event summaries into shared payloads.

func TaskInspectPayloadFromView

func TaskInspectPayloadFromView(view *taskpkg.InspectView) contract.TaskInspectPayload

TaskInspectPayloadFromView converts one inspect view into the shared payload.

func TaskInspectRunPayloadFromSummary

func TaskInspectRunPayloadFromSummary(summary *taskpkg.InspectRunSummary) *contract.TaskInspectRunPayload

TaskInspectRunPayloadFromSummary converts an inspect run summary into the shared payload.

func TaskInspectRunPayloadsFromSummaries

func TaskInspectRunPayloadsFromSummaries(
	summaries []taskpkg.InspectRunSummary,
) []contract.TaskInspectRunPayload

TaskInspectRunPayloadsFromSummaries converts inspect run summaries into shared payloads.

func TaskInspectSchedulerPayloadFromState

func TaskInspectSchedulerPayloadFromState(state taskpkg.InspectSchedulerState) contract.TaskInspectSchedulerPayload

TaskInspectSchedulerPayloadFromState converts scheduler state into the shared payload.

func TaskInspectSessionPayloadFromSummary

func TaskInspectSessionPayloadFromSummary(
	summary *taskpkg.InspectSessionSummary,
) *contract.TaskInspectSessionPayload

TaskInspectSessionPayloadFromSummary converts an inspect session summary into the shared payload.

func TaskOwnerTotalPayloadsFromObserve

func TaskOwnerTotalPayloadsFromObserve(rows []observepkg.TaskOwnerTotal) []contract.TaskOwnerTotalPayload

TaskOwnerTotalPayloadsFromObserve converts task ownership buckets.

func TaskPayloadFromTask

func TaskPayloadFromTask(record *taskpkg.Task) contract.TaskPayload

TaskPayloadFromTask converts one task record into the shared payload.

func TaskQueueDepthPayloadsFromObserve

func TaskQueueDepthPayloadsFromObserve(rows []observepkg.TaskQueueDepth) []contract.TaskQueueDepthPayload

TaskQueueDepthPayloadsFromObserve converts task queue-depth rows.

func TaskReferencePayloadFromReference

func TaskReferencePayloadFromReference(record taskpkg.Reference) contract.TaskReferencePayload

TaskReferencePayloadFromReference converts one task reference into the shared payload.

func TaskRunDetailPayloadFromView

func TaskRunDetailPayloadFromView(view *taskpkg.RunDetailView) contract.TaskRunDetailPayload

TaskRunDetailPayloadFromView converts one run-detail view into the shared payload.

func TaskRunOperationalSummaryPayloadFromSummary

func TaskRunOperationalSummaryPayloadFromSummary(
	summary taskpkg.RunOperationalSummary,
) contract.TaskRunOperationalSummaryPayload

TaskRunOperationalSummaryPayloadFromSummary converts run-detail operational metrics into the shared payload.

func TaskRunPayloadFromRun

func TaskRunPayloadFromRun(run *taskpkg.Run) contract.TaskRunPayload

TaskRunPayloadFromRun converts one task run into the shared payload.

func TaskRunPayloadsFromRuns

func TaskRunPayloadsFromRuns(runs []taskpkg.Run) []contract.TaskRunPayload

TaskRunPayloadsFromRuns converts task runs into shared payloads.

func TaskRunReviewPayloadsFromReviews

func TaskRunReviewPayloadsFromReviews(reviews []taskpkg.RunReview) []contract.TaskRunReviewPayload

TaskRunReviewPayloadsFromReviews converts review records into shared payloads.

func TaskRunReviewVerdictResponseFromResult

func TaskRunReviewVerdictResponseFromResult(result *taskpkg.RunReviewResult) contract.TaskRunReviewVerdictResponse

TaskRunReviewVerdictResponseFromResult converts one verdict result into a shared payload.

func TaskRunSessionPayloadFromSession

func TaskRunSessionPayloadFromSession(session *taskpkg.RunSessionRef) *contract.TaskRunSessionPayload

TaskRunSessionPayloadFromSession converts one task run session link into the shared payload.

func TaskRunSummaryPayloadFromSummary

func TaskRunSummaryPayloadFromSummary(summary *taskpkg.RunSummary) *contract.TaskRunSummaryPayload

TaskRunSummaryPayloadFromSummary converts one operator-facing run summary into the shared payload.

func TaskRunTotalPayloadsFromObserve

func TaskRunTotalPayloadsFromObserve(rows []observepkg.TaskRunTotal) []contract.TaskRunTotalPayload

TaskRunTotalPayloadsFromObserve converts task-run status buckets.

func TaskStatusTotalPayloadsFromObserve

func TaskStatusTotalPayloadsFromObserve(rows []observepkg.TaskStatusTotal) []contract.TaskStatusTotalPayload

TaskStatusTotalPayloadsFromObserve converts task status buckets.

func TaskStreamEventPayloadFromEvent

func TaskStreamEventPayloadFromEvent(event taskpkg.StreamEvent) contract.TaskStreamEventPayload

TaskStreamEventPayloadFromEvent converts one task live-stream event into the shared payload.

func TaskSummaryPayloadFromSummary

func TaskSummaryPayloadFromSummary(record *taskpkg.Summary) contract.TaskSummaryPayload

TaskSummaryPayloadFromSummary converts one task summary into the shared payload.

func TaskSummaryPayloadFromTask

func TaskSummaryPayloadFromTask(record *taskpkg.Task) contract.TaskSummaryPayload

TaskSummaryPayloadFromTask provides the compact task shape used by list and backlog surfaces.

func TaskSummaryPayloadsFromSummaries

func TaskSummaryPayloadsFromSummaries(tasks []taskpkg.Summary) []contract.TaskSummaryPayload

TaskSummaryPayloadsFromSummaries converts task summaries into shared payloads.

func TaskTimelineItemPayloadFromItem

func TaskTimelineItemPayloadFromItem(item taskpkg.TimelineItem) contract.TaskTimelineItemPayload

TaskTimelineItemPayloadFromItem converts one task timeline item into the shared payload.

func TaskTimelineItemPayloadsFromItems

func TaskTimelineItemPayloadsFromItems(items []taskpkg.TimelineItem) []contract.TaskTimelineItemPayload

TaskTimelineItemPayloadsFromItems converts task timeline items into shared payloads.

func TaskTreeNodePayloadFromNode

func TaskTreeNodePayloadFromNode(node taskpkg.TreeNode) contract.TaskTreeNodePayload

TaskTreeNodePayloadFromNode converts one task tree node into the shared payload.

func TaskTreePayloadFromView

func TaskTreePayloadFromView(view *taskpkg.TreeView) contract.TaskTreePayload

TaskTreePayloadFromView converts one task tree snapshot into the shared payload.

func TaskTriageStatePayloadFromState

func TaskTriageStatePayloadFromState(state taskpkg.TriageState) contract.TaskTriageStatePayload

TaskTriageStatePayloadFromState converts one triage-state record into the shared payload.

func TokenUsagePayloadFromUsage

func TokenUsagePayloadFromUsage(usage *acp.TokenUsage) *contract.TokenUsagePayload

TokenUsagePayloadFromUsage converts token usage info into the shared payload.

func ToolErrorResponseForError

func ToolErrorResponseForError(err error, status int, maskInternal bool) contract.ToolErrorResponse

ToolErrorResponseForError builds the stable tool error response payload.

func ToolPayloadFromView

func ToolPayloadFromView(view *toolspkg.ToolView) contract.ToolPayload

ToolPayloadFromView converts one registry view into a public DTO.

func ToolPayloadsFromViews

func ToolPayloadsFromViews(views []toolspkg.ToolView) []contract.ToolPayload

ToolPayloadsFromViews converts registry views into public DTOs.

func ToolsetPayloadFromView

func ToolsetPayloadFromView(view toolspkg.ToolsetView) contract.ToolsetPayload

ToolsetPayloadFromView converts one toolset projection into a public DTO.

func ToolsetPayloadsFromViews

func ToolsetPayloadsFromViews(views []toolspkg.ToolsetView) []contract.ToolsetPayload

ToolsetPayloadsFromViews converts toolset projections into public DTOs.

func TriggerPayloadFromTrigger

func TriggerPayloadFromTrigger(trigger automationpkg.Trigger) contract.TriggerPayload

TriggerPayloadFromTrigger converts an automation trigger into the shared response payload.

func TriggerPayloadsFromTriggers

func TriggerPayloadsFromTriggers(triggers []automationpkg.Trigger) []contract.TriggerPayload

TriggerPayloadsFromTriggers converts a slice of triggers into response payloads.

func ValidateAutomationManagedJobUpdate

func ValidateAutomationManagedJobUpdate(req contract.UpdateJobRequest) error

ValidateAutomationManagedJobUpdate enforces the managed job mutation policy.

func ValidateAutomationManagedTriggerUpdate

func ValidateAutomationManagedTriggerUpdate(req contract.UpdateTriggerRequest) error

ValidateAutomationManagedTriggerUpdate enforces the managed trigger mutation policy.

func VaultSecretPayloadFromMetadata

func VaultSecretPayloadFromMetadata(row vault.Metadata) (contract.VaultSecretPayload, error)

VaultSecretPayloadFromMetadata converts redacted vault metadata into the shared contract payload.

func VaultSecretPayloadsFromMetadata

func VaultSecretPayloadsFromMetadata(rows []vault.Metadata) ([]contract.VaultSecretPayload, error)

VaultSecretPayloadsFromMetadata converts a metadata list into public payloads.

func WebhookDeliveryPayloadFromResult

func WebhookDeliveryPayloadFromResult(result automationpkg.TriggerResult) contract.WebhookDeliveryPayload

WebhookDeliveryPayloadFromResult converts a webhook trigger dispatch result into the shared response payload.

func WorkspacePayloadFromWorkspace

func WorkspacePayloadFromWorkspace(workspace workspacepkg.Workspace) contract.WorkspacePayload

WorkspacePayloadFromWorkspace converts a workspace into the shared payload.

func WorkspaceSkillPayloads

func WorkspaceSkillPayloads(skills []workspacepkg.SkillPath) []contract.WorkspaceSkillPayload

WorkspaceSkillPayloads converts workspace skill paths into response payloads.

func WriteSSE

func WriteSSE(writer FlushWriter, msg SSEMessage) error

WriteSSE writes one SSE message with JSON-encoded data.

func WriteSSEComment

func WriteSSEComment(writer FlushWriter, comment string) error

WriteSSEComment writes one SSE comment frame. EventSource clients ignore comment frames, so stream keep-alives must use this helper instead of data events.

func WriteSSERaw

func WriteSSERaw(writer FlushWriter, id string, raw string, names ...string) error

WriteSSERaw writes one SSE message using a pre-encoded payload.

func WriteTaskStreamEvent

func WriteTaskStreamEvent(writer FlushWriter, event taskpkg.StreamEvent) error

WriteTaskStreamEvent writes one task-native live event as a standard SSE message. TaskStreamEventPayload.Type is the event identity consumed by clients.

Types

type AgentCatalog

type AgentCatalog interface {
	ListAgents(ctx context.Context) ([]AgentCatalogEntry, error)
	GetAgent(ctx context.Context, name string) (AgentCatalogEntry, error)
}

AgentCatalog exposes projected resource-backed agent definitions.

type AgentCatalogEntry

type AgentCatalogEntry struct {
	Def         compozyconfig.AgentDef
	Origin      contract.AgentOrigin
	WorkspaceID string
}

AgentCatalogEntry carries one definition with its durable ownership scope.

func AgentCatalogEntryFromDef

func AgentCatalogEntryFromDef(
	home compozyconfig.HomePaths,
	agent compozyconfig.AgentDef,
	workspaceID string,
) AgentCatalogEntry

AgentCatalogEntryFromDef attaches origin truth to one disk-loaded definition.

type AgentContextService

type AgentContextService interface {
	ContextForSession(ctx context.Context, info *session.Info) (contract.AgentContextPayload, error)
}

AgentContextService assembles the bounded situation payload for a validated agent session.

type AgentDefinitionSync

type AgentDefinitionSync interface {
	Sync(ctx context.Context) error
}

AgentDefinitionSync converges authored definitions into runtime projections.

type AgentLoader

type AgentLoader func(name string, homePaths compozyconfig.HomePaths) (compozyconfig.AgentDef, error)

AgentLoader loads one parsed AGENT.md definition.

type AgentSessionMetricsReader

type AgentSessionMetricsReader interface {
	AggregateSessionsByAgent(
		ctx context.Context,
		workspaceID string,
	) (map[string]session.AgentSessionMetrics, error)
}

AgentSessionMetricsReader exposes exact workspace-scoped session aggregates.

type AutomationManager

type AutomationManager interface {
	ListSuggestions(
		ctx context.Context,
		workspaceRef string,
		status automationpkg.SuggestionStatus,
	) ([]automationpkg.Suggestion, error)
	AcceptSuggestion(
		ctx context.Context,
		workspaceRef string,
		suggestionID string,
	) (automationpkg.SuggestionAcceptance, error)
	DismissSuggestion(
		ctx context.Context,
		workspaceRef string,
		suggestionID string,
	) (automationpkg.Suggestion, error)
	ListJobs(ctx context.Context, query automationpkg.JobListQuery) (automationpkg.JobListPage, error)
	Jobs(ctx context.Context) ([]automationpkg.Job, error)
	GetJob(ctx context.Context, id string) (automationpkg.Job, error)
	CreateJob(ctx context.Context, job automationpkg.Job) (automationpkg.Job, error)
	UpdateJob(ctx context.Context, job automationpkg.Job) (automationpkg.Job, error)
	DeleteJob(ctx context.Context, id string) error
	TriggerJob(ctx context.Context, id string) (automationpkg.Run, error)
	ListTriggers(ctx context.Context, query automationpkg.TriggerListQuery) (automationpkg.TriggerListPage, error)
	Triggers(ctx context.Context) ([]automationpkg.Trigger, error)
	GetTrigger(ctx context.Context, id string) (automationpkg.Trigger, error)
	CreateTrigger(
		ctx context.Context,
		trigger automationpkg.Trigger,
		webhookSecret automationpkg.WebhookSecretWrite,
	) (automationpkg.Trigger, error)
	UpdateTrigger(
		ctx context.Context,
		trigger automationpkg.Trigger,
		webhookSecret *automationpkg.WebhookSecretWrite,
	) (automationpkg.Trigger, error)
	DeleteTrigger(ctx context.Context, id string) error
	ListRuns(ctx context.Context, query automationpkg.RunQuery) ([]automationpkg.Run, error)
	Runs(ctx context.Context, query automationpkg.RunQuery) ([]automationpkg.Run, error)
	GetRun(ctx context.Context, id string) (automationpkg.Run, error)
	Status(ctx context.Context) (automationpkg.ManagerStatus, error)
	SetJobEnabled(ctx context.Context, id string, enabled bool) (automationpkg.Job, error)
	SetTriggerEnabled(ctx context.Context, id string, enabled bool) (automationpkg.Trigger, error)
	HandleWebhook(ctx context.Context, request automationpkg.WebhookRequest) (automationpkg.TriggerResult, error)
}

AutomationManager exposes automation state and control surfaces to the API layer.

type BaseHandlerConfig

type BaseHandlerConfig struct {
	TransportName                string
	MaskInternalErrors           bool
	IncludeSessionWorkspaceInSSE bool
	Sessions                     SessionManager
	SessionAcceptance            SessionAcceptanceManager
	DrainController              DaemonDrainController
	SessionCatalog               SessionCatalog
	Network                      NetworkService
	NetworkStore                 NetworkStore
	NetworkUsage                 store.NetworkUsageStore
	Coordination                 workspacepkg.CoordinationCommands
	Observer                     Observer
	SchemaStreams                SchemaStreamStatusReader
	Resources                    ResourceService
	Extensions                   ExtensionService
	Tools                        ToolRegistry
	ToolArtifacts                toolspkg.ToolArtifactStore
	Toolsets                     ToolsetRegistry
	ToolApprovals                ToolApprovalIssuer
	ApprovalGrants               ToolApprovalGrantService
	Clarify                      toolspkg.ClarifyBroker
	Automation                   AutomationManager
	Loops                        LoopService
	Tasks                        TaskService
	Bridges                      BridgeService
	Notifications                NotificationPresetService
	Bundles                      BundleService
	SupportBundles               SupportBundleService
	Settings                     SettingsService
	SettingsRestart              SettingsRestartController
	SettingsUpdate               SettingsUpdateController
	Vault                        VaultService
	Workspaces                   WorkspaceService
	WindowManager                WindowManagerService
	Onboarding                   OnboardingStore
	AgentCatalog                 AgentCatalog
	AgentDefinitionSync          AgentDefinitionSync
	ModelCatalog                 ModelCatalogService
	MarketplaceCatalog           MarketplaceCatalogService
	ProviderAuthRunner           authproviders.ProviderAuthCommandRunner
	AgentContextService          AgentContextService
	SoulAuthoring                SoulAuthoringService
	SoulHistoryPurger            SoulHistoryPurger
	SoulRefresher                SoulRefresher
	HeartbeatAuthoring           HeartbeatAuthoringService
	HeartbeatHistoryPurger       HeartbeatHistoryPurger
	HeartbeatStatus              HeartbeatStatusService
	HeartbeatWake                HeartbeatWakeService
	SessionHealth                SessionHealthReader
	HeartbeatWakeEvents          HeartbeatWakeEventReader
	CoordinatorRole              CoordinatorRoleResolver
	Roles                        RolesStatusProvider
	SkillsRegistry               SkillsRegistry
	SkillResources               SkillResourceSyncer
	SkillMarketplace             SkillMarketplaceService
	InstalledSkillMarketplace    InstalledSkillMarketplaceService
	TaskActorContextResolver     TaskActorContextResolver
	MemoryStore                  *memory.Store
	DreamTrigger                 DreamTrigger
	MemoryExtractor              MemoryExtractorService
	MemoryProviders              MemoryProviderService
	MemorySessionLedger          MemorySessionLedgerService
	RuntimeMemory                doctor.RuntimeMemorySnapshotSource
	DeadEntities                 doctor.DeadEntitySource
	HomePaths                    compozyconfig.HomePaths
	Config                       compozyconfig.Config
	Logger                       *slog.Logger
	StartedAt                    time.Time
	Now                          func() time.Time
	PollInterval                 time.Duration
	AgentLoader                  AgentLoader
	StreamDone                   <-chan struct{}
	HTTPPort                     int
	PID                          func() int
}

BaseHandlerConfig configures a shared handler set for one transport.

type BaseHandlers

type BaseHandlers struct {
	TransportName                string
	MaskInternalErrors           bool
	IncludeSessionWorkspaceInSSE bool
	Sessions                     SessionManager
	SessionAcceptance            SessionAcceptanceManager
	DrainController              DaemonDrainController
	SessionCatalog               SessionCatalog
	Network                      NetworkService
	NetworkStore                 NetworkStore
	NetworkUsage                 store.NetworkUsageStore
	Coordination                 workspacepkg.CoordinationCommands
	Observer                     Observer
	SchemaStreams                SchemaStreamStatusReader
	Resources                    ResourceService
	Extensions                   ExtensionService
	Tools                        ToolRegistry
	ToolArtifacts                toolspkg.ToolArtifactStore
	Toolsets                     ToolsetRegistry
	ToolApprovals                ToolApprovalIssuer
	ApprovalGrants               ToolApprovalGrantService
	Clarify                      toolspkg.ClarifyBroker
	Automation                   AutomationManager
	Loops                        LoopService
	Tasks                        TaskService
	Bridges                      BridgeService
	Notifications                NotificationPresetService
	Bundles                      BundleService
	SupportBundles               SupportBundleService
	Settings                     SettingsService
	SettingsRestart              SettingsRestartController
	SettingsUpdate               SettingsUpdateController
	Vault                        VaultService
	Workspaces                   WorkspaceService
	WindowManager                WindowManagerService
	Onboarding                   OnboardingStore
	AgentCatalog                 AgentCatalog
	AgentDefinitionSync          AgentDefinitionSync
	ModelCatalog                 ModelCatalogService
	MarketplaceCatalog           MarketplaceCatalogService
	ProviderAuthRunner           authproviders.ProviderAuthCommandRunner
	AgentContextService          AgentContextService
	SoulAuthoring                SoulAuthoringService
	SoulHistoryPurger            SoulHistoryPurger
	SoulRefresher                SoulRefresher
	HeartbeatAuthoring           HeartbeatAuthoringService
	HeartbeatHistoryPurger       HeartbeatHistoryPurger
	HeartbeatStatus              HeartbeatStatusService
	HeartbeatWake                HeartbeatWakeService
	SessionHealth                SessionHealthReader
	HeartbeatWakeEvents          HeartbeatWakeEventReader
	CoordinatorRole              CoordinatorRoleResolver
	Roles                        RolesStatusProvider
	SkillsRegistry               SkillsRegistry
	SkillResources               SkillResourceSyncer
	SkillMarketplace             SkillMarketplaceService
	InstalledSkillMarketplace    InstalledSkillMarketplaceService
	TaskActorContextResolver     TaskActorContextResolver
	MemoryStore                  *memory.Store
	DreamTrigger                 DreamTrigger
	MemoryExtractor              MemoryExtractorService
	MemoryProviders              MemoryProviderService
	MemorySessionLedger          MemorySessionLedgerService
	RuntimeMemory                doctor.RuntimeMemorySnapshotSource
	DeadEntities                 doctor.DeadEntitySource
	HomePaths                    compozyconfig.HomePaths
	Config                       compozyconfig.Config
	Logger                       *slog.Logger
	StartedAt                    time.Time
	Now                          func() time.Time
	PollInterval                 time.Duration
	AgentLoader                  AgentLoader
	PID                          func() int
	// contains filtered or unexported fields
}

BaseHandlers contains the shared transport-independent API handler logic.

func NewBaseHandlers

func NewBaseHandlers(cfg *BaseHandlerConfig) *BaseHandlers

NewBaseHandlers builds a shared handler set with transport-specific defaults applied.

func (*BaseHandlers) AcceptAutomationSuggestion

func (h *BaseHandlers) AcceptAutomationSuggestion(c *gin.Context)

AcceptAutomationSuggestion accepts one proposal and creates its Job.

func (*BaseHandlers) ActivateBundle

func (h *BaseHandlers) ActivateBundle(c *gin.Context)

func (*BaseHandlers) AddTaskDependency

func (h *BaseHandlers) AddTaskDependency(c *gin.Context)

AddTaskDependency adds one blocking dependency edge.

func (*BaseHandlers) AgentChannelRecv

func (h *BaseHandlers) AgentChannelRecv(c *gin.Context)

AgentChannelRecv returns queued channel messages for the validated caller, optionally waiting.

func (*BaseHandlers) AgentChannelReply

func (h *BaseHandlers) AgentChannelReply(c *gin.Context)

AgentChannelReply replies to one queued or persisted message using the validated caller identity.

func (*BaseHandlers) AgentChannelSend

func (h *BaseHandlers) AgentChannelSend(c *gin.Context)

AgentChannelSend sends one coordination message using the validated caller identity.

func (*BaseHandlers) AgentChannels

func (h *BaseHandlers) AgentChannels(c *gin.Context)

AgentChannels lists discoverable coordination channels for the validated caller.

func (*BaseHandlers) AgentContext

func (h *BaseHandlers) AgentContext(c *gin.Context)

AgentContext returns the bounded situation payload for the validated caller session.

func (*BaseHandlers) AgentCoordinatorRole

func (h *BaseHandlers) AgentCoordinatorRole(c *gin.Context)

AgentCoordinatorRole returns the resolved coordinator policy for the caller workspace.

func (*BaseHandlers) AgentMe

func (h *BaseHandlers) AgentMe(c *gin.Context)

AgentMe returns the daemon-validated caller identity for agent-facing UDS operations.

func (*BaseHandlers) AgentSoul

func (h *BaseHandlers) AgentSoul(c *gin.Context)

AgentSoul returns the caller's resolved full Soul read model.

func (*BaseHandlers) AgentSpawn

func (h *BaseHandlers) AgentSpawn(c *gin.Context)

AgentSpawn creates a bounded child session for the validated agent caller.

func (*BaseHandlers) AgentTaskClaimNext

func (h *BaseHandlers) AgentTaskClaimNext(c *gin.Context)

AgentTaskClaimNext claims the next eligible task run for the validated caller.

func (*BaseHandlers) AgentTaskComplete

func (h *BaseHandlers) AgentTaskComplete(c *gin.Context)

AgentTaskComplete completes one claimed task run after token verification.

func (*BaseHandlers) AgentTaskFail

func (h *BaseHandlers) AgentTaskFail(c *gin.Context)

AgentTaskFail fails one claimed task run after token verification.

func (*BaseHandlers) AgentTaskHeartbeat

func (h *BaseHandlers) AgentTaskHeartbeat(c *gin.Context)

AgentTaskHeartbeat extends the current lease for one claimed task run.

func (*BaseHandlers) AgentTaskRelease

func (h *BaseHandlers) AgentTaskRelease(c *gin.Context)

AgentTaskRelease releases one claimed task run back to the queue.

func (*BaseHandlers) AnswerSessionClarification

func (h *BaseHandlers) AnswerSessionClarification(c *gin.Context)

AnswerSessionClarification resolves one live request after workspace/session authorization.

func (*BaseHandlers) ApproveLoopRun

func (h *BaseHandlers) ApproveLoopRun(c *gin.Context)

ApproveLoopRun applies a human-gate decision.

func (*BaseHandlers) ApproveTask

func (h *BaseHandlers) ApproveTask(c *gin.Context)

ApproveTask records one approval decision for an approval-gated task.

func (*BaseHandlers) ArchiveTask

func (h *BaseHandlers) ArchiveTask(c *gin.Context)

ArchiveTask archives one task triage record for the current actor.

func (*BaseHandlers) AttachSession

func (h *BaseHandlers) AttachSession(c *gin.Context)

AttachSession acquires a short-lived attach lease without starting a new runtime authority.

func (*BaseHandlers) AttachTaskRunSession

func (h *BaseHandlers) AttachTaskRunSession(c *gin.Context)

AttachTaskRunSession binds one existing session to a run.

func (*BaseHandlers) AutomationJobRuns

func (h *BaseHandlers) AutomationJobRuns(c *gin.Context)

AutomationJobRuns returns run history for one automation job.

func (*BaseHandlers) AutomationTriggerRuns

func (h *BaseHandlers) AutomationTriggerRuns(c *gin.Context)

AutomationTriggerRuns returns run history for one automation trigger.

func (*BaseHandlers) BeginSettingsMCPAuth

func (h *BaseHandlers) BeginSettingsMCPAuth(c *gin.Context)

BeginSettingsMCPAuth creates one daemon-owned PKCE session.

func (*BaseHandlers) BlockTask

func (h *BaseHandlers) BlockTask(c *gin.Context)

BlockTask creates one runtime-declared block for a task.

func (*BaseHandlers) BrowseDirectory

func (h *BaseHandlers) BrowseDirectory(c *gin.Context)

BrowseDirectory lists immediate directory entries so the onboarding workspace picker can navigate the local filesystem. It is read-only and operator-scoped: the daemon already runs with the operator's filesystem access.

func (*BaseHandlers) BrowseMarketplaceKind

func (h *BaseHandlers) BrowseMarketplaceKind(c *gin.Context)

BrowseMarketplaceKind returns one marketplace kind or a deterministic error.

func (*BaseHandlers) BulkForceFailTaskRuns

func (h *BaseHandlers) BulkForceFailTaskRuns(c *gin.Context)

BulkForceFailTaskRuns force fails a bounded set of runs.

func (*BaseHandlers) BulkForceReleaseTaskRuns

func (h *BaseHandlers) BulkForceReleaseTaskRuns(c *gin.Context)

BulkForceReleaseTaskRuns force releases a bounded set of runs.

func (*BaseHandlers) BundleNetworkSettings

func (h *BaseHandlers) BundleNetworkSettings(c *gin.Context)

func (*BaseHandlers) CancelTask

func (h *BaseHandlers) CancelTask(c *gin.Context)

CancelTask requests cancellation for one task tree.

func (*BaseHandlers) CancelTaskRun

func (h *BaseHandlers) CancelTaskRun(c *gin.Context)

CancelTaskRun cancels one non-terminal run.

func (*BaseHandlers) ClearSessionConversation

func (h *BaseHandlers) ClearSessionConversation(c *gin.Context)

ClearSessionConversation clears persisted conversation history and restarts the session with a fresh ACP conversation context while preserving the same id.

func (*BaseHandlers) ClearTaskBlock

func (h *BaseHandlers) ClearTaskBlock(c *gin.Context)

ClearTaskBlock clears one open task block.

func (*BaseHandlers) CompleteOnboarding

func (h *BaseHandlers) CompleteOnboarding(c *gin.Context)

CompleteOnboarding marks first-run onboarding as completed and returns the new status.

func (*BaseHandlers) CompleteSettingsMCPAuthCallback

func (h *BaseHandlers) CompleteSettingsMCPAuthCallback(c *gin.Context)

CompleteSettingsMCPAuthCallback completes a browser redirect and renders a close-tab page.

func (*BaseHandlers) CompleteTaskRun

func (h *BaseHandlers) CompleteTaskRun(c *gin.Context)

CompleteTaskRun marks one running run as completed.

func (*BaseHandlers) ConfigApplyRecordsSnapshot

func (h *BaseHandlers) ConfigApplyRecordsSnapshot(
	ctx context.Context,
) (contract.ConfigApplyRecordsResponse, error)

ConfigApplyRecordsSnapshot returns recent config apply records for support bundles.

func (*BaseHandlers) CreateAgent

func (h *BaseHandlers) CreateAgent(c *gin.Context)

CreateAgent writes a new global or workspace-local AGENT.md definition.

func (*BaseHandlers) CreateAutomationJob

func (h *BaseHandlers) CreateAutomationJob(c *gin.Context)

CreateAutomationJob stores a new dynamic automation job.

func (*BaseHandlers) CreateAutomationTrigger

func (h *BaseHandlers) CreateAutomationTrigger(c *gin.Context)

CreateAutomationTrigger stores a new dynamic automation trigger definition.

func (*BaseHandlers) CreateBridge

func (h *BaseHandlers) CreateBridge(c *gin.Context)

CreateBridge persists a new bridge instance.

func (*BaseHandlers) CreateChildTask

func (h *BaseHandlers) CreateChildTask(c *gin.Context)

CreateChildTask creates one child task beneath the supplied parent.

func (*BaseHandlers) CreateLoop

func (h *BaseHandlers) CreateLoop(c *gin.Context)

CreateLoop creates or forks one writable Loop definition.

func (*BaseHandlers) CreateMemoryAdhocNote

func (h *BaseHandlers) CreateMemoryAdhocNote(c *gin.Context)

func (*BaseHandlers) CreateNetworkChannel

func (h *BaseHandlers) CreateNetworkChannel(c *gin.Context)

CreateNetworkChannel validates and creates one new channel by starting a new session per selected agent.

func (*BaseHandlers) CreateNotificationPreset

func (h *BaseHandlers) CreateNotificationPreset(c *gin.Context)

CreateNotificationPreset creates one preset.

func (*BaseHandlers) CreateSession

func (h *BaseHandlers) CreateSession(c *gin.Context)

CreateSession creates a new runtime session.

func (*BaseHandlers) CreateSupportBundle

func (h *BaseHandlers) CreateSupportBundle(c *gin.Context)

CreateSupportBundle starts an asynchronous daemon-owned support bundle operation.

func (*BaseHandlers) CreateTask

func (h *BaseHandlers) CreateTask(c *gin.Context)

CreateTask creates one new task.

func (*BaseHandlers) CreateTaskBridgeNotificationSubscription

func (h *BaseHandlers) CreateTaskBridgeNotificationSubscription(c *gin.Context)

CreateTaskBridgeNotificationSubscription persists one task-scoped terminal bridge notification target.

func (*BaseHandlers) CreateToolApproval

func (h *BaseHandlers) CreateToolApproval(c *gin.Context)

CreateToolApproval mints one daemon-memory approval reference for a concrete invocation.

func (*BaseHandlers) CreateWorkspace

func (h *BaseHandlers) CreateWorkspace(c *gin.Context)

CreateWorkspace registers a workspace.

func (*BaseHandlers) DeleteAgent

func (h *BaseHandlers) DeleteAgent(c *gin.Context)

DeleteAgent durably removes the effective authored directory and its scoped revision history.

func (*BaseHandlers) DeleteAgentHeartbeat

func (h *BaseHandlers) DeleteAgentHeartbeat(c *gin.Context)

DeleteAgentHeartbeat removes HEARTBEAT.md through the managed authoring service.

func (*BaseHandlers) DeleteAgentSoul

func (h *BaseHandlers) DeleteAgentSoul(c *gin.Context)

DeleteAgentSoul removes SOUL.md through the managed authoring service.

func (*BaseHandlers) DeleteAutomationJob

func (h *BaseHandlers) DeleteAutomationJob(c *gin.Context)

DeleteAutomationJob removes one dynamic automation job definition.

func (*BaseHandlers) DeleteAutomationTrigger

func (h *BaseHandlers) DeleteAutomationTrigger(c *gin.Context)

DeleteAutomationTrigger removes one dynamic automation trigger definition.

func (*BaseHandlers) DeleteBridgeSecretBinding

func (h *BaseHandlers) DeleteBridgeSecretBinding(c *gin.Context)

DeleteBridgeSecretBinding removes one bridge secret binding row.

func (*BaseHandlers) DeleteBundleActivation

func (h *BaseHandlers) DeleteBundleActivation(c *gin.Context)

func (*BaseHandlers) DeleteLoop

func (h *BaseHandlers) DeleteLoop(c *gin.Context)

DeleteLoop deletes one writable Loop definition.

func (*BaseHandlers) DeleteLoopInputDefault

func (h *BaseHandlers) DeleteLoopInputDefault(c *gin.Context)

DeleteLoopInputDefault removes one configured key at one explicit scope.

func (*BaseHandlers) DeleteMemory

func (h *BaseHandlers) DeleteMemory(c *gin.Context)

DeleteMemory deletes one memory document.

func (*BaseHandlers) DeleteNetworkSubscription

func (h *BaseHandlers) DeleteNetworkSubscription(c *gin.Context)

DeleteNetworkSubscription removes one peer delivery preference.

func (*BaseHandlers) DeleteNotificationPreset

func (h *BaseHandlers) DeleteNotificationPreset(c *gin.Context)

DeleteNotificationPreset removes one preset.

func (*BaseHandlers) DeleteResource

func (h *BaseHandlers) DeleteResource(c *gin.Context)

DeleteResource deletes one desired-state resource by optimistic version.

func (*BaseHandlers) DeleteSession

func (h *BaseHandlers) DeleteSession(c *gin.Context)

DeleteSession removes one session from the runtime catalog and persisted history.

func (*BaseHandlers) DeleteSettingsHook

func (h *BaseHandlers) DeleteSettingsHook(c *gin.Context)

DeleteSettingsHook deletes one hook settings item.

func (*BaseHandlers) DeleteSettingsMCPServer

func (h *BaseHandlers) DeleteSettingsMCPServer(c *gin.Context)

DeleteSettingsMCPServer deletes one MCP server settings item.

func (*BaseHandlers) DeleteSettingsProvider

func (h *BaseHandlers) DeleteSettingsProvider(c *gin.Context)

DeleteSettingsProvider deletes one provider settings item.

func (*BaseHandlers) DeleteSettingsSandbox

func (h *BaseHandlers) DeleteSettingsSandbox(c *gin.Context)

DeleteSettingsSandbox deletes one sandbox settings item.

func (*BaseHandlers) DeleteTask

func (h *BaseHandlers) DeleteTask(c *gin.Context)

DeleteTask removes one task record and any cascade-owned child rows.

func (*BaseHandlers) DeleteTaskBridgeNotificationSubscription

func (h *BaseHandlers) DeleteTaskBridgeNotificationSubscription(c *gin.Context)

DeleteTaskBridgeNotificationSubscription removes one task-scoped terminal bridge notification target.

func (*BaseHandlers) DeleteTaskExecutionProfile

func (h *BaseHandlers) DeleteTaskExecutionProfile(c *gin.Context)

DeleteTaskExecutionProfile removes one persisted task-owned execution profile.

func (*BaseHandlers) DeleteVaultSecret

func (h *BaseHandlers) DeleteVaultSecret(c *gin.Context)

DeleteVaultSecret removes one vault-backed secret.

func (*BaseHandlers) DeleteWindowManagerLayoutProfile

func (h *BaseHandlers) DeleteWindowManagerLayoutProfile(c *gin.Context)

DeleteWindowManagerLayoutProfile deletes one route-workspace-visible profile.

func (*BaseHandlers) DeleteWorkspace

func (h *BaseHandlers) DeleteWorkspace(c *gin.Context)

DeleteWorkspace unregisters a workspace.

func (*BaseHandlers) DeliverGlobalWebhook

func (h *BaseHandlers) DeliverGlobalWebhook(c *gin.Context)

DeliverGlobalWebhook handles external webhook delivery for global triggers.

func (*BaseHandlers) DeliverWorkspaceWebhook

func (h *BaseHandlers) DeliverWorkspaceWebhook(c *gin.Context)

DeliverWorkspaceWebhook handles external webhook delivery for workspace-scoped triggers.

func (*BaseHandlers) DisableBridge

func (h *BaseHandlers) DisableBridge(c *gin.Context)

DisableBridge moves one bridge instance into the disabled lifecycle state.

func (*BaseHandlers) DisableExtension

func (h *BaseHandlers) DisableExtension(c *gin.Context)

DisableExtension disables one installed extension.

func (*BaseHandlers) DisableMemoryProvider

func (h *BaseHandlers) DisableMemoryProvider(c *gin.Context)

func (*BaseHandlers) DisableSkill

func (h *BaseHandlers) DisableSkill(c *gin.Context)

DisableSkill disables a skill by name.

func (*BaseHandlers) DismissAutomationSuggestion

func (h *BaseHandlers) DismissAutomationSuggestion(c *gin.Context)

DismissAutomationSuggestion dismisses one proposal without creating a Job.

func (*BaseHandlers) DismissTask

func (h *BaseHandlers) DismissTask(c *gin.Context)

DismissTask dismisses one task triage record for the current actor.

func (*BaseHandlers) DoctorSnapshot

func (h *BaseHandlers) DoctorSnapshot(ctx context.Context) (contract.DoctorPayload, error)

DoctorSnapshot returns the same diagnostic payload used by /api/doctor with all probes enabled.

func (*BaseHandlers) DownloadSupportBundle

func (h *BaseHandlers) DownloadSupportBundle(c *gin.Context)

DownloadSupportBundle streams a completed support bundle archive.

func (*BaseHandlers) DrainDaemon

func (h *BaseHandlers) DrainDaemon(c *gin.Context)

DrainDaemon closes new-work admission without interrupting admitted work.

func (*BaseHandlers) DrainMemoryExtractor

func (h *BaseHandlers) DrainMemoryExtractor(c *gin.Context)

func (*BaseHandlers) DrainScheduler

func (h *BaseHandlers) DrainScheduler(c *gin.Context)

DrainScheduler lets the task service own drain policy while the API only maps request overrides.

func (*BaseHandlers) DuplicateAgent

func (h *BaseHandlers) DuplicateAgent(c *gin.Context)

DuplicateAgent clones the effective authored directory under a new name.

func (*BaseHandlers) EditMemory

func (h *BaseHandlers) EditMemory(c *gin.Context)

EditMemory edits one memory document through the controller.

func (*BaseHandlers) EnableBridge

func (h *BaseHandlers) EnableBridge(c *gin.Context)

EnableBridge moves one bridge instance into the starting lifecycle state.

func (*BaseHandlers) EnableExtension

func (h *BaseHandlers) EnableExtension(c *gin.Context)

EnableExtension enables one installed extension.

func (*BaseHandlers) EnableMemoryProvider

func (h *BaseHandlers) EnableMemoryProvider(c *gin.Context)

func (*BaseHandlers) EnableSkill

func (h *BaseHandlers) EnableSkill(c *gin.Context)

EnableSkill enables a skill by name.

func (*BaseHandlers) EnqueueTaskRun

func (h *BaseHandlers) EnqueueTaskRun(c *gin.Context)

EnqueueTaskRun creates one new queue-first run for the supplied task.

func (*BaseHandlers) EventSummariesSnapshot

func (h *BaseHandlers) EventSummariesSnapshot(ctx context.Context) (contract.LogsListResponse, error)

EventSummariesSnapshot returns recent event summaries for support bundles.

func (*BaseHandlers) ExchangeSettingsMCPAuth

func (h *BaseHandlers) ExchangeSettingsMCPAuth(c *gin.Context)

ExchangeSettingsMCPAuth consumes one active PKCE session.

func (*BaseHandlers) ExecuteWindowManagerCommand

func (h *BaseHandlers) ExecuteWindowManagerCommand(c *gin.Context)

ExecuteWindowManagerCommand applies one semantic command through revision CAS.

func (*BaseHandlers) ExportWindowManagerLayout

func (h *BaseHandlers) ExportWindowManagerLayout(c *gin.Context)

ExportWindowManagerLayout returns a history-free declarative document.

func (*BaseHandlers) ExtensionProvenance

func (h *BaseHandlers) ExtensionProvenance(c *gin.Context)

ExtensionProvenance returns one installed extension's persisted trust report.

func (*BaseHandlers) ExtensionStatus

func (h *BaseHandlers) ExtensionStatus(c *gin.Context)

ExtensionStatus returns one installed extension's runtime status.

func (*BaseHandlers) FailTaskRun

func (h *BaseHandlers) FailTaskRun(c *gin.Context)

FailTaskRun marks one run as failed.

func (*BaseHandlers) FanOutTaskRuns

func (h *BaseHandlers) FanOutTaskRuns(c *gin.Context)

FanOutTaskRuns creates designated sibling runs for one task.

func (*BaseHandlers) ForceFailTaskRun

func (h *BaseHandlers) ForceFailTaskRun(c *gin.Context)

ForceFailTaskRun force fails one queued or claimed run without requiring the raw claim token.

func (*BaseHandlers) ForceReleaseTaskRun

func (h *BaseHandlers) ForceReleaseTaskRun(c *gin.Context)

ForceReleaseTaskRun force releases one claimed run without requiring the raw claim token.

func (*BaseHandlers) GetAgent

func (h *BaseHandlers) GetAgent(c *gin.Context)

GetAgent returns one agent definition by name.

func (*BaseHandlers) GetAgentHeartbeat

func (h *BaseHandlers) GetAgentHeartbeat(c *gin.Context)

GetAgentHeartbeat returns the resolved Heartbeat policy for one workspace-visible agent.

func (*BaseHandlers) GetAgentHeartbeatStatus

func (h *BaseHandlers) GetAgentHeartbeatStatus(c *gin.Context)

GetAgentHeartbeatStatus returns policy, wake state, and optional session health.

func (*BaseHandlers) GetAgentSoul

func (h *BaseHandlers) GetAgentSoul(c *gin.Context)

GetAgentSoul returns the resolved full Soul read model for one workspace-visible agent.

func (*BaseHandlers) GetAutomationJob

func (h *BaseHandlers) GetAutomationJob(c *gin.Context)

GetAutomationJob returns one automation job by id.

func (*BaseHandlers) GetAutomationRun

func (h *BaseHandlers) GetAutomationRun(c *gin.Context)

GetAutomationRun returns one automation run by id.

func (*BaseHandlers) GetAutomationTrigger

func (h *BaseHandlers) GetAutomationTrigger(c *gin.Context)

GetAutomationTrigger returns one automation trigger by id.

func (*BaseHandlers) GetBridge

func (h *BaseHandlers) GetBridge(c *gin.Context)

GetBridge returns one persisted bridge instance.

func (*BaseHandlers) GetBundleActivation

func (h *BaseHandlers) GetBundleActivation(c *gin.Context)

func (*BaseHandlers) GetDoctor

func (h *BaseHandlers) GetDoctor(c *gin.Context)

GetDoctor returns the hard-cut diagnostic probe payload shared by HTTP and UDS.

func (*BaseHandlers) GetLoop

func (h *BaseHandlers) GetLoop(c *gin.Context)

GetLoop inspects one resolved Loop definition.

func (*BaseHandlers) GetLoopAnnotations

func (h *BaseHandlers) GetLoopAnnotations(c *gin.Context)

GetLoopAnnotations returns editor node positions for one Loop.

func (*BaseHandlers) GetLoopConfig

func (h *BaseHandlers) GetLoopConfig(c *gin.Context)

GetLoopConfig returns one no-fork Loop config override.

func (*BaseHandlers) GetLoopInputDefault

func (h *BaseHandlers) GetLoopInputDefault(c *gin.Context)

GetLoopInputDefault returns one configured key with an explicit presence bit.

func (*BaseHandlers) GetLoopInputDefaults

func (h *BaseHandlers) GetLoopInputDefaults(c *gin.Context)

GetLoopInputDefaults returns one explicit file-backed defaults layer.

func (*BaseHandlers) GetLoopRun

func (h *BaseHandlers) GetLoopRun(c *gin.Context)

GetLoopRun returns one workspace-scoped Loop run.

func (*BaseHandlers) GetMarketplaceEntry

func (h *BaseHandlers) GetMarketplaceEntry(c *gin.Context)

GetMarketplaceEntry returns one exact marketplace detail by stable entry_id.

func (*BaseHandlers) GetMemoryDecision

func (h *BaseHandlers) GetMemoryDecision(c *gin.Context)

GetMemoryDecision returns one Memory v2 controller decision.

func (*BaseHandlers) GetMemoryDream

func (h *BaseHandlers) GetMemoryDream(c *gin.Context)

func (*BaseHandlers) GetMemoryDreamStatus

func (h *BaseHandlers) GetMemoryDreamStatus(c *gin.Context)

GetMemoryDreamStatus returns a truthful empty status until daemon wiring provides live dreaming runtime state.

func (*BaseHandlers) GetMemoryExtractorStatus

func (h *BaseHandlers) GetMemoryExtractorStatus(c *gin.Context)

func (*BaseHandlers) GetMemoryProvider

func (h *BaseHandlers) GetMemoryProvider(c *gin.Context)

func (*BaseHandlers) GetMemoryRecallTrace

func (h *BaseHandlers) GetMemoryRecallTrace(c *gin.Context)

func (*BaseHandlers) GetMemorySessionLedger

func (h *BaseHandlers) GetMemorySessionLedger(c *gin.Context)

func (*BaseHandlers) GetNetworkCoordination

func (h *BaseHandlers) GetNetworkCoordination(c *gin.Context)

GetNetworkCoordination returns one scope-explicit setting, invitation, and eligibility view.

func (*BaseHandlers) GetNetworkUsage

func (h *BaseHandlers) GetNetworkUsage(c *gin.Context)

GetNetworkUsage returns workspace-scoped wake usage from the ledger.

func (*BaseHandlers) GetNotificationPreset

func (h *BaseHandlers) GetNotificationPreset(c *gin.Context)

GetNotificationPreset returns one notification preset.

func (*BaseHandlers) GetOnboardingStatus

func (h *BaseHandlers) GetOnboardingStatus(c *gin.Context)

GetOnboardingStatus reports whether first-run onboarding has been completed.

func (*BaseHandlers) GetProvider

func (h *BaseHandlers) GetProvider(c *gin.Context)

GetProvider returns one canonical provider summary.

func (*BaseHandlers) GetResource

func (h *BaseHandlers) GetResource(c *gin.Context)

GetResource returns one desired-state resource by kind and id.

func (*BaseHandlers) GetRole

func (h *BaseHandlers) GetRole(c *gin.Context)

GetRole returns one effective role projection for an optional workspace.

func (*BaseHandlers) GetScheduler

func (h *BaseHandlers) GetScheduler(c *gin.Context)

GetScheduler exposes service-owned scheduler state without deriving queue pressure in the API.

func (*BaseHandlers) GetSchedulerBacklog

func (h *BaseHandlers) GetSchedulerBacklog(c *gin.Context)

GetSchedulerBacklog keeps pause-aware backlog projection behind the task service boundary.

func (*BaseHandlers) GetSession

func (h *BaseHandlers) GetSession(c *gin.Context)

GetSession returns one session snapshot.

func (*BaseHandlers) GetSessionByID

func (h *BaseHandlers) GetSessionByID(c *gin.Context)

GetSessionByID returns one session snapshot without requiring the caller to know its workspace.

func (*BaseHandlers) GetSessionGoal

func (h *BaseHandlers) GetSessionGoal(c *gin.Context)

GetSessionGoal returns the newest visible session-origin Goal or an explicit null projection.

func (*BaseHandlers) GetSessionHealth

func (h *BaseHandlers) GetSessionHealth(c *gin.Context)

GetSessionHealth returns metadata-only session health and wake eligibility.

func (*BaseHandlers) GetSessionStatus

func (h *BaseHandlers) GetSessionStatus(c *gin.Context)

GetSessionStatus returns compact session health with wake state when available.

func (*BaseHandlers) GetSettingsAutomation

func (h *BaseHandlers) GetSettingsAutomation(c *gin.Context)

GetSettingsAutomation returns the automation settings section.

func (*BaseHandlers) GetSettingsGeneral

func (h *BaseHandlers) GetSettingsGeneral(c *gin.Context)

GetSettingsGeneral returns the general settings section.

func (*BaseHandlers) GetSettingsHooksExtensions

func (h *BaseHandlers) GetSettingsHooksExtensions(c *gin.Context)

GetSettingsHooksExtensions returns the hooks and extensions settings section.

func (*BaseHandlers) GetSettingsMemory

func (h *BaseHandlers) GetSettingsMemory(c *gin.Context)

GetSettingsMemory returns the memory settings section.

func (*BaseHandlers) GetSettingsNetwork

func (h *BaseHandlers) GetSettingsNetwork(c *gin.Context)

GetSettingsNetwork returns the network settings section.

func (*BaseHandlers) GetSettingsObservability

func (h *BaseHandlers) GetSettingsObservability(c *gin.Context)

GetSettingsObservability returns the observability settings section.

func (*BaseHandlers) GetSettingsProvider

func (h *BaseHandlers) GetSettingsProvider(c *gin.Context)

GetSettingsProvider returns one provider settings item.

func (*BaseHandlers) GetSettingsRestartStatus

func (h *BaseHandlers) GetSettingsRestartStatus(c *gin.Context)

GetSettingsRestartStatus returns the persisted restart operation payload.

func (*BaseHandlers) GetSettingsRoles

func (h *BaseHandlers) GetSettingsRoles(c *gin.Context)

GetSettingsRoles returns the background-role routing settings section.

func (*BaseHandlers) GetSettingsSandbox

func (h *BaseHandlers) GetSettingsSandbox(c *gin.Context)

GetSettingsSandbox returns one sandbox settings item.

func (*BaseHandlers) GetSettingsSkills

func (h *BaseHandlers) GetSettingsSkills(c *gin.Context)

GetSettingsSkills returns the skills settings section.

func (*BaseHandlers) GetSettingsUpdate

func (h *BaseHandlers) GetSettingsUpdate(c *gin.Context)

GetSettingsUpdate returns the current software update status snapshot.

func (*BaseHandlers) GetSettingsWindowManager

func (h *BaseHandlers) GetSettingsWindowManager(c *gin.Context)

GetSettingsWindowManager returns the window-manager settings section.

func (*BaseHandlers) GetSkill

func (h *BaseHandlers) GetSkill(c *gin.Context)

GetSkill returns one skill by name.

func (*BaseHandlers) GetSkillContent

func (h *BaseHandlers) GetSkillContent(c *gin.Context)

GetSkillContent returns the explicit body for one skill.

func (*BaseHandlers) GetSkillShadows

func (h *BaseHandlers) GetSkillShadows(c *gin.Context)

GetSkillShadows returns every declaration involved in resolving one skill.

func (*BaseHandlers) GetSlackBridgeManifest

func (h *BaseHandlers) GetSlackBridgeManifest(c *gin.Context)

GetSlackBridgeManifest returns the Slack app manifest for one persisted instance.

func (*BaseHandlers) GetStatus

func (h *BaseHandlers) GetStatus(c *gin.Context)

GetStatus returns the hard-cut runtime status payload shared by HTTP and UDS.

func (*BaseHandlers) GetSupportBundle

func (h *BaseHandlers) GetSupportBundle(c *gin.Context)

GetSupportBundle returns the current status for one support bundle operation.

func (*BaseHandlers) GetTask

func (h *BaseHandlers) GetTask(c *gin.Context)

GetTask returns one expanded task view.

func (*BaseHandlers) GetTaskBridgeNotificationSubscription

func (h *BaseHandlers) GetTaskBridgeNotificationSubscription(c *gin.Context)

GetTaskBridgeNotificationSubscription returns one task-scoped terminal bridge notification target.

func (*BaseHandlers) GetTaskExecutionProfile

func (h *BaseHandlers) GetTaskExecutionProfile(c *gin.Context)

GetTaskExecutionProfile returns one task-owned execution profile.

func (*BaseHandlers) GetTaskRun

func (h *BaseHandlers) GetTaskRun(c *gin.Context)

GetTaskRun returns one run-detail view.

func (*BaseHandlers) GetTaskRunReview

func (h *BaseHandlers) GetTaskRunReview(c *gin.Context)

GetTaskRunReview returns one task-run review.

func (*BaseHandlers) GetTool

func (h *BaseHandlers) GetTool(c *gin.Context)

GetTool returns one operator-visible tool projection.

func (*BaseHandlers) GetToolset

func (h *BaseHandlers) GetToolset(c *gin.Context)

GetToolset returns one named toolset with expansion diagnostics.

func (*BaseHandlers) GetVaultSecretMetadata

func (h *BaseHandlers) GetVaultSecretMetadata(c *gin.Context)

GetVaultSecretMetadata returns redacted metadata for one vault-backed secret.

func (*BaseHandlers) GetWindowManagerSnapshot

func (h *BaseHandlers) GetWindowManagerSnapshot(c *gin.Context)

GetWindowManagerSnapshot returns the complete authorized workspace aggregate.

func (*BaseHandlers) GetWorkspace

func (h *BaseHandlers) GetWorkspace(c *gin.Context)

GetWorkspace returns one resolved workspace with related sessions, agents, and skills.

func (*BaseHandlers) HTTPPortValue

func (h *BaseHandlers) HTTPPortValue() int

HTTPPortValue returns the configured HTTP port in a concurrency-safe way.

func (*BaseHandlers) HookCatalog

func (h *BaseHandlers) HookCatalog(c *gin.Context)

HookCatalog returns the resolved hook catalog for the supplied workspace and agent view.

func (*BaseHandlers) HookEvents

func (h *BaseHandlers) HookEvents(c *gin.Context)

HookEvents returns the supported hook taxonomy metadata.

func (*BaseHandlers) HookRuns

func (h *BaseHandlers) HookRuns(c *gin.Context)

HookRuns returns persisted hook execution history for a session.

func (*BaseHandlers) InspectRun

func (h *BaseHandlers) InspectRun(c *gin.Context)

InspectRun returns a diagnostic snapshot rooted at one run.

func (*BaseHandlers) InspectSession

func (h *BaseHandlers) InspectSession(c *gin.Context)

InspectSession returns detailed health, wake audit, and policy correlation metadata.

func (*BaseHandlers) InspectTask

func (h *BaseHandlers) InspectTask(c *gin.Context)

InspectTask returns a diagnostic snapshot for one task.

func (*BaseHandlers) InstallExtension

func (h *BaseHandlers) InstallExtension(c *gin.Context)

InstallExtension installs either a local path or a marketplace slug via the daemon.

func (*BaseHandlers) InstallSettingsMCPServer

func (h *BaseHandlers) InstallSettingsMCPServer(c *gin.Context)

InstallSettingsMCPServer installs one curated MCP template through the settings lifecycle.

func (*BaseHandlers) InstallSkillMarketplace

func (h *BaseHandlers) InstallSkillMarketplace(c *gin.Context)

InstallSkillMarketplace installs one remote marketplace skill.

func (*BaseHandlers) InvokeTool

func (h *BaseHandlers) InvokeTool(c *gin.Context)

InvokeTool dispatches a concrete tool invocation through the registry.

func (*BaseHandlers) ListAgentCatalog

func (h *BaseHandlers) ListAgentCatalog(c *gin.Context)

ListAgentCatalog returns one filtered, counted workspace fleet page with exact per-agent session metrics when the session authority is available.

func (*BaseHandlers) ListAgentHeartbeatHistory

func (h *BaseHandlers) ListAgentHeartbeatHistory(c *gin.Context)

ListAgentHeartbeatHistory lists HEARTBEAT.md managed authoring revisions.

func (*BaseHandlers) ListAgentSoulHistory

func (h *BaseHandlers) ListAgentSoulHistory(c *gin.Context)

ListAgentSoulHistory lists SOUL.md managed authoring revisions.

func (*BaseHandlers) ListAgents

func (h *BaseHandlers) ListAgents(c *gin.Context)

ListAgents returns all readable agent definitions in home paths.

func (*BaseHandlers) ListAutomationJobs

func (h *BaseHandlers) ListAutomationJobs(c *gin.Context)

ListAutomationJobs returns the filtered automation job list.

func (*BaseHandlers) ListAutomationRuns

func (h *BaseHandlers) ListAutomationRuns(c *gin.Context)

ListAutomationRuns returns filtered automation run history.

func (*BaseHandlers) ListAutomationSuggestions

func (h *BaseHandlers) ListAutomationSuggestions(c *gin.Context)

ListAutomationSuggestions returns one workspace's consent-first Job proposals.

func (*BaseHandlers) ListAutomationTriggers

func (h *BaseHandlers) ListAutomationTriggers(c *gin.Context)

ListAutomationTriggers returns the filtered automation trigger list.

func (*BaseHandlers) ListBridgeProviders

func (h *BaseHandlers) ListBridgeProviders(c *gin.Context)

ListBridgeProviders returns installed bridge-capable providers.

func (*BaseHandlers) ListBridgeRoutes

func (h *BaseHandlers) ListBridgeRoutes(c *gin.Context)

ListBridgeRoutes returns the persisted routes owned by one bridge instance.

func (*BaseHandlers) ListBridgeSecretBindings

func (h *BaseHandlers) ListBridgeSecretBindings(c *gin.Context)

ListBridgeSecretBindings returns the persisted secret bindings for one bridge instance.

func (*BaseHandlers) ListBridgeTargets

func (h *BaseHandlers) ListBridgeTargets(c *gin.Context)

ListBridgeTargets returns the daemon-owned target directory for one bridge instance.

func (*BaseHandlers) ListBridges

func (h *BaseHandlers) ListBridges(c *gin.Context)

ListBridges returns one bounded page from the shared public bridge catalog.

func (*BaseHandlers) ListBundleActivations

func (h *BaseHandlers) ListBundleActivations(c *gin.Context)

func (*BaseHandlers) ListBundleCatalog

func (h *BaseHandlers) ListBundleCatalog(c *gin.Context)

func (*BaseHandlers) ListExtensions

func (h *BaseHandlers) ListExtensions(c *gin.Context)

ListExtensions returns daemon-owned installed extension state.

func (*BaseHandlers) ListGoalTurns

func (h *BaseHandlers) ListGoalTurns(c *gin.Context)

ListGoalTurns returns one validated run-wide Goal audit page.

func (*BaseHandlers) ListLogs

func (h *BaseHandlers) ListLogs(c *gin.Context)

ListLogs returns the filtered runtime log list.

func (*BaseHandlers) ListLoopRuns

func (h *BaseHandlers) ListLoopRuns(c *gin.Context)

ListLoopRuns returns workspace-scoped Loop runs.

func (*BaseHandlers) ListLoops

func (h *BaseHandlers) ListLoops(c *gin.Context)

ListLoops returns one bounded workspace Loop catalog page.

func (*BaseHandlers) ListMemory

func (h *BaseHandlers) ListMemory(c *gin.Context)

ListMemory lists one bounded page of memory headers for the requested selector.

func (*BaseHandlers) ListMemoryDailyLogs

func (h *BaseHandlers) ListMemoryDailyLogs(c *gin.Context)

func (*BaseHandlers) ListMemoryDecisions

func (h *BaseHandlers) ListMemoryDecisions(c *gin.Context)

ListMemoryDecisions returns filtered Memory v2 controller decisions.

func (*BaseHandlers) ListMemoryDreams

func (h *BaseHandlers) ListMemoryDreams(c *gin.Context)

func (*BaseHandlers) ListMemoryExtractorFailures

func (h *BaseHandlers) ListMemoryExtractorFailures(c *gin.Context)

func (*BaseHandlers) ListMemoryProviders

func (h *BaseHandlers) ListMemoryProviders(c *gin.Context)

func (*BaseHandlers) ListNotificationPresets

func (h *BaseHandlers) ListNotificationPresets(c *gin.Context)

ListNotificationPresets returns all persisted notification presets.

func (*BaseHandlers) ListProviders

func (h *BaseHandlers) ListProviders(c *gin.Context)

ListProviders returns the canonical provider inventory and declared auth readiness.

func (*BaseHandlers) ListResources

func (h *BaseHandlers) ListResources(c *gin.Context)

ListResources lists desired-state resources under the shared operator service.

func (*BaseHandlers) ListRoles

func (h *BaseHandlers) ListRoles(c *gin.Context)

ListRoles returns the closed effective role roster for an optional workspace.

func (*BaseHandlers) ListSessionClarifications

func (h *BaseHandlers) ListSessionClarifications(c *gin.Context)

ListSessionClarifications returns only the broker's live projection for one authorized session.

func (*BaseHandlers) ListSessionTools

func (h *BaseHandlers) ListSessionTools(c *gin.Context)

ListSessionTools returns the session/model-callable projection.

func (*BaseHandlers) ListSessions

func (h *BaseHandlers) ListSessions(c *gin.Context)

ListSessions returns one bounded page from the shared public session catalog.

func (*BaseHandlers) ListSettingsApplyRecords

func (h *BaseHandlers) ListSettingsApplyRecords(c *gin.Context)

ListSettingsApplyRecords returns persisted config apply history.

func (*BaseHandlers) ListSettingsHooks

func (h *BaseHandlers) ListSettingsHooks(c *gin.Context)

ListSettingsHooks returns the hook settings collection.

func (*BaseHandlers) ListSettingsMCPServers

func (h *BaseHandlers) ListSettingsMCPServers(c *gin.Context)

ListSettingsMCPServers returns the MCP server settings collection.

func (*BaseHandlers) ListSettingsProviders

func (h *BaseHandlers) ListSettingsProviders(c *gin.Context)

ListSettingsProviders returns the provider settings collection.

func (*BaseHandlers) ListSettingsSandboxes

func (h *BaseHandlers) ListSettingsSandboxes(c *gin.Context)

ListSettingsSandboxes returns the sandbox settings collection.

func (*BaseHandlers) ListSkills

func (h *BaseHandlers) ListSkills(c *gin.Context)

ListSkills returns skills for the selected workspace or global scope.

func (*BaseHandlers) ListTaskBlocks

func (h *BaseHandlers) ListTaskBlocks(c *gin.Context)

ListTaskBlocks returns task block rows for one task.

func (*BaseHandlers) ListTaskBridgeNotificationSubscriptions

func (h *BaseHandlers) ListTaskBridgeNotificationSubscriptions(c *gin.Context)

ListTaskBridgeNotificationSubscriptions returns task-scoped terminal bridge notification targets.

func (*BaseHandlers) ListTaskReviews

func (h *BaseHandlers) ListTaskReviews(c *gin.Context)

ListTaskReviews lists reviews scoped to one task.

func (*BaseHandlers) ListTaskRunReviews

func (h *BaseHandlers) ListTaskRunReviews(c *gin.Context)

ListTaskRunReviews lists reviews scoped to one task run.

func (*BaseHandlers) ListTaskRuns

func (h *BaseHandlers) ListTaskRuns(c *gin.Context)

ListTaskRuns returns the filtered run list for one task.

func (*BaseHandlers) ListTasks

func (h *BaseHandlers) ListTasks(c *gin.Context)

ListTasks returns the filtered task list.

func (*BaseHandlers) ListToolApprovalGrants

func (h *BaseHandlers) ListToolApprovalGrants(c *gin.Context)

ListToolApprovalGrants returns remembered native-tool decisions for one resolved workspace.

func (*BaseHandlers) ListTools

func (h *BaseHandlers) ListTools(c *gin.Context)

ListTools returns the operator-visible registry projection.

func (*BaseHandlers) ListToolsets

func (h *BaseHandlers) ListToolsets(c *gin.Context)

ListToolsets returns named toolsets with expansion diagnostics.

func (*BaseHandlers) ListVaultSecrets

func (h *BaseHandlers) ListVaultSecrets(c *gin.Context)

ListVaultSecrets returns redacted metadata for vault-backed secrets.

func (*BaseHandlers) ListWindowManagerClients

func (h *BaseHandlers) ListWindowManagerClients(c *gin.Context)

ListWindowManagerClients returns client-local views in one workspace partition.

func (*BaseHandlers) ListWindowManagerLayoutProfiles

func (h *BaseHandlers) ListWindowManagerLayoutProfiles(c *gin.Context)

ListWindowManagerLayoutProfiles lists global and route-workspace layout profiles.

func (*BaseHandlers) ListWorkspaces

func (h *BaseHandlers) ListWorkspaces(c *gin.Context)

ListWorkspaces returns all registered workspaces.

func (*BaseHandlers) LogoutSettingsMCPAuth

func (h *BaseHandlers) LogoutSettingsMCPAuth(c *gin.Context)

LogoutSettingsMCPAuth revokes and removes one scoped credential set.

func (*BaseHandlers) MarkTaskRead

func (h *BaseHandlers) MarkTaskRead(c *gin.Context)

MarkTaskRead marks one task triage record as read for the current actor.

func (*BaseHandlers) MarketplaceEntry

MarketplaceEntry resolves one exact marketplace entry through the shared core seam.

func (*BaseHandlers) MarketplaceKind

MarketplaceKind resolves one discovery kind through the shared core seam.

func (*BaseHandlers) MarketplaceSearch

MarketplaceSearch resolves grouped discovery for HTTP, UDS, CLI, and native-tool adapters.

func (*BaseHandlers) MemoryConfigMetadata

func (h *BaseHandlers) MemoryConfigMetadata(c *gin.Context)

MemoryConfigMetadata returns settings/config metadata that is safe for agents.

func (*BaseHandlers) MemoryHealth

func (h *BaseHandlers) MemoryHealth(c *gin.Context)

MemoryHealth returns the memory-specific health snapshot.

func (*BaseHandlers) MemoryHealthWorkspaces

func (h *BaseHandlers) MemoryHealthWorkspaces(ctx context.Context, rawWorkspace string) ([]string, error)

MemoryHealthWorkspaces returns the workspaces considered for memory health checks.

func (*BaseHandlers) MemoryHistory

func (h *BaseHandlers) MemoryHistory(c *gin.Context)

MemoryHistory returns bounded, redacted memory operation history.

func (*BaseHandlers) MemoryScopeShow

func (h *BaseHandlers) MemoryScopeShow(c *gin.Context)

MemoryScopeShow reports the effective selector and precedence chain.

func (*BaseHandlers) ModelCatalogRoute

func (h *BaseHandlers) ModelCatalogRoute(c *gin.Context)

ModelCatalogRoute dispatches the native provider model catalog route family.

func (*BaseHandlers) NetworkChannel

func (h *BaseHandlers) NetworkChannel(c *gin.Context)

NetworkChannel returns one network channel detail payload.

func (*BaseHandlers) NetworkChannelMessages

func (h *BaseHandlers) NetworkChannelMessages(c *gin.Context)

NetworkChannelMessages returns the read-only message timeline for one network channel.

func (*BaseHandlers) NetworkChannels

func (h *BaseHandlers) NetworkChannels(c *gin.Context)

NetworkChannels returns the active runtime channels and, when requested, a bounded cross-channel recent-conversation projection in the same request.

func (*BaseHandlers) NetworkDirectRoom

func (h *BaseHandlers) NetworkDirectRoom(c *gin.Context)

NetworkDirectRoom returns one direct-room summary.

func (*BaseHandlers) NetworkDirectRoomMessages

func (h *BaseHandlers) NetworkDirectRoomMessages(c *gin.Context)

NetworkDirectRoomMessages returns one stable cursor page for a direct room.

func (*BaseHandlers) NetworkDirectRooms

func (h *BaseHandlers) NetworkDirectRooms(c *gin.Context)

NetworkDirectRooms returns one stable cursor page of direct-room summaries.

func (*BaseHandlers) NetworkInbox

func (h *BaseHandlers) NetworkInbox(c *gin.Context)

NetworkInbox returns the queued inbound envelopes for one local session.

func (*BaseHandlers) NetworkPeer

func (h *BaseHandlers) NetworkPeer(c *gin.Context)

NetworkPeer returns one selected peer detail payload.

func (*BaseHandlers) NetworkPeerMessages

func (h *BaseHandlers) NetworkPeerMessages(c *gin.Context)

NetworkPeerMessages returns the directed message timeline for one network peer.

func (*BaseHandlers) NetworkPeers

func (h *BaseHandlers) NetworkPeers(c *gin.Context)

NetworkPeers returns the current visible peers, optionally filtered by channel.

func (*BaseHandlers) NetworkSend

func (h *BaseHandlers) NetworkSend(c *gin.Context)

NetworkSend validates and forwards one outbound network send request.

func (*BaseHandlers) NetworkStatus

func (h *BaseHandlers) NetworkStatus(c *gin.Context)

NetworkStatus returns the current daemon-owned network runtime status.

func (*BaseHandlers) NetworkSubscriptions

func (h *BaseHandlers) NetworkSubscriptions(c *gin.Context)

NetworkSubscriptions returns peer delivery preferences for a channel or thread.

func (*BaseHandlers) NetworkThread

func (h *BaseHandlers) NetworkThread(c *gin.Context)

NetworkThread returns one public-thread summary.

func (*BaseHandlers) NetworkThreadMessages

func (h *BaseHandlers) NetworkThreadMessages(c *gin.Context)

NetworkThreadMessages returns one stable cursor page for a public thread.

func (*BaseHandlers) NetworkThreads

func (h *BaseHandlers) NetworkThreads(c *gin.Context)

NetworkThreads returns one stable cursor page of public-thread summaries.

func (*BaseHandlers) NetworkWork

func (h *BaseHandlers) NetworkWork(c *gin.Context)

NetworkWork returns one network work row by work_id.

func (*BaseHandlers) ObserveOverview

func (h *BaseHandlers) ObserveOverview(c *gin.Context)

ObserveOverview returns the observer-backed home overview read model.

func (*BaseHandlers) OpenAIModels

func (h *BaseHandlers) OpenAIModels(c *gin.Context)

OpenAIModels lists catalog models using the OpenAI-compatible shape.

func (*BaseHandlers) PatchLoop

func (h *BaseHandlers) PatchLoop(c *gin.Context)

PatchLoop atomically lints, compiles, and publishes one Loop definition.

func (*BaseHandlers) PauseLoopRun

func (h *BaseHandlers) PauseLoopRun(c *gin.Context)

PauseLoopRun requests operator pause for one Loop run.

func (*BaseHandlers) PauseScheduler

func (h *BaseHandlers) PauseScheduler(c *gin.Context)

PauseScheduler delegates global pause state to the task service's transactional controls.

func (*BaseHandlers) PauseTask

func (h *BaseHandlers) PauseTask(c *gin.Context)

PauseTask routes task pauses through the service so claim eligibility remains centralized.

func (*BaseHandlers) PreviewBundleActivation

func (h *BaseHandlers) PreviewBundleActivation(c *gin.Context)

func (*BaseHandlers) PreviewWindowManagerCommand

func (h *BaseHandlers) PreviewWindowManagerCommand(c *gin.Context)

PreviewWindowManagerCommand validates one semantic command without persisting it.

func (*BaseHandlers) ProbeProviderAuth

func (h *BaseHandlers) ProbeProviderAuth(c *gin.Context)

ProbeProviderAuth runs a live provider auth status command.

func (*BaseHandlers) PromoteMemory

func (h *BaseHandlers) PromoteMemory(c *gin.Context)

func (*BaseHandlers) PromoteNetworkThreadTask

func (h *BaseHandlers) PromoteNetworkThreadTask(c *gin.Context)

PromoteNetworkThreadTask creates a durable task from a public-thread message.

func (*BaseHandlers) PromptCallerForWorkspace

func (h *BaseHandlers) PromptCallerForWorkspace(
	c *gin.Context,
	workspaceID string,
) (session.PromptCaller, error)

PromptCallerForWorkspace derives the authenticated prompt caller for external ingress.

func (*BaseHandlers) ProviderListSnapshot

func (h *BaseHandlers) ProviderListSnapshot(ctx context.Context) (contract.ProviderListResponse, error)

ProviderListSnapshot returns the same provider inventory payload used by /api/providers.

func (*BaseHandlers) PruneMemorySessions

func (h *BaseHandlers) PruneMemorySessions(c *gin.Context)

func (*BaseHandlers) PublishTask

func (h *BaseHandlers) PublishTask(c *gin.Context)

PublishTask publishes one draft task into the canonical runnable lifecycle.

func (*BaseHandlers) PutAgentHeartbeat

func (h *BaseHandlers) PutAgentHeartbeat(c *gin.Context)

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

func (*BaseHandlers) PutAgentSoul

func (h *BaseHandlers) PutAgentSoul(c *gin.Context)

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

func (*BaseHandlers) PutBridgeSecretBinding

func (h *BaseHandlers) PutBridgeSecretBinding(c *gin.Context)

PutBridgeSecretBinding creates or updates one bridge secret binding.

func (*BaseHandlers) PutLoopAnnotations

func (h *BaseHandlers) PutLoopAnnotations(c *gin.Context)

PutLoopAnnotations replaces editor node positions for one Loop.

func (*BaseHandlers) PutLoopConfig

func (h *BaseHandlers) PutLoopConfig(c *gin.Context)

PutLoopConfig replaces one no-fork Loop config override.

func (*BaseHandlers) PutLoopInputDefault

func (h *BaseHandlers) PutLoopInputDefault(c *gin.Context)

PutLoopInputDefault sets one configured key at one explicit scope.

func (*BaseHandlers) PutLoopInputDefaults

func (h *BaseHandlers) PutLoopInputDefaults(c *gin.Context)

PutLoopInputDefaults replaces one Loop defaults table at one explicit scope.

func (*BaseHandlers) PutNetworkCoordination

func (h *BaseHandlers) PutNetworkCoordination(c *gin.Context)

PutNetworkCoordination compare-and-sets one future-run coordination scope.

func (*BaseHandlers) PutNetworkCoordinationInvitation

func (h *BaseHandlers) PutNetworkCoordinationInvitation(c *gin.Context)

PutNetworkCoordinationInvitation compare-and-sets one durable invitation disposition.

func (*BaseHandlers) PutResource

func (h *BaseHandlers) PutResource(c *gin.Context)

PutResource creates or updates one desired-state resource.

func (*BaseHandlers) PutSettingsHook

func (h *BaseHandlers) PutSettingsHook(c *gin.Context)

PutSettingsHook upserts one hook settings item.

func (*BaseHandlers) PutSettingsMCPServer

func (h *BaseHandlers) PutSettingsMCPServer(c *gin.Context)

PutSettingsMCPServer upserts one MCP server settings item.

func (*BaseHandlers) PutSettingsProvider

func (h *BaseHandlers) PutSettingsProvider(c *gin.Context)

PutSettingsProvider upserts one provider settings item.

func (*BaseHandlers) PutSettingsSandbox

func (h *BaseHandlers) PutSettingsSandbox(c *gin.Context)

PutSettingsSandbox upserts one sandbox settings item.

func (*BaseHandlers) PutVaultSecret

func (h *BaseHandlers) PutVaultSecret(c *gin.Context)

PutVaultSecret stores one write-only vault secret and returns redacted metadata.

func (*BaseHandlers) PutWindowManagerLayoutProfile

func (h *BaseHandlers) PutWindowManagerLayoutProfile(c *gin.Context)

PutWindowManagerLayoutProfile creates or replaces one route-workspace-visible profile.

func (*BaseHandlers) ReadMemory

func (h *BaseHandlers) ReadMemory(c *gin.Context)

ReadMemory returns one memory document.

func (*BaseHandlers) ReadToolArtifact

func (h *BaseHandlers) ReadToolArtifact(c *gin.Context)

ReadToolArtifact returns one retained result page within the resolved workspace.

func (*BaseHandlers) RecoverTask

func (h *BaseHandlers) RecoverTask(c *gin.Context)

RecoverTask clears task-level needs_attention state.

func (*BaseHandlers) RecoverTaskRun

func (h *BaseHandlers) RecoverTaskRun(c *gin.Context)

RecoverTaskRun terminalizes one needs_attention run and queues a fresh child to resume work.

func (*BaseHandlers) RefreshMarketplaceCatalog

func (h *BaseHandlers) RefreshMarketplaceCatalog(c *gin.Context)

RefreshMarketplaceCatalog refreshes all or one feed-backed marketplace kind.

func (*BaseHandlers) RefreshSessionSoul

func (h *BaseHandlers) RefreshSessionSoul(c *gin.Context)

RefreshSessionSoul refreshes an idle session's Soul snapshot through body-level CAS.

func (*BaseHandlers) RegisterBridgeWebhook

func (h *BaseHandlers) RegisterBridgeWebhook(c *gin.Context)

RegisterBridgeWebhook asks the owning adapter to register its configured callback.

func (*BaseHandlers) RegisterWindowManagerClient

func (h *BaseHandlers) RegisterWindowManagerClient(c *gin.Context)

RegisterWindowManagerClient creates or refreshes one explicit client-local view.

func (*BaseHandlers) ReindexMemory

func (h *BaseHandlers) ReindexMemory(c *gin.Context)

ReindexMemory rebuilds the derived memory catalog from Markdown memory files.

func (*BaseHandlers) RejectTask

func (h *BaseHandlers) RejectTask(c *gin.Context)

RejectTask records one rejection decision for an approval-gated task.

func (*BaseHandlers) ReloadMemory

func (h *BaseHandlers) ReloadMemory(c *gin.Context)

func (*BaseHandlers) ReloadSettings

func (h *BaseHandlers) ReloadSettings(c *gin.Context)

ReloadSettings reconciles desired config.toml with the daemon active generation.

func (*BaseHandlers) RemoveExtension

func (h *BaseHandlers) RemoveExtension(c *gin.Context)

RemoveExtension removes one managed extension via the daemon.

func (*BaseHandlers) RemoveSkillMarketplace

func (h *BaseHandlers) RemoveSkillMarketplace(c *gin.Context)

RemoveSkillMarketplace removes one installed marketplace skill.

func (*BaseHandlers) RemoveTaskDependency

func (h *BaseHandlers) RemoveTaskDependency(c *gin.Context)

RemoveTaskDependency removes one blocking dependency edge.

func (*BaseHandlers) RepairMemorySessions

func (h *BaseHandlers) RepairMemorySessions(c *gin.Context)

func (*BaseHandlers) RepairSession

func (h *BaseHandlers) RepairSession(c *gin.Context)

RepairSession inspects and optionally repairs an interrupted persisted session transcript.

func (*BaseHandlers) ReplaceWindowManagerLayout

func (h *BaseHandlers) ReplaceWindowManagerLayout(c *gin.Context)

ReplaceWindowManagerLayout applies a declarative document through revision CAS.

func (*BaseHandlers) ReplayMemorySession

func (h *BaseHandlers) ReplayMemorySession(c *gin.Context)

func (*BaseHandlers) RequestTaskRunReview

func (h *BaseHandlers) RequestTaskRunReview(c *gin.Context)

RequestTaskRunReview creates or replays one authoritative review request for a task run.

func (*BaseHandlers) RequireRouteSessionInWorkspace

func (h *BaseHandlers) RequireRouteSessionInWorkspace(c *gin.Context) (string, bool)

RequireRouteSessionInWorkspace validates that the route session id belongs to the workspace route scope before transport-specific handlers open the session.

func (*BaseHandlers) ResetMemory

func (h *BaseHandlers) ResetMemory(c *gin.Context)

func (*BaseHandlers) ResetOnboarding

func (h *BaseHandlers) ResetOnboarding(c *gin.Context)

ResetOnboarding clears the onboarding completion flag so the wizard runs again.

func (*BaseHandlers) ResolveBridgeTarget

func (h *BaseHandlers) ResolveBridgeTarget(c *gin.Context)

ResolveBridgeTarget resolves a friendly bridge target name without sending.

func (*BaseHandlers) ResolveMemoryLocation

func (h *BaseHandlers) ResolveMemoryLocation(
	filename string,
	rawScope string,
	rawWorkspace string,
) (MemoryLocation, error)

ResolveMemoryLocation resolves the storage location for a memory document.

func (*BaseHandlers) ResolveNetworkDirectRoom

func (h *BaseHandlers) ResolveNetworkDirectRoom(c *gin.Context)

ResolveNetworkDirectRoom creates or returns a deterministic two-party direct room.

func (*BaseHandlers) ResolveWorkspace

func (h *BaseHandlers) ResolveWorkspace(c *gin.Context)

ResolveWorkspace resolves or registers a workspace from a path.

func (*BaseHandlers) RestartBridge

func (h *BaseHandlers) RestartBridge(c *gin.Context)

RestartBridge restarts one bridge instance while preserving route ownership.

func (*BaseHandlers) ResumeLoopRun

func (h *BaseHandlers) ResumeLoopRun(c *gin.Context)

ResumeLoopRun resumes one paused Loop run.

func (*BaseHandlers) ResumeScheduler

func (h *BaseHandlers) ResumeScheduler(c *gin.Context)

ResumeScheduler clears global pause state through the same control store that claims read.

func (*BaseHandlers) ResumeSession

func (h *BaseHandlers) ResumeSession(c *gin.Context)

ResumeSession attaches a caller to an eligible live session.

func (*BaseHandlers) ResumeTask

func (h *BaseHandlers) ResumeTask(c *gin.Context)

ResumeTask keeps pause recovery on the same service path that owns claim eligibility.

func (*BaseHandlers) RetryMemoryDream

func (h *BaseHandlers) RetryMemoryDream(c *gin.Context)

func (*BaseHandlers) RetryMemoryExtractor

func (h *BaseHandlers) RetryMemoryExtractor(c *gin.Context)

func (*BaseHandlers) RetryTaskRun

func (h *BaseHandlers) RetryTaskRun(c *gin.Context)

RetryTaskRun enqueues a new run linked to one failed source run.

func (*BaseHandlers) RevertMemoryDecision

func (h *BaseHandlers) RevertMemoryDecision(c *gin.Context)

RevertMemoryDecision re-applies prior content for one persisted decision.

func (*BaseHandlers) RevokeToolApprovalGrant

func (h *BaseHandlers) RevokeToolApprovalGrant(c *gin.Context)

RevokeToolApprovalGrant removes one remembered native-tool decision from the resolved workspace.

func (*BaseHandlers) RollbackAgentHeartbeat

func (h *BaseHandlers) RollbackAgentHeartbeat(c *gin.Context)

RollbackAgentHeartbeat rolls HEARTBEAT.md back to a prior revision or snapshot digest.

func (*BaseHandlers) RollbackAgentSoul

func (h *BaseHandlers) RollbackAgentSoul(c *gin.Context)

RollbackAgentSoul rolls SOUL.md back to a prior managed revision.

func (*BaseHandlers) RunLoop

func (h *BaseHandlers) RunLoop(c *gin.Context)

RunLoop starts or dry-runs a Loop.

func (*BaseHandlers) SearchMarketplace

func (h *BaseHandlers) SearchMarketplace(c *gin.Context)

SearchMarketplace returns fixed-order grouped marketplace discovery results.

func (*BaseHandlers) SearchMemory

func (h *BaseHandlers) SearchMemory(c *gin.Context)

SearchMemory returns ranked durable memory matches.

func (*BaseHandlers) SearchSessionTools

func (h *BaseHandlers) SearchSessionTools(c *gin.Context)

SearchSessionTools searches only within the session/model-callable projection.

func (*BaseHandlers) SearchTools

func (h *BaseHandlers) SearchTools(c *gin.Context)

SearchTools searches the operator-visible registry projection.

func (*BaseHandlers) SelectMemoryProvider

func (h *BaseHandlers) SelectMemoryProvider(c *gin.Context)

func (*BaseHandlers) SendBridgeTest

func (h *BaseHandlers) SendBridgeTest(c *gin.Context)

SendBridgeTest performs one synchronous delivery through the real provider adapter.

func (*BaseHandlers) SessionEvents

func (h *BaseHandlers) SessionEvents(c *gin.Context)

SessionEvents returns the filtered session event list.

func (*BaseHandlers) SessionHistory

func (h *BaseHandlers) SessionHistory(c *gin.Context)

SessionHistory returns the grouped turn history for a session.

func (*BaseHandlers) SessionRecap

func (h *BaseHandlers) SessionRecap(c *gin.Context)

SessionRecap returns a deterministic recap composed from persisted session state.

func (*BaseHandlers) SessionTranscript

func (h *BaseHandlers) SessionTranscript(c *gin.Context)

SessionTranscript returns one bounded materialized transcript page.

func (*BaseHandlers) SessionUsage

func (h *BaseHandlers) SessionUsage(c *gin.Context)

SessionUsage returns the aggregated token-usage summary for one session.

The summary is sourced from the daemon's authoritative per-session token-stats aggregate (populated by the observer as usage-bearing agent events are seen), so the web inspector Usage tab renders real data instead of a structurally empty metric surface. A session that never reported usage yields an empty summary (turn_count 0, absent token/cost fields) rather than a fabricated zero grid.

func (*BaseHandlers) SessionsSnapshot

func (h *BaseHandlers) SessionsSnapshot(ctx context.Context) (contract.SessionsResponse, error)

SessionsSnapshot returns all known session payloads for support bundles.

func (*BaseHandlers) SetHTTPPort

func (h *BaseHandlers) SetHTTPPort(port int)

SetHTTPPort overrides the reported HTTP port for daemon status responses.

func (*BaseHandlers) SetStreamDone

func (h *BaseHandlers) SetStreamDone(done <-chan struct{})

SetStreamDone updates the transport shutdown bridge used by streaming handlers.

func (*BaseHandlers) SetTaskExecutionProfile

func (h *BaseHandlers) SetTaskExecutionProfile(c *gin.Context)

SetTaskExecutionProfile replaces one task-owned execution profile.

func (*BaseHandlers) SetToolApprovalGrant

func (h *BaseHandlers) SetToolApprovalGrant(c *gin.Context)

SetToolApprovalGrant creates or replaces one explicit wider native-tool decision.

func (*BaseHandlers) ShutdownWindowManagerStreams

func (h *BaseHandlers) ShutdownWindowManagerStreams(ctx context.Context) error

ShutdownWindowManagerStreams stops upgrades and waits for every window-manager stream.

func (*BaseHandlers) StartTask

func (h *BaseHandlers) StartTask(c *gin.Context)

StartTask explicitly enqueues one executable run for an existing task.

func (*BaseHandlers) StartTaskRun

func (h *BaseHandlers) StartTaskRun(c *gin.Context)

StartTaskRun starts one claimed run.

func (*BaseHandlers) StatusSnapshot

func (h *BaseHandlers) StatusSnapshot(ctx context.Context) (contract.StatusPayload, error)

StatusSnapshot returns the same runtime status payload used by /api/status.

func (*BaseHandlers) StopLoopRun

func (h *BaseHandlers) StopLoopRun(c *gin.Context)

StopLoopRun requests operator stop for one Loop run.

func (*BaseHandlers) StopSession

func (h *BaseHandlers) StopSession(c *gin.Context)

StopSession stops a running session without deleting persisted history.

func (*BaseHandlers) StreamBridgeHealth

func (h *BaseHandlers) StreamBridgeHealth(c *gin.Context)

StreamBridgeHealth streams health only for the bounded bridge page requested by ID.

func (*BaseHandlers) StreamDoneChannel

func (h *BaseHandlers) StreamDoneChannel() <-chan struct{}

StreamDoneChannel returns the transport shutdown channel in a concurrency-safe way.

func (*BaseHandlers) StreamLogs

func (h *BaseHandlers) StreamLogs(c *gin.Context)

StreamLogs streams runtime logs over SSE with a bounded retained replay.

func (*BaseHandlers) StreamLoopRunEvents

func (h *BaseHandlers) StreamLoopRunEvents(c *gin.Context)

StreamLoopRunEvents streams retained Loop run events over SSE.

func (*BaseHandlers) StreamSession

func (h *BaseHandlers) StreamSession(c *gin.Context)

StreamSession streams session events over SSE.

func (*BaseHandlers) StreamSessionCatalog

func (h *BaseHandlers) StreamSessionCatalog(c *gin.Context)

StreamSessionCatalog emits workspace-identified wake signals for catalog reconciliation.

func (*BaseHandlers) StreamSettingsObservabilityLogTail

func (h *BaseHandlers) StreamSettingsObservabilityLogTail(c *gin.Context)

StreamSettingsObservabilityLogTail streams daemon log lines over SSE.

func (*BaseHandlers) StreamTask

func (h *BaseHandlers) StreamTask(c *gin.Context)

StreamTask streams task-native live events over SSE.

func (*BaseHandlers) StreamTaskRunConversation

func (h *BaseHandlers) StreamTaskRunConversation(c *gin.Context)

StreamTaskRunConversation streams run-scoped coordination messages and usage changes over SSE.

func (*BaseHandlers) StreamWindowManager

func (h *BaseHandlers) StreamWindowManager(c *gin.Context)

StreamWindowManager upgrades one HTTP or UDS request to a snapshot-fenced WebSocket stream.

func (*BaseHandlers) SubmitTaskRunReviewVerdict

func (h *BaseHandlers) SubmitTaskRunReviewVerdict(c *gin.Context)

SubmitTaskRunReviewVerdict records one reviewer verdict for a review request.

func (*BaseHandlers) TaskDashboard

func (h *BaseHandlers) TaskDashboard(c *gin.Context)

TaskDashboard returns the observer-backed task dashboard view.

func (*BaseHandlers) TaskInbox

func (h *BaseHandlers) TaskInbox(c *gin.Context)

TaskInbox returns the observer-backed task inbox view.

func (*BaseHandlers) TaskTimeline

func (h *BaseHandlers) TaskTimeline(c *gin.Context)

TaskTimeline returns the task-native live timeline for one task.

func (*BaseHandlers) TaskTree

func (h *BaseHandlers) TaskTree(c *gin.Context)

TaskTree returns one task-tree live view.

func (*BaseHandlers) TestBridgeDelivery

func (h *BaseHandlers) TestBridgeDelivery(c *gin.Context)

TestBridgeDelivery resolves the typed outbound delivery target for one bridge instance without requiring a live platform adapter.

func (*BaseHandlers) TriggerAutomationJob

func (h *BaseHandlers) TriggerAutomationJob(c *gin.Context)

TriggerAutomationJob forces one immediate manual automation run.

func (*BaseHandlers) TriggerMemoryDream

func (h *BaseHandlers) TriggerMemoryDream(c *gin.Context)

TriggerMemoryDream triggers dream consolidation when enabled.

func (*BaseHandlers) TriggerSettingsRestart

func (h *BaseHandlers) TriggerSettingsRestart(c *gin.Context)

TriggerSettingsRestart starts the asynchronous daemon restart flow.

func (*BaseHandlers) UndrainDaemon

func (h *BaseHandlers) UndrainDaemon(c *gin.Context)

UndrainDaemon restores new-work admission.

func (*BaseHandlers) UnregisterWindowManagerClient

func (h *BaseHandlers) UnregisterWindowManagerClient(c *gin.Context)

UnregisterWindowManagerClient removes transient presentation state only.

func (*BaseHandlers) UpdateAgent

func (h *BaseHandlers) UpdateAgent(c *gin.Context)

UpdateAgent replaces the effective authored definition after a digest CAS.

func (*BaseHandlers) UpdateAutomationJob

func (h *BaseHandlers) UpdateAutomationJob(c *gin.Context)

UpdateAutomationJob patches one automation job definition.

func (*BaseHandlers) UpdateAutomationTrigger

func (h *BaseHandlers) UpdateAutomationTrigger(c *gin.Context)

UpdateAutomationTrigger patches one automation trigger definition.

func (*BaseHandlers) UpdateBridge

func (h *BaseHandlers) UpdateBridge(c *gin.Context)

UpdateBridge patches the mutable configuration fields of one bridge instance.

func (*BaseHandlers) UpdateBundleActivation

func (h *BaseHandlers) UpdateBundleActivation(c *gin.Context)

func (*BaseHandlers) UpdateExtension

func (h *BaseHandlers) UpdateExtension(c *gin.Context)

UpdateExtension updates one marketplace-installed extension via the daemon.

func (*BaseHandlers) UpdateNetworkChannel

func (h *BaseHandlers) UpdateNetworkChannel(c *gin.Context)

UpdateNetworkChannel mutates the channel metadata and delivery policy.

func (*BaseHandlers) UpdateNotificationPreset

func (h *BaseHandlers) UpdateNotificationPreset(c *gin.Context)

UpdateNotificationPreset mutates one preset.

func (*BaseHandlers) UpdateSettingsAutomation

func (h *BaseHandlers) UpdateSettingsAutomation(c *gin.Context)

UpdateSettingsAutomation persists the automation settings section.

func (*BaseHandlers) UpdateSettingsGeneral

func (h *BaseHandlers) UpdateSettingsGeneral(c *gin.Context)

UpdateSettingsGeneral persists the general settings section.

func (*BaseHandlers) UpdateSettingsHooksExtensions

func (h *BaseHandlers) UpdateSettingsHooksExtensions(c *gin.Context)

UpdateSettingsHooksExtensions persists the hooks and extensions settings section.

func (*BaseHandlers) UpdateSettingsMemory

func (h *BaseHandlers) UpdateSettingsMemory(c *gin.Context)

UpdateSettingsMemory persists the memory settings section.

func (*BaseHandlers) UpdateSettingsNetwork

func (h *BaseHandlers) UpdateSettingsNetwork(c *gin.Context)

UpdateSettingsNetwork persists the network settings section.

func (*BaseHandlers) UpdateSettingsObservability

func (h *BaseHandlers) UpdateSettingsObservability(c *gin.Context)

UpdateSettingsObservability persists the observability settings section.

func (*BaseHandlers) UpdateSettingsRoles

func (h *BaseHandlers) UpdateSettingsRoles(c *gin.Context)

UpdateSettingsRoles persists the background-role routing settings section.

func (*BaseHandlers) UpdateSettingsSkills

func (h *BaseHandlers) UpdateSettingsSkills(c *gin.Context)

UpdateSettingsSkills persists the skills settings section.

func (*BaseHandlers) UpdateSettingsWindowManager

func (h *BaseHandlers) UpdateSettingsWindowManager(c *gin.Context)

UpdateSettingsWindowManager persists the window-manager settings section.

func (*BaseHandlers) UpdateSkillMarketplace

func (h *BaseHandlers) UpdateSkillMarketplace(c *gin.Context)

UpdateSkillMarketplace checks or applies updates for marketplace skills.

func (*BaseHandlers) UpdateTask

func (h *BaseHandlers) UpdateTask(c *gin.Context)

UpdateTask patches one mutable task surface.

func (*BaseHandlers) UpdateWorkspace

func (h *BaseHandlers) UpdateWorkspace(c *gin.Context)

UpdateWorkspace updates a registered workspace.

func (*BaseHandlers) UpsertNetworkSubscription

func (h *BaseHandlers) UpsertNetworkSubscription(c *gin.Context)

UpsertNetworkSubscription sets one peer delivery preference for a channel or thread.

func (*BaseHandlers) ValidateAgentHeartbeat

func (h *BaseHandlers) ValidateAgentHeartbeat(c *gin.Context)

ValidateAgentHeartbeat validates a proposed HEARTBEAT.md body.

func (*BaseHandlers) ValidateAgentSoul

func (h *BaseHandlers) ValidateAgentSoul(c *gin.Context)

ValidateAgentSoul validates a proposed SOUL.md body for the caller's agent.

func (*BaseHandlers) ValidateAgentSoulDefinition

func (h *BaseHandlers) ValidateAgentSoulDefinition(c *gin.Context)

ValidateAgentSoulDefinition validates a proposed SOUL.md body for one workspace-visible agent.

func (*BaseHandlers) ValidateLoop

func (h *BaseHandlers) ValidateLoop(c *gin.Context)

ValidateLoop lints and compiles one Loop definition without saving it.

func (*BaseHandlers) ValidateWindowManagerLayout

func (h *BaseHandlers) ValidateWindowManagerLayout(c *gin.Context)

ValidateWindowManagerLayout validates a raw layout without normalization or writes.

func (*BaseHandlers) VerifyBridge

func (h *BaseHandlers) VerifyBridge(c *gin.Context)

VerifyBridge runs live provider checks without changing bridge lifecycle state.

func (*BaseHandlers) WakeAgentHeartbeat

func (h *BaseHandlers) WakeAgentHeartbeat(c *gin.Context)

WakeAgentHeartbeat requests one manual advisory Heartbeat wake decision.

func (*BaseHandlers) WriteMemory

func (h *BaseHandlers) WriteMemory(c *gin.Context)

WriteMemory creates or proposes one Memory v2 entry.

type BridgeCatalogObserver

type BridgeCatalogObserver interface {
	CheckBridgeCatalogReady() error
	QueryBridgeEffectiveStatuses(
		ctx context.Context,
		records []bridgepkg.BridgeCatalogRecord,
	) (map[string]bridgepkg.BridgeStatus, error)
	QueryBridgeHealthFor(
		ctx context.Context,
		instances []bridgepkg.BridgeInstance,
	) ([]observe.BridgeInstanceHealth, error)
}

BridgeCatalogObserver is the required bounded bridge projection used by public catalog surfaces.

type BridgeService

type BridgeService interface {
	bridgepkg.Registry
	bridgepkg.TargetDirectory
	bridgepkg.BridgeTaskSubscriptionStore
	bridgepkg.TargetResolver
	bridgepkg.BridgeControlTransport
	bridgepkg.DeliveryTransport
	ListProviders(ctx context.Context) ([]bridgepkg.BridgeProvider, error)
	CountBridgeRoutes(ctx context.Context, bridgeInstanceIDs []string) (map[string]int, error)
	ListSecretBindings(ctx context.Context, bridgeInstanceID string) ([]bridgepkg.BridgeSecretBinding, error)
	ListSecretBindingsForInstances(
		ctx context.Context,
		bridgeInstanceIDs []string,
	) (map[string][]bridgepkg.BridgeSecretBinding, error)
	PutSecretBinding(ctx context.Context, binding bridgepkg.BridgeSecretBinding, secretValue *string) error
	DeleteSecretBinding(ctx context.Context, bridgeInstanceID string, bindingName string) error
	StartInstance(ctx context.Context, id string) (*bridgepkg.BridgeInstance, error)
	StopInstance(ctx context.Context, id string) (*bridgepkg.BridgeInstance, error)
	RestartInstance(ctx context.Context, id string) (*bridgepkg.BridgeInstance, error)
}

BridgeService is the daemon-owned bridge runtime surface exposed by API transports.

type BundleService

BundleService exposes extension bundle catalog, activation, and declared network channels to API transports.

type CoordinatorRoleResolver

type CoordinatorRoleResolver interface {
	ResolveCoordinatorRole(ctx context.Context, workspaceID string) (compozyconfig.ResolvedCoordinatorRole, error)
}

CoordinatorRoleResolver resolves safe coordinator policy for agent-facing reads.

type DaemonDrainController

type DaemonDrainController interface {
	Drain(ctx context.Context) error
	Undrain(ctx context.Context) error
	DrainState() contract.DrainState
}

DaemonDrainController owns daemon-global new-work admission state.

type DreamTrigger

type DreamTrigger interface {
	Trigger(ctx context.Context, workspace string) (bool, string, error)
	LastConsolidatedAt() (time.Time, error)
	Enabled() bool
}

DreamTrigger exposes consolidation controls and state to the API layer.

type FlushWriter

type FlushWriter interface {
	io.Writer
	Flush()
}

FlushWriter is an SSE writer that can flush streamed content.

func PrepareSSE

func PrepareSSE(c *gin.Context) (FlushWriter, error)

PrepareSSE configures a Gin response for SSE streaming.

type GoalTurnListQuery

type GoalTurnListQuery struct {
	NodeID    string
	ItemIndex *int
	AfterSeq  int64
	Limit     int
}

GoalTurnListQuery contains validated public turn-audit filters.

func ParseGoalTurnListQuery

func ParseGoalTurnListQuery(c *gin.Context) (GoalTurnListQuery, error)

ParseGoalTurnListQuery enforces the public cursor and filter contract without clamping.

type HeartbeatAuthoringService

type HeartbeatAuthoringService interface {
	heartbeat.AuthoringService
}

HeartbeatAuthoringService exposes managed HEARTBEAT.md authoring to API handlers.

type HeartbeatHistoryPurger

type HeartbeatHistoryPurger interface {
	PurgeAgentHistory(ctx context.Context, ref heartbeat.WorkspaceRef, agentName string, sourcePath string) error
}

HeartbeatHistoryPurger removes history owned by one effective definition.

type HeartbeatStatusService

type HeartbeatStatusService interface {
	heartbeat.StatusService
}

HeartbeatStatusService composes read-only Heartbeat policy, wake state, and health.

type HeartbeatWakeEventReader

type HeartbeatWakeEventReader interface {
	ListHeartbeatWakeEvents(ctx context.Context, query heartbeat.WakeEventListQuery) ([]heartbeat.WakeEvent, error)
}

HeartbeatWakeEventReader lists retained Heartbeat wake audit rows.

type HeartbeatWakeService

type HeartbeatWakeService interface {
	Wake(ctx context.Context, req heartbeat.WakeRequest) (heartbeat.WakeDecision, error)
}

HeartbeatWakeService evaluates one advisory manual Heartbeat wake.

type InstalledSkillMarketplaceService

type InstalledSkillMarketplaceService interface {
	ListInstalled(ctx context.Context) ([]skillmarketplace.InstalledSkill, error)
}

InstalledSkillMarketplaceService exposes the global marketplace sidecar projection.

type LogsCursor

type LogsCursor struct {
	Timestamp time.Time
	Sequence  int64
	ID        string
}

LogsCursor is the shared cursor used for logs streaming.

func EmitLogs

func EmitLogs(writer FlushWriter, events []store.EventSummary, cursor LogsCursor) LogsCursor

EmitLogs writes log events newer than the supplied cursor.

func ParseLogsCursor

func ParseLogsCursor(raw string) (LogsCursor, error)

ParseLogsCursor parses a Last-Event-ID cursor for logs streaming.

type LoopLintFailedError

type LoopLintFailedError struct {
	Errors []contract.LoopLintErrorPayload
}

LoopLintFailedError carries authoring diagnostics for 422 responses.

func (*LoopLintFailedError) Error

func (e *LoopLintFailedError) Error() string

type LoopRunListQuery

type LoopRunListQuery struct {
	LoopName      string
	Status        string
	Origin        string
	OriginSession string
	Live          *bool
	Limit         int
}

LoopRunListQuery contains HTTP/UDS list filters for loop runs.

func ParseLoopRunListQuery

func ParseLoopRunListQuery(c *gin.Context) (LoopRunListQuery, error)

ParseLoopRunListQuery parses shared Loop run list filters.

type LoopService

type LoopService interface {
	ListLoops(
		ctx context.Context,
		workspaceID string,
		query looppkg.CatalogQuery,
	) (contract.LoopsResponse, error)
	CreateLoop(ctx context.Context, workspaceID string, req contract.CreateLoopRequest) (contract.LoopResponse, error)
	GetLoop(ctx context.Context, workspaceID string, name string) (contract.LoopResponse, error)
	PatchLoop(
		ctx context.Context,
		workspaceID string,
		name string,
		req contract.PatchLoopRequest,
	) (contract.LoopResponse, error)
	ValidateLoop(
		ctx context.Context,
		workspaceID string,
		name string,
		req contract.ValidateLoopRequest,
	) (contract.LoopValidationResponse, error)
	DeleteLoop(ctx context.Context, workspaceID string, name string) error
	RunLoop(
		ctx context.Context,
		workspaceID string,
		name string,
		req contract.RunLoopRequest,
		startKind dsl.StartKind,
		actor taskpkg.ActorContext,
		dry bool,
	) (contract.RunLoopResponse, error)
	GetLoopConfig(ctx context.Context, workspaceID string, name string) (contract.LoopConfigResponse, error)
	PutLoopConfig(
		ctx context.Context,
		workspaceID string,
		name string,
		req contract.PutLoopConfigRequest,
	) (contract.LoopConfigResponse, error)
	GetLoopInputDefaults(
		ctx context.Context,
		workspaceID string,
		name string,
		scope contract.LoopInputDefaultsScope,
	) (contract.LoopInputDefaultsResponse, error)
	GetLoopInputDefault(
		ctx context.Context,
		workspaceID string,
		name string,
		key string,
		scope contract.LoopInputDefaultsScope,
	) (contract.LoopInputDefaultResponse, error)
	PutLoopInputDefaults(
		ctx context.Context,
		workspaceID string,
		name string,
		req contract.PutLoopInputDefaultsRequest,
	) (contract.LoopInputDefaultsResponse, error)
	PutLoopInputDefault(
		ctx context.Context,
		workspaceID string,
		name string,
		key string,
		req contract.PutLoopInputDefaultRequest,
	) (contract.LoopInputDefaultResponse, error)
	DeleteLoopInputDefault(
		ctx context.Context,
		workspaceID string,
		name string,
		key string,
		scope contract.LoopInputDefaultsScope,
	) (contract.DeleteLoopInputDefaultResponse, error)
	GetLoopAnnotations(ctx context.Context, workspaceID string, name string) (contract.LoopAnnotationsResponse, error)
	PutLoopAnnotations(
		ctx context.Context,
		workspaceID string,
		name string,
		req contract.PutLoopAnnotationsRequest,
	) (contract.LoopAnnotationsResponse, error)
	ListLoopRuns(ctx context.Context, workspaceID string, query LoopRunListQuery) (contract.LoopRunsResponse, error)
	GetLoopRun(ctx context.Context, workspaceID string, runID string) (contract.LoopRunResponse, error)
	GetSessionGoal(ctx context.Context, workspaceID string, sessionID string) (*session.GoalSnapshot, error)
	ListGoalTurns(
		ctx context.Context,
		workspaceID string,
		runID string,
		query GoalTurnListQuery,
	) (session.GoalTurnPage, error)
	StopLoopRun(ctx context.Context, workspaceID string, runID string, actor taskpkg.ActorContext) error
	PauseLoopRun(ctx context.Context, workspaceID string, runID string, actor taskpkg.ActorContext) error
	ResumeLoopRun(ctx context.Context, workspaceID string, runID string, actor taskpkg.ActorContext) error
	ApproveLoopRun(
		ctx context.Context,
		workspaceID string,
		runID string,
		req contract.ApproveLoopRunRequest,
		actor taskpkg.ActorContext,
	) error
	ListLoopRunEvents(
		ctx context.Context,
		workspaceID string,
		runID string,
		afterSeq int64,
	) ([]contract.LoopRunEventPayload, error)
}

LoopService exposes the daemon-owned Loop public API facade to transports.

type LoopVersionConflictError

type LoopVersionConflictError struct {
	CurrentVersion int
}

LoopVersionConflictError carries the current published version for CAS responses.

func (*LoopVersionConflictError) Error

func (e *LoopVersionConflictError) Error() string

func (*LoopVersionConflictError) Unwrap

func (e *LoopVersionConflictError) Unwrap() error

type MCPSettingsAuth

MCPSettingsAuth exposes daemon-owned MCP OAuth operations to API transports.

type MCPSettingsInstaller

type MCPSettingsInstaller interface {
	InstallMCPCatalog(
		ctx context.Context,
		req settingspkg.MCPCatalogInstallRequest,
	) (settingspkg.MCPCatalogInstallResult, error)
}

MCPSettingsInstaller exposes feed-aware MCP installation to API transports.

type MarketplaceCatalogService

MarketplaceCatalogService exposes the daemon-owned curated feed projection.

type MarketplaceEntryRequest

type MarketplaceEntryRequest struct {
	Kind          string
	EntryID       string
	InstalledName string
	Scope         string
	WorkspaceID   string
}

MarketplaceEntryRequest captures transport-independent marketplace detail identity and scope.

type MarketplaceKindRequest

type MarketplaceKindRequest struct {
	Kind        string
	Query       string
	Cursor      string
	Limit       int
	Scope       string
	WorkspaceID string
}

MarketplaceKindRequest captures transport-independent single-kind discovery filters.

type MarketplaceSearchRequest

type MarketplaceSearchRequest struct {
	Query       string
	Limit       int
	Scope       string
	WorkspaceID string
}

MarketplaceSearchRequest captures transport-independent marketplace discovery filters.

type MemoryExtractorService

MemoryExtractorService exposes the daemon-owned Memory v2 extractor runtime.

type MemoryLocation

type MemoryLocation struct {
	Scope       memcontract.Scope
	Workspace   string
	WorkspaceID string
	AgentName   string
	AgentTier   memcontract.AgentTier
	Filename    string
}

MemoryLocation identifies the storage location for a memory document.

type MemoryProviderService

type MemoryProviderService interface {
	List(ctx context.Context, workspaceID string) ([]contract.MemoryProviderPayload, error)
	Get(ctx context.Context, workspaceID string, name string) (contract.MemoryProviderPayload, error)
	Select(ctx context.Context, workspaceID string, name string) (contract.MemoryProviderPayload, error)
	Enable(
		ctx context.Context,
		workspaceID string,
		name string,
		reason string,
	) (contract.MemoryProviderLifecycleResponse, error)
	Disable(
		ctx context.Context,
		workspaceID string,
		name string,
		reason string,
	) (contract.MemoryProviderLifecycleResponse, error)
}

MemoryProviderService exposes the active MemoryProvider registry.

type MemorySessionLedgerService

MemorySessionLedgerService exposes materialized session ledgers and replay.

type ModelCatalogService

type ModelCatalogService interface {
	modelcatalog.Service
}

ModelCatalogService exposes daemon-owned provider model catalog reads and refreshes.

type NetworkService

type NetworkService interface {
	Send(ctx context.Context, req network.SendRequest) (string, error)
	ListPeers(ctx context.Context, workspaceID string, channel string) ([]network.PeerInfo, error)
	ListChannels(ctx context.Context, workspaceID string) ([]network.ChannelInfo, error)
	Status(ctx context.Context) (*network.Status, error)
	Inbox(ctx context.Context, sessionID string) ([]network.Envelope, error)
	WaitInbox(ctx context.Context, sessionID string, channel string) ([]network.Envelope, error)
}

NetworkService is the runtime network surface exposed to daemon transports.

type NetworkStore

NetworkStore exposes persisted network audit, channel metadata CRUD, and timeline queries to the API layer.

type NotificationPresetService

type NotificationPresetService interface {
	List(ctx context.Context, query presetspkg.Query) ([]presetspkg.Preset, error)
	Get(ctx context.Context, name string) (presetspkg.Preset, error)
	Create(ctx context.Context, req presetspkg.CreateRequest) (presetspkg.Preset, error)
	Update(ctx context.Context, name string, req presetspkg.UpdateRequest) (presetspkg.Preset, error)
	Delete(ctx context.Context, name string) error
}

NotificationPresetService is the daemon-owned notification preset runtime.

type Observer

type Observer interface {
	QueryEvents(ctx context.Context, query store.EventSummaryQuery) ([]store.EventSummary, error)
	QueryHookCatalog(ctx context.Context, filter hookspkg.CatalogFilter) ([]hookspkg.CatalogEntry, error)
	QueryHookRuns(ctx context.Context, query store.HookRunQuery) ([]hookspkg.HookRunRecord, error)
	QueryHookEvents(ctx context.Context, filter hookspkg.EventFilter) ([]hookspkg.EventDescriptor, error)
	QueryTokenStats(ctx context.Context, query store.TokenStatsQuery) ([]store.TokenStats, error)
	QueryBridgeHealth(ctx context.Context) ([]observe.BridgeInstanceHealth, error)
	Health(ctx context.Context) (observe.Health, error)
	QueryTaskDashboard(ctx context.Context, query observe.TaskDashboardQuery) (observe.TaskDashboardView, error)
	QueryTaskInbox(
		ctx context.Context,
		query observe.TaskInboxQuery,
		actor taskpkg.ActorIdentity,
	) (observe.TaskInboxView, error)
	QueryObserveOverview(ctx context.Context, query observe.OverviewQuery) (observe.OverviewView, error)
}

Observer is the observability surface exposed by API transports.

type OnboardingStore

type OnboardingStore interface {
	store.OnboardingStore
}

OnboardingStore persists the global first-run onboarding completion flag.

type PromptStreamEncoder

type PromptStreamEncoder struct {
	// contains filtered or unexported fields
}

PromptStreamEncoder converts raw ACP agent events into the typed public prompt stream envelope used by HTTP, UDS, and CLI streaming surfaces.

func NewPromptStreamEncoder

func NewPromptStreamEncoder(now func() time.Time) *PromptStreamEncoder

NewPromptStreamEncoder constructs a prompt-stream encoder with deterministic timestamps for generated IDs when provided.

func (*PromptStreamEncoder) Emit

func (e *PromptStreamEncoder) Emit(writer FlushWriter, event acp.AgentEvent) error

Emit writes one public prompt-stream frame for the supplied raw agent event.

func (*PromptStreamEncoder) Finish

func (e *PromptStreamEncoder) Finish(writer FlushWriter, event acp.AgentEvent) error

Finish closes any open blocks and emits the terminal finish frame followed by the `[DONE]` sentinel exactly once.

func (*PromptStreamEncoder) Start

func (e *PromptStreamEncoder) Start(writer FlushWriter, messageID string) error

Start emits the public prompt stream start frame as soon as the daemon has accepted a durable turn. Later event frames reuse the same message id.

type ProviderModelSettingsCurator

type ProviderModelSettingsCurator interface {
	ApplyProviderModelCuration(
		ctx context.Context,
		req settingspkg.ProviderModelCurationRequest,
	) (settingspkg.ProviderModelCurationResult, error)
}

ProviderModelSettingsCurator exposes provider model curation to API transports.

type ResourceService

type ResourceService interface {
	List(ctx context.Context, filter resources.ResourceFilter) ([]resources.RawRecord, error)
	Get(ctx context.Context, kind resources.ResourceKind, id string) (resources.RawRecord, error)
	Put(ctx context.Context, draft resources.RawDraft) (resources.RawRecord, error)
	Delete(ctx context.Context, kind resources.ResourceKind, id string, expectedVersion int64) error
}

ResourceService exposes the operator-facing desired-state CRUD surface to API transports.

func NewOperatorResourceService

func NewOperatorResourceService(cfg *ResourceServiceConfig) (ResourceService, error)

NewOperatorResourceService constructs the shared desired-state CRUD service used by HTTP and UDS handlers. Resource writes validate against registered codecs when available and otherwise fall back to the raw kernel semantics so the generic control plane remains usable before family codecs land.

type ResourceServiceConfig

type ResourceServiceConfig struct {
	RawStore      resources.RawStore
	CodecRegistry *resources.CodecRegistry
	Actor         resources.MutationActor
	Trigger       func(context.Context, resources.ResourceKind, resources.ReconcileReason) error
}

ResourceServiceConfig configures the shared operator-facing resource service.

type RolesStatusProvider

type RolesStatusProvider interface {
	RoleStatuses(ctx context.Context, workspaceID string) ([]contract.RoleStatus, error)
	RoleStatus(ctx context.Context, workspaceID, role string) (contract.RoleStatus, error)
}

RolesStatusProvider projects effective role configuration without simulating an invocation.

type SSEMessage

type SSEMessage struct {
	ID   string
	Name string
	Data any
}

SSEMessage is the shared SSE envelope.

type SchemaStreamStatusReader

type SchemaStreamStatusReader interface {
	SchemaStreamStatuses(context.Context) ([]store.StreamStatus, error)
}

SchemaStreamStatusReader reads the daemon-global migration streams exposed by status.

type SessionAcceptanceManager

type SessionAcceptanceManager interface {
	CreateAccepted(ctx context.Context, opts session.CreateAcceptedOpts) (*session.Info, error)
}

SessionAcceptanceManager durably accepts user-created sessions without waiting for provider startup.

type SessionAttachManager

type SessionAttachManager interface {
	AttachSession(ctx context.Context, req store.SessionAttachRequest) (store.SessionAttach, error)
}

SessionAttachManager owns durable attach CAS and live-session synchronization.

type SessionCatalog

type SessionCatalog interface {
	ListSessions(ctx context.Context, query store.SessionListQuery) ([]store.SessionInfo, error)
}

SessionCatalog exposes daemon-owned session catalog operations that must not create a second live session authority.

type SessionCatalogEventSubscriber

type SessionCatalogEventSubscriber interface {
	SubscribeSessionCatalogEvents(
		ctx context.Context,
	) (<-chan session.CatalogEvent, func(), error)
}

SessionCatalogEventSubscriber exposes catalog wakes across workspaces.

type SessionHealthPageReader

type SessionHealthPageReader interface {
	SessionHealthForPage(ctx context.Context, infos []*session.Info) (map[string]heartbeat.SessionHealth, error)
}

SessionHealthPageReader returns health for one bounded session catalog page without per-session metadata or store reads.

type SessionHealthReader

type SessionHealthReader interface {
	GetSessionHealth(ctx context.Context, sessionID string) (heartbeat.SessionHealth, error)
}

SessionHealthReader reads metadata-only session health rows.

type SessionManager

type SessionManager interface {
	Create(ctx context.Context, opts session.CreateOpts) (*session.Session, error)
	List() []*session.Info
	ListAll(ctx context.Context) ([]*session.Info, error)
	Status(ctx context.Context, id string) (*session.Info, error)
	Events(ctx context.Context, id string, query store.EventQuery) ([]store.SessionEvent, error)
	LatestSessionEventByType(ctx context.Context, id string, eventType string) (*store.SessionEvent, error)
	History(ctx context.Context, id string, query store.EventQuery) ([]store.TurnHistory, error)
	TranscriptPage(ctx context.Context, id string, query transcript.PageQuery) (transcript.Page, error)
	TranscriptChanges(ctx context.Context, id string, query transcript.ChangeQuery) (transcript.ChangePage, error)
	RepairSession(ctx context.Context, opts session.RepairOpts) (*session.RepairResult, error)
	Delete(ctx context.Context, id string) error
	Stop(ctx context.Context, id string) error
	StopWithCause(ctx context.Context, id string, cause session.StopCause, detail string) error
	Resume(ctx context.Context, id string) (*session.Session, error)
	ClearConversation(ctx context.Context, id string) (*session.Session, error)
	Prompt(ctx context.Context, id string, msg string) (<-chan acp.AgentEvent, error)
	PromptWithOpts(ctx context.Context, id string, opts session.PromptOpts) (<-chan acp.AgentEvent, error)
	PromptSynthetic(ctx context.Context, id string, opts session.SyntheticPromptOpts) (<-chan acp.AgentEvent, error)
	SendPrompt(ctx context.Context, id string, opts session.SendPromptOpts) (session.SendPromptResult, error)
	InterruptPrompt(ctx context.Context, id string) (session.SendPromptResult, error)
	SteerPrompt(ctx context.Context, id string, msg string) (session.SendPromptResult, error)
	CancelQueuedPrompt(ctx context.Context, id string, queueEntryID string) (session.SendPromptResult, error)
	CancelPrompt(ctx context.Context, id string) error
	ApprovePermission(ctx context.Context, id string, req acp.ApproveRequest) error
	InputQueueSummary(ctx context.Context, id string) (session.InputQueueSummary, error)
}

SessionManager is the runtime session surface exposed by API transports. List returns the current in-memory session snapshot without performing I/O. ListAll may perform I/O to return the authoritative session set, so it accepts a context.

type SessionPageManager

type SessionPageManager interface {
	ListPage(ctx context.Context, query session.ListQuery) (session.ListPage, error)
}

SessionPageManager is the bounded public catalog capability implemented by the runtime manager without widening internal full-snapshot consumers.

type SettingsLogTailEventPayload

type SettingsLogTailEventPayload struct {
	Line string `json:"line"`
}

SettingsLogTailEventPayload is the shared SSE payload for daemon log tailing.

type SettingsRestartController

type SettingsRestartController interface {
	RequestRestart(ctx context.Context) (SettingsRestartOperation, error)
	GetRestartOperation(ctx context.Context, operationID string) (SettingsRestartOperation, error)
}

SettingsRestartController exposes the daemon-owned restart action and persisted status surface.

type SettingsRestartOperation

type SettingsRestartOperation struct {
	OperationID        string
	Status             string
	OldPID             int
	OldStartedAt       time.Time
	OldSocketPath      string
	NewPID             int
	ActiveSessionCount int
	FailureReason      string
	StartedAt          time.Time
	UpdatedAt          time.Time
	CompletedAt        *time.Time
}

SettingsRestartOperation is the daemon-owned restart record exposed to settings transports.

type SettingsUpdateController

type SettingsUpdateController interface {
	GetUpdate(ctx context.Context) (SettingsUpdateStatus, error)
}

SettingsUpdateController exposes the daemon-owned update status surface to settings transports.

type SettingsUpdateStatus

type SettingsUpdateStatus struct {
	Supported      bool
	Managed        bool
	InstallMethod  string
	CurrentVersion string
	LatestVersion  string
	Available      bool
	Status         string
	Recommendation string
	ReleaseURL     string
	CheckedAt      *time.Time
	LastError      string
}

SettingsUpdateStatus is the daemon-owned software-update snapshot exposed to settings transports.

type SkillMarketplaceService

type SkillMarketplaceService interface {
	Search(ctx context.Context, query string, offset int, limit int) ([]registrypkg.Listing, error)
	Info(ctx context.Context, slug string) (*registrypkg.Detail, error)
	Install(ctx context.Context, slug string, version string) (skillmarketplace.InstallResult, error)
	Update(ctx context.Context, req skillmarketplace.UpdateRequest) ([]skillmarketplace.UpdateResult, error)
	Remove(ctx context.Context, name string) (skillmarketplace.RemoveResult, error)
}

SkillMarketplaceService exposes remote skill marketplace lifecycle operations.

type SkillResourceSyncer

type SkillResourceSyncer interface {
	SyncSkills(ctx context.Context) error
}

SkillResourceSyncer synchronizes resource-backed skill declarations after on-disk mutations.

type SkillsRegistry

type SkillsRegistry interface {
	Get(name string) (*skills.Skill, bool)
	List() []*skills.Skill
	ForWorkspace(ctx context.Context, resolved *workspacepkg.ResolvedWorkspace) ([]*skills.Skill, error)
	ForAgent(ctx context.Context, resolved *workspacepkg.ResolvedWorkspace, agentName string) ([]*skills.Skill, error)
	LoadContent(ctx context.Context, skill *skills.Skill) (string, error)
	LoadResource(ctx context.Context, skill *skills.Skill, relativePath string) (string, error)
	SetEnabled(name string, resolved *workspacepkg.ResolvedWorkspace, enabled bool) error
	SetEnabledForAgent(name string, resolved *workspacepkg.ResolvedWorkspace, agentName string, enabled bool) error
}

SkillsRegistry exposes the daemon-owned skill catalog.

type SkillsRegistryRefresher

type SkillsRegistryRefresher interface {
	RefreshGlobal(ctx context.Context) error
}

SkillsRegistryRefresher refreshes the daemon global skill catalog after on-disk mutations.

type SoulAuthoringService

type SoulAuthoringService interface {
	soul.AuthoringService
}

SoulAuthoringService exposes managed SOUL.md authoring and read validation to API handlers.

type SoulHistoryPurger

type SoulHistoryPurger interface {
	PurgeAgentHistory(ctx context.Context, ref soul.WorkspaceRef, agentName string, sourcePath string) error
}

SoulHistoryPurger removes history owned by one effective definition.

type SoulRefresher

type SoulRefresher interface {
	RefreshSoulWithExpectedDigest(
		ctx context.Context,
		id string,
		expectedDigest string,
	) (session.SoulRefreshResult, error)
}

SoulRefresher refreshes a session's resolved Soul snapshot through service-owned CAS.

type SupportBundleService

type SupportBundleService interface {
	Create(ctx context.Context, req support.CreateRequest) (support.Operation, error)
	Get(ctx context.Context, operationID string) (support.Operation, error)
	DownloadPath(ctx context.Context, operationID string) (support.Operation, string, error)
}

SupportBundleService exposes daemon-owned support bundle operations to transports.

type TaskActorContextResolver

type TaskActorContextResolver func(c *gin.Context, action string) (taskpkg.ActorContext, error)

TaskActorContextResolver derives the trusted task-domain actor envelope for one API request.

type TaskService

type TaskService interface {
	taskpkg.Manager
	taskpkg.CatalogManager
}

TaskService exposes task-domain state and lifecycle surfaces to the API layer.

type ToolApprovalGrantService

type ToolApprovalGrantService interface {
	toolspkg.ApprovalGrantStore
}

ToolApprovalGrantService manages workspace-scoped remembered native-tool approval decisions.

type ToolApprovalIssuer

type ToolApprovalIssuer interface {
	CreateToolApproval(
		ctx context.Context,
		scope toolspkg.Scope,
		req toolspkg.ApprovalRequest,
	) (toolspkg.ApprovalTokenGrant, error)
}

ToolApprovalIssuer mints local one-shot approval references for operator transports.

type ToolRegistry

type ToolRegistry interface {
	List(ctx context.Context, scope toolspkg.Scope) ([]toolspkg.ToolView, error)
	Search(ctx context.Context, scope toolspkg.Scope, q toolspkg.SearchQuery) ([]toolspkg.ToolView, error)
	Get(ctx context.Context, scope toolspkg.Scope, id toolspkg.ToolID) (toolspkg.ToolView, error)
	Call(ctx context.Context, scope toolspkg.Scope, req toolspkg.CallRequest) (toolspkg.ToolResult, error)
}

ToolRegistry exposes registry projection and dispatch without binding API handlers to backend packages.

type ToolsetRegistry

type ToolsetRegistry interface {
	ListToolsets(ctx context.Context, scope toolspkg.Scope) ([]toolspkg.ToolsetView, error)
	GetToolset(ctx context.Context, scope toolspkg.Scope, id toolspkg.ToolsetID) (toolspkg.ToolsetView, error)
}

ToolsetRegistry exposes named toolset projections.

type VaultService

type VaultService interface {
	GetMetadata(ctx context.Context, ref string) (vault.Metadata, error)
	ListMetadata(ctx context.Context, prefix string) ([]vault.Metadata, error)
	PutSecret(ctx context.Context, ref string, kind string, plaintext string) (vault.Metadata, error)
	DeleteSecret(ctx context.Context, ref string) error
}

VaultService exposes redacted secret metadata and write-only mutations to API transports.

type WorkspaceGetter

type WorkspaceGetter interface {
	Get(ctx context.Context, ref string) (workspacepkg.Workspace, error)
}

WorkspaceGetter resolves registered workspaces by reference.

type WorkspaceService

type WorkspaceService interface {
	Register(ctx context.Context, opts workspacepkg.RegisterOptions) (workspacepkg.Workspace, error)
	Unregister(ctx context.Context, id string) error
	Update(ctx context.Context, id string, opts workspacepkg.UpdateOptions) error
	List(ctx context.Context) ([]workspacepkg.Workspace, error)
	Get(ctx context.Context, idOrNameOrPath string) (workspacepkg.Workspace, error)
	Resolve(ctx context.Context, idOrNameOrPath string) (workspacepkg.ResolvedWorkspace, error)
	ResolveOrRegister(ctx context.Context, path string) (workspacepkg.ResolvedWorkspace, error)
}

WorkspaceService exposes workspace registration and resolution to the API layer.

Source Files

Jump to

Keyboard shortcuts

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