@arbidocs/blocks 0.4.77 → 0.4.78

package/dist/agents/index.js

@@ -1,23 +1,23 @@
 "use client";
-export { 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, ConversationListView, ConversationTurnSpeaker, 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_NEW_THREAD_DIALOG_LABELS, DEFAULT_PILL_SELECT_LABELS, DEFAULT_RECURRENCE, DEFAULT_RECURRENCE_BUILDER_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_ACTIVITY_LABELS, DEFAULT_TASK_COMPOSER_LABELS, DEFAULT_TASK_LIST_LABELS, DEFAULT_TASK_OUTPUTS_CELL_LABELS, DEFAULT_TASK_PLAN_LABELS, DEFAULT_TASK_RUNS_DIALOG_LABELS, DEFAULT_TASK_STATUS_PILL_LABELS, DEFAULT_TASK_THREAD_CHIP_LABELS, DEFAULT_TASK_TRIGGER_CHIP_LABELS, DEFAULT_TUPLE_ARRAY_FIELD_LABELS, DEFAULT_UPLOAD_TASK_ITEM_LABELS, DEFAULT_UPLOAD_TASK_LIST_LABELS, DEFAULT_WORKFLOWS_CHROME_LABELS, DEFAULT_WORKFLOW_CONFIG_DIALOG_LABELS, DEFAULT_WORKFLOW_LIST_LABELS, DEFAULT_WORKFLOW_THREAD_STRIP_LABELS, DERIVED_NAME_WORDS, EMPTY_NEW_THREAD, GoalCriteria, MAX_TASK_DEPTH, NewThreadDialog, PersonPill, PillSelect, RecurrenceBuilder, STATUS_LABELS, STATUS_ORDER, STATUS_TONE, SkillActionButton, SkillCard, SkillDetail, SkillDetailSection, SkillEditForm, SkillFilterChips, SkillGenerateForm, SkillGlobalBadge, SkillRow, SkillTile, SkillTypeBadge, SkillViewToggle, StepDetail, StepNarration, StepOutcome, StepParams, StepRow, StepSummary, StepTrace, StepTraceSummary, SubAgentLane, SubStepGroup, SubagentRoster, TASK_COLUMN_ORDER, TRIGGER_LABELS, TaskActivityDialog, TaskActivityTimeline, TaskComposer, TaskFlow, TaskInbox, TaskMoveDialog, TaskOutputsCell, TaskPlan, TaskRunsDialog, TaskStartDialog, TaskStatusPill, TaskTable, TaskThreadChip, TaskTriggerChip, TasksToolbar, ThreadActivity, ThreadNotifyDialog, TupleArrayField, UploadTaskItem, UploadTaskList, WEEKDAYS, WORKFLOW_COLUMN_ORDER, WorkflowConfigDialog, WorkflowDocumentsField, WorkflowLauncher, WorkflowThreadStartedBy, WorkflowThreadStrip, WorkflowsTable, WorkflowsToolbar, agentConfigSectionToValues, agentCreatorToConfigSection, asTaskStatus, authModeFor, buildRRule, buildTaskRows, buildWorkflowScopeSource, compactThreadActivity, composePersona, composerToTaskQuery, composerToWorkRequest, composerToWorkflowRequest, composerToWorkflowUpdate, createTaskColumns, createWorkflowColumns, createsWork, defaultScopeRenderer, defaultTaskComposerValues, deriveAgentName, deriveWorkflowName, descendantIds, describeRRule, filterConversationRows, firstWords, formatElapsed, goalProgress, groupThreadActivity, hasTaskFields, hasTrigger, humanizeSection, indexTasks, inferType, inputDocumentIds, isAgenticWorkflow, isOutOfBounds, isPlainTodo, isSkillRow, isValidAgentName, isoToLocalInput, linkedRunsFromActivity, localInputToIso, matchWorkflowScope, moveTargets, newThreadToRequest, nextCriterionId, ownerExtId, parseRRule, prettifyKey, resolveScopeInputs, skillSlug, stripPersonaPreamble, summarizeAgent, summarizeCapabilities, taskComposerToCreateRequest, taskComposerToUpdateRequest, taskNeedsAccess, taskToComposerValues, useWorkflowPreview, workflowFromSkillMarkdown, workflowStatus, workflowTaskFields, workflowToComposerValues, workflowToSkillMarkdown, workflowTriggerType, workflowWhen } from '../chunk-HEVVT6IT.js';
+export { 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, ConversationListView, ConversationTurnSpeaker, 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_NEW_THREAD_DIALOG_LABELS, DEFAULT_PILL_SELECT_LABELS, DEFAULT_RECURRENCE, DEFAULT_RECURRENCE_BUILDER_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_ACTIVITY_LABELS, DEFAULT_TASK_COMPOSER_LABELS, DEFAULT_TASK_LIST_LABELS, DEFAULT_TASK_OUTPUTS_CELL_LABELS, DEFAULT_TASK_PLAN_LABELS, DEFAULT_TASK_RUNS_DIALOG_LABELS, DEFAULT_TASK_STATUS_PILL_LABELS, DEFAULT_TASK_THREAD_CHIP_LABELS, DEFAULT_TASK_TRIGGER_CHIP_LABELS, DEFAULT_TUPLE_ARRAY_FIELD_LABELS, DEFAULT_UPLOAD_TASK_ITEM_LABELS, DEFAULT_UPLOAD_TASK_LIST_LABELS, DEFAULT_WORKFLOWS_CHROME_LABELS, DEFAULT_WORKFLOW_CONFIG_DIALOG_LABELS, DEFAULT_WORKFLOW_LIST_LABELS, DEFAULT_WORKFLOW_THREAD_STRIP_LABELS, DERIVED_NAME_WORDS, EMPTY_NEW_THREAD, GoalCriteria, MAX_TASK_DEPTH, NewThreadDialog, PersonPill, PillSelect, RecurrenceBuilder, STATUS_LABELS, STATUS_ORDER, STATUS_TONE, SkillActionButton, SkillCard, SkillDetail, SkillDetailSection, SkillEditForm, SkillFilterChips, SkillGenerateForm, SkillGlobalBadge, SkillRow, SkillTile, SkillTypeBadge, SkillViewToggle, StepDetail, StepNarration, StepOutcome, StepParams, StepRow, StepSummary, StepTrace, StepTraceSummary, SubAgentLane, SubStepGroup, SubagentRoster, TASK_COLUMN_ORDER, TRIGGER_LABELS, TaskActivityDialog, TaskActivityTimeline, TaskComposer, TaskFlow, TaskInbox, TaskMoveDialog, TaskOutputsCell, TaskPlan, TaskRunsDialog, TaskStartDialog, TaskStatusPill, TaskTable, TaskThreadChip, TaskTriggerChip, TasksToolbar, ThreadActivity, ThreadNotifyDialog, TupleArrayField, UploadTaskItem, UploadTaskList, WEEKDAYS, WORKFLOW_COLUMN_ORDER, WorkflowConfigDialog, WorkflowDocumentsField, WorkflowLauncher, WorkflowThreadStartedBy, WorkflowThreadStrip, WorkflowsTable, WorkflowsToolbar, agentConfigSectionToValues, agentCreatorToConfigSection, asTaskStatus, authModeFor, buildRRule, buildTaskRows, buildWorkflowScopeSource, compactThreadActivity, composePersona, composerToTaskQuery, composerToWorkRequest, composerToWorkflowRequest, composerToWorkflowUpdate, createTaskColumns, createWorkflowColumns, createsWork, defaultScopeRenderer, defaultTaskComposerValues, deriveAgentName, deriveWorkflowName, descendantIds, describeRRule, filterConversationRows, firstWords, formatElapsed, goalProgress, groupThreadActivity, hasTaskFields, hasTrigger, humanizeSection, indexTasks, inferType, inputDocumentIds, isAgenticWorkflow, isOutOfBounds, isPlainTodo, isSkillRow, isValidAgentName, isoToLocalInput, linkedRunsFromActivity, localInputToIso, matchWorkflowScope, moveTargets, newThreadToRequest, nextCriterionId, ownerExtId, parseRRule, prettifyKey, resolveScopeInputs, skillSlug, stripPersonaPreamble, summarizeAgent, summarizeCapabilities, taskComposerToCreateRequest, taskComposerToUpdateRequest, taskNeedsAccess, taskToComposerValues, useWorkflowPreview, workflowFromSkillMarkdown, workflowStatus, workflowTaskFields, workflowToComposerValues, workflowToSkillMarkdown, workflowTriggerType, workflowWhen } from '../chunk-5OC5CGYX.js';
 import '../chunk-CKB64Z4R.js';
 import '../chunk-P6GHJSLR.js';
-export { ActionStepBody, ApprovalEvidence, AssigneeLine, DEFAULT_ASSIGNEE_WORDING, DEFAULT_SCHEMA_FORM_LABELS, DEFAULT_WORKFLOW_RUNNER_LABELS, DEFAULT_WORKFLOW_STEP_PARTS_LABELS, EMPTY_WORKFLOW_SCOPE, SKILL_PROMPT_FALLBACK_PLACEHOLDER, SKILL_PROMPT_LABEL, SchemaForm, SendBackControl, WorkflowRunner, assigneeName, buildLaunch, canAssign, composeStepPrompt, composeWorkflowPrompt, defaultInputs, dependsOn, fieldToFrontmatter, fillRunText, fillStepInputs, fromPlanAssignee, fromPlanDocumentRef, fromPlanSteps, initialRunInputs, inputsFromContext, isEmptyWorkflowScope, isIncompleteSignal, isPersonAction, isPersonStep, isRunFinished, isSteppedWorkflow, isWorkflowScope, layoutFromPlanSteps, nextAction, orderSteps, promptFieldName, reviewInstructions, runFields, runFieldsOf, runThreadTitle, sendBackTargets, skillToWorkflow, splitDocRef, stepConfigProblems, stepDependencies, stepFields, stepLevels, stepPhase, stepStatesFromActivity, toPlanAssignee, toPlanDocumentRef, toPlanSteps, upstreamSteps, useWorkflowView, validateInputs, validateStep, validateWorkflowGraph, workflowAccepts, workflowFromFrontmatter, workflowSteps, workflowsAccepting, workflowsForHost } from '../chunk-34UW6XUQ.js';
+export { ActionStepBody, ApprovalEvidence, AssigneeLine, DEFAULT_ASSIGNEE_WORDING, DEFAULT_SCHEMA_FORM_LABELS, DEFAULT_STEP_BAR_LABELS, DEFAULT_WORKFLOW_RUNNER_LABELS, DEFAULT_WORKFLOW_STEP_PARTS_LABELS, EMPTY_WORKFLOW_SCOPE, SKILL_PROMPT_FALLBACK_PLACEHOLDER, SKILL_PROMPT_LABEL, SchemaForm, SendBackControl, WorkflowRunner, activeStepId, assigneeName, buildLaunch, canAssign, composeStepPrompt, composeWorkflowPrompt, defaultInputs, dependsOn, fieldToFrontmatter, fillRunText, fillStepInputs, fromPlanAssignee, fromPlanDocumentRef, fromPlanSteps, initialRunInputs, inputsFromContext, isEmptyWorkflowScope, isIncompleteSignal, isPersonAction, isPersonStep, isRunFinished, isSteppedWorkflow, isWorkflowScope, layoutFromPlanSteps, nextAction, orderSteps, promptFieldName, reviewInstructions, runFields, runFieldsOf, runThreadTitle, sendBackTargets, skillToWorkflow, splitDocRef, stepConfigProblems, stepDependencies, stepFields, stepLevels, stepPhase, stepStatesFromActivity, stepWindow, toPlanAssignee, toPlanDocumentRef, toPlanSteps, upstreamSteps, useWorkflowView, validateInputs, validateStep, validateWorkflowGraph, workflowAccepts, workflowFromFrontmatter, workflowSteps, workflowsAccepting, workflowsForHost } from '../chunk-WXRCMIAE.js';
 import '../chunk-4WWM3GQ5.js';
+import '../chunk-DDF5GPIJ.js';
+import '../chunk-XD2M6LIG.js';
 import '../chunk-RFXJYIDV.js';
 import '../chunk-DPLRHEJZ.js';
 import '../chunk-EVUEIBNU.js';
 import '../chunk-NUNKSZKU.js';
 import '../chunk-YU2KUMGE.js';
 import '../chunk-ZPLG7QYF.js';
-import '../chunk-DDF5GPIJ.js';
-import '../chunk-XD2M6LIG.js';
 import '../chunk-S7PSMMRG.js';
-import '../chunk-76JDDMSP.js';
 import '../chunk-HOXKR26S.js';
 import '../chunk-AA3PT6KR.js';
 import '../chunk-SLSBJRWW.js';
 import '../chunk-NPLYHR2E.js';
+import '../chunk-76JDDMSP.js';
 import '../chunk-OXF2IFXG.js';
 import '../chunk-TX2ZICS7.js';
 import '../chunk-7F6CBP3Z.js';

package/dist/agents/tasks/WorkflowThreadStrip.d.ts

@@ -1,14 +1,17 @@
 /**
- * The top bar of a thread that runs a workflow: the workflow's named steps (done, under way, still
- * to come), with everything that actually happened in the thread attached to the step it happened
+ * The top bar of a thread that runs a workflow: where the run is — the previous, current and next
+ * steps by name, the rest behind ‹ › and "…", parallel steps as a "+N" chip, and every running step
+ * out of view as "Working: <title>" (`StepBarFrame`, the same model as the runner's stepper) — with
+ * everything that actually happened in the thread attached to the step it happened
  * during — the assistant's turns, a draft sent back, people's messages and edits, notifications.
  * What happened before the first step or after the last stays as ordinary entries at either end.
  * Linked runs show too: a signal a step raised and the linked thread it started (after the step),
  * and, for a thread a signal started, "Started by <step> in <thread>" (before the steps).
  * A thread without a workflow shows `TaskFlow` instead.
  */
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 import { type WorkflowStepPhase } from '../workflows/run';
+import { type StepBarLabels } from '../workflows/StepBarFrame';
 import type { WorkflowStep, WorkflowStepState } from '../workflows/types';
 import type { TaskFlowItem } from './TaskFlow';
 /** An activity entry, with what the strip needs to place it. */
@@ -91,6 +94,8 @@ export interface WorkflowThreadStripProps {
     /** Who a step is for, in words (`assigneeName`): shown on the step while it waits for them. */
     assigneeOf?: (step: WorkflowStep) => string | undefined;
     labels?: Partial<WorkflowThreadStripLabels>;
+    /** The bar's own wording (arrows, "…", "Working: <title>", status words). */
+    barLabels?: Partial<StepBarLabels>;
     className?: string;
 }
 /** "Started by <step> in <thread>": a linked run's way back to the thread that started it. */
@@ -98,4 +103,4 @@ export declare function WorkflowThreadStartedBy({ origin, labels, }: {
     origin: WorkflowThreadOrigin;
     labels?: Partial<WorkflowThreadStripLabels>;
 }): import("react").JSX.Element;
-export declare function WorkflowThreadStrip({ steps, states, items, renderIcon, onSkip, renderStepAction, signals, startedBy, assigneeOf, labels, className, }: WorkflowThreadStripProps): import("react").JSX.Element;
+export declare function WorkflowThreadStrip({ steps, states, items, renderIcon, onSkip, renderStepAction, signals, startedBy, assigneeOf, labels, barLabels, className, }: WorkflowThreadStripProps): import("react").JSX.Element;

package/dist/agents/workflows/StepBarFrame.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The frame both step bars share (`WorkflowStepBar` in a runner, `WorkflowThreadStrip` on a
+ * thread): `‹ … [previous] [CURRENT] [next] … ›`, from `stepWindow`. Each visible level shows one
+ * step by name (its pill is the host's), a parallel level adds a "+N" chip that lists the group,
+ * "…" on either side lists every step, and every running step the window does not show gets a
+ * "Working: <title>" pill at the end. The bar is a nav landmark; ←/→ (Home/End) move the window.
+ */
+import { type ReactNode } from 'react';
+import type { WorkflowStepPhase } from './run';
+import { type StepWindow, type StepWindowLevel, type StepWindowStep } from './stepWindow';
+export declare function PhaseMark({ phase, icon }: {
+    phase: WorkflowStepPhase;
+    icon?: ReactNode;
+}): import("react").JSX.Element;
+export interface StepBarLabels {
+    nav: string;
+    back: string;
+    forward: string;
+    /** The "…" before the window; `{count}` is replaced. */
+    hiddenBefore: string;
+    /** The "…" after the window; `{count}` is replaced. */
+    hiddenAfter: string;
+    /** The full list's heading; `{position}` and `{total}` are replaced. */
+    position: string;
+    /** A parallel group's chip; `{count}` is replaced. */
+    parallel: string;
+    inParallel: string;
+    /** A running step out of view; `{title}` is replaced. */
+    working: string;
+    /** Several more running out of view; `{count}` is replaced. */
+    moreWorking: string;
+    /** A step that waits for someone; `{name}` is replaced. */
+    waitingFor: string;
+    phases: Record<WorkflowStepPhase, string>;
+}
+export declare const DEFAULT_STEP_BAR_LABELS: StepBarLabels;
+/** A pill's colours: the status shows in the text colour as well as the icon. */
+export declare function stepPillTone(phase: WorkflowStepPhase, current: boolean): string;
+export declare const STEP_PILL = "flex min-w-0 items-center gap-1.5 whitespace-nowrap rounded-full border px-2.5 py-1 text-xs font-medium transition-colors";
+/** A label is the full title, cut with an ellipsis only when very long (in full in `title`). */
+export declare const STEP_LABEL = "min-w-[2.5rem] truncate";
+/** What follows a name on its pill ("Waiting for …"): cut before the name is. */
+export declare const STEP_EXTRA = "min-w-0 shrink-[6] truncate font-normal opacity-80";
+/** A step in the frame's lists: its title, for naming it. */
+export interface StepBarStep extends StepWindowStep {
+    title: string;
+}
+export interface StepBarFrameProps<T extends StepBarStep> {
+    levels: T[][];
+    phaseOf: (id: string) => WorkflowStepPhase;
+    /** The step in view (none = where the run is). */
+    current?: string | null;
+    /** Go to a step: from a group, the full list or a "Working" pill. */
+    onSelect: (id: string) => void;
+    /** The pill of a level's primary step (a button or a popover trigger). */
+    renderStep: (step: T, level: StepWindowLevel<T>, win: StepWindow<T>, narrow: boolean) => ReactNode;
+    /**
+     * What the step in view waits on ("Waiting for …"): on its pill when wide, on a line of its own
+     * when narrow (where the pill has room for its name only).
+     */
+    noteOf?: (id: string) => string | undefined;
+    /** What follows a level's pill (signals it raised…). */
+    renderAfter?: (level: StepWindowLevel<T>) => ReactNode;
+    /** Before the steps / after them: shown while the window is at that end. */
+    leading?: ReactNode;
+    trailing?: ReactNode;
+    /** Steps that cannot be gone to (the completion marker). */
+    isSelectable?: (id: string) => boolean;
+    icon?: (step: T) => ReactNode;
+    disabled?: boolean;
+    labels?: Partial<StepBarLabels>;
+    tid: (suffix: string) => string;
+    className?: string;
+}
+export declare function StepBarFrame<T extends StepBarStep>({ levels, phaseOf, current, onSelect, renderStep, noteOf, renderAfter, leading, trailing, isSelectable, icon, disabled, labels, tid, className, }: StepBarFrameProps<T>): import("react").JSX.Element;

package/dist/agents/workflows/WorkflowRunner.d.ts

@@ -76,6 +76,10 @@ export interface WorkflowRunnerProps extends Pick<SchemaFormProps, 'renderScope'
     renderStepNote?: (step: WorkflowStep, run: WorkflowRunView) => ReactNode;
     /** Replaces the finish screen. */
     renderComplete?: (run: WorkflowRunView) => ReactNode;
+    /** Leave out the stepper (the host shows it elsewhere, e.g. above the run's thread). */
+    hideStepBar?: boolean;
+    /** A narrow panel beside a thread: tighter cards, the full width they are given. */
+    compact?: boolean;
     /** Where the runner hands off to the host: documents, the sign flow, mail, a review grid. */
     actions?: WorkflowRunnerActions;
     /** A document's name by id (chips show it instead of the id). */
@@ -90,6 +94,6 @@ export interface WorkflowRunnerProps extends Pick<SchemaFormProps, 'renderScope'
     testIdPrefix?: string;
     className?: string;
 }
-export declare function WorkflowRunner({ workflow, run, renderAgentOutput, renderReview, onUpload, uploading, files, renderUpload, renderStepNote, renderComplete, renderScope, renderDocuments, renderIcon, people, actions, nameOfDoc, labels, partsLabels, testIdPrefix, className, }: WorkflowRunnerProps): import("react").JSX.Element;
+export declare function WorkflowRunner({ workflow, run, renderAgentOutput, renderReview, onUpload, uploading, files, renderUpload, renderStepNote, renderComplete, renderScope, renderDocuments, renderIcon, people, actions, nameOfDoc, hideStepBar, compact, labels, partsLabels, testIdPrefix, className, }: WorkflowRunnerProps): import("react").JSX.Element;
 /** m:ss (h:mm:ss past an hour). */
 export declare function formatElapsed(ms: number): string;

package/dist/agents/workflows/WorkflowStepBar.d.ts

@@ -1,17 +1,14 @@
 /**
- * The run's stepper: the graph by depth (a sequence is one row, steps side by side stack in a
- * column). It shows every label while they fit the width it has; when they do not, only the step
- * in view keeps its label and the rest are icons (named on hover and to assistive technology).
- * Labels never run past their pill: a long title is cut with an ellipsis, in full in `title`.
+ * The run's stepper: where you are, what is done, what is next and what is still running. It
+ * names the previous, current and next steps of the graph (`StepBarFrame` over `stepLevels`); the
+ * rest is a click away (‹ ›, "…"), a parallel level is one step plus a "+N" chip, and a running
+ * step out of view shows as "Working: <title>". The run's completion is the last step.
  */
-import { type ReactNode } from 'react';
-import type { WorkflowStepPhase } from './run';
+import type { ReactNode } from 'react';
 import type { WorkflowRunView } from './useWorkflowView';
 import type { WorkflowStep } from './types';
-export declare function PhaseMark({ phase, icon }: {
-    phase: WorkflowStepPhase;
-    icon?: ReactNode;
-}): import("react").JSX.Element | null;
+import { PhaseMark, type StepBarLabels } from './StepBarFrame';
+export { PhaseMark };
 export interface WorkflowStepBarProps {
     run: WorkflowRunView;
     levels: WorkflowStep[][];
@@ -19,5 +16,6 @@ export interface WorkflowStepBarProps {
     doneIcon?: ReactNode;
     icon: (key?: string) => ReactNode;
     tid: (suffix: string) => string;
+    labels?: Partial<StepBarLabels>;
 }
-export declare function WorkflowStepBar({ run, levels, doneTitle, doneIcon, icon, tid, }: WorkflowStepBarProps): import("react").JSX.Element;
+export declare function WorkflowStepBar({ run, levels, doneTitle, doneIcon, icon, tid, labels, }: WorkflowStepBarProps): import("react").JSX.Element;

package/dist/agents/workflows/index.d.ts

@@ -13,4 +13,6 @@ export { workflowToSkillMarkdown, workflowFromSkillMarkdown, skillSlug } from '.
 export { useWorkflowView, type UseWorkflowViewOptions, type WorkflowRunView, } from './useWorkflowView';
 export { useWorkflowPreview, type UseWorkflowPreviewOptions } from './useWorkflowPreview';
 export { WorkflowRunner, DEFAULT_WORKFLOW_RUNNER_LABELS, type WorkflowRunnerProps, type WorkflowRunnerLabels, type WorkflowRunnerFile, } from './WorkflowRunner';
+export { stepWindow, activeStepId, type StepWindow, type StepWindowLevel, type StepWindowOptions, type StepWindowStep, } from './stepWindow';
+export { DEFAULT_STEP_BAR_LABELS, type StepBarLabels } from './StepBarFrame';
 export { ActionStepBody, ApprovalEvidence, AssigneeLine, SendBackControl, DEFAULT_WORKFLOW_STEP_PARTS_LABELS, type WorkflowRunnerActions, type WorkflowStepPartsLabels, } from './StepParts';

package/dist/agents/workflows/stepWindow.d.ts

@@ -0,0 +1,59 @@
+/**
+ * What a step bar shows of a run: a window of a few levels of the graph (`stepLevels`) around the
+ * step in view — previous, current, next — with how many steps it hides on either side, each
+ * parallel level collapsed to one primary step plus the rest, and the running steps the window
+ * does not show (so work that is still going on is never out of sight). Pure: both bars
+ * (`WorkflowStepBar` in a runner, `WorkflowThreadStrip` on a thread) render from it.
+ */
+import type { WorkflowStepPhase } from './run';
+/** A step as far as the window is concerned. */
+export interface StepWindowStep {
+    id: string;
+}
+/** One level of the graph: a step, or steps that run side by side (a parallel group). */
+export interface StepWindowLevel<T extends StepWindowStep> {
+    index: number;
+    steps: T[];
+    /** The step the bar shows for the level: the running one, else the one in view, else … */
+    primary: T;
+    /** The level's other steps, behind a "+N" chip. */
+    others: T[];
+    /** Where the level stands relative to the step in view. */
+    role: 'previous' | 'current' | 'next' | 'other';
+}
+export interface StepWindow<T extends StepWindowStep> {
+    levels: StepWindowLevel<T>[];
+    /** The levels in the window, in order. */
+    visible: StepWindowLevel<T>[];
+    /** The window's first level and the one after its last. */
+    start: number;
+    end: number;
+    /** The level of the step in view. */
+    currentLevel: number;
+    /** Steps in the levels before and after the window. */
+    hiddenBefore: number;
+    hiddenAfter: number;
+    canBack: boolean;
+    canForward: boolean;
+    /** Running steps the bar does not show: outside the window, or collapsed in a group. */
+    runningHidden: T[];
+    /** 1-based position of the step in view among all steps, and how many there are. */
+    position: number;
+    total: number;
+}
+export interface StepWindowOptions<T extends StepWindowStep> {
+    levels: T[][];
+    phaseOf: (id: string) => WorkflowStepPhase;
+    /** The step in view; none (or unknown) = the step the run is at (`activeStepId`). */
+    current?: string | null;
+    /** The window's first level, as the arrows moved it; none = around the step in view. */
+    start?: number | null;
+    /** How many levels the window shows (3: previous, current, next). */
+    span?: number;
+}
+/**
+ * The step a run is at, when nothing else says which step is in view: a running one, else one
+ * waiting on someone, else one that failed, else one ready to do, else the last one.
+ */
+export declare function activeStepId<T extends StepWindowStep>(levels: T[][], phaseOf: (id: string) => WorkflowStepPhase): string | undefined;
+export declare function stepWindow<T extends StepWindowStep>({ levels: raw, phaseOf, current, start: requested, span, }: StepWindowOptions<T>): StepWindow<T>;

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, 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, workflowStepTitle, singleThread, targetMessageId, asideBreakpoint, fillHeight, minHeight, compactHeader, accept, labels, className, testIds, }: ChatPageProps): import("react").JSX.Element;

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

@@ -192,6 +192,11 @@ export interface ChatPageProps {
     fillHeight?: boolean;
     /** Smallest height `fillHeight` gives, in px. Default 360. */
     minHeight?: number;
+    /**
+     * One conversation only (e.g. a workflow run's thread): no conversation list, select or New
+     * chat; the host picks the thread (`chat.selectThread`).
+     */
+    singleThread?: boolean;
     /** 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. */