@swarmclawai/swarmclaw 1.5.69 → 1.5.71

package/README.md

@@ -399,6 +399,25 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.5.71 Highlights
+
+Fast-follow release for [#60](https://github.com/swarmclawai/swarmclaw/pull/60) by [@borislavnnikolov](https://github.com/borislavnnikolov). Thanks Borislav!
+
+- **Browser MCP works from standalone builds again.** The Next standalone output now includes the Playwright MCP runtime packages required by packaged SwarmClaw builds.
+- **Host browser launches use cached Chromium.** Local Playwright MCP startup now selects Chromium explicitly instead of depending on a system Chrome install.
+- **Standalone repair is more robust.** The build repair step now fills partially traced Playwright MCP package directories, and the packaging and browser startup paths are covered by regression tests.
+
+### v1.5.70 Highlights
+
+Fast-follow release for [#56](https://github.com/swarmclawai/swarmclaw/pull/56) by [@latentwill](https://github.com/latentwill). Thanks latentwill!
+
+Also includes fixes for [#57](https://github.com/swarmclawai/swarmclaw/issues/57) and [#58](https://github.com/swarmclawai/swarmclaw/issues/58) reported by [@zantak](https://github.com/zantak). Thanks zantak!
+
+- **Builtin provider saves work again.** Saving a builtin provider no longer sends the strict-schema rejected `type` field, and the provider update route is now covered by the runtime test script.
+- **Knowledge sources appear on direct visits.** Panel-backed routes such as Knowledge now auto-open their source/sidebar panel on desktop route changes, while mobile keeps the drawer closed by default.
+- **Reasoning content stays out of the reply body.** OpenAI-compatible `reasoning_content` and `reasoning` stream deltas now flow into the existing collapsed Thinking panel instead of being appended before the visible answer.
+- **macOS install guidance remains explicit.** Ad-hoc signed macOS desktop builds still document the quarantine workaround until Developer ID signing and notarization are available. Thanks [@yagudaev](https://github.com/yagudaev) for confirming the current workaround on Apple Silicon.
+
 ### v1.5.69 Highlights
 
 Fast-follow release for [#55](https://github.com/swarmclawai/swarmclaw/pull/55) by [@borislavnnikolov](https://github.com/borislavnnikolov). Thanks Borislav!

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.5.69",
+  "version": "1.5.71",
   "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",
@@ -86,8 +86,8 @@
     "cli": "node ./bin/swarmclaw.js",
     "test:cli": "node --test src/cli/*.test.js bin/*.test.js 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/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/openclaw-exports.test.ts src/app/api/openclaw/dashboard-url/route.test.ts",
-    "test:runtime": "tsx --test 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/observability/otel-config.test.ts src/lib/server/safe-parse-body.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/tts/route.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/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/openclaw/dashboard-url/route.test.ts",
+    "test:runtime": "tsx --test 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/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/app/view-constants.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": "tsx .workbench/browser-e2e/run.ts",
     "test:mcp:conformance": "node --import tsx ./scripts/mcp-conformance-check.ts",

package/scripts/run-next-build.mjs

@@ -35,6 +35,11 @@ export const REQUIRED_NEXT_METADATA_FILES = [
   'get-metadata-route.js',
   'is-metadata-route.js',
 ]
+export const REQUIRED_STANDALONE_BROWSER_PACKAGES = [
+  '@playwright/mcp',
+  'playwright',
+  'playwright-core',
+]
 
 function parsePositiveInteger(value) {
   const parsed = Number.parseInt(String(value ?? '').trim(), 10)
@@ -187,6 +192,27 @@ export function repairStandaloneCssTreeData(cwd = process.cwd()) {
   return repaired
 }
 
+export function repairStandaloneBrowserMcpRuntime(cwd = process.cwd()) {
+  const standaloneDir = path.join(cwd, '.next', 'standalone')
+  if (!fs.existsSync(standaloneDir)) return false
+
+  let repaired = false
+  const standaloneNodeModules = path.join(standaloneDir, 'node_modules')
+  for (const packageName of REQUIRED_STANDALONE_BROWSER_PACKAGES) {
+    const sourceDir = path.join(cwd, 'node_modules', ...packageName.split('/'))
+    const targetDir = path.join(standaloneNodeModules, ...packageName.split('/'))
+    if (!fs.existsSync(sourceDir)) {
+      throw new Error(`Missing required browser MCP runtime package under ${sourceDir}.`)
+    }
+
+    fs.mkdirSync(path.dirname(targetDir), { recursive: true })
+    fs.cpSync(sourceDir, targetDir, { recursive: true, force: true })
+    repaired = true
+  }
+
+  return repaired
+}
+
 export function repairStandaloneNextMetadata(cwd = process.cwd()) {
   const standaloneDir = path.join(cwd, '.next', 'standalone')
   if (!fs.existsSync(standaloneDir)) return false
@@ -248,6 +274,9 @@ function main() {
     if (result.status === 0 && repairStandaloneCssTreeData(process.cwd())) {
       console.error('Copied css-tree/data/ into standalone build output.')
     }
+    if (result.status === 0 && repairStandaloneBrowserMcpRuntime(process.cwd())) {
+      console.error('Copied Playwright MCP runtime packages into standalone build output.')
+    }
     process.exit(result.status)
   }
   if (result.signal) {

package/src/app/api/providers/[id]/route.test.ts

@@ -47,3 +47,23 @@ test('provider route upserts builtin override records for enablement changes', (
   assert.equal(output.responsePayload.type, 'builtin')
   assert.equal(output.responsePayload.isEnabled, false)
 })
+
+test('provider route rejects unknown fields per ProviderUpdateSchema.strict()', () => {
+  const output = runWithTempDataDir<{ status: number }>(`
+    const routeMod = await import('./src/app/api/providers/[id]/route')
+    const route = routeMod.default || routeMod
+
+    const response = await route.PUT(
+      new Request('http://local/api/providers/openai', {
+        method: 'PUT',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ type: 'builtin', isEnabled: true }),
+      }),
+      { params: Promise.resolve({ id: 'openai' }) },
+    )
+
+    console.log(JSON.stringify({ status: response.status }))
+  `, { prefix: 'swarmclaw-provider-route-strict-test-' })
+
+  assert.equal(output.status, 400)
+})

package/src/components/layout/dashboard-shell.tsx

@@ -1,6 +1,6 @@
 'use client'
 
-import { useEffect, useState, useCallback } from 'react'
+import { useEffect, useRef, useState, useCallback } from 'react'
 import { useRouter, usePathname } from 'next/navigation'
 import { initAudioContext } from '@/lib/tts'
 import { clearStoredAccessKey } from '@/lib/app/api-client'
@@ -13,6 +13,7 @@ import { useSwipe } from '@/hooks/use-swipe'
 import { useWs } from '@/hooks/use-ws'
 import { api } from '@/lib/app/api-client'
 import { pathToView, useNavigate } from '@/lib/app/navigation'
+import { shouldAutoOpenPanelSidebar } from '@/lib/app/view-constants'
 
 import { FullScreenLoader } from '@/components/ui/full-screen-loader'
 import { SidebarRail } from '@/components/layout/sidebar-rail'
@@ -45,6 +46,7 @@ export function DashboardShell({ children }: { children: React.ReactNode }) {
 
   const [bootTimedOut, setBootTimedOut] = useState(false)
   const [profileSheetOpen, setProfileSheetOpen] = useState(false)
+  const lastAutoOpenedPanelPathRef = useRef<string | null>(null)
   const sidebarOpen = useAppStore((s) => s.sidebarOpen)
   const setSidebarOpen = useAppStore((s) => s.setSidebarOpen)
   const appSettings = useAppStore((s) => s.appSettings)
@@ -165,6 +167,18 @@ export function DashboardShell({ children }: { children: React.ReactNode }) {
     }
   }, [pathname, isViewEnabled, router, isAuthPage])
 
+  useEffect(() => {
+    if (isAuthPage) return
+    const currentView = pathToView(pathname)
+    if (!shouldAutoOpenPanelSidebar(currentView, isDesktop)) {
+      lastAutoOpenedPanelPathRef.current = null
+      return
+    }
+    if (lastAutoOpenedPanelPathRef.current === pathname) return
+    lastAutoOpenedPanelPathRef.current = pathname
+    setSidebarOpen(true)
+  }, [isAuthPage, isDesktop, pathname, setSidebarOpen])
+
   // Extension sidebar items
   const refreshExtensionState = useCallback(() => {
     void loadExtensions()

package/src/components/layout/sidebar-rail.tsx

@@ -9,7 +9,7 @@ import { DaemonIndicator } from '@/components/layout/daemon-indicator'
 import { NotificationCenter } from '@/components/shared/notification-center'
 import { NavItem, RailTooltip } from '@/components/layout/nav-item'
 import { useWs } from '@/hooks/use-ws'
-import { FULL_WIDTH_VIEWS } from '@/lib/app/view-constants'
+import { FULL_WIDTH_VIEWS, isPanelSidebarView } from '@/lib/app/view-constants'
 import { pathToView, useNavigate } from '@/lib/app/navigation'
 import { safeStorageGet, safeStorageSet } from '@/lib/app/safe-storage'
 import type { AppView } from '@/types'
@@ -80,9 +80,9 @@ export function SidebarRail({
       setSidebarOpen(false)
       return
     }
-    if (FULL_WIDTH_VIEWS.has(view)) {
-      setSidebarOpen(false)
-    } else if (activeView === view && sidebarOpen) {
+    if (isPanelSidebarView(view)) {
+      setSidebarOpen(!(activeView === view && sidebarOpen))
+    } else if (FULL_WIDTH_VIEWS.has(view)) {
       setSidebarOpen(false)
     } else {
       setSidebarOpen(true)

package/src/features/providers/queries.ts

@@ -85,7 +85,6 @@ export function useSaveBuiltinProviderMutation() {
     mutationFn: async ({ id, models, isEnabled, baseUrl }: SaveBuiltinProviderInput) => {
       await api('PUT', `/providers/${id}/models`, { models })
       return api('PUT', `/providers/${id}`, {
-        type: 'builtin',
         isEnabled,
         ...(baseUrl ? { baseUrl } : {}),
       })

package/src/lib/app/view-constants.test.ts

@@ -0,0 +1,21 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import { isPanelSidebarView, shouldAutoOpenPanelSidebar } from './view-constants'
+
+describe('panel sidebar route helpers', () => {
+  it('treats knowledge as a panel-backed view', () => {
+    assert.equal(isPanelSidebarView('knowledge'), true)
+  })
+
+  it('auto-opens panel-backed views only on desktop', () => {
+    assert.equal(shouldAutoOpenPanelSidebar('knowledge', true), true)
+    assert.equal(shouldAutoOpenPanelSidebar('knowledge', false), false)
+  })
+
+  it('does not auto-open full-width views without panel layouts', () => {
+    assert.equal(shouldAutoOpenPanelSidebar('home', true), false)
+    assert.equal(shouldAutoOpenPanelSidebar('settings', true), false)
+    assert.equal(shouldAutoOpenPanelSidebar(null, true), false)
+  })
+})

package/src/lib/app/view-constants.ts

@@ -245,3 +245,28 @@ export const FULL_WIDTH_VIEWS = new Set<AppView>([
   'connectors', 'webhooks', 'mcp_servers', 'knowledge', 'extensions',
   'usage', 'runs', 'autonomy', 'logs', 'settings', 'activity', 'projects', 'swarmfeed', 'marketplace', 'missions',
 ])
+
+export const PANEL_SIDEBAR_VIEWS = new Set<AppView>([
+  'agents',
+  'connectors',
+  'extensions',
+  'knowledge',
+  'logs',
+  'mcp_servers',
+  'memory',
+  'providers',
+  'runs',
+  'schedules',
+  'secrets',
+  'skills',
+  'tasks',
+  'webhooks',
+])
+
+export function isPanelSidebarView(view: AppView | null | undefined): boolean {
+  return Boolean(view && PANEL_SIDEBAR_VIEWS.has(view))
+}
+
+export function shouldAutoOpenPanelSidebar(view: AppView | null | undefined, isDesktop: boolean): boolean {
+  return isDesktop && isPanelSidebarView(view)
+}

package/src/lib/providers/openai.test.ts

@@ -0,0 +1,54 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { streamOpenAiChat } from './openai'
+
+function sseChunk(data: unknown) {
+  return `data: ${JSON.stringify(data)}\n\n`
+}
+
+function parseSseEvents(frames: string[]) {
+  return frames
+    .flatMap((frame) => frame.trim().split('\n\n'))
+    .filter(Boolean)
+    .map((frame) => JSON.parse(frame.replace(/^data: /, '')) as { t: string; text?: string })
+}
+
+test('OpenAI-compatible reasoning deltas stream as thinking instead of visible text', async () => {
+  const originalFetch = globalThis.fetch
+  const encoded = new TextEncoder()
+  const frames = [
+    sseChunk({ choices: [{ delta: { reasoning_content: 'internal reasoning ' } }] }),
+    sseChunk({ choices: [{ delta: { content: 'visible answer' } }] }),
+    'data: [DONE]\n\n',
+  ]
+  const writes: string[] = []
+
+  globalThis.fetch = async () => new Response(new ReadableStream({
+    start(controller) {
+      for (const frame of frames) controller.enqueue(encoded.encode(frame))
+      controller.close()
+    },
+  }), {
+    status: 200,
+    headers: { 'content-type': 'text/event-stream' },
+  })
+
+  try {
+    const result = await streamOpenAiChat({
+      session: { id: 'session-1', provider: 'openai', model: 'test-model' },
+      message: 'hello',
+      write: (data) => writes.push(data),
+      active: new Map(),
+      loadHistory: () => [],
+    } as Parameters<typeof streamOpenAiChat>[0])
+
+    assert.equal(result, 'visible answer')
+    assert.deepEqual(parseSseEvents(writes), [
+      { t: 'thinking', text: 'internal reasoning ' },
+      { t: 'd', text: 'visible answer' },
+    ])
+  } finally {
+    globalThis.fetch = originalFetch
+  }
+})

package/src/lib/providers/openai.ts

@@ -166,13 +166,17 @@ export function streamOpenAiChat({ session, message, imagePath, imageUrl, apiKey
               try {
                 const parsed = JSON.parse(data)
                 const choice = parsed.choices?.[0]?.delta
-                const delta = choice?.content
-                  // Thinking/reasoning models (kimi-k2, etc.) put output in reasoning fields
-                  || choice?.reasoning_content
-                  || choice?.reasoning
-                if (delta) {
-                  fullResponse += delta
-                  writeSSE(write, 'd', delta)
+                const contentDelta = typeof choice?.content === 'string' ? choice.content : ''
+                const reasoningDelta =
+                  typeof choice?.reasoning_content === 'string' ? choice.reasoning_content
+                    : typeof choice?.reasoning === 'string' ? choice.reasoning
+                      : ''
+                if (reasoningDelta) {
+                  writeSSE(write, 'thinking', reasoningDelta)
+                }
+                if (contentDelta) {
+                  fullResponse += contentDelta
+                  writeSSE(write, 'd', contentDelta)
                 }
                 // Extract usage from the final chunk (stream_options: include_usage)
                 if (usageEnabled && parsed.usage && onUsage) {

package/src/lib/server/session-tools/web-browser-config.test.ts

@@ -18,9 +18,12 @@ describe('browser tool connection config', () => {
     const params = buildBrowserStdioServerParams('/tmp/swarmclaw-browser-profile')
 
     assert.equal(params.command, process.execPath)
+    assert.equal(params.args.includes('--browser'), true)
+    assert.equal(params.args[params.args.indexOf('--browser') + 1], 'chromium')
     assert.equal(params.args.includes('--headless'), true)
     assert.equal(params.args.includes('--shared-browser-context'), false)
     assert.equal(params.args.includes('/tmp/swarmclaw-browser-profile'), true)
+    assert.equal((params.env as Record<string, string | undefined>).PLAYWRIGHT_MCP_BROWSER, 'chromium')
     assert.equal((params.env as Record<string, string | undefined>).PLAYWRIGHT_MCP_USER_DATA_DIR, '/tmp/swarmclaw-browser-profile')
     assert.equal(params.env.PLAYWRIGHT_MCP_OUTPUT_MODE, 'file')
     assert.equal(params.env.PLAYWRIGHT_MCP_TIMEOUT_ACTION, '60000')
@@ -39,10 +42,12 @@ describe('browser tool connection config', () => {
     assert.equal(params.args.includes('--cdp-header'), true)
     assert.equal(params.args.includes('Authorization: Bearer token-123'), true)
     assert.equal(params.args.includes('--allow-unrestricted-file-access'), true)
+    assert.equal(params.args.includes('--browser'), false)
     assert.equal(params.args.includes('--user-data-dir'), false)
     const env = params.env as Record<string, string | undefined>
     assert.equal(env.PLAYWRIGHT_MCP_CDP_ENDPOINT, 'http://127.0.0.1:44001')
     assert.equal(params.env.PLAYWRIGHT_MCP_ALLOW_UNRESTRICTED_FILE_ACCESS, '1')
+    assert.equal(env.PLAYWRIGHT_MCP_BROWSER, undefined)
     assert.equal(env.PLAYWRIGHT_MCP_USER_DATA_DIR, undefined)
   })
 

package/src/lib/server/session-tools/web-utils.ts

@@ -102,6 +102,7 @@ export function buildBrowserStdioServerParams(
     allowUnrestrictedFileAccess?: boolean
   },
 ) {
+  const browserName = 'chromium'
   const cliCandidates = [
     path.join(process.cwd(), 'node_modules', '@playwright', 'mcp', 'cli.js'),
     path.join(process.cwd(), '[project]', 'node_modules', '@playwright', 'mcp', 'cli.js'),
@@ -134,6 +135,7 @@ export function buildBrowserStdioServerParams(
     }
   } else {
     args.push(
+      '--browser', browserName,
       '--headless',
       '--user-data-dir', profileDir,
     )
@@ -145,6 +147,7 @@ export function buildBrowserStdioServerParams(
     env: {
       ...env,
       ...(cdpEndpoint ? { PLAYWRIGHT_MCP_CDP_ENDPOINT: cdpEndpoint } : {
+        PLAYWRIGHT_MCP_BROWSER: browserName,
         PLAYWRIGHT_MCP_USER_DATA_DIR: profileDir,
         PLAYWRIGHT_MCP_HEADLESS: '1',
       }),