sdf

AGENTS.md

@@ -9,6 +9,7 @@
 - Build prerequisite: `protoc` must be on PATH (the LanceDB-backed agent memory store pulls lance-* crates whose build scripts compile vendored .proto files). On macOS: `brew install protobuf`.
 - Run scooped tests and format instead of repo wide when working with rust to save time and storage.
 - Dont create branches or stash unless user asks, there may be multiple agents working at the same time and doing this will break things
+- When running in development, you should only be using the data in Support/dev.sn0w.xero
 
 ## Stages vs. Workflow (terminology)
 

README.md

@@ -132,6 +132,9 @@ Detected/used CLIs include:
 
 If tools are missing, workbench surfaces degraded/missing-toolchain states rather than crashing.
 
+For the current Solana workbench and autonomous tool coverage map, see
+`docs/solana-workbench-tool-coverage-audit.md`.
+
 ### 4) Server features
 
 - Postgres is provided by `server/docker-compose.yml` in local development.
@@ -379,6 +382,10 @@ Use `--json` on batch commands for scriptable output, and `--app-data-dir PATH`
 
 The agent TUI parity matrix lives in `docs/agent-tui-parity.md`. Desktop-only browser viewport, emulator live panes, graphical canvas gestures, window chrome, and microphone dictation remain explicit exclusions; renderer-independent workflows are exposed through terminal-native panes or CLI commands.
 
+Owned-agent file mutations use stale-file protection: agents must observe existing files and pass current SHA-256 guards before writing, while command mutations invalidate prior observations. See `docs/agent-stale-file-protection.md` for the mutation-path inventory and retry contract.
+
+Context pressure, compaction, and same-type handoff behavior are audited in `docs/context-exhaustion-compaction-handoff.md`, including the proposed continuity model-routing rollout.
+
 Scoped verification for harness work:
 
 ```bash
@@ -453,15 +460,13 @@ XERO_SKIP_DICTATION_SHIM=1
 These are optional and only needed for specific runtime integrations:
 
 ```bash
-# Custom web-search provider used by autonomous web tools
-XERO_AUTONOMOUS_WEB_SEARCH_URL=https://...
-XERO_AUTONOMOUS_WEB_SEARCH_BEARER_TOKEN=...
-
 # Solana workbench resource overrides
 XERO_SOLANA_RESOURCE_ROOT=/path/to/resources
 XERO_SOLANA_TOOLCHAIN_ROOT=/path/to/toolchain
 ```
 
+Autonomous web search is configured in the desktop app under Settings -> Web Search. Xero stores non-secret provider settings in OS app-data and stores API keys through the same provider credential table used for LLM providers. The custom endpoint contract is `GET <endpoint>?q=<query>&limit=<count>` with a JSON response shaped as `{ "results": [{ "title": string, "url": string, "snippet"?: string }] }`.
+
 ---
 
 ## Persistence Model

client/components/xero/agent-dock-sidebar.test.tsx

@@ -7,11 +7,16 @@ import { createXeroHighChurnStore } from '@/src/features/xero/use-xero-desktop-s
 import type { AgentSessionView } from '@/src/lib/xero-model'
 
 interface CapturedRuntimeProps {
+  active?: boolean
   density?: 'comfortable' | 'compact'
   inSidebar?: boolean
   sidebarSessions?: readonly AgentSessionView[]
   onCloseSidebar?: () => void
   onSelectSidebarSession?: (id: string) => void
+  onClearSidebarChat?: () => void
+  sidebarChatClearDisabled?: boolean
+  sidebarChatClearPending?: boolean
+  sidebarChatClearTitle?: string
   onCreateSession?: () => void
   isCreatingSession?: boolean
   agentCreateCanvasIncluded?: boolean
@@ -21,11 +26,16 @@ interface CapturedRuntimeProps {
 vi.mock('@/components/xero/agent-runtime/live-agent-runtime', () => ({
   LiveAgentRuntimeView: ({
     agent,
+    active,
     density,
     inSidebar,
     sidebarSessions,
     onCloseSidebar,
     onSelectSidebarSession,
+    onClearSidebarChat,
+    sidebarChatClearDisabled,
+    sidebarChatClearPending,
+    sidebarChatClearTitle,
     onCreateSession,
     isCreatingSession,
     agentCreateCanvasIncluded,
@@ -34,6 +44,7 @@ vi.mock('@/components/xero/agent-runtime/live-agent-runtime', () => ({
     if (!agent) return null
     return (
       <div data-testid="live-agent-runtime">
+        <div data-testid="live-agent-runtime-active">{active ? 'true' : 'false'}</div>
         <div data-testid="live-agent-runtime-density">{density}</div>
         <div data-testid="live-agent-runtime-in-sidebar">{inSidebar ? 'true' : 'false'}</div>
         <div data-testid="live-agent-runtime-session-count">{sidebarSessions?.length ?? 0}</div>
@@ -46,6 +57,14 @@ vi.mock('@/components/xero/agent-runtime/live-agent-runtime', () => ({
         <button type="button" onClick={() => onCloseSidebar?.()}>
           mock-close
         </button>
+        <button
+          type="button"
+          disabled={sidebarChatClearDisabled || sidebarChatClearPending}
+          title={sidebarChatClearTitle}
+          onClick={() => onClearSidebarChat?.()}
+        >
+          mock-clear-chat
+        </button>
         <button
           type="button"
           disabled={isCreatingSession}
@@ -121,6 +140,15 @@ const dummyAgent = {
   },
 } as unknown as ComponentProps<typeof AgentDockSidebar>['agent']
 
+function setViewportWidth(width: number) {
+  Object.defineProperty(window, 'innerWidth', {
+    configurable: true,
+    writable: true,
+    value: width,
+  })
+  window.dispatchEvent(new Event('resize'))
+}
+
 function renderDock(
   overrides: Partial<ComponentProps<typeof AgentDockSidebar>> = {},
 ) {
@@ -142,16 +170,26 @@ function renderDock(
 
 describe('AgentDockSidebar', () => {
   afterEach(() => {
+    setViewportWidth(1024)
     window.localStorage.clear()
   })
 
   it('renders the live agent runtime in sidebar mode when open with an agent', () => {
     renderDock()
     expect(screen.getByTestId('live-agent-runtime')).toBeInTheDocument()
+    expect(screen.getByTestId('live-agent-runtime-active')).toHaveTextContent('true')
     expect(screen.getByTestId('live-agent-runtime-in-sidebar')).toHaveTextContent('true')
     expect(screen.getByTestId('live-agent-runtime-session-count')).toHaveTextContent('2')
   })
 
+  it('prerenders the agent runtime while closed during surface prewarm', () => {
+    renderDock({ open: false, prewarm: true })
+
+    expect(screen.getByTestId('live-agent-runtime')).toBeInTheDocument()
+    expect(screen.getByTestId('live-agent-runtime-active')).toHaveTextContent('false')
+    expect(screen.queryByText('No active session')).not.toBeInTheDocument()
+  })
+
   it('keeps the runtime comfortable until the sidebar is below the compact breakpoint', () => {
     window.localStorage.setItem('xero.agentDock.width', '420')
 
@@ -168,6 +206,20 @@ describe('AgentDockSidebar', () => {
     expect(screen.getByTestId('live-agent-runtime-density')).toHaveTextContent('compact')
   })
 
+  it('uses a fixed full-width sheet on mobile viewports', () => {
+    setViewportWidth(390)
+
+    renderDock()
+
+    const aside = screen.getByLabelText('Agent dock')
+    expect(aside).toHaveClass('fixed')
+    expect(aside).toHaveClass('right-0')
+    expect(aside).toHaveClass('max-w-[100dvw]')
+    expect(aside).toHaveStyle({ maxWidth: '100dvw' })
+    expect(screen.getByRole('separator', { name: 'Resize agent dock', hidden: true })).toHaveClass('hidden')
+    expect(screen.getByTestId('live-agent-runtime-density')).toHaveTextContent('compact')
+  })
+
   it('shows the empty state when no agent is available', () => {
     renderDock({ agent: null })
     expect(screen.queryByTestId('live-agent-runtime')).not.toBeInTheDocument()
@@ -184,6 +236,20 @@ describe('AgentDockSidebar', () => {
     expect(onCreateSession).toHaveBeenCalledTimes(1)
   })
 
+  it('forwards the Computer Use clear chat action into the agent runtime header', () => {
+    const onClearSidebarChat = vi.fn()
+    renderDock({
+      onClearSidebarChat,
+      sidebarChatClearTitle: 'Clear this sidebar chat',
+    })
+
+    const clearButton = screen.getByRole('button', { name: 'mock-clear-chat' })
+    expect(clearButton).toHaveAttribute('title', 'Clear this sidebar chat')
+    fireEvent.click(clearButton)
+
+    expect(onClearSidebarChat).toHaveBeenCalledTimes(1)
+  })
+
   it('forwards the Agent Create canvas context into the agent runtime', () => {
     renderDock({ agentCreateCanvasIncluded: true })
 

client/components/xero/agent-dock-sidebar.tsx

@@ -1,6 +1,6 @@
 "use client"
 
-import { useCallback, useMemo, useRef, useState } from "react"
+import { useCallback, useEffect, useMemo, useRef, useState } from "react"
 import { Bot, Plus } from "lucide-react"
 
 import { cn } from "@/lib/utils"
@@ -24,8 +24,28 @@ import type {
 const MIN_WIDTH = 320
 const MAX_WIDTH = 720
 const DEFAULT_WIDTH = 560
+const MOBILE_OVERLAY_BREAKPOINT = 768
 const WIDTH_STORAGE_KEY = "xero.agentDock.width"
 
+function readViewportWidth(): number | null {
+  if (typeof window === "undefined") return null
+  return window.innerWidth
+}
+
+function useViewportWidth(): number | null {
+  const [viewportWidth, setViewportWidth] = useState<number | null>(() => readViewportWidth())
+
+  useEffect(() => {
+    if (typeof window === "undefined") return
+    const updateViewportWidth = () => setViewportWidth(window.innerWidth)
+    updateViewportWidth()
+    window.addEventListener("resize", updateViewportWidth)
+    return () => window.removeEventListener("resize", updateViewportWidth)
+  }, [])
+
+  return viewportWidth
+}
+
 function readPersistedWidth(): number | null {
   if (typeof window === "undefined") return null
   try {
@@ -50,6 +70,7 @@ function writePersistedWidth(width: number): void {
 
 export interface AgentDockSidebarProps {
   open: boolean
+  prewarm?: boolean
   agent: AgentPaneView | null
   highChurnStore: XeroHighChurnStore
   sessions: readonly AgentSessionView[]
@@ -62,6 +83,7 @@ export interface AgentDockSidebarProps {
   accountAvatarUrl?: string | null
   accountLogin?: string | null
   toolCallGroupingPreference?: AgentRuntimeProps["toolCallGroupingPreference"]
+  agentRoutingAutoSwitchEnabled?: AgentRuntimeProps["agentRoutingAutoSwitchEnabled"]
   customAgentDefinitions?: readonly AgentDefinitionSummaryDto[]
   onOpenAgentManagement?: () => void
   onCreateAgentByHand?: AgentRuntimeProps["onCreateAgentByHand"]
@@ -75,6 +97,11 @@ export interface AgentDockSidebarProps {
   onStartRuntimeRun?: AgentRuntimeProps["onStartRuntimeRun"]
   onUpdateRuntimeRunControls?: AgentRuntimeProps["onUpdateRuntimeRunControls"]
   onComposerControlsChange?: AgentRuntimeProps["onComposerControlsChange"]
+  onClearSidebarChat?: AgentRuntimeProps["onClearSidebarChat"]
+  sidebarChatClearDisabled?: AgentRuntimeProps["sidebarChatClearDisabled"]
+  sidebarChatClearLabel?: AgentRuntimeProps["sidebarChatClearLabel"]
+  sidebarChatClearPending?: AgentRuntimeProps["sidebarChatClearPending"]
+  sidebarChatClearTitle?: AgentRuntimeProps["sidebarChatClearTitle"]
   onStartRuntimeSession?: AgentRuntimeProps["onStartRuntimeSession"]
   onStopRuntimeRun?: AgentRuntimeProps["onStopRuntimeRun"]
   onSubmitManualCallback?: AgentRuntimeProps["onSubmitManualCallback"]
@@ -90,11 +117,11 @@ export interface AgentDockSidebarProps {
   onPendingInitialRuntimeAgentIdConsumed?: AgentRuntimeProps["onPendingInitialRuntimeAgentIdConsumed"]
   pendingComposerInsert?: AgentRuntimeProps["pendingComposerInsert"]
   onPendingComposerInsertConsumed?: AgentRuntimeProps["onPendingComposerInsertConsumed"]
-  browserContextLoading?: AgentRuntimeProps["browserContextLoading"]
 }
 
 export function AgentDockSidebar({
   open,
+  prewarm = false,
   agent,
   highChurnStore,
   sessions,
@@ -107,8 +134,11 @@ export function AgentDockSidebar({
 }: AgentDockSidebarProps) {
   const [width, setWidth] = useState<number>(() => readPersistedWidth() ?? DEFAULT_WIDTH)
   const [isResizing, setIsResizing] = useState(false)
+  const viewportWidth = useViewportWidth()
+  const isMobileOverlay = viewportWidth !== null && viewportWidth < MOBILE_OVERLAY_BREAKPOINT
+  const renderedWidth = isMobileOverlay && viewportWidth !== null ? viewportWidth : width
   const motionOpen = useSidebarOpenMotion(open)
-  const targetWidth = motionOpen ? width : 0
+  const targetWidth = motionOpen ? renderedWidth : 0
   const widthMotion = useSidebarWidthMotion(targetWidth, { isResizing })
   const widthRef = useRef(width)
   widthRef.current = width
@@ -117,6 +147,7 @@ export function AgentDockSidebar({
     () => sessions.filter((session) => session.isActive),
     [sessions],
   )
+  const shouldRenderRuntime = Boolean(agent && (open || prewarm))
 
   const handleResizeStart = useCallback((event: React.PointerEvent<HTMLDivElement>) => {
     if (event.button !== 0) return
@@ -171,11 +202,17 @@ export function AgentDockSidebar({
       aria-label="Agent dock"
       className={cn(
         widthMotion.islandClassName,
-        "relative flex shrink-0 flex-col overflow-hidden bg-sidebar",
+        "flex shrink-0 flex-col overflow-hidden bg-sidebar",
+        isMobileOverlay
+          ? "fixed inset-y-0 right-0 z-50 max-w-[100dvw] shadow-2xl"
+          : "relative",
         open ? "border-l border-border/80" : "border-l-0",
       )}
       inert={!open ? true : undefined}
-      style={widthMotion.style}
+      style={{
+        ...widthMotion.style,
+        maxWidth: isMobileOverlay ? "100dvw" : undefined,
+      }}
     >
       <div
         aria-label="Resize agent dock"
@@ -187,25 +224,29 @@ export function AgentDockSidebar({
           "absolute inset-y-0 -left-[3px] z-10 w-[6px] cursor-col-resize bg-transparent transition-colors",
           "hover:bg-primary/30",
           isResizing && "bg-primary/40",
+          isMobileOverlay && "hidden",
         )}
         onKeyDown={handleResizeKey}
         onPointerDown={handleResizeStart}
         role="separator"
-        tabIndex={open ? 0 : -1}
+        tabIndex={open && !isMobileOverlay ? 0 : -1}
       />
 
       <div
         className="flex h-full min-w-0 shrink-0 flex-col"
-        style={{ width }}
+        style={{
+          width: renderedWidth,
+          maxWidth: isMobileOverlay ? "100dvw" : undefined,
+        }}
       >
         <div className="flex min-h-0 flex-1 flex-col">
-          {open && agent ? (
+          {shouldRenderRuntime ? (
             <LiveAgentRuntimeView
               {...runtimeProps}
               active={open}
               agent={agent}
               highChurnStore={highChurnStore}
-              density={width < SIDEBAR_AGENT_PANE_COMPACT_WIDTH_PX ? "compact" : "comfortable"}
+              density={renderedWidth < SIDEBAR_AGENT_PANE_COMPACT_WIDTH_PX ? "compact" : "comfortable"}
               onCreateSession={onCreateSession}
               isCreatingSession={isCreatingSession}
               inSidebar