@swarmclawai/swarmclaw 1.2.6 → 1.2.9

package/src/types/session.ts

@@ -0,0 +1,215 @@
+import type { ProviderId, OllamaMode } from './provider'
+import type { ConnectorPlatform } from './connector'
+import type { Message } from './message'
+
+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 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
+  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
+  /** 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'
+  | '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' | 'tasks' | 'secrets' | 'wallets' | 'providers' | 'skills' | 'connectors' | 'webhooks' | 'mcp_servers' | 'knowledge' | 'extensions' | 'usage' | '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'

package/src/types/swarmdock.ts

@@ -0,0 +1,29 @@
+// --- SwarmDock Marketplace Types ---
+
+export interface AgentWallet {
+  id: string
+  agentId: string
+  walletAddress: string
+  chain: 'base'
+  label?: string
+  encryptedPrivateKey?: string | null
+  spendingLimitUsdc?: string | null
+  dailyLimitUsdc?: string | null
+  requireApproval?: boolean
+  swarmdockAgentId?: string | null
+  swarmdockDid?: string | null
+  createdAt: number
+}
+
+export type SafeWallet = Omit<AgentWallet, 'encryptedPrivateKey'>
+
+export interface WalletTransaction {
+  id: string
+  walletId: string
+  swarmdockTaskId?: string | null
+  amount: string
+  direction: 'in' | 'out'
+  txHash?: string | null
+  status: 'pending' | 'confirmed' | 'failed'
+  createdAt: number
+}

package/src/types/task.ts

@@ -0,0 +1,144 @@
+import type { GoalContract } from './app-settings'
+
+// --- 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
+}
+
+export interface BoardTask {
+  id: string
+  title: string
+  description: string
+  status: BoardTaskStatus
+  agentId: string
+  protocolRunId?: string | null
+  // Objective tracking (absorbed from missions)
+  objective?: string | null
+  successCriteria?: string[] | null
+  verificationSummary?: string | null
+  rootTaskId?: string | 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
+  // Atomic checkout — prevents two runners from starting the same task
+  checkoutRunId?: string | null
+}