@calliopelabs/ui 0.11.0 → 0.13.0

package/README.md

@@ -284,6 +284,19 @@ The package fetches nothing. `DataTable` reads a `TableController`: rows, state,
 
 ## Workflows
 
+`WorkflowQuestionCard` shows a host-owned runtime question, including several
+fields, optional choices and Unicode answers. Bind `question.id`, its opaque
+`revision`, `answers` and delivery `state` to the same request. `onSubmit` reports
+answer intent only; the host must authorize delivery and set `submitting` before
+starting its request. Use `accepted` when the service accepted the answer and
+`acknowledged` only with correlated worker evidence. For uncertain delivery,
+`onRefresh` reads the original request without submitting it again. A changed
+question identity or revision requires a fresh host-owned answer draft.
+
+The card handles loading, empty, read-only, expired and unavailable states. Its
+copy is overridable through the `workflowQuestion` message group. It never starts
+work, grants permission, fetches data or infers acknowledgment from a click.
+
 The workflow surfaces are module-neutral: software, content, media, legal, document review, process, paperwork and automations are labels and versions the host supplies, and nothing in the model assumes tickets, repositories or code. They are host-driven: data in, callbacks out. The package never fetches, saves, authorizes or runs anything.
 
 - **Gallery.** `WorkflowGallery` is a full page of `WorkflowCard`s with search, a module filter, scope and status filters, grid and list views, and create and import when the host passes their handlers. Its filters are controlled (`filters`, `onFiltersChange`): a host that searches on its server passes them to its query; one that holds every definition uses `filterWorkflows(workflows, filters)`. Empty and no-matches are different states.
@@ -360,6 +373,24 @@ const registry: WorkflowRegistry = {
 
 It marks unsaved edits and a draft that differs from live (`documentStatus`). A newer saved revision is taken when there is nothing to lose; when it moves under unsaved edits, it stops and asks: compare, use theirs, or keep mine. Publishing shows the draft against live (`WorkflowDiff`) and is held while anything blocks. A rejected promise's message is shown and the edits stay. Persistence and authority stay with the host: it never saves, publishes or runs anything itself. Below a 64rem container the palette and the side panel open as drawers.
 
+A host can reach further into the editor. Each is opt-in; without them the editor is as above.
+
+- **Deep links.** `defaultSelection` opens the editor on a flow and a node (`{ type: "node", flow, id }`); `selection` with `onSelectionChange` holds it in the host. A selection in another flow opens that flow, and the canvas brings the node into view.
+- **Flows.** `onFlowCreate` offers New flow and `onFlowRename` offers Rename flow for the open one. The dialog checks the name as it is typed against `WORKFLOW_FLOW_NAME` (a lowercase slug of up to 32 characters), against the other flows and against `WORKFLOW_MAX_FLOWS`, then hands the host the next definition to apply. `renameFlow` renames the key, `main` and every sub-flow node that runs it; anything else the host keeps that names flows is the host's to follow. `flowNameProblem`, `addFlow` and `renameFlow` are exported for hosts that edit flows themselves.
+- **Host fields.** `renderNodeFields` adds the host's own fields to the inspector after a node's kind fields, with the node, its flow and an `onChange` that patches it. Switch on `node.kind` and return null for none.
+
+```tsx
+<WorkflowWorkspace
+  {...props}
+  defaultSelection={at ? { type: "node", flow: at.flow, id: at.node } : null}
+  onFlowCreate={(next) => setDraft(next)}
+  onFlowRename={(next, from, to) => setDraft(next) /* and follow `from` to `to` in what you keep */}
+  renderNodeFields={({ node, readOnly }) =>
+    node.kind === "step" ? <RunnerPicker step={node.id} readOnly={readOnly} /> : null
+  }
+/>
+```
+
 The canvas pans, zooms and fits without going below `READABLE_ZOOM`; loop bodies and fan-out branches fold, and a sub-flow shows in place. Every drag has a keyboard equivalent: Tab to a node or edge, Enter to select, arrows to move, Delete to remove, and Add and Connect in its toolbar.
 
 `@xyflow/react` comes with the package; its structural CSS is in the preset.

package/dist/index.d.ts

@@ -64,6 +64,8 @@ export { Tabs, TabsContent, TabsList, TabsTrigger } from "./primitives/Tabs.js";
 export { Skeleton } from "./primitives/Skeleton.js";
 export type { WorkflowAction, WorkflowAvailability, WorkflowModule, WorkflowPermissions, WorkflowScope, WorkflowStatus, WorkflowSummary, } from "./workflow/model.js";
 export { WorkflowCard, WorkflowCardSkeleton, type WorkflowCardActions, type WorkflowCardProps, } from "./workflow/WorkflowCard.js";
+export { WorkflowQuestionCard, type WorkflowQuestionCardProps, } from "./workflow/WorkflowQuestionCard.js";
+export type { WorkflowQuestion, WorkflowQuestionField, WorkflowQuestionState, WorkflowQuestionAnswers, WorkflowQuestionSubmission, } from "./workflow/question.js";
 export { ANY_FILTER, DEFAULT_WORKFLOW_FILTERS, filterWorkflows, isFiltered, type WorkflowGalleryFilters, } from "./workflow/gallery.js";
 export { WorkflowGallery, type WorkflowGalleryProps, type WorkflowGalleryView, } from "./workflow/WorkflowGallery.js";
 export { ARTIFACT_TONE, GATE_TONE, RUN_STAGE_TONE, VERDICT_TONE, type Artifact, type ArtifactStatus, type Gate, type GateStatus, type ReviewComment, type ReviewDecision, type ReviewVerdict, type RunStage, type RunStageStatus, type RunValue, } from "./workflow/run.js";
@@ -74,7 +76,7 @@ export { ReviewPanel, type ReviewPanelProps } from "./workflow/ReviewPanel.js";
 export { MediaReview, formatTimecode, type MediaAnchor, type MediaCaptionTrack, type MediaComment, type MediaRegion, type MediaReviewProps, } from "./workflow/MediaReview.js";
 export { DocumentReview, type DocumentAnnotation, type DocumentBlock, type DocumentPage, type DocumentReviewProps, type DocumentSegment, type DocumentSignOff, type SignOffStatus, } from "./workflow/DocumentReview.js";
 export { FormReview, type FormField, type FormFieldBox, type FormFieldStatus, type FormReviewProps, type FormSourcePage, } from "./workflow/FormReview.js";
-export { IN, LOOP_IN, LOOP_OUT, OUT, WORKFLOW_DEFINITION_VERSION, WORKFLOW_NODE_KINDS, WORKFLOW_SELECTORS, addNode, canConnect, createNode, dataTypes, downstream, edgeId, exitLabel, exitsOf, findFact, findGateKind, findPreset, freshId, inputsOf, isJudge, moveNode, operatorsFor, outputsOf, portOf, removeEdge, removeNode, startOf, typeAccepts, updateEdge, updateNode, upstream, withFlow, type WorkflowCase, type WorkflowCheckNode, type WorkflowClassifierNode, type WorkflowClassifierOption, type WorkflowCondition, type WorkflowConditionNode, type WorkflowConnectReason, type WorkflowConnectResult, type WorkflowConnection, type WorkflowDataType, type WorkflowDefinition, type WorkflowEdge, type WorkflowEvaluatorNode, type WorkflowFact, type WorkflowFactType, type WorkflowFanoutNode, type WorkflowFlow, type WorkflowGateField, type WorkflowGateKind, type WorkflowGateNode, type WorkflowGatePolicy, type WorkflowGotoNode, type WorkflowJoinNode, type WorkflowJudgeNode, type WorkflowModuleSpec, type WorkflowNode, type WorkflowNodeKind, type WorkflowNodeOf, type WorkflowNodeTemplate, type WorkflowOperator, type WorkflowOption, type WorkflowPort, type WorkflowPosition, type WorkflowRegistry, type WorkflowSelection, type WorkflowSelector, type WorkflowStepNode, type WorkflowStepPreset, type WorkflowSubflowNode, type WorkflowVariant, type WorkflowVariantsNode, } from "./workflow/definition.js";
+export { IN, LOOP_IN, LOOP_OUT, OUT, WORKFLOW_DEFINITION_VERSION, WORKFLOW_FLOW_NAME, WORKFLOW_MAX_FLOWS, WORKFLOW_NODE_KINDS, WORKFLOW_SELECTORS, addFlow, addNode, canConnect, createNode, dataTypes, downstream, edgeId, exitLabel, exitsOf, findFact, findGateKind, findPreset, flowNameProblem, freshId, inputsOf, isJudge, moveNode, operatorsFor, outputsOf, portOf, removeEdge, removeNode, renameFlow, startOf, typeAccepts, updateEdge, updateNode, upstream, withFlow, type WorkflowCase, type WorkflowCheckNode, type WorkflowClassifierNode, type WorkflowClassifierOption, type WorkflowCondition, type WorkflowConditionNode, type WorkflowConnectReason, type WorkflowConnectResult, type WorkflowConnection, type WorkflowDataType, type WorkflowDefinition, type WorkflowEdge, type WorkflowEvaluatorNode, type WorkflowFact, type WorkflowFactType, type WorkflowFanoutNode, type WorkflowFlow, type WorkflowFlowNameProblem, type WorkflowGateField, type WorkflowGateKind, type WorkflowGateNode, type WorkflowGatePolicy, type WorkflowGotoNode, type WorkflowJoinNode, type WorkflowJudgeNode, type WorkflowModuleSpec, type WorkflowNode, type WorkflowNodeKind, type WorkflowNodeOf, type WorkflowNodeTemplate, type WorkflowOperator, type WorkflowOption, type WorkflowPort, type WorkflowPosition, type WorkflowRegistry, type WorkflowSelection, type WorkflowSelector, type WorkflowStepNode, type WorkflowStepPreset, type WorkflowSubflowNode, type WorkflowVariant, type WorkflowVariantsNode, } from "./workflow/definition.js";
 export { WORKFLOW_PROBLEM_CODES, blockingProblems, checkDefinition, definitionAvailability, nodeAvailability, type WorkflowProblem, type WorkflowProblemCode, type WorkflowProblemLevel, } from "./workflow/problems.js";
 export { WORKFLOW_PACKAGE_FORMAT, WORKFLOW_PACKAGE_VERSION, diffDefinitions, exportWorkflowPackage, previewWorkflowImport, readWorkflowDefinition, readWorkflowPackage, requirementsOf, sameDefinition, type WorkflowDefinitionDiff, type WorkflowDiffEdge, type WorkflowDiffItem, type WorkflowDisabledNode, type WorkflowFlowDiff, type WorkflowImportSummary, type WorkflowModuleGap, type WorkflowPackage, type WorkflowReadError, type WorkflowReadResult, type WorkflowRequirements, } from "./workflow/portable.js";
 export { NODE_HEADER, NODE_WIDTH, PORT_ROW, arrangeFlow, layoutFlow, nodeSize, portRows, ranksOf, regionsOf, type WorkflowRegion, } from "./workflow/layout.js";
@@ -82,7 +84,7 @@ export { insertPaletteItem, paletteOf, type WorkflowPaletteGroup, type WorkflowP
 export { READABLE_ZOOM, WorkflowCanvas, type WorkflowCanvasProps, } from "./workflow/canvas/WorkflowCanvas.js";
 export { WorkflowPalette, type WorkflowPaletteProps } from "./workflow/editor/WorkflowPalette.js";
 export { WorkflowProblems, problemTarget, type WorkflowProblemsProps, } from "./workflow/editor/WorkflowProblems.js";
-export { ConditionEditor, GatePolicyEditor, WorkflowInspector, type WorkflowInspectorProps, } from "./workflow/editor/WorkflowInspector.js";
+export { ConditionEditor, GatePolicyEditor, WorkflowInspector, type WorkflowInspectorProps, type WorkflowNodeFieldsContext, } from "./workflow/editor/WorkflowInspector.js";
 export { WorkflowJsonView, type WorkflowJsonViewProps, } from "./workflow/editor/WorkflowJsonView.js";
 export { documentStatus, type WorkflowDocumentStatus, type WorkflowRevision, } from "./workflow/workspace.js";
 export { WorkflowDiff, type WorkflowDiffProps } from "./workflow/editor/WorkflowDiff.js";

package/dist/index.js

@@ -74,6 +74,7 @@ export { Popover, PopoverAnchor, PopoverContent, PopoverHeader, PopoverTrigger,
 export { Tabs, TabsContent, TabsList, TabsTrigger } from "./primitives/Tabs.js";
 export { Skeleton } from "./primitives/Skeleton.js";
 export { WorkflowCard, WorkflowCardSkeleton, } from "./workflow/WorkflowCard.js";
+export { WorkflowQuestionCard, } from "./workflow/WorkflowQuestionCard.js";
 export { ANY_FILTER, DEFAULT_WORKFLOW_FILTERS, filterWorkflows, isFiltered, } from "./workflow/gallery.js";
 export { WorkflowGallery, } from "./workflow/WorkflowGallery.js";
 export { ARTIFACT_TONE, GATE_TONE, RUN_STAGE_TONE, VERDICT_TONE, } from "./workflow/run.js";
@@ -84,7 +85,7 @@ export { ReviewPanel } from "./workflow/ReviewPanel.js";
 export { MediaReview, formatTimecode, } from "./workflow/MediaReview.js";
 export { DocumentReview, } from "./workflow/DocumentReview.js";
 export { FormReview, } from "./workflow/FormReview.js";
-export { IN, LOOP_IN, LOOP_OUT, OUT, WORKFLOW_DEFINITION_VERSION, WORKFLOW_NODE_KINDS, WORKFLOW_SELECTORS, addNode, canConnect, createNode, dataTypes, downstream, edgeId, exitLabel, exitsOf, findFact, findGateKind, findPreset, freshId, inputsOf, isJudge, moveNode, operatorsFor, outputsOf, portOf, removeEdge, removeNode, startOf, typeAccepts, updateEdge, updateNode, upstream, withFlow, } from "./workflow/definition.js";
+export { IN, LOOP_IN, LOOP_OUT, OUT, WORKFLOW_DEFINITION_VERSION, WORKFLOW_FLOW_NAME, WORKFLOW_MAX_FLOWS, WORKFLOW_NODE_KINDS, WORKFLOW_SELECTORS, addFlow, addNode, canConnect, createNode, dataTypes, downstream, edgeId, exitLabel, exitsOf, findFact, findGateKind, findPreset, flowNameProblem, freshId, inputsOf, isJudge, moveNode, operatorsFor, outputsOf, portOf, removeEdge, removeNode, renameFlow, startOf, typeAccepts, updateEdge, updateNode, upstream, withFlow, } from "./workflow/definition.js";
 export { WORKFLOW_PROBLEM_CODES, blockingProblems, checkDefinition, definitionAvailability, nodeAvailability, } from "./workflow/problems.js";
 export { WORKFLOW_PACKAGE_FORMAT, WORKFLOW_PACKAGE_VERSION, diffDefinitions, exportWorkflowPackage, previewWorkflowImport, readWorkflowDefinition, readWorkflowPackage, requirementsOf, sameDefinition, } from "./workflow/portable.js";
 export { NODE_HEADER, NODE_WIDTH, PORT_ROW, arrangeFlow, layoutFlow, nodeSize, portRows, ranksOf, regionsOf, } from "./workflow/layout.js";

package/dist/provider/messages.d.ts

@@ -1,7 +1,8 @@
 import type { ProductTheme } from "../appearance/product.js";
+import type { WorkflowQuestionState } from "../workflow/question.js";
 import type { WorkflowAction, WorkflowAvailability, WorkflowScope, WorkflowStatus } from "../workflow/model.js";
 import type { ArtifactStatus, GateStatus, ReviewDecision, ReviewVerdict, RunStageStatus } from "../workflow/run.js";
-import type { WorkflowConnectReason, WorkflowNode, WorkflowNodeKind, WorkflowSelector } from "../workflow/definition.js";
+import type { WorkflowConnectReason, WorkflowFlowNameProblem, WorkflowNode, WorkflowNodeKind, WorkflowSelector } from "../workflow/definition.js";
 /** The names a node's summary line uses, looked up by the caller. */
 export interface WorkflowSummaryNames {
     /** A step's or variants' preset, and its module. */
@@ -21,6 +22,23 @@ import type { WorkflowReadError } from "../workflow/portable.js";
  * it (plurals, numbers, word order).
  */
 export interface Messages {
+    workflowQuestion: {
+        title: string;
+        worker: (worker: string) => string;
+        state: (state: WorkflowQuestionState) => string;
+        description: (state: WorkflowQuestionState) => string;
+        loading: string;
+        empty: string;
+        answer: string;
+        answers: string;
+        otherAnswers: string;
+        multipleHint: string;
+        invalidAnswer: string;
+        readOnly: string;
+        send: string;
+        sending: string;
+        refresh: string;
+    };
     shell: {
         skipToContent: string;
         /** The mobile button and drawer title for the sidebar. */
@@ -376,6 +394,22 @@ export interface Messages {
         importing: string;
         importedNotice: string;
         importAvailability: (status: WorkflowAvailability["status"]) => string;
+        newFlow: string;
+        newFlowTitle: string;
+        newFlowDescription: string;
+        createFlow: string;
+        renameFlow: string;
+        renameFlowTitle: (name: string) => string;
+        renameFlowDescription: string;
+        rename: string;
+        flowName: string;
+        flowNameHint: string;
+        flowLabel: string;
+        flowLabelHint: string;
+        flowNameProblem: (problem: WorkflowFlowNameProblem) => string;
+        flowsFull: (max: number) => string;
+        flowCreatedNotice: (name: string) => string;
+        flowRenamedNotice: (name: string) => string;
         modules: string;
         noModules: string;
         moduleStatus: (status: "available" | "missing" | "version" | "unavailable", installed?: string) => string;

package/dist/provider/messages.js

@@ -144,6 +144,39 @@ function problemText({ code, values: v }) {
     }
 }
 export const defaultMessages = {
+    workflowQuestion: {
+        title: "Question for this run",
+        worker: (worker) => `Worker: ${worker}`,
+        state: (state) => ({
+            waiting: "Waiting for an answer",
+            submitting: "Sending answer",
+            accepted: "Answer sent",
+            acknowledged: "Worker acknowledged",
+            expired: "Answer window closed",
+            "delivery-unknown": "Delivery unconfirmed",
+            unavailable: "Question unavailable",
+        })[state],
+        description: (state) => ({
+            waiting: "Answer the questions below to continue this task.",
+            submitting: "Sending your answer to this task.",
+            accepted: "Waiting for the worker to acknowledge your answer.",
+            acknowledged: "The worker acknowledged this answer.",
+            expired: "This question can no longer accept an answer.",
+            "delivery-unknown": "Check delivery before sending another answer.",
+            unavailable: "The current question could not be read. Check again to continue.",
+        })[state],
+        loading: "Loading question…",
+        empty: "Nothing needs an answer right now.",
+        answer: "Answer",
+        answers: "Answers",
+        otherAnswers: "Additional answers",
+        multipleHint: "Choose options or enter additional answers on separate lines. Up to eight answers.",
+        invalidAnswer: "Answer each question with up to 4,000 characters per answer. Multiple answers must be distinct, with no more than eight.",
+        readOnly: "An operator can provide these answers.",
+        send: "Send answer",
+        sending: "Sending answer…",
+        refresh: "Check delivery",
+    },
     shell: {
         skipToContent: "Skip to content",
         navigation: "Navigation",
@@ -567,6 +600,26 @@ export const defaultMessages = {
         importAction: "Import",
         importing: "Importing",
         importedNotice: "Imported.",
+        newFlow: "New flow",
+        newFlowTitle: "New flow",
+        newFlowDescription: "An empty flow beside the others. A sub-flow node runs it.",
+        createFlow: "Create flow",
+        renameFlow: "Rename flow",
+        renameFlowTitle: (name) => `Rename ${name}`,
+        renameFlowDescription: "Sub-flow nodes that run it, and the main flow, follow the new name.",
+        rename: "Rename",
+        flowName: "Name",
+        flowNameHint: "Lowercase letters, digits and dashes, starting with a letter. Up to 32.",
+        flowLabel: "Label",
+        flowLabelHint: "How the flow is shown. Its name when empty.",
+        flowNameProblem: (problem) => ({
+            empty: "Give the flow a name.",
+            format: "Use lowercase letters, digits and dashes, starting with a letter, up to 32.",
+            taken: "Another flow has this name.",
+        })[problem],
+        flowsFull: (max) => `A workflow holds at most ${count(max)} flows.`,
+        flowCreatedNotice: (name) => `Flow ${name} created.`,
+        flowRenamedNotice: (name) => `Flow renamed to ${name}.`,
         importAvailability: (status) => ({
             available: "Runs here",
             "missing-capabilities": "Missing capabilities here",

package/dist/workflow/WorkflowQuestionCard.d.ts

@@ -0,0 +1,18 @@
+import * as React from "react";
+import type { WorkflowQuestion, WorkflowQuestionAnswers, WorkflowQuestionState, WorkflowQuestionSubmission } from "./question.js";
+export interface WorkflowQuestionCardProps {
+    question: WorkflowQuestion | null;
+    state: WorkflowQuestionState;
+    answers?: WorkflowQuestionAnswers;
+    onAnswersChange?: (answers: WorkflowQuestionAnswers) => void;
+    /** Synchronous intent notification. Set the controlled state before starting delivery. */
+    onSubmit?: (submission: WorkflowQuestionSubmission) => void;
+    /** Read current delivery state. This action never submits an answer. */
+    onRefresh?: () => void;
+    canAnswer?: boolean;
+    reason?: string;
+    loading?: boolean;
+    className?: string;
+}
+/** Controlled projection: a submit callback is never evidence of runtime acknowledgment. */
+export declare function WorkflowQuestionCard(props: WorkflowQuestionCardProps): React.JSX.Element;

package/dist/workflow/WorkflowQuestionCard.js

@@ -0,0 +1,78 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { cn } from "../lib/cn.js";
+import { Button } from "../primitives/Button.js";
+import { Checkbox } from "../primitives/Checkbox.js";
+import { Field } from "../primitives/Field.js";
+import { Textarea } from "../primitives/Textarea.js";
+import { Skeleton } from "../primitives/Skeleton.js";
+import { useUI } from "../provider/UIProvider.js";
+import { StatusBadge } from "../status/StatusBadge.js";
+const TONE = {
+    waiting: "warn",
+    submitting: "info",
+    accepted: "info",
+    acknowledged: "ok",
+    expired: "muted",
+    "delivery-unknown": "warn",
+    unavailable: "error",
+};
+function textValid(value) {
+    return value.trim().length > 0 && Array.from(value).length <= 4000 && !value.includes("\0");
+}
+function answerValid(field, value) {
+    if (field.multiple)
+        return (value !== undefined &&
+            typeof value !== "string" &&
+            value.length > 0 &&
+            value.length <= 8 &&
+            new Set(value).size === value.length &&
+            value.every(textValid));
+    return typeof value === "string" && textValid(value);
+}
+/** Controlled projection: a submit callback is never evidence of runtime acknowledgment. */
+export function WorkflowQuestionCard(props) {
+    return (_jsx(QuestionBody, { ...props }, JSON.stringify([props.question?.id, props.question?.revision])));
+}
+function QuestionBody({ question, state, answers = {}, onAnswersChange, onSubmit, onRefresh, canAnswer = true, reason, loading = false, className, }) {
+    const t = useUI().messages.workflowQuestion;
+    const id = React.useId();
+    const [attempted, setAttempted] = React.useState(false);
+    const editable = !loading && state === "waiting" && canAnswer && !!onSubmit && !!onAnswersChange;
+    const set = (field, value) => {
+        if (editable)
+            onAnswersChange?.({ ...answers, [field]: value });
+    };
+    const submit = (event) => {
+        event.preventDefault();
+        if (!editable || !question?.fields.length)
+            return;
+        setAttempted(true);
+        if (question.fields.some((field) => !answerValid(field, answers[field.id])))
+            return;
+        const selected = Object.fromEntries(question.fields.map((field) => {
+            const value = answers[field.id];
+            return [field.id, typeof value === "string" ? value : [...value]];
+        }));
+        onSubmit?.({ questionId: question.id, revision: question.revision, answers: selected });
+    };
+    return (_jsxs("section", { "data-slot": "workflow-question-card", "aria-labelledby": `${id}-title`, "aria-busy": loading || state === "submitting", className: cn("space-y-4 rounded-lg border bg-card p-4 text-card-foreground", className), children: [_jsxs("div", { className: "flex flex-wrap items-start justify-between gap-3", children: [_jsxs("div", { className: "min-w-0 space-y-1", children: [_jsx("h3", { id: `${id}-title`, className: "font-medium break-words", children: question?.title ?? t.title }), question?.worker && (_jsx("p", { className: "text-sm text-muted-foreground", children: t.worker(question.worker) }))] }), !loading && (_jsx(StatusBadge, { tone: TONE[state], pulse: state === "submitting" || state === "accepted", children: t.state(state) }))] }), _jsx("p", { role: "status", className: "text-sm text-muted-foreground", children: loading ? t.loading : t.description(state) }), reason && _jsx("p", { className: "text-sm text-muted-foreground", children: reason }), loading ? (_jsxs("div", { className: "space-y-3", children: [_jsx(Skeleton, { className: "h-5 w-1/2" }), _jsx(Skeleton, { className: "h-20 w-full" })] })) : !question?.fields.length ? (state === "waiting" ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t.empty })) : null) : (_jsxs("form", { onSubmit: submit, noValidate: true, className: "space-y-5", children: [question.fields.map((field, index) => {
+                        const value = answers[field.id];
+                        const selected = value !== undefined && typeof value !== "string" ? value : [];
+                        const labels = new Set(field.options?.map((option) => option.label));
+                        const custom = selected.filter((answer) => !labels.has(answer));
+                        const error = attempted && !answerValid(field, value) ? t.invalidAnswer : undefined;
+                        return (_jsxs("fieldset", { disabled: !editable, className: "min-w-0 space-y-3", children: [_jsx("legend", { className: "mb-3 text-sm font-medium break-words whitespace-pre-wrap", children: field.text }), !!field.options?.length && (_jsx("div", { className: "flex flex-wrap gap-2", children: field.options.map((option, optionIndex) => field.multiple ? (_jsxs("label", { htmlFor: `${id}-${index}-${optionIndex}`, className: "flex max-w-full min-w-0 items-start gap-2 rounded-lg border p-2 text-sm", children: [_jsx(Checkbox, { id: `${id}-${index}-${optionIndex}`, disabled: !editable, checked: selected.includes(option.label), onCheckedChange: (checked) => set(field.id, checked === true
+                                                    ? [
+                                                        ...selected.filter((answer) => answer !== option.label),
+                                                        option.label,
+                                                    ]
+                                                    : selected.filter((answer) => answer !== option.label)) }), _jsxs("span", { className: "min-w-0 break-words", children: [option.label, option.description && (_jsxs("span", { className: "mt-1 block text-xs text-muted-foreground", children: [" ", option.description] }))] })] }, option.label)) : (_jsx(Button, { type: "button", variant: "outline", disabled: !editable, className: "h-auto max-w-full min-w-0 py-2 text-left", "aria-pressed": value === option.label, onClick: () => set(field.id, option.label), children: _jsxs("span", { className: "min-w-0 break-words whitespace-normal", children: [option.label, option.description && (_jsxs("span", { className: "mt-1 block text-xs text-muted-foreground", children: [" ", option.description] }))] }) }, option.label))) })), _jsx(Field, { label: field.multiple ? (field.options?.length ? t.otherAnswers : t.answers) : t.answer, hint: field.multiple ? t.multipleHint : undefined, error: error, children: _jsx(Textarea, { readOnly: !editable, disabled: !editable, rows: 3, value: field.multiple ? custom.join("\n") : typeof value === "string" ? value : "", onChange: (event) => set(field.id, field.multiple
+                                            ? [
+                                                ...selected.filter((answer) => labels.has(answer)),
+                                                ...(event.target.value === "" ? [] : event.target.value.split("\n")),
+                                            ]
+                                            : event.target.value) }) })] }, field.id));
+                    }), !canAnswer && state === "waiting" && !reason && (_jsx("p", { className: "text-sm text-muted-foreground", children: t.readOnly })), onSubmit && (state === "waiting" || state === "submitting") && (_jsx(Button, { type: "submit", disabled: !editable, children: state === "submitting" ? t.sending : t.send }))] })), onRefresh && (state === "delivery-unknown" || state === "unavailable") && (_jsx(Button, { type: "button", variant: "outline", onClick: onRefresh, children: t.refresh }))] }));
+}

package/dist/workflow/canvas/WorkflowCanvas.js

@@ -191,6 +191,35 @@ function CanvasInner({ definition, flow: flowProp, registry, onChange, readOnly:
         const y = b.height * zoom <= h - pad * 2 ? (h - b.height * zoom) / 2 - b.y * zoom : pad - b.y * zoom;
         void view.setViewport({ x, y, zoom });
     }, [view]);
+    /**
+     * Centers a node that is out of view at the current zoom. `whole`: unless
+     * all of it shows (a deep link); otherwise unless its middle shows, so
+     * choosing a node at the edge does not move the canvas.
+     */
+    const reveal = React.useCallback((id, whole = false) => {
+        const el = pane.current;
+        const n = view.getInternalNode(id);
+        if (!el || !n || !el.clientWidth || !el.clientHeight)
+            return;
+        const { x, y, zoom } = view.getViewport();
+        const w = n.measured.width ?? 0;
+        const h = n.measured.height ?? 0;
+        const left = n.internals.positionAbsolute.x * zoom + x;
+        const top = n.internals.positionAbsolute.y * zoom + y;
+        const [x0, y0, x1, y1] = whole
+            ? [left, top, left + w * zoom, top + h * zoom]
+            : [
+                left + (w * zoom) / 2,
+                top + (h * zoom) / 2,
+                left + (w * zoom) / 2,
+                top + (h * zoom) / 2,
+            ];
+        if (x0 >= 0 && y0 >= 0 && x1 <= el.clientWidth && y1 <= el.clientHeight)
+            return;
+        const cx = n.internals.positionAbsolute.x + w / 2;
+        const cy = n.internals.positionAbsolute.y + h / 2;
+        void view.setCenter(cx, cy, { zoom });
+    }, [view]);
     const flowName = flowProp && definition.flows[flowProp] ? flowProp : definition.main;
     const flow = definition.flows[flowName] ?? EMPTY_FLOW;
     const readOnly = readOnlyProp || !onChange;
@@ -218,6 +247,17 @@ function CanvasInner({ definition, flow: flowProp, registry, onChange, readOnly:
     const selectedNode = selection?.type === "node" && selection.flow === flowName
         ? flow.nodes.find((n) => n.id === selection.id)
         : undefined;
+    // A node selected from outside the canvas (a deep link, a problem) comes into view.
+    const selectedId = selectedNode?.id;
+    React.useEffect(() => {
+        if (selectedId)
+            reveal(selectedId);
+    }, [selectedId, reveal]);
+    const init = React.useCallback(() => {
+        place();
+        if (selectedId)
+            reveal(selectedId, true);
+    }, [place, reveal, selectedId]);
     const selectedEdge = selection?.type === "edge" && selection.flow === flowName
         ? flow.edges.find((e) => edgeId(e) === selection.id)
         : undefined;
@@ -624,7 +664,7 @@ function CanvasInner({ definition, flow: flowProp, registry, onChange, readOnly:
                                                                 : m.kind(item.template.kind)), item.available ? null : (_jsx("span", { className: "ml-auto text-2xs text-muted-foreground", children: m.notRun }))] }, item.key)))] }, g.key))) })] }), _jsxs(Button, { size: "sm", variant: "outline", disabled: !selectedNode, onClick: () => setConnecting(true), children: [_jsx(CableIcon, { "aria-hidden": true }), m.connectAction] }), _jsxs(Button, { size: "sm", variant: "outline", disabled: !selectedNode && !selectedEdge, onClick: () => remove(selectedNode ? [selectedNode.id] : [], selectedEdge ? [edgeId(selectedEdge)] : []), children: [_jsx(Trash2Icon, { "aria-hidden": true }), m.deleteSelection] }), _jsxs(Button, { size: "sm", variant: "outline", disabled: !flow.nodes.length, onClick: () => {
                                     change(arrangeFlow(flow, registry, definition));
                                     window.requestAnimationFrame(place);
-                                }, children: [_jsx(LayoutGridIcon, { "aria-hidden": true }), m.arrange] })] })), _jsxs("span", { className: "ml-auto flex items-center gap-1", children: [_jsx(Button, { size: "icon-sm", variant: "ghost", "aria-label": m.zoomOut, title: m.zoomOut, onClick: () => void view.zoomOut(), children: _jsx(ZoomOutIcon, { "aria-hidden": true }) }), _jsx(Button, { size: "icon-sm", variant: "ghost", "aria-label": m.zoomIn, title: m.zoomIn, onClick: () => void view.zoomIn(), children: _jsx(ZoomInIcon, { "aria-hidden": true }) }), _jsx(Button, { size: "icon-sm", variant: "ghost", "aria-label": m.fit, title: m.fit, onClick: place, children: _jsx(MaximizeIcon, { "aria-hidden": true }) })] })] }), _jsx("div", { ref: pane, className: "relative min-h-0 flex-1", children: _jsx(ReactFlow, { nodes: nodes, edges: built.edges, nodeTypes: NODE_TYPES, onInit: place, minZoom: READABLE_ZOOM, maxZoom: 1.5, panOnScroll: true, snapToGrid: true, snapGrid: [GRID, GRID], nodesDraggable: !readOnly, nodesConnectable: !readOnly, nodesFocusable: true, edgesFocusable: true, elementsSelectable: true, multiSelectionKeyCode: null, selectionKeyCode: null, deleteKeyCode: readOnly ? null : ["Backspace", "Delete"], ariaLabelConfig: {
+                                }, children: [_jsx(LayoutGridIcon, { "aria-hidden": true }), m.arrange] })] })), _jsxs("span", { className: "ml-auto flex items-center gap-1", children: [_jsx(Button, { size: "icon-sm", variant: "ghost", "aria-label": m.zoomOut, title: m.zoomOut, onClick: () => void view.zoomOut(), children: _jsx(ZoomOutIcon, { "aria-hidden": true }) }), _jsx(Button, { size: "icon-sm", variant: "ghost", "aria-label": m.zoomIn, title: m.zoomIn, onClick: () => void view.zoomIn(), children: _jsx(ZoomInIcon, { "aria-hidden": true }) }), _jsx(Button, { size: "icon-sm", variant: "ghost", "aria-label": m.fit, title: m.fit, onClick: place, children: _jsx(MaximizeIcon, { "aria-hidden": true }) })] })] }), _jsx("div", { ref: pane, className: "relative min-h-0 flex-1", children: _jsx(ReactFlow, { nodes: nodes, edges: built.edges, nodeTypes: NODE_TYPES, onInit: init, minZoom: READABLE_ZOOM, maxZoom: 1.5, panOnScroll: true, snapToGrid: true, snapGrid: [GRID, GRID], nodesDraggable: !readOnly, nodesConnectable: !readOnly, nodesFocusable: true, edgesFocusable: true, elementsSelectable: true, multiSelectionKeyCode: null, selectionKeyCode: null, deleteKeyCode: readOnly ? null : ["Backspace", "Delete"], ariaLabelConfig: {
                         "node.a11yDescription.default": m.nodeHelp,
                         "node.a11yDescription.keyboardDisabled": m.nodeHelp,
                         "node.a11yDescription.ariaLiveMessage": ({ direction, x, y }) => m.movedLive(direction, x, y),

package/dist/workflow/definition.d.ts

@@ -405,4 +405,24 @@ export interface WorkflowSelection {
     flow: string;
     id: string;
 }
+/** A flow's name, its key in `flows`: a lowercase slug of up to 32 characters ("build", "escalation"). */
+export declare const WORKFLOW_FLOW_NAME: RegExp;
+/** The most flows one definition holds. */
+export declare const WORKFLOW_MAX_FLOWS = 20;
+/** Why a flow name is refused. The editor's copy names each one. */
+export type WorkflowFlowNameProblem = "empty" | "format" | "taken";
+/**
+ * Whether `name` can name a flow of the definition: a slug by
+ * `WORKFLOW_FLOW_NAME` that no other flow has. `current` is the flow being
+ * renamed, which may keep its own name. Null when it can.
+ */
+export declare function flowNameProblem(definition: WorkflowDefinition, name: string, current?: string): WorkflowFlowNameProblem | null;
+/** The definition with a new, empty flow. A label that is empty is left out. */
+export declare function addFlow(definition: WorkflowDefinition, name: string, label?: string): WorkflowDefinition;
+/**
+ * Renames a flow everywhere the definition names it: its key, `main`, and
+ * the sub-flow nodes that run it. `label` replaces the flow's label; an empty
+ * one removes it; omitted, the label stays. Flows keep their order.
+ */
+export declare function renameFlow(definition: WorkflowDefinition, from: string, to: string, label?: string): WorkflowDefinition;
 export {};

package/dist/workflow/definition.js

@@ -409,3 +409,47 @@ export function updateEdge(flow, id, patch) {
 export function withFlow(definition, name, flow) {
     return { ...definition, flows: { ...definition.flows, [name]: flow } };
 }
+// ---------------------------------------------------------------- flows
+/** A flow's name, its key in `flows`: a lowercase slug of up to 32 characters ("build", "escalation"). */
+export const WORKFLOW_FLOW_NAME = /^[a-z][a-z0-9-]{0,31}$/;
+/** The most flows one definition holds. */
+export const WORKFLOW_MAX_FLOWS = 20;
+/**
+ * Whether `name` can name a flow of the definition: a slug by
+ * `WORKFLOW_FLOW_NAME` that no other flow has. `current` is the flow being
+ * renamed, which may keep its own name. Null when it can.
+ */
+export function flowNameProblem(definition, name, current) {
+    if (!name)
+        return "empty";
+    if (!WORKFLOW_FLOW_NAME.test(name))
+        return "format";
+    if (name !== current && Object.hasOwn(definition.flows, name))
+        return "taken";
+    return null;
+}
+/** The definition with a new, empty flow. A label that is empty is left out. */
+export function addFlow(definition, name, label) {
+    const flow = { ...(label ? { label } : {}), nodes: [], edges: [] };
+    return withFlow(definition, name, flow);
+}
+/**
+ * Renames a flow everywhere the definition names it: its key, `main`, and
+ * the sub-flow nodes that run it. `label` replaces the flow's label; an empty
+ * one removes it; omitted, the label stays. Flows keep their order.
+ */
+export function renameFlow(definition, from, to, label) {
+    if (!definition.flows[from])
+        return definition;
+    const flows = {};
+    for (const [name, f] of Object.entries(definition.flows)) {
+        const nodes = f.nodes.map((n) => n.kind === "subflow" && n.flow === from ? { ...n, flow: to } : n);
+        let flow = { ...f, nodes };
+        if (name === from && label !== undefined) {
+            const { label: _old, ...rest } = flow;
+            flow = label ? { ...rest, label } : rest;
+        }
+        flows[name === from ? to : name] = flow;
+    }
+    return { ...definition, main: definition.main === from ? to : definition.main, flows };
+}

package/dist/workflow/editor/WorkflowInspector.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import { type WorkflowCondition, type WorkflowDefinition, type WorkflowFlow, type WorkflowGatePolicy, type WorkflowRegistry, type WorkflowSelection } from "../definition.js";
+import { type WorkflowCondition, type WorkflowDefinition, type WorkflowFlow, type WorkflowGatePolicy, type WorkflowNode, type WorkflowRegistry, type WorkflowSelection } from "../definition.js";
 export interface WorkflowInspectorProps {
     definition: WorkflowDefinition;
     registry: WorkflowRegistry;
@@ -9,8 +9,25 @@ export interface WorkflowInspectorProps {
     /** After a delete from the inspector, the selection is cleared through this. */
     onSelectionChange?: (selection: WorkflowSelection | null) => void;
     readOnly?: boolean;
+    /**
+     * The host's own fields for the selected node, after the fields of its
+     * kind: a runner picker, what a step inherits. Switch on `node.kind`;
+     * return null to add nothing. It is called while the inspector renders, so
+     * fields that need hooks go in a component it returns.
+     */
+    renderNodeFields?: (context: WorkflowNodeFieldsContext) => React.ReactNode;
     className?: string;
 }
+/** What the inspector hands `renderNodeFields`. */
+export interface WorkflowNodeFieldsContext {
+    node: WorkflowNode;
+    /** The flow the node is in. */
+    flow: string;
+    definition: WorkflowDefinition;
+    /** Patches the node, as the inspector's own fields do. Does nothing when read only. */
+    onChange: (patch: Partial<WorkflowNode>) => void;
+    readOnly: boolean;
+}
 /** One comparison on a run fact: the fact, its node when it is a node's, the operator and the value. */
 export declare function ConditionEditor({ condition, onChange, flow, registry, label, disabled, }: {
     condition: WorkflowCondition;
@@ -34,7 +51,8 @@ export declare function GatePolicyEditor({ policy, onChange, registry, approvers
  * The selected node's or connection's fields, edited in place: per-kind
  * fields, a condition editor over the host's facts and operators, a gate
  * policy editor (roles, members, quorum, timeout), and the host's model,
- * harness and effort pickers. With nothing selected, the workflow's name and
+ * harness and effort pickers, then any fields the host adds for the node
+ * (`renderNodeFields`). With nothing selected, the workflow's name and
  * description. Every edit goes out as the whole next definition.
  */
-export declare function WorkflowInspector({ definition, registry, selection, onChange, onSelectionChange, readOnly, className, }: WorkflowInspectorProps): React.JSX.Element;
+export declare function WorkflowInspector({ definition, registry, selection, onChange, onSelectionChange, readOnly, renderNodeFields, className, }: WorkflowInspectorProps): React.JSX.Element;

package/dist/workflow/editor/WorkflowInspector.js

@@ -149,10 +149,11 @@ function PortsEditor({ legend, ports, onChange, registry, disabled, }) {
  * The selected node's or connection's fields, edited in place: per-kind
  * fields, a condition editor over the host's facts and operators, a gate
  * policy editor (roles, members, quorum, timeout), and the host's model,
- * harness and effort pickers. With nothing selected, the workflow's name and
+ * harness and effort pickers, then any fields the host adds for the node
+ * (`renderNodeFields`). With nothing selected, the workflow's name and
  * description. Every edit goes out as the whole next definition.
  */
-export function WorkflowInspector({ definition, registry, selection = null, onChange, onSelectionChange, readOnly = false, className, }) {
+export function WorkflowInspector({ definition, registry, selection = null, onChange, onSelectionChange, readOnly = false, renderNodeFields, className, }) {
     const { messages } = useUI();
     const m = messages.editor;
     const disabled = readOnly || !onChange;
@@ -165,7 +166,14 @@ export function WorkflowInspector({ definition, registry, selection = null, onCh
     let title;
     if (node) {
         title = m.inspectorFor(m.kind(node.kind), node.label);
-        body = (_jsx(NodeFields, { node: node, flow: flow, definition: definition, registry: registry, disabled: disabled, onPatch: (patch) => setFlow(updateNode(flow, node.id, patch)), onDelete: () => {
+        const patch = (p) => setFlow(updateNode(flow, node.id, p));
+        body = (_jsx(NodeFields, { node: node, flow: flow, definition: definition, registry: registry, disabled: disabled, host: renderNodeFields?.({
+                node,
+                flow: flowName,
+                definition,
+                onChange: disabled ? () => { } : patch,
+                readOnly: disabled,
+            }), onPatch: patch, onDelete: () => {
                 setFlow(removeNode(flow, node.id));
                 onSelectionChange?.(null);
             } }));
@@ -187,7 +195,7 @@ export function WorkflowInspector({ definition, registry, selection = null, onCh
     }
     return (_jsxs("section", { "aria-label": m.inspector, "data-slot": "workflow-inspector", className: cn("flex min-h-0 flex-col gap-3", className), children: [_jsx("h2", { className: "truncate text-sm font-medium", children: title }), _jsx("div", { className: "flex min-h-0 flex-col gap-4 overflow-y-auto pb-2", children: body })] }));
 }
-function NodeFields({ node, flow, definition, registry, disabled, onPatch, onDelete, }) {
+function NodeFields({ node, flow, definition, registry, disabled, host, onPatch, onDelete, }) {
     const { messages } = useUI();
     const m = messages.editor;
     const presetOptions = registry.modules.flatMap((mod) => mod.presets.map((p) => ({ value: `${mod.id}/${p.id}`, label: `${mod.label} · ${p.label}` })));
@@ -327,7 +335,7 @@ function NodeFields({ node, flow, definition, registry, disabled, onPatch, onDel
             fields = (_jsxs(_Fragment, { children: [_jsx(Field, { label: m.question, children: _jsx(Textarea, { value: node.question, disabled: disabled, onChange: (e) => onPatch({ question: e.target.value }) }) }), _jsx(Field, { label: m.yesAt, children: _jsx(PercentInput, { value: node.threshold, disabled: disabled, onValue: (threshold) => onPatch({ threshold: threshold ?? 0.5 }) }) })] }));
             break;
     }
-    return (_jsxs("div", { className: "flex flex-col gap-4", children: [common, fields, _jsx(Field, { label: m.note, children: _jsx(Textarea, { value: node.note ?? "", disabled: disabled, onChange: (e) => onPatch({ note: e.target.value || undefined }) }) }), disabled ? null : (_jsxs(Button, { type: "button", variant: "destructive", size: "sm", className: "self-start", onClick: onDelete, children: [_jsx(Trash2Icon, { "aria-hidden": true }), m.deleteNode(node.label)] }))] }));
+    return (_jsxs("div", { className: "flex flex-col gap-4", children: [common, fields, host == null || host === false ? null : (_jsx("div", { "data-slot": "workflow-inspector-host-fields", className: "flex flex-col gap-4", children: host })), _jsx(Field, { label: m.note, children: _jsx(Textarea, { value: node.note ?? "", disabled: disabled, onChange: (e) => onPatch({ note: e.target.value || undefined }) }) }), disabled ? null : (_jsxs(Button, { type: "button", variant: "destructive", size: "sm", className: "self-start", onClick: onDelete, children: [_jsx(Trash2Icon, { "aria-hidden": true }), m.deleteNode(node.label)] }))] }));
 }
 /** A preset's contract, read from the registry. */
 function PortSummary({ node, definition, registry, }) {

package/dist/workflow/editor/WorkflowWorkspace.d.ts

@@ -1,7 +1,8 @@
 import * as React from "react";
-import type { WorkflowDefinition, WorkflowRegistry } from "../definition.js";
+import { type WorkflowDefinition, type WorkflowRegistry, type WorkflowSelection } from "../definition.js";
 import { type WorkflowImportSummary as ImportPreview } from "../portable.js";
 import { type WorkflowRevision } from "../workspace.js";
+import { type WorkflowInspectorProps } from "./WorkflowInspector.js";
 /** A host action: may return a promise; a rejection's message is shown. */
 type HostAction<A extends unknown[]> = (...args: A) => Promise<unknown> | unknown;
 export interface WorkflowWorkspaceProps {
@@ -26,6 +27,28 @@ export interface WorkflowWorkspaceProps {
     importPreview?: ImportPreview | null;
     onImportConfirm?: HostAction<[]>;
     onImportCancel?: () => void;
+    /**
+     * What is selected, held by the host: a deep link to a node opens its flow
+     * with the node selected and in view. Uncontrolled when omitted.
+     */
+    selection?: WorkflowSelection | null;
+    /** Where the editor opens when the host does not hold the selection. */
+    defaultSelection?: WorkflowSelection | null;
+    onSelectionChange?: (selection: WorkflowSelection | null) => void;
+    /**
+     * Offers New flow. The workspace asks for a name (`WORKFLOW_FLOW_NAME`, not
+     * taken) and an optional label, and hands the host the definition with the
+     * flow added. The host applies it, with anything it keeps beside it.
+     */
+    onFlowCreate?: HostAction<[definition: WorkflowDefinition, name: string]>;
+    /**
+     * Offers Rename flow, for the open flow. The definition handed over has the
+     * flow renamed everywhere it names it (`renameFlow`): its key, `main` and
+     * the sub-flow nodes that run it. Anything else that names flows is the host's.
+     */
+    onFlowRename?: HostAction<[definition: WorkflowDefinition, from: string, to: string]>;
+    /** The host's own fields for the selected node in the inspector. */
+    renderNodeFields?: WorkflowInspectorProps["renderNodeFields"];
     readOnly?: boolean;
     loading?: boolean;
     error?: string | {
@@ -42,8 +65,10 @@ export interface WorkflowWorkspaceProps {
  * there are no edits, and when the saved revision moves under unsaved edits
  * it stops and asks (use theirs, keep mine, compare). Publishing shows the
  * draft against live first and is held while anything blocks. Save, publish,
- * save as, import and export are the host's; it never persists anything. On
- * narrow containers the palette and the side panel open as drawers.
+ * save as, import and export are the host's; it never persists anything. A
+ * host may hold the selection (deep links), let people add and rename flows,
+ * and add its own fields to the inspector. On narrow containers the palette
+ * and the side panel open as drawers.
  */
 export declare function WorkflowWorkspace(props: WorkflowWorkspaceProps): React.JSX.Element;
 export {};

package/dist/workflow/editor/WorkflowWorkspace.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { CopyPlusIcon, DownloadIcon, ListTreeIcon, PanelRightIcon, RocketIcon, SaveIcon, UndoIcon, UploadIcon, } from "lucide-react";
+import { CopyPlusIcon, DownloadIcon, ListTreeIcon, PanelRightIcon, PencilIcon, PlusIcon, RocketIcon, SaveIcon, UndoIcon, UploadIcon, } from "lucide-react";
 import * as React from "react";
 import { cn } from "../../lib/cn.js";
 import { ConfirmDialog } from "../../overlays/ConfirmDialog.js";
@@ -16,6 +16,7 @@ import { ErrorState } from "../../states/ErrorState.js";
 import { LoadingState } from "../../states/LoadingState.js";
 import { StatusBadge } from "../../status/StatusBadge.js";
 import { WorkflowCanvas } from "../canvas/WorkflowCanvas.js";
+import { WORKFLOW_MAX_FLOWS, addFlow, flowNameProblem, renameFlow, } from "../definition.js";
 import { insertPaletteItem } from "../palette.js";
 import { diffDefinitions, sameDefinition, } from "../portable.js";
 import { blockingProblems, checkDefinition } from "../problems.js";
@@ -26,6 +27,7 @@ import { WorkflowInspector } from "./WorkflowInspector.js";
 import { WorkflowJsonView } from "./WorkflowJsonView.js";
 import { WorkflowPalette } from "./WorkflowPalette.js";
 import { WorkflowProblems } from "./WorkflowProblems.js";
+const sameSelection = (a, b) => a === b || (!!a && !!b && a.type === b.type && a.flow === b.flow && a.id === b.id);
 const messageOf = (e) => (e instanceof Error ? e.message : typeof e === "string" ? e : "");
 /**
  * The whole editor on one page: the palette, the canvas and a side panel
@@ -35,8 +37,10 @@ const messageOf = (e) => (e instanceof Error ? e.message : typeof e === "string"
  * there are no edits, and when the saved revision moves under unsaved edits
  * it stops and asks (use theirs, keep mine, compare). Publishing shows the
  * draft against live first and is held while anything blocks. Save, publish,
- * save as, import and export are the host's; it never persists anything. On
- * narrow containers the palette and the side panel open as drawers.
+ * save as, import and export are the host's; it never persists anything. A
+ * host may hold the selection (deep links), let people add and rename flows,
+ * and add its own fields to the inspector. On narrow containers the palette
+ * and the side panel open as drawers.
  */
 export function WorkflowWorkspace(props) {
     const { messages } = useUI();
@@ -46,14 +50,22 @@ export function WorkflowWorkspace(props) {
         return (_jsx(ErrorState, { variant: "page", title: messages.workspace.loadFailed, error: props.error ?? null, onRetry: props.onRetry, className: props.className }));
     return _jsx(Workspace, { ...props, definition: props.definition });
 }
-function Workspace({ definition, onChange, registry, saved = null, published = null, onSave, onPublish, onSaveAs, onExport, onImport, importPreview = null, onImportConfirm, onImportCancel, readOnly: readOnlyProp = false, className, }) {
+function Workspace({ definition, onChange, registry, saved = null, published = null, onSave, onPublish, onSaveAs, onExport, onImport, importPreview = null, onImportConfirm, onImportCancel, selection: selectionProp, defaultSelection = null, onSelectionChange, onFlowCreate, onFlowRename, renderNodeFields, readOnly: readOnlyProp = false, className, }) {
     const { messages } = useUI();
     const m = messages.workspace;
     const readOnly = readOnlyProp || !onChange;
     const [base, setBase] = React.useState(saved ?? published);
-    const [flowName, setFlowName] = React.useState(definition.main);
+    const [ownSelection, setOwnSelection] = React.useState(defaultSelection);
+    const selection = selectionProp === undefined ? ownSelection : selectionProp;
+    const [flowName, setFlowName] = React.useState(selection?.flow ?? definition.main);
     const flow = definition.flows[flowName] ? flowName : definition.main;
-    const [selection, setSelection] = React.useState(null);
+    // A selection in another flow (the host's, or a problem's) opens that flow.
+    const [shown, setShown] = React.useState(selection);
+    if (!sameSelection(shown, selection)) {
+        setShown(selection);
+        if (selection && selection.flow !== flowName)
+            setFlowName(selection.flow);
+    }
     const [panel, setPanel] = React.useState("inspector");
     const [drawer, setDrawer] = React.useState(null);
     const [dialog, setDialog] = React.useState(null);
@@ -103,9 +115,15 @@ function Workspace({ definition, onChange, registry, saved = null, published = n
         }
     };
     const select = (s) => {
-        setSelection(s);
-        if (s && s.flow !== flow)
-            setFlowName(s.flow);
+        if (sameSelection(s, selection))
+            return;
+        if (selectionProp === undefined)
+            setOwnSelection(s);
+        onSelectionChange?.(s);
+    };
+    const openFlow = (next) => {
+        setFlowName(next);
+        select(null);
     };
     const add = (item) => {
         const label = item.label ||
@@ -120,7 +138,7 @@ function Workspace({ definition, onChange, registry, saved = null, published = n
     const flows = Object.entries(definition.flows);
     const edit = readOnly ? undefined : onChange;
     const palette = (_jsx(WorkflowPalette, { registry: registry, onAdd: readOnly ? undefined : add, className: "min-h-0 flex-1" }));
-    const side = (_jsxs(Tabs, { value: panel, onValueChange: (v) => setPanel(v), className: "flex min-h-0 flex-1 flex-col", children: [_jsxs(TabsList, { "aria-label": m.panels, children: [_jsx(TabsTrigger, { value: "inspector", children: messages.editor.inspector }), _jsx(TabsTrigger, { value: "problems", children: m.problemsTab(blocking + warnings) }), _jsx(TabsTrigger, { value: "json", children: m.jsonTab })] }), _jsx(TabsContent, { value: "inspector", className: "min-h-0 flex-1 overflow-y-auto", children: _jsx(WorkflowInspector, { definition: definition, registry: registry, selection: selection, onSelectionChange: select, onChange: edit, readOnly: readOnly }) }), _jsx(TabsContent, { value: "problems", className: "min-h-0 flex-1 overflow-y-auto", children: _jsx(WorkflowProblems, { problems: problems, definition: definition, onSelect: (s) => {
+    const side = (_jsxs(Tabs, { value: panel, onValueChange: (v) => setPanel(v), className: "flex min-h-0 flex-1 flex-col", children: [_jsxs(TabsList, { "aria-label": m.panels, children: [_jsx(TabsTrigger, { value: "inspector", children: messages.editor.inspector }), _jsx(TabsTrigger, { value: "problems", children: m.problemsTab(blocking + warnings) }), _jsx(TabsTrigger, { value: "json", children: m.jsonTab })] }), _jsx(TabsContent, { value: "inspector", className: "min-h-0 flex-1 overflow-y-auto", children: _jsx(WorkflowInspector, { definition: definition, registry: registry, selection: selection, onSelectionChange: select, onChange: edit, readOnly: readOnly, renderNodeFields: renderNodeFields }) }), _jsx(TabsContent, { value: "problems", className: "min-h-0 flex-1 overflow-y-auto", children: _jsx(WorkflowProblems, { problems: problems, definition: definition, onSelect: (s) => {
                         select(s);
                         setPanel("inspector");
                         setDrawer(null);
@@ -131,10 +149,13 @@ function Workspace({ definition, onChange, registry, saved = null, published = n
                                 }, children: [_jsx(CopyPlusIcon, { "aria-hidden": true }), m.saveAs] })) : null, onSave && !readOnly ? (_jsxs(Button, { size: "sm", variant: "outline", disabled: !status.dirty || status.conflict || busy !== null, onClick: () => void run("save", () => onSave(definition, base), m.savedNotice), children: [_jsx(SaveIcon, { "aria-hidden": true }), busy === "save" ? m.saving : m.save] })) : null, onPublish && !readOnly ? (_jsxs(Button, { size: "sm", disabled: status.conflict || busy !== null || (!status.unpublished && !!published), onClick: () => setDialog("publish"), children: [_jsx(RocketIcon, { "aria-hidden": true }), m.publish] })) : null] })] }), failure ? (_jsx("p", { role: "alert", className: "rounded-lg border border-danger-border bg-danger-bg px-3 py-2 text-sm text-danger-fg", children: failure })) : null, notice ? (_jsx("p", { className: "sr-only", role: "status", children: notice })) : null, status.conflict && saved ? (_jsxs("div", { role: "alert", className: "flex flex-wrap items-center gap-2 rounded-lg border border-warning-border bg-warning-bg px-3 py-2 text-sm text-warning-fg", children: [_jsx("span", { className: "min-w-0 flex-1", children: m.conflictDescription(saved.by, saved.label) }), _jsx(Button, { size: "sm", variant: "outline", onClick: () => setDialog("compare"), children: m.compare }), _jsx(Button, { size: "sm", variant: "outline", onClick: () => {
                             setBase(saved);
                             onChange?.(saved.definition);
-                        }, children: m.useTheirs }), _jsx(Button, { size: "sm", variant: "outline", onClick: () => setBase(saved), children: m.keepMine })] })) : null, _jsxs("div", { className: "flex min-h-0 flex-1 gap-3", children: [_jsx("aside", { "aria-label": m.paletteRegion, className: "hidden w-60 shrink-0 flex-col @5xl:flex", children: palette }), _jsxs("div", { className: "flex min-h-0 min-w-0 flex-1 flex-col gap-2", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [!readOnly ? (_jsxs(Button, { size: "sm", variant: "outline", className: "@5xl:hidden", onClick: () => setDrawer("palette"), children: [_jsx(ListTreeIcon, { "aria-hidden": true }), messages.editor.palette] })) : null, _jsxs(Button, { size: "sm", variant: "outline", className: "@5xl:hidden", onClick: () => setDrawer("panel"), children: [_jsx(PanelRightIcon, { "aria-hidden": true }), m.panels] }), flows.length > 1 ? (_jsx(Segmented, { label: m.flow, size: "sm", value: flow, onValueChange: (v) => {
-                                            setFlowName(v);
-                                            setSelection(null);
-                                        }, options: flows.map(([key, f]) => ({ value: key, label: f.label ?? key })) })) : null] }), _jsx(WorkflowCanvas, { definition: definition, flow: flow, registry: registry, onChange: edit, readOnly: readOnly, selection: selection, onSelectionChange: select, problems: problems, className: "min-h-96 flex-1" }, flow)] }), _jsx("aside", { "aria-label": m.panels, className: "hidden w-88 shrink-0 flex-col @5xl:flex", children: side })] }), _jsx(Drawer, { open: drawer !== null, onOpenChange: (open) => !open && setDrawer(null), children: _jsxs(DrawerContent, { side: drawer === "palette" ? "left" : "right", className: "p-4", children: [_jsx(DrawerTitle, { children: drawer === "palette" ? messages.editor.palette : m.panels }), _jsx("div", { className: "flex min-h-0 flex-1 flex-col", children: drawer === "palette" ? palette : side })] }) }), _jsx(Dialog, { open: dialog === "publish", onOpenChange: (open) => !open && setDialog(null), children: _jsxs(DialogContent, { className: "max-w-xl", children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: m.publishTitle }), _jsx(DialogDescription, { children: published ? m.publishDescription(published.label) : m.firstPublish })] }), published ? (_jsx(WorkflowDiff, { diff: diffDefinitions(published.definition, definition), flows: definition.flows, label: m.draftAgainstLive, className: "max-h-80 overflow-y-auto" })) : null, blocking ? (_jsx("p", { role: "alert", className: "text-sm text-danger-fg", children: m.publishBlocked(blocking) })) : null, _jsxs(DialogFooter, { children: [_jsx(Button, { type: "button", variant: "outline", onClick: () => setDialog(null), children: messages.editor.cancel }), _jsx(Button, { type: "button", disabled: blocking > 0 || busy !== null, onClick: async () => {
+                        }, children: m.useTheirs }), _jsx(Button, { size: "sm", variant: "outline", onClick: () => setBase(saved), children: m.keepMine })] })) : null, _jsxs("div", { className: "flex min-h-0 flex-1 gap-3", children: [_jsx("aside", { "aria-label": m.paletteRegion, className: "hidden w-60 shrink-0 flex-col @5xl:flex", children: palette }), _jsxs("div", { className: "flex min-h-0 min-w-0 flex-1 flex-col gap-2", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [!readOnly ? (_jsxs(Button, { size: "sm", variant: "outline", className: "@5xl:hidden", onClick: () => setDrawer("palette"), children: [_jsx(ListTreeIcon, { "aria-hidden": true }), messages.editor.palette] })) : null, _jsxs(Button, { size: "sm", variant: "outline", className: "@5xl:hidden", onClick: () => setDrawer("panel"), children: [_jsx(PanelRightIcon, { "aria-hidden": true }), m.panels] }), flows.length > 1 ? (_jsx(Segmented, { label: m.flow, size: "sm", value: flow, onValueChange: openFlow, options: flows.map(([key, f]) => ({ value: key, label: f.label ?? key })) })) : null, onFlowRename && !readOnly ? (_jsxs(Button, { size: "sm", variant: "ghost", disabled: busy !== null, onClick: () => {
+                                            setFailure(null);
+                                            setDialog("rename-flow");
+                                        }, children: [_jsx(PencilIcon, { "aria-hidden": true }), m.renameFlow] })) : null, onFlowCreate && !readOnly ? (_jsxs(Button, { size: "sm", variant: "ghost", disabled: busy !== null, onClick: () => {
+                                            setFailure(null);
+                                            setDialog("new-flow");
+                                        }, children: [_jsx(PlusIcon, { "aria-hidden": true }), m.newFlow] })) : null] }), _jsx(WorkflowCanvas, { definition: definition, flow: flow, registry: registry, onChange: edit, readOnly: readOnly, selection: selection, onSelectionChange: select, problems: problems, className: "min-h-96 flex-1" }, flow)] }), _jsx("aside", { "aria-label": m.panels, className: "hidden w-88 shrink-0 flex-col @5xl:flex", children: side })] }), _jsx(Drawer, { open: drawer !== null, onOpenChange: (open) => !open && setDrawer(null), children: _jsxs(DrawerContent, { side: drawer === "palette" ? "left" : "right", className: "p-4", children: [_jsx(DrawerTitle, { children: drawer === "palette" ? messages.editor.palette : m.panels }), _jsx("div", { className: "flex min-h-0 flex-1 flex-col", children: drawer === "palette" ? palette : side })] }) }), _jsx(Dialog, { open: dialog === "publish", onOpenChange: (open) => !open && setDialog(null), children: _jsxs(DialogContent, { className: "max-w-xl", children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: m.publishTitle }), _jsx(DialogDescription, { children: published ? m.publishDescription(published.label) : m.firstPublish })] }), published ? (_jsx(WorkflowDiff, { diff: diffDefinitions(published.definition, definition), flows: definition.flows, label: m.draftAgainstLive, className: "max-h-80 overflow-y-auto" })) : null, blocking ? (_jsx("p", { role: "alert", className: "text-sm text-danger-fg", children: m.publishBlocked(blocking) })) : null, _jsxs(DialogFooter, { children: [_jsx(Button, { type: "button", variant: "outline", onClick: () => setDialog(null), children: messages.editor.cancel }), _jsx(Button, { type: "button", disabled: blocking > 0 || busy !== null, onClick: async () => {
                                         if (await run("publish", () => onPublish?.(definition), m.publishedNotice))
                                             setDialog(null);
                                     }, children: busy === "publish" ? m.publishing : m.publish })] })] }) }), _jsx(Dialog, { open: dialog === "save-as", onOpenChange: (open) => !open && setDialog(null), children: _jsxs(DialogContent, { children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: m.saveAsTitle }), _jsx(DialogDescription, { children: m.saveAsDescription })] }), _jsxs("form", { className: "flex flex-col gap-4", onSubmit: async (e) => {
@@ -147,8 +168,46 @@ function Workspace({ definition, onChange, registry, saved = null, published = n
                             }, children: [_jsx(Field, { label: messages.editor.name, required: true, children: _jsx(Input, { value: name, onChange: (e) => setName(e.target.value) }) }), _jsxs(DialogFooter, { children: [_jsx(Button, { type: "button", variant: "outline", onClick: () => setDialog(null), children: messages.editor.cancel }), _jsx(Button, { type: "submit", disabled: !name.trim() || busy !== null, children: busy === "save-as" ? m.saving : m.saveAs })] })] })] }) }), _jsx(Dialog, { open: dialog === "compare", onOpenChange: (open) => !open && setDialog(null), children: _jsxs(DialogContent, { className: "max-w-xl", children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: m.compareTitle }), _jsx(DialogDescription, { children: m.compareDescription })] }), saved ? (_jsx(WorkflowDiff, { diff: diffDefinitions(saved.definition, definition), flows: definition.flows, label: m.compareTitle, className: "max-h-80 overflow-y-auto" })) : null] }) }), _jsx(ConfirmDialog, { open: dialog === "discard", onOpenChange: (open) => !open && setDialog(null), title: m.discardTitle, description: m.discardDescription, confirmLabel: m.discard, destructive: true, onConfirm: () => {
                     if (base)
                         onChange?.(base.definition);
-                    setSelection(null);
-                } }), _jsx(Dialog, { open: !!importPreview, onOpenChange: (open) => !open && onImportCancel?.(), children: _jsxs(DialogContent, { className: "max-w-xl", children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: m.importTitle }), _jsx(DialogDescription, { children: m.importDescription })] }), importPreview ? (_jsx(WorkflowImportPreview, { preview: importPreview, busy: busy === "import", onCancel: onImportCancel, onConfirm: onImportConfirm
+                    select(null);
+                } }), _jsx(Dialog, { open: dialog === "new-flow" || dialog === "rename-flow", onOpenChange: (open) => !open && setDialog(null), children: _jsxs(DialogContent, { children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: dialog === "rename-flow"
+                                        ? m.renameFlowTitle(definition.flows[flow]?.label ?? flow)
+                                        : m.newFlowTitle }), _jsx(DialogDescription, { children: dialog === "rename-flow" ? m.renameFlowDescription : m.newFlowDescription })] }), dialog === "new-flow" || dialog === "rename-flow" ? (_jsx(FlowForm, { definition: definition, current: dialog === "rename-flow" ? flow : undefined, busy: busy !== null, failure: failure, onCancel: () => setDialog(null), onSubmit: async (name, label) => {
+                                const renaming = dialog === "rename-flow";
+                                const done = renaming
+                                    ? await run("flow", () => onFlowRename?.(renameFlow(definition, flow, name, label), flow, name), m.flowRenamedNotice(name))
+                                    : await run("flow", () => onFlowCreate?.(addFlow(definition, name, label), name), m.flowCreatedNotice(name));
+                                if (!done)
+                                    return;
+                                setDialog(null);
+                                if (renaming && selection?.flow === flow)
+                                    select({ ...selection, flow: name });
+                                else if (!renaming)
+                                    select(null);
+                                setFlowName(name);
+                            } })) : null] }) }), _jsx(Dialog, { open: !!importPreview, onOpenChange: (open) => !open && onImportCancel?.(), children: _jsxs(DialogContent, { className: "max-w-xl", children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: m.importTitle }), _jsx(DialogDescription, { children: m.importDescription })] }), importPreview ? (_jsx(WorkflowImportPreview, { preview: importPreview, busy: busy === "import", onCancel: onImportCancel, onConfirm: onImportConfirm
                                 ? () => void run("import", () => onImportConfirm(), m.importedNotice)
                                 : undefined, className: "max-h-[70vh] overflow-y-auto" })) : null] }) })] }));
 }
+/**
+ * A flow's name and label, checked as they are typed: a new flow, or the
+ * open one (`current`) being renamed. Holds its own state so typing does not
+ * redraw the canvas.
+ */
+function FlowForm({ definition, current, busy, failure, onCancel, onSubmit, }) {
+    const { messages } = useUI();
+    const m = messages.workspace;
+    const currentLabel = current ? (definition.flows[current]?.label ?? "") : "";
+    const [name, setName] = React.useState(current ?? "");
+    const [label, setLabel] = React.useState(currentLabel);
+    const [touched, setTouched] = React.useState(false);
+    const trimmed = name.trim();
+    const problem = flowNameProblem(definition, trimmed, current);
+    const full = !current && Object.keys(definition.flows).length >= WORKFLOW_MAX_FLOWS;
+    const unchanged = !!current && trimmed === current && label.trim() === currentLabel;
+    return (_jsxs("form", { className: "flex flex-col gap-4", noValidate: true, onSubmit: (e) => {
+            e.preventDefault();
+            setTouched(true);
+            if (!problem && !full && !unchanged)
+                onSubmit(trimmed, label.trim());
+        }, children: [_jsx(Field, { label: m.flowName, hint: m.flowNameHint, error: touched && problem ? m.flowNameProblem(problem) : undefined, required: true, children: _jsx(Input, { value: name, autoComplete: "off", spellCheck: false, onChange: (e) => setName(e.target.value), onBlur: () => setTouched(true) }) }), _jsx(Field, { label: m.flowLabel, hint: m.flowLabelHint, children: _jsx(Input, { value: label, onChange: (e) => setLabel(e.target.value) }) }), full ? (_jsx("p", { role: "alert", className: "text-sm text-danger-fg", children: m.flowsFull(WORKFLOW_MAX_FLOWS) })) : null, failure ? (_jsx("p", { role: "alert", className: "text-sm text-danger-fg", children: failure })) : null, _jsxs(DialogFooter, { children: [_jsx(Button, { type: "button", variant: "outline", onClick: onCancel, children: messages.editor.cancel }), _jsx(Button, { type: "submit", disabled: full || unchanged || busy, children: busy ? m.saving : current ? m.rename : m.createFlow })] })] }));
+}

package/dist/workflow/question.d.ts

@@ -0,0 +1,26 @@
+/** Runtime question state supplied by the host, independently of form submission. */
+export type WorkflowQuestionState = "waiting" | "submitting" | "accepted" | "acknowledged" | "expired" | "delivery-unknown" | "unavailable";
+export interface WorkflowQuestionField {
+    id: string;
+    text: string;
+    options?: readonly {
+        label: string;
+        description?: string;
+    }[];
+    multiple?: boolean;
+}
+export interface WorkflowQuestion {
+    id: string;
+    /** Opaque host revision, echoed unchanged with the answer intent. */
+    revision: string;
+    title?: string;
+    worker?: string;
+    fields: readonly WorkflowQuestionField[];
+}
+export type WorkflowQuestionAnswers = Readonly<Record<string, string | readonly string[]>>;
+/** Intent only. The host owns authorization, delivery correlation and acknowledgment. */
+export interface WorkflowQuestionSubmission {
+    questionId: string;
+    revision: string;
+    answers: WorkflowQuestionAnswers;
+}

package/dist/workflow/question.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calliopelabs/ui",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Calliope AI shared operator UI: app shell, navigation, page frame, data table and list patterns, status colours, design tokens and appearance for Astrolift AI and Zentinelle AI.",
   "keywords": [
     "calliope-ai",