@consciousclouds/operator-shell 0.1.0 → 0.2.0

package/dist/chief/ChiefPanel.d.ts

@@ -1,10 +1,53 @@
+import type { CanvasDefinition } from "@consciousclouds/canvas-sdk";
 import type { OperatorFlavor } from "../flavor/types.js";
+import type { IconRegistry } from "../icons/registry.js";
+import { type ChiefWorkspacesRegion } from "./ChiefSession.js";
+import type { ConversationAdapter } from "./conversation-adapter.js";
+import { type PersonalityDisplay } from "./personality-display.js";
 import type { TurnAdapter } from "./turn-adapter.js";
+import { type ComposedMeta } from "./use-chief-turn.js";
 export interface ChiefPanelProps {
     flavor: OperatorFlavor;
     /** The product's transport (P1-1). The shell owns the panel, never the wire. */
     adapter: TurnAdapter;
+    /**
+     * `push` (default): closed-by-default responsive hybrid — overlay below
+     * lg, in-flow push at lg+. `rail`: the always-open inflow rail at xl+
+     * (the always-visible mode; the region mounts the overlay below xl).
+     */
+    mode?: "push" | "rail";
+    /** Panel width in px at the inflow breakpoint (default 420). */
+    width?: number;
+    /**
+     * Desktop chrome: `card` (default) floats as a rounded sibling card —
+     * the framed-workspace look; `flat` squares off with a left border for
+     * edge-to-edge workspaces. Cosmetic only.
+     */
+    variant?: "card" | "flat";
+    /** Controlled open state (push mode). Omit for uncontrolled (closed). */
+    open?: boolean;
+    /** Open-state observer/setter — fires for every open/close, however caused. */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * External trigger (e.g. the shell header's ChiefTrigger): excluded from
+     * outside-click dismissal; receives focus back on close.
+     */
+    getTriggerElement?: () => HTMLElement | null;
+    /** Display identity from the Factory personality record (D-Q2 seam). */
+    personalityDisplay?: PersonalityDisplay;
+    /** Icon-registry extensions for `personalityDisplay.iconRef` resolution. */
+    icons?: IconRegistry;
+    /** Brand icon family (read-and-defaulted by the registry). */
+    iconFamily?: string;
+    /** The compose→center seam — forwarded verbatim to useChiefTurn (see ChiefRegion). */
+    onComposed?: (canvas: CanvasDefinition, meta: ComposedMeta) => void;
+    /** Composition activity (real tool events) — forwarded verbatim to useChiefTurn. */
+    onComposeActivity?: (phase: "composing" | "idle") => void;
+    /** The transcript transport — forwarded verbatim to useChiefTurn (fail-closed slot). */
+    conversationAdapter?: ConversationAdapter;
+    /** Kept workspaces for the drawer's Workspaces tab (fail-closed slot). */
+    workspaces?: ChiefWorkspacesRegion;
     className?: string;
 }
-export declare function ChiefPanel({ flavor, adapter, className }: ChiefPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChiefPanel({ flavor, adapter, mode, width, variant, open: openProp, onOpenChange, getTriggerElement, personalityDisplay, icons, iconFamily, onComposed, onComposeActivity, conversationAdapter, workspaces, className, }: ChiefPanelProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=ChiefPanel.d.ts.map

package/dist/chief/ChiefPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChiefPanel.d.ts","sourceRoot":"","sources":["../../src/chief/ChiefPanel.tsx"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,gFAAgF;IAChF,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,eAAe,2CAqCzE"}
+{"version":3,"file":"ChiefPanel.d.ts","sourceRoot":"","sources":["../../src/chief/ChiefPanel.tsx"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAgB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGtE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,gFAAgF;IAChF,OAAO,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,yEAAyE;IACzE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC7C,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACpE,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,KAAK,IAAI,CAAC;IAC1D,wFAAwF;IACxF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,0EAA0E;IAC1E,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,OAAO,EACP,IAAa,EACb,KAAW,EACX,OAAgB,EAChB,IAAI,EAAE,QAAQ,EACd,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,SAAS,GACV,EAAE,eAAe,2CA+FjB"}

package/dist/chief/ChiefPanel.js

@@ -1,46 +1,96 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /**
- * ChiefPanel — the AI Region's RAIL placement: an always-open inflow
- * assistant rail mounted through @consciousclouds/assistant-surface's
- * headless hook (open, non-modal, non-dismissible). The turn flow lives in
- * useChiefTurn and the body in ChiefSession — shared verbatim with the
- * drawer placement (ChiefDrawer); this file is only the right-rail chrome.
+ * ChiefPanel — the AI Region's INFLOW placements, one CSS-responsive
+ * component (ported from the reference operator surface's proven panel):
  *
- * Two shapes off one turn:
- *   - a deterministic command moves the surface via a `routed` event — ZERO
- *     model tokens (only honored when the destination is part of this
- *     console, DERIVED from the Flavor's nav; off-console targets are
- *     reported, not navigated to);
- *   - any other question is a router miss → the model reasons over the
- *     granted knowledge envelope and streams the answer here.
+ *   - `mode="push"` (default): the responsive hybrid. Below `lg` the panel
+ *     is a fixed overlay drawer sliding from the right over a clickable
+ *     scrim; at `lg+` it is an in-flow peer panel animating `w-0 →
+ *     w-(--chief-width)` (300ms) so the workspace visibly reflows beside
+ *     it. Closed by default; a dismissible, non-modal peer surface (Esc +
+ *     outside-click close, composer focused on open, focus returned to the
+ *     trigger on close) — the full assistant-surface option set.
+ *   - `mode="rail"`: the always-visible mode — an always-open inflow rail
+ *     at `xl+` (never dismissible; ⌘J focuses the composer). Below xl the
+ *     region mounts the overlay instead (ChiefRegion owns that fallback).
  *
- * The chat is just the access point; the operator intelligence is the
- * knowledge underneath. Transport is the injected TurnAdapter's — the shell
- * never owns the wire (P1-1).
+ * Because BOTH responsive layouts of `push` are one mounted component, the
+ * turn thread survives viewport changes, and open/close keeps the thread —
+ * turn state lives here, outside the animated chrome.
+ *
+ * Layout is chrome; behavior never forks: every mode runs the identical
+ * useChiefTurn flow over the injected TurnAdapter (P1-1 — the shell owns
+ * the panel, never the wire).
  */
 import * as React from "react";
-import { Sparkles } from "lucide-react";
 import { useAssistantSurface } from "@consciousclouds/assistant-surface";
 import { cn } from "@consciousclouds/ui";
+import { ChiefHeaderBar } from "./ChiefHeaderBar.js";
 import { ChiefSession } from "./ChiefSession.js";
+import { resolvePersonalityAccent, resolvePersonalityIcon, } from "./personality-display.js";
 import { useChiefShortcut } from "./use-chief-shortcut.js";
 import { useChiefTurn } from "./use-chief-turn.js";
-export function ChiefPanel({ flavor, adapter, className }) {
-    const session = useChiefTurn({ flavor, adapter });
-    // Headless assistant-surface mount (inflow: always open, non-modal,
-    // non-dismissible). The drawer placement is the same content behind the
-    // sheet primitive — see ChiefRegion for the placement switch.
+import { useControlledOpen } from "./use-controlled-open.js";
+export function ChiefPanel({ flavor, adapter, mode = "push", width = 420, variant = "card", open: openProp, onOpenChange, getTriggerElement, personalityDisplay, icons, iconFamily, onComposed, onComposeActivity, conversationAdapter, workspaces, className, }) {
+    const isRail = mode === "rail";
+    const [openState, setOpen] = useControlledOpen(openProp, onOpenChange);
+    const open = isRail ? true : openState;
+    const session = useChiefTurn({ flavor, adapter, personalityDisplay, onComposed, onComposeActivity, conversationAdapter });
+    const composerRef = React.useRef(null);
+    const Icon = resolvePersonalityIcon(personalityDisplay, icons, iconFamily);
+    const accentColor = resolvePersonalityAccent(personalityDisplay?.accentRef);
+    // The shell-owned Chief keybinding (⌘J / Ctrl+J — use-chief-shortcut.ts).
+    // Rail (always open): focus the composer. Push: summon/dismiss — the SAME
+    // setOpen the trigger, Esc, and outside-click drive; one open state,
+    // whoever moves it.
+    useChiefShortcut(() => {
+        if (isRail)
+            composerRef.current?.focus();
+        else
+            setOpen(!open);
+    });
+    // Assistant-surface lifecycle (same surface id in every placement — one AI
+    // Region per application). Push is the full dismissible peer-panel option
+    // set: non-modal (no trap, no scroll lock), Esc + outside-click close,
+    // composer focus on open, focus back to the external trigger on close.
+    // Rail stays non-modal AND non-dismissible — always-visible means it.
     const surface = useAssistantSurface({
-        open: true,
-        onOpenChange: () => { },
+        open,
+        onOpenChange: isRail ? () => { } : setOpen,
         surfaceId: "operator-shell-chief",
         "aria-label": session.title,
+        modal: false,
+        dismissible: !isRail,
+        // EXPLICIT-CLOSE (owner): Chief is a working PEER, not a popover — clicking into the
+        // workspace to act on what Chief said must never dismiss the conversation. Only the
+        // header ✕, the trigger toggle, and Esc (a deliberate keyboard gesture) close it.
+        closeOnOutsideClick: false,
+        focusOnOpen: isRail ? "none" : () => composerRef.current,
+        getTriggerElement,
     });
-    // The shell-owned Chief keybinding (⌘J / Ctrl+J — use-chief-shortcut.ts).
-    // The rail is always open, so invocation here means: focus the composer.
-    const composerRef = React.useRef(null);
-    useChiefShortcut(() => composerRef.current?.focus());
-    return (_jsxs("aside", { ref: surface.surfaceRef, ...surface.surfaceProps, className: cn("hidden w-[340px] shrink-0 flex-col border-l border-border bg-background xl:flex", className), children: [_jsxs("div", { className: "flex h-12 shrink-0 items-center gap-2 border-b border-border px-4", children: [_jsx("div", { className: "flex size-6 items-center justify-center rounded-md bg-primary/10 text-primary", children: _jsx(Sparkles, { className: "size-3.5" }) }), _jsx("div", { className: "text-sm font-medium", children: session.title })] }), _jsx(ChiefSession, { session: session, composerRef: composerRef })] }));
+    return (_jsxs(_Fragment, { children: [!isRail && (_jsx("div", { "aria-hidden": true, 
+                // No click-to-close: explicit-close only (✕ / trigger / Esc).
+                className: cn("fixed inset-0 z-40 bg-black/30 transition-opacity duration-(--motion-duration-base) lg:hidden", open ? "opacity-100" : "pointer-events-none opacity-0") })), _jsxs("aside", { ref: surface.surfaceRef, ...surface.surfaceProps, role: isRail ? undefined : "dialog", style: { "--chief-width": `${width}px` }, className: cn("flex flex-col overflow-hidden bg-muted/50", isRail
+                    ? // Always-visible inflow rail at xl+ (the region mounts the
+                        // overlay below xl, where this is CSS-hidden).
+                        [
+                            "hidden w-(--chief-width) shrink-0 shadow-panel xl:flex",
+                            variant === "card" ? "rounded-xl" : "border-l border-border",
+                        ]
+                    : [
+                        "transition-all duration-(--motion-duration-base) ease-(--motion-ease-standard)",
+                        // Below lg: fixed overlay drawer from the right (floating →
+                        // the heavier overlay shadow gives it separation from content).
+                        "fixed inset-y-4 right-4 z-50 w-[min(var(--chief-width),calc(100vw-2rem))] rounded-xl shadow-2xl backdrop-blur-xl",
+                        // lg+: in-flow peer panel; the workspace reflows beside it. At
+                        // rest it carries the subtle harvested container elevation
+                        // (shadow-panel), not the floating overlay shadow.
+                        "lg:relative lg:inset-auto lg:right-auto lg:z-auto lg:shrink-0 lg:shadow-panel lg:backdrop-blur-none",
+                        variant === "flat" && "lg:rounded-none lg:border-l lg:border-border",
+                        open
+                            ? "translate-x-0 opacity-100 lg:w-(--chief-width)"
+                            : "pointer-events-none invisible translate-x-[calc(100%+1.5rem)] opacity-0 lg:w-0 lg:translate-x-0",
+                    ], className), children: [_jsx(ChiefHeaderBar, { title: session.title, icon: Icon, accentColor: accentColor, onClose: isRail ? undefined : () => setOpen(false) }), _jsx(ChiefSession, { session: session, composerRef: composerRef, accentColor: accentColor, workspaces: workspaces })] })] }));
 }
 //# sourceMappingURL=ChiefPanel.js.map

package/dist/chief/ChiefPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChiefPanel.js","sourceRoot":"","sources":["../../src/chief/ChiefPanel.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AASnD,MAAM,UAAU,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAmB;IACxE,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAElD,oEAAoE;IACpE,wEAAwE;IACxE,8DAA8D;IAC9D,MAAM,OAAO,GAAG,mBAAmB,CAAC;QAClC,IAAI,EAAE,IAAI;QACV,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC;QACtB,SAAS,EAAE,sBAAsB;QACjC,YAAY,EAAE,OAAO,CAAC,KAAK;KAC5B,CAAC,CAAC;IAEH,0EAA0E;IAC1E,yEAAyE;IACzE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAmB,IAAI,CAAC,CAAC;IACzD,gBAAgB,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAErD,OAAO,CACL,iBACE,GAAG,EAAE,OAAO,CAAC,UAAU,KACnB,OAAO,CAAC,YAAY,EACxB,SAAS,EAAE,EAAE,CACX,iFAAiF,EACjF,SAAS,CACV,aAED,eAAK,SAAS,EAAC,mEAAmE,aAChF,cAAK,SAAS,EAAC,+EAA+E,YAC5F,KAAC,QAAQ,IAAC,SAAS,EAAC,UAAU,GAAG,GAC7B,EACN,cAAK,SAAS,EAAC,qBAAqB,YAAE,OAAO,CAAC,KAAK,GAAO,IACtD,EAEN,KAAC,YAAY,IAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,GAAI,IACtD,CACT,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ChiefPanel.js","sourceRoot":"","sources":["../../src/chief/ChiefPanel.tsx"],"names":[],"mappings":"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"}

package/dist/chief/ChiefRegion.d.ts

@@ -1,9 +1,52 @@
 import type { OperatorFlavor } from "../flavor/types.js";
+import type { CanvasDefinition } from "@consciousclouds/canvas-sdk";
+import type { IconRegistry } from "../icons/registry.js";
+import type { PersonalityDisplay } from "./personality-display.js";
 import type { TurnAdapter } from "./turn-adapter.js";
+import type { ChiefWorkspacesRegion } from "./ChiefSession.js";
+import type { ConversationAdapter } from "./conversation-adapter.js";
+import type { ComposedMeta } from "./use-chief-turn.js";
+/** The AI Region's layout behaviors (chrome, never turn flow). */
+export type ChiefBehavior = "push" | "overlay" | "rail";
+/**
+ * The one behavior-resolution rule, pure and provable: the chrome config
+ * wins; a legacy `flavor.chief.placement` is honored as a hint (`rail` →
+ * `rail`, `drawer` → `overlay`); the default is the responsive hybrid.
+ */
+export declare function resolveChiefBehavior(behavior?: ChiefBehavior, legacyPlacement?: "rail" | "drawer"): ChiefBehavior;
 export interface ChiefRegionProps {
     flavor: OperatorFlavor;
     /** The product's transport (P1-1). The shell owns the region, never the wire. */
     adapter: TurnAdapter;
+    /** Layout behavior (chrome config). Absent ⇒ legacy placement hint ⇒ `push`. */
+    behavior?: ChiefBehavior;
+    /** Panel width in px (default 420). */
+    width?: number;
+    /** Desktop chrome for the inflow modes: `card` (framed) | `flat` (edge-to-edge). */
+    variant?: "card" | "flat";
+    /** Controlled open state (push/overlay; rail is always open at xl+). */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** External trigger element (outside-click exclusion + focus return). */
+    getTriggerElement?: () => HTMLElement | null;
+    /** Display identity from the Factory personality record (D-Q2 seam). */
+    personalityDisplay?: PersonalityDisplay;
+    /** Icon-registry extensions for `personalityDisplay.iconRef` resolution. */
+    icons?: IconRegistry;
+    /** Brand icon family (read-and-defaulted by the registry). */
+    iconFamily?: string;
+    /**
+     * The compose→center seam: a turn produced a transient CanvasDefinition.
+     * Threaded down to useChiefTurn (identical in every presentation); OperatorShell
+     * consumes it to drive the CENTER workspace. Panel stays presentation-only.
+     */
+    onComposed?: (canvas: CanvasDefinition, meta: ComposedMeta) => void;
+    /** Composition activity (real tool events) — forwarded verbatim to useChiefTurn. */
+    onComposeActivity?: (phase: "composing" | "idle") => void;
+    /** The transcript transport (fail-closed slot) — identical in every presentation. */
+    conversationAdapter?: ConversationAdapter;
+    /** Kept workspaces for the drawer's Workspaces tab (fail-closed slot). */
+    workspaces?: ChiefWorkspacesRegion;
 }
-export declare function ChiefRegion({ flavor, adapter }: ChiefRegionProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChiefRegion({ flavor, adapter, behavior, width, variant, open, onOpenChange, getTriggerElement, personalityDisplay, icons, iconFamily, onComposed, onComposeActivity, conversationAdapter, workspaces, }: ChiefRegionProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=ChiefRegion.d.ts.map

package/dist/chief/ChiefRegion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChiefRegion.d.ts","sourceRoot":"","sources":["../../src/chief/ChiefRegion.tsx"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAkBrD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,iFAAiF;IACjF,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,gBAAgB,2CAYhE"}
+{"version":3,"file":"ChiefRegion.d.ts","sourceRoot":"","sources":["../../src/chief/ChiefRegion.tsx"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,kEAAkE;AAClE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,CAAC,EAAE,aAAa,EACxB,eAAe,CAAC,EAAE,MAAM,GAAG,QAAQ,GAClC,aAAa,CAKf;AAkBD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,iFAAiF;IACjF,OAAO,EAAE,WAAW,CAAC;IACrB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC7C,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACpE,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,KAAK,IAAI,CAAC;IAC1D,qFAAqF;IACrF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,0EAA0E;IAC1E,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAED,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,OAAO,EACP,QAAQ,EACR,KAAK,EACL,OAAO,EACP,IAAI,EACJ,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,GACX,EAAE,gBAAgB,2CAiClB"}

package/dist/chief/ChiefRegion.js

@@ -2,29 +2,46 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * ChiefRegion — the shell's AI REGION: the one place Chief mounts, resolving
- * `flavor.chief.placement` to a presentation. Placement is Flavor decoration
- * (P1-1): it moves the panel, never the behavior — every placement runs the
- * same useChiefTurn flow over the same injected TurnAdapter, the same
- * conductor event vocabulary, and the same routed-directive guard.
+ * a BEHAVIOR to a presentation. Behavior is a COMPOSITION concern (the
+ * chrome config on OperatorShell — defaults-and-overrides: the SDK ships
+ * sensible defaults, the consuming app overrides at its composition root,
+ * never by forking); it moves the panel, never the turn flow — every
+ * behavior runs the same useChiefTurn over the same injected TurnAdapter,
+ * the same conductor event vocabulary, and the same routed-directive guard.
  *
- *   - `rail` (default): the always-open inflow right rail (ChiefPanel).
- *     Below the xl breakpoint — where the rail's `hidden xl:flex` chrome
- *     disappears — the region falls back to the DRAWER so Chief stays
- *     reachable on narrow viewports instead of silently vanishing (the rail
- *     was CSS-hidden there before; now the same seam that makes placement
- *     configurable also closes that gap).
- *   - `drawer`: the same content behind the sheet primitive + a floating
- *     trigger, with assistant-surface's open/close lifecycle (ChiefDrawer).
+ *   - `push` (default): the responsive hybrid, one component — overlay
+ *     drawer below lg, in-flow push panel (w-0 → w-(--chief-width)) at lg+.
+ *     Closed by default; summoned by the header trigger or ⌘J.
+ *   - `overlay`: the floating drawer at every width.
+ *   - `rail`: the always-visible mode — the always-open inflow rail at xl+,
+ *     the overlay below it (where the rail is CSS-hidden) so Chief stays
+ *     reachable on narrow viewports.
  *
  * Exactly ONE presentation mounts at a time (they share the
- * `operator-shell-chief` surface id — the single-surface rule holds). The
- * breakpoint check is undefined until the client knows the viewport; the
- * region then renders the rail, whose CSS already hides it below xl, so
- * SSR/hydration stay consistent and nothing flashes.
+ * `operator-shell-chief` surface id — the single-surface rule holds). For
+ * `rail`, the breakpoint check is undefined until the client knows the
+ * viewport; the region then renders the rail, whose CSS already hides it
+ * below xl, so SSR/hydration stay consistent and nothing flashes. `push`
+ * and `overlay` need no viewport check at all — their responsiveness is
+ * pure CSS on one mounted component (the turn thread survives resizes).
  */
 import * as React from "react";
 import { ChiefDrawer } from "./ChiefDrawer.js";
 import { ChiefPanel } from "./ChiefPanel.js";
+/**
+ * The one behavior-resolution rule, pure and provable: the chrome config
+ * wins; a legacy `flavor.chief.placement` is honored as a hint (`rail` →
+ * `rail`, `drawer` → `overlay`); the default is the responsive hybrid.
+ */
+export function resolveChiefBehavior(behavior, legacyPlacement) {
+    if (behavior !== undefined)
+        return behavior;
+    if (legacyPlacement === "rail")
+        return "rail";
+    if (legacyPlacement === "drawer")
+        return "overlay";
+    return "push";
+}
 /** Tailwind's `xl` — MUST match the rail's `hidden xl:flex` visibility. */
 const XL_QUERY = "(min-width: 1280px)";
 /** undefined until the client can answer (SSR/first render). */
@@ -39,17 +56,36 @@ function useIsXl() {
     }, []);
     return isXl;
 }
-export function ChiefRegion({ flavor, adapter }) {
-    const placement = flavor.chief?.placement ?? "rail";
+export function ChiefRegion({ flavor, adapter, behavior, width, variant, open, onOpenChange, getTriggerElement, personalityDisplay, icons, iconFamily, onComposed, onComposeActivity, conversationAdapter, workspaces, }) {
+    const resolved = resolveChiefBehavior(behavior, flavor.chief?.placement);
     const isXl = useIsXl();
-    if (placement === "drawer")
-        return _jsx(ChiefDrawer, { flavor: flavor, adapter: adapter });
-    // Rail placement: the inflow rail at xl and up; the drawer below it
-    // (where the rail is CSS-hidden). While the viewport is unknown
-    // (SSR/first client render) the rail mounts — its own CSS keeps it
-    // invisible below xl, so there is no flash either way.
-    if (isXl === false)
-        return _jsx(ChiefDrawer, { flavor: flavor, adapter: adapter });
-    return _jsx(ChiefPanel, { flavor: flavor, adapter: adapter });
+    const shared = {
+        flavor,
+        adapter,
+        width,
+        open,
+        onOpenChange,
+        getTriggerElement,
+        personalityDisplay,
+        icons,
+        iconFamily,
+        onComposed,
+        onComposeActivity,
+        conversationAdapter,
+        workspaces,
+    };
+    if (resolved === "overlay")
+        return _jsx(ChiefDrawer, { ...shared });
+    if (resolved === "rail") {
+        // The always-visible mode: the inflow rail at xl and up; the overlay
+        // below it (where the rail is CSS-hidden). While the viewport is
+        // unknown (SSR/first client render) the rail mounts — its own CSS keeps
+        // it invisible below xl, so there is no flash either way.
+        if (isXl === false)
+            return _jsx(ChiefDrawer, { ...shared });
+        return _jsx(ChiefPanel, { ...shared, mode: "rail", variant: variant });
+    }
+    // The default responsive hybrid — one component, pure-CSS responsive.
+    return _jsx(ChiefPanel, { ...shared, mode: "push", variant: variant });
 }
 //# sourceMappingURL=ChiefRegion.js.map

package/dist/chief/ChiefRegion.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChiefRegion.js","sourceRoot":"","sources":["../../src/chief/ChiefRegion.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,2EAA2E;AAC3E,MAAM,QAAQ,GAAG,qBAAqB,CAAC;AAEvC,gEAAgE;AAChE,SAAS,OAAO;IACd,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAsB,SAAS,CAAC,CAAC;IACvE,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,QAAQ,EAAE,CAAC;QACX,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACzC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,IAAI,CAAC;AACd,CAAC;AAQD,MAAM,UAAU,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAoB;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,SAAS,IAAI,MAAM,CAAC;IACpD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IAEvB,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAC,WAAW,IAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAI,CAAC;IAErF,oEAAoE;IACpE,gEAAgE;IAChE,mEAAmE;IACnE,uDAAuD;IACvD,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,KAAC,WAAW,IAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAI,CAAC;IAC7E,OAAO,KAAC,UAAU,IAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAI,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"ChiefRegion.js","sourceRoot":"","sources":["../../src/chief/ChiefRegion.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAU7C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAwB,EACxB,eAAmC;IAEnC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,eAAe,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,eAAe,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACnD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2EAA2E;AAC3E,MAAM,QAAQ,GAAG,qBAAqB,CAAC;AAEvC,gEAAgE;AAChE,SAAS,OAAO;IACd,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAsB,SAAS,CAAC,CAAC;IACvE,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,QAAQ,EAAE,CAAC;QACX,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACzC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,IAAI,CAAC;AACd,CAAC;AAqCD,MAAM,UAAU,WAAW,CAAC,EAC1B,MAAM,EACN,OAAO,EACP,QAAQ,EACR,KAAK,EACL,OAAO,EACP,IAAI,EACJ,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,GACO;IACjB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IAEvB,MAAM,MAAM,GAAG;QACb,MAAM;QACN,OAAO;QACP,KAAK;QACL,IAAI;QACJ,YAAY;QACZ,iBAAiB;QACjB,kBAAkB;QAClB,KAAK;QACL,UAAU;QACV,UAAU;QACV,iBAAiB;QACjB,mBAAmB;QACnB,UAAU;KACX,CAAC;IAEF,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAC,WAAW,OAAK,MAAM,GAAI,CAAC;IAE/D,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,qEAAqE;QACrE,iEAAiE;QACjE,wEAAwE;QACxE,0DAA0D;QAC1D,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,KAAC,WAAW,OAAK,MAAM,GAAI,CAAC;QACvD,OAAO,KAAC,UAAU,OAAK,MAAM,EAAE,IAAI,EAAC,MAAM,EAAC,OAAO,EAAE,OAAO,GAAI,CAAC;IAClE,CAAC;IAED,sEAAsE;IACtE,OAAO,KAAC,UAAU,OAAK,MAAM,EAAE,IAAI,EAAC,MAAM,EAAC,OAAO,EAAE,OAAO,GAAI,CAAC;AAClE,CAAC"}

package/dist/chief/ChiefSession.d.ts

@@ -1,21 +1,57 @@
 /**
- * ChiefSession — the AI Region's shared BODY: idle hint, thread (question ·
- * streamed answer · status line), and the composer form, rendered from a
+ * ChiefSession — the AI Region's shared BODY: the empty state (hint card +
+ * suggestion chips), the thread (question · streamed markdown answer ·
+ * color-coded metadata bar), and the pill composer, rendered from a
  * ChiefTurnSession. Pure presentation of the one turn flow — every placement
- * (rail, drawer) mounts this same column inside its own chrome, so moving
- * Chief never forks its behavior or its look.
+ * (rail, push, overlay) mounts this same column inside its own chrome, so
+ * moving Chief never forks its behavior or its look.
  *
- * `composerRef` exposes the composer input to the mounting placement — the
- * rail points the shell's ⌘J invocation at it (focus); presentation only,
- * no behavior lives here.
+ * Suggestion chips are inert Flavor strings (`flavor.chief.suggestions`);
+ * clicking one submits its text through `submitPrompt` — the SAME entry the
+ * composer uses, so a chip is a canned question, never a second code path.
+ *
+ * `composerRef` exposes the composer input to the mounting placement — ⌘J
+ * focus on the rail, focus-on-open in the dismissible placements;
+ * presentation only, no behavior lives here.
+ *
+ * MOTION (presentation only — the turn STATE and the adapter are untouched):
+ * the conversation is animated with the ConsciousClouds motion vocabulary
+ * (`@consciousclouds/tokens`' `motionTokens` — durations/curves/offsets, no
+ * inline magic numbers) through `motion/react`. The empty-state hint rises in
+ * and the suggestion chips STAGGER in gently; when the first turn starts the
+ * thread rises in (empty → active); inside the thread the "thinking…" state
+ * and the answer CROSSFADE (the leaving one lifts out as an absolute overlay,
+ * so nothing reflows) and the answer SETTLES to full size the instant
+ * streaming completes; the status line eases in. The token stream itself is
+ * never animated per-character (that fights the stream) — only the CONTAINER
+ * and the turn state are. Every gesture respects `prefers-reduced-motion`
+ * (`useReducedMotion`): reduced → instant, no transform, no fade.
  */
-import type * as React from "react";
+import * as React from "react";
 import type { ChiefTurnSession } from "./use-chief-turn.js";
+/**
+ * The AI Region's Workspaces tab data (Session Binder consumption slice —
+ * "a conversation owns a workspace", so kept workspaces live WITH the
+ * conversation surface, in the drawer, not the side menu). Same shape the
+ * sidebar region used; fed by OperatorShell, absent ⇒ no tab.
+ */
+export interface ChiefWorkspacesRegion {
+    items: ReadonlyArray<{
+        workspaceId: string;
+        name: string;
+    }>;
+    activeId?: string;
+    onOpen: (workspaceId: string) => void;
+}
 export interface ChiefSessionProps {
     session: ChiefTurnSession;
-    /** The composer input element — the placement's focus target (⌘J on the rail). */
+    /** The composer input element — the placement's focus target (⌘J, focus-on-open). */
     composerRef?: React.Ref<HTMLInputElement>;
+    /** Composable CSS color from a token ROLE (resolvePersonalityAccent). */
+    accentColor?: string;
+    /** Kept workspaces for the Workspaces tab (absent ⇒ the tab doesn't exist). */
+    workspaces?: ChiefWorkspacesRegion;
     className?: string;
 }
-export declare function ChiefSession({ session, composerRef, className }: ChiefSessionProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChiefSession({ session, composerRef, accentColor, workspaces, className, }: ChiefSessionProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=ChiefSession.d.ts.map

package/dist/chief/ChiefSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChiefSession.d.ts","sourceRoot":"","sources":["../../src/chief/ChiefSession.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAKpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,kFAAkF;IAClF,WAAW,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,iBAAiB,2CAyFlF"}
+{"version":3,"file":"ChiefSession.d.ts","sourceRoot":"","sources":["../../src/chief/ChiefSession.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAY5D;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,aAAa,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAKD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,qFAAqF;IACrF,WAAW,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC1C,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8BD,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,GACV,EAAE,iBAAiB,2CAyenB"}