@arbidocs/blocks 0.4.5 → 0.4.6

package/dist/agents/index.js

@@ -1,15 +1,16 @@
 "use client";
-export { ACTION_LABELS, AgentAvatarField, AgentBar, AgentBarIconButton, AgentBarMenu, AgentBarNotes, AgentBarProbeAnswer, AgentBarQueuedNote, AgentBarStatus, AgentCard, AgentCreateView, AgentCreatedView, AgentCreator, AgentEditView, AgentGallery, AgentMainView, AgentSelect, AgentTypeSelector, CapabilityGrid, CapabilityTile, ConfigField, ConfigForm, ConsentActions, ConsentBulletList, ConsentCard, ConsentFootnote, ConsentHeader, ConsentMessage, ConsentNotice, ConsentPage, ConsentPermissionList, ConsentSection, ConsentStrong, ConsentText, CopyableUrl, DEFAULT_AGENT_AVATAR_FIELD_LABELS, DEFAULT_AGENT_BAR_LABELS, DEFAULT_AGENT_CARD_LABELS, DEFAULT_AGENT_CREATOR_LABELS, DEFAULT_AGENT_GALLERY_LABELS, DEFAULT_AGENT_SELECT_LABELS, DEFAULT_AGENT_STEPS_LABELS, DEFAULT_AGENT_TYPE_SELECTOR_LABELS, DEFAULT_AUTHORIZE_AGENT_LABELS, DEFAULT_CONFIG_FIELD_LABELS, DEFAULT_CONFIG_FORM_LABELS, DEFAULT_CONSENT_ACTIONS_LABELS, DEFAULT_COPYABLE_URL_LABELS, DEFAULT_LIVE_RUNS_BANNER_LABELS, DEFAULT_RECURRENCE, DEFAULT_RECURRENCE_BUILDER_LABELS, DEFAULT_SCHEMA_FORM_LABELS, DEFAULT_SKILL_CARD_LABELS, DEFAULT_SKILL_EDIT_FORM_LABELS, DEFAULT_SKILL_GENERATE_FORM_LABELS, DEFAULT_SKILL_GLOBAL_BADGE_LABELS, DEFAULT_SKILL_ROW_LABELS, DEFAULT_SKILL_VIEW_TOGGLE_LABELS, DEFAULT_SUBAGENT_ROSTER_LABELS, DEFAULT_TASKS_CHROME_LABELS, DEFAULT_TASK_COLUMN_LABELS, DEFAULT_TASK_COMPOSER_LABELS, DEFAULT_TASK_PLAN_LABELS, DEFAULT_TASK_ROW_ACTIONS_LABELS, DEFAULT_TASK_RUNS_DIALOG_LABELS, DEFAULT_TUPLE_ARRAY_FIELD_LABELS, DEFAULT_UPLOAD_TASK_ITEM_LABELS, DEFAULT_UPLOAD_TASK_LIST_LABELS, DEFAULT_WORKFLOW_CONFIG_DIALOG_LABELS, EMPTY_WORKFLOW_SCOPE, GoalCriteria, LiveRunsBanner, NewTaskEmptyAction, RecurrenceBuilder, SKILL_PROMPT_FALLBACK_PLACEHOLDER, SKILL_PROMPT_LABEL, STATUS_LABELS, SchemaForm, SkillActionButton, SkillCard, SkillDetail, SkillDetailSection, SkillEditForm, SkillFilterChips, SkillGenerateForm, SkillGlobalBadge, SkillRow, SkillTile, SkillTypeBadge, SkillViewToggle, StepDetail, StepNarration, StepOutcome, StepParams, StepRow, StepSummary, StepTrace, StepTraceSummary, SubAgentLane, SubStepGroup, SubagentRoster, TRIGGER_LABELS, TaskComposer, TaskPlan, TaskRowActions, TaskRunsDialog, TasksBulkBar, TasksToolbar, TupleArrayField, UploadTaskItem, UploadTaskList, WEEKDAYS, WorkflowConfigDialog, WorkflowLauncher, agentConfigSectionToValues, agentCreatorToConfigSection, authModeFor, buildLaunch, buildRRule, composePersona, composeWorkflowPrompt, createTaskColumns, defaultInputs, defaultTaskComposerValues, deriveAgentName, describeRRule, formatElapsed, goalProgress, humanizeSection, inferType, inputsFromContext, isAgenticWorkflow, isEmptyWorkflowScope, isOutOfBounds, isValidAgentName, isWorkflowScope, isoToLocalInput, localInputToIso, nextCriterionId, parseRRule, prettifyKey, promptFieldName, skillToWorkflow, statusBadgeVariant, stripPersonaPreamble, summarizeAgent, summarizeCapabilities, taskComposerToCreateRequest, taskComposerToUpdateRequest, taskNeedsAccess, taskToComposerValues, validateInputs, workflowAccepts, workflowFromFrontmatter, workflowTaskFields, workflowsAccepting, workflowsForHost } from '../chunk-5XTZFH65.js';
+export { ACTION_LABELS, AgentAvatarField, AgentBar, AgentBarIconButton, AgentBarMenu, AgentBarNotes, AgentBarProbeAnswer, AgentBarQueuedNote, AgentBarStatus, AgentCard, AgentCreateView, AgentCreatedView, AgentCreator, AgentEditView, AgentGallery, AgentMainView, AgentSelect, AgentTypeSelector, CapabilityGrid, CapabilityTile, ConfigField, ConfigForm, ConsentActions, ConsentBulletList, ConsentCard, ConsentFootnote, ConsentHeader, ConsentMessage, ConsentNotice, ConsentPage, ConsentPermissionList, ConsentSection, ConsentStrong, ConsentText, CopyableUrl, DEFAULT_AGENT_AVATAR_FIELD_LABELS, DEFAULT_AGENT_BAR_LABELS, DEFAULT_AGENT_CARD_LABELS, DEFAULT_AGENT_CREATOR_LABELS, DEFAULT_AGENT_GALLERY_LABELS, DEFAULT_AGENT_SELECT_LABELS, DEFAULT_AGENT_STEPS_LABELS, DEFAULT_AGENT_TYPE_SELECTOR_LABELS, DEFAULT_AUTHORIZE_AGENT_LABELS, DEFAULT_CONFIG_FIELD_LABELS, DEFAULT_CONFIG_FORM_LABELS, DEFAULT_CONSENT_ACTIONS_LABELS, DEFAULT_COPYABLE_URL_LABELS, DEFAULT_LIVE_RUNS_BANNER_LABELS, DEFAULT_RECURRENCE, DEFAULT_RECURRENCE_BUILDER_LABELS, DEFAULT_SCHEMA_FORM_LABELS, DEFAULT_SKILL_CARD_LABELS, DEFAULT_SKILL_EDIT_FORM_LABELS, DEFAULT_SKILL_GENERATE_FORM_LABELS, DEFAULT_SKILL_GLOBAL_BADGE_LABELS, DEFAULT_SKILL_ROW_LABELS, DEFAULT_SKILL_VIEW_TOGGLE_LABELS, DEFAULT_SUBAGENT_ROSTER_LABELS, DEFAULT_TASKS_CHROME_LABELS, DEFAULT_TASK_COLUMN_LABELS, DEFAULT_TASK_COMPOSER_LABELS, DEFAULT_TASK_PLAN_LABELS, DEFAULT_TASK_ROW_ACTIONS_LABELS, DEFAULT_TASK_RUNS_DIALOG_LABELS, DEFAULT_TUPLE_ARRAY_FIELD_LABELS, DEFAULT_UPLOAD_TASK_ITEM_LABELS, DEFAULT_UPLOAD_TASK_LIST_LABELS, DEFAULT_WORKFLOW_CONFIG_DIALOG_LABELS, EMPTY_WORKFLOW_SCOPE, GoalCriteria, LiveRunsBanner, NewTaskEmptyAction, RecurrenceBuilder, SKILL_PROMPT_FALLBACK_PLACEHOLDER, SKILL_PROMPT_LABEL, STATUS_LABELS, SchemaForm, SkillActionButton, SkillCard, SkillDetail, SkillDetailSection, SkillEditForm, SkillFilterChips, SkillGenerateForm, SkillGlobalBadge, SkillRow, SkillTile, SkillTypeBadge, SkillViewToggle, StepDetail, StepNarration, StepOutcome, StepParams, StepRow, StepSummary, StepTrace, StepTraceSummary, SubAgentLane, SubStepGroup, SubagentRoster, TRIGGER_LABELS, TaskComposer, TaskPlan, TaskRowActions, TaskRunsDialog, TasksBulkBar, TasksToolbar, TupleArrayField, UploadTaskItem, UploadTaskList, WEEKDAYS, WorkflowConfigDialog, WorkflowLauncher, agentConfigSectionToValues, agentCreatorToConfigSection, authModeFor, buildLaunch, buildRRule, composePersona, composeWorkflowPrompt, createTaskColumns, defaultInputs, defaultTaskComposerValues, deriveAgentName, describeRRule, formatElapsed, goalProgress, humanizeSection, inferType, inputsFromContext, isAgenticWorkflow, isEmptyWorkflowScope, isOutOfBounds, isValidAgentName, isWorkflowScope, isoToLocalInput, localInputToIso, nextCriterionId, parseRRule, prettifyKey, promptFieldName, skillToWorkflow, statusBadgeVariant, stripPersonaPreamble, summarizeAgent, summarizeCapabilities, taskComposerToCreateRequest, taskComposerToUpdateRequest, taskNeedsAccess, taskToComposerValues, validateInputs, workflowAccepts, workflowFromFrontmatter, workflowTaskFields, workflowsAccepting, workflowsForHost } from '../chunk-CVFBSUXL.js';
 import '../chunk-NUNKSZKU.js';
-import '../chunk-NPKGUQU5.js';
+import '../chunk-NJL4LIXX.js';
 import '../chunk-CQCC7LE7.js';
 import '../chunk-UBNVIIBT.js';
-import '../chunk-NPLYHR2E.js';
 import '../chunk-P6GHJSLR.js';
 import '../chunk-S7PSMMRG.js';
-import '../chunk-TX2ZICS7.js';
 import '../chunk-76JDDMSP.js';
-import '../chunk-7F6CBP3Z.js';
+import '../chunk-CPMNAJLF.js';
+import '../chunk-NPLYHR2E.js';
 import '../chunk-OXF2IFXG.js';
+import '../chunk-TJMKFY5P.js';
+import '../chunk-7F6CBP3Z.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/chat/ChatMessageContent.d.ts

@@ -0,0 +1,16 @@
+import { type ChatCitationTarget, type ChatPageLabels, type ChatPageMessage } from './chat-page-types';
+export interface ChatMessageContentProps {
+    message: ChatPageMessage;
+    labels?: Partial<ChatPageLabels>;
+    /** Opens the cited document in the host's viewer. */
+    onOpenCitation?: (target: ChatCitationTarget) => void;
+    className?: string;
+}
+/**
+ * The one renderer of an assistant answer, used by `ChatPage` and `AssistantDock` (the dock is the
+ * same page). Markdown (lists, tables, code) where each `[statement](#cite-N)` shows the statement
+ * as plain text followed by a quiet numbered mark; the mark opens the source popover when the
+ * message carries `citations`. Literal `(*Source: ...*)` notes are tidied by the markdown
+ * normaliser; a stopped answer says so.
+ */
+export declare function ChatMessageContent({ message, labels, onOpenCitation, className, }: ChatMessageContentProps): import("react").JSX.Element;

package/dist/chat/ChatPage.d.ts

@@ -1,16 +1,19 @@
 import { type ChatPageProps } from './chat-page-types';
 /**
  * A complete assistant chat, composed from the same parts as the dock: conversation list with
- * auto-titles, message list, composer with the document chip and upload, empty state, error and
- * retry. Drive it with `useArbiChat()` from `@arbidocs/react` (or fill `ChatPageController`).
+ * titles (stored conversations included), message list with source popovers on citations,
+ * composer with the document chip, upload and stop, empty state, error and retry. Drive it with
+ * `useArbiChat()` from `@arbidocs/react` (or fill `ChatPageController`).
  *
- * It sizes to its container, not the viewport (container queries on the root), so it holds up in
- * a card, beside an open dock or on a phone: the conversation list is a column from 48rem and a
- * select below; the `aside` slot (workflow launcher) is a column from 72rem and a collapsible
- * panel below. Give it a height (`h-full` of a sized parent, or a `className`). Colours come from
- * the tokens only; the user bubble has two optional ones (see `USER_BUBBLE`).
+ * It lays itself out by its own width, not the viewport's, so it holds up in a card, beside an
+ * open dock or on a phone: the conversation list is a column from 48rem and a select below; the
+ * `aside` slot (workflow launcher) is a column from `asideBreakpoint` (60rem) and below that one
+ * button-toggled panel over the transcript, so it never pushes the conversation down. Every part
+ * renders once. Give it a height (`h-full` of a sized parent, a `className`) or `fillHeight`
+ * under a page header. Colours come from the tokens only; the user bubble has two optional ones
+ * (see `USER_BUBBLE`).
  *
  * With `surface="page"` it claims the page-chat slot, so `useChatSurface()` tells the host's dock
  * to yield: one chat on screen, never two.
  */
-export declare function ChatPage({ chat, surface, header, headerActions, aside, prompts, emptyTitle, emptyDescription, identity, renderContent, accept, labels, className, testIds, }: ChatPageProps): import("react").JSX.Element;
+export declare function ChatPage({ chat, surface, header, headerActions, aside, prompts, emptyTitle, emptyDescription, identity, renderContent, onOpenCitation, asideBreakpoint, fillHeight, minHeight, compactHeader, accept, labels, className, testIds, }: ChatPageProps): import("react").JSX.Element;

package/dist/chat/ChatThreads.d.ts

@@ -6,6 +6,8 @@ interface ThreadProps {
     onSelect: (id: string) => void;
     onNew: () => void;
     onDelete?: (id: string) => void;
+    /** The stored conversations are still loading. */
+    isLoading?: boolean;
     testIds?: Partial<{
         list: string;
         row: string;
@@ -19,7 +21,7 @@ interface ThreadProps {
  * delete action. The active row is `aria-current`. Rows are real buttons, so keyboard and touch
  * work; delete is always visible on touch and appears on hover/focus elsewhere.
  */
-export declare function ChatThreadList({ threads, activeId, labels, onSelect, onNew, onDelete, testIds, }: ThreadProps): import("react").JSX.Element;
+export declare function ChatThreadList({ threads, activeId, labels, onSelect, onNew, onDelete, isLoading, testIds, }: ThreadProps): import("react").JSX.Element;
 /**
  * The conversation list as one native select (narrow containers, the dock). Native on purpose:
  * the platform picker on a phone, a label for screen readers, text at least 16px on touch.

package/dist/chat/CitationMark.d.ts

@@ -0,0 +1,18 @@
+import type { ChatCitationTarget, ChatPageCitation, ChatPageLabels } from './chat-page-types';
+export type CitationLabels = Pick<ChatPageLabels, 'citation' | 'citationHeading' | 'citationNoSource' | 'openDocument' | 'page'>;
+export interface CitationMarkProps {
+    num: string;
+    /** The source behind the mark. Without it the mark is a quiet, non-interactive number. */
+    citation?: ChatPageCitation;
+    labels: CitationLabels;
+    /** Opens the cited document in the host's viewer; without it the popover has no open action. */
+    onOpen?: (target: ChatCitationTarget) => void;
+    className?: string;
+}
+/**
+ * The mark after a cited statement: a small superscript number, not an underline over the whole
+ * sentence. With citation data it is a button that opens a popover with the source document, the
+ * page and the cited passage(s), and (when the host passes `onOpen`) an "Open document" action;
+ * without data (still streaming, an old message with no stored sources) it is the number alone.
+ */
+export declare function CitationMark({ num, citation, labels, onOpen, className }: CitationMarkProps): import("react").JSX.Element;

package/dist/chat/chat-page-types.d.ts

@@ -4,6 +4,33 @@ import type { ReactNode } from 'react';
  * so `<ChatPage chat={useArbiChat(...)} />` works without an adapter; any other source (a demo,
  * another backend) can fill it in. Plain data and callbacks: no SDK, store or router.
  */
+/** One passage of a source document behind a citation. */
+export interface ChatPagePassage {
+    id: string;
+    /** The source document's id, when known (what an "open document" action needs). */
+    documentId: string | null;
+    documentTitle: string;
+    page: number | null;
+    text: string;
+}
+/** The source behind `[statement](#cite-N)` marks of an answer. */
+export interface ChatPageCitation {
+    /** The number in `(#cite-N)`. */
+    num: string;
+    statement: string;
+    documentTitle: string;
+    page: number | null;
+    passages: ReadonlyArray<ChatPagePassage>;
+}
+/** What the host gets when the reader opens a cited document. */
+export interface ChatCitationTarget {
+    documentId: string | null;
+    documentTitle: string;
+    page: number | null;
+    /** The cited passage (the one opened from, or the first). */
+    passage: ChatPagePassage | null;
+    citation: ChatPageCitation;
+}
 export interface ChatPageMessage {
     id: string;
     role: 'user' | 'assistant';
@@ -14,6 +41,10 @@ export interface ChatPageMessage {
     error?: string;
     /** Agent steps the answer took so far. */
     stepCount?: number;
+    /** Sources of the `[..](#cite-N)` marks in `content`. Without them the marks are quiet numbers. */
+    citations?: ReadonlyArray<ChatPageCitation>;
+    /** The reader stopped the answer; `content` is what had streamed. */
+    stopped?: boolean;
 }
 export interface ChatPageThread {
     id: string;
@@ -32,12 +63,20 @@ export interface ChatPageController {
     isRunning: boolean;
     /** The last turn failed. */
     error: string | null;
+    /** A stored conversation's messages are loading. */
+    isLoadingThread?: boolean;
+    /** The conversation list is loading. */
+    isLoadingThreads?: boolean;
+    /** Loading or deleting a stored conversation failed. */
+    historyError?: string | null;
     documents: ReadonlyArray<ChatPageDocument>;
     isLoadingDocuments: boolean;
     isUploading: boolean;
     uploadError: string | null;
     send: (text: string) => void | Promise<void>;
     retry: () => void | Promise<void>;
+    /** Stops the running answer. Omit when the source cannot be aborted: no stop button then. */
+    stop?: () => void;
     selectThread: (id: string) => void;
     newThread: () => void;
     /** Omit to hide the delete action. */
@@ -75,6 +114,18 @@ export interface ChatPageLabels {
     emptyUploadDescription: string;
     workflows: string;
     loadingDocuments: string;
+    stop: string;
+    stopped: string;
+    loadingConversation: string;
+    historyFailedTitle: string;
+    /** Accessible name of a citation mark. */
+    citation: (num: string, source: string) => string;
+    /** Heading of the citation popover. */
+    citationHeading: (num: string) => string;
+    citationNoSource: string;
+    openDocument: string;
+    page: (page: number) => string;
+    morePassages: (count: number) => string;
 }
 export declare const DEFAULT_CHAT_PAGE_LABELS: ChatPageLabels;
 export interface ChatPageProps {
@@ -101,8 +152,31 @@ export interface ChatPageProps {
     emptyDescription?: string;
     /** Identity chip on the answer's byline (default: the assistant label). */
     identity?: ReactNode;
-    /** Renders an answer. Default: the shared markdown renderer (lists, tables, cited words). */
+    /**
+     * Renders an answer. Default: `ChatMessageContent` (markdown: lists, tables, a quiet numbered
+     * mark with a source popover for each citation).
+     */
     renderContent?: (message: ChatPageMessage) => ReactNode;
+    /**
+     * Opens the cited document (and page) in the host's viewer. Without it the citation popover
+     * shows the source and passage and offers no open action.
+     */
+    onOpenCitation?: (target: ChatCitationTarget) => void;
+    /**
+     * Container width, in rem, from which `aside` is a column beside the chat; narrower, it is a
+     * button-toggled panel over the transcript. Default 60.
+     */
+    asideBreakpoint?: number;
+    /**
+     * Fill the height left in the nearest scrolling ancestor below the chat's own top (the page
+     * header above it, the shell bars around it), measured in dynamic viewport units so a phone's
+     * collapsing URL bar cannot cut it. Use it for a chat card placed under a page header.
+     */
+    fillHeight?: boolean;
+    /** Smallest height `fillHeight` gives, in px. Default 360. */
+    minHeight?: number;
+    /** Drop the heading from the header bar (the host's page header already names the chat). */
+    compactHeader?: boolean;
     /** Accepted upload types for the file picker. */
     accept?: string;
     labels?: Partial<ChatPageLabels>;