@swarmclawai/swarmclaw 1.2.6 → 1.2.8

package/src/types/run.ts

@@ -0,0 +1,183 @@
+import type { SSEEvent } from './misc'
+
+// --- 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
+  activeTurn?: SessionQueuedTurn | 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
+}

package/src/types/schedule.ts

@@ -0,0 +1,59 @@
+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
+}

package/src/types/session.ts

@@ -0,0 +1,265 @@
+import type { ProviderId, OllamaMode } from './provider'
+import type { ConnectorPlatform } from './connector'
+import type { Message } from './message'
+import type { MissionSummary } from './mission'
+
+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 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 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 type MailboxStatus = 'new' | 'ack'
+
+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'
+
+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'

package/src/types/skill.ts

@@ -0,0 +1,157 @@
+// --- 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[]
+}
+
+// --- 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[]
+}
+
+export type SkillAllowlistMode = 'all' | 'none' | 'selected'