@arbidocs/blocks 0.4.136 → 0.4.138

package/dist/agents/index.js

@@ -1,27 +1,26 @@
 "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_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_THREAD_LAUNCHER_LABELS, DEFAULT_THREAD_STATE_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_RUN_STATUS_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, TaskComposer, TaskFlow, TaskInbox, TaskMoveDialog, TaskOutputsCell, TaskPlan, TaskRunsDialog, TaskStartDialog, TaskStatusPill, TaskTable, TaskThreadChip, TaskTriggerChip, TasksToolbar, ThreadActivity, ThreadLauncher, ThreadNotifyDialog, ThreadStatusLine, TupleArrayField, UploadTaskItem, UploadTaskList, WEEKDAYS, WORKFLOW_COLUMN_ORDER, WorkflowConfigDialog, WorkflowDocumentsField, WorkflowLauncher, WorkflowRunStatus, 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, stripPersonaPreamble, summarizeAgent, summarizeCapabilities, taskComposerToCreateRequest, taskComposerToUpdateRequest, taskNeedsAccess, taskToComposerValues, useWorkflowPreview, workflowStatus, workflowTaskFields, workflowToComposerValues, workflowTriggerType, workflowWhen } from '../chunk-LT2X5N37.js';
-import '../chunk-3FFRYZKV.js';
-import '../chunk-4XJZ6AAY.js';
+export { AgentAvatarField, AgentBar, AgentBarIconButton, AgentBarMenu, AgentBarNotes, AgentBarProbeAnswer, AgentBarQueuedNote, AgentBarStatus, AgentCard, AgentCreateView, AgentCreatedView, AgentCreator, AgentEditView, AgentGallery, AgentMainView, 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_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_ROW_LABELS, DEFAULT_SUBAGENT_ROSTER_LABELS, DEFAULT_TASKS_CHROME_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_THREAD_LAUNCHER_LABELS, DEFAULT_THREAD_STATE_LABELS, DEFAULT_TUPLE_ARRAY_FIELD_LABELS, DEFAULT_UPLOAD_TASK_ITEM_LABELS, DEFAULT_UPLOAD_TASK_LIST_LABELS, DEFAULT_WORKFLOWS_CHROME_LABELS, DEFAULT_WORKFLOW_RUN_STATUS_LABELS, DEFAULT_WORKFLOW_THREAD_STRIP_LABELS, DERIVED_NAME_WORDS, EMPTY_NEW_THREAD, GoalCriteria, MAX_TASK_DEPTH, NewThreadDialog, PillSelect, RecurrenceBuilder, STATUS_LABELS, STATUS_ORDER, STATUS_TONE, SkillCard, SkillRow, StepDetail, StepNarration, StepOutcome, StepParams, StepRow, StepSummary, StepTrace, StepTraceSummary, SubAgentLane, SubStepGroup, SubagentRoster, TASK_COLUMN_ORDER, TRIGGER_LABELS, TaskActivityDialog, TaskComposer, TaskFlow, TaskInbox, TaskMoveDialog, TaskOutputsCell, TaskPlan, TaskRunsDialog, TaskStartDialog, TaskStatusPill, TaskTable, TaskThreadChip, TasksToolbar, ThreadActivity, ThreadLauncher, ThreadNotifyDialog, ThreadStatusLine, TupleArrayField, UploadTaskItem, UploadTaskList, WEEKDAYS, WorkflowRunStatus, WorkflowThreadStartedBy, WorkflowThreadStrip, WorkflowsToolbar, agentConfigSectionToValues, agentCreatorToConfigSection, asTaskStatus, authModeFor, buildRRule, buildTaskRows, compactThreadActivity, composePersona, composerToTaskQuery, composerToWorkRequest, composerToWorkflowRequest, composerToWorkflowUpdate, createTaskColumns, createsWork, defaultScopeRenderer, defaultTaskComposerValues, deriveAgentName, deriveWorkflowName, descendantIds, describeRRule, filterConversationRows, firstWords, formatElapsed, goalProgress, groupThreadActivity, hasTaskFields, humanizeSection, indexTasks, inferType, inputDocumentIds, isAgenticWorkflow, isOutOfBounds, isPlainTodo, isValidAgentName, isoToLocalInput, linkedRunsFromActivity, localInputToIso, moveTargets, newThreadToRequest, nextCriterionId, ownerExtId, parseRRule, prettifyKey, resolveScopeInputs, stripPersonaPreamble, summarizeAgent, summarizeCapabilities, taskComposerToCreateRequest, taskComposerToUpdateRequest, taskNeedsAccess, taskToComposerValues, useWorkflowPreview, workflowTaskFields, workflowToComposerValues, workflowWhen } from '../chunk-UBEI6WFJ.js';
+import '../chunk-CQCC7LE7.js';
+export { ActionStepBody, AgentSelect, ApprovalEvidence, AssigneeLine, DEFAULT_AGENT_SELECT_LABELS, DEFAULT_SCHEMA_FORM_LABELS, DEFAULT_SKILL_EDIT_FORM_LABELS, DEFAULT_SKILL_GENERATE_FORM_LABELS, DEFAULT_SKILL_GLOBAL_BADGE_LABELS, DEFAULT_SKILL_VIEW_TOGGLE_LABELS, DEFAULT_STEP_BAR_LABELS, DEFAULT_TASK_ACTIVITY_LABELS, DEFAULT_TASK_TRIGGER_CHIP_LABELS, DEFAULT_WORKFLOW_CONFIG_DIALOG_LABELS, DEFAULT_WORKFLOW_DOCUMENTS_FIELD_LABELS, DEFAULT_WORKFLOW_LIST_LABELS, DEFAULT_WORKFLOW_RUNNER_LABELS, DEFAULT_WORKFLOW_STEP_PARTS_LABELS, PersonPill, SKILL_FIELD_TYPE_LABELS, SKILL_MAIN_FILENAME, SKILL_SOURCE_LABELS, SKILL_TYPES, SKILL_TYPE_LABELS, SchemaForm, SendBackControl, SkillActionButton, SkillDetail, SkillDetailSection, SkillEditForm, SkillFilterChips, SkillGenerateForm, SkillGlobalBadge, SkillLibraryDetail, SkillTile, SkillTypeBadge, SkillViewToggle, TaskActivityTimeline, TaskTriggerChip, WORKFLOW_COLUMN_ORDER, WorkflowConfigDialog, WorkflowDocumentsField, WorkflowLauncher, WorkflowRunner, WorkflowsTable, activeStepId, buildLibrarySkills, buildWorkflowScopeSource, buildZipSkillImport, createWorkflowColumns, documentScopeLabels, filterLibrarySkills, fromPlanAssignee, fromPlanDocumentRef, fromPlanSteps, hasTrigger, importMarkdownSkill, importSkillFile, importSkillFromUrl, isIncompleteSignal, isMainSkillFile, isSkillRow, layoutFromPlanSteps, matchWorkflowScope, parseSkillFrontmatter, readSkillArchive, serializeSkill, skillSlug, stepWindow, taskActivityHeadline, toPlanAssignee, toPlanDocumentRef, toPlanSteps, useWorkflowView, workflowFromSkillMarkdown, workflowStatus, workflowToSkillMarkdown, workflowTriggerType } from '../chunk-XVME4XYD.js';
+import '../chunk-3RJN2VTL.js';
+import '../chunk-KSHKTOY2.js';
 import '../chunk-P6GHJSLR.js';
-export { ActionStepBody, ApprovalEvidence, AssigneeLine, DEFAULT_SCHEMA_FORM_LABELS, DEFAULT_STEP_BAR_LABELS, DEFAULT_TASK_ACTIVITY_LABELS, DEFAULT_WORKFLOW_RUNNER_LABELS, DEFAULT_WORKFLOW_STEP_PARTS_LABELS, SKILL_MAIN_FILENAME, SKILL_TYPES, SchemaForm, SendBackControl, TaskActivityTimeline, WorkflowRunner, activeStepId, buildZipSkillImport, fromPlanAssignee, fromPlanDocumentRef, fromPlanSteps, importMarkdownSkill, importSkillFile, importSkillFromUrl, isIncompleteSignal, isMainSkillFile, layoutFromPlanSteps, parseSkillFrontmatter, readSkillArchive, serializeSkill, skillSlug, stepWindow, taskActivityHeadline, toPlanAssignee, toPlanDocumentRef, toPlanSteps, useWorkflowView, workflowFromSkillMarkdown, workflowToSkillMarkdown } from '../chunk-IQU2GI6V.js';
-import '../chunk-XD2M6LIG.js';
-import '../chunk-6S5FLMWG.js';
 import '../chunk-RFXJYIDV.js';
 import '../chunk-5LXQPP2K.js';
-import '../chunk-444XKG46.js';
 import '../chunk-EVUEIBNU.js';
+import '../chunk-444XKG46.js';
 import '../chunk-NUNKSZKU.js';
 import '../chunk-YU2KUMGE.js';
 import '../chunk-N5YEF3LC.js';
 import '../chunk-4WWM3GQ5.js';
-import '../chunk-YNIBUKV5.js';
-import '../chunk-TX2ZICS7.js';
 export { DEFAULT_ASSIGNEE_WORDING, DEFAULT_STEP_DOCUMENT_LABELS, DEFAULT_STEP_KIND_LABELS, DEFAULT_STEP_RECORD_LABELS, EMPTY_WORKFLOW_SCOPE, SKILL_PROMPT_FALLBACK_PLACEHOLDER, SKILL_PROMPT_LABEL, STEP_KIND_ICONS, StepDocumentButton, StepDocumentCards, StepRecord, WORKFLOW_STEP_KINDS, assigneeName, buildLaunch, canAssign, composeStepPrompt, composeWorkflowPrompt, defaultInputs, dependsOn, fieldToFrontmatter, fillRunText, fillStepInputs, initialRunInputs, inputsFromContext, isEmptyWorkflowScope, isPersonAction, isPersonStep, isRunFinished, isSteppedWorkflow, isWorkflowScope, mergeSkillWorkflows, nextAction, orderSteps, promptFieldName, reviewInstructions, runFields, runFieldsOf, runThreadTitle, sendBackTargets, skillTitle, skillToWorkflow, splitDocRef, stepConfigProblems, stepDependencies, stepDocuments, stepFields, stepKindOf, stepLevels, stepPhase, stepStatesFromActivity, upstreamSteps, validateInputs, validateStep, validateWorkflowGraph, workflowAccepts, workflowFromFrontmatter, workflowSteps, workflowsAccepting, workflowsForHost } from '../chunk-Y5KTM3V5.js';
 import '../chunk-AA3PT6KR.js';
 import '../chunk-AUS3KBHJ.js';
 import '../chunk-SLSBJRWW.js';
 import '../chunk-NPLYHR2E.js';
 import '../chunk-7F6CBP3Z.js';
+import '../chunk-YNIBUKV5.js';
+import '../chunk-TX2ZICS7.js';
 import '../chunk-OXF2IFXG.js';
 import '../chunk-VUNV25KB.js';
 //# sourceMappingURL=index.js.map

package/dist/agents/skills/SkillLibraryDetail.d.ts

@@ -0,0 +1,26 @@
+/**
+ * One skill of the library, in full: what it does, what it will ask you, its instructions, and what
+ * you can do with it. Everything is plain words: Run, Make a copy, Share with everyone, Export,
+ * Delete.
+ */
+import type { ReactNode } from 'react';
+import { type LibrarySkill } from './skillLibrary';
+export interface SkillLibraryActions {
+    onRun: () => void;
+    onCopy: () => void;
+    onEdit: () => void;
+    onToggleShare: () => void;
+    onExport: () => void;
+    onDelete: () => void;
+    isBusy: boolean;
+}
+export interface SkillLibraryDetailProps {
+    skill: LibrarySkill;
+    /** Its instructions (a stored skill's are read on demand). */
+    instructions: string;
+    /** The instructions are still being read. */
+    isLoading?: boolean;
+    actions: SkillLibraryActions;
+    icon?: ReactNode;
+}
+export declare function SkillLibraryDetail({ skill, instructions, isLoading, actions, icon, }: SkillLibraryDetailProps): import("react").JSX.Element;

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

@@ -5,3 +5,5 @@ export { SkillGenerateForm, SkillEditForm, DEFAULT_SKILL_GENERATE_FORM_LABELS, D
 export { SkillFilterChips, SkillViewToggle, SkillTile, SkillDetail, SkillDetailSection, DEFAULT_SKILL_VIEW_TOGGLE_LABELS, type SkillFilterOption, type SkillFilterChipsProps, type SkillBrowserView, type SkillViewToggleLabels, type SkillViewToggleProps, type SkillTileProps, type SkillDetailProps, } from './SkillBrowserParts';
 export { parseSkillFrontmatter, serializeSkill, isMainSkillFile, SKILL_MAIN_FILENAME, SKILL_TYPES, type SkillType, type ParsedSkill, } from './skillFiles';
 export { importSkillFile, importSkillFromUrl, importMarkdownSkill, buildZipSkillImport, readSkillArchive, type SkillImportResult, type SkillUploadEntry, type SkillArchiveEntry, } from './skillImport';
+export { buildLibrarySkills, filterLibrarySkills, SKILL_SOURCE_LABELS, SKILL_TYPE_LABELS, SKILL_FIELD_TYPE_LABELS, type LibrarySkill, type LibrarySkillListing, type SkillSource, type SkillFilters, } from './skillLibrary';
+export { SkillLibraryDetail, type SkillLibraryDetailProps, type SkillLibraryActions, } from './SkillLibraryDetail';

package/dist/agents/skills/skillLibrary.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The skills library's one list: the host's built-in skills (its own definitions), the user's own
+ * and the ones other people shared, each with where it comes from. Pure, so the filters and the
+ * "your copy replaces the original" rule are testable without a backend.
+ */
+import type { WorkflowDefinition, WorkflowFieldType } from '../workflows/types';
+import { type SkillListing } from '../workflows/workflow';
+export type SkillSource = 'builtin' | 'mine' | 'shared';
+/** A skill as the skills list returns it, with what the library reads of it. */
+export interface LibrarySkillListing extends SkillListing {
+    skill_type?: string | null;
+    is_owner?: boolean | null;
+    /** Its main file (SKILL.md); a built-in has none. */
+    doc_ext_id?: string | null;
+}
+export interface LibrarySkill {
+    /** The slug: how it is typed after a slash, and what a copy keeps. */
+    slug: string;
+    title: string;
+    description: string;
+    source: SkillSource;
+    /** `markdown` (plain instructions), `python`, ... */
+    type: string;
+    /** Yours and shared with everyone. */
+    isShared: boolean;
+    /** Yours, and it has the same name as a built-in one: yours is used instead. */
+    replacesBuiltin: boolean;
+    workflow: WorkflowDefinition;
+    /** Its main file; absent for a built-in. */
+    docExtId?: string;
+}
+export declare const SKILL_SOURCE_LABELS: Record<SkillSource, string>;
+/** What a kind of skill is called to a reader. */
+export declare const SKILL_TYPE_LABELS: Record<string, string>;
+export declare const SKILL_FIELD_TYPE_LABELS: Record<WorkflowFieldType, string>;
+/**
+ * @param builtins the host's built-in skills (prompt workflows with their own forms)
+ * @param listings the skills list (yours, shared, and the deployment's built-ins)
+ */
+export declare function buildLibrarySkills(builtins: WorkflowDefinition[], listings: LibrarySkillListing[]): LibrarySkill[];
+export interface SkillFilters {
+    query: string;
+    source: SkillSource | 'all';
+    type: string;
+}
+export declare function filterLibrarySkills(skills: LibrarySkill[], f: SkillFilters): LibrarySkill[];

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

@@ -1,12 +1,49 @@
-import type { ReactNode } from 'react';
 import { type PickerDocument } from '../../settings/DocumentPicker';
 import type { WorkflowField, WorkflowScope } from './types';
+/** A workspace file a `documents` field can pick. */
+export interface WorkflowFieldDocument extends PickerDocument {
+    /** Its processing status (`completed`, `processing`…); absent = ready. */
+    status?: string | null;
+    /** An image (for an image-only field, and its thumbnail). */
+    isImage?: boolean;
+}
+export interface WorkflowDocumentsFieldLabels {
+    pickOne: string;
+    pickMany: string;
+    /** The heading of the one list of files (a run has no conversation). */
+    allDocuments: string;
+    addFiles: string;
+    adding: string;
+    empty: string;
+    remove: (name: string) => string;
+    /** A chosen file that is not ready yet: where it is, and that it can still be picked. */
+    pending: (name: string, status: string) => string;
+    status: Record<string, string>;
+}
+export declare const DEFAULT_WORKFLOW_DOCUMENTS_FIELD_LABELS: WorkflowDocumentsFieldLabels;
 export interface WorkflowDocumentsFieldProps {
     field: WorkflowField;
     value: WorkflowScope;
     onChange: (value: WorkflowScope) => void;
-    documents: PickerDocument[];
-    addFilesAction?: ReactNode;
+    /** The workspace's files. */
+    documents: WorkflowFieldDocument[];
+    /** The list has arrived (until then an empty list is not "no files yet"). Default true. */
+    loaded?: boolean;
+    /** A chosen image's thumbnail (`data:` or URL), for the gallery of a several-files field. */
+    thumbnailOf?: (id: string) => string | null | undefined;
+    /**
+     * Add files (dropped ones, or none: the host asks). Absent: no Add files and no drop. A file
+     * that appears in `documents` after this is chosen at once, even while it processes.
+     */
+    onAddFiles?: (files?: File[]) => void;
+    /** Files are being added (the button waits). */
+    adding?: boolean;
+    labels?: Partial<WorkflowDocumentsFieldLabels>;
 }
-/** An explicit workspace-file input, with selection limits and removable choices. */
-export declare function WorkflowDocumentsField({ field, value, onChange, documents, addFilesAction, }: WorkflowDocumentsFieldProps): import("react").JSX.Element;
+/**
+ * A workflow `documents` field: an explicit pick of workspace files. One file is a combobox;
+ * several (`max` > 1) show the chosen ones as removable tiles, with a thumbnail for images, so you
+ * SEE what you are steering a run with. With `onAddFiles`, files can be added (or dropped) right
+ * here, and an empty workspace says so instead of offering an empty list.
+ */
+export declare function WorkflowDocumentsField({ field, value, onChange, documents, loaded, thumbnailOf, onAddFiles, adding, labels, }: WorkflowDocumentsFieldProps): import("react").JSX.Element;

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

@@ -5,8 +5,8 @@ export { AgentSelect, DEFAULT_AGENT_SELECT_LABELS, type AgentSelectProps, type A
 export { WorkflowConfigDialog, DEFAULT_WORKFLOW_CONFIG_DIALOG_LABELS, type WorkflowConfigDialogProps, type WorkflowConfigDialogLabels, type WorkflowScopeSource, } from './WorkflowConfigDialog';
 export { defaultScopeRenderer, resolveScopeInputs } from './scopeRender';
 export { WorkflowLauncher, type WorkflowLauncherProps } from './WorkflowLauncher';
-export { buildWorkflowScopeSource, matchWorkflowScope, type WorkflowScopeDocument, type WorkflowScopeLabel, } from './workspaceScope';
-export { WorkflowDocumentsField, type WorkflowDocumentsFieldProps } from './WorkflowDocumentsField';
+export { buildWorkflowScopeSource, documentScopeLabels, matchWorkflowScope, type WorkflowScopeDocument, type WorkflowScopeLabel, type WorkflowScopeTag, } from './workspaceScope';
+export { WorkflowDocumentsField, DEFAULT_WORKFLOW_DOCUMENTS_FIELD_LABELS, type WorkflowDocumentsFieldProps, type WorkflowDocumentsFieldLabels, type WorkflowFieldDocument, } from './WorkflowDocumentsField';
 export { workflowSteps, isSteppedWorkflow, stepDependencies, dependsOn, orderSteps, validateWorkflowGraph, stepLevels, stepStatesFromActivity, runFields, initialRunInputs, stepPhase, isRunFinished, isPersonStep, nextAction, validateStep, fillRunText, fillStepInputs, runThreadTitle, reviewInstructions, composeStepPrompt, stepFields, runFieldsOf, isPersonAction, canAssign, upstreamSteps, sendBackTargets, stepConfigProblems, splitDocRef, assigneeName, DEFAULT_ASSIGNEE_WORDING, type AssigneeWording, type WorkflowStepProblem, type StepComposeOptions, type WorkflowActivityEvent, type WorkflowGraphProblem, type WorkflowStepPhase, type WorkflowNextAction, } from './run';
 export { toPlanSteps, fromPlanSteps, layoutFromPlanSteps, isIncompleteSignal, toPlanAssignee, fromPlanAssignee, toPlanDocumentRef, fromPlanDocumentRef, type TaskPlanStep, type ToPlanOptions, } from './planSteps';
 export { workflowToSkillMarkdown, workflowFromSkillMarkdown, skillSlug } from './skillMarkdown';

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

@@ -12,6 +12,18 @@ export interface WorkflowScopeLabel {
     name: string;
     color?: string;
 }
+/** A workspace tag, as far as the scope picker reads it. */
+export interface WorkflowScopeTag extends WorkflowScopeLabel {
+    kind?: string | null;
+    doctag_count?: number | null;
+    facttag_count?: number | null;
+}
+/**
+ * The labels a scope picker offers: the workspace's document vocabulary, as the Files page's quick
+ * filter has it. Saved searches are not labels; a tag used only on facts is not a file label; one
+ * used nowhere yet is offered.
+ */
+export declare function documentScopeLabels<T extends WorkflowScopeTag>(tags: T[]): T[];
 /** Match the same folder/label OR semantics as the document library; explicit file picks win. */
 export declare function matchWorkflowScope<T extends WorkflowScopeDocument>(docs: T[], scope: WorkflowScope): T[];
 /** Turn real workspace documents and labels into the shared workflow scope picker model. */

package/dist/calls/index.cjs

@@ -1,12 +1,12 @@
 "use client";
 'use strict';
 
-var chunkZAVEMQ37_cjs = require('../chunk-ZAVEMQ37.cjs');
+var chunkDWZXSPMB_cjs = require('../chunk-DWZXSPMB.cjs');
 var chunk7RGLTF76_cjs = require('../chunk-7RGLTF76.cjs');
-require('../chunk-ULWRNGGE.cjs');
 var chunkMWDW5UBW_cjs = require('../chunk-MWDW5UBW.cjs');
 require('../chunk-PPCATBOY.cjs');
 require('../chunk-MHVNT4J3.cjs');
+require('../chunk-ULWRNGGE.cjs');
 var chunkKDG6FER6_cjs = require('../chunk-KDG6FER6.cjs');
 require('../chunk-DES3K4SD.cjs');
 var react = require('react');
@@ -1986,7 +1986,7 @@ function WebinarEndConfirm({
   const { isPending, run } = usePending();
   const ending = isPending("end");
   return /* @__PURE__ */ jsxRuntime.jsx(
-    chunkZAVEMQ37_cjs.ConfirmDialog,
+    chunkDWZXSPMB_cjs.ConfirmDialog,
     {
       isOpen: open,
       onClose: () => onOpenChange(false),

package/dist/calls/index.js

@@ -1,11 +1,11 @@
 "use client";
-import { ConfirmDialog } from '../chunk-ECERC6TI.js';
+import { ConfirmDialog } from '../chunk-VHJHY7TT.js';
 import { TabHeader } from '../chunk-4WWM3GQ5.js';
-import '../chunk-TX2ZICS7.js';
 import { NOTICE_MS, gridSlots, gridLayout, spotlightBox, CAPTION_TTL_MS, CAPTION_LINES, speakerAccent, formatElapsed, initialsOf, SPEAKING_LEVEL, nextSpotlight, INITIAL_SPOTLIGHT } from '../chunk-Z3AZ7Q5X.js';
 export { CAPTION_LINES, CAPTION_TTL_MS, INITIAL_SPOTLIGHT, MAX_GRID_TILES, NOTICE_MS, SPEAKER_ACCENTS, SPEAKING_LEVEL, TILE_ASPECT, formatElapsed, gridLayout, gridSlots, initialsOf, nearestCorner, nextSpotlight, pickSpotlight, rowCounts, speakerAccent, speakerBorder, spotlightBox, stageContentHeight } from '../chunk-Z3AZ7Q5X.js';
 import '../chunk-NPLYHR2E.js';
 import '../chunk-7F6CBP3Z.js';
+import '../chunk-TX2ZICS7.js';
 import { fromNow } from '../chunk-OXF2IFXG.js';
 import '../chunk-VUNV25KB.js';
 import { forwardRef, useState, useRef, useMemo, useEffect, useSyncExternalStore, useCallback } from 'react';

package/dist/chunk-2KUCVSFF.js

@@ -0,0 +1,51 @@
+"use client";
+import { useConnectedWorkspace } from './chunk-L2PAPOZ5.js';
+import { createContext, useMemo, useContext } from 'react';
+import { useDocuments, useTags, useConversations } from '@arbidocs/react';
+import { jsx } from 'react/jsx-runtime';
+
+var WorkspaceDataContext = createContext({});
+function ConnectedWorkspaceDataProvider({
+  documents,
+  tags,
+  conversations,
+  children
+}) {
+  const value = useMemo(
+    () => ({ documents, tags, conversations }),
+    [documents, tags, conversations]
+  );
+  return /* @__PURE__ */ jsx(WorkspaceDataContext.Provider, { value, children });
+}
+var EMPTY = [];
+function useList(hosted, own) {
+  const source = hosted ?? own;
+  const data = source.data ?? EMPTY;
+  const refetch = hosted ? hosted.refetch : own.refetch;
+  return useMemo(
+    () => ({ data, loaded: source.isFetched, refetch }),
+    [data, source.isFetched, refetch]
+  );
+}
+function useConnectedDocuments() {
+  const hosted = useContext(WorkspaceDataContext).documents;
+  const { workspaceId } = useConnectedWorkspace();
+  const own = useDocuments(workspaceId ?? void 0, { enabled: !hosted });
+  return useList(hosted, own);
+}
+function useConnectedTags() {
+  const hosted = useContext(WorkspaceDataContext).tags;
+  const { workspaceId } = useConnectedWorkspace();
+  const own = useTags(workspaceId ?? void 0, { enabled: !hosted });
+  return useList(hosted, own);
+}
+function useConnectedConversations(options) {
+  const hosted = useContext(WorkspaceDataContext).conversations;
+  const { workspaceId } = useConnectedWorkspace();
+  const own = useConversations(workspaceId ?? void 0, { enabled: !hosted, live: options?.live });
+  return useList(hosted, own);
+}
+
+export { ConnectedWorkspaceDataProvider, useConnectedConversations, useConnectedDocuments, useConnectedTags };
+//# sourceMappingURL=chunk-2KUCVSFF.js.map
+//# sourceMappingURL=chunk-2KUCVSFF.js.map

package/dist/chunk-2KUCVSFF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connection/workspaceData.tsx"],"names":[],"mappings":";;;;;AA+BA,IAAM,oBAAA,GAAuB,aAAA,CAAsC,EAAE,CAAA;AAE9D,SAAS,8BAAA,CAA+B;AAAA,EAC7C,SAAA;AAAA,EACA,IAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAA,EAAqD;AACnD,EAAA,MAAM,KAAA,GAAQ,OAAA;AAAA,IACZ,OAAO,EAAE,SAAA,EAAW,IAAA,EAAM,aAAA,EAAc,CAAA;AAAA,IACxC,CAAC,SAAA,EAAW,IAAA,EAAM,aAAa;AAAA,GACjC;AACA,EAAA,uBAAO,GAAA,CAAC,oBAAA,CAAqB,QAAA,EAArB,EAA8B,OAAe,QAAA,EAAS,CAAA;AAChE;AASA,IAAM,QAAiB,EAAC;AAExB,SAAS,OAAA,CACP,QACA,GAAA,EACwB;AACxB,EAAA,MAAM,SAAS,MAAA,IAAU,GAAA;AACzB,EAAA,MAAM,IAAA,GAAO,OAAO,IAAA,IAAS,KAAA;AAC7B,EAAA,MAAM,OAAA,GAAU,MAAA,GAAS,MAAA,CAAO,OAAA,GAAU,GAAA,CAAI,OAAA;AAC9C,EAAA,OAAO,OAAA;AAAA,IACL,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,MAAA,CAAO,WAAW,OAAA,EAAQ,CAAA;AAAA,IACjD,CAAC,IAAA,EAAM,MAAA,CAAO,SAAA,EAAW,OAAO;AAAA,GAClC;AACF;AAGO,SAAS,qBAAA,GAAgE;AAC9E,EAAA,MAAM,MAAA,GAAS,UAAA,CAAW,oBAAoB,CAAA,CAAE,SAAA;AAChD,EAAA,MAAM,EAAE,WAAA,EAAY,GAAI,qBAAA,EAAsB;AAC9C,EAAA,MAAM,GAAA,GAAM,aAAa,WAAA,IAAe,MAAA,EAAW,EAAE,OAAA,EAAS,CAAC,QAAQ,CAAA;AACvE,EAAA,OAAO,OAAA,CAAQ,QAAQ,GAAG,CAAA;AAC5B;AAGO,SAAS,gBAAA,GAAsD;AACpE,EAAA,MAAM,MAAA,GAAS,UAAA,CAAW,oBAAoB,CAAA,CAAE,IAAA;AAChD,EAAA,MAAM,EAAE,WAAA,EAAY,GAAI,qBAAA,EAAsB;AAC9C,EAAA,MAAM,GAAA,GAAM,QAAQ,WAAA,IAAe,MAAA,EAAW,EAAE,OAAA,EAAS,CAAC,QAAQ,CAAA;AAClE,EAAA,OAAO,OAAA,CAAQ,QAAQ,GAAG,CAAA;AAC5B;AAMO,SAAS,0BAA0B,OAAA,EAEK;AAC7C,EAAA,MAAM,MAAA,GAAS,UAAA,CAAW,oBAAoB,CAAA,CAAE,aAAA;AAChD,EAAA,MAAM,EAAE,WAAA,EAAY,GAAI,qBAAA,EAAsB;AAC9C,EAAA,MAAM,GAAA,GAAM,gBAAA,CAAiB,WAAA,IAAe,MAAA,EAAW,EAAE,OAAA,EAAS,CAAC,MAAA,EAAQ,IAAA,EAAM,OAAA,EAAS,IAAA,EAAM,CAAA;AAChG,EAAA,OAAO,OAAA,CAAQ,QAAQ,GAAG,CAAA;AAC5B","file":"chunk-2KUCVSFF.js","sourcesContent":["/**\n * The open workspace's documents, tags and conversations for the connected kits. By default each kit reads them\n * through the `@arbidocs/react` hooks. A host that already keeps these lists live in its own cache\n * (the ARBI app, with its progressive loader and WebSocket patches) passes them once through\n * `ConnectedWorkspaceDataProvider`, so the kits show the same list and nothing is fetched twice.\n */\n\nimport { createContext, useContext, useMemo, type ReactNode } from 'react'\nimport { useConversations, useDocuments, useTags } from '@arbidocs/react'\nimport { useConnectedWorkspace } from './ConnectionProvider'\n\nexport type ConnectedDocument = NonNullable<ReturnType<typeof useDocuments>['data']>[number]\nexport type ConnectedTag = NonNullable<ReturnType<typeof useTags>['data']>[number]\nexport type ConnectedConversation = NonNullable<ReturnType<typeof useConversations>['data']>[number]\n\n/**\n * A list the host keeps: its rows, whether it has arrived, and how to read it again (absent: the\n * host keeps it current itself, so a kit never re-reads it).\n */\nexport interface ConnectedList<T> {\n  data: T[] | undefined\n  isFetched: boolean\n  refetch?: () => unknown\n}\n\nexport interface ConnectedWorkspaceData {\n  documents?: ConnectedList<ConnectedDocument>\n  tags?: ConnectedList<ConnectedTag>\n  conversations?: ConnectedList<ConnectedConversation>\n}\n\nconst WorkspaceDataContext = createContext<ConnectedWorkspaceData>({})\n\nexport function ConnectedWorkspaceDataProvider({\n  documents,\n  tags,\n  conversations,\n  children,\n}: ConnectedWorkspaceData & { children: ReactNode }) {\n  const value = useMemo(\n    () => ({ documents, tags, conversations }),\n    [documents, tags, conversations]\n  )\n  return <WorkspaceDataContext.Provider value={value}>{children}</WorkspaceDataContext.Provider>\n}\n\nexport interface ConnectedListResult<T> {\n  data: T[]\n  loaded: boolean\n  /** Read the list again after a change made here; absent when the host keeps it current. */\n  refetch?: () => unknown\n}\n\nconst EMPTY: never[] = []\n\nfunction useList<T>(\n  hosted: ConnectedList<T> | undefined,\n  own: { data?: T[]; isFetched: boolean; refetch: () => unknown }\n): ConnectedListResult<T> {\n  const source = hosted ?? own\n  const data = source.data ?? (EMPTY as T[])\n  const refetch = hosted ? hosted.refetch : own.refetch\n  return useMemo(\n    () => ({ data, loaded: source.isFetched, refetch }),\n    [data, source.isFetched, refetch]\n  )\n}\n\n/** The open workspace's documents: the host's list when it gives one, else read here. */\nexport function useConnectedDocuments(): ConnectedListResult<ConnectedDocument> {\n  const hosted = useContext(WorkspaceDataContext).documents\n  const { workspaceId } = useConnectedWorkspace()\n  const own = useDocuments(workspaceId ?? undefined, { enabled: !hosted })\n  return useList(hosted, own)\n}\n\n/** The open workspace's tags: the host's list when it gives one, else read here. */\nexport function useConnectedTags(): ConnectedListResult<ConnectedTag> {\n  const hosted = useContext(WorkspaceDataContext).tags\n  const { workspaceId } = useConnectedWorkspace()\n  const own = useTags(workspaceId ?? undefined, { enabled: !hosted })\n  return useList(hosted, own)\n}\n\n/**\n * The open workspace's conversations (threads and tasks): the host's list when it gives one, else\n * read here (`live`: re-read while shown, as a run moves on by itself).\n */\nexport function useConnectedConversations(options?: {\n  live?: boolean\n}): ConnectedListResult<ConnectedConversation> {\n  const hosted = useContext(WorkspaceDataContext).conversations\n  const { workspaceId } = useConnectedWorkspace()\n  const own = useConversations(workspaceId ?? undefined, { enabled: !hosted, live: options?.live })\n  return useList(hosted, own)\n}\n"]}