core

package
v0.3.0-beta.11 Latest Latest
Warning

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

Go to latest
Published: Aug 11, 2026 License: MIT Imports: 87 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"
)
View Source
const GatewayInvalidRequestCode = "gateway_invalid_request"

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 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 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 ExtensionGitDependencyDiagnostic ¶

func ExtensionGitDependencyDiagnostic(err error) (contract.DiagnosticItem, bool)

ExtensionGitDependencyDiagnostic returns the canonical public Git remediation.

func ExtensionStatusCode ¶

func ExtensionStatusCode(err error) int

ExtensionStatusCode maps extension-domain errors onto transport status codes.

func GatewayDevicePayloads ¶

func GatewayDevicePayloads(devices []gateway.DeviceSession) []contract.GatewayDevicePayload

func GatewayErrorCode ¶

func GatewayErrorCode(err error) string

GatewayErrorCode returns the deterministic machine code for a known gateway error.

func GatewayStatusPayload ¶

func GatewayStatusPayload(status gateway.Status) contract.GatewayStatusPayload

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 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 wraps every non-streaming prompt outcome in one stable envelope.

func PromptResultPayloadFromSession ¶

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

PromptResultPayloadFromSession converts runtime prompt admission state into the shared DTO.

func PromptRuntimeSelectionFromPayload ¶

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

PromptRuntimeSelectionFromPayload converts an optional prompt runtime snapshot.

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 SessionCommandsResponseFromCatalog ¶

func SessionCommandsResponseFromCatalog(catalog commandpkg.Catalog) contract.SessionCommandsResponse

SessionCommandsResponseFromCatalog maps the internal catalog to its public path-free contract.

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 SessionInputPayloadFromSession ¶

func SessionInputPayloadFromSession(input session.PendingInput) contract.SessionInputPayload

SessionInputPayloadFromSession maps daemon state into the public contract.

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 SkillMarketplaceCleanupDiagnosticPayloadsFromDomain ¶

func SkillMarketplaceCleanupDiagnosticPayloadsFromDomain(
	diagnostics []skillmarketplace.CleanupDiagnostic,
) []contract.SkillMarketplaceCleanupDiagnosticPayload

SkillMarketplaceCleanupDiagnosticPayloadsFromDomain converts cleanup diagnostics into wire 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 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 StatusForGatewayError ¶

func StatusForGatewayError(err error) int

StatusForGatewayError maps gateway-domain failures to stable transport statuses.

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, error)

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, error)

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, error)

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, error)

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

func TaskBridgeNotificationSubscriptionPayloadsFromSubscriptions ¶

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

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
	SupportBundles               SupportBundleService
	Settings                     SettingsService
	SettingsRestart              SettingsRestartController
	SettingsUpdate               SettingsUpdateController
	Vault                        VaultService
	Workspaces                   WorkspaceService
	WorkspaceAccess              workspaceaccess.Policy
	WindowManager                WindowManagerService
	Onboarding                   OnboardingStore
	AgentCatalog                 AgentCatalog
	AgentDefinitionSync          AgentDefinitionSync
	ModelCatalog                 ModelCatalogService
	MarketplaceCatalog           MarketplaceCatalogService
	ProviderAuthRunner           authproviders.ProviderAuthCommandRunner
	ProviderAuthCommandResolver  authproviders.ProviderAuthCommandResolver
	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
	Gateway                      GatewayService
	GatewayPairingSource         string
	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
	SupportBundles               SupportBundleService
	Settings                     SettingsService
	SettingsRestart              SettingsRestartController
	SettingsUpdate               SettingsUpdateController
	Vault                        VaultService
	Workspaces                   WorkspaceService
	WorkspaceAccess              workspaceaccess.Policy
	WindowManager                WindowManagerService
	Onboarding                   OnboardingStore
	AgentCatalog                 AgentCatalog
	AgentDefinitionSync          AgentDefinitionSync
	ModelCatalog                 ModelCatalogService
	MarketplaceCatalog           MarketplaceCatalogService
	ProviderAuthRunner           authproviders.ProviderAuthCommandRunner
	ProviderAuthCommandResolver  authproviders.ProviderAuthCommandResolver
	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
	Gateway                      GatewayService
	GatewayPairingSource         string
	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) 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) ArchiveSession ¶

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

ArchiveSession removes one stopped session from default catalog listings.

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) AuthorizeNetworkWorkspaceAccess ¶

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

AuthorizeNetworkWorkspaceAccess enforces agent workspace policy on every workspace Network route.

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) BindGatewayIngress ¶

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

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) CancelLoopNode ¶

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

CancelLoopNode requests cooperative cancellation for one authored node.

func (*BaseHandlers) CancelLoopRun ¶

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

CancelLoopRun requests cooperative cancellation for one run.

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) ClearSessionRuntime ¶

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

ClearSessionRuntime removes the durable runtime preference for future prompts.

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) DeleteExtensionSecret ¶

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

DeleteExtensionSecret unbinds one environment name.

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) DevExtension ¶

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

DevExtension links and activates one immutable generation in the trusted workspace.

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) DisableGatewayProvider ¶

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

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) DispatchSessionPrompt ¶

func (h *BaseHandlers) DispatchSessionPrompt(c *gin.Context) (*PromptDispatch, bool)

DispatchSessionPrompt validates and dispatches one authenticated prompt with its detached execution and request-bound delivery lifetimes.

func (*BaseHandlers) DispatchSessionSteer ¶

func (h *BaseHandlers) DispatchSessionSteer(c *gin.Context) (session.SendPromptResult, bool)

DispatchSessionSteer validates and dispatches one detached steering command.

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) EnableGatewayProvider ¶

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

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) ExtensionCommands ¶

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

ExtensionCommands returns active command leaves and presentation groups.

func (*BaseHandlers) ExtensionInventory ¶

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

ExtensionInventory returns the shipped and live resource union for one extension.

func (*BaseHandlers) ExtensionLogs ¶

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

ExtensionLogs returns or follows the redacted ring for the trusted instance.

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) GatewayStatus ¶

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) GetDoctor ¶

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

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

func (*BaseHandlers) GetGatewayAudit ¶

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

func (*BaseHandlers) GetGatewayStatus ¶

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

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) GetSessionCommands ¶

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

GetSessionCommands lists daemon, ACP, and effective skill commands for one session.

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) GetSessionOwner ¶

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

GetSessionOwner returns the minimal workspace ownership projection for one session.

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) GetSettingsMCPAuthStatus ¶

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

GetSettingsMCPAuthStatus returns redacted OAuth state without probing the MCP runtime.

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) HandleListSessionInputs ¶

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

HandleListSessionInputs returns authoritative daemon-owned pending input.

func (*BaseHandlers) HandlePromoteSessionInput ¶

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

HandlePromoteSessionInput atomically promotes queued input to steering.

func (*BaseHandlers) HandleReplaceSessionInput ¶

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

HandleReplaceSessionInput atomically replaces one queued input.

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 one extension from the closed distribution-source union.

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) KillLoopNode ¶

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

KillLoopNode immediately fences one authored node.

func (*BaseHandlers) KillLoopRun ¶

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

KillLoopRun immediately fences and terminalizes one run.

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) ListExtensionSecrets ¶

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

ListExtensionSecrets returns declared and bound env names without secret material.

func (*BaseHandlers) ListExtensions ¶

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

ListExtensions returns daemon-owned installed extension state.

func (*BaseHandlers) ListGatewayDevices ¶

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

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) ListLoopNodes ¶

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

ListLoopNodes returns one stable workspace node-state page.

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) MintGatewayPairing ¶

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

func (*BaseHandlers) MintGatewayStreamTicket ¶

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

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) PauseLoopNode ¶

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

PauseLoopNode parks one authored node.

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) PreviewExtensionEnable ¶

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

PreviewExtensionEnable returns the mutation-free enable projection for one extension.

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) ProxyGatewayBridgeCallback ¶

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

ProxyGatewayBridgeCallback forwards a confirmed public callback to the adapter's loopback listener.

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) RedeemGatewayPairing ¶

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

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) ReloadDevExtension ¶

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

ReloadDevExtension swaps one workspace instance to a verified generation.

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) RenameGatewayDevice ¶

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

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) RequeueLoopNode ¶

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

RequeueLoopNode clears one quarantine and reserves the next generation.

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) RespondPromptRaw ¶

func (h *BaseHandlers) RespondPromptRaw(c *gin.Context, dispatch *PromptDispatch)

RespondPromptRaw writes an accepted prompt as raw ACP event frames or its non-streaming prompt-result envelope.

func (*BaseHandlers) RespondPromptV1 ¶

func (h *BaseHandlers) RespondPromptV1(c *gin.Context, dispatch *PromptDispatch)

RespondPromptV1 writes an accepted prompt as the AI SDK v1 stream or its non-streaming prompt-result envelope.

func (*BaseHandlers) RestartBridge ¶

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

RestartBridge restarts one bridge instance while preserving route ownership.

func (*BaseHandlers) ResumeLoopNode ¶

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

ResumeLoopNode releases one node pause or admits a manual wait payload.

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) RevokeGatewayDevice ¶

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

func (*BaseHandlers) RevokeToolApprovalGrant ¶

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

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

func (*BaseHandlers) RewindSessionConversation ¶

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

RewindSessionConversation cuts the active transcript before one durable user message and restarts the same session with a fresh ACP context.

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) SearchExtensions ¶

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

SearchExtensions returns one stable page from curated and GitHub discovery.

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) SetExtensionSecrets ¶

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

SetExtensionSecrets applies write-only values or existing Vault bindings.

func (*BaseHandlers) SetGatewaySurface ¶

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

func (*BaseHandlers) SetHTTPPort ¶

func (h *BaseHandlers) SetHTTPPort(port int)

SetHTTPPort overrides the reported HTTP port for daemon status responses.

func (*BaseHandlers) SetSessionRuntime ¶

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

SetSessionRuntime durably selects the default runtime for future prompts.

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) 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) UnarchiveSession ¶

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

UnarchiveSession restores one session to default catalog listings.

func (*BaseHandlers) UnbindGatewayIngress ¶

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

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) UpdateExtension ¶

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

UpdateExtension updates one marketplace-installed extension via the daemon.

func (*BaseHandlers) UpdateExtensions ¶

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

UpdateExtensions updates a daemon-selected batch and preserves per-item outcomes.

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 CoordinatorRoleResolver ¶

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

CoordinatorRoleResolver resolves safe coordinator policy for agent-facing reads.

type CreatedAgentDefinition ¶

type CreatedAgentDefinition struct {
	Agent         compozyconfig.AgentDef
	RuntimeConfig compozyconfig.Config
	WorkspaceID   string
}

CreatedAgentDefinition is the normalized result of one shared agent creation.

func CreateAgentFromRequest ¶

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

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

type DaemonDrainController ¶

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

DaemonDrainController owns daemon-global admission and quiesce truth.

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 ExtensionCommandService ¶

type ExtensionCommandService interface {
	Commands(context.Context, string) (contract.ExtensionCommandsResponse, error)
}

ExtensionCommandService exposes the global contributed-command projection.

type ExtensionDevService ¶

ExtensionDevService exposes workspace-bound development lifecycle operations.

type ExtensionScopedCommandService ¶

type ExtensionScopedCommandService interface {
	CommandsScoped(
		context.Context,
		string,
		taskpkg.ActorContext,
	) (contract.ExtensionCommandsResponse, error)
}

ExtensionScopedCommandService exposes the trusted-workspace command projection.

type ExtensionScopedReadService ¶

type ExtensionScopedReadService interface {
	ListScoped(context.Context, taskpkg.ActorContext) ([]contract.ExtensionPayload, error)
	StatusScoped(context.Context, string, taskpkg.ActorContext) (contract.ExtensionPayload, error)
}

ExtensionScopedReadService exposes caller-filtered read projections.

type ExtensionScopedRemoveService ¶

type ExtensionScopedRemoveService interface {
	RemoveScoped(
		context.Context,
		string,
		taskpkg.ActorContext,
	) (contract.ManagedExtensionRemovePayload, error)
}

ExtensionScopedRemoveService removes a workspace overlay without mutating the published row.

type ExtensionSecretsService ¶

type ExtensionSecretsService interface {
	ListExtensionSecrets(
		ctx context.Context,
		name string,
		actor taskpkg.ActorContext,
	) (contract.ExtensionSecretsPayload, error)
	SetExtensionSecrets(
		ctx context.Context,
		name string,
		req contract.SetExtensionSecretsRequest,
		actor taskpkg.ActorContext,
	) (contract.ExtensionSecretsPayload, error)
	DeleteExtensionSecret(
		ctx context.Context,
		name string,
		envName string,
		actor taskpkg.ActorContext,
	) error
}

ExtensionSecretsService exposes presence-only, caller-scoped secret bindings.

type ExtensionService ¶

type ExtensionService interface {
	ExtensionSecretsService

	List(ctx context.Context) ([]contract.ExtensionPayload, error)
	Search(ctx context.Context, req contract.ExtensionSearchRequest) (contract.ExtensionSearchResponse, error)
	MarketplaceTrust(
		ctx context.Context,
		evidence extensionpkg.MarketplaceTrustEvidence,
	) (contract.ExtensionTrustReportPayload, error)
	Install(
		ctx context.Context,
		req contract.InstallExtensionRequest,
		actor taskpkg.ActorContext,
	) (contract.ExtensionPayload, error)
	Update(
		ctx context.Context,
		name string,
		req contract.UpdateExtensionRequest,
		actor taskpkg.ActorContext,
	) (contract.ManagedExtensionUpdatePayload, error)
	UpdateBatch(
		ctx context.Context,
		req contract.UpdateExtensionsRequest,
		actor taskpkg.ActorContext,
	) ([]contract.ManagedExtensionUpdatePayload, error)
	Remove(ctx context.Context, name string, actor taskpkg.ActorContext) (contract.ManagedExtensionRemovePayload, error)
	Enable(
		ctx context.Context,
		name string,
		req contract.EnableExtensionRequest,
		actor taskpkg.ActorContext,
	) (contract.ExtensionEnableResult, error)
	Disable(ctx context.Context, name string, actor taskpkg.ActorContext) (contract.ExtensionPayload, error)
	Status(ctx context.Context, name string) (contract.ExtensionPayload, error)
	Provenance(ctx context.Context, name string) (contract.ExtensionProvenancePayload, error)
	Inventory(ctx context.Context, name string) (contract.ExtensionInventoryPayload, error)
	Preview(ctx context.Context, name string) (contract.ExtensionEnablePreviewPayload, error)
}

ExtensionService exposes daemon-backed extension management to API transports.

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 LoopNodeListQuery ¶

type LoopNodeListQuery struct {
	State    string
	LoopName string
	RunID    string
	Cursor   string
	Limit    int
}

LoopNodeListQuery contains workspace node-inventory filters.

func ParseLoopNodeListQuery ¶

func ParseLoopNodeListQuery(c *gin.Context) (LoopNodeListQuery, error)

ParseLoopNodeListQuery parses shared HTTP and UDS inventory filters.

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)
	CancelLoopRun(
		ctx context.Context,
		workspaceID string,
		runID string,
		actor taskpkg.ActorContext,
	) (contract.LoopMutationResponse, error)
	KillLoopRun(
		ctx context.Context,
		workspaceID string,
		runID string,
		actor taskpkg.ActorContext,
	) (contract.LoopMutationResponse, error)
	PauseLoopNode(
		ctx context.Context,
		workspaceID string,
		runID string,
		nodeID string,
		req contract.LoopNodePauseRequest,
		actor taskpkg.ActorContext,
	) (contract.LoopMutationResponse, error)
	ResumeLoopNode(
		ctx context.Context,
		workspaceID string,
		runID string,
		nodeID string,
		req contract.LoopNodeResumeRequest,
		actor taskpkg.ActorContext,
	) (contract.LoopMutationResponse, error)
	CancelLoopNode(
		ctx context.Context,
		workspaceID string,
		runID string,
		nodeID string,
		req contract.LoopNodeMutationRequest,
		actor taskpkg.ActorContext,
	) (contract.LoopMutationResponse, error)
	KillLoopNode(
		ctx context.Context,
		workspaceID string,
		runID string,
		nodeID string,
		req contract.LoopNodeMutationRequest,
		actor taskpkg.ActorContext,
	) (contract.LoopMutationResponse, error)
	RequeueLoopNode(
		ctx context.Context,
		workspaceID string,
		runID string,
		nodeID string,
		req contract.LoopNodeMutationRequest,
		actor taskpkg.ActorContext,
	) (contract.LoopMutationResponse, error)
	ListLoopNodes(
		ctx context.Context,
		workspaceID string,
		query LoopNodeListQuery,
	) (contract.LoopNodeInventoryResponse, 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 PromptDispatch ¶

type PromptDispatch struct {
	// contains filtered or unexported fields
}

PromptDispatch owns the delivery context for one accepted prompt response. Its lifecycle ends when a response writer finishes or disconnects.

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 SessionArchiveManager ¶

type SessionArchiveManager interface {
	Archive(ctx context.Context, workspaceID string, sessionID string) (*session.Info, error)
	Unarchive(ctx context.Context, workspaceID string, sessionID string) (*session.Info, error)
}

SessionArchiveManager owns reversible workspace-scoped session catalog visibility.

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 SessionCommandCatalogManager ¶

type SessionCommandCatalogManager interface {
	CommandCatalog(ctx context.Context, id string) (commandpkg.Catalog, error)
}

SessionCommandCatalogManager exposes one unified session command projection.

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)
	RewindConversation(
		ctx context.Context,
		id string,
		opts session.ConversationRewindOptions,
	) (session.ConversationRewindResult, 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)
	SteerPrompt(ctx context.Context, id string, opts session.SteerPromptOpts) (session.SendPromptResult, error)
	ListPendingInputs(ctx context.Context, id string) ([]session.PendingInput, error)
	ReplacePendingInput(
		ctx context.Context,
		id string,
		entryID string,
		opts session.ReplacePendingInputOpts,
	) (session.PendingInput, error)
	PromotePendingInputToSteer(
		ctx context.Context,
		id string,
		entryID string,
		opts session.PromotePendingInputOpts,
	) (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 SessionRuntimeSelectionManager ¶

type SessionRuntimeSelectionManager interface {
	SetRuntimeSelection(
		ctx context.Context,
		id string,
		selection session.RuntimeSelection,
		expectedRevision int64,
	) (*session.Info, error)
	ClearRuntimeSelection(ctx context.Context, id string, expectedRevision int64) (*session.Info, error)
}

SessionRuntimeSelectionManager owns durable compare-and-set runtime preferences.

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