@arbidocs/blocks 0.4.135 → 0.4.137

package/dist/agents/index.js

@@ -1,20 +1,19 @@
 "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, skillSlug, stripPersonaPreamble, summarizeAgent, summarizeCapabilities, taskComposerToCreateRequest, taskComposerToUpdateRequest, taskNeedsAccess, taskToComposerValues, useWorkflowPreview, workflowFromSkillMarkdown, workflowStatus, workflowTaskFields, workflowToComposerValues, workflowToSkillMarkdown, workflowTriggerType, workflowWhen } from '../chunk-UMIY4SQS.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_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_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, 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, 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-KMNZ2RVO.js';
 import '../chunk-RFXJYIDV.js';
-import '../chunk-4XJZ6AAY.js';
+import '../chunk-CQCC7LE7.js';
 import '../chunk-5LXQPP2K.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, SchemaForm, SendBackControl, TaskActivityTimeline, WorkflowRunner, activeStepId, fromPlanAssignee, fromPlanDocumentRef, fromPlanSteps, isIncompleteSignal, layoutFromPlanSteps, stepWindow, taskActivityHeadline, toPlanAssignee, toPlanDocumentRef, toPlanSteps, useWorkflowView } from '../chunk-2PNNCEPH.js';
+export { ActionStepBody, AgentSelect, ApprovalEvidence, AssigneeLine, DEFAULT_AGENT_SELECT_LABELS, DEFAULT_SCHEMA_FORM_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_MAIN_FILENAME, SKILL_TYPES, SchemaForm, SendBackControl, TaskActivityTimeline, TaskTriggerChip, WORKFLOW_COLUMN_ORDER, WorkflowConfigDialog, WorkflowDocumentsField, WorkflowLauncher, WorkflowRunner, WorkflowsTable, activeStepId, buildWorkflowScopeSource, buildZipSkillImport, createWorkflowColumns, documentScopeLabels, 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-ATJUVHVB.js';
 import '../chunk-EVUEIBNU.js';
-import '../chunk-6S5FLMWG.js';
+import '../chunk-KSHKTOY2.js';
+import '../chunk-P6GHJSLR.js';
+import '../chunk-3RJN2VTL.js';
+import '../chunk-444XKG46.js';
 import '../chunk-NUNKSZKU.js';
 import '../chunk-YU2KUMGE.js';
 import '../chunk-N5YEF3LC.js';
-import '../chunk-GDBDHOI4.js';
-import '../chunk-444XKG46.js';
-import '../chunk-XD2M6LIG.js';
 import '../chunk-4WWM3GQ5.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, nextAction, orderSteps, promptFieldName, reviewInstructions, runFields, runFieldsOf, runThreadTitle, sendBackTargets, skillToWorkflow, splitDocRef, stepConfigProblems, stepDependencies, stepDocuments, stepFields, stepKindOf, stepLevels, stepPhase, stepStatesFromActivity, upstreamSteps, validateInputs, validateStep, validateWorkflowGraph, workflowAccepts, workflowFromFrontmatter, workflowSteps, workflowsAccepting, workflowsForHost } from '../chunk-2DFDFOM7.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-YOMPLCP6.js';
 import '../chunk-AUS3KBHJ.js';
 import '../chunk-AA3PT6KR.js';
 import '../chunk-SLSBJRWW.js';

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

@@ -3,3 +3,5 @@ export { SkillRow, DEFAULT_SKILL_ROW_LABELS, type SkillRowProps, type SkillRowLa
 export { SkillTypeBadge, SkillGlobalBadge, SkillActionButton, DEFAULT_SKILL_GLOBAL_BADGE_LABELS, type SkillGlobalBadgeLabels, type SkillActionButtonProps, } from './SkillParts';
 export { SkillGenerateForm, SkillEditForm, DEFAULT_SKILL_GENERATE_FORM_LABELS, DEFAULT_SKILL_EDIT_FORM_LABELS, type SkillGenerateFormLabels, type SkillGenerateFormTestIds, type SkillEditFormLabels, type SkillEditFormTestIds, type SkillGenerateFormProps, type SkillEditFormProps, } from './SkillForms';
 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';

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

@@ -0,0 +1,65 @@
+/**
+ * Skill files: the SKILL.md frontmatter parser / serializer.
+ *
+ * Mirrors the backend parser at
+ * `ARBI/src/core/instruments/skills.py::parse_skill_frontmatter` exactly so
+ * that SKILL.md files created by this UI round-trip through the backend skill
+ * loader without surprises.
+ *
+ * Backend rules we replicate:
+ *  - Frontmatter is delimited by a leading `---` and a closing `---`.
+ *  - It is parsed line-by-line (NOT a real YAML parser): each line is split
+ *    on the first `:`, key is lowercased, value is trimmed.
+ *  - `name` / `description` are metadata.
+ *  - `model` (string), `temperature` (float 0..2), `agent` (truthy string),
+ *    `tools` (comma-separated -> list), `type` (alias-mapped) are config.
+ *  - Skill type is detected from frontmatter `type`, then filename extension,
+ *    then shebang. Default is `markdown`.
+ *  - Main file is `SKILL.md` / `skill.{py,sh,js,ts}` (case-insensitive) or
+ *    `{skill-name}.{ext}` (stem matches the skill folder name).
+ *
+ * A skill's slug is `skillSlug` (`re.sub(r"[^a-z0-9-]", "", name.lower())`).
+ */
+export type SkillType = 'markdown' | 'python' | 'shell' | 'javascript' | 'typescript';
+export declare const SKILL_TYPES: SkillType[];
+/** Canonical primary file name for a skill (Claude-Code compatible). */
+export declare const SKILL_MAIN_FILENAME = "SKILL.md";
+export interface ParsedSkill {
+    /** Skill body with frontmatter removed (trimmed, matches backend). */
+    content: string;
+    name: string;
+    description: string;
+    skillType: SkillType;
+    config: {
+        model?: string;
+        temperature?: number;
+        agent?: boolean;
+        tools?: string[];
+    };
+}
+/**
+ * Mirrors backend `_is_main_file`: a filename is the skill's primary entry
+ * point if it's `SKILL.md`/`skill.{ext}` (case-insensitive) or its stem
+ * equals the skill folder name.
+ */
+export declare function isMainSkillFile(filename: string, skillName: string): boolean;
+/**
+ * Parse skill frontmatter. Behaviourally equivalent to the backend
+ * `parse_skill_frontmatter`.
+ */
+export declare function parseSkillFrontmatter(raw: string, filename?: string): ParsedSkill;
+/**
+ * Serialize a skill back to a SKILL.md string. The output is intentionally in
+ * the simple `key: value` form the backend's line-based parser expects:
+ *  - `tools` is written as a comma-separated string (`tools: a, b`) because
+ *    the backend splits on `,` — a YAML list would NOT round-trip.
+ *  - `type` is only emitted when not `markdown` (markdown is the default and
+ *    needs no annotation).
+ *  - `name` / `description` are always written (metadata, Claude Code compatible).
+ */
+export declare function serializeSkill(input: {
+    name: string;
+    description: string;
+    body: string;
+    type?: SkillType;
+}): string;

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

@@ -0,0 +1,36 @@
+/**
+ * Skill import: turn a `.md` or `.zip` someone gave you (a file, or a link to one) into the upload
+ * entries `{ folder, fileName, content }` of the skill storage contract:
+ *
+ *  - `.md`  → one `skills/{slug}/SKILL.md`. The slug is the frontmatter `name`, else the file name.
+ *  - `.zip` → every file under `skills/{slug}/<relpath>`, subpaths kept. The slug is the archive's
+ *             single top-level folder, else the main file's frontmatter `name`, else the archive
+ *             name. The main file is renamed `SKILL.md`.
+ *
+ * Junk entries (`__MACOSX/`, dotfiles, folders) are skipped. The upload itself is
+ * `useUploadSkillFiles` (`@arbidocs/react`).
+ */
+export interface SkillUploadEntry {
+    folder: string;
+    fileName: string;
+    content: string;
+}
+export interface SkillImportResult {
+    slug: string;
+    entries: SkillUploadEntry[];
+}
+/** A file read out of an archive: its path inside it (forward slashes) and its text. */
+export interface SkillArchiveEntry {
+    path: string;
+    text: string;
+}
+/** One Markdown skill. Slug: the frontmatter `name`, else the file name. */
+export declare function importMarkdownSkill(fileName: string, text: string): SkillImportResult;
+/** The upload entries of an archive's files (already read). */
+export declare function buildZipSkillImport(archiveName: string, rawEntries: SkillArchiveEntry[]): SkillImportResult;
+/** The files of a `.zip` (off the main thread where the browser allows it). */
+export declare function readSkillArchive(file: Blob): Promise<SkillArchiveEntry[]>;
+/** A skill from a file: `.md` / `.markdown`, or a `.zip`. Throws for anything else. */
+export declare function importSkillFile(file: File): Promise<SkillImportResult>;
+/** A skill from a link: its text, named after the last part of the path. */
+export declare function importSkillFromUrl(url: string): Promise<SkillImportResult>;

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

@@ -1,12 +1,12 @@
 export * from './types';
-export { composeWorkflowPrompt, buildLaunch, defaultInputs, validateInputs, isWorkflowScope, isEmptyWorkflowScope, skillToWorkflow, promptFieldName, SKILL_PROMPT_LABEL, SKILL_PROMPT_FALLBACK_PLACEHOLDER, workflowFromFrontmatter, fieldToFrontmatter, workflowAccepts, workflowsAccepting, workflowsForHost, inputsFromContext, type SkillLike, type WorkflowComposeContext, type WorkflowContext, } from './workflow';
+export { composeWorkflowPrompt, buildLaunch, defaultInputs, validateInputs, isWorkflowScope, isEmptyWorkflowScope, skillToWorkflow, skillTitle, mergeSkillWorkflows, promptFieldName, SKILL_PROMPT_LABEL, SKILL_PROMPT_FALLBACK_PLACEHOLDER, workflowFromFrontmatter, fieldToFrontmatter, workflowAccepts, workflowsAccepting, workflowsForHost, inputsFromContext, type SkillLike, type SkillListing, type WorkflowComposeContext, type WorkflowContext, } from './workflow';
 export { SchemaForm, DEFAULT_SCHEMA_FORM_LABELS, type SchemaFormProps, type SchemaFormLabels, } from './SchemaForm';
 export { AgentSelect, DEFAULT_AGENT_SELECT_LABELS, type AgentSelectProps, type AgentSelectLabels, type AgentOption, } from './AgentSelect';
 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/workflow.d.ts

@@ -55,6 +55,25 @@ export declare const SKILL_PROMPT_FALLBACK_PLACEHOLDER = "Describe what you want
  * nothing is never offered; text typed after the slash pre-fills the field.
  */
 export declare function skillToWorkflow(skill: SkillLike): WorkflowDefinition;
+/** A skill named like its slug ("deep-research") reads as a title ("Deep research"); a written name is kept. */
+export declare function skillTitle(name: string): string;
+/** A skill as the skills list returns it (`GET /v1/assistant/skills`). */
+export interface SkillListing extends Omit<SkillLike, 'arg_hint' | 'description'> {
+    description?: string | null;
+    arg_hint?: string | null;
+    /** `builtin` ships with ARBI; `mine` and `global` are documents someone uploaded. */
+    visibility?: string | null;
+}
+/**
+ * The host's own workflows together with the skills the user can run, as one list of workflows:
+ * `host` (in its order) and `skills` (by slug, each a one-field form, icon `skill`). An uploaded skill with a
+ * host workflow's id replaces it (your own copy is used instead of the original); a built-in skill
+ * the host already offers keeps the host's richer form, so nothing is listed twice.
+ */
+export declare function mergeSkillWorkflows(host: WorkflowDefinition[], listings: SkillListing[]): {
+    host: WorkflowDefinition[];
+    skills: WorkflowDefinition[];
+};
 /**
  * Build a workflow from parsed SKILL.md frontmatter (snake_case keys) and its body (the prompt
  * template). The inverse of what the backend will publish; seeded workflows use the same shape.

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. */