@arbidocs/react 0.3.102 → 0.3.104

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-import { ArbiOptions, Arbi, SSEStreamResult, SSEStreamStartData, AgentStepEvent } from '@arbidocs/sdk/browser';
+import { ArbiOptions, Arbi, SSEStreamResult, SSEStreamStartData, AgentStepEvent, ArtifactEvent } from '@arbidocs/sdk/browser';
 export { AgentStepEvent, Arbi, ArbiError, ArbiOptions, ArtifactEvent, CreateMemoryRequest, CreateTaskRequest, MemoryResponse, MemorySearchRequest, MemorySearchResponse, MessageMetadataPayload, OutputTokensDetails, QueryOptions, ResponseCompletedEvent, ResponseContentPartAddedEvent, ResponseCreatedEvent, ResponseFailedEvent, ResponseOutputItemAddedEvent, ResponseOutputItemDoneEvent, ResponseOutputTextDeltaEvent, ResponseOutputTextDoneEvent, ResponseUsage, SSEStreamCallbacks, SSEStreamResult, SSEStreamStartData, TaskResponse, UpdateTaskRequest, UserInputRequestEvent, UserMessageEvent } from '@arbidocs/sdk/browser';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import * as _arbidocs_client from '@arbidocs/client';
@@ -9,6 +9,7 @@ import * as AvatarPrimitive from '@radix-ui/react-avatar';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import * as HoverCardPrimitive from '@radix-ui/react-hover-card';
+import { LucideIcon } from 'lucide-react';
 import * as zustand from 'zustand';
 import { ClassValue } from 'clsx';
 
@@ -320,6 +321,7 @@ declare function useAssistantQuery(): _tanstack_react_query.UseMutationResult<SS
     onToken?: (content: string) => void;
     onStreamStart?: (data: SSEStreamStartData) => void;
     onAgentStep?: (data: AgentStepEvent) => void;
+    onArtifact?: (data: ArtifactEvent) => void;
     onError?: (message: string) => void;
     onComplete?: () => void;
 }, unknown>;
@@ -473,14 +475,14 @@ declare const AvatarImage: React.ForwardRefExoticComponent<Omit<AvatarPrimitive.
 declare const AvatarFallback: React.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarFallbackProps & React.RefAttributes<HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
 
 declare const badgeVariants: (props?: ({
-    variant?: "outline" | "default" | "secondary" | "destructive" | null | undefined;
+    variant?: "outline" | "default" | "accent" | "secondary" | "destructive" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
 }
 declare function Badge({ className, variant, ...props }: BadgeProps): React.JSX.Element;
 
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "outline" | "default" | "secondary" | "destructive" | "ghost" | null | undefined;
+    variant?: "link" | "outline" | "default" | "accent" | "secondary" | "destructive" | "ghost" | null | undefined;
     size?: "default" | "icon" | "sm" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
@@ -492,6 +494,247 @@ declare const HoverCard: React.FC<HoverCardPrimitive.HoverCardProps>;
 declare const HoverCardTrigger: React.ForwardRefExoticComponent<HoverCardPrimitive.HoverCardTriggerProps & React.RefAttributes<HTMLAnchorElement>>;
 declare const HoverCardContent: React.ForwardRefExoticComponent<Omit<HoverCardPrimitive.HoverCardContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 
+declare function Card({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function CardHeader({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function CardTitle({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function CardDescription({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function CardContent({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function CardFooter({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+
+declare function Input({ className, type, ...props }: React.ComponentProps<'input'>): React.JSX.Element;
+
+/**
+ * The AI engine — domain-agnostic hooks for building an AI-native app on ARBI.
+ *
+ * `useAiTask` runs a streaming, cited agentic query (tokens, agent steps and
+ * artifacts accumulate live, with follow-up threading). `useWorkspaceDocs`
+ * resolves a workspace's document ids to ground on, and `useSemanticSearch`
+ * returns retrieval-only cited passages. These wrap the low-level SDK hooks so a
+ * vertical app never re-implements the streaming/accumulation plumbing.
+ */
+
+/**
+ * Resolve a workspace's document set and their external ids. Pass the active
+ * `workspaceId`; the kit stays agnostic about how selection is managed.
+ */
+declare function useWorkspaceDocs(workspaceId?: string): {
+    wsId: string | undefined;
+    docs: {
+        external_id: string;
+        workspace_ext_id: string;
+        file_name?: string | null | undefined;
+        status?: string | null | undefined;
+        error_message?: string | null | undefined;
+        failed_stage?: string | null | undefined;
+        n_pages?: number | null | undefined;
+        n_chunks?: number | null | undefined;
+        tokens?: number | null | undefined;
+        file_type?: string | null | undefined;
+        file_size?: number | null | undefined;
+        storage_type?: string | null | undefined;
+        storage_uri?: string | null | undefined;
+        content_hash?: string | null | undefined;
+        shared?: boolean | null | undefined;
+        re_ocred?: boolean | null | undefined;
+        config_ext_id?: string | null | undefined;
+        parent_ext_id?: string | null | undefined;
+        created_by_ext_id: string;
+        updated_by_ext_id?: string | null | undefined;
+        created_at: string;
+        updated_at: string;
+        wp_type?: string | null | undefined;
+        folder?: string | null | undefined;
+        doctags: {
+            doc_ext_id: string;
+            tag_ext_id: string;
+            note?: string | null | undefined;
+            citations?: {
+                [x: string]: {
+                    chunk_ids: string[];
+                    scores: number[];
+                    statement: string;
+                    offset_start: number;
+                    offset_end: number;
+                };
+            } | null | undefined;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+        }[];
+        doc_metadata?: {
+            doc_nature?: string | null | undefined;
+            doc_author?: string | null | undefined;
+            doc_subject?: string | null | undefined;
+            doc_date?: string | null | undefined;
+            title?: string | null | undefined;
+        } | null | undefined;
+    }[];
+    docIds: string[];
+    isLoading: boolean;
+    isError: boolean;
+    ready: boolean;
+};
+type AiTaskStatus = 'idle' | 'running' | 'done' | 'error';
+interface AiRunOptions {
+    /** Continue a prior turn (follow-up questions in the same thread). */
+    previousResponseId?: string | null;
+    model?: string;
+}
+/**
+ * Run a single streaming agentic task grounded in a set of documents.
+ *
+ * Returns live state (`text` accumulates tokens as they stream) plus a `run`
+ * that resolves to the full {@link SSEStreamResult} — including the response id
+ * needed to chain follow-ups.
+ */
+declare function useAiTask(): {
+    status: AiTaskStatus;
+    text: string;
+    stepCount: number;
+    error: string | null;
+    responseId: string | null;
+    artifacts: {
+        t?: number | null;
+        type: "arbi.artifact";
+        doc_ext_id: string;
+        title: string;
+        mode: "markdown" | "html" | "text";
+        content: string;
+        is_complete: boolean;
+        version: number;
+        message_ext_id?: string | null;
+    }[];
+    run: (question: string, docIds: string[], opts?: AiRunOptions) => Promise<SSEStreamResult | null>;
+    reset: () => void;
+    isRunning: boolean;
+    isDone: boolean;
+};
+interface SearchChunk {
+    docId?: string | null;
+    docTitle?: string | null;
+    page?: number | null;
+    score?: number | null;
+    content: string;
+}
+/** Search a set of documents and return the top matching passages. */
+declare function useSemanticSearch(docIds: string[]): {
+    query: string;
+    results: SearchChunk[];
+    status: AiTaskStatus;
+    error: string | null;
+    search: (q: string, mode?: "semantic" | "keyword" | "hybrid") => Promise<void>;
+    isRunning: boolean;
+};
+
+/** Produce inline `<del>/<ins>` redline markdown from two document versions. */
+declare function toRedlineMarkdown(original: string, revised: string): string;
+/** Count added/removed words between two versions (for a redline summary). */
+declare function redlineStats(original: string, revised: string): {
+    added: number;
+    removed: number;
+};
+/** Wrap arbitrary text/markdown as a synthetic artifact for the canvas. */
+declare function textToArtifact(title: string, content: string, opts?: {
+    mode?: ArtifactEvent['mode'];
+    isComplete?: boolean;
+    version?: number;
+    id?: string;
+}): ArtifactEvent;
+
+/**
+ * Renders agent output (markdown — headings, lists, GFM tables) in one house
+ * style so every AI result across the app looks the same. Redline marks
+ * (`<del>` / `<ins>` / `<mark>`) render as tracked changes. Token-neutral: uses
+ * shadcn semantic tokens plus the kit's `ai-accent` colour.
+ */
+declare function AiMarkdown({ children, className }: {
+    children: string;
+    className?: string;
+}): React.JSX.Element;
+
+/**
+ * Renders the live state of a single agentic task: streaming tokens, a "thinking"
+ * indicator with the running step count, errors, and a grounded/cited footer with
+ * copy-to-clipboard. Shared by every AI feature so streaming looks identical
+ * everywhere. Copy is customisable via `groundedNote` / `runningHint`.
+ */
+declare function AiAnswer({ status, text, stepCount, error, className, emptyHint, groundedNote, runningHint, testId, }: {
+    status: AiTaskStatus;
+    text: string;
+    stepCount?: number;
+    error?: string | null;
+    className?: string;
+    emptyHint?: string;
+    groundedNote?: string;
+    runningHint?: string;
+    testId?: string;
+}): React.JSX.Element | null;
+
+/**
+ * A self-contained one-click agentic workflow: title + description + a Run button
+ * that streams a grounded, cited result inline. Drop it on any page — it owns its
+ * own task state via `useAiTask`.
+ */
+declare function AiActionCard({ icon: Icon, title, description, prompt, docIds, runLabel, noDocsHint, disabled, testId, }: {
+    icon?: LucideIcon;
+    title: string;
+    description: string;
+    /** The fully-built prompt to run, or a factory (deferred until click). */
+    prompt: string | (() => string);
+    docIds: string[];
+    runLabel?: string;
+    noDocsHint?: string;
+    disabled?: boolean;
+    testId?: string;
+}): React.JSX.Element;
+
+/**
+ * The artifacts canvas — renders agent-produced documents (drafts, redlines,
+ * memos) as first-class artifacts in a paper-styled panel. Markdown mode supports
+ * redlines (`<del>` deletions / `<ins>` additions). Streams live: content grows
+ * and `is_complete` flips when finished. Token-neutral: the "paper" surface is
+ * the kit's `ai-surface` colour.
+ */
+declare function ArtifactCanvas({ artifacts, className, emptyHint, busy, busyHint, stepCount, error, }: {
+    artifacts: ArtifactEvent[];
+    className?: string;
+    emptyHint?: string;
+    /** A run failed before producing content — show it instead of the empty hint. */
+    error?: string | null;
+    /**
+     * The agent is running but hasn't produced streamable content yet. Agentic
+     * drafts spend a while planning/retrieving before the first token, so show a
+     * live working state instead of the empty hint — otherwise the canvas reads
+     * as broken during a perfectly normal multi-step run.
+     */
+    busy?: boolean;
+    busyHint?: string;
+    /** Agent steps completed so far, surfaced in the working state when > 0. */
+    stepCount?: number;
+}): React.JSX.Element;
+
+/**
+ * Semantic search across a document set — retrieval-only (no LLM), returning the
+ * top matching passages with their source document and page. Uses the SDK's
+ * `assistant.retrieve`, so every hit is a real, cited chunk of a real document.
+ */
+declare function DocSearch({ docIds, onOpenDoc, placeholder, className, }: {
+    docIds: string[];
+    onOpenDoc?: (docId: string) => void;
+    placeholder?: string;
+    className?: string;
+}): React.JSX.Element;
+
+/**
+ * Ask questions grounded in a SINGLE document (docId scoped to one file), plus a
+ * one-click "suggest tags" action. Drop it in a document viewer.
+ */
+declare function DocQaPanel({ docId, docName }: {
+    docId: string;
+    docName?: string;
+}): React.JSX.Element;
+
 /** PDF file icon (red). Promoted from the ARBI app for SDK reuse. */
 
 interface IconProps$5 {
@@ -789,4 +1032,4 @@ declare const useArbiUiStore: zustand.UseBoundStore<zustand.StoreApi<ArbiUiState
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { ArbiChat, type ArbiChatLabels, ArbiChatPanel, type ArbiChatPanelProps, type ArbiChatProps, type ArbiChatTheme, ArbiProvider, type ArbiProviderProps, type ArbiUiState, AudIcon, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, type ButtonProps, DocumentEntity, type DocumentEntityProps, type DocumentLike, DocumentTable, type DocumentTableProps, EmlIcon, EntityPill, FILE_TYPE_COLORS, FileIcon, HoverCard, HoverCardContent, HoverCardTrigger, ImgIcon, PdfIcon, ProjectEntity, type ProjectEntityProps, type ProjectRelation, TagEntity, type TagEntityProps, type TagLike, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, VidIcon, arbiQueryKeys, badgeVariants, buttonVariants, cn, useAgents, useArbi, useArbiUiStore, useAssistantQuery, useConfigs, useConversations, useDeleteAgents, useDocuments, useHealth, useMemories, useSessions, useTags, useTasks, useWorkspaces };
+export { AiActionCard, AiAnswer, AiMarkdown, type AiRunOptions, type AiTaskStatus, ArbiChat, type ArbiChatLabels, ArbiChatPanel, type ArbiChatPanelProps, type ArbiChatProps, type ArbiChatTheme, ArbiProvider, type ArbiProviderProps, type ArbiUiState, ArtifactCanvas, AudIcon, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, DocQaPanel, DocSearch, DocumentEntity, type DocumentEntityProps, type DocumentLike, DocumentTable, type DocumentTableProps, EmlIcon, EntityPill, FILE_TYPE_COLORS, FileIcon, HoverCard, HoverCardContent, HoverCardTrigger, ImgIcon, Input, PdfIcon, ProjectEntity, type ProjectEntityProps, type ProjectRelation, type SearchChunk, TagEntity, type TagEntityProps, type TagLike, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, VidIcon, arbiQueryKeys, badgeVariants, buttonVariants, cn, redlineStats, textToArtifact, toRedlineMarkdown, useAgents, useAiTask, useArbi, useArbiUiStore, useAssistantQuery, useConfigs, useConversations, useDeleteAgents, useDocuments, useHealth, useMemories, useSemanticSearch, useSessions, useTags, useTasks, useWorkspaceDocs, useWorkspaces };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-import { ArbiOptions, Arbi, SSEStreamResult, SSEStreamStartData, AgentStepEvent } from '@arbidocs/sdk/browser';
+import { ArbiOptions, Arbi, SSEStreamResult, SSEStreamStartData, AgentStepEvent, ArtifactEvent } from '@arbidocs/sdk/browser';
 export { AgentStepEvent, Arbi, ArbiError, ArbiOptions, ArtifactEvent, CreateMemoryRequest, CreateTaskRequest, MemoryResponse, MemorySearchRequest, MemorySearchResponse, MessageMetadataPayload, OutputTokensDetails, QueryOptions, ResponseCompletedEvent, ResponseContentPartAddedEvent, ResponseCreatedEvent, ResponseFailedEvent, ResponseOutputItemAddedEvent, ResponseOutputItemDoneEvent, ResponseOutputTextDeltaEvent, ResponseOutputTextDoneEvent, ResponseUsage, SSEStreamCallbacks, SSEStreamResult, SSEStreamStartData, TaskResponse, UpdateTaskRequest, UserInputRequestEvent, UserMessageEvent } from '@arbidocs/sdk/browser';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import * as _arbidocs_client from '@arbidocs/client';
@@ -9,6 +9,7 @@ import * as AvatarPrimitive from '@radix-ui/react-avatar';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import * as HoverCardPrimitive from '@radix-ui/react-hover-card';
+import { LucideIcon } from 'lucide-react';
 import * as zustand from 'zustand';
 import { ClassValue } from 'clsx';
 
@@ -320,6 +321,7 @@ declare function useAssistantQuery(): _tanstack_react_query.UseMutationResult<SS
     onToken?: (content: string) => void;
     onStreamStart?: (data: SSEStreamStartData) => void;
     onAgentStep?: (data: AgentStepEvent) => void;
+    onArtifact?: (data: ArtifactEvent) => void;
     onError?: (message: string) => void;
     onComplete?: () => void;
 }, unknown>;
@@ -473,14 +475,14 @@ declare const AvatarImage: React.ForwardRefExoticComponent<Omit<AvatarPrimitive.
 declare const AvatarFallback: React.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarFallbackProps & React.RefAttributes<HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
 
 declare const badgeVariants: (props?: ({
-    variant?: "outline" | "default" | "secondary" | "destructive" | null | undefined;
+    variant?: "outline" | "default" | "accent" | "secondary" | "destructive" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
 }
 declare function Badge({ className, variant, ...props }: BadgeProps): React.JSX.Element;
 
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "outline" | "default" | "secondary" | "destructive" | "ghost" | null | undefined;
+    variant?: "link" | "outline" | "default" | "accent" | "secondary" | "destructive" | "ghost" | null | undefined;
     size?: "default" | "icon" | "sm" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
@@ -492,6 +494,247 @@ declare const HoverCard: React.FC<HoverCardPrimitive.HoverCardProps>;
 declare const HoverCardTrigger: React.ForwardRefExoticComponent<HoverCardPrimitive.HoverCardTriggerProps & React.RefAttributes<HTMLAnchorElement>>;
 declare const HoverCardContent: React.ForwardRefExoticComponent<Omit<HoverCardPrimitive.HoverCardContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 
+declare function Card({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function CardHeader({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function CardTitle({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function CardDescription({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function CardContent({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function CardFooter({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+
+declare function Input({ className, type, ...props }: React.ComponentProps<'input'>): React.JSX.Element;
+
+/**
+ * The AI engine — domain-agnostic hooks for building an AI-native app on ARBI.
+ *
+ * `useAiTask` runs a streaming, cited agentic query (tokens, agent steps and
+ * artifacts accumulate live, with follow-up threading). `useWorkspaceDocs`
+ * resolves a workspace's document ids to ground on, and `useSemanticSearch`
+ * returns retrieval-only cited passages. These wrap the low-level SDK hooks so a
+ * vertical app never re-implements the streaming/accumulation plumbing.
+ */
+
+/**
+ * Resolve a workspace's document set and their external ids. Pass the active
+ * `workspaceId`; the kit stays agnostic about how selection is managed.
+ */
+declare function useWorkspaceDocs(workspaceId?: string): {
+    wsId: string | undefined;
+    docs: {
+        external_id: string;
+        workspace_ext_id: string;
+        file_name?: string | null | undefined;
+        status?: string | null | undefined;
+        error_message?: string | null | undefined;
+        failed_stage?: string | null | undefined;
+        n_pages?: number | null | undefined;
+        n_chunks?: number | null | undefined;
+        tokens?: number | null | undefined;
+        file_type?: string | null | undefined;
+        file_size?: number | null | undefined;
+        storage_type?: string | null | undefined;
+        storage_uri?: string | null | undefined;
+        content_hash?: string | null | undefined;
+        shared?: boolean | null | undefined;
+        re_ocred?: boolean | null | undefined;
+        config_ext_id?: string | null | undefined;
+        parent_ext_id?: string | null | undefined;
+        created_by_ext_id: string;
+        updated_by_ext_id?: string | null | undefined;
+        created_at: string;
+        updated_at: string;
+        wp_type?: string | null | undefined;
+        folder?: string | null | undefined;
+        doctags: {
+            doc_ext_id: string;
+            tag_ext_id: string;
+            note?: string | null | undefined;
+            citations?: {
+                [x: string]: {
+                    chunk_ids: string[];
+                    scores: number[];
+                    statement: string;
+                    offset_start: number;
+                    offset_end: number;
+                };
+            } | null | undefined;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+        }[];
+        doc_metadata?: {
+            doc_nature?: string | null | undefined;
+            doc_author?: string | null | undefined;
+            doc_subject?: string | null | undefined;
+            doc_date?: string | null | undefined;
+            title?: string | null | undefined;
+        } | null | undefined;
+    }[];
+    docIds: string[];
+    isLoading: boolean;
+    isError: boolean;
+    ready: boolean;
+};
+type AiTaskStatus = 'idle' | 'running' | 'done' | 'error';
+interface AiRunOptions {
+    /** Continue a prior turn (follow-up questions in the same thread). */
+    previousResponseId?: string | null;
+    model?: string;
+}
+/**
+ * Run a single streaming agentic task grounded in a set of documents.
+ *
+ * Returns live state (`text` accumulates tokens as they stream) plus a `run`
+ * that resolves to the full {@link SSEStreamResult} — including the response id
+ * needed to chain follow-ups.
+ */
+declare function useAiTask(): {
+    status: AiTaskStatus;
+    text: string;
+    stepCount: number;
+    error: string | null;
+    responseId: string | null;
+    artifacts: {
+        t?: number | null;
+        type: "arbi.artifact";
+        doc_ext_id: string;
+        title: string;
+        mode: "markdown" | "html" | "text";
+        content: string;
+        is_complete: boolean;
+        version: number;
+        message_ext_id?: string | null;
+    }[];
+    run: (question: string, docIds: string[], opts?: AiRunOptions) => Promise<SSEStreamResult | null>;
+    reset: () => void;
+    isRunning: boolean;
+    isDone: boolean;
+};
+interface SearchChunk {
+    docId?: string | null;
+    docTitle?: string | null;
+    page?: number | null;
+    score?: number | null;
+    content: string;
+}
+/** Search a set of documents and return the top matching passages. */
+declare function useSemanticSearch(docIds: string[]): {
+    query: string;
+    results: SearchChunk[];
+    status: AiTaskStatus;
+    error: string | null;
+    search: (q: string, mode?: "semantic" | "keyword" | "hybrid") => Promise<void>;
+    isRunning: boolean;
+};
+
+/** Produce inline `<del>/<ins>` redline markdown from two document versions. */
+declare function toRedlineMarkdown(original: string, revised: string): string;
+/** Count added/removed words between two versions (for a redline summary). */
+declare function redlineStats(original: string, revised: string): {
+    added: number;
+    removed: number;
+};
+/** Wrap arbitrary text/markdown as a synthetic artifact for the canvas. */
+declare function textToArtifact(title: string, content: string, opts?: {
+    mode?: ArtifactEvent['mode'];
+    isComplete?: boolean;
+    version?: number;
+    id?: string;
+}): ArtifactEvent;
+
+/**
+ * Renders agent output (markdown — headings, lists, GFM tables) in one house
+ * style so every AI result across the app looks the same. Redline marks
+ * (`<del>` / `<ins>` / `<mark>`) render as tracked changes. Token-neutral: uses
+ * shadcn semantic tokens plus the kit's `ai-accent` colour.
+ */
+declare function AiMarkdown({ children, className }: {
+    children: string;
+    className?: string;
+}): React.JSX.Element;
+
+/**
+ * Renders the live state of a single agentic task: streaming tokens, a "thinking"
+ * indicator with the running step count, errors, and a grounded/cited footer with
+ * copy-to-clipboard. Shared by every AI feature so streaming looks identical
+ * everywhere. Copy is customisable via `groundedNote` / `runningHint`.
+ */
+declare function AiAnswer({ status, text, stepCount, error, className, emptyHint, groundedNote, runningHint, testId, }: {
+    status: AiTaskStatus;
+    text: string;
+    stepCount?: number;
+    error?: string | null;
+    className?: string;
+    emptyHint?: string;
+    groundedNote?: string;
+    runningHint?: string;
+    testId?: string;
+}): React.JSX.Element | null;
+
+/**
+ * A self-contained one-click agentic workflow: title + description + a Run button
+ * that streams a grounded, cited result inline. Drop it on any page — it owns its
+ * own task state via `useAiTask`.
+ */
+declare function AiActionCard({ icon: Icon, title, description, prompt, docIds, runLabel, noDocsHint, disabled, testId, }: {
+    icon?: LucideIcon;
+    title: string;
+    description: string;
+    /** The fully-built prompt to run, or a factory (deferred until click). */
+    prompt: string | (() => string);
+    docIds: string[];
+    runLabel?: string;
+    noDocsHint?: string;
+    disabled?: boolean;
+    testId?: string;
+}): React.JSX.Element;
+
+/**
+ * The artifacts canvas — renders agent-produced documents (drafts, redlines,
+ * memos) as first-class artifacts in a paper-styled panel. Markdown mode supports
+ * redlines (`<del>` deletions / `<ins>` additions). Streams live: content grows
+ * and `is_complete` flips when finished. Token-neutral: the "paper" surface is
+ * the kit's `ai-surface` colour.
+ */
+declare function ArtifactCanvas({ artifacts, className, emptyHint, busy, busyHint, stepCount, error, }: {
+    artifacts: ArtifactEvent[];
+    className?: string;
+    emptyHint?: string;
+    /** A run failed before producing content — show it instead of the empty hint. */
+    error?: string | null;
+    /**
+     * The agent is running but hasn't produced streamable content yet. Agentic
+     * drafts spend a while planning/retrieving before the first token, so show a
+     * live working state instead of the empty hint — otherwise the canvas reads
+     * as broken during a perfectly normal multi-step run.
+     */
+    busy?: boolean;
+    busyHint?: string;
+    /** Agent steps completed so far, surfaced in the working state when > 0. */
+    stepCount?: number;
+}): React.JSX.Element;
+
+/**
+ * Semantic search across a document set — retrieval-only (no LLM), returning the
+ * top matching passages with their source document and page. Uses the SDK's
+ * `assistant.retrieve`, so every hit is a real, cited chunk of a real document.
+ */
+declare function DocSearch({ docIds, onOpenDoc, placeholder, className, }: {
+    docIds: string[];
+    onOpenDoc?: (docId: string) => void;
+    placeholder?: string;
+    className?: string;
+}): React.JSX.Element;
+
+/**
+ * Ask questions grounded in a SINGLE document (docId scoped to one file), plus a
+ * one-click "suggest tags" action. Drop it in a document viewer.
+ */
+declare function DocQaPanel({ docId, docName }: {
+    docId: string;
+    docName?: string;
+}): React.JSX.Element;
+
 /** PDF file icon (red). Promoted from the ARBI app for SDK reuse. */
 
 interface IconProps$5 {
@@ -789,4 +1032,4 @@ declare const useArbiUiStore: zustand.UseBoundStore<zustand.StoreApi<ArbiUiState
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { ArbiChat, type ArbiChatLabels, ArbiChatPanel, type ArbiChatPanelProps, type ArbiChatProps, type ArbiChatTheme, ArbiProvider, type ArbiProviderProps, type ArbiUiState, AudIcon, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, type ButtonProps, DocumentEntity, type DocumentEntityProps, type DocumentLike, DocumentTable, type DocumentTableProps, EmlIcon, EntityPill, FILE_TYPE_COLORS, FileIcon, HoverCard, HoverCardContent, HoverCardTrigger, ImgIcon, PdfIcon, ProjectEntity, type ProjectEntityProps, type ProjectRelation, TagEntity, type TagEntityProps, type TagLike, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, VidIcon, arbiQueryKeys, badgeVariants, buttonVariants, cn, useAgents, useArbi, useArbiUiStore, useAssistantQuery, useConfigs, useConversations, useDeleteAgents, useDocuments, useHealth, useMemories, useSessions, useTags, useTasks, useWorkspaces };
+export { AiActionCard, AiAnswer, AiMarkdown, type AiRunOptions, type AiTaskStatus, ArbiChat, type ArbiChatLabels, ArbiChatPanel, type ArbiChatPanelProps, type ArbiChatProps, type ArbiChatTheme, ArbiProvider, type ArbiProviderProps, type ArbiUiState, ArtifactCanvas, AudIcon, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, DocQaPanel, DocSearch, DocumentEntity, type DocumentEntityProps, type DocumentLike, DocumentTable, type DocumentTableProps, EmlIcon, EntityPill, FILE_TYPE_COLORS, FileIcon, HoverCard, HoverCardContent, HoverCardTrigger, ImgIcon, Input, PdfIcon, ProjectEntity, type ProjectEntityProps, type ProjectRelation, type SearchChunk, TagEntity, type TagEntityProps, type TagLike, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, VidIcon, arbiQueryKeys, badgeVariants, buttonVariants, cn, redlineStats, textToArtifact, toRedlineMarkdown, useAgents, useAiTask, useArbi, useArbiUiStore, useAssistantQuery, useConfigs, useConversations, useDeleteAgents, useDocuments, useHealth, useMemories, useSemanticSearch, useSessions, useTags, useTasks, useWorkspaceDocs, useWorkspaces };