@flamingo-stack/openframe-frontend-core 0.0.204 → 0.0.205

package/dist/components/chat/entity-cards/slack-message-card.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Slack Message Card — unified visual for slack-messages markers.
+ *
+ * PURE PRESENTATION (no internal nav). The card receives the structured
+ * `<a>` prop bundle via `anchorProps` (composed by the caller from a
+ * runtime hook) and renders the rest from the `SlackMessageItem` shape
+ * directly.
+ */
+import React from 'react';
+import type { SlackMessageItem } from '../types/entities/slack-message';
+export interface SlackMessageCardAnchorProps {
+    href: string;
+    target?: '_blank';
+    rel?: 'noopener noreferrer';
+    onClick?: (e: React.MouseEvent<HTMLAnchorElement>) => void;
+}
+export interface SlackMessageCardProps {
+    item: SlackMessageItem;
+    variant?: 'row' | 'compact';
+    className?: string;
+    anchorProps?: SlackMessageCardAnchorProps;
+}
+export declare function SlackMessageCard({ item, variant, className, anchorProps }: SlackMessageCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function SlackMessageCardSkeleton({ variant, className }: {
+    variant?: 'row' | 'compact';
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=slack-message-card.d.ts.map

package/dist/components/chat/entity-cards/slack-message-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-message-card.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/entity-cards/slack-message-card.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAmBzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAEvE,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,GAAG,CAAC,EAAE,qBAAqB,CAAA;IAC3B,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAA;CAC3D;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,gBAAgB,CAAA;IACtB,OAAO,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,2BAA2B,CAAA;CAC1C;AAgBD,wBAAgB,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAmB,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,qBAAqB,2CAwF5G;AAED,wBAAgB,wBAAwB,CAAC,EAAE,OAAmB,EAAE,SAAS,EAAE,EAAE;IAAE,OAAO,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,2CA+B/H"}

package/dist/components/chat/entity-cards/task-type-icon.d.ts

@@ -0,0 +1,6 @@
+export interface TaskTypeIconProps {
+    customItemId: number | null | undefined;
+    className?: string;
+}
+export declare function TaskTypeIcon({ customItemId, className }: TaskTypeIconProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=task-type-icon.d.ts.map

package/dist/components/chat/entity-cards/task-type-icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-type-icon.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/entity-cards/task-type-icon.tsx"],"names":[],"mappings":"AAmDA,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,YAAY,CAAC,EAAE,YAAY,EAAE,SAAqB,EAAE,EAAE,iBAAiB,2CAGtF"}

package/dist/components/chat/hooks/index.d.ts

@@ -3,4 +3,14 @@ export * from './use-collapsible';
 export * from './use-jetstream-dialog-subscription';
 export * from './use-nats-dialog-subscription';
 export * from './use-realtime-chunk-processor';
+export * from './use-slash-commands';
+export * from './use-chat-attachments';
+export * from './use-chat-attachment-image-gallery';
+export * from './use-chat-identity';
+export * from './use-chat-card-item';
+export * from './use-close-on-navigation';
+export * from './use-chat';
+export * from './use-sse';
+export * from './use-embedded-chat';
+export * from './use-proxied-image-url';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/chat/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/index.ts"],"names":[],"mappings":"AAEA,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qCAAqC,CAAA;AACnD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,gCAAgC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/index.ts"],"names":[],"mappings":"AAEA,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qCAAqC,CAAA;AACnD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,gCAAgC,CAAA;AAG9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qCAAqC,CAAA;AACnD,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AAMzC,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,qBAAqB,CAAA;AAMnC,cAAc,yBAAyB,CAAA"}

package/dist/components/chat/hooks/use-chat-attachment-image-gallery.d.ts

@@ -0,0 +1,5 @@
+export declare function useChatAttachmentImageGallery(): {
+    panelRef: import("react").RefObject<HTMLDivElement | null>;
+    modal: import("react/jsx-runtime").JSX.Element | null;
+};
+//# sourceMappingURL=use-chat-attachment-image-gallery.d.ts.map

package/dist/components/chat/hooks/use-chat-attachment-image-gallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-attachment-image-gallery.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-chat-attachment-image-gallery.tsx"],"names":[],"mappings":"AAsCA,wBAAgB,6BAA6B;;;EA8D5C"}

package/dist/components/chat/hooks/use-chat-attachments.d.ts

@@ -0,0 +1,33 @@
+import type { ChatAttachment } from '../utils/chat-attachment-markdown';
+type Status = 'sniffing' | 'uploading' | 'ready' | 'error';
+/** Internal staged-attachment shape (more fields than the wire
+ *  `ChatAttachment` — carries state-machine metadata). */
+export interface StagedAttachment {
+    /** Stable client-side id; survives across re-renders. */
+    id: string;
+    file: File;
+    status: Status;
+    /** Set when `status === 'ready'`. Server-issued. */
+    storagePath?: string;
+    /** Set when `status === 'ready'`. Server-issued HMAC view token. */
+    viewToken?: string;
+    /** 0-100 during 'uploading'. */
+    progress: number;
+    /** Set when `status === 'error'`. */
+    errorMessage?: string;
+}
+interface UseChatAttachmentsApi {
+    attachments: StagedAttachment[];
+    /** All staged files in 'ready' state, projected to the wire
+     *  `ChatAttachment` shape — pass to `sendMessage`'s `pendingAttachments`. */
+    readyAttachments: ChatAttachment[];
+    /** True iff any attachment is mid-upload — Send button reads this
+     *  to disable itself. */
+    hasInflightUploads: boolean;
+    addFiles: (files: FileList | File[]) => void;
+    removeAttachment: (id: string) => void;
+    clear: () => void;
+}
+export declare function useChatAttachments(): UseChatAttachmentsApi;
+export {};
+//# sourceMappingURL=use-chat-attachments.d.ts.map

package/dist/components/chat/hooks/use-chat-attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-attachments.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-chat-attachments.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAgBvE,KAAK,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAA;AAE1D;0DAC0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAYD,UAAU,qBAAqB;IAC7B,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B;iFAC6E;IAC7E,gBAAgB,EAAE,cAAc,EAAE,CAAA;IAClC;6BACyB;IACzB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,KAAK,IAAI,CAAA;IAC5C,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAiGD,wBAAgB,kBAAkB,IAAI,qBAAqB,CAkP1D"}

package/dist/components/chat/hooks/use-chat-card-item.d.ts

@@ -0,0 +1,7 @@
+export interface UseChatCardItemResult<T = unknown> {
+    item: T | undefined;
+    isLoading: boolean;
+    isError: boolean;
+}
+export declare function useChatCardItem<T = unknown>(type: string, id: string): UseChatCardItemResult<T>;
+//# sourceMappingURL=use-chat-card-item.d.ts.map

package/dist/components/chat/hooks/use-chat-card-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-card-item.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-chat-card-item.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,OAAO;IAChD,IAAI,EAAE,CAAC,GAAG,SAAS,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB;AAyCD,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EACzC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,qBAAqB,CAAC,CAAC,CAAC,CA6B1B"}

package/dist/components/chat/hooks/use-chat-identity.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Wire-shape for the `/api/chat/identity` route response. Mirrors
+ * the hub's `ChatIdentityResponse` (in `app/api/chat/identity/route.ts`)
+ * — kept in sync there. Lib-side declaration so the chat panel can
+ * compile without depending on hub-internal types.
+ */
+export interface ChatIdentityResponse {
+    authTier: 'session' | 'bearer-act-as' | 'anon';
+    source: string | null;
+    attachmentsEnabled: boolean;
+    /** Server-resolved display identity. `null` for anon. Read by the
+     *  chat panel for the greeting first-name — embedders DON'T pass
+     *  user info into the runtime; server is the single source of truth
+     *  so the displayed name always matches the auth tier.
+     *
+     *  All sub-fields are optional and may be `null`. Consumers MUST
+     *  treat missing values as "use empty string and skip the affected
+     *  UI line" — never substitute a placeholder. */
+    user: {
+        name: string | null;
+        email: string | null;
+        /** Optional first name supplied by the identity webservice.
+         *  When set, the chat greeting renders `Hey ${firstName}, I'm Mingo`.
+         *  When absent (null/undefined/empty), the greeting falls back to
+         *  the no-name variant `Hey, I'm Mingo`. The chat panel does NOT
+         *  derive `firstName` from `name.split(' ')[0]` anymore — this is
+         *  the dedicated authoritative source from the identity webservice. */
+        firstName?: string | null;
+        /** Optional last name. Currently unused by chat UI; surfaced for
+         *  embedders that want to display the full name elsewhere. */
+        lastName?: string | null;
+        /** Optional avatar URL. Validated as https:// server-side. */
+        avatarUrl?: string | null;
+    } | null;
+}
+/** Shape returned by the hook. NEVER throws — loading + error fall
+ *  back to anon defaults so consumers can always render synchronously. */
+export interface ChatIdentitySurface extends ChatIdentityResponse {
+    /** True while the query is in-flight on first mount; consumers that
+     *  show a skeleton spinner can read this. */
+    isLoading: boolean;
+}
+export declare function useChatIdentity(): ChatIdentitySurface;
+//# sourceMappingURL=use-chat-identity.d.ts.map

package/dist/components/chat/hooks/use-chat-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-identity.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-chat-identity.ts"],"names":[],"mappings":"AAwCA;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,GAAG,eAAe,GAAG,MAAM,CAAA;IAC9C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,kBAAkB,EAAE,OAAO,CAAA;IAC3B;;;;;;;qDAOiD;IACjD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB;;;;;+EAKuE;QACvE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACzB;sEAC8D;QAC9D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACxB,8DAA8D;QAC9D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC1B,GAAG,IAAI,CAAA;CACT;AAED;0EAC0E;AAC1E,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D;iDAC6C;IAC7C,SAAS,EAAE,OAAO,CAAA;CACnB;AASD,wBAAgB,eAAe,IAAI,mBAAmB,CA+CrD"}

package/dist/components/chat/hooks/use-chat.d.ts

@@ -0,0 +1,30 @@
+import { type StreamFn, type StreamFnExtraOptions } from './use-sse';
+import type { Message } from '../types/message.types';
+export type { Message } from '../types/message.types';
+export type { StreamFnExtraOptions } from './use-sse';
+interface UseChatOptions {
+    useMock?: boolean;
+    debugMode?: boolean;
+    assistantName?: string;
+    assistantAvatar?: string;
+    /** Custom stream function — bypasses mock/SSE service when provided */
+    streamFn?: StreamFn;
+    /** Initial messages (e.g., restored from localStorage). Evaluated once on mount. */
+    initialMessages?: Message[];
+    /** Called whenever the messages array changes — use for persistence. */
+    onMessagesChange?: (messages: Message[]) => void;
+}
+export declare function useChat({ useMock, debugMode, assistantName, assistantAvatar, streamFn, initialMessages, onMessagesChange, }?: UseChatOptions): {
+    messages: Message[];
+    isTyping: boolean;
+    isStreaming: boolean;
+    error: string | null;
+    sendMessage: (text: string, extra?: StreamFnExtraOptions, options?: {
+        hidden?: boolean;
+    }) => Promise<void>;
+    stopMessage: () => void;
+    handleQuickAction: (actionText: string) => void;
+    clearMessages: () => void;
+    hasMessages: boolean;
+};
+//# sourceMappingURL=use-chat.d.ts.map

package/dist/components/chat/hooks/use-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-chat.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,QAAQ,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAC5E,OAAO,KAAK,EACV,OAAO,EAGR,MAAM,wBAAwB,CAAA;AAI/B,YAAY,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAErD,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,oFAAoF;IACpF,eAAe,CAAC,EAAE,OAAO,EAAE,CAAA;IAC3B,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACjD;AAQD,wBAAgB,OAAO,CAAC,EACtB,OAAc,EACd,SAAiB,EACjB,aAAqB,EACrB,eAAe,EACf,QAAQ,EACR,eAAe,EACf,gBAAgB,GACjB,GAAE,cAAmB;;;;;wBA4CV,MAAM,UACJ,oBAAoB,YAOlB;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;;oCAoXnB,MAAM;;;EAkCtB"}

package/dist/components/chat/hooks/use-close-on-navigation.d.ts

@@ -0,0 +1,2 @@
+export declare function useCloseOnNavigation(close: () => void, pathname: string | null): void;
+//# sourceMappingURL=use-close-on-navigation.d.ts.map

package/dist/components/chat/hooks/use-close-on-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-close-on-navigation.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-close-on-navigation.ts"],"names":[],"mappings":"AAwDA,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,IAAI,EACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,IAAI,CA2BN"}

package/dist/components/chat/hooks/use-embedded-chat.d.ts

@@ -0,0 +1,174 @@
+import { type StreamFnExtraOptions } from './use-chat';
+import type { ChatRef } from '../chat-ref.types';
+import type { MessageSegment } from '../types/message.types';
+import { type ScrollAnchor } from '../utils/scroll-anchor';
+/** Source identifier — opaque string ID (registry lookup happens in the
+ *  hub-side platform-utils, not in lib). */
+export type DocSource = string;
+export interface ChatSource {
+    index: number;
+    name: string;
+    path: string;
+    documentType: string;
+    externalUrl?: string;
+    /** Platform that owns the destination at `externalUrl`. */
+    targetPlatform?: string | null;
+    /** Primary-key value for single-row chips. */
+    id?: string;
+    /** Per-row items for grouped chips. */
+    items?: Array<{
+        id: string;
+        documentType: string;
+        name: string;
+        externalUrl?: string;
+        targetPlatform?: string | null;
+        /** In-app doc-tree path for markdown / data-room-doc rows so the
+         *  grouped chip's anchor can trigger an in-page doc-tree swap via
+         *  `handleChatNavClick` (parity with single-row chips + cards). */
+        path?: string | null;
+    }>;
+    /** RagTableConfig.id for this source. */
+    sourceRepo?: string;
+    /** Optional display label override returned by the chat API. */
+    label?: string;
+}
+export interface DocChatMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    /** String form for legacy callers that just want the answer text; structured
+     *  segments include thinking blocks too, which the lib's
+     *  ChatMessageEnhanced renders as <ThinkingDisplay> cards. */
+    content: string;
+    /** Structured segments. When set, callers should prefer this over `content`. */
+    segments?: MessageSegment[];
+    sources?: ChatSource[];
+    /** Per-row refs for inline object-card rendering. Keyed by
+     *  `<documentType>:<primaryKey>`. Populated for assistant messages only. */
+    chatRefs?: Record<string, ChatRef>;
+    /** Per-message viewport-positioning hint emitted by the server. */
+    scrollAnchor?: ScrollAnchor;
+    /** When true the message is part of the conversation history but is
+     *  NOT rendered in the chat UI. */
+    hidden?: boolean;
+}
+/** Streaming phase exposed to the chat shell so it can render a "Thinking with
+ *  Sonnet 4.6 · 200K context window" status row above the input box.
+ *  - 'idle'      → no in-flight turn
+ *  - 'thinking'  → server emitted the leading {status:'thinking'} frame; no
+ *                  text token has arrived yet (adaptive-thinking phase)
+ *  - 'streaming' → first text token has arrived; model is generating answer */
+export type StreamingPhase = 'idle' | 'thinking' | 'streaming';
+/** Per-turn metadata extracted from the streamed metadata frame. */
+export interface ChatTurnMeta {
+    /** Provider key recognized by `<ModelDisplay>` for icon
+     *  selection: 'anthropic' | 'openai' | 'google' (case-insensitive). */
+    provider: string | null;
+    modelLabel: string | null;
+    contextWindowMaxTokens: number | null;
+    /** Input tokens (from message_start). Includes cached tokens. */
+    inputTokens: number | null;
+    /** Output tokens (from message_delta). Only known after stream end. */
+    outputTokens: number | null;
+    /** Cache hit % (read / total-input × 100). Only known after stream end. */
+    cacheHitRatePct: number | null;
+    /** Cross-call usage breakdown extracted from the trailing usage frame. */
+    breakdown: {
+        haikuRewriter?: {
+            input: number;
+            output: number;
+        };
+        haikuClassifier?: {
+            input: number;
+            output: number;
+        };
+        haikuSummarizer?: {
+            input: number;
+            output: number;
+        };
+        routedAnswer?: {
+            model: string;
+            complexity: string;
+            thinkingBudget: number;
+        };
+    } | null;
+    /** Per-message viewport-positioning hint. */
+    scrollAnchor: ScrollAnchor | null;
+    /** Routing decision from the server's `decideRoute`. */
+    routedComplexity: string | null;
+    routedThinkingBudget: number | null;
+}
+/**
+ * Optional dependency-injection options for `useEmbeddedChat`.
+ *
+ *   - `tableIdForDocumentType` — looks up the RagTableConfig.id for an
+ *     LLM document type. Used by `displayRef` + `discussRef` to translate
+ *     an inline-card click into a server-side entity-id filter.
+ *
+ *     **Defaults to `defaultTableIdForDocumentType` from
+ *     `src/utils/source-icons.ts`** — a lib-baked map covering every
+ *     documentType currently registered in the hub's RAG_TABLE_CONFIGS.
+ *     This makes Ask / Display work out of the box in embedders without
+ *     any callback wiring.
+ *
+ *     Override only when you have polymorphic / per-tenant document
+ *     types that map to a different tableId than the default
+ *     (hub-canonical) registry — pass your own `(docType) => tableId`
+ *     callback and it wins over the default.
+ */
+export interface UseEmbeddedChatOptions {
+    tableIdForDocumentType?: (documentType: string) => string | null;
+}
+/**
+ * Stream-driven AI chat hook. Returns the message list, send/stop/clear
+ * controls, and per-turn metadata (model name, token counts, routing
+ * decision) the lib's `<ChatContainer>` consumes.
+ *
+ * Source identity comes from `useRequiredChatRuntime().source` — no
+ * parameter. Throws if `runtime.source` is empty.
+ */
+export declare function useEmbeddedChat(options?: UseEmbeddedChatOptions): {
+    messages: DocChatMessage[];
+    isLoading: boolean;
+    sendMessage: (text: string, options?: StreamFnExtraOptions, messageOptions?: {
+        hidden?: boolean;
+    }) => void;
+    /** "Discuss" affordance for ObjectCard. */
+    discussRef: (reference: ChatRef) => void;
+    /** "Display" counterpart of `discussRef`. */
+    displayRef: (reference: ChatRef) => void;
+    stopMessage: () => void;
+    clearMessages: () => void;
+    streamingPhase: StreamingPhase;
+    /** Provider key for the lib's `<ModelDisplay>` icon. */
+    currentProvider: string | null;
+    currentModelLabel: string | null;
+    currentContextWindowMaxTokens: number | null;
+    /** Input tokens (known after server's message_start frame; null until). */
+    currentInputTokens: number | null;
+    /** Output tokens (known only after server's trailing usage frame). */
+    currentOutputTokens: number | null;
+    /** Cache hit % (read / total-input × 100). null during streaming. */
+    currentCacheHitRatePct: number | null;
+    /** Cross-call usage breakdown (Haiku rewriter/classifier/summarizer
+     *  token counts). null until the trailing usage frame lands. */
+    currentUsageBreakdown: {
+        haikuRewriter?: {
+            input: number;
+            output: number;
+        };
+        haikuClassifier?: {
+            input: number;
+            output: number;
+        };
+        haikuSummarizer?: {
+            input: number;
+            output: number;
+        };
+        routedAnswer?: {
+            model: string;
+            complexity: string;
+            thinkingBudget: number;
+        };
+    } | null;
+};
+//# sourceMappingURL=use-embedded-chat.d.ts.map

package/dist/components/chat/hooks/use-embedded-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-embedded-chat.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-embedded-chat.ts"],"names":[],"mappings":"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"}

package/dist/components/chat/hooks/use-proxied-image-url.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Hook-version of `getProxiedImageUrl` that reads `proxyPrefix` and
+ * `skipDomains` from the ambient `ChatRuntime`. Use anywhere inside
+ * a `<ChatRuntimeContext.Provider>`.
+ *
+ * Returns the input URL (or `''` for null/undefined) when no
+ * `imageProxyUrlPrefix` is configured. Always passes `directHttps: true`
+ * — callers that need proxied https (e.g. raster-only) must use the pure
+ * `getProxiedImageUrl` from `@flamingo-stack/openframe-frontend-core/utils`
+ * directly.
+ *
+ * Rules of hooks: call at the TOP of a component, NOT inside loops/maps.
+ * For `.map(item => proxy(item.url))` patterns, use the pure
+ * `getProxiedImageUrl` and hardcode the proxy config — the rare
+ * non-React-tree caller pattern.
+ */
+export declare function useProxiedImageUrl(url: string | null | undefined): string;
+//# sourceMappingURL=use-proxied-image-url.d.ts.map

package/dist/components/chat/hooks/use-proxied-image-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-proxied-image-url.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-proxied-image-url.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CASzE"}

package/dist/components/chat/hooks/use-slash-commands.d.ts

@@ -0,0 +1,32 @@
+import type { SlashCommandActionId, SlashCommandSummaryAction, SlashCommandSummary } from "../types/component.types";
+export type { SlashCommandActionId, SlashCommandSummaryAction, SlashCommandSummary, };
+/**
+ * Fetch slash-command suggestions for the CURRENT deployment platform,
+ * matching id-prefix `prefix`. The chat source is server-resolved — the
+ * client sends NO `source` param on the URL.
+ *
+ * `commandsUrl` is required — supplied by `useChatRuntime().endpoints.commandsUrl`
+ * at the call site. NO default value.
+ *
+ * URL handling: `new URL(commandsUrl, window.location.origin)` works
+ * for both relative (e.g. `/api/mingo-guide/commands` → resolved against
+ * the embedder origin, proxy handles it) and absolute
+ * (e.g. `https://hub.openframe.ai/api/commands` → the base arg is
+ * ignored).
+ *
+ * Returns the parsed `commands` array; on any non-2xx (auth,
+ * rate-limit, chat-disabled) returns an empty array — the autocomplete
+ * UI silently shows no suggestions rather than surfacing 401/403/429
+ * toasts.
+ */
+export declare function fetchSlashCommands(prefix: string, signal: AbortSignal | undefined, commandsUrl: string): Promise<SlashCommandSummary[]>;
+/**
+ * Debounced, cancellable React hook. Returns `{ commands, loading }`.
+ *
+ * `commandsUrl` is required — pass `useChatRuntime().endpoints.commandsUrl`.
+ */
+export declare function useSlashCommands(prefix: string | null, commandsUrl: string): {
+    commands: SlashCommandSummary[];
+    loading: boolean;
+};
+//# sourceMappingURL=use-slash-commands.d.ts.map

package/dist/components/chat/hooks/use-slash-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-slash-commands.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-slash-commands.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAMlC,YAAY,EACV,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,GACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAOhC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,WAAW,EAAE,MAAM,GAClB;IAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAiCvD"}

package/dist/components/chat/hooks/use-sse.d.ts

@@ -0,0 +1,57 @@
+import type { MessageSegment } from '../types/message.types';
+import type { WireCommandOverride } from '../utils/slash-dispatch-utils';
+import type { ChatAttachment } from '../utils/chat-attachment-markdown';
+/**
+ * Stream function signature. The optional `signal` is created fresh per
+ * `streamMessage` call so the underlying fetch can be aborted cleanly when
+ * the user clicks Stop. Without the signal, abort would only stop yielding
+ * chunks at the iterator boundary while the upstream Anthropic request
+ * continued running (and billing).
+ *
+ * `extraOptions` carries per-call extras (currently `commandOverride` for
+ * the inline-card "Discuss" affordance per v6.1 §B.2.8). Kept generic so
+ * future per-call wire fields don't bloat the signature.
+ */
+export interface StreamFnExtraOptions {
+    commandOverride?: WireCommandOverride;
+    /** Out-of-band signal for the post-approval / post-reject
+     *  server-driven turn. When set, the streamFn routes to
+     *  `/api/chat/agent/confirm-tool` instead of `/api/docs/chat` and
+     *  encodes the action on the request body. The server emits a
+     *  `decision_resolved` leading frame that the chat-shell uses to
+     *  flip the SOURCE approval card (different assistant message than
+     *  the one being streamed into), then — on approve + write tool —
+     *  pipes the auto-continuation Sonnet response as standard chat SSE
+     *  frames into a NEW assistant turn. The CLIENT does not orchestrate
+     *  the auto-continuation; it just renders frames. */
+    approvalAction?: {
+        proposalId: string;
+        action: 'approve' | 'reject';
+    };
+    /** Chat-attachment payload riding alongside the user's text — the
+     *  staged attachments produced by `useChatAttachments`. Server-side,
+     *  `runDocsChat` strips the embedded `/api/storage/view/chat-attachments/...`
+     *  markdown lines from the user's text and replaces them with
+     *  Anthropic image content blocks (raw signed URLs).
+     *
+     *  Wire format: `storagePath` + `viewToken` only — NEVER a `url`
+     *  field. Server validates against `ChatAttachmentSchema` and rejects
+     *  malformed shapes. */
+    pendingAttachments?: ChatAttachment[];
+}
+export type StreamFn = (message: string, signal?: AbortSignal, extra?: StreamFnExtraOptions) => AsyncGenerator<MessageSegment>;
+interface UseSSEOptions {
+    useMock?: boolean;
+    debugMode?: boolean;
+    /** Custom stream function — when provided, bypasses the mock fallback */
+    streamFn?: StreamFn;
+}
+export declare function useSSE({ useMock, debugMode, streamFn }?: UseSSEOptions): {
+    streamMessage: (message: string, extra?: StreamFnExtraOptions) => AsyncGenerator<MessageSegment>;
+    isStreaming: boolean;
+    error: string | null;
+    abort: () => void;
+    reset: () => void;
+};
+export {};
+//# sourceMappingURL=use-sse.d.ts.map

package/dist/components/chat/hooks/use-sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sse.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-sse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAEvE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,EAAE,mBAAmB,CAAA;IACrC;;;;;;;;;yDASqD;IACrD,cAAc,CAAC,EAAE;QACf,UAAU,EAAE,MAAM,CAAA;QAClB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAA;KAC7B,CAAA;IACD;;;;;;;;4BAQwB;IACxB,kBAAkB,CAAC,EAAE,cAAc,EAAE,CAAA;CACtC;AACD,MAAM,MAAM,QAAQ,GAAG,CACrB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,EACpB,KAAK,CAAC,EAAE,oBAAoB,KACzB,cAAc,CAAC,cAAc,CAAC,CAAA;AAEnC,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,wBAAgB,MAAM,CAAC,EAAE,OAAc,EAAE,SAAiB,EAAE,QAAQ,EAAE,GAAE,aAAkB;6BAqB3E,MAAM,UACP,oBAAoB,KAC3B,cAAc,CAAC,cAAc,CAAC;;;;;EA6DpC"}