@hachej/boring-ask-user 0.1.64 → 0.1.65

package/dist/front/index.d.ts

@@ -1,7 +1,17 @@
+import * as _hachej_boring_workspace_plugin from '@hachej/boring-workspace/plugin';
 import { BoringFrontFactoryWithId } from '@hachej/boring-workspace/plugin';
+import { WorkspaceAttentionBlocker } from '@hachej/boring-workspace';
 
+declare const INBOX_DEMO_SESSION_ID = "showcase";
+declare function createInboxDemoBlockers(now?: number): WorkspaceAttentionBlocker[];
+declare const inboxDemoPlugin: _hachej_boring_workspace_plugin.BoringFrontFactoryWithId;
+
+interface CreateAskUserPluginOptions {
+    /** Register the workspace Inbox button/overlay in the app-left rail. */
+    appLeftInbox?: boolean;
+}
 /**
- * `BoringFrontFactoryWithId` for the ask-user plugin. Registers
+ * Creates a `BoringFrontFactoryWithId` for the ask-user plugin. Registers
  * (1) a provider that owns the per-app questions runtime (apiBaseUrl,
  * auth headers, in-memory pending-question store), (2) a "Questions"
  * panel rendering the pending question form, and (3) a surface
@@ -10,8 +20,10 @@ import { BoringFrontFactoryWithId } from '@hachej/boring-workspace/plugin';
  * Pass directly to `WorkspaceProvider.plugins`.
  *
  * The panel is opened via the surface resolver (kind: ASK_USER_SURFACE_KIND),
- * which is how the server-side agent tool triggers it.
+ * which is how the server-side agent tool triggers it. The app-left Inbox
+ * button is opt-in via `appLeftInbox`.
  */
+declare function createAskUserPlugin(options?: CreateAskUserPluginOptions): BoringFrontFactoryWithId;
 declare const askUserPlugin: BoringFrontFactoryWithId;
 
-export { askUserPlugin, askUserPlugin as default };
+export { type CreateAskUserPluginOptions, INBOX_DEMO_SESSION_ID, askUserPlugin, createAskUserPlugin, createInboxDemoBlockers, askUserPlugin as default, inboxDemoPlugin };

package/dist/front/index.js

@@ -4,13 +4,15 @@
 import { Button, EmptyState, Notice, Pane, PaneBody, PaneFooter, PaneHeader, PaneTitle } from "@hachej/boring-ui-kit";
 import {
   WORKSPACE_COMPOSER_STOP_EVENT as WORKSPACE_COMPOSER_STOP_EVENT2,
+  useWorkspaceAttention as useWorkspaceAttention4,
+  useWorkspaceContext,
   workspaceComposerStopAppliesToSession as workspaceComposerStopAppliesToSession2
 } from "@hachej/boring-workspace";
 import {
-  definePlugin
+  definePlugin as definePlugin2
 } from "@hachej/boring-workspace/plugin";
-import { HelpCircle, XCircle } from "lucide-react";
-import { useEffect as useEffect3, useMemo as useMemo2, useRef as useRef3, useSyncExternalStore, useState as useState2 } from "react";
+import { HelpCircle, Inbox as Inbox2, XCircle } from "lucide-react";
+import { useEffect as useEffect5, useMemo as useMemo4, useRef as useRef3, useSyncExternalStore, useState as useState3 } from "react";
 
 // src/shared/constants.ts
 var ASK_USER_PLUGIN_ID = "ask-user";
@@ -573,9 +575,18 @@ function useAskUserAttentionBlockers(runtime, pendingSnapshot) {
         reason: "ask-user.question",
         surfaceKind: ASK_USER_SURFACE_KIND,
         target: hint.questionId,
-        label: "Answer the question in Questions to continue",
+        label: hydrated?.title ?? "Answer the question in Questions to continue",
         sessionId: hint.sessionId,
         sessionBadge: { kind: "question", label: "question", tone: "attention", priority: 10 },
+        pruneWhenSessionMissing: true,
+        focus: { closeWorkbenchLeftPane: true },
+        inbox: {
+          kind: "question",
+          sourceLabel: "question",
+          createdAt: hydrated?.createdAt,
+          updatedAt: hydrated?.updatedAt ?? hydrated?.createdAt,
+          priority: 10
+        },
         actions
       });
     }
@@ -655,9 +666,8 @@ function useAskUserPendingRefresh(runtime, options) {
       const sessionsToHydrate = /* @__PURE__ */ new Set();
       if (activeSessionId) sessionsToHydrate.add(activeSessionId);
       for (const hint of hints) {
-        if (isSessionOpen(runtime, hint.sessionId)) sessionsToHydrate.add(hint.sessionId);
+        sessionsToHydrate.add(hint.sessionId);
       }
-      if (sessionsToHydrate.size === 0 && hints[0]) sessionsToHydrate.add(hints[0].sessionId);
       await Promise.all([...sessionsToHydrate].map(async (sessionId) => {
         try {
           await runtime.refreshPending(sessionId);
@@ -707,10 +717,454 @@ function hasPendingStateSlot(state) {
   return !!state && Object.prototype.hasOwnProperty.call(state, ASK_USER_UI_STATE_SLOTS.PENDING);
 }
 
-// src/front/index.tsx
+// src/front/inbox/InboxOverlay.tsx
+import { useCallback as useCallback2, useEffect as useEffect3, useMemo as useMemo3, useState as useState2 } from "react";
+import { Inbox, MailOpen, X } from "lucide-react";
+import { IconButton } from "@hachej/boring-ui-kit";
+import { emitWorkspaceAttentionAction, useWorkspaceAttention as useWorkspaceAttention2, useAppLeftOverlayChrome, cn as cn3 } from "@hachej/boring-workspace";
+
+// src/front/inbox/attentionBlockerAdapter.ts
+import { workspaceAttentionSessionBadgeForBlocker } from "@hachej/boring-workspace";
+var FALLBACK_TIMESTAMP = "1970-01-01T00:00:00.000Z";
+function dateValue(value) {
+  if (value === void 0 || value === null) return null;
+  const date = value instanceof Date ? value : new Date(value);
+  return Number.isNaN(date.getTime()) ? null : date.toISOString();
+}
+function blockerTimestamp(blocker) {
+  return dateValue(blocker.inbox?.updatedAt) ?? dateValue(blocker.inbox?.createdAt) ?? FALLBACK_TIMESTAMP;
+}
+function blockerKind(blocker) {
+  if (blocker.inbox?.kind) return blocker.inbox.kind;
+  const badge = workspaceAttentionSessionBadgeForBlocker(blocker);
+  if (badge?.kind === "question" || badge?.kind === "review" || badge?.kind === "approval" || badge?.kind === "notice") return badge.kind;
+  return "notice";
+}
+function blockerTitle(blocker) {
+  return blocker.label || blocker.reason || "Workspace item";
+}
+function blockerSourceLabel(blocker) {
+  return blocker.inbox?.sourceLabel ?? workspaceAttentionSessionBadgeForBlocker(blocker)?.label ?? "workspace";
+}
+function isInboxAttentionBlocker(blocker) {
+  return !!blocker.inbox;
+}
+function attentionBlockerToInboxItem(blocker) {
+  const updatedAt = blockerTimestamp(blocker);
+  return {
+    id: blocker.id,
+    kind: blockerKind(blocker),
+    status: "open",
+    title: blockerTitle(blocker),
+    description: blocker.reason,
+    source: { type: "plugin", pluginId: blocker.reason, label: blockerSourceLabel(blocker) },
+    sessionId: blocker.sessionId ?? null,
+    chatAvailable: blocker.pruneWhenSessionMissing === true && !!blocker.sessionId,
+    targetLabel: blocker.target ?? "",
+    artifact: blocker.surfaceKind ? {
+      type: "surface",
+      surfaceKind: blocker.surfaceKind,
+      target: blocker.target,
+      params: blocker.sessionId ? { sessionId: blocker.sessionId } : void 0
+    } : null,
+    createdAt: dateValue(blocker.inbox?.createdAt) ?? updatedAt,
+    updatedAt,
+    priority: blocker.inbox?.priority ?? workspaceAttentionSessionBadgeForBlocker(blocker)?.priority ?? 0,
+    actions: blocker.actions?.map((action) => ({ id: action.id, label: action.label })) ?? []
+  };
+}
+
+// src/front/inbox/InboxFilterBar.tsx
+import { cn } from "@hachej/boring-workspace";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function InboxFilterBar({
+  filter,
+  counts,
+  onFilterChange
+}) {
+  return /* @__PURE__ */ jsx2("div", { className: "flex shrink-0 gap-1 border-b border-border/60 bg-[color:oklch(from_var(--background)_calc(l-0.012)_c_h)] px-4 py-2", children: [
+    ["all", "All", counts.all],
+    ["questions", "Questions", counts.questions],
+    ["reviews", "Reviews", counts.reviews]
+  ].map(([id, label2, count]) => /* @__PURE__ */ jsxs2(
+    "button",
+    {
+      type: "button",
+      onClick: () => onFilterChange(id),
+      className: cn(
+        "rounded-full px-2.5 py-1 text-[11px] font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40",
+        filter === id ? "bg-[color:oklch(from_var(--accent)_l_c_h/0.14)] text-[color:var(--accent)]" : "bg-transparent text-muted-foreground hover:bg-foreground/[0.06] hover:text-foreground"
+      ),
+      children: [
+        label2,
+        " ",
+        /* @__PURE__ */ jsx2("span", { className: "ml-1 opacity-70", children: count })
+      ]
+    },
+    id
+  )) });
+}
+
+// src/front/inbox/InboxSection.tsx
+import { Pin } from "lucide-react";
+
+// src/front/inbox/InboxRow.tsx
+import { MessageSquare, Star } from "lucide-react";
+import { cn as cn2 } from "@hachej/boring-workspace";
+
+// src/front/inbox/inboxItemModel.ts
+function inboxItemDate(item) {
+  const date = new Date(item.updatedAt || item.createdAt);
+  return Number.isNaN(date.getTime()) ? /* @__PURE__ */ new Date(0) : date;
+}
+function formatInboxTime(item, now = Date.now()) {
+  const date = inboxItemDate(item);
+  const diff = now - date.getTime();
+  if (diff < 6e4) return "now";
+  const minutes = Math.floor(diff / 6e4);
+  if (minutes < 60) return `${minutes}m`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h`;
+  const days = Math.floor(hours / 24);
+  if (days < 7) return `${days}d`;
+  return date.toLocaleDateString(void 0, { month: "short", day: "numeric" });
+}
+function inboxItemSender(item) {
+  return item.source.label || item.source.type;
+}
+function filterInboxItems(items, filter) {
+  if (filter === "all") return [...items];
+  return items.filter((item) => filter === "questions" ? item.kind === "question" : item.kind === "review");
+}
+function sortInboxItems(items) {
+  return [...items].sort((a, b) => {
+    const byTime = inboxItemDate(b).getTime() - inboxItemDate(a).getTime();
+    if (byTime !== 0) return byTime;
+    const byPriority = b.priority - a.priority;
+    if (byPriority !== 0) return byPriority;
+    return a.title.localeCompare(b.title);
+  });
+}
+function mergeInboxPinnedState(items, pinnedIds) {
+  return items.map((item) => ({ ...item, pinned: pinnedIds.has(item.id) }));
+}
+
+// src/front/inbox/InboxRow.tsx
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function badgeTone(kind) {
+  switch (kind) {
+    case "review":
+      return "bg-amber-500/12 text-amber-700 dark:text-amber-300";
+    case "approval":
+      return "bg-emerald-500/12 text-emerald-700 dark:text-emerald-300";
+    case "notice":
+      return "bg-foreground/[0.07] text-muted-foreground";
+    default:
+      return "bg-[color:var(--accent)]/12 text-[color:var(--accent)]";
+  }
+}
+function InboxRow({
+  item,
+  onTogglePinned,
+  onOpenArtifact,
+  onOpenChat
+}) {
+  const subtitle = [item.sessionId ? `Session ${item.sessionId}` : null, item.targetLabel || null].filter(Boolean).join(" \xB7 ");
+  return /* @__PURE__ */ jsx3("li", { children: /* @__PURE__ */ jsxs3(
+    "div",
+    {
+      role: "button",
+      tabIndex: 0,
+      className: "group flex h-11 w-full items-center gap-2 overflow-hidden px-4 text-left text-[12px] transition-colors hover:bg-muted/60 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40",
+      onClick: () => onOpenArtifact(item),
+      onKeyDown: (event) => {
+        if (event.currentTarget !== event.target) return;
+        if (event.key !== "Enter" && event.key !== " ") return;
+        event.preventDefault();
+        onOpenArtifact(item);
+      },
+      children: [
+        /* @__PURE__ */ jsx3("span", { className: "size-2 shrink-0 rounded-full bg-[color:var(--accent)]" }),
+        /* @__PURE__ */ jsx3("span", { className: "max-w-28 shrink-0 truncate font-semibold text-foreground", children: inboxItemSender(item) }),
+        /* @__PURE__ */ jsxs3("span", { className: "flex min-w-0 flex-1 items-center gap-1 overflow-hidden whitespace-nowrap text-foreground", children: [
+          /* @__PURE__ */ jsx3("span", { className: "truncate font-medium", children: item.title }),
+          /* @__PURE__ */ jsx3("span", { className: "shrink-0 text-muted-foreground", children: "\u2014" }),
+          /* @__PURE__ */ jsx3("span", { className: "truncate text-muted-foreground", children: subtitle || item.description })
+        ] }),
+        /* @__PURE__ */ jsxs3("span", { className: "flex shrink-0 items-center gap-1.5", children: [
+          /* @__PURE__ */ jsx3("span", { className: cn2("rounded-full px-2 py-0.5 text-[10px] font-medium", badgeTone(item.kind)), children: item.kind }),
+          /* @__PURE__ */ jsx3("span", { className: "text-[11px] font-medium text-muted-foreground", title: inboxItemDate(item).toLocaleString(), children: formatInboxTime(item) })
+        ] }),
+        item.sessionId && item.chatAvailable ? /* @__PURE__ */ jsx3(
+          "button",
+          {
+            type: "button",
+            "aria-label": `Open chat session ${item.sessionId}`,
+            title: "Open chat session",
+            className: "grid size-6 shrink-0 place-items-center rounded-md text-muted-foreground opacity-0 transition-opacity hover:bg-foreground/[0.06] hover:text-foreground focus-visible:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40 group-hover:opacity-100 group-focus-visible:opacity-100",
+            onClick: (event) => {
+              event.stopPropagation();
+              onOpenChat(item);
+            },
+            children: /* @__PURE__ */ jsx3(MessageSquare, { className: "size-3.5", strokeWidth: 1.75 })
+          }
+        ) : null,
+        /* @__PURE__ */ jsx3(
+          "button",
+          {
+            type: "button",
+            "aria-label": `${item.pinned ? "Unpin" : "Pin"} ${item.title}`,
+            title: item.pinned ? "Unpin" : "Pin",
+            className: cn2(
+              "grid size-6 shrink-0 place-items-center rounded-md transition-colors hover:bg-foreground/[0.06] hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40",
+              item.pinned ? "text-[color:var(--accent)] opacity-100" : "text-muted-foreground opacity-0 group-hover:opacity-100 group-focus-visible:opacity-100"
+            ),
+            onClick: (event) => {
+              event.stopPropagation();
+              onTogglePinned(item.id);
+            },
+            children: /* @__PURE__ */ jsx3(Star, { className: cn2("size-3.5", item.pinned && "fill-current"), strokeWidth: 1.75 })
+          }
+        )
+      ]
+    }
+  ) });
+}
+
+// src/front/inbox/InboxSection.tsx
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+function InboxSection({
+  title,
+  items,
+  onTogglePinned,
+  onOpenArtifact,
+  onOpenChat
+}) {
+  if (items.length === 0) return null;
+  return /* @__PURE__ */ jsxs4("section", { className: "py-1", children: [
+    /* @__PURE__ */ jsxs4("div", { className: "flex items-center gap-1 px-4 pb-1 pt-2 text-[11px] font-semibold uppercase tracking-[0.14em] text-muted-foreground/70", children: [
+      title === "Pinned" ? /* @__PURE__ */ jsx4(Pin, { className: "size-3", strokeWidth: 1.75 }) : null,
+      title
+    ] }),
+    /* @__PURE__ */ jsx4("ul", { role: "list", className: "divide-y divide-border/60 bg-card/80", children: items.map((item) => /* @__PURE__ */ jsx4(
+      InboxRow,
+      {
+        item,
+        onTogglePinned,
+        onOpenArtifact,
+        onOpenChat
+      },
+      item.id
+    )) })
+  ] });
+}
+
+// src/front/inbox/WorkspaceInboxShellContext.tsx
+import { useMemo as useMemo2 } from "react";
+import { useWorkspaceShellCapabilities } from "@hachej/boring-workspace";
+function useWorkspaceInboxShell() {
+  const shell = useWorkspaceShellCapabilities();
+  return useMemo2(() => ({
+    openInboxArtifact: (item) => shell.openArtifact(item.artifact, {
+      // Row clicks open the workspace artifact/question only. The explicit chat
+      // icon owns chat opening; otherwise ask-user inbox rows jump to chat
+      // instead of showing the Questions form.
+      sessionId: null,
+      title: item.title,
+      instanceId: item.id
+    }),
+    openDetachedChat: shell.openDetachedChat
+  }), [shell]);
+}
+
+// src/front/inbox/InboxOverlay.tsx
+import { Fragment as Fragment2, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
+function readPinnedIds(storageKey) {
+  if (!storageKey) return /* @__PURE__ */ new Set();
+  try {
+    const raw = globalThis.localStorage?.getItem(storageKey);
+    const parsed = raw ? JSON.parse(raw) : null;
+    return new Set(Array.isArray(parsed?.ids) ? parsed.ids.filter((id) => typeof id === "string" && id.length > 0) : []);
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+}
+function writePinnedIds(storageKey, ids) {
+  if (!storageKey) return;
+  try {
+    const values = Array.from(ids);
+    if (values.length === 0) globalThis.localStorage?.removeItem(storageKey);
+    else globalThis.localStorage?.setItem(storageKey, JSON.stringify({ ids: values }));
+  } catch {
+  }
+}
+function InboxOverlay({ onClose, pinStorageKey }) {
+  const { headerInsetStart, headerInsetEnd } = useAppLeftOverlayChrome();
+  const { blockers } = useWorkspaceAttention2();
+  const shell = useWorkspaceInboxShell();
+  const [filter, setFilter] = useState2("all");
+  const [shellError, setShellError] = useState2(null);
+  const [selectedItemId, setSelectedItemId] = useState2(null);
+  const [pinnedIds, setPinnedIds] = useState2(() => readPinnedIds(pinStorageKey));
+  useEffect3(() => {
+    setPinnedIds(readPinnedIds(pinStorageKey));
+  }, [pinStorageKey]);
+  const sorted = useMemo3(() => sortInboxItems(blockers.filter(isInboxAttentionBlocker).map(attentionBlockerToInboxItem)), [blockers]);
+  const filtered = useMemo3(() => filterInboxItems(sorted, filter), [filter, sorted]);
+  const items = useMemo3(() => mergeInboxPinnedState(filtered, pinnedIds), [filtered, pinnedIds]);
+  const pinnedItems = useMemo3(() => items.filter((item) => item.pinned), [items]);
+  const unpinnedItems = useMemo3(() => items.filter((item) => !item.pinned), [items]);
+  const selectedItem = useMemo3(() => items.find((item) => item.id === selectedItemId) ?? null, [items, selectedItemId]);
+  const selectedBlocker = useMemo3(() => selectedItem ? blockers.find((blocker) => blocker.id === selectedItem.id) : void 0, [blockers, selectedItem]);
+  const counts = useMemo3(() => ({
+    all: sorted.length,
+    questions: filterInboxItems(sorted, "questions").length,
+    reviews: filterInboxItems(sorted, "reviews").length
+  }), [sorted]);
+  const togglePinned = useCallback2((id) => {
+    setPinnedIds((current) => {
+      const next = new Set(current);
+      if (next.has(id)) next.delete(id);
+      else next.add(id);
+      writePinnedIds(pinStorageKey, next);
+      return next;
+    });
+  }, [pinStorageKey]);
+  const handleShellResult = useCallback2((result) => {
+    setShellError(result.success ? null : result.message);
+  }, []);
+  const openArtifact = useCallback2((item) => {
+    if (!item.artifact) {
+      setSelectedItemId(item.id);
+      setShellError(null);
+      return;
+    }
+    const result = shell.openInboxArtifact(item);
+    handleShellResult(result);
+    setSelectedItemId(result.success ? null : item.id);
+  }, [handleShellResult, shell]);
+  const openChat = useCallback2((item) => {
+    if (!item.sessionId) return;
+    handleShellResult(shell.openDetachedChat(item.sessionId, { title: item.title }));
+  }, [handleShellResult, shell]);
+  const handleDetailAction = useCallback2((actionId) => {
+    if (!selectedItem || !selectedBlocker) return;
+    emitWorkspaceAttentionAction({ blockerId: selectedBlocker.id, actionId, blocker: selectedBlocker, sessionId: selectedItem.sessionId ?? void 0 });
+    if (actionId === "open") {
+      if (selectedItem.artifact) openArtifact(selectedItem);
+      else setShellError("This inbox item has no artifact target.");
+    }
+  }, [openArtifact, selectedBlocker, selectedItem]);
+  return /* @__PURE__ */ jsxs5("div", { "data-boring-workspace-part": "inbox-overlay", className: "flex h-full min-h-0 flex-col bg-background", children: [
+    /* @__PURE__ */ jsxs5("header", { className: cn3(
+      "flex h-12 shrink-0 items-center justify-between border-b border-border/60",
+      headerInsetStart ? "pl-12" : "pl-4",
+      headerInsetEnd ? "pr-16" : "pr-4"
+    ), children: [
+      /* @__PURE__ */ jsxs5("div", { className: "flex min-w-0 items-center gap-2", children: [
+        /* @__PURE__ */ jsx5("span", { className: "grid size-7 place-items-center rounded-lg bg-[color:oklch(from_var(--accent)_l_c_h/0.14)] text-[color:var(--accent)]", children: /* @__PURE__ */ jsx5(Inbox, { className: "h-4 w-4", strokeWidth: 1.75, "aria-hidden": "true" }) }),
+        /* @__PURE__ */ jsxs5("div", { className: "min-w-0", children: [
+          /* @__PURE__ */ jsx5("h2", { className: "truncate text-sm font-semibold tracking-tight text-foreground", children: "Inbox" }),
+          /* @__PURE__ */ jsx5("p", { className: "truncate text-xs text-muted-foreground", children: "Questions, reviews, and owner decisions" })
+        ] })
+      ] }),
+      /* @__PURE__ */ jsx5("div", { className: "flex shrink-0 items-center gap-0.5", children: /* @__PURE__ */ jsx5(IconButton, { type: "button", variant: "ghost", size: "icon-xs", onClick: onClose, "aria-label": "Close inbox", title: "Close", className: "text-muted-foreground hover:text-foreground", children: /* @__PURE__ */ jsx5(X, { className: "size-3", strokeWidth: 1.75 }) }) })
+    ] }),
+    /* @__PURE__ */ jsx5(InboxFilterBar, { filter, counts, onFilterChange: setFilter }),
+    shellError ? /* @__PURE__ */ jsx5("div", { className: "border-b border-border/60 bg-destructive/10 px-4 py-2 text-xs text-destructive", children: shellError }) : null,
+    selectedItem ? /* @__PURE__ */ jsxs5("div", { className: "border-b border-border/60 bg-background px-4 py-3 text-xs", children: [
+      /* @__PURE__ */ jsxs5("div", { className: "flex items-start justify-between gap-3", children: [
+        /* @__PURE__ */ jsxs5("div", { className: "min-w-0", children: [
+          /* @__PURE__ */ jsx5("div", { className: "truncate font-medium text-foreground", children: selectedItem.title }),
+          /* @__PURE__ */ jsx5("div", { className: "mt-1 line-clamp-2 text-muted-foreground", children: selectedItem.description })
+        ] }),
+        /* @__PURE__ */ jsx5("button", { type: "button", className: "shrink-0 text-muted-foreground hover:text-foreground", onClick: () => setSelectedItemId(null), children: "Close" })
+      ] }),
+      selectedItem.actions.length > 0 && selectedBlocker ? /* @__PURE__ */ jsx5("div", { className: "mt-3 flex flex-wrap gap-1.5", children: selectedItem.actions.map((action) => /* @__PURE__ */ jsx5(
+        "button",
+        {
+          type: "button",
+          className: "rounded-md border border-border/80 bg-background px-2 py-1 text-[11px] font-medium hover:bg-muted/60",
+          onClick: () => handleDetailAction(action.id),
+          children: action.label
+        },
+        action.id
+      )) }) : null
+    ] }) : null,
+    /* @__PURE__ */ jsx5("div", { className: "boring-scrollbar-discreet min-h-0 flex-1 overflow-y-auto bg-[color:oklch(from_var(--background)_calc(l-0.012)_c_h)] py-2", "aria-live": "polite", children: items.length === 0 ? /* @__PURE__ */ jsx5("div", { className: "flex h-full min-h-[180px] items-center justify-center px-6 text-center text-sm text-muted-foreground", children: /* @__PURE__ */ jsxs5("div", { children: [
+      /* @__PURE__ */ jsx5(MailOpen, { className: "mx-auto mb-3 size-8 text-muted-foreground/70", strokeWidth: 1.75 }),
+      /* @__PURE__ */ jsx5("div", { className: "font-medium text-foreground/80", children: "Inbox zero" }),
+      /* @__PURE__ */ jsx5("p", { className: "mt-1 max-w-xs", children: "When plugins or external harnesses ask for a decision, it appears here." })
+    ] }) }) : /* @__PURE__ */ jsxs5(Fragment2, { children: [
+      /* @__PURE__ */ jsx5(InboxSection, { title: "Pinned", items: pinnedItems, onTogglePinned: togglePinned, onOpenArtifact: openArtifact, onOpenChat: openChat }),
+      /* @__PURE__ */ jsx5(InboxSection, { title: "Inbox", items: unpinnedItems, onTogglePinned: togglePinned, onOpenArtifact: openArtifact, onOpenChat: openChat })
+    ] }) })
+  ] });
+}
+
+// src/front/inbox/examples/inboxDemoPlugin.tsx
+import { useEffect as useEffect4 } from "react";
+import { WORKSPACE_OPEN_PATH_SURFACE_KIND, useWorkspaceAttention as useWorkspaceAttention3 } from "@hachej/boring-workspace";
+import { definePlugin } from "@hachej/boring-workspace/plugin";
+var INBOX_DEMO_SESSION_ID = "showcase";
+function createInboxDemoBlockers(now = Date.now()) {
+  return [
+    {
+      id: "demo-question-deploy",
+      reason: "ask-user.question",
+      label: "Pick the deploy target for the release smoke",
+      sessionId: INBOX_DEMO_SESSION_ID,
+      pruneWhenSessionMissing: true,
+      target: "README.md",
+      surfaceKind: WORKSPACE_OPEN_PATH_SURFACE_KIND,
+      inbox: {
+        kind: "question",
+        sourceLabel: "question",
+        createdAt: now - 4 * 6e4,
+        priority: 10
+      },
+      sessionBadge: { kind: "question", label: "question", tone: "attention", priority: 10 },
+      actions: [{ id: "answer", label: "Answer" }, { id: "dismiss", label: "Dismiss" }]
+    },
+    {
+      id: "demo-review-ui",
+      reason: "external-review.request",
+      label: "Review Codex notes on workspace inbox flow",
+      sessionId: "codex-42",
+      target: "analysis.py",
+      surfaceKind: WORKSPACE_OPEN_PATH_SURFACE_KIND,
+      inbox: {
+        kind: "review",
+        sourceLabel: "review",
+        createdAt: now - 2 * 60 * 6e4,
+        priority: 8
+      },
+      sessionBadge: { kind: "review", label: "review", tone: "warning", priority: 8 },
+      actions: [{ id: "open", label: "Open review" }]
+    }
+  ];
+}
+function InboxDemoAttentionSeed() {
+  const { addBlocker, removeBlocker } = useWorkspaceAttention3();
+  useEffect4(() => {
+    const blockers = createInboxDemoBlockers();
+    for (const blocker of blockers) addBlocker(blocker);
+    return () => blockers.forEach((blocker) => removeBlocker(blocker.id));
+  }, [addBlocker, removeBlocker]);
+  return null;
+}
+var inboxDemoPlugin = definePlugin({
+  id: "inbox-demo-playground",
+  label: "Inbox Demo Playground",
+  setup(api) {
+    api.registerBinding({ id: "inbox-demo-attention-seed", component: InboxDemoAttentionSeed });
+  }
+});
+
+// src/front/index.tsx
+import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
 function AskUserProvider({ apiBaseUrl, authHeaders, activeSessionId, openSessionIds, children }) {
-  const runtime = useMemo2(() => ({
+  const runtime = useMemo4(() => ({
     ...sharedQuestionsStore,
     apiBaseUrl,
     authHeaders,
@@ -728,11 +1182,14 @@ function AskUserProvider({ apiBaseUrl, authHeaders, activeSessionId, openSession
   useAskUserAttentionActions(runtime);
   useAskUserComposerStopCancel(runtime);
   useAskUserPendingRefresh(runtime, { activeSessionId, apiBaseUrl, authHeaders });
-  return /* @__PURE__ */ jsx2(QuestionsRuntimeContext.Provider, { value: runtime, children });
+  return /* @__PURE__ */ jsx6(QuestionsRuntimeContext.Provider, { value: runtime, children });
 }
 function paneQuestionSessionId(runtime, params) {
   const activeSessionId = runtime.activeSessionId ?? null;
   if (activeSessionId && isPaneSessionVisible(runtime, activeSessionId) && hasReadyQuestion(runtime, activeSessionId)) return activeSessionId;
+  if (params?.sessionId && hasReadyQuestion(runtime, params.sessionId)) return params.sessionId;
+  const hintedSessionId = runtime.getPendingHints().find((hint) => !hint.status || hint.status === "ready")?.sessionId;
+  if (hintedSessionId) return hintedSessionId;
   if (params?.sessionId && isPaneSessionVisible(runtime, params.sessionId)) return params.sessionId;
   return activeSessionId && isPaneSessionVisible(runtime, activeSessionId) ? activeSessionId : null;
 }
@@ -747,23 +1204,46 @@ function hasReadyQuestion(runtime, sessionId) {
   if (pending?.status === "ready") return true;
   return runtime.getPendingHints().some((hint) => hint.sessionId === sessionId && (!hint.status || hint.status === "ready"));
 }
+function InboxCountBadge() {
+  const { blockers } = useWorkspaceAttention4();
+  const count = blockers.filter(isInboxAttentionBlocker).length;
+  if (count === 0) return null;
+  const label2 = count > 99 ? "99+" : String(count);
+  return /* @__PURE__ */ jsx6(
+    "span",
+    {
+      "data-boring-workspace-part": "app-left-inbox-count",
+      "aria-label": `${count} inbox item${count === 1 ? "" : "s"}`,
+      className: "inline-flex min-w-5 items-center justify-center rounded-full bg-[color:var(--accent)] px-1.5 py-0.5 text-[10px] font-semibold leading-none text-white shadow-sm",
+      children: label2
+    }
+  );
+}
+function AskUserInboxOverlay({ onClose }) {
+  const { workspaceId } = useWorkspaceContext();
+  return /* @__PURE__ */ jsx6(InboxOverlay, { onClose, pinStorageKey: `boring-workspace:inbox-pins:${workspaceId ?? "workspace"}` });
+}
 function QuestionsPane({ api, params, className }) {
   const runtime = useQuestionsRuntime();
+  useSyncExternalStore(runtime.subscribe, () => pendingQuestionSnapshot(runtime), () => "none");
   const paneSessionId = paneQuestionSessionId(runtime, params);
   const pending = useSyncExternalStore(runtime.subscribe, () => runtime.getPending(paneSessionId), () => runtime.getPending(paneSessionId));
-  const [closedQuestionId, setClosedQuestionId] = useState2(null);
+  const [closedQuestionId, setClosedQuestionId] = useState3(null);
   const retargetRefreshRef = useRef3(null);
-  const [error, setError] = useState2(null);
-  const [submitting, setSubmitting] = useState2(false);
+  const [error, setError] = useState3(null);
+  const [submitting, setSubmitting] = useState3(false);
   const question = pending?.questionId === closedQuestionId ? null : pending;
-  const client = useMemo2(() => createQuestionsClient({ apiBaseUrl: runtime.apiBaseUrl, headers: runtime.authHeaders }), [runtime.apiBaseUrl, runtime.authHeaders]);
-  useEffect3(() => {
+  const client = useMemo4(() => createQuestionsClient({ apiBaseUrl: runtime.apiBaseUrl, headers: runtime.authHeaders }), [runtime.apiBaseUrl, runtime.authHeaders]);
+  useEffect5(() => {
     if (!params?.sessionId || !isPaneSessionKnownHidden(runtime, params.sessionId)) return;
+    if (hasReadyQuestion(runtime, params.sessionId)) return;
+    const hints = runtime.getPendingHints();
+    if (hints.length === 0) return;
     const activeSessionId = runtime.activeSessionId ?? null;
     const canShowActiveQuestion = activeSessionId && isPaneSessionVisible(runtime, activeSessionId) && hasReadyQuestion(runtime, activeSessionId);
     if (!canShowActiveQuestion) api.close();
   }, [api, params?.sessionId, runtime]);
-  useEffect3(() => {
+  useEffect5(() => {
     const onStop = (event) => {
       const detail = event.detail;
       if (!question || !workspaceComposerStopAppliesToSession2(detail, question.sessionId)) return;
@@ -774,7 +1254,7 @@ function QuestionsPane({ api, params, className }) {
     window.addEventListener(WORKSPACE_COMPOSER_STOP_EVENT2, onStop);
     return () => window.removeEventListener(WORKSPACE_COMPOSER_STOP_EVENT2, onStop);
   }, [api, question, runtime]);
-  useEffect3(() => {
+  useEffect5(() => {
     if (!paneSessionId) return;
     const targetQuestionId = params?.questionId;
     if (!pending) {
@@ -791,13 +1271,13 @@ function QuestionsPane({ api, params, className }) {
     retargetRefreshRef.current = refreshKey;
     void runtime.refreshPending(paneSessionId).catch(() => void 0);
   }, [paneSessionId, params?.questionId, pending, runtime]);
-  return /* @__PURE__ */ jsx2("div", { className: className ? `${className} min-h-0 overflow-hidden` : "h-full min-h-0 overflow-hidden", children: /* @__PURE__ */ jsxs2(Pane, { className: "h-full min-h-0 overflow-hidden border-0 bg-background text-sm", children: [
-    /* @__PURE__ */ jsx2(PaneHeader, { className: "border-b bg-background/95", children: /* @__PURE__ */ jsx2("div", { children: /* @__PURE__ */ jsxs2(PaneTitle, { className: "flex items-center gap-2", children: [
-      /* @__PURE__ */ jsx2(HelpCircle, { className: "h-4 w-4 text-muted-foreground" }),
+  return /* @__PURE__ */ jsx6("div", { className: className ? `${className} min-h-0 overflow-hidden` : "h-full min-h-0 overflow-hidden", children: /* @__PURE__ */ jsxs6(Pane, { className: "h-full min-h-0 overflow-hidden border-0 bg-background text-sm", children: [
+    /* @__PURE__ */ jsx6(PaneHeader, { className: "border-b bg-background/95", children: /* @__PURE__ */ jsx6("div", { children: /* @__PURE__ */ jsxs6(PaneTitle, { className: "flex items-center gap-2", children: [
+      /* @__PURE__ */ jsx6(HelpCircle, { className: "h-4 w-4 text-muted-foreground" }),
       " Agent needs input"
     ] }) }) }),
-    !question ? /* @__PURE__ */ jsx2(PaneBody, { className: "overflow-auto p-4", children: /* @__PURE__ */ jsx2(EmptyState, { icon: /* @__PURE__ */ jsx2(HelpCircle, { className: "h-5 w-5" }), title: "No pending questions", description: "When the agent needs a decision, the form will appear here.", className: "border border-dashed bg-muted/20" }) }) : null,
-    question?.status === "ready" && question.schema ? /* @__PURE__ */ jsx2(QuestionFormProvider, { schema: question.schema, submitting, onSubmit: async (values) => {
+    !question ? /* @__PURE__ */ jsx6(PaneBody, { className: "overflow-auto p-4", children: /* @__PURE__ */ jsx6(EmptyState, { icon: /* @__PURE__ */ jsx6(HelpCircle, { className: "h-5 w-5" }), title: "No pending questions", description: "When the agent needs a decision, the form will appear here.", className: "border border-dashed bg-muted/20" }) }) : null,
+    question?.status === "ready" && question.schema ? /* @__PURE__ */ jsx6(QuestionFormProvider, { schema: question.schema, submitting, onSubmit: async (values) => {
       setSubmitting(true);
       setError(null);
       try {
@@ -825,72 +1305,89 @@ function QuestionsPane({ api, params, className }) {
       } finally {
         setSubmitting(false);
       }
-    }, children: /* @__PURE__ */ jsxs2(QuestionForm, { className: "flex min-h-0 flex-1 flex-col", children: [
-      /* @__PURE__ */ jsx2(PaneBody, { className: "overflow-auto p-4", children: /* @__PURE__ */ jsxs2("div", { className: "space-y-4", children: [
-        /* @__PURE__ */ jsxs2("section", { className: "rounded-md border border-border/60 bg-muted/30 p-4", children: [
-          /* @__PURE__ */ jsx2("div", { className: "text-xs font-medium uppercase tracking-wide text-muted-foreground", children: "Waiting for answer" }),
-          /* @__PURE__ */ jsx2("h2", { className: "mt-2 text-balance text-sm font-semibold leading-5 text-foreground", children: question.title ?? "Question" }),
-          question.context ? /* @__PURE__ */ jsx2("p", { className: "mt-2 max-w-prose text-sm leading-6 text-muted-foreground", children: question.context }) : null
+    }, children: /* @__PURE__ */ jsxs6(QuestionForm, { className: "flex min-h-0 flex-1 flex-col", children: [
+      /* @__PURE__ */ jsx6(PaneBody, { className: "overflow-auto p-4", children: /* @__PURE__ */ jsxs6("div", { className: "space-y-4", children: [
+        /* @__PURE__ */ jsxs6("section", { className: "rounded-md border border-border/60 bg-muted/30 p-4", children: [
+          /* @__PURE__ */ jsx6("div", { className: "text-xs font-medium uppercase tracking-wide text-muted-foreground", children: "Waiting for answer" }),
+          /* @__PURE__ */ jsx6("h2", { className: "mt-2 text-balance text-sm font-semibold leading-5 text-foreground", children: question.title ?? "Question" }),
+          question.context ? /* @__PURE__ */ jsx6("p", { className: "mt-2 max-w-prose text-sm leading-6 text-muted-foreground", children: question.context }) : null
         ] }),
-        /* @__PURE__ */ jsx2("div", { className: "space-y-4", children: /* @__PURE__ */ jsx2(QuestionFields, {}) }),
-        error ? /* @__PURE__ */ jsx2(Notice, { tone: "destructive", role: "alert", children: error }) : null
+        /* @__PURE__ */ jsx6("div", { className: "space-y-4", children: /* @__PURE__ */ jsx6(QuestionFields, {}) }),
+        error ? /* @__PURE__ */ jsx6(Notice, { tone: "destructive", role: "alert", children: error }) : null
       ] }) }),
-      /* @__PURE__ */ jsxs2(PaneFooter, { className: "justify-between border-t bg-background px-4 py-3", children: [
-        /* @__PURE__ */ jsx2("p", { className: "min-w-0 text-xs text-muted-foreground", children: "Sends answers and closes the pane." }),
-        /* @__PURE__ */ jsxs2("div", { className: "flex gap-2", children: [
-          /* @__PURE__ */ jsx2(Button, { asChild: true, variant: "outline", size: "sm", children: /* @__PURE__ */ jsx2(QuestionCancelButton, { children: "Cancel" }) }),
-          /* @__PURE__ */ jsx2(Button, { asChild: true, size: "sm", children: /* @__PURE__ */ jsx2(QuestionSubmitButton, { children: question.schema.submitLabel ?? "Send answers" }) })
+      /* @__PURE__ */ jsxs6(PaneFooter, { className: "justify-between border-t bg-background px-4 py-3", children: [
+        /* @__PURE__ */ jsx6("p", { className: "min-w-0 text-xs text-muted-foreground", children: "Sends answers and closes the pane." }),
+        /* @__PURE__ */ jsxs6("div", { className: "flex gap-2", children: [
+          /* @__PURE__ */ jsx6(Button, { asChild: true, variant: "outline", size: "sm", children: /* @__PURE__ */ jsx6(QuestionCancelButton, { children: "Cancel" }) }),
+          /* @__PURE__ */ jsx6(Button, { asChild: true, size: "sm", children: /* @__PURE__ */ jsx6(QuestionSubmitButton, { children: question.schema.submitLabel ?? "Send answers" }) })
         ] })
       ] })
     ] }) }, question.questionId) : null,
-    question && question.status !== "ready" ? /* @__PURE__ */ jsx2(PaneBody, { className: "p-5", children: /* @__PURE__ */ jsx2(Notice, { children: /* @__PURE__ */ jsxs2("span", { className: "flex items-center gap-2", children: [
-      /* @__PURE__ */ jsx2(XCircle, { className: "h-4 w-4 text-muted-foreground" }),
+    question && question.status !== "ready" ? /* @__PURE__ */ jsx6(PaneBody, { className: "p-5", children: /* @__PURE__ */ jsx6(Notice, { children: /* @__PURE__ */ jsxs6("span", { className: "flex items-center gap-2", children: [
+      /* @__PURE__ */ jsx6(XCircle, { className: "h-4 w-4 text-muted-foreground" }),
       "Question ",
       question.status
     ] }) }) }) : null
   ] }) });
 }
-var askUserPlugin = definePlugin({
-  id: ASK_USER_PLUGIN_ID,
-  label: ASK_USER_PANEL_TITLE,
-  providers: [
-    {
-      id: `${ASK_USER_PLUGIN_ID}.provider`,
-      component: AskUserProvider
-    }
-  ],
-  panels: [
-    {
-      id: ASK_USER_PANEL_ID,
-      label: ASK_USER_PANEL_TITLE,
-      icon: HelpCircle,
-      component: QuestionsPane,
-      placement: "center",
-      source: "builtin",
-      chromeless: true
-    }
-  ],
-  surfaceResolvers: [
-    {
-      id: `${ASK_USER_PLUGIN_ID}.surface`,
-      kind: ASK_USER_SURFACE_KIND,
-      source: "builtin",
-      // No inner kind guard — the workspace's surface registry already
-      // pre-filters by the top-level `kind` field before calling resolve.
-      resolve(request) {
-        const sessionId = typeof request.meta === "object" && request.meta && typeof request.meta.sessionId === "string" ? request.meta.sessionId : void 0;
-        return {
-          component: ASK_USER_PANEL_ID,
-          id: ASK_USER_PANEL_ID,
-          title: ASK_USER_PANEL_TITLE,
-          params: { questionId: request.target, sessionId }
-        };
+function createAskUserPlugin(options = {}) {
+  return definePlugin2({
+    id: ASK_USER_PLUGIN_ID,
+    label: ASK_USER_PANEL_TITLE,
+    providers: [
+      {
+        id: `${ASK_USER_PLUGIN_ID}.provider`,
+        component: AskUserProvider
       }
-    }
-  ]
-});
+    ],
+    panels: [
+      {
+        id: ASK_USER_PANEL_ID,
+        label: ASK_USER_PANEL_TITLE,
+        icon: HelpCircle,
+        component: QuestionsPane,
+        placement: "center",
+        source: "builtin",
+        chromeless: true
+      }
+    ],
+    appLeftActions: options.appLeftInbox ? [
+      {
+        id: "inbox",
+        label: "Inbox",
+        icon: Inbox2,
+        trailing: InboxCountBadge,
+        overlay: AskUserInboxOverlay,
+        order: 10
+      }
+    ] : [],
+    surfaceResolvers: [
+      {
+        id: `${ASK_USER_PLUGIN_ID}.surface`,
+        kind: ASK_USER_SURFACE_KIND,
+        source: "builtin",
+        // No inner kind guard — the workspace's surface registry already
+        // pre-filters by the top-level `kind` field before calling resolve.
+        resolve(request) {
+          const sessionId = typeof request.meta === "object" && request.meta && typeof request.meta.sessionId === "string" ? request.meta.sessionId : void 0;
+          return {
+            component: ASK_USER_PANEL_ID,
+            id: ASK_USER_PANEL_ID,
+            title: ASK_USER_PANEL_TITLE,
+            params: { questionId: request.target, sessionId }
+          };
+        }
+      }
+    ]
+  });
+}
+var askUserPlugin = createAskUserPlugin();
 var front_default = askUserPlugin;
 export {
+  INBOX_DEMO_SESSION_ID,
   askUserPlugin,
-  front_default as default
+  createAskUserPlugin,
+  createInboxDemoBlockers,
+  front_default as default,
+  inboxDemoPlugin
 };

package/dist/server/index.js

@@ -358,6 +358,7 @@ var AskUserRuntime = class {
   }
   async ask(request, signal) {
     const ownerPrincipalId = request.ownerPrincipalId ?? this.ownerPrincipalId;
+    await this.abandonOrphanedPending([request.sessionId]);
     this.assertAllowed(request.sessionId, ownerPrincipalId);
     const question = this.createQuestion({ ...request, ownerPrincipalId });
     const parsed = AskUserFormSchemaSchema.safeParse(request.schema);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-ask-user",
-  "version": "0.1.64",
+  "version": "0.1.65",
   "type": "module",
   "private": false,
   "license": "MIT",
@@ -46,28 +46,28 @@
     "fastify": "^5.3.3",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
-    "@hachej/boring-workspace": "0.1.64"
+    "@hachej/boring-workspace": "0.1.65"
   },
   "dependencies": {
-    "lucide-react": "^1.8.0",
+    "lucide-react": "^1.21.0",
     "zod": "^3.23.0",
-    "@hachej/boring-ui-kit": "0.1.64"
+    "@hachej/boring-ui-kit": "0.1.65"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.0",
-    "@types/node": "^22.0.0",
-    "@types/react": "^19.0.0",
+    "@types/node": "^22.20.0",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.0.0",
     "@vitejs/plugin-react": "^4.0.0",
-    "fastify": "^5.3.3",
-    "jsdom": "^29.0.2",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
+    "fastify": "^5.9.0",
+    "jsdom": "^29.1.1",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tsup": "^8.4.0",
-    "typescript": "~5.9.3",
-    "vitest": "^3.2.6",
-    "@hachej/boring-workspace": "0.1.64"
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.9",
+    "@hachej/boring-workspace": "0.1.65"
   },
   "peerDependenciesMeta": {
     "fastify": {