@swarmclawai/swarmclaw 1.9.15 → 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:
@@ -399,6 +407,15 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.9.16 Highlights
+
+Agent planning controls release: strict planning is now a first-class agent setting instead of a hidden persisted field, so operators can decide which agents must expose machine-readable plans before multi-step work.
+
+- **Agent editor control.** Advanced agent settings now include a Standard / Strict planning selector with inline behavior guidance.
+- **Runtime prompt wiring.** Strict planning continues to inject the existing `[MAIN_LOOP_PLAN]` contract before multi-step tool work, and the test suite now keeps that prompt section in the runtime gate.
+- **Portable agent packs.** Agent exports preserve `planningMode`, so planning discipline follows agents across installs.
+- **API coverage.** Agent create and update route tests verify that strict planning persists without clobbering unrelated settings.
+
 ### v1.9.15 Highlights
 
 Run handoff release: SwarmClaw now turns completed, failed, queued, or running execution records into copyable handoff packets with outcome, evidence, artifacts, timeline, usage, resume commands, and recommended next actions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.9.15",
+  "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/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/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/agents/agents-route.test.ts

@@ -101,6 +101,27 @@ test('POST /api/agents accepts a valid provider and creates the agent', async ()
   saveAgents(agents)
 })
 
+test('POST /api/agents persists strict planning mode for created agents', async () => {
+  const response = await createAgent(new Request('http://local/api/agents', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({
+      name: 'Planning Agent',
+      provider: 'ollama',
+      model: 'qwen3.5',
+      planningMode: 'strict',
+    }),
+  }))
+
+  assert.equal(response.status, 200)
+  const body = await response.json()
+  assert.equal(body.planningMode, 'strict')
+
+  const agents = loadAgents()
+  delete agents[body.id]
+  saveAgents(agents)
+})
+
 test('POST /api/agents rejects missing required fields with a 400', async () => {
   const response = await createAgent(new Request('http://local/api/agents', {
     method: 'POST',
@@ -163,6 +184,28 @@ test('PUT /api/agents/:id does not clobber untouched fields with schema defaults
   assert.equal(body.proactiveMemory, false)
 })
 
+test('PUT /api/agents/:id updates planning mode without clobbering other fields', async () => {
+  seedAgent('agent-planning-mode', {
+    name: 'Planner',
+    tools: ['memory'],
+    planningMode: 'off',
+    proactiveMemory: false,
+  })
+
+  const response = await putAgent(new Request('http://local/api/agents/agent-planning-mode', {
+    method: 'PUT',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ planningMode: 'strict' }),
+  }), routeParams('agent-planning-mode'))
+
+  assert.equal(response.status, 200)
+  const body = await response.json()
+  assert.equal(body.planningMode, 'strict')
+  assert.equal(body.name, 'Planner')
+  assert.deepEqual(body.tools, ['memory'])
+  assert.equal(body.proactiveMemory, false)
+})
+
 test('PUT /api/agents/:id rejects non-string name', async () => {
   seedAgent('agent-bad-name', { name: 'Good' })
 

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

@@ -26,10 +26,13 @@ import { StatusDot } from '@/components/ui/status-dot'
 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'
@@ -238,6 +241,7 @@ export function AgentSheet() {
   const [memoryTierPreference, setMemoryTierPreference] = useState<'working' | 'durable' | 'archive' | 'blended'>('blended')
   const [proactiveMemory, setProactiveMemory] = useState(true)
   const [autoDraftSkillSuggestions, setAutoDraftSkillSuggestions] = useState(true)
+  const [planningMode, setPlanningMode] = useState<AgentPlanningMode>('off')
   const [autoRecovery, setAutoRecovery] = useState(false)
   const [disabled, setDisabled] = useState(false)
   const [filesystemScope, setFilesystemScope] = useState<'workspace' | 'machine'>('workspace')
@@ -290,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]
@@ -359,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)
@@ -444,6 +469,7 @@ export function AgentSheet() {
         setMemoryTierPreference(editing.memoryTierPreference || 'blended')
         setProactiveMemory(editing.proactiveMemory !== false)
         setAutoDraftSkillSuggestions(editing.autoDraftSkillSuggestions !== false)
+        setPlanningMode(normalizeAgentPlanningMode(editing.planningMode))
         setAutoRecovery(editing.autoRecovery || false)
         setDisabled(editing.disabled === true)
         setFilesystemScope(editing.filesystemScope === 'machine' ? 'machine' : 'workspace')
@@ -527,6 +553,7 @@ export function AgentSheet() {
         setMemoryTierPreference(src.memoryTierPreference || 'blended')
         setProactiveMemory(src.proactiveMemory !== false)
         setAutoDraftSkillSuggestions(src.autoDraftSkillSuggestions !== false)
+        setPlanningMode(normalizeAgentPlanningMode(src.planningMode))
         setAutoRecovery(src.autoRecovery || false)
         setDisabled(false)
         setFilesystemScope(src.filesystemScope === 'machine' ? 'machine' : 'workspace')
@@ -602,6 +629,7 @@ export function AgentSheet() {
         setMemoryTierPreference('blended')
         setProactiveMemory(true)
         setAutoDraftSkillSuggestions(true)
+        setPlanningMode('off')
         setAutoRecovery(false)
         setDisabled(false)
         setVoiceId('')
@@ -635,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
@@ -809,6 +848,7 @@ export function AgentSheet() {
       memoryTierPreference,
       proactiveMemory,
       autoDraftSkillSuggestions,
+      planningMode,
       autoRecovery,
       disabled,
       filesystemScope: filesystemScope === 'machine' ? 'machine' as const : undefined,
@@ -885,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) => (
@@ -916,6 +983,7 @@ export function AgentSheet() {
         extensions: getEnabledExtensionIds(editing),
         capabilities: editing.capabilities,
         elevenLabsVoiceId: editing.elevenLabsVoiceId || null,
+        planningMode: normalizeAgentPlanningMode(editing.planningMode),
         soul: editing.soul,
         systemPrompt: editing.systemPrompt,
       }],
@@ -1043,6 +1111,7 @@ export function AgentSheet() {
     if (projectId) badges.push('Project')
     if (thinkingLevel) badges.push('Thinking')
     if (!autoDraftSkillSuggestions) badges.push('Skill drafting')
+    if (planningMode === 'strict') badges.push('Planning')
     return Array.from(new Set(badges))
   }, [
     autoDraftSkillSuggestions,
@@ -1061,6 +1130,7 @@ export function AgentSheet() {
     memoryScopeMode,
     memoryTierPreference,
     proactiveMemory,
+    planningMode,
     projectId,
     routingStrategy,
     routingTargets.length,
@@ -1091,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 (
     <>
@@ -2145,7 +2216,15 @@ export function AgentSheet() {
           <option value="durable">Durable memory</option>
           <option value="archive">Archive memory</option>
         </select>
+        <select value={planningMode} onChange={(e) => setPlanningMode(normalizeAgentPlanningMode(e.target.value))} className={inputClass}>
+          {AGENT_PLANNING_MODE_OPTIONS.map((option) => (
+            <option key={option.value} value={option.value}>{option.label}</option>
+          ))}
+        </select>
       </div>
+      <p className="mb-4 text-[12px] leading-[1.6] text-text-3/70">
+        {describeAgentPlanningMode(planningMode)}
+      </p>
       <div className="space-y-3">
         <label className="flex items-center gap-3 cursor-pointer">
           <div
@@ -2770,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,
+  }
+}

package/src/lib/agent-planning-mode.test.ts

@@ -0,0 +1,32 @@
+import assert from 'node:assert/strict'
+import { test } from 'node:test'
+
+import {
+  AGENT_PLANNING_MODE_OPTIONS,
+  describeAgentPlanningMode,
+  isAgentPlanningModeEnabled,
+  normalizeAgentPlanningMode,
+} from './agent-planning-mode'
+
+test('normalizeAgentPlanningMode accepts only supported persisted values', () => {
+  assert.equal(normalizeAgentPlanningMode('strict'), 'strict')
+  assert.equal(normalizeAgentPlanningMode('off'), 'off')
+  assert.equal(normalizeAgentPlanningMode(null), 'off')
+  assert.equal(normalizeAgentPlanningMode(undefined), 'off')
+  assert.equal(normalizeAgentPlanningMode('unexpected'), 'off')
+})
+
+test('planning mode options include a safe default and strict mode', () => {
+  assert.deepEqual(
+    AGENT_PLANNING_MODE_OPTIONS.map((option) => option.value),
+    ['off', 'strict'],
+  )
+  assert.equal(isAgentPlanningModeEnabled('strict'), true)
+  assert.equal(isAgentPlanningModeEnabled('off'), false)
+  assert.equal(isAgentPlanningModeEnabled(null), false)
+})
+
+test('describeAgentPlanningMode returns operator-facing copy for each mode', () => {
+  assert.match(describeAgentPlanningMode('off'), /No extra plan contract/)
+  assert.match(describeAgentPlanningMode('strict'), /machine-readable plan block/)
+})

package/src/lib/agent-planning-mode.ts

@@ -0,0 +1,34 @@
+import type { Agent } from '@/types'
+
+export type AgentPlanningMode = NonNullable<Agent['planningMode']>
+
+export const AGENT_PLANNING_MODE_OPTIONS: ReadonlyArray<{
+  value: AgentPlanningMode
+  label: string
+  description: string
+}> = [
+  {
+    value: 'off',
+    label: 'Standard',
+    description: 'No extra plan contract. The agent can answer, plan, or act normally based on the task.',
+  },
+  {
+    value: 'strict',
+    label: 'Strict planning',
+    description: 'Require a machine-readable plan block before multi-step tool work so progress can be tracked.',
+  },
+]
+
+export function normalizeAgentPlanningMode(value: unknown): AgentPlanningMode {
+  return value === 'strict' ? 'strict' : 'off'
+}
+
+export function isAgentPlanningModeEnabled(value: Agent['planningMode'] | undefined): boolean {
+  return normalizeAgentPlanningMode(value) === 'strict'
+}
+
+export function describeAgentPlanningMode(value: Agent['planningMode'] | undefined): string {
+  const mode = normalizeAgentPlanningMode(value)
+  return AGENT_PLANNING_MODE_OPTIONS.find((option) => option.value === mode)?.description
+    || AGENT_PLANNING_MODE_OPTIONS[0].description
+}

package/src/types/agent.ts

@@ -301,6 +301,7 @@ export interface AgentPackEntry {
   extensions?: string[]
   capabilities?: string[]
   elevenLabsVoiceId?: string | null
+  planningMode?: 'off' | 'strict' | null
   soul?: string
   systemPrompt?: string
 }