@stigmer/react 3.6.0 → 3.8.0

package/conversation/ConversationsWorkbench.js.map

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

package/conversation/conversationPresentation.d.ts

@@ -0,0 +1,137 @@
+import { type ChannelConversation, type ConversationTimelineItem } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import type { ChannelProviderId } from "../channel/providers.js";
+/**
+ * Pure render vocabulary for the conversation surface — the single place
+ * the wire enums become words and layout facts (the providerPresentation
+ * convention). No React, no I/O; every component and every test reads the
+ * same mapping.
+ */
+/** Who authored a timeline item, in render vocabulary. */
+export type ConversationAuthorKind = "customer" | "agent" | "teammate" | "platform" | "unknown";
+/** Map the wire author onto the render vocabulary. */
+export declare function authorKindOf(item: ConversationTimelineItem): ConversationAuthorKind;
+/** True for org-internal items (escalations, attention clears, notes). */
+export declare function isInternalItem(item: ConversationTimelineItem): boolean;
+/**
+ * The platform's own send attempt, in render vocabulary. `null` on items
+ * that carry no attempt (inbound messages, internal events).
+ *
+ * `"suppressed"` and `"failed"` are items the customer NEVER saw and
+ * `"pending"`/`"delivering"` are items the customer has not seen YET —
+ * a renderer that shows any of them as a plain sent bubble lies to staff.
+ */
+export type SendAttemptKind = "pending" | "delivering" | "delivered" | "failed" | "suppressed";
+/** Map the wire delivery status onto the render vocabulary. */
+export declare function sendAttemptOf(item: ConversationTimelineItem): SendAttemptKind | null;
+/**
+ * The provider's receipt report, in render vocabulary. `null` until the
+ * provider reports (and always on items with no receipt axis).
+ *
+ * A SECOND axis beside {@link sendAttemptOf}, never collapsed into it
+ * (channel-conversations DD-004 D-d): "we handed it to WhatsApp" and
+ * "it reached the phone" are different facts — an item can be
+ * `delivered` + `receipt_failed`.
+ */
+export type ReceiptKind = "sent" | "delivered" | "read" | "failed";
+/** Map the wire receipt state onto the render vocabulary. */
+export declare function receiptOf(item: ConversationTimelineItem): ReceiptKind | null;
+/**
+ * Placeholder copy for inbound items whose body the platform cannot
+ * render (`text` empty, `provider_message_type` names the kind). Media
+ * retrieval is a named non-goal of this surface — the placeholder tells
+ * staff something arrived and what shape it was.
+ *
+ * Returns `null` when the item needs no placeholder (it has text, or it
+ * is not a provider-typed inbound item — e.g. an attention-clear event,
+ * whose copy is the renderer's own vocabulary).
+ */
+export declare function inboundPlaceholderOf(item: ConversationTimelineItem): string | null;
+/**
+ * The list-row label for a conversation: the provider-reported display
+ * name when one exists, else a provider-aware fallback.
+ *
+ * The fallback is provider-aware because conversation keys are not
+ * uniformly meaningful: WhatsApp's key is the customer's phone number
+ * (a real label), while Slack's key is a thread timestamp like
+ * `1723012345.678900` (noise a human cannot use).
+ */
+export declare function conversationLabelOf(conversation: ChannelConversation, provider: ChannelProviderId | null): string;
+/**
+ * The customer's reachable address, when the label hides it: the fact a
+ * staffer needs to call or message the customer outside the platform.
+ *
+ * Provider-aware like {@link conversationLabelOf}, because conversation
+ * keys are not uniformly addresses: WhatsApp's key IS the customer's
+ * phone number (the wa_id), and when a display name wins the label slot
+ * that number would otherwise appear nowhere on the surface. Slack's
+ * key is a thread timestamp — not a way to reach anyone — so there is
+ * nothing to show. Unknown providers show nothing rather than guess.
+ *
+ * Returns `null` when the label already shows the key (no display
+ * name), so the same fact never renders twice. The key returns
+ * verbatim — no fabricated `+` prefix: the wire value is the truth this
+ * module reports, and formatting belongs to hosts that know their
+ * display rules.
+ */
+export declare function conversationContactOf(conversation: ChannelConversation, provider: ChannelProviderId | null): string | null;
+/** The service-window estimate, in render vocabulary. */
+export type ServiceWindowState = "open" | "closed";
+/**
+ * Estimate whether the provider's free-form reply window is open
+ * (channel-conversations DD-014 D-a). Provider-aware like
+ * {@link conversationLabelOf}: WhatsApp is the only windowed provider, so
+ * every other provider answers `null` — no window, no claim — as does a
+ * conversation whose customer has never written
+ * (`last_customer_message_at` unset; that conversation takes the
+ * composer's disabled branch instead).
+ *
+ * Client-derived on purpose, and NOT a divergence from DD-011 A-1's
+ * "the predicate is expressed once, in SQL" rule: the window is
+ * wall-clock-anchored — it flips with NO row change — so a
+ * server-computed boolean would be stale by construction between polls.
+ * Time-decaying presentation derived from wire instants is this
+ * surface's established class (relative timestamps, day grouping).
+ *
+ * Honesty caveat (DD-014 D-a): the anchor is the platform's receipt
+ * instant, minutes AFTER Meta's own clock started the window, so the
+ * estimate can claim "open" briefly after Meta closed it — which is why
+ * consumers warn and never block (D-b). For the same reason the exact
+ * 24-hour tie reads "closed": erring a moment early offsets an anchor
+ * that always errs late.
+ */
+export declare function serviceWindowOf(conversation: ChannelConversation, provider: ChannelProviderId | null, now: Date): ServiceWindowState | null;
+/**
+ * How strongly the awaiting-reply indicator renders. Two strengths, not
+ * one, because "waiting" means different things per holder (DD-011 D-a).
+ */
+export type AwaitingIndicator = "strong" | "muted";
+/**
+ * The awaiting-reply indicator for a conversation (channel-conversations
+ * DD-011 D-a): `"strong"` when a human holds it — the agent will not
+ * answer, so a person must (F-13's exact case) — and `"muted"` when the
+ * agent holds it: the agent is about to answer, and if its turn dies the
+ * conversation stays visibly waiting, which is the built-in recovery
+ * path (DD-011 D-b). `null` when the customer's last message has been
+ * answered (or the customer has not written).
+ *
+ * The fact itself is server-derived (`awaiting_reply` rides the wire as
+ * a boolean precisely so no client re-implements the NULL-and-compare
+ * rule); this helper only maps fact × holder onto render strength.
+ */
+export declare function awaitingIndicatorOf(conversation: ChannelConversation): AwaitingIndicator | null;
+/**
+ * The timeline item id an accepted staff reply appears under: the
+ * outbound ledger's `ob:` namespace over the reply output's
+ * `outbound_message_id` — the contract
+ * `useConversationParticipation.reply` documents ("the item will
+ * appear on the timeline as `ob:<that id>`"). The workbench's
+ * post-send busy state watches for exactly this id (F-05).
+ */
+export declare function outboundItemIdOf(outboundMessageId: string): string;
+/**
+ * Newest-first timeline order: `(at, item_id)` descending — the exact
+ * comparator the server pages with, so client-side merges can never
+ * disagree with server pages about order.
+ */
+export declare function compareTimelineItemsNewestFirst(a: ConversationTimelineItem, b: ConversationTimelineItem): number;
+//# sourceMappingURL=conversationPresentation.d.ts.map

package/conversation/conversationPresentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationPresentation.d.ts","sourceRoot":"","sources":["../../src/conversation/conversationPresentation.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,mBAAmB,EAIxB,KAAK,wBAAwB,EAC9B,MAAM,uEAAuE,CAAC;AAG/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;GAKG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,CAAC;AAEd,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,wBAAwB,GAAG,sBAAsB,CAanF;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAEtE;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,YAAY,CAAC;AAEjB,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,IAAI,EAAE,wBAAwB,GAAG,eAAe,GAAG,IAAI,CAepF;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnE,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,wBAAwB,GAAG,WAAW,GAAG,IAAI,CAa5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,GAAG,IAAI,CAwBlF;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,mBAAmB,EACjC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GACjC,MAAM,CAIR;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,mBAAmB,EACjC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GACjC,MAAM,GAAG,IAAI,CAIf;AAYD,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,mBAAmB,EACjC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,EAClC,GAAG,EAAE,IAAI,GACR,kBAAkB,GAAG,IAAI,CAM3B;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,mBAAmB,GAChC,iBAAiB,GAAG,IAAI,CAK1B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,CAAC,EAAE,wBAAwB,EAC3B,CAAC,EAAE,wBAAwB,GAC1B,MAAM,CAIR"}

package/conversation/conversationPresentation.js

@@ -0,0 +1,230 @@
+import { timestampDate } from "@bufbuild/protobuf/wkt";
+import { ConversationControl, ConversationItemAuthor, ConversationLane, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import { ChannelDeliveryStatus } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/delivery_pb";
+import { ChannelReceiptState } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/outbound_pb";
+/** Map the wire author onto the render vocabulary. */
+export function authorKindOf(item) {
+    switch (item.author) {
+        case ConversationItemAuthor.author_customer:
+            return "customer";
+        case ConversationItemAuthor.author_agent:
+            return "agent";
+        case ConversationItemAuthor.author_teammate:
+            return "teammate";
+        case ConversationItemAuthor.author_platform:
+            return "platform";
+        default:
+            return "unknown";
+    }
+}
+/** True for org-internal items (escalations, attention clears, notes). */
+export function isInternalItem(item) {
+    return item.lane === ConversationLane.lane_internal;
+}
+/** Map the wire delivery status onto the render vocabulary. */
+export function sendAttemptOf(item) {
+    switch (item.deliveryStatus) {
+        case ChannelDeliveryStatus.pending:
+            return "pending";
+        case ChannelDeliveryStatus.delivering:
+            return "delivering";
+        case ChannelDeliveryStatus.delivered:
+            return "delivered";
+        case ChannelDeliveryStatus.failed:
+            return "failed";
+        case ChannelDeliveryStatus.suppressed:
+            return "suppressed";
+        default:
+            return null;
+    }
+}
+/** Map the wire receipt state onto the render vocabulary. */
+export function receiptOf(item) {
+    switch (item.receiptState) {
+        case ChannelReceiptState.receipt_sent:
+            return "sent";
+        case ChannelReceiptState.receipt_delivered:
+            return "delivered";
+        case ChannelReceiptState.receipt_read:
+            return "read";
+        case ChannelReceiptState.receipt_failed:
+            return "failed";
+        default:
+            return null;
+    }
+}
+/**
+ * Placeholder copy for inbound items whose body the platform cannot
+ * render (`text` empty, `provider_message_type` names the kind). Media
+ * retrieval is a named non-goal of this surface — the placeholder tells
+ * staff something arrived and what shape it was.
+ *
+ * Returns `null` when the item needs no placeholder (it has text, or it
+ * is not a provider-typed inbound item — e.g. an attention-clear event,
+ * whose copy is the renderer's own vocabulary).
+ */
+export function inboundPlaceholderOf(item) {
+    if (item.text !== "" || item.providerMessageType === "")
+        return null;
+    switch (item.providerMessageType) {
+        case "text":
+            return null;
+        case "image":
+            return "Photo";
+        case "video":
+            return "Video";
+        case "audio":
+            return "Voice message";
+        case "document":
+            return "Document";
+        case "sticker":
+            return "Sticker";
+        case "location":
+            return "Location";
+        case "contacts":
+            return "Contact card";
+        default:
+            // The provider's vocabulary passes through verbatim (never
+            // re-encoded), so an unknown kind still names itself.
+            return `Unsupported message (${item.providerMessageType})`;
+    }
+}
+/**
+ * The list-row label for a conversation: the provider-reported display
+ * name when one exists, else a provider-aware fallback.
+ *
+ * The fallback is provider-aware because conversation keys are not
+ * uniformly meaningful: WhatsApp's key is the customer's phone number
+ * (a real label), while Slack's key is a thread timestamp like
+ * `1723012345.678900` (noise a human cannot use).
+ */
+export function conversationLabelOf(conversation, provider) {
+    if (conversation.displayName !== "")
+        return conversation.displayName;
+    if (provider === "slack")
+        return "Slack thread";
+    return conversation.conversationKey;
+}
+/**
+ * The customer's reachable address, when the label hides it: the fact a
+ * staffer needs to call or message the customer outside the platform.
+ *
+ * Provider-aware like {@link conversationLabelOf}, because conversation
+ * keys are not uniformly addresses: WhatsApp's key IS the customer's
+ * phone number (the wa_id), and when a display name wins the label slot
+ * that number would otherwise appear nowhere on the surface. Slack's
+ * key is a thread timestamp — not a way to reach anyone — so there is
+ * nothing to show. Unknown providers show nothing rather than guess.
+ *
+ * Returns `null` when the label already shows the key (no display
+ * name), so the same fact never renders twice. The key returns
+ * verbatim — no fabricated `+` prefix: the wire value is the truth this
+ * module reports, and formatting belongs to hosts that know their
+ * display rules.
+ */
+export function conversationContactOf(conversation, provider) {
+    if (provider !== "whatsapp")
+        return null;
+    if (conversation.displayName === "")
+        return null;
+    return conversation.conversationKey;
+}
+/**
+ * Meta's customer-service window: a business can send free-form WhatsApp
+ * messages for 24 hours after the customer's last inbound message; after
+ * that, only template messages deliver. The constant lives beside its
+ * only consumer and is promoted to `ChannelProviderDescriptor` only if a
+ * second windowed provider ever appears (the second-sighting rule,
+ * DD-014 D-a).
+ */
+const WHATSAPP_SERVICE_WINDOW_MS = 24 * 60 * 60 * 1000;
+/**
+ * Estimate whether the provider's free-form reply window is open
+ * (channel-conversations DD-014 D-a). Provider-aware like
+ * {@link conversationLabelOf}: WhatsApp is the only windowed provider, so
+ * every other provider answers `null` — no window, no claim — as does a
+ * conversation whose customer has never written
+ * (`last_customer_message_at` unset; that conversation takes the
+ * composer's disabled branch instead).
+ *
+ * Client-derived on purpose, and NOT a divergence from DD-011 A-1's
+ * "the predicate is expressed once, in SQL" rule: the window is
+ * wall-clock-anchored — it flips with NO row change — so a
+ * server-computed boolean would be stale by construction between polls.
+ * Time-decaying presentation derived from wire instants is this
+ * surface's established class (relative timestamps, day grouping).
+ *
+ * Honesty caveat (DD-014 D-a): the anchor is the platform's receipt
+ * instant, minutes AFTER Meta's own clock started the window, so the
+ * estimate can claim "open" briefly after Meta closed it — which is why
+ * consumers warn and never block (D-b). For the same reason the exact
+ * 24-hour tie reads "closed": erring a moment early offsets an anchor
+ * that always errs late.
+ */
+export function serviceWindowOf(conversation, provider, now) {
+    if (provider !== "whatsapp")
+        return null;
+    const anchor = conversation.lastCustomerMessageAt;
+    if (anchor === undefined)
+        return null;
+    const elapsedMs = now.getTime() - timestampDate(anchor).getTime();
+    return elapsedMs >= WHATSAPP_SERVICE_WINDOW_MS ? "closed" : "open";
+}
+/**
+ * The awaiting-reply indicator for a conversation (channel-conversations
+ * DD-011 D-a): `"strong"` when a human holds it — the agent will not
+ * answer, so a person must (F-13's exact case) — and `"muted"` when the
+ * agent holds it: the agent is about to answer, and if its turn dies the
+ * conversation stays visibly waiting, which is the built-in recovery
+ * path (DD-011 D-b). `null` when the customer's last message has been
+ * answered (or the customer has not written).
+ *
+ * The fact itself is server-derived (`awaiting_reply` rides the wire as
+ * a boolean precisely so no client re-implements the NULL-and-compare
+ * rule); this helper only maps fact × holder onto render strength.
+ */
+export function awaitingIndicatorOf(conversation) {
+    if (!conversation.awaitingReply)
+        return null;
+    return conversation.control === ConversationControl.control_human
+        ? "strong"
+        : "muted";
+}
+/**
+ * The timeline item id an accepted staff reply appears under: the
+ * outbound ledger's `ob:` namespace over the reply output's
+ * `outbound_message_id` — the contract
+ * `useConversationParticipation.reply` documents ("the item will
+ * appear on the timeline as `ob:<that id>`"). The workbench's
+ * post-send busy state watches for exactly this id (F-05).
+ */
+export function outboundItemIdOf(outboundMessageId) {
+    return `ob:${outboundMessageId}`;
+}
+/**
+ * Newest-first timeline order: `(at, item_id)` descending — the exact
+ * comparator the server pages with, so client-side merges can never
+ * disagree with server pages about order.
+ */
+export function compareTimelineItemsNewestFirst(a, b) {
+    const byInstant = compareInstants(b.at, a.at);
+    if (byInstant !== 0)
+        return byInstant;
+    return a.itemId < b.itemId ? 1 : a.itemId > b.itemId ? -1 : 0;
+}
+// BigInt() call form, not a 0n literal: the web console compiles SDK
+// sources under a pre-ES2020 target where the literal is a syntax error.
+const ZERO_SECONDS = BigInt(0);
+function compareInstants(a, b) {
+    // A missing instant sorts oldest — the server always stamps `at`, so
+    // this only orders a defensively-handled corrupt item to the top of
+    // history rather than crashing the sort.
+    const aSeconds = a?.seconds ?? ZERO_SECONDS;
+    const bSeconds = b?.seconds ?? ZERO_SECONDS;
+    if (aSeconds !== bSeconds)
+        return aSeconds < bSeconds ? -1 : 1;
+    const aNanos = a?.nanos ?? 0;
+    const bNanos = b?.nanos ?? 0;
+    return aNanos - bNanos;
+}
+//# sourceMappingURL=conversationPresentation.js.map

package/conversation/conversationPresentation.js.map

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

package/conversation/index.d.ts

@@ -0,0 +1,26 @@
+export { ConversationsWorkbench } from "./ConversationsWorkbench.js";
+export type { ConversationHeaderContext, ConversationsWorkbenchProps, } from "./ConversationsWorkbench.js";
+export { ConversationListPane } from "./ConversationListPane.js";
+export type { ConversationIdentity, ConversationListPaneProps, } from "./ConversationListPane.js";
+export { ConversationTimelineView } from "./ConversationTimelineView.js";
+export type { ConversationTimelineViewProps } from "./ConversationTimelineView.js";
+export { ConversationControlBanner } from "./ConversationControlBanner.js";
+export type { ConversationControlBannerProps } from "./ConversationControlBanner.js";
+export { ConversationAttentionBanner } from "./ConversationAttentionBanner.js";
+export type { ConversationAttentionBannerProps } from "./ConversationAttentionBanner.js";
+export { ConversationComposer } from "./ConversationComposer.js";
+export type { ConversationComposerProps } from "./ConversationComposer.js";
+export { useConversation } from "./useConversation.js";
+export type { UseConversationOptions, UseConversationReturn, } from "./useConversation.js";
+export { useConversationList } from "./useConversationList.js";
+export type { UseConversationListOptions, UseConversationListReturn, } from "./useConversationList.js";
+export { useConversationTimeline } from "./useConversationTimeline.js";
+export type { UseConversationTimelineOptions, UseConversationTimelineReturn, } from "./useConversationTimeline.js";
+export { useConversationParticipation } from "./useConversationParticipation.js";
+export type { ConversationCommand, UseConversationParticipationOptions, UseConversationParticipationReturn, } from "./useConversationParticipation.js";
+export { useConversationsWantsHumanCount } from "./useConversationsWantsHumanCount.js";
+export type { UseConversationsWantsHumanCountOptions, UseConversationsWantsHumanCountReturn, } from "./useConversationsWantsHumanCount.js";
+export { authorKindOf, awaitingIndicatorOf, compareTimelineItemsNewestFirst, conversationContactOf, conversationLabelOf, inboundPlaceholderOf, isInternalItem, receiptOf, sendAttemptOf, serviceWindowOf, } from "./conversationPresentation.js";
+export type { AwaitingIndicator, ConversationAuthorKind, ReceiptKind, SendAttemptKind, ServiceWindowState, } from "./conversationPresentation.js";
+export { CONVERSATION_BADGE_POLL_INTERVAL_MS, CONVERSATION_DETAIL_POLL_INTERVAL_MS, CONVERSATION_LIST_POLL_INTERVAL_MS, } from "./polling.js";
+//# sourceMappingURL=index.d.ts.map

package/conversation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EACV,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EACV,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAEnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,YAAY,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAErF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,YAAY,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AAEzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,YAAY,EACV,mBAAmB,EACnB,mCAAmC,EACnC,kCAAkC,GACnC,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,YAAY,EACV,sCAAsC,EACtC,qCAAqC,GACtC,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,+BAA+B,EAC/B,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,aAAa,EACb,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,EACX,eAAe,EACf,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,mCAAmC,EACnC,oCAAoC,EACpC,kCAAkC,GACnC,MAAM,cAAc,CAAC"}

package/conversation/index.js

@@ -0,0 +1,14 @@
+export { ConversationsWorkbench } from "./ConversationsWorkbench.js";
+export { ConversationListPane } from "./ConversationListPane.js";
+export { ConversationTimelineView } from "./ConversationTimelineView.js";
+export { ConversationControlBanner } from "./ConversationControlBanner.js";
+export { ConversationAttentionBanner } from "./ConversationAttentionBanner.js";
+export { ConversationComposer } from "./ConversationComposer.js";
+export { useConversation } from "./useConversation.js";
+export { useConversationList } from "./useConversationList.js";
+export { useConversationTimeline } from "./useConversationTimeline.js";
+export { useConversationParticipation } from "./useConversationParticipation.js";
+export { useConversationsWantsHumanCount } from "./useConversationsWantsHumanCount.js";
+export { authorKindOf, awaitingIndicatorOf, compareTimelineItemsNewestFirst, conversationContactOf, conversationLabelOf, inboundPlaceholderOf, isInternalItem, receiptOf, sendAttemptOf, serviceWindowOf, } from "./conversationPresentation.js";
+export { CONVERSATION_BADGE_POLL_INTERVAL_MS, CONVERSATION_DETAIL_POLL_INTERVAL_MS, CONVERSATION_LIST_POLL_INTERVAL_MS, } from "./polling.js";
+//# sourceMappingURL=index.js.map

package/conversation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAMrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAMjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAG3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAG/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAM/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAMvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAOjF,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAMvF,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,+BAA+B,EAC/B,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,aAAa,EACb,eAAe,GAChB,MAAM,+BAA+B,CAAC;AASvC,OAAO,EACL,mCAAmC,EACnC,oCAAoC,EACpC,kCAAkC,GACnC,MAAM,cAAc,CAAC"}

package/conversation/polling.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Liveness for the conversation surface is HONEST POLLING (channel-
+ * conversations DD-012) — no streaming or watch RPC exists on the
+ * conversation query controller, and none ships until a revisit trigger
+ * fires (a real push consumer, or sub-second liveness becoming a product
+ * property). These constants are the deliberate transport seam: hooks
+ * default to them, consumers may override per instance, and when
+ * push-shaped liveness lands the defaults change here without touching a
+ * consumer.
+ *
+ * The latency budget is a stated contract (DD-012 D-b), not an accident
+ * of three numbers:
+ *
+ * | Surface                                  | Budget                       | Mechanism                                        |
+ * | ---------------------------------------- | ---------------------------- | ------------------------------------------------ |
+ * | Your own action (take over, hand back,   | immediate                    | command answer applied to the detail AND list    |
+ * | dismiss, reply)                          |                              | `applyServerState` seams — zero polls involved   |
+ * | The open conversation (row + timeline)   | ≤ 5s                         | detail polls                                     |
+ * | The inbox list                           | ≤ 20s, immediate on refocus  | list poll + focus refetch                        |
+ * | The nav badge                            | ≤ 60s, immediate on refocus  | count poll (the filtered list's `total_count`)   |
+ */
+/** Default poll interval for the org-wide conversation list. */
+export declare const CONVERSATION_LIST_POLL_INTERVAL_MS = 20000;
+/**
+ * Default poll interval for the OPEN conversation (its row and its
+ * timeline head). Tighter than the list on purpose: this is where a
+ * teammate's takeover or the customer's next message must appear while
+ * a human is watching.
+ */
+export declare const CONVERSATION_DETAIL_POLL_INTERVAL_MS = 5000;
+/**
+ * Default poll interval for the sidebar's wants-human count. Deliberately
+ * the slowest budget on the surface: a badge tolerates staleness an open
+ * inbox does not, it renders on every console page in every tab, and each
+ * tick pays an FGA ListObjects before the count (DD-011 D-g's stated
+ * price). Focus refetch keeps it honest at the moment someone returns.
+ */
+export declare const CONVERSATION_BADGE_POLL_INTERVAL_MS = 60000;
+//# sourceMappingURL=polling.d.ts.map

package/conversation/polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/conversation/polling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,gEAAgE;AAChE,eAAO,MAAM,kCAAkC,QAAS,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,OAAQ,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC,QAAS,CAAC"}

package/conversation/polling.js

@@ -0,0 +1,39 @@
+/**
+ * Liveness for the conversation surface is HONEST POLLING (channel-
+ * conversations DD-012) — no streaming or watch RPC exists on the
+ * conversation query controller, and none ships until a revisit trigger
+ * fires (a real push consumer, or sub-second liveness becoming a product
+ * property). These constants are the deliberate transport seam: hooks
+ * default to them, consumers may override per instance, and when
+ * push-shaped liveness lands the defaults change here without touching a
+ * consumer.
+ *
+ * The latency budget is a stated contract (DD-012 D-b), not an accident
+ * of three numbers:
+ *
+ * | Surface                                  | Budget                       | Mechanism                                        |
+ * | ---------------------------------------- | ---------------------------- | ------------------------------------------------ |
+ * | Your own action (take over, hand back,   | immediate                    | command answer applied to the detail AND list    |
+ * | dismiss, reply)                          |                              | `applyServerState` seams — zero polls involved   |
+ * | The open conversation (row + timeline)   | ≤ 5s                         | detail polls                                     |
+ * | The inbox list                           | ≤ 20s, immediate on refocus  | list poll + focus refetch                        |
+ * | The nav badge                            | ≤ 60s, immediate on refocus  | count poll (the filtered list's `total_count`)   |
+ */
+/** Default poll interval for the org-wide conversation list. */
+export const CONVERSATION_LIST_POLL_INTERVAL_MS = 20_000;
+/**
+ * Default poll interval for the OPEN conversation (its row and its
+ * timeline head). Tighter than the list on purpose: this is where a
+ * teammate's takeover or the customer's next message must appear while
+ * a human is watching.
+ */
+export const CONVERSATION_DETAIL_POLL_INTERVAL_MS = 5_000;
+/**
+ * Default poll interval for the sidebar's wants-human count. Deliberately
+ * the slowest budget on the surface: a badge tolerates staleness an open
+ * inbox does not, it renders on every console page in every tab, and each
+ * tick pays an FGA ListObjects before the count (DD-011 D-g's stated
+ * price). Focus refetch keeps it honest at the moment someone returns.
+ */
+export const CONVERSATION_BADGE_POLL_INTERVAL_MS = 60_000;
+//# sourceMappingURL=polling.js.map

package/conversation/polling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.js","sourceRoot":"","sources":["../../src/conversation/polling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,kCAAkC,GAAG,MAAM,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,KAAK,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,MAAM,CAAC"}

package/conversation/useConversation.d.ts

@@ -0,0 +1,61 @@
+import type { ChannelConversation } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+/** Options for {@link useConversation}. */
+export interface UseConversationOptions {
+    /**
+     * Poll interval in milliseconds; `false` disables polling. Defaults to
+     * {@link CONVERSATION_DETAIL_POLL_INTERVAL_MS} — the open conversation
+     * is where another teammate's takeover must appear promptly.
+     */
+    readonly refetchIntervalMs?: number | false;
+}
+/** Return value of {@link useConversation}. */
+export interface UseConversationReturn {
+    /**
+     * The conversation's participation state, or `null` while loading and
+     * while the conversation does not exist yet (see
+     * {@link awaitingCustomer} for the distinction).
+     */
+    readonly conversation: ChannelConversation | null;
+    /**
+     * `true` when the server answered NOT_FOUND: no conversation row
+     * exists yet for this key. NOT an error — a proactive cold-send can
+     * have a timeline before the customer ever writes, and the row is
+     * created by the customer's first message. Render it as
+     * "participation controls unlock when the customer writes".
+     */
+    readonly awaitingCustomer: boolean;
+    /** `true` only until the first answer (row or NOT_FOUND) arrives. */
+    readonly isLoading: boolean;
+    /** `true` while a background poll is in flight and stale state shows. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request (NOT_FOUND excluded), or `null`. */
+    readonly error: Error | null;
+    /** Imperatively re-read the row. */
+    readonly refetch: () => void;
+    /**
+     * Adopt a fresh row the server just returned — every participation
+     * command answers the post-command state (including for the loser of
+     * a concurrent-takeover race), and that answer is newer than anything
+     * a poll already in flight will deliver. Applying it also fences
+     * those in-flight polls so a stale answer can never overwrite it.
+     */
+    readonly applyServerState: (fresh: ChannelConversation) => void;
+}
+/**
+ * Data hook for one conversation's identity and participation state —
+ * the single-row read behind a conversation detail view (who holds
+ * control, whether attention is needed and why, the display name).
+ *
+ * Deliberately NOT built on the shared `useFetch`: participation
+ * commands hand back fresher state than any in-flight poll
+ * ({@link UseConversationReturn.applyServerState}), which needs a write
+ * fence over the fetch state — a seam `useFetch`'s single-writer model
+ * does not have. The fence is an epoch counter: applying server state
+ * bumps it, and a poll that started under an older epoch discards its
+ * answer instead of resurrecting pre-command state under the user's
+ * cursor.
+ *
+ * Pass empty strings to skip fetching (the `null`-fetchFn convention).
+ */
+export declare function useConversation(agentChannelId: string, conversationKey: string, options?: UseConversationOptions): UseConversationReturn;
+//# sourceMappingURL=useConversation.d.ts.map

package/conversation/useConversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversation.d.ts","sourceRoot":"","sources":["../../src/conversation/useConversation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uEAAuE,CAAC;AAUjH,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC7C;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACjE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,qBAAqB,CA8IvB"}