@agent-native/core 0.98.3 → 0.98.5

package/corpus/core/src/scripts/agent-engines/list-agent-engines.ts

@@ -15,8 +15,6 @@ import {
   normalizeModelForEngine,
 } from "../../agent/engine/index.js";
 import type { ActionTool } from "../../agent/types.js";
-import { resolveHostedDefaultModelExperiment } from "../../observability/hosted-model-experiment.js";
-import { getRequestUserEmail } from "../../server/request-context.js";
 import { getSetting } from "../../settings/index.js";
 
 export const tool: ActionTool = {
@@ -84,24 +82,13 @@ export async function run(args: Record<string, string> = {}): Promise<string> {
         ? current?.model
         : undefined;
   const currentEngineName = currentEntry?.name ?? "anthropic";
-  let currentModel =
+  const currentModel =
     currentEntry && !envUnavailable
       ? normalizeModelForEngine(
           currentEntry,
           currentModelCandidate ?? currentEntry.defaultModel,
         )
       : (currentModelCandidate ?? DEFAULT_MODEL);
-  const hostedExperiment =
-    currentEntry && !currentModelCandidate
-      ? resolveHostedDefaultModelExperiment({
-          userId: getRequestUserEmail(),
-          engineName: currentEntry.name,
-          isDefaultModelSelection: true,
-          supportedModels: currentEntry.supportedModels,
-        })
-      : null;
-  if (hostedExperiment) currentModel = hostedExperiment.model;
-
   const result = {
     engines: engines.map((e) => ({
       name: e.name,
@@ -119,12 +106,6 @@ export async function run(args: Record<string, string> = {}): Promise<string> {
       : {
           engine: currentEngineName,
           model: currentModel,
-          ...(hostedExperiment
-            ? {
-                modelSelectionSource: "experiment",
-                experimentAssignment: hostedExperiment.assignment,
-              }
-            : {}),
         },
   };
 

package/corpus/core/src/session-replay-iframe-protocol.ts

@@ -0,0 +1,58 @@
+export const SESSION_REPLAY_IFRAME_ATTRIBUTE =
+  "data-agent-native-session-replay";
+export const SESSION_REPLAY_IFRAME_PROBE = "agent-native-session-replay:probe";
+export const SESSION_REPLAY_IFRAME_START = "agent-native-session-replay:start";
+export const SESSION_REPLAY_IFRAME_STOP = "agent-native-session-replay:stop";
+
+export interface SessionReplayIframePrivacyOptions {
+  blockSelector: string;
+  ignoreSelector: string;
+  maskTextClass?: string | RegExp;
+  maskTextSelector: string;
+  maskAllInputs: boolean;
+  maskInputOptions?: Record<string, boolean>;
+  recordCanvas: boolean;
+  collectFonts: boolean;
+  inlineImages: boolean;
+  sampling: Record<string, unknown>;
+}
+
+export interface SessionReplayIframeProbeMessage {
+  type: typeof SESSION_REPLAY_IFRAME_PROBE;
+}
+
+export interface SessionReplayIframeStartMessage {
+  type: typeof SESSION_REPLAY_IFRAME_START;
+  options: SessionReplayIframePrivacyOptions;
+}
+
+export interface SessionReplayIframeStopMessage {
+  type: typeof SESSION_REPLAY_IFRAME_STOP;
+}
+
+export type SessionReplayIframeMessage =
+  | SessionReplayIframeProbeMessage
+  | SessionReplayIframeStartMessage
+  | SessionReplayIframeStopMessage;
+
+/**
+ * `srcdoc` HTML came from the immediate parent, so that parent already owns the
+ * document being rendered. Server-rendered extension URLs are stricter: only a
+ * parent on the render URL's origin may activate recording. That supports
+ * custom app domains without allowing an external embed host to make an opaque
+ * extension frame disclose its DOM through rrweb's postMessage transport.
+ */
+export function isTrustedSessionReplayIframeParentOrigin(
+  parentOrigin: string,
+  frameHref: string,
+): boolean {
+  if (frameHref === "about:srcdoc") {
+    return parentOrigin !== "null" && parentOrigin !== "";
+  }
+  try {
+    const frameOrigin = new URL(frameHref).origin;
+    return frameOrigin !== "null" && parentOrigin === frameOrigin;
+  } catch {
+    return false;
+  }
+}

package/corpus/core/src/shared/reasoning-effort.ts

@@ -170,6 +170,41 @@ function isClaudeReasoningModel(model: string) {
   return opusMatch ? parseInt(opusMatch[1], 10) >= 6 : false;
 }
 
+/**
+ * Anthropic's adaptive-thinking API is only available on the newer Claude
+ * model families. Claude Haiku 4.5 is reasoning-capable, but it still
+ * requires the legacy manual `budget_tokens` configuration.
+ */
+export function supportsClaudeAdaptiveThinking(model: string | undefined) {
+  if (!model) return false;
+  const id = model.toLowerCase().replace(/^anthropic\//, "");
+  if (id.includes("fable-5") || id.includes("mythos-5")) return true;
+  if (id.includes("sonnet-5") || id.includes("sonnet-4-6")) return true;
+  const opusMatch = id.match(/opus-4[-.](\d+)/);
+  return opusMatch ? parseInt(opusMatch[1], 10) >= 6 : false;
+}
+
+/**
+ * Map the shared reasoning ladder to Anthropic's manual thinking budgets for
+ * models that do not support adaptive thinking (currently Claude Haiku 4.5).
+ */
+export function anthropicManualThinkingBudget(effort: ReasoningEffort) {
+  switch (effort) {
+    case "low":
+      return 1_024;
+    case "medium":
+      return 4_096;
+    case "high":
+      return 8_000;
+    case "xhigh":
+      return 16_000;
+    case "max":
+      return 32_000;
+    default:
+      return 4_096;
+  }
+}
+
 function supportsClaudeXHigh(model: string) {
   const id = model.toLowerCase().replace(/^anthropic\//, "");
   // Models that support the xhigh effort tier (built-in extended thinking via

package/corpus/core/src/styles/agent-conversation.css

@@ -493,6 +493,32 @@
   -webkit-mask-image: linear-gradient(to bottom, transparent, black 1.5rem);
 }
 
+.agent-chat-collapse {
+  display: grid;
+  grid-template-rows: 1fr;
+  opacity: 1;
+  transition:
+    grid-template-rows 200ms var(--ease-collapse),
+    opacity 150ms ease-out;
+}
+
+.agent-chat-collapse[data-state="closed"] {
+  grid-template-rows: 0fr;
+  opacity: 0;
+  pointer-events: none;
+}
+
+.agent-chat-collapse__content {
+  min-height: 0;
+  overflow: hidden;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .agent-chat-collapse {
+    transition-duration: 0.01ms;
+  }
+}
+
 /* ─── Agent-Markdown (AssistantChat react-markdown render surface) ─────────── */
 /* These classes are applied by the SmoothMarkdownText/MarkdownText components  */
 /* in the AssistantChat/AssistantChatInner tree. The shiki dual-theme rules      */

package/corpus/core/src/templates/workspace-core/.agents/skills/observability/SKILL.md

@@ -158,21 +158,6 @@ The agent loop reads active experiments via `resolveActiveExperimentConfig()` an
 
 Compute results with `POST /_agent-native/observability/experiments/:id/results`.
 
-#### First-party hosted default-model rollout
-
-First-party apps on `agent-native.com` automatically run the July 2026
-default-model experiment for authenticated users on the Builder engine:
-
-- 80% `claude-sonnet-5`
-- 20% `gpt-5-6-luna`
-- Assignment is sticky by normalized user email and shared across templates.
-- The rollout applies only when the user, app, and deployment have not selected
-  a model. Explicit model choices and BYO provider engines always win.
-- Set `AGENT_NATIVE_HOSTED_MODEL_EXPERIMENT=off` for an emergency rollback, or
-  `true` to exercise the rollout on a non-first-party preview.
-- `$ai_generation` tracking includes `experiment_id`,
-  `experiment_variant`, and `model_selection_source` for central analysis.
-
 In production, experiment management routes require the caller's email in the
 comma-separated `AGENT_NATIVE_EXPERIMENT_ADMIN_EMAILS` allowlist. This gate is
 separate from normal app/org admin roles because an experiment affects every

package/corpus/templates/analytics/.agents/skills/session-replay/SKILL.md

@@ -102,9 +102,9 @@ agent answers about browser recordings in the Analytics template.
 - Wait for all replay chunks (`isComplete`) before constructing the rrweb
   `Replayer`. Progressive chunk publishes should only update the loading bar;
   rebuilding the player mid-load desyncs the scrubber and playhead.
-- Pass events to `Replayer` untouched. rrweb rebuilds them in a sandboxed iframe;
-  pre-processing DOM, stylesheet, resource, or mutation payloads makes playback
-  diverge from the captured page. In particular, never rewrite `href`, `src`,
+- Pass normal events to `Replayer` untouched. rrweb rebuilds them in a sandboxed
+  iframe; pre-processing DOM, stylesheet, resource, or mutation payloads makes
+  playback diverge from the captured page. In particular, never rewrite `href`, `src`,
   `_cssText`, CSS `url()`, or Meta URLs to `about:blank`; that exact remediation
   broke historical replay CSS in PR #2040. Handle request privacy at capture or
   the sandbox boundary instead of mutating stored rrweb events. Historical
@@ -112,19 +112,59 @@ agent answers about browser recordings in the Analytics template.
   requests for accurate rendering; the viewer accepts that fidelity tradeoff,
   uses rrweb's script-disabled sandbox plus `referrerpolicy="no-referrer"`, and
   must never add credentials or proxy those URLs through a privileged server.
-- Let rrweb own normal iframe sizing via Meta / ViewportResize, and keep the
-  outer wrapper in that same coordinate system for fit-to-stage scaling. Some
-  legacy recordings contain demonstrably corrupt 4,000–7,500px-wide viewport
-  values from ordinary desktop sessions. Only widths of at least 4,000px with
-  aspect ratios above 4:1 are recovered to a 16:10 viewport; real 32:9 and
-  mobile portrait captures remain untouched. The resize handler applies the
-  recovery to **both** rrweb's iframe and the outer stage.
-  Never remove this recovery, clamp only one layer, or broadly rewrite event
-  geometry: those changes repeatedly recreated the ribbon/clipping regression.
-- Keep the realistic fidelity and malformed-viewport tests in
-  `SessionDetailPage.spec.ts`. Do not change their expectations merely to bless
-  a new sanitizer or raw ultra-wide sizing; validate the affected replay in a
-  browser first.
+- Capture-time URL scrubbing must preserve load-bearing DOM resource attributes:
+  `src`, `srcset`, `poster`, `data`, and `href` only on resource links such as
+  stylesheets, preloads, and icons. Signed CDN query parameters are part of the
+  resource identity; redacting them produces missing CSS, fonts, images, and
+  oversized fallback icons. Keep scrubbing Meta/navigation URLs, anchor hrefs,
+  and console/network diagnostics. Captured `_cssText` and CSS `@import`/`url()`
+  values must remain byte-identical.
+- rrweb rebuilds into an `about:srcdoc` iframe, which inherits the Analytics
+  document's CSP. Analytics currently sends no CSP header; if a future change
+  adds restrictive `style-src`, `font-src`, or `img-src` directives, verify
+  historical replays and resolve external imports/fonts at capture before
+  blocking the recorded resource origins. Do not diagnose current font loss as
+  CSP without checking the deployed response headers first.
+- Let rrweb own iframe sizing entirely via Meta / ViewportResize, and keep the
+  outer wrapper on the exact same raw dimensions for fit-to-stage scaling.
+  Player geometry and pointer coordinates are fully stock and untouched — do
+  not add width/aspect-ratio "recovery" heuristics or pointer-coordinate
+  projection. There is no such thing as a stored recording with corrupt
+  viewport geometry: a census of all production recordings found zero stored
+  widths >= 3,000px. The 2026-07 "ultra-wide replay" bugs (stages rendered
+  3,000–9,500px wide, frozen/teleporting cursors, giant icons) were caused
+  entirely by demo mode's fetch interceptor: its number redactor faked any
+  integer >= 1000 inside raw replay JSON at *view* time, corrupting Meta /
+  ViewportResize widths, pointer x/y coordinates, and numeric values inside
+  `_cssText` and SVG attributes before rrweb ever saw the payload (heights
+  below 1000 stayed real, which is why the symptom looked like a viewport
+  problem rather than a redaction bug — two different sessions that both
+  stored a 1,152px width read back as the same 4,491px, a deterministic
+  salted-hash fingerprint of the redactor, not two coincidentally identical
+  malformed recordings). This is fixed in
+  `packages/core/src/demo/fetch-interceptor.ts`: raw replay payload and
+  manifest URLs are skipped from demo number redaction entirely, and must
+  never be routed through it again. Do not reintroduce viewport clamping or
+  pointer-coordinate projection in the player — they can now only corrupt
+  genuine future recordings (for example, a real 3440x900 ultrawide browser
+  window, or a short vertical window under 1,000px tall).
+- Keep rrweb's stock cursor stylesheet and its hotspot transform. During
+  playback, hide the viewer's native pointer over Analytics' transparent
+  click-to-pause overlay so it cannot masquerade as a frozen recorded cursor.
+- Keep rrweb's recorded focus handling enabled. Focus and focus-visible state
+  affect menus, forms, and keyboard UX; disabling `triggerFocus` makes a valid
+  snapshot diverge from the source page.
+- `insertStyleRules` may suppress known toast/snackbar containers only. Never
+  hide generic framework primitives such as
+  `[data-radix-popper-content-wrapper]`: Radix dropdowns, selects, tooltips,
+  and other real recorded product UI all share that wrapper.
+- Keep the realistic-fidelity purity/pass-through tests in
+  `SessionDetailPage.spec.ts` — raw event identity, raw viewport dimensions,
+  and raw resize-state derivation (including the 3,189x885 tripwire against
+  reintroducing a clamp) — as regression guards against reintroducing any
+  viewport "recovery" or pointer-projection heuristic. Do not change their
+  expectations merely to bless a new sanitizer or clamp; validate the affected
+  replay in a browser first.
 - The event timeline soft-highlights the active marker, auto-scrolls it into
   view (pausing briefly after manual scroll), and supports search. It appears
   beside the player from ~880px content width upward.
@@ -161,3 +201,14 @@ agent answers about browser recordings in the Analytics template.
   `.an-mask` or `data-an-mask`.
 - Use `.an-block`, `.an-ignore`, `data-an-block`, or `data-an-ignore` for
   sensitive zones that should not be captured.
+- A definitive upload `409` abandons only the conflicted replay identity and
+  immediately starts rrweb again under a fresh per-tab id, producing a new
+  Meta + FullSnapshot for long-lived SPA tabs. Recovery is limited to one
+  restart until an upload succeeds so a misconfigured endpoint cannot loop;
+  Analytics tracks the content-free `session replay upload rejected` lifecycle
+  event so conflicts and recovery success are measurable.
+- Do not label an old recording "corrupt" from pointer coordinates, unknown
+  mutation node ids, or changing Meta geometry alone. Those shapes can be
+  legitimate with scrolling, iframes/shadow DOM, navigation, and resize. A
+  historical-artifact notice needs a durable capture/ingest marker or another
+  low-false-positive invariant; do not guess from playback heuristics.

package/corpus/templates/analytics/AGENTS.md

@@ -106,6 +106,18 @@ details live in `.agents/skills/`.
   / `$ai_latency`, `status`, `tool_calls`, `successful_tools`, `failed_tools`,
   and `$ai_error` / `error_message`. Do not expect prompts, tool args, or model
   responses in these tracked events by default.
+- External MCP callers should use `ask_app` as the default for multi-step
+  Analytics work. It can resolve a person's known email, correlate sessions
+  with captured errors, mint a temporary replay-context link, and inspect the
+  timeline, page navigation, console diagnostics, failed network requests, and
+  clicks when needed. The authenticated connector catalog is the fast fallback
+  and exposes only bounded, user/org-scoped read actions for incident triage:
+  `list-session-recordings`, `get-session-replay-summary`,
+  `get-session-replay-events`, `query-agent-native-analytics`,
+  `list-error-issues`, and `get-error-issue`. Fetch the summary before raw
+  events, use the event filters/limits to keep the response bounded, and do not
+  add replay blob or dashboard mutation actions to this catalog without an
+  explicit security review.
 - `/agents` is the Analytics home for admin surfaces. The default Monitoring
   view embeds the shared observability dashboard for traces, conversations,
   evals, experiments, and feedback. `/agents?view=dashboards` shows the

package/corpus/templates/analytics/actions/get-error-issue.ts

@@ -28,6 +28,7 @@ export default defineAction({
   }),
   http: { method: "GET" },
   readOnly: true,
+  publicAgent: { expose: true, readOnly: true, requiresAuth: true },
   run: async (args) => {
     return getErrorIssue(resolveScope(), args.id, {
       eventsLimit: args.eventsLimit,

package/corpus/templates/analytics/actions/get-session-replay-events.ts

@@ -40,6 +40,7 @@ export default defineAction({
   }),
   http: { method: "GET" },
   readOnly: true,
+  publicAgent: { expose: true, readOnly: true, requiresAuth: true },
   run: async (args) => {
     return getSessionReplayEvents(args.recordingId, resolveScope(), {
       startSeq: args.startSeq,

package/corpus/templates/analytics/actions/get-session-replay-summary.ts

@@ -21,6 +21,7 @@ export default defineAction({
   }),
   http: { method: "GET" },
   readOnly: true,
+  publicAgent: { expose: true, readOnly: true, requiresAuth: true },
   run: async (args) => {
     return getSessionReplaySummary(args.recordingId, resolveScope());
   },

package/corpus/templates/analytics/actions/list-error-issues.ts

@@ -34,6 +34,7 @@ export default defineAction({
   }),
   http: { method: "GET" },
   readOnly: true,
+  publicAgent: { expose: true, readOnly: true, requiresAuth: true },
   run: async (args) => {
     return listErrorIssues(resolveScope(), args);
   },

package/corpus/templates/analytics/actions/list-session-recordings.ts

@@ -58,6 +58,7 @@ export default defineAction({
   }),
   http: { method: "GET" },
   readOnly: true,
+  publicAgent: { expose: true, readOnly: true, requiresAuth: true },
   run: async (args) => {
     return listSessionRecordings(resolveScope(), args);
   },

package/corpus/templates/analytics/actions/query-agent-native-analytics.ts

@@ -33,7 +33,8 @@ export default defineAction({
     ),
   }),
   readOnly: true,
-  http: false,
+  http: { method: "GET" },
+  publicAgent: { expose: true, readOnly: true, requiresAuth: true },
   run: async (args) => {
     return queryFirstPartyAnalytics(args.sql, resolveScope());
   },

package/corpus/templates/analytics/app/global.css

@@ -186,7 +186,7 @@
   .analytics-chat-intro {
   display: grid;
   width: 100%;
-  max-width: min(570px, 90%);
+  max-width: min(684px, 90%);
   gap: 0.5rem;
   margin: 0 auto 1rem;
   text-align: center;
@@ -223,7 +223,7 @@
   [data-agent-empty-state="centered"]
   .agent-plan-mode-callout {
   width: 100%;
-  max-width: min(570px, 90%);
+  max-width: min(684px, 90%);
   padding: 0;
 }
 
@@ -245,72 +245,14 @@
   transform-origin: top left;
 }
 
-/* First-party visitor-cursor styles for rrweb playback. These are bundled
-   statically so the cursor stays visible even if the lazily imported
-   `@rrweb/replay/dist/style.css` sheet fails to load, and they replace the
-   default black arrow sprite with an app-styled indicator. The cursor lives
-   inside `.replayer-wrapper`, so it scales with the fit-to-stage transform. */
-.an-replay-stage-root .replayer-mouse {
-  position: absolute;
-  z-index: 2;
-  width: 1.125rem;
-  height: 1.5rem;
-  border-radius: 0;
-  background: transparent;
-  background-image: none;
-  box-shadow: none;
-  transform: none;
-  transition:
-    left 80ms linear,
-    top 80ms linear;
-  pointer-events: none;
-}
-
-.an-replay-stage-root .replayer-mouse::before {
-  content: "";
-  position: absolute;
-  inset: 0;
-  background: hsl(0 0% 100%);
-  clip-path: polygon(0 0, 0 77%, 30% 57%, 48% 100%, 68% 92%, 50% 51%, 92% 51%);
-  filter: drop-shadow(0 0 1px hsl(0 0% 0% / 0.95))
-    drop-shadow(0 1px 3px hsl(0 0% 0% / 0.35));
-}
-
+/* IMPORTANT: Keep rrweb's stock SVG arrow. Only suppress its permanently
+   visible purple ::after disc, which can otherwise read as the cursor itself
+   when the arrow is small. The stock .active animation still supplies the
+   brief click halo. Do not replace the arrow with an app-colored dot. */
 .an-replay-stage-root .replayer-mouse::after {
-  content: "";
-  position: absolute;
-  left: -0.5rem;
-  top: -0.5rem;
-  width: 1rem;
-  height: 1rem;
-  border-radius: 9999px;
-  border: 2px solid hsl(217 91% 60%);
-  background: transparent;
   opacity: 0;
 }
 
-/* rrweb toggles `.active` on mouse interactions; pulse a click ripple. */
-.an-replay-stage-root .replayer-mouse.active::after {
-  animation: an-replay-mouse-click 0.4s ease-out 1;
-}
-
-@keyframes an-replay-mouse-click {
-  0% {
-    opacity: 0.5;
-    transform: scale(1);
-  }
-  100% {
-    opacity: 0;
-    transform: scale(3.5);
-  }
-}
-
-.an-replay-stage-root .replayer-mouse-tail {
-  position: absolute;
-  inset: 0;
-  pointer-events: none;
-}
-
 .analytics-session-snippet .plan-code-surface {
   border: 0;
   border-radius: 0;

package/corpus/templates/analytics/app/hooks/use-dashboard-chat-context.ts

@@ -1,12 +1,14 @@
 import {
+  SIDEBAR_STATE_CHANGE_EVENT,
   deleteClientAppState,
   readClientAppState,
   removeAgentChatContextItem,
   setAgentChatContextItem,
   setClientAppState,
+  type AgentSidebarStateChangeDetail,
   useAgentChatContext,
 } from "@agent-native/core/client";
-import { useCallback, useEffect } from "react";
+import { useCallback, useEffect, useState } from "react";
 
 import { TAB_ID } from "@/lib/tab-id";
 
@@ -120,10 +122,22 @@ function parsePanelSelection(
   }
 }
 
+function isAgentSidebarOpenInDocument(): boolean {
+  if (typeof document === "undefined") return false;
+  return Boolean(
+    document.querySelector(
+      '.agent-sidebar-panel[data-agent-sidebar-state="open"]',
+    ),
+  );
+}
+
 export function useDashboardChatContext(
   args: DashboardChatContextArgs,
 ): DashboardChatContextResult {
   const { id, kind, title, panelCount, canEdit } = args;
+  const [isAgentSidebarOpen, setIsAgentSidebarOpen] = useState(
+    isAgentSidebarOpenInDocument,
+  );
   const { items } = useAgentChatContext();
   const panelContext = items.find(
     (item) => item.key === DASHBOARD_PANEL_CONTEXT_KEY,
@@ -132,7 +146,9 @@ export function useDashboardChatContext(
     ? parsePanelSelection(panelContext.context)
     : null;
   const selectedPanelId =
-    id && panelSelection?.dashboardId === id ? panelSelection.panelId : null;
+    isAgentSidebarOpen && id && panelSelection?.dashboardId === id
+      ? panelSelection.panelId
+      : null;
   const hasSelectedPanel = selectedPanelId !== null;
 
   const selectPanelForChat = useCallback(
@@ -141,6 +157,7 @@ export function useDashboardChatContext(
       options: SelectDashboardPanelOptions = {},
     ) => {
       if (!id) return;
+      if (options.openSidebar !== true && !isAgentSidebarOpen) return;
       const displayDashboardTitle = title?.trim() || id;
       const displayPanelTitle = panel.panelTitle.trim() || panel.panelId;
       const contextLines = [
@@ -166,7 +183,7 @@ export function useDashboardChatContext(
         key: DASHBOARD_PANEL_CONTEXT_KEY,
         title: displayPanelTitle,
         context: contextLines.join("\n"),
-        openSidebar: options.openSidebar ?? true,
+        openSidebar: options.openSidebar === true,
         focus: options.focus ?? false,
       });
       setClientAppState(
@@ -191,9 +208,29 @@ export function useDashboardChatContext(
         },
       ).catch(() => {});
     },
-    [id, kind, title],
+    [id, isAgentSidebarOpen, kind, title],
   );
 
+  useEffect(() => {
+    const handleSidebarStateChange = (event: Event) => {
+      const detail = (event as CustomEvent<AgentSidebarStateChangeDetail>)
+        .detail;
+      if (typeof detail?.open === "boolean") {
+        setIsAgentSidebarOpen(detail.open);
+      }
+    };
+
+    window.addEventListener(
+      SIDEBAR_STATE_CHANGE_EVENT,
+      handleSidebarStateChange,
+    );
+    return () =>
+      window.removeEventListener(
+        SIDEBAR_STATE_CHANGE_EVENT,
+        handleSidebarStateChange,
+      );
+  }, []);
+
   useEffect(() => {
     if (!id) return;
     const displayTitle = title?.trim() || id;