@swarmclawai/swarmclaw 1.9.16 → 1.9.17

package/README.md

@@ -149,6 +149,14 @@ clawhub install swarmclaw
 
 [Browse on ClawHub](https://clawhub.ai/skills/swarmclaw)
 
+## v1.9.17 Highlights
+
+Agent configuration history is now visible in the agent editor, so operators can review recent saved versions and restore prior settings without leaving the agent workflow.
+
+- **Agent sheet history.** Advanced agent settings list recent saved versions with timestamp, actor, and provider/model snapshot.
+- **One-click restore.** Restoring a prior version uses the existing config-version restore API, refreshes agent state, and closes the sheet to avoid stale form data.
+- **Regression coverage.** New tests cover config-version list/restore routes and UI summary formatting.
+
 ## Hosted Deploys
 
 SwarmClaw now ships provider-ready deploy files at the repo root:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.9.16",
+  "version": "1.9.17",
   "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",
@@ -88,7 +88,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/agent-planning-mode.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/prompt-sections.planning-mode.test.ts src/lib/server/chat-execution/reasoning-tag-scrubber.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/chats/session-context-pack.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/runs/run-handoff.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/quality/architecture-health.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-execution-policy.test.ts src/lib/server/tasks/task-handoff.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-pack-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/runs/run-handoff-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:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/agent-planning-mode.test.ts src/lib/agent-config-history.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/prompt-sections.planning-mode.test.ts src/lib/server/chat-execution/reasoning-tag-scrubber.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/chats/session-context-pack.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/runs/run-handoff.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/quality/architecture-health.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-execution-policy.test.ts src/lib/server/tasks/task-handoff.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-pack-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/config-versions/config-versions-route.test.ts src/app/api/runs/run-handoff-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/config-versions/config-versions-route.test.ts

@@ -0,0 +1,81 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { runWithTempDataDir } from '@/lib/server/test-utils/run-with-temp-data-dir'
+
+test('config version routes list and restore prior agent settings', () => {
+  const output = runWithTempDataDir<{
+    updateStatus: number
+    listStatus: number
+    restoreStatus: number
+    versionCount: number
+    versionName: string | null
+    restoredName: string | null
+    restoredModel: string | null
+  }>(`
+    const storageMod = await import('./src/lib/server/storage')
+    const agentRouteMod = await import('./src/app/api/agents/[id]/route')
+    const configRouteMod = await import('./src/app/api/config-versions/route')
+    const restoreRouteMod = await import('./src/app/api/config-versions/restore/route')
+    const storage = storageMod.default || storageMod
+    const agentRoute = agentRouteMod.default || agentRouteMod
+    const configRoute = configRouteMod.default || configRouteMod
+    const restoreRoute = restoreRouteMod.default || restoreRouteMod
+
+    const now = Date.now()
+    storage.saveAgents({
+      agent_history_1: {
+        id: 'agent_history_1',
+        name: 'Before Save',
+        description: 'Original',
+        systemPrompt: '',
+        provider: 'ollama',
+        model: 'qwen3.5',
+        credentialId: null,
+        fallbackCredentialIds: [],
+        apiEndpoint: null,
+        gatewayProfileId: null,
+        extensions: [],
+        createdAt: now,
+        updatedAt: now,
+      },
+    })
+
+    const params = { params: Promise.resolve({ id: 'agent_history_1' }) }
+    const updateResponse = await agentRoute.PUT(new Request('http://local/api/agents/agent_history_1', {
+      method: 'PUT',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ name: 'After Save', model: 'qwen3.6' }),
+    }), params)
+
+    const listResponse = await configRoute.GET(new Request('http://local/api/config-versions?entityKind=agent&entityId=agent_history_1'))
+    const listPayload = await listResponse.json()
+    const firstVersion = listPayload.versions?.[0] || null
+
+    const restoreResponse = await restoreRoute.POST(new Request('http://local/api/config-versions/restore', {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ versionId: firstVersion?.id }),
+    }))
+
+    const restored = storage.loadAgents().agent_history_1
+
+    console.log(JSON.stringify({
+      updateStatus: updateResponse.status,
+      listStatus: listResponse.status,
+      restoreStatus: restoreResponse.status,
+      versionCount: Array.isArray(listPayload.versions) ? listPayload.versions.length : 0,
+      versionName: firstVersion?.snapshot?.name || null,
+      restoredName: restored?.name || null,
+      restoredModel: restored?.model || null,
+    }))
+  `, { prefix: 'swarmclaw-config-versions-route-' })
+
+  assert.equal(output.updateStatus, 200)
+  assert.equal(output.listStatus, 200)
+  assert.equal(output.restoreStatus, 200)
+  assert.equal(output.versionCount, 1)
+  assert.equal(output.versionName, 'Before Save')
+  assert.equal(output.restoredName, 'Before Save')
+  assert.equal(output.restoredModel, 'qwen3.5')
+})

package/src/components/agents/agent-sheet.tsx

@@ -27,10 +27,12 @@ import { resolveStoredOllamaMode } from '@/lib/ollama-mode'
 import { errorMessage } from '@/lib/shared-utils'
 import { getDefaultAgentToolIds } from '@/lib/agent-default-tools'
 import { AGENT_PLANNING_MODE_OPTIONS, describeAgentPlanningMode, normalizeAgentPlanningMode, type AgentPlanningMode } from '@/lib/agent-planning-mode'
+import { buildAgentConfigVersionSummary } from '@/lib/agent-config-history'
 import { getEnabledExtensionIds, getEnabledToolIds } from '@/lib/capability-selection'
 import { buildAgentSelectableProviders, resolveAgentSelectableProviderCredentials } from '@/lib/agent-provider-options'
 import { AgentSocialSettings } from '@/features/swarmfeed/agent-social-settings'
 import { AgentMarketplaceSettings } from '@/features/swarmdock/agent-marketplace-settings'
+import type { ConfigVersion } from '@/types/config-version'
 
 const HB_PRESETS = [1800, 3600, 7200, 21600, 43200] as const
 const FALLBACK_ELEVENLABS_VOICE_ID = 'JBFqnCBsd6RMkjVDRZzb'
@@ -292,6 +294,10 @@ export function AgentSheet() {
   const lastAutoSyncedModelsKeyRef = useRef<string | null>(null)
   const skipAutoModelRef = useRef(false)
   const [showAdvancedSettings, setShowAdvancedSettings] = useState(false)
+  const [configVersions, setConfigVersions] = useState<ConfigVersion[]>([])
+  const [configVersionsLoading, setConfigVersionsLoading] = useState(false)
+  const [configVersionsError, setConfigVersionsError] = useState<string | null>(null)
+  const [restoringConfigVersionId, setRestoringConfigVersionId] = useState<string | null>(null)
 
   const handleFileUpload = (setter: (v: string) => void) => (e: React.ChangeEvent<HTMLInputElement>) => {
     const file = e.target.files?.[0]
@@ -361,6 +367,23 @@ export function AgentSheet() {
     return { synced: !sameModels, models: result.models }
   }, [agentSelectableProviders, loadProviders, openclawEnabled])
 
+  const loadAgentConfigVersions = useCallback(async (agentId: string) => {
+    setConfigVersionsLoading(true)
+    setConfigVersionsError(null)
+    try {
+      const response = await api<{ versions: ConfigVersion[] }>(
+        'GET',
+        `/config-versions?entityKind=agent&entityId=${encodeURIComponent(agentId)}`,
+      )
+      setConfigVersions(Array.isArray(response.versions) ? response.versions : [])
+    } catch (err) {
+      setConfigVersions([])
+      setConfigVersionsError(errorMessage(err))
+    } finally {
+      setConfigVersionsLoading(false)
+    }
+  }, [])
+
   const providerNeedsKey = !editing && (
     (currentProvider?.requiresApiKey && providerCredentials.length === 0 && !addingKey) ||
     (provider === 'ollama' && ollamaMode === 'cloud' && providerCredentials.length === 0 && !addingKey)
@@ -640,6 +663,17 @@ export function AgentSheet() {
   // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [open, editingId])
 
+  useEffect(() => {
+    if (!open || !editingId) {
+      setConfigVersions([])
+      setConfigVersionsError(null)
+      setConfigVersionsLoading(false)
+      setRestoringConfigVersionId(null)
+      return
+    }
+    void loadAgentConfigVersions(editingId)
+  }, [editingId, loadAgentConfigVersions, open])
+
   useEffect(() => {
     if (skipAutoModelRef.current) {
       skipAutoModelRef.current = false
@@ -891,6 +925,33 @@ export function AgentSheet() {
     }
   }
 
+  const handleRestoreConfigVersion = async (versionId: string) => {
+    if (!editing) return
+    const confirmed = window.confirm('Restore this saved agent configuration? Current settings will become a new history entry when restored.')
+    if (!confirmed) return
+    setRestoringConfigVersionId(versionId)
+    try {
+      await api('POST', '/config-versions/restore', { versionId })
+      await loadAgents()
+      if (
+        activeSessionId
+        && currentSession?.agentId === editing.id
+        && (
+          currentSession.shortcutForAgentId === editing.id
+          || activeSessionId === editing.threadSessionId
+        )
+      ) {
+        await refreshSession(activeSessionId)
+      }
+      toast.success('Agent configuration restored')
+      onClose()
+    } catch (err) {
+      toast.error(`Restore failed: ${errorMessage(err)}`)
+    } finally {
+      setRestoringConfigVersionId(null)
+    }
+  }
+
   const handleExport = () => {
     if (!editing) return
     const recommendedProviders = agentSelectableProviders.some((providerOption) => (
@@ -1100,6 +1161,7 @@ export function AgentSheet() {
   }
 
   const inputClass = "w-full px-4 py-3.5 rounded-[14px] border border-white/[0.08] bg-surface text-text text-[15px] outline-none transition-all duration-200 placeholder:text-text-3/50 focus-glow"
+  const configVersionSummaries = configVersions.map((version) => buildAgentConfigVersionSummary(version))
 
   return (
     <>
@@ -2787,6 +2849,63 @@ export function AgentSheet() {
       </div>
       </SectionCard>
 
+      {editing && (
+        <SectionCard
+          title="Configuration History"
+          description="Recent saved versions for this agent."
+          className="mb-6 border-white/[0.05] bg-white/[0.01]"
+          action={(
+            <button
+              type="button"
+              onClick={() => void loadAgentConfigVersions(editing.id)}
+              disabled={configVersionsLoading}
+              className="px-3 py-2 rounded-[10px] border border-white/[0.08] bg-transparent text-[12px] font-600 text-text-3 hover:bg-white/[0.04] hover:text-text-2 transition-all disabled:opacity-50"
+              style={{ fontFamily: 'inherit' }}
+            >
+              {configVersionsLoading ? 'Refreshing' : 'Refresh'}
+            </button>
+          )}
+        >
+          {configVersionsError ? (
+            <div className="rounded-[12px] border border-red-500/20 bg-red-500/[0.06] p-3 text-[13px] text-red-300">
+              {configVersionsError}
+            </div>
+          ) : configVersionsLoading && configVersionSummaries.length === 0 ? (
+            <div className="rounded-[12px] border border-white/[0.06] bg-white/[0.02] p-3 text-[13px] text-text-3">
+              Loading saved versions...
+            </div>
+          ) : configVersionSummaries.length === 0 ? (
+            <div className="rounded-[12px] border border-white/[0.06] bg-white/[0.02] p-3 text-[13px] text-text-3">
+              No saved versions yet.
+            </div>
+          ) : (
+            <div className="space-y-3">
+              {configVersionSummaries.slice(0, 8).map((summary) => (
+                <div
+                  key={summary.id}
+                  className="flex flex-col gap-3 rounded-[12px] border border-white/[0.06] bg-white/[0.02] p-3 sm:flex-row sm:items-center sm:justify-between"
+                >
+                  <div className="min-w-0">
+                    <div className="truncate text-[14px] font-700 text-text">{summary.title}</div>
+                    <div className="mt-1 truncate text-[12px] text-text-3">{summary.subtitle}</div>
+                    <div className="mt-1 text-[11px] text-text-3/70">{summary.meta}</div>
+                  </div>
+                  <button
+                    type="button"
+                    onClick={() => void handleRestoreConfigVersion(summary.id)}
+                    disabled={Boolean(restoringConfigVersionId)}
+                    className="shrink-0 rounded-[10px] border border-accent-bright/20 bg-accent-soft/30 px-3 py-2 text-[12px] font-700 text-accent-bright transition-all hover:bg-accent-soft disabled:opacity-50"
+                    style={{ fontFamily: 'inherit' }}
+                  >
+                    {restoringConfigVersionId === summary.id ? 'Restoring' : 'Restore'}
+                  </button>
+                </div>
+              ))}
+            </div>
+          )}
+        </SectionCard>
+      )}
+
       <SectionCard
         title="Utilities"
         description="Import and export agents."

package/src/lib/agent-config-history.test.ts

@@ -0,0 +1,50 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { buildAgentConfigVersionSummary, formatAgentConfigVersionAge } from './agent-config-history'
+import type { ConfigVersion } from '@/types/config-version'
+
+function makeVersion(overrides: Partial<ConfigVersion> = {}): ConfigVersion {
+  return {
+    id: 'version_1',
+    entityKind: 'agent',
+    entityId: 'agent_1',
+    actor: 'user',
+    approvalId: null,
+    note: null,
+    createdAt: 1_700_000_000_000,
+    snapshot: {
+      name: 'Release Agent',
+      provider: 'openai',
+      model: 'gpt-5.2',
+    },
+    ...overrides,
+  }
+}
+
+test('formatAgentConfigVersionAge formats compact relative ages', () => {
+  assert.equal(formatAgentConfigVersionAge(1_700_000_000_000, 1_700_000_030_000), 'just now')
+  assert.equal(formatAgentConfigVersionAge(1_700_000_000_000, 1_700_000_300_000), '5m ago')
+  assert.equal(formatAgentConfigVersionAge(1_700_000_000_000, 1_700_010_800_000), '3h ago')
+  assert.equal(formatAgentConfigVersionAge(1_700_000_000_000, 1_700_259_200_000), '3d ago')
+})
+
+test('buildAgentConfigVersionSummary surfaces useful agent snapshot labels', () => {
+  const summary = buildAgentConfigVersionSummary(makeVersion(), 1_700_000_300_000)
+
+  assert.equal(summary.id, 'version_1')
+  assert.equal(summary.title, 'Release Agent')
+  assert.equal(summary.subtitle, 'openai / gpt-5.2')
+  assert.equal(summary.meta, '5m ago by user')
+})
+
+test('buildAgentConfigVersionSummary handles sparse snapshots', () => {
+  const summary = buildAgentConfigVersionSummary(makeVersion({
+    actor: 'system',
+    snapshot: {},
+  }), 1_700_000_300_000)
+
+  assert.equal(summary.title, 'Previous agent settings')
+  assert.equal(summary.subtitle, 'No provider snapshot')
+  assert.equal(summary.meta, '5m ago by system')
+})

package/src/lib/agent-config-history.ts

@@ -0,0 +1,48 @@
+import type { ConfigVersion } from '@/types/config-version'
+
+export interface AgentConfigVersionSummary {
+  id: string
+  title: string
+  subtitle: string
+  meta: string
+  createdAt: number
+}
+
+function snapshotString(snapshot: Record<string, unknown>, key: string): string {
+  const value = snapshot[key]
+  return typeof value === 'string' && value.trim() ? value.trim() : ''
+}
+
+export function formatAgentConfigVersionAge(createdAt: number, now = Date.now()): string {
+  const ageMs = Math.max(0, now - createdAt)
+  const seconds = Math.floor(ageMs / 1000)
+  if (seconds < 60) return 'just now'
+  const minutes = Math.floor(seconds / 60)
+  if (minutes < 60) return `${minutes}m ago`
+  const hours = Math.floor(minutes / 60)
+  if (hours < 24) return `${hours}h ago`
+  const days = Math.floor(hours / 24)
+  return `${days}d ago`
+}
+
+export function buildAgentConfigVersionSummary(
+  version: ConfigVersion,
+  now = Date.now(),
+): AgentConfigVersionSummary {
+  const snapshot = version.snapshot || {}
+  const name = snapshotString(snapshot, 'name')
+  const provider = snapshotString(snapshot, 'provider')
+  const model = snapshotString(snapshot, 'model')
+  const title = name || 'Previous agent settings'
+  const subtitle = provider && model
+    ? `${provider} / ${model}`
+    : provider || model || 'No provider snapshot'
+
+  return {
+    id: version.id,
+    title,
+    subtitle,
+    meta: `${formatAgentConfigVersionAge(version.createdAt, now)} by ${version.actor || 'user'}`,
+    createdAt: version.createdAt,
+  }
+}