gentiq 0.8.0 → 0.8.2

package/dist/src/ChatReferencesContext.d.ts

@@ -0,0 +1,27 @@
+import { HTMLAttributes, ReactNode } from 'react';
+import { ChatReference, ChatReferenceInput } from './types';
+interface ChatReferencesContextValue {
+    references: ChatReference[];
+    addReference: (reference: ChatReferenceInput) => ChatReference | null;
+    removeReference: (id: string) => void;
+    clearReferences: () => void;
+    focusReference: (reference: ChatReference) => boolean;
+    registerSource: (reference: ChatReferenceInput) => void;
+    unregisterSource: (sourceId?: string) => void;
+    enabled: boolean;
+}
+interface ChatReferencesProviderProps {
+    enabled?: boolean;
+    readonly?: boolean;
+    maxItems?: number;
+    maxExcerptLength?: number;
+    children: ReactNode;
+}
+export declare function ChatReferencesProvider({ enabled, readonly, maxItems, maxExcerptLength, children, }: ChatReferencesProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useChatReferences(): ChatReferencesContextValue;
+export interface ReferenceableProps extends HTMLAttributes<HTMLDivElement> {
+    reference: ChatReferenceInput;
+    showAction?: boolean;
+}
+export declare function Referenceable({ reference, showAction, className, children, ...props }: ReferenceableProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/ComponentsContext.d.ts

@@ -4,8 +4,9 @@ import { GentiqComponents } from './types';
  * The resolved component map: every key is guaranteed to be defined.
  * Leaf components read from this context — no prop drilling required.
  */
-type ResolvedComponents = Required<Omit<GentiqComponents, 'toolComponents' | 'textComponents' | 'remarkPlugins' | 'rehypePlugins'>> & {
+type ResolvedComponents = Required<Omit<GentiqComponents, 'toolComponents' | 'referenceAdapters' | 'textComponents' | 'remarkPlugins' | 'rehypePlugins'>> & {
     toolComponents?: GentiqComponents['toolComponents'];
+    referenceAdapters?: GentiqComponents['referenceAdapters'];
     textComponents?: GentiqComponents['textComponents'];
     remarkPlugins?: GentiqComponents['remarkPlugins'];
     rehypePlugins?: GentiqComponents['rehypePlugins'];

package/dist/src/components/PromptInputArea.d.ts

@@ -1,5 +1,6 @@
+import { ChatReference } from '../types';
 interface PromptInputAreaProps {
-    onSend: (text: string, files?: FileList) => void;
+    onSend: (text: string, files?: FileList, references?: ChatReference[]) => void;
     status: string;
     isLastMessageFinished: boolean;
     stop: () => void;

package/dist/src/hooks/useGentiqChat.d.ts

@@ -1,9 +1,10 @@
+import { ChatReference } from '../types';
 export type ChatStatus = 'idle' | 'loading-history' | 'ready' | 'streaming' | 'error' | 'submitted';
 export interface UseGentiqChatOptions {
     onFinish?: () => void;
 }
 export declare function useGentiqChat({ onFinish }?: UseGentiqChatOptions): {
-    sendMessage: (text: string, files?: FileList) => Promise<void>;
+    sendMessage: (text: string, files?: FileList, references?: ChatReference[]) => Promise<void>;
     stop: () => void;
     clearError: () => void;
     error: Error | null;

package/dist/src/index.d.ts

@@ -8,6 +8,9 @@ export { TextPart } from './parts/TextPart';
 export { ReasoningPart } from './parts/ReasoningPart';
 export { ToolPart } from './parts/ToolPart';
 export { FilePart } from './parts/FilePart';
+export { ReferencePart } from './parts/ReferencePart';
+export { ChoiceQuestionPart } from './parts/ChoiceQuestionPart';
+export { Referenceable, useChatReferences } from './ChatReferencesContext';
 export { MessageList } from './components/MessageList';
 export { PromptInputArea } from './components/PromptInputArea';
 export { SettingsDialog } from './components/SettingsDialog';

package/dist/src/locales/en.json.d.ts

@@ -39,6 +39,13 @@ declare const _default: {
         "dislike": "Dislike",
         "attach_file": "Attach file",
         "remove_file": "Remove file",
+        "reference": "Reference",
+        "reference_selection": "Reference selection",
+        "remove_reference": "Remove reference",
+        "referenced_context": "Referenced context",
+        "source_unavailable": "Source unavailable",
+        "tool_reference": "Tool reference",
+        "card_reference": "Card reference",
         "used_sources": "Used {{count}} sources",
         "welcome": {
             "title": "Hello! How can I help you today?",
@@ -204,6 +211,7 @@ declare const _default: {
             "threads_chart": "Threads",
             "messages_chart": "Messages",
             "token_usage_chart": "Token Usage",
+            "cost_chart": "Cost Per Day",
             "active_users": "Active Users",
             "conversations": "conversations",
             "threads": "threads",

package/dist/src/locales/fa.json.d.ts

@@ -39,6 +39,13 @@ declare const _default: {
         "dislike": "نپسندیدم",
         "attach_file": "پیوست فایل",
         "remove_file": "حذف فایل",
+        "reference": "ارجاع",
+        "reference_selection": "ارجاع به بخش انتخاب‌شده",
+        "remove_reference": "حذف ارجاع",
+        "referenced_context": "بخش ارجاع‌شده",
+        "source_unavailable": "منبع در دسترس نیست",
+        "tool_reference": "ارجاع به ابزار",
+        "card_reference": "ارجاع به کارت",
         "used_sources": "از {{count}} منبع استفاده شد",
         "welcome": {
             "title": "سلام! چطور می‌تونم کمکت کنم؟",
@@ -203,6 +210,7 @@ declare const _default: {
             "threads_chart": "گفتگوها",
             "messages_chart": "پیام‌ها",
             "token_usage_chart": "مصرف توکن",
+            "cost_chart": "هزینه روزانه",
             "active_users": "کاربران فعال",
             "conversations": "گفتگو",
             "threads": "گفتگو",

package/dist/src/parts/ChoiceQuestionPart.d.ts

@@ -0,0 +1,5 @@
+import { ChoiceQuestion, ChoiceQuestionPartProps } from '../types';
+export type { ChoiceQuestionPartProps } from '../types';
+export declare function normalizeChoiceQuestion(data: unknown): ChoiceQuestion | null;
+export declare function extractChoiceQuestionFromText(text: string | undefined): ChoiceQuestion | null;
+export declare function ChoiceQuestionPart({ part, disabled, onAnswer }: ChoiceQuestionPartProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/parts/ReferencePart.d.ts

@@ -0,0 +1,3 @@
+import { ReferencePartProps } from '../types';
+export type { ReferencePartProps } from '../types';
+export declare function ReferencePart({ part, message }: ReferencePartProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/parts/TextPart.d.ts

@@ -1,3 +1,3 @@
 import { TextPartProps } from '../types';
 export type { TextPartProps } from '../types';
-export declare function TextPart({ part, message, status, isFinished, lastMessage, isLastVisiblePart, regen, feedback, handleFeedback, copyHost, feedbackEnabled, retryEnabled, }: TextPartProps): import("react/jsx-runtime").JSX.Element;
+export declare function TextPart({ part, message, status, isFinished, lastMessage, isLastVisiblePart, regen, feedback, handleFeedback, copyHost, feedbackEnabled, retryEnabled, reference, }: TextPartProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/parts/index.d.ts

@@ -2,3 +2,5 @@ export * from './TextPart';
 export * from './ReasoningPart';
 export * from './ToolPart';
 export * from './FilePart';
+export * from './ReferencePart';
+export * from './ChoiceQuestionPart';

package/dist/src/types.d.ts

@@ -198,6 +198,15 @@ export interface ComposerConfig {
         /** Allowed MIME types for files. */
         types?: string[];
     };
+    /** Configuration for chat references. */
+    references?: {
+        /** Whether users can reference earlier chat content from the composer. */
+        enabled?: boolean;
+        /** Maximum number of active references in the composer. Defaults to 5. */
+        maxItems?: number;
+        /** Maximum excerpt length stored/sent for each reference. Defaults to 500. */
+        maxExcerptLength?: number;
+    };
 }
 /**
  * Configuration for the UI theme and styling.
@@ -401,6 +410,90 @@ export interface TextPartProps {
     feedbackEnabled?: boolean;
     /** Whether the retry button is enabled. */
     retryEnabled?: boolean;
+    /** Reference metadata for the visible text content. */
+    reference?: ChatReferenceInput;
+}
+/**
+ * Structured reference context selected from an earlier message or explicit UI card.
+ */
+export interface ChatReference {
+    /** Unique ID for this reference instance. */
+    id: string;
+    /** Reference source type. */
+    kind: 'text' | 'card' | 'tool' | 'file' | string;
+    /** Source message ID, when the source belongs to a chat message. */
+    messageId?: string;
+    /** Source part index, when the source belongs to a message part. */
+    partIndex?: number;
+    /** Stable DOM/source identifier used for focus and highlighting. */
+    sourceId?: string;
+    /** Human-readable source label shown in UI and sent as context. */
+    label: string;
+    /** Human-readable selected or summarized content. */
+    excerpt: string;
+    /** Role of the source message. */
+    role?: UIMessage['role'];
+    /** Optional structured data for custom cards/tools. */
+    data?: unknown;
+    /** Optional source metadata for apps that need provenance. */
+    metadata?: Record<string, unknown>;
+}
+export type ChatReferenceInput = Omit<ChatReference, 'id'> & {
+    id?: string;
+};
+export interface ReferenceAdapterContext {
+    /** The source part being referenced. */
+    part: UIMessagePart<any, any>;
+    /** The parent message object. */
+    message: UIMessage;
+    /** Resolved tool name for tool parts, when available. */
+    toolName?: string;
+    /** Direct access to the chat state if needed. */
+    chat?: any;
+}
+export type ReferenceAdapter = (context: ReferenceAdapterContext) => Partial<ChatReferenceInput> | null | undefined;
+export interface ReferencePartProps {
+    /** Reference part stored on a user message. */
+    part: UIMessagePart<any, any> & {
+        type: 'data-reference';
+        data?: ChatReference;
+        reference?: ChatReference;
+    };
+    /** Parent message. */
+    message: UIMessage;
+}
+/**
+ * One selectable option shown in a Gentiq choice question.
+ */
+export interface ChoiceQuestionChoice {
+    /** Human-readable option shown to the user and sent when selected. */
+    label: string;
+    /** Optional app-specific value for custom renderers. */
+    value?: unknown;
+}
+/**
+ * Structured assistant question that can be answered with one tap.
+ */
+export interface ChoiceQuestion {
+    /** The question shown above the options. */
+    question: string;
+    /** Choices the user can select. */
+    choices: ChoiceQuestionChoice[];
+    /** Whether the default renderer should show a custom answer field. Defaults to true. */
+    allowCustom?: boolean;
+}
+export interface ChoiceQuestionPartProps {
+    /** Choice-question data part produced by the Gentiq backend. */
+    part: UIMessagePart<any, any> & {
+        type: 'data-choice-question';
+        data?: ChoiceQuestion | ChoiceQuestion[];
+    };
+    /** Parent message. */
+    message: UIMessage;
+    /** Whether the controls should accept an answer. */
+    disabled?: boolean;
+    /** Submit a selected/custom answer as a normal user message. */
+    onAnswer?: (answer: string) => void | Promise<void>;
 }
 /**
  * Props for the ReasoningPart component, which renders chain-of-thought steps.
@@ -484,7 +577,7 @@ export interface MessageListProps {
  */
 export interface PromptInputProps {
     /** Callback to send a message. */
-    onSend: (text: string, files?: FileList) => void;
+    onSend: (text: string, files?: FileList, references?: ChatReference[]) => void;
     /** Current chat status. */
     status: string;
     /** Whether the last message has finished streaming. */
@@ -538,12 +631,32 @@ export interface GentiqComponents {
     ToolPart?: ComponentType<ToolPartProps>;
     /** Replaces the file attachment renderer */
     FilePart?: ComponentType<FilePartProps>;
+    /** Replaces the reference renderer */
+    ReferencePart?: ComponentType<ReferencePartProps>;
+    /** Replaces the multiple-choice question renderer */
+    ChoiceQuestionPart?: ComponentType<ChoiceQuestionPartProps>;
     /**
      * Per-tool-name component overrides.
      * Takes priority over a custom ToolPart if the tool name matches.
      * @example { get_weather: WeatherCard, run_code: CodeCard }
      */
     toolComponents?: Record<string, ComponentType<ToolCallComponentProps>>;
+    /**
+     * Per-tool/card reference display adapters.
+     * Return label/excerpt/data overrides used in composer chips, sent context,
+     * and reference badges.
+     *
+     * @example
+     * ```ts
+     * referenceAdapters: {
+     *   get_weather: ({ part }) => ({
+     *     label: 'Weather',
+     *     excerpt: `Weather: ${part.output.city}: ${part.output.condition}`,
+     *   }),
+     * }
+     * ```
+     */
+    referenceAdapters?: Record<string, ReferenceAdapter>;
     /** Custom components mapping for markdown rendering overrides. */
     textComponents?: Record<string, ComponentType<any>>;
     /** Custom remark plugins for markdown parsing. */

package/package.json

@@ -10,7 +10,7 @@
     "provenance": true
   },
   "description": "React UI library for the Gentiq AI framework.",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "type": "module",
   "files": [
     "dist"