core

package
v0.5.2 Latest Latest
Warning

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

Go to latest
Published: Nov 4, 2026 License: MIT Imports: 103 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"
View Source
const SessionAttachmentMultipartOverheadBytes int64 = 64 << 10

SessionAttachmentMultipartOverheadBytes bounds multipart headers and framing around one uploaded file.

View Source
const SpawnPromptStatusFailed = "failed"

SpawnPromptStatusFailed marks a first prompt that failed after its child was created.

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 (
	// 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 ErrLoopVersionConflict = errors.New("loop version conflict")

ErrLoopVersionConflict reports a failed expected_version compare-and-swap.

View Source
var ErrMarketplaceCursorStale = errors.New("marketplace: catalog revision changed")
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 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 ErrSpawnWorktreeConflict = fmt.Errorf(
	"%w: worktree and new_worktree are mutually exclusive",
	session.ErrSpawnValidation,
)

ErrSpawnWorktreeConflict reports a spawn request naming both worktree selectors.

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

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

Functions ¶

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

func AgentInstanceCheckResponse(result heartbeat.CheckResult) contract.AgentInstanceCheckResponse

AgentInstanceCheckResponse projects the public check result for every transport.

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,
) contract.TaskRunLeaseSummaryPayload

AgentTaskLeasePayloadFromRun builds the public, redacted lease payload.

func AppTokenErrorStatus ¶

func AppTokenErrorStatus(err error, authentication bool) (int, string)

func AppTokenFromContext ¶

func AppTokenFromContext(ctx context.Context) (gateway.AppToken, bool)

AppTokenFromContext returns the app credential attributed to this request.

func AppTokenPayload ¶

func AppTokenPayload(token gateway.AppToken) contract.AppTokenPayload

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

func ApplySessionPlacements(payloads []contract.SessionPayload, placements map[string]store.SessionPlacement)

ApplySessionPlacements decorates catalog payloads with their folder ids.

func ApplyTaskLoopCatalogFilters ¶

func ApplyTaskLoopCatalogFilters(query *taskpkg.CatalogQuery, includeLoop bool, loopRunID string)

ApplyTaskLoopCatalogFilters maps public Loop filters into the neutral catalog query.

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

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

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

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

func CleanupBranchOutcome ¶

func CleanupBranchOutcome(
	ctx context.Context,
	worktrees WorktreeService,
	workspaceID, id string,
	force bool,
) (*contract.WorktreeBranchOutcomePayload, error)

CleanupBranchOutcome runs the opted-in branch step after a successful removal or dismissal. Only precondition failures stay errors; any other failure is a kept-branch outcome, so callers never mistake a completed cleanup for a failed one.

func ConfigApplyRecordsResponseFromRecords ¶

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

ConfigApplyRecordsResponseFromRecords converts apply history rows into the public payload.

func ContextWithAppToken ¶

func ContextWithAppToken(ctx context.Context, token gateway.AppToken) context.Context

ContextWithAppToken attributes a local request without changing its local privileges.

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

func DecorateSessionLinkedWork(
	ctx context.Context,
	reader any,
	infos []*session.Info,
	payloads []contract.SessionPayload,
) error

func DecorateSessionPullRequests ¶

func DecorateSessionPullRequests(
	ctx context.Context,
	reader any,
	infos []*session.Info,
	payloads []contract.SessionPayload,
) error

DecorateSessionPullRequests performs one batch projection for an already-authorized page.

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

func DeriveChildSessionID(err error) string

DeriveChildSessionID returns the committed child id a derive failure carries.

func DeriveErrorCode ¶

func DeriveErrorCode(err error) string

DeriveErrorCode returns the stable public code of a continue/fork failure.

func DeriveErrorPayload ¶

func DeriveErrorPayload(err error) contract.SessionDeriveErrorPayload

DeriveErrorPayload is the continue/fork error payload for non-HTTP transports.

func DeriveFailure ¶

func DeriveFailure(err error, result session.DeriveResult) error

DeriveFailure wraps a continue/fork failure for non-HTTP transports (native tools): the same code and committed child id the HTTP/UDS routes report.

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

func ExtensionAcquisitionErrorPayload(err error) (contract.ExtensionOperationErrorPayload, bool)

ExtensionAcquisitionErrorPayload maps candidate failures consistently across public transports.

func ExtensionAgentPluginErrorCode ¶

func ExtensionAgentPluginErrorCode(err error) string

ExtensionAgentPluginErrorCode returns the stable branch key for one portable-package failure.

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

func FilterProviderUsage(envelope providerusage.Envelope, providerID string) (providerusage.Envelope, error)

FilterProviderUsage preserves the envelope shape for a single provider read.

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

func LinkedWorkErrorCode(err error) string

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

func MissingWorkspaceDiagnostics(workspaceID string) []contract.DiagnosticItem

MissingWorkspaceDiagnostics describes unavailable execution files without invalidating retained state.

func NativeToolError ¶

func NativeToolError(id toolspkg.ToolID, err error) error

NativeToolError preserves domain classifications at the native provider boundary.

func NewAutomationValidationError ¶

func NewAutomationValidationError(err error) error

NewAutomationValidationError wraps an automation validation failure with the shared sentinel.

func NewModelCatalogValidationError ¶

func NewModelCatalogValidationError(err error) error

NewModelCatalogValidationError wraps a model catalog request validation failure.

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,
	readScope store.ReadScope,
	workspaces ...WorkspaceGetter,
) (automationpkg.JobListQuery, error)

ParseAutomationJobListQuery parses the shared automation job list filters.

func ParseAutomationRunQuery ¶

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

ParseAutomationRunQuery parses the shared automation run list filters.

func ParseAutomationTriggerListQuery ¶

func ParseAutomationTriggerListQuery(
	c *gin.Context,
	readScope store.ReadScope,
	workspaces ...WorkspaceGetter,
) (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 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 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, workspaces ...WorkspaceGetter) (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, workspaces ...WorkspaceGetter) (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 PendingInteractionPayloadsFromStore ¶

func PendingInteractionPayloadsFromStore(values []store.PendingInteraction) []contract.PendingInteractionPayload

PendingInteractionPayloadsFromStore converts canonical records into sanitized wire payloads.

func ProcessScope ¶

func ProcessScope(all, includeTools bool) (sessionprocess.Scope, error)

ProcessScope maps a request's all and include_tools flags to the stop scope.

func ProcessTargets ¶

func ProcessTargets(targets []contract.SessionProcessTarget, all bool) ([]sessionprocess.Identity, error)

func ProfileLabels ¶

func ProfileLabels(c *gin.Context)

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

func ProviderUsageConsentProfile(ctx context.Context) (string, bool)

ProviderUsageConsentProfile identifies a validated local operator's settings action. Absence is deliberately background, including native tools and reloads.

func ProviderUsageRefreshInput ¶

func ProviderUsageRefreshInput(input contract.ProviderUsageRefreshRequest) (providerusage.RefreshRequest, error)

ProviderUsageRefreshInput validates transport bounds before duration conversion.

func ProviderUsageView ¶

func ProviderUsageView(
	envelope providerusage.Envelope, providerID string, cfg *config.Config,
) (providerusage.Envelope, error)

ProviderUsageView hides opt-outs in aggregate views while keeping the explicit provider diagnostic read available, including when the master switch is off.

func ResolveSpawnWorkspace ¶

func ResolveSpawnWorkspace(ctx context.Context, sessions any, parentSessionID, workspaceRef string) (string, error)

ResolveSpawnWorkspace authorizes the child workspace of a spawn before any side effect in it.

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

func RespondAppTokenError(c *gin.Context, err error, authentication bool)

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

func RollbackSpawnWorktree(ctx context.Context, svc WorktreeService, target SpawnWorktreeTarget) error

RollbackSpawnWorktree removes a worktree created for a spawn that did not complete.

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

func SearchAgentMemorySessions(
	ctx context.Context,
	sessions any,
	policy workspaceaccess.Policy,
	actor workspaceaccess.ActorRef,
	profileID, query string,
) ([]agentmemory.SearchResult, error)

SearchAgentMemorySessions checks access before reading any transcript.

func SessionActivityHealthPayloadsFromObserve ¶

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

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

func SessionAttachmentRequestBodyLimit ¶

func SessionAttachmentRequestBodyLimit(maxFileBytes int64) int64

SessionAttachmentRequestBodyLimit returns the largest multipart body accepted for one file upload.

func SessionCommandsResponseFromCatalog ¶

func SessionCommandsResponseFromCatalog(catalog commandpkg.Catalog) contract.SessionCommandsResponse

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

func SessionCompactPayload ¶

func SessionCompactPayload(result session.CompactionRequestResult) contract.SessionCompactResponse

SessionCompactPayload maps the acceptance receipt shared by transports and tools.

func SessionDerivePreviewPayload ¶

func SessionDerivePreviewPayload(preview session.DerivePreview) contract.SessionDerivePreviewResponse

SessionDerivePreviewPayload projects a derive preview onto the public payload.

func SessionDerivedPayloadFromResult ¶

func SessionDerivedPayloadFromResult(result session.DeriveResult) contract.SessionDerivedPayload

SessionDerivedPayloadFromResult projects one derive outcome onto the public payload.

func SessionEnvToPayload ¶

func SessionEnvToPayload(env config.SessionEnv) map[string]contract.SessionEnvBindingPayload

SessionEnvToPayload projects reference-only declarations to the public contract.

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

func SessionFolderPayload(folder store.SessionFolder) contract.SessionFolderPayload

SessionFolderPayload maps one store folder to its wire shape.

func SessionFolderPayloads ¶

func SessionFolderPayloads(folders []store.SessionFolder) []contract.SessionFolderPayload

SessionFolderPayloads maps store folders to their wire shape.

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

func SessionPayloadWithQueue(ctx context.Context, reader interface {
	InputQueueSummary(context.Context, string) (session.InputQueueSummary, error)
}, info *session.Info) (contract.SessionPayload, error)

SessionPayloadWithQueue adds the durable admission summary to a session detail.

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

func SessionPayloadsWithProfileOwners(
	ctx context.Context,
	payloads []contract.SessionPayload,
	profiles ProfileOwnerReader,
) ([]contract.SessionPayload, error)

SessionPayloadsWithProfileOwners requires current owner labels rather than emitting misleading empty names.

func SessionProcessTrees ¶

func SessionProcessTrees(processes []sessionprocess.Process) []contract.SessionProcessTreePayload

SessionProcessTrees groups one session's processes into the trees a stop acts on.

func SessionProfileMoveErrorCode ¶

func SessionProfileMoveErrorCode(err error) string

SessionProfileMoveErrorCode returns the stable error code of a move-to-profile refusal.

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

func SessionReparentErrorCode(err error) string

SessionReparentErrorCode returns the stable error code of a lineage-rule refusal.

func SessionStopOutcomePayload ¶

func SessionStopOutcomePayload(id string, outcome session.StopOutcome) contract.SessionStopPayload

SessionStopOutcomePayload projects the shared stop result without fabricating termination.

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

func SettingsSkillsMutationResponseFromResult(
	result settingspkg.ApplyResult,
	response contract.SettingsSkillsResponse,
) contract.SettingsSkillsMutationResponse

SettingsSkillsMutationResponseFromResult combines apply metadata with the refreshed skills section.

func SettingsUpdateResponseFromStatus ¶

func SettingsUpdateResponseFromStatus(status compozyupdate.MultiState) 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 SkillExposurePayloadsFromDomain ¶

func SkillExposurePayloadsFromDomain(states []skills.ExposureState) []contract.SkillExposurePayload

SkillExposurePayloadsFromDomain converts reconciled exposure state into the public vocabulary.

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

func SpawnPermissionNarrowing(
	tools, skills, mcpServers, workspacePaths []string,
) *session.SubagentPermissionNarrowing

SpawnPermissionNarrowing keeps absent (nil) categories distinct from empty ones so inherit_permissions can inherit only the categories the request omits.

func SpawnPromptFailurePayload ¶

func SpawnPromptFailurePayload(childSessionID string, err error) *contract.SpawnPromptPayload

SpawnPromptFailurePayload reports a first prompt that failed after the child was created. The child keeps running so the caller can retry the prompt instead of spawning a duplicate child (and worktree).

func SpawnPromptPayloadFromResult ¶

func SpawnPromptPayloadFromResult(result session.SendPromptResult) *contract.SpawnPromptPayload

SpawnPromptPayloadFromResult projects the admitted first prompt of a spawned child.

func SpawnWorktreePayloadFromTarget ¶

func SpawnWorktreePayloadFromTarget(target SpawnWorktreeTarget) *contract.SpawnWorktreePayload

SpawnWorktreePayloadFromTarget projects the bound worktree of a spawned child.

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

func StatusForModelCatalogError(err error) int

StatusForModelCatalogError maps model catalog failures to transport statuses.

func StatusForResourceError ¶

func StatusForResourceError(err error) int

func StatusForSessionError ¶

func StatusForSessionError(err error) int

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

func StatusForSessionLayoutError ¶

func StatusForSessionLayoutError(err error) int

StatusForSessionLayoutError maps folder and manual-order errors to transport statuses.

func StatusForSessionProfileMoveError ¶

func StatusForSessionProfileMoveError(err error) int

StatusForSessionProfileMoveError maps a refusal to 409 and other failures as session errors.

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

func StatusForWorkspaceError ¶

func StatusForWorkspaceError(err error) int

StatusForWorkspaceError maps workspace-domain errors to transport statuses.

func StatusForWorkspaceLayoutError ¶

func StatusForWorkspaceLayoutError(err error) int

StatusForWorkspaceLayoutError maps workspace folder and order errors to transport statuses.

func StatusForWorktreeError ¶

func StatusForWorktreeError(err error) int

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

func TerminalDomainStatus(code terminalpkg.ErrorCode) (int, bool)

TerminalDomainStatus returns the public status for every frozen terminal domain code.

func TerminalErrorResponseForError ¶

func TerminalErrorResponseForError(err error, status int, maskInternal bool) contract.TerminalErrorResponse

TerminalErrorResponseForError projects a terminal failure without writing to a transport.

func TerminalErrorStatus ¶

func TerminalErrorStatus(err error) (int, string, bool)

TerminalErrorStatus returns the status and safe code classification for a terminal failure.

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

func WorkspaceFolderPayload(folder store.WorkspaceFolder) contract.WorkspaceFolderPayload

WorkspaceFolderPayload maps one store workspace folder to its wire shape.

func WorkspaceLayoutPayload ¶

func WorkspaceLayoutPayload(layout store.WorkspaceLayout) contract.WorkspaceLayoutResponse

WorkspaceLayoutPayload maps a store workspace layout to its wire shape.

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

func WorktreeBranchOutcomePayload(outcome worktree.BranchOutcome) contract.WorktreeBranchOutcomePayload

WorktreeBranchOutcomePayload maps an opt-in branch deletion outcome to its wire shape.

func WorktreeErrorCode ¶

func WorktreeErrorCode(err error) string

func WorktreeForgePayloadFromStatus ¶

func WorktreeForgePayloadFromStatus(status *worktree.ForgeStatus) *contract.WorktreeForgeStatusPayload

func WorktreeInspectionPayload ¶

func WorktreeInspectionPayload(
	inspection worktree.Inspection,
) contract.WorktreeInspectionResponse

func WorktreePayloadFromInspection ¶

func WorktreePayloadFromInspection(inspection worktree.Inspection) contract.WorktreePayload

func WorktreeStatusPayloadFromStatus ¶

func WorktreeStatusPayloadFromStatus(status *worktree.Status) *contract.WorktreeStatusPayload

func WorktreesPayloadFromListing ¶

func WorktreesPayloadFromListing(listing *worktree.DetailedListing) contract.WorktreesResponse

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)
	ListAgentsForWorkspace(context.Context, *workspacepkg.ResolvedWorkspace) ([]AgentCatalogEntry, error)
	GetAgent(ctx context.Context, name string) (AgentCatalogEntry, error)
}

AgentCatalog exposes projected resource-backed agent definitions.

type AgentCatalogEntry ¶

type AgentCatalogEntry struct {
	MemoryOrigin string
	PackageOwned bool
	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 AgentInstanceAPI ¶

type AgentInstanceAPI struct {
	SourceExtensions    source.ExtensionPoller
	Metrics             func(context.Context, string, string) (agentinstance.Metrics, error)
	ReadPeer            func(context.Context, agentinstance.Instance) (contract.AgentInstancePeer, error)
	SkillPublished      func(context.Context) error
	SkillProposals      *agentinstance.SkillProposalService
	SkillTarget         func(context.Context, agentinstance.Instance) (string, []string, error)
	HeldWakes           func(context.Context, string) (int64, error)
	UnattendedTurnLimit int64
	WakeState           func(context.Context, string) (heartbeat.InstanceWakeState, error)
	CountActive         func(context.Context, string) (int64, error)
	MaxActiveInstances  int
	FatigueLimit        int
	ReadAttention       func(context.Context, string) (bool, error)
	ReadPayload         func(context.Context, agentinstance.Instance) (contract.AgentInstancePayload, error)
	CheckSettings       AgentInstanceCheckSettings
	Checks              AgentInstanceChecker
	Service             *agentinstance.Service
	Store               agentinstance.InstanceStore
	Reports             agentinstance.ReportStore
	Authority           agentinstance.Authority
	// Profiles labels each instance with its owner's profile_name.
	Profiles ProfileOwnerReader
}

func (*AgentInstanceAPI) Away ¶

func (*AgentInstanceAPI) CheckIns ¶

func (api *AgentInstanceAPI) CheckIns(
	ctx context.Context,
	id, cursor string,
	limit int,
) (contract.AgentInstanceCheckInsResponse, error)

func (*AgentInstanceAPI) ListPage ¶

ListPage fills an authorized page before deciding whether a next page exists.

func (*AgentInstanceAPI) ListResponse ¶

func (api *AgentInstanceAPI) ListResponse(
	ctx context.Context,
	profileIDs ...string,
) (contract.AgentInstanceListResponse, error)

ListResponse starts a page with the active count of the profiles it reads. The cap applies per profile, so the aggregate reports the sum across every owner.

func (*AgentInstanceAPI) Payload ¶

func (*AgentInstanceAPI) PeersPage ¶

PeersPage applies both instance and workspace authority before filling a page. It never hydrates reports, session state or private runtime settings for peers.

func (*AgentInstanceAPI) ReportsPage ¶

ReportsPage shares report hydration and terminal-page detection across transports.

func (*AgentInstanceAPI) SkillReviewsPage ¶

SkillReviewsPage binds continuation to the authorized population, then hydrates only the page.

type AgentInstanceCheckSettings ¶

type AgentInstanceCheckSettings interface {
	SetChecks(context.Context, string, bool) (agentinstance.Instance, error)
}

type AgentInstanceChecker ¶

type AgentInstanceChecker interface {
	Check(context.Context, string, bool) (heartbeat.CheckResult, error)
}

type AgentInstanceOccurrenceReader ¶

type AgentInstanceOccurrenceReader interface {
	Occurrence(context.Context, string, string) (agentinstance.Occurrence, error)
}

type AgentInstructionsDrafter ¶

type AgentInstructionsDrafter interface {
	DraftInstructions(context.Context, session.DraftInstructionsRequest) (string, error)
}

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,
		readScope store.ReadScope,
		workspaceID string,
	) (map[string]session.AgentSessionMetrics, error)
}

AgentSessionMetricsReader exposes exact workspace-scoped session aggregates.

type AppTokenManager ¶

type AppTokenManager interface {
	CreateAppToken(context.Context, string, []string) (gateway.AppTokenIssued, error)
	ListAppTokens(context.Context, gateway.AppTokenState) ([]gateway.AppToken, error)
	UpdateAppToken(context.Context, string, gateway.AppTokenPatch) (gateway.AppToken, error)
	RevokeAppToken(context.Context, string) (gateway.AppTokenRevokeResult, error)
}

AppTokenManager owns operator-local app credentials.

type AutomationManager ¶

type AutomationManager interface {
	LatestRunsByOwner(
		ctx context.Context,
		owner automationpkg.RunOwnerKind,
		ids []string,
	) (map[string]automationpkg.Run, error)
	ListSuggestions(
		ctx context.Context,
		readScope store.ReadScope,
		workspaceRef string,
		status automationpkg.SuggestionStatus,
	) ([]automationpkg.Suggestion, error)
	AcceptSuggestion(
		ctx context.Context,
		profileID string,
		workspaceRef string,
		suggestionID string,
	) (automationpkg.SuggestionAcceptance, error)
	DismissSuggestion(
		ctx context.Context,
		profileID string,
		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 {
	AgentInstances               *AgentInstanceAPI
	TransportName                string
	MaskInternalErrors           bool
	IncludeSessionWorkspaceInSSE bool
	Subagents                    session.SubagentService
	SessionMonitors              SessionMonitorService
	SessionProcesses             SessionProcessService
	Sessions                     SessionManager
	SessionAcceptance            SessionAcceptanceManager
	DrainController              DaemonDrainController
	SessionCatalog               SessionCatalog
	Observer                     Observer
	SchemaStreams                SchemaStreamStatusReader
	Resources                    ResourceService
	Extensions                   ExtensionService
	Tools                        ToolRegistry
	ToolArtifacts                toolspkg.ToolArtifactStore
	SessionAttachments           SessionAttachmentStore
	SessionFiles                 SessionFileSearcher
	Toolsets                     ToolsetRegistry
	ToolApprovals                ToolApprovalIssuer
	ApprovalCoordinator          toolspkg.ApprovalCoordinator
	ApprovalGrants               ToolApprovalGrantService
	CmdPalette                   cmdpalette.Registry
	Clarify                      toolspkg.ClarifyBroker
	Automation                   AutomationManager
	Loops                        LoopService
	TaskDesignations             TaskDesignationStore
	Tasks                        TaskService
	Profiles                     ProfileService
	SupportBundles               SupportBundleService
	Settings                     SettingsService
	SettingsRestart              SettingsRestartController
	SettingsUpdate               SettingsUpdateController
	Vault                        VaultService
	Workspaces                   WorkspaceService
	Worktrees                    WorktreeService
	WorkspaceAccess              workspaceaccess.Policy
	WindowManager                WindowManagerProvider
	// WindowManagerPingInterval spaces stream pings and heartbeat frames; zero keeps the default.
	WindowManagerPingInterval   time.Duration
	Terminal                    TerminalProvider
	Onboarding                  OnboardingStore
	AgentCatalog                AgentCatalog
	AgentDefinitionSync         AgentDefinitionSync
	ContextWindowResolver       ContextWindowResolver
	ModelCatalog                ModelCatalogService
	ProviderUsage               ProviderUsageService
	MarketplaceCatalog          MarketplaceCatalogService
	OnProviderAuthSuccess       func()
	ProviderAuthVerdicts        *authproviders.AuthVerdicts
	ProviderAuthRunner          authproviders.ProviderAuthCommandRunner
	ProviderAuthCommandResolver authproviders.ProviderAuthCommandResolver
	ProviderACPProbe            func(context.Context, acp.SessionInspectionRequest) error
	AgentContextService         AgentContextService
	SoulAuthoring               SoulAuthoringService
	AgentMemory                 *agentmemory.Store
	SoulHistoryPurger           SoulHistoryPurger
	SoulRefresher               SoulRefresher
	HeartbeatAuthoring          HeartbeatAuthoringService
	HeartbeatHistoryPurger      HeartbeatHistoryPurger
	HeartbeatStatus             HeartbeatStatusService
	HeartbeatWake               HeartbeatWakeService
	SessionHealth               SessionHealthReader
	HeartbeatWakeEvents         HeartbeatWakeEventReader
	CoordinatorRole             CoordinatorRoleResolver
	Roles                       RolesStatusProvider
	SkillsRegistry              SkillsRegistry
	SkillResources              SkillResourceSyncer
	SkillExposures              store.SkillExposureRepository
	SkillExposureEvents         store.EventSummaryStore
	TaskActorContextResolver    TaskActorContextResolver
	RuntimeMemory               doctor.RuntimeMemorySnapshotSource
	HostLoad                    doctor.HostLoadSnapshotSource
	DeadEntities                doctor.DeadEntitySource
	AppTokens                   AppTokenManager
	OpenAPI                     *OpenAPIDocument
	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 {
	AgentInstances               *AgentInstanceAPI
	TransportName                string
	MaskInternalErrors           bool
	IncludeSessionWorkspaceInSSE bool
	Subagents                    session.SubagentService
	SessionMonitors              SessionMonitorService
	SessionProcesses             SessionProcessService
	Sessions                     SessionManager
	SessionAcceptance            SessionAcceptanceManager
	DrainController              DaemonDrainController
	SessionCatalog               SessionCatalog
	Observer                     Observer
	SchemaStreams                SchemaStreamStatusReader
	Resources                    ResourceService
	Extensions                   ExtensionService
	Tools                        ToolRegistry
	ToolArtifacts                toolspkg.ToolArtifactStore
	SessionAttachments           SessionAttachmentStore
	SessionFiles                 SessionFileSearcher
	Toolsets                     ToolsetRegistry
	ToolApprovals                ToolApprovalIssuer
	ApprovalCoordinator          toolspkg.ApprovalCoordinator
	ApprovalGrants               ToolApprovalGrantService
	CmdPalette                   cmdpalette.Registry
	Clarify                      toolspkg.ClarifyBroker
	Automation                   AutomationManager
	Loops                        LoopService
	TaskDesignations             TaskDesignationStore
	Tasks                        TaskService
	Profiles                     ProfileService
	SupportBundles               SupportBundleService
	Settings                     SettingsService
	SettingsRestart              SettingsRestartController
	SettingsUpdate               SettingsUpdateController
	Vault                        VaultService
	Workspaces                   WorkspaceService
	Worktrees                    WorktreeService
	WorkspaceAccess              workspaceaccess.Policy
	WindowManager                WindowManagerProvider
	Terminal                     TerminalProvider
	Onboarding                   OnboardingStore
	AgentCatalog                 AgentCatalog
	AgentDefinitionSync          AgentDefinitionSync
	ContextWindowResolver        ContextWindowResolver
	ModelCatalog                 ModelCatalogService
	ProviderUsage                ProviderUsageService
	MarketplaceCatalog           MarketplaceCatalogService
	OnProviderAuthSuccess        func()
	ProviderAuthVerdicts         *authproviders.AuthVerdicts
	ProviderAuthRunner           authproviders.ProviderAuthCommandRunner
	ProviderAuthCommandResolver  authproviders.ProviderAuthCommandResolver
	ProviderACPProbe             func(context.Context, acp.SessionInspectionRequest) error
	AgentContextService          AgentContextService
	SoulAuthoring                SoulAuthoringService
	AgentMemory                  *agentmemory.Store
	SoulHistoryPurger            SoulHistoryPurger
	SoulRefresher                SoulRefresher
	HeartbeatAuthoring           HeartbeatAuthoringService
	HeartbeatHistoryPurger       HeartbeatHistoryPurger
	HeartbeatStatus              HeartbeatStatusService
	HeartbeatWake                HeartbeatWakeService
	SessionHealth                SessionHealthReader
	HeartbeatWakeEvents          HeartbeatWakeEventReader
	CoordinatorRole              CoordinatorRoleResolver
	Roles                        RolesStatusProvider
	SkillsRegistry               SkillsRegistry
	SkillResources               SkillResourceSyncer
	SkillExposures               store.SkillExposureRepository
	SkillExposureEvents          store.EventSummaryStore
	TaskActorContextResolver     TaskActorContextResolver
	RuntimeMemory                doctor.RuntimeMemorySnapshotSource
	HostLoad                     doctor.HostLoadSnapshotSource
	DeadEntities                 doctor.DeadEntitySource
	AppTokens                    AppTokenManager
	OpenAPI                      *OpenAPIDocument
	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) AcknowledgeAttentionNotifications ¶

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

AcknowledgeAttentionNotifications acknowledges exactly the frozen bell or Home population.

func (*BaseHandlers) AddMarketplaceSource ¶

func (h *BaseHandlers) AddMarketplaceSource(c *gin.Context)
func (h *BaseHandlers) AddSessionWorkLink(c *gin.Context)

func (*BaseHandlers) AddTaskDependency ¶

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

AddTaskDependency adds one blocking dependency edge.

func (*BaseHandlers) AdmitCmdPaletteViewSessionEvent ¶

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

func (*BaseHandlers) AdoptAgentInstance ¶

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

func (*BaseHandlers) AdoptWorktree ¶

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

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

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

AgentNotify publishes a bounded notification for the validated agent caller.

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

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

AgentTaskStart starts one claimed task run under the calling session's lease.

func (*BaseHandlers) AmendLoopNode ¶

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

func (*BaseHandlers) AnswerSessionClarification ¶

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

AnswerSessionClarification resolves one live request after workspace/session authorization.

func (*BaseHandlers) AnswerTerminalInputRequest ¶

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

func (*BaseHandlers) ApplySettingsUpdate ¶

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

ApplySettingsUpdate durably acquires an asynchronous update operation.

func (*BaseHandlers) ApproveAgentHeartbeatScript ¶

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

func (*BaseHandlers) ApproveAgentSkillReview ¶

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

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

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

func (*BaseHandlers) ArchiveProfile ¶

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

ArchiveProfile archives a profile after validating the supplied plan revision.

func (*BaseHandlers) ArchiveSession ¶

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

ArchiveSession removes one session from default catalog listings. A live session is refused unless the request opts into stopping it first.

func (*BaseHandlers) ArchiveTask ¶

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

ArchiveTask archives one task triage record for the current actor.

func (*BaseHandlers) ArchiveWorkspace ¶

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

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

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

AttentionNotifications lists unread occurrences across all workspaces and source profiles.

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

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

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

func (h *BaseHandlers) BindSessionWorktree(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) 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 immediately fences one authored node.

func (*BaseHandlers) CancelLoopRun ¶

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

CancelLoopRun immediately fences and terminalizes one run.

func (*BaseHandlers) CancelPendingToolApproval ¶

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

func (*BaseHandlers) CancelSessionMonitor ¶

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

CancelSessionMonitor stops one monitor without waking its session.

func (*BaseHandlers) CancelSessionPrompt ¶

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

CancelSessionPrompt cancels one active turn through the canonical idempotent path.

func (*BaseHandlers) CancelSettingsUpdate ¶

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

CancelSettingsUpdate cancels and archives a dormant update operation.

func (*BaseHandlers) CancelSubagent ¶

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

func (*BaseHandlers) CancelTask ¶

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

CancelTask requests cancellation for one task tree.

func (*BaseHandlers) CancelTaskRun ¶

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

CancelTaskRun cancels one non-terminal run.

func (*BaseHandlers) CancelWorktreeCreate ¶

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

func (*BaseHandlers) CancelWorktreeExitAction ¶

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

func (*BaseHandlers) CaptureDaemonProfile ¶

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

CaptureDaemonProfile is experimental and registered exclusively by the UDS transport.

func (*BaseHandlers) CheckAgentInstance ¶

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

func (*BaseHandlers) CheckSettingsUpdate ¶

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

CheckSettingsUpdate refreshes release discovery without acquiring an update operation.

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

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

ClearSessionParent makes an adopted child session top-level again.

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

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

func (*BaseHandlers) CompactSession ¶

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

CompactSession accepts one standalone maintenance turn (experimental).

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

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

ContinueSession starts a new session for another agent with the source conversation carried over.

func (*BaseHandlers) ControlTerminalRecording ¶

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

func (*BaseHandlers) CreateAgent ¶

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

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

func (*BaseHandlers) CreateAgentInstance ¶

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

func (*BaseHandlers) CreateAppToken ¶

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

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

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

CreateProfile creates a profile and optionally activates it for a selection lens.

func (*BaseHandlers) CreateSession ¶

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

CreateSession creates a new runtime session.

func (*BaseHandlers) CreateSessionFolder ¶

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

CreateSessionFolder adds a folder at the top of the folder order.

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

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

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

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

CreateWorkspaceFolder adds a root folder at the top of the folder order.

func (*BaseHandlers) CreateWorktree ¶

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

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

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

DeleteProfile removes a profile after validating the supplied plan revision.

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

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

DeleteSessionAttachment removes one authorized attachment.

func (*BaseHandlers) DeleteSessionFolder ¶

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

DeleteSessionFolder removes a folder; its sessions return to the workspace root.

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

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

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

func (*BaseHandlers) DeleteTaskExecutionProfile ¶

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

DeleteTaskExecutionProfile removes one persisted task-owned execution profile.

func (*BaseHandlers) DeleteTerminal ¶

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

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

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

DeleteWorkspaceFolder removes a folder; its workspaces return to the root.

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

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

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

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

DismissWorktree authorizes metadata cleanup without deleting files or history. The lifecycle service owns repeated-request and concurrent-state handling. Only an explicit delete_branch request touches Git, after the record is dismissed.

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

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

func (*BaseHandlers) DownloadTerminalRecording ¶

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

func (*BaseHandlers) DraftAgentInstructions ¶

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

func (*BaseHandlers) DrainDaemon ¶

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

DrainDaemon closes new-work admission without interrupting admitted work.

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

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

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

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

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

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

ExposeSkill creates provider-root links for one skill.

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

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

func (*BaseHandlers) ForkSession ¶

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

ForkSession forks the session with the same agent into a new session.

func (*BaseHandlers) ForkSessionToWorktree ¶

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

ForkSessionToWorktree creates a fresh child session without changing the origin session or copying its transcript.

func (*BaseHandlers) GatewayStatus ¶

func (*BaseHandlers) GetAgent ¶

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

GetAgent returns one agent definition by name.

func (*BaseHandlers) GetAgentActivity ¶

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

func (*BaseHandlers) GetAgentHeartbeat ¶

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

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

func (*BaseHandlers) GetAgentHeartbeatSources ¶

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

func (*BaseHandlers) GetAgentHeartbeatStatus ¶

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

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

func (*BaseHandlers) GetAgentInstance ¶

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

func (*BaseHandlers) GetAgentInstanceAway ¶

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

func (*BaseHandlers) GetAgentInstanceOccurrence ¶

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

func (*BaseHandlers) GetAgentSkillReview ¶

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

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

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

func (*BaseHandlers) GetCmdPaletteRankSignals ¶

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

func (*BaseHandlers) GetCmdPaletteView ¶

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

func (*BaseHandlers) GetDoctor ¶

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

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

func (*BaseHandlers) 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) GetLoopRequest ¶

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

func (*BaseHandlers) GetLoopRun ¶

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

GetLoopRun returns one workspace-scoped Loop run.

func (*BaseHandlers) GetLoopRunBriefing ¶

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

GetLoopRunBriefing returns the server-owned verdict for one Loop run.

func (*BaseHandlers) GetLoopRunNodes ¶

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

GetLoopRunNodes returns the computed roster for one Loop run.

func (*BaseHandlers) GetLoopRunTimeline ¶

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

GetLoopRunTimeline returns one durable timeline page for a Loop run.

func (*BaseHandlers) GetMarketplaceCatalogEntry ¶

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

func (*BaseHandlers) GetOnboardingStatus ¶

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

GetOnboardingStatus reports whether first-run onboarding has been completed.

func (*BaseHandlers) GetOpenAPIDocument ¶

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

func (*BaseHandlers) GetPendingToolApproval ¶

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

func (*BaseHandlers) GetProfile ¶

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

GetProfile returns one profile by its public name.

func (*BaseHandlers) GetProfileSelections ¶

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

GetProfileSelections returns remembered profile selections, optionally filtered to one lens.

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

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

GetRuntimeIdentity returns the bounded daemon identity shared by HTTP and UDS.

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. It never writes the session: an owner lookup (a permalink, or the CLI resolving a continue/fork source) must not repair an inactive session's metadata.

func (*BaseHandlers) GetSessionStatus ¶

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

GetSessionStatus returns compact session health with wake state when available.

func (*BaseHandlers) GetSettingsAttention ¶

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

GetSettingsAttention returns the operator attention settings section.

func (*BaseHandlers) GetSettingsAutomation ¶

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

GetSettingsAutomation returns the automation settings section.

func (*BaseHandlers) GetSettingsCmdPalette ¶

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

GetSettingsCmdPalette returns the command-palette 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) GetSettingsMCPServer ¶

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

GetSettingsMCPServer returns an exact owner-qualified definition, or a manual definition when owner is omitted.

func (*BaseHandlers) GetSettingsMarketplace ¶

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

func (*BaseHandlers) GetSettingsObservability ¶

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

GetSettingsObservability returns the observability settings section.

func (*BaseHandlers) GetSettingsPersona ¶

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

GetSettingsPersona returns the profile-layerable persona defaults section.

func (*BaseHandlers) GetSettingsProvider ¶

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

GetSettingsProvider returns one provider settings item.

func (*BaseHandlers) GetSettingsProviderUsage ¶

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

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

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

GetSettingsShell returns the operator shell settings section.

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

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

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

func (*BaseHandlers) GetSubagent ¶

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

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

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

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

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

GetWorkspaceLayout returns the caller profile's workspace folders and placements.

func (*BaseHandlers) GetWorktreeExitPlan ¶

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

func (*BaseHandlers) GetWorktreeStatus ¶

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

func (*BaseHandlers) HTTPPortValue ¶

func (h *BaseHandlers) HTTPPortValue() int

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

func (*BaseHandlers) HandleClearSessionInputs ¶

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

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

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

func (*BaseHandlers) InstallExtension ¶

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

InstallExtension installs one extension from the closed distribution-source union.

func (*BaseHandlers) InvokeCmdPaletteCommand ¶

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

func (*BaseHandlers) InvokeTool ¶

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

InvokeTool dispatches a concrete tool invocation through the registry.

func (*BaseHandlers) ListAgentAggregate ¶

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

func (*BaseHandlers) ListAgentCatalog ¶

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

ListAgentCatalog returns a scoped fleet page with exact session metrics.

func (*BaseHandlers) ListAgentHeartbeatHistory ¶

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

ListAgentHeartbeatHistory lists HEARTBEAT.md managed authoring revisions.

func (*BaseHandlers) ListAgentInstanceCheckIns ¶

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

func (*BaseHandlers) ListAgentInstanceReports ¶

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

func (*BaseHandlers) ListAgentInstances ¶

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

func (*BaseHandlers) ListAgentSkillReviews ¶

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

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

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

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

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

func (*BaseHandlers) ListCmdPaletteCommands ¶

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

func (*BaseHandlers) ListExtensionEnablement ¶

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

ListExtensionEnablement returns effective state for every profile.

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

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

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

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

ListMarketplace serves the one-catalog envelope on HTTP and UDS.

func (*BaseHandlers) ListMarketplaceSources ¶

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

func (*BaseHandlers) ListProcesses ¶

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

func (*BaseHandlers) ListProfileOperations ¶

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

ListProfileOperations returns lifecycle operations recorded by the profile service.

func (*BaseHandlers) ListProfiles ¶

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

ListProfiles returns every profile and its ownership summary.

func (*BaseHandlers) ListProviderUsage ¶

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

ListProviderUsage reads only the profile-scoped cache.

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

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

ListSessionDescendants lists the sessions with_children would include. The catalog is paginated and filtered, so clients cannot derive this from it.

func (*BaseHandlers) ListSessionFacets ¶

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

ListSessionFacets returns exact population counts separately from bounded rows.

func (*BaseHandlers) ListSessionFolders ¶

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

ListSessionFolders returns the caller profile's folders in one workspace.

func (*BaseHandlers) ListSessionInteractions ¶

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

ListSessionInteractions lists sanitized actionable interactions for one session.

func (*BaseHandlers) ListSessionLinkedWork ¶

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

func (*BaseHandlers) ListSessionMonitors ¶

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

ListSessionMonitors returns the session's monitors, active first.

func (*BaseHandlers) ListSessionProcesses ¶

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

func (*BaseHandlers) ListSessionSubagents ¶

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

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

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

func (*BaseHandlers) ListTerminalInputRequests ¶

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

func (*BaseHandlers) ListTerminals ¶

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

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

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

func (*BaseHandlers) ListWorktrees ¶

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

func (*BaseHandlers) LogoutSettingsMCPAuth ¶

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

LogoutSettingsMCPAuth revokes and removes one scoped credential set.

func (*BaseHandlers) MarkAgentInstanceSeen ¶

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

func (*BaseHandlers) MarkSessionSeen ¶

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

MarkSessionSeen clears a session's Needs you for the operator until its next occurrence.

func (*BaseHandlers) MarkTaskRead ¶

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

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

func (*BaseHandlers) MarketplaceList ¶

func (*BaseHandlers) MintGatewayPairing ¶

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

func (*BaseHandlers) MintGatewayStreamTicket ¶

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

func (*BaseHandlers) MintTerminalAttachTicket ¶

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

func (*BaseHandlers) ModelCatalogRoute ¶

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

ModelCatalogRoute dispatches the native provider model catalog route family.

func (*BaseHandlers) MoveSession ¶

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

MoveSession moves a session into a folder or back to the workspace root.

func (*BaseHandlers) MoveSessionToLater ¶

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

MoveSessionToLater stops a session tree and parks it in Later.

func (*BaseHandlers) MoveSessionToProfile ¶

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

MoveSessionToProfile copies a stopped user session into another profile and archives the original.

func (*BaseHandlers) MoveWorkspace ¶

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

MoveWorkspace moves a workspace into a folder or back to the root.

func (*BaseHandlers) MutateSessionGoal ¶

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

MutateSessionGoal executes one authenticated typed Goal operation for the route session.

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

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

func (*BaseHandlers) PatchLoop ¶

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

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

func (*BaseHandlers) PauseAgentInstance ¶

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

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

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

PermissionEntries lists the newest permission decisions with their initiators.

func (*BaseHandlers) PermissionRollup ¶

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

func (*BaseHandlers) PinCmdPaletteCommand ¶

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

func (*BaseHandlers) PrepareProfileArchive ¶

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

PrepareProfileArchive previews the blockers and work affected by archiving a profile.

func (*BaseHandlers) PrepareProfileDelete ¶

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

PrepareProfileDelete previews the resources that deleting a profile will remove.

func (*BaseHandlers) PrepareProfileRename ¶

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

PrepareProfileRename previews the effects of renaming one profile.

func (*BaseHandlers) PrepareWorktreeExitPlan ¶

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

func (*BaseHandlers) PreviewExtensionEnable ¶

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

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

func (*BaseHandlers) PreviewExtensionInstall ¶

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

PreviewExtensionInstall returns the exact declared-profile and placement summary without mutation.

func (*BaseHandlers) PreviewSessionDerive ¶

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

PreviewSessionDerive reports what a continue or fork of the session would carry; it never writes.

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

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

ProfileRemoteWriteForbidden rejects profile-state writes on paired listeners.

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

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

PutProfileSelection stores the selected profile for one selection lens.

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

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

func (*BaseHandlers) ReadSessionAttachmentBytes ¶

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

ReadSessionAttachmentBytes streams one authorized attachment with its stored MIME type.

func (*BaseHandlers) ReadTaskRunResult ¶

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

ReadTaskRunResult returns one authorized exact-byte result page.

func (*BaseHandlers) ReadTerminal ¶

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

func (*BaseHandlers) ReadToolArtifact ¶

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

ReadToolArtifact returns one retained result page within the resolved workspace.

func (*BaseHandlers) RecordCmdPaletteUsage ¶

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

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 the extension catalog.

func (*BaseHandlers) RefreshMarketplaceSource ¶

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

func (*BaseHandlers) RefreshProviderUsage ¶

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

func (*BaseHandlers) RefreshSessionPullRequest ¶

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

func (*BaseHandlers) RefreshSessionSoul ¶

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

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

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

func (*BaseHandlers) RegisterAgentMemoryRoutes ¶

func (h *BaseHandlers) RegisterAgentMemoryRoutes(agents gin.IRouter)

func (*BaseHandlers) RegisterWindowManagerClient ¶

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

RegisterWindowManagerClient creates or refreshes one explicit client-local view.

func (*BaseHandlers) RejectAgentSkillReview ¶

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

func (*BaseHandlers) RejectTask ¶

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

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

func (*BaseHandlers) RejectTerminalInputRequest ¶

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

func (*BaseHandlers) ReloadDevExtension ¶

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

ReloadDevExtension swaps one workspace instance to a verified generation.

func (*BaseHandlers) ReloadSettings ¶

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

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

func (*BaseHandlers) RemoveDiscoveredWorktree ¶

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

RemoveDiscoveredWorktree deletes a Git-only checkout named by its listed path. No registry row owns it, so the caller only needs mutation authority. Refusals share the record removal 409 payload so clients reuse one force escalation.

func (*BaseHandlers) RemoveExtension ¶

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

RemoveExtension removes one managed extension via the daemon.

func (*BaseHandlers) RemoveMarketplaceSource ¶

func (h *BaseHandlers) RemoveMarketplaceSource(c *gin.Context)
func (h *BaseHandlers) RemoveSessionWorkLink(c *gin.Context)

func (*BaseHandlers) RemoveTaskDependency ¶

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

RemoveTaskDependency removes one blocking dependency edge.

func (*BaseHandlers) RemoveWorktree ¶

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

RemoveWorktree authorizes the saved target before delegating checkout removal. Lifecycle refusals retain their structured 409 payload, including force risks. An explicit delete_branch request answers 200 with the branch outcome.

func (*BaseHandlers) RenameGatewayDevice ¶

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

func (*BaseHandlers) RenameProfile ¶

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

RenameProfile applies a previously reviewed profile rename request.

func (*BaseHandlers) RenameSession ¶

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

RenameSession changes one user session's durable display name.

func (*BaseHandlers) RenameSessionFolder ¶

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

RenameSessionFolder changes one folder's display name.

func (*BaseHandlers) RenameWorkspaceFolder ¶

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

RenameWorkspaceFolder changes one folder's display name.

func (*BaseHandlers) ReorderSessionFolders ¶

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

ReorderSessionFolders applies a complete folder order.

func (*BaseHandlers) ReorderSessions ¶

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

ReorderSessions pins a manual session order inside one container.

func (*BaseHandlers) ReorderWorkspaceFolders ¶

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

ReorderWorkspaceFolders applies a complete workspace folder order.

func (*BaseHandlers) ReorderWorkspaces ¶

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

ReorderWorkspaces pins a manual workspace order inside one container.

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

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

RequireProjectReference rejects User on surfaces that require a registered project.

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

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

RequireSessionApprovalAuthority resolves agent identity before applying session policy.

func (*BaseHandlers) RerunLoopRun ¶

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

func (*BaseHandlers) ResetCmdPalettePersonalization ¶

func (h *BaseHandlers) ResetCmdPalettePersonalization(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) ResolvePendingToolApproval ¶

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

func (*BaseHandlers) ResolveWorkspace ¶

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

ResolveWorkspace resolves or registers a workspace from a path.

func (*BaseHandlers) RespondLoopRequest ¶

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

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

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

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

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

ResumeSessionFromLater returns a parked session to the normal flow without starting its runtime.

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

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

RetryProfileOperation retries one failed profile lifecycle operation.

func (*BaseHandlers) RetryTaskRun ¶

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

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

func (*BaseHandlers) RevokeAgentHeartbeatScript ¶

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

func (*BaseHandlers) RevokeAppToken ¶

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

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

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

func (*BaseHandlers) SearchExtensions ¶

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

SearchExtensions returns one stable page from curated and GitHub discovery.

func (*BaseHandlers) SearchSessionFiles ¶

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

SearchSessionFiles lists ranked files and folders under one session's working directory.

func (*BaseHandlers) SearchSessionTools ¶

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

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

func (*BaseHandlers) SearchSessionWorkCandidates ¶

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

func (*BaseHandlers) SearchTools ¶

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

SearchTools searches the operator-visible registry projection.

func (*BaseHandlers) SessionAttentionSummary ¶

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

SessionAttentionSummary returns exact operator-wide attention counts.

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

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

SessionPresence acquires, renews, or releases one operator presence lease.

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

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

SessionTranscriptOutline returns the full retained operator-message trail.

func (*BaseHandlers) SessionTranscriptSearch ¶

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

SessionTranscriptSearch searches retained projected messages using literal text.

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

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

func (*BaseHandlers) SessionWait ¶

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

SessionWait performs one request-coupled, bounded wait for a canonical badge.

func (*BaseHandlers) SessionsSnapshot ¶

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

SessionsSnapshot returns all known session payloads for support bundles.

func (*BaseHandlers) SetExtensionEnablement ¶

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

SetExtensionEnablement writes one profile-specific state.

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

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

SetSessionParent adopts a parentless user session as a child of another session.

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

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

SetTaskWorktreePolicy patches only the worktree block of one task execution profile.

func (*BaseHandlers) SetToolApprovalGrant ¶

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

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

func (*BaseHandlers) ShutdownEventStreams ¶

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

ShutdownEventStreams joins upgraded streams, which net/http cannot drain.

func (*BaseHandlers) ShutdownTerminalStreams ¶

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

ShutdownTerminalStreams stops upgrades and waits for every terminal stream.

func (*BaseHandlers) ShutdownWindowManagerStreams ¶

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

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

func (*BaseHandlers) SignalTerminal ¶

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

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

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

func (*BaseHandlers) StreamCmdPaletteView ¶

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

func (*BaseHandlers) StreamCmdPaletteViewSession ¶

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

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 as SSE or WebSocket frames with bounded replay.

func (*BaseHandlers) StreamLoopRunEvents ¶

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

StreamLoopRunEvents streams retained Loop run events over SSE.

func (*BaseHandlers) StreamProviderUsage ¶

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

StreamProviderUsage emits cache invalidations, never credentials or account data.

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

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

func (*BaseHandlers) StreamTerminalAggregate ¶

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

func (*BaseHandlers) StreamTerminalCatalog ¶

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

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

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

func (*BaseHandlers) StreamWorktreeCatalog ¶

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

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

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

func (*BaseHandlers) TerminateSessionProcesses ¶

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

func (*BaseHandlers) TriggerAutomationJob ¶

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

TriggerAutomationJob forces one immediate manual automation run.

func (*BaseHandlers) TriggerSettingsRestart ¶

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

TriggerSettingsRestart starts the asynchronous daemon restart flow.

func (*BaseHandlers) UnarchiveProfile ¶

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

UnarchiveProfile restores an archived profile to the active catalog.

func (*BaseHandlers) UnarchiveSession ¶

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

UnarchiveSession restores one session to default catalog listings.

func (*BaseHandlers) UnarchiveWorkspace ¶

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

func (*BaseHandlers) UnbindGatewayIngress ¶

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

func (*BaseHandlers) UnbindSessionWorktree ¶

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

func (*BaseHandlers) UndrainDaemon ¶

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

UndrainDaemon restores new-work admission.

func (*BaseHandlers) UnexposeSkill ¶

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

UnexposeSkill removes provider-root links proven to be owned by CompozyOS.

func (*BaseHandlers) UnpinCmdPaletteCommand ¶

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

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

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

func (*BaseHandlers) UpdateAppToken ¶

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

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

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

func (*BaseHandlers) UpdateProfile ¶

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

UpdateProfile updates the identity fields of one profile.

func (*BaseHandlers) UpdateSettingsAttention ¶

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

UpdateSettingsAttention persists the operator attention settings section.

func (*BaseHandlers) UpdateSettingsAutomation ¶

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

UpdateSettingsAutomation persists the automation settings section.

func (*BaseHandlers) UpdateSettingsCmdPalette ¶

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

UpdateSettingsCmdPalette persists command-palette personalization settings.

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

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

func (*BaseHandlers) UpdateSettingsObservability ¶

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

UpdateSettingsObservability persists the observability settings section.

func (*BaseHandlers) UpdateSettingsPersona ¶

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

UpdateSettingsPersona persists the profile-layerable persona defaults section.

func (*BaseHandlers) UpdateSettingsProviderUsage ¶

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

func (*BaseHandlers) UpdateSettingsRoles ¶

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

UpdateSettingsRoles persists the background-role routing settings section.

func (*BaseHandlers) UpdateSettingsShell ¶

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

UpdateSettingsShell persists the operator shell settings section.

func (*BaseHandlers) UpdateSettingsSkills ¶

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

UpdateSettingsSkills persists the skills settings section and returns its refreshed read model.

func (*BaseHandlers) UpdateSettingsWindowManager ¶

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

UpdateSettingsWindowManager returns canonical persisted settings and their separate apply receipt.

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

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

UploadSessionAttachment stores one multipart file in the authorized session scope.

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

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

func (*BaseHandlers) WakeAgentHeartbeat ¶

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

WakeAgentHeartbeat requests one manual advisory Heartbeat wake decision.

func (*BaseHandlers) WorkspaceReferenceGuard ¶

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

WorkspaceReferenceGuard rejects unsupported User selectors before registry lookup.

type ContextWindowResolver ¶

type ContextWindowResolver interface {
	ContextWindow(context.Context, string, string) (*int64, error)
}

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,
	profileName 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 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 ExtensionEnablementService ¶

type ExtensionEnablementService interface {
	ListEnablement(ctx context.Context, name string) ([]contract.ExtensionEnablementPayload, error)
	SetEnablement(
		ctx context.Context,
		name string,
		req contract.SetExtensionEnablementRequest,
		actor taskpkg.ActorContext,
	) (contract.ExtensionEnablementPayload, error)
}

ExtensionEnablementService exposes the profile-specific extension authority.

type ExtensionInstallPreviewService ¶

type ExtensionInstallPreviewService interface {
	PreviewInstall(
		ctx context.Context,
		req contract.InstallExtensionRequest,
		actor taskpkg.ActorContext,
	) (contract.ExtensionInstallPreviewPayload, error)
}

ExtensionInstallPreviewService exposes the mutation-free install confirmation contract.

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)
	InventoryScoped(
		ctx context.Context,
		name string,
		actor taskpkg.ActorContext,
	) (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 GoalCommandService ¶

type GoalCommandService interface {
	Handle(
		context.Context,
		string,
		string,
		session.PromptCaller,
		session.GoalCommand,
	) (session.GoalDispatchDecision, error)
}

GoalCommandService is the authenticated structured Goal mutation seam shared by HTTP, UDS, CLI, and tools.

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 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 {
	AllWorkspaces bool
	ReadScope     store.ReadScope
	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 LoopRequestListQuery ¶

type LoopRequestListQuery struct {
	AllWorkspaces bool
	WorkspaceIDs  []string
	ReadScope     store.ReadScope
	RunID         string
	State         string
	Cursor        string
	Limit         int
}

LoopRequestListQuery contains request inventory filters shared by HTTP and UDS.

type LoopRunInput ¶

type LoopRunInput struct {
	Request   contract.RunLoopRequest
	ProfileID string
	StartKind dsl.StartKind
	Actor     taskpkg.ActorContext
	Dry       bool
}

LoopRunInput carries the resolved owner and transport context for one Loop start.

type LoopRunListQuery ¶

type LoopRunListQuery struct {
	Order         string
	AllWorkspaces bool
	WorkspaceIDs  []string
	ReadScope     store.ReadScope
	LoopName      string
	Status        string
	Origin        string
	OriginSession string
	Live          *bool
	Cursor        string
	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 LoopRunReadService ¶

LoopRunReadService is the computed read contract used by run-read routes.

type LoopService ¶

type LoopService interface {
	ListLoops(
		ctx context.Context,
		workspaceID string,
		query looppkg.CatalogQuery,
	) (contract.LoopsResponse, error)
	CreateLoop(
		ctx context.Context,
		workspaceID string,
		profileID string,
		req contract.CreateLoopRequest,
	) (contract.LoopResponse, error)
	GetLoop(ctx context.Context, workspaceID string, profileID string, name string) (contract.LoopResponse, error)
	PatchLoop(
		ctx context.Context,
		workspaceID string,
		profileID string,
		name string,
		req contract.PatchLoopRequest,
	) (contract.LoopResponse, error)
	ValidateLoop(
		ctx context.Context,
		workspaceID string,
		profileID string,
		name string,
		req contract.ValidateLoopRequest,
	) (contract.LoopValidationResponse, error)
	DeleteLoop(ctx context.Context, workspaceID string, profileID string, name string) error
	RunLoop(
		ctx context.Context,
		workspaceID string,
		name string,
		input LoopRunInput,
	) (contract.RunLoopResponse, error)
	GetLoopConfig(
		ctx context.Context,
		workspaceID string,
		profileID string,
		name string,
	) (contract.LoopConfigResponse, error)
	PutLoopConfig(
		ctx context.Context,
		workspaceID string,
		profileID string,
		name string,
		req contract.PutLoopConfigRequest,
	) (contract.LoopConfigResponse, error)
	GetLoopInputDefaults(
		ctx context.Context,
		workspaceID string,
		profileID string,
		name string,
		scope contract.LoopInputDefaultsScope,
	) (contract.LoopInputDefaultsResponse, error)
	GetLoopInputDefault(
		ctx context.Context,
		workspaceID string,
		profileID string,
		name string,
		key string,
		scope contract.LoopInputDefaultsScope,
	) (contract.LoopInputDefaultResponse, error)
	PutLoopInputDefaults(
		ctx context.Context,
		workspaceID string,
		profileID string,
		name string,
		req contract.PutLoopInputDefaultsRequest,
	) (contract.LoopInputDefaultsResponse, error)
	PutLoopInputDefault(
		ctx context.Context,
		workspaceID string,
		profileID string,
		name string,
		key string,
		req contract.PutLoopInputDefaultRequest,
	) (contract.LoopInputDefaultResponse, error)
	DeleteLoopInputDefault(
		ctx context.Context,
		workspaceID string,
		profileID string,
		name string,
		key string,
		scope contract.LoopInputDefaultsScope,
	) (contract.DeleteLoopInputDefaultResponse, error)
	GetLoopAnnotations(
		ctx context.Context,
		workspaceID string,
		profileID string,
		name string,
	) (contract.LoopAnnotationsResponse, error)
	PutLoopAnnotations(
		ctx context.Context,
		workspaceID string,
		profileID 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)
	DiffLoopRun(
		ctx context.Context,
		workspaceID string,
		runID string,
		query looppkg.DiffQuery,
	) (contract.LoopDiffResponse, error)
	RerunLoopRun(
		context.Context,
		string,
		string,
		contract.RerunLoopRequest,
		taskpkg.ActorContext,
	) (contract.RerunLoopResponse, error)
	ForkLoopRun(
		context.Context,
		string,
		string,
		contract.ForkLoopRequest,
		taskpkg.ActorContext,
	) (contract.ForkLoopResponse, 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)
	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)
	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
	ListLoopRequests(context.Context, string, LoopRequestListQuery) (contract.LoopRequestsResponse, error)
	GetLoopRequest(context.Context, string, string, int, string, int) (contract.LoopRequestPayload, error)
	RespondLoopRequest(
		context.Context,
		string,
		string,
		string,
		contract.RespondLoopRequest,
		taskpkg.ActorContext,
	) (contract.RespondLoopRequestResponse, error)
	AmendLoopNode(
		context.Context,
		string,
		string,
		string,
		contract.LoopNodeAmendRequest,
		taskpkg.ActorContext,
	) (contract.LoopNodeAmendResponse, error)
	ListLoopRunEvents(
		ctx context.Context,
		workspaceID string,
		runID string,
		afterSeq int64,
		readScope store.ReadScope,
	) ([]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 MarketplaceCatalogService ¶

MarketplaceCatalogService exposes the daemon-owned curated feed projection.

type MarketplaceListRequest ¶

type MarketplaceListRequest struct {
	Query       string
	Cursor      string
	Limit       int
	Scope       string
	WorkspaceID string
	ProfileName string
	Actor       *taskpkg.ActorContext
}

MarketplaceListRequest carries canonical catalog pagination and installed-state scope.

type MarketplaceSourcesReader ¶

type MarketplaceSourcesReader interface {
	Status(context.Context) ([]marketplace.SourceState, error)
}

MarketplaceSourcesService owns global source registration and persistence.

type ModelCatalogService ¶

type ModelCatalogService interface {
	modelcatalog.Service
}

ModelCatalogService exposes daemon-owned provider model catalog reads and refreshes.

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

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

OpenAPIDocument caches the release contract across transports.

func NewOpenAPIDocument ¶

func NewOpenAPIDocument(render func() ([]byte, error)) *OpenAPIDocument

type ProfileOwnerReader ¶

type ProfileOwnerReader interface {
	ListIdentities(context.Context) ([]profilepkg.Profile, error)
}

ProfileOwnerReader supplies labels without ownership counts or credential details.

type ProfileService ¶

type ProfileService interface {
	// contains filtered or unexported methods
}

ProfileService is the daemon-owned profile boundary exposed by both transports.

type ProfileSkillsRegistry ¶

type ProfileSkillsRegistry interface {
	ForProfile(ctx context.Context, profileName string, profileRoot string) ([]*skills.Skill, error)
}

ProfileSkillsRegistry exposes personal-profile skill projections when supported.

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

func (e *PromptStreamEncoder) SetSessionID(sessionID string)

SetSessionID names the durable session the stream belongs to, so subagent cards derive the same ids the transcript projection does.

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

type ProviderUsageService interface {
	providerusage.Service
	BootID() string
}

ProviderUsageService exposes profile-scoped cached usage and invalidations.

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)
	// ArchiveWithStop stops a live session through the normal stop path before archiving it.
	ArchiveWithStop(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 SessionAttachmentStore ¶

type SessionAttachmentStore interface {
	Put(ctx context.Context, request attachmentspkg.PutRequest) (attachmentspkg.AttachmentRef, error)
	Open(ctx context.Context, workspaceID string, sessionID string, id string) (
		io.ReadCloser,
		attachmentspkg.AttachmentRef,
		error,
	)
	Delete(ctx context.Context, workspaceID string, sessionID string, id string) error
}

SessionAttachmentStore is the attachment persistence surface consumed by API handlers.

type SessionAttentionManager ¶

type SessionAttentionManager interface {
	SessionPresence(ctx context.Context, sessionID string, leaseID string, visible bool) (string, error)
	PendingInteractions(
		ctx context.Context,
		sessionID string,
		statuses []string,
	) ([]store.PendingInteraction, error)
	AttentionSummary(ctx context.Context, readScope store.ReadScope) (store.SessionAttentionSummary, error)
}

SessionAttentionManager owns operator presence and durable interaction discovery.

type SessionAttentionSeenManager ¶

type SessionAttentionSeenManager interface {
	MarkAttentionSeen(ctx context.Context, sessionID string) (*session.Info, error)
}

SessionAttentionSeenManager marks the current Needs you occurrence of a session as seen.

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,
		scope session.CatalogScope,
	) (<-chan session.CatalogEvent, func(), error)
}

SessionCatalogEventSubscriber exposes catalog wakes across workspaces.

type SessionCatalogFacetManager ¶

type SessionCatalogFacetManager interface {
	CatalogFacets(context.Context, session.ListQuery) (store.SessionCatalogFacetResult, error)
}

SessionCatalogFacetManager counts scope metadata without rich history hydration.

type SessionCommandCatalogManager ¶

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

SessionCommandCatalogManager exposes one unified session command projection.

type SessionCompactionManager ¶

type SessionCompactionManager interface {
	RequestCompaction(context.Context, string) (session.CompactionRequestResult, <-chan acp.AgentEvent, error)
}

SessionCompactionManager owns advertised native compaction requests.

type SessionDeriveManager ¶

type SessionDeriveManager interface {
	ContinueSession(ctx context.Context, opts session.ContinueSessionOpts) (session.DeriveResult, error)
	ForkSession(ctx context.Context, opts session.ForkSessionOpts) (session.DeriveResult, error)
	DerivePreview(
		ctx context.Context,
		workspaceID string,
		sourceSessionID string,
		messageID string,
	) (session.DerivePreview, error)
}

SessionDeriveManager continues sessions and previews what a derive would carry.

type SessionDescendantInteractionManager ¶

type SessionDescendantInteractionManager interface {
	DescendantPendingInteractions(context.Context, string, []string) ([]store.PendingInteraction, error)
}

type SessionFileSearcher ¶

type SessionFileSearcher interface {
	Search(ctx context.Context, root string, query string, limit int) (workspacefiles.Result, error)
}

SessionFileSearcher ranks files and folders under one directory root.

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

type SessionLaterManager interface {
	MoveToLater(
		ctx context.Context,
		workspaceID string,
		sessionID string,
		req session.LaterRequest,
	) (*session.Info, error)
	ResumeFromLater(ctx context.Context, workspaceID string, sessionID string, withChildren bool) (*session.Info, error)
}

SessionLaterManager parks sessions in Later and returns them to the normal flow.

type SessionLayoutManager ¶

type SessionLayoutManager interface {
	ListSessionFolders(ctx context.Context, scope store.SessionLayoutScope) ([]store.SessionFolder, error)
	CreateSessionFolder(ctx context.Context, scope store.SessionLayoutScope, name string) (store.SessionFolder, error)
	RenameSessionFolder(
		ctx context.Context,
		scope store.SessionLayoutScope,
		folderID string,
		name string,
	) (store.SessionFolder, error)
	DeleteSessionFolder(ctx context.Context, scope store.SessionLayoutScope, folderID string) error
	ReorderSessionFolders(
		ctx context.Context,
		scope store.SessionLayoutScope,
		folderIDs []string,
	) ([]store.SessionFolder, error)
	MoveSession(ctx context.Context, scope store.SessionLayoutScope, sessionID string, folderID string) error
	ReorderSessions(ctx context.Context, scope store.SessionLayoutScope, folderID string, sessionIDs []string) error
}

SessionLayoutManager owns workspace session folders and manual session order.

type SessionLinkedWorkManager ¶

type SessionLinkedWorkManager interface {
	SessionLinkedWork(context.Context, []*session.Info) (map[string]session.LinkedWorkProjection, error)
	LinkSessionWork(context.Context, string, store.SessionWorkLink, bool) error
	UnlinkSessionWork(context.Context, string, string, string) error
	RefreshSessionWorkLink(context.Context, string, string, string) error
}

type SessionManager ¶

type SessionManager interface {
	ContextEvents(context.Context, string) (session.ContextEvents, error)
	Create(ctx context.Context, opts *session.CreateOpts) (*session.Session, error)
	List() []*session.Info
	ListAll(ctx context.Context) ([]*session.Info, error)
	ListForWorkspace(ctx context.Context, workspaceID string) ([]*session.Info, error)
	Status(ctx context.Context, id string) (*session.Info, error)
	ActivePromptRun(ctx context.Context, id string) (session.PromptRunIdentity, error)
	Events(ctx context.Context, id string, query store.EventQuery) ([]store.SessionEvent, error)
	EventMetadata(ctx context.Context, id string, query store.EventQuery) ([]store.EventMetadata, 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)
	ClearPendingInputs(
		ctx context.Context,
		id string,
		caller session.PromptCaller,
	) (session.ClearPendingInputsResult, 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) (session.PromptCancelResult, error)
	ApprovePermission(ctx context.Context, id string, req acp.ApproveRequest) (session.ApprovalResult, error)
	InputQueueSummary(ctx context.Context, id string) (session.InputQueueSummary, error)
	// WorkingDir returns the directory the session's agent runs in, the root
	// mention resolution and file search share.
	WorkingDir(ctx context.Context, id string) (string, 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 SessionMonitorService ¶

type SessionMonitorService interface {
	List(sessionID string) []monitorpkg.Monitor
	Cancel(sessionID, monitorID string) (monitorpkg.Monitor, error)
	ActiveCounts(sessionIDs []string) map[string]int
}

SessionMonitorService reads and cancels the daemon-owned monitors of one session.

type SessionNavigationReader ¶

type SessionNavigationReader interface {
	TranscriptSearch(context.Context, string, transcript.SearchQuery) (transcript.SearchResult, error)
	TranscriptOutline(context.Context, string) (transcript.OutlineResult, error)
}

SessionNavigationReader is the session-scoped materialized navigation capability.

type SessionOwnerReader ¶

type SessionOwnerReader interface {
	SessionOwner(ctx context.Context, sessionID string) (store.SessionOwner, error)
}

SessionOwnerReader resolves the catalog scope that owns a session without repairing it.

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

type SessionProcessService interface {
	Refresh(context.Context) (sessionprocess.Snapshot, error)
	Summary(string) sessionprocess.Summary
	Acquire() func()
	Terminate(
		context.Context,
		string,
		[]sessionprocess.Identity,
		sessionprocess.Scope,
		func(sessionprocess.Owner) bool,
	) ([]sessionprocess.Result, error)
	AfterStop(string, func(context.Context) error)
}

type SessionProfileMover ¶

type SessionProfileMover interface {
	MoveToProfile(ctx context.Context, opts session.MoveToProfileOpts) (session.MoveToProfileResult, error)
}

SessionProfileMover copies a stopped user session into another profile and archives the original.

type SessionRenameManager ¶

type SessionRenameManager interface {
	Rename(ctx context.Context, workspaceID string, sessionID string, name string) (*session.Info, error)
}

SessionRenameManager owns durable workspace-scoped session display names.

type SessionReparentManager ¶

type SessionReparentManager interface {
	AdoptSession(
		ctx context.Context, workspaceID string, sessionID string, parentSessionID string,
	) (*session.Info, error)
	DetachSession(ctx context.Context, workspaceID string, sessionID string) (*session.Info, error)
}

SessionReparentManager owns adopting and detaching user session provenance parents.

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

type SessionStopManager interface {
	RequestStop(context.Context, string, session.StopCause) error
	AwaitStopped(context.Context, string) (session.StopOutcome, error)
}

SessionStopManager owns shared asynchronous stop requests and their outcomes.

type SessionTreeManager ¶

type SessionTreeManager interface {
	// Descendants lists the session's children recursively.
	Descendants(ctx context.Context, workspaceID string, sessionID string) ([]*session.Info, error)
	// ArchiveWithChildren archives the session and its descendants together.
	ArchiveWithChildren(
		ctx context.Context,
		workspaceID string,
		sessionID string,
		opts session.ArchiveTreeOptions,
	) (*session.Tree, error)
	// DeleteWithChildren deletes the descendants, then the session, returning
	// the ids deleted before any failure.
	DeleteWithChildren(ctx context.Context, workspaceID string, sessionID string) ([]string, error)
}

SessionTreeManager owns the operations that include a session's hierarchy descendants.

type SessionWaitManager ¶

type SessionWaitManager interface {
	WaitForBadge(context.Context, session.WaitRequest) (session.WaitOutcome, error)
}

SessionWaitManager owns bounded, gapless session badge waits.

type SessionWorktreeBindingManager ¶

type SessionWorktreeBindingManager interface {
	ChangeWorktreeBinding(context.Context, string, string, *string) (*session.Info, error)
}

type SessionWorktreeForkAcceptanceManager ¶

type SessionWorktreeForkAcceptanceManager interface {
	CreateWorktreeForkAccepted(context.Context, string, *session.CreateAcceptedOpts) (*session.Info, error)
}

SessionWorktreeForkAcceptanceManager reserves the origin session while a clean worktree-bound child is accepted.

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
	Progress           *SettingsRestartProgress
}

SettingsRestartOperation is the daemon-owned restart record exposed to settings transports.

type SettingsRestartProgress ¶

type SettingsRestartProgress struct {
	Phase     string
	Stage     string
	Completed int64
	Total     int64
	UpdatedAt time.Time
}

SettingsRestartProgress is the replacement daemon's latest data-migration progress.

type SettingsUpdateApply ¶

type SettingsUpdateApply struct {
	Targets     []compozyupdate.Target
	Status      compozyupdate.ApplyStatus
	OperationID string
	Message     string
	Holder      *compozyupdate.Holder
}

SettingsUpdateApply describes an accepted update operation.

type SettingsUpdateCancel ¶

type SettingsUpdateCancel struct {
	Status      compozyupdate.Status
	OperationID string
	Message     string
	Holder      *compozyupdate.Holder
}

SettingsUpdateCancel describes a canceled update operation.

type SettingsUpdateController ¶

type SettingsUpdateController interface {
	GetUpdate(ctx context.Context) (compozyupdate.MultiState, error)
	CheckUpdate(ctx context.Context) (compozyupdate.MultiState, error)
	ApplyUpdate(ctx context.Context, targets []compozyupdate.Target) (SettingsUpdateApply, error)
	CancelUpdate(ctx context.Context) (SettingsUpdateCancel, error)
}

SettingsUpdateController exposes the daemon-owned update status surface to settings transports.

type SkillExposureRootsProvider ¶

type SkillExposureRootsProvider interface {
	ExposureRoots(resolved *workspacepkg.ResolvedWorkspace) []compozyconfig.SkillRootSpec
}

SkillExposureRootsProvider returns the exact active roots for one resolved catalog scope.

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)
	ForAgentDef(
		ctx context.Context,
		resolved *workspacepkg.ResolvedWorkspace,
		agent compozyconfig.AgentDef,
	) ([]*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 SpawnWorktreeTarget ¶

type SpawnWorktreeTarget struct {
	Item        *worktree.Worktree
	WorkspaceID string
	Created     bool
}

SpawnWorktreeTarget is the worktree resolved or created for one spawned child.

func ResolveSpawnWorktree ¶

func ResolveSpawnWorktree(
	ctx context.Context,
	svc WorktreeService,
	workspaceID string,
	profileID string,
	ref string,
	spec *contract.SpawnNewWorktreeRequest,
) (SpawnWorktreeTarget, error)

ResolveSpawnWorktree resolves an existing worktree ref or creates the requested managed worktree in the child workspace. Callers roll a created worktree back with RollbackSpawnWorktree when the spawn fails.

func (SpawnWorktreeTarget) ID ¶

func (t SpawnWorktreeTarget) ID() string

ID returns the bound worktree ID, or empty when the child is not bound to one.

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

type TaskDesignationStore interface {
	PutTaskDesignationRollup(context.Context, store.TaskDesignationRollup) error
	ListTaskDesignationRollups(context.Context, store.TaskDesignationRollupQuery) ([]store.TaskDesignationRollup, error)
}

TaskDesignationStore persists the summaries of designated sibling task runs.

type TaskService ¶

type TaskService interface {
	taskpkg.Manager
	taskpkg.CatalogManager
}

TaskService exposes task-domain state and lifecycle surfaces to the API layer.

type TerminalProvider ¶

type TerminalProvider interface{ terminalpkg.Manager }

TerminalProvider is the daemon-owned terminal domain authority.

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.ApprovalTokenRequest,
	) (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 WindowManagerProvider ¶

type WindowManagerProvider interface {
	WindowManagerFor(profileID string) (WindowManagerService, error)
	// ClaimClient attaches one client id to one profile as a single operation.
	//
	// A browser tab presents one profile at a time, so registering has to move the
	// client rather than add an attachment — and moving it is only truthful if the
	// whole claim is serialized, which is why the transport asks for it as one call
	// instead of retiring and registering in two.
	ClaimClient(
		ctx context.Context,
		profileID string,
		registration windowmanager.ClientRegistration,
	) (windowmanager.ClientView, error)
}

WindowManagerProvider resolves the window manager that owns one profile's desks. Desktops are per-profile working state, so every transport names the profile it is acting as before it can reach any window state (US-026).

type WindowManagerService ¶

type WindowManagerService interface {
	Snapshot(context.Context, windowmanager.WorkspaceID) (windowmanager.Snapshot, error)
	Preview(context.Context, windowmanager.CommandRequest) (windowmanager.Preview, error)
	Execute(context.Context, windowmanager.CommandRequest) (windowmanager.Result, error)
	Clients(context.Context, windowmanager.WorkspaceID) ([]windowmanager.ClientView, error)
	RegisterClient(context.Context, windowmanager.ClientRegistration) (windowmanager.ClientView, error)
	UpdateClientContext(context.Context, windowmanager.ClientContextUpdate) (windowmanager.ClientView, error)
	AuthorizeClient(context.Context, windowmanager.WorkspaceID, windowmanager.ClientID, string) error
	AttachClientCommands(
		context.Context,
		windowmanager.WorkspaceID,
		windowmanager.ClientID,
	) (windowmanager.ClientCommandConnection, error)
	DispatchClientCommand(
		context.Context,
		windowmanager.WorkspaceID,
		windowmanager.ClientID,
		windowmanager.ClientCommand,
	) (windowmanager.ClientCommandResponse, error)
	UnregisterClient(context.Context, windowmanager.WorkspaceID, windowmanager.ClientID) error
	ExportLayout(context.Context, windowmanager.WorkspaceID) (windowmanager.LayoutDocument, error)
	ValidateLayout(
		context.Context,
		windowmanager.WorkspaceID,
		windowmanager.LayoutDocument,
	) (windowmanager.Validation, error)
	ReplaceLayout(context.Context, windowmanager.ReplaceLayoutRequest) (windowmanager.Result, error)
	Subscribe(context.Context, windowmanager.SubscriptionRequest) (windowmanager.Subscription, error)
}

WindowManagerService is the semantic window-manager port consumed by public transports.

type WorkspaceBreadth ¶

type WorkspaceBreadth struct {
	AllWorkspaces bool
	WorkspaceID   string
	WorkspaceIDs  []string
}

WorkspaceBreadth preserves route selectors while expressing aggregate narrowing.

type WorkspaceGetter ¶

type WorkspaceGetter interface {
	Get(ctx context.Context, ref string) (workspacepkg.Workspace, error)
}

WorkspaceGetter resolves registered workspaces by reference.

type WorkspaceLayoutManager ¶

type WorkspaceLayoutManager interface {
	WorkspaceLayout(ctx context.Context, profileID string) (store.WorkspaceLayout, error)
	CreateWorkspaceFolder(ctx context.Context, profileID string, name string) (store.WorkspaceFolder, error)
	RenameWorkspaceFolder(
		ctx context.Context,
		profileID string,
		folderID string,
		name string,
	) (store.WorkspaceFolder, error)
	DeleteWorkspaceFolder(ctx context.Context, profileID string, folderID string) error
	ReorderWorkspaceFolders(ctx context.Context, profileID string, folderIDs []string) error
	MoveWorkspace(ctx context.Context, profileID string, workspaceID string, folderID string) error
	ReorderWorkspaces(ctx context.Context, profileID string, folderID string, workspaceIDs []string) error
}

WorkspaceLayoutManager owns one profile's root workspace folders and manual workspace order.

type WorkspaceService ¶

type WorkspaceService interface {
	SetArchived(ctx context.Context, ref string, archived bool) (workspacepkg.Workspace, error)
	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.

type WorktreeCatalogEventSubscriber ¶

type WorktreeCatalogEventSubscriber interface {
	SubscribeWorktreeCatalogEvents(context.Context) (<-chan worktree.CatalogEvent, func(), error)
}

Source Files ¶

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL