@arbidocs/blocks 0.4.122 → 0.4.124

package/dist/artifacts/index.cjs

@@ -1,7 +1,7 @@
 "use client";
 'use strict';
 
-var chunkSVJQWLOF_cjs = require('../chunk-SVJQWLOF.cjs');
+var chunkW4GXDARU_cjs = require('../chunk-W4GXDARU.cjs');
 var chunkQVBZESYQ_cjs = require('../chunk-QVBZESYQ.cjs');
 require('../chunk-MHVNT4J3.cjs');
 require('../chunk-DES3K4SD.cjs');
@@ -10,83 +10,83 @@ require('../chunk-DES3K4SD.cjs');
 
 Object.defineProperty(exports, "ArtifactCompareBar", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.ArtifactCompareBar; }
+  get: function () { return chunkW4GXDARU_cjs.ArtifactCompareBar; }
 });
 Object.defineProperty(exports, "ArtifactEditor", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.ArtifactEditor; }
+  get: function () { return chunkW4GXDARU_cjs.ArtifactEditor; }
 });
 Object.defineProperty(exports, "ArtifactEditorBody", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.ArtifactEditorBody; }
+  get: function () { return chunkW4GXDARU_cjs.ArtifactEditorBody; }
 });
 Object.defineProperty(exports, "ArtifactRedlineView", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.ArtifactRedlineView; }
+  get: function () { return chunkW4GXDARU_cjs.ArtifactRedlineView; }
 });
 Object.defineProperty(exports, "ArtifactToolbar", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.ArtifactToolbar; }
+  get: function () { return chunkW4GXDARU_cjs.ArtifactToolbar; }
 });
 Object.defineProperty(exports, "ArtifactVersionBar", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.ArtifactVersionBar; }
+  get: function () { return chunkW4GXDARU_cjs.ArtifactVersionBar; }
 });
 Object.defineProperty(exports, "DEFAULT_ARTIFACT_COMPARE_BAR_LABELS", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.DEFAULT_ARTIFACT_COMPARE_BAR_LABELS; }
+  get: function () { return chunkW4GXDARU_cjs.DEFAULT_ARTIFACT_COMPARE_BAR_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_ARTIFACT_EDITOR_STATUS_LABELS", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.DEFAULT_ARTIFACT_EDITOR_STATUS_LABELS; }
+  get: function () { return chunkW4GXDARU_cjs.DEFAULT_ARTIFACT_EDITOR_STATUS_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_ARTIFACT_TOOLBAR_LABELS", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.DEFAULT_ARTIFACT_TOOLBAR_LABELS; }
+  get: function () { return chunkW4GXDARU_cjs.DEFAULT_ARTIFACT_TOOLBAR_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_ARTIFACT_VERSION_BAR_LABELS", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.DEFAULT_ARTIFACT_VERSION_BAR_LABELS; }
+  get: function () { return chunkW4GXDARU_cjs.DEFAULT_ARTIFACT_VERSION_BAR_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_REDLINE_LABELS", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.DEFAULT_REDLINE_LABELS; }
+  get: function () { return chunkW4GXDARU_cjs.DEFAULT_REDLINE_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_VERSION_TIMELINE_LABELS", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.DEFAULT_VERSION_TIMELINE_LABELS; }
+  get: function () { return chunkW4GXDARU_cjs.DEFAULT_VERSION_TIMELINE_LABELS; }
 });
 Object.defineProperty(exports, "RedlineComputing", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.RedlineComputing; }
+  get: function () { return chunkW4GXDARU_cjs.RedlineComputing; }
 });
 Object.defineProperty(exports, "RedlineDocument", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.RedlineDocument; }
+  get: function () { return chunkW4GXDARU_cjs.RedlineDocument; }
 });
 Object.defineProperty(exports, "RedlineFrame", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.RedlineFrame; }
+  get: function () { return chunkW4GXDARU_cjs.RedlineFrame; }
 });
 Object.defineProperty(exports, "RedlineHeader", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.RedlineHeader; }
+  get: function () { return chunkW4GXDARU_cjs.RedlineHeader; }
 });
 Object.defineProperty(exports, "RedlineMark", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.RedlineMark; }
+  get: function () { return chunkW4GXDARU_cjs.RedlineMark; }
 });
 Object.defineProperty(exports, "RedlineRevertGutter", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.RedlineRevertGutter; }
+  get: function () { return chunkW4GXDARU_cjs.RedlineRevertGutter; }
 });
 Object.defineProperty(exports, "RedlineStatus", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.RedlineStatus; }
+  get: function () { return chunkW4GXDARU_cjs.RedlineStatus; }
 });
 Object.defineProperty(exports, "VersionTimeline", {
   enumerable: true,
-  get: function () { return chunkSVJQWLOF_cjs.VersionTimeline; }
+  get: function () { return chunkW4GXDARU_cjs.VersionTimeline; }
 });
 Object.defineProperty(exports, "DEFAULT_STREAMED_ARTIFACT_FRAME_LABELS", {
   enumerable: true,

package/dist/artifacts/index.js

@@ -1,5 +1,5 @@
 "use client";
-export { ArtifactCompareBar, ArtifactEditor, ArtifactEditorBody, ArtifactRedlineView, ArtifactToolbar, ArtifactVersionBar, DEFAULT_ARTIFACT_COMPARE_BAR_LABELS, DEFAULT_ARTIFACT_EDITOR_STATUS_LABELS, DEFAULT_ARTIFACT_TOOLBAR_LABELS, DEFAULT_ARTIFACT_VERSION_BAR_LABELS, DEFAULT_REDLINE_LABELS, DEFAULT_VERSION_TIMELINE_LABELS, RedlineComputing, RedlineDocument, RedlineFrame, RedlineHeader, RedlineMark, RedlineRevertGutter, RedlineStatus, VersionTimeline } from '../chunk-65HZ36MY.js';
+export { ArtifactCompareBar, ArtifactEditor, ArtifactEditorBody, ArtifactRedlineView, ArtifactToolbar, ArtifactVersionBar, DEFAULT_ARTIFACT_COMPARE_BAR_LABELS, DEFAULT_ARTIFACT_EDITOR_STATUS_LABELS, DEFAULT_ARTIFACT_TOOLBAR_LABELS, DEFAULT_ARTIFACT_VERSION_BAR_LABELS, DEFAULT_REDLINE_LABELS, DEFAULT_VERSION_TIMELINE_LABELS, RedlineComputing, RedlineDocument, RedlineFrame, RedlineHeader, RedlineMark, RedlineRevertGutter, RedlineStatus, VersionTimeline } from '../chunk-OTDGTBAS.js';
 export { DEFAULT_STREAMED_ARTIFACT_FRAME_LABELS, StreamedArtifactFrame } from '../chunk-LOJVUGBJ.js';
 import '../chunk-7F6CBP3Z.js';
 import '../chunk-VUNV25KB.js';

package/dist/chat/ChatPage.d.ts

@@ -16,4 +16,4 @@ import { type ChatPageProps } from './chat-page-types';
  * 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, documentsRequired, emptyTitle, emptyDescription, identity, renderContent, onOpenCitation, workflowStepTitle, singleThread, targetMessageId, asideBreakpoint, fillHeight, minHeight, compactHeader, accept, labels, className, testIds, }: ChatPageProps): import("react").JSX.Element;
+export declare function ChatPage({ chat, surface, header, headerActions, aside, prompts, documentsRequired, emptyTitle, emptyDescription, identity, renderContent, onOpenCitation, workflowStepOf, singleThread, targetMessageId, asideBreakpoint, fillHeight, minHeight, compactHeader, accept, labels, className, testIds, }: ChatPageProps): import("react").JSX.Element;

package/dist/chat/DraftingDocChip.d.ts

@@ -0,0 +1,22 @@
+/** Every fixed string of the chip. Pass a partial `labels` to translate or reword. */
+export interface DraftingDocChipLabels {
+    /** `{title}` is the open document's name. */
+    drafting: string;
+    /** What it means, on hover. */
+    hint: string;
+}
+export declare const DEFAULT_DRAFTING_DOC_CHIP_LABELS: DraftingDocChipLabels;
+export interface DraftingDocChipProps {
+    /** The document open beside the chat (the one the assistant drafts in). */
+    title: string;
+    className?: string;
+    labels?: Partial<DraftingDocChipLabels>;
+    testId?: string;
+}
+/**
+ * Drafting mode, said in the composer: the document open beside the chat is the one the assistant
+ * works in — it reads it on demand and edits it granularly as tracked changes, never as a whole
+ * document resent each turn (that is what a pin is for). Not removable: closing the document ends
+ * it.
+ */
+export declare function DraftingDocChip({ title, className, labels, testId, }: DraftingDocChipProps): import("react").JSX.Element;

package/dist/chat/WorkflowStepChip.d.ts

@@ -1,13 +1,20 @@
 /**
- * A message the server sent to start a workflow's step, shown as that step: a compact chip
- * ("Workflow step · Draft the letter") that expands to the full instruction. Any chat that knows a
- * message's step (its `tools.workflow_step`) renders this instead of the raw instruction.
+ * A message the server sent to start a workflow's step, shown as that step: centred in the chat
+ * like the thread's other events, as the same chip the thread's top bar draws (`StepChip`: the
+ * step's kind in its colour and icon, its phase), between two lines in that colour. It expands to
+ * the full instruction. Any chat that knows a message's step (its `tools.workflow_step`) renders
+ * this instead of the raw instruction.
  */
+import { type WorkflowStepKind } from '../agents/workflows/stepKinds';
+import type { WorkflowStepPhase } from '../agents/workflows/run';
 export interface WorkflowStepChipLabels {
-    /** `{title}` is the step's title (its id when the title is not known). */
+    /** The chip's text; `{title}` is the step's title (its id when the title is not known). */
     chip: string;
+    /** Its accessible name; `{kind}` and `{title}` are replaced. */
+    name: string;
     show: string;
     hide: string;
+    kinds: Record<WorkflowStepKind, string>;
 }
 export declare const DEFAULT_WORKFLOW_STEP_CHIP_LABELS: WorkflowStepChipLabels;
 export interface WorkflowStepChipProps {
@@ -15,10 +22,21 @@ export interface WorkflowStepChipProps {
     step: string;
     /** The step's title, when the host knows it (from the run's plan). */
     title?: string;
+    /** The step's kind (`stepKindOf`), for its colour and icon; unknown = an AI step. */
+    kind?: WorkflowStepKind;
+    /** Where the step is now (`stepPhase`); unknown = started. */
+    phase?: WorkflowStepPhase;
+    /** The step's document (its latest version): a button beside the chip opens it. */
+    document?: {
+        name: string;
+        onOpen: () => void;
+    };
     /** The instruction the step sent. */
     content: string;
+    /** The message it stands for: the chat scrolls to it by this id. */
+    messageId?: string;
     labels?: Partial<WorkflowStepChipLabels>;
     className?: string;
     testId?: string;
 }
-export declare function WorkflowStepChip({ step, title, content, labels, className, testId, }: WorkflowStepChipProps): import("react").JSX.Element;
+export declare function WorkflowStepChip({ step, title, kind, phase, document, content, messageId, labels, className, testId, }: WorkflowStepChipProps): import("react").JSX.Element;

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

@@ -1,4 +1,6 @@
 import type { ReactNode } from 'react';
+import type { WorkflowStepKind } from '../agents/workflows/stepKinds';
+import type { WorkflowStepPhase } from '../agents/workflows/run';
 import type { MentionCandidate, MessageMentionRef } from './mentions';
 /**
  * The view-model of a chat page. It is the shape `useArbiChat()` from `@arbidocs/react` returns,
@@ -177,8 +179,11 @@ export interface ChatPageProps {
      * shows the source and passage and offers no open action.
      */
     onOpenCitation?: (target: ChatCitationTarget) => void;
-    /** A workflow step's title by id: a message that started a step shows it (else the id). */
-    workflowStepTitle?: (stepId: string) => string | undefined;
+    /**
+     * A workflow step by id — its title, kind and phase: a message that started a step shows as that
+     * step's chip, as the thread's bar draws it (else its id, as an AI step).
+     */
+    workflowStepOf?: (stepId: string) => WorkflowStepView | undefined;
     /**
      * 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.
@@ -215,3 +220,14 @@ export interface ChatPageProps {
         aside: string;
     }>;
 }
+/** A workflow step as a chat shows it: its title, kind and where it is. */
+export interface WorkflowStepView {
+    title?: string;
+    kind?: WorkflowStepKind;
+    phase?: WorkflowStepPhase;
+    /** The step's document (its latest version): opened from beside its chip. */
+    document?: {
+        name: string;
+        onOpen: () => void;
+    };
+}

package/dist/chat/flashMessage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Mark the message a link took the reader to: a brief, gentle highlight on the message itself (on
+ * the theme's accent and ring, `[data-deep-link-target]` in `blocks.css`) that fades out and
+ * removes itself, so nothing is left tinted afterwards.
+ */
+export declare function flashMessage(el: Element): void;