contract

type ACPCapsPayload struct {
	SupportsLoadSession bool                         `json:"supports_load_session"`
	SupportedModes      []string                     `json:"supported_modes,omitempty"`
	SupportedModels     []string                     `json:"supported_models,omitempty"`
	ConfigOptions       []SessionConfigOptionPayload `json:"config_options,omitempty"`
}

type ActivateBundleRequest struct {
	ExtensionName               string `json:"extension_name"`
	BundleName                  string `json:"bundle_name"`
	ProfileName                 string `json:"profile_name"`
	Scope                       string `json:"scope,omitempty"`
	Workspace                   string `json:"workspace,omitempty"`
	BindPrimaryChannelAsDefault bool   `json:"bind_primary_channel_as_default"`
}

type AddTaskDependencyRequest struct {
	DependsOnTaskID string                 `json:"depends_on_task_id"`
	Kind            taskpkg.DependencyKind `json:"kind,omitempty"`
}

type AgentCapabilityPayload struct {
	ID      string `json:"id"`
	Summary string `json:"summary,omitempty"`
	Source  string `json:"source,omitempty"`
}

type AgentCapabilitySectionPayload struct {
	Section      AgentContextSectionMetaPayload `json:"section"`
	Capabilities []AgentCapabilityPayload       `json:"capabilities"`
}

type AgentChannelMessagePayload struct {
	MessageID     string                             `json:"message_id"`
	ChannelID     string                             `json:"channel_id"`
	FromSessionID string                             `json:"from_session_id"`
	ToSessionID   string                             `json:"to_session_id,omitempty"`
	Body          json.RawMessage                    `json:"body"`
	Metadata      CoordinationMessageMetadataPayload `json:"metadata"`
	Timestamp     time.Time                          `json:"timestamp"`
}

type AgentChannelMessageResponse struct {
	Message AgentChannelMessagePayload `json:"message"`
}

type AgentChannelMessagesResponse struct {
	Messages []AgentChannelMessagePayload `json:"messages"`
}

type AgentChannelReplyRequest struct {
	ReplyToMessageID string                             `json:"reply_to_message_id"`
	Body             json.RawMessage                    `json:"body"`
	Metadata         CoordinationMessageMetadataPayload `json:"metadata"`
	IdempotencyKey   string                             `json:"idempotency_key,omitempty"`
}

type AgentChannelSendRequest struct {
	Body           json.RawMessage                    `json:"body"`
	Metadata       CoordinationMessageMetadataPayload `json:"metadata"`
	IdempotencyKey string                             `json:"idempotency_key,omitempty"`
}

type AgentChannelsResponse struct {
	Channels []CoordinationChannelPayload `json:"channels"`
}

type AgentContextPayload struct {
	Self                AgentIdentityPayload                   `json:"self"`
	Workspace           AgentWorkspacePayload                  `json:"workspace"`
	Session             AgentSessionPayload                    `json:"session"`
	Soul                AgentSoulSectionPayload                `json:"soul"`
	Task                AgentTaskContextPayload                `json:"task"`
	CoordinationChannel AgentCoordinationChannelContextPayload `json:"coordination_channel"`
	InboxSummary        AgentInboxSummaryPayload               `json:"inbox_summary"`
	PeerRoster          AgentPeerRosterPayload                 `json:"peer_roster"`
	Capabilities        AgentCapabilitySectionPayload          `json:"capabilities"`
	Limits              AgentLimitsPayload                     `json:"limits"`
	Provenance          AgentContextProvenancePayload          `json:"provenance"`
}

type AgentContextProvenancePayload struct {
	GeneratedAt time.Time `json:"generated_at"`
	Source      string    `json:"source"`
}

type AgentContextResponse struct {
	Context AgentContextPayload `json:"context"`
}

type AgentContextSectionMetaPayload struct {
	Limit     int  `json:"limit"`
	Returned  int  `json:"returned"`
	Truncated bool `json:"truncated"`
}

type AgentCoordinationChannelContextPayload struct {
	Available bool                        `json:"available"`
	Channel   *CoordinationChannelPayload `json:"channel,omitempty"`
}

type AgentCoordinatorConfigResponse struct {
	Coordinator CoordinatorConfigPayload `json:"coordinator"`
}

type AgentCreateScope string

type AgentDiagnosticPayload struct {
	Path      string `json:"path"`
	ErrorKind string `json:"error_kind"`
	Message   string `json:"message"`
}

type AgentEventPayload struct {
	Type       string                  `json:"type"`
	SessionID  string                  `json:"session_id,omitempty"`
	TurnID     string                  `json:"turn_id,omitempty"`
	RequestID  string                  `json:"request_id,omitempty"`
	Timestamp  time.Time               `json:"timestamp"`
	Text       string                  `json:"text,omitempty"`
	Title      string                  `json:"title,omitempty"`
	ToolCallID string                  `json:"tool_call_id,omitempty"`
	StopReason string                  `json:"stop_reason,omitempty"`
	Action     string                  `json:"action,omitempty"`
	Resource   string                  `json:"resource,omitempty"`
	Decision   string                  `json:"decision,omitempty"`
	Error      string                  `json:"error,omitempty"`
	Failure    *SessionFailurePayload  `json:"failure,omitempty"`
	Usage      *TokenUsagePayload      `json:"usage,omitempty"`
	Runtime    *RuntimeActivityPayload `json:"runtime,omitempty"`
	Raw        json.RawMessage         `json:"raw,omitempty"`
}

type AgentIdentityPayload struct {
	SessionID string `json:"session_id"`
	AgentName string `json:"agent_name"`
	Provider  string `json:"provider"`
	Model     string `json:"model,omitempty"`
}

type AgentInboxItemPayload struct {
	MessageID string                             `json:"message_id"`
	ChannelID string                             `json:"channel_id"`
	Kind      CoordinationMessageKind            `json:"kind"`
	Metadata  CoordinationMessageMetadataPayload `json:"metadata"`
	Preview   string                             `json:"preview,omitempty"`
	Timestamp time.Time                          `json:"timestamp"`
}

type AgentInboxSummaryPayload struct {
	Section     AgentContextSectionMetaPayload `json:"section"`
	UnreadCount int                            `json:"unread_count"`
	Items       []AgentInboxItemPayload        `json:"items"`
}

type AgentLimitsPayload struct {
	MaxChildren         int `json:"max_children"`
	MaxSpawnDepth       int `json:"max_spawn_depth"`
	MaxActiveTaskLeases int `json:"max_active_task_leases"`
	ContextSectionLimit int `json:"context_section_limit"`
}

type AgentMCPServerJSON struct {
	Name      string                        `json:"name"`
	Transport string                        `json:"transport,omitempty"`
	Command   string                        `json:"command,omitempty"`
	Args      []string                      `json:"args,omitempty"`
	Env       map[string]string             `json:"env,omitempty"`
	SecretEnv map[string]string             `json:"secret_env,omitempty"`
	URL       string                        `json:"url,omitempty"`
	Auth      *SettingsMCPAuthConfigPayload `json:"auth,omitempty"`
}

type AgentMePayload struct {
	Self             AgentIdentityPayload         `json:"self"`
	Workspace        AgentWorkspacePayload        `json:"workspace"`
	Session          AgentSessionPayload          `json:"session"`
	Capabilities     []AgentCapabilityPayload     `json:"capabilities"`
	Channels         []CoordinationChannelPayload `json:"channels"`
	ActiveTaskLeases []TaskRunLeaseSummaryPayload `json:"active_task_leases"`
	Coordinator      CoordinatorConfigPayload     `json:"coordinator"`
	Limits           AgentLimitsPayload           `json:"limits"`
}

type AgentMeResponse struct {
	Me AgentMePayload `json:"me"`
}

type AgentPayload struct {
	Name         string                   `json:"name"`
	Provider     string                   `json:"provider"`
	Command      string                   `json:"command,omitempty"`
	Model        string                   `json:"model,omitempty"`
	Tools        []string                 `json:"tools,omitempty"`
	Toolsets     []string                 `json:"toolsets,omitempty"`
	DenyTools    []string                 `json:"deny_tools,omitempty"`
	Permissions  string                   `json:"permissions,omitempty"`
	CategoryPath []string                 `json:"category_path,omitempty"`
	MCPServers   []AgentMCPServerJSON     `json:"mcp_servers,omitempty"`
	Prompt       string                   `json:"prompt"`
	Diagnostics  []AgentDiagnosticPayload `json:"diagnostics,omitempty"`
}

type AgentPeerRosterPayload struct {
	Section AgentContextSectionMetaPayload `json:"section"`
	Peers   []AgentPeerSummaryPayload      `json:"peers"`
}

type AgentPeerSummaryPayload struct {
	PeerID       string   `json:"peer_id"`
	SessionID    string   `json:"session_id,omitempty"`
	DisplayName  string   `json:"display_name,omitempty"`
	ChannelID    string   `json:"channel_id,omitempty"`
	Capabilities []string `json:"capabilities"`
}

type AgentProbeHealthPayload struct {
	AgentName  string    `json:"agent_name,omitempty"`
	Provider   string    `json:"provider,omitempty"`
	Command    string    `json:"command,omitempty"`
	Executable string    `json:"executable,omitempty"`
	Status     string    `json:"status"`
	Error      string    `json:"error,omitempty"`
	CheckedAt  time.Time `json:"checked_at"`
	DurationMS int64     `json:"duration_ms"`
}

type AgentResponse struct {
	Agent AgentPayload `json:"agent"`
}

type AgentSessionPayload struct {
	ID        string                 `json:"id"`
	Name      string                 `json:"name,omitempty"`
	Type      session.Type           `json:"type,omitempty"`
	State     session.State          `json:"state"`
	Channel   string                 `json:"channel,omitempty"`
	Lineage   *SessionLineagePayload `json:"lineage,omitempty"`
	CreatedAt time.Time              `json:"created_at"`
	UpdatedAt time.Time              `json:"updated_at"`
}

type AgentSoulConfigProvenancePayload struct {
	Digest                 string `json:"digest"`
	Source                 string `json:"source,omitempty"`
	Enabled                bool   `json:"enabled"`
	MaxBodyBytes           int64  `json:"max_body_bytes"`
	ContextProjectionBytes int64  `json:"context_projection_bytes"`
}

type AgentSoulDeleteByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	ExpectedDigest string `json:"expected_digest"`
}

type AgentSoulDeleteRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	ExpectedDigest string `json:"expected_digest"`
}

type AgentSoulFrontmatterPayload struct {
	Version       string   `json:"version,omitempty"`
	Role          string   `json:"role,omitempty"`
	Tone          []string `json:"tone,omitempty"`
	Principles    []string `json:"principles,omitempty"`
	Constraints   []string `json:"constraints,omitempty"`
	Collaboration []string `json:"collaboration,omitempty"`
	MemoryPolicy  []string `json:"memory_policy,omitempty"`
	Tags          []string `json:"tags,omitempty"`
}

type AgentSoulHistoryRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	AgentName   string `json:"agent_name"`
	Limit       int    `json:"limit,omitempty"`
	Cursor      string `json:"cursor,omitempty"`
}

type AgentSoulHistoryResponse struct {
	Revisions  []AgentSoulRevisionPayload `json:"revisions"`
	NextCursor string                     `json:"next_cursor,omitempty"`
}

type AgentSoulMutationResponse struct {
	Soul     AgentSoulPayload         `json:"soul"`
	Revision AgentSoulRevisionPayload `json:"revision"`
}

type AgentSoulPayload struct {
	AgentName        string                             `json:"agent_name,omitempty"`
	Enabled          bool                               `json:"enabled"`
	Present          bool                               `json:"present"`
	Active           bool                               `json:"active"`
	Valid            bool                               `json:"valid"`
	ValidationStatus AuthoredValidationStatus           `json:"validation_status"`
	SnapshotID       string                             `json:"snapshot_id,omitempty"`
	RevisionID       string                             `json:"revision_id,omitempty"`
	Digest           string                             `json:"digest,omitempty"`
	SourcePath       string                             `json:"source_path,omitempty"`
	Frontmatter      AgentSoulFrontmatterPayload        `json:"frontmatter"`
	Body             string                             `json:"body,omitempty"`
	Truncated        bool                               `json:"truncated,omitempty"`
	Limits           AuthoredContextLimitsPayload       `json:"limits"`
	ConfigProvenance AgentSoulConfigProvenancePayload   `json:"config_provenance"`
	Diagnostics      []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
	CreatedAt        *time.Time                         `json:"created_at,omitempty"`
}

type AgentSoulPutByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	Body           string `json:"body"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

type AgentSoulPutRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	Body           string `json:"body"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

type AgentSoulRevisionAction string

type AgentSoulRevisionPayload struct {
	ID             string                             `json:"id"`
	AgentName      string                             `json:"agent_name"`
	SourcePath     string                             `json:"source_path"`
	Action         AgentSoulRevisionAction            `json:"action"`
	PreviousDigest string                             `json:"previous_digest,omitempty"`
	NewDigest      string                             `json:"new_digest,omitempty"`
	Diagnostics    []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
	Actor          AuthoredContextActorPayload        `json:"actor"`
	Origin         *AuthoredContextActorPayload       `json:"origin,omitempty"`
	CreatedAt      time.Time                          `json:"created_at"`
}

type AgentSoulRollbackByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	RevisionID     string `json:"revision_id"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

type AgentSoulRollbackRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	RevisionID     string `json:"revision_id"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

type AgentSoulSectionPayload struct {
	Enabled          bool                     `json:"enabled"`
	Present          bool                     `json:"present"`
	Active           bool                     `json:"active"`
	Valid            bool                     `json:"valid"`
	ValidationStatus AuthoredValidationStatus `json:"validation_status,omitempty"`
	SnapshotID       string                   `json:"snapshot_id,omitempty"`
	Digest           string                   `json:"digest,omitempty"`
	ConfigDigest     string                   `json:"config_digest,omitempty"`
	SourcePath       string                   `json:"source_path,omitempty"`
	Role             string                   `json:"role,omitempty"`
	Tone             []string                 `json:"tone"`
	Principles       []string                 `json:"principles"`
	Truncated        bool                     `json:"truncated,omitempty"`
	MaxBytes         int64                    `json:"max_bytes,omitempty"`
	MaxBodyBytes     int64                    `json:"max_body_bytes,omitempty"`
}

type AgentSoulValidateByPathRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	Body        string `json:"body,omitempty"`
}

type AgentSoulValidateRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	AgentName   string `json:"agent_name,omitempty"`
	Body        string `json:"body,omitempty"`
}

type AgentSpawnPayload struct {
	Session     SessionPayload               `json:"session"`
	Lineage     SessionLineagePayload        `json:"lineage"`
	Permissions SpawnPermissionPolicyPayload `json:"permissions"`
}

type AgentSpawnRequest struct {
	AgentName        string                       `json:"agent_name"`
	Provider         string                       `json:"provider,omitempty"`
	Model            string                       `json:"model,omitempty"`
	Name             string                       `json:"name,omitempty"`
	PromptOverlay    string                       `json:"prompt_overlay,omitempty"`
	SpawnRole        string                       `json:"spawn_role"`
	TTLSeconds       int64                        `json:"ttl_seconds"`
	AutoStopOnParent bool                         `json:"auto_stop_on_parent"`
	Permissions      SpawnPermissionPolicyPayload `json:"permissions"`
	IdempotencyKey   string                       `json:"idempotency_key,omitempty"`
}

type AgentSpawnResponse struct {
	Spawn AgentSpawnPayload `json:"spawn"`
}

type AgentTaskClaimNextRequest struct {
	WorkspaceID          string   `json:"workspace_id,omitempty"`
	RequiredCapabilities []string `json:"required_capabilities,omitempty"`
	PriorityMin          int      `json:"priority_min,omitempty"`
	LeaseSeconds         int64    `json:"lease_seconds,omitempty"`
	Wait                 bool     `json:"wait,omitempty"`
	IdempotencyKey       string   `json:"idempotency_key,omitempty"`
}

type AgentTaskClaimPayload struct {
	Task                TaskReferencePayload        `json:"task"`
	Run                 TaskRunPayload              `json:"run"`
	Lease               TaskRunLeaseSummaryPayload  `json:"lease"`
	CoordinationChannel *CoordinationChannelPayload `json:"coordination_channel,omitempty"`
}

type AgentTaskClaimResponse struct {
	Claim AgentTaskClaimPayload `json:"claim"`
}

type AgentTaskCompleteRequest struct {
	Result json.RawMessage `json:"result,omitempty"`
}

type AgentTaskContextPayload struct {
	Available bool                        `json:"available"`
	Task      *TaskReferencePayload       `json:"task,omitempty"`
	Lease     *TaskRunLeaseSummaryPayload `json:"lease,omitempty"`
	Bundle    *taskpkg.ContextBundle      `json:"bundle,omitempty"`
}

type AgentTaskFailRequest struct {
	Error    string          `json:"error"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

type AgentTaskHeartbeatRequest struct {
	LeaseSeconds int64 `json:"lease_seconds,omitempty"`
}

type AgentTaskLeaseResponse struct {
	Lease TaskRunLeaseSummaryPayload `json:"lease"`
}

type AgentTaskReleaseRequest struct {
	Reason string `json:"reason,omitempty"`
}

type AgentWorkspacePayload struct {
	ID      string `json:"id,omitempty"`
	Name    string `json:"name,omitempty"`
	RootDir string `json:"root_dir,omitempty"`
}

type AgentsResponse struct {
	Agents []AgentPayload `json:"agents"`
}

type ApproveSessionRequest struct {
	RequestID string `json:"request_id"`
	TurnID    string `json:"turn_id"`
	Decision  string `json:"decision"`
}

type AttachSessionRequest struct {
	AttachedTo string `json:"attached_to,omitempty"`
	TTLSeconds int    `json:"ttl_seconds,omitempty"`
}

type AttachTaskRunSessionRequest struct {
	SessionID string `json:"session_id"`
}

type AuthoredContextActorPayload struct {
	Kind string `json:"kind"`
	Ref  string `json:"ref,omitempty"`
}

type AuthoredContextDiagnosticPayload struct {
	Code         string                     `json:"code"`
	Severity     AuthoredDiagnosticSeverity `json:"severity"`
	Message      string                     `json:"message"`
	Field        string                     `json:"field,omitempty"`
	Section      string                     `json:"section,omitempty"`
	SourcePath   string                     `json:"source_path,omitempty"`
	Line         int                        `json:"line,omitempty"`
	Column       int                        `json:"column,omitempty"`
	OwnerSurface string                     `json:"owner_surface,omitempty"`
}

type AuthoredContextLimitsPayload struct {
	MaxBodyBytes           int64 `json:"max_body_bytes"`
	ContextProjectionBytes int64 `json:"context_projection_bytes,omitempty"`
	MaxBytes               int64 `json:"max_bytes,omitempty"`
}

type AuthoredDiagnosticSeverity string

type AuthoredValidationStatus string

type AutomationHealthPayload struct {
	Enabled          bool                              `json:"enabled"`
	Jobs             AutomationResourceStatusPayload   `json:"jobs"`
	Triggers         AutomationResourceStatusPayload   `json:"triggers"`
	SchedulerRunning bool                              `json:"scheduler_running"`
	NextFire         *time.Time                        `json:"next_fire,omitempty"`
	ScheduledJobs    []AutomationSchedulerStatePayload `json:"scheduled_jobs,omitempty"`
}

type AutomationResourceStatusPayload struct {
	Total   int `json:"total"`
	Enabled int `json:"enabled"`
}

type AutomationSchedulerStatePayload struct {
	JobID                     string                               `json:"job_id"`
	Registered                bool                                 `json:"registered"`
	NextRunAt                 *time.Time                           `json:"next_run_at,omitempty"`
	LastRunAt                 *time.Time                           `json:"last_run_at,omitempty"`
	LastScheduledAt           *time.Time                           `json:"last_scheduled_at,omitempty"`
	LastFireID                string                               `json:"last_fire_id,omitempty"`
	CatchUpPolicy             automationpkg.SchedulerCatchUpPolicy `json:"catch_up_policy,omitempty"`
	MisfireGraceSeconds       int                                  `json:"misfire_grace_seconds,omitempty"`
	ConsecutiveResumeFailures int                                  `json:"consecutive_resume_failures,omitempty"`
	LastMisfireAt             *time.Time                           `json:"last_misfire_at,omitempty"`
	MisfireCount              int                                  `json:"misfire_count,omitempty"`
	UpdatedAt                 *time.Time                           `json:"updated_at,omitempty"`
}

type BridgeAggregateHealthPayload struct {
	TotalInstances        int                       `json:"total_instances"`
	RouteCount            int                       `json:"route_count"`
	DeliveryBacklog       int                       `json:"delivery_backlog"`
	DeliveryDroppedTotal  int                       `json:"delivery_dropped_total"`
	DeliveryFailuresTotal int                       `json:"delivery_failures_total"`
	AuthFailuresTotal     int                       `json:"auth_failures_total"`
	StatusCounts          BridgeStatusCountsPayload `json:"status_counts"`
}

type BridgeDeliveryDefaultsPayload json.RawMessage

type BridgeDeliveryTargetInput struct {
	BridgeInstanceID string                 `json:"bridge_instance_id,omitempty"`
	PeerID           string                 `json:"peer_id,omitempty"`
	ThreadID         string                 `json:"thread_id,omitempty"`
	GroupID          string                 `json:"group_id,omitempty"`
	Mode             bridgepkg.DeliveryMode `json:"mode,omitempty"`
}

type BridgeHealthPayload struct {
	BridgeInstanceID        string                       `json:"bridge_instance_id"`
	Status                  bridgepkg.BridgeStatus       `json:"status"`
	RouteCount              int                          `json:"route_count"`
	DeliveryBacklog         int                          `json:"delivery_backlog"`
	DeliveryDroppedTotal    int                          `json:"delivery_dropped_total"`
	DeliveryDroppedByReason map[string]int               `json:"delivery_dropped_by_reason,omitempty"`
	DeliveryFailuresTotal   int                          `json:"delivery_failures_total"`
	AuthFailuresTotal       int                          `json:"auth_failures_total"`
	LastSuccessAt           *time.Time                   `json:"last_success_at,omitempty"`
	LastError               string                       `json:"last_error,omitempty"`
	LastErrorAt             *time.Time                   `json:"last_error_at,omitempty"`
	Degradation             *bridgepkg.BridgeDegradation `json:"degradation,omitempty"`
	Diagnostics             []bridgepkg.BridgeDiagnostic `json:"diagnostics,omitempty"`
}

type BridgeHealthStreamPayload struct {
	GeneratedAt  time.Time                      `json:"generated_at"`
	BridgeHealth map[string]BridgeHealthPayload `json:"bridge_health"`
}

type BridgePayload struct {
	ID                   string                         `json:"id"`
	Scope                bridgepkg.Scope                `json:"scope"`
	WorkspaceID          string                         `json:"workspace_id,omitempty"`
	Platform             string                         `json:"platform"`
	ExtensionName        string                         `json:"extension_name"`
	DisplayName          string                         `json:"display_name"`
	Source               bridgepkg.BridgeInstanceSource `json:"source,omitempty"`
	Enabled              bool                           `json:"enabled"`
	Status               bridgepkg.BridgeStatus         `json:"status"`
	DMPolicy             bridgepkg.BridgeDMPolicy       `json:"dm_policy,omitempty"`
	RoutingPolicy        bridgepkg.RoutingPolicy        `json:"routing_policy"`
	ProviderConfig       BridgeProviderConfigPayload    `json:"provider_config,omitempty"`
	DeliveryDefaults     BridgeDeliveryDefaultsPayload  `json:"delivery_defaults,omitempty"`
	NotificationSuppress bool                           `json:"notification_suppress"`
	Degradation          *bridgepkg.BridgeDegradation   `json:"degradation,omitempty"`
	CreatedAt            time.Time                      `json:"created_at"`
	UpdatedAt            time.Time                      `json:"updated_at"`
}

type BridgeProviderConfigPayload json.RawMessage

type BridgeProviderPayload struct {
	Platform      string                                `json:"platform"`
	ExtensionName string                                `json:"extension_name"`
	DisplayName   string                                `json:"display_name"`
	Description   string                                `json:"description,omitempty"`
	SecretSlots   []bridgepkg.BridgeSecretSlot          `json:"secret_slots,omitempty"`
	ConfigSchema  *bridgepkg.BridgeProviderConfigSchema `json:"config_schema,omitempty"`
	Enabled       bool                                  `json:"enabled"`
	State         string                                `json:"state"`
	Health        string                                `json:"health"`
	HealthMessage string                                `json:"health_message,omitempty"`
}

type BridgeProvidersResponse struct {
	Providers []BridgeProviderPayload `json:"providers"`
}

type BridgeResolveTargetRequest struct {
	Name string `json:"name"`
}

type BridgeResolveTargetResponse struct {
	Result     bridgepkg.ResolveBridgeTargetResult `json:"result"`
	Diagnostic *DiagnosticItem                     `json:"diagnostic,omitempty"`
}

type BridgeResponse struct {
	Bridge BridgePayload       `json:"bridge"`
	Health BridgeHealthPayload `json:"health"`
}

type BridgeRoutesResponse struct {
	Routes []bridgepkg.BridgeRoute `json:"routes"`
}

type BridgeSecretBindingResponse struct {
	Binding bridgepkg.BridgeSecretBinding `json:"binding"`
}

type BridgeSecretBindingsResponse struct {
	Bindings []bridgepkg.BridgeSecretBinding `json:"bindings"`
}

type BridgeStatusCountsPayload struct {
	Disabled     int `json:"disabled"`
	Starting     int `json:"starting"`
	Ready        int `json:"ready"`
	Degraded     int `json:"degraded"`
	AuthRequired int `json:"auth_required"`
	Error        int `json:"error"`
}

type BridgeTargetsResponse struct {
	BridgeID                string                   `json:"bridge_id"`
	Targets                 []bridgepkg.BridgeTarget `json:"targets"`
	Total                   int                      `json:"total"`
	CacheStale              bool                     `json:"cache_stale"`
	GeneratedAt             time.Time                `json:"generated_at"`
	LastSuccessfulRefreshAt *time.Time               `json:"last_successful_refresh_at,omitempty"`
}

type BridgeTestDeliveryRequest struct {
	Message string                    `json:"message,omitempty"`
	Target  BridgeDeliveryTargetInput `json:"target"`
}

type BridgeTestDeliveryResponse struct {
	Status         string                   `json:"status"`
	Message        string                   `json:"message,omitempty"`
	DeliveryTarget bridgepkg.DeliveryTarget `json:"delivery_target"`
}

type BridgesResponse struct {
	Bridges      []BridgePayload                `json:"bridges"`
	BridgeHealth map[string]BridgeHealthPayload `json:"bridge_health,omitempty"`
}

type BulkForceTaskRunItemPayload struct {
	RunID string          `json:"run_id"`
	OK    bool            `json:"ok"`
	Run   *TaskRunPayload `json:"run,omitempty"`
	Error *ErrorPayload   `json:"error,omitempty"`
}

type BulkForceTaskRunRequest struct {
	RunIDs   []string        `json:"run_ids"`
	Reason   string          `json:"reason,omitempty"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

type BulkForceTaskRunResponse struct {
	Results []BulkForceTaskRunItemPayload `json:"results"`
}

type BundleActivationPayload struct {
	ID                          string                   `json:"id"`
	ExtensionName               string                   `json:"extension_name"`
	BundleName                  string                   `json:"bundle_name"`
	BundleDescription           string                   `json:"bundle_description,omitempty"`
	ProfileName                 string                   `json:"profile_name"`
	ProfileDescription          string                   `json:"profile_description,omitempty"`
	Scope                       string                   `json:"scope"`
	WorkspaceID                 string                   `json:"workspace_id,omitempty"`
	BindPrimaryChannelAsDefault bool                     `json:"bind_primary_channel_as_default"`
	Channels                    []BundleChannelPayload   `json:"channels,omitempty"`
	Agents                      []BundleAgentPayload     `json:"agents,omitempty"`
	Jobs                        []BundleJobPayload       `json:"jobs,omitempty"`
	Triggers                    []BundleTriggerPayload   `json:"triggers,omitempty"`
	Bridges                     []BundleBridgePayload    `json:"bridges,omitempty"`
	Inventory                   []BundleInventoryPayload `json:"inventory,omitempty"`
	CreatedAt                   time.Time                `json:"created_at"`
	UpdatedAt                   time.Time                `json:"updated_at"`
}

type BundleActivationResponse struct {
	Activation BundleActivationPayload `json:"activation"`
}

type BundleActivationsResponse struct {
	Activations []BundleActivationPayload `json:"activations"`
}

type BundleAgentPayload struct {
	ID           string   `json:"id"`
	Name         string   `json:"name"`
	Provider     string   `json:"provider,omitempty"`
	Model        string   `json:"model,omitempty"`
	CategoryPath []string `json:"category_path,omitempty"`
	HasSoul      bool     `json:"has_soul,omitempty"`
	HasHeartbeat bool     `json:"has_heartbeat,omitempty"`
}

type BundleBridgePayload struct {
	ID            string                          `json:"id"`
	Name          string                          `json:"name"`
	ExtensionName string                          `json:"extension_name"`
	Platform      string                          `json:"platform"`
	DisplayName   string                          `json:"display_name"`
	SecretSlots   []BundleBridgeSecretSlotPayload `json:"secret_slots,omitempty"`
}

type BundleBridgeSecretSlotPayload struct {
	Name        string `json:"name"`
	Kind        string `json:"kind"`
	Description string `json:"description,omitempty"`
}

type BundleCatalogPayload struct {
	ExtensionName string                        `json:"extension_name"`
	BundleName    string                        `json:"bundle_name"`
	Description   string                        `json:"description,omitempty"`
	Profiles      []BundleProfileCatalogPayload `json:"profiles,omitempty"`
}

type BundleChannelPayload struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Primary     bool   `json:"primary,omitempty"`
}

type BundleInventoryPayload struct {
	ResourceKind string `json:"resource_kind"`
	ResourceID   string `json:"resource_id"`
	ResourceName string `json:"resource_name"`
}

type BundleJobPayload struct {
	ID        string `json:"id"`
	Name      string `json:"name"`
	AgentName string `json:"agent_name"`
	Enabled   bool   `json:"enabled"`
}

type BundleNetworkSettingsPayload struct {
	ConfiguredDefaultChannel string                          `json:"configured_default_channel,omitempty"`
	EffectiveDefaultChannel  string                          `json:"effective_default_channel,omitempty"`
	EffectiveDefaultSource   string                          `json:"effective_default_source,omitempty"`
	DeclaredChannels         []DeclaredNetworkChannelPayload `json:"declared_channels,omitempty"`
}

type BundleNetworkSettingsResponse struct {
	Network BundleNetworkSettingsPayload `json:"network"`
}

type BundlePreviewResponse struct {
	Activation BundleActivationPayload `json:"activation"`
}

type BundleProfileCatalogPayload struct {
	Name           string                 `json:"name"`
	Description    string                 `json:"description,omitempty"`
	PrimaryChannel string                 `json:"primary_channel,omitempty"`
	Channels       []BundleChannelPayload `json:"channels,omitempty"`
	AgentCount     int                    `json:"agent_count,omitempty"`
	JobCount       int                    `json:"job_count,omitempty"`
	TriggerCount   int                    `json:"trigger_count,omitempty"`
	BridgeCount    int                    `json:"bridge_count,omitempty"`
}

type BundleTriggerPayload struct {
	ID        string `json:"id"`
	Name      string `json:"name"`
	AgentName string `json:"agent_name"`
	Event     string `json:"event"`
	Enabled   bool   `json:"enabled"`
}

type BundlesCatalogResponse struct {
	Bundles []BundleCatalogPayload `json:"bundles"`
}

type CancelTaskRequest struct {
	Reason   string          `json:"reason,omitempty"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

type CancelTaskRunRequest struct {
	Reason   string          `json:"reason,omitempty"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

type ClaimTaskRunRequest struct {
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

type CompleteTaskRunRequest struct {
	Result json.RawMessage `json:"result,omitempty"`
}

type ConfigApplyRecordPayload struct {
	ID                string                  `json:"id"`
	DesiredConfigHash string                  `json:"desired_config_hash"`
	ActiveConfigHash  string                  `json:"active_config_hash"`
	Generation        int64                   `json:"generation"`
	Actor             string                  `json:"actor"`
	DiffClass         SettingsApplyLifecycle  `json:"diff_class"`
	Status            ConfigApplyStatus       `json:"status"`
	Lifecycle         SettingsApplyLifecycle  `json:"lifecycle"`
	NextAction        SettingsApplyNextAction `json:"next_action"`
	Diagnostics       []DiagnosticItem        `json:"diagnostics,omitempty"`
	CreatedAt         time.Time               `json:"created_at"`
	AppliedAt         *time.Time              `json:"applied_at,omitempty"`
	UpdatedAt         time.Time               `json:"updated_at"`
}

type ConfigApplyRecordsResponse struct {
	Entries []ConfigApplyRecordPayload `json:"entries"`
}

type ConfigApplyStatus string

type ConfigRuntimeStatusPayload struct {
	Status          string `json:"status"`
	Validated       bool   `json:"validated"`
	ValidationError string `json:"validation_error,omitempty"`
	HomeDir         string `json:"home_dir,omitempty"`
	ConfigFile      string `json:"config_file,omitempty"`
	RestartRequired bool   `json:"restart_required"`
	ApplyState      string `json:"apply_state"`
}

type CoordinationChannelPayload struct {
	ID                  string                    `json:"id"`
	Channel             string                    `json:"channel,omitempty"`
	DisplayName         string                    `json:"display_name"`
	Purpose             string                    `json:"purpose,omitempty"`
	WorkspaceID         string                    `json:"workspace_id,omitempty"`
	TaskID              string                    `json:"task_id,omitempty"`
	RunID               string                    `json:"run_id,omitempty"`
	WorkflowID          string                    `json:"workflow_id,omitempty"`
	AllowedMessageKinds []CoordinationMessageKind `json:"allowed_message_kinds"`
	LastActivityAt      *time.Time                `json:"last_activity_at,omitempty"`
}

type CoordinationMessageKind string

type CoordinationMessageMetadataPayload struct {
	TaskID                string                     `json:"task_id"`
	RunID                 string                     `json:"run_id"`
	WorkflowID            string                     `json:"workflow_id,omitempty"`
	CoordinationChannelID string                     `json:"coordination_channel_id"`
	MessageKind           CoordinationMessageKind    `json:"message_kind"`
	CorrelationID         string                     `json:"correlation_id"`
	Ext                   map[string]json.RawMessage `json:"ext,omitempty"`
}

type CoordinatorConfigPayload struct {
	Enabled               bool                    `json:"enabled"`
	AgentName             string                  `json:"agent_name"`
	Provider              string                  `json:"provider,omitempty"`
	Model                 string                  `json:"model,omitempty"`
	DefaultTTLSeconds     int64                   `json:"default_ttl_seconds"`
	MaxChildren           int                     `json:"max_children"`
	MaxActivePerWorkspace int                     `json:"max_active_per_workspace"`
	Source                CoordinatorConfigSource `json:"source"`
	WorkspaceID           string                  `json:"workspace_id,omitempty"`
}

type CoordinatorConfigSource string

type CreateAgentPayload struct {
	Name         string                   `json:"name"`
	Provider     string                   `json:"provider"`
	Command      string                   `json:"command,omitempty"`
	Model        string                   `json:"model,omitempty"`
	Tools        []string                 `json:"tools,omitempty"`
	Toolsets     []string                 `json:"toolsets,omitempty"`
	DenyTools    []string                 `json:"deny_tools,omitempty"`
	Permissions  SettingsPermissionMode   `json:"permissions,omitempty"`
	CategoryPath []string                 `json:"category_path,omitempty"`
	Skills       *CreateAgentSkillsConfig `json:"skills,omitempty"`
	Prompt       string                   `json:"prompt"`
}

type CreateAgentRequest struct {
	Scope     AgentCreateScope   `json:"scope"`
	Workspace string             `json:"workspace,omitempty"`
	Agent     CreateAgentPayload `json:"agent"`
}

type CreateAgentSkillsConfig struct {
	Disabled []string `json:"disabled,omitempty"`
}

type CreateBridgeRequest struct {
	Scope                bridgepkg.Scope               `json:"scope"`
	WorkspaceID          string                        `json:"workspace_id,omitempty"`
	Platform             string                        `json:"platform"`
	ExtensionName        string                        `json:"extension_name"`
	DisplayName          string                        `json:"display_name"`
	Enabled              bool                          `json:"enabled"`
	DMPolicy             bridgepkg.BridgeDMPolicy      `json:"dm_policy,omitempty"`
	RoutingPolicy        bridgepkg.RoutingPolicy       `json:"routing_policy"`
	ProviderConfig       BridgeProviderConfigPayload   `json:"provider_config,omitempty"`
	DeliveryDefaults     BridgeDeliveryDefaultsPayload `json:"delivery_defaults,omitempty"`
	NotificationSuppress bool                          `json:"notification_suppress,omitempty"`
}

type CreateJobRequest struct {
	Scope       automationpkg.Scope            `json:"scope"`
	Name        string                         `json:"name"`
	AgentName   string                         `json:"agent_name"`
	WorkspaceID string                         `json:"workspace_id,omitempty"`
	Prompt      string                         `json:"prompt"`
	Schedule    automationpkg.ScheduleSpec     `json:"schedule"`
	Task        *automationpkg.JobTaskConfig   `json:"task,omitempty"`
	Enabled     *bool                          `json:"enabled,omitempty"`
	Retry       *automationpkg.RetryConfig     `json:"retry,omitempty"`
	FireLimit   *automationpkg.FireLimitConfig `json:"fire_limit,omitempty"`
}

type CreateNetworkChannelRequest struct {
	Channel     string   `json:"channel"`
	WorkspaceID string   `json:"workspace_id"`
	Purpose     string   `json:"purpose"`
	AgentNames  []string `json:"agent_names"`
}

type CreateNetworkChannelResponse struct {
	Channel NetworkChannelDetailPayload `json:"channel"`
}

type CreateNotificationPresetRequest struct {
	Name    string                      `json:"name"`
	Events  []string                    `json:"events"`
	Targets []NotificationTargetPayload `json:"targets"`
	Filter  string                      `json:"filter,omitempty"`
	Enabled bool                        `json:"enabled"`
}

type CreateSessionRequest struct {
	AgentName       string `json:"agent_name,omitempty"`
	Provider        string `json:"provider,omitempty"`
	Model           string `json:"model,omitempty"`
	ReasoningEffort string `json:"reasoning_effort,omitempty"`
	Name            string `json:"name,omitempty"`
	Workspace       string `json:"workspace,omitempty"`
	WorkspacePath   string `json:"workspace_path,omitempty"`
	Channel         string `json:"channel,omitempty"`
}

type CreateSupportBundleRequest struct {
	Yes           bool  `json:"yes"`
	IncludeStatus *bool `json:"include_status,omitempty"`
}

type CreateTaskBridgeNotificationSubscriptionRequest struct {
	SubscriptionID   string                 `json:"subscription_id,omitempty"`
	BridgeInstanceID string                 `json:"bridge_instance_id"`
	Scope            bridgepkg.Scope        `json:"scope"`
	WorkspaceID      string                 `json:"workspace_id,omitempty"`
	PeerID           string                 `json:"peer_id,omitempty"`
	ThreadID         string                 `json:"thread_id,omitempty"`
	GroupID          string                 `json:"group_id,omitempty"`
	DeliveryMode     bridgepkg.DeliveryMode `json:"delivery_mode"`
}

type CreateTaskChildRequest struct {
	ID             string                 `json:"id,omitempty"`
	Identifier     string                 `json:"identifier,omitempty"`
	Scope          taskpkg.Scope          `json:"scope"`
	Workspace      string                 `json:"workspace,omitempty"`
	NetworkChannel string                 `json:"network_channel,omitempty"`
	Title          string                 `json:"title"`
	Description    string                 `json:"description,omitempty"`
	Priority       taskpkg.Priority       `json:"priority,omitempty"`
	MaxAttempts    *int                   `json:"max_attempts,omitempty"`
	Draft          bool                   `json:"draft,omitempty"`
	ApprovalPolicy taskpkg.ApprovalPolicy `json:"approval_policy,omitempty"`
	Owner          *taskpkg.Ownership     `json:"owner,omitempty"`
	Metadata       json.RawMessage        `json:"metadata,omitempty"`
}

type CreateTaskRequest struct {
	ID             string                 `json:"id,omitempty"`
	Identifier     string                 `json:"identifier,omitempty"`
	Scope          taskpkg.Scope          `json:"scope"`
	Workspace      string                 `json:"workspace,omitempty"`
	NetworkChannel string                 `json:"network_channel,omitempty"`
	Title          string                 `json:"title"`
	Description    string                 `json:"description,omitempty"`
	Priority       taskpkg.Priority       `json:"priority,omitempty"`
	MaxAttempts    *int                   `json:"max_attempts,omitempty"`
	Draft          bool                   `json:"draft,omitempty"`
	ApprovalPolicy taskpkg.ApprovalPolicy `json:"approval_policy,omitempty"`
	Owner          *taskpkg.Ownership     `json:"owner,omitempty"`
	Metadata       json.RawMessage        `json:"metadata,omitempty"`
}

type CreateTaskRunReviewRequest = taskpkg.RunReviewRequest

type CreateTriggerRequest struct {
	Scope              automationpkg.Scope            `json:"scope"`
	Name               string                         `json:"name"`
	AgentName          string                         `json:"agent_name"`
	WorkspaceID        string                         `json:"workspace_id,omitempty"`
	Prompt             string                         `json:"prompt"`
	Event              string                         `json:"event"`
	Filter             map[string]string              `json:"filter,omitempty"`
	Enabled            *bool                          `json:"enabled,omitempty"`
	Retry              *automationpkg.RetryConfig     `json:"retry,omitempty"`
	FireLimit          *automationpkg.FireLimitConfig `json:"fire_limit,omitempty"`
	WebhookID          string                         `json:"webhook_id,omitempty"`
	EndpointSlug       string                         `json:"endpoint_slug,omitempty"`
	WebhookSecretValue string                         `json:"webhook_secret_value,omitempty"`
}

type CreateWorkspaceRequest struct {
	RootDir      string   `json:"root_dir"`
	Name         string   `json:"name,omitempty"`
	AddDirs      []string `json:"add_dirs,omitempty"`
	DefaultAgent string   `json:"default_agent,omitempty"`
	SandboxRef   string   `json:"sandbox_ref,omitempty"`
}

type DaemonStatusPayload struct {
	Status         string                `json:"status"`
	PID            int                   `json:"pid"`
	StartedAt      time.Time             `json:"started_at"`
	Socket         string                `json:"socket"`
	HTTPHost       string                `json:"http_host"`
	HTTPPort       int                   `json:"http_port"`
	UserHomeDir    string                `json:"user_home_dir"`
	ActiveSessions int                   `json:"active_sessions"`
	TotalSessions  int                   `json:"total_sessions"`
	Version        string                `json:"version,omitempty"`
	Network        *NetworkStatusPayload `json:"network,omitempty"`
}

type DeclaredNetworkChannelPayload struct {
	ActivationID  string `json:"activation_id,omitempty"`
	ExtensionName string `json:"extension_name,omitempty"`
	BundleName    string `json:"bundle_name,omitempty"`
	ProfileName   string `json:"profile_name,omitempty"`
	WorkspaceID   string `json:"workspace_id,omitempty"`
	Name          string `json:"name"`
	Description   string `json:"description,omitempty"`
	Primary       bool   `json:"primary,omitempty"`
}

type DeleteResourceRequest struct {
	ExpectedVersion int64 `json:"expected_version"`
}

type DiagnosticCodeSpec = diagnosticcontract.DiagnosticCodeSpec

type DiagnosticItem = diagnosticcontract.DiagnosticItem

type DoctorPayload struct {
	SchemaVersion string               `json:"schema_version"`
	GeneratedAt   time.Time            `json:"generated_at"`
	DurationMS    int64                `json:"duration_ms"`
	Status        string               `json:"status"`
	Summary       DoctorSummaryPayload `json:"summary"`
	Items         []DiagnosticItem     `json:"items"`
}

type DoctorSummaryPayload struct {
	Total            int            `json:"total"`
	CountsBySeverity map[string]int `json:"counts_by_severity"`
}

type EnqueueTaskRunRequest struct {
	IdempotencyKey string          `json:"idempotency_key,omitempty"`
	NetworkChannel string          `json:"network_channel,omitempty"`
	Metadata       json.RawMessage `json:"metadata,omitempty"`
}

type ErrorPayload struct {
	Error      string          `json:"error"`
	Diagnostic *DiagnosticItem `json:"diagnostic,omitempty"`
}

type ExtensionBundleSummaryPayload struct {
	Name        string   `json:"name"`
	Description string   `json:"description,omitempty"`
	Profiles    []string `json:"profiles,omitempty"`
}

type ExtensionMarketplaceEntry struct {
	Slug        string                       `json:"slug"`
	Name        string                       `json:"name"`
	Description string                       `json:"description,omitempty"`
	Author      string                       `json:"author,omitempty"`
	Version     string                       `json:"version,omitempty"`
	Downloads   int                          `json:"downloads,omitempty"`
	Source      string                       `json:"source"`
	Type        string                       `json:"type"`
	Trust       *ExtensionTrustReportPayload `json:"trust,omitempty"`
}

type ExtensionMarketplaceResponse struct {
	Extensions []ExtensionMarketplaceEntry `json:"extensions"`
}

type ExtensionPayload struct {
	Name          string                          `json:"name"`
	Version       string                          `json:"version"`
	Type          string                          `json:"type"`
	Source        string                          `json:"source"`
	Enabled       bool                            `json:"enabled"`
	State         string                          `json:"state"`
	Capabilities  []string                        `json:"capabilities,omitempty"`
	Actions       []string                        `json:"actions,omitempty"`
	RequiresEnv   []string                        `json:"requires_env,omitempty"`
	MissingEnv    []string                        `json:"missing_env,omitempty"`
	PID           int                             `json:"pid,omitempty"`
	UptimeSeconds int64                           `json:"uptime_seconds,omitempty"`
	Health        string                          `json:"health,omitempty"`
	HealthMessage string                          `json:"health_message,omitempty"`
	LastError     string                          `json:"last_error,omitempty"`
	DaemonRunning bool                            `json:"daemon_running"`
	Bundles       []ExtensionBundleSummaryPayload `json:"bundles,omitempty"`
	Provenance    *ExtensionProvenancePayload     `json:"provenance,omitempty"`
	Trust         *ExtensionTrustReportPayload    `json:"trust,omitempty"`
	Diagnostics   []DiagnosticItem                `json:"diagnostics,omitempty"`
}

type ExtensionProvenancePayload struct {
	Slug             string                       `json:"slug,omitempty"`
	InstalledFrom    string                       `json:"installed_from"`
	SourceURL        string                       `json:"source_url,omitempty"`
	ChecksumSHA256   string                       `json:"checksum_sha256"`
	ChecksumVerified bool                         `json:"checksum_verified"`
	RegistryTier     string                       `json:"registry_tier"`
	Permissions      []string                     `json:"permissions,omitempty"`
	InstalledAt      time.Time                    `json:"installed_at"`
	InstalledBy      string                       `json:"installed_by"`
	AllowUnverified  bool                         `json:"allow_unverified"`
	Warnings         []DiagnosticItem             `json:"warnings,omitempty"`
	Trust            *ExtensionTrustReportPayload `json:"trust,omitempty"`
}

type ExtensionProvenanceResponse struct {
	Provenance ExtensionProvenancePayload `json:"provenance"`
}

type ExtensionRemoveResponse struct {
	Extension ManagedExtensionRemovePayload `json:"extension"`
}

type ExtensionResponse struct {
	Extension ExtensionPayload `json:"extension"`
}

type ExtensionTrustReportPayload struct {
	Decision         string           `json:"decision"`
	RegistryTier     string           `json:"registry_tier"`
	ChecksumVerified bool             `json:"checksum_verified"`
	AllowUnverified  bool             `json:"allow_unverified"`
	Warnings         []DiagnosticItem `json:"warnings,omitempty"`
}

type ExtensionUpdateResponse struct {
	Update ManagedExtensionUpdatePayload `json:"update"`
}

type ExtensionsResponse struct {
	Extensions []ExtensionPayload `json:"extensions"`
}

type FSBrowseResponse struct {
	Path    string           `json:"path"`
	Parent  string           `json:"parent,omitempty"`
	Home    string           `json:"home,omitempty"`
	Entries []FSEntryPayload `json:"entries"`
}

type FSEntryPayload struct {
	Name  string `json:"name"`
	Path  string `json:"path"`
	IsDir bool   `json:"is_dir"`
}

type FailTaskRunRequest struct {
	Error    string          `json:"error"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

type ForceFailTaskRunRequest struct {
	Reason   string          `json:"reason"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

type ForceReleaseTaskRunRequest struct {
	Reason   string          `json:"reason,omitempty"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
}

type HeartbeatActorKind string

type HeartbeatActorPayload struct {
	Kind HeartbeatActorKind `json:"kind"`
	Ref  string             `json:"ref,omitempty"`
}

type HeartbeatConfigProvenancePayload struct {
	Digest string                       `json:"digest"`
	Subset HeartbeatConfigSubsetPayload `json:"subset"`
}

type HeartbeatConfigSubsetPayload struct {
	Enabled                      bool   `json:"enabled"`
	MaxBodyBytes                 int64  `json:"max_body_bytes"`
	ContextProjectionBytes       int64  `json:"context_projection_bytes"`
	MinInterval                  string `json:"min_interval"`
	DefaultInterval              string `json:"default_interval"`
	WakeCooldown                 string `json:"wake_cooldown"`
	MaxWakesPerCycle             int    `json:"max_wakes_per_cycle"`
	ActiveSessionOnly            bool   `json:"active_session_only"`
	AllowActiveHoursPreferences  bool   `json:"allow_active_hours_preferences"`
	WakeEventRetention           string `json:"wake_event_retention"`
	SessionHealthStaleAfter      string `json:"session_health_stale_after"`
	SessionHealthHookMinInterval string `json:"session_health_hook_min_interval"`
}

type HeartbeatContextProjectionPayload struct {
	Include []string `json:"include,omitempty"`
}

type HeartbeatDeleteByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	ExpectedDigest string `json:"expected_digest"`
}

type HeartbeatDeleteRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	ExpectedDigest string `json:"expected_digest"`
}

type HeartbeatFrontmatterPayload struct {
	Version     int                                    `json:"version"`
	Enabled     bool                                   `json:"enabled"`
	Summary     string                                 `json:"summary,omitempty"`
	Preferences HeartbeatFrontmatterPreferencesPayload `json:"preferences"`
	Context     HeartbeatContextProjectionPayload      `json:"context"`
}

type HeartbeatFrontmatterPreferencesPayload struct {
	MinInterval  string                       `json:"min_interval,omitempty"`
	ActiveHours  []HeartbeatTimeWindowPayload `json:"active_hours,omitempty"`
	QuietWindows []HeartbeatTimeWindowPayload `json:"quiet_windows,omitempty"`
}

type HeartbeatHistoryRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	AgentName   string `json:"agent_name"`
	Limit       int    `json:"limit,omitempty"`
	Cursor      string `json:"cursor,omitempty"`
}

type HeartbeatHistoryResponse struct {
	Revisions  []HeartbeatRevisionPayload `json:"revisions"`
	NextCursor string                     `json:"next_cursor,omitempty"`
}

type HeartbeatMutationResponse struct {
	Heartbeat HeartbeatPolicyPayload   `json:"heartbeat"`
	Revision  HeartbeatRevisionPayload `json:"revision"`
}

type HeartbeatPolicyPayload struct {
	AgentName        string                             `json:"agent_name,omitempty"`
	Enabled          bool                               `json:"enabled"`
	Present          bool                               `json:"present"`
	Active           bool                               `json:"active"`
	Valid            bool                               `json:"valid"`
	ValidationStatus AuthoredValidationStatus           `json:"validation_status"`
	SourcePath       string                             `json:"source_path,omitempty"`
	Digest           string                             `json:"digest,omitempty"`
	ConfigDigest     string                             `json:"config_digest,omitempty"`
	SnapshotID       string                             `json:"snapshot_id,omitempty"`
	SchemaVersion    int                                `json:"schema_version"`
	Summary          string                             `json:"summary,omitempty"`
	GuidanceMarkdown string                             `json:"guidance_markdown,omitempty"`
	Frontmatter      HeartbeatFrontmatterPayload        `json:"frontmatter"`
	Preferences      HeartbeatPreferencesPayload        `json:"preferences"`
	ConfigProvenance HeartbeatConfigProvenancePayload   `json:"config_provenance"`
	Prompt           HeartbeatPromptContributionPayload `json:"prompt"`
	Diagnostics      []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
	Limits           AuthoredContextLimitsPayload       `json:"limits"`
	CreatedAt        *time.Time                         `json:"created_at,omitempty"`
}

type HeartbeatPreferencesPayload struct {
	MinInterval  string                            `json:"min_interval"`
	ActiveHours  []HeartbeatTimeWindowPayload      `json:"active_hours,omitempty"`
	QuietWindows []HeartbeatTimeWindowPayload      `json:"quiet_windows,omitempty"`
	Context      HeartbeatContextProjectionPayload `json:"context"`
}

type HeartbeatPromptContributionPayload struct {
	Active           bool                               `json:"active"`
	Digest           string                             `json:"digest,omitempty"`
	ConfigDigest     string                             `json:"config_digest,omitempty"`
	SourcePath       string                             `json:"source_path,omitempty"`
	Summary          string                             `json:"summary,omitempty"`
	GuidanceMarkdown string                             `json:"guidance_markdown,omitempty"`
	Preferences      HeartbeatPreferencesPayload        `json:"preferences"`
	Truncated        bool                               `json:"truncated"`
	MaxBytes         int64                              `json:"max_bytes"`
	MaxBodyBytes     int64                              `json:"max_body_bytes"`
	Diagnostics      []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
	Context          HeartbeatContextProjectionPayload  `json:"context"`
}

type HeartbeatPutByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	Body           string `json:"body"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

type HeartbeatPutRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	Body           string `json:"body"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

type HeartbeatRevisionOperation string

type HeartbeatRevisionPayload struct {
	ID             string                     `json:"id"`
	AgentName      string                     `json:"agent_name"`
	SourcePath     string                     `json:"source_path"`
	Operation      HeartbeatRevisionOperation `json:"operation"`
	PreviousDigest string                     `json:"previous_digest,omitempty"`
	NewDigest      string                     `json:"new_digest,omitempty"`
	NewSnapshotID  string                     `json:"new_snapshot_id,omitempty"`
	Actor          HeartbeatActorPayload      `json:"actor"`
	CreatedAt      time.Time                  `json:"created_at"`
}

type HeartbeatRollbackByPathRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	RevisionID     string `json:"revision_id,omitempty"`
	TargetDigest   string `json:"target_digest,omitempty"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

type HeartbeatRollbackRequest struct {
	WorkspaceID    string `json:"workspace_id,omitempty"`
	AgentName      string `json:"agent_name"`
	RevisionID     string `json:"revision_id,omitempty"`
	TargetDigest   string `json:"target_digest,omitempty"`
	ExpectedDigest string `json:"expected_digest"`
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

type HeartbeatStatusRequest struct {
	WorkspaceID             string `json:"workspace_id,omitempty"`
	AgentName               string `json:"agent_name"`
	SessionID               string `json:"session_id,omitempty"`
	IncludeSessionHealth    bool   `json:"include_session_health,omitempty"`
	IncludeRecentWakeEvents bool   `json:"include_recent_wake_events,omitempty"`
}

type HeartbeatStatusResponse struct {
	AgentName        string                             `json:"agent_name"`
	SourcePath       string                             `json:"source_path,omitempty"`
	Enabled          bool                               `json:"enabled"`
	Present          bool                               `json:"present"`
	Active           bool                               `json:"active"`
	Valid            bool                               `json:"valid"`
	ValidationStatus AuthoredValidationStatus           `json:"validation_status"`
	Digest           string                             `json:"digest,omitempty"`
	ConfigDigest     string                             `json:"config_digest,omitempty"`
	SnapshotID       string                             `json:"snapshot_id,omitempty"`
	Summary          string                             `json:"summary,omitempty"`
	Preferences      HeartbeatPreferencesPayload        `json:"preferences"`
	Diagnostics      []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
	WakeState        *HeartbeatWakeStatePayload         `json:"wake_state,omitempty"`
	WakeEvents       []HeartbeatWakeEventPayload        `json:"wake_events,omitempty"`
	SessionHealth    *SessionHealthPayload              `json:"session_health,omitempty"`
	RevisionCursor   string                             `json:"revision_cursor,omitempty"`
}

type HeartbeatTimeWindowPayload struct {
	Timezone string `json:"timezone"`
	Start    string `json:"start"`
	End      string `json:"end"`
}

type HeartbeatValidateByPathRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	Body        string `json:"body"`
}

type HeartbeatValidateRequest struct {
	WorkspaceID string `json:"workspace_id,omitempty"`
	AgentName   string `json:"agent_name,omitempty"`
	Body        string `json:"body"`
}

type HeartbeatWakeByPathRequest struct {
	WorkspaceID    string              `json:"workspace_id,omitempty"`
	SessionID      string              `json:"session_id"`
	Source         HeartbeatWakeSource `json:"source"`
	DryRun         bool                `json:"dry_run,omitempty"`
	IdempotencyKey string              `json:"idempotency_key,omitempty"`
}

type HeartbeatWakeDecisionPayload struct {
	WakeEventID       string                             `json:"wake_event_id,omitempty"`
	Result            HeartbeatWakeResult                `json:"result"`
	Reason            HeartbeatWakeReason                `json:"reason"`
	PolicySnapshotID  string                             `json:"policy_snapshot_id,omitempty"`
	PolicyDigest      string                             `json:"policy_digest,omitempty"`
	ConfigDigest      string                             `json:"config_digest,omitempty"`
	SyntheticPromptID string                             `json:"synthetic_prompt_id,omitempty"`
	Diagnostics       []AuthoredContextDiagnosticPayload `json:"diagnostics,omitempty"`
}

type HeartbeatWakeEventPayload struct {
	ID                string              `json:"id"`
	WorkspaceID       string              `json:"workspace_id,omitempty"`
	AgentName         string              `json:"agent_name,omitempty"`
	SessionID         string              `json:"session_id,omitempty"`
	PolicySnapshotID  string              `json:"policy_snapshot_id,omitempty"`
	Source            HeartbeatWakeSource `json:"source"`
	Result            HeartbeatWakeResult `json:"result"`
	Reason            HeartbeatWakeReason `json:"reason"`
	SyntheticPromptID string              `json:"synthetic_prompt_id,omitempty"`
	CreatedAt         time.Time           `json:"created_at"`
	ExpiresAt         time.Time           `json:"expires_at"`
}

type HeartbeatWakeReason string

type HeartbeatWakeRequest struct {
	WorkspaceID    string              `json:"workspace_id,omitempty"`
	AgentName      string              `json:"agent_name"`
	SessionID      string              `json:"session_id"`
	Source         HeartbeatWakeSource `json:"source"`
	DryRun         bool                `json:"dry_run,omitempty"`
	IdempotencyKey string              `json:"idempotency_key,omitempty"`
}

type HeartbeatWakeResponse struct {
	Decision HeartbeatWakeDecisionPayload `json:"decision"`
}

type HeartbeatWakeResult string

type HeartbeatWakeSource string

type HeartbeatWakeStatePayload struct {
	WorkspaceID      string              `json:"workspace_id,omitempty"`
	AgentName        string              `json:"agent_name,omitempty"`
	SessionID        string              `json:"session_id"`
	PolicySnapshotID string              `json:"policy_snapshot_id,omitempty"`
	LastWakeAt       *time.Time          `json:"last_wake_at,omitempty"`
	NextAllowedAt    *time.Time          `json:"next_allowed_at,omitempty"`
	CoalescedCount   int                 `json:"coalesced_count"`
	LastResult       HeartbeatWakeResult `json:"last_result"`
	LastReason       HeartbeatWakeReason `json:"last_reason,omitempty"`
	UpdatedAt        time.Time           `json:"updated_at"`
}

type HookCatalogPayload struct {
	Order        int                  `json:"order"`
	Name         string               `json:"name"`
	Event        string               `json:"event"`
	Source       string               `json:"source"`
	SkillSource  string               `json:"skill_source,omitempty"`
	Mode         string               `json:"mode"`
	Required     bool                 `json:"required"`
	Priority     int                  `json:"priority"`
	TimeoutMS    int64                `json:"timeout_ms,omitempty"`
	ExecutorKind string               `json:"executor_kind,omitempty"`
	Matcher      hookspkg.HookMatcher `json:"matcher"`
	Metadata     map[string]string    `json:"metadata,omitempty"`
}

type HookCatalogQuery struct {
	Workspace string
	Agent     string
	Event     string
	Source    string
	Mode      string
}

type HookCatalogResponse struct {
	Hooks []HookCatalogPayload `json:"hooks"`
}

type HookEventPayload struct {
	Event         string `json:"event"`
	Family        string `json:"family"`
	SyncEligible  bool   `json:"sync_eligible"`
	PayloadSchema string `json:"payload_schema"`
	PatchSchema   string `json:"patch_schema,omitempty"`
}

type HookEventsQuery struct {
	Family   string
	SyncOnly bool
}

type HookEventsResponse struct {
	Events []HookEventPayload `json:"events"`
}

type HookRunPayload struct {
	HookName      string          `json:"hook_name"`
	Event         string          `json:"event"`
	Source        string          `json:"source"`
	Mode          string          `json:"mode"`
	DurationMS    int64           `json:"duration_ms"`
	Outcome       string          `json:"outcome"`
	DispatchDepth int             `json:"dispatch_depth"`
	PatchApplied  json.RawMessage `json:"patch_applied,omitempty"`
	Error         string          `json:"error,omitempty"`
	Required      bool            `json:"required,omitempty"`
	RecordedAt    time.Time       `json:"recorded_at"`
}

type HookRunsQuery struct {
	Session string
	Event   string
	Outcome string
	Since   string
	Last    int
}

type HookRunsResponse struct {
	Runs []HookRunPayload `json:"runs"`
}

type InstallExtensionRequest struct {
	Path            string `json:"path,omitempty"`
	Checksum        string `json:"checksum,omitempty"`
	Slug            string `json:"slug,omitempty"`
	Version         string `json:"version,omitempty"`
	Source          string `json:"source,omitempty"`
	Asset           string `json:"asset,omitempty"`
	AllowUnverified bool   `json:"allow_unverified,omitempty"`
}

type JobPayload struct {
	ID          string                           `json:"id"`
	Scope       automationpkg.Scope              `json:"scope"`
	Name        string                           `json:"name"`
	AgentName   string                           `json:"agent_name"`
	WorkspaceID string                           `json:"workspace_id,omitempty"`
	Prompt      string                           `json:"prompt"`
	Schedule    *automationpkg.ScheduleSpec      `json:"schedule,omitempty"`
	Task        *automationpkg.JobTaskConfig     `json:"task,omitempty"`
	Enabled     bool                             `json:"enabled"`
	Retry       automationpkg.RetryConfig        `json:"retry"`
	FireLimit   automationpkg.FireLimitConfig    `json:"fire_limit"`
	Source      automationpkg.JobSource          `json:"source"`
	CreatedAt   time.Time                        `json:"created_at"`
	UpdatedAt   time.Time                        `json:"updated_at"`
	NextRun     *time.Time                       `json:"next_run,omitempty"`
	Scheduler   *AutomationSchedulerStatePayload `json:"scheduler,omitempty"`
}

type JobResponse struct {
	Job JobPayload `json:"job"`
}

type JobsResponse struct {
	Jobs []JobPayload `json:"jobs"`
}

type LogEventPayload struct {
	ID          string          `json:"id"`
	SessionID   string          `json:"session_id"`
	WorkspaceID string          `json:"workspace_id,omitempty"`
	Type        string          `json:"type"`
	AgentName   string          `json:"agent_name"`
	Provider    string          `json:"provider,omitempty"`
	Component   string          `json:"component,omitempty"`
	Outcome     string          `json:"outcome,omitempty"`
	Content     json.RawMessage `json:"content,omitempty"`
	store.EventCorrelation
	ParentSessionID string    `json:"parent_session_id,omitempty"`
	RootSessionID   string    `json:"root_session_id,omitempty"`
	SpawnDepth      int       `json:"spawn_depth"`
	Summary         string    `json:"summary,omitempty"`
	Timestamp       time.Time `json:"timestamp"`
}

type LogTailStatusPayload struct {
	Available bool   `json:"available"`
	Status    string `json:"status"`
}

type LogsListResponse struct {
	Events []LogEventPayload `json:"events"`
}

type MCPServerStatusPayload struct {
	Name          string `json:"name"`
	Scope         string `json:"scope"`
	WorkspaceID   string `json:"workspace_id,omitempty"`
	AuthStatus    string `json:"auth_status,omitempty"`
	Configured    bool   `json:"configured"`
	Initialized   bool   `json:"initialized"`
	State         string `json:"state"`
	Probe         string `json:"probe,omitempty"`
	ToolCount     int    `json:"tool_count,omitempty"`
	Reason        string `json:"reason,omitempty"`
	Diagnostic    string `json:"diagnostic,omitempty"`
	Transport     string `json:"transport,omitempty"`
	RuntimeStatus string `json:"runtime_status"`
}

type ManagedExtensionRemovePayload struct {
	Name   string `json:"name"`
	Path   string `json:"path"`
	Status string `json:"status"`
}

type ManagedExtensionUpdatePayload struct {
	Name           string `json:"name"`
	Slug           string `json:"slug"`
	Registry       string `json:"registry"`
	CurrentVersion string `json:"current_version,omitempty"`
	LatestVersion  string `json:"latest_version,omitempty"`
	Path           string `json:"path"`
	Status         string `json:"status"`
}

type MemoryAdhocNoteRequest struct {
	Scope       memcontract.Scope     `json:"scope"`
	WorkspaceID string                `json:"workspace_id,omitempty"`
	AgentName   string                `json:"agent_name,omitempty"`
	AgentTier   memcontract.AgentTier `json:"agent_tier,omitempty"`
	Content     string                `json:"content"`
	Slug        string                `json:"slug,omitempty"`
}

type MemoryAdhocNoteResponse struct {
	Path      string    `json:"path"`
	Accepted  bool      `json:"accepted"`
	CreatedAt time.Time `json:"created_at"`
}

type MemoryConfigMetadataResponse struct {
	Config       SettingsMemoryConfigPayload `json:"config"`
	MutablePaths []string                    `json:"mutable_paths"`
	LockedPaths  []string                    `json:"locked_paths"`
	Providers    []MemoryProviderPayload     `json:"providers"`
}

type MemoryConsolidateRequest struct {
	Workspace string `json:"workspace,omitempty"`
}

type MemoryConsolidateResponse struct {
	Triggered bool   `json:"triggered"`
	Reason    string `json:"reason,omitempty"`
}

type MemoryCreateRequest struct {
	Scope          memcontract.Scope     `json:"scope"`
	WorkspaceID    string                `json:"workspace_id,omitempty"`
	AgentName      string                `json:"agent_name,omitempty"`
	AgentTier      memcontract.AgentTier `json:"agent_tier,omitempty"`
	Origin         memcontract.Origin    `json:"origin,omitempty"`
	Type           memcontract.Type      `json:"type"`
	Name           string                `json:"name"`
	Description    string                `json:"description,omitempty"`
	Content        string                `json:"content"`
	Entity         string                `json:"entity,omitempty"`
	Attribute      string                `json:"attribute,omitempty"`
	Metadata       map[string]string     `json:"metadata,omitempty"`
	IdempotencyKey string                `json:"idempotency_key,omitempty"`
	DryRun         bool                  `json:"dry_run,omitempty"`
}

type MemoryDailyLogListResponse struct {
	Logs []MemoryDailyLogPayload `json:"logs"`
}

type MemoryDailyLogPayload struct {
	Date           string                `json:"date"`
	Scope          memcontract.Scope     `json:"scope"`
	WorkspaceID    string                `json:"workspace_id,omitempty"`
	AgentName      string                `json:"agent_name,omitempty"`
	AgentTier      memcontract.AgentTier `json:"agent_tier,omitempty"`
	Path           string                `json:"path"`
	OperationCount int                   `json:"operation_count"`
}

type MemoryDecisionListResponse struct {
	Decisions []MemoryDecisionPayload `json:"decisions"`
}

type MemoryDecisionOp string

type MemoryDecisionPayload struct {
	ID              string                     `json:"id"`
	CandidateHash   string                     `json:"candidate_hash"`
	IdempotencyKey  string                     `json:"idempotency_key,omitempty"`
	Op              MemoryDecisionOp           `json:"op"`
	Scope           memcontract.Scope          `json:"scope"`
	WorkspaceID     string                     `json:"workspace_id,omitempty"`
	AgentName       string                     `json:"agent_name,omitempty"`
	AgentTier       memcontract.AgentTier      `json:"agent_tier,omitempty"`
	Targets         []string                   `json:"targets,omitempty"`
	TargetFilename  string                     `json:"target_filename,omitempty"`
	Frontmatter     memcontract.Header         `json:"frontmatter"`
	PostContentHash string                     `json:"post_content_hash,omitempty"`
	Confidence      float32                    `json:"confidence"`
	Source          memcontract.DecisionSource `json:"source"`
	RuleTrace       []memcontract.RuleHit      `json:"rule_trace,omitempty"`
	LLMTrace        *MemoryLLMTracePayload     `json:"llm_trace,omitempty"`
	Reason          string                     `json:"reason,omitempty"`
	PromptVersion   string                     `json:"prompt_version,omitempty"`
	AppliedAt       *time.Time                 `json:"applied_at,omitempty"`
	DecidedAt       time.Time                  `json:"decided_at"`
}

type MemoryDecisionResponse struct {
	Decision MemoryDecisionPayload `json:"decision"`
}

type MemoryDecisionRevertRequest struct {
	Reason string `json:"reason,omitempty"`
	DryRun bool   `json:"dry_run,omitempty"`
}

type MemoryDecisionRevertResponse struct {
	Decision MemoryDecisionPayload `json:"decision"`
	Reverted bool                  `json:"reverted"`
	DryRun   bool                  `json:"dry_run,omitempty"`
}

type MemoryDeleteResponse struct {
	Decision MemoryDecisionPayload `json:"decision"`
	Applied  bool                  `json:"applied"`
}

type MemoryDreamListResponse struct {
	Dreams []MemoryDreamPayload `json:"dreams"`
}

type MemoryDreamPayload struct {
	ID             string                `json:"id"`
	Status         MemoryDreamState      `json:"status"`
	Scope          memcontract.Scope     `json:"scope"`
	WorkspaceID    string                `json:"workspace_id,omitempty"`
	AgentName      string                `json:"agent_name,omitempty"`
	AgentTier      memcontract.AgentTier `json:"agent_tier,omitempty"`
	CandidateCount int                   `json:"candidate_count"`
	PromotedCount  int                   `json:"promoted_count"`
	ArtifactPaths  []string              `json:"artifact_paths,omitempty"`
	FailurePath    string                `json:"failure_path,omitempty"`
	FailureReason  string                `json:"failure_reason,omitempty"`
	LockUntil      *time.Time            `json:"lock_until,omitempty"`
	StartedAt      time.Time             `json:"started_at"`
	CompletedAt    *time.Time            `json:"completed_at,omitempty"`
}

type MemoryDreamResponse struct {
	Dream MemoryDreamPayload `json:"dream"`
}

type MemoryDreamRetryRequest struct {
	FailureID string `json:"failure_id,omitempty"`
	Force     bool   `json:"force,omitempty"`
}

type MemoryDreamRetryResponse struct {
	Dream   MemoryDreamPayload `json:"dream"`
	Retried bool               `json:"retried"`
}

type MemoryDreamState string

type MemoryDreamTriggerRequest struct {
	Scope       memcontract.Scope     `json:"scope,omitempty"`
	WorkspaceID string                `json:"workspace_id,omitempty"`
	AgentName   string                `json:"agent_name,omitempty"`
	AgentTier   memcontract.AgentTier `json:"agent_tier,omitempty"`
	Force       bool                  `json:"force,omitempty"`
}

type MemoryDreamTriggerResponse struct {
	Dream     MemoryDreamPayload `json:"dream"`
	Triggered bool               `json:"triggered"`
	Reason    string             `json:"reason,omitempty"`
}

type MemoryEditRequest struct {
	Scope          memcontract.Scope     `json:"scope,omitempty"`
	WorkspaceID    string                `json:"workspace_id,omitempty"`
	AgentName      string                `json:"agent_name,omitempty"`
	AgentTier      memcontract.AgentTier `json:"agent_tier,omitempty"`
	Type           memcontract.Type      `json:"type,omitempty"`
	Name           string                `json:"name,omitempty"`
	Description    string                `json:"description,omitempty"`
	Content        string                `json:"content"`
	Metadata       map[string]string     `json:"metadata,omitempty"`
	IdempotencyKey string                `json:"idempotency_key,omitempty"`
	DryRun         bool                  `json:"dry_run,omitempty"`
}

type MemoryEntryPayload struct {
	Summary MemoryEntrySummaryPayload `json:"summary"`
	Content string                    `json:"content"`
}

type MemoryEntryResponse struct {
	Memory MemoryEntryPayload `json:"memory"`
}

type MemoryEntrySummaryPayload struct {
	Filename        string                `json:"filename"`
	Name            string                `json:"name"`
	Description     string                `json:"description,omitempty"`
	Type            memcontract.Type      `json:"type"`
	Scope           memcontract.Scope     `json:"scope"`
	WorkspaceID     string                `json:"workspace_id,omitempty"`
	AgentName       string                `json:"agent_name,omitempty"`
	AgentTier       memcontract.AgentTier `json:"agent_tier,omitempty"`
	ContentHash     string                `json:"content_hash,omitempty"`
	SupersededBy    string                `json:"superseded_by,omitempty"`
	ModTime         time.Time             `json:"mod_time"`
	CreatedAt       *time.Time            `json:"created_at,omitempty"`
	UpdatedAt       *time.Time            `json:"updated_at,omitempty"`
	LastRecalledAt  *time.Time            `json:"last_recalled_at,omitempty"`
	RecallCount     int                   `json:"recall_count"`
	Injection       bool                  `json:"injection"`
	SystemManaged   bool                  `json:"system_managed"`
	StalenessBanner string                `json:"staleness_banner,omitempty"`
}

type MemoryErrorPayload struct {
	Code    string         `json:"code"`
	Message string         `json:"message"`
	Details map[string]any `json:"details,omitempty"`
}

type MemoryExtractorDrainResponse struct {
	DrainedAt time.Time `json:"drained_at"`
	Remaining int       `json:"remaining"`
}

type MemoryExtractorFailurePayload struct {
	ID          string    `json:"id"`
	SessionID   string    `json:"session_id"`
	WorkspaceID string    `json:"workspace_id,omitempty"`
	AgentName   string    `json:"agent_name,omitempty"`
	Reason      string    `json:"reason"`
	Path        string    `json:"path"`
	CreatedAt   time.Time `json:"created_at"`
}

type MemoryExtractorFailuresResponse struct {
	Failures []MemoryExtractorFailurePayload `json:"failures"`
}

type MemoryExtractorRetryRequest struct {
	FailureID string `json:"failure_id,omitempty"`
	SessionID string `json:"session_id,omitempty"`
}

type MemoryExtractorRetryResponse struct {
	Retried int `json:"retried"`
	Failed  int `json:"failed"`
}

type MemoryExtractorState string

type MemoryExtractorStatusPayload struct {
	Status                 MemoryExtractorState `json:"status"`
	QueuedSessions         int                  `json:"queued_sessions"`
	InFlightSessions       int                  `json:"in_flight_sessions"`
	ActiveProviderSessions int                  `json:"active_provider_sessions"`
	DroppedTurns           int                  `json:"dropped_turns"`
	CoalescedTurns         int                  `json:"coalesced_turns"`
	SkippedTurns           int                  `json:"skipped_turns"`
	BackpressuredSessions  int                  `json:"backpressured_sessions"`
	FailureCount           int                  `json:"failure_count"`
}

type MemoryExtractorStatusResponse struct {
	Extractor MemoryExtractorStatusPayload `json:"extractor"`
}

type MemoryHealthPayload struct {
	Status             string     `json:"status"`
	Reason             string     `json:"reason,omitempty"`
	Enabled            bool       `json:"enabled"`
	Configured         bool       `json:"configured"`
	GlobalDir          string     `json:"global_dir,omitempty"`
	GlobalFiles        int        `json:"global_files"`
	WorkspaceFiles     int        `json:"workspace_files"`
	WorkspaceCount     int        `json:"workspace_count"`
	DreamEnabled       bool       `json:"dream_enabled"`
	DreamAgent         string     `json:"dream_agent,omitempty"`
	DreamMinHours      float64    `json:"dream_min_hours,omitempty"`
	DreamMinSessions   int        `json:"dream_min_sessions,omitempty"`
	DreamCheckInterval string     `json:"dream_check_interval,omitempty"`
	IndexedFiles       int        `json:"indexed_files"`
	OrphanedFiles      int        `json:"orphaned_files"`
	LastReindex        *time.Time `json:"last_reindex"`
	OperationCount     int        `json:"operation_count"`
	LastOperationAt    *time.Time `json:"last_operation_at"`
	LastConsolidation  *time.Time `json:"last_consolidation"`
}

type MemoryHistoryResponse struct {
	Operations []MemoryOperationPayload `json:"operations"`
}

type MemoryLLMTracePayload struct {
	Model         string `json:"model"`
	PromptVersion string `json:"prompt_version"`
	LatencyMs     int64  `json:"latency_ms"`
	Error         string `json:"error,omitempty"`
}

type MemoryListResponse struct {
	Memories []MemoryEntrySummaryPayload `json:"memories"`
}

type MemoryMutationDecisionResponse struct {
	Decision MemoryDecisionPayload `json:"decision"`
	Applied  bool                  `json:"applied"`
	DryRun   bool                  `json:"dry_run,omitempty"`
}

type MemoryMutationResponse struct {
	OK bool `json:"ok"`
}

type MemoryOperationHistoryPayload struct {
	ID          string                `json:"id"`
	Operation   memcontract.Operation `json:"operation"`
	Scope       memcontract.Scope     `json:"scope,omitempty"`
	WorkspaceID string                `json:"workspace_id,omitempty"`
	AgentName   string                `json:"agent_name,omitempty"`
	AgentTier   memcontract.AgentTier `json:"agent_tier,omitempty"`
	Filename    string                `json:"filename,omitempty"`
	Summary     string                `json:"summary,omitempty"`
	Timestamp   time.Time             `json:"timestamp"`
}

type MemoryOperationHistoryResponse struct {
	Operations []MemoryOperationHistoryPayload `json:"operations"`
}