@swarmclawai/swarmclaw 1.9.21 → 1.9.23

package/README.md

@@ -151,13 +151,13 @@ clawhub install swarmclaw
 
 [Browse on ClawHub](https://clawhub.ai/skills/swarmclaw)
 
-## v1.9.17 Highlights
+## v1.9.23 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.
+Schedule reliability is now more deterministic for recurring autonomous work, especially after restarts or stale stored timing state.
 
-- **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.
+- **Cron drift repair.** Active schedules repair stale future cron slots before they skip the nearest run.
+- **Stable stagger.** Staggered schedules keep a deterministic per-schedule offset.
+- **Mission continuity.** Schedule-created board tasks keep a persistent mission link across recurring runs.
 
 ## Hosted Deploys
 
@@ -409,6 +409,24 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.9.23 Highlights
+
+Schedule reliability release: recurring work now repairs stale timing state before it can skip the nearest run, and scheduled board tasks keep mission context across repeat launches.
+
+- **Cron drift repair.** Active cron schedules repair missing or invalid `nextRunAt` values and stale future cron slots before the scheduler decides whether work is due.
+- **Tick-time advancement.** Cron and interval schedules now advance from the scheduler tick time instead of the process wall clock, making restart and catch-up behavior deterministic.
+- **Stable stagger.** Schedule stagger offsets are deterministic per schedule, avoiding thundering-herd launches without moving a saved next-run target on every recompute.
+- **Mission continuity.** Schedule-created board tasks attach to a persistent mission link, so recurring runs share the same operational context.
+
+### v1.9.22 Highlights
+
+Research tools release: agents now get direct `web_extract` and `web_crawl` tools alongside `web_search`, `web_fetch`, and the unified `web` tool.
+
+- **Source-grounded extraction.** `web_extract` returns a page title, canonical URL, and readable content for known source URLs.
+- **Bounded crawls.** `web_crawl` walks same-origin links by default with conservative page and depth caps, plus an explicit external-link opt-in.
+- **Better routing.** Tool aliases, capability policy, planning hints, continuation recovery, and the chat UI all recognize the granular research tools.
+- **Regression coverage.** New tests cover action inference, tool-call translation, direct tool registration, extraction cleanup, and same-origin crawl bounds.
+
 ### v1.9.21 Highlights
 
 Provider diagnostics release: connection checks now return a structured step timeline across setup, provider settings, and agent editing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.9.21",
+  "version": "1.9.23",
   "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/electron-signing-config.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/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/provider-diagnostics.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/server/schedules/schedule-preview.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/preview/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/provider-diagnostics.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/server/schedules/schedule-timing.test.ts src/lib/server/schedules/schedule-preview.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/server/session-tools/web-crawl.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/preview/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/components/chat/activity-moment.tsx

@@ -19,6 +19,9 @@ const NOTABLE_TOOLS: Record<string, { label: string; color: string; icon: 'brain
   delegate_to_agent: { label: 'Delegating task', color: '#6366F1', icon: 'delegate' },
   check_delegation_status: { label: 'Checking delegation', color: '#6366F1', icon: 'delegate' },
   web_search: { label: 'Searched the web', color: '#22C55E', icon: 'search' },
+  web_fetch: { label: 'Read a web page', color: '#22C55E', icon: 'search' },
+  web_extract: { label: 'Extracted a web page', color: '#22C55E', icon: 'search' },
+  web_crawl: { label: 'Crawled a site', color: '#22C55E', icon: 'search' },
   connector_message_tool: { label: 'Sent a message', color: '#F97316', icon: 'message' },
 }
 
@@ -35,6 +38,7 @@ function extractSnippet(toolName: string, toolInput: string): string | null {
     if (toolName === 'check_delegation_status' && parsed.agentName) return parsed.agentName
     if (toolName.startsWith('delegate_to_') && parsed.task) return parsed.task
     if (toolName === 'web_search' && parsed.query) return parsed.query
+    if ((toolName === 'web_fetch' || toolName === 'web_extract' || toolName === 'web_crawl') && parsed.url) return parsed.url
     if (toolName === 'connector_message_tool' && parsed.to) return parsed.to
   } catch { /* ignore parse errors */ }
   return null

package/src/components/chat/tool-call-bubble.tsx

@@ -20,6 +20,8 @@ const TOOL_COLORS: Record<string, string> = {
   create_spreadsheet: '#10B981',
   web_search: '#3B82F6',
   web_fetch: '#3B82F6',
+  web_extract: '#3B82F6',
+  web_crawl: '#3B82F6',
   spawn_subagent: '#8B5CF6',
   delegate_to_agent: '#6366F1',
   check_delegation_status: '#6366F1',
@@ -77,6 +79,8 @@ export const TOOL_LABELS: Record<string, string> = {
   create_spreadsheet: 'Create Spreadsheet',
   web_search: 'Web Search',
   web_fetch: 'Web Fetch',
+  web_extract: 'Web Extract',
+  web_crawl: 'Web Crawl',
   claude_code: 'Claude Code',
   codex_cli: 'Codex CLI',
   opencode_cli: 'OpenCode CLI',
@@ -127,6 +131,8 @@ export const TOOL_DESCRIPTIONS: Record<string, string> = {
   create_spreadsheet: 'Create Excel or CSV files from structured data',
   web_search: 'Search the web for information',
   web_fetch: 'Fetch and read web page content',
+  web_extract: 'Extract readable content from a source URL',
+  web_crawl: 'Crawl a bounded set of pages from one site',
   claude_code: 'Enable delegation to Claude Code CLI',
   codex_cli: 'Enable delegation to OpenAI Codex CLI',
   opencode_cli: 'Enable delegation to OpenCode CLI',

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

@@ -162,6 +162,8 @@ function historyActionLabel(action: ScheduleHistoryEntry['action']): string {
       return 'Skipped'
     case 'failed':
       return 'Failed'
+    case 'repaired':
+      return 'Repaired'
     default:
       return action
   }
@@ -171,6 +173,7 @@ 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')
+  if (action === 'repaired') return badgeClass('running')
   return badgeClass('running')
 }
 

package/src/lib/server/capability-router.test.ts

@@ -26,7 +26,7 @@ test('routeTaskIntent keeps coding prompts prioritized over memory keywords', ()
 test('routeTaskIntent keeps hybrid research-plus-media prompts in research intent', () => {
   const decision = routeTaskIntent(
     'Can you tell me more if there is any news related to the US-Iran war, and can you send me some screenshots and give me a summary and maybe send me a voice note about it?',
-    ['web_search', 'web_fetch', 'browser', 'manage_connectors'],
+    ['web_search', 'web_fetch', 'web_crawl', 'browser', 'manage_connectors'],
     null,
     makeClassification({
       taskIntent: 'research',
@@ -39,7 +39,7 @@ test('routeTaskIntent keeps hybrid research-plus-media prompts in research inten
   )
 
   assert.equal(decision.intent, 'research')
-  assert.deepEqual(decision.preferredTools, ['web_search', 'web_fetch', 'browser', 'connector_message_tool'])
+  assert.deepEqual(decision.preferredTools, ['web_search', 'web_fetch', 'web_extract', 'web_crawl', 'browser', 'connector_message_tool'])
 })
 
 test('routeTaskIntent treats direct voice-note delivery as outreach', () => {
@@ -72,7 +72,7 @@ test('routeTaskIntent treats keep-watching update requests as research even with
   )
 
   assert.equal(decision.intent, 'research')
-  assert.deepEqual(decision.preferredTools, ['web_search', 'web_fetch'])
+  assert.deepEqual(decision.preferredTools, ['web_search', 'web_fetch', 'web_extract', 'web_crawl'])
 })
 
 test('routeTaskIntent uses structured classification when available', () => {
@@ -99,7 +99,7 @@ test('routeTaskIntent uses structured classification when available', () => {
   )
 
   assert.equal(decision.intent, 'browsing')
-  assert.deepEqual(decision.preferredTools, ['browser', 'web_fetch'])
+  assert.deepEqual(decision.preferredTools, ['browser', 'web_fetch', 'web_extract'])
 })
 
 function makeClassification(overrides: Partial<MessageClassification>): MessageClassification {

package/src/lib/server/capability-router.ts

@@ -144,6 +144,7 @@ export function routeTaskIntent(
       [
         TOOL_CAPABILITY.researchSearch,
         TOOL_CAPABILITY.researchFetch,
+        TOOL_CAPABILITY.researchCrawl,
         ...(wantsScreenshots ? [TOOL_CAPABILITY.browserCapture] : []),
         ...(wantsVoiceDelivery ? [TOOL_CAPABILITY.deliveryVoiceNote] : []),
         ...(wantsOutboundDelivery ? [TOOL_CAPABILITY.deliveryMedia, TOOL_CAPABILITY.deliveryMessage] : []),

package/src/lib/server/chat-execution/chat-execution-advanced.test.ts

@@ -407,6 +407,33 @@ describe('translateRequestedToolInvocation advanced', () => {
     assert.equal(args.action, 'search')
     assert.equal(args.query, 'test query')
   })
+
+  it('maps web_extract to web with action=extract', () => {
+    const { toolName, args } = translateRequestedToolInvocation(
+      'web_extract',
+      { url: 'https://example.com/source' },
+      '',
+      ['web'],
+    )
+    assert.equal(toolName, 'web')
+    assert.equal(args.action, 'extract')
+    assert.equal(args.url, 'https://example.com/source')
+  })
+
+  it('maps web_crawl to web with bounded crawl arguments', () => {
+    const { toolName, args } = translateRequestedToolInvocation(
+      'web_crawl',
+      { url: 'https://example.com/', maxPages: 4, maxDepth: 1, includeExternal: false },
+      '',
+      ['web'],
+    )
+    assert.equal(toolName, 'web')
+    assert.equal(args.action, 'crawl')
+    assert.equal(args.url, 'https://example.com/')
+    assert.equal(args.maxPages, 4)
+    assert.equal(args.maxDepth, 1)
+    assert.equal(args.includeExternal, false)
+  })
 })
 
 // ---------------------------------------------------------------------------

package/src/lib/server/chat-execution/chat-execution-utils.ts

@@ -127,6 +127,27 @@ export function translateRequestedToolInvocation(
       },
     }
   }
+  if (requestedName === 'web_extract') {
+    return {
+      toolName: 'web',
+      args: {
+        action: 'extract',
+        url: rawArgs.url,
+      },
+    }
+  }
+  if (requestedName === 'web_crawl') {
+    return {
+      toolName: 'web',
+      args: {
+        action: 'crawl',
+        url: rawArgs.url || rawArgs.query,
+        maxPages: rawArgs.maxPages ?? rawArgs.maxResults,
+        maxDepth: rawArgs.maxDepth,
+        includeExternal: rawArgs.includeExternal,
+      },
+    }
+  }
   if (requestedName === 'delegate_to_claude_code') {
     return { toolName: 'delegate', args: { ...rawArgs, backend: 'claude' } }
   }

package/src/lib/server/chat-execution/iteration-event-handler.ts

@@ -349,7 +349,7 @@ export async function processIterationEvents(opts: ProcessIterationEventsOpts):
       }
       if (
         boundedExternalExecutionTask
-        && ['http_request', 'web', 'web_search', 'web_fetch', 'browser'].includes(toolName)
+        && ['http_request', 'web', 'web_search', 'web_fetch', 'web_extract', 'web_crawl', 'browser'].includes(toolName)
         && countExternalExecutionResearchSteps(state.streamedToolEvents) >= 5
         && countDistinctExternalResearchHosts(state.streamedToolEvents) >= 3
       ) {

package/src/lib/server/chat-execution/stream-continuation.ts

@@ -196,7 +196,7 @@ function getRequestedArtifactStatus(params: {
 
 export function countExternalExecutionResearchSteps(toolEvents: MessageToolEvent[]): number {
   return toolEvents.filter((event) => {
-    return ['http_request', 'web', 'web_search', 'web_fetch', 'browser'].includes(event.name)
+    return ['http_request', 'web', 'web_search', 'web_fetch', 'web_extract', 'web_crawl', 'browser'].includes(event.name)
   }).length
 }
 
@@ -300,6 +300,8 @@ const RECOVERABLE_TOOL_ERROR_NAMES = new Set([
   'web',
   'web_search',
   'web_fetch',
+  'web_extract',
+  'web_crawl',
   'http_request',
 ])
 
@@ -390,6 +392,8 @@ export function getToolFrequencyHint(toolName: string, sessionExtensions: string
     case 'http_request':
     case 'web_search':
     case 'web_fetch':
+    case 'web_extract':
+    case 'web_crawl':
       return 'Hint: You have done extensive research. Stop gathering more sources and use the information you already have to complete the task.'
 
     case 'spawn_subagent':
@@ -490,7 +494,7 @@ function buildDeliverableFollowthroughPrompt(params: {
   }
 
   if (
-    params.toolEvents.some((event) => ['web', 'web_search', 'web_fetch', 'browser', 'http_request'].includes(event.name))
+    params.toolEvents.some((event) => ['web', 'web_search', 'web_fetch', 'web_extract', 'web_crawl', 'browser', 'http_request'].includes(event.name))
     && !params.toolEvents.some((event) => ['files', 'write_file', 'edit_file', 'shell', 'execute_command'].includes(event.name))
   ) {
     lines.push(

package/src/lib/server/plugins-advanced.test.ts

@@ -135,11 +135,13 @@ describe('expandExtensionIds', () => {
     }
   })
 
-  it('web expands to include web_search and web_fetch', () => {
+  it('web expands to include granular web tools', () => {
     const result = expandExtensionIds(['web'])
     assert.ok(result.includes('web'))
     assert.ok(result.includes('web_search'))
     assert.ok(result.includes('web_fetch'))
+    assert.ok(result.includes('web_extract'))
+    assert.ok(result.includes('web_crawl'))
   })
 
   it('removes duplicates after expansion', () => {
@@ -199,12 +201,14 @@ describe('expandExtensionIds', () => {
 // getExtensionAliases
 // ---------------------------------------------------------------------------
 describe('getExtensionAliases', () => {
-  it('web returns [web, web_search, web_fetch]', () => {
+  it('web returns the full web alias group', () => {
     const result = getExtensionAliases('web')
     assert.ok(result.includes('web'))
     assert.ok(result.includes('web_search'))
     assert.ok(result.includes('web_fetch'))
-    assert.equal(result.length, 5) // web, web_search, web_fetch, http_request, http
+    assert.ok(result.includes('web_extract'))
+    assert.ok(result.includes('web_crawl'))
+    assert.equal(result.length, 7) // web, web_search, web_fetch, web_extract, web_crawl, http_request, http
   })
 
   it('web_search returns the same group as web', () => {

package/src/lib/server/runtime/scheduler.test.ts

@@ -202,6 +202,135 @@ describe('scheduler wake targeting', () => {
     assert.deepEqual(output.deliveryModes, ['silent'])
   })
 
+  it('repairs stale future cron next-run slots without launching a run', () => {
+    const output = runSchedulerWithTempDataDir(`
+      const storageMod = await import('@/lib/server/storage')
+      const schedulerMod = await import('@/lib/server/runtime/scheduler')
+      const storage = storageMod.default || storageMod
+      const scheduler = schedulerMod.default || schedulerMod
+
+      const now = Date.parse('2026-05-06T07:30:00.000Z')
+      const staleFuture = Date.parse('2026-05-12T08:00:00.000Z')
+
+      storage.saveSchedules({
+        'sched-cron': {
+          id: 'sched-cron',
+          name: 'Daily status',
+          agentId: 'agent-1',
+          taskPrompt: 'Send the daily status.',
+          scheduleType: 'cron',
+          cron: '0 8 * * *',
+          timezone: 'UTC',
+          status: 'active',
+          nextRunAt: staleFuture,
+          createdAt: now - 10_000,
+          updatedAt: now - 10_000,
+        },
+      })
+
+      await scheduler.runSchedulerTickForTests(now)
+      const schedule = storage.loadSchedules()['sched-cron']
+
+      console.log(JSON.stringify({
+        status: schedule.status,
+        nextRunAt: schedule.nextRunAt,
+        taskCount: Object.keys(storage.loadTasks()).length,
+        historyAction: schedule.history?.[0]?.action || null,
+        historyReason: schedule.history?.[0]?.metadata?.reason || null,
+      }))
+    `)
+
+    assert.equal(output.status, 'active')
+    assert.equal(output.nextRunAt, Date.parse('2026-05-06T08:00:00.000Z'))
+    assert.equal(output.taskCount, 0)
+    assert.equal(output.historyAction, 'repaired')
+    assert.equal(output.historyReason, 'stale_future')
+  })
+
+  it('advances cron schedules from the scheduler tick time after firing', () => {
+    const output = runSchedulerWithTempDataDir(`
+      const storageMod = await import('@/lib/server/storage')
+      const schedulerMod = await import('@/lib/server/runtime/scheduler')
+      const heartbeatWakeMod = await import('@/lib/server/runtime/heartbeat-wake')
+      const storage = storageMod.default || storageMod
+      const scheduler = schedulerMod.default || schedulerMod
+      const heartbeatWake = heartbeatWakeMod.default || heartbeatWakeMod
+
+      const now = Date.parse('2030-01-01T08:00:30.000Z')
+      const dueAt = Date.parse('2030-01-01T08:00:00.000Z')
+
+      storage.saveAgents({
+        'agent-1': {
+          id: 'agent-1',
+          name: 'Daily Agent',
+          description: '',
+          systemPrompt: '',
+          provider: 'openai',
+          model: 'gpt-test',
+          threadSessionId: 'thread-main',
+          createdAt: now - 10_000,
+          updatedAt: now - 10_000,
+        },
+      })
+
+      storage.saveSessions({
+        'thread-main': {
+          id: 'thread-main',
+          name: 'Daily Agent',
+          cwd: process.env.WORKSPACE_DIR,
+          user: 'tester',
+          provider: 'openai',
+          model: 'gpt-test',
+          claudeSessionId: null,
+          messages: [],
+          createdAt: now - 10_000,
+          lastActiveAt: now - 5_000,
+          active: true,
+          currentRunId: null,
+          agentId: 'agent-1',
+          shortcutForAgentId: 'agent-1',
+        },
+      })
+
+      storage.saveSchedules({
+        'sched-cron': {
+          id: 'sched-cron',
+          name: 'Daily wake',
+          agentId: 'agent-1',
+          taskPrompt: 'Wake for the daily status.',
+          taskMode: 'wake_only',
+          message: 'Run the daily status.',
+          scheduleType: 'cron',
+          cron: '0 8 * * *',
+          timezone: 'UTC',
+          status: 'active',
+          nextRunAt: dueAt,
+          createdInSessionId: 'thread-main',
+          createdAt: now - 10_000,
+          updatedAt: now - 10_000,
+        },
+      })
+
+      await scheduler.runSchedulerTickForTests(now)
+      const schedule = storage.loadSchedules()['sched-cron']
+      const wakes = heartbeatWake.snapshotPendingHeartbeatWakesForTests()
+
+      console.log(JSON.stringify({
+        status: schedule.status,
+        nextRunAt: schedule.nextRunAt,
+        runNumber: schedule.runNumber,
+        historyAction: schedule.history?.[0]?.action || null,
+        wakeCount: wakes.length,
+      }))
+    `)
+
+    assert.equal(output.status, 'active')
+    assert.equal(output.nextRunAt, Date.parse('2030-01-02T08:00:00.000Z'))
+    assert.equal(output.runNumber, 1)
+    assert.equal(output.historyAction, 'run_started')
+    assert.equal(output.wakeCount, 1)
+  })
+
   it('reuses a persistent mission for scheduled task runs', () => {
     const output = runSchedulerWithTempDataDir(`
       const storageMod = await import('@/lib/server/storage')

package/src/lib/server/runtime/scheduler.ts

@@ -2,7 +2,6 @@ import { listAgents } from '@/lib/server/agents/agent-repository'
 import { loadSchedules, upsertSchedule, upsertSchedules } from '@/lib/server/schedules/schedule-repository'
 import { loadTasks, upsertTask } from '@/lib/server/tasks/task-repository'
 import { enqueueTask } from '@/lib/server/runtime/queue'
-import { CronExpressionParser } from 'cron-parser'
 import { pushMainLoopEventToMainSessions } from '@/lib/server/agents/main-agent-loop'
 import { getScheduleSignatureKey } from '@/lib/schedules/schedule-dedupe'
 import { dispatchWake } from '@/lib/server/runtime/wake-dispatcher'
@@ -14,6 +13,7 @@ import { hasActiveProtocolRunForSchedule, launchProtocolRunForSchedule } from '@
 import { hmrSingleton } from '@/lib/shared-utils'
 import { log } from '@/lib/server/logger'
 import { appendScheduleHistoryEntry } from '@/lib/server/schedules/schedule-history'
+import { assessScheduleNextRunRepair, computeScheduleNextRunAt } from '@/lib/server/schedules/schedule-timing'
 import type { Schedule } from '@/types'
 
 const TAG = 'scheduler'
@@ -52,7 +52,7 @@ export function startScheduler() {
   if (schedulerState.intervalId) return
   log.info(TAG, 'Starting scheduler engine (60s tick)')
 
-  // Compute initial nextRunAt for cron schedules missing it
+  // Compute initial timing and repair stale nextRunAt values before the first tick.
   computeNextRuns()
 
   schedulerState.intervalId = setInterval(tick, TICK_INTERVAL)
@@ -66,32 +66,64 @@ export function stopScheduler() {
   }
 }
 
-function computeNextRuns() {
+function computeNextRuns(now = Date.now()): Record<string, Schedule> {
   const schedules = loadSchedules()
   const changedEntries: Array<[string, Schedule]> = []
   for (const schedule of Object.values(schedules)) {
     if (schedule.status !== 'active') continue
-    if (schedule.scheduleType === 'cron' && schedule.cron && !schedule.nextRunAt) {
-      try {
-        const interval = CronExpressionParser.parse(
-          schedule.cron,
-          schedule.timezone ? { tz: schedule.timezone } : undefined,
-        )
-        schedule.nextRunAt = interval.next().getTime()
-        changedEntries.push([schedule.id, schedule])
-      } catch (err) {
-        log.error(TAG, `Invalid cron for ${schedule.id}:`, err)
-        schedule.status = 'failed'
-        changedEntries.push([schedule.id, schedule])
-      }
+    const assessment = assessScheduleNextRunRepair(schedule, now)
+    if (!assessment.ok) {
+      log.error(TAG, `Invalid cron for ${schedule.id}`)
+      const failedSchedule = appendScheduleHistoryEntry({
+        ...schedule,
+        status: 'failed',
+        updatedAt: now,
+      }, {
+        now,
+        actor: 'system',
+        action: 'failed',
+        summary: `Schedule failed because cron could not be parsed: "${schedule.name}"`,
+        changes: [{
+          field: 'status',
+          label: 'Status',
+          before: 'active',
+          after: 'failed',
+        }],
+        metadata: { reason: 'invalid_cron' },
+      })
+      schedules[schedule.id] = failedSchedule
+      changedEntries.push([schedule.id, failedSchedule])
+      continue
+    }
+    if (assessment.repair) {
+      const repairedSchedule = appendScheduleHistoryEntry({
+        ...schedule,
+        nextRunAt: assessment.nextRunAt,
+        updatedAt: now,
+      }, {
+        now,
+        actor: 'system',
+        action: 'repaired',
+        summary: `Schedule timing repaired: "${schedule.name}"`,
+        changes: [{
+          field: 'nextRunAt',
+          label: 'Next run',
+          before: assessment.previousNextRunAt == null ? null : String(assessment.previousNextRunAt),
+          after: String(assessment.nextRunAt),
+        }],
+        metadata: { reason: assessment.reason },
+      })
+      schedules[schedule.id] = repairedSchedule
+      changedEntries.push([schedule.id, repairedSchedule])
     }
   }
   if (changedEntries.length > 0) upsertSchedules(changedEntries)
+  return schedules
 }
 
 async function tick(now = Date.now()) {
   await processDueWatchJobs(now)
-  const schedules = loadSchedules()
+  const schedules = computeNextRuns(now)
   const agents = listAgents()
   const tasks = loadTasks()
   const inFlightScheduleKeys = new Set<string>(
@@ -101,27 +133,22 @@ async function tick(now = Date.now()) {
       .filter((value: string) => value.length > 0),
   )
 
-  const applyStagger = (ts: number, staggerSec: number | null | undefined): number => {
-    if (!staggerSec || staggerSec <= 0) return ts
-    return ts + Math.floor(Math.random() * staggerSec * 1000)
-  }
-
   const advanceSchedule = (schedule: Schedule): void => {
-    if (schedule.scheduleType === 'cron' && schedule.cron) {
-      try {
-        const interval = CronExpressionParser.parse(
-          schedule.cron,
-          schedule.timezone ? { tz: schedule.timezone } : undefined,
-        )
-        schedule.nextRunAt = applyStagger(interval.next().getTime(), schedule.staggerSec)
-      } catch {
-        schedule.status = 'failed'
-      }
-    } else if (schedule.scheduleType === 'interval' && schedule.intervalMs) {
-      schedule.nextRunAt = applyStagger(now + schedule.intervalMs, schedule.staggerSec)
-    } else if (schedule.scheduleType === 'once') {
+    if (schedule.scheduleType === 'once') {
       schedule.status = 'completed'
       schedule.nextRunAt = undefined
+      return
+    }
+
+    try {
+      const nextRunAt = computeScheduleNextRunAt(schedule, now)
+      if (nextRunAt == null) {
+        schedule.status = 'failed'
+      } else {
+        schedule.nextRunAt = nextRunAt
+      }
+    } catch {
+      schedule.status = 'failed'
     }
   }
 

package/src/lib/server/schedules/schedule-history.test.ts

@@ -118,4 +118,18 @@ describe('schedule history', () => {
     assert.equal(history[24].id, 'hist-5')
     assert.equal(schedule.revision, 30)
   })
+
+  it('retains scheduler repair history entries', () => {
+    const history = normalizeScheduleHistory([{
+      id: 'hist-repair',
+      at: 1_000,
+      actor: 'system',
+      action: 'repaired',
+      revision: 1,
+      summary: 'Schedule timing repaired',
+    }])
+
+    assert.equal(history.length, 1)
+    assert.equal(history[0].action, 'repaired')
+  })
 })

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

@@ -57,6 +57,7 @@ const HISTORY_ACTIONS = new Set<ScheduleHistoryAction>([
   'run_started',
   'skipped',
   'failed',
+  'repaired',
 ])
 
 function cleanActor(value: string): string {