@swarmclawai/swarmclaw 1.9.8 → 1.9.9

package/README.md

@@ -399,6 +399,15 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.9.9 Highlights
+
+Schedule revision timeline release: schedule edits, lifecycle changes, and run evidence now stay inspectable from UI, API, and CLI surfaces.
+
+- **Schedule history ledger.** Schedules now carry a bounded revision history for create, update, archive, restore, skipped, failed, and run-started events.
+- **History console.** The Schedule Console adds a searchable History tab with revision badges, actor labels, and before/after change summaries.
+- **API and CLI access.** `GET /api/schedules/:id/history` and `swarmclaw schedules history <id>` expose the same timeline for scripts and operator audits.
+- **Runtime evidence.** Manual runs and scheduler-fired runs append history entries, while storage normalization caps old entries and keeps legacy schedules compatible.
+
 ### v1.9.8 Highlights
 
 Bundled release-readiness release: a single operator report that combines eval gates, operations blockers, approvals, and runtime readiness.
@@ -703,6 +712,62 @@ Older releases: https://swarmclaw.ai/docs/release-notes
 - npm package: https://www.npmjs.com/package/@swarmclawai/swarmclaw
 - Historical release notes: https://swarmclaw.ai/docs/release-notes
 
+
+## FAQ
+
+### General
+
+**What is SwarmClaw?**
+SwarmClaw is an open-source, self-hosted AI agent runtime and multi-agent framework. It lets you run autonomous AI agents, agent swarms, and orchestrators with durable memory, MCP tools, skills, delegation, schedules, and support for 23+ LLM providers — serving as a practical alternative to Claude Code and LangChain for self-hosted workflows.
+
+**How does SwarmClaw differ from LangChain or CrewAI?**
+SwarmClaw is a self-hosted runtime rather than a code library. It provides a persistent dashboard, durable agent memory, real-time org chart visualization, and built-in multi-agent orchestration with delegation — all running on your own infrastructure. LangChain and CrewAI are code frameworks you embed in your applications; SwarmClaw is the platform your agents run on.
+
+**Is SwarmClaw production-ready?**
+Yes. SwarmClaw is used in production by teams running autonomous agent swarms. It includes security features like approval-gated actions, TLS support, and access key management.
+
+### Setup & Configuration
+
+**How do I install SwarmClaw?**
+Install via npm: `npm install -g @swarmclawai/swarmclaw`, then run `swarmclaw init` to create your configuration. Docker deployment is also available via the provided Docker Compose setup.
+
+**Which LLM providers are supported?**
+SwarmClaw supports 23+ providers including OpenAI, Anthropic (Claude), Google Gemini, OpenRouter, Ollama (local), DeepSeek, Groq, Together AI, and more. Configure your API keys in the `.env` file or via the dashboard.
+
+**Can I use local models?**
+Yes. SwarmClaw integrates with Ollama and other local LLM backends for fully offline agent operation.
+
+### Agent Development
+
+**What is an agent swarm?**
+An agent swarm is a group of AI agents working together under an orchestrator. Each agent has its own role, tools, and memory. The orchestrator delegates tasks, agents execute in parallel, and results are aggregated — mimicking a real organizational structure.
+
+**What are MCP tools?**
+MCP (Model Context Protocol) tools let agents interact with external systems — databases, APIs, file systems, browsers, and more. SwarmClaw provides a marketplace of pre-built MCP tools at SwarmDock.
+
+**How does agent memory work?**
+SwarmClaw provides durable agent memory that persists across sessions. Each agent maintains its own conversation history, learned skills, and context — enabling long-running autonomous workflows.
+
+### Deployment
+
+**How do I deploy SwarmClaw?**
+Options include: local npm installation, Docker Compose for containerized deployment, or cloud VPS with reverse proxy and TLS. See the [deployment docs](https://swarmclaw.ai/docs/deployment) for detailed guides.
+
+**Can I run SwarmClaw in the cloud?**
+Yes. SwarmClaw runs on any Linux server with Node.js 18+. Popular options include AWS EC2, DigitalOcean, Hetzner, and self-hosted on home servers.
+
+### Troubleshooting
+
+**Agent is not responding. What should I check?**
+Verify your LLM API key is valid, check the agent's configuration in the dashboard, and review the agent chat logs for error messages. Common issues include rate limiting and invalid model names.
+
+**How do I update SwarmClaw?**
+Run `npm update -g @swarmclawai/swarmclaw` or pull the latest Docker image. Check the [release notes](https://swarmclaw.ai/docs/release-notes) for breaking changes.
+
+**Where can I get help?**
+- Documentation: https://swarmclaw.ai/docs
+- Discord community: https://discord.gg/sbEavS8cPV
+- GitHub Issues: https://github.com/swarmclawai/swarmclaw/issues
 ## Security Notes
 
 - First run creates an access key; keep it private.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.9.8",
+  "version": "1.9.9",
   "description": "Build and run autonomous AI agents with OpenClaw, Hermes, multiple model providers, orchestration, delegation, memory, skills, schedules, and chat connectors.",
   "main": "electron-dist/main.js",
   "license": "MIT",
@@ -87,7 +87,7 @@
     "test:cli": "node --test src/cli/*.test.js bin/*.test.js scripts/electron-after-pack.test.mjs scripts/ensure-sandbox-browser-image.test.mjs scripts/postinstall.test.mjs scripts/run-next-build.test.mjs scripts/run-next-typegen.test.mjs",
     "test:setup": "tsx --test src/app/api/setup/check-provider/route.test.ts src/lib/server/provider-model-discovery.test.ts src/components/auth/setup-wizard/utils.test.ts src/components/auth/setup-wizard/types.test.ts src/hooks/setup-done-detection.test.ts src/lib/setup-defaults.test.ts src/lib/server/storage-auth.test.ts src/lib/server/storage-auth-docker.test.ts",
     "test:openclaw": "tsx --test src/lib/openclaw/openclaw-agent-id.test.ts src/lib/openclaw/openclaw-endpoint.test.ts src/lib/server/agents/agent-runtime-config.test.ts src/lib/server/build-llm.test.ts src/lib/server/connectors/connector-routing.test.ts src/lib/server/connectors/openclaw.test.ts src/lib/server/connectors/swarmdock.test.ts src/lib/server/gateway/protocol.test.ts src/lib/server/gateways/gateway-topology.test.ts src/lib/server/llm-response-cache.test.ts src/lib/server/mcp-conformance.test.ts src/lib/server/openclaw/agent-resolver.test.ts src/lib/server/openclaw/deploy.test.ts src/lib/server/openclaw/skills-normalize.test.ts src/lib/server/session-tools/openclaw-nodes.test.ts src/lib/server/session-tools/swarmdock.test.ts src/lib/server/tasks/task-quality-gate.test.ts src/lib/server/tasks/task-validation.test.ts src/lib/server/tool-capability-policy.test.ts src/lib/providers/openai.test.ts src/lib/providers/openclaw-exports.test.ts src/app/api/gateways/topology-route.test.ts src/app/api/openclaw/dashboard-url/route.test.ts",
-    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/strip-internal-metadata.test.ts src/lib/provider-sets.test.ts src/lib/providers/opencode-cli.test.ts src/lib/providers/cli-provider-metadata.test.ts src/lib/providers/cli-utils.test.ts src/lib/providers/generic-cli.test.ts src/lib/server/agents/delegation-advisory.test.ts src/lib/server/cli-provider-readiness.test.ts src/lib/server/provider-health.test.ts src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/extension-managed-resources.test.ts src/lib/server/eval/baseline.test.ts src/lib/server/eval/environment-plan.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chat-execution/reasoning-tag-scrubber.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/runtime/queue-retry-policy.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/quality/release-readiness.test.ts src/lib/server/artifacts/artifact-resolver.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/server/sharing/share-link-repository.test.ts src/lib/server/sharing/share-resolver.test.ts src/lib/server/tasks/task-execution-workspace.test.ts src/lib/server/tasks/task-service.test.ts src/lib/server/session-tools/execute.test.ts src/lib/server/session-tools/manage-tasks.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/tasks/task-workspace-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/extensions/managed-resources/route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/portability/export/route.test.ts src/app/api/portability/import/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/tts/route.test.ts",
+    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/strip-internal-metadata.test.ts src/lib/provider-sets.test.ts src/lib/providers/opencode-cli.test.ts src/lib/providers/cli-provider-metadata.test.ts src/lib/providers/cli-utils.test.ts src/lib/providers/generic-cli.test.ts src/lib/server/agents/delegation-advisory.test.ts src/lib/server/cli-provider-readiness.test.ts src/lib/server/provider-health.test.ts src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/extension-managed-resources.test.ts src/lib/server/eval/baseline.test.ts src/lib/server/eval/environment-plan.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chat-execution/reasoning-tag-scrubber.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/runtime/queue-retry-policy.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/server/schedules/schedule-history.test.ts src/lib/quality/release-readiness.test.ts src/lib/server/artifacts/artifact-resolver.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/server/sharing/share-link-repository.test.ts src/lib/server/sharing/share-resolver.test.ts src/lib/server/tasks/task-execution-workspace.test.ts src/lib/server/tasks/task-service.test.ts src/lib/server/session-tools/execute.test.ts src/lib/server/session-tools/manage-tasks.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/tasks/task-workspace-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/extensions/managed-resources/route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/portability/export/route.test.ts src/app/api/portability/import/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/schedules/schedule-history-route.test.ts src/app/api/tts/route.test.ts",
     "test:builder": "tsx --test src/features/protocols/builder/utils/nodes-to-template.test.ts src/features/protocols/builder/utils/template-to-nodes.test.ts src/features/protocols/builder/validators/dag-validator.test.ts",
     "test:e2e": "node --import tsx scripts/browser-e2e-smoke.ts",
     "test:mcp:conformance": "node --import tsx ./scripts/mcp-conformance-check.ts",

package/src/app/api/schedules/[id]/history/route.ts

@@ -0,0 +1,15 @@
+import { NextResponse } from 'next/server'
+import { notFound } from '@/lib/server/collection-helpers'
+import { loadSchedule } from '@/lib/server/schedules/schedule-repository'
+import { normalizeScheduleHistory } from '@/lib/server/schedules/schedule-history'
+
+export async function GET(_req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const schedule = loadSchedule(id)
+  if (!schedule) return notFound()
+  return NextResponse.json({
+    scheduleId: schedule.id,
+    revision: schedule.revision || 0,
+    history: normalizeScheduleHistory(schedule.history),
+  })
+}

package/src/app/api/schedules/[id]/route.test.ts

@@ -2,6 +2,7 @@ import assert from 'node:assert/strict'
 import test, { afterEach } from 'node:test'
 
 import { DELETE as deleteScheduleRoute, PUT as updateSchedule } from './route'
+import { GET as getScheduleHistory } from './history/route'
 import { loadAgents, loadSchedules, saveAgents, saveSchedules } from '@/lib/server/storage'
 
 const originalAgents = loadAgents()
@@ -84,7 +85,7 @@ test('PUT /api/schedules/[id] pauses equivalent reminder schedules together', as
   assert.equal(schedules.two.status, 'paused')
 })
 
-test('DELETE /api/schedules/[id] deletes equivalent reminder schedules together', async () => {
+test('DELETE /api/schedules/[id] archives equivalent reminder schedules together', async () => {
   seedAgent('schedule-route-agent-delete')
   const now = Date.now()
   saveSchedules({
@@ -123,6 +124,54 @@ test('DELETE /api/schedules/[id] deletes equivalent reminder schedules together'
 
   assert.equal(response.status, 200)
   const payload = await response.json() as Record<string, unknown>
-  assert.deepEqual(new Set(payload.deletedIds as string[]), new Set(['one', 'two']))
-  assert.deepEqual(loadSchedules(), {})
+  assert.deepEqual(new Set(payload.archivedIds as string[]), new Set(['one', 'two']))
+  const schedules = loadSchedules()
+  assert.equal(schedules.one.status, 'archived')
+  assert.equal(schedules.two.status, 'archived')
+  assert.equal(schedules.one.history?.[0]?.action, 'archived')
+})
+
+test('GET /api/schedules/[id]/history returns revision history', async () => {
+  const now = Date.now()
+  saveSchedules({
+    one: {
+      id: 'one',
+      name: 'History Schedule',
+      agentId: 'schedule-route-agent-history',
+      taskPrompt: 'Report changes',
+      scheduleType: 'interval',
+      intervalMs: 86_400_000,
+      status: 'active',
+      revision: 2,
+      history: [{
+        id: 'history-2',
+        at: now,
+        actor: 'user',
+        action: 'updated',
+        revision: 2,
+        summary: 'Schedule updated: "History Schedule"',
+        changes: [{
+          field: 'status',
+          label: 'Status',
+          before: 'paused',
+          after: 'active',
+        }],
+      }],
+      createdAt: now,
+      updatedAt: now,
+    },
+  })
+
+  const response = await getScheduleHistory(
+    new Request('http://local/api/schedules/one/history', { method: 'GET' }),
+    routeParams('one'),
+  )
+
+  assert.equal(response.status, 200)
+  const payload = await response.json() as Record<string, unknown>
+  assert.equal(payload.scheduleId, 'one')
+  assert.equal(payload.revision, 2)
+  const history = payload.history as Array<Record<string, unknown>>
+  assert.equal(history.length, 1)
+  assert.equal(history[0].action, 'updated')
 })

package/src/app/api/schedules/schedule-history-route.test.ts

@@ -0,0 +1,60 @@
+import assert from 'node:assert/strict'
+import test, { afterEach } from 'node:test'
+
+import { GET as getScheduleHistory } from './[id]/history/route'
+import { loadSchedules, saveSchedules } from '@/lib/server/storage'
+
+const originalSchedules = loadSchedules()
+
+function routeParams(id: string) {
+  return { params: Promise.resolve({ id }) }
+}
+
+afterEach(() => {
+  saveSchedules(originalSchedules)
+})
+
+test('GET /api/schedules/[id]/history returns normalized revision history', async () => {
+  const now = Date.now()
+  saveSchedules({
+    one: {
+      id: 'one',
+      name: 'History Schedule',
+      agentId: 'schedule-route-agent-history',
+      taskPrompt: 'Report changes',
+      scheduleType: 'interval',
+      intervalMs: 86_400_000,
+      status: 'active',
+      revision: 2,
+      history: [{
+        id: 'history-2',
+        at: now,
+        actor: 'user',
+        action: 'updated',
+        revision: 2,
+        summary: 'Schedule updated: "History Schedule"',
+        changes: [{
+          field: 'status',
+          label: 'Status',
+          before: 'paused',
+          after: 'active',
+        }],
+      }],
+      createdAt: now,
+      updatedAt: now,
+    },
+  })
+
+  const response = await getScheduleHistory(
+    new Request('http://local/api/schedules/one/history', { method: 'GET' }),
+    routeParams('one'),
+  )
+
+  assert.equal(response.status, 200)
+  const payload = await response.json() as Record<string, unknown>
+  assert.equal(payload.scheduleId, 'one')
+  assert.equal(payload.revision, 2)
+  const history = payload.history as Array<Record<string, unknown>>
+  assert.equal(history.length, 1)
+  assert.equal(history[0].action, 'updated')
+})

package/src/cli/index.js

@@ -579,6 +579,7 @@ const COMMAND_GROUPS = [
     commands: [
       cmd('list', 'GET', '/schedules', 'List schedules'),
       cmd('get', 'GET', '/schedules/:id', 'Get schedule by id'),
+      cmd('history', 'GET', '/schedules/:id/history', 'Get schedule revision history'),
       cmd('create', 'POST', '/schedules', 'Create schedule', { expectsJsonBody: true }),
       cmd('update', 'PUT', '/schedules/:id', 'Update schedule', { expectsJsonBody: true }),
       cmd('delete', 'DELETE', '/schedules/:id', 'Delete schedule'),

package/src/cli/index.ts

@@ -608,6 +608,14 @@ export function buildProgram(): Command {
       await runWithHandler(this as Command, (ctx) => resolveByIdFromCollection(ctx, '/schedules', id))
     })
 
+  schedules
+    .command('history')
+    .description('Get schedule revision history')
+    .argument('<id>', 'Schedule id')
+    .action(async function (id: string) {
+      await runWithHandler(this as Command, (ctx) => apiRequest(ctx, 'GET', `/schedules/${encodeURIComponent(id)}/history`))
+    })
+
   schedules
     .command('create')
     .description('Create schedule')

package/src/cli/spec.js

@@ -420,6 +420,7 @@ const COMMAND_GROUPS = {
       list: { description: 'List schedules', method: 'GET', path: '/schedules' },
       create: { description: 'Create schedule', method: 'POST', path: '/schedules' },
       get: { description: 'Get schedule by id (from list)', virtualGet: true, collectionPath: '/schedules', params: ['id'] },
+      history: { description: 'Get schedule revision history', method: 'GET', path: '/schedules/:id/history', params: ['id'] },
       update: { description: 'Update schedule', method: 'PUT', path: '/schedules/:id', params: ['id'] },
       delete: { description: 'Delete schedule', method: 'DELETE', path: '/schedules/:id', params: ['id'] },
       run: { description: 'Trigger schedule immediately', method: 'POST', path: '/schedules/:id/run', params: ['id'] },

package/src/components/schedules/schedule-console.tsx

@@ -14,10 +14,10 @@ import { api } from '@/lib/app/api-client'
 import { archiveSchedule, purgeSchedule, restoreSchedule, runSchedule, updateSchedule } from '@/lib/schedules/schedules'
 import { cronToHuman } from '@/lib/schedules/cron-human'
 import { timeAgo, timeUntil } from '@/lib/time-format'
-import type { BoardTask, ProtocolRun, Schedule, ScheduleStatus } from '@/types'
+import type { BoardTask, ProtocolRun, Schedule, ScheduleHistoryEntry, ScheduleStatus } from '@/types'
 import { toast } from 'sonner'
 
-type ScheduleScope = 'live' | 'archived' | 'runs'
+type ScheduleScope = 'live' | 'archived' | 'runs' | 'history'
 type ScheduleFilterStatus = 'all' | ScheduleStatus
 type ScheduleRunStatusFilter = 'all' | Extract<BoardTask['status'], 'queued' | 'running' | 'completed' | 'failed' | 'cancelled'>
 type ScheduleCadenceFilter = 'all' | Schedule['scheduleType']
@@ -35,6 +35,12 @@ type ScheduleConsoleRunRow = {
   scheduleId: string | null
   scheduleName: string
 }
+type ScheduleHistoryRow = {
+  id: string
+  schedule: Schedule
+  entry: ScheduleHistoryEntry
+  searchText: string
+}
 
 const STATUS_STYLES: Record<string, string> = {
   active: 'bg-emerald-500/12 text-emerald-400 border-emerald-500/20',
@@ -139,6 +145,38 @@ function protocolRunPreview(run: ProtocolRun): string {
   return (goal || run.title || 'Structured session run').slice(0, 180)
 }
 
+function historyActionLabel(action: ScheduleHistoryEntry['action']): string {
+  switch (action) {
+    case 'created':
+      return 'Created'
+    case 'updated':
+      return 'Updated'
+    case 'archived':
+      return 'Archived'
+    case 'restored':
+      return 'Restored'
+    case 'run_started':
+      return 'Run started'
+    case 'skipped':
+      return 'Skipped'
+    case 'failed':
+      return 'Failed'
+    default:
+      return action
+  }
+}
+
+function historyActionBadge(action: ScheduleHistoryEntry['action']): string {
+  if (action === 'created' || action === 'restored' || action === 'run_started') return badgeClass('completed')
+  if (action === 'failed') return badgeClass('failed')
+  if (action === 'skipped' || action === 'archived') return badgeClass('paused')
+  return badgeClass('running')
+}
+
+function formatHistoryValue(value: string | null | undefined): string {
+  return value == null || value === '' ? 'empty' : value
+}
+
 function ActionButton(
   props: ButtonHTMLAttributes<HTMLButtonElement> & { tone?: 'default' | 'danger' },
 ) {
@@ -337,6 +375,42 @@ export function ScheduleConsole() {
       .sort((a, b) => b.updatedAt - a.updatedAt)
   }, [agentFilter, agents, cadenceFilter, projectScopedProtocolRuns, projectScopedRuns, runStatusFilter, schedules, search])
 
+  const filteredHistory = useMemo<ScheduleHistoryRow[]>(() => {
+    const q = search.trim().toLowerCase()
+    return projectScopedSchedules
+      .filter((schedule) => {
+        if (statusFilter !== 'all' && schedule.status !== statusFilter) return false
+        if (cadenceFilter !== 'all' && schedule.scheduleType !== cadenceFilter) return false
+        if (agentFilter !== 'all' && schedule.agentId !== agentFilter) return false
+        return true
+      })
+      .flatMap((schedule) => {
+        const agentName = agents[schedule.agentId]?.name || ''
+        const history = Array.isArray(schedule.history) ? schedule.history : []
+        return history.map((entry) => {
+          const changeText = Array.isArray(entry.changes)
+            ? entry.changes.map((change) => [change.label, change.before, change.after].filter(Boolean).join(' ')).join(' ')
+            : ''
+          return {
+            id: `${schedule.id}:${entry.id}`,
+            schedule,
+            entry,
+            searchText: [
+              schedule.name,
+              schedule.taskPrompt,
+              agentName,
+              entry.summary,
+              entry.actor,
+              historyActionLabel(entry.action),
+              changeText,
+            ].filter(Boolean).join(' ').toLowerCase(),
+          }
+        })
+      })
+      .filter((row) => !q || row.searchText.includes(q))
+      .sort((a, b) => b.entry.at - a.entry.at || b.entry.revision - a.entry.revision)
+  }, [agentFilter, agents, cadenceFilter, projectScopedSchedules, search, statusFilter])
+
   const handleArchive = async (scheduleId: string) => {
     setBusyId(scheduleId)
     try {
@@ -432,7 +506,11 @@ export function ScheduleConsole() {
     setSortBy('nextRunAt')
   }
 
-  const scopeCount = scope === 'runs' ? filteredRuns.length : filteredSchedules.length
+  const scopeCount = scope === 'runs'
+    ? filteredRuns.length
+    : scope === 'history'
+      ? filteredHistory.length
+      : filteredSchedules.length
 
   if (!loaded) {
     return <PageLoader label="Loading schedules..." />
@@ -464,6 +542,7 @@ export function ScheduleConsole() {
                   <FilterPill label="Live" active={scope === 'live'} onClick={() => setScope('live')} />
                   <FilterPill label="Archived" active={scope === 'archived'} onClick={() => setScope('archived')} />
                   <FilterPill label="Runs" active={scope === 'runs'} onClick={() => setScope('runs')} />
+                  <FilterPill label="History" active={scope === 'history'} onClick={() => setScope('history')} />
                 </div>
               </div>
               <div className="w-full lg:max-w-[360px]">
@@ -472,7 +551,11 @@ export function ScheduleConsole() {
                   value={search}
                   onChange={(e) => setSearch(e.target.value)}
                   onClear={() => setSearch('')}
-                  placeholder={scope === 'runs' ? 'Search runs, schedules, or agents...' : 'Search schedules, agents, or recipients...'}
+                  placeholder={scope === 'runs'
+                    ? 'Search runs, schedules, or agents...'
+                    : scope === 'history'
+                      ? 'Search history, schedules, or changes...'
+                      : 'Search schedules, agents, or recipients...'}
                 />
               </div>
             </div>
@@ -544,7 +627,7 @@ export function ScheduleConsole() {
                 </select>
               </label>
 
-              {scope !== 'runs' ? (
+              {scope !== 'runs' && scope !== 'history' ? (
                 <label className="text-[12px] text-text-3/70">
                   <span className="block mb-1.5 font-600 uppercase tracking-[0.08em] text-[10px]">Delivery</span>
                   <select
@@ -562,16 +645,26 @@ export function ScheduleConsole() {
 
               <label className="text-[12px] text-text-3/70">
                 <span className="block mb-1.5 font-600 uppercase tracking-[0.08em] text-[10px]">Sort</span>
-                <select
-                  value={sortBy}
-                  onChange={(e) => setSortBy(e.target.value as ScheduleSortBy)}
-                  className="w-full px-3 py-2.5 rounded-[12px] border border-white/[0.06] bg-surface text-text-2"
-                >
-                  <option value="nextRunAt">Next run</option>
-                  <option value="lastRunAt">Last run</option>
-                  <option value="updatedAt">Recently updated</option>
-                  <option value="name">Name</option>
-                </select>
+                {scope === 'history' ? (
+                  <select
+                    value="history"
+                    disabled
+                    className="w-full px-3 py-2.5 rounded-[12px] border border-white/[0.06] bg-surface text-text-3"
+                  >
+                    <option value="history">Newest changes</option>
+                  </select>
+                ) : (
+                  <select
+                    value={sortBy}
+                    onChange={(e) => setSortBy(e.target.value as ScheduleSortBy)}
+                    className="w-full px-3 py-2.5 rounded-[12px] border border-white/[0.06] bg-surface text-text-2"
+                  >
+                    <option value="nextRunAt">Next run</option>
+                    <option value="lastRunAt">Last run</option>
+                    <option value="updatedAt">Recently updated</option>
+                    <option value="name">Name</option>
+                  </select>
+                )}
               </label>
 
               <div className="flex items-end">
@@ -628,6 +721,71 @@ export function ScheduleConsole() {
                 )
               })}
             </div>
+          ) : scope === 'history' ? (
+            <div className="divide-y divide-white/[0.05]">
+              {filteredHistory.length === 0 ? (
+                <div className="px-5 py-10 text-center text-text-3/60">No schedule history matches the current filters.</div>
+              ) : filteredHistory.map((row) => {
+                const { schedule, entry } = row
+                const agent = agents[schedule.agentId]
+                const changes = Array.isArray(entry.changes) ? entry.changes.slice(0, 4) : []
+                const remainingChanges = Math.max(0, (entry.changes?.length || 0) - changes.length)
+                return (
+                  <div key={row.id} className="px-5 py-4 hover:bg-white/[0.02] transition-colors">
+                    <div className="flex flex-col gap-3 xl:flex-row xl:items-start xl:justify-between">
+                      <div className="min-w-0">
+                        <div className="flex flex-wrap items-center gap-2 mb-1.5">
+                          <span className={`px-2 py-0.5 rounded-[8px] border text-[10px] font-700 uppercase tracking-[0.08em] ${historyActionBadge(entry.action)}`}>
+                            {historyActionLabel(entry.action)}
+                          </span>
+                          <span className="text-[11px] text-text-3/60 uppercase tracking-[0.08em]">{schedule.scheduleType}</span>
+                          <span className="text-[11px] text-text-3/40 uppercase tracking-[0.08em]">rev {entry.revision}</span>
+                        </div>
+                        <div className="text-[15px] font-600 text-text-2">{schedule.name}</div>
+                        <div className="text-[13px] text-text-3 mt-1 line-clamp-2">{entry.summary}</div>
+                        {changes.length > 0 && (
+                          <div className="mt-3 grid grid-cols-1 md:grid-cols-2 gap-2">
+                            {changes.map((change) => (
+                              <div key={`${entry.id}:${change.field}`} className="rounded-[10px] border border-white/[0.06] bg-white/[0.025] px-3 py-2">
+                                <div className="text-[10px] uppercase tracking-[0.08em] text-text-3/50 font-700">{change.label}</div>
+                                <div className="mt-1 text-[12px] text-text-2 break-words">
+                                  <span className="text-text-3">{formatHistoryValue(change.before)}</span>
+                                  <span className="mx-1.5 text-text-3/40">-&gt;</span>
+                                  <span>{formatHistoryValue(change.after)}</span>
+                                </div>
+                              </div>
+                            ))}
+                            {remainingChanges > 0 && (
+                              <div className="rounded-[10px] border border-white/[0.06] bg-white/[0.025] px-3 py-2 text-[12px] text-text-3">
+                                {remainingChanges} more change{remainingChanges === 1 ? '' : 's'}
+                              </div>
+                            )}
+                          </div>
+                        )}
+                        <div className="flex flex-wrap items-center gap-2 mt-3">
+                          {agent && (
+                            <div className="inline-flex items-center gap-2 rounded-[10px] bg-white/[0.03] px-2.5 py-1.5 text-[12px] text-text-2">
+                              <AgentAvatar
+                                seed={agent.avatarSeed}
+                                avatarUrl={agent.avatarUrl}
+                                name={agent.name}
+                                size={16}
+                              />
+                              <span>{agent.name}</span>
+                            </div>
+                          )}
+                          <span className="text-[12px] text-text-3/60">{timeAgo(entry.at, now)}</span>
+                          <span className="text-[12px] text-text-3/50">Actor: {entry.actor}</span>
+                        </div>
+                      </div>
+                      <div className="flex flex-wrap items-center gap-2 shrink-0">
+                        <ActionButton onClick={() => openSchedule(schedule.id)}>Open Schedule</ActionButton>
+                      </div>
+                    </div>
+                  </div>
+                )
+              })}
+            </div>
           ) : (
             <div className="divide-y divide-white/[0.05]">
               {filteredSchedules.length === 0 ? (

package/src/lib/schedules/schedules.ts

@@ -1,5 +1,5 @@
 import { api } from '@/lib/app/api-client'
-import type { Schedule } from '@/types'
+import type { Schedule, ScheduleHistoryEntry } from '@/types'
 
 export interface ScheduleArchiveResponse {
   ok: boolean
@@ -19,6 +19,12 @@ export interface SchedulePurgeResponse {
   purgedIds: string[]
 }
 
+export interface ScheduleHistoryResponse {
+  scheduleId: string
+  revision: number
+  history: ScheduleHistoryEntry[]
+}
+
 export const fetchSchedules = (includeArchived = false) =>
   api<Record<string, Schedule>>('GET', `/schedules${includeArchived ? '?includeArchived=true' : ''}`)
 
@@ -42,3 +48,6 @@ export const purgeSchedule = (id: string) =>
 
 export const runSchedule = (id: string) =>
   api<{ ok: boolean; queued?: boolean; reason?: string; taskId?: string; runNumber?: number }>('POST', `/schedules/${id}/run`)
+
+export const fetchScheduleHistory = (id: string) =>
+  api<ScheduleHistoryResponse>('GET', `/schedules/${id}/history`)