daemon

type AgentMessage struct{ Kind, Text string }

type Handler func(context.Context, Request) Response

type Lock interface{ Close() error }

type Request struct {
	Method, WorkspaceID                                string
	ProjectID, WorkstreamID, MemberID, SessionID, Root string
	// APIBaseURL and DeviceID name the backend a Project being registered
	// lives on, and the device identity this profile uses with it (ADR-074).
	// They travel together, and only workspace registration carries them: a
	// Project joined on a friend's server may be the first thing this profile
	// has ever heard of that server.
	APIBaseURL, DeviceID                                                                string
	Title, IntendedOutcome                                                              string
	ApproachSummary                                                                     string
	Components, Contracts, WaitingOn                                                    []string
	AnticipatedPaths, PlanItemIDs                                                       []string
	IdempotencyKey, Trigger, SinceCursor, CheckpointID, BriefID, Kind, Summary, Outcome string
	Revision, ManifestRevision, ApproximateTokenBudget                                  int64
	Discoveries, ConsideredItemIDs                                                      []string
	Verification                                                                        []VerificationSummary
	AgentVendor, AgentCWD, AgentWorkstreamID, AgentSessionAlias                         string
	AgentEvent, AgentStatus, AgentAction, AgentTool, AgentType, AgentSubagentAlias      string
	AgentPaths                                                                          []string
	// AgentCandidateRoots holds every workspace root a vendor reported, for
	// vendors that report more than one. Only the service knows which of them is
	// registered, so the selection happens there.
	AgentCandidateRoots []string
	// AgentSessionTitle is already-classified title text (ADR-042). It is never
	// raw vendor text: the adapter runs ClassifyCoordinationTitle before this
	// field is populated.
	AgentSessionTitle                         string
	AgentTranscriptPath, AgentVendorSessionID string
	SinceRevision                             int64
	// FocusSeconds bounds how long an agent session stays free of injected
	// coordination. Zero means the service default; the store caps the maximum.
	FocusSeconds int64
}

type Response struct {
	OK    bool   `json:"ok"`
	Error string `json:"error,omitempty"`
	Data  any    `json:"data,omitempty"`
}

type VerificationSummary struct {
	State, CheckKind, Label, Summary, AffectedComponent, Source, ObservedAt string
	ManifestRevision                                                        int64
}