@swarmclawai/swarmclaw 1.5.51 → 1.5.52

package/README.md

@@ -399,6 +399,12 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.5.52 Highlights
+
+- **Session X-Ray now surfaces the backend execution log** ([#48](https://github.com/swarmclawai/swarmclaw/pull/48), thanks to [@borislavnnikolov](https://github.com/borislavnnikolov)). The debug panel fetches entries from the SQLite execution log on open and merges them with in-memory message events, sorted by time. Expandable entries show provider, model, stream errors, duration, and token counts — the info that was previously invisible when Ollama or other local-model runs failed silently. A new **Tools** filter tab, an `exec` badge for log-sourced entries, an entry count in the stats bar, and a Refresh button round it out. New API route `GET /api/chats/:id/execution-log` with `limit`, `since`, and `category` query params, registered in the CLI manifest as `swarmclaw chats execution-log`.
+- **Execution errors now captured in the log** ([#48](https://github.com/swarmclawai/swarmclaw/pull/48)). `finalizeChatTurn()` writes a structured `error` entry to the execution log on terminal failure, recording provider, model, stream errors, duration, token counts, and whether a response was produced — so the Session X-Ray above actually has something to show.
+- **Fix: blank task-sheet no longer shows `"null"` under *Blocked By*** ([#47](https://github.com/swarmclawai/swarmclaw/pull/47), thanks to [@borislavnnikolov](https://github.com/borislavnnikolov)). A successful task create/update returns `error: null`, and the old `'error' in res` guard treated that as a truthy error and rendered `String(null)` as a red "null" string under the Blocked By field. Now only non-empty string errors trigger the UI, and `depError` is cleared on dialog close so stale state cannot leak across re-opens.
+
 ### v1.5.51 Highlights
 
 - **Desktop app now actually opens and renders on macOS**: packaged builds were broken in v1.5.50 by a stack of independent issues that each masked the next. This release unblocks the cold-boot path end to end. Measured cold-boot time on a populated install: ~1 second to first `/api/healthz` response, down from a hard 60-second timeout.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.5.51",
+  "version": "1.5.52",
   "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",

package/src/app/api/chats/[id]/execution-log/route.ts

@@ -0,0 +1,20 @@
+import { NextResponse } from 'next/server'
+import { notFound } from '@/lib/server/collection-helpers'
+import { getSession } from '@/lib/server/sessions/session-repository'
+import { queryLogs } from '@/lib/server/execution-log'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const session = getSession(id)
+  if (!session) return notFound()
+
+  const { searchParams } = new URL(req.url)
+  const limit = Math.min(200, Math.max(1, Number(searchParams.get('limit')) || 100))
+  const since = searchParams.get('since') ? Number(searchParams.get('since')) : undefined
+  const category = searchParams.get('category') as Parameters<typeof queryLogs>[0]['category'] | undefined
+
+  const entries = queryLogs({ sessionId: id, limit, since, category })
+  return NextResponse.json(entries)
+}

package/src/cli/index.js

@@ -607,6 +607,7 @@ const COMMAND_GROUPS = [
         defaultBody: { action: 'status' },
       }),
       cmd('checkpoints', 'GET', '/chats/:id/checkpoints', 'List checkpoint history for a chat'),
+      cmd('execution-log', 'GET', '/chats/:id/execution-log', 'Get execution log entries for a chat'),
       cmd('migrate-messages', 'POST', '/chats/migrate-messages', 'Migrate messages from session blobs to relational table'),
     ],
   },

package/src/components/chat/session-debug-panel.tsx

@@ -1,6 +1,6 @@
 'use client'
 
-import { useState } from 'react'
+import { useState, useEffect, useCallback } from 'react'
 import type { Message } from '@/types'
 import { IconButton } from '@/components/shared/icon-button'
 import { CheckpointTimeline } from './checkpoint-timeline'
@@ -19,7 +19,20 @@ interface DebugEvent {
   type: EventType
   label: string
   detail: string
+  extraDetail?: Record<string, unknown> | null
   time: number
+  source: 'message' | 'execlog'
+}
+
+interface ExecLogEntry {
+  id: string
+  sessionId: string
+  runId: string | null
+  agentId: string | null
+  category: string
+  summary: string
+  detail: Record<string, unknown> | null
+  ts: number
 }
 
 function classifyMessage(msg: Message): DebugEvent {
@@ -27,30 +40,66 @@ function classifyMessage(msg: Message): DebugEvent {
 
   if (msg.role === 'user') {
     if (text.startsWith('[System]')) {
-      return { type: 'system', label: 'System', detail: text.replace('[System] ', ''), time: msg.time }
+      return { type: 'system', label: 'System', detail: text.replace('[System] ', ''), time: msg.time, source: 'message' }
     }
     if (text.startsWith('[Agent ')) {
       const match = text.match(/\[Agent (.+?) result\]/)
-      return { type: 'agent_result', label: `Agent: ${match?.[1] || 'Unknown'}`, detail: text.replace(/\[Agent .+? result\]:?\n?/, ''), time: msg.time }
+      return { type: 'agent_result', label: `Agent: ${match?.[1] || 'Unknown'}`, detail: text.replace(/\[Agent .+? result\]:?\n?/, ''), time: msg.time, source: 'message' }
     }
     if (text.startsWith('[Memory search')) {
-      return { type: 'system', label: 'Memory Search', detail: text.replace('[Memory search results]:\n', ''), time: msg.time }
+      return { type: 'system', label: 'Memory Search', detail: text.replace('[Memory search results]:\n', ''), time: msg.time, source: 'message' }
     }
-    return { type: 'user', label: 'User', detail: text, time: msg.time }
+    return { type: 'user', label: 'User', detail: text, time: msg.time, source: 'message' }
   }
 
   // assistant
   if (text.startsWith('[Delegating to ')) {
     const match = text.match(/\[Delegating to (.+?)\]/)
-    return { type: 'delegation', label: `Delegate: ${match?.[1] || 'Unknown'}`, detail: text.replace(/\[Delegating to .+?\]:?\s?/, ''), time: msg.time }
+    return { type: 'delegation', label: `Delegate: ${match?.[1] || 'Unknown'}`, detail: text.replace(/\[Delegating to .+?\]:?\s?/, ''), time: msg.time, source: 'message' }
   }
   if (text.startsWith('[Error]')) {
-    return { type: 'error', label: 'Error', detail: text.replace('[Error] ', ''), time: msg.time }
+    return { type: 'error', label: 'Error', detail: text.replace('[Error] ', ''), time: msg.time, source: 'message' }
   }
   if (text.startsWith('Starting task:')) {
-    return { type: 'system', label: 'Task Start', detail: text, time: msg.time }
+    return { type: 'system', label: 'Task Start', detail: text, time: msg.time, source: 'message' }
+  }
+  return { type: 'assistant', label: 'Assistant', detail: text, time: msg.time, source: 'message' }
+}
+
+function classifyExecLogEntry(entry: ExecLogEntry): DebugEvent {
+  const catMap: Record<string, EventType> = {
+    error: 'error',
+    tool_call: 'tool_call',
+    tool_result: 'tool_call',
+    decision: 'system',
+    trigger: 'system',
+    loop_detection: 'system',
+    delegation_start: 'delegation',
+    delegation_complete: 'agent_result',
+    delegation_fail: 'error',
+  }
+  const type: EventType = catMap[entry.category] ?? 'system'
+  const labelMap: Record<string, string> = {
+    error: 'Error',
+    tool_call: 'Tool Call',
+    tool_result: 'Tool Result',
+    decision: 'Decision',
+    trigger: 'Trigger',
+    loop_detection: 'Loop Detect',
+    delegation_start: 'Delegation',
+    delegation_complete: 'Delegation Result',
+    delegation_fail: 'Delegation Error',
+    heartbeat_failure: 'Heartbeat Fail',
+  }
+  const label = labelMap[entry.category] ?? entry.category.replace(/_/g, ' ')
+  return {
+    type,
+    label,
+    detail: entry.summary,
+    extraDetail: entry.detail,
+    time: entry.ts,
+    source: 'execlog',
   }
-  return { type: 'assistant', label: 'Assistant', detail: text, time: msg.time }
 }
 
 const TYPE_COLORS: Record<EventType, string> = {
@@ -67,14 +116,66 @@ function fmtTime(ts: number) {
   return new Date(ts).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', second: '2-digit' })
 }
 
+function ExtraDetail({ data }: { data: Record<string, unknown> }) {
+  const entries = Object.entries(data).filter(([, v]) => v !== null && v !== undefined)
+  if (entries.length === 0) return null
+  return (
+    <div className="mt-2 rounded-[8px] bg-black/30 border border-white/[0.06] p-3 text-[11px] font-mono space-y-1">
+      {entries.map(([k, v]) => (
+        <div key={k} className="flex gap-2 flex-wrap">
+          <span className="text-text-3/70 shrink-0">{k}:</span>
+          <span className="text-text-2 break-all">
+            {Array.isArray(v)
+              ? v.map(String).join(', ') || '(empty)'
+              : typeof v === 'object'
+                ? JSON.stringify(v)
+                : String(v)}
+          </span>
+        </div>
+      ))}
+    </div>
+  )
+}
+
 export function SessionDebugPanel({ messages, open, onClose }: Props) {
   const [tab, setTab] = useState<'log' | 'checkpoints'>('log')
   const [filter, setFilter] = useState<EventType | 'all'>('all')
   const [expandedIdx, setExpandedIdx] = useState<number | null>(null)
-  
+  const [execLogs, setExecLogs] = useState<ExecLogEntry[]>([])
+  const [loadingExec, setLoadingExec] = useState(false)
+
   const currentSessionId = useAppStore(selectActiveSessionId)
 
-  const events = messages.map(classifyMessage)
+  const fetchExecLogs = useCallback(async (sessionId: string) => {
+    setLoadingExec(true)
+    try {
+      const res = await fetch(`/api/chats/${sessionId}/execution-log?limit=200`)
+      if (res.ok) {
+        const data = await res.json() as ExecLogEntry[]
+        setExecLogs(Array.isArray(data) ? data : [])
+      }
+    } catch {
+      // non-critical
+    } finally {
+      setLoadingExec(false)
+    }
+  }, [])
+
+  useEffect(() => {
+    if (open && currentSessionId) {
+      void fetchExecLogs(currentSessionId)
+    } else if (!open) {
+      setExecLogs([])
+      setExpandedIdx(null)
+    }
+  }, [open, currentSessionId, fetchExecLogs])
+
+  const msgEvents = messages.map(classifyMessage)
+  const execEvents = execLogs.map(classifyExecLogEntry)
+
+  // Merge and sort by time
+  const allEvents = [...msgEvents, ...execEvents].sort((a, b) => a.time - b.time)
+  const events = allEvents
   const filtered = filter === 'all' ? events : events.filter((e) => e.type === filter)
 
   if (!open) return null
@@ -85,6 +186,7 @@ export function SessionDebugPanel({ messages, open, onClose }: Props) {
     { id: 'agent_result', label: 'Results' },
     { id: 'error', label: 'Errors' },
     { id: 'system', label: 'System' },
+    { id: 'tool_call', label: 'Tools' },
   ]
 
   return (
@@ -97,20 +199,20 @@ export function SessionDebugPanel({ messages, open, onClose }: Props) {
           <path d="M6 20v-4" />
         </svg>
         <span className="font-display text-[16px] font-600 tracking-[-0.02em] flex-1">Session X-Ray</span>
-        
+
         <div className="flex bg-white/[0.04] p-0.5 rounded-[8px] mr-2">
-           <button 
-             onClick={() => setTab('log')}
-             className={`px-3 py-1 rounded-[6px] text-[11px] font-600 transition-all ${tab === 'log' ? 'bg-white/[0.08] text-text shadow-sm' : 'text-text-3 hover:text-text-2'}`}
-           >
-             Event Log
-           </button>
-           <button 
-             onClick={() => setTab('checkpoints')}
-             className={`px-3 py-1 rounded-[6px] text-[11px] font-600 transition-all ${tab === 'checkpoints' ? 'bg-accent-soft text-accent-bright' : 'text-text-3 hover:text-text-2'}`}
-           >
-             Checkpoints
-           </button>
+          <button
+            onClick={() => setTab('log')}
+            className={`px-3 py-1 rounded-[6px] text-[11px] font-600 transition-all ${tab === 'log' ? 'bg-white/[0.08] text-text shadow-sm' : 'text-text-3 hover:text-text-2'}`}
+          >
+            Event Log
+          </button>
+          <button
+            onClick={() => setTab('checkpoints')}
+            className={`px-3 py-1 rounded-[6px] text-[11px] font-600 transition-all ${tab === 'checkpoints' ? 'bg-accent-soft text-accent-bright' : 'text-text-3 hover:text-text-2'}`}
+          >
+            Checkpoints
+          </button>
         </div>
 
         <IconButton onClick={onClose} aria-label="Close debug panel">
@@ -138,6 +240,16 @@ export function SessionDebugPanel({ messages, open, onClose }: Props) {
                 {f.label}
               </button>
             ))}
+            {currentSessionId && (
+              <button
+                onClick={() => void fetchExecLogs(currentSessionId)}
+                disabled={loadingExec}
+                className="ml-auto px-3 py-1.5 rounded-[8px] text-[11px] font-600 cursor-pointer transition-all border bg-surface border-white/[0.06] text-text-3 hover:text-text-2 disabled:opacity-40 whitespace-nowrap"
+                style={{ fontFamily: 'inherit' }}
+              >
+                {loadingExec ? 'Refreshing…' : '↺ Refresh'}
+              </button>
+            )}
           </div>
 
           {/* Event timeline */}
@@ -162,27 +274,40 @@ export function SessionDebugPanel({ messages, open, onClose }: Props) {
                     />
 
                     {/* Content */}
-                    <div className="flex items-center gap-2 mb-0.5">
+                    <div className="flex items-center gap-2 mb-0.5 flex-wrap">
                       <span className="text-[11px] font-700 uppercase tracking-wider" style={{ color }}>
                         {event.label}
                       </span>
                       <span className="text-[10px] text-text-3/70 font-mono">{fmtTime(event.time)}</span>
+                      {event.source === 'execlog' && (
+                        <span className="text-[9px] text-text-3/40 font-mono uppercase tracking-wider">exec</span>
+                      )}
                     </div>
 
                     <p className={`text-[12px] text-text-3 leading-[1.5] ${expanded ? 'whitespace-pre-wrap' : 'line-clamp-2'}`}>
                       {event.detail}
                     </p>
 
+                    {expanded && event.extraDetail && (
+                      <ExtraDetail data={event.extraDetail} />
+                    )}
+
                     {!expanded && event.detail.length > 150 && (
                       <span className="text-[11px] text-accent-bright/60 mt-1 inline-block">click to expand</span>
                     )}
+                    {!expanded && event.extraDetail && Object.keys(event.extraDetail).length > 0 && (
+                      <span className="text-[11px] text-accent-bright/60 mt-1 inline-block ml-2">+ details</span>
+                    )}
                   </button>
                 )
               })}
 
-              {filtered.length === 0 && (
+              {filtered.length === 0 && !loadingExec && (
                 <p className="text-center text-[13px] text-text-3 py-12">No events matching filter</p>
               )}
+              {filtered.length === 0 && loadingExec && (
+                <p className="text-center text-[13px] text-text-3 py-12">Loading…</p>
+              )}
             </div>
           </div>
 
@@ -198,17 +323,19 @@ export function SessionDebugPanel({ messages, open, onClose }: Props) {
                 </span>
               )
             })}
+            <span className="ml-auto text-[10px] text-text-3/40 font-mono">{execLogs.length} exec log entries</span>
           </div>
         </>
       ) : (
         <div className="flex-1 overflow-y-auto">
-           {currentSessionId ? (
-             <CheckpointTimeline sessionId={currentSessionId} />
-           ) : (
-             <div className="p-12 text-center text-text-3">No active chat</div>
-           )}
+          {currentSessionId ? (
+            <CheckpointTimeline sessionId={currentSessionId} />
+          ) : (
+            <div className="p-12 text-center text-text-3">No active chat</div>
+          )}
         </div>
       )}
     </div>
   )
 }
+

package/src/components/tasks/task-sheet.tsx

@@ -186,6 +186,7 @@ export function TaskSheet() {
 
   const onClose = () => {
     formInitRef.current = null
+    setDepError(null)
     setOpen(false)
     setEditingId(null)
   }
@@ -215,14 +216,16 @@ export function TaskSheet() {
     try {
       if (editing) {
         const res = await updateTaskMutation.mutateAsync({ id: editing.id, patch: payload })
-        if (res && typeof res === 'object' && 'error' in res) {
-          setDepError(String((res as unknown as Record<string, unknown>).error))
+        const errMsg = res && typeof res === 'object' ? (res as unknown as Record<string, unknown>).error : undefined
+        if (typeof errMsg === 'string' && errMsg.trim()) {
+          setDepError(errMsg)
           return
         }
       } else {
         const res = await createTaskMutation.mutateAsync(payload)
-        if (res && typeof res === 'object' && 'error' in res) {
-          setDepError(String((res as unknown as Record<string, unknown>).error))
+        const errMsg = res && typeof res === 'object' ? (res as unknown as Record<string, unknown>).error : undefined
+        if (typeof errMsg === 'string' && errMsg.trim()) {
+          setDepError(errMsg)
           return
         }
       }

package/src/lib/server/chat-execution/chat-turn-finalization.ts

@@ -33,6 +33,7 @@ import {
 import { estimateCost } from '@/lib/server/cost'
 import { refreshSessionIdentityState } from '@/lib/server/identity-continuity'
 import { log } from '@/lib/server/logger'
+import { logExecution } from '@/lib/server/execution-log'
 import { syncSessionArchiveMemory } from '@/lib/server/memory/session-archive-memory'
 import { runCapabilityHook, transformCapabilityText } from '@/lib/server/native-capabilities'
 import { isHeartbeatSource } from '@/lib/server/runtime/heartbeat-source'
@@ -287,6 +288,22 @@ export async function finalizeChatTurn(params: {
         inferredError: terminalError,
       })
     }
+    logExecution(sessionId, 'error', terminalError, {
+      runId,
+      agentId: sessionForRun.agentId || null,
+      detail: {
+        provider: providerType,
+        model: sessionForRun.model,
+        streamErrors: streamErrors.length > 0 ? streamErrors : undefined,
+        source,
+        durationMs,
+        inputTokens: directUsage.received ? directUsage.inputTokens : null,
+        outputTokens: directUsage.received ? directUsage.outputTokens : null,
+        tokenUsageReceived: directUsage.received,
+        hadResponse: !!(fullResponse || '').trim(),
+        toolEventCount: toolEvents.length,
+      },
+    })
     errorMessage = terminalError
   }