@elizaos/ui 2.0.0-beta.1 → 2.0.3-beta.2

package/components/shell/__e2e__/home-screen-fixture.activity-stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-screen-fixture.activity-stub.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/shell/__e2e__/home-screen-fixture.activity-stub.ts"],"names":[],"mappings":"AACA,wBAAgB,iBAAiB;;;;;;;;EAUhC"}

package/components/shell/__e2e__/home-screen-fixture.activity-stub.js

@@ -0,0 +1,12 @@
+// Stub useActivityEvents for the home-screen e2e.
+export function useActivityEvents() {
+    return {
+        events: [
+            { id: "a1", timestamp: Date.now() - 8000, eventType: "task_complete", summary: "Shipped the chat-sheet redesign" },
+            { id: "a2", timestamp: Date.now() - 95000, eventType: "tool_running", summary: "Running the Android route-coverage suite" },
+            { id: "a3", timestamp: Date.now() - 600000, eventType: "reminder", summary: "Standup at 10:30" },
+            { id: "a4", timestamp: Date.now() - 3600000, eventType: "workflow", summary: "Nightly backup completed" },
+        ],
+        clearEvents() { },
+    };
+}

package/components/shell/__e2e__/home-screen-fixture.api-stub.d.ts

@@ -0,0 +1,15 @@
+export declare const client: {
+    getInboxChats: () => Promise<{
+        chats: {
+            id: string;
+            source: string;
+            worldLabel: string;
+            title: string;
+            lastMessageText: string;
+            lastMessageAt: number;
+            messageCount: number;
+        }[];
+        count: number;
+    }>;
+};
+//# sourceMappingURL=home-screen-fixture.api-stub.d.ts.map

package/components/shell/__e2e__/home-screen-fixture.api-stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-screen-fixture.api-stub.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/shell/__e2e__/home-screen-fixture.api-stub.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,MAAM;;;;;;;;;;;;;CASlB,CAAC"}

package/components/shell/__e2e__/home-screen-fixture.api-stub.js

@@ -0,0 +1,11 @@
+// Stub `../../api` for the home-screen e2e: just the client methods HomeScreen uses.
+export const client = {
+    getInboxChats: async () => ({
+        chats: [
+            { id: "c1", source: "imessage", worldLabel: "iMessage", title: "Alex Rivera", lastMessageText: "see you at 5, bring the deck", lastMessageAt: Date.now() - 120000, messageCount: 4 },
+            { id: "c2", source: "telegram", worldLabel: "Telegram", title: "Eng standup", lastMessageText: "deploy is green ✅", lastMessageAt: Date.now() - 1800000, messageCount: 12 },
+            { id: "c3", source: "discord", worldLabel: "Discord", title: "example", lastMessageText: "gm", lastMessageAt: Date.now() - 5400000, messageCount: 99 },
+        ],
+        count: 3,
+    }),
+};

package/components/shell/__e2e__/home-screen-fixture.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=home-screen-fixture.d.ts.map

package/components/shell/__e2e__/home-screen-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-screen-fixture.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/shell/__e2e__/home-screen-fixture.tsx"],"names":[],"mappings":""}

package/components/shell/__e2e__/home-screen-fixture.docvis-stub.d.ts

@@ -0,0 +1,3 @@
+export declare function useIntervalWhenDocumentVisible(): void;
+export declare function useDocumentVisibility(): boolean;
+//# sourceMappingURL=home-screen-fixture.docvis-stub.d.ts.map

package/components/shell/__e2e__/home-screen-fixture.docvis-stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-screen-fixture.docvis-stub.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/shell/__e2e__/home-screen-fixture.docvis-stub.ts"],"names":[],"mappings":"AACA,wBAAgB,8BAA8B,SAAK;AACnD,wBAAgB,qBAAqB,YAAmB"}

package/components/shell/__e2e__/home-screen-fixture.docvis-stub.js

@@ -0,0 +1,3 @@
+// Stub the visibility-interval hooks for the e2e (no live timers in headless).
+export function useIntervalWhenDocumentVisible() { }
+export function useDocumentVisibility() { return true; }

package/components/shell/__e2e__/home-screen-fixture.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createRoot } from "react-dom/client";
+import { ChatAmbientBackground } from "../ChatAmbientBackground.js";
+import { HomeScreen } from "../HomeScreen.js";
+const params = typeof location !== "undefined"
+    ? new URLSearchParams(location.search)
+    : new URLSearchParams();
+const showNativeOsTiles = params.has("native");
+function Harness() {
+    return (_jsxs("div", { "data-testid": "home-fixture-root", style: { position: "fixed", inset: 0, overflow: "hidden" }, children: [_jsx(ChatAmbientBackground, {}), _jsx(HomeScreen, { onOpenTile: (t) => console.log(`[fixture] open ${JSON.stringify(t)}`), showNativeOsTiles: showNativeOsTiles })] }));
+}
+const root = document.getElementById("root");
+if (root)
+    createRoot(root).render(_jsx(Harness, {}));

package/components/shell/__e2e__/home-screen-fixture.views-stub.d.ts

@@ -0,0 +1,8 @@
+export declare function useAvailableViews(): {
+    views: {
+        id: string;
+        path: string;
+    }[];
+    loading: boolean;
+};
+//# sourceMappingURL=home-screen-fixture.views-stub.d.ts.map

package/components/shell/__e2e__/home-screen-fixture.views-stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-screen-fixture.views-stub.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/shell/__e2e__/home-screen-fixture.views-stub.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB;;;;;;EAShC"}

package/components/shell/__e2e__/home-screen-fixture.views-stub.js

@@ -0,0 +1,13 @@
+// Stub for useAvailableViews in the home-screen e2e: report the view paths the
+// home tiles gate on as registered, so the gated tiles (orchestrator,
+// workflows, inbox) render deterministically.
+export function useAvailableViews() {
+    return {
+        views: [
+            { id: "orchestrator", path: "/orchestrator" },
+            { id: "automations", path: "/automations" },
+            { id: "inbox", path: "/inbox" },
+        ],
+        loading: false,
+    };
+}

package/components/shell/__e2e__/usePromptSuggestions.stub.d.ts

@@ -0,0 +1,2 @@
+export declare function usePromptSuggestions(): string[];
+//# sourceMappingURL=usePromptSuggestions.stub.d.ts.map

package/components/shell/__e2e__/usePromptSuggestions.stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePromptSuggestions.stub.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/shell/__e2e__/usePromptSuggestions.stub.ts"],"names":[],"mappings":"AAIA,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAM/C"}

package/components/shell/__e2e__/usePromptSuggestions.stub.js

@@ -0,0 +1,11 @@
+// Browser-pure stand-in for usePromptSuggestions in the e2e bundle. The real
+// hook reaches the API client (which drags in Node-only deps at bundle time and
+// only matters for the small-model fetch). The harness just needs the static
+// strip, so return three fixed prompts.
+export function usePromptSuggestions() {
+    return [
+        "what's on my plate today?",
+        "summarize this view",
+        "draft a quick note",
+    ];
+}

package/components/shell/first-run-theme.d.ts

@@ -0,0 +1,6 @@
+import type { CSSProperties } from "react";
+import type { FirstRunThemeConfig } from "../../config/branding";
+type FirstRunCssVars = CSSProperties & Record<`--${string}`, string>;
+export declare function getFirstRunThemeVars(theme: FirstRunThemeConfig | undefined): FirstRunCssVars;
+export {};
+//# sourceMappingURL=first-run-theme.d.ts.map

package/components/shell/first-run-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-run-theme.d.ts","sourceRoot":"","sources":["../../../../../../src/components/shell/first-run-theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,KAAK,eAAe,GAAG,aAAa,GAAG,MAAM,CAAC,KAAK,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;AAkBrE,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACrC,eAAe,CAejB"}

package/components/shell/first-run-theme.js

@@ -0,0 +1,31 @@
+const DEFAULT_FIRST_RUN_THEME = {
+    // Brand rule (#8796): no blue. Near-black background with the orange button +
+    // white text is the on-brand first-run look (orange/black/white).
+    background: "#0b0e11",
+    foreground: "#ffffff",
+    mutedForeground: "rgba(255, 255, 255, 0.78)",
+    controlBackground: "rgba(255, 255, 255, 0.18)",
+    controlForeground: "#ffffff",
+    buttonBackground: "#ff8a24",
+    buttonForeground: "#fff7ee",
+    buttonHighlightBackground: "#fff7ee",
+    inputBackground: "rgba(255, 255, 255, 0.92)",
+    inputForeground: "#06131f",
+    errorForeground: "#fff0e8",
+};
+export function getFirstRunThemeVars(theme) {
+    const resolved = { ...DEFAULT_FIRST_RUN_THEME, ...theme };
+    return {
+        "--first-run-bg": resolved.background,
+        "--first-run-fg": resolved.foreground,
+        "--first-run-muted": resolved.mutedForeground,
+        "--first-run-control-bg": resolved.controlBackground,
+        "--first-run-control-fg": resolved.controlForeground,
+        "--first-run-button-bg": resolved.buttonBackground,
+        "--first-run-button-fg": resolved.buttonForeground,
+        "--first-run-button-highlight": resolved.buttonHighlightBackground,
+        "--first-run-input-bg-flat": resolved.inputBackground,
+        "--first-run-input-fg-flat": resolved.inputForeground,
+        "--first-run-error": resolved.errorForeground,
+    };
+}

package/components/shell/glass-composer.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+export declare function GlassIconButton({ icon, label, disabled, active, onClick, onPointerDown, onPointerUp, onPointerCancel, }: {
+    icon: "mic" | "send";
+    label: string;
+    disabled?: boolean;
+    /** Mic only: reflects recording state (adds a pulse + aria-pressed). */
+    active?: boolean;
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    onPointerDown?: (event: React.PointerEvent<HTMLButtonElement>) => void;
+    onPointerUp?: (event: React.PointerEvent<HTMLButtonElement>) => void;
+    onPointerCancel?: (event: React.PointerEvent<HTMLButtonElement>) => void;
+}): React.JSX.Element;
+//# sourceMappingURL=glass-composer.d.ts.map

package/components/shell/glass-composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass-composer.d.ts","sourceRoot":"","sources":["../../../../../../src/components/shell/glass-composer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA4B/B,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,aAAa,EACb,WAAW,EACX,eAAe,GAChB,EAAE;IACD,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC/D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACvE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACrE,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;CAC1E,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAuDpB"}

package/components/shell/glass-composer.helpers.d.ts

@@ -0,0 +1,3 @@
+/** Class for the glass composer bar — translucent, blurred, edge-highlighted; no plain borders. */
+export declare const GLASS_COMPOSER_CLASS = "flex items-center gap-1.5 rounded-[6px] border border-txt/15 bg-txt/5 p-1.5 backdrop-blur-xl shadow-[inset_0_1px_0_rgba(255,255,255,0.25),inset_0_-1px_0_rgba(0,0,0,0.06),0_10px_30px_rgba(0,0,0,0.18)]";
+//# sourceMappingURL=glass-composer.helpers.d.ts.map

package/components/shell/glass-composer.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass-composer.helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/components/shell/glass-composer.helpers.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,eAAO,MAAM,oBAAoB,4MAC0K,CAAC"}

package/components/shell/glass-composer.helpers.js

@@ -0,0 +1,2 @@
+/** Class for the glass composer bar — translucent, blurred, edge-highlighted; no plain borders. */
+export const GLASS_COMPOSER_CLASS = "flex items-center gap-1.5 rounded-[6px] border border-txt/15 bg-txt/5 p-1.5 backdrop-blur-xl shadow-[inset_0_1px_0_rgba(255,255,255,0.25),inset_0_-1px_0_rgba(0,0,0,0.06),0_10px_30px_rgba(0,0,0,0.18)]";

package/components/shell/glass-composer.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { cn } from "../../lib/utils.js";
+/**
+ * Shared chat-composer chrome: a well-defined refractive-glass bar plus
+ * xs-cornered white "negative-space" icon buttons (the glyph is cut OUT of the
+ * white so the glass/background shows through it, matching the negative-space
+ * face art). Used by both the homescreen composer and the overlay ChatSurface
+ * so the mic and send controls read as one consistent set.
+ *
+ * The bar class lives in {@link ./glass-composer.helpers}.
+ */
+// xs-cornered button rect + filled glyphs, combined under fillRule=evenodd so
+// the glyph becomes a transparent hole in the white button.
+const BTN_RECT = "M6 0H30A6 6 0 0 1 36 6V30A6 6 0 0 1 30 36H6A6 6 0 0 1 0 30V6A6 6 0 0 1 6 0Z";
+// Up arrow — shaft + head, pointing up (send).
+const SEND_GLYPH = "M18 10L25 18H21V27H15V18H11Z";
+// Five-bar waveform — tallest in the center, like OpenAI's voice indicator.
+const MIC_GLYPH = "M6 14H9V22H6Z" +
+    "M11.5 10H14.5V26H11.5Z" +
+    "M16.5 7H19.5V29H16.5Z" +
+    "M22 10H25V26H22Z" +
+    "M27 14H30V22H27Z";
+export function GlassIconButton({ icon, label, disabled, active, onClick, onPointerDown, onPointerUp, onPointerCancel, }) {
+    const pointerActivatedRef = React.useRef(false);
+    const handleClick = React.useCallback((event) => {
+        if (pointerActivatedRef.current) {
+            pointerActivatedRef.current = false;
+            return;
+        }
+        onClick?.(event);
+    }, [onClick]);
+    const handleMouseDown = React.useCallback((event) => {
+        if (onPointerDown || onPointerUp || !onClick)
+            return;
+        pointerActivatedRef.current = true;
+        onClick(event);
+        window.setTimeout(() => {
+            pointerActivatedRef.current = false;
+        }, 0);
+    }, [onClick, onPointerDown, onPointerUp]);
+    return (_jsx("button", { type: "button", "aria-label": label, "aria-pressed": icon === "mic" ? active : undefined, disabled: disabled, onClick: handleClick, onPointerDown: onPointerDown, onPointerUp: onPointerUp, onPointerCancel: onPointerCancel, onMouseDown: handleMouseDown, className: cn("grid h-9 w-9 shrink-0 place-items-center transition-transform", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/70 focus-visible:ring-offset-0", disabled ? "opacity-40" : "hover:scale-105", active && "animate-pulse"), children: _jsx("svg", { viewBox: "0 0 36 36", className: "pointer-events-none h-full w-full drop-shadow-[0_1px_4px_rgba(0,0,0,0.3)]", "aria-hidden": "true", children: _jsx("path", { fill: "#ffffff", fillRule: "evenodd", d: `${BTN_RECT}${icon === "mic" ? MIC_GLYPH : SEND_GLYPH}` }) }) }));
+}

package/components/shell/shell-state.d.ts

@@ -0,0 +1,25 @@
+import type { ChatFailureKind, MessageAttachment } from "../../api";
+/**
+ * Shell phase for the device-shell foundation (HomePill + AssistantOverlay +
+ * ChatSurface). Drives the pill's visual treatment.
+ *
+ *   booting    — startup not ready; pill dim, no halo.
+ *   idle       — ready, no overlay; pill solid.
+ *   summoned   — overlay open, no active mic/response; faint halo.
+ *   listening  — push-to-talk capture in flight; red pulse.
+ *   responding — agent stream in flight; ambient glow.
+ */
+export type ShellPhase = "booting" | "idle" | "summoned" | "listening" | "responding";
+export interface ShellMessage {
+    id: string;
+    role: "user" | "assistant";
+    content: string;
+    createdAt: number;
+    /** Set on assistant turns the server flagged as failed (e.g. no provider). */
+    failureKind?: ChatFailureKind;
+    /** Agent reasoning/thought for this turn, rendered as a collapsed block. */
+    reasoning?: string;
+    /** Media attached to this turn — user uploads and agent-generated media. */
+    attachments?: MessageAttachment[];
+}
+//# sourceMappingURL=shell-state.d.ts.map

package/components/shell/shell-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-state.d.ts","sourceRoot":"","sources":["../../../../../../src/components/shell/shell-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEpE;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,YAAY,CAAC;AAEjB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACnC"}

package/components/shell/startup-shell-types.d.ts

@@ -0,0 +1,25 @@
+import type { ReactNode } from "react";
+import type { StartupErrorState } from "../../state/types";
+export type StartupShellView = {
+    kind: "error";
+    error: StartupErrorState;
+} | {
+    kind: "pairing";
+} | {
+    kind: "bootstrap";
+    onAdvance: () => void;
+} | {
+    kind: "first-run";
+} | {
+    kind: "loading";
+    phase: string;
+    status: string;
+} | {
+    kind: "none";
+};
+export interface StartupShellProps {
+    view: StartupShellView;
+    firstRun: ReactNode;
+    onRetry: () => void;
+}
+//# sourceMappingURL=startup-shell-types.d.ts.map

package/components/shell/startup-shell-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-shell-types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/shell/startup-shell-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,IAAI,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB"}

package/components/shell/use-pull-gesture.d.ts

@@ -0,0 +1,44 @@
+import * as React from "react";
+/**
+ * Vertical pull/flick gesture detection for the homescreen shell.
+ *
+ * Drives the Claude/Whisper-Flow-style interactions: pull UP on the homescreen
+ * to reveal the chat, pull DOWN (or flick up on the voice overlay) to dismiss.
+ * Pure pointer-event logic — bind the returned handlers to any element. A
+ * gesture fires on release when it crosses either a distance OR a velocity
+ * threshold, so both deliberate drags and quick flicks register.
+ */
+export interface PullGestureOptions {
+    /** Released after a drag/flick UP past threshold. */
+    onPullUp?: () => void;
+    /** Released after a drag/flick DOWN past threshold. */
+    onPullDown?: () => void;
+    /** Live drag offset while pressed, in px. Positive = dragging up. */
+    onDrag?: (offset: number) => void;
+    /** A near-stationary press/release — a tap, not a pull. */
+    onTap?: () => void;
+    /**
+     * A deliberate (slow) drag released without passing the flick/distance
+     * threshold. When provided, the gesture rests exactly where released
+     * (the consumer keeps the live offset) instead of snapping back.
+     */
+    onSettleFree?: (direction: "up" | "down") => void;
+    /** Minimum travel (px) to count as a pull. Default 56. */
+    distanceThreshold?: number;
+    /** Minimum speed (px/ms) to count as a flick. Default 0.5. */
+    velocityThreshold?: number;
+}
+export interface PullGestureBinding {
+    onPointerDown: (event: React.PointerEvent) => void;
+    onPointerMove: (event: React.PointerEvent) => void;
+    onPointerUp: (event: React.PointerEvent) => void;
+    onPointerCancel: (event: React.PointerEvent) => void;
+    /** The OS can revoke pointer capture without a pointerup/pointercancel — most
+     *  notably on device ROTATION, which otherwise strands the gesture mid-drag
+     *  (the consumer's morph freezes). Treat it as a release so the sheet settles. */
+    onLostPointerCapture: (event: React.PointerEvent) => void;
+}
+/** Decide whether a release should fire a pull, and in which direction. */
+export declare function resolvePull(deltaUp: number, velocityUp: number, distanceThreshold: number, velocityThreshold: number): "up" | "down" | null;
+export declare function usePullGesture(options: PullGestureOptions): PullGestureBinding;
+//# sourceMappingURL=use-pull-gesture.d.ts.map

package/components/shell/use-pull-gesture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pull-gesture.d.ts","sourceRoot":"","sources":["../../../../../../src/components/shell/use-pull-gesture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,qEAAqE;IACrE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,KAAK,IAAI,CAAC;IAClD,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAKD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;IACnD,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;IACnD,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;IACjD,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;IACrD;;sFAEkF;IAClF,oBAAoB,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;CAC3D;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,EAAE,MAAM,GACxB,IAAI,GAAG,MAAM,GAAG,IAAI,CAMtB;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,kBAAkB,GAC1B,kBAAkB,CAmFpB"}

package/components/shell/use-pull-gesture.js

@@ -0,0 +1,85 @@
+import * as React from "react";
+/** Movement (px) under which a release is treated as a tap, not a drag. */
+const TAP_SLOP = 8;
+/** Decide whether a release should fire a pull, and in which direction. */
+export function resolvePull(deltaUp, velocityUp, distanceThreshold, velocityThreshold) {
+    const passed = Math.abs(deltaUp) >= distanceThreshold ||
+        Math.abs(velocityUp) >= velocityThreshold;
+    if (!passed)
+        return null;
+    return deltaUp > 0 ? "up" : "down";
+}
+export function usePullGesture(options) {
+    const { onPullUp, onPullDown, onDrag, onTap, onSettleFree, distanceThreshold = 56, velocityThreshold = 0.5, } = options;
+    const start = React.useRef(null);
+    const onPointerDown = React.useCallback((event) => {
+        start.current = { y: event.clientY, t: performance.now() };
+        try {
+            event.currentTarget.setPointerCapture(event.pointerId);
+        }
+        catch {
+            // Detached node mid-gesture — capture is best-effort.
+        }
+    }, []);
+    const onPointerMove = React.useCallback((event) => {
+        const s = start.current;
+        if (!s || !onDrag)
+            return;
+        onDrag(s.y - event.clientY);
+    }, [onDrag]);
+    const finish = React.useCallback((event) => {
+        const s = start.current;
+        start.current = null;
+        if (!s)
+            return;
+        const deltaUp = s.y - event.clientY; // up is positive
+        const elapsed = Math.max(1, performance.now() - s.t);
+        const velocityUp = deltaUp / elapsed;
+        const moved = Math.abs(deltaUp);
+        const isFlick = Math.abs(velocityUp) >= velocityThreshold;
+        // A near-stationary release is a tap (e.g. tapping the collapsed bar to
+        // focus the composer), not a drag.
+        if (moved < TAP_SLOP && !isFlick) {
+            onDrag?.(0); // snap back
+            onTap?.();
+            return;
+        }
+        // A quick FLICK snaps to the next detent in the flick direction; any
+        // deliberate (non-flick) drag RESTS wherever it was released — drag the
+        // sheet to any size and it stays (a detent is only taken by a flick/tap).
+        if (isFlick) {
+            if (deltaUp > 0)
+                onPullUp?.();
+            else
+                onPullDown?.();
+            return;
+        }
+        if (onSettleFree) {
+            onSettleFree(deltaUp > 0 ? "up" : "down");
+        }
+        else if (moved >= distanceThreshold) {
+            if (deltaUp > 0)
+                onPullUp?.();
+            else
+                onPullDown?.();
+        }
+        else {
+            onDrag?.(0); // sub-threshold, no free-settle consumer → snap back
+        }
+    }, [
+        onDrag,
+        onPullUp,
+        onPullDown,
+        onTap,
+        onSettleFree,
+        distanceThreshold,
+        velocityThreshold,
+    ]);
+    return {
+        onPointerDown,
+        onPointerMove,
+        onPointerUp: finish,
+        onPointerCancel: finish,
+        onLostPointerCapture: finish,
+    };
+}

package/components/shell/useKioskViewSurfaces.d.ts

@@ -0,0 +1,28 @@
+/**
+ * One in-window dynamic-view surface mounted on the kiosk canvas. Mirrors the
+ * `KioskViewEvent` "mount" payload emitted by the Electrobun-side KioskCanvas
+ * when the agent opens a dynamic view in kiosk shell mode.
+ */
+export interface KioskViewSurface {
+    windowId: string;
+    url: string;
+    title: string;
+    width: number;
+    height: number;
+    alwaysOnTop: boolean;
+}
+/**
+ * Subscribes to the Electrobun `kioskViewEvent` channel and maintains the set
+ * of dynamic-view surfaces the kiosk canvas should render in-window.
+ *
+ * In kiosk shell mode the OS runs a single fullscreen toplevel, so the
+ * dynamic-view session manager mounts views as in-canvas surfaces (positioned
+ * iframes) instead of opening native windows. This hook turns the bun-side
+ * mount/unmount events into the list of surfaces the `KioskViewCanvas` renders.
+ *
+ * `a2ui` events are intentionally not forwarded here: each view loads its
+ * initial state from its own entrypoint over the local agent, so the canvas
+ * only reacts to `mount`/`unmount` events.
+ */
+export declare function useKioskViewSurfaces(): KioskViewSurface[];
+//# sourceMappingURL=useKioskViewSurfaces.d.ts.map

package/components/shell/useKioskViewSurfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKioskViewSurfaces.d.ts","sourceRoot":"","sources":["../../../../../../src/components/shell/useKioskViewSurfaces.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;CACtB;AAqBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,EAAE,CAqCzD"}

package/components/shell/useKioskViewSurfaces.js

@@ -0,0 +1,56 @@
+import { useEffect, useState } from "react";
+import { subscribeDesktopBridgeEvent } from "../../bridge/electrobun-rpc.js";
+function isKioskViewEvent(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const kind = value.kind;
+    return kind === "mount" || kind === "unmount" || kind === "a2ui";
+}
+/**
+ * Subscribes to the Electrobun `kioskViewEvent` channel and maintains the set
+ * of dynamic-view surfaces the kiosk canvas should render in-window.
+ *
+ * In kiosk shell mode the OS runs a single fullscreen toplevel, so the
+ * dynamic-view session manager mounts views as in-canvas surfaces (positioned
+ * iframes) instead of opening native windows. This hook turns the bun-side
+ * mount/unmount events into the list of surfaces the `KioskViewCanvas` renders.
+ *
+ * `a2ui` events are intentionally not forwarded here: each view loads its
+ * initial state from its own entrypoint over the local agent, so the canvas
+ * only reacts to `mount`/`unmount` events.
+ */
+export function useKioskViewSurfaces() {
+    const [surfaces, setSurfaces] = useState([]);
+    useEffect(() => {
+        return subscribeDesktopBridgeEvent({
+            rpcMessage: "kioskViewEvent",
+            ipcChannel: "kiosk:viewEvent",
+            listener: (payload) => {
+                if (!isKioskViewEvent(payload))
+                    return;
+                if (payload.kind === "mount") {
+                    const next = {
+                        windowId: payload.windowId,
+                        url: payload.url,
+                        title: payload.title,
+                        width: payload.width,
+                        height: payload.height,
+                        alwaysOnTop: payload.alwaysOnTop,
+                    };
+                    setSurfaces((current) => [
+                        ...current.filter((s) => s.windowId !== next.windowId),
+                        next,
+                    ]);
+                    return;
+                }
+                if (payload.kind === "unmount") {
+                    setSurfaces((current) => current.filter((s) => s.windowId !== payload.windowId));
+                }
+                // `a2ui` events carry agent-pushed view state. The view loads its
+                // initial state from its own entrypoint over the local agent, so the
+                // canvas does not need to forward the payload here.
+            },
+        });
+    }, []);
+    return surfaces;
+}

package/components/shell/usePromptSuggestions.d.ts

@@ -0,0 +1,39 @@
+import { type PageScope } from "../pages/page-scoped-conversations";
+import type { ShellMessage } from "./shell-state";
+/** Test-only: forget remembered/in-flight model sets so cases stay independent. */
+export declare function resetPromptSuggestionMemory(): void;
+/**
+ * Cache-key time bucket. Matches {@link timeOfDayLead}'s boundaries: the
+ * time-of-day dimension only exists to keep suggestions in step with the
+ * greeting, so the remembered set refreshes at the 3 daypart boundaries —
+ * not 24 times a day on every raw hour rollover.
+ */
+export declare function daypartForHour(hour: number): "morning" | "afternoon" | "evening";
+/**
+ * Pure computation (no React/network) so it can be unit-tested directly. Always
+ * returns exactly 3 unique prompt strings, order-stable. Used as the offline
+ * fallback and as the immediate value before the model set resolves.
+ */
+export declare function computePromptSuggestions(messages: readonly ShellMessage[], hour?: number): string[];
+/**
+ * Derive the active {@link PageScope} from the current location so the server
+ * can tailor suggestions per view. The shell navigates by path or hash
+ * (`/lifeops`, `#/lifeops?...`), so the first segment of whichever is present
+ * is the tab id; `page-<tab>` counts only when it's a registered scope. Pure
+ * for unit tests; returns undefined off-DOM or on unscoped views.
+ */
+export declare function pageScopeFromLocation(pathname: string, hash: string): PageScope | undefined;
+/**
+ * Hook: returns exactly 3 suggestions. Yields the static fallback immediately,
+ * then upgrades to the model-generated set once `POST /api/suggestions`
+ * resolves. The fetch starts only while `enabled` (the strip is actually
+ * visible), so the small model isn't invoked for a hidden strip. The set is
+ * stable for a given context — reopening the overlay reuses the remembered
+ * model set; only a new turn, a view change, the thread's first line, or a
+ * daypart boundary (morning/afternoon/evening) produces a fresh one.
+ */
+export declare function usePromptSuggestions(messages: readonly ShellMessage[], options?: {
+    enabled?: boolean;
+    scope?: PageScope;
+}): string[];
+//# sourceMappingURL=usePromptSuggestions.d.ts.map

package/components/shell/usePromptSuggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePromptSuggestions.d.ts","sourceRoot":"","sources":["../../../../../../src/components/shell/usePromptSuggestions.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AA4ElD,mFAAmF;AACnF,wBAAgB,2BAA2B,IAAI,IAAI,CAUlD;AA2BD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,WAAW,GAAG,SAAS,CAIrC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,EAAE,CAKV;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,SAAS,CASvB;AA6FD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GACjD,MAAM,EAAE,CAgDV"}