@swarmclawai/swarmclaw 1.2.6 → 1.2.9

package/src/types/index.ts

@@ -1,3555 +1,16 @@
-export interface MessageToolEvent {
-  name: string
-  input: string
-  output?: string
-  error?: boolean
-  /** Internal correlation token for matching streaming tool calls/results. */
-  toolCallId?: string
-}
-
-export type MessageTaskIntent = 'coding' | 'research' | 'browsing' | 'outreach' | 'scheduling' | 'general'
-export type MessageWorkType = 'coding' | 'research' | 'writing' | 'review' | 'operations' | 'general'
-
-export interface MessageSemanticsSummary {
-  taskIntent: MessageTaskIntent
-  workType: MessageWorkType
-  walletIntent: 'none' | 'read_only' | 'transactional'
-  isDeliverableTask: boolean
-  isBroadGoal: boolean
-  isResearchSynthesis: boolean
-  hasHumanSignals: boolean
-  hasSignificantEvent: boolean
-  wantsScreenshots?: boolean
-  wantsOutboundDelivery?: boolean
-  wantsVoiceDelivery?: boolean
-  explicitToolRequests: string[]
-  confidence: number
-}
-
-export interface Message {
-  role: 'user' | 'assistant'
-  text: string
-  time: number
-  /** Client-only render identity used to keep in-progress transcript rows stable. */
-  clientRenderId?: string
-  imagePath?: string
-  imageUrl?: string
-  attachedFiles?: string[]
-  toolEvents?: MessageToolEvent[]
-  thinking?: string
-  kind?: 'chat' | 'heartbeat' | 'system' | 'context-clear' | 'extension-ui' | 'connector-delivery'
-  suppressed?: boolean
-  bookmarked?: boolean
-  suggestions?: string[]
-  replyToId?: string
-  source?: MessageSource
-  /** Persist in the UI transcript, but exclude from normal model history. */
-  historyExcluded?: boolean
-  /** True while the message is still being streamed — cleared on final persist. */
-  streaming?: boolean
-  /** Run ID that produced this message — used to scope streaming artifact replacement. */
-  runId?: string
-  /** Cached turn semantics used for routing, delegation, and reflection. */
-  semantics?: MessageSemanticsSummary
-}
-
-export type SessionResetMode = 'idle' | 'daily' | 'isolated'
-export type SessionResetType = 'direct' | 'group' | 'thread' | 'main'
-
-export interface IdentityContinuityState {
-  selfSummary?: string | null
-  relationshipSummary?: string | null
-  personaLabel?: string | null
-  toneStyle?: string | null
-  boundaries?: string[]
-  continuityNotes?: string[]
-  updatedAt?: number | null
-}
-
-export interface SessionArchiveState {
-  memoryId?: string | null
-  lastSyncedAt?: number | null
-  lastHash?: string | null
-  messageCount?: number
-  exportPath?: string | null
-}
-
-export type WorkingStateStatus = 'idle' | 'progress' | 'blocked' | 'waiting' | 'completed'
-export type WorkingStateItemStatus = 'active' | 'resolved' | 'superseded'
-
-export interface EvidenceRef {
-  id: string
-  type: 'tool' | 'message' | 'mission' | 'task' | 'artifact' | 'error' | 'approval'
-  summary: string
-  value?: string | null
-  toolName?: string | null
-  toolCallId?: string | null
-  runId?: string | null
-  sessionId?: string | null
-  missionId?: string | null
-  taskId?: string | null
-  createdAt: number
-}
-
-export interface WorkingPlanStep {
-  id: string
-  text: string
-  status: WorkingStateItemStatus
-  createdAt: number
-  updatedAt: number
-}
-
-export interface WorkingFact {
-  id: string
-  statement: string
-  source: 'user' | 'tool' | 'assistant' | 'mission' | 'system'
-  status: WorkingStateItemStatus
-  evidenceIds?: string[]
-  createdAt: number
-  updatedAt: number
-}
-
-export interface WorkingArtifact {
-  id: string
-  label: string
-  kind: 'file' | 'url' | 'approval' | 'message' | 'other'
-  path?: string | null
-  url?: string | null
-  sourceTool?: string | null
-  status: WorkingStateItemStatus
-  evidenceIds?: string[]
-  createdAt: number
-  updatedAt: number
-}
-
-export interface WorkingDecision {
-  id: string
-  summary: string
-  rationale?: string | null
-  status: WorkingStateItemStatus
-  evidenceIds?: string[]
-  createdAt: number
-  updatedAt: number
-}
-
-export interface WorkingBlocker {
-  id: string
-  summary: string
-  kind?: 'approval' | 'credential' | 'human_input' | 'external_dependency' | 'error' | 'other' | null
-  nextAction?: string | null
-  status: WorkingStateItemStatus
-  evidenceIds?: string[]
-  createdAt: number
-  updatedAt: number
-}
-
-export interface WorkingQuestion {
-  id: string
-  question: string
-  status: WorkingStateItemStatus
-  evidenceIds?: string[]
-  createdAt: number
-  updatedAt: number
-}
-
-export interface WorkingHypothesis {
-  id: string
-  statement: string
-  confidence?: 'low' | 'medium' | 'high' | null
-  status: WorkingStateItemStatus
-  evidenceIds?: string[]
-  createdAt: number
-  updatedAt: number
-}
-
-export interface WorkingPlanStepPatch {
-  id?: string | null
-  text: string
-  status?: WorkingStateItemStatus | null
-}
-
-export interface WorkingFactPatch {
-  id?: string | null
-  statement: string
-  source?: WorkingFact['source'] | null
-  status?: WorkingStateItemStatus | null
-  evidenceIds?: string[]
-}
-
-export interface WorkingArtifactPatch {
-  id?: string | null
-  label: string
-  kind?: WorkingArtifact['kind'] | null
-  path?: string | null
-  url?: string | null
-  sourceTool?: string | null
-  status?: WorkingStateItemStatus | null
-  evidenceIds?: string[]
-}
-
-export interface WorkingDecisionPatch {
-  id?: string | null
-  summary: string
-  rationale?: string | null
-  status?: WorkingStateItemStatus | null
-  evidenceIds?: string[]
-}
-
-export interface WorkingBlockerPatch {
-  id?: string | null
-  summary: string
-  kind?: WorkingBlocker['kind']
-  nextAction?: string | null
-  status?: WorkingStateItemStatus | null
-  evidenceIds?: string[]
-}
-
-export interface WorkingQuestionPatch {
-  id?: string | null
-  question: string
-  status?: WorkingStateItemStatus | null
-  evidenceIds?: string[]
-}
-
-export interface WorkingHypothesisPatch {
-  id?: string | null
-  statement: string
-  confidence?: WorkingHypothesis['confidence']
-  status?: WorkingStateItemStatus | null
-  evidenceIds?: string[]
-}
-
-export interface WorkingStatePatch {
-  objective?: string | null
-  summary?: string | null
-  constraints?: string[]
-  successCriteria?: string[]
-  status?: WorkingStateStatus | null
-  nextAction?: string | null
-  planSteps?: WorkingPlanStepPatch[]
-  factsUpsert?: WorkingFactPatch[]
-  artifactsUpsert?: WorkingArtifactPatch[]
-  decisionsAppend?: WorkingDecisionPatch[]
-  blockersUpsert?: WorkingBlockerPatch[]
-  questionsUpsert?: WorkingQuestionPatch[]
-  hypothesesUpsert?: WorkingHypothesisPatch[]
-  evidenceAppend?: EvidenceRef[]
-  supersedeIds?: string[]
-}
-
-export interface SessionWorkingState {
-  sessionId: string
-  missionId?: string | null
-  objective?: string | null
-  summary?: string | null
-  constraints: string[]
-  successCriteria: string[]
-  status: WorkingStateStatus
-  nextAction?: string | null
-  planSteps: WorkingPlanStep[]
-  confirmedFacts: WorkingFact[]
-  artifacts: WorkingArtifact[]
-  decisions: WorkingDecision[]
-  blockers: WorkingBlocker[]
-  openQuestions: WorkingQuestion[]
-  hypotheses: WorkingHypothesis[]
-  evidenceRefs: EvidenceRef[]
-  createdAt: number
-  updatedAt: number
-  lastCompactedAt?: number | null
-}
-
-export interface ExecutionBriefPlanStep {
-  text: string
-  status: WorkingStateItemStatus
-}
-
-export interface ExecutionBrief {
-  sessionId?: string | null
-  missionId?: string | null
-  objective: string | null
-  summary: string | null
-  status: WorkingStateStatus
-  nextAction: string | null
-  plan: ExecutionBriefPlanStep[]
-  blockers: string[]
-  facts: string[]
-  artifacts: string[]
-  constraints: string[]
-  successCriteria: string[]
-  missionStatus?: MissionStatus | null
-  missionPhase?: MissionPhase | null
-  waitState?: MissionWaitState | null
-  evidenceRefs: EvidenceRef[]
-  parentContext: string | null
-}
-
-export type MissionSource =
-  | 'chat'
-  | 'connector'
-  | 'heartbeat'
-  | 'main-loop-followup'
-  | 'task'
-  | 'schedule'
-  | 'delegation'
-  | 'manual'
-
-export type MissionStatus = 'active' | 'waiting' | 'completed' | 'failed' | 'cancelled'
-export type MissionPhase = 'intake' | 'planning' | 'dispatching' | 'executing' | 'verifying' | 'waiting' | 'completed' | 'failed'
-export type MissionWaitKind =
-  | 'human_reply'
-  | 'approval'
-  | 'external_dependency'
-  | 'provider'
-  | 'blocked_task'
-  | 'blocked_mission'
-  | 'scheduled'
-  | 'other'
-
-export type MissionPlannerDecision =
-  | 'dispatch_task'
-  | 'dispatch_session_turn'
-  | 'spawn_child_mission'
-  | 'wait'
-  | 'verify_now'
-  | 'complete_candidate'
-  | 'replan'
-  | 'fail_terminal'
-  | 'cancel'
-
-export type MissionVerificationVerdict =
-  | 'continue'
-  | 'waiting'
-  | 'completed'
-  | 'failed'
-  | 'replan'
-
-export type MissionSourceRef =
-  | { kind: 'chat'; sessionId: string; messageId?: string | null }
-  | { kind: 'connector'; sessionId: string; connectorId: string; channelId: string; threadId?: string | null }
-  | { kind: 'schedule'; scheduleId: string; recurring: boolean }
-  | { kind: 'task'; taskId: string }
-  | { kind: 'delegation'; parentMissionId: string; backend?: 'agent' | 'codex' | 'claude' | 'opencode' | 'gemini' | null }
-  | { kind: 'heartbeat'; sessionId: string }
-  | { kind: 'manual' }
-
-export interface MissionWaitState {
-  kind: MissionWaitKind
-  reason: string
-  approvalId?: string | null
-  untilAt?: number | null
-  dependencyTaskId?: string | null
-  dependencyMissionId?: string | null
-  providerKey?: string | null
-}
-
-export interface MissionControllerState {
-  leaseId?: string | null
-  leaseExpiresAt?: number | null
-  tickRequestedAt?: number | null
-  tickReason?: string | null
-  plannerRunId?: string | null
-  verifierRunId?: string | null
-  activeRunId?: string | null
-  currentTaskId?: string | null
-  currentChildMissionId?: string | null
-  pendingWakeId?: string | null
-  attemptCount?: number
-  lastEvidenceAt?: number | null
-}
-
-export interface MissionPlannerState {
-  lastDecision?: MissionPlannerDecision | null
-  lastPlannedAt?: number | null
-  planSummary?: string | null
-}
-
-export interface MissionVerificationState {
-  candidate: boolean
-  requiredTaskIds?: string[]
-  requiredChildMissionIds?: string[]
-  requiredArtifacts?: string[]
-  evidenceSummary?: string | null
-  lastVerdict?: MissionVerificationVerdict | null
-  lastVerifiedAt?: number | null
-}
-
-export interface MissionSummary {
-  id: string
-  objective: string
-  status: MissionStatus
-  phase: MissionPhase
-  source: MissionSource
-  currentStep?: string | null
-  waitingReason?: string | null
-  sessionId?: string | null
-  agentId?: string | null
-  projectId?: string | null
-  parentMissionId?: string | null
-  rootMissionId?: string | null
-  taskIds?: string[]
-  openTaskCount?: number
-  completedTaskCount?: number
-  childCount?: number
-  sourceRef?: MissionSourceRef
-  updatedAt: number
-}
-
-export interface Mission {
-  id: string
-  source: MissionSource
-  sourceRef?: MissionSourceRef
-  objective: string
-  successCriteria?: string[]
-  status: MissionStatus
-  phase: MissionPhase
-  sessionId?: string | null
-  agentId?: string | null
-  projectId?: string | null
-  rootMissionId?: string | null
-  parentMissionId?: string | null
-  childMissionIds?: string[]
-  dependencyMissionIds?: string[]
-  dependencyTaskIds?: string[]
-  taskIds?: string[]
-  rootTaskId?: string | null
-  currentStep?: string | null
-  plannerSummary?: string | null
-  verifierSummary?: string | null
-  blockerSummary?: string | null
-  waitState?: MissionWaitState | null
-  controllerState?: MissionControllerState
-  plannerState?: MissionPlannerState
-  verificationState?: MissionVerificationState
-  lastRunId?: string | null
-  sourceRunId?: string | null
-  sourceMessage?: string | null
-  createdAt: number
-  updatedAt: number
-  lastActiveAt?: number | null
-  completedAt?: number | null
-  failedAt?: number | null
-  cancelledAt?: number | null
-}
-
-export type MissionEventType =
-  | 'created'
-  | 'source_triggered'
-  | 'attached'
-  | 'planner_decision'
-  | 'dispatch_started'
-  | 'task_linked'
-  | 'task_started'
-  | 'task_completed'
-  | 'task_failed'
-  | 'child_created'
-  | 'child_completed'
-  | 'child_failed'
-  | 'run_result'
-  | 'verifier_decision'
-  | 'waiting'
-  | 'resumed'
-  | 'replanned'
-  | 'completed'
-  | 'failed'
-  | 'cancelled'
-  | 'interrupted'
-  | 'operator_action'
-  | 'status_change'
-
-export interface MissionEvent {
-  id: string
-  missionId: string
-  type: MissionEventType
-  source: MissionSource | 'system'
-  summary: string
-  data?: Record<string, unknown> | null
-  sessionId?: string | null
-  taskId?: string | null
-  runId?: string | null
-  createdAt: number
-}
-
-export interface SessionSkillRuntimeState {
-  selectedSkillId?: string | null
-  selectedSkillName?: string | null
-  selectedAt?: number | null
-  lastAction?: 'select' | 'load' | 'run' | null
-  lastRunAt?: number | null
-  lastRunToolName?: string | null
-}
-
-export interface CanvasMetricItem {
-  label: string
-  value: string
-  detail?: string
-  tone?: 'default' | 'positive' | 'negative' | 'warning'
-}
-
-export interface CanvasCardItem {
-  title: string
-  body?: string
-  meta?: string
-  tone?: 'default' | 'positive' | 'negative' | 'warning'
-}
-
-export interface CanvasActionItem {
-  label: string
-  href?: string
-  note?: string
-  intent?: 'primary' | 'secondary' | 'success' | 'danger'
-}
-
-export interface CanvasTableData {
-  columns: string[]
-  rows: Array<Array<string | number | boolean | null>>
-  caption?: string
-}
-
-export type CanvasBlock =
-  | { type: 'markdown'; title?: string; markdown: string }
-  | { type: 'metrics'; title?: string; items: CanvasMetricItem[] }
-  | { type: 'cards'; title?: string; items: CanvasCardItem[] }
-  | { type: 'table'; title?: string; table: CanvasTableData }
-  | { type: 'code'; title?: string; code: string; language?: string }
-  | { type: 'actions'; title?: string; items: CanvasActionItem[] }
-
-export interface CanvasDocument {
-  kind: 'structured'
-  title?: string
-  subtitle?: string
-  theme?: 'slate' | 'sky' | 'emerald' | 'amber' | 'rose'
-  blocks: CanvasBlock[]
-  updatedAt?: number | null
-}
-
-export type CanvasContent = string | CanvasDocument | null
-
-export type ProviderType = 'claude-cli' | 'codex-cli' | 'opencode-cli' | 'gemini-cli' | 'openai' | 'ollama' | 'anthropic' | 'openclaw' | 'google' | 'deepseek' | 'groq' | 'together' | 'mistral' | 'xai' | 'fireworks' | 'nebius' | 'deepinfra'
-export type ProviderId = ProviderType | (string & {})
-
-export interface ProviderInfo {
-  id: ProviderId
-  name: string
-  models: string[]
-  defaultModels?: string[]
-  supportsModelDiscovery?: boolean
-  requiresApiKey: boolean
-  optionalApiKey?: boolean
-  requiresEndpoint: boolean
-  defaultEndpoint?: string
-}
-
-export interface ProviderModelDiscoveryResult {
-  ok: boolean
-  providerId: string
-  providerName?: string
-  models: string[]
-  cached: boolean
-  fetchedAt: number
-  cacheTtlMs: number
-  supportsDiscovery: boolean
-  missingCredential?: boolean
-  message?: string
-}
-
-export interface Credential {
-  id: string
-  provider: string
-  name: string
-  createdAt: number
-}
-
-export type Credentials = Record<string, Credential>
-export type OllamaMode = 'local' | 'cloud'
-
-export interface Session {
-  id: string
-  name: string
-  openclawAgentId?: string | null
-  shortcutForAgentId?: string | null
-  cwd: string
-  user: string
-  provider: ProviderId
-  model: string
-  ollamaMode?: OllamaMode | null
-  credentialId?: string | null
-  fallbackCredentialIds?: string[]
-  apiEndpoint?: string | null
-  gatewayProfileId?: string | null
-  routePreferredGatewayTags?: string[]
-  routePreferredGatewayUseCase?: string | null
-  claudeSessionId: string | null
-  codexThreadId?: string | null
-  opencodeSessionId?: string | null
-  geminiSessionId?: string | null
-  delegateResumeIds?: {
-    claudeCode?: string | null
-    codex?: string | null
-    opencode?: string | null
-    gemini?: string | null
-  }
-  /** @deprecated Messages are stored in session_messages table. Use message-repository. */
-  messages: Message[]
-  /** Pre-computed message count (kept in sync by message-repository). */
-  messageCount?: number
-  lastMessageSummary?: Message | null
-  lastAssistantAt?: number | null
-  createdAt: number
-  updatedAt?: number | null
-  lastActiveAt: number
-  active?: boolean
-  sessionType?: SessionType
-  agentId?: string | null
-  parentSessionId?: string | null
-  delegationDepth?: number | null
-  tools?: string[]
-  extensions?: string[]
-  heartbeatEnabled?: boolean | null
-  heartbeatIntervalSec?: number | null
-  heartbeatTarget?: 'last' | 'none' | string | null
-  memoryScopeMode?: 'auto' | 'all' | 'global' | 'agent' | 'session' | 'project' | null
-  memoryTierPreference?: 'working' | 'durable' | 'archive' | 'blended' | null
-  projectId?: string | null
-  sessionResetMode?: SessionResetMode | null
-  sessionIdleTimeoutSec?: number | null
-  sessionMaxAgeSec?: number | null
-  sessionDailyResetAt?: string | null
-  sessionResetTimezone?: string | null
-  thinkingLevel?: 'minimal' | 'low' | 'medium' | 'high' | null
-  browserProfileId?: string | null
-  connectorThinkLevel?: 'minimal' | 'low' | 'medium' | 'high' | null
-  connectorSessionScope?: 'main' | 'channel' | 'peer' | 'channel-peer' | 'thread' | null
-  connectorReplyMode?: 'off' | 'first' | 'all' | null
-  connectorThreadBinding?: 'off' | 'prefer' | 'strict' | null
-  connectorGroupPolicy?: 'open' | 'mention' | 'reply-or-mention' | 'disabled' | null
-  connectorIdleTimeoutSec?: number | null
-  connectorMaxAgeSec?: number | null
-  /** Last heartbeat/cron delivery status */
-  lastDeliveryStatus?: 'ok' | 'error' | null
-  /** Timestamp of last heartbeat/cron delivery attempt */
-  lastDeliveredAt?: number | null
-  /** Error message from last failed delivery */
-  lastDeliveryError?: string | null
-  mailbox?: MailboxEnvelope[] | null
-  connectorContext?: {
-    connectorId?: string | null
-    platform?: ConnectorPlatform | null
-    channelId?: string | null
-    channelIdAlt?: string | null
-    senderId?: string | null
-    senderIdAlt?: string | null
-    senderName?: string | null
-    senderAvatarUrl?: string | null
-    sessionKey?: string | null
-    peerKey?: string | null
-    scope?: 'main' | 'channel' | 'peer' | 'channel-peer' | 'thread' | null
-    replyMode?: 'off' | 'first' | 'all' | null
-    threadBinding?: 'off' | 'prefer' | 'strict' | null
-    groupPolicy?: 'open' | 'mention' | 'reply-or-mention' | 'disabled' | null
-    threadId?: string | null
-    threadTitle?: string | null
-    threadPersonaLabel?: string | null
-    threadParentChannelId?: string | null
-    threadParentChannelName?: string | null
-    isGroup?: boolean
-    isOwnerConversation?: boolean
-    lastInboundAt?: number | null
-    lastInboundMessageId?: string | null
-    lastInboundReplyToMessageId?: string | null
-    lastInboundThreadId?: string | null
-    lastOutboundAt?: number | null
-    lastOutboundMessageId?: string | null
-    lastResetAt?: number | null
-    lastResetReason?: string | null
-    allKnownPeerIds?: string[] | null
-  }
-  lastAutoMemoryAt?: number | null
-  lastHeartbeatText?: string | null
-  lastHeartbeatSentAt?: number | null
-  lastSessionResetAt?: number | null
-  lastSessionResetReason?: string | null
-  identityState?: IdentityContinuityState | null
-  sessionArchiveState?: SessionArchiveState | null
-  missionId?: string | null
-  missionSummary?: MissionSummary | null
-  skillRuntimeState?: SessionSkillRuntimeState | null
-  pinned?: boolean
-  file?: string | null
-  queuedCount?: number
-  currentRunId?: string | null
-  conversationTone?: string
-  emoji?: string
-  creature?: string
-  vibe?: string
-  theme?: string
-  avatar?: string
-  canvasContent?: CanvasContent
-  /** Tracks how many times each memory ID has been injected via proactive recall in this session. */
-  injectedMemoryIds?: Record<string, number>
-  /** Structured working memory that survives compaction and flows through delegation. */
-  runContext?: RunContext | null
-}
-
-export interface RunContext {
-  objective: string | null
-  constraints: string[]
-  keyFacts: string[]
-  discoveries: string[]
-  failedApproaches: string[]
-  currentPlan: string[]
-  completedSteps: string[]
-  blockers: string[]
-  parentContext: string | null
-  updatedAt: number
-  version: number
-}
-
-export type Sessions = Record<string, Session>
-
-export type SessionTool =
-  | 'shell'
-  | 'files'
-  | 'claude_code'
-  | 'codex_cli'
-  | 'opencode_cli'
-  | 'web_search'
-  | 'web_fetch'
-  | 'edit_file'
-  | 'process'
-  | 'spawn_subagent'
-  | 'canvas'
-  | 'http_request'
-  | 'git'
-  | 'mailbox'
-  | 'ask_human'
-  | 'document'
-  | 'extract'
-  | 'table'
-  | 'crawl'
-
-// --- Approvals ---
-
-export type ApprovalCategory =
-  | 'tool_access'
-  | 'wallet_transfer'
-  | 'wallet_action'
-  | 'extension_scaffold'
-  | 'extension_install'
-  | 'task_tool'
-  | 'human_loop'
-  | 'connector_sender'
-
-export interface ApprovalRequest {
-  id: string
-  category: ApprovalCategory
-  agentId?: string | null
-  sessionId?: string | null
-  taskId?: string | null
-  title: string
-  description?: string
-  data: Record<string, unknown>
-  createdAt: number
-  updatedAt: number
-  status: 'pending' | 'approved' | 'rejected'
-}
-
-export type Approvals = Record<string, ApprovalRequest>
-
-export type MailboxStatus = 'new' | 'ack'
-
-export interface MailboxEnvelope {
-  id: string
-  type: string
-  payload: string
-  fromSessionId?: string | null
-  fromAgentId?: string | null
-  toSessionId: string
-  toAgentId?: string | null
-  correlationId?: string | null
-  status: MailboxStatus
-  createdAt: number
-  expiresAt?: number | null
-  ackAt?: number | null
-}
-
-export interface ExtensionInvocationRecord {
-  extensionId: string
-  toolName: string
-  inputTokens: number
-  outputTokens: number
-}
-
-export interface ExtensionDefinitionCost {
-  extensionId: string
-  estimatedTokens: number
-}
-
-export interface UsageRecord {
-  sessionId: string
-  messageIndex: number
-  model: string
-  provider: string
-  inputTokens: number
-  outputTokens: number
-  totalTokens: number
-  estimatedCost: number
-  timestamp: number
-  durationMs?: number
-  agentId?: string | null
-  projectId?: string | null
-  extensionDefinitionCosts?: ExtensionDefinitionCost[]
-  extensionInvocations?: ExtensionInvocationRecord[]
-}
-
-// --- Extension System ---
-
-export interface ExtensionPromptBuildResult {
-  systemPrompt?: string
-  prependContext?: string
-  prependSystemContext?: string
-  appendSystemContext?: string
-}
-
-export interface ExtensionModelResolveResult {
-  providerOverride?: ProviderId
-  modelOverride?: string
-  apiEndpointOverride?: string | null
-}
-
-export interface ExtensionToolCallResult {
-  input?: Record<string, unknown> | null
-  params?: Record<string, unknown>
-  block?: boolean
-  blockReason?: string
-  warning?: string
-}
-
-export interface ExtensionMessagePersistResult {
-  message?: Message
-}
-
-export interface ExtensionBeforeMessageWriteResult extends ExtensionMessagePersistResult {
-  block?: boolean
-}
-
-export interface ExtensionSubagentSpawningResult {
-  status: 'ok' | 'error'
-  error?: string
-}
-
-export interface ExtensionHooks {
-  beforeAgentStart?: (ctx: { session: Session; message: string }) => Promise<void> | void
-  afterAgentComplete?: (ctx: { session: Session; response: string }) => Promise<void> | void
-  beforeModelResolve?: (ctx: {
-    session: Session
-    prompt: string
-    message: string
-    provider: ProviderId
-    model: string
-    apiEndpoint?: string | null
-  }) => Promise<ExtensionModelResolveResult | void> | ExtensionModelResolveResult | void
-  beforeToolExec?: (ctx: { toolName: string; input: Record<string, unknown> | null }) => Promise<Record<string, unknown> | void> | Record<string, unknown> | void
-  beforePromptBuild?: (ctx: {
-    session: Session
-    prompt: string
-    message: string
-    history: Message[]
-    messages: Message[]
-  }) => Promise<ExtensionPromptBuildResult | void> | ExtensionPromptBuildResult | void
-  beforeToolCall?: (ctx: {
-    session: Session
-    toolName: string
-    input: Record<string, unknown> | null
-    runId?: string
-    toolCallId?: string
-  }) => Promise<ExtensionToolCallResult | Record<string, unknown> | void> | ExtensionToolCallResult | Record<string, unknown> | void
-  llmInput?: (ctx: {
-    session: Session
-    runId: string
-    provider: ProviderId
-    model: string
-    systemPrompt?: string
-    prompt: string
-    historyMessages: Message[]
-    imagesCount: number
-  }) => Promise<void> | void
-  llmOutput?: (ctx: {
-    session: Session
-    runId: string
-    provider: ProviderId
-    model: string
-    assistantTexts: string[]
-    response: string
-    usage?: {
-      input?: number
-      output?: number
-      total?: number
-      estimatedCost?: number
-    }
-  }) => Promise<void> | void
-  toolResultPersist?: (ctx: {
-    session: Session
-    message: Message
-    toolName?: string
-    toolCallId?: string
-    isSynthetic?: boolean
-  }) => Promise<ExtensionMessagePersistResult | Message | void> | ExtensionMessagePersistResult | Message | void
-  beforeMessageWrite?: (ctx: {
-    session: Session
-    message: Message
-    phase?: 'user' | 'system' | 'assistant_partial' | 'assistant_final' | 'heartbeat'
-    runId?: string
-  }) => Promise<ExtensionBeforeMessageWriteResult | Message | void> | ExtensionBeforeMessageWriteResult | Message | void
-  afterToolExec?: (ctx: { session: Session; toolName: string; input: Record<string, unknown> | null; output: string }) => Promise<void> | void
-  onMessage?: (ctx: { session: Session; message: Message }) => Promise<void> | void
-  sessionStart?: (ctx: {
-    session: Session
-    resumedFrom?: string | null
-  }) => Promise<void> | void
-  sessionEnd?: (ctx: {
-    sessionId: string
-    session?: Session | null
-    messageCount: number
-    durationMs?: number
-    reason?: string | null
-  }) => Promise<void> | void
-  subagentSpawning?: (ctx: {
-    parentSessionId?: string | null
-    agentId: string
-    agentName: string
-    message: string
-    cwd: string
-    mode: 'run' | 'session'
-    threadRequested: boolean
-  }) => Promise<ExtensionSubagentSpawningResult | void> | ExtensionSubagentSpawningResult | void
-  subagentSpawned?: (ctx: {
-    parentSessionId?: string | null
-    childSessionId: string
-    agentId: string
-    agentName: string
-    runId: string
-    mode: 'run' | 'session'
-    threadRequested: boolean
-  }) => Promise<void> | void
-  subagentEnded?: (ctx: {
-    parentSessionId?: string | null
-    childSessionId: string
-    agentId: string
-    agentName: string
-    status: 'completed' | 'failed' | 'cancelled' | 'timed_out'
-    response?: string | null
-    error?: string | null
-    durationMs?: number
-  }) => Promise<void> | void
-
-  // Post-turn hook — fires after a full chat exchange (user message → agent response)
-  afterChatTurn?: (ctx: {
-    session: Session
-    message: string
-    response: string
-    source: string
-    internal: boolean
-    toolEvents?: MessageToolEvent[]
-  }) => Promise<void> | void
-
-  // Orchestration & Swarm Hooks
-  onTaskComplete?: (ctx: { taskId: string; result: unknown }) => Promise<void> | void
-  onAgentDelegation?: (ctx: { sourceAgentId: string; targetAgentId: string; task: string }) => Promise<void> | void
-
-  // Chat Middleware (Transform messages)
-  transformInboundMessage?: (ctx: { session: Session; text: string }) => Promise<string> | string
-  transformOutboundMessage?: (ctx: { session: Session; text: string }) => Promise<string> | string
-
-  // Context injection — return a markdown string to inject into the agent's state modifier, or null/undefined to skip
-  getAgentContext?: (ctx: { session: Session; enabledExtensions: string[]; message: string; history: Message[] }) => Promise<string | null | undefined> | string | null | undefined
-
-  // Self-description — returns a capability line for the system prompt (e.g., "I can remember things across conversations")
-  getCapabilityDescription?: () => string | null | undefined
-
-  // Operating guidance — returns operational hints for the agent when this extension is active
-  getOperatingGuidance?: () => string | string[] | null | undefined
-
-  // Approval guidance — returns approval-scoped instructions when this extension is active
-  getApprovalGuidance?: (ctx: {
-    approval: ApprovalRequest
-    phase: 'request' | 'resume' | 'connector_reminder'
-    approved?: boolean
-  }) => string | string[] | null | undefined
-}
-
-export interface ExtensionToolPlanning {
-  /**
-   * Capability tags that the harness can use for prompt guidance and tool routing.
-   * Examples: research.search, research.fetch, browser.capture, artifact.pdf,
-   * delivery.media, delivery.voice_note.
-   */
-  capabilities?: string[]
-  /**
-   * Concrete usage guidance that should be injected into the system prompt when
-   * this tool is enabled.
-   */
-  disciplineGuidance?: string[]
-}
-
-export interface ExtensionToolDef {
-  name: string
-  description: string
-  parameters: Record<string, unknown>
-  planning?: ExtensionToolPlanning
-  execute: (args: Record<string, unknown>, ctx: { session: Session; message: string }) => Promise<string | object> | string | object
-}
-
-export interface ExtensionSettingsField {
-  key: string
-  label: string
-  type: 'text' | 'number' | 'boolean' | 'select' | 'secret'
-  placeholder?: string
-  help?: string
-  options?: Array<{ value: string; label: string }>
-  defaultValue?: string | number | boolean
-  required?: boolean
-}
-
-export interface ExtensionUIDefinition {
-  sidebarItems?: Array<{
-    id: string
-    label: string
-    icon?: string
-    href: string
-    position?: 'top' | 'bottom'
-  }>
-  headerWidgets?: Array<{
-    id: string
-    label: string
-    icon?: string
-  }>
-  chatInputActions?: Array<{
-    id: string
-    label: string
-    icon?: string
-    tooltip?: string
-    action: 'message' | 'link' | 'tool'
-    value: string
-  }>
-  /** Settings fields declared by the extension, rendered in the extension settings panel */
-  settingsFields?: ExtensionSettingsField[]
-  /** Chat panels the extension provides (e.g., browser view, terminal) */
-  chatPanels?: Array<{
-    id: string
-    label: string
-    icon?: string
-    /** WS topic to subscribe to for updates (e.g., 'browser:{sessionId}') */
-    wsTopic?: string
-  }>
-  /** Badges to show on agent cards when this extension is enabled */
-  agentBadges?: Array<{
-    id: string
-    label: string
-    icon?: string
-  }>
-}
-
-export interface ExtensionProviderDefinition {
-  id: string
-  name: string
-  models: string[]
-  requiresApiKey: boolean
-  requiresEndpoint: boolean
-  defaultEndpoint?: string
-  streamChat: (opts: {
-    session: { id: string } & Record<string, unknown>
-    message: string
-    imagePath?: string
-    imageUrl?: string
-    apiKey?: string | null
-    systemPrompt?: string
-    write: (data: string) => void
-    active: Map<string, unknown>
-    loadHistory: (sessionId: string) => unknown[]
-    onUsage?: (usage: { inputTokens: number; outputTokens: number }) => void
-    signal?: AbortSignal
-  }) => Promise<string>
-}
-
-export type InboundMediaType = 'image' | 'video' | 'audio' | 'document' | 'file'
-
-export interface InboundThreadHistoryEntry {
-  role: 'user' | 'assistant'
-  senderName: string
-  text: string
-  messageId?: string
-}
-
-export interface InboundMedia {
-  type: InboundMediaType
-  fileName?: string
-  mimeType?: string
-  sizeBytes?: number
-  url?: string
-  localPath?: string
-}
-
-export interface InboundMessage {
-  platform: string
-  channelId: string
-  channelIdAlt?: string
-  channelName?: string
-  senderId: string
-  senderIdAlt?: string
-  senderName: string
-  senderAvatarUrl?: string
-  text: string
-  isGroup?: boolean
-  messageId?: string
-  imageUrl?: string
-  media?: InboundMedia[]
-  replyToMessageId?: string
-  threadId?: string
-  threadTitle?: string
-  threadStarterText?: string
-  threadStarterSenderName?: string
-  threadPersonaLabel?: string
-  threadParentChannelId?: string
-  threadParentChannelName?: string
-  threadHistory?: InboundThreadHistoryEntry[]
-  mentionsBot?: boolean
-  agentIdOverride?: string
-  isOwnerConversation?: boolean
-}
-
-export interface OutboundSendOptions {
-  imageUrl?: string
-  fileUrl?: string
-  mediaPath?: string
-  mimeType?: string
-  fileName?: string
-  caption?: string
-  ptt?: boolean
-  replyToMessageId?: string
-  threadId?: string
-}
-
-export interface ExtensionConnectorDefinition {
-  id: string
-  name: string
-  description: string
-  supportsBinaryMedia?: boolean
-  // For sending outbound
-  sendMessage?: (
-    channelId: string,
-    text: string,
-    options?: OutboundSendOptions,
-  ) => Promise<{ messageId?: string } | void>
-  // For polling/listening
-  startListener?: (onMessage: (msg: InboundMessage) => void) => Promise<() => void>
-}
-
-export interface Extension {
-  name: string
-  version?: string
-  description?: string
-  author?: string
-  openclaw?: boolean
-  enabledByDefault?: boolean
-  hooks?: ExtensionHooks
-  tools?: ExtensionToolDef[]
-  ui?: ExtensionUIDefinition
-  providers?: ExtensionProviderDefinition[]
-  connectors?: ExtensionConnectorDefinition[]
-}
-
-export interface ExtensionMeta {
-  name: string
-  description?: string
-  filename: string
-  enabled: boolean
-  isBuiltin?: boolean
-  author?: string
-  version?: string
-  source?: 'local' | 'manual' | 'marketplace'
-  sourceLabel?: ExtensionPublisherSource
-  installSource?: ExtensionInstallSource
-  sourceUrl?: string
-  openclaw?: boolean
-  failureCount?: number
-  lastFailureAt?: number
-  lastFailureStage?: string
-  lastFailureError?: string
-  autoDisabled?: boolean
-  toolCount?: number
-  hookCount?: number
-  hasUI?: boolean
-  providerCount?: number
-  connectorCount?: number
-  createdByAgentId?: string | null
-  settingsFields?: ExtensionSettingsField[]
-  hasDependencyManifest?: boolean
-  dependencyCount?: number
-  devDependencyCount?: number
-  packageManager?: ExtensionPackageManager
-  dependencyInstallStatus?: ExtensionDependencyInstallStatus
-  dependencyInstallError?: string
-  dependencyInstalledAt?: number
-}
-
-export type ExtensionPublisherSource =
-  | 'builtin'
-  | 'local'
-  | 'manual'
-  | 'swarmclaw'
-  | 'swarmforge'
-  | 'clawhub'
-
-export type ExtensionCatalogSource =
-  | 'swarmclaw'
-  | 'swarmclaw-site'
-  | 'swarmforge'
-  | 'clawhub'
-
-export type ExtensionInstallSource =
-  | 'builtin'
-  | 'local'
-  | 'manual'
-  | ExtensionCatalogSource
-
-export type ExtensionPackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun'
-export type ExtensionDependencyInstallStatus = 'none' | 'ready' | 'installing' | 'installed' | 'error'
-
-export interface MarketplaceExtension {
-  id: string
-  name: string
-  description: string
-  author: string
-  version: string
-  url: string
-  source?: ExtensionPublisherSource
-  catalogSource?: ExtensionCatalogSource
-  tags?: string[]
-  openclaw?: boolean
-  downloads?: number
-}
-
-export interface SSEEvent {
-  t: 'd' | 'md' | 'r' | 'done' | 'err' | 'tool_call' | 'tool_result' | 'status' | 'thinking' | 'reset' | 'cr_agent_start' | 'cr_agent_done'
-  text?: string
-  toolName?: string
-  toolInput?: string
-  toolOutput?: string
-  toolCallId?: string
-  agentId?: string
-  agentName?: string
-}
-
-export interface Directory {
-  name: string
-  path: string
-}
-
-export interface DevServerStatus {
-  running: boolean
-  url?: string
-}
-
-export interface DeployResult {
-  ok: boolean
-  output?: string
-  error?: string
-}
-
-export interface UploadResult {
-  path: string
-  size: number
-  url: string
-}
-
-export interface NetworkInfo {
-  ip: string
-  port: number
-}
-
-// --- Agent / Delegation ---
-
-export type AgentRole = 'worker' | 'coordinator'
-export type DelegationTargetMode = 'all' | 'selected'
-
-export interface AgentOrgChart {
-  parentId?: string | null
-  teamLabel?: string | null
-  teamColor?: string | null
-  x?: number | null
-  y?: number | null
-}
-
-export interface Agent {
-  id: string
-  name: string
-  openclawAgentId?: string | null
-  description: string
-  soul?: string
-  identityState?: IdentityContinuityState | null
-  emoji?: string
-  creature?: string
-  vibe?: string
-  theme?: string
-  avatar?: string
-  systemPrompt: string
-  provider: ProviderId
-  model: string
-  ollamaMode?: OllamaMode | null
-  credentialId?: string | null
-  fallbackCredentialIds?: string[]
-  apiEndpoint?: string | null
-  gatewayProfileId?: string | null
-  preferredGatewayTags?: string[]
-  preferredGatewayUseCase?: string | null
-  routingStrategy?: AgentRoutingStrategy | null
-  routingTargets?: AgentRoutingTarget[]
-  role?: AgentRole                // default 'worker' — coordinators get enhanced delegation prompts
-  delegationEnabled?: boolean
-  delegationTargetMode?: DelegationTargetMode
-  delegationTargetAgentIds?: string[]
-  tools?: string[]
-  extensions?: string[]
-  skills?: string[]             // e.g. ['frontend-design'] — pinned Claude Code skills to mention explicitly
-  skillIds?: string[]           // IDs of pinned managed skills to keep always-on for this agent
-  mcpServerIds?: string[]       // IDs of configured MCP servers to inject tools from
-  mcpDisabledTools?: string[]   // MCP tool names disabled for this agent (denylist)
-  orgChart?: AgentOrgChart | null
-  capabilities?: string[]       // e.g. ['frontend', 'screenshots', 'research', 'devops']
-  threadSessionId?: string | null  // persistent shortcut chat session for agent-centric UI
-  heartbeatEnabled?: boolean
-  heartbeatIntervalSec?: number | null
-  heartbeatInterval?: string | number | null
-  heartbeatPrompt?: string | null
-  heartbeatModel?: string | null
-  heartbeatAckMaxChars?: number | null
-  heartbeatShowOk?: boolean | null
-  heartbeatShowAlerts?: boolean | null
-  heartbeatTarget?: 'last' | 'none' | string | null
-  heartbeatGoal?: string | null
-  heartbeatNextAction?: string | null
-  heartbeatLightContext?: boolean | null
-  sessionResetMode?: SessionResetMode | null
-  sessionIdleTimeoutSec?: number | null
-  sessionMaxAgeSec?: number | null
-  sessionDailyResetAt?: string | null
-  sessionResetTimezone?: string | null
-  thinkingLevel?: 'minimal' | 'low' | 'medium' | 'high'
-  memoryScopeMode?: 'auto' | 'all' | 'global' | 'agent' | 'session' | 'project' | null
-  memoryTierPreference?: 'working' | 'durable' | 'archive' | 'blended' | null
-  elevenLabsVoiceId?: string | null
-  projectId?: string
-  avatarSeed?: string
-  avatarUrl?: string | null
-  pinned?: boolean
-  lastUsedAt?: number
-  totalCost?: number
-  disabled?: boolean
-  trashedAt?: number
-  openclawSkillMode?: SkillAllowlistMode
-  openclawAllowedSkills?: string[]
-  walletIds?: string[]
-  activeWalletId?: string | null
-  /** @deprecated Use walletIds + activeWalletId */
-  walletId?: string | null
-  responseStyle?: 'concise' | 'normal' | 'detailed' | null
-  responseMaxChars?: number | null
-  monthlyBudget?: number | null
-  dailyBudget?: number | null
-  hourlyBudget?: number | null
-  autoRecovery?: boolean
-  proactiveMemory?: boolean
-  /** Auto-refresh a reviewed skill draft from meaningful chat turns for this agent. */
-  autoDraftSkillSuggestions?: boolean
-  /** Controls whether file operations are confined to the workspace or allowed anywhere on the host. Default: 'workspace'. */
-  filesystemScope?: 'workspace' | 'machine' | null
-  /** Per-agent filesystem restrictions. Globs matched against resolved paths. */
-  fileAccessPolicy?: {
-    /** If set, only these paths (globs) are writable. Others are blocked. */
-    allowedPaths?: string[]
-    /** These paths (globs) are always blocked even if allowedPaths matches. */
-    blockedPaths?: string[]
-  } | null
-
-  /** Docker container sandbox for shell command execution. */
-  sandboxConfig?: {
-    enabled: boolean
-    mode?: 'off' | 'non-main' | 'all' // default: 'all' when enabled, modeled after OpenClaw
-    scope?: 'session' | 'agent'       // default: 'session'
-    workspaceAccess?: 'ro' | 'rw'     // default: 'rw'
-    image?: string               // default: 'node:22-slim'
-    network?: 'none' | 'bridge'  // default: 'none'
-    memoryMb?: number            // default: 512
-    cpus?: number                // default: 1.0
-    readonlyRoot?: boolean       // default: false
-    workdir?: string             // default: '/workspace'
-    containerPrefix?: string     // default: 'swarmclaw-sb-'
-    pidsLimit?: number           // default: 256
-    setupCommand?: string
-    browser?: {
-      enabled?: boolean
-      image?: string
-      containerPrefix?: string
-      network?: 'none' | 'bridge'
-      cdpPort?: number
-      vncPort?: number
-      noVncPort?: number
-      headless?: boolean
-      enableNoVnc?: boolean
-      mountUploads?: boolean
-      autoStartTimeoutMs?: number
-    } | null
-    prune?: {
-      idleHours?: number
-      maxAgeDays?: number
-    } | null
-  } | null
-
-  budgetAction?: 'warn' | 'block'
-  /** Runtime-enriched: current month's spend. Populated by GET /api/agents when monthlyBudget is set. */
-  monthlySpend?: number
-  /** Runtime-enriched: current day's spend. Populated by GET /api/agents when dailyBudget is set. */
-  dailySpend?: number
-  /** Runtime-enriched: trailing 1-hour spend. Populated by GET /api/agents when hourlyBudget is set. */
-  hourlySpend?: number
-  maxFollowupChain?: number
-
-  // Orchestrator Mode
-  orchestratorEnabled?: boolean
-  orchestratorMission?: string
-  orchestratorWakeInterval?: string | number | null
-  orchestratorGovernance?: 'autonomous' | 'approval-required' | 'notify-only'
-  orchestratorMaxCyclesPerDay?: number | null
-  orchestratorLastWakeAt?: number | null
-  orchestratorCycleCount?: number
-
-  createdAt: number
-  updatedAt: number
-}
-
-// --- Agent Wallets ---
-
-export type WalletChain = 'solana' | 'ethereum'
-
-export interface AgentWallet {
-  id: string
-  agentId: string
-  chain: WalletChain
-  publicKey: string
-  encryptedPrivateKey: string       // AES-256-GCM via encryptKey()
-  label?: string
-  spendingLimitAtomic?: string
-  dailyLimitAtomic?: string
-  /** @deprecated Use spendingLimitAtomic */
-  spendingLimitLamports?: number
-  /** @deprecated Use dailyLimitAtomic */
-  dailyLimitLamports?: number
-  requireApproval: boolean          // default true; can be globally overridden by app settings
-  createdAt: number
-  updatedAt: number
-}
-
-export interface WalletAssetBalance {
-  id: string
-  chain: WalletChain
-  networkId: string
-  networkLabel: string
-  symbol: string
-  name?: string
-  decimals: number
-  balanceAtomic: string
-  balanceFormatted?: string
-  balanceDisplay?: string
-  isNative: boolean
-  contractAddress?: string
-  tokenMint?: string
-  explorerUrl?: string
-}
-
-export interface WalletPortfolioSummary {
-  totalAssets: number
-  nonZeroAssets: number
-  tokenAssets: number
-  networkCount: number
-}
-
-export type WalletTransactionType = 'send' | 'receive' | 'swap'
-export type WalletTransactionStatus = 'pending_approval' | 'pending' | 'confirmed' | 'failed' | 'denied'
-
-export interface WalletTransaction {
-  id: string
-  walletId: string
-  agentId: string
-  chain: WalletChain
-  type: WalletTransactionType
-  signature: string
-  fromAddress: string
-  toAddress: string
-  amountAtomic?: string
-  feeAtomic?: string
-  /** @deprecated Use amountAtomic */
-  amountLamports?: number
-  /** @deprecated Use feeAtomic */
-  feeLamports?: number
-  status: WalletTransactionStatus
-  memo?: string                     // agent's reason for tx
-  approvedBy?: 'user' | 'auto'
-  tokenMint?: string                // null = native chain asset
-  timestamp: number
-}
-
-export interface WalletBalanceSnapshot {
-  id: string
-  walletId: string
-  balanceAtomic?: string
-  /** @deprecated Use balanceAtomic */
-  balanceLamports?: number
-  timestamp: number
-}
-
-export type AgentTool = 'browser'
-
-export interface ClaudeSkill {
-  id: string
-  name: string
-  description: string
-}
-
-export type ScheduleType = 'cron' | 'interval' | 'once'
-export type ScheduleStatus = 'active' | 'paused' | 'completed' | 'failed' | 'archived'
-export type ScheduleTaskMode = 'task' | 'wake_only' | 'protocol'
-
-export interface Schedule {
-  id: string
-  name: string
-  agentId: string
-  projectId?: string
-  taskPrompt: string
-  /** 'task' creates a board task, 'wake_only' just wakes the agent, and 'protocol' launches a structured session run. */
-  taskMode?: ScheduleTaskMode
-  /** Wake message sent to agent when taskMode is 'wake_only' */
-  message?: string
-  /** Structured session template launched when taskMode is 'protocol'. */
-  protocolTemplateId?: string | null
-  protocolParticipantAgentIds?: string[]
-  protocolFacilitatorAgentId?: string | null
-  protocolObserverAgentIds?: string[]
-  protocolConfig?: Record<string, unknown> | null
-  scheduleType: ScheduleType
-  action?: string
-  path?: string
-  command?: string
-  description?: string
-  frequency?: string
-  cron?: string
-  /** Natural time expression e.g. "at 09:00" — resolved to cron on creation */
-  atTime?: string | null
-  intervalMs?: number
-  runAt?: number
-  lastRunAt?: number
-  nextRunAt?: number
-  /** IANA timezone for schedule evaluation (default: system local) */
-  timezone?: string | null
-  /** Random stagger window in seconds added to nextRunAt to avoid thundering herd */
-  staggerSec?: number | null
-  /** Last delivery status for this schedule */
-  lastDeliveryStatus?: 'ok' | 'error' | null
-  /** Timestamp of last delivery attempt */
-  lastDeliveredAt?: number | null
-  /** Error message from last failed delivery */
-  lastDeliveryError?: string | null
-  status: ScheduleStatus
-  archivedAt?: number | null
-  archivedFromStatus?: Exclude<ScheduleStatus, 'archived'> | null
-  linkedTaskId?: string | null
-  linkedMissionId?: string | null
-  runNumber?: number
-  createdByAgentId?: string | null
-  createdInSessionId?: string | null
-  followupConnectorId?: string | null
-  followupChannelId?: string | null
-  followupThreadId?: string | null
-  followupSenderId?: string | null
-  followupSenderName?: string | null
-  createdAt: number
-  updatedAt?: number
-}
-
-export type BrowserSessionStatus = 'active' | 'idle' | 'closed' | 'error'
-
-export interface BrowserSessionTab {
-  index: number
-  title?: string | null
-  url?: string | null
-}
-
-export interface BrowserSessionArtifact {
-  kind: 'snapshot' | 'screenshot' | 'download' | 'pdf'
-  path: string
-  url?: string | null
-  filename?: string | null
-  createdAt: number
-}
-
-export interface BrowserObservationLink {
-  text: string
-  href: string
-}
-
-export interface BrowserObservationFormField {
-  name?: string | null
-  label?: string | null
-  type: string
-  required?: boolean
-}
-
-export interface BrowserObservationForm {
-  index: number
-  action?: string | null
-  method?: string | null
-  fields: BrowserObservationFormField[]
-}
-
-export interface BrowserObservationTable {
-  index: number
-  headers: string[]
-  rowCount: number
-  rows?: string[][]
-}
-
-export interface BrowserObservation {
-  capturedAt: number
-  url?: string | null
-  title?: string | null
-  textPreview?: string | null
-  activeTabIndex?: number | null
-  tabs?: BrowserSessionTab[]
-  links?: BrowserObservationLink[]
-  forms?: BrowserObservationForm[]
-  tables?: BrowserObservationTable[]
-  errors?: string[]
-}
-
-export interface BrowserSandboxRuntimeInfo {
-  scopeKey?: string | null
-  containerName?: string | null
-  cdpEndpoint?: string | null
-  cdpPort?: number | null
-  noVncPort?: number | null
-  bridgeUrl?: string | null
-}
-
-export interface BrowserSessionRecord {
-  id: string
-  sessionId: string
-  profileId: string
-  profileDir: string
-  status: BrowserSessionStatus
-  runtime?: 'host' | 'sandbox-browser' | null
-  sandbox?: BrowserSandboxRuntimeInfo | null
-  inheritedFromSessionId?: string | null
-  currentUrl?: string | null
-  pageTitle?: string | null
-  activeTabIndex?: number | null
-  tabs?: BrowserSessionTab[]
-  lastAction?: string | null
-  lastError?: string | null
-  lastObservation?: BrowserObservation | null
-  artifacts?: BrowserSessionArtifact[]
-  createdAt: number
-  updatedAt: number
-  lastUsedAt: number
-}
-
-export type WatchJobType = 'time' | 'http' | 'file' | 'task' | 'webhook' | 'page' | 'email' | 'mailbox' | 'approval'
-export type WatchJobStatus = 'active' | 'triggered' | 'failed' | 'cancelled'
-
-export interface WatchJob {
-  id: string
-  type: WatchJobType
-  status: WatchJobStatus
-  description?: string | null
-  sessionId?: string | null
-  agentId?: string | null
-  createdByAgentId?: string | null
-  browserProfileId?: string | null
-  resumeMessage: string
-  target: Record<string, unknown>
-  condition: Record<string, unknown>
-  runAt?: number | null
-  nextCheckAt?: number | null
-  intervalMs?: number | null
-  timeoutAt?: number | null
-  lastCheckedAt?: number | null
-  lastTriggeredAt?: number | null
-  lastError?: string | null
-  result?: Record<string, unknown> | null
-  createdAt: number
-  updatedAt: number
-}
-
-export type DelegationJobKind = 'subagent' | 'delegate'
-export type DelegationJobStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled'
-
-export interface DelegationJobCheckpoint {
-  at: number
-  note: string
-  status?: DelegationJobStatus
-}
-
-export interface DelegationJobArtifact {
-  type: 'text' | 'file' | 'image' | 'link'
-  value: string
-  label?: string | null
-}
-
-export interface DelegationJobRecord {
-  id: string
-  kind: DelegationJobKind
-  status: DelegationJobStatus
-  backend?: 'claude' | 'codex' | 'opencode' | 'gemini' | null
-  missionId?: string | null
-  parentMissionId?: string | null
-  parentSessionId?: string | null
-  childSessionId?: string | null
-  agentId?: string | null
-  agentName?: string | null
-  cwd?: string | null
-  task: string
-  result?: string | null
-  resultPreview?: string | null
-  error?: string | null
-  checkpoints?: DelegationJobCheckpoint[]
-  artifacts?: DelegationJobArtifact[]
-  resumeId?: string | null
-  resumeIds?: {
-    claudeCode?: string | null
-    codex?: string | null
-    opencode?: string | null
-    gemini?: string | null
-  }
-  requesterRunId?: string | null
-  childRunId?: string | null
-  createdAt: number
-  updatedAt: number
-  startedAt?: number | null
-  completedAt?: number | null
-}
-
-export interface FileReference {
-  path: string
-  contextSnippet?: string
-  kind?: 'file' | 'folder' | 'project'
-  projectRoot?: string
-  projectName?: string
-  exists?: boolean
-  timestamp: number
-}
-
-export interface MemoryReference {
-  type: 'project' | 'folder' | 'file' | 'task' | 'session' | 'url'
-  path?: string
-  projectRoot?: string
-  projectName?: string
-  title?: string
-  note?: string
-  exists?: boolean
-  timestamp: number
-}
-
-export interface MemoryImage {
-  path: string
-  mimeType?: string
-  width?: number
-  height?: number
-  sizeBytes?: number
-}
-
-export interface MemoryEntry {
-  id: string
-  agentId?: string | null
-  sessionId?: string | null
-  category: string
-  title: string
-  content: string
-  metadata?: Record<string, unknown>
-  references?: MemoryReference[]
-  filePaths?: FileReference[]
-  image?: MemoryImage | null
-  imagePath?: string | null
-  linkedMemoryIds?: string[]
-  pinned?: boolean
-  sharedWith?: string[]
-  accessCount?: number
-  lastAccessedAt?: number
-  contentHash?: string
-  reinforcementCount?: number
-  abstract?: string | null
-  createdAt: number
-  updatedAt: number
-}
-
-export type SessionType = 'human'
-export type AppView = 'home' | 'agents' | 'org_chart' | 'inbox' | 'chatrooms' | 'protocols' | 'schedules' | 'memory' | 'missions' | 'tasks' | 'secrets' | 'providers' | 'skills' | 'connectors' | 'webhooks' | 'mcp_servers' | 'knowledge' | 'extensions' | 'usage' | 'wallets' | 'runs' | 'autonomy' | 'logs' | 'settings' | 'projects' | 'activity'
-
-// --- Chatrooms ---
-
-export interface ChatroomRoutingRule {
-  id: string
-  type: 'keyword' | 'capability'
-  pattern?: string
-  keywords?: string[]
-  agentId: string
-  priority: number
-}
-
-export interface ChatroomMember {
-  agentId: string
-  role: 'admin' | 'moderator' | 'member'
-  mutedUntil?: string
-}
-
-export interface ChatroomReaction {
-  emoji: string
-  reactorId: string   // 'user' or agentId
-  time: number
-}
-
-export interface ChatroomMessage {
-  id: string
-  senderId: string    // 'user' or agentId
-  senderName: string
-  role: 'user' | 'assistant'
-  text: string
-  mentions: string[]  // parsed agentIds
-  reactions: ChatroomReaction[]
-  toolEvents?: MessageToolEvent[]
-  time: number
-  attachedFiles?: string[]
-  imagePath?: string
-  replyToId?: string
-  targetAgentId?: string
-  source?: MessageSource
-  historyExcluded?: boolean
-}
-
-export interface Chatroom {
-  id: string
-  name: string
-  description?: string
-  agentIds: string[]
-  members?: ChatroomMember[]
-  messages: ChatroomMessage[]
-  pinnedMessageIds?: string[]
-  chatMode?: 'sequential' | 'parallel'
-  autoAddress?: boolean
-  routingGuidance?: string | null
-  /** Legacy deterministic routing config kept only for migration/read compatibility. */
-  routingRules?: ChatroomRoutingRule[]
-  temporary?: boolean
-  topic?: string
-  hidden?: boolean
-  archivedAt?: number | null
-  protocolRunId?: string | null
-  parentChatroomId?: string | null
-  createdAt: number
-  updatedAt: number
-}
-
-// --- Structured Session Runs / Protocols ---
-
-export type ProtocolRunStatus = 'draft' | 'running' | 'waiting' | 'paused' | 'completed' | 'failed' | 'cancelled' | 'archived'
-
-export type ProtocolPhaseKind =
-  | 'present'
-  | 'collect_independent_inputs'
-  | 'round_robin'
-  | 'compare'
-  | 'decide'
-  | 'summarize'
-  | 'emit_tasks'
-  | 'wait'
-  | 'dispatch_task'
-  | 'dispatch_delegation'
-
-export interface ProtocolPhaseDefinition {
-  id: string
-  kind: ProtocolPhaseKind
-  label: string
-  instructions?: string | null
-  turnLimit?: number | null
-  completionCriteria?: string | null
-  taskConfig?: { agentId?: string; title: string; description: string } | null
-  delegationConfig?: { agentId: string; message: string } | null
-}
-
-export type ProtocolConditionDefinition =
-  | { type: 'summary_exists' }
-  | { type: 'artifact_exists'; artifactKind?: ProtocolRunArtifact['kind'] | null }
-  | { type: 'artifact_count_at_least'; count: number; artifactKind?: ProtocolRunArtifact['kind'] | null }
-  | { type: 'created_task_count_at_least'; count: number }
-  | { type: 'all'; conditions: ProtocolConditionDefinition[] }
-  | { type: 'any'; conditions: ProtocolConditionDefinition[] }
-
-export interface ProtocolBranchCase {
-  id: string
-  label: string
-  nextStepId: string
-  description?: string | null
-  when?: ProtocolConditionDefinition | null
-}
-
-export interface ProtocolRepeatConfig {
-  bodyStepId: string
-  nextStepId?: string | null
-  maxIterations: number
-  exitCondition?: ProtocolConditionDefinition | null
-  onExhausted?: 'advance' | 'fail'
-}
-
-export interface ProtocolParallelBranchDefinition {
-  id: string
-  label: string
-  steps: ProtocolStepDefinition[]
-  entryStepId?: string | null
-  participantAgentIds?: string[]
-  facilitatorAgentId?: string | null
-  observerAgentIds?: string[]
-}
-
-export interface ProtocolParallelConfig {
-  branches: ProtocolParallelBranchDefinition[]
-}
-
-export interface ProtocolJoinConfig {
-  parallelStepId?: string | null
-}
-
-export type ProtocolStepKind =
-  | ProtocolPhaseKind
-  | 'branch'
-  | 'repeat'
-  | 'parallel'
-  | 'join'
-  | 'complete'
-  | 'for_each'
-  | 'subflow'
-  | 'swarm_claim'
-
-export interface ProtocolStepDefinition {
-  id: string
-  kind: ProtocolStepKind
-  label: string
-  instructions?: string | null
-  turnLimit?: number | null
-  completionCriteria?: string | null
-  taskConfig?: { agentId?: string; title: string; description: string } | null
-  delegationConfig?: { agentId: string; message: string } | null
-  nextStepId?: string | null
-  branchCases?: ProtocolBranchCase[]
-  defaultNextStepId?: string | null
-  repeat?: ProtocolRepeatConfig | null
-  parallel?: ProtocolParallelConfig | null
-  join?: ProtocolJoinConfig | null
-  dependsOnStepIds?: string[]
-  outputKey?: string | null
-  forEach?: ProtocolForEachConfig | null
-  subflow?: ProtocolSubflowConfig | null
-  swarm?: ProtocolSwarmConfig | null
-}
-
-export interface ProtocolTemplate {
-  id: string
-  name: string
-  description: string
-  builtIn: boolean
-  singleAgentAllowed?: boolean
-  tags?: string[]
-  recommendedOutputs?: string[]
-  defaultPhases: ProtocolPhaseDefinition[]
-  steps?: ProtocolStepDefinition[]
-  entryStepId?: string | null
-  createdAt?: number
-  updatedAt?: number
-}
-
-export type ProtocolSourceRef =
-  | { kind: 'manual' }
-  | { kind: 'api' }
-  | { kind: 'session'; sessionId: string }
-  | { kind: 'chatroom'; chatroomId: string }
-  | { kind: 'mission'; missionId: string }
-  | { kind: 'task'; taskId: string }
-  | { kind: 'schedule'; scheduleId: string }
-  | { kind: 'protocol_run'; runId: string; parentRunId?: string | null; stepId?: string | null; branchId?: string | null }
-
-export interface ProtocolRunArtifact {
-  id: string
-  kind: 'summary' | 'decision' | 'comparison' | 'notes' | 'action_items'
-  title: string
-  content: string
-  phaseId?: string | null
-  taskIds?: string[]
-  createdAt: number
-}
-
-export interface ProtocolRunPhaseStateResponse {
-  agentId: string
-  text: string
-  toolEvents?: MessageToolEvent[]
-}
-
-export interface ProtocolRunPhaseState {
-  phaseId: string
-  respondedAgentIds?: string[]
-  responses?: ProtocolRunPhaseStateResponse[]
-  appendedToTranscript?: boolean
-  artifactId?: string | null
-  dispatchedTaskId?: string | null
-}
-
-export interface ProtocolRunLoopState {
-  stepId: string
-  iterationCount: number
-}
-
-export interface ProtocolRunBranchDecision {
-  stepId: string
-  caseId?: string | null
-  nextStepId?: string | null
-  decidedAt: number
-}
-
-export interface ProtocolRunParallelBranchState {
-  branchId: string
-  label: string
-  runId: string
-  status: ProtocolRunStatus
-  participantAgentIds?: string[]
-  summary?: string | null
-  lastError?: string | null
-  updatedAt: number
-}
-
-export interface ProtocolRunParallelStepState {
-  stepId: string
-  branchRunIds: string[]
-  branches: ProtocolRunParallelBranchState[]
-  waitingOnBranchIds?: string[]
-  joinReady?: boolean
-  joinCompletedAt?: number | null
-}
-
-// --- DAG Step State ---
-
-export type ProtocolRunStepStatus = 'pending' | 'ready' | 'running' | 'waiting' | 'completed' | 'failed' | 'skipped'
-
-export interface ProtocolRunStepState {
-  stepId: string
-  status: ProtocolRunStepStatus
-  startedAt?: number | null
-  completedAt?: number | null
-  error?: string | null
-}
-
-export interface ProtocolRunStepOutput {
-  stepId: string
-  outputKey?: string | null
-  summary?: string | null
-  artifactIds?: string[]
-  taskIds?: string[]
-  childRunIds?: string[]
-  structuredData?: Record<string, unknown> | null
-}
-
-// --- For-Each Config ---
-
-export interface ProtocolForEachConfig {
-  itemsSource:
-    | { type: 'literal'; items: unknown[] }
-    | { type: 'step_output'; stepId: string; path?: string | null }
-    | { type: 'artifact'; artifactId?: string | null; artifactKind?: string | null }
-    | { type: 'llm_extract'; prompt: string }
-  itemAlias: string
-  branchTemplate: {
-    steps: ProtocolStepDefinition[]
-    entryStepId?: string | null
-    participantAgentIds?: string[]
-    facilitatorAgentId?: string | null
-  }
-  joinMode: 'all'
-  maxItems?: number | null
-  onEmpty?: 'fail' | 'skip' | 'advance'
-}
-
-export interface ProtocolRunForEachStepState {
-  stepId: string
-  items: unknown[]
-  branchRunIds: string[]
-  branches: ProtocolRunParallelBranchState[]
-  waitingOnBranchIds?: string[]
-  joinReady?: boolean
-  joinCompletedAt?: number | null
-}
-
-// --- Subflow Config ---
-
-export interface ProtocolSubflowConfig {
-  templateId: string
-  templateVersion?: string | null
-  participantAgentIds?: string[]
-  facilitatorAgentId?: string | null
-  inputMapping?: Record<string, string> | null
-  outputMapping?: Record<string, string> | null
-  onFailure: 'fail_parent' | 'advance_with_warning'
-}
-
-export interface ProtocolRunSubflowState {
-  stepId: string
-  childRunId: string
-  templateId: string
-  status: ProtocolRunStatus
-  summary?: string | null
-  lastError?: string | null
-  startedAt?: number | null
-  completedAt?: number | null
-}
-
-// --- Swarm Config ---
-
-export interface ProtocolSwarmConfig {
-  eligibleAgentIds: string[]
-  workItemsSource:
-    | { type: 'literal'; items: Array<{ id: string; label: string; description?: string | null }> }
-    | { type: 'step_output'; stepId: string; path?: string | null }
-  claimLimitPerAgent?: number | null
-  selectionMode: 'first_claim' | 'claim_until_empty'
-  claimTimeoutSec: number
-  onUnclaimed: 'fail' | 'advance' | 'fallback_assign'
-}
-
-export interface ProtocolSwarmClaim {
-  id: string
-  workItemId: string
-  workItemLabel: string
-  agentId: string
-  childRunId?: string | null
-  taskId?: string | null
-  status: 'claimed' | 'running' | 'completed' | 'failed'
-  claimedAt: number
-  completedAt?: number | null
-}
-
-export interface ProtocolRunSwarmState {
-  stepId: string
-  workItems: Array<{ id: string; label: string; description?: string | null }>
-  claims: ProtocolSwarmClaim[]
-  unclaimedItemIds: string[]
-  eligibleAgentIds: string[]
-  claimLimitPerAgent: number
-  selectionMode: 'first_claim' | 'claim_until_empty'
-  claimTimeoutSec: number
-  openedAt: number
-  closedAt?: number | null
-  timedOut?: boolean
-}
-
-export interface ProtocolRunConfig {
-  goal?: string | null
-  kickoffMessage?: string | null
-  roundLimit?: number | null
-  decisionMode?: string | null
-  createTranscript?: boolean
-  autoEmitTasks?: boolean
-  taskProjectId?: string | null
-  postSummaryToParent?: boolean
-}
-
-export interface ProtocolRun {
-  id: string
-  title: string
-  templateId: string
-  templateName: string
-  status: ProtocolRunStatus
-  sourceRef: ProtocolSourceRef
-  participantAgentIds: string[]
-  facilitatorAgentId?: string | null
-  observerAgentIds?: string[]
-  missionId?: string | null
-  taskId?: string | null
-  sessionId?: string | null
-  parentRunId?: string | null
-  parentStepId?: string | null
-  branchId?: string | null
-  parentChatroomId?: string | null
-  transcriptChatroomId?: string | null
-  scheduleId?: string | null
-  systemOwned?: boolean
-  phases: ProtocolPhaseDefinition[]
-  steps?: ProtocolStepDefinition[]
-  entryStepId?: string | null
-  currentStepId?: string | null
-  config?: ProtocolRunConfig | null
-  currentPhaseIndex: number
-  roundNumber?: number
-  summary?: string | null
-  latestArtifactId?: string | null
-  artifacts?: ProtocolRunArtifact[]
-  createdTaskIds?: string[]
-  waitingReason?: string | null
-  pauseReason?: string | null
-  lastError?: string | null
-  operatorContext?: string[]
-  phaseState?: ProtocolRunPhaseState | null
-  loopState?: Record<string, ProtocolRunLoopState>
-  branchHistory?: ProtocolRunBranchDecision[]
-  parallelState?: Record<string, ProtocolRunParallelStepState>
-  stepState?: Record<string, ProtocolRunStepState>
-  completedStepIds?: string[]
-  runningStepIds?: string[]
-  readyStepIds?: string[]
-  failedStepIds?: string[]
-  stepOutputs?: Record<string, ProtocolRunStepOutput>
-  forEachState?: Record<string, ProtocolRunForEachStepState>
-  subflowState?: Record<string, ProtocolRunSubflowState>
-  swarmState?: Record<string, ProtocolRunSwarmState>
-  createdAt: number
-  updatedAt: number
-  startedAt?: number | null
-  endedAt?: number | null
-  archivedAt?: number | null
-}
-
-export interface ProtocolRunEvent {
-  id: string
-  runId: string
-  type:
-    | 'created'
-    | 'phase_started'
-    | 'phase_completed'
-    | 'participant_response'
-    | 'artifact_emitted'
-    | 'task_emitted'
-    | 'waiting'
-    | 'paused'
-    | 'resumed'
-    | 'phase_skipped'
-    | 'phase_retried'
-    | 'context_injected'
-    | 'recovered'
-    | 'step_started'
-    | 'step_completed'
-    | 'branch_taken'
-    | 'parallel_started'
-    | 'parallel_branch_spawned'
-    | 'parallel_branch_completed'
-    | 'parallel_branch_failed'
-    | 'join_ready'
-    | 'join_completed'
-    | 'loop_iteration_started'
-    | 'loop_iteration_completed'
-    | 'loop_exhausted'
-    | 'completed'
-    | 'failed'
-    | 'warning'
-    | 'cancelled'
-    | 'task_dispatched'
-    | 'delegation_dispatched'
-    | 'archived'
-    | 'summary_posted'
-    | 'step_ready'
-    | 'step_waiting'
-    | 'step_failed'
-    | 'for_each_expanded'
-    | 'subflow_started'
-    | 'subflow_completed'
-    | 'subflow_failed'
-    | 'swarm_opened'
-    | 'swarm_claimed'
-    | 'swarm_exhausted'
-  summary: string
-  phaseId?: string | null
-  stepId?: string | null
-  agentId?: string | null
-  artifactId?: string | null
-  taskId?: string | null
-  createdAt: number
-  data?: Record<string, unknown> | null
-}
-
-// --- Activity / Audit Trail ---
-
-export interface ActivityEntry {
-  id: string
-  entityType: 'agent' | 'task' | 'connector' | 'session' | 'webhook' | 'schedule' | 'delegation' | 'swarm' | 'chatroom' | 'coordination'
-  entityId: string
-  action: 'created' | 'updated' | 'deleted' | 'started' | 'stopped' | 'queued' | 'completed' | 'failed' | 'archived' | 'restored' | 'approved' | 'rejected' | 'delegated' | 'queried' | 'spawned' | 'timeout' | 'cancelled' | 'incident' | 'running' | 'claimed'
-  actor: 'user' | 'agent' | 'system' | 'daemon'
-  actorId?: string
-  summary: string
-  detail?: Record<string, unknown>
-  timestamp: number
-}
-
-// --- Webhook Retry Queue ---
-
-export interface WebhookRetryEntry {
-  id: string
-  webhookId: string
-  event: string
-  payload: string
-  attempts: number
-  maxAttempts: number
-  nextRetryAt: number
-  deadLettered: boolean
-  createdAt: number
-}
-
-export interface Project {
-  id: string
-  name: string
-  description: string
-  color?: string
-  objective?: string
-  audience?: string
-  priorities?: string[]
-  openObjectives?: string[]
-  capabilityHints?: string[]
-  credentialRequirements?: string[]
-  successMetrics?: string[]
-  heartbeatPrompt?: string
-  heartbeatIntervalSec?: number
-  createdAt: number
-  updatedAt: number
-}
-
-// --- Notifications ---
-
-export interface AppNotification {
-  id: string
-  type: 'info' | 'success' | 'warning' | 'error'
-  title: string
-  message?: string
-  actionLabel?: string
-  actionUrl?: string
-  entityType?: string
-  entityId?: string
-  dedupKey?: string
-  read: boolean
-  createdAt: number
-  updatedAt?: number
-  occurrenceCount?: number
-}
-
-// --- Session Runs ---
-
-export type SessionRunStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled'
-export type ExecutionKind =
-  | 'session_turn'
-  | 'task_attempt'
-  | 'protocol_step'
-  | 'heartbeat_tick'
-  | 'schedule_wake'
-  | 'repair_turn'
-  | 'subagent_turn'
-
-export type ExecutionOwnerType =
-  | 'session'
-  | 'task'
-  | 'protocol_run'
-  | 'schedule'
-  | 'mission'
-  | 'agent'
-  | 'subagent'
-
-export interface SessionRunHeartbeatConfig {
-  ackMaxChars: number
-  showOk: boolean
-  showAlerts: boolean
-  target: string | null
-  deliveryMode?: 'default' | 'tool_only' | 'silent'
-  lightContext?: boolean
-}
-
-export interface SessionRunRecoveryPayload {
-  message: string
-  imagePath?: string
-  imageUrl?: string
-  attachedFiles?: string[]
-  internal: boolean
-  source: string
-  mode: string
-  maxRuntimeMs?: number
-  modelOverride?: string
-  heartbeatConfig?: SessionRunHeartbeatConfig
-  replyToId?: string
-  executionGroupKey?: string
-}
-
-export interface SessionRunRecord {
-  id: string
-  sessionId: string
-  missionId?: string | null
-  kind?: ExecutionKind
-  ownerType?: ExecutionOwnerType | null
-  ownerId?: string | null
-  parentExecutionId?: string | null
-  recoveryPolicy?: 'restart_recoverable' | 'ephemeral' | 'manual' | 'none'
-  source: string
-  internal: boolean
-  mode: string
-  status: SessionRunStatus
-  messagePreview: string
-  dedupeKey?: string
-  queuedAt: number
-  startedAt?: number
-  endedAt?: number
-  interruptedAt?: number
-  interruptedReason?: string
-  error?: string
-  resultPreview?: string
-  recoveredFromRestart?: boolean
-  recoveredFromRunId?: string
-  recoveryPayload?: SessionRunRecoveryPayload
-  totalInputTokens?: number
-  totalOutputTokens?: number
-  estimatedCost?: number
-}
-
-export interface SessionQueuedTurn {
-  runId: string
-  sessionId: string
-  missionId?: string | null
-  text: string
-  queuedAt: number
-  position: number
-  imagePath?: string
-  imageUrl?: string
-  attachedFiles?: string[]
-  replyToId?: string
-  source?: string
-}
-
-export interface SessionQueueSnapshot {
-  sessionId: string
-  activeRunId: string | null
-  queueLength: number
-  items: SessionQueuedTurn[]
-}
-
-export interface RunEventRecord {
-  id: string
-  runId: string
-  sessionId: string
-  kind?: ExecutionKind
-  ownerType?: ExecutionOwnerType | null
-  ownerId?: string | null
-  parentExecutionId?: string | null
-  timestamp: number
-  phase: 'status' | 'event'
-  status?: SessionRunStatus
-  summary?: string
-  event: SSEEvent
-}
-
-export type RuntimeFailureFamily =
-  | 'provider_auth'
-  | 'provider_transport'
-  | 'gateway_disconnected'
-  | 'browser_boot'
-  | 'cli_missing'
-  | 'rate_limit'
-  | 'webhook_delivery'
-  | 'connector_delivery'
-  | 'workspace_recovery'
-
-export type SupervisorIncidentKind =
-  | 'run_error'
-  | 'repeated_tool'
-  | 'no_progress'
-  | 'budget_pressure'
-  | 'context_pressure'
-  | 'runtime_failure'
-
-export type SupervisorIncidentSeverity = 'low' | 'medium' | 'high'
-
-export interface SupervisorIncident {
-  id: string
-  runId: string
-  sessionId: string
-  taskId?: string | null
-  agentId?: string | null
-  source: string
-  kind: SupervisorIncidentKind
-  severity: SupervisorIncidentSeverity
-  summary: string
-  details?: string | null
-  toolName?: string | null
-  failureFamily?: RuntimeFailureFamily | null
-  remediation?: string | null
-  repairPrompt?: string | null
-  autoAction?: 'replan' | 'compact' | 'block' | 'budget_trim' | null
-  createdAt: number
-}
-
-export interface RunReflection {
-  id: string
-  runId: string
-  sessionId: string
-  taskId?: string | null
-  agentId?: string | null
-  source: string
-  status: SessionRunStatus | 'completed' | 'failed'
-  summary: string
-  sourceSnippet?: string | null
-  invariantNotes: string[]
-  derivedNotes: string[]
-  failureNotes: string[]
-  lessonNotes: string[]
-  communicationNotes?: string[]
-  relationshipNotes?: string[]
-  significantEventNotes?: string[]
-  profileNotes?: string[]
-  boundaryNotes?: string[]
-  openLoopNotes?: string[]
-  incidentIds?: string[]
-  autoMemoryIds?: string[]
-  learnedSkillIds?: string[]
-  learnedSkillNotes?: string[]
-  qualityScore?: number | null
-  qualityReasoning?: string | null
-  createdAt: number
-  updatedAt: number
-}
-
-// --- Webhook Logs ---
-
-export interface WebhookLogEntry {
-  id: string
-  webhookId: string
-  event: string
-  payload: string
-  status: 'success' | 'error'
-  sessionId?: string
-  runId?: string
-  error?: string
-  timestamp: number
-}
-
-// --- App Settings ---
-export type LoopMode = 'bounded' | 'ongoing'
-export type AutonomyEstopLevel = 'none' | 'autonomy' | 'all'
-
-export interface GoalContract {
-  objective: string
-  constraints?: string[]
-  budgetUsd?: number | null
-  deadlineAt?: number | null
-  successMetric?: string | null
-}
-
-export interface AppSettings {
-  userPrompt?: string
-  userName?: string
-  setupCompleted?: boolean
-  embeddingProvider?: 'local' | 'openai' | 'ollama' | null
-  embeddingModel?: string | null
-  embeddingCredentialId?: string | null
-  embeddingEndpoint?: string | null
-  loopMode?: LoopMode
-  agentLoopRecursionLimit?: number
-  delegationMaxDepth?: number
-  ongoingLoopMaxIterations?: number
-  ongoingLoopMaxRuntimeMinutes?: number
-  maxFollowupChain?: number
-  shellCommandTimeoutSec?: number
-  claudeCodeTimeoutSec?: number
-  cliProcessTimeoutSec?: number
-  streamIdleStallSec?: number
-  requiredToolKickoffSec?: number
-  userAvatarSeed?: string
-  elevenLabsEnabled?: boolean
-  elevenLabsApiKey?: string | null
-  elevenLabsApiKeyConfigured?: boolean
-  elevenLabsVoiceId?: string | null
-  speechRecognitionLang?: string | null
-  tavilyApiKey?: string | null
-  tavilyApiKeyConfigured?: boolean
-  braveApiKey?: string | null
-  braveApiKeyConfigured?: boolean
-  heartbeatPrompt?: string | null
-  heartbeatIntervalSec?: number | null
-  heartbeatInterval?: string | number | null
-  heartbeatModel?: string | null
-  heartbeatAckMaxChars?: number | null
-  heartbeatShowOk?: boolean | null
-  heartbeatShowAlerts?: boolean | null
-  heartbeatTarget?: 'last' | 'none' | string | null
-  heartbeatActiveStart?: string | null
-  heartbeatActiveEnd?: string | null
-  heartbeatTimezone?: string | null
-  heartbeatLightContext?: boolean | null
-  sessionResetMode?: SessionResetMode | null
-  sessionIdleTimeoutSec?: number | null
-  sessionMaxAgeSec?: number | null
-  sessionDailyResetAt?: string | null
-  sessionResetTimezone?: string | null
-  untrustedContentGuardMode?: 'off' | 'warn' | 'block'
-  // Task resiliency and supervision
-  defaultTaskMaxAttempts?: number
-  taskRetryBackoffSec?: number
-  taskStallTimeoutMin?: number
-  // Safety rails
-  safetyRequireApprovalForOutbound?: boolean
-  safetyMaxDailySpendUsd?: number | null
-  safetyBlockedTools?: string[]
-  walletApprovalsEnabled?: boolean
-  capabilityPolicyMode?: 'permissive' | 'balanced' | 'strict'
-  capabilityBlockedTools?: string[]
-  capabilityBlockedCategories?: string[]
-  capabilityAllowedTools?: string[]
-  taskManagementEnabled?: boolean
-  projectManagementEnabled?: boolean
-  // Memory governance
-  memoryWorkingTtlHours?: number
-  memoryDefaultConfidence?: number
-  memoryPruneEnabled?: boolean
-  memorySummaryEnabled?: boolean
-  // Capability router preferences
-  autonomyPreferredDelegates?: Array<'claude' | 'codex' | 'opencode'>
-  autonomyPreferToolRouting?: boolean
-  // Continuous eval
-  autonomyEvalEnabled?: boolean
-  autonomyEvalCron?: string | null
-  supervisorEnabled?: boolean
-  supervisorRuntimeScope?: 'chat' | 'task' | 'both'
-  supervisorNoProgressLimit?: number
-  supervisorRepeatedToolLimit?: number
-  autonomyResumeApprovalsEnabled?: boolean
-  missionHumanLoopEnabled?: boolean
-  reflectionEnabled?: boolean
-  reflectionAutoWriteMemory?: boolean
-  memoryReferenceDepth?: number
-  maxMemoriesPerLookup?: number
-  maxLinkedMemoriesExpanded?: number
-  memoryMaxDepth?: number
-  memoryMaxPerLookup?: number
-  // Chat UX
-  suggestionsEnabled?: boolean
-  runtimeSkillRetrievalMode?: 'keyword' | 'embedding'
-  runtimeSkillTopK?: number
-  // Globally approved WhatsApp contacts for connector DMs
-  whatsappApprovedContacts?: WhatsAppApprovedContact[]
-  // Voice conversation
-  voiceAutoSendDelaySec?: number
-  // Default agent for main chat on startup
-  defaultAgentId?: string | null
-  // Theme
-  themeHue?: string
-  // Web search provider
-  webSearchProvider?: 'duckduckgo' | 'google' | 'bing' | 'searxng' | 'tavily' | 'brave'
-  searxngUrl?: string
-  // Task custom field definitions
-  taskCustomFieldDefs?: Array<{ key: string; label: string; type: 'text' | 'number' | 'select'; options?: string[] }>
-  // OpenClaw sync settings
-  openclawWorkspacePath?: string | null
-  openclawAutoSyncMemory?: boolean
-  openclawAutoSyncSchedules?: boolean
-  // Outbound ops alert webhook
-  alertWebhookUrl?: string | null
-  alertWebhookType?: 'discord' | 'slack' | 'custom' | null
-  alertWebhookEvents?: ('error' | 'warning')[]
-  // Deterministic LLM response cache
-  responseCacheEnabled?: boolean
-  responseCacheTtlSec?: number
-  responseCacheMaxEntries?: number
-  // Task quality gate defaults
-  taskQualityGateEnabled?: boolean
-  taskQualityGateMinResultChars?: number
-  taskQualityGateMinEvidenceItems?: number
-  taskQualityGateRequireVerification?: boolean
-  taskQualityGateRequireArtifact?: boolean
-  taskQualityGateRequireReport?: boolean
-  // Integrity monitor
-  integrityMonitorEnabled?: boolean
-  // Background daemon
-  daemonAutostartEnabled?: boolean
-  // Tool loop detection thresholds
-  toolLoopFrequencyWarn?: number
-  toolLoopFrequencyCritical?: number
-  toolLoopCircuitBreaker?: number
-  // Per-extension settings (keyed by extensionId)
-  extensionSettings?: Record<string, Record<string, unknown>>
-}
-
-export interface WhatsAppApprovedContact {
-  id: string
-  label: string
-  phone: string
-}
-
-// --- Agent Secrets ---
-
-export interface StoredSecret {
-  id: string
-  name: string
-  service: string           // e.g. 'gmail', 'ahrefs', 'custom'
-  encryptedValue: string
-  scope: 'global' | 'agent'
-  agentIds: string[]      // if scope === 'agent', which agents can use it
-  projectId?: string
-  createdAt: number
-  updatedAt: number
-}
-
-// --- Task Board ---
-
-export type BoardTaskStatus = 'backlog' | 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'archived' | 'deferred'
-
-export interface TaskComment {
-  id: string
-  author: string         // agent name or 'user'
-  agentId?: string     // if from an agent
-  text: string
-  createdAt: number
-}
-
-export interface TaskQualityGateConfig {
-  enabled?: boolean
-  minResultChars?: number
-  minEvidenceItems?: number
-  requireVerification?: boolean
-  requireArtifact?: boolean
-  requireReport?: boolean
-}
-
-// --- Custom Providers ---
-
-export interface ProviderConfig {
-  id: string
-  name: string
-  type: 'builtin' | 'custom'
-  baseUrl?: string
-  models: string[]
-  requiresApiKey: boolean
-  credentialId?: string | null
-  isEnabled: boolean
-  createdAt: number
-  updatedAt: number
-}
-
-// --- Gateways ---
-
-export type GatewayProvider = 'openclaw'
-export type GatewayHealthState = 'unknown' | 'healthy' | 'degraded' | 'offline' | 'pending'
-export type OpenClawDeploymentMethod = 'local' | 'bundle' | 'ssh' | 'imported'
-export type OpenClawDeploymentProvider =
-  | 'local'
-  | 'hetzner'
-  | 'digitalocean'
-  | 'vultr'
-  | 'linode'
-  | 'lightsail'
-  | 'gcp'
-  | 'azure'
-  | 'oci'
-  | 'generic'
-  | 'render'
-  | 'fly'
-  | 'railway'
-export type OpenClawRemoteDeployTarget = 'docker' | 'render' | 'fly' | 'railway'
-export type OpenClawUseCaseTemplate = 'local-dev' | 'single-vps' | 'private-tailnet' | 'browser-heavy' | 'team-control'
-export type OpenClawExposurePreset = 'private-lan' | 'tailscale' | 'caddy' | 'nginx' | 'ssh-tunnel'
-
-export interface OpenClawGatewayStats {
-  nodeCount?: number
-  connectedNodeCount?: number
-  pendingNodePairings?: number
-  pairedDeviceCount?: number
-  pendingDevicePairings?: number
-  externalRuntimeCount?: number
-}
-
-export interface OpenClawDeploymentConfig {
-  method?: OpenClawDeploymentMethod | null
-  provider?: OpenClawDeploymentProvider | null
-  remoteTarget?: OpenClawRemoteDeployTarget | null
-  useCase?: OpenClawUseCaseTemplate | null
-  exposure?: OpenClawExposurePreset | null
-  managedBy?: 'swarmclaw' | 'manual' | null
-  localInstanceId?: string | null
-  localPort?: number | null
-  targetHost?: string | null
-  sshHost?: string | null
-  sshUser?: string | null
-  sshPort?: number | null
-  sshKeyPath?: string | null
-  sshTargetDir?: string | null
-  image?: string | null
-  version?: string | null
-  lastDeployAt?: number | null
-  lastDeployAction?: string | null
-  lastDeployProcessId?: string | null
-  lastDeploySummary?: string | null
-  lastVerifiedAt?: number | null
-  lastVerifiedOk?: boolean | null
-  lastVerifiedMessage?: string | null
-  lastBackupPath?: string | null
-}
-
-export interface GatewayProfile {
-  id: string
-  name: string
-  provider: GatewayProvider
-  endpoint: string
-  wsUrl?: string | null
-  credentialId?: string | null
-  status: GatewayHealthState
-  notes?: string | null
-  tags?: string[]
-  lastError?: string | null
-  lastCheckedAt?: number | null
-  lastModelCount?: number | null
-  discoveredHost?: string | null
-  discoveredPort?: number | null
-  deployment?: OpenClawDeploymentConfig | null
-  stats?: OpenClawGatewayStats | null
-  isDefault?: boolean
-  createdAt: number
-  updatedAt: number
-}
-
-export interface OpenClawNode {
-  nodeId: string
-  displayName?: string
-  platform?: string
-  version?: string
-  coreVersion?: string
-  uiVersion?: string
-  deviceFamily?: string
-  modelIdentifier?: string
-  remoteIp?: string
-  caps?: string[]
-  commands?: string[]
-  pathEnv?: string[]
-  permissions?: string[]
-  connectedAtMs?: number
-  paired?: boolean
-  connected?: boolean
-}
-
-export interface OpenClawNodePairRequest {
-  requestId: string
-  nodeId?: string
-  displayName?: string
-  platform?: string
-  remoteIp?: string
-  createdAtMs?: number
-}
-
-export interface OpenClawPairedDevice {
-  deviceId: string
-  displayName?: string
-  role?: string
-  remoteIp?: string
-  platform?: string
-  tokens?: Array<{ role?: string; scopes?: string[]; createdAtMs?: number; rotatedAtMs?: number; revokedAtMs?: number }>
-}
-
-export interface OpenClawDevicePairRequest {
-  requestId: string
-  deviceId?: string
-  displayName?: string
-  role?: string
-  platform?: string
-  remoteIp?: string
-  createdAtMs?: number
-}
-
-export interface OpenClawPairingSnapshot {
-  pending?: OpenClawDevicePairRequest[]
-  paired?: OpenClawPairedDevice[]
-}
-
-// --- Agent Routing / Packs ---
-
-export type AgentRoutingStrategy = 'single' | 'balanced' | 'economy' | 'premium' | 'reasoning'
-export type AgentRoutingTargetRole = 'primary' | 'economy' | 'premium' | 'reasoning' | 'backup'
-
-export interface AgentRoutingTarget {
-  id: string
-  label?: string
-  role?: AgentRoutingTargetRole
-  provider: ProviderId
-  model: string
-  ollamaMode?: OllamaMode | null
-  credentialId?: string | null
-  fallbackCredentialIds?: string[]
-  apiEndpoint?: string | null
-  gatewayProfileId?: string | null
-  preferredGatewayTags?: string[]
-  preferredGatewayUseCase?: string | null
-  priority?: number
-}
-
-export interface AgentPackEntry {
-  id: string
-  name: string
-  description?: string
-  provider: ProviderId
-  model: string
-  ollamaMode?: OllamaMode | null
-  credentialId?: string | null
-  fallbackCredentialIds?: string[]
-  apiEndpoint?: string | null
-  gatewayProfileId?: string | null
-  routingStrategy?: AgentRoutingStrategy | null
-  routingTargets?: AgentRoutingTarget[]
-  tools?: string[]
-  extensions?: string[]
-  capabilities?: string[]
-  elevenLabsVoiceId?: string | null
-  soul?: string
-  systemPrompt?: string
-}
-
-export interface AgentPackManifest {
-  schemaVersion: 1
-  kind: 'swarmclaw-agent-pack'
-  name: string
-  description?: string
-  exportedAt: number
-  recommendedProviders?: ProviderType[]
-  agents: AgentPackEntry[]
-}
-
-// --- External Agents ---
-
-export type ExternalAgentSourceType = 'codex' | 'claude' | 'opencode' | 'openclaw' | 'custom'
-export type ExternalAgentStatus = 'online' | 'idle' | 'offline' | 'stale'
-
-export interface ExternalAgentRuntime {
-  id: string
-  name: string
-  sourceType: ExternalAgentSourceType
-  status: ExternalAgentStatus
-  provider?: ProviderId | null
-  model?: string | null
-  workspace?: string | null
-  transport?: 'http' | 'ws' | 'cli' | 'gateway' | 'custom' | null
-  endpoint?: string | null
-  agentId?: string | null
-  gatewayProfileId?: string | null
-  capabilities?: string[]
-  labels?: string[]
-  lifecycleState?: 'active' | 'draining' | 'cordoned'
-  gatewayTags?: string[]
-  gatewayUseCase?: string | null
-  version?: string | null
-  lastHealthNote?: string | null
-  metadata?: Record<string, unknown> | null
-  tokenStats?: {
-    inputTokens?: number
-    outputTokens?: number
-    totalTokens?: number
-  } | null
-  lastHeartbeatAt?: number | null
-  lastSeenAt?: number | null
-  createdAt: number
-  updatedAt: number
-}
-
-// --- Skills ---
-
-export interface Skill {
-  id: string
-  name: string
-  filename: string
-  content: string
-  projectId?: string
-  description?: string
-  sourceUrl?: string
-  sourceFormat?: 'openclaw' | 'plain'
-  author?: string
-  tags?: string[]
-  version?: string
-  homepage?: string
-  primaryEnv?: string | null
-  skillKey?: string | null
-  toolNames?: string[]
-  capabilities?: string[]
-  always?: boolean
-  installOptions?: SkillInstallOption[]
-  skillRequirements?: SkillRequirements
-  detectedEnvVars?: string[]
-  security?: SkillSecuritySummary | null
-  invocation?: SkillInvocationConfig | null
-  commandDispatch?: SkillCommandDispatch | null
-  frontmatter?: Record<string, unknown> | null
-  scope?: 'global' | 'agent'
-  agentIds?: string[]
-  createdAt: number
-  updatedAt: number
-}
-
-export type LearnedSkillScope = 'agent' | 'session'
-export type LearnedSkillLifecycle = 'candidate' | 'active' | 'shadow' | 'demoted' | 'review_ready'
-export type LearnedSkillSourceKind = 'success_pattern' | 'failure_repair'
-export type LearnedSkillValidationStatus = 'pending' | 'passed' | 'failed'
-export type LearnedSkillRiskLevel = 'low' | 'medium' | 'high'
-
-export interface LearnedSkill {
-  id: string
-  parentSkillId?: string | null
-  agentId: string
-  userId?: string | null
-  sessionId?: string | null
-  scope: LearnedSkillScope
-  lifecycle: LearnedSkillLifecycle
-  sourceKind: LearnedSkillSourceKind
-  workflowKey: string
-  failureFamily?: string | null
-  objectiveSummary?: string | null
-  name?: string | null
-  description?: string | null
-  content?: string | null
-  tags?: string[]
-  rationale?: string | null
-  confidence?: number | null
-  riskLevel?: LearnedSkillRiskLevel | null
-  validationStatus: LearnedSkillValidationStatus
-  validationSummary?: string | null
-  validationEvidenceCount?: number
-  evidenceCount?: number
-  activationCount?: number
-  successCount?: number
-  failureCount?: number
-  consecutiveSuccessCount?: number
-  consecutiveFailureCount?: number
-  lastSourceHash?: string | null
-  lastUsedAt?: number | null
-  lastSucceededAt?: number | null
-  lastFailedAt?: number | null
-  demotedAt?: number | null
-  demotionReason?: string | null
-  retryUnlockedAt?: number | null
-  retryUnlockedByReflectionId?: string | null
-  retryUnlockedBySkillId?: string | null
-  reviewReadyAt?: number | null
-  sourceSessionName?: string | null
-  sourceSnippet?: string | null
-  lastRefinedAt?: number | null
-  refinementCount?: number
-  createdAt: number
-  updatedAt: number
-}
-
-export type SkillSuggestionStatus = 'draft' | 'approved' | 'rejected'
-
-export interface SkillSuggestion {
-  id: string
-  status: SkillSuggestionStatus
-  sourceSessionId: string
-  sourceSessionName?: string | null
-  sourceAgentId?: string | null
-  sourceAgentName?: string | null
-  sourceHash?: string | null
-  sourceMessageCount?: number | null
-  name: string
-  description?: string
-  content: string
-  tags?: string[]
-  confidence?: number | null
-  rationale?: string | null
-  summary?: string | null
-  sourceSnippet?: string | null
-  createdSkillId?: string | null
-  approvedAt?: number | null
-  rejectedAt?: number | null
-  createdAt: number
-  updatedAt: number
-}
-
-export interface SkillInvocationConfig {
-  userInvocable?: boolean
-}
-
-export interface SkillCommandDispatch {
-  kind: 'tool'
-  toolName: string
-  argMode?: 'raw'
-}
-
-export interface SkillAuditFinding {
-  severity: 'warning' | 'error'
-  code: string
-  message: string
-  path?: string
-}
-
-export interface SkillAuditResult {
-  status: 'pass' | 'warn' | 'block'
-  findings: SkillAuditFinding[]
-}
-
-export interface SkillSecuritySummary {
-  level: 'low' | 'medium' | 'high'
-  notes: string[]
-  detectedEnvVars?: string[]
-  missingDeclarations?: string[]
-  installCommands?: string[]
-}
-
-export interface EstopState {
-  level: AutonomyEstopLevel
-  reason?: string | null
-  engagedAt?: number | null
-  engagedBy?: string | null
-  resumeApprovalId?: string | null
-  updatedAt: number
-}
-
-export interface GuardianCheckpoint {
-  id: string
-  cwd: string
-  head: string
-  branch?: string | null
-  status: string
-  createdAt: number
-  createdBy: string
-  approvalId?: string | null
-  restorePreparedAt?: number | null
-  restoredAt?: number | null
-}
-
-// --- Connector Health Events ---
-
-export type ConnectorHealthEventType = 'started' | 'stopped' | 'error' | 'reconnected' | 'disconnected'
-
-export interface ConnectorHealthEvent {
-  id: string
-  connectorId: string
-  event: ConnectorHealthEventType
-  message?: string
-  timestamp: string
-}
-
-// --- Connectors (Chat Platform Bridges) ---
-
-export type ConnectorPlatform =
-  | 'discord'
-  | 'telegram'
-  | 'slack'
-  | 'whatsapp'
-  | 'openclaw'
-  | 'bluebubbles'
-  | 'signal'
-  | 'teams'
-  | 'googlechat'
-  | 'matrix'
-  | 'email'
-  | 'webchat'
-  | 'mockmail'
-export type ConnectorStatus = 'stopped' | 'running' | 'error'
-
-export interface MessageSource {
-  platform: ConnectorPlatform
-  connectorId: string
-  connectorName: string
-  channelId?: string
-  senderId?: string
-  senderName?: string
-  messageId?: string
-  replyToMessageId?: string
-  threadId?: string
-  deliveryMode?: 'text' | 'voice_note'
-  deliveryTranscript?: string | null
-}
-
-export interface Connector {
-  id: string
-  name: string
-  platform: ConnectorPlatform
-  agentId?: string | null        // which agent handles incoming messages (optional if using chatroomId)
-  chatroomId?: string | null     // route to a chatroom instead of a single agent
-  credentialId?: string | null    // bot token stored as encrypted credential
-  config: Record<string, string>  // platform-specific settings
-  isEnabled: boolean
-  status: ConnectorStatus
-  lastError?: string | null
-  /** WhatsApp QR code data URL (runtime only) */
-  qrDataUrl?: string | null
-  /** WhatsApp authenticated/paired state (runtime only) */
-  authenticated?: boolean
-  /** WhatsApp has stored credentials from previous pairing (runtime only) */
-  hasCredentials?: boolean
-  /** Connector presence info (runtime only) */
-  presence?: { lastMessageAt?: number | null; channelId?: string | null }
-  createdAt: number
-  updatedAt: number
-}
-
-export type ConnectorDmAddressingMode = 'open' | 'addressed'
-
-export interface ConnectorAccessSenderStatus {
-  senderIds: string[]
-  isOwnerOverride: boolean
-  isBlocked: boolean
-  isApproved: boolean
-  isConfigAllowed: boolean
-  isStoredAllowed: boolean
-  isGlobalAllowed: boolean
-  isPending: boolean
-  pendingCode?: string | null
-  dmAddressingOverride: ConnectorDmAddressingMode | null
-  effectiveDmAddressingMode: ConnectorDmAddressingMode
-  requiresDirectAddress: boolean
-}
-
-export interface ConnectorAccessSnapshot {
-  connectorId: string
-  platform: ConnectorPlatform
-  dmPolicy: 'open' | 'allowlist' | 'pairing' | 'disabled'
-  dmAddressingMode: ConnectorDmAddressingMode
-  allowFrom: string[]
-  denyFrom: string[]
-  ownerSenderId: string | null
-  storedAllowedSenderIds: string[]
-  senderAddressingOverrides: Array<{
-    senderId: string
-    dmAddressingMode: ConnectorDmAddressingMode
-  }>
-  pendingPairingRequests: Array<{
-    code: string
-    senderId: string
-    senderName?: string
-    channelId?: string
-    createdAt: number
-    updatedAt: number
-  }>
-  globalWhatsAppApprovedContacts: WhatsAppApprovedContact[]
-  senderStatus?: ConnectorAccessSenderStatus | null
-}
-
-export type ConnectorAccessMutationAction =
-  | 'set_policy'
-  | 'set_dm_addressing_mode'
-  | 'allow_sender'
-  | 'remove_allowed_sender'
-  | 'block_sender'
-  | 'unblock_sender'
-  | 'approve_pairing'
-  | 'reject_pairing'
-  | 'set_owner'
-  | 'clear_owner'
-  | 'set_sender_dm_addressing'
-  | 'clear_sender_dm_addressing'
-
-export interface ConnectorAccessMutationResponse {
-  ok: boolean
-  snapshot: ConnectorAccessSnapshot
-}
-
-export interface Webhook {
-  id: string
-  name: string
-  source: string
-  events: string[]
-  agentId?: string | null
-  secret?: string
-  isEnabled: boolean
-  createdAt: number
-  updatedAt: number
-}
-
-export interface DocumentRevision {
-  id: string
-  documentId: string
-  version: number
-  content: string
-  createdAt: number
-  createdBy?: string | null
-}
-
-export interface DocumentEntry {
-  id: string
-  title: string
-  fileName: string
-  sourcePath: string
-  content: string
-  method: string
-  textLength: number
-  currentVersion?: number
-  metadata?: Record<string, unknown>
-  createdAt: number
-  updatedAt: number
-}
-
-export interface BoardTask {
-  id: string
-  title: string
-  description: string
-  status: BoardTaskStatus
-  agentId: string
-  missionId?: string | null
-  protocolRunId?: string | null
-  missionSummary?: MissionSummary | null
-  projectId?: string
-  goalContract?: GoalContract | null
-  cwd?: string | null
-  file?: string | null
-  sessionId?: string | null
-  completionReportPath?: string | null
-  result?: string | null
-  error?: string | null
-  outputFiles?: string[]
-  artifacts?: Array<{
-    url: string
-    type: 'image' | 'video' | 'pdf' | 'file'
-    filename: string
-  }>
-  comments?: TaskComment[]
-  images?: string[]
-  createdByAgentId?: string | null
-  createdInSessionId?: string | null
-  followupConnectorId?: string | null
-  followupChannelId?: string | null
-  followupThreadId?: string | null
-  followupSenderId?: string | null
-  followupSenderName?: string | null
-  delegatedByAgentId?: string | null
-  delegatedFromTaskId?: string | null
-  delegationDepth?: number | null
-  createdAt: number
-  updatedAt: number
-  queuedAt?: number | null
-  startedAt?: number | null
-  completedAt?: number | null
-  archivedAt?: number | null
-  attempts?: number
-  maxAttempts?: number
-  retryBackoffSec?: number
-  retryScheduledAt?: number | null
-  runNumber?: number
-  totalRuns?: number
-  totalCompleted?: number
-  totalFailed?: number
-  sourceType?: 'schedule' | 'delegation' | 'manual' | 'import'
-  sourceScheduleId?: string | null
-  sourceScheduleName?: string | null
-  sourceScheduleKey?: string | null
-  externalSource?: {
-    source: string
-    id?: string | null
-    repo?: string | null
-    number?: number | null
-    state?: string | null
-    labels?: string[]
-    assignee?: string | null
-    url?: string | null
-  } | null
-  lastActivityAt?: number | null
-  deferredReason?: string | null
-  deadLetteredAt?: number | null
-  cliResumeId?: string | null
-  cliProvider?: string | null
-  claudeResumeId?: string | null
-  codexResumeId?: string | null
-  opencodeResumeId?: string | null
-  geminiResumeId?: string | null
-  checkpoint?: {
-    lastRunId?: string | null
-    lastSessionId?: string | null
-    note?: string | null
-    updatedAt: number
-  } | null
-  validation?: {
-    ok: boolean
-    reasons: string[]
-    checkedAt: number
-  } | null
-  // Parent/child task hierarchy (user-created subtasks)
-  parentTaskId?: string | null
-  subtaskIds?: string[]
-  // Task dependencies (DAG)
-  blockedBy?: string[]
-  blocks?: string[]
-  // Task tags
-  tags?: string[]
-  // Due date
-  dueAt?: number | null
-  // Custom fields
-  customFields?: Record<string, string | number | boolean>
-  // Priority
-  priority?: 'low' | 'medium' | 'high' | 'critical'
-  // Dedup fingerprint
-  fingerprint?: string
-  qualityGate?: TaskQualityGateConfig | null
-  // Competitive task claiming (pool mode)
-  assignmentMode?: 'direct' | 'pool'
-  poolCandidateAgentIds?: string[]
-  claimedByAgentId?: string | null
-  claimedAt?: number | null
-  requiredCapabilities?: string[]
-  // Upstream task results (populated by cascadeUnblock when dependencies complete)
-  upstreamResults?: Array<{
-    taskId: string
-    taskTitle: string
-    agentId: string | null
-    resultPreview: string | null
-  }>
-  repairRunId?: string | null
-  lastRepairAttemptAt?: number | null
-}
-
-// --- MCP Servers ---
-
-export type McpTransport = 'stdio' | 'sse' | 'streamable-http'
-
-export interface McpServerConfig {
-  id: string
-  name: string
-  transport: McpTransport
-  command?: string             // for stdio transport
-  args?: string[]              // for stdio transport
-  url?: string                 // for sse/streamable-http transport
-  env?: Record<string, string> // environment variables
-  headers?: Record<string, string> // HTTP headers for sse/streamable-http
-  createdAt: number
-  updatedAt: number
-}
-
-// --- ClawHub ---
-
-export interface ClawHubSkill {
-  id: string
-  name: string
-  description: string
-  author: string
-  tags: string[]
-  downloads: number
-  stars?: number
-  url: string
-  version: string
-  changelog?: string
-  createdAt?: number
-  updatedAt?: number
-  metadata?: Record<string, unknown> | null
-}
-
-// --- OpenClaw Execution Approvals ---
-
-export interface PendingExecApproval {
-  id: string
-  agentId: string
-  sessionKey: string
-  command: string
-  cwd?: string
-  host?: string
-  security?: string
-  ask?: string
-  createdAtMs: number
-  expiresAtMs: number
-  resolving?: boolean
-  error?: string
-}
-
-export type ExecApprovalDecision = 'allow-once' | 'allow-always' | 'deny'
-
-// --- OpenClaw Skills ---
-
-export interface OpenClawSkillEntry {
-  name: string
-  description?: string
-  source: 'bundled' | 'managed' | 'personal' | 'workspace'
-  eligible: boolean
-  requirements?: string[]
-  missing?: string[]
-  disabled?: boolean
-  installOptions?: SkillInstallOption[]
-  skillRequirements?: SkillRequirements
-  configChecks?: { key: string; ok: boolean }[]
-  skillKey?: string
-  baseDir?: string
-}
-
-export type SkillAllowlistMode = 'all' | 'none' | 'selected'
-
-// --- Fleet Sidebar Filters (F16) ---
-export type FleetFilter = 'all' | 'running' | 'approvals'
-
-// --- Exec Approval Config (F8) ---
-export interface ExecApprovalConfig {
-  security: 'deny' | 'allowlist' | 'full'
-  askMode: 'off' | 'on-miss' | 'always'
-  patterns: string[]
-}
-
-export interface ExecApprovalSnapshot {
-  path: string
-  exists: boolean
-  hash: string
-  file: ExecApprovalConfig
-}
-
-// --- Permission Presets (F9) ---
-export type PermissionPreset = 'conservative' | 'collaborative' | 'autonomous'
-
-// --- Personality Builder (F10) ---
-export interface PersonalityDraft {
-  identity: { name?: string; creature?: string; vibe?: string; emoji?: string }
-  user: { name?: string; callThem?: string; pronouns?: string; timezone?: string; notes?: string; context?: string }
-  soul: { coreTruths?: string; boundaries?: string; vibe?: string; continuity?: string }
-}
-
-// --- Skill Lifecycle (F11) ---
-export interface SkillInstallOption {
-  kind: 'brew' | 'node' | 'go' | 'uv' | 'download'
-  label: string
-  bins?: string[]
-}
-
-export interface SkillRequirements {
-  bins?: string[]
-  anyBins?: string[][]
-  env?: string[]
-  config?: string[]
-  os?: string[]
-}
-
-// --- Cron Jobs (F12) ---
-export interface GatewayCronJob {
-  id: string
-  name: string
-  agentId: string
-  enabled: boolean
-  schedule: { kind: 'at' | 'every' | 'cron'; value: string; timezone?: string }
-  payload: {
-    kind: 'systemEvent' | 'agentTurn'
-    text?: string
-    message?: string
-    model?: string
-    deliver?: { mode: 'none' | 'announce'; channel?: string }
-  }
-  sessionTarget: 'main' | 'isolated'
-  state?: { nextRun?: string; lastRun?: string; lastStatus?: string }
-}
-
-// --- Rich Chat Traces (F13) ---
-export interface ChatTraceBlock {
-  type: 'thinking' | 'tool-call' | 'tool-result'
-  content: string
-  label?: string
-  collapsed?: boolean
-}
-
-// --- Chat History Sync (F18) ---
-export interface GatewaySessionPreview {
-  sessionKey: string
-  epoch: number
-  messages: Array<{ role: string; content: string; ts: number }>
-}
-
-// --- Gateway Reload Mode (F21) ---
-export type GatewayReloadMode = 'hot' | 'hybrid' | 'full'
+export * from './message'
+export * from './session'
+export * from './agent'
+export * from './working-state'
+export * from './extension'
+export * from './connector'
+export * from './provider'
+export * from './task'
+export * from './schedule'
+export * from './protocol'
+export * from './app-settings'
+export * from './skill'
+export * from './run'
+export * from './approval'
+export * from './misc'
+export * from './swarmdock'