gentiq 0.8.3 → 0.10.0

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

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

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

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

package/dist/src/types.d.ts

@@ -1,6 +1,11 @@
-import { ComponentType } from 'react';
+import { ComponentProps, ComponentType, ReactNode } from 'react';
 import { UIMessage, UIMessagePart } from 'ai';
 import { TFunction } from 'i18next';
+import { LucideIcon } from 'lucide-react';
+import { Streamdown } from 'streamdown';
+/** Props accepted by the markdown renderer (Streamdown), used to type the
+ *  markdown override slots below without restating their (evolving) shapes. */
+type StreamdownProps = ComponentProps<typeof Streamdown>;
 /**
  * Represents a single conversation thread in the history.
  */
@@ -33,6 +38,172 @@ export interface GentiqUser {
     } | null;
     created_at?: string;
 }
+/**
+ * A user's token/request balance as returned by the backend.
+ */
+export interface UserBalance {
+    tokens: number;
+    requests: number;
+    token_limit: number;
+    request_limit: number;
+    updated_at?: string | null;
+}
+/** Cadence unit for an automatic balance-recharge policy. */
+export type RechargeIntervalUnit = 'minute' | 'hour' | 'day' | 'week' | 'month';
+/**
+ * A user's automatic balance-recharge policy.
+ */
+export interface RechargePolicy {
+    enabled: boolean;
+    interval_value?: number | null;
+    interval_unit?: RechargeIntervalUnit | null;
+    anchor_at?: string | null;
+    next_recharge_at?: string | null;
+    last_recharged_at?: string | null;
+}
+/**
+ * Response from the login endpoint.
+ */
+export interface AuthResponse {
+    user_id: string;
+    phone: string;
+    name: string;
+    surname: string;
+    token: string;
+    balance?: UserBalance | null;
+    recharge_policy?: RechargePolicy | null;
+}
+/**
+ * Response from the registration endpoint.
+ */
+export interface RegisterResponse {
+    user_id: string;
+    phone: string;
+    name: string;
+    surname: string;
+    token: string;
+}
+/**
+ * Generic `{ status, message }` acknowledgement returned by mutating endpoints.
+ */
+export interface StatusResponse {
+    status: string;
+    message: string;
+}
+/**
+ * Response from the feedback endpoint.
+ */
+export interface FeedbackResponse {
+    status: string;
+}
+/**
+ * A single thread summary in the chat history list.
+ */
+export interface ThreadSummary {
+    id: string;
+    title?: string;
+    firstMessage?: string;
+    created_at: string;
+    updated_at?: string | null;
+    pinned?: boolean;
+    user_info?: {
+        name?: string;
+        surname?: string;
+        phone?: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+/**
+ * Paginated chat-history response.
+ */
+export interface ThreadHistoryResponse {
+    threads: ThreadSummary[];
+    skip: number;
+    limit: number;
+    count: number;
+    total_count: number;
+}
+/**
+ * A raw thread message item as persisted by the backend. The `content`/`parts`
+ * payload is intentionally loose — it is normalized into UI message parts by
+ * the chat hook.
+ */
+export interface ThreadMessageItem {
+    id?: string;
+    role?: string;
+    content?: unknown;
+    parts?: unknown[];
+    feedback?: string;
+    created_at?: string;
+}
+/**
+ * Response containing the messages of a single thread.
+ */
+export interface ThreadMessagesResponse {
+    items: ThreadMessageItem[];
+}
+/**
+ * Response from sharing a thread.
+ */
+export interface ShareThreadResponse {
+    status: string;
+    share_id: string;
+    url: string;
+}
+/**
+ * Response containing a publicly shared thread and its messages.
+ */
+export interface SharedThreadResponse {
+    id: string;
+    title: string;
+    items: ThreadMessageItem[];
+    created_at: string;
+}
+/**
+ * The flat application settings model returned by the backend `/config`
+ * endpoint and the admin settings API. Also used as the source for layering
+ * backend-driven configuration over local {@link GentiqConfig}.
+ */
+export interface AppSettings {
+    app_name: string;
+    admin_title?: string | null;
+    default_theme?: 'system' | 'light' | 'dark' | null;
+    default_accent?: string | null;
+    welcome_greeting?: string | null;
+    welcome_subtitle?: string | null;
+    disclaimer?: string | null;
+    show_tool_details: boolean;
+    show_settings: boolean;
+    show_version_in_settings: boolean;
+    disable_signup: boolean;
+    disable_auth_page: boolean;
+    composer_attachments: boolean;
+    thread_actions_feedback: boolean;
+    thread_actions_retry: boolean;
+    history_enabled: boolean;
+    history_show_delete: boolean;
+    history_show_rename: boolean;
+    history_show_share: boolean;
+    history_show_pin: boolean;
+    settings_general_mode: string;
+    settings_profile_mode: string;
+    settings_account_mode: string;
+    settings_general_fields: Record<string, unknown>;
+    settings_profile_fields: Record<string, unknown>;
+    settings_account_fields: Record<string, unknown>;
+    language: string;
+    translations: Record<string, unknown>;
+    initial_balance_tokens?: number | null;
+    initial_balance_requests?: number | null;
+    updated_at?: string | null;
+}
+/**
+ * Response from the public `/config` endpoint — {@link AppSettings} plus the
+ * deployed application version injected by the backend.
+ */
+export interface AppConfigResponse extends AppSettings {
+    app_version?: string | null;
+}
 /**
  * User data available when building a personalized welcome greeting.
  */
@@ -122,6 +293,8 @@ export interface GentiqEndpoints {
     updateThreadTitle?: (threadId: string) => string;
     /** Retrieve attachment metadata/url. */
     attachments?: (objectName: string) => string;
+    /** Retrieve a publicly shared attachment metadata/url. */
+    sharedAttachments?: (objectName: string) => string;
     /** Send feedback for a message. */
     feedback?: string;
     /** Chat streaming endpoint. */
@@ -156,7 +329,7 @@ export interface WelcomeSuggestion {
     /** The text of the suggestion. */
     text: string;
     /** Optional icon to display alongside the text. */
-    icon?: any;
+    icon?: LucideIcon;
 }
 /**
  * Configuration for the welcome/empty-state screen.
@@ -172,7 +345,7 @@ export interface WelcomeScreenConfig {
     /** Optional override for the starter prompt suggestions. */
     prompts?: (string | WelcomeSuggestion)[];
     /** Optional override for the icon displayed on the welcome screen. Defaults to null. */
-    icon?: any;
+    icon?: LucideIcon | ReactNode;
 }
 /**
  * Configuration for actions available on individual chat bubbles.
@@ -312,7 +485,7 @@ export interface SettingsConfig {
 export interface MetadataFieldCondition {
     field: string;
     operator?: 'equals' | 'not_equals' | 'in' | 'not_in';
-    value: any;
+    value: unknown;
 }
 export interface UserMetadataField {
     key: string;
@@ -320,13 +493,13 @@ export interface UserMetadataField {
     type: 'text' | 'number' | 'email' | 'tel' | 'date' | 'select' | 'checkbox';
     options?: {
         label: string;
-        value: any;
+        value: string | number | boolean;
     }[];
     required?: boolean;
     showInSignup?: boolean;
     showInProfile?: boolean;
     placeholder?: string;
-    defaultValue?: any;
+    defaultValue?: unknown;
     condition?: MetadataFieldCondition;
     /** Display mode for the field in the profile settings. */
     mode?: SettingsFieldMode;
@@ -448,7 +621,7 @@ export interface ReferenceAdapterContext {
     message: UIMessage;
     /** Resolved tool name for tool parts, when available. */
     toolName?: string;
-    /** Direct access to the chat state if needed. */
+    /** Direct access to the chat state if needed (the full AI SDK chat handle). */
     chat?: any;
 }
 export type ReferenceAdapter = (context: ReferenceAdapterContext) => Partial<ChatReferenceInput> | null | undefined;
@@ -520,7 +693,7 @@ export interface ToolPartProps {
     part: UIMessagePart<any, any>;
     /** The parent message object. */
     message: UIMessage;
-    /** Direct access to the chat state if needed. */
+    /** Direct access to the chat state if needed (the full AI SDK chat handle). */
     chat?: any;
     /** Per-tool-name component map — resolved from GentiqComponents.toolComponents */
     toolComponents?: Record<string, ComponentType<ToolCallComponentProps>>;
@@ -545,7 +718,7 @@ export interface WelcomeScreenProps {
     /** Callback for when a conversation starter is clicked. */
     onSuggestionClick: (suggestion: string) => void;
     /** Optional icons to showcase on the screen. */
-    icons?: any[];
+    icons?: LucideIcon[];
 }
 /**
  * Props for the MessageList component, which manages the scrollable list of messages.
@@ -565,7 +738,7 @@ export interface MessageListProps {
     regen: (id: string) => void;
     /** Callback for when a suggestion is clicked (e.g. from the empty state). */
     onSuggestionClick: (suggestion: string) => void;
-    /** Direct access to the chat state. */
+    /** Direct access to the chat state (the full AI SDK chat handle). */
     chat?: any;
     /** Custom CSS class names. */
     className?: string;
@@ -600,7 +773,7 @@ export interface ToolCallComponentProps {
     part: UIMessagePart<any, any>;
     /** The parent message object. */
     message: UIMessage;
-    /** Direct access to the chat state. */
+    /** Direct access to the chat state (the full AI SDK chat handle). */
     chat?: any;
 }
 /**
@@ -658,11 +831,11 @@ export interface GentiqComponents {
      */
     referenceAdapters?: Record<string, ReferenceAdapter>;
     /** Custom components mapping for markdown rendering overrides. */
-    textComponents?: Record<string, ComponentType<any>>;
+    textComponents?: StreamdownProps['components'];
     /** Custom remark plugins for markdown parsing. */
-    remarkPlugins?: any[];
+    remarkPlugins?: StreamdownProps['remarkPlugins'];
     /** Custom rehype plugins for markdown parsing. */
-    rehypePlugins?: any[];
+    rehypePlugins?: StreamdownProps['rehypePlugins'];
 }
 export interface AdminPage {
     path: string;
@@ -671,3 +844,4 @@ export interface AdminPage {
     permission?: string;
 }
 export type BuiltInAdminPage = 'analytics' | 'chat_history' | 'user_management' | 'admin_management' | 'settings';
+export {};

package/package.json

@@ -10,7 +10,7 @@
     "provenance": true
   },
   "description": "React UI library for the Gentiq AI framework.",
-  "version": "0.8.3",
+  "version": "0.10.0",
   "type": "module",
   "files": [
     "dist"
@@ -55,7 +55,6 @@
     "ai": "^5.0.123",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "embla-carousel-react": "^8.6.0",
     "i18next": "^25.8.10",
     "i18next-browser-languagedetector": "^8.2.1",
     "katex": "^0.16.28",
@@ -108,9 +107,10 @@
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "format": "prettier --write",
-    "lint": "eslint",
-    "lint-fix": "eslint --fix --quiet",
+    "format": "prettier --write \"src/**/*.{ts,tsx,css,json}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,css,json}\"",
+    "lint": "eslint src",
+    "lint-fix": "eslint src --fix",
     "dev": "vite",
     "dev:server": "cd agent && uv run uvicorn chatbot.server:app --port 8000",
     "build": "tsc -b && vite build",

package/dist/src/components/ai-elements/Branch.d.ts

@@ -1,20 +0,0 @@
-import { Button } from '../ui/button';
-import { UIMessage } from 'ai';
-import { ComponentProps, HTMLAttributes } from 'react';
-export type BranchProps = HTMLAttributes<HTMLDivElement> & {
-    defaultBranch?: number;
-    onBranchChange?: (branchIndex: number) => void;
-};
-export declare const Branch: ({ defaultBranch, onBranchChange, className, ...props }: BranchProps) => import("react/jsx-runtime").JSX.Element;
-export type BranchMessagesProps = HTMLAttributes<HTMLDivElement>;
-export declare const BranchMessages: ({ children, ...props }: BranchMessagesProps) => import("react/jsx-runtime").JSX.Element[];
-export type BranchSelectorProps = HTMLAttributes<HTMLDivElement> & {
-    from: UIMessage['role'];
-};
-export declare const BranchSelector: ({ className, from, ...props }: BranchSelectorProps) => import("react/jsx-runtime").JSX.Element | null;
-export type BranchPreviousProps = ComponentProps<typeof Button>;
-export declare const BranchPrevious: ({ className, children, ...props }: BranchPreviousProps) => import("react/jsx-runtime").JSX.Element;
-export type BranchNextProps = ComponentProps<typeof Button>;
-export declare const BranchNext: ({ className, children, ...props }: BranchNextProps) => import("react/jsx-runtime").JSX.Element;
-export type BranchPageProps = HTMLAttributes<HTMLSpanElement>;
-export declare const BranchPage: ({ className, ...props }: BranchPageProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/ai-elements/Image.d.ts

@@ -1,6 +0,0 @@
-import { Experimental_GeneratedImage } from 'ai';
-export type ImageProps = Experimental_GeneratedImage & {
-    className?: string;
-    alt?: string;
-};
-export declare const Image: ({ base64, uint8Array, mediaType, ...props }: ImageProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/ai-elements/InlineCitation.d.ts

@@ -1,38 +0,0 @@
-import { Badge } from '../ui/badge';
-import { Carousel } from '../ui/carousel';
-import { HoverCard } from '../ui/hover-card';
-import { ComponentProps } from 'react';
-export type InlineCitationProps = ComponentProps<'span'>;
-export declare const InlineCitation: ({ className, ...props }: InlineCitationProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationTextProps = ComponentProps<'span'>;
-export declare const InlineCitationText: ({ className, ...props }: InlineCitationTextProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationCardProps = ComponentProps<typeof HoverCard>;
-export declare const InlineCitationCard: (props: InlineCitationCardProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationCardTriggerProps = ComponentProps<typeof Badge> & {
-    sources: string[];
-};
-export declare const InlineCitationCardTrigger: ({ sources, className, ...props }: InlineCitationCardTriggerProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationCardBodyProps = ComponentProps<'div'>;
-export declare const InlineCitationCardBody: ({ className, ...props }: InlineCitationCardBodyProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationCarouselProps = ComponentProps<typeof Carousel>;
-export declare const InlineCitationCarousel: ({ className, children, ...props }: InlineCitationCarouselProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationCarouselContentProps = ComponentProps<'div'>;
-export declare const InlineCitationCarouselContent: (props: InlineCitationCarouselContentProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationCarouselItemProps = ComponentProps<'div'>;
-export declare const InlineCitationCarouselItem: ({ className, ...props }: InlineCitationCarouselItemProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationCarouselHeaderProps = ComponentProps<'div'>;
-export declare const InlineCitationCarouselHeader: ({ className, ...props }: InlineCitationCarouselHeaderProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationCarouselIndexProps = ComponentProps<'div'>;
-export declare const InlineCitationCarouselIndex: ({ children, className, ...props }: InlineCitationCarouselIndexProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationCarouselPrevProps = ComponentProps<'button'>;
-export declare const InlineCitationCarouselPrev: ({ className, ...props }: InlineCitationCarouselPrevProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationCarouselNextProps = ComponentProps<'button'>;
-export declare const InlineCitationCarouselNext: ({ className, ...props }: InlineCitationCarouselNextProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationSourceProps = ComponentProps<'div'> & {
-    title?: string;
-    url?: string;
-    description?: string;
-};
-export declare const InlineCitationSource: ({ title, url, description, className, children, ...props }: InlineCitationSourceProps) => import("react/jsx-runtime").JSX.Element;
-export type InlineCitationQuoteProps = ComponentProps<'blockquote'>;
-export declare const InlineCitationQuote: ({ children, className, ...props }: InlineCitationQuoteProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/ai-elements/Task.d.ts

@@ -1,14 +0,0 @@
-import { Collapsible, CollapsibleContent, CollapsibleTrigger } from '../ui/collapsible';
-import { ComponentProps } from 'react';
-export type TaskItemFileProps = ComponentProps<'div'>;
-export declare const TaskItemFile: ({ children, className, ...props }: TaskItemFileProps) => import("react/jsx-runtime").JSX.Element;
-export type TaskItemProps = ComponentProps<'div'>;
-export declare const TaskItem: ({ children, className, ...props }: TaskItemProps) => import("react/jsx-runtime").JSX.Element;
-export type TaskProps = ComponentProps<typeof Collapsible>;
-export declare const Task: ({ defaultOpen, className, ...props }: TaskProps) => import("react/jsx-runtime").JSX.Element;
-export type TaskTriggerProps = ComponentProps<typeof CollapsibleTrigger> & {
-    title: string;
-};
-export declare const TaskTrigger: ({ children, className, title, ...props }: TaskTriggerProps) => import("react/jsx-runtime").JSX.Element;
-export type TaskContentProps = ComponentProps<typeof CollapsibleContent>;
-export declare const TaskContent: ({ children, className, ...props }: TaskContentProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/ai-elements/WebPreview.d.ts

@@ -1,34 +0,0 @@
-import { Button } from '../ui/button';
-import { Input } from '../ui/input';
-import { ComponentProps, ReactNode } from 'react';
-export interface WebPreviewContextValue {
-    url: string;
-    setUrl: (url: string) => void;
-    consoleOpen: boolean;
-    setConsoleOpen: (open: boolean) => void;
-}
-export type WebPreviewProps = ComponentProps<'div'> & {
-    defaultUrl?: string;
-    onUrlChange?: (url: string) => void;
-};
-export declare const WebPreview: ({ className, children, defaultUrl, onUrlChange, ...props }: WebPreviewProps) => import("react/jsx-runtime").JSX.Element;
-export type WebPreviewNavigationProps = ComponentProps<'div'>;
-export declare const WebPreviewNavigation: ({ className, children, ...props }: WebPreviewNavigationProps) => import("react/jsx-runtime").JSX.Element;
-export type WebPreviewNavigationButtonProps = ComponentProps<typeof Button> & {
-    tooltip?: string;
-};
-export declare const WebPreviewNavigationButton: ({ onClick, disabled, tooltip, children, ...props }: WebPreviewNavigationButtonProps) => import("react/jsx-runtime").JSX.Element;
-export type WebPreviewUrlProps = ComponentProps<typeof Input>;
-export declare const WebPreviewUrl: ({ value, onChange, onKeyDown, ...props }: WebPreviewUrlProps) => import("react/jsx-runtime").JSX.Element;
-export type WebPreviewBodyProps = ComponentProps<'iframe'> & {
-    loading?: ReactNode;
-};
-export declare const WebPreviewBody: ({ className, loading, src, ...props }: WebPreviewBodyProps) => import("react/jsx-runtime").JSX.Element;
-export type WebPreviewConsoleProps = ComponentProps<'div'> & {
-    logs?: {
-        level: 'log' | 'warn' | 'error';
-        message: string;
-        timestamp: Date;
-    }[];
-};
-export declare const WebPreviewConsole: ({ className, logs, children, ...props }: WebPreviewConsoleProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/ui/carousel.d.ts

@@ -1,19 +0,0 @@
-import { default as useEmblaCarousel, UseEmblaCarouselType } from 'embla-carousel-react';
-import { Button } from './button';
-import * as React from 'react';
-type CarouselApi = UseEmblaCarouselType[1];
-type UseCarouselParameters = Parameters<typeof useEmblaCarousel>;
-type CarouselOptions = UseCarouselParameters[0];
-type CarouselPlugin = UseCarouselParameters[1];
-interface CarouselProps {
-    opts?: CarouselOptions;
-    plugins?: CarouselPlugin;
-    orientation?: 'horizontal' | 'vertical';
-    setApi?: (api: CarouselApi) => void;
-}
-declare function Carousel({ orientation, opts, setApi, plugins, className, children, ...props }: React.ComponentProps<'div'> & CarouselProps): import("react/jsx-runtime").JSX.Element;
-declare function CarouselContent({ className, ...props }: React.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
-declare function CarouselItem({ className, ...props }: React.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
-declare function CarouselPrevious({ className, variant, size, ...props }: React.ComponentProps<typeof Button>): import("react/jsx-runtime").JSX.Element;
-declare function CarouselNext({ className, variant, size, ...props }: React.ComponentProps<typeof Button>): import("react/jsx-runtime").JSX.Element;
-export { type CarouselApi, Carousel, CarouselContent, CarouselItem, CarouselPrevious, CarouselNext };