@iota-uz/sdk 0.20.0 → 0.22.0

package/dist/chat-ui/machine/ChatMachine.d.ts

@@ -0,0 +1,191 @@
+/**
+ * ChatMachine — framework-agnostic state machine for BiChat.
+ *
+ * Owns all async logic that was previously in ChatContext.tsx:
+ * - Session fetch (with race-condition guards)
+ * - Message sending + streaming
+ * - Slash commands (/debug, /clear, /compact)
+ * - HITL question submission / rejection
+ * - Message queue (auto-drain)
+ * - Rate limiting
+ * - Abort / cancel
+ *
+ * Zero React dependency. Designed for `useSyncExternalStore`:
+ * three subscribe/getSnapshot pairs map to the existing 3-context split.
+ */
+import type { CodeOutput, Attachment, QuestionAnswers } from "../types";
+import type { ChatMachineConfig, SessionSnapshot, MessagingSnapshot, InputSnapshot } from "./types";
+type Listener = () => void;
+export declare class ChatMachine {
+    private dataSource;
+    private rateLimiter;
+    private onSessionCreated?;
+    private state;
+    private abortController;
+    private lastSendAttempt;
+    /** Prevents fetchSession effect from clobbering state while stream is active. */
+    private sendingSessionId;
+    /**
+     * Monotonic counter bumped on every real session switch. An async op (send
+     * stream, post-stream sync, queue drain, resume, HITL) captures it at start
+     * and re-checks before writing to the single shared `state.messaging`; a stale
+     * epoch means the user navigated to a different session, so the write is
+     * dropped instead of bleeding into / clobbering the now-visible session.
+     */
+    private viewEpoch;
+    private fetchCancelled;
+    private disposed;
+    private reasoningEffortOptions;
+    private reasoningEffortOptionSet;
+    /** Memoized sessionDebugUsage — avoids unnecessary session re-renders during streaming. */
+    private lastSessionDebugUsage;
+    /** Interval handle for passive polling when another tab has an active stream. */
+    private passivePollingId;
+    private sessionListeners;
+    private messagingListeners;
+    private inputListeners;
+    private cachedSessionSnapshot;
+    private cachedMessagingSnapshot;
+    private cachedInputSnapshot;
+    private sessionSnapshotVersion;
+    private messagingSnapshotVersion;
+    private inputSnapshotVersion;
+    private lastSessionSnapshotVersion;
+    private lastMessagingSnapshotVersion;
+    private lastInputSnapshotVersion;
+    readonly setError: (error: string | null) => void;
+    readonly retryFetchSession: () => void;
+    readonly sendMessage: (content: string, attachments?: Attachment[]) => Promise<void>;
+    readonly handleRegenerate: (turnId: string, model?: string) => Promise<void>;
+    readonly handleEdit: (turnId: string, newContent: string) => Promise<void>;
+    readonly handleCopy: (text: string) => Promise<void>;
+    readonly handleSubmitQuestionAnswers: (answers: QuestionAnswers) => void;
+    readonly handleRejectPendingQuestion: () => Promise<void>;
+    readonly retryLastMessage: () => Promise<void>;
+    readonly clearStreamError: () => void;
+    readonly cancel: () => void;
+    readonly setCodeOutputs: (outputs: CodeOutput[]) => void;
+    readonly setMessage: (message: string) => void;
+    readonly setInputError: (error: string | null) => void;
+    readonly handleSubmit: (e: {
+        preventDefault: () => void;
+    }, attachments?: Attachment[]) => void;
+    readonly handleUnqueue: () => {
+        content: string;
+        attachments: Attachment[];
+    } | null;
+    readonly enqueueMessage: (content: string, attachments: Attachment[]) => boolean;
+    readonly removeQueueItem: (index: number) => void;
+    readonly updateQueueItem: (index: number, content: string) => void;
+    readonly setReasoningEffort: (effort: string) => void;
+    readonly setModel: (model: string | undefined) => void;
+    constructor(config: ChatMachineConfig);
+    private buildReasoningEffortOptions;
+    private sanitizeReasoningEffort;
+    /**
+     * Set the active session ID. Triggers fetch when transitioning to a real
+     * session, or resets state for 'new'/undefined.
+     */
+    setSessionId(id: string | undefined): void;
+    /**
+     * Update mutable config that may change across parent re-renders.
+     * Called from the React provider's useEffect to keep the machine in sync.
+     */
+    updateConfig(config: Pick<ChatMachineConfig, "dataSource" | "onSessionCreated">): void;
+    dispose(): void;
+    subscribeSession: (listener: Listener) => (() => void);
+    getSessionSnapshot: () => SessionSnapshot;
+    subscribeMessaging: (listener: Listener) => (() => void);
+    getMessagingSnapshot: () => MessagingSnapshot;
+    subscribeInput: (listener: Listener) => (() => void);
+    getInputSnapshot: () => InputSnapshot;
+    private _updateSession;
+    private _notifySession;
+    private _updateMessaging;
+    private _notifyMessaging;
+    private _updateInput;
+    private _notifyInput;
+    private _persistQueue;
+    /**
+     * True while `epoch` is still the active view — i.e. the machine has not been
+     * disposed and no session switch has happened since `epoch` was captured.
+     * Async ops gate their writes to the shared messaging state on this.
+     */
+    private _isCurrentEpoch;
+    /** A send can't start while generating, mid-resume, or with an open question. */
+    private _isBlockedForSend;
+    /**
+     * Send the next queued message, but only if we still own the view (`epoch`)
+     * and nothing is blocking (an in-flight generation or an open question). The
+     * item is dequeued optimistically and restored to the front if it turns out we
+     * can't send when the deferred tick fires — so a queued message is never
+     * silently dropped.
+     */
+    private _drainQueueIfReady;
+    private _setDebugModeForSession;
+    private _hydrateDebugModeForSession;
+    private _setReasoningEffort;
+    private _setModel;
+    private _fetchSessionIfNeeded;
+    /**
+     * Sets turns from fetch, preserving pending user-only turns if server hasn't caught up.
+     * Applies `turns` + optional `pendingQuestion` in a single messaging update to avoid
+     * transient intermediate UI states between separate notifications.
+     */
+    private _setTurnsFromFetch;
+    /**
+     * After fetch: if backend has an active stream, either resume (same-browser) or poll (passive).
+     */
+    private _checkStreamStatusAndResumeOrPoll;
+    private _stopPassivePolling;
+    private _startPassivePolling;
+    private _runResumeStream;
+    private _resumeAcceptedRunOrPoll;
+    private _setError;
+    private _retryFetchSession;
+    private _clearStreamError;
+    private _notifySessionsUpdated;
+    private _cancel;
+    private _setCodeOutputs;
+    private _setMessage;
+    private _setInputError;
+    private _executeSlashCommand;
+    private _insertOptimisticTurn;
+    private _resolveSendSession;
+    private _syncSessionFromServer;
+    private _runSendStream;
+    private _ensureSessionSyncAfterStream;
+    private _finalizeSuccessfulSend;
+    private _handleSendError;
+    private _preservePartialAssistant;
+    /**
+     * Public entry point (no options). Calls _sendMessageCore internally.
+     */
+    private _sendMessage;
+    /**
+     * Internal entry point with options (for regenerate/edit).
+     */
+    private _sendMessageDirect;
+    /**
+     * Core send-message logic. Handles slash commands, rate limiting, streaming,
+     * session creation, optimistic turns, and auto-queue-drain.
+     */
+    private _sendMessageCore;
+    private _handleThinkingChunk;
+    private _handleToolStart;
+    private _handleToolEnd;
+    /** Match a step to a tool_end event. Use callId when present; fall back to name + agentName. */
+    private _matchStep;
+    private _retryLastMessage;
+    private _handleRegenerate;
+    private _handleEdit;
+    private _handleCopy;
+    private _handleSubmitQuestionAnswers;
+    private _handleRejectPendingQuestion;
+    private _handleSubmit;
+    private _handleUnqueue;
+    private _enqueueMessage;
+    private _removeQueueItem;
+    private _updateQueueItem;
+}
+export {};

package/dist/chat-ui/machine/hitlLifecycle.d.ts

@@ -0,0 +1,7 @@
+import type { ConversationTurn, PendingQuestion, StreamInterruptPayload } from "../types";
+export declare function normalizeQuestionType(rawType: unknown): "SINGLE_CHOICE" | "MULTIPLE_CHOICE";
+export declare function isOpenQuestionStatus(status: PendingQuestion["status"] | undefined): boolean;
+export declare function shouldPromptForHumanInput(status: PendingQuestion["status"] | undefined): boolean;
+export declare function pendingQuestionFromInterrupt(interrupt: StreamInterruptPayload | undefined, fallbackTurnId: string): PendingQuestion | null;
+export declare function resolvePendingQuestionTurnIndex(turns: ConversationTurn[], pendingQuestion: PendingQuestion | null): number;
+export declare function applyTurnLifecycleForPendingQuestion(turns: ConversationTurn[], pendingQuestion: PendingQuestion | null): ConversationTurn[];

package/dist/chat-ui/machine/index.d.ts

@@ -0,0 +1,2 @@
+export { ChatMachine } from './ChatMachine';
+export type { ChatMachineConfig } from './types';

package/dist/chat-ui/machine/selectors.d.ts

@@ -0,0 +1,5 @@
+import type { ChatMachineState, SessionSnapshot, MessagingSnapshot, InputSnapshot } from './types';
+export declare function deriveDebugMode(state: ChatMachineState): boolean;
+export declare function deriveSessionSnapshot(state: ChatMachineState, methods: Pick<SessionSnapshot, 'setError' | 'retryFetchSession' | 'setReasoningEffort' | 'setModel'>): SessionSnapshot;
+export declare function deriveMessagingSnapshot(state: ChatMachineState, methods: Pick<MessagingSnapshot, 'sendMessage' | 'handleRegenerate' | 'handleEdit' | 'handleCopy' | 'handleSubmitQuestionAnswers' | 'handleRejectPendingQuestion' | 'retryLastMessage' | 'clearStreamError' | 'cancel' | 'setCodeOutputs'>): MessagingSnapshot;
+export declare function deriveInputSnapshot(state: ChatMachineState, methods: Pick<InputSnapshot, 'setMessage' | 'setInputError' | 'handleSubmit' | 'handleUnqueue' | 'enqueueMessage' | 'removeQueueItem' | 'updateQueueItem'>): InputSnapshot;

package/dist/chat-ui/machine/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Internal types for the ChatMachine.
+ *
+ * These are implementation details — consumers use the existing
+ * ChatSessionStateValue / ChatMessagingStateValue / ChatInputStateValue
+ * types via the public hooks.
+ */
+import type { Session, ConversationTurn, PendingQuestion, CodeOutput, QueuedMessage, Attachment, ActivityStep, ChatDataSource, SessionDebugUsage, DebugLimits, SendMessageOptions, QuestionAnswers } from '../types';
+import type { RateLimiter } from '../utils/RateLimiter';
+export interface ChatMachineConfig {
+    dataSource: ChatDataSource;
+    rateLimiter: RateLimiter;
+    onSessionCreated?: (sessionId: string) => void;
+}
+export interface SessionState {
+    currentSessionId: string | undefined;
+    session: Session | null;
+    fetching: boolean;
+    error: string | null;
+    errorRetryable: boolean;
+    debugModeBySession: Record<string, boolean>;
+    debugLimits: DebugLimits | null;
+    reasoningEffort: string | undefined;
+    reasoningEffortOptions?: string[];
+    model: string | undefined;
+}
+export interface MessagingState {
+    turns: ConversationTurn[];
+    streamingContent: string;
+    isStreaming: boolean;
+    streamError: string | null;
+    streamErrorRetryable: boolean;
+    loading: boolean;
+    pendingQuestion: PendingQuestion | null;
+    codeOutputs: CodeOutput[];
+    isCompacting: boolean;
+    artifactsInvalidationTrigger: number;
+    /** Ephemeral: accumulated reasoning/thinking content during streaming. */
+    thinkingContent: string;
+    /** Ephemeral: ordered list of activity steps (thinking, tools, delegations). */
+    activeSteps: ActivityStep[];
+    /** True when another tab/device has an active stream; show "generation in progress" and poll. */
+    generationInProgress: boolean;
+}
+export interface InputState {
+    message: string;
+    inputError: string | null;
+    messageQueue: QueuedMessage[];
+}
+export interface ChatMachineState {
+    session: SessionState;
+    messaging: MessagingState;
+    input: InputState;
+}
+/**
+ * Mirrors ChatSessionStateValue. Methods are stable (bound once on
+ * machine construction) so they never trigger re-renders by identity change.
+ */
+export interface SessionSnapshot {
+    session: Session | null;
+    currentSessionId?: string;
+    fetching: boolean;
+    error: string | null;
+    errorRetryable: boolean;
+    debugMode: boolean;
+    sessionDebugUsage: SessionDebugUsage;
+    debugLimits: DebugLimits | null;
+    reasoningEffort: string | undefined;
+    reasoningEffortOptions: string[] | undefined;
+    model: string | undefined;
+    setError: (error: string | null) => void;
+    retryFetchSession: () => void;
+    setReasoningEffort: (effort: string) => void;
+    setModel: (model: string | undefined) => void;
+}
+/** Superset of ChatMessagingStateValue used internally by the state machine; includes internal-only fields such as generationInProgress. */
+export interface MessagingSnapshot {
+    turns: ConversationTurn[];
+    streamingContent: string;
+    isStreaming: boolean;
+    streamError: string | null;
+    streamErrorRetryable: boolean;
+    loading: boolean;
+    pendingQuestion: PendingQuestion | null;
+    codeOutputs: CodeOutput[];
+    isCompacting: boolean;
+    compactionSummary: string | null;
+    artifactsInvalidationTrigger: number;
+    thinkingContent: string;
+    activeSteps: ActivityStep[];
+    generationInProgress: boolean;
+    showActivityTrace: boolean;
+    showTypingIndicator: boolean;
+    sendMessage: (content: string, attachments?: Attachment[]) => Promise<void>;
+    handleRegenerate?: (turnId: string, model?: string) => Promise<void>;
+    handleEdit?: (turnId: string, newContent: string) => Promise<void>;
+    handleCopy: (text: string) => Promise<void>;
+    handleSubmitQuestionAnswers: (answers: QuestionAnswers) => void;
+    handleRejectPendingQuestion: () => Promise<void>;
+    retryLastMessage: () => Promise<void>;
+    clearStreamError: () => void;
+    cancel: () => void;
+    setCodeOutputs: (outputs: CodeOutput[]) => void;
+}
+/** Mirrors ChatInputStateValue. */
+export interface InputSnapshot {
+    message: string;
+    inputError: string | null;
+    messageQueue: QueuedMessage[];
+    setMessage: (message: string) => void;
+    setInputError: (error: string | null) => void;
+    handleSubmit: (e: {
+        preventDefault: () => void;
+    }, attachments?: Attachment[]) => void;
+    handleUnqueue: () => {
+        content: string;
+        attachments: Attachment[];
+    } | null;
+    enqueueMessage: (content: string, attachments: Attachment[]) => boolean;
+    removeQueueItem: (index: number) => void;
+    updateQueueItem: (index: number, content: string) => void;
+}
+export interface LastSendAttempt {
+    content: string;
+    attachments: Attachment[];
+    options?: SendMessageOptions;
+}

package/dist/chat-ui/styles.css

@@ -0,0 +1 @@
+:root,:host{--bichat-spacing-0: 0;--bichat-spacing-px: 1px;--bichat-spacing-0_5: .125rem;--bichat-spacing-1: .25rem;--bichat-spacing-1_5: .375rem;--bichat-spacing-2: .5rem;--bichat-spacing-2_5: .625rem;--bichat-spacing-3: .75rem;--bichat-spacing-3_5: .875rem;--bichat-spacing-4: 1rem;--bichat-spacing-5: 1.25rem;--bichat-spacing-6: 1.5rem;--bichat-spacing-7: 1.75rem;--bichat-spacing-8: 2rem;--bichat-spacing-9: 2.25rem;--bichat-spacing-10: 2.5rem;--bichat-spacing-12: 3rem;--bichat-spacing-14: 3.5rem;--bichat-spacing-16: 4rem;--bichat-spacing-xs: var(--bichat-spacing-1);--bichat-spacing-sm: var(--bichat-spacing-2);--bichat-spacing-md: var(--bichat-spacing-4);--bichat-spacing-lg: var(--bichat-spacing-6);--bichat-spacing-xl: var(--bichat-spacing-8);--bichat-spacing-2xl: var(--bichat-spacing-12);--bichat-color-gray-50: #f9fafb;--bichat-color-gray-100: #f3f4f6;--bichat-color-gray-200: #e5e7eb;--bichat-color-gray-300: #d1d5db;--bichat-color-gray-400: #9ca3af;--bichat-color-gray-500: #6b7280;--bichat-color-gray-600: #4b5563;--bichat-color-gray-700: #374151;--bichat-color-gray-800: #1f2937;--bichat-color-gray-900: #111827;--bichat-color-gray-950: #030712;--bichat-color-primary-50: #eff6ff;--bichat-color-primary-100: #dbeafe;--bichat-color-primary-200: #bfdbfe;--bichat-color-primary-300: #93c5fd;--bichat-color-primary-400: #60a5fa;--bichat-color-primary-500: #3b82f6;--bichat-color-primary-600: #2563eb;--bichat-color-primary-700: #1d4ed8;--bichat-color-primary-800: #1e40af;--bichat-color-primary-900: #1e3a8a;--bichat-color-primary-950: #172554;--bichat-color-success-50: #f0fdf4;--bichat-color-success-500: #22c55e;--bichat-color-success-600: #16a34a;--bichat-color-success-700: #15803d;--bichat-color-error-50: #fef2f2;--bichat-color-error-500: #ef4444;--bichat-color-error-600: #dc2626;--bichat-color-error-700: #b91c1c;--bichat-color-warning-50: #fffbeb;--bichat-color-warning-500: #f59e0b;--bichat-color-warning-600: #d97706;--bichat-color-warning-700: #b45309;--bichat-color-info-50: #eff6ff;--bichat-color-info-500: #3b82f6;--bichat-color-info-600: #2563eb;--bichat-color-info-700: #1d4ed8;--bichat-color-bg: var(--bichat-color-gray-50);--bichat-color-bg-subtle: var(--bichat-color-gray-100);--bichat-color-bg-muted: var(--bichat-color-gray-200);--bichat-color-surface: #ffffff;--bichat-color-surface-raised: #ffffff;--bichat-color-surface-overlay: rgba(255, 255, 255, .9);--bichat-color-text: var(--bichat-color-gray-900);--bichat-color-text-secondary: var(--bichat-color-gray-600);--bichat-color-text-muted: var(--bichat-color-gray-500);--bichat-color-text-disabled: var(--bichat-color-gray-400);--bichat-color-text-inverse: #ffffff;--bichat-color-code-text: var(--bichat-color-gray-800);--bichat-color-code-bg: var(--bichat-color-gray-100);--bichat-color-text-icon: var(--bichat-color-gray-500);--bichat-color-border: var(--bichat-color-gray-200);--bichat-color-border-subtle: var(--bichat-color-gray-100);--bichat-color-border-strong: var(--bichat-color-gray-300);--bichat-color-border-brand: var(--bichat-color-primary-500);--bichat-color-border-danger: var(--bichat-color-error-500);--bichat-color-border-warning: var(--bichat-color-warning-500);--bichat-color-border-success: var(--bichat-color-success-500);--bichat-color-border-disabled: var(--bichat-color-gray-200);--bichat-color-accent: var(--bichat-color-primary-600);--bichat-color-accent-hover: var(--bichat-color-primary-700);--bichat-color-accent-muted: var(--bichat-color-primary-100);--bichat-color-user-bubble-bg: var(--bichat-color-primary-600);--bichat-color-user-bubble-text: #ffffff;--bichat-color-user-bubble-border: transparent;--bichat-color-assistant-bubble-bg: var(--bichat-color-surface);--bichat-color-assistant-bubble-text: var(--bichat-color-text);--bichat-color-assistant-bubble-border: var(--bichat-color-border);--bichat-color-system-bubble-bg: var(--bichat-color-bg-subtle);--bichat-color-system-bubble-text: var(--bichat-color-text-secondary);--bichat-color-input-bg: var(--bichat-color-surface);--bichat-color-input-text: var(--bichat-color-text);--bichat-color-input-border: var(--bichat-color-border);--bichat-color-input-focus-border: var(--bichat-color-accent);--bichat-color-input-placeholder: var(--bichat-color-text-muted);--bichat-font-family: "Gilroy", -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto", "Oxygen", "Ubuntu", "Cantarell", "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif;--bichat-font-family-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;--bichat-font-size-xs: .75rem;--bichat-font-size-sm: .875rem;--bichat-font-size-base: 1rem;--bichat-font-size-lg: 1.125rem;--bichat-font-size-xl: 1.25rem;--bichat-font-size-2xl: 1.5rem;--bichat-font-size-3xl: 1.875rem;--bichat-font-weight-normal: 400;--bichat-font-weight-medium: 500;--bichat-font-weight-semibold: 600;--bichat-font-weight-bold: 700;--bichat-line-height-tight: 1.25;--bichat-line-height-normal: 1.5;--bichat-line-height-relaxed: 1.625;--bichat-letter-spacing-tight: -.025em;--bichat-letter-spacing-normal: 0;--bichat-letter-spacing-wide: .025em;--bichat-radius-none: 0;--bichat-radius-sm: .125rem;--bichat-radius-default: .25rem;--bichat-radius-md: .375rem;--bichat-radius-lg: .5rem;--bichat-radius-xl: .75rem;--bichat-radius-2xl: 1rem;--bichat-radius-3xl: 1.5rem;--bichat-radius-full: 9999px;--bichat-radius-bubble: var(--bichat-radius-2xl);--bichat-radius-bubble-tail: var(--bichat-radius-sm);--bichat-radius-button: var(--bichat-radius-lg);--bichat-radius-input: var(--bichat-radius-lg);--bichat-radius-card: var(--bichat-radius-xl);--bichat-radius-modal: var(--bichat-radius-2xl);--bichat-shadow-xs: 0 1px 2px 0 rgba(0, 0, 0, .05);--bichat-shadow-sm: 0 1px 3px 0 rgba(0, 0, 0, .1), 0 1px 2px -1px rgba(0, 0, 0, .1);--bichat-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, .1), 0 2px 4px -2px rgba(0, 0, 0, .1);--bichat-shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, .1), 0 4px 6px -4px rgba(0, 0, 0, .1);--bichat-shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, .1), 0 8px 10px -6px rgba(0, 0, 0, .1);--bichat-shadow-2xl: 0 25px 50px -12px rgba(0, 0, 0, .25);--bichat-shadow-inner: inset 0 2px 4px 0 rgba(0, 0, 0, .05);--bichat-shadow-none: 0 0 #0000;--bichat-ring-width: 2px;--bichat-ring-offset: 2px;--bichat-ring-color: var(--bichat-color-primary-500);--bichat-focus-ring: 0 0 0 var(--bichat-ring-width) var(--bichat-ring-color);--bichat-focus-ring-offset: 0 0 0 var(--bichat-ring-offset) var(--bichat-color-surface);--bichat-transition-fast: .1s;--bichat-transition-normal: .15s;--bichat-transition-slow: .2s;--bichat-transition-slower: .3s;--bichat-ease-default: cubic-bezier(.4, 0, .2, 1);--bichat-ease-in: cubic-bezier(.4, 0, 1, 1);--bichat-ease-out: cubic-bezier(0, 0, .2, 1);--bichat-ease-in-out: cubic-bezier(.4, 0, .2, 1);--bichat-ease-bounce: cubic-bezier(.68, -.55, .265, 1.55);--bichat-z-base: 0;--bichat-z-dropdown: 10;--bichat-z-sticky: 20;--bichat-z-overlay: 30;--bichat-z-modal: 40;--bichat-z-popover: 50;--bichat-z-toast: 60;--bichat-z-tooltip: 70;--bichat-avatar-size-sm: 1.5rem;--bichat-avatar-size-md: 2rem;--bichat-avatar-size-lg: 2.5rem;--bichat-avatar-size-xl: 3rem;--bichat-bubble-max-width: 75%;--bichat-bubble-assistant-max-width: 85%;--bichat-input-min-height: 2.5rem;--bichat-input-max-height: 12rem;--bichat-color-chart-grid: rgba(148, 163, 184, .15);--bichat-primary: var(--bichat-color-primary-500);--bichat-bg: var(--bichat-color-bg);--bichat-text: var(--bichat-color-text);--bichat-border: var(--bichat-color-border);--bichat-bubble-user: var(--bichat-color-user-bubble-bg);--bichat-bubble-assistant: var(--bichat-color-assistant-bubble-bg)}.dark,[data-theme=dark]{--bichat-color-bg: var(--bichat-color-gray-900);--bichat-color-bg-subtle: var(--bichat-color-gray-800);--bichat-color-bg-muted: var(--bichat-color-gray-700);--bichat-color-surface: var(--bichat-color-gray-800);--bichat-color-surface-raised: var(--bichat-color-gray-750, #2d3748);--bichat-color-surface-overlay: rgba(31, 41, 55, .9);--bichat-color-text: var(--bichat-color-gray-100);--bichat-color-text-secondary: var(--bichat-color-gray-300);--bichat-color-text-muted: var(--bichat-color-gray-400);--bichat-color-text-disabled: var(--bichat-color-gray-500);--bichat-color-code-text: var(--bichat-color-gray-200);--bichat-color-code-bg: var(--bichat-color-gray-800);--bichat-color-text-icon: var(--bichat-color-gray-400);--bichat-color-border: var(--bichat-color-gray-700);--bichat-color-border-subtle: var(--bichat-color-gray-800);--bichat-color-border-strong: var(--bichat-color-gray-600);--bichat-color-border-brand: var(--bichat-color-primary-400);--bichat-color-border-danger: var(--bichat-color-error-600);--bichat-color-border-warning: var(--bichat-color-warning-500);--bichat-color-border-success: var(--bichat-color-success-600);--bichat-color-border-disabled: var(--bichat-color-gray-800);--bichat-color-accent-muted: var(--bichat-color-primary-900);--bichat-color-user-bubble-bg: var(--bichat-color-primary-700);--bichat-color-assistant-bubble-bg: var(--bichat-color-gray-800);--bichat-color-assistant-bubble-border: var(--bichat-color-gray-700);--bichat-color-system-bubble-bg: var(--bichat-color-gray-800);--bichat-color-input-bg: var(--bichat-color-gray-800);--bichat-color-input-border: var(--bichat-color-gray-700);--bichat-bg: var(--bichat-color-bg);--bichat-text: var(--bichat-color-text);--bichat-border: var(--bichat-color-border);--bichat-bubble-assistant: var(--bichat-color-assistant-bubble-bg);--bichat-color-chart-grid: rgba(148, 163, 184, .1);--bichat-shadow-sm: 0 1px 3px 0 rgba(0, 0, 0, .3), 0 1px 2px -1px rgba(0, 0, 0, .3);--bichat-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, .3), 0 2px 4px -2px rgba(0, 0, 0, .3);--bichat-shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, .4), 0 4px 6px -4px rgba(0, 0, 0, .4)}.bichat-session{background-color:var(--bichat-color-bg);color:var(--bichat-color-text);font-family:var(--bichat-font-family);font-size:var(--bichat-font-size-base);line-height:var(--bichat-line-height-normal);-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}:host button,:host [role=button],:host [role=tab],.bichat-session button,.bichat-session [role=button],.bichat-session [role=tab],bi-chat-root button,bi-chat-root [role=button],bi-chat-root [role=tab]{cursor:pointer}:host button:disabled,:host [role=button][aria-disabled=true],.bichat-session button:disabled,.bichat-session [role=button][aria-disabled=true],bi-chat-root button:disabled,bi-chat-root [role=button][aria-disabled=true]{cursor:not-allowed}.bichat-session button:focus-visible,.bichat-session a:focus-visible,.bichat-session input:focus-visible,.bichat-session textarea:focus-visible,.bichat-session [role=button]:focus-visible,.bichat-session [role=menuitem]:focus-visible,.bichat-session [role=tab]:focus-visible,.bichat-session select:focus-visible,.bichat-session [tabindex]:not([tabindex="-1"]):focus-visible,bi-chat-root button:focus-visible,bi-chat-root a:focus-visible,bi-chat-root input:focus-visible,bi-chat-root textarea:focus-visible,bi-chat-root [role=button]:focus-visible,bi-chat-root [role=menuitem]:focus-visible,bi-chat-root [role=tab]:focus-visible,bi-chat-root select:focus-visible,bi-chat-root [tabindex]:not([tabindex="-1"]):focus-visible{outline:none;box-shadow:var(--bichat-focus-ring-offset),var(--bichat-focus-ring);border-radius:inherit}.dark .bichat-session button:focus-visible,.dark .bichat-session a:focus-visible,.dark .bichat-session input:focus-visible,.dark .bichat-session textarea:focus-visible,.dark .bichat-session [role=button]:focus-visible,.dark .bichat-session [role=menuitem]:focus-visible,.dark .bichat-session [role=tab]:focus-visible,.dark .bichat-session select:focus-visible,.dark .bichat-session [tabindex]:not([tabindex="-1"]):focus-visible,.dark bi-chat-root button:focus-visible,.dark bi-chat-root a:focus-visible,.dark bi-chat-root input:focus-visible,.dark bi-chat-root textarea:focus-visible,.dark bi-chat-root [role=button]:focus-visible,.dark bi-chat-root [role=menuitem]:focus-visible,.dark bi-chat-root [role=tab]:focus-visible,.dark bi-chat-root select:focus-visible,.dark bi-chat-root [tabindex]:not([tabindex="-1"]):focus-visible{--bichat-focus-ring: 0 0 0 var(--bichat-ring-width) var(--bichat-color-primary-400)}.bichat-messages::-webkit-scrollbar{width:8px}.bichat-messages::-webkit-scrollbar-track{background:transparent}.bichat-messages::-webkit-scrollbar-thumb{background:var(--bichat-color-gray-300);border-radius:var(--bichat-radius-full)}.bichat-messages::-webkit-scrollbar-thumb:hover{background:var(--bichat-color-gray-400)}.dark .bichat-messages::-webkit-scrollbar-thumb{background:var(--bichat-color-gray-600)}.dark .bichat-messages::-webkit-scrollbar-thumb:hover{background:var(--bichat-color-gray-500)}@keyframes bichat-pulse{0%,to{opacity:1}50%{opacity:0}}@keyframes bichat-bounce{0%,to{transform:translateY(0);animation-timing-function:cubic-bezier(.8,0,1,1)}50%{transform:translateY(-25%);animation-timing-function:cubic-bezier(0,0,.2,1)}}@keyframes bichat-spin{0%{transform:rotate(0)}to{transform:rotate(360deg)}}@keyframes bichat-fade-in{0%{opacity:0}to{opacity:1}}@keyframes bichat-slide-up{0%{opacity:0;transform:translateY(10px)}to{opacity:1;transform:translateY(0)}}.animate-pulse{animation:bichat-pulse 1s var(--bichat-ease-in-out) infinite}.animate-bounce{animation:bichat-bounce 1s infinite}.animate-spin{animation:bichat-spin 1s linear infinite}.animate-fade-in{animation:bichat-fade-in var(--bichat-transition-normal) var(--bichat-ease-out)}.animate-slide-up{animation:bichat-slide-up var(--bichat-transition-slow) var(--bichat-ease-out)}.bichat-thinking-shimmer{-webkit-mask-image:linear-gradient(-45deg,rgba(0,0,0,1) 20%,rgba(0,0,0,1) 40%,rgba(0,0,0,.2) 50%,rgba(0,0,0,1) 60%,rgba(0,0,0,1) 80%);mask-image:linear-gradient(-45deg,#000 20%,#000 40%,#0003,#000 60%,#000 80%);-webkit-mask-size:300% 100%;mask-size:300% 100%;animation:bichat-thinking-shimmer 4.5s linear infinite}.dark .bichat-thinking-shimmer{-webkit-mask-image:linear-gradient(-45deg,rgba(0,0,0,1) 15%,rgba(0,0,0,1) 35%,rgba(0,0,0,.3) 50%,rgba(0,0,0,1) 65%,rgba(0,0,0,1) 85%);mask-image:linear-gradient(-45deg,#000 15%,#000 35%,#0000004d,#000 65%,#000 85%)}@keyframes bichat-toast-progress{0%{transform:scaleX(1)}to{transform:scaleX(0)}}@media (prefers-reduced-motion: reduce){.bichat-thinking-shimmer,.animate-pulse,.animate-bounce,.animate-spin,.animate-fade-in,.animate-slide-up{animation:none}}@keyframes bichat-thinking-shimmer{0%{-webkit-mask-position:130% 0;mask-position:130% 0}to{-webkit-mask-position:-30% 0;mask-position:-30% 0}}.prose{color:var(--bichat-color-text);font-size:var(--bichat-font-size-base);line-height:var(--bichat-line-height-relaxed)}.prose>:first-child{margin-top:0}.prose>:last-child{margin-bottom:0}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{color:var(--bichat-color-text);font-weight:var(--bichat-font-weight-semibold);margin-top:1.5em;margin-bottom:.5em;line-height:var(--bichat-line-height-tight)}.prose h1{font-size:1.625rem;font-weight:var(--bichat-font-weight-bold)}.prose h2{font-size:1.375rem;margin-top:2em}.prose h3{font-size:var(--bichat-font-size-lg);font-weight:var(--bichat-font-weight-semibold)}.prose h4{font-size:var(--bichat-font-size-base)}.prose>*+h2{margin-top:2em}.prose p{margin-top:.75em;margin-bottom:.75em}.prose strong{font-weight:var(--bichat-font-weight-semibold);color:var(--bichat-color-text)}.prose code{background-color:var(--bichat-color-code-bg);color:var(--bichat-color-code-text);padding:.2em .5em;border-radius:var(--bichat-radius-md);border:1px solid var(--bichat-color-border-subtle);font-family:var(--bichat-font-family-mono);font-size:.875em}.prose pre{background-color:var(--bichat-color-code-bg);color:var(--bichat-color-gray-100);padding:var(--bichat-spacing-4);border-radius:var(--bichat-radius-lg);overflow-x:auto;margin-top:1em;margin-bottom:1em;font-family:var(--bichat-font-family-mono);font-size:var(--bichat-font-size-sm);line-height:var(--bichat-line-height-relaxed)}.prose pre code{background-color:transparent;padding:0;color:inherit;font-size:inherit;border-radius:0;border:none}.prose a{color:var(--bichat-color-accent);text-decoration:none;font-weight:var(--bichat-font-weight-medium)}.prose a:hover{text-decoration:underline}.prose ul,.prose ol{margin-top:.75em;margin-bottom:.75em;padding-left:1.5em}.prose ul{list-style-type:disc}.prose ol{list-style-type:decimal}.prose li{margin-top:.25em;margin-bottom:.25em}.prose li>ul,.prose li>ol{margin-top:.25em;margin-bottom:.25em}.prose blockquote{border-left:4px solid var(--bichat-color-border-strong);padding-left:var(--bichat-spacing-4);margin-left:0;font-style:italic;color:var(--bichat-color-text-secondary)}.prose hr{border:0;border-top:1px solid var(--bichat-color-border);margin:2em 0}.prose table{width:100%;border-collapse:collapse;margin-top:1em;margin-bottom:1em;font-size:var(--bichat-font-size-sm)}.prose th,.prose td{border:1px solid var(--bichat-color-border);padding:var(--bichat-spacing-2) var(--bichat-spacing-3);text-align:left}.prose th{background-color:var(--bichat-color-bg-subtle);font-weight:var(--bichat-font-weight-semibold)}.prose tbody tr:nth-child(2n){background-color:var(--bichat-color-bg-subtle)}.markdown-content math[display=block]{display:block;overflow-x:auto;overflow-y:hidden;padding:.25rem 0}.bichat-focus-ring:focus-visible{outline:none;box-shadow:0 0 0 var(--bichat-ring-offset) var(--bichat-color-bg),0 0 0 calc(var(--bichat-ring-offset) + var(--bichat-ring-width)) var(--bichat-ring-color)}.bichat-sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.bichat-code{color:#24292e;background:#fff;font-family:JetBrains Mono,Fira Code,Menlo,monospace}.dark .bichat-code{color:#d4d4d4;background:#1e1e1e}.bichat-code .token.comment,.bichat-code .token.prolog{color:#6a737d}.bichat-code .token.keyword,.bichat-code .token.operator{color:#d73a49}.bichat-code .token.string{color:#032f62}.bichat-code .token.function,.bichat-code .token.class-name{color:#6f42c1}.bichat-code .token.number,.bichat-code .token.boolean{color:#005cc5}.dark .bichat-code .token.comment{color:#6a9955}.dark .bichat-code .token.keyword{color:#569cd6}.dark .bichat-code .token.string{color:#ce9178}.dark .bichat-code .token.function{color:#dcdcaa}.dark .bichat-code .token.number,.dark .bichat-code .token.boolean{color:#b5cea8}

package/dist/chat-ui/theme/themes.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Predefined theme configurations
+ */
+import { Theme } from './types';
+export declare const lightTheme: Theme;
+export declare const darkTheme: Theme;

package/dist/chat-ui/theme/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Theme system type definitions
+ */
+export interface Theme {
+    name: string;
+    colors: ThemeColors;
+    spacing: ThemeSpacing;
+    borderRadius: ThemeBorderRadius;
+}
+export interface ThemeColors {
+    background: string;
+    surface: string;
+    primary: string;
+    secondary: string;
+    text: string;
+    textMuted: string;
+    border: string;
+    error: string;
+    success: string;
+    warning: string;
+    userBubble: string;
+    assistantBubble: string;
+    userText: string;
+    assistantText: string;
+}
+export interface ThemeSpacing {
+    xs: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+}
+export interface ThemeBorderRadius {
+    sm: string;
+    md: string;
+    lg: string;
+    full: string;
+}

package/dist/chat-ui/types/applet/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * TypeScript type definitions for IOTA SDK Applet Core
+ * Matches Go backend types from pkg/applet/types.go
+ */
+export interface InitialContext {
+    user: UserContext;
+    tenant: TenantContext;
+    locale: LocaleContext;
+    config: AppConfig;
+    route: RouteContext;
+    session: SessionContext;
+    error: ErrorContext | null;
+    extensions?: Record<string, unknown>;
+}
+export interface UserContext {
+    id: number;
+    email: string;
+    firstName: string;
+    lastName: string;
+    permissions: string[];
+}
+export interface TenantContext {
+    id: string;
+    name: string;
+}
+export interface LocaleContext {
+    language: string;
+    translations: Record<string, string>;
+}
+export interface AppConfig {
+    graphQLEndpoint?: string;
+    streamEndpoint?: string;
+    restEndpoint?: string;
+    basePath?: string;
+    assetsBasePath?: string;
+    rpcUIEndpoint?: string;
+    shellMode?: 'embedded' | 'standalone';
+}
+export interface RouteContext {
+    path: string;
+    params: Record<string, string>;
+    query: Record<string, string>;
+}
+export interface SessionContext {
+    expiresAt: number;
+    refreshURL: string;
+    csrfToken: string;
+}
+export interface ErrorContext {
+    supportEmail?: string;
+    debugMode: boolean;
+    errorCodes?: Record<string, string>;
+    retryConfig?: RetryConfig;
+}
+export interface RetryConfig {
+    maxAttempts: number;
+    backoffMs: number;
+}
+/**
+ * Hook return types
+ */
+export interface TranslationHook {
+    t: (key: string, params?: Record<string, unknown>) => string;
+    language: string;
+}
+export interface PermissionsHook {
+    hasPermission: (permission: string) => boolean;
+    hasAnyPermission: (...permissions: string[]) => boolean;
+    permissions: string[];
+}
+export interface SessionHook {
+    isExpiringSoon: boolean;
+    refreshSession: () => Promise<void>;
+    csrfToken: string;
+    expiresAt: number;
+}
+export interface StreamingHook {
+    isStreaming: boolean;
+    processStream: <T>(generator: AsyncGenerator<T>, onChunk: (chunk: T) => void, signal?: AbortSignal) => Promise<void>;
+    cancel: () => void;
+    reset: () => void;
+}

package/dist/chat-ui/types/data-source.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Split data source interfaces for BiChat.
+ *
+ * ChatDataSource was a single interface mixing CRUD, streaming, artifacts,
+ * and admin. These focused interfaces let consumers implement only what
+ * they need. ChatDataSource keeps the same shape (with optional artifact
+ * and admin methods) for backwards compatibility — it is NOT a strict
+ * intersection of these interfaces.
+ */
+import type { Session, SessionMember, SessionListResult, SessionUser, ConversationTurn, PendingQuestion, Attachment, StreamChunk, QuestionAnswers, SendMessageOptions, SessionArtifact, AsyncRunAccepted } from './index';
+export interface SessionStore {
+    createSession(): Promise<Session>;
+    fetchSession(id: string): Promise<{
+        session: Session;
+        turns: ConversationTurn[];
+        pendingQuestion?: PendingQuestion | null;
+    } | null>;
+    listSessions(options?: {
+        limit?: number;
+        offset?: number;
+        includeArchived?: boolean;
+    }): Promise<SessionListResult>;
+    archiveSession(sessionId: string): Promise<Session>;
+    unarchiveSession(sessionId: string): Promise<Session>;
+    pinSession(sessionId: string): Promise<Session>;
+    unpinSession(sessionId: string): Promise<Session>;
+    deleteSession(sessionId: string): Promise<void>;
+    renameSession(sessionId: string, title: string): Promise<Session>;
+    regenerateSessionTitle(sessionId: string): Promise<Session>;
+    clearSessionHistory(sessionId: string): Promise<{
+        success: boolean;
+        deletedMessages: number;
+        deletedArtifacts: number;
+    }>;
+    compactSessionHistory(sessionId: string): Promise<AsyncRunAccepted>;
+}
+export interface MessageTransport {
+    sendMessage(sessionId: string, content: string, attachments?: Attachment[], signal?: AbortSignal, options?: SendMessageOptions): AsyncGenerator<StreamChunk>;
+    submitQuestionAnswers(sessionId: string, questionId: string, answers: QuestionAnswers): Promise<{
+        success: boolean;
+        data?: AsyncRunAccepted;
+        error?: string;
+    }>;
+    rejectPendingQuestion(sessionId: string): Promise<{
+        success: boolean;
+        data?: AsyncRunAccepted;
+        error?: string;
+    }>;
+}
+export interface ArtifactStore {
+    fetchSessionArtifacts(sessionId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        artifacts: SessionArtifact[];
+        hasMore?: boolean;
+        nextOffset?: number;
+    }>;
+    uploadSessionArtifacts(sessionId: string, files: File[]): Promise<{
+        artifacts: SessionArtifact[];
+    }>;
+    renameSessionArtifact(artifactId: string, name: string, description?: string): Promise<SessionArtifact>;
+    deleteSessionArtifact(artifactId: string): Promise<void>;
+}
+export interface AdminStore {
+    listUsers(): Promise<SessionUser[]>;
+    listAllSessions(options?: {
+        limit?: number;
+        offset?: number;
+        includeArchived?: boolean;
+        userId?: string | null;
+    }): Promise<{
+        sessions: Session[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    listSessionMembers(sessionId: string): Promise<SessionMember[]>;
+    addSessionMember(sessionId: string, userId: string, role: 'editor' | 'viewer'): Promise<void>;
+    updateSessionMemberRole(sessionId: string, userId: string, role: 'editor' | 'viewer'): Promise<void>;
+    removeSessionMember(sessionId: string, userId: string): Promise<void>;
+}