@swarmclawai/swarmclaw 1.9.7 → 1.9.9

package/src/lib/server/schedules/schedule-service.ts

@@ -9,6 +9,11 @@ import type { Schedule, ScheduleStatus } from '@/types'
 import { dedup } from '@/lib/shared-utils'
 
 import { normalizeSchedulePayload } from '@/lib/server/schedules/schedule-normalization'
+import {
+  applyScheduleCreationHistory,
+  applyScheduleUpdateHistory,
+  type ScheduleHistoryActor,
+} from '@/lib/server/schedules/schedule-history'
 
 export interface ScheduleCreatorScope {
   agentId?: string | null
@@ -91,6 +96,7 @@ export interface PrepareScheduleCreateOptions {
   dedupeCreatorScope?: ScheduleCreatorScope | null
   followupTarget?: Partial<Schedule>
   createId?: () => string
+  historyActor?: ScheduleHistoryActor | null
 }
 
 export type PrepareScheduleCreateResult =
@@ -150,7 +156,16 @@ export function prepareScheduleCreate(options: PrepareScheduleCreateOptions): Pr
       nextSchedule.status = nextStatus
       changed = true
     }
-    if (changed) nextSchedule.updatedAt = options.now
+    if (changed) {
+      nextSchedule.updatedAt = options.now
+      const withHistory = applyScheduleUpdateHistory(duplicate as Schedule, nextSchedule as Schedule, {
+        now: options.now,
+        actor: options.historyActor?.actor || 'system',
+        actorId: options.historyActor?.actorId || null,
+        summary: `Schedule updated from duplicate create request: "${nextSchedule.name}"`,
+      })
+      Object.assign(nextSchedule, withHistory)
+    }
     return {
       ok: true,
       kind: 'duplicate',
@@ -168,7 +183,7 @@ export function prepareScheduleCreate(options: PrepareScheduleCreateOptions): Pr
         createdInSessionId: options.creatorScope.sessionId || null,
       }
     : {}
-  const schedule = {
+  const schedule = applyScheduleCreationHistory({
     id,
     ...candidate,
     ...creatorFields,
@@ -178,7 +193,11 @@ export function prepareScheduleCreate(options: PrepareScheduleCreateOptions): Pr
     lastRunAt: undefined,
     createdAt: options.now,
     updatedAt: options.now,
-  } as Schedule
+  } as Schedule, {
+    now: options.now,
+    actor: options.historyActor?.actor || 'system',
+    actorId: options.historyActor?.actorId || null,
+  })
 
   return {
     ok: true,
@@ -199,6 +218,7 @@ export interface PrepareScheduleUpdateOptions {
   agentExists?: (agentId: string) => boolean
   propagateEquivalentStatuses?: boolean
   propagationSource?: Record<string, unknown> | null
+  historyActor?: ScheduleHistoryActor | null
 }
 
 export type PrepareScheduleUpdateResult =
@@ -243,7 +263,13 @@ export function prepareScheduleUpdate(options: PrepareScheduleUpdateOptions): Pr
     taskPrompt: nextSchedule.taskPrompt,
   })
 
-  const entries: Array<[string, ScheduleLike]> = [[options.id, nextSchedule]]
+  const scheduleWithHistory = applyScheduleUpdateHistory(options.current as Schedule, nextSchedule as Schedule, {
+    now: options.now,
+    actor: options.historyActor?.actor || 'system',
+    actorId: options.historyActor?.actorId || null,
+  })
+
+  const entries: Array<[string, ScheduleLike]> = [[options.id, scheduleWithHistory]]
   const normalizedStatus = normalizeScheduleStatus(nextSchedule.status)
   if (options.propagateEquivalentStatuses && (normalizedStatus === 'paused' || normalizedStatus === 'completed' || normalizedStatus === 'failed' || normalizedStatus === 'archived')) {
     const relatedIds = findRelatedScheduleIds(
@@ -254,17 +280,23 @@ export function prepareScheduleUpdate(options: PrepareScheduleUpdateOptions): Pr
     for (const relatedId of relatedIds) {
       const related = options.schedules[relatedId]
       if (!related) continue
-      entries.push([relatedId, {
+      const relatedNext = {
         ...related,
         status: normalizedStatus,
         updatedAt: options.now,
-      }])
+      } as Schedule
+      entries.push([relatedId, applyScheduleUpdateHistory(related as Schedule, relatedNext, {
+        now: options.now,
+        actor: options.historyActor?.actor || 'system',
+        actorId: options.historyActor?.actorId || null,
+        summary: `Schedule status updated with related schedule: "${scheduleWithHistory.name}"`,
+      })])
     }
   }
 
   return {
     ok: true,
-    schedule: nextSchedule,
+    schedule: scheduleWithHistory,
     entries,
     affectedScheduleIds: dedup(entries.map(([id]) => id)),
   }

package/src/lib/server/session-tools/crud.ts

@@ -672,6 +672,7 @@ export function buildCrudTools(bctx: ToolBuildContext): StructuredToolInterface[
                     sessionId: ctx?.sessionId || null,
                   },
                   followupTarget: deriveScheduleFollowupTarget(ctx?.sessionId || null),
+                  historyActor: { actor: ctx?.agentId ? 'agent' : 'user', actorId: ctx?.agentId || null },
                 })
                 if (!prepared.ok) return prepared.error
                 if (prepared.kind === 'duplicate') {
@@ -880,6 +881,7 @@ export function buildCrudTools(bctx: ToolBuildContext): StructuredToolInterface[
                   agentExists: (agentId) => Boolean(managedAgents?.[agentId]),
                   propagateEquivalentStatuses: true,
                   propagationSource: previousEntry as Record<string, unknown>,
+                  historyActor: { actor: ctx?.agentId ? 'agent' : 'user', actorId: ctx?.agentId || null },
                 })
                 if (!prepared.ok) return prepared.error
                 for (const [scheduleId, schedule] of prepared.entries) {

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

@@ -2,6 +2,7 @@ import { normalizeCapabilitySelection } from '@/lib/capability-selection'
 import { normalizeAgentSandboxConfig } from '@/lib/agent-sandbox-defaults'
 import { isDirectConnectorSession } from '@/lib/server/connectors/session-kind'
 import { WORKER_ONLY_PROVIDER_IDS } from '@/lib/provider-sets'
+import { normalizeScheduleHistory } from '@/lib/server/schedules/schedule-history'
 
 type StoredObject = Record<string, unknown>
 
@@ -204,6 +205,20 @@ function normalizeStoredScheduleRecord(value: unknown, loadItem: CollectionItemL
     delete schedule.followupThreadId
   }
 
+  const history = normalizeScheduleHistory(schedule.history)
+  if (history.length > 0) {
+    schedule.history = history
+    const revision = typeof schedule.revision === 'number' && Number.isFinite(schedule.revision)
+      ? Math.trunc(schedule.revision)
+      : 0
+    schedule.revision = Math.max(revision, ...history.map((entry) => entry.revision))
+  } else {
+    delete schedule.history
+    if (typeof schedule.revision !== 'number' || !Number.isFinite(schedule.revision) || schedule.revision <= 0) {
+      delete schedule.revision
+    }
+  }
+
   return schedule
 }
 

package/src/types/schedule.ts

@@ -3,6 +3,26 @@ import type { ExtensionManagedResourceMarker } from './extension'
 export type ScheduleType = 'cron' | 'interval' | 'once'
 export type ScheduleStatus = 'active' | 'paused' | 'completed' | 'failed' | 'archived'
 export type ScheduleTaskMode = 'task' | 'wake_only' | 'protocol'
+export type ScheduleHistoryAction = 'created' | 'updated' | 'archived' | 'restored' | 'run_started' | 'skipped' | 'failed'
+
+export interface ScheduleHistoryChange {
+  field: string
+  label: string
+  before: string | null
+  after: string | null
+}
+
+export interface ScheduleHistoryEntry {
+  id: string
+  at: number
+  actor: string
+  actorId?: string | null
+  action: ScheduleHistoryAction
+  revision: number
+  summary: string
+  changes?: ScheduleHistoryChange[]
+  metadata?: Record<string, string | number | boolean | null>
+}
 
 export interface Schedule {
   id: string
@@ -57,6 +77,8 @@ export interface Schedule {
   followupSenderId?: string | null
   followupSenderName?: string | null
   managedByExtension?: ExtensionManagedResourceMarker | null
+  revision?: number
+  history?: ScheduleHistoryEntry[]
   createdAt: number
   updatedAt?: number
 }