teodor-new-chat-ui 4.3.396 → 4.3.398

package/dist/lib/attemptDetection.d.ts

@@ -11,6 +11,7 @@
  * msg3 appears in multiple checkpoints = multiple attempts/versions
  */
 import type { HydratedCheckpointSnapshot } from "@/types/models";
+import type { CheckpointAttemptInfo } from "@/types/checkpoints";
 export interface AttemptMetadata {
     attemptIndex: number;
     attemptCount: number;
@@ -23,10 +24,5 @@ export interface AttemptMetadata {
  */
 export declare function buildAttemptMaps(checkpoints: HydratedCheckpointSnapshot[]): {
     attemptMetaById: Map<string, AttemptMetadata>;
-    userMessageIdToAttempts: Map<string, Array<{
-        checkpointId: string;
-        attemptIndex: number;
-        attemptCount: number;
-        isLatestAttempt: boolean;
-    }>>;
+    userMessageIdToAttempts: Map<string, CheckpointAttemptInfo[]>;
 };

package/dist/lib/checkpointIndex.d.ts

@@ -0,0 +1,15 @@
+import type { HydratedCheckpointSnapshot } from "@/types";
+import type { CheckpointAttemptInfo, CheckpointMeta, CheckpointMetaWithAttempts, TimelineCheckpoint } from "@/types/checkpoints";
+export interface CheckpointIndex {
+    checkpoints: HydratedCheckpointSnapshot[];
+    checkpointMetaById: Map<string, CheckpointMeta>;
+    checkpointIndexByKey: Map<string, CheckpointMeta[]>;
+    attemptMetaById: Map<string, CheckpointMetaWithAttempts>;
+    userMessageIdToAttempts: Map<string, CheckpointAttemptInfo[]>;
+    timeline: TimelineCheckpoint[];
+    messagePreviews: Map<string, string>;
+    getLatest: () => CheckpointMeta | undefined;
+    getCheckpoint: (id: string) => CheckpointMeta | undefined;
+    getAttempts: (userMessageId: string) => CheckpointAttemptInfo[];
+}
+export declare function buildCheckpointIndex(checkpoints: HydratedCheckpointSnapshot[]): CheckpointIndex;

package/dist/lib/index.d.ts

@@ -13,8 +13,6 @@ export type { MessageComponentProps } from '../components/chat/MessageComponent'
 export { MessageList } from '../components/chat/MessageList';
 export type { MessageListProps } from '../components/chat/MessageList';
 export { ThreadManager } from '../components/chat/ThreadManager';
-export { TimelineColumn } from '../components/chat/TimelineColumn';
-export type { TimelineColumnProps } from '../components/chat/TimelineColumn';
 export { useMessagesReducer } from '@/context/reducers/MessageReducer';
 export { useStream as useChatStream } from '@/hooks/use-stream';
 export { ChatApi, chatApiClient } from '../api/chat-api';
@@ -25,6 +23,8 @@ export { ChatSettings } from '@/components/settings/ChatSettings';
 export type { ChatSettingsConfig } from '@/components/settings/ChatSettings';
 export type { ChatMessage, ChatRequest, StateSnapshot, HistoryPayload, HydratedCheckpointSnapshot, MessagePart, PregelTask, Role, StreamEvent, TextPart, ThreadInfo, ThreadShareTarget, ThreadSummary, ToolEndEvent } from '@/types';
 export { buildMessagePreviewMap } from './messagePreviews';
+export { buildCheckpointIndex } from './checkpointIndex';
+export type { CheckpointIndex } from './checkpointIndex';
 export type { ChatAppProps, SimpleChatProps } from '../components/chat/ChatApp';
 export type { ChatProvidersProps } from '../context/ChatProviders';
 export { ChatApp as default } from '../components/chat/ChatApp';

package/dist/lib/messageMetadataResolver.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Message Metadata Resolver
+ *
+ * Pure function that resolves checkpoint metadata for a single message.
+ * Extracted from the hook for:
+ * - Better testability (pure function)
+ * - Reusability outside React context
+ * - Clear separation of heuristics from memoization
+ */
+import type { ChatMessage, DefaultMessage } from "@/types";
+import type { CheckpointIndex } from "@/lib/checkpointIndex";
+import type { CheckpointMeta } from "@/types/checkpoints";
+export interface ResolvedMessageMetadata {
+    checkpointCandidates: CheckpointMeta[];
+    defaultCheckpointId: string | null;
+    resolvedStep: number | null;
+    resolvedSource: string | null;
+}
+/**
+ * Resolves checkpoint metadata for a message given a checkpoint index.
+ *
+ * Handles:
+ * - Multi-source step/source fallback (additionalKwargs > responseMetadata > index)
+ * - Checkpoint candidate lookup by step:source key
+ * - Attempt filtering for edited/multi-version messages
+ * - Attempt metadata enrichment
+ *
+ * @param message - The message to resolve metadata for
+ * @param index - The pre-built checkpoint index (consolidates all lookup maps)
+ * @returns Resolved metadata including candidates and resolved step/source
+ */
+export declare function resolveMessageMetadata(message: ChatMessage | DefaultMessage | undefined, index: CheckpointIndex): ResolvedMessageMetadata;

package/dist/lib/messagePreviews.d.ts

@@ -1,5 +1,6 @@
 import type { ChatMessage } from '@/types';
 import type { HydratedCheckpointSnapshot } from '@/types/models';
+export declare function getPreviewForMessage(message: ChatMessage): string;
 /**
  * Legacy function: builds a map of message ID -> preview text.
  * This creates a single preview per message ID, with later occurrences overwriting earlier ones.

package/dist/types/checkpoints.d.ts

@@ -0,0 +1,33 @@
+export type EditMeta = {
+    checkpointId?: string | null;
+    checkpointNs?: string | null;
+};
+export type CheckpointMeta = {
+    id: string;
+    step: number | null;
+    source: string | null;
+    createdAt: string | null;
+    namespace: string | null;
+    parentId: string | null;
+};
+export type CheckpointMetaWithAttempts = CheckpointMeta & {
+    attemptIndex: number;
+    attemptCount: number;
+    isLatestAttempt: boolean;
+    baseUserMessageId: string | null;
+};
+export type CheckpointAttemptInfo = {
+    checkpointId: string;
+    attemptIndex: number;
+    attemptCount: number;
+    isLatestAttempt: boolean;
+};
+export type TimelineCheckpoint = {
+    id: string;
+    messageId: string | null;
+    step: number | null;
+    source: string | null;
+    createdAt: string | null;
+    next?: string | null;
+    parentConfig?: Record<string, unknown> | null;
+};

package/dist/types/requests.d.ts

@@ -1,5 +1,5 @@
 import type { StreamCommand } from "./events";
-import type { TimelineCheckpoint } from "@/hooks/useCheckpointSelectors";
+import type { TimelineCheckpoint } from "@/hooks/checkpoints";
 export interface ChatRequest {
     threadId?: string | null;
     payload?: Record<string, unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teodor-new-chat-ui",
-  "version": "4.3.396",
+  "version": "4.3.398",
   "description": "React chat UI components with streaming support, tool calls, and modern design",
   "main": "dist/index.umd.js",
   "module": "dist/index.esm.js",

package/dist/components/chat/TimelineColumn.d.ts

@@ -1,12 +0,0 @@
-import type { TimelineCheckpoint } from "@/hooks/useCheckpointSelectors";
-export interface TimelineColumnProps {
-    timelineEntries: TimelineCheckpoint[];
-    activeCheckpointId?: string | null;
-    onSelectCheckpoint?: (checkpointId: string | null) => Promise<void> | void;
-    messagePreviews?: Map<string, string>;
-    className?: string;
-    onHoverStart?: () => void;
-    onHoverEnd?: () => void;
-}
-export declare const TimelineColumn: ({ timelineEntries, activeCheckpointId, onSelectCheckpoint, messagePreviews, className, onHoverStart, onHoverEnd, }: TimelineColumnProps) => import("react/jsx-runtime").JSX.Element | null;
-export default TimelineColumn;

package/dist/hooks/useCheckpointMetadata.d.ts

@@ -1,33 +0,0 @@
-/**
- * useCheckpointMetadata Hook
- *
- * Builds checkpoint metadata maps from server checkpoint options.
- *
- * Encapsulates logic for:
- * - Normalizing and sorting checkpoint options
- * - Building checkpoint lookups (by ID, by step:source)
- * - Detecting edited messages (attempt detection via buildAttemptMaps)
- *
- * This hook moves ~107 lines of metadata preparation logic from ChatInterface,
- * resulting in cleaner separation of concerns.
- */
-import type { HydratedCheckpointSnapshot } from "@/types";
-import type { CheckpointMeta, CheckpointMetaWithAttempts } from "@/hooks/useCheckpointSelectors";
-export interface CheckpointMetadataResult {
-    checkpointMetaById: Map<string, CheckpointMeta>;
-    checkpointIndexByKey: Map<string, CheckpointMeta[]>;
-    attemptMetaById: Map<string, CheckpointMetaWithAttempts>;
-    userMessageIdToAttempts: Map<string, Array<{
-        checkpointId: string;
-        attemptIndex: number;
-        attemptCount: number;
-        isLatestAttempt: boolean;
-    }>>;
-}
-/**
- * Hook to build and memoize checkpoint metadata from server options.
- *
- * @param checkpointOptions - Raw checkpoint snapshots from the server
- * @returns Memoized metadata maps for efficient lookups
- */
-export declare function useCheckpointMetadata(checkpointOptions: HydratedCheckpointSnapshot[]): CheckpointMetadataResult;

package/dist/hooks/useCheckpointSelectors.d.ts

@@ -1,36 +0,0 @@
-import type { HydratedCheckpointSnapshot, PendingInterrupt as Interrupt } from "@/types";
-export type EditMeta = {
-    checkpointId?: string | null;
-    checkpointNs?: string | null;
-};
-export type TimelineCheckpoint = {
-    id: string;
-    label: string;
-    messageId: string | null;
-    step: number | null;
-    source: string | null;
-    createdAt: string | null;
-    next?: string | null;
-    parentConfig?: Record<string, unknown> | null;
-};
-export declare function useCheckpointTimeline(checkpoints: HydratedCheckpointSnapshot[]): TimelineCheckpoint[];
-export type CheckpointMeta = {
-    id: string;
-    step: number | null;
-    source: string | null;
-    createdAt: string | null;
-    namespace: string | null;
-    parentId: string | null;
-};
-export declare function useCheckpointMeta(checkpoints: HydratedCheckpointSnapshot[]): CheckpointMeta[];
-export type CheckpointMetaWithAttempts = CheckpointMeta & {
-    attemptIndex: number;
-    attemptCount: number;
-    isLatestAttempt: boolean;
-    baseUserMessageId: string | null;
-};
-export declare function useCheckpointAttempts(checkpoints: HydratedCheckpointSnapshot[]): CheckpointMetaWithAttempts[];
-export declare function isExecutionPaused(snapshot: HydratedCheckpointSnapshot): boolean;
-export declare function getCurrentInterrupt(snapshot: HydratedCheckpointSnapshot): Interrupt | null;
-export declare function getLatestCheckpoint(checkpoints: HydratedCheckpointSnapshot[]): HydratedCheckpointSnapshot | undefined;
-export declare function useCheckpointById(checkpoints: HydratedCheckpointSnapshot[], checkpointId: string | null): HydratedCheckpointSnapshot | undefined;

package/dist/hooks/useMessageMetadata.d.ts

@@ -1,39 +0,0 @@
-/**
- * useMessageMetadata Hook
- *
- * Resolves and enriches metadata for a single message, including:
- * - Checkpoint candidates (versions/branches of a conversation)
- * - Attempt information (if message was edited/attempted multiple times)
- * - Resolved step/source from multiple possible sources
- *
- * This hook encapsulates ~120 lines of complex metadata resolution logic
- * that was previously embedded in MessageList.tsx's render function.
- */
-import type { ChatMessage, DefaultMessage } from "@/types";
-import type { CheckpointMeta, CheckpointMetaWithAttempts } from "@/hooks/useCheckpointSelectors";
-export interface MetadataResolverMaps {
-    checkpointMetaById?: Map<string, CheckpointMeta>;
-    checkpointIndexByKey?: Map<string, CheckpointMeta[]>;
-    attemptMetaById?: Map<string, CheckpointMetaWithAttempts>;
-    userMessageIdToAttempts?: Map<string, Array<{
-        checkpointId: string;
-        attemptIndex: number;
-        attemptCount: number;
-        isLatestAttempt: boolean;
-    }>>;
-}
-export interface ResolvedMessageMetadata {
-    checkpointCandidates: CheckpointMeta[];
-    defaultCheckpointId: string | null;
-    attemptMeta: CheckpointMetaWithAttempts | null;
-    resolvedStep: number | null;
-    resolvedSource: string | null;
-}
-/**
- * Hook to resolve metadata for a single message.
- *
- * @param message - The message to resolve metadata for (ChatMessage or DefaultMessage)
- * @param maps - Container with all required metadata lookup maps
- * @returns Resolved metadata including candidates, attempt info, and step/source
- */
-export declare function useMessageMetadata(message: ChatMessage | DefaultMessage | undefined, maps: MetadataResolverMaps): ResolvedMessageMetadata;