@swarmclawai/swarmclaw 1.5.68 → 1.5.70

package/README.md

@@ -399,6 +399,26 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### 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!
+
+- **Structured runs are easier to find.** Schedule-backed protocol runs now appear in the schedule console and unified `/api/runs` endpoints, including detail and event fallbacks for structured run records.
+- **Agent sessions get a cleaner fresh-chat flow.** Agent chat headers now expose a New chat action for sessions with history or saved CLI/runtime handles, first prompts derive compact session titles, and agent session lists sort newest-first.
+- **Structured session execution is sturdier.** CLI providers can execute structured turns through their direct provider runtime, blank structured responses now surface the real logged error where possible, successful structured turns clear their watchdog timers promptly, schedule timing changes recompute `nextRunAt`, and in-process daemon status/control paths are covered.
+- **Package contents are safer.** The npm package allowlist now explicitly excludes local env files under `src/` even when a maintainer has private ignored config in their working tree.
+
 ### v1.5.68 Highlights
 
 Launch-readiness release for turning SwarmClaw's own next launch into a reusable workflow.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.5.68",
+  "version": "1.5.70",
   "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",
@@ -44,6 +44,7 @@
     "bin/",
     "skills/",
     "src/",
+    "!src/**/.env*",
     "public/",
     "Dockerfile.sandbox-browser",
     "scripts/easy-setup.mjs",
@@ -85,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/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/app/api/runs/[id]/events/route.ts

@@ -1,5 +1,7 @@
 import { NextResponse } from 'next/server'
 import { getRunById, listRunEvents } from '@/lib/server/runtime/session-run-manager'
+import { listProtocolRunEventsForRun, loadProtocolRunById } from '@/lib/server/protocols/protocol-queries'
+import { protocolEventToRunEventRecord } from '@/lib/server/runs/unified-run-records'
 
 export const dynamic = 'force-dynamic'
 
@@ -12,11 +14,15 @@ function parseLimit(value: string | null): number | undefined {
 export async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {
   const { id } = await params
   const run = getRunById(id)
-  if (!run) {
-    return NextResponse.json({ error: 'Run not found' }, { status: 404 })
+  if (run) {
+    const url = new URL(req.url)
+    const limit = parseLimit(url.searchParams.get('limit'))
+    return NextResponse.json(listRunEvents(id, limit))
   }
-
+  const protocolRun = loadProtocolRunById(id)
+  if (!protocolRun) return NextResponse.json({ error: 'Run not found' }, { status: 404 })
   const url = new URL(req.url)
   const limit = parseLimit(url.searchParams.get('limit'))
-  return NextResponse.json(listRunEvents(id, limit))
+  const events = listProtocolRunEventsForRun(id, limit || 200).map((event) => protocolEventToRunEventRecord(protocolRun, event))
+  return NextResponse.json(events)
 }

package/src/app/api/runs/[id]/route.ts

@@ -1,9 +1,13 @@
 import { NextResponse } from 'next/server'
 import { getRunById } from '@/lib/server/runtime/session-run-manager'
+import { loadProtocolRunById } from '@/lib/server/protocols/protocol-queries'
+import { protocolRunToSessionRunRecord } from '@/lib/server/runs/unified-run-records'
 
 export async function GET(_req: Request, { params }: { params: Promise<{ id: string }> }) {
   const { id } = await params
   const run = getRunById(id)
-  if (!run) return NextResponse.json({ error: 'Run not found' }, { status: 404 })
-  return NextResponse.json(run)
+  if (run) return NextResponse.json(run)
+  const protocolRun = loadProtocolRunById(id)
+  if (protocolRun) return NextResponse.json(protocolRunToSessionRunRecord(protocolRun))
+  return NextResponse.json({ error: 'Run not found' }, { status: 404 })
 }

package/src/app/api/runs/route.test.ts

@@ -0,0 +1,84 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { runWithTempDataDir } from '@/lib/server/test-utils/run-with-temp-data-dir'
+
+test('runs routes include structured schedule protocol runs', () => {
+  const output = runWithTempDataDir<{
+    listCount: number
+    firstRunId: string | null
+    firstRunSource: string | null
+    firstRunStatus: string | null
+    detailId: string | null
+    detailSource: string | null
+    eventsCount: number
+    eventSummary: string | null
+  }>(`
+    const storageMod = await import('./src/lib/server/storage')
+    const protocolsMod = await import('./src/lib/server/protocols/protocol-service')
+    const listRouteMod = await import('./src/app/api/runs/route')
+    const detailRouteMod = await import('./src/app/api/runs/[id]/route')
+    const eventsRouteMod = await import('./src/app/api/runs/[id]/events/route')
+    const storage = storageMod.default || storageMod
+    const protocols = protocolsMod.default || protocolsMod
+    const listRoute = listRouteMod.default || listRouteMod
+    const detailRoute = detailRouteMod.default || detailRouteMod
+    const eventsRoute = eventsRouteMod.default || eventsRouteMod
+
+    storage.upsertStoredItem('agents', 'agentA', {
+      id: 'agentA',
+      name: 'Agent A',
+      provider: 'ollama',
+      model: 'test-model',
+      systemPrompt: 'test',
+      createdAt: 1,
+      updatedAt: 1,
+    })
+
+    const run = protocols.createProtocolRun({
+      title: 'Scheduled structured run',
+      participantAgentIds: ['agentA'],
+      facilitatorAgentId: 'agentA',
+      autoStart: false,
+      scheduleId: 'sched-1',
+      sourceRef: { kind: 'schedule', id: 'sched-1', label: 'Morning schedule' },
+      config: {
+        goal: 'Summarize the morning inbox.',
+      },
+    })
+
+    const listResponse = await listRoute.GET(new Request('http://local/api/runs?limit=10'))
+    const listPayload = await listResponse.json()
+
+    const detailResponse = await detailRoute.GET(
+      new Request('http://local/api/runs/' + run.id),
+      { params: Promise.resolve({ id: run.id }) },
+    )
+    const detailPayload = await detailResponse.json()
+
+    const eventsResponse = await eventsRoute.GET(
+      new Request('http://local/api/runs/' + run.id + '/events?limit=10'),
+      { params: Promise.resolve({ id: run.id }) },
+    )
+    const eventsPayload = await eventsResponse.json()
+
+    console.log(JSON.stringify({
+      listCount: Array.isArray(listPayload) ? listPayload.length : -1,
+      firstRunId: Array.isArray(listPayload) && listPayload[0] ? listPayload[0].id : null,
+      firstRunSource: Array.isArray(listPayload) && listPayload[0] ? listPayload[0].source : null,
+      firstRunStatus: Array.isArray(listPayload) && listPayload[0] ? listPayload[0].status : null,
+      detailId: detailPayload?.id || null,
+      detailSource: detailPayload?.source || null,
+      eventsCount: Array.isArray(eventsPayload) ? eventsPayload.length : -1,
+      eventSummary: Array.isArray(eventsPayload) && eventsPayload[0] ? eventsPayload[0].summary || null : null,
+    }))
+  `, { prefix: 'swarmclaw-runs-route-' })
+
+  assert.equal(output.listCount, 1)
+  assert.equal(output.firstRunId, output.detailId)
+  assert.equal(output.firstRunSource, 'structured schedule')
+  assert.equal(output.firstRunStatus, 'queued')
+  assert.equal(output.detailSource, 'structured schedule')
+  assert.equal(output.eventsCount >= 1, true)
+  assert.equal(typeof output.eventSummary, 'string')
+})

package/src/app/api/runs/route.ts

@@ -1,9 +1,28 @@
 import { NextResponse } from 'next/server'
 import { listRuns } from '@/lib/server/runtime/session-run-manager'
-import type { SessionRunStatus } from '@/types'
+import { listProtocolRuns } from '@/lib/server/protocols/protocol-queries'
+import { protocolRunToSessionRunRecord } from '@/lib/server/runs/unified-run-records'
+import type { ProtocolRunStatus, SessionRunStatus } from '@/types'
 
 export const dynamic = 'force-dynamic'
 
+function protocolStatusesForRunStatus(status?: SessionRunStatus): ProtocolRunStatus[] {
+  switch (status) {
+    case 'queued':
+      return ['draft']
+    case 'running':
+      return ['running', 'waiting', 'paused']
+    case 'completed':
+      return ['completed']
+    case 'failed':
+      return ['failed']
+    case 'cancelled':
+      return ['cancelled', 'archived']
+    default:
+      return []
+  }
+}
+
 export async function GET(req: Request) {
   const { searchParams } = new URL(req.url)
   const sessionId = searchParams.get('sessionId') || undefined
@@ -11,6 +30,26 @@ export async function GET(req: Request) {
   const limitRaw = searchParams.get('limit')
   const limit = limitRaw ? Number.parseInt(limitRaw, 10) : undefined
 
-  const runs = listRuns({ sessionId, status, limit })
+  const sessionRuns = listRuns({ sessionId, status, limit })
+  const fetchLimit = limit || 200
+  const scopedProtocolRuns = status
+    ? protocolStatusesForRunStatus(status).flatMap((protocolStatus) => listProtocolRuns({
+      includeSystemOwned: true,
+      sessionId,
+      status: protocolStatus,
+      limit: fetchLimit,
+    }))
+    : listProtocolRuns({
+      includeSystemOwned: true,
+      sessionId,
+      limit: fetchLimit,
+    })
+  const protocolRuns = Array.from(new Map(scopedProtocolRuns.map((run) => [run.id, run])).values())
+    .filter((run) => run.status !== 'archived')
+    .map(protocolRunToSessionRunRecord)
+    .filter((run) => !status || run.status === status)
+  const runs = [...sessionRuns, ...protocolRuns]
+    .sort((left, right) => (right.queuedAt || 0) - (left.queuedAt || 0))
+    .slice(0, fetchLimit)
   return NextResponse.json(runs)
 }

package/src/components/agents/inspector-panel.tsx

@@ -6,6 +6,7 @@ import type { Agent, MemoryEntry, Session } from '@/types'
 import { useAppStore } from '@/stores/use-app-store'
 import { useChatStore } from '@/stores/use-chat-store'
 import { api } from '@/lib/app/api-client'
+import { sortSessionsNewestFirst } from '@/lib/chat/new-session'
 import { AgentAvatar } from './agent-avatar'
 import { AgentFilesEditor } from './agent-files-editor'
 import { OpenClawSkillsPanel } from './openclaw-skills-panel'
@@ -907,7 +908,7 @@ function SessionsSection({ agent }: { agent: Agent }) {
   const setInspectorOpen = useAppStore((s) => s.setInspectorOpen)
 
   const agentSessions = useMemo(() => {
-    return Object.values(sessions).filter((s) => s.agentId === agent.id)
+    return sortSessionsNewestFirst(Object.values(sessions).filter((s) => s.agentId === agent.id))
   }, [sessions, agent.id])
 
   if (agentSessions.length === 0) return null

package/src/components/chat/chat-area.tsx

@@ -31,6 +31,7 @@ import { api } from '@/lib/app/api-client'
 import { messagesDiffer } from '@/lib/chat/chat-streaming-state'
 import { createAssistantRenderId } from '@/lib/chat/assistant-render-id'
 import { getSessionLastMessage } from '@/lib/chat/session-summary'
+import { buildNewAgentSessionPayload, summarizeFirstMessageAsTitle } from '@/lib/chat/new-session'
 import { getEnabledCapabilityIds, getEnabledToolIds } from '@/lib/capability-selection'
 
 const DIRECT_PROMPT_SUGGESTIONS = [
@@ -57,6 +58,8 @@ export function ChatArea() {
   const setCurrentAgent = useAppStore((s) => s.setCurrentAgent)
   const removeSessionFromStore = useAppStore((s) => s.removeSession)
   const refreshSession = useAppStore((s) => s.refreshSession)
+  const updateSessionInStore = useAppStore((s) => s.updateSessionInStore)
+  const setActiveSessionIdOverride = useAppStore((s) => s.setActiveSessionIdOverride)
   const appSettings = useAppStore((s) => s.appSettings)
   const messages = useChatStore((s) => s.messages)
   const messageStartIndex = useChatStore((s) => s.messageStartIndex)
@@ -172,6 +175,7 @@ export function ChatArea() {
   const hasMultipleSources = connectorSources.size > 1 || (connectorSources.size > 0 && hasDirectMessages)
   const [isDragging, setIsDragging] = useState(false)
   const dragCounter = useRef(0)
+  const freshSessionIdRef = useRef<string | null>(null)
   const setPendingImage = useChatStore((s) => s.setPendingImage)
 
   useEffect(() => {
@@ -180,6 +184,13 @@ export function ChatArea() {
     const requestedSessionId = sessionId
     const chatState = useChatStore.getState()
     const preserveLocalStream = chatState.streaming && chatState.streamingSessionId === requestedSessionId
+    if (freshSessionIdRef.current === requestedSessionId) {
+      freshSessionIdRef.current = null
+      setMessages([], { startIndex: 0, totalMessages: 0 })
+      useChatStore.setState({ hasMoreMessages: false })
+      setMessagesLoading(false)
+      return () => { cancelled = true }
+    }
     // Clear stale messages immediately so the skeleton loader shows instead of
     // the previous chat's messages flashing briefly during the fetch.
     if (!preserveLocalStream) setMessages([], { startIndex: 0, totalMessages: 0 })
@@ -431,7 +442,7 @@ export function ChatArea() {
     setDevServer(null)
   }, [sessionId, setDevServer])
 
-  const handleClear = useCallback(async () => {
+  const handleClear = useCallback(async (mode: 'clear' | 'new-session' = 'clear') => {
     setConfirmClear(false)
     if (!sessionId) return
     const targetSessionId = sessionId
@@ -448,7 +459,11 @@ export function ChatArea() {
     await refreshSession(targetSessionId)
     const { undoToken, cleared } = result
     if (!undoToken) return
-    const clearedLabel = cleared === 1 ? '1 message cleared' : `${cleared.toLocaleString()} messages cleared`
+    const clearedLabel = mode === 'new-session'
+      ? 'Started a fresh chat session.'
+      : cleared === 1
+        ? '1 message cleared'
+        : `${cleared.toLocaleString()} messages cleared`
     toast(clearedLabel, {
       duration: 10_000,
       action: {
@@ -487,6 +502,34 @@ export function ChatArea() {
     setConfirmClear(true)
   }, [])
 
+  const handleStartNewSession = useCallback(async () => {
+    if (!session) return
+    try {
+      const nextSession = await api<typeof session>('POST', '/chats', {
+        ...buildNewAgentSessionPayload(session),
+        name: currentAgent?.name || session.name,
+      })
+      freshSessionIdRef.current = nextSession.id
+      updateSessionInStore(nextSession)
+      setActiveSessionIdOverride(nextSession.id)
+      toast.success('Started a new chat session.')
+    } catch (err) {
+      toast.error(`Could not start a new chat session: ${errorMessage(err)}`)
+    }
+  }, [currentAgent?.name, session, setActiveSessionIdOverride, updateSessionInStore])
+
+  const handleSend = useCallback(async (text: string) => {
+    if (!sessionId) return
+    if (session && messages.length === 0) {
+      const nextTitle = summarizeFirstMessageAsTitle(text, currentAgent?.name || session.name)
+      if (nextTitle && nextTitle !== session.name) {
+        updateSessionInStore({ ...session, name: nextTitle })
+        void api('PUT', `/chats/${sessionId}`, { name: nextTitle }).catch(() => {})
+      }
+    }
+    await sendMessage(text, { sessionId })
+  }, [currentAgent?.name, messages.length, sendMessage, session, sessionId, updateSessionInStore])
+
   const handleDelete = useCallback(async () => {
     setConfirmDelete(false)
     if (!sessionId) return
@@ -496,8 +539,8 @@ export function ChatArea() {
   }, [removeSessionFromStore, sessionId, setCurrentAgent])
 
   const handlePrompt = useCallback((text: string) => {
-    sendMessage(text)
-  }, [sendMessage])
+    void handleSend(text)
+  }, [handleSend])
 
   const handleDragOver = useCallback((e: React.DragEvent) => {
     e.preventDefault()
@@ -568,6 +611,7 @@ export function ChatArea() {
           messageCount={messages.length}
           onCompactComplete={handleCompactComplete}
           onClearRequest={handleClearRequest}
+          onStartNewSession={handleStartNewSession}
         />
       )}
       {!isDesktop && (
@@ -589,6 +633,7 @@ export function ChatArea() {
           messageCount={messages.length}
           onCompactComplete={handleCompactComplete}
           onClearRequest={handleClearRequest}
+          onStartNewSession={handleStartNewSession}
         />
       )}
       <DevServerBar status={devServerStatus} onStop={handleStopDevServer} />
@@ -691,13 +736,13 @@ export function ChatArea() {
         onClose={() => setDebugOpen(false)}
       />
 
-      <ChatInput
-        streaming={streamingForThisSession}
-        busy={streamingForThisSession || session.active === true}
-        onSend={sendMessage}
-        onStop={stopStreaming}
-        extensionChatActions={extensionChatActions}
-      />
+        <ChatInput
+          streaming={streamingForThisSession}
+          busy={streamingForThisSession || session.active === true}
+          onSend={handleSend}
+          onStop={stopStreaming}
+          extensionChatActions={extensionChatActions}
+        />
 
       <Dropdown open={menuOpen} onClose={() => setMenuOpen(false)}>
         <DropdownItem onClick={() => {
@@ -720,7 +765,7 @@ export function ChatArea() {
         message="Clear every message in this chat. Long-term memory, skills, and facts are preserved. You'll have 10 seconds to undo."
         confirmLabel="Clear"
         danger
-        onConfirm={handleClear}
+        onConfirm={() => { void handleClear('clear') }}
         onCancel={() => setConfirmClear(false)}
       />
       <ConfirmDialog

package/src/components/chat/chat-header.tsx

@@ -1,6 +1,7 @@
 'use client'
 
 import { useEffect, useState, useMemo, useRef, type ReactNode } from 'react'
+import { Plus } from 'lucide-react'
 import type { Session } from '@/types'
 import { useAppStore } from '@/stores/use-app-store'
 import { useChatStore } from '@/stores/use-chat-store'
@@ -17,6 +18,7 @@ import { Tooltip, TooltipTrigger, TooltipContent } from '@/components/ui/tooltip
 import { copyTextToClipboard } from '@/lib/clipboard'
 import { useNavigate } from '@/lib/app/navigation'
 import { getEnabledToolIds } from '@/lib/capability-selection'
+import { getNewSessionButtonTitle, hasResettableSessionRuntime } from '@/lib/chat/new-session'
 import { ContextMeterBadge } from './context-meter-badge'
 
 function Tip({ label, children, side = 'bottom' }: { label: string; children: ReactNode; side?: 'top' | 'bottom' | 'left' | 'right' }) {
@@ -84,9 +86,10 @@ interface Props {
   messageCount?: number
   onCompactComplete?: () => void
   onClearRequest?: () => void
+  onStartNewSession?: () => void
 }
 
-export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, mobile, browserActive, onStopBrowser, onVoiceToggle, voiceActive, voiceSupported, connectorSources, connectorFilter, onConnectorFilterChange, hasMultipleSources, messageCount = 0, onCompactComplete, onClearRequest }: Props) {
+export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, mobile, browserActive, onStopBrowser, onVoiceToggle, voiceActive, voiceSupported, connectorSources, connectorFilter, onConnectorFilterChange, hasMultipleSources, messageCount = 0, onCompactComplete, onClearRequest, onStartNewSession }: Props) {
   const now = useNow()
   const agentStatus = useChatStore((s) => s.agentStatus)
   const agents = useAppStore((s) => s.agents)
@@ -114,6 +117,8 @@ export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, m
   const renameInputRef = useRef<HTMLInputElement>(null)
   const renameContainerRef = useRef<HTMLSpanElement>(null)
   const liveStatus = agentStatus || null
+  const canStartNewSession = !streaming && !!onStartNewSession && (messageCount > 0 || hasResettableSessionRuntime(session))
+  const newSessionTitle = getNewSessionButtonTitle(session)
   const connectorPresenceMeta = useMemo(() => {
     if (!connector) return null
     const lastAt = connectorPresence?.lastMessageAt
@@ -431,6 +436,20 @@ export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, m
                 onClearRequest={onClearRequest}
               />
             )}
+            {canStartNewSession && (
+              <Tip label={newSessionTitle}>
+                <button
+                  type="button"
+                  onClick={onStartNewSession}
+                  className="inline-flex items-center gap-1.5 rounded-[9px] border border-white/[0.06] bg-white/[0.03] px-2.5 py-1 text-[10px] font-600 text-text-3/70 transition-colors shrink-0 cursor-pointer hover:border-white/[0.15] hover:bg-white/[0.05] hover:text-text-2"
+                  aria-label="Start a new chat session"
+                  title={newSessionTitle}
+                >
+                  <Plus className="h-3 w-3" aria-hidden="true" strokeWidth={2.2} />
+                  <span>New chat</span>
+                </button>
+              </Tip>
+            )}
           </div>
           {liveStatus?.status && (
           <div className="mt-1.5 flex min-w-0 flex-wrap items-center gap-1.5">

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)