@swarmclawai/swarmclaw 1.5.48 → 1.5.49

package/src/lib/server/storage-normalization.ts

@@ -355,6 +355,135 @@ function normalizeStoredMissionEventRecord(value: unknown): unknown {
   return event
 }
 
+// --- Agent Mission normalizers (autonomous goal-driven runs, v1.5.49+) ---
+
+const VALID_AGENT_MISSION_STATUSES = new Set([
+  'draft',
+  'running',
+  'paused',
+  'completed',
+  'failed',
+  'cancelled',
+  'budget_exhausted',
+])
+
+const VALID_AGENT_MISSION_REPORT_FORMATS = new Set(['markdown', 'slack', 'discord', 'email', 'audio'])
+
+function normalizeFiniteNumber(value: unknown): number | null {
+  if (typeof value !== 'number' || !Number.isFinite(value)) return null
+  return value
+}
+
+function normalizeNonNegativeNumber(value: unknown, fallback: number): number {
+  const n = normalizeFiniteNumber(value)
+  if (n == null || n < 0) return fallback
+  return n
+}
+
+function normalizeStoredAgentMissionRecord(value: unknown): unknown {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return value
+  const mission = value as StoredObject
+
+  const status = typeof mission.status === 'string' ? mission.status.trim().toLowerCase() : ''
+  mission.status = VALID_AGENT_MISSION_STATUSES.has(status) ? status : 'draft'
+
+  mission.successCriteria = normalizeStoredStringArray(mission.successCriteria, 64)
+  mission.agentIds = normalizeStoredStringArray(mission.agentIds, 32)
+  mission.reportConnectorIds = normalizeStoredStringArray(mission.reportConnectorIds, 16)
+
+  const budget = mission.budget && typeof mission.budget === 'object' && !Array.isArray(mission.budget)
+    ? mission.budget as StoredObject
+    : {}
+  budget.maxUsd = normalizeFiniteNumber(budget.maxUsd)
+  budget.maxTokens = normalizeFiniteNumber(budget.maxTokens)
+  budget.maxToolCalls = normalizeFiniteNumber(budget.maxToolCalls)
+  budget.maxWallclockSec = normalizeFiniteNumber(budget.maxWallclockSec)
+  budget.maxTurns = normalizeFiniteNumber(budget.maxTurns)
+  if (!Array.isArray(budget.warnAtFractions)) {
+    budget.warnAtFractions = [0.5, 0.8, 0.95]
+  } else {
+    budget.warnAtFractions = (budget.warnAtFractions as unknown[])
+      .map((entry) => normalizeFiniteNumber(entry))
+      .filter((entry): entry is number => entry != null && entry > 0 && entry < 1)
+    if ((budget.warnAtFractions as number[]).length === 0) {
+      budget.warnAtFractions = [0.5, 0.8, 0.95]
+    }
+  }
+  mission.budget = budget
+
+  const usage = mission.usage && typeof mission.usage === 'object' && !Array.isArray(mission.usage)
+    ? mission.usage as StoredObject
+    : {}
+  usage.usdSpent = normalizeNonNegativeNumber(usage.usdSpent, 0)
+  usage.tokensUsed = normalizeNonNegativeNumber(usage.tokensUsed, 0)
+  usage.toolCallsUsed = normalizeNonNegativeNumber(usage.toolCallsUsed, 0)
+  usage.turnsRun = normalizeNonNegativeNumber(usage.turnsRun, 0)
+  usage.wallclockMsElapsed = normalizeNonNegativeNumber(usage.wallclockMsElapsed, 0)
+  usage.startedAt = normalizeFiniteNumber(usage.startedAt)
+  usage.lastUpdatedAt = normalizeNonNegativeNumber(usage.lastUpdatedAt, 0)
+  if (!Array.isArray(usage.warnFractionsHit)) {
+    usage.warnFractionsHit = []
+  } else {
+    usage.warnFractionsHit = (usage.warnFractionsHit as unknown[])
+      .map((entry) => normalizeFiniteNumber(entry))
+      .filter((entry): entry is number => entry != null)
+  }
+  mission.usage = usage
+
+  if (!Array.isArray(mission.milestones)) mission.milestones = []
+  // Cap the stored tail so missions don't balloon
+  if ((mission.milestones as unknown[]).length > 200) {
+    mission.milestones = (mission.milestones as unknown[]).slice(-200)
+  }
+
+  const reportSchedule = mission.reportSchedule
+    && typeof mission.reportSchedule === 'object'
+    && !Array.isArray(mission.reportSchedule)
+    ? mission.reportSchedule as StoredObject
+    : null
+  if (reportSchedule) {
+    const format = typeof reportSchedule.format === 'string' ? reportSchedule.format.trim().toLowerCase() : ''
+    reportSchedule.format = VALID_AGENT_MISSION_REPORT_FORMATS.has(format) ? format : 'markdown'
+    reportSchedule.intervalSec = normalizeNonNegativeNumber(reportSchedule.intervalSec, 3600)
+    reportSchedule.enabled = reportSchedule.enabled !== false
+    reportSchedule.lastReportAt = normalizeFiniteNumber(reportSchedule.lastReportAt)
+    mission.reportSchedule = reportSchedule
+  } else if (mission.reportSchedule !== undefined) {
+    mission.reportSchedule = null
+  }
+
+  if (typeof mission.createdAt !== 'number') mission.createdAt = Date.now()
+  if (typeof mission.updatedAt !== 'number') mission.updatedAt = mission.createdAt as number
+  if (mission.startedAt === undefined) mission.startedAt = null
+  if (mission.endedAt === undefined) mission.endedAt = null
+  if (mission.endReason === undefined) mission.endReason = null
+
+  return mission
+}
+
+function normalizeStoredMissionReportRecord(value: unknown): unknown {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return value
+  const report = value as StoredObject
+  const format = typeof report.format === 'string' ? report.format.trim().toLowerCase() : ''
+  report.format = VALID_AGENT_MISSION_REPORT_FORMATS.has(format) ? format : 'markdown'
+  if (!Array.isArray(report.highlights)) report.highlights = []
+  if (!Array.isArray(report.deliveredTo)) report.deliveredTo = []
+  if (typeof report.body !== 'string') report.body = ''
+  if (typeof report.title !== 'string') report.title = 'Mission report'
+  return report
+}
+
+function normalizeStoredAgentMissionEventRecord(value: unknown): unknown {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return value
+  const event = value as StoredObject
+  if (!event.payload || typeof event.payload !== 'object' || Array.isArray(event.payload)) {
+    event.payload = {}
+  }
+  if (typeof event.kind !== 'string' || !event.kind.trim()) event.kind = 'unknown'
+  if (typeof event.at !== 'number' || !Number.isFinite(event.at)) event.at = Date.now()
+  return event
+}
+
 // --- Delegation job normalizer ---
 
 function normalizeStoredDelegationJobRecord(value: unknown): unknown {
@@ -428,7 +557,7 @@ export function normalizeStoredRecord(
   value: unknown,
   loadItem: CollectionItemLoader,
 ): NormalizationResult {
-  // Tables with no normalization — early exit
+  // Tables with no normalization, early exit.
   if (
     table !== 'agents' && table !== 'tasks' && table !== 'missions'
     && table !== 'mission_events' && table !== 'delegation_jobs'
@@ -436,6 +565,9 @@ export function normalizeStoredRecord(
     && table !== 'provider_configs'
     && table !== 'runtime_runs' && table !== 'runtime_run_events'
     && table !== 'wallets'
+    && table !== 'agent_missions'
+    && table !== 'mission_reports'
+    && table !== 'agent_mission_events'
   ) {
     return { value, changed: false }
   }
@@ -590,6 +722,18 @@ function normalizeStoredRecordInner(
     return normalizeStoredMissionEventRecord(value)
   }
 
+  if (table === 'agent_missions') {
+    return normalizeStoredAgentMissionRecord(value)
+  }
+
+  if (table === 'mission_reports') {
+    return normalizeStoredMissionReportRecord(value)
+  }
+
+  if (table === 'agent_mission_events') {
+    return normalizeStoredAgentMissionEventRecord(value)
+  }
+
   if (table === 'delegation_jobs') {
     return normalizeStoredDelegationJobRecord(value)
   }

package/src/lib/server/storage.ts

@@ -26,6 +26,9 @@ import type {
   KnowledgeSource,
   LearnedSkill,
   Message,
+  Mission,
+  MissionEvent,
+  MissionReport,
   ProtocolTemplate,
   ProtocolRun,
   ProtocolRunEvent,
@@ -176,6 +179,9 @@ const COLLECTIONS = [
   'wallets',
   'wallet_transactions',
   'goals',
+  'agent_missions',
+  'mission_reports',
+  'agent_mission_events',
 ] as const
 
 export type StorageCollection = (typeof COLLECTIONS)[number]
@@ -1686,6 +1692,29 @@ export const loadGoal = goalsStore.loadItem
 export const upsertGoal = goalsStore.upsert
 export const deleteGoalItem = goalsStore.deleteItem
 
+// --- Agent Missions (autonomous goal-driven runs) ---
+const agentMissionsStore = createCollectionStore<Mission>('agent_missions', { ttlMs: 5_000 })
+export const loadAgentMissions = agentMissionsStore.load
+export const saveAgentMissions = agentMissionsStore.save
+export const loadAgentMission = agentMissionsStore.loadItem
+export const upsertAgentMission = agentMissionsStore.upsert
+export const patchAgentMission = agentMissionsStore.patch
+export const deleteAgentMission = agentMissionsStore.deleteItem
+
+const missionReportsStore = createCollectionStore<MissionReport>('mission_reports')
+export const loadMissionReports = missionReportsStore.load
+export const saveMissionReports = missionReportsStore.save
+export const loadMissionReport = missionReportsStore.loadItem
+export const upsertMissionReport = missionReportsStore.upsert
+export const deleteMissionReport = missionReportsStore.deleteItem
+
+const agentMissionEventsStore = createCollectionStore<MissionEvent>('agent_mission_events')
+export const loadAgentMissionEvents = agentMissionEventsStore.load
+export const saveAgentMissionEvents = agentMissionEventsStore.save
+export const loadAgentMissionEvent = agentMissionEventsStore.loadItem
+export const upsertAgentMissionEvent = agentMissionEventsStore.upsert
+export const deleteAgentMissionEvent = agentMissionEventsStore.deleteItem
+
 function legacyMissionStatusToWorkingStatus(value: unknown): 'idle' | 'progress' | 'blocked' | 'completed' {
   const normalized = typeof value === 'string' ? value.trim().toLowerCase() : ''
   if (normalized === 'achieved' || normalized === 'completed' || normalized === 'ok') return 'completed'

package/src/types/index.ts

@@ -14,6 +14,7 @@ export * from './run'
 export * from './approval'
 export * from './misc'
 export * from './goal'
+export * from './mission'
 export * from './swarmdock'
 export * from './dream'
 export * from './swarmfeed'

package/src/types/mission.ts

@@ -0,0 +1,115 @@
+export type MissionStatus =
+  | 'draft'
+  | 'running'
+  | 'paused'
+  | 'completed'
+  | 'failed'
+  | 'cancelled'
+  | 'budget_exhausted'
+
+export type MissionReportFormat = 'markdown' | 'slack' | 'discord' | 'email' | 'audio'
+
+export type MissionMilestoneKind =
+  | 'started'
+  | 'budget_warn'
+  | 'budget_hit'
+  | 'check_in'
+  | 'subgoal_done'
+  | 'report_sent'
+  | 'paused'
+  | 'resumed'
+  | 'completed'
+  | 'failed'
+  | 'cancelled'
+
+export interface MissionBudget {
+  maxUsd?: number | null
+  maxTokens?: number | null
+  maxToolCalls?: number | null
+  maxWallclockSec?: number | null
+  maxTurns?: number | null
+  warnAtFractions?: number[]
+}
+
+export interface MissionUsage {
+  usdSpent: number
+  tokensUsed: number
+  toolCallsUsed: number
+  turnsRun: number
+  wallclockMsElapsed: number
+  startedAt: number | null
+  lastUpdatedAt: number
+  warnFractionsHit: number[]
+}
+
+export interface MissionMilestone {
+  id: string
+  at: number
+  kind: MissionMilestoneKind
+  summary: string
+  evidence?: string[]
+  sessionId?: string | null
+  runId?: string | null
+}
+
+export interface MissionReportSchedule {
+  intervalSec: number
+  format: MissionReportFormat
+  enabled: boolean
+  lastReportAt?: number | null
+}
+
+export interface MissionReportDelivery {
+  connectorId?: string | null
+  channelId?: string | null
+  deliveredAt: number
+  status: 'ok' | 'error'
+  error?: string | null
+}
+
+export interface MissionReport {
+  id: string
+  missionId: string
+  generatedAt: number
+  format: MissionReportFormat
+  fromAt: number
+  toAt: number
+  title: string
+  body: string
+  audioUrl?: string | null
+  deliveredTo: MissionReportDelivery[]
+  highlights: Array<{ kind: string; summary: string; evidenceRunId?: string | null }>
+}
+
+export interface MissionEvent {
+  id: string
+  missionId: string
+  at: number
+  kind: string
+  payload: Record<string, unknown>
+  sessionId?: string | null
+  runId?: string | null
+}
+
+export interface Mission {
+  id: string
+  title: string
+  goal: string
+  successCriteria: string[]
+  rootSessionId: string
+  agentIds: string[]
+  status: MissionStatus
+  budget: MissionBudget
+  usage: MissionUsage
+  milestones: MissionMilestone[]
+  reportSchedule?: MissionReportSchedule | null
+  reportConnectorIds: string[]
+  createdAt: number
+  updatedAt: number
+  startedAt?: number | null
+  endedAt?: number | null
+  endReason?: string | null
+}
+
+export const DEFAULT_MISSION_WARN_FRACTIONS = [0.5, 0.8, 0.95]
+export const MISSION_MILESTONE_TAIL_CAP = 200

package/src/types/session.ts

@@ -173,6 +173,8 @@ export interface Session {
   file?: string | null
   queuedCount?: number
   currentRunId?: string | null
+  /** Optional link to an autonomous Mission that drives this session. */
+  missionId?: string | null
   conversationTone?: string
   emoji?: string
   creature?: string
@@ -227,4 +229,4 @@ export type SessionTool =
   | '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' | 'swarmfeed' | 'marketplace'
+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' | 'swarmfeed' | 'marketplace' | 'missions'