@stigmer/react 3.7.0 → 3.9.0

package/conversation/useConversationParticipation.d.ts

@@ -0,0 +1,63 @@
+import type { ChannelConversation } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import type { SendChannelMessageOutput } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/message_io_pb";
+/** The four staff-facing participation commands. */
+export type ConversationCommand = "reply" | "takeOver" | "handBack" | "clearAttention";
+/** Options for {@link useConversationParticipation}. */
+export interface UseConversationParticipationOptions {
+    /** AgentChannel the conversation belongs to. */
+    readonly agentChannelId: string;
+    /** Conversation key within the channel. */
+    readonly conversationKey: string;
+    /**
+     * Receives the fresh conversation row every command answers with —
+     * wire it to {@link useConversation}'s `applyServerState` so banners
+     * and controls adopt server truth immediately. Called for reply too
+     * (via a follow-up row read): a staff reply implicitly takes over
+     * BEFORE the send, unconditionally, so control has moved even when
+     * the send itself was refused.
+     */
+    readonly onConversation?: (fresh: ChannelConversation) => void;
+}
+/** Return value of {@link useConversationParticipation}. */
+export interface UseConversationParticipationReturn {
+    /**
+     * Send a staff text reply. Resolves with the truthful outcome of the
+     * inline attempt: `accepted` (with `outboundMessageId` — the item will
+     * appear on the timeline as `ob:<that id>`), `queued`, or `refused`.
+     * A `refused` outcome WITHOUT an `outboundMessageId` left no ledger
+     * row and no timeline item will ever exist for it.
+     */
+    readonly reply: (text: string) => Promise<SendChannelMessageOutput>;
+    /**
+     * Take the conversation over: the agent goes quiet until handBack.
+     * Resolves with the fresh row — for the LOSER of a concurrent
+     * takeover too (success-with-the-winner's-state, never an error), so
+     * compare `controlledBy` against the caller rather than assuming the
+     * transition won.
+     */
+    readonly takeOver: () => Promise<ChannelConversation>;
+    /** Hand the conversation back to the agent. */
+    readonly handBack: () => Promise<ChannelConversation>;
+    /** Dismiss the needs-attention flag in place; control is untouched. */
+    readonly clearAttention: () => Promise<ChannelConversation>;
+    /** Commands currently in flight. */
+    readonly pendingCommands: ReadonlySet<ConversationCommand>;
+    /** Per-command failures, cleared when that command is retried. */
+    readonly commandErrors: ReadonlyMap<ConversationCommand, Error>;
+    /** Reset every recorded command error. */
+    readonly clearErrors: () => void;
+}
+/**
+ * Behavior hook for the participation commands on one conversation
+ * (channel-conversations DD-005/DD-007/DD-008/DD-009): reply, takeOver,
+ * handBack, clearAttention — each keyed independently so a slow reply
+ * and a takeover can be in flight at once with attributable spinners
+ * and errors.
+ *
+ * Every command re-throws its failure after recording it in
+ * {@link UseConversationParticipationReturn.commandErrors}, so callers
+ * choose the propagation (await-and-toast, or ignore and render the
+ * keyed error inline).
+ */
+export declare function useConversationParticipation(options: UseConversationParticipationOptions): UseConversationParticipationReturn;
+//# sourceMappingURL=useConversationParticipation.d.ts.map

package/conversation/useConversationParticipation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationParticipation.d.ts","sourceRoot":"","sources":["../../src/conversation/useConversationParticipation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACpB,MAAM,uEAAuE,CAAC;AAM/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kEAAkE,CAAC;AAKjH,oDAAoD;AACpD,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAEvF,wDAAwD;AACxD,MAAM,WAAW,mCAAmC;IAClD,gDAAgD;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAChE;AAED,4DAA4D;AAC5D,MAAM,WAAW,kCAAkC;IACjD;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACpE;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtD,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtD,uEAAuE;IACvE,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D,oCAAoC;IACpC,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAC3D,kEAAkE;IAClE,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAChE,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,kCAAkC,CAiGpC"}

package/conversation/useConversationParticipation.js

@@ -0,0 +1,84 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { ConversationControlInputSchema, GetChannelConversationInputSchema, ReplyToConversationInputSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import { useCallback, useMemo } from "react";
+import { useStigmer } from "../hooks.js";
+import { useKeyedSubmission } from "../internal/useKeyedSubmission.js";
+/**
+ * Behavior hook for the participation commands on one conversation
+ * (channel-conversations DD-005/DD-007/DD-008/DD-009): reply, takeOver,
+ * handBack, clearAttention — each keyed independently so a slow reply
+ * and a takeover can be in flight at once with attributable spinners
+ * and errors.
+ *
+ * Every command re-throws its failure after recording it in
+ * {@link UseConversationParticipationReturn.commandErrors}, so callers
+ * choose the propagation (await-and-toast, or ignore and render the
+ * keyed error inline).
+ */
+export function useConversationParticipation(options) {
+    const { agentChannelId, conversationKey, onConversation } = options;
+    const stigmer = useStigmer();
+    const submission = useKeyedSubmission();
+    const { run } = submission;
+    const controlInput = useCallback(() => create(ConversationControlInputSchema, { agentChannelId, conversationKey }), [agentChannelId, conversationKey]);
+    const takeOver = useCallback(() => run("takeOver", async () => {
+        const fresh = await stigmer.agentChannel.takeOver(controlInput());
+        onConversation?.(fresh);
+        return fresh;
+    }), [run, stigmer, controlInput, onConversation]);
+    const handBack = useCallback(() => run("handBack", async () => {
+        const fresh = await stigmer.agentChannel.handBack(controlInput());
+        onConversation?.(fresh);
+        return fresh;
+    }), [run, stigmer, controlInput, onConversation]);
+    const clearAttention = useCallback(() => run("clearAttention", async () => {
+        const fresh = await stigmer.agentChannel.clearAttention(controlInput());
+        onConversation?.(fresh);
+        return fresh;
+    }), [run, stigmer, controlInput, onConversation]);
+    const reply = useCallback((text) => run("reply", async () => {
+        const output = await stigmer.agentChannel.reply(create(ReplyToConversationInputSchema, {
+            agentChannelId,
+            conversationKey,
+            payload: { kind: { case: "text", value: { body: text } } },
+        }));
+        // The implicit takeover flipped control BEFORE the send ran —
+        // even a refused reply moved it — but reply answers the send
+        // outcome, not the row. One follow-up read keeps the control
+        // banner honest without waiting a poll tick. Best-effort: a
+        // failed read only delays the banner until the next poll.
+        if (onConversation) {
+            try {
+                onConversation(await stigmer.agentChannel.getConversation(create(GetChannelConversationInputSchema, {
+                    agentChannelId,
+                    conversationKey,
+                })));
+            }
+            catch {
+                // The reply itself succeeded; the poll will catch the row up.
+            }
+        }
+        return output;
+    }), [run, stigmer, agentChannelId, conversationKey, onConversation]);
+    return useMemo(() => ({
+        reply,
+        takeOver,
+        handBack,
+        clearAttention,
+        // The submission primitive keys by string; this hook only ever
+        // submits the four command names, so the narrowing is sound.
+        pendingCommands: submission.submittingKeys,
+        commandErrors: submission.errorsByKey,
+        clearErrors: submission.clearErrors,
+    }), [
+        reply,
+        takeOver,
+        handBack,
+        clearAttention,
+        submission.submittingKeys,
+        submission.errorsByKey,
+        submission.clearErrors,
+    ]);
+}
+//# sourceMappingURL=useConversationParticipation.js.map

package/conversation/useConversationParticipation.js.map

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

package/conversation/useConversationTimeline.d.ts

@@ -0,0 +1,71 @@
+import type { ConversationTimelineItem } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+/** Options for {@link useConversationTimeline}. */
+export interface UseConversationTimelineOptions {
+    /** Items per page, for the polled head and each loadOlder page. Default 50. */
+    readonly pageSize?: number;
+    /**
+     * Poll interval in milliseconds; `false` disables polling. Defaults to
+     * {@link CONVERSATION_DETAIL_POLL_INTERVAL_MS}. Only the head page
+     * polls — it is where new items land and where recent items' delivery
+     * and receipt states still move.
+     */
+    readonly refetchIntervalMs?: number | false;
+}
+/** Return value of {@link useConversationTimeline}. */
+export interface UseConversationTimelineReturn {
+    /**
+     * Every item seen so far, in chronological (oldest → newest) order —
+     * the render order of a chat view. Items are never dropped: the polled
+     * head window may shift as new messages land, and an item that slides
+     * out of it stays here rather than vanishing mid-scroll.
+     */
+    readonly items: readonly ConversationTimelineItem[];
+    /**
+     * `true` while older history exists beyond what is loaded. Decided
+     * ONLY by the server's cursor — a short page mid-history is normal
+     * (same-second bursts narrow pages) and never means the end.
+     */
+    readonly hasOlder: boolean;
+    /** Load the next older page. No-op while one is already loading. */
+    readonly loadOlder: () => void;
+    /** `true` while a loadOlder page is in flight. */
+    readonly isLoadingOlder: boolean;
+    /** Error from the last failed loadOlder, or `null`. Cleared on retry. */
+    readonly loadOlderError: Error | null;
+    /** `true` only during the first head-page load. */
+    readonly isLoading: boolean;
+    /** `true` while the head page refreshes in the background. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed head-page fetch, or `null`. */
+    readonly error: Error | null;
+    /** Re-fetch the head page. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook for one conversation's customer-visible timeline
+ * (channel-conversations DD-004): newest-first cursor pages from the
+ * server, accumulated into one chronological list for a chat view.
+ *
+ * The accumulation is an UPSERT by `item_id`, not head/tail
+ * concatenation, for two verified server behaviors:
+ *
+ * - Item instants are stable but STATUSES mutate in place — an outbound
+ *   item's delivery status and receipt ticks advance after it first
+ *   renders. Each head poll re-upserts the newest window, so those
+ *   fields stay live without any diffing protocol.
+ * - The head window SHIFTS as new items land. Items that slide out of
+ *   it are not in any loaded older page (older cursors are anchored
+ *   below the original head), so concatenation would silently drop
+ *   them; the upsert map keeps everything ever seen.
+ *
+ * The older cursor is captured from the FIRST head page only: later
+ * head refreshes serve the top of the timeline, while the cursor tracks
+ * how deep into history the consumer has scrolled — two independent
+ * frontiers. Receipt ticks on items deeper than the head window can go
+ * stale until the conversation is reopened; accepted for v1 (the T05
+ * liveness seam is where per-item freshness lands).
+ *
+ * Pass empty strings to skip fetching (the `null`-fetchFn convention).
+ */
+export declare function useConversationTimeline(agentChannelId: string, conversationKey: string, options?: UseConversationTimelineOptions): UseConversationTimelineReturn;
+//# sourceMappingURL=useConversationTimeline.d.ts.map

package/conversation/useConversationTimeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationTimeline.d.ts","sourceRoot":"","sources":["../../src/conversation/useConversationTimeline.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uEAAuE,CAAC;AAYtH,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC7C,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC7C;AAED,uDAAuD;AACvD,MAAM,WAAW,6BAA6B;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,KAAK,GAAG,IAAI,CAAC;IACtC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AASD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,8BAA8B,GACvC,6BAA6B,CA6H/B"}

package/conversation/useConversationTimeline.js

@@ -0,0 +1,152 @@
+"use client";
+import { create, equals } from "@bufbuild/protobuf";
+import { ConversationTimelineItemSchema, GetConversationTimelineInputSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+import { useFetch } from "../internal/useFetch.js";
+import { compareTimelineItemsNewestFirst } from "./conversationPresentation.js";
+import { CONVERSATION_DETAIL_POLL_INTERVAL_MS } from "./polling.js";
+const EMPTY_HEAD = { items: [], nextPageToken: "" };
+/**
+ * Data hook for one conversation's customer-visible timeline
+ * (channel-conversations DD-004): newest-first cursor pages from the
+ * server, accumulated into one chronological list for a chat view.
+ *
+ * The accumulation is an UPSERT by `item_id`, not head/tail
+ * concatenation, for two verified server behaviors:
+ *
+ * - Item instants are stable but STATUSES mutate in place — an outbound
+ *   item's delivery status and receipt ticks advance after it first
+ *   renders. Each head poll re-upserts the newest window, so those
+ *   fields stay live without any diffing protocol.
+ * - The head window SHIFTS as new items land. Items that slide out of
+ *   it are not in any loaded older page (older cursors are anchored
+ *   below the original head), so concatenation would silently drop
+ *   them; the upsert map keeps everything ever seen.
+ *
+ * The older cursor is captured from the FIRST head page only: later
+ * head refreshes serve the top of the timeline, while the cursor tracks
+ * how deep into history the consumer has scrolled — two independent
+ * frontiers. Receipt ticks on items deeper than the head window can go
+ * stale until the conversation is reopened; accepted for v1 (the T05
+ * liveness seam is where per-item freshness lands).
+ *
+ * Pass empty strings to skip fetching (the `null`-fetchFn convention).
+ */
+export function useConversationTimeline(agentChannelId, conversationKey, options) {
+    const pageSize = options?.pageSize ?? 50;
+    const refetchIntervalMs = options?.refetchIntervalMs ?? CONVERSATION_DETAIL_POLL_INTERVAL_MS;
+    const stigmer = useStigmer();
+    const enabled = agentChannelId !== "" && conversationKey !== "";
+    const fetchFn = enabled
+        ? async () => {
+            const result = await stigmer.agentChannel.getTimeline(create(GetConversationTimelineInputSchema, {
+                agentChannelId,
+                conversationKey,
+                pageSize,
+            }));
+            return { items: result.items, nextPageToken: result.nextPageToken };
+        }
+        : null;
+    const { data: head, isLoading, isRefetching, error, refetch, } = useFetch(fetchFn, [agentChannelId, conversationKey, pageSize, stigmer], EMPTY_HEAD, {
+        refetchInterval: refetchIntervalMs,
+        // DD-012 D-a: returning to the tab is fresh (the head re-upserts, so
+        // a focus refetch can never disturb accumulated history).
+        refetchOnWindowFocus: true,
+    });
+    // Everything ever seen for this conversation, by item id.
+    const [known, setKnown] = useState(new Map());
+    // The older-history frontier: null until the first head page answers,
+    // "" once history is exhausted, otherwise the next older cursor.
+    const [olderCursor, setOlderCursor] = useState(null);
+    const [isLoadingOlder, setIsLoadingOlder] = useState(false);
+    const [loadOlderError, setLoadOlderError] = useState(null);
+    const epochRef = useRef(0);
+    useEffect(() => {
+        epochRef.current += 1;
+        setKnown(new Map());
+        setOlderCursor(null);
+        setIsLoadingOlder(false);
+        setLoadOlderError(null);
+    }, [agentChannelId, conversationKey, pageSize, stigmer]);
+    // Fold each head page into the map. `head` is referentially fresh per
+    // fetch, so this runs exactly once per answer.
+    useEffect(() => {
+        if (head === EMPTY_HEAD)
+            return;
+        setKnown((current) => upsert(current, head.items));
+        setOlderCursor((current) => (current === null ? head.nextPageToken : current));
+    }, [head]);
+    const loadOlder = useCallback(() => {
+        if (!enabled || isLoadingOlder || !olderCursor)
+            return;
+        const epoch = epochRef.current;
+        setIsLoadingOlder(true);
+        setLoadOlderError(null);
+        stigmer.agentChannel
+            .getTimeline(create(GetConversationTimelineInputSchema, {
+            agentChannelId,
+            conversationKey,
+            pageSize,
+            pageToken: olderCursor,
+        }))
+            .then((result) => {
+            if (epochRef.current !== epoch)
+                return;
+            setKnown((current) => upsert(current, result.items));
+            setOlderCursor(result.nextPageToken);
+            setIsLoadingOlder(false);
+        }, (err) => {
+            if (epochRef.current !== epoch)
+                return;
+            setLoadOlderError(toError(err));
+            setIsLoadingOlder(false);
+        });
+    }, [enabled, isLoadingOlder, olderCursor, agentChannelId, conversationKey, pageSize, stigmer]);
+    const items = useMemo(() => Array.from(known.values())
+        .sort(compareTimelineItemsNewestFirst)
+        .reverse(), [known]);
+    const hasOlder = olderCursor !== null && olderCursor !== "";
+    return useMemo(() => ({
+        items,
+        hasOlder,
+        loadOlder,
+        isLoadingOlder,
+        loadOlderError,
+        isLoading,
+        isRefetching,
+        error,
+        refetch,
+    }), [
+        items,
+        hasOlder,
+        loadOlder,
+        isLoadingOlder,
+        loadOlderError,
+        isLoading,
+        isRefetching,
+        error,
+        refetch,
+    ]);
+}
+/**
+ * Fold a page into the map, preserving references: a poll returns fresh
+ * proto objects even when nothing changed, and swapping equal items
+ * would defeat `React.memo` on every row every poll tick (DD-010 —
+ * reference stability is architectural, not an optimization). An
+ * unchanged page returns the SAME map, so the sorted `items` memo does
+ * not even re-run.
+ */
+function upsert(current, incoming) {
+    let next = null;
+    for (const item of incoming) {
+        const existing = current.get(item.itemId);
+        if (existing && equals(ConversationTimelineItemSchema, existing, item))
+            continue;
+        next ??= new Map(current);
+        next.set(item.itemId, item);
+    }
+    return next ?? current;
+}
+//# sourceMappingURL=useConversationTimeline.js.map

package/conversation/useConversationTimeline.js.map

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

package/conversation/useConversationsWantsHumanCount.d.ts

@@ -0,0 +1,42 @@
+/** Options for {@link useConversationsWantsHumanCount}. */
+export interface UseConversationsWantsHumanCountOptions {
+    /**
+     * Poll interval in milliseconds; `false` disables polling. Defaults to
+     * {@link CONVERSATION_BADGE_POLL_INTERVAL_MS} — deliberately the
+     * slowest budget on the conversation surface (DD-012 D-b): a badge
+     * tolerates staleness an open inbox does not, and it renders on every
+     * console page in every tab.
+     */
+    readonly refetchIntervalMs?: number | false;
+}
+/** Return value of {@link useConversationsWantsHumanCount}. */
+export interface UseConversationsWantsHumanCountReturn {
+    /**
+     * Conversations where a human action is wanted:
+     * `needs_attention OR (awaiting_reply AND human-held)` — the two ways
+     * a conversation can be blocked on a person (the agent asked for one,
+     * or a human took over and the customer wrote). `0` until the first
+     * answer.
+     */
+    readonly count: number;
+    /** `true` only until the first answer arrives. */
+    readonly isLoading: boolean;
+    /** Error from the last failed read, or `null`. */
+    readonly error: Error | null;
+    /** Imperatively re-read the count. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook for the sidebar's Conversations badge (channel-conversations
+ * DD-011 D-f): how many conversations want a human right now, org-wide.
+ *
+ * The count IS the filtered list's `total_count` — one page-size-1 read
+ * with `filter_wants_human`, zero dedicated RPCs (DD-011 D-g). Because
+ * the badge and the wants-human list filter share one server-side
+ * predicate, the number shown and the list it leads to can never
+ * disagree.
+ *
+ * Pass `null` to skip fetching (no active org).
+ */
+export declare function useConversationsWantsHumanCount(org: string | null, options?: UseConversationsWantsHumanCountOptions): UseConversationsWantsHumanCountReturn;
+//# sourceMappingURL=useConversationsWantsHumanCount.d.ts.map

package/conversation/useConversationsWantsHumanCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationsWantsHumanCount.d.ts","sourceRoot":"","sources":["../../src/conversation/useConversationsWantsHumanCount.ts"],"names":[],"mappings":"AAYA,2DAA2D;AAC3D,MAAM,WAAW,sCAAsC;IACrD;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC7C;AAED,+DAA+D;AAC/D,MAAM,WAAW,qCAAqC;IACpD;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,sCAAsC,GAC/C,qCAAqC,CA4BvC"}

package/conversation/useConversationsWantsHumanCount.js

@@ -0,0 +1,40 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { ChannelConversationListFilter, ListChannelConversationsInputSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import { useMemo } from "react";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+import { CONVERSATION_BADGE_POLL_INTERVAL_MS } from "./polling.js";
+/**
+ * Data hook for the sidebar's Conversations badge (channel-conversations
+ * DD-011 D-f): how many conversations want a human right now, org-wide.
+ *
+ * The count IS the filtered list's `total_count` — one page-size-1 read
+ * with `filter_wants_human`, zero dedicated RPCs (DD-011 D-g). Because
+ * the badge and the wants-human list filter share one server-side
+ * predicate, the number shown and the list it leads to can never
+ * disagree.
+ *
+ * Pass `null` to skip fetching (no active org).
+ */
+export function useConversationsWantsHumanCount(org, options) {
+    const stigmer = useStigmer();
+    const refetchIntervalMs = options?.refetchIntervalMs ?? CONVERSATION_BADGE_POLL_INTERVAL_MS;
+    const fetchFn = org
+        ? async () => {
+            const result = await stigmer.agentChannel.listConversations(create(ListChannelConversationsInputSchema, {
+                org,
+                filter: ChannelConversationListFilter.filter_wants_human,
+                pageInfo: { num: 1, size: 1 },
+            }));
+            return result.totalCount;
+        }
+        : null;
+    const { data, isLoading, error, refetch } = useFetch(fetchFn, [org, stigmer], 0, {
+        refetchInterval: refetchIntervalMs,
+        // DD-012 D-a: returning to the tab is fresh.
+        refetchOnWindowFocus: true,
+    });
+    return useMemo(() => ({ count: data, isLoading, error, refetch }), [data, isLoading, error, refetch]);
+}
+//# sourceMappingURL=useConversationsWantsHumanCount.js.map

package/conversation/useConversationsWantsHumanCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationsWantsHumanCount.js","sourceRoot":"","sources":["../../src/conversation/useConversationsWantsHumanCount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,GACpC,MAAM,uEAAuE,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,mCAAmC,EAAE,MAAM,cAAc,CAAC;AAgCnE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,+BAA+B,CAC7C,GAAkB,EAClB,OAAgD;IAEhD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,iBAAiB,GACrB,OAAO,EAAE,iBAAiB,IAAI,mCAAmC,CAAC;IAEpE,MAAM,OAAO,GAAG,GAAG;QACjB,CAAC,CAAC,KAAK,IAAqB,EAAE;YAC1B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,iBAAiB,CACzD,MAAM,CAAC,mCAAmC,EAAE;gBAC1C,GAAG;gBACH,MAAM,EAAE,6BAA6B,CAAC,kBAAkB;gBACxD,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;aAC9B,CAAC,CACH,CAAC;YACF,OAAO,MAAM,CAAC,UAAU,CAAC;QAC3B,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE;QAC/E,eAAe,EAAE,iBAAiB;QAClC,6CAA6C;QAC7C,oBAAoB,EAAE,IAAI;KAC3B,CAAC,CAAC;IAEH,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAClD,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAClC,CAAC;AACJ,CAAC"}

package/index.d.ts

@@ -23,8 +23,8 @@ export { isTerminalPhase, useCreateAgentExecution, useExecutionStream, useLiveAg
 export type { BootstrapSessionSpec, CreateAgentExecutionInput, CreateAgentExecutionResult, SharedAgentExecutionFields, UseCreateAgentExecutionReturn, UseExecutionStreamReturn, UseLiveAgentExecutionOptions, UseLiveAgentExecutionReturn, UseAgentExecutionActionsOptions, UseAgentExecutionActionsReturn, UseSubmitApprovalReturn, UseFileReviewReturn, FileDecisionOptions, FileReviewability, FileBlockReason, ChangeSetReviewability, FileReviewRowState, ExecutionPhaseBadgeProps, InteractionModeBadgeProps, SetupProgressProps, ExecutionProgressProps, TodoListProps, TodoCardProps, UsageWidgetProps, ContextGaugeProps, SummarizationBadgeProps, SummarizationCardProps, PlanCompletionCardProps, PlanArtifactCardProps, PlanStreamingCardProps, PlanDocumentMessageProps, ContextHealth, SummarizationEventView, UseContextWindowReturn, ToolCallGroupProps, ToolCallDetailProps, ResultViewProps, TerminalSessionProps, ToolPresentation, ToolPresenter, ToolDisclosure, McpToolDetailProps, McpArgsViewProps, McpMetadataRowProps, ToolArgsViewProps, ToolCallItemProps, SubAgentSectionProps, MessageEntryProps, MessageThreadProps, ThreadContentColumn, ThreadSkeletonProps, FollowUpInputProps, ApprovalCardProps, ApprovalCardHeaderProps, ApprovalCardBodyProps, FileReviewCardProps, FileReviewDockProps, FileChangeProgressBarProps, ApprovalContextValue, UseApprovalResult, FileReviewContextValue, ArtifactRowProps, ArtifactRowViewProps, ArtifactRowItem, ArtifactContentRendererProps, ArtifactContentBodyProps, ArtifactFileContentProps, ArtifactDocumentProps, ArtifactInspection, UseArtifactInspectionOptions, ArtifactRenderMode, ArtifactPreviewContentProps, ArtifactPreviewModalProps, ArtifactsWidgetProps, WriteBacksWidgetProps, FilePathLinkProps, FilePathContextValue, PathClassification, ResolvedPathAction, SessionVariableEntry, UseSessionVariablesReturn, SessionVariablesInputProps, UseExecutionArtifactsReturn, UseArtifactContentReturn, UseArtifactContentByIdReturn, UseArtifactDownloadUrlReturn, UseArtifactDownloadUrlOptions, UseArtifactDownloadReturn, UseArtifactCopyReturn, UseToolOutputContentReturn, ToolOutputRefLike, UseFileChangeContentReturn, UseWorkspaceWriteBacksReturn, WriteBackCardProps, DiffStatSummary, FileChangesViewProps, FileChangeDiffProps, EmptyChangeNoticeProps, EmptyChangeKind, } from "./execution/index.js";
 export type { ExecutionArtifact } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/artifact_pb";
 export { ExecutionArtifactKind } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
-export { useAttachments, AttachmentChipList, MAX_ATTACHMENT_BYTES, detectContentType, formatFileSize, validateAttachmentSize, } from "./attachment/index.js";
-export type { AttachmentPhase, AttachmentEntry, UseAttachmentsOptions, UseAttachmentsReturn, AttachmentChipListProps, } from "./attachment/index.js";
+export { useAttachments, AttachmentChipList, MAX_ATTACHMENT_BYTES, MAX_VISION_LONG_EDGE_PX, MAX_VISION_PIXELS, detectContentType, exceedsVisionResolution, extractClipboardFiles, fitToVisionResolution, formatFileSize, prepareImageForVision, uniquifyFilename, validateAttachmentSize, } from "./attachment/index.js";
+export type { AttachmentPhase, AttachmentEntry, ClipboardFilesSource, UseAttachmentsOptions, UseAttachmentsReturn, AttachmentChipListProps, VisionFitSize, } from "./attachment/index.js";
 export { useFileReferences, FileReferenceChipList, } from "./file-reference/index.js";
 export type { UseFileReferencesReturn, FileReferenceChipListProps, } from "./file-reference/index.js";
 export { FILE_REF_MIME } from "./internal/file-tree/index.js";
@@ -91,6 +91,10 @@ export { useSharedAgentProfile, SharedAgentChat, draftFromShare, sharingAudience
 export type { UseSharedAgentProfileOptions, UseSharedAgentProfileReturn, SharedAgentChatProps, AgentShareCreateIdentity, AgentShareDraft, SharingAudience, UseAgentSharesReturn, UseCanCreateAgentShareReturn, UseSaveAgentShareReturn, UseDeleteAgentShareReturn, UseRotateShareLinkReturn, ShareAgentDialogProps, AgentShareListProps, ShareToolReadiness, } from "./sharing/index.js";
 export { useAgentChannelList, useAgentChannel, useSaveAgentChannel, agentChannelToInput, useCreateAgentChannel, useDeleteAgentChannel, useConnectSlackChannel, useInstallChannel, useChannelToolReadiness, useChannelTemplateReadiness, useChannelSessions, useChannelTemplateList, templateStatusPhase, splitTemplateBody, AgentChannelsPanel, ConnectSlackDialog, ConnectWhatsAppDialog, ChannelCredentialsDialog, ChannelToolCredentials, ChannelConversationsDialog, ChannelTemplatesDialog, } from "./channel/index.js";
 export type { UseAgentChannelListReturn, UseAgentChannelReturn, UseSaveAgentChannelReturn, UseCreateAgentChannelReturn, UseDeleteAgentChannelReturn, UseConnectSlackChannelReturn, SlackConnectPhase, UseInstallChannelReturn, InstallChannelPhase, ChannelTemplateReadiness, UseChannelSessionsReturn, UseChannelTemplateListOptions, UseChannelTemplateListReturn, TemplateBodySegment, AgentChannelsPanelProps, ConnectSlackDialogProps, ConnectWhatsAppDialogProps, ChannelCredentialsDialogProps, ChannelToolCredentialsProps, ChannelConversationsDialogProps, ChannelTemplatesDialogProps, } from "./channel/index.js";
+export { ConversationsWorkbench, ConversationListPane, ConversationTimelineView, ConversationControlBanner, ConversationAttentionBanner, ConversationComposer, useConversation, useConversationList, useConversationTimeline, useConversationParticipation, useConversationsWantsHumanCount, authorKindOf, awaitingIndicatorOf, compareTimelineItemsNewestFirst, conversationContactOf, conversationLabelOf, inboundPlaceholderOf, isInternalItem, receiptOf, sendAttemptOf, serviceWindowOf, CONVERSATION_BADGE_POLL_INTERVAL_MS, CONVERSATION_DETAIL_POLL_INTERVAL_MS, CONVERSATION_LIST_POLL_INTERVAL_MS, } from "./conversation/index.js";
+export type { ConversationsWorkbenchProps, ConversationHeaderContext, ConversationIdentity, ConversationListPaneProps, ConversationTimelineViewProps, ConversationControlBannerProps, ConversationAttentionBannerProps, ConversationComposerProps, UseConversationOptions, UseConversationReturn, UseConversationListOptions, UseConversationListReturn, UseConversationTimelineOptions, UseConversationTimelineReturn, ConversationCommand, UseConversationParticipationOptions, UseConversationParticipationReturn, UseConversationsWantsHumanCountOptions, UseConversationsWantsHumanCountReturn, AwaitingIndicator, ConversationAuthorKind, ReceiptKind, SendAttemptKind, ServiceWindowState, } from "./conversation/index.js";
+export { ChannelConversationListFilter, ConversationControl, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+export type { ChannelConversation, ConversationTimelineItem, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
 export { ErrorMessage, SecretFlowErrorGuide, isSecretFlowError } from "./error/index.js";
 export type { ErrorMessageProps, SecretFlowErrorGuideProps } from "./error/index.js";
 export { LibraryBreadcrumbProvider, useBreadcrumbLabel, useBreadcrumbOverride, ScopeToggle, ResourceCountCard, detectStigmerResource, useDetectStigmerResource, isSkillPackage, detectSkillPackage, useDetectSkillPackage, isPlanArtifact, isPlanArtifactName, findPlanArtifact, findLatestSessionPlan, findStreamingPlan, PLAN_ARTIFACT_NAME, PLAN_ARTIFACT_SUFFIX, useApplyResource, useExportResource, VisibilitySelector, VisibilityBadge, blueprintVisibilityLevels, INSTANCE_VISIBILITY_LEVELS, visibilityLabel, useUpdateVisibility, } from "./library/index.js";