@stigmer/react 3.7.0 → 3.8.0

package/conversation/ConversationAttentionBanner.d.ts

@@ -0,0 +1,22 @@
+import type { ChannelConversation } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import type { UseConversationParticipationReturn } from "./useConversationParticipation.js";
+/** Props for {@link ConversationAttentionBanner}. */
+export interface ConversationAttentionBannerProps {
+    /** The conversation's fresh participation state. */
+    readonly conversation: ChannelConversation;
+    /** The participation commands (from `useConversationParticipation`). */
+    readonly participation: UseConversationParticipationReturn;
+    /** Additional classes for the banner container. */
+    readonly className?: string;
+}
+/**
+ * The needs-attention banner (channel-conversations DD-008): the
+ * escalating agent's reason, verbatim, with the false-alarm dismissal.
+ *
+ * Dismiss is `clearAttention` — attention clears in place and control
+ * never moves (taking over also clears it, structurally, because the
+ * human arriving IS the answer to an escalation). Renders nothing while
+ * the conversation is unflagged.
+ */
+export declare function ConversationAttentionBanner({ conversation, participation, className, }: ConversationAttentionBannerProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=ConversationAttentionBanner.d.ts.map

package/conversation/ConversationAttentionBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationAttentionBanner.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationAttentionBanner.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uEAAuE,CAAC;AAEjH,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,mCAAmC,CAAC;AAE5F,qDAAqD;AACrD,MAAM,WAAW,gCAAgC;IAC/C,oDAAoD;IACpD,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,kCAAkC,CAAC;IAC3D,mDAAmD;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,YAAY,EACZ,aAAa,EACb,SAAS,GACV,EAAE,gCAAgC,kDA4ClC"}

package/conversation/ConversationAttentionBanner.js

@@ -0,0 +1,25 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { TriangleAlert } from "lucide-react";
+import { cn } from "@stigmer/theme";
+import { getUserMessage } from "@stigmer/sdk";
+import { Button } from "../button/Button.js";
+/**
+ * The needs-attention banner (channel-conversations DD-008): the
+ * escalating agent's reason, verbatim, with the false-alarm dismissal.
+ *
+ * Dismiss is `clearAttention` — attention clears in place and control
+ * never moves (taking over also clears it, structurally, because the
+ * human arriving IS the answer to an escalation). Renders nothing while
+ * the conversation is unflagged.
+ */
+export function ConversationAttentionBanner({ conversation, participation, className, }) {
+    if (!conversation.needsAttention)
+        return null;
+    const { clearAttention, pendingCommands, commandErrors } = participation;
+    const error = commandErrors.get("clearAttention");
+    return (_jsxs("div", { className: cn("border-b border-border bg-destructive-subtle px-4 py-2", className), role: "status", children: [_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-2", children: [_jsxs("p", { className: "flex min-w-0 items-start gap-1.5 text-sm text-destructive", children: [_jsx(TriangleAlert, { "aria-hidden": "true", className: "mt-0.5 size-4 shrink-0" }), _jsxs("span", { className: "min-w-0 break-words", children: ["The agent asked for a human", conversation.attentionReason ? (_jsxs(_Fragment, { children: [" \u2014 \u201C", conversation.attentionReason, "\u201D"] })) : (".")] })] }), _jsx(Button, { variant: "outline", size: "xs", onClick: () => void clearAttention().catch(() => {
+                            // Recorded in commandErrors and rendered below.
+                        }), disabled: pendingCommands.has("clearAttention"), children: pendingCommands.has("clearAttention") ? "Dismissing…" : "Dismiss" })] }), error && (_jsx("p", { className: "mt-1 text-xs text-destructive", children: getUserMessage(error) }))] }));
+}
+//# sourceMappingURL=ConversationAttentionBanner.js.map

package/conversation/ConversationAttentionBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationAttentionBanner.js","sourceRoot":"","sources":["../../src/conversation/ConversationAttentionBanner.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAa7C;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CAAC,EAC1C,YAAY,EACZ,aAAa,EACb,SAAS,GACwB;IACjC,IAAI,CAAC,YAAY,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,aAAa,CAAC;IACzE,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAElD,OAAO,CACL,eACE,SAAS,EAAE,EAAE,CACX,wDAAwD,EACxD,SAAS,CACV,EACD,IAAI,EAAC,QAAQ,aAEb,eAAK,SAAS,EAAC,mDAAmD,aAChE,aAAG,SAAS,EAAC,2DAA2D,aACtE,KAAC,aAAa,mBAAa,MAAM,EAAC,SAAS,EAAC,wBAAwB,GAAG,EACvE,gBAAM,SAAS,EAAC,qBAAqB,4CAElC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAC9B,gDAAa,YAAY,CAAC,eAAe,cAAW,CACrD,CAAC,CAAC,CAAC,CACF,GAAG,CACJ,IACI,IACL,EACJ,KAAC,MAAM,IACL,OAAO,EAAC,SAAS,EACjB,IAAI,EAAC,IAAI,EACT,OAAO,EAAE,GAAG,EAAE,CACZ,KAAK,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;4BAC/B,gDAAgD;wBAClD,CAAC,CAAC,EAEJ,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,gBAAgB,CAAC,YAE9C,eAAe,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,GAC3D,IACL,EACL,KAAK,IAAI,CACR,YAAG,SAAS,EAAC,+BAA+B,YAAE,cAAc,CAAC,KAAK,CAAC,GAAK,CACzE,IACG,CACP,CAAC;AACJ,CAAC"}

package/conversation/ConversationComposer.d.ts

@@ -0,0 +1,41 @@
+import type { SendChannelMessageOutput } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/message_io_pb";
+/** Props for {@link ConversationComposer}. */
+export interface ConversationComposerProps {
+    /** Send a staff reply (from `useConversationParticipation().reply`). */
+    readonly onSend: (text: string) => Promise<SendChannelMessageOutput>;
+    /** `true` while a reply is in flight. */
+    readonly isSending: boolean;
+    /**
+     * Why replying is unavailable, when it is — rendered in place of the
+     * input (a senderless provider, or a conversation the customer has
+     * not started yet). `null` enables the composer.
+     */
+    readonly disabledReason: string | null;
+    /**
+     * A pre-send forecast that ANNOTATES the enabled input — the
+     * `disabledReason` pattern's sibling with the opposite contract
+     * (channel-conversations DD-014 D-e): a closed service window is a
+     * forecast, not a structural block, so the input stays usable and the
+     * send engines remain the authority. Rendered above the input and
+     * associated via `aria-describedby` (never a live region: the
+     * advisory is state a reader meets on open, not an event). Compute it
+     * with `serviceWindowOf`; `null` or omitted renders nothing.
+     */
+    readonly advisory?: string | null;
+    /** Additional classes for the composer container. */
+    readonly className?: string;
+}
+/**
+ * The staff reply composer. Sending is an implicit takeover — the agent
+ * goes quiet the moment a staff reply lands, before the send itself —
+ * so this composer is only ever rendered alongside the control banner
+ * that shows that state change.
+ *
+ * Outcome honesty: `refused` keeps the draft (the words never left) and
+ * renders the server's refusal detail verbatim; `queued` clears it and
+ * says the platform is retrying; a thrown failure keeps the draft and
+ * renders the error. The timeline shows the delivered item via its own
+ * read — this component never fabricates one.
+ */
+export declare function ConversationComposer({ onSend, isSending, disabledReason, advisory, className, }: ConversationComposerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ConversationComposer.d.ts.map

package/conversation/ConversationComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationComposer.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationComposer.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kEAAkE,CAAC;AAKjH,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrE,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,MAAM,EACN,SAAS,EACT,cAAc,EACd,QAAQ,EACR,SAAS,GACV,EAAE,yBAAyB,2CAkG3B"}

package/conversation/ConversationComposer.js

@@ -0,0 +1,57 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useState } from "react";
+import { Send, TriangleAlert } from "lucide-react";
+import { cn } from "@stigmer/theme";
+import { getUserMessage } from "@stigmer/sdk";
+import { ChannelSendOutcome } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/message_io_pb";
+import { Button } from "../button/Button.js";
+import { SpinnerIcon } from "../composer/icons.js";
+import { useComposer } from "../composer/useComposer.js";
+/**
+ * The staff reply composer. Sending is an implicit takeover — the agent
+ * goes quiet the moment a staff reply lands, before the send itself —
+ * so this composer is only ever rendered alongside the control banner
+ * that shows that state change.
+ *
+ * Outcome honesty: `refused` keeps the draft (the words never left) and
+ * renders the server's refusal detail verbatim; `queued` clears it and
+ * says the platform is retrying; a thrown failure keeps the draft and
+ * renders the error. The timeline shows the delivered item via its own
+ * read — this component never fabricates one.
+ */
+export function ConversationComposer({ onSend, isSending, disabledReason, advisory, className, }) {
+    const advisoryId = useId();
+    const hasAdvisory = advisory != null && advisory !== "";
+    const [notice, setNotice] = useState(null);
+    const composer = useComposer({
+        onSubmit: (message) => {
+            setNotice(null);
+            onSend(message).then((output) => {
+                if (output.outcome === ChannelSendOutcome.refused) {
+                    // The words never left; keep them so the user can adjust.
+                    composer.setMessage(message);
+                    setNotice({
+                        kind: "refused",
+                        text: output.detail || "The provider refused this message.",
+                    });
+                }
+                else if (output.outcome === ChannelSendOutcome.queued) {
+                    setNotice({
+                        kind: "queued",
+                        text: "Delivery hit a transient issue — the platform is retrying in the background.",
+                    });
+                }
+            }, (err) => {
+                composer.setMessage(message);
+                setNotice({ kind: "error", text: getUserMessage(err) });
+            });
+        },
+        disabled: disabledReason !== null || isSending,
+    });
+    if (disabledReason !== null) {
+        return (_jsx("div", { className: cn("border-t border-border px-4 py-3", className), children: _jsx("p", { className: "text-center text-xs text-muted-foreground", children: disabledReason }) }));
+    }
+    return (_jsxs("div", { className: cn("border-t border-border px-4 py-3", className), children: [hasAdvisory && (_jsxs("p", { id: advisoryId, className: "mb-2 flex items-start gap-1.5 rounded-md bg-status-degraded-subtle px-2.5 py-1.5 text-xs text-status-degraded", children: [_jsx(TriangleAlert, { "aria-hidden": "true", className: "mt-0.5 size-3.5 shrink-0" }), _jsx("span", { className: "min-w-0", children: advisory })] })), notice && (_jsx("p", { className: cn("mb-2 text-xs", notice.kind === "queued" ? "text-muted-foreground" : "text-destructive"), role: "status", children: notice.text })), _jsxs("div", { className: "flex items-end gap-2", children: [_jsx("textarea", { ...composer.textareaProps, rows: 1, placeholder: "Reply as your business\u2026", "aria-label": "Reply to the customer", "aria-describedby": hasAdvisory ? advisoryId : undefined, className: cn("min-h-9 flex-1 resize-none rounded-md border border-border bg-background", "px-3 py-2 text-sm text-foreground placeholder:text-muted-foreground-faint", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring") }), _jsxs(Button, { variant: "primary", size: "sm", onClick: composer.submit, disabled: !composer.canSubmit || isSending, "aria-label": "Send reply", children: [isSending ? _jsx(SpinnerIcon, {}) : _jsx(Send, { "aria-hidden": "true", className: "size-4" }), isSending ? "Sending…" : "Send"] })] })] }));
+}
+//# sourceMappingURL=ConversationComposer.js.map

package/conversation/ConversationComposer.js.map

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

package/conversation/ConversationControlBanner.d.ts

@@ -0,0 +1,52 @@
+import { type ChannelConversation } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import type { UseConversationParticipationReturn } from "./useConversationParticipation.js";
+/** Props for {@link ConversationControlBanner}. */
+export interface ConversationControlBannerProps {
+    /** The conversation's fresh participation state. */
+    readonly conversation: ChannelConversation;
+    /** The participation commands (from `useConversationParticipation`). */
+    readonly participation: UseConversationParticipationReturn;
+    /**
+     * `true` when the customer's last message has not been answered —
+     * the conversation row's server-derived `awaiting_reply` fact, which
+     * is bounce-aware: a staff reply the provider later failed does not
+     * count as an answer (channel-conversations F-28/DD-015). Arms the
+     * handback confirm guard (DD-007 D-e): handing back runs NO turn, so
+     * the agent stays quiet until the customer next speaks, and the
+     * unanswered state must be unmissable. Never derive this from
+     * timeline authorship — the send attempt's presence on the timeline
+     * says nothing about whether the customer received it.
+     */
+    readonly unansweredCustomer: boolean;
+    /**
+     * Whether the channel's provider has a staff send lane. Senderless
+     * providers disable takeover with the reason — a takeover there would
+     * silence the agent while no human reply could reach the customer,
+     * which is exactly what the server refuses.
+     */
+    readonly supportsStaffReplies: boolean;
+    /**
+     * The signed-in staff member's identity account id, when the host
+     * knows it — lets the banner attribute a human hold: "You have this
+     * conversation" when it matches, "A teammate has this conversation"
+     * when it differs. When omitted the banner only states that a human
+     * holds it — the holder may be the viewer themself, so "a teammate"
+     * would be a guess. Optional: the SDK never assumes a host's auth
+     * state.
+     */
+    readonly currentIdentityAccountId?: string;
+    /** Additional classes for the banner container. */
+    readonly className?: string;
+}
+/**
+ * Who may speak to the customer, and the controls that move it: take
+ * over (the agent goes quiet) and hand back (the agent resumes, with
+ * the context it missed injected on its next turn).
+ *
+ * Truth rules: state renders from the conversation row the server
+ * answered — a takeover that lost its race renders the WINNER's hold,
+ * because that is what happened. Failures render verbatim beside the
+ * control that caused them.
+ */
+export declare function ConversationControlBanner({ conversation, participation, unansweredCustomer, supportsStaffReplies, currentIdentityAccountId, className, }: ConversationControlBannerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ConversationControlBanner.d.ts.map

package/conversation/ConversationControlBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationControlBanner.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationControlBanner.tsx"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,uEAAuE,CAAC;AAE/E,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,mCAAmC,CAAC;AAE5F,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC7C,oDAAoD;IACpD,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,kCAAkC,CAAC;IAC3D;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC;;;;;;;;OAQG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C,mDAAmD;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,SAAS,GACV,EAAE,8BAA8B,2CA2HhC"}

package/conversation/ConversationControlBanner.js

@@ -0,0 +1,59 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Bot, User } from "lucide-react";
+import { cn } from "@stigmer/theme";
+import { getUserMessage } from "@stigmer/sdk";
+import { ConversationControl, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import { Button } from "../button/Button.js";
+/**
+ * Who may speak to the customer, and the controls that move it: take
+ * over (the agent goes quiet) and hand back (the agent resumes, with
+ * the context it missed injected on its next turn).
+ *
+ * Truth rules: state renders from the conversation row the server
+ * answered — a takeover that lost its race renders the WINNER's hold,
+ * because that is what happened. Failures render verbatim beside the
+ * control that caused them.
+ */
+export function ConversationControlBanner({ conversation, participation, unansweredCustomer, supportsStaffReplies, currentIdentityAccountId, className, }) {
+    const [confirmingHandBack, setConfirmingHandBack] = useState(false);
+    const humanHeld = conversation.control === ConversationControl.control_human;
+    const heldByMe = humanHeld &&
+        currentIdentityAccountId !== undefined &&
+        conversation.controlledBy === currentIdentityAccountId;
+    const { takeOver, handBack, pendingCommands, commandErrors } = participation;
+    const error = commandErrors.get("takeOver") ?? commandErrors.get("handBack");
+    const requestHandBack = () => {
+        if (unansweredCustomer) {
+            setConfirmingHandBack(true);
+            return;
+        }
+        void handBack().catch(() => {
+            // Recorded in commandErrors and rendered below.
+        });
+    };
+    return (_jsxs("div", { className: cn("border-b border-border px-4 py-2", humanHeld ? "bg-primary-subtle" : "bg-muted-faint", className), children: [_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-2", children: [_jsx("p", { className: "flex items-center gap-1.5 text-sm text-foreground", children: humanHeld ? (_jsxs(_Fragment, { children: [_jsx(User, { "aria-hidden": "true", className: "size-4 text-muted-foreground" }), heldByMe
+                                    ? "You have this conversation — the agent is quiet until you hand it back."
+                                    : currentIdentityAccountId !== undefined
+                                        ? "A teammate has this conversation — the agent is quiet until handback."
+                                        : // Without the host's identity the holder may be the
+                                            // viewer themself — claiming "a teammate" would be a
+                                            // guess. State only what the row proves: a human
+                                            // holds it (channel-conversations F-01).
+                                            "This conversation is with a human — the agent is quiet until handback."] })) : (_jsxs(_Fragment, { children: [_jsx(Bot, { "aria-hidden": "true", className: "size-4 text-muted-foreground" }), "The agent is serving this conversation."] })) }), confirmingHandBack ? (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-destructive", children: "The customer's last message has no reply \u2014 the agent stays quiet until they write again." }), _jsx(Button, { variant: "outline", size: "xs", onClick: () => {
+                                    setConfirmingHandBack(false);
+                                    void handBack().catch(() => {
+                                        // Recorded in commandErrors and rendered below.
+                                    });
+                                }, disabled: pendingCommands.has("handBack"), children: "Hand back anyway" }), _jsx(Button, { variant: "primary", size: "xs", onClick: () => setConfirmingHandBack(false), children: "Keep the conversation" })] })) : humanHeld ? (_jsx(Button, { variant: "outline", size: "xs", onClick: requestHandBack, disabled: pendingCommands.has("handBack"), children: pendingCommands.has("handBack") ? "Handing back…" : "Hand back to agent" })) : (_jsxs("div", { className: "flex items-center gap-2", children: [!supportsStaffReplies && (
+                            // Visible text, never a native title (F-18): a disabled
+                            // Button swallows hover (disabled:pointer-events-none) and
+                            // leaves the tab order, so a title on it is unreachable by
+                            // every input method. Kept short — the composer's own
+                            // notice already explains the missing staff reply lane.
+                            _jsx("span", { className: "text-xs text-muted-foreground", children: "This channel's provider has no staff send lane yet \u2014 a takeover would silence the agent with no way to reply." })), _jsx(Button, { variant: "outline", size: "xs", onClick: () => void takeOver().catch(() => {
+                                    // Recorded in commandErrors and rendered below.
+                                }), disabled: !supportsStaffReplies || pendingCommands.has("takeOver"), children: pendingCommands.has("takeOver") ? "Taking over…" : "Take over" })] }))] }), error && (_jsx("p", { className: "mt-1 text-xs text-destructive", children: getUserMessage(error) }))] }));
+}
+//# sourceMappingURL=ConversationControlBanner.js.map

package/conversation/ConversationControlBanner.js.map

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

package/conversation/ConversationListPane.d.ts

@@ -0,0 +1,68 @@
+import type { AgentChannel } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/api_pb";
+import { ChannelConversationListFilter, type ChannelConversation } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+/** The (channel, key) pair identifying one conversation. */
+export interface ConversationIdentity {
+    readonly agentChannelId: string;
+    readonly conversationKey: string;
+}
+/** Props for {@link ConversationListPane}. */
+export interface ConversationListPaneProps {
+    /** Conversations, newest activity first (from `useConversationList`). */
+    readonly conversations: readonly ChannelConversation[];
+    /** `true` only during the first load. */
+    readonly isLoading: boolean;
+    /** Error from the list read, or `null`. */
+    readonly error: Error | null;
+    /** `true` while more conversations exist beyond what is loaded. */
+    readonly hasMore: boolean;
+    /** Load the next page. */
+    readonly loadMore: () => void;
+    /** `true` while the next page is in flight. */
+    readonly isLoadingMore: boolean;
+    /**
+     * The org's channels the caller can view (from
+     * `useOrgAgentChannelList`) — the channel filter's options, each
+     * row's provider identity, and the honest empty-state distinction
+     * (no channel access vs no conversations yet).
+     */
+    readonly channels: readonly AgentChannel[];
+    /** Current channel filter; empty string means all channels. */
+    readonly channelFilter: string;
+    /** Called when the user picks a channel filter. */
+    readonly onChannelFilterChange: (agentChannelId: string) => void;
+    /**
+     * The server-evaluated predicate filter currently applied to the list
+     * (DD-011 D-g — the same predicate the nav badge counts, so the
+     * filtered list always matches the number that opened it). Defaults
+     * to unspecified (all conversations).
+     */
+    readonly filter?: ChannelConversationListFilter;
+    /**
+     * Called when the user picks a predicate filter. The control renders
+     * only when this is wired — a dead toggle over an unfiltered list
+     * would lie.
+     */
+    readonly onFilterChange?: (filter: ChannelConversationListFilter) => void;
+    /** The open conversation, for row highlighting. `null` when none. */
+    readonly selected: ConversationIdentity | null;
+    /** Called when the user opens a conversation. */
+    readonly onSelect: (conversation: ChannelConversation) => void;
+    /** Frozen instant for deterministic hosts (tests, documentation tours). */
+    readonly now?: Date;
+    /** Additional classes for the pane container. */
+    readonly className?: string;
+}
+/**
+ * The conversation inbox pane (channel-conversations T04): every
+ * conversation across the org's channels, newest activity first, with
+ * control, attention, and awaiting-reply indicators.
+ *
+ * Presentational — pair with `useConversationList` and
+ * `useOrgAgentChannelList`, or compose via `ConversationsWorkbench`.
+ * The wants-human filter is SERVER-evaluated (DD-011 D-g closed the API
+ * gap that T04 D1 cited): a client-side tab over one fetched page would
+ * silently lie across pages, so the pane only reports the choice and the
+ * list hook sends it to the server.
+ */
+export declare function ConversationListPane({ conversations, isLoading, error, hasMore, loadMore, isLoadingMore, channels, channelFilter, onChannelFilterChange, filter, onFilterChange, selected, onSelect, now, className, }: ConversationListPaneProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ConversationListPane.d.ts.map

package/conversation/ConversationListPane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationListPane.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationListPane.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAC9F,OAAO,EACL,6BAA6B,EAE7B,KAAK,mBAAmB,EACzB,MAAM,uEAAuE,CAAC;AAiB/E,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,yEAAyE;IACzE,QAAQ,CAAC,aAAa,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvD,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,qBAAqB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,6BAA6B,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,6BAA6B,KAAK,IAAI,CAAC;IAC1E,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC/C,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC/D,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,aAAa,EACb,SAAS,EACT,KAAK,EACL,OAAO,EACP,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,aAAa,EACb,qBAAqB,EACrB,MAAmF,EACnF,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,GAAG,EACH,SAAS,GACV,EAAE,yBAAyB,2CA2H3B"}

package/conversation/ConversationListPane.js

@@ -0,0 +1,120 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { memo, useCallback, useRef } from "react";
+import { timestampDate } from "@bufbuild/protobuf/wkt";
+import { MessageSquare, TriangleAlert, User } from "lucide-react";
+import { cn } from "@stigmer/theme";
+import { getUserMessage } from "@stigmer/sdk";
+import { ChannelConversationListFilter, ConversationControl, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import { formatRelativeTime } from "../activity/format-relative-time.js";
+import { channelProviderOf } from "../channel/providers.js";
+import { Button } from "../button/Button.js";
+import { EmptyState } from "../empty-state/EmptyState.js";
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from "../internal/tooltip.js";
+import { awaitingIndicatorOf, conversationContactOf, conversationLabelOf, } from "./conversationPresentation.js";
+/**
+ * The conversation inbox pane (channel-conversations T04): every
+ * conversation across the org's channels, newest activity first, with
+ * control, attention, and awaiting-reply indicators.
+ *
+ * Presentational — pair with `useConversationList` and
+ * `useOrgAgentChannelList`, or compose via `ConversationsWorkbench`.
+ * The wants-human filter is SERVER-evaluated (DD-011 D-g closed the API
+ * gap that T04 D1 cited): a client-side tab over one fetched page would
+ * silently lie across pages, so the pane only reports the choice and the
+ * list hook sends it to the server.
+ */
+export function ConversationListPane({ conversations, isLoading, error, hasMore, loadMore, isLoadingMore, channels, channelFilter, onChannelFilterChange, filter = ChannelConversationListFilter.channel_conversation_list_filter_unspecified, onFilterChange, selected, onSelect, now, className, }) {
+    const providerById = new Map(channels.map((channel) => [
+        channel.metadata?.id ?? "",
+        channelProviderOf(channel.spec?.providerConfig?.case),
+    ]));
+    return (_jsxs("div", { "aria-label": "Conversation list", className: cn("flex min-h-0 flex-col", className), children: [(onFilterChange !== undefined || channels.length > 1) && (_jsxs("div", { className: "flex flex-col gap-2 border-b border-border px-3 py-2", children: [onFilterChange !== undefined && (_jsx(ConversationFilterToggle, { value: filter, onChange: onFilterChange })), channels.length > 1 && (_jsxs(_Fragment, { children: [_jsx("label", { className: "sr-only", htmlFor: "stgm-conversation-channel-filter", children: "Filter by channel" }), _jsxs("select", { id: "stgm-conversation-channel-filter", value: channelFilter, onChange: (e) => onChannelFilterChange(e.target.value), className: cn("w-full rounded-md border border-border bg-background px-2 py-1.5", "text-sm text-foreground", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"), children: [_jsx("option", { value: "", children: "All channels" }), channels.map((channel) => (_jsx("option", { value: channel.metadata?.id, children: channel.metadata?.name || channel.metadata?.slug }, channel.metadata?.id)))] })] }))] })), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto p-2", children: isLoading ? (_jsx(ListSkeleton, {})) : error ? (_jsx("p", { className: "px-2 py-6 text-center text-sm text-destructive", children: getUserMessage(error) })) : conversations.length === 0 ? (channels.length === 0 ? (_jsx(EmptyState, { variant: "first-use", icon: _jsx(MessageSquare, { className: "size-8" }), title: "No channels to watch", description: "Conversations arrive through an agent's channels. Connect a channel \u2014 or ask a channel owner for access \u2014 and customer conversations appear here." })) : filter === ChannelConversationListFilter.filter_wants_human ? (
+                // Its own empty state on purpose: under the filter, "No
+                // conversations yet — when a customer messages…" would lie
+                // to an org with a full inbox and nothing needing a person.
+                _jsx(EmptyState, { variant: "first-use", icon: _jsx(MessageSquare, { className: "size-8" }), title: "Nothing needs a human right now", description: "Conversations appear here when the agent asks for attention, or when a human-held conversation has a customer message awaiting a reply." })) : (_jsx(EmptyState, { variant: "first-use", icon: _jsx(MessageSquare, { className: "size-8" }), title: "No conversations yet", description: "When a customer messages one of your channels, their conversation appears here." }))) : (_jsxs(_Fragment, { children: [_jsx(TooltipProvider, { children: _jsx("ul", { className: "space-y-0.5", children: conversations.map((conversation) => (_jsx(ConversationRow, { conversation: conversation, label: conversationLabelOf(conversation, providerById.get(conversation.agentChannelId)?.id ?? null), contact: conversationContactOf(conversation, providerById.get(conversation.agentChannelId)?.id ?? null), isSelected: selected?.agentChannelId === conversation.agentChannelId &&
+                                        selected?.conversationKey === conversation.conversationKey, onSelect: onSelect, now: now }, `${conversation.agentChannelId}:${conversation.conversationKey}`))) }) }), hasMore && (_jsx("div", { className: "flex justify-center py-2", children: _jsx(Button, { variant: "ghost", size: "xs", onClick: loadMore, disabled: isLoadingMore, children: isLoadingMore ? "Loading…" : "Show more" }) }))] })) })] }));
+}
+const FILTER_OPTIONS = [
+    {
+        value: ChannelConversationListFilter.channel_conversation_list_filter_unspecified,
+        label: "All",
+        ariaLabel: "All conversations",
+    },
+    {
+        value: ChannelConversationListFilter.filter_wants_human,
+        label: "Needs human",
+        ariaLabel: "Conversations where a human action is wanted",
+    },
+];
+/**
+ * Segmented control for the server-evaluated list filter. Renders as a
+ * WAI-ARIA Radio Group with roving tabindex and arrow-key navigation —
+ * the `ScopeToggle` pattern (its second sighting; extract a shared
+ * primitive if a third segmented control appears).
+ *
+ * "Needs human" is exactly the nav badge's predicate (DD-011 D-f/D-g),
+ * so the number on the badge and the list this control opens can never
+ * disagree.
+ */
+function ConversationFilterToggle({ value, onChange, }) {
+    const optionRefs = useRef([]);
+    const handleSelect = useCallback((next) => {
+        if (next !== value)
+            onChange(next);
+    }, [value, onChange]);
+    const handleKeyDown = useCallback((e, index) => {
+        let nextIndex = null;
+        if (e.key === "ArrowRight" || e.key === "ArrowDown") {
+            e.preventDefault();
+            nextIndex = (index + 1) % FILTER_OPTIONS.length;
+        }
+        else if (e.key === "ArrowLeft" || e.key === "ArrowUp") {
+            e.preventDefault();
+            nextIndex = (index - 1 + FILTER_OPTIONS.length) % FILTER_OPTIONS.length;
+        }
+        if (nextIndex !== null) {
+            optionRefs.current[nextIndex]?.focus();
+            handleSelect(FILTER_OPTIONS[nextIndex].value);
+        }
+    }, [handleSelect]);
+    return (_jsx("div", { role: "radiogroup", "aria-label": "Conversation filter", className: "inline-flex self-start rounded-md bg-muted p-0.5", children: FILTER_OPTIONS.map((option, index) => {
+            const isSelected = value === option.value;
+            return (_jsx("button", { ref: (el) => {
+                    optionRefs.current[index] = el;
+                }, type: "button", role: "radio", "aria-checked": isSelected, "aria-label": option.ariaLabel, tabIndex: isSelected ? 0 : -1, onClick: () => handleSelect(option.value), onKeyDown: (e) => handleKeyDown(e, index), className: cn("inline-flex cursor-pointer items-center rounded-sm px-2 py-1 text-xs font-medium transition-colors", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", isSelected
+                    ? "bg-background text-foreground shadow-sm"
+                    : "text-muted-foreground hover:text-foreground"), children: option.label }, option.value));
+        }) }));
+}
+const ConversationRow = memo(function ConversationRow({ conversation, label, contact, isSelected, onSelect, now, }) {
+    const humanHeld = conversation.control === ConversationControl.control_human;
+    const awaiting = awaitingIndicatorOf(conversation);
+    const lastActivity = conversation.lastActivityAt
+        ? timestampDate(conversation.lastActivityAt)
+        : null;
+    return (_jsx("li", { children: _jsxs("button", { type: "button", onClick: () => onSelect(conversation), "aria-current": isSelected ? "true" : undefined, className: cn("flex w-full items-center gap-2.5 rounded-md px-2.5 py-2 text-left", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", isSelected ? "bg-primary-subtle" : "hover:bg-accent"), children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex items-center gap-1.5", children: [_jsx("p", { className: "truncate text-sm font-medium text-foreground", children: label }), conversation.needsAttention && (
+                                // The reason rides the house tooltip (F-18). The trigger
+                                // renders as a span — it sits INSIDE the row button, so a
+                                // default (button) trigger would nest buttons — and stays
+                                // out of the tab order; the sr-only text remains the
+                                // accessible name. The full reason is also always visible
+                                // in the open conversation's attention banner.
+                                _jsxs(Tooltip, { children: [_jsxs(TooltipTrigger, { render: _jsx("span", { className: "shrink-0" }), children: [_jsx(TriangleAlert, { "aria-hidden": "true", className: "size-3.5 text-destructive" }), _jsx("span", { className: "sr-only", children: conversation.attentionReason
+                                                        ? `Needs attention: ${conversation.attentionReason}`
+                                                        : "Needs attention" })] }), _jsx(TooltipContent, { side: "top", children: conversation.attentionReason || "Needs attention" })] }))] }), contact !== null && (_jsx("p", { className: "mt-0.5 truncate text-xs text-muted-foreground-faint", children: contact })), humanHeld && (_jsxs("p", { className: "mt-0.5 flex items-center gap-1 text-xs text-muted-foreground", children: [_jsx(User, { "aria-hidden": "true", className: "size-3" }), "Human has the conversation"] }))] }), (lastActivity !== null || awaiting !== null) && (_jsxs("span", { className: "flex shrink-0 flex-col items-end gap-1", children: [lastActivity && (_jsx("span", { className: "text-xs text-muted-foreground-faint", children: formatRelativeTime(lastActivity, now) })), awaiting && (
+                        // The WhatsApp inbox convention: an awaiting conversation
+                        // carries a dot under its timestamp. Strength maps the
+                        // holder (DD-011 D-a): strong when a human holds it — the
+                        // agent will not answer, a person must — muted when the
+                        // agent does. No tooltip and no tab stop (the F-18
+                        // discipline); the sr-only text is the accessible meaning.
+                        _jsxs("span", { className: "flex", children: [_jsx("span", { "aria-hidden": "true", className: cn("size-2 rounded-full", awaiting === "strong" ? "bg-primary" : "bg-muted-foreground") }), _jsx("span", { className: "sr-only", children: awaiting === "strong"
+                                        ? "Customer awaiting reply — the conversation is human-held"
+                                        : "Customer awaiting reply" })] }))] }))] }) }));
+});
+function ListSkeleton() {
+    return (_jsx("div", { className: "space-y-1 p-1", "aria-hidden": "true", children: [1, 2, 3, 4].map((i) => (_jsx("div", { className: "h-11 animate-pulse rounded-md bg-muted-faint" }, i))) }));
+}
+//# sourceMappingURL=ConversationListPane.js.map

package/conversation/ConversationListPane.js.map

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

package/conversation/ConversationTimelineView.d.ts

@@ -0,0 +1,46 @@
+import type { ConversationTimelineItem } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import { type ChannelProviderId } from "../channel/providers.js";
+/** Props for {@link ConversationTimelineView}. */
+export interface ConversationTimelineViewProps {
+    /** Timeline items in chronological order (from `useConversationTimeline`). */
+    readonly items: readonly ConversationTimelineItem[];
+    /** `true` only during the first load. */
+    readonly isLoading: boolean;
+    /** Error from the timeline read, or `null`. */
+    readonly error: Error | null;
+    /** `true` while older history exists beyond what is loaded. */
+    readonly hasOlder: boolean;
+    /** Load the next older page. */
+    readonly loadOlder: () => void;
+    /** `true` while an older page is in flight. */
+    readonly isLoadingOlder: boolean;
+    /**
+     * The channel's provider, for the honest-timeline notice: providers
+     * whose inbound lane has no timeline source (Slack) render an
+     * explicit "customer messages aren't shown" notice instead of a
+     * silently one-sided thread. `null` renders no notice.
+     */
+    readonly provider: ChannelProviderId | null;
+    /** Frozen instant for deterministic hosts (tests, documentation tours). */
+    readonly now?: Date;
+    /** Additional classes for the view container. */
+    readonly className?: string;
+}
+/**
+ * One conversation's customer-visible thread, WhatsApp-style: customer
+ * on the left, the business (agent, teammate, platform copy) on the
+ * right, internal-lane events (escalations, attention clears) as inline
+ * system rows the customer never saw.
+ *
+ * Honesty rules, enforced here rather than hoped for: outbound items
+ * carry their send attempt AND the provider's receipt as two independent
+ * facts (DD-004 D-d — an item can be handed to the provider yet fail on
+ * the customer's side), failed and suppressed sends render as exactly
+ * that, and non-text inbound renders a typed placeholder instead of
+ * disappearing.
+ *
+ * Presentational — pair with `useConversationTimeline`, or compose via
+ * `ConversationsWorkbench`.
+ */
+export declare function ConversationTimelineView({ items, isLoading, error, hasOlder, loadOlder, isLoadingOlder, provider, now, className, }: ConversationTimelineViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ConversationTimelineView.d.ts.map

package/conversation/ConversationTimelineView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationTimelineView.d.ts","sourceRoot":"","sources":["../../src/conversation/ConversationTimelineView.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAoBpF,kDAAkD;AAClD,MAAM,WAAW,6BAA6B;IAC5C,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACpD,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,KAAK,EACL,SAAS,EACT,KAAK,EACL,QAAQ,EACR,SAAS,EACT,cAAc,EACd,QAAQ,EACR,GAAG,EACH,SAAS,GACV,EAAE,6BAA6B,2CAgF/B"}