@wzrhine/agent 0.0.0-stage → 0.2.0

package/dist/components/shell/AgentHeader.d.ts

@@ -0,0 +1,84 @@
+import * as React from 'react';
+import type { AgentIdentityView, ConversationOrigin, RunPhase, RunStatus, SyncStatus } from '@wzrhine/agent-core';
+/**
+ * AgentHeader (atlas 02): title bar of the open conversation.
+ *
+ * Start → end: back (only with `onBack`), index toggle (only inside a narrow AgentShell whose
+ * index is a sheet), origin link (fork / sub-agent, only with `origin` + `onOpenOrigin`),
+ * sub-agent badge, title + rename, agent identity, run status, sync status, then the trailing
+ * group: counts, `actions` and the context toggle.
+ *
+ * - The title is a heading (`headingLevel`, default 2) truncated to one line; the full text is in
+ *   `title` and, because truncation is visual only, still read in full by assistive tech.
+ *   The trailing group never shrinks, so long titles cannot squeeze status or actions.
+ * - Rename (only with `onRename`) is visible on hover / focus-within but always reserves its
+ *   space, so the title never jumps; its opacity transition is `--rl-motion-fast`.
+ * - Run status = AgentStatus (glyph + text): the phase label while active or waiting, else the
+ *   run label.
+ *   Active runs breathe through the shared loop lifecycle (static off-screen / hidden / reduced).
+ *   Sync is a separate axis: a second pill appears whenever `syncStatus` is not `live`.
+ *   No `runStatus` = no pill (unknown is never painted as a state).
+ * - The context toggle (only with `onToggleContext`, or automatically inside an AgentShell that
+ *   has a context slot) is an IconButton with a stable name and `aria-pressed` = pane open.
+ * - `badges` are small counts (terminals, sub-tasks) with their own accessible text.
+ */
+export interface AgentHeaderBadge {
+    id: string;
+    icon?: React.ReactNode;
+    count: number;
+    /** Accessible text, e.g. "2 个终端运行中". */
+    label: string;
+}
+export type AgentHeaderProps = Omit<React.HTMLAttributes<HTMLElement>, 'title'> & {
+    title?: string;
+    identity?: AgentIdentityView;
+    runStatus?: RunStatus;
+    runPhase?: RunPhase;
+    /** Overrides the status label (e.g. a custom phase text). */
+    statusLabel?: string;
+    syncStatus?: SyncStatus;
+    origin?: ConversationOrigin;
+    onOpenOrigin?: (origin: ConversationOrigin) => void;
+    onBack?: () => void;
+    backLabel?: string;
+    onRename?: () => void;
+    renameLabel?: string;
+    /** Explicit pane state; defaults to the surrounding AgentShell. */
+    contextOpen?: boolean;
+    /** Explicit toggle; defaults to the surrounding AgentShell's toggle when it has a context slot. */
+    onToggleContext?: () => void;
+    contextLabel?: string;
+    badges?: AgentHeaderBadge[];
+    /** Trailing slot (e.g. a Menu with more conversation actions). */
+    actions?: React.ReactNode;
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Disables rename (e.g. while a request is pending); other controls stay. */
+    pending?: boolean;
+};
+export declare const AgentHeader: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLElement>, "title"> & {
+    title?: string;
+    identity?: AgentIdentityView;
+    runStatus?: RunStatus;
+    runPhase?: RunPhase;
+    /** Overrides the status label (e.g. a custom phase text). */
+    statusLabel?: string;
+    syncStatus?: SyncStatus;
+    origin?: ConversationOrigin;
+    onOpenOrigin?: (origin: ConversationOrigin) => void;
+    onBack?: () => void;
+    backLabel?: string;
+    onRename?: () => void;
+    renameLabel?: string;
+    /** Explicit pane state; defaults to the surrounding AgentShell. */
+    contextOpen?: boolean;
+    /** Explicit toggle; defaults to the surrounding AgentShell's toggle when it has a context slot. */
+    onToggleContext?: () => void;
+    contextLabel?: string;
+    badges?: AgentHeaderBadge[];
+    /** Trailing slot (e.g. a Menu with more conversation actions). */
+    actions?: React.ReactNode;
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Disables rename (e.g. while a request is pending); other controls stay. */
+    pending?: boolean;
+} & React.RefAttributes<HTMLElement>>;
+//# sourceMappingURL=AgentHeader.d.ts.map

package/dist/components/shell/AgentHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentHeader.d.ts","sourceRoot":"","sources":["../../../src/components/shell/AgentHeader.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQlH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,GAAG;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACpD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mGAAmG;IACnG,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,kEAAkE;IAClE,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAyBF,eAAO,MAAM,WAAW;YAjDd,MAAM;eACH,iBAAiB;gBAChB,SAAS;eACV,QAAQ;IACnB,6DAA6D;kBAC/C,MAAM;iBACP,UAAU;aACd,kBAAkB;mBACZ,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI;aAC1C,MAAM,IAAI;gBACP,MAAM;eACP,MAAM,IAAI;kBACP,MAAM;IACpB,mEAAmE;kBACrD,OAAO;IACrB,mGAAmG;sBACjF,MAAM,IAAI;mBACb,MAAM;aACZ,gBAAgB,EAAE;IAC3B,kEAAkE;cACxD,KAAK,CAAC,SAAS;mBACV,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;IACpC,8EAA8E;cACpE,OAAO;qCA4KjB,CAAC"}

package/dist/components/shell/AgentHeader.js

@@ -0,0 +1,43 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { IconButton } from '@wzrhine/react';
+import { effectivePhase, runPhaseMeta, runStatusMeta, syncStatusMeta } from '@wzrhine/agent-core';
+import { useAgentFormat, useAgentMessages } from '../../provider/AgentMessages.js';
+import { AgentIcon } from '../../primitives/icons.js';
+import { AgentStatus } from '../../primitives/AgentStatus.js';
+import { loopAttributes, useAgentLoop } from '../../motion/agent-motion.js';
+import { cx } from '../../utils/cx.js';
+import { useAgentShell } from './AgentShell.js';
+function RunPill({ status, phase, label }) {
+    const messages = useAgentMessages().status;
+    const run = runStatusMeta[status];
+    // `waiting` is not "active" (nothing breathes) but still carries the phase that says what it
+    // waits for (approval / answer / sub-tasks), as in RunStatus.
+    const shownPhase = run.active || status === 'waiting' ? effectivePhase(status, phase) : undefined;
+    const meta = shownPhase ? runPhaseMeta[shownPhase] : run;
+    const text = label ?? (shownPhase ? messages.phase[shownPhase] : messages.run[status]);
+    const { ref, lifecycle } = useAgentLoop(meta.active);
+    return (_jsx(AgentStatus, { ref: ref, className: "rl-agent-header__status", glyph: meta.glyph, tone: meta.tone, label: text, active: meta.active, "data-run": status, ...loopAttributes(lifecycle) }));
+}
+export const AgentHeader = React.forwardRef(function AgentHeader({ title, identity, runStatus, runPhase, statusLabel, syncStatus, origin, onOpenOrigin, onBack, backLabel, onRename, renameLabel, contextOpen: contextOpenProp, onToggleContext: onToggleProp, contextLabel, badges, actions, headingLevel = 2, pending = false, className, ...rest }, ref) {
+    const messages = useAgentMessages();
+    const shell = messages.shell;
+    const format = useAgentFormat();
+    const shellState = useAgentShell();
+    const Heading = `h${headingLevel}`;
+    const shownTitle = title?.trim() || shell.untitled;
+    const onToggleContext = onToggleProp ?? (shellState?.hasContext ? shellState.toggleContext : undefined);
+    const contextOpen = contextOpenProp ?? shellState?.contextOpen ?? false;
+    const showIndexToggle = !!shellState && shellState.hasIndex && shellState.layout === 'narrow';
+    const parentTitle = origin?.parentTitle?.trim() || shell.originUnknownParent;
+    const originLabel = origin ? (origin.kind === 'fork' ? shell.originFork(parentTitle) : shell.originSubagent(parentTitle)) : '';
+    const sync = syncStatus && syncStatus !== 'live' ? syncStatusMeta[syncStatus] : null;
+    return (_jsxs("header", { ...rest, ref: ref, className: cx('rl-agent-header', className), "data-run": runStatus, children: [_jsxs("div", { className: "rl-agent-header__lead", children: [onBack && _jsx(IconButton, { size: "sm", icon: _jsx(AgentIcon, { name: "arrow-left" }), label: backLabel ?? shell.back, onClick: onBack }), showIndexToggle && (_jsx(IconButton, { size: "sm", icon: _jsx(AgentIcon, { name: "list" }), label: shell.openIndex, "aria-haspopup": "dialog", onClick: () => shellState.setIndexOpen(true, 'toggle') })), origin && onOpenOrigin && (_jsx(IconButton, { size: "sm", icon: _jsx(AgentIcon, { name: origin.kind === 'fork' ? 'fork' : 'link' }), label: originLabel, onClick: () => onOpenOrigin(origin) }))] }), _jsxs("div", { className: "rl-agent-header__titles", children: [_jsxs("div", { className: "rl-agent-header__title-row", children: [origin?.kind === 'subagent' && (_jsxs("span", { className: "rl-agent-header__badge", children: [_jsx(AgentIcon, { name: "agent" }), shell.subagentBadge] })), _jsx(Heading, { className: "rl-agent-header__title", title: shownTitle, children: shownTitle }), onRename && (_jsx(IconButton, { className: "rl-agent-header__rename", size: "sm", icon: _jsx(AgentIcon, { name: "edit" }), label: renameLabel ?? shell.rename, disabled: pending, onClick: onRename }))] }), (identity || runStatus || sync) && (_jsxs("div", { className: "rl-agent-header__meta", children: [identity && (_jsxs("span", { className: "rl-agent-header__identity", children: [_jsx("span", { className: "rl-agent-header__monogram", "aria-hidden": "true", children: identity.monogram ?? _jsx(AgentIcon, { name: "agent" }) }), _jsx("span", { className: "rl-agent-sr", children: shell.agentIdentity(identity.name, identity.role) }), _jsx("span", { className: "rl-agent-header__identity-name", "aria-hidden": "true", children: identity.name }), identity.role && (_jsx("span", { className: "rl-agent-header__identity-role", "aria-hidden": "true", children: identity.role }))] })), runStatus && _jsx(RunPill, { status: runStatus, phase: runPhase, label: statusLabel }), sync && syncStatus && (_jsx(AgentStatus, { className: "rl-agent-header__sync", glyph: sync.glyph, tone: sync.tone, label: messages.status.sync[syncStatus], "data-sync": syncStatus }))] }))] }), _jsxs("div", { className: "rl-agent-header__trail", children: [badges?.map((badge) => (_jsxs("span", { className: "rl-agent-header__count", children: [badge.icon && (_jsx("span", { className: "rl-agent-header__count-icon", "aria-hidden": "true", children: badge.icon })), _jsx("span", { "aria-hidden": "true", children: format.compact(badge.count) }), _jsx("span", { className: "rl-agent-sr", children: badge.label })] }, badge.id))), actions, onToggleContext && (_jsx(IconButton, { className: "rl-agent-header__toggle", size: "sm", icon: _jsx(AgentIcon, { name: "panel" }), label: contextLabel ?? shell.contextToggle, pressed: contextOpen, onClick: (event) => {
+                            // WebKit pointer activation does not focus buttons automatically. Make this
+                            // programmatic drawer's opener explicit before its focus scope mounts.
+                            event.currentTarget.focus({ preventScroll: true });
+                            onToggleContext();
+                        } }))] })] }));
+});
+//# sourceMappingURL=AgentHeader.js.map

package/dist/components/shell/AgentHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentHeader.js","sourceRoot":"","sources":["../../../src/components/shell/AgentHeader.tsx"],"names":[],"mappings":"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"}

package/dist/components/shell/AgentShell.d.ts

@@ -0,0 +1,154 @@
+import * as React from 'react';
+/**
+ * AgentShell (atlas 01): the workbench frame. It owns regions, slots, focus and responsive
+ * behaviour only; routing, window chrome and data stay with the host (ADR-0011 §9).
+ *
+ * Layout, from the inline start: `rail` (app navigation) · `index` (conversation index) · reading
+ * column (`header` / `conversation` / `composer`) · ResizeHandle · `context` (side pane). Every
+ * column scrolls on its own (`min-height: 0` + `overflow: auto`); reading content is capped at
+ * `--rl-agent-reading-width` and centred, so wide screens never stretch long lines.
+ *
+ * Responsive: the shell measures its own width (ResizeObserver; without it the shell stays
+ * `wide`), so two shells on one page, or a shell inside a card, decide independently.
+ * - `wide`: every column inline.
+ * - `compact` (< `breakpoints.context` rem): the context pane leaves the row first instead of
+ *   squeezing the reading column; opening it shows a Drawer sheet.
+ * - `narrow` (< `breakpoints.index` rem): the index becomes a sheet too and the rail is hidden;
+ *   one reading column remains.
+ * Shrinking past a breakpoint closes what no longer fits (`onContextOpenChange(false, 'layout')`,
+ * so `aria-pressed` on toggles always matches what is visible) and growing back reopens it,
+ * unless the user toggled it in between. Controlled hosts receive the same calls.
+ *
+ * Landmarks: the shell does not force `main`. The reading column is a `<section aria-label>`
+ * (`mainLabel`); wrap the shell in `<main>` when it is the page's main content. The index is a
+ * labelled section; AgentSidePane brings its own `complementary` landmark. Closing the inline
+ * pane while focus is inside it returns focus to the element that was focused when it opened
+ * (typically the header toggle); sheets restore focus through Drawer.
+ *
+ * Motion (ADR-0012): the inline pane opens / closes with a single-axis CSS translate + opacity
+ * transition on `--rl-motion-panel`, interruptible and instant under reduced motion. Its width
+ * is never animated: it appears at once on open and is released only after the exit fade.
+ * Dragging the ResizeHandle follows the pointer directly.
+ */
+export type AgentShellLayout = 'wide' | 'compact' | 'narrow';
+/** Why an open state changed: user toggle, sheet dismissal, layout breakpoint, a new selection. */
+export type AgentShellOpenReason = 'toggle' | 'dismiss' | 'layout' | 'selection';
+export interface AgentShellContextValue {
+    layout: AgentShellLayout;
+    hasContext: boolean;
+    hasIndex: boolean;
+    contextOpen: boolean;
+    setContextOpen: (open: boolean, reason?: AgentShellOpenReason) => void;
+    toggleContext: () => void;
+    indexOpen: boolean;
+    setIndexOpen: (open: boolean, reason?: AgentShellOpenReason) => void;
+    /** The index is not visible as an inline column (narrow layout or collapsed). */
+    indexCollapsed: boolean;
+}
+/** Where the context slot is rendered right now. */
+export type AgentContextPresentation = 'inline' | 'sheet' | 'standalone';
+/** The nearest AgentShell's state and toggles, or `null` outside a shell. */
+export declare function useAgentShell(): AgentShellContextValue | null;
+/** How the surrounding shell presents the context slot (AgentSidePane hides its close button in a sheet). */
+export declare function useAgentContextPresentation(): AgentContextPresentation;
+export type AgentShellProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> & {
+    /** App navigation rail (hidden on narrow layouts; the host offers its own menu there). */
+    rail?: React.ReactNode;
+    /** Conversation index column, usually a ConversationList. */
+    index?: React.ReactNode;
+    header?: React.ReactNode;
+    /** Main reading area (MessageList). */
+    conversation?: React.ReactNode;
+    /** Docked at the bottom of the reading column. */
+    composer?: React.ReactNode;
+    /** Side pane, usually an AgentSidePane. */
+    context?: React.ReactNode;
+    /** Accessible name of the reading column. */
+    mainLabel?: string;
+    /** Accessible name of the index column and title of the index sheet. */
+    indexLabel?: string;
+    /** Title of the context sheet on compact / narrow layouts. */
+    contextLabel?: string;
+    contextOpen?: boolean;
+    defaultContextOpen?: boolean;
+    onContextOpenChange?: (open: boolean, reason: AgentShellOpenReason) => void;
+    indexOpen?: boolean;
+    defaultIndexOpen?: boolean;
+    onIndexOpenChange?: (open: boolean, reason: AgentShellOpenReason) => void;
+    /** Width of the inline context pane in CSS pixels. */
+    contextSize?: number;
+    defaultContextSize?: number;
+    onContextSizeChange?: (size: number) => void;
+    readingMin?: number;
+    resizeStep?: number;
+    resizeLargeStep?: number;
+    onContextClosed?: () => void;
+    contextMin?: number;
+    contextMax?: number;
+    /** Show the ResizeHandle between reading column and pane (default true). */
+    resizable?: boolean;
+    /** Breakpoints in rem of the shell's own width (defaults: context 64, index 40). */
+    breakpoints?: {
+        context?: number;
+        index?: number;
+    };
+    /** Force a layout (tests, hosts that already know their size). Overrides measurement. */
+    layout?: AgentShellLayout;
+    /** Id of the conversation being read; a change closes the index sheet on narrow layouts. */
+    activeId?: string;
+    /** Stable view identity for main conversation ↔ sub-task transitions. */
+    viewKey?: string;
+    /** Direction of the view drill-down animation. */
+    direction?: 'forward' | 'back';
+};
+export declare const AgentShell: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
+    /** App navigation rail (hidden on narrow layouts; the host offers its own menu there). */
+    rail?: React.ReactNode;
+    /** Conversation index column, usually a ConversationList. */
+    index?: React.ReactNode;
+    header?: React.ReactNode;
+    /** Main reading area (MessageList). */
+    conversation?: React.ReactNode;
+    /** Docked at the bottom of the reading column. */
+    composer?: React.ReactNode;
+    /** Side pane, usually an AgentSidePane. */
+    context?: React.ReactNode;
+    /** Accessible name of the reading column. */
+    mainLabel?: string;
+    /** Accessible name of the index column and title of the index sheet. */
+    indexLabel?: string;
+    /** Title of the context sheet on compact / narrow layouts. */
+    contextLabel?: string;
+    contextOpen?: boolean;
+    defaultContextOpen?: boolean;
+    onContextOpenChange?: (open: boolean, reason: AgentShellOpenReason) => void;
+    indexOpen?: boolean;
+    defaultIndexOpen?: boolean;
+    onIndexOpenChange?: (open: boolean, reason: AgentShellOpenReason) => void;
+    /** Width of the inline context pane in CSS pixels. */
+    contextSize?: number;
+    defaultContextSize?: number;
+    onContextSizeChange?: (size: number) => void;
+    readingMin?: number;
+    resizeStep?: number;
+    resizeLargeStep?: number;
+    onContextClosed?: () => void;
+    contextMin?: number;
+    contextMax?: number;
+    /** Show the ResizeHandle between reading column and pane (default true). */
+    resizable?: boolean;
+    /** Breakpoints in rem of the shell's own width (defaults: context 64, index 40). */
+    breakpoints?: {
+        context?: number;
+        index?: number;
+    };
+    /** Force a layout (tests, hosts that already know their size). Overrides measurement. */
+    layout?: AgentShellLayout;
+    /** Id of the conversation being read; a change closes the index sheet on narrow layouts. */
+    activeId?: string;
+    /** Stable view identity for main conversation ↔ sub-task transitions. */
+    viewKey?: string;
+    /** Direction of the view drill-down animation. */
+    direction?: "forward" | "back";
+} & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=AgentShell.d.ts.map

package/dist/components/shell/AgentShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentShell.d.ts","sourceRoot":"","sources":["../../../src/components/shell/AgentShell.tsx"],"names":[],"mappings":"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"}

package/dist/components/shell/AgentShell.js

@@ -0,0 +1,210 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { motion } from 'motion/react';
+import { Drawer } from '@wzrhine/react';
+import { useRhineMotion } from '@wzrhine/react';
+import { useAgentMessages } from '../../provider/AgentMessages.js';
+import { cx } from '../../utils/cx.js';
+import { ResizeHandle } from './ResizeHandle.js';
+import { useIsoLayoutEffect } from './use-controllable.js';
+const ShellContext = React.createContext(null);
+const PresentationContext = React.createContext('standalone');
+/** The nearest AgentShell's state and toggles, or `null` outside a shell. */
+export function useAgentShell() {
+    return React.useContext(ShellContext);
+}
+/** How the surrounding shell presents the context slot (AgentSidePane hides its close button in a sheet). */
+export function useAgentContextPresentation() {
+    return React.useContext(PresentationContext);
+}
+const DEFAULT_BREAKPOINTS = { context: 64, index: 40 };
+/** Reading column kept free when clamping the pane width (CSS pixels, 20rem at 16px). */
+const READING_MIN = 320;
+const rank = { narrow: 0, compact: 1, wide: 2 };
+function rootFontSize() {
+    if (typeof document === 'undefined' || typeof getComputedStyle === 'undefined')
+        return 16;
+    return Number.parseFloat(getComputedStyle(document.documentElement).fontSize) || 16;
+}
+function useShellMeasure(ref, contextAt, indexAt) {
+    const [state, setState] = React.useState({ layout: 'wide', width: 0, side: 0 });
+    useIsoLayoutEffect(() => {
+        const el = ref.current;
+        if (!el)
+            return undefined;
+        const measure = () => {
+            const width = Math.round(el.getBoundingClientRect().width);
+            if (!width)
+                return;
+            const rem = rootFontSize();
+            const layout = width < indexAt * rem ? 'narrow' : width < contextAt * rem ? 'compact' : 'wide';
+            let side = 0;
+            for (const child of Array.from(el.children)) {
+                if (child.matches('.rl-agent-shell__rail, .rl-agent-shell__index'))
+                    side += child.offsetWidth;
+            }
+            setState((prev) => (prev.layout === layout && prev.width === width && prev.side === side ? prev : { layout, width, side }));
+        };
+        measure();
+        if (typeof ResizeObserver === 'undefined')
+            return undefined;
+        const observer = new ResizeObserver(measure);
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, [ref, contextAt, indexAt]);
+    return state;
+}
+function useOpenState(value, defaultValue, onChange) {
+    const [inner, setInner] = React.useState(defaultValue);
+    const controlled = value !== undefined;
+    const open = controlled ? value : inner;
+    const latest = React.useRef(open);
+    latest.current = open;
+    const onChangeRef = React.useRef(onChange);
+    onChangeRef.current = onChange;
+    const restore = React.useRef(false);
+    const set = React.useCallback((next, reason = 'toggle') => {
+        if (reason !== 'layout')
+            restore.current = false;
+        if (next === latest.current)
+            return;
+        latest.current = next;
+        if (!controlled)
+            setInner(next);
+        onChangeRef.current?.(next, reason);
+    }, [controlled]);
+    return { open, set, restore };
+}
+/** Scroll container that is keyboard-focusable only while it actually overflows. */
+function useScrollable() {
+    const [node, setNode] = React.useState(null);
+    const [scrollable, setScrollable] = React.useState(false);
+    useIsoLayoutEffect(() => {
+        if (!node || typeof ResizeObserver === 'undefined')
+            return undefined;
+        const update = () => setScrollable(node.scrollHeight > node.clientHeight + 1);
+        update();
+        const observer = new ResizeObserver(update);
+        observer.observe(node);
+        const content = node.firstElementChild;
+        if (content)
+            observer.observe(content);
+        return () => observer.disconnect();
+    }, [node]);
+    return { ref: setNode, scrollable };
+}
+const present = (node) => node != null && node !== false;
+export const AgentShell = React.forwardRef(function AgentShell({ rail, index, header, conversation, composer, context, mainLabel, indexLabel, contextLabel, contextOpen: contextOpenProp, defaultContextOpen = false, onContextOpenChange, indexOpen: indexOpenProp, defaultIndexOpen = true, onIndexOpenChange, contextSize, defaultContextSize = 352, onContextSizeChange, contextMin = 288, contextMax = 640, readingMin = READING_MIN, resizeStep = 16, resizeLargeStep = 64, onContextClosed, resizable = true, breakpoints, layout: layoutProp, activeId, viewKey, direction = 'forward', className, style, ...rest }, forwardedRef) {
+    const messages = useAgentMessages().shell;
+    const motionPrefs = useRhineMotion();
+    const rootRef = React.useRef(null);
+    const contextRef = React.useRef(null);
+    const setRoot = React.useCallback((el) => {
+        rootRef.current = el;
+        if (typeof forwardedRef === 'function')
+            forwardedRef(el);
+        else if (forwardedRef)
+            forwardedRef.current = el;
+    }, [forwardedRef]);
+    const measured = useShellMeasure(rootRef, breakpoints?.context ?? DEFAULT_BREAKPOINTS.context, breakpoints?.index ?? DEFAULT_BREAKPOINTS.index);
+    const layout = layoutProp ?? measured.layout;
+    const hasContext = present(context);
+    const hasIndex = present(index);
+    const ctx = useOpenState(contextOpenProp, defaultContextOpen, onContextOpenChange);
+    const idx = useOpenState(indexOpenProp, defaultIndexOpen, onIndexOpenChange);
+    // Leaving a layout closes what no longer fits *before* a sheet could open for it: sheets only
+    // follow `open` once the layout change has been reconciled (`synced`).
+    // Starts from `wide` (the server / first-paint layout) so a narrow first measurement closes
+    // what the defaults opened instead of popping a sheet on load.
+    const [synced, setSynced] = React.useState('wide');
+    useIsoLayoutEffect(() => {
+        if (synced === layout)
+            return;
+        const reconcile = (state, threshold) => {
+            const was = rank[synced] >= threshold;
+            const is = rank[layout] >= threshold;
+            if (was && !is && state.open) {
+                state.set(false, 'layout');
+                state.restore.current = true;
+            }
+            else if (!was && is && state.restore.current) {
+                state.restore.current = false;
+                state.set(true, 'layout');
+            }
+        };
+        reconcile(ctx, rank.wide);
+        reconcile(idx, rank.compact);
+        setSynced(layout);
+    }, [layout, synced]);
+    // Picking a conversation in the narrow index sheet closes the sheet.
+    const prevActive = React.useRef(activeId);
+    React.useEffect(() => {
+        if (prevActive.current === activeId)
+            return;
+        prevActive.current = activeId;
+        if (layout === 'narrow' && idx.open)
+            idx.set(false, 'selection');
+    });
+    // Focus return for the inline pane: remember the opener, restore it when the pane closes with focus inside.
+    const opener = React.useRef(null);
+    const focusWithin = React.useRef(false);
+    const wasOpen = React.useRef(ctx.open);
+    useIsoLayoutEffect(() => {
+        if (ctx.open === wasOpen.current)
+            return;
+        wasOpen.current = ctx.open;
+        if (typeof document === 'undefined')
+            return;
+        const active = document.activeElement;
+        if (ctx.open) {
+            opener.current = active && active !== document.body ? active : null;
+            return;
+        }
+        const pane = contextRef.current;
+        // `inert` may already have blurred the focused control, so also trust the focus-within flag.
+        if (focusWithin.current || (pane && active && pane.contains(active))) {
+            focusWithin.current = false;
+            const target = opener.current;
+            if (target?.isConnected)
+                target.focus();
+            else
+                rootRef.current?.querySelector('.rl-agent-shell__main')?.focus();
+        }
+        onContextClosed?.();
+        opener.current = null;
+    }, [ctx.open, onContextClosed]);
+    const [innerSize, setInnerSize] = React.useState(defaultContextSize);
+    const rawSize = contextSize ?? innerSize;
+    const fitMax = measured.width ? Math.max(contextMin, Math.min(contextMax, measured.width - measured.side - readingMin)) : contextMax;
+    const paneSize = Math.round(Math.min(Math.max(rawSize, contextMin), fitMax));
+    const setSize = (next) => {
+        if (contextSize === undefined)
+            setInnerSize(next);
+        onContextSizeChange?.(next);
+    };
+    const inlineContext = hasContext && layout === 'wide';
+    const inlineIndex = hasIndex && layout !== 'narrow';
+    const contextOpen = hasContext && ctx.open;
+    const indexOpen = hasIndex && idx.open;
+    const value = React.useMemo(() => ({
+        layout,
+        hasContext,
+        hasIndex,
+        contextOpen,
+        setContextOpen: ctx.set,
+        toggleContext: () => ctx.set(!contextOpen, 'toggle'),
+        indexOpen,
+        setIndexOpen: idx.set,
+        indexCollapsed: hasIndex && (!inlineIndex || !indexOpen),
+    }), [layout, hasContext, hasIndex, contextOpen, ctx.set, indexOpen, idx.set, inlineIndex]);
+    const scroller = useScrollable();
+    const sheetsReady = synced === layout;
+    return (_jsxs(ShellContext.Provider, { value: value, children: [_jsxs("div", { ...rest, ref: setRoot, className: cx('rl-agent-shell', className), style: { ...style, ['--rl-agent-pane-size']: `${paneSize}px` }, "data-layout": layout, "data-context-open": (inlineContext && contextOpen) || undefined, children: [present(rail) && layout !== 'narrow' && _jsx("div", { className: "rl-agent-shell__rail", children: rail }), inlineIndex && indexOpen && (_jsx("section", { className: "rl-agent-shell__index", "aria-label": indexLabel ?? messages.indexLabel, children: index })), _jsxs("section", { className: "rl-agent-shell__main", "aria-label": mainLabel ?? messages.mainLabel, tabIndex: -1, children: [present(header) && _jsx("div", { className: "rl-agent-shell__header", children: header }), _jsxs(motion.div, { className: "rl-agent-shell__view", "data-view-key": viewKey, initial: viewKey ? { opacity: 0, x: motionPrefs.reduced ? 0 : direction === 'forward' ? 16 : -16 } : false, animate: { opacity: 1, x: 0 }, transition: { opacity: motionPrefs.resolve('opacity', 'base'), x: motionPrefs.resolve('transform', 'base') }, children: [_jsx("div", { ref: scroller.ref, className: "rl-agent-shell__conversation", tabIndex: scroller.scrollable ? 0 : undefined, children: _jsx("div", { className: "rl-agent-shell__reading", children: conversation }) }), present(composer) && (_jsx("div", { className: "rl-agent-shell__composer", children: _jsx("div", { className: "rl-agent-shell__reading", children: composer }) }))] }, viewKey)] }), inlineContext && resizable && contextOpen && (_jsx(ResizeHandle, { className: "rl-agent-shell__handle", size: paneSize, onSizeChange: setSize, min: contextMin, max: fitMax, resetSize: defaultContextSize, pane: "end", step: resizeStep, largeStep: resizeLargeStep })), inlineContext && (_jsx("div", { ref: contextRef, className: "rl-agent-shell__context", "data-open": contextOpen || undefined, inert: !contextOpen, "aria-hidden": !contextOpen || undefined, onFocus: () => {
+                            focusWithin.current = true;
+                        }, onBlur: (event) => {
+                            if (!event.currentTarget.contains(event.relatedTarget))
+                                focusWithin.current = false;
+                        }, children: _jsx("div", { className: "rl-agent-shell__context-inner", children: _jsx(PresentationContext.Provider, { value: "inline", children: context }) }) }))] }), hasIndex && !inlineIndex && (_jsx(Drawer, { open: sheetsReady && indexOpen, onOpenChange: (open) => idx.set(open, 'dismiss'), side: "start", size: "sm", title: indexLabel ?? messages.indexLabel, className: "rl-agent-shell__sheet", children: index })), hasContext && !inlineContext && (_jsx(Drawer, { open: sheetsReady && contextOpen, onOpenChange: (open) => { ctx.set(open, 'dismiss'); }, side: "end", size: "md", title: contextLabel ?? messages.contextLabel, className: "rl-agent-shell__sheet", children: _jsx(PresentationContext.Provider, { value: "sheet", children: context }) }))] }));
+});
+//# sourceMappingURL=AgentShell.js.map

package/dist/components/shell/AgentShell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentShell.js","sourceRoot":"","sources":["../../../src/components/shell/AgentShell.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAmD3D,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAgC,IAAI,CAAC,CAAC;AAI9E,MAAM,mBAAmB,GAAG,KAAK,CAAC,aAAa,CAA2B,YAAY,CAAC,CAAC;AAExF,6EAA6E;AAC7E,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACxC,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,2BAA2B;IACzC,OAAO,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;AAC/C,CAAC;AAsDD,MAAM,mBAAmB,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACvD,yFAAyF;AACzF,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,IAAI,GAAqC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAElF,SAAS,YAAY;IACnB,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,OAAO,gBAAgB,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAC1F,OAAO,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AACtF,CAAC;AASD,SAAS,eAAe,CAAC,GAA2C,EAAE,SAAiB,EAAE,OAAe;IACtG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAW,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1F,kBAAkB,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAC1B,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,KAAK,CAAC,CAAC;YAC3D,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAqB,KAAK,GAAG,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;YACjH,IAAI,IAAI,GAAG,CAAC,CAAC;YACb,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,+CAA+C,CAAC;oBAAE,IAAI,IAAK,KAAqB,CAAC,WAAW,CAAC;YACjH,CAAC;YACD,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9H,CAAC,CAAC;QACF,OAAO,EAAE,CAAC;QACV,IAAI,OAAO,cAAc,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AASD,SAAS,YAAY,CAAC,KAA0B,EAAE,YAAqB,EAAE,QAAgE;IACvI,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,KAAK,KAAK,SAAS,CAAC;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3C,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAC3B,CAAC,IAAa,EAAE,SAA+B,QAAQ,EAAE,EAAE;QACzD,IAAI,MAAM,KAAK,QAAQ;YAAE,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;QACjD,IAAI,IAAI,KAAK,MAAM,CAAC,OAAO;YAAE,OAAO;QACpC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU;YAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,WAAW,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC;AAED,oFAAoF;AACpF,SAAS,aAAa;IACpB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAW,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,kBAAkB,CAAC,GAAG,EAAE;QACtB,IAAI,CAAC,IAAI,IAAI,OAAO,cAAc,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QACrE,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;QAC9E,MAAM,EAAE,CAAC;QACT,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5C,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC;QACvC,IAAI,OAAO;YAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACX,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,IAAqB,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,KAAK,CAAC;AAE1E,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAkC,SAAS,UAAU,CAC7F,EACE,IAAI,EACJ,KAAK,EACL,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EAAE,eAAe,EAC5B,kBAAkB,GAAG,KAAK,EAC1B,mBAAmB,EACnB,SAAS,EAAE,aAAa,EACxB,gBAAgB,GAAG,IAAI,EACvB,iBAAiB,EACjB,WAAW,EACX,kBAAkB,GAAG,GAAG,EACxB,mBAAmB,EACnB,UAAU,GAAG,GAAG,EAChB,UAAU,GAAG,GAAG,EAChB,UAAU,GAAG,WAAW,EACxB,UAAU,GAAG,EAAE,EACf,eAAe,GAAG,EAAE,EACpB,eAAe,EACf,SAAS,GAAG,IAAI,EAChB,WAAW,EACX,MAAM,EAAE,UAAU,EAClB,QAAQ,EACR,OAAO,EACP,SAAS,GAAG,SAAS,EACrB,SAAS,EACT,KAAK,EACL,GAAG,IAAI,EACR,EACD,YAAY;IAEZ,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC,KAAK,CAAC;IAC1C,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAwB,IAAI,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAwB,IAAI,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAC/B,CAAC,EAAyB,EAAE,EAAE;QAC5B,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;QACrB,IAAI,OAAO,YAAY,KAAK,UAAU;YAAE,YAAY,CAAC,EAAE,CAAC,CAAC;aACpD,IAAI,YAAY;YAAE,YAAY,CAAC,OAAO,GAAG,EAAE,CAAC;IACnD,CAAC,EACD,CAAC,YAAY,CAAC,CACf,CAAC;IACF,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAChJ,MAAM,MAAM,GAAG,UAAU,IAAI,QAAQ,CAAC,MAAM,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEhC,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IACnF,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;IAE7E,8FAA8F;IAC9F,uEAAuE;IACvE,4FAA4F;IAC5F,+DAA+D;IAC/D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAmB,MAAM,CAAC,CAAC;IACrE,kBAAkB,CAAC,GAAG,EAAE;QACtB,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO;QAC9B,MAAM,SAAS,GAAG,CAAC,KAAgB,EAAE,SAAiB,EAAE,EAAE;YACxD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;YACtC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;YACrC,IAAI,GAAG,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC7B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBAC3B,KAAK,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YAC/B,CAAC;iBAAM,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC/C,KAAK,CAAC,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;gBAC9B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;QACF,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,SAAS,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAErB,qEAAqE;IACrE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,UAAU,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO;QAC5C,UAAU,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC9B,IAAI,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,4GAA4G;IAC5G,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAqB,IAAI,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,kBAAkB,CAAC,GAAG,EAAE;QACtB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO;YAAE,OAAO;QACzC,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;QAC3B,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAO;QAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAmC,CAAC;QAC5D,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,CAAC,OAAO,GAAG,MAAM,IAAI,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;YACpE,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC;QAChC,6FAA6F;QAC7F,IAAI,WAAW,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACrE,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;YAC9B,IAAI,MAAM,EAAE,WAAW;gBAAE,MAAM,CAAC,KAAK,EAAE,CAAC;;gBACnC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAc,uBAAuB,CAAC,EAAE,KAAK,EAAE,CAAC;QACrF,CAAC;QACD,eAAe,EAAE,EAAE,CAAC;QACpB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IAEhC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,WAAW,IAAI,SAAS,CAAC;IACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACrI,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE;QAC/B,IAAI,WAAW,KAAK,SAAS;YAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QAClD,mBAAmB,EAAE,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,UAAU,IAAI,MAAM,KAAK,MAAM,CAAC;IACtD,MAAM,WAAW,GAAG,QAAQ,IAAI,MAAM,KAAK,QAAQ,CAAC;IACpD,MAAM,WAAW,GAAG,UAAU,IAAI,GAAG,CAAC,IAAI,CAAC;IAC3C,MAAM,SAAS,GAAG,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC;IAEvC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CACzB,GAAG,EAAE,CAAC,CAAC;QACL,MAAM;QACN,UAAU;QACV,QAAQ;QACR,WAAW;QACX,cAAc,EAAE,GAAG,CAAC,GAAG;QACvB,aAAa,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC;QACpD,SAAS;QACT,YAAY,EAAE,GAAG,CAAC,GAAG;QACrB,cAAc,EAAE,QAAQ,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC;KACzD,CAAC,EACF,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CACtF,CAAC;IAEF,MAAM,QAAQ,GAAG,aAAa,EAAkB,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,KAAK,MAAM,CAAC;IAEtC,OAAO,CACL,MAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,aACjC,kBACM,IAAI,EACR,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,EAAE,CAAC,gBAAgB,EAAE,SAAS,CAAC,EAC1C,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,sBAAgC,CAAC,EAAE,GAAG,QAAQ,IAAI,EAAE,iBAC3D,MAAM,uBACA,CAAC,aAAa,IAAI,WAAW,CAAC,IAAI,SAAS,aAE7D,OAAO,CAAC,IAAI,CAAC,IAAI,MAAM,KAAK,QAAQ,IAAI,cAAK,SAAS,EAAC,sBAAsB,YAAE,IAAI,GAAO,EAC1F,WAAW,IAAI,SAAS,IAAI,CAC3B,kBAAS,SAAS,EAAC,uBAAuB,gBAAa,UAAU,IAAI,QAAQ,CAAC,UAAU,YACrF,KAAK,GACE,CACX,EACD,mBAAS,SAAS,EAAC,sBAAsB,gBAAa,SAAS,IAAI,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,aAChG,OAAO,CAAC,MAAM,CAAC,IAAI,cAAK,SAAS,EAAC,wBAAwB,YAAE,MAAM,GAAO,EAC1E,MAAC,MAAM,CAAC,GAAG,IAET,SAAS,EAAC,sBAAsB,mBACjB,OAAO,EACtB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAC1G,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAC7B,UAAU,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,aAE5G,cAAK,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAC,8BAA8B,EAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,YAC5G,cAAK,SAAS,EAAC,yBAAyB,YAAE,YAAY,GAAO,GACzD,EACL,OAAO,CAAC,QAAQ,CAAC,IAAI,CACpB,cAAK,SAAS,EAAC,0BAA0B,YACvC,cAAK,SAAS,EAAC,yBAAyB,YAAE,QAAQ,GAAO,GACrD,CACP,KAdI,OAAO,CAeD,IACL,EACT,aAAa,IAAI,SAAS,IAAI,WAAW,IAAI,CAC5C,KAAC,YAAY,IACX,SAAS,EAAC,wBAAwB,EAClC,IAAI,EAAE,QAAQ,EACd,YAAY,EAAE,OAAO,EACrB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,kBAAkB,EAC7B,IAAI,EAAC,KAAK,EACV,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,eAAe,GAC1B,CACH,EACA,aAAa,IAAI,CAChB,cACE,GAAG,EAAE,UAAU,EACf,SAAS,EAAC,yBAAyB,eACxB,WAAW,IAAI,SAAS,EACnC,KAAK,EAAE,CAAC,WAAW,iBACN,CAAC,WAAW,IAAI,SAAS,EACxC,OAAO,EAAE,GAAG,EAAE;4BACV,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;wBAC7B,CAAC,EACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;4BAChB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,aAA4B,CAAC;gCAAE,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;wBACrG,CAAC,YAED,cAAK,SAAS,EAAC,+BAA+B,YAC5C,KAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAC,QAAQ,YAAE,OAAO,GAAgC,GACjF,GACF,CACP,IACG,EACL,QAAQ,IAAI,CAAC,WAAW,IAAI,CAC3B,KAAC,MAAM,IACL,IAAI,EAAE,WAAW,IAAI,SAAS,EAC9B,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,EAChD,IAAI,EAAC,OAAO,EACZ,IAAI,EAAC,IAAI,EACT,KAAK,EAAE,UAAU,IAAI,QAAQ,CAAC,UAAU,EACxC,SAAS,EAAC,uBAAuB,YAEhC,KAAK,GACC,CACV,EACA,UAAU,IAAI,CAAC,aAAa,IAAI,CAC/B,KAAC,MAAM,IACL,IAAI,EAAE,WAAW,IAAI,WAAW,EAChC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EACrD,IAAI,EAAC,KAAK,EACV,IAAI,EAAC,IAAI,EACT,KAAK,EAAE,YAAY,IAAI,QAAQ,CAAC,YAAY,EAC5C,SAAS,EAAC,uBAAuB,YAEjC,KAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAC,OAAO,YAAE,OAAO,GAAgC,GAC7E,CACV,IACqB,CACzB,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/components/shell/AgentSidePane.d.ts

@@ -0,0 +1,54 @@
+import * as React from 'react';
+/**
+ * AgentSidePane (atlas 26): the context / detail pane. A `complementary` landmark
+ * (`<aside aria-label>`) with Tabs (@wzrhine/react) over `sections`.
+ *
+ * - Every panel stays mounted (`keepMounted`), hidden ones with `hidden`, and each panel is its
+ *   own scroll container, so switching tabs keeps every tab's scroll position.
+ * - A panel that overflows becomes keyboard-scrollable (`tabIndex=0` comes from Base UI).
+ * - `count` renders after the tab label and is part of the tab's name; `content` can carry its
+ *   own loading / error / empty state.
+ * - Close button only with `onClose`, or automatically inside an inline AgentShell pane (it
+ *   closes the pane and the shell returns focus). Inside the shell's sheet the Drawer has its
+ *   own close button, so the pane's title row and close button are not repeated there.
+ * - With one section the tab strip is omitted and the section label becomes the heading.
+ * - Motion: tab indicator from Tabs (CSS, `--rl-motion-base`); pane open / close belongs to
+ *   AgentShell. No content drift between tabs.
+ */
+export interface AgentSidePaneSection {
+    id: string;
+    label: string;
+    count?: number;
+    content: React.ReactNode;
+}
+export type AgentSidePaneProps = Omit<React.HTMLAttributes<HTMLElement>, 'children' | 'title'> & {
+    sections: AgentSidePaneSection[];
+    activeTab?: string;
+    defaultTab?: string;
+    onTabChange?: (id: string) => void;
+    /** Accessible name of the landmark (and visible heading). */
+    label?: string;
+    /** Hide the visible heading (the landmark keeps its name). */
+    hideHeading?: boolean;
+    onClose?: () => void;
+    closeLabel?: string;
+    /** Accessible name of the tab list. */
+    tabsLabel?: string;
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+};
+export declare const AgentSidePane: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLElement>, "children" | "title"> & {
+    sections: AgentSidePaneSection[];
+    activeTab?: string;
+    defaultTab?: string;
+    onTabChange?: (id: string) => void;
+    /** Accessible name of the landmark (and visible heading). */
+    label?: string;
+    /** Hide the visible heading (the landmark keeps its name). */
+    hideHeading?: boolean;
+    onClose?: () => void;
+    closeLabel?: string;
+    /** Accessible name of the tab list. */
+    tabsLabel?: string;
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+} & React.RefAttributes<HTMLElement>>;
+//# sourceMappingURL=AgentSidePane.d.ts.map

package/dist/components/shell/AgentSidePane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSidePane.d.ts","sourceRoot":"","sources":["../../../src/components/shell/AgentSidePane.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG;IAC/F,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,aAAa;cAfd,oBAAoB,EAAE;gBACpB,MAAM;iBACL,MAAM;kBACL,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI;IAClC,6DAA6D;YACrD,MAAM;IACd,8DAA8D;kBAChD,OAAO;cACX,MAAM,IAAI;iBACP,MAAM;IACnB,uCAAuC;gBAC3B,MAAM;mBACH,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;qCAwEhC,CAAC"}