@arbidocs/blocks 0.3.184 → 0.4.0

package/dist/agents/index.d.ts

@@ -0,0 +1,7 @@
+export * from './workflows';
+export * from './definitions';
+export * from './skills';
+export * from './tasks';
+export * from './config';
+export * from './runs';
+export * from './approvals';

package/dist/agents/index.js

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

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/agents/runs/AgentBar.d.ts

@@ -0,0 +1,103 @@
+import { type ButtonHTMLAttributes, type ReactNode, type Ref, type UIEventHandler } from 'react';
+/** Every fixed string of the agent bar parts. Pass a partial `labels` to a part to reword. */
+export interface AgentBarLabels {
+    steps: string;
+    hideSteps: string;
+    showSteps: string;
+    /** Step toggle text: "Step 3". */
+    stepN: (count: number) => string;
+    checkingIn: string;
+    agentActions: string;
+    queuedMessage: string;
+    statusUpdate: string;
+}
+export declare const DEFAULT_AGENT_BAR_LABELS: AgentBarLabels;
+export interface AgentBarProps {
+    /** The turn is still running (tonal surface); a settled bar is a hairline outline. */
+    isStreaming: boolean;
+    testId?: string;
+    /** Mirrors run-control state onto `data-control-state`. */
+    controlState?: string;
+    /** Number of rows the steps drawer would show; 0 hides the toggle. */
+    stepCount: number;
+    isDrawerOpen: boolean;
+    onToggleDrawer: () => void;
+    /** The steps list. Rendered in a drawer that opens UPWARD above the bar row. */
+    drawer?: ReactNode;
+    drawerRef?: Ref<HTMLDivElement>;
+    onDrawerScroll?: UIEventHandler<HTMLDivElement>;
+    /** Left: what the agent is doing now ({@link AgentBarStatus}), or "Answered in Xs". */
+    status: ReactNode;
+    /** Run totals (tool calls) shown beside the controls. */
+    stats?: ReactNode;
+    /** Right: Stop and the actions menu. */
+    controls?: ReactNode;
+    /** Under the bar row: queued message, status-update answer. */
+    below?: ReactNode;
+    className?: string;
+    labels?: Partial<AgentBarLabels>;
+    /** Test id of the steps toggle. */
+    stepsToggleTestId?: string;
+}
+/**
+ * The agent turn bar: current step + timer, steps drawer, stop and actions. One chrome for the
+ * live bar above the composer and the settled bar inside a message, so it is learned once.
+ */
+export declare function AgentBar({ isStreaming, testId, controlState, stepCount, isDrawerOpen, onToggleDrawer, drawer, drawerRef, onDrawerScroll, status, stats, controls, below, className, labels, stepsToggleTestId, }: AgentBarProps): import("react").JSX.Element;
+export type AgentBarState = 'pausing' | 'paused' | 'resuming';
+export interface AgentBarStatusProps {
+    /** Run-control state other than `running`. */
+    state?: AgentBarState;
+    stateLabel?: string;
+    /** A status probe is awaiting the agent's answer. */
+    isProbing?: boolean;
+    /** Waiting on delegated sub-agents: names who. */
+    waitingLabel?: string;
+    /** Current step: icon + description. */
+    stepLabel?: string;
+    stepIcon?: ReactNode;
+    /** Live elapsed-seconds ticker. */
+    timer?: ReactNode;
+    labels?: Partial<AgentBarLabels>;
+    /** Per-variant test ids; defaults are the current ids. */
+    testIds?: Partial<{
+        control: string;
+        probe: string;
+        waiting: string;
+        step: string;
+    }>;
+}
+/** The left-hand status line. Exactly one of its variants renders, in priority order. */
+export declare function AgentBarStatus({ state, stateLabel, isProbing, waitingLabel, stepLabel, stepIcon, timer, labels, testIds, }: AgentBarStatusProps): import("react").JSX.Element;
+/** Small icon button in the bar's control cluster (44px on touch). */
+export declare const AgentBarIconButton: import("react").ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & import("react").RefAttributes<HTMLButtonElement>>;
+export interface AgentBarMenuItem {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    onSelect: () => void;
+    disabled?: boolean;
+    testId?: string;
+}
+/** The ⋮ menu. Non-modal: the composer stays usable while it is open. */
+export declare function AgentBarMenu({ items, labels, testId, }: {
+    items: ReadonlyArray<AgentBarMenuItem>;
+    labels?: Partial<AgentBarLabels>;
+    testId?: string;
+}): import("react").JSX.Element;
+/** Wrapper for the notes under the bar row. */
+export declare function AgentBarNotes({ children, className, }: {
+    children: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;
+export declare function AgentBarQueuedNote({ text, isAcknowledged, labels, testId, }: {
+    text: string;
+    isAcknowledged: boolean;
+    labels?: Partial<AgentBarLabels>;
+    testId?: string;
+}): import("react").JSX.Element;
+export declare function AgentBarProbeAnswer({ answer, labels, testId, }: {
+    answer: string;
+    labels?: Partial<AgentBarLabels>;
+    testId?: string;
+}): import("react").JSX.Element;

package/dist/agents/runs/AgentSteps.d.ts

@@ -0,0 +1,157 @@
+import type { ReactNode } from 'react';
+export interface StepTraceProps {
+    /** The rows (StepRow / SubAgentLane). */
+    children: ReactNode;
+    /** Totals footer (see StepTraceSummary). */
+    summary?: ReactNode;
+    className?: string;
+    /** Root id (default `agent-steps`). */
+    testId?: string;
+    /** List id (default `agent-steps-list`). */
+    listTestId?: string;
+}
+/** The agent's step timeline: a numbered list with a rail, plus an optional totals footer. */
+export declare function StepTrace({ children, summary, className, testId, listTestId }: StepTraceProps): import("react").JSX.Element;
+/** Every fixed string of the agent step parts. Pass a partial `labels` to a part to reword. */
+export interface AgentStepsLabels {
+    nearBudget: string;
+    goalMet: string;
+    reviewingGoal: string;
+    subAgent: string;
+    running: string;
+    failed: string;
+    done: string;
+}
+export declare const DEFAULT_AGENT_STEPS_LABELS: AgentStepsLabels;
+export interface StepTraceSummaryProps {
+    /** "3 steps · 2 tool calls · 12.0s ..." */
+    left: string;
+    /** Shows the "near shared credit budget" warning. */
+    isNearBudget?: boolean;
+    /** "Total: 1.2 credits" */
+    total: string;
+    labels?: Partial<AgentStepsLabels>;
+    testId?: string;
+}
+export declare function StepTraceSummary({ left, isNearBudget, total, labels, testId, }: StepTraceSummaryProps): import("react").JSX.Element;
+/** Tone classes of a step's icon node. */
+export interface StepAccentClasses {
+    bg: string;
+    fg: string;
+    ring: string;
+}
+export interface StepRowProps {
+    /** Step index: drives `agent-step-{index}`. */
+    index: number;
+    /** Display number ("3" or "3.2"). */
+    number: string;
+    depth: number;
+    /** The last row has no rail below it. */
+    isLast: boolean;
+    /** The step running right now: pending treatment + ping. */
+    isActive: boolean;
+    accent: StepAccentClasses;
+    icon: ReactNode;
+    /** Row semantic identity (`narration`, `goal`, `tool`...), mirrored as data-step. */
+    kind: string;
+    /** The step's title. */
+    title: ReactNode;
+    /** Test id of the title text (set on the active row). */
+    titleTestId?: string;
+    /** Prefix of the row id: `<prefix>-<index>` (default `agent-step`). */
+    testIdPrefix?: string;
+    /** Tier glyph beside the title (host wraps its tooltip). */
+    badge?: ReactNode;
+    /** Right-aligned meta: model, tokens, credits, duration. */
+    meta?: ReactNode;
+    /** Summary, detail lines, outcome, criteria, folded sub-steps. */
+    children?: ReactNode;
+}
+/** One step: number gutter, rail, icon node, title row, then body parts. */
+export declare function StepRow({ index, number, depth, isLast, isActive, accent, icon, kind, title, titleTestId, testIdPrefix, badge, meta, children, }: StepRowProps): import("react").JSX.Element;
+/** One-line summary under a step title (clamped unless multi-line). */
+export declare function StepSummary({ index, multiLine, children, testIdPrefix, }: {
+    index: number;
+    multiLine?: boolean;
+    children: ReactNode;
+    /** Default `agent-step-summary` (`<prefix>-<index>`). */
+    testIdPrefix?: string;
+}): import("react").JSX.Element;
+/** Narration (the model writing prose to the user); the host renders the markdown. */
+export declare function StepNarration({ index, children, testIdPrefix, }: {
+    index: number;
+    children: ReactNode;
+    /** Default `agent-step-summary` (`<prefix>-<index>`). */
+    testIdPrefix?: string;
+}): import("react").JSX.Element;
+/** What the narrative displaced: the tool's target or a plan's checklist line. */
+export declare function StepDetail({ index, children, testIdPrefix, }: {
+    index: number;
+    children: ReactNode;
+    /** Default `agent-step-detail` (`<prefix>-<index>`). */
+    testIdPrefix?: string;
+}): import("react").JSX.Element;
+/** Outcome chip: neutral tick, or a warning when the step failed. */
+export declare function StepOutcome({ index, failed, children, testIdPrefix, }: {
+    index: number;
+    failed: boolean;
+    children: ReactNode;
+    /** Default `agent-step-outcome` (`<prefix>-<index>`). */
+    testIdPrefix?: string;
+}): import("react").JSX.Element;
+/** Raw tool params (developer affordance). */
+export declare function StepParams({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export interface GoalCriterionView {
+    key: string;
+    text: string;
+    note?: string;
+    met: boolean;
+}
+/** The goal gate's criteria as ticked / unticked checkboxes plus the overall verdict. */
+export declare function GoalCriteria({ criteria, labels, testIds, }: {
+    criteria: GoalCriterionView[];
+    labels?: Partial<AgentStepsLabels>;
+    /** Part ids; defaults are the current ids. */
+    testIds?: Partial<Record<'list' | 'verdict', string>>;
+}): import("react").JSX.Element;
+export interface SubStepGroupProps {
+    /** Parent step index. */
+    parentIndex: number;
+    /** "3 searches, 2 reads". */
+    summary: string;
+    /** Colour class applied to the summary while open (the parent's accent). */
+    openClassName?: string;
+    /** Rendered only while open. */
+    renderSteps: () => ReactNode;
+    /** Prefixes (`<prefix>-<parent index>`); defaults `sub-steps-toggle` / `sub-steps`. */
+    testIds?: Partial<Record<'toggle' | 'list', string>>;
+}
+/** Inner steps of a sub-agent, folded under their parent (collapsed, self-describing). */
+export declare function SubStepGroup({ parentIndex, summary, openClassName, renderSteps, testIds, }: SubStepGroupProps): import("react").JSX.Element;
+export type SubAgentStatus = 'running' | 'failed' | 'done';
+export interface SubAgentLaneProps {
+    handle: string;
+    /** Display number of the lane row. */
+    number: number;
+    /** The lane's job name, never the raw handle. */
+    job: string;
+    /** The child's task (tooltip). */
+    task?: string;
+    status: SubAgentStatus;
+    /** Count of the child's own steps. */
+    innerCount: number;
+    /** What the child is doing right now (shown while collapsed and running). */
+    liveFocus?: string;
+    /** Rendered only while open. */
+    renderSteps: () => ReactNode;
+    labels?: Partial<AgentStepsLabels>;
+    /**
+     * Prefixes (`<prefix>-<handle>`); defaults `subagent-lane`, `subagent-lane-toggle`,
+     * `subagent-lane-status`, `subagent-lane-live`.
+     */
+    testIds?: Partial<Record<'lane' | 'toggle' | 'status' | 'live', string>>;
+}
+/** A concurrently-running sub-agent as its own live lane; collapsed by default, expands on demand. */
+export declare function SubAgentLane({ handle, number, job, task, status, innerCount, liveFocus, renderSteps, labels, testIds, }: SubAgentLaneProps): import("react").JSX.Element;

package/dist/agents/runs/SubagentRoster.d.ts

@@ -0,0 +1,37 @@
+import { type ReactNode } from 'react';
+import type { SubAgentStatus } from './AgentSteps';
+/** One sub-agent line of the roster. */
+export interface SubagentRosterLane {
+    handle: string;
+    status: SubAgentStatus;
+    /** The delegated task (or its job name): the line's text and tooltip. */
+    task: string;
+    /** Count of the child's own steps; a child with none has nothing to expand. */
+    stepCount: number;
+    /** Present when the child has its own thread to step into. */
+    canOpenThread?: boolean;
+}
+/** Every fixed string of the roster. */
+export interface SubagentRosterLabels {
+    badge: string;
+    hideSteps: string;
+    showSteps: string;
+    openThread: string;
+    openThreadAria: string;
+}
+export declare const DEFAULT_SUBAGENT_ROSTER_LABELS: SubagentRosterLabels;
+export interface SubagentRosterProps {
+    lanes: SubagentRosterLane[];
+    /** The child's own steps, rendered only while its line is expanded. */
+    renderSteps: (handle: string) => ReactNode;
+    onOpenThread: (handle: string) => void;
+    className?: string;
+    labels?: Partial<SubagentRosterLabels>;
+}
+/**
+ * Live roster of a turn's sub-agents, indented under the agent's status line: one compact line
+ * per child (static dot while running, check / alert once settled), each expandable to its own
+ * steps. Ids: `running-subagents`, `running-subagent-<h>`, `-toggle-<h>`, `-open-thread-<h>`,
+ * `-steps-<h>`.
+ */
+export declare function SubagentRoster({ lanes, renderSteps, onOpenThread, className, labels, }: SubagentRosterProps): import("react").JSX.Element;

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

@@ -0,0 +1,3 @@
+export { AgentBar, AgentBarStatus, AgentBarIconButton, AgentBarMenu, AgentBarNotes, AgentBarQueuedNote, AgentBarProbeAnswer, DEFAULT_AGENT_BAR_LABELS, type AgentBarLabels, type AgentBarProps, type AgentBarState, type AgentBarStatusProps, type AgentBarMenuItem, } from './AgentBar';
+export { GoalCriteria, DEFAULT_AGENT_STEPS_LABELS, type AgentStepsLabels, StepDetail, StepNarration, StepOutcome, StepParams, StepRow, StepSummary, StepTrace, StepTraceSummary, SubAgentLane, SubStepGroup, type GoalCriterionView, type StepAccentClasses, type StepRowProps, type StepTraceProps, type StepTraceSummaryProps, type SubAgentLaneProps, type SubAgentStatus, type SubStepGroupProps, } from './AgentSteps';
+export { SubagentRoster, DEFAULT_SUBAGENT_ROSTER_LABELS, type SubagentRosterProps, type SubagentRosterLane, type SubagentRosterLabels, } from './SubagentRoster';

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

@@ -0,0 +1,70 @@
+import type { ReactNode } from 'react';
+export interface SkillFilterOption {
+    id: string;
+    label: string;
+    /** How many skills this filter would show. */
+    count?: number;
+}
+export interface SkillFilterChipsProps {
+    options: SkillFilterOption[];
+    value: string;
+    onChange: (id: string) => void;
+    /** Accessible name of the group. */
+    label: string;
+    /** Chip ids are `<prefix>-<option id>`. */
+    testIdPrefix?: string;
+    className?: string;
+}
+/** A single-choice row of filter chips (a radio group): 44px targets on touch, wraps on phones. */
+export declare function SkillFilterChips({ options, value, onChange, label, testIdPrefix, className, }: SkillFilterChipsProps): import("react").JSX.Element;
+export type SkillBrowserView = 'gallery' | 'list';
+export interface SkillViewToggleLabels {
+    group: string;
+    gallery: string;
+    list: string;
+}
+export declare const DEFAULT_SKILL_VIEW_TOGGLE_LABELS: SkillViewToggleLabels;
+export interface SkillViewToggleProps {
+    value: SkillBrowserView;
+    onChange: (view: SkillBrowserView) => void;
+    labels?: Partial<SkillViewToggleLabels>;
+    testId?: string;
+}
+/** Gallery / list switch. */
+export declare function SkillViewToggle({ value, onChange, labels, testId }: SkillViewToggleProps): import("react").JSX.Element;
+export interface SkillTileProps {
+    name: string;
+    description: string;
+    /** Where it comes from: "Built in", "Yours", "Shared". */
+    sourceLabel: string;
+    /** Shown as a small pill when it is not plain instructions. */
+    type?: string;
+    icon?: ReactNode;
+    layout: SkillBrowserView;
+    selected?: boolean;
+    onSelect: () => void;
+    testId?: string;
+}
+/** One skill in the gallery (a card) or the list (a row). Selecting it opens its detail. */
+export declare function SkillTile({ name, description, sourceLabel, type, icon, layout, selected, onSelect, testId, }: SkillTileProps): import("react").JSX.Element;
+export interface SkillDetailProps {
+    title: string;
+    sourceLabel: string;
+    description: string;
+    icon?: ReactNode;
+    /** A line under the title ("Your copy is used instead of the original"). */
+    notice?: ReactNode;
+    /** Sections: the form it asks for, the instructions. */
+    children?: ReactNode;
+    /** The action buttons, as a toolbar. */
+    actions?: ReactNode;
+    testId?: string;
+}
+/** The detail pane of one skill: a header, sections and a sticky action bar. */
+export declare function SkillDetail({ title, sourceLabel, description, icon, notice, children, actions, testId, }: SkillDetailProps): import("react").JSX.Element;
+/** A titled block inside the detail pane. */
+export declare function SkillDetailSection({ title, children, testId, }: {
+    title: string;
+    children: ReactNode;
+    testId?: string;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,48 @@
+import type { HTMLAttributes, MouseEvent, ReactNode } from 'react';
+import { type SkillGlobalBadgeLabels } from './SkillParts';
+export interface SkillCardLabels extends SkillGlobalBadgeLabels {
+    preview: string;
+    edit: string;
+    export: string;
+    makePrivate: string;
+    makePrivateTooltip: string;
+    publish: string;
+}
+export declare const DEFAULT_SKILL_CARD_LABELS: SkillCardLabels;
+export interface SkillCardTestIds {
+    root: string;
+    preview: string;
+    edit: string;
+    export: string;
+    toggleVisibility: string;
+}
+export interface SkillCardProps {
+    name: string;
+    description: string;
+    /** Skill type; a small badge is shown when not `markdown`. */
+    type?: string;
+    /** `global` shows a badge and drives the publish toggle. */
+    visibility?: 'mine' | 'global';
+    /** Only owners see the publish toggle. */
+    isOwner?: boolean;
+    /** Leading icon (the app supplies its skill entity icon). */
+    icon?: ReactNode;
+    /** Invoke the skill (row click / Enter / Space). */
+    onClick: () => void;
+    onPreview: (e: MouseEvent) => void;
+    onEdit: (e: MouseEvent) => void;
+    onExport: (e: MouseEvent) => void;
+    /** Publish / unpublish. Owner-only; omit to hide. */
+    onToggleVisibility?: (e: MouseEvent) => void;
+    /** Destination of the skill; the name becomes a real link (modified clicks go to the browser). */
+    href?: string;
+    labels?: Partial<SkillCardLabels>;
+    testId?: string;
+    testIds?: Partial<SkillCardTestIds>;
+    className?: string;
+}
+/**
+ * Horizontal skill row: icon + `/name` + badges + description, with preview / edit / export /
+ * publish actions. All actions are always visible (nothing is hover-only).
+ */
+export declare function SkillCard({ name, description, type, visibility, isOwner, icon, onClick, onPreview, onEdit, onExport, onToggleVisibility, href, labels, testId, testIds, className, ...rest }: SkillCardProps & Omit<HTMLAttributes<HTMLDivElement>, keyof SkillCardProps | 'onClick'>): import("react").JSX.Element;

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

@@ -0,0 +1,64 @@
+import { type ReactNode } from 'react';
+export interface SkillGenerateFormLabels {
+    title: string;
+    hint: string;
+    placeholder: string;
+    generate: string;
+    writeManually: string;
+}
+export declare const DEFAULT_SKILL_GENERATE_FORM_LABELS: SkillGenerateFormLabels;
+export interface SkillGenerateFormTestIds {
+    description: string;
+    generate: string;
+    writeManually: string;
+}
+export interface SkillGenerateFormProps {
+    /** Describe what the skill should do; the app routes it to the agent. */
+    onGenerate: (description: string) => void;
+    /** Escape hatch to the blank editor. */
+    onManual: () => void;
+    /** Icon on the generate button. */
+    icon?: ReactNode;
+    labels?: Partial<SkillGenerateFormLabels>;
+    testIds?: Partial<SkillGenerateFormTestIds>;
+}
+/** AI-first skill creation: describe it, or write it manually. */
+export declare function SkillGenerateForm({ onGenerate, onManual, icon, labels, testIds, }: SkillGenerateFormProps): import("react").JSX.Element;
+export interface SkillEditFormLabels {
+    name: string;
+    namePlaceholder: string;
+    /** Receives the typed name (empty when nothing is typed yet). */
+    invokedAs: (name: string) => ReactNode;
+    description: string;
+    descriptionPlaceholder: string;
+    instructions: string;
+    cancel: string;
+    saving: string;
+    saveChanges: string;
+    create: string;
+}
+export declare const DEFAULT_SKILL_EDIT_FORM_LABELS: SkillEditFormLabels;
+export interface SkillEditFormTestIds {
+    name: string;
+    description: string;
+    save: string;
+}
+export interface SkillEditFormProps {
+    name: string;
+    onNameChange: (name: string) => void;
+    /** Existing skills cannot be renamed. */
+    isNameLocked?: boolean;
+    nameError?: string | null;
+    description: string;
+    onDescriptionChange: (description: string) => void;
+    /** The instructions editor (the app supplies its markdown editor). */
+    editor: ReactNode;
+    isSaving?: boolean;
+    isEditing: boolean;
+    onSave: () => void;
+    onCancel: () => void;
+    labels?: Partial<SkillEditFormLabels>;
+    testIds?: Partial<SkillEditFormTestIds>;
+}
+/** Skill editor chrome: name + description + editor slot + Cancel / Save footer. */
+export declare function SkillEditForm({ name, onNameChange, isNameLocked, nameError, description, onDescriptionChange, editor, isSaving, isEditing, onSave, onCancel, labels, testIds, }: SkillEditFormProps): import("react").JSX.Element;

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

@@ -0,0 +1,31 @@
+import type { MouseEvent, ReactNode } from 'react';
+/** Small tonal pill showing a non-markdown skill type. */
+export declare function SkillTypeBadge({ type, className }: {
+    type: string;
+    className?: string;
+}): import("react").JSX.Element;
+export interface SkillGlobalBadgeLabels {
+    global: string;
+    globalTitle: string;
+}
+export declare const DEFAULT_SKILL_GLOBAL_BADGE_LABELS: SkillGlobalBadgeLabels;
+/** "Global" marketplace pill. */
+export declare function SkillGlobalBadge({ className, labels, }: {
+    className?: string;
+    labels?: Partial<SkillGlobalBadgeLabels>;
+}): import("react").JSX.Element;
+export interface SkillActionButtonProps {
+    label: string;
+    /** Tooltip text; defaults to `label`. */
+    tooltip?: string;
+    onClick: (e: MouseEvent<HTMLButtonElement>) => void;
+    children: ReactNode;
+    testId?: string;
+}
+/**
+ * Icon action inside a clickable skill row. Stops propagation so the row's invoke handler does
+ * not fire, and meets the 44px touch target on coarse pointers.
+ */
+export declare function SkillActionButton({ label, tooltip, onClick, children, testId, }: SkillActionButtonProps): import("react").JSX.Element;
+/** Activate a role="button" row with Enter/Space, ignoring keys that bubble from inner controls. */
+export declare function activateOnKey(handler: () => void): (e: React.KeyboardEvent<HTMLElement>) => void;

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

@@ -0,0 +1,34 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+import { type SkillGlobalBadgeLabels } from './SkillParts';
+export interface SkillRowLabels extends SkillGlobalBadgeLabels {
+    preview: string;
+    edit: string;
+    makePrivate: string;
+    publish: string;
+    delete: string;
+    /** Row tooltip; receives the skill name. */
+    insertTitle: (name: string) => string;
+}
+export declare const DEFAULT_SKILL_ROW_LABELS: SkillRowLabels;
+export interface SkillRowProps {
+    name: string;
+    description?: string;
+    type?: string;
+    isGlobal?: boolean;
+    icon?: ReactNode;
+    /** Invoke the skill (inserts `/name` into the chat). */
+    onInvoke: () => void;
+    onPreview: () => void;
+    /** Owner-only actions: omit to hide. */
+    onEdit?: () => void;
+    onTogglePublish?: () => void;
+    onDelete?: () => void;
+    /** Destination of the skill; the name becomes a real link (modified clicks go to the browser). */
+    href?: string;
+    labels?: Partial<SkillRowLabels>;
+    /** Overrides the default `skills-panel-row-{name}` id. */
+    testId?: string;
+    className?: string;
+}
+/** Compact two-line skill row for side panels. Actions are always visible. */
+export declare function SkillRow({ name, description, type, isGlobal, icon, onInvoke, onPreview, onEdit, onTogglePublish, onDelete, href, labels, testId, className, ...rest }: SkillRowProps & Omit<HTMLAttributes<HTMLDivElement>, keyof SkillRowProps | 'onClick'>): import("react").JSX.Element;

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

@@ -0,0 +1,5 @@
+export { SkillCard, DEFAULT_SKILL_CARD_LABELS, type SkillCardProps, type SkillCardLabels, type SkillCardTestIds, } from './SkillCard';
+export { SkillRow, DEFAULT_SKILL_ROW_LABELS, type SkillRowProps, type SkillRowLabels, } from './SkillRow';
+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';

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

@@ -0,0 +1,26 @@
+import type { HTMLAttributes } from 'react';
+export interface LiveRun {
+    id: string;
+    name: string;
+}
+export interface LiveRunsBannerProps {
+    runs: LiveRun[];
+    /** Jump into a running task's conversation to watch it stream. */
+    onWatch: (id: string) => void;
+    /** Test ids; `watchRun` derives one per run (default `task-watch-run-{id}`). */
+    testIds?: Partial<{
+        root: string;
+        watchRun: (id: string) => string;
+    }>;
+    labels?: Partial<LiveRunsBannerLabels>;
+    className?: string;
+}
+export interface LiveRunsBannerLabels {
+    /** Count text, e.g. "2 running". */
+    running: (count: number) => string;
+    /** Watch button text for a run. */
+    watch: (name: string) => string;
+}
+export declare const DEFAULT_LIVE_RUNS_BANNER_LABELS: LiveRunsBannerLabels;
+/** Strip of currently running tasks with a Watch action each. Renders nothing when idle. */
+export declare function LiveRunsBanner({ runs, onWatch, testIds, labels, className, ...rest }: LiveRunsBannerProps & Omit<HTMLAttributes<HTMLDivElement>, 'children'>): import("react").JSX.Element | null;

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

@@ -0,0 +1,36 @@
+import { type Weekday } from './rrule';
+/** Fixed strings of the recurrence builder. */
+export interface RecurrenceBuilderLabels {
+    rruleLabel: string;
+    rrulePlaceholder: string;
+    backToSimple: string;
+    repeat: string;
+    daily: string;
+    weekly: string;
+    monthly: string;
+    onDay: string;
+    at: string;
+    on: string;
+    advanced: string;
+    /** Single-letter weekday chips. */
+    weekdayShort: Record<Weekday, string>;
+}
+export declare const DEFAULT_RECURRENCE_BUILDER_LABELS: RecurrenceBuilderLabels;
+export interface RecurrenceBuilderTestIds {
+    rruleRaw: string;
+    simple: string;
+    builder: string;
+    frequency: string;
+    monthDay: string;
+    time: string;
+    advanced: string;
+    /** Per weekday chip (default `task-weekday-{MO..SU}`). */
+    weekday: (day: Weekday) => string;
+}
+export interface RecurrenceBuilderProps {
+    rrule: string;
+    onChange: (rrule: string) => void;
+    testIds?: Partial<RecurrenceBuilderTestIds>;
+    labels?: Partial<RecurrenceBuilderLabels>;
+}
+export declare function RecurrenceBuilder({ rrule, onChange, testIds, labels }: RecurrenceBuilderProps): import("react").JSX.Element;