@swarmclawai/swarmclaw 1.8.12 → 1.8.13

package/README.md

@@ -8,13 +8,13 @@
   <img src="https://raw.githubusercontent.com/swarmclawai/swarmclaw/main/public/branding/swarmclaw-org-avatar.png" alt="SwarmClaw lobster logo" width="120" />
 </p>
 
-<p align="center"><strong>Self-hosted runtime for autonomous AI agents.</strong> Multi-provider, MCP-native, with memory, skills, delegation, and schedules.</p>
+<p align="center"><strong>The self-hosted AI agent runtime and multi-agent framework for autonomous agents.</strong> Open-source agent swarms with durable agent memory, MCP tools, skills, delegation, schedules, and 23+ LLM providers — a practical Claude Code and LangChain alternative.</p>
 
 <p align="center">
   <img src="doc/assets/screenshots/org-chart.png" alt="SwarmClaw org chart with delegation and live agent activity" width="900" />
 </p>
 
-SwarmClaw is a self-hosted AI runtime for OpenClaw and multi-agent work. It helps you run autonomous agents and orchestrators with heartbeats, schedules, delegation, memory, runtime skills, and reviewed conversation-to-skill learning across OpenClaw gateways and other providers.
+SwarmClaw is an open-source, self-hosted AI agent runtime and multi-agent framework. Run autonomous AI agents, agent swarms, and orchestrators with heartbeats, schedules, delegation, agent memory, runtime skills, and reviewed conversation-to-skill learning — across OpenClaw gateways, Claude, GPT, Gemini, OpenRouter, Ollama, and 23+ other providers. Use it as your AI agent dashboard, agent orchestration platform, and home base for self-hosted multi-agent AI workflows.
 
 GitHub: https://github.com/swarmclawai/swarmclaw  
 Docs: https://swarmclaw.ai/docs  
@@ -399,6 +399,14 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.8.13 Highlights
+
+Task retry and host execute hotfix for issues [#68](https://github.com/swarmclawai/swarmclaw/issues/68) and [#69](https://github.com/swarmclawai/swarmclaw/issues/69).
+
+- **Per-agent host execute.** Agents configured with `executeConfig.backend = "host"` now pass that setting into the runtime `execute` tool, so `persistent=true` uses the documented host backend.
+- **Scheduled task validation.** Schedule-created tasks no longer get auto-classified as implementation tasks for quality gates unless they explicitly opt into a task quality gate.
+- **Retry loop guard.** A task that fails again with the same retry reason is dead-lettered instead of spending another run on identical work.
+
 ### v1.8.12 Highlights
 
 Gateway Fleet Command release: SwarmClaw now treats OpenClaw gateways as an operator surface instead of a background provider detail.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.8.12",
+  "version": "1.8.13",
   "description": "Build and run autonomous AI agents with OpenClaw, Hermes, multiple model providers, orchestration, delegation, memory, skills, schedules, and chat connectors.",
   "main": "electron-dist/main.js",
   "license": "MIT",
@@ -87,7 +87,7 @@
     "test:cli": "node --test src/cli/*.test.js bin/*.test.js scripts/electron-after-pack.test.mjs scripts/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/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/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/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/operations/operation-pulse.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/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/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/tts/route.test.ts",
+    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/strip-internal-metadata.test.ts src/lib/provider-sets.test.ts src/lib/providers/opencode-cli.test.ts src/lib/providers/cli-provider-metadata.test.ts src/lib/providers/cli-utils.test.ts src/lib/providers/generic-cli.test.ts src/lib/server/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/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/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/runtime/queue-retry-policy.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/server/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/session-tools/execute.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/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/providers/[id]/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/lib/server/runtime/queue/core.ts

@@ -124,6 +124,14 @@ function applyTaskPolicyDefaults(task: BoardTask): void {
   if (task.deadLetteredAt === undefined) task.deadLetteredAt = null
 }
 
+function formatRetryError(reason: string): string {
+  return `Retry scheduled after failure: ${reason}`.slice(0, 500)
+}
+
+function isRepeatedRetryFailure(previousError: unknown, reason: string): boolean {
+  return typeof previousError === 'string' && previousError === formatRetryError(reason)
+}
+
 export interface TaskResumeState {
   claudeSessionId: string | null
   codexThreadId: string | null
@@ -971,9 +979,10 @@ function scheduleRetryOrDeadLetter(task: BoardTask, reason: string): 'retry' | '
   }
   applyTaskPolicyDefaults(task)
   const now = Date.now()
+  const repeatedRetryFailure = isRepeatedRetryFailure(task.error, reason)
   task.attempts = (task.attempts || 0) + 1
 
-  if ((task.attempts || 0) < (task.maxAttempts || 1)) {
+  if ((task.attempts || 0) < (task.maxAttempts || 1) && !repeatedRetryFailure) {
     const delayMs = jitteredBackoff((task.retryBackoffSec || 30) * 1000, Math.max(0, (task.attempts || 1) - 1), 6 * 3600_000)
     task.status = 'queued'
     task.retryScheduledAt = now + delayMs
@@ -982,7 +991,7 @@ function scheduleRetryOrDeadLetter(task: BoardTask, reason: string): 'retry' | '
     // recovery loop burns CPU re-queueing a task that can never run.
     task.checkoutRunId = null
     task.updatedAt = now
-    task.error = `Retry scheduled after failure: ${reason}`.slice(0, 500)
+    task.error = formatRetryError(reason)
     if (!task.comments) task.comments = []
     task.comments.push({
       id: genId(),

package/src/lib/server/runtime/queue-retry-policy.test.ts

@@ -0,0 +1,98 @@
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { test } from 'node:test'
+
+const repoRoot = path.resolve(path.dirname(new URL(import.meta.url).pathname), '../../../..')
+
+function runWithTempDataDir<T extends Record<string, unknown>>(script: string): T {
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'swarmclaw-queue-retry-policy-'))
+  try {
+    const result = spawnSync(process.execPath, ['--import', 'tsx', '--input-type=module', '--eval', script], {
+      cwd: repoRoot,
+      env: {
+        ...process.env,
+        DATA_DIR: path.join(tempDir, 'data'),
+        WORKSPACE_DIR: path.join(tempDir, 'workspace'),
+        SWARMCLAW_BUILD_MODE: '1',
+      },
+      encoding: 'utf-8',
+      timeout: 15000,
+    })
+    assert.equal(result.status, 0, result.stderr || result.stdout || 'subprocess failed')
+    const lines = (result.stdout || '')
+      .trim()
+      .split('\n')
+      .map((line) => line.trim())
+      .filter(Boolean)
+    const jsonLine = [...lines].reverse().find((line) => line.startsWith('{'))
+    return JSON.parse(jsonLine || '{}') as T
+  } finally {
+    fs.rmSync(tempDir, { recursive: true, force: true })
+  }
+}
+
+test('recoverStalledRunningTasks dead-letters repeated retry failures instead of repeating identical work', () => {
+  const output = runWithTempDataDir<{
+    result: { recovered: number; deadLettered: number }
+    status: string | null
+    attempts: number | null
+    queued: string[]
+    retryScheduledAt: number | null
+    deadLetteredAt: number | null
+    error: string | null
+  }>(`
+    const storageMod = await import('@/lib/server/storage')
+    const queueMod = await import('@/lib/server/runtime/queue')
+    const storage = storageMod.default || storageMod
+    const queue = queueMod.default || queueMod
+
+    const now = Date.now()
+    const reason = 'Detected stalled run after 5m without progress'
+    storage.saveSettings({
+      ...storage.loadSettings(),
+      taskStallTimeoutMin: 5,
+      taskRetryBackoffSec: 30,
+    })
+    storage.saveTasks({
+      repeat: {
+        id: 'repeat',
+        title: 'Repeated structural failure',
+        description: 'A task that already retried the same failure reason',
+        status: 'running',
+        agentId: 'agent-a',
+        startedAt: now - 600_000,
+        updatedAt: now - 600_000,
+        createdAt: now - 700_000,
+        maxAttempts: 3,
+        attempts: 1,
+        checkoutRunId: 'repeat-run-id',
+        error: 'Retry scheduled after failure: ' + reason,
+      },
+    })
+    storage.saveQueue([])
+
+    const result = queue.recoverStalledRunningTasks()
+    const task = storage.loadTasks().repeat
+    console.log(JSON.stringify({
+      result,
+      status: task?.status ?? null,
+      attempts: task?.attempts ?? null,
+      queued: storage.loadQueue(),
+      retryScheduledAt: task?.retryScheduledAt ?? null,
+      deadLetteredAt: task?.deadLetteredAt ?? null,
+      error: task?.error ?? null,
+    }))
+  `)
+
+  assert.equal(output.result.recovered, 0)
+  assert.equal(output.result.deadLettered, 1)
+  assert.equal(output.status, 'failed')
+  assert.equal(output.attempts, 2)
+  assert.deepEqual(output.queued, [])
+  assert.equal(output.retryScheduledAt, null)
+  assert.equal(typeof output.deadLetteredAt, 'number')
+  assert.match(output.error || '', /Dead-lettered after 2\/3 attempts/)
+})

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

@@ -94,6 +94,8 @@ export interface ToolBuildContext {
   fileAccessPolicy?: { allowedPaths?: string[]; blockedPaths?: string[] } | null
   /** Agent's sandbox config — passed to shell for session-scoped container execution */
   sandboxConfig?: NonNullable<Agent['sandboxConfig']> | null
+  /** Loaded agent record for tool builders that need per-agent runtime settings */
+  agentRecord?: Agent | null
   /** Agent's filesystem scope — 'machine' allows file access outside the workspace */
   filesystemScope?: 'workspace' | 'machine'
 }

package/src/lib/server/session-tools/execute.test.ts

@@ -1,7 +1,40 @@
-import { describe, it } from 'node:test'
 import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { describe, it, test } from 'node:test'
 import { redactSecrets, buildCredentialEnv } from './credential-env'
 
+const repoRoot = path.resolve(path.dirname(new URL(import.meta.url).pathname), '../../../..')
+
+function runWithTempDataDir<T extends Record<string, unknown>>(script: string): T {
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'swarmclaw-execute-tool-'))
+  try {
+    const result = spawnSync(process.execPath, ['--import', 'tsx', '--input-type=module', '--eval', script], {
+      cwd: repoRoot,
+      env: {
+        ...process.env,
+        DATA_DIR: path.join(tempDir, 'data'),
+        WORKSPACE_DIR: path.join(tempDir, 'workspace'),
+        SWARMCLAW_BUILD_MODE: '1',
+      },
+      encoding: 'utf-8',
+      timeout: 15000,
+    })
+    assert.equal(result.status, 0, result.stderr || result.stdout || 'subprocess failed')
+    const lines = (result.stdout || '')
+      .trim()
+      .split('\n')
+      .map((line) => line.trim())
+      .filter(Boolean)
+    const jsonLine = [...lines].reverse().find((line) => line.startsWith('{'))
+    return JSON.parse(jsonLine || '{}') as T
+  } finally {
+    fs.rmSync(tempDir, { recursive: true, force: true })
+  }
+}
+
 describe('credential-env', () => {
   describe('redactSecrets', () => {
     it('redacts secret values from text', () => {
@@ -56,3 +89,62 @@ describe('credential-env', () => {
     })
   })
 })
+
+test('buildExecuteTools uses the current agent executeConfig backend', () => {
+  const output = runWithTempDataDir<{
+    hostOutput: string
+    sandboxOutput: string
+  }>(`
+    const storageMod = await import('@/lib/server/storage')
+    const executeModImport = await import('./src/lib/server/session-tools/execute.ts')
+    const executeMod = executeModImport.default || executeModImport
+    const storage = storageMod.default || storageMod
+    const now = Date.now()
+
+    storage.saveAgents({
+      'agent-host': {
+        id: 'agent-host',
+        name: 'Host Agent',
+        provider: 'openai',
+        model: 'gpt-test',
+        executeConfig: { backend: 'host', network: { enabled: true }, timeout: 30 },
+        createdAt: now,
+        updatedAt: now,
+      },
+      'agent-sandbox': {
+        id: 'agent-sandbox',
+        name: 'Sandbox Agent',
+        provider: 'openai',
+        model: 'gpt-test',
+        createdAt: now,
+        updatedAt: now,
+      },
+    })
+
+    const makeContext = (agentId) => ({
+      cwd: process.cwd(),
+      ctx: { agentId, sessionId: 'session-' + agentId },
+      hasExtension: (name) => name === 'execute',
+      hasTool: (name) => name === 'execute',
+      cleanupFns: [],
+      commandTimeoutMs: 30000,
+      claudeTimeoutMs: 30000,
+      cliProcessTimeoutMs: 30000,
+      persistDelegateResumeId: () => {},
+      readStoredDelegateResumeId: () => null,
+      resolveCurrentSession: () => ({ id: 'session-' + agentId, agentId }),
+      activeExtensions: ['execute'],
+      agentRecord: storage.loadAgent(agentId),
+    })
+
+    const hostTool = executeMod.buildExecuteTools(makeContext('agent-host'))[0]
+    const sandboxTool = executeMod.buildExecuteTools(makeContext('agent-sandbox'))[0]
+    const hostOutput = await hostTool.invoke({ code: 'printf host-ok', persistent: true })
+    const sandboxOutput = await sandboxTool.invoke({ code: 'printf sandbox-no', persistent: true })
+
+    console.log(JSON.stringify({ hostOutput, sandboxOutput }))
+  `)
+
+  assert.equal(output.hostOutput, 'host-ok')
+  assert.match(output.sandboxOutput, /requires `executeConfig\.backend = "host"`/)
+})

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

@@ -26,6 +26,7 @@ import {
   normalizeAgentExecuteConfig,
   type AgentExecuteConfig,
 } from '@/lib/agent-execute-defaults'
+import { loadAgent } from '../storage'
 
 const TAG = 'execute'
 
@@ -310,9 +311,9 @@ registerNativeCapability('execute', ExecuteExtension)
 export function buildExecuteTools(bctx: ToolBuildContext) {
   if (!bctx.hasExtension('execute')) return []
 
-  // Resolve execute config from the agent
-  const session = bctx.resolveCurrentSession?.()
-  const agent = session?.agent as (Agent & { executeConfig?: ExecuteConfig }) | undefined
+  const agentId = typeof bctx.ctx?.agentId === 'string' ? bctx.ctx.agentId.trim() : ''
+  const agent = (bctx.agentRecord as (Agent & { executeConfig?: ExecuteConfig }) | null | undefined)
+    ?? (agentId ? (loadAgent(agentId) as (Agent & { executeConfig?: ExecuteConfig }) | null) : null)
   const executeConfig = normalizeAgentExecuteConfig(agent?.executeConfig)
 
   return [

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

@@ -1,6 +1,6 @@
 import { z } from 'zod'
 import { tool, type StructuredToolInterface } from '@langchain/core/tools'
-import type { Session } from '@/types'
+import type { Agent, Session } from '@/types'
 import { dedup, errorMessage } from '@/lib/shared-utils'
 import { loadSettings, loadSession, loadAgent, loadMcpServers, patchAgent, patchSession } from '../storage'
 import { loadRuntimeSettings } from '@/lib/server/runtime/runtime-settings'
@@ -221,6 +221,7 @@ export async function buildSessionTools(cwd: string, enabledExtensions: string[]
       activeExtensions,
       fileAccessPolicy: effectiveFileAccessPolicy,
       sandboxConfig: agentRecord?.sandboxConfig ?? null,
+      agentRecord: agentRecord as Agent | null,
       filesystemScope,
     }
 

package/src/lib/server/tasks/task-validation.test.ts

@@ -49,6 +49,39 @@ test('validateTaskCompletion still enforces stricter minimum for implementation
   assert.ok(validation.reasons.some((reason) => reason.includes('Result summary is too short')))
 })
 
+test('validateTaskCompletion does not auto-apply implementation quality gates to scheduled tasks', () => {
+  const validation = validateTaskCompletion({
+    title: '[Sched] Daily wiki hygiene (run #1)',
+    description: 'Run scripts/wiki-hygiene.mjs and post the digest to Slack.',
+    result: 'Ran node scripts/wiki-hygiene.mjs and posted the digest to Slack with exit code 0.',
+    sourceType: 'schedule',
+    sourceScheduleId: 'schedule-wiki',
+    error: null,
+  } as Partial<BoardTask>)
+
+  assert.equal(validation.ok, true)
+})
+
+test('validateTaskCompletion still enforces explicit quality gates on scheduled tasks', () => {
+  const validation = validateTaskCompletion({
+    title: '[Sched] Daily wiki hygiene (run #1)',
+    description: 'Run scripts/wiki-hygiene.mjs and post the digest to Slack.',
+    result: 'Ran node scripts/wiki-hygiene.mjs and posted the digest to Slack with exit code 0.',
+    sourceType: 'schedule',
+    sourceScheduleId: 'schedule-wiki',
+    qualityGate: {
+      enabled: true,
+      minResultChars: 20,
+      minEvidenceItems: 2,
+      requireVerification: true,
+    },
+    error: null,
+  } as Partial<BoardTask>)
+
+  assert.equal(validation.ok, false)
+  assert.ok(validation.reasons.some((reason) => reason.includes('verification evidence is required')))
+})
+
 test('validateTaskCompletion fails implementation task with unfinished next-step language', () => {
   const validation = validateTaskCompletion({
     title: 'Build weather dashboard',

package/src/lib/server/tasks/task-validation.ts

@@ -85,7 +85,8 @@ export function validateTaskCompletion(
   const report = options.report || null
   const hasExplicitQualityGate = !!task.qualityGate && typeof task.qualityGate === 'object'
   const qualityGate = normalizeTaskQualityGate(task.qualityGate || null, options.settings || null)
-  const implementationTask = IMPLEMENTATION_HINT.test(title) || IMPLEMENTATION_HINT.test(description)
+  const scheduleTask = task.sourceType === 'schedule' || typeof task.sourceScheduleId === 'string'
+  const implementationTask = !scheduleTask && (IMPLEMENTATION_HINT.test(title) || IMPLEMENTATION_HINT.test(description))
 
   if (error) reasons.push('Task has a non-empty error field.')
   if (/^untitled task$/i.test(title) && !description) {