@open-mercato/core 0.7.1-develop.7193.1.910a5b0a1e → 0.7.1-develop.7195.1.b5efd1d51a

package/dist/modules/workflows/lib/editor-annotations.js

@@ -0,0 +1,195 @@
+const ANNOTATION_NOTE_NODE_TYPE = "annotationNote";
+const ANNOTATION_GROUP_NODE_TYPE = "annotationGroup";
+const DEFAULT_NOTE_SIZE = { width: 220, height: 140 };
+const DEFAULT_GROUP_SIZE = { width: 360, height: 260 };
+const GROUP_Z_INDEX = -1;
+function createEmptyAnnotations() {
+  return { notes: [], groups: [] };
+}
+function isAnnotationNodeType(nodeType) {
+  return nodeType === ANNOTATION_NOTE_NODE_TYPE || nodeType === ANNOTATION_GROUP_NODE_TYPE;
+}
+function isAnnotationNode(node) {
+  return isAnnotationNodeType(node.type);
+}
+function hasAnnotations(annotations) {
+  if (!annotations) return false;
+  return annotations.notes.length > 0 || annotations.groups.length > 0;
+}
+function generateAnnotationId(prefix) {
+  return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 11)}`;
+}
+function readPoint(value, fallback) {
+  if (!value || typeof value !== "object") return fallback;
+  const candidate = value;
+  const x = typeof candidate.x === "number" && Number.isFinite(candidate.x) ? candidate.x : fallback.x;
+  const y = typeof candidate.y === "number" && Number.isFinite(candidate.y) ? candidate.y : fallback.y;
+  return { x, y };
+}
+function readSize(value, fallback) {
+  if (!value || typeof value !== "object") return fallback;
+  const candidate = value;
+  const width = typeof candidate.width === "number" && candidate.width > 0 ? candidate.width : fallback.width;
+  const height = typeof candidate.height === "number" && candidate.height > 0 ? candidate.height : fallback.height;
+  return { width, height };
+}
+function readNote(value) {
+  if (!value || typeof value !== "object") return null;
+  const candidate = value;
+  if (typeof candidate.id !== "string" || candidate.id.length === 0) return null;
+  return {
+    id: candidate.id,
+    markdown: typeof candidate.markdown === "string" ? candidate.markdown : "",
+    position: readPoint(candidate.position, { x: 0, y: 0 }),
+    size: readSize(candidate.size, DEFAULT_NOTE_SIZE)
+  };
+}
+function readGroup(value) {
+  if (!value || typeof value !== "object") return null;
+  const candidate = value;
+  if (typeof candidate.id !== "string" || candidate.id.length === 0) return null;
+  const point = readPoint(candidate.rect, { x: 0, y: 0 });
+  const size = readSize(candidate.rect, DEFAULT_GROUP_SIZE);
+  const group = {
+    id: candidate.id,
+    name: typeof candidate.name === "string" ? candidate.name : "",
+    rect: { x: point.x, y: point.y, width: size.width, height: size.height }
+  };
+  if (candidate.collapsed === true) group.collapsed = true;
+  return group;
+}
+function readEditorAnnotations(metadata) {
+  const editorValue = metadata?.editor;
+  if (!editorValue || typeof editorValue !== "object" || Array.isArray(editorValue)) return createEmptyAnnotations();
+  const annotationsValue = editorValue.annotations;
+  if (!annotationsValue || typeof annotationsValue !== "object" || Array.isArray(annotationsValue)) {
+    return createEmptyAnnotations();
+  }
+  const candidate = annotationsValue;
+  const notes = Array.isArray(candidate.notes) ? candidate.notes.map(readNote).filter((note) => note !== null) : [];
+  const groups = Array.isArray(candidate.groups) ? candidate.groups.map(readGroup).filter((group) => group !== null) : [];
+  return { notes, groups };
+}
+function writeEditorAnnotations(metadata, annotations) {
+  const base = { ...metadata ?? {} };
+  const editorValue = base.editor;
+  const editor = editorValue && typeof editorValue === "object" && !Array.isArray(editorValue) ? { ...editorValue } : {};
+  if (hasAnnotations(annotations)) {
+    const payload = {};
+    if (annotations.notes.length > 0) payload.notes = annotations.notes;
+    if (annotations.groups.length > 0) payload.groups = annotations.groups;
+    editor.annotations = payload;
+  } else {
+    delete editor.annotations;
+  }
+  if (Object.keys(editor).length > 0) base.editor = editor;
+  else delete base.editor;
+  return Object.keys(base).length > 0 ? base : null;
+}
+function annotationsToNodes(annotations) {
+  if (!annotations) return [];
+  const groupNodes = annotations.groups.map((group) => ({
+    id: group.id,
+    type: ANNOTATION_GROUP_NODE_TYPE,
+    position: { x: group.rect.x, y: group.rect.y },
+    width: group.rect.width,
+    height: group.rect.height,
+    style: { width: group.rect.width, height: group.rect.height },
+    zIndex: GROUP_Z_INDEX,
+    data: { name: group.name, collapsed: group.collapsed === true }
+  }));
+  const noteNodes = annotations.notes.map((note) => ({
+    id: note.id,
+    type: ANNOTATION_NOTE_NODE_TYPE,
+    position: { x: note.position.x, y: note.position.y },
+    width: note.size.width,
+    height: note.size.height,
+    style: { width: note.size.width, height: note.size.height },
+    data: { markdown: note.markdown }
+  }));
+  return [...groupNodes, ...noteNodes];
+}
+function nodeSize(node, fallback) {
+  const width = typeof node.width === "number" && node.width > 0 ? node.width : typeof node.measured?.width === "number" && node.measured.width > 0 ? node.measured.width : fallback.width;
+  const height = typeof node.height === "number" && node.height > 0 ? node.height : typeof node.measured?.height === "number" && node.measured.height > 0 ? node.measured.height : fallback.height;
+  return { width, height };
+}
+function annotationsFromNodes(nodes) {
+  const notes = [];
+  const groups = [];
+  for (const node of nodes) {
+    if (node.type === ANNOTATION_NOTE_NODE_TYPE) {
+      const data = node.data;
+      notes.push({
+        id: node.id,
+        markdown: typeof data?.markdown === "string" ? data.markdown : "",
+        position: { x: node.position.x, y: node.position.y },
+        size: nodeSize(node, DEFAULT_NOTE_SIZE)
+      });
+      continue;
+    }
+    if (node.type === ANNOTATION_GROUP_NODE_TYPE) {
+      const data = node.data;
+      const size = nodeSize(node, DEFAULT_GROUP_SIZE);
+      const group = {
+        id: node.id,
+        name: typeof data?.name === "string" ? data.name : "",
+        rect: { x: node.position.x, y: node.position.y, width: size.width, height: size.height }
+      };
+      if (data?.collapsed === true) group.collapsed = true;
+      groups.push(group);
+    }
+  }
+  return { notes, groups };
+}
+function createNoteNode(position, markdown) {
+  return {
+    id: generateAnnotationId("note"),
+    type: ANNOTATION_NOTE_NODE_TYPE,
+    position: { x: position.x, y: position.y },
+    width: DEFAULT_NOTE_SIZE.width,
+    height: DEFAULT_NOTE_SIZE.height,
+    style: { width: DEFAULT_NOTE_SIZE.width, height: DEFAULT_NOTE_SIZE.height },
+    data: { markdown }
+  };
+}
+function createGroupNode(position, name) {
+  return {
+    id: generateAnnotationId("group"),
+    type: ANNOTATION_GROUP_NODE_TYPE,
+    position: { x: position.x, y: position.y },
+    width: DEFAULT_GROUP_SIZE.width,
+    height: DEFAULT_GROUP_SIZE.height,
+    style: { width: DEFAULT_GROUP_SIZE.width, height: DEFAULT_GROUP_SIZE.height },
+    zIndex: GROUP_Z_INDEX,
+    data: { name, collapsed: false }
+  };
+}
+function updateAnnotationNode(nodes, nodeId, updates) {
+  return nodes.map(
+    (node) => node.id === nodeId && isAnnotationNode(node) ? { ...node, data: { ...node.data, ...updates } } : node
+  );
+}
+function removeAnnotationNode(nodes, nodeId) {
+  return nodes.filter((node) => !(node.id === nodeId && isAnnotationNode(node)));
+}
+export {
+  ANNOTATION_GROUP_NODE_TYPE,
+  ANNOTATION_NOTE_NODE_TYPE,
+  DEFAULT_GROUP_SIZE,
+  DEFAULT_NOTE_SIZE,
+  annotationsFromNodes,
+  annotationsToNodes,
+  createEmptyAnnotations,
+  createGroupNode,
+  createNoteNode,
+  generateAnnotationId,
+  hasAnnotations,
+  isAnnotationNode,
+  isAnnotationNodeType,
+  readEditorAnnotations,
+  removeAnnotationNode,
+  updateAnnotationNode,
+  writeEditorAnnotations
+};
+//# sourceMappingURL=editor-annotations.js.map

package/dist/modules/workflows/lib/editor-annotations.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/editor-annotations.ts"],
+  "sourcesContent": ["/**\n * Sticky notes and named groups (spec section 4.5).\n *\n * Annotations are DOCUMENTATION and never execution semantics. They live in\n * `metadata.editor.annotations` only \u2014 `graphToDefinition` filters their nodes\n * out of `steps` and `transitions` entirely, so a definition carrying a hundred\n * notes serializes byte-identically to one carrying none and the engine can\n * never see them.\n *\n * They are still React Flow NODES while the editor is open, which is what makes\n * dragging, selection, the undo stack and the arrangement autosave work for a\n * note exactly as they do for a step: the page owns one node array and the\n * annotations are derived back out of it on save.\n *\n * PURE: plain data in, plain data out \u2014 React Flow is a type-only import.\n */\n\nimport type { Node } from '@xyflow/react'\n\nexport const ANNOTATION_NOTE_NODE_TYPE = 'annotationNote'\nexport const ANNOTATION_GROUP_NODE_TYPE = 'annotationGroup'\n\nexport const DEFAULT_NOTE_SIZE = { width: 220, height: 140 }\nexport const DEFAULT_GROUP_SIZE = { width: 360, height: 260 }\n\n/** Groups render behind the steps they frame; notes sit in the normal plane. */\nconst GROUP_Z_INDEX = -1\n\nexport interface AnnotationPoint {\n  x: number\n  y: number\n}\n\nexport interface AnnotationSize {\n  width: number\n  height: number\n}\n\nexport interface AnnotationRect extends AnnotationPoint, AnnotationSize {}\n\nexport interface WorkflowEditorNote {\n  id: string\n  markdown: string\n  position: AnnotationPoint\n  size: AnnotationSize\n}\n\n/**\n * A group is stored as a RECT rather than a member-id list. A region needs no\n * maintenance when a step it happens to overlap is deleted, pasted or converted,\n * and \"which steps are in this group\" is already answered by the canvas \u2014 an id\n * list would be a second source of truth the engine must never read anyway.\n */\nexport interface WorkflowEditorGroup {\n  id: string\n  name: string\n  rect: AnnotationRect\n  collapsed?: boolean\n}\n\nexport interface WorkflowEditorAnnotations {\n  notes: WorkflowEditorNote[]\n  groups: WorkflowEditorGroup[]\n}\n\nexport interface WorkflowNoteNodeData extends Record<string, unknown> {\n  markdown: string\n}\n\nexport interface WorkflowGroupNodeData extends Record<string, unknown> {\n  name: string\n  collapsed: boolean\n}\n\nexport function createEmptyAnnotations(): WorkflowEditorAnnotations {\n  return { notes: [], groups: [] }\n}\n\nexport function isAnnotationNodeType(nodeType: string | undefined | null): boolean {\n  return nodeType === ANNOTATION_NOTE_NODE_TYPE || nodeType === ANNOTATION_GROUP_NODE_TYPE\n}\n\nexport function isAnnotationNode(node: { type?: string | null }): boolean {\n  return isAnnotationNodeType(node.type)\n}\n\nexport function hasAnnotations(annotations: WorkflowEditorAnnotations | null | undefined): boolean {\n  if (!annotations) return false\n  return annotations.notes.length > 0 || annotations.groups.length > 0\n}\n\nexport function generateAnnotationId(prefix: 'note' | 'group'): string {\n  return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 11)}`\n}\n\nfunction readPoint(value: unknown, fallback: AnnotationPoint): AnnotationPoint {\n  if (!value || typeof value !== 'object') return fallback\n  const candidate = value as Record<string, unknown>\n  const x = typeof candidate.x === 'number' && Number.isFinite(candidate.x) ? candidate.x : fallback.x\n  const y = typeof candidate.y === 'number' && Number.isFinite(candidate.y) ? candidate.y : fallback.y\n  return { x, y }\n}\n\nfunction readSize(value: unknown, fallback: AnnotationSize): AnnotationSize {\n  if (!value || typeof value !== 'object') return fallback\n  const candidate = value as Record<string, unknown>\n  const width = typeof candidate.width === 'number' && candidate.width > 0 ? candidate.width : fallback.width\n  const height = typeof candidate.height === 'number' && candidate.height > 0 ? candidate.height : fallback.height\n  return { width, height }\n}\n\nfunction readNote(value: unknown): WorkflowEditorNote | null {\n  if (!value || typeof value !== 'object') return null\n  const candidate = value as Record<string, unknown>\n  if (typeof candidate.id !== 'string' || candidate.id.length === 0) return null\n  return {\n    id: candidate.id,\n    markdown: typeof candidate.markdown === 'string' ? candidate.markdown : '',\n    position: readPoint(candidate.position, { x: 0, y: 0 }),\n    size: readSize(candidate.size, DEFAULT_NOTE_SIZE),\n  }\n}\n\nfunction readGroup(value: unknown): WorkflowEditorGroup | null {\n  if (!value || typeof value !== 'object') return null\n  const candidate = value as Record<string, unknown>\n  if (typeof candidate.id !== 'string' || candidate.id.length === 0) return null\n  const point = readPoint(candidate.rect, { x: 0, y: 0 })\n  const size = readSize(candidate.rect, DEFAULT_GROUP_SIZE)\n  const group: WorkflowEditorGroup = {\n    id: candidate.id,\n    name: typeof candidate.name === 'string' ? candidate.name : '',\n    rect: { x: point.x, y: point.y, width: size.width, height: size.height },\n  }\n  if (candidate.collapsed === true) group.collapsed = true\n  return group\n}\n\n/**\n * Read the annotations carried by a definition's metadata bag, tolerating every\n * shape a hand-edited or older document can hold. Anything unreadable is simply\n * dropped rather than throwing: annotations are documentation, and a malformed\n * note must never stop a workflow from opening.\n */\nexport function readEditorAnnotations(\n  metadata: Record<string, unknown> | null | undefined,\n): WorkflowEditorAnnotations {\n  const editorValue = metadata?.editor\n  if (!editorValue || typeof editorValue !== 'object' || Array.isArray(editorValue)) return createEmptyAnnotations()\n  const annotationsValue = (editorValue as Record<string, unknown>).annotations\n  if (!annotationsValue || typeof annotationsValue !== 'object' || Array.isArray(annotationsValue)) {\n    return createEmptyAnnotations()\n  }\n  const candidate = annotationsValue as Record<string, unknown>\n  const notes = Array.isArray(candidate.notes)\n    ? candidate.notes.map(readNote).filter((note): note is WorkflowEditorNote => note !== null)\n    : []\n  const groups = Array.isArray(candidate.groups)\n    ? candidate.groups.map(readGroup).filter((group): group is WorkflowEditorGroup => group !== null)\n    : []\n  return { notes, groups }\n}\n\n/**\n * Write annotations back into a metadata bag. An empty set REMOVES the key (and\n * the `editor` bag when nothing else lives there), so a workflow that never used\n * an annotation keeps saving exactly the metadata it always did.\n */\nexport function writeEditorAnnotations(\n  metadata: Record<string, unknown> | null,\n  annotations: WorkflowEditorAnnotations | null | undefined,\n): Record<string, unknown> | null {\n  const base: Record<string, unknown> = { ...(metadata ?? {}) }\n  const editorValue = base.editor\n  const editor: Record<string, unknown> =\n    editorValue && typeof editorValue === 'object' && !Array.isArray(editorValue)\n      ? { ...(editorValue as Record<string, unknown>) }\n      : {}\n\n  if (hasAnnotations(annotations)) {\n    const payload: Record<string, unknown> = {}\n    if (annotations!.notes.length > 0) payload.notes = annotations!.notes\n    if (annotations!.groups.length > 0) payload.groups = annotations!.groups\n    editor.annotations = payload\n  } else {\n    delete editor.annotations\n  }\n\n  if (Object.keys(editor).length > 0) base.editor = editor\n  else delete base.editor\n  return Object.keys(base).length > 0 ? base : null\n}\n\nexport function annotationsToNodes(annotations: WorkflowEditorAnnotations | null | undefined): Node[] {\n  if (!annotations) return []\n  const groupNodes: Node[] = annotations.groups.map((group) => ({\n    id: group.id,\n    type: ANNOTATION_GROUP_NODE_TYPE,\n    position: { x: group.rect.x, y: group.rect.y },\n    width: group.rect.width,\n    height: group.rect.height,\n    style: { width: group.rect.width, height: group.rect.height },\n    zIndex: GROUP_Z_INDEX,\n    data: { name: group.name, collapsed: group.collapsed === true } satisfies WorkflowGroupNodeData,\n  }))\n  const noteNodes: Node[] = annotations.notes.map((note) => ({\n    id: note.id,\n    type: ANNOTATION_NOTE_NODE_TYPE,\n    position: { x: note.position.x, y: note.position.y },\n    width: note.size.width,\n    height: note.size.height,\n    style: { width: note.size.width, height: note.size.height },\n    data: { markdown: note.markdown } satisfies WorkflowNoteNodeData,\n  }))\n  return [...groupNodes, ...noteNodes]\n}\n\nfunction nodeSize(node: Node, fallback: AnnotationSize): AnnotationSize {\n  const width = typeof node.width === 'number' && node.width > 0\n    ? node.width\n    : typeof node.measured?.width === 'number' && node.measured.width > 0\n      ? node.measured.width\n      : fallback.width\n  const height = typeof node.height === 'number' && node.height > 0\n    ? node.height\n    : typeof node.measured?.height === 'number' && node.measured.height > 0\n      ? node.measured.height\n      : fallback.height\n  return { width, height }\n}\n\n/** Derive the persisted annotations back out of the live node array. */\nexport function annotationsFromNodes(nodes: Node[]): WorkflowEditorAnnotations {\n  const notes: WorkflowEditorNote[] = []\n  const groups: WorkflowEditorGroup[] = []\n  for (const node of nodes) {\n    if (node.type === ANNOTATION_NOTE_NODE_TYPE) {\n      const data = node.data as Partial<WorkflowNoteNodeData> | undefined\n      notes.push({\n        id: node.id,\n        markdown: typeof data?.markdown === 'string' ? data.markdown : '',\n        position: { x: node.position.x, y: node.position.y },\n        size: nodeSize(node, DEFAULT_NOTE_SIZE),\n      })\n      continue\n    }\n    if (node.type === ANNOTATION_GROUP_NODE_TYPE) {\n      const data = node.data as Partial<WorkflowGroupNodeData> | undefined\n      const size = nodeSize(node, DEFAULT_GROUP_SIZE)\n      const group: WorkflowEditorGroup = {\n        id: node.id,\n        name: typeof data?.name === 'string' ? data.name : '',\n        rect: { x: node.position.x, y: node.position.y, width: size.width, height: size.height },\n      }\n      if (data?.collapsed === true) group.collapsed = true\n      groups.push(group)\n    }\n  }\n  return { notes, groups }\n}\n\nexport function createNoteNode(position: AnnotationPoint, markdown: string): Node {\n  return {\n    id: generateAnnotationId('note'),\n    type: ANNOTATION_NOTE_NODE_TYPE,\n    position: { x: position.x, y: position.y },\n    width: DEFAULT_NOTE_SIZE.width,\n    height: DEFAULT_NOTE_SIZE.height,\n    style: { width: DEFAULT_NOTE_SIZE.width, height: DEFAULT_NOTE_SIZE.height },\n    data: { markdown } satisfies WorkflowNoteNodeData,\n  }\n}\n\nexport function createGroupNode(position: AnnotationPoint, name: string): Node {\n  return {\n    id: generateAnnotationId('group'),\n    type: ANNOTATION_GROUP_NODE_TYPE,\n    position: { x: position.x, y: position.y },\n    width: DEFAULT_GROUP_SIZE.width,\n    height: DEFAULT_GROUP_SIZE.height,\n    style: { width: DEFAULT_GROUP_SIZE.width, height: DEFAULT_GROUP_SIZE.height },\n    zIndex: GROUP_Z_INDEX,\n    data: { name, collapsed: false } satisfies WorkflowGroupNodeData,\n  }\n}\n\nexport function updateAnnotationNode(\n  nodes: Node[],\n  nodeId: string,\n  updates: Partial<WorkflowNoteNodeData & WorkflowGroupNodeData>,\n): Node[] {\n  return nodes.map((node) =>\n    node.id === nodeId && isAnnotationNode(node)\n      ? { ...node, data: { ...node.data, ...updates } }\n      : node,\n  )\n}\n\nexport function removeAnnotationNode(nodes: Node[], nodeId: string): Node[] {\n  return nodes.filter((node) => !(node.id === nodeId && isAnnotationNode(node)))\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/workflows/lib/editor-commands.js

@@ -0,0 +1,103 @@
+const WORKFLOW_COMMAND_GROUP_ORDER = ["edit", "add", "navigate", "view", "run"];
+function buildWorkflowEditorCommands(context) {
+  const { readOnly, labels, actions } = context;
+  const commands = [
+    {
+      id: "edit.undo",
+      group: "edit",
+      label: labels.undo,
+      shortcut: "Cmd+Z",
+      disabled: readOnly || !context.canUndo,
+      run: actions.undo
+    },
+    {
+      id: "edit.redo",
+      group: "edit",
+      label: labels.redo,
+      shortcut: "Cmd+Shift+Z",
+      disabled: readOnly || !context.canRedo,
+      run: actions.redo
+    },
+    {
+      id: "edit.delete",
+      group: "edit",
+      label: labels.deleteSelection,
+      shortcut: "Del",
+      disabled: readOnly || !context.hasSelection,
+      run: actions.deleteSelection
+    },
+    {
+      id: "edit.copy",
+      group: "edit",
+      label: labels.copy,
+      shortcut: "Cmd+C",
+      disabled: !context.hasSelection,
+      run: actions.copy
+    },
+    {
+      id: "edit.paste",
+      group: "edit",
+      label: labels.paste,
+      shortcut: "Cmd+V",
+      disabled: readOnly,
+      run: actions.paste
+    },
+    {
+      id: "edit.duplicate",
+      group: "edit",
+      label: labels.duplicate,
+      shortcut: "Cmd+D",
+      disabled: readOnly || !context.hasSelection,
+      run: actions.duplicate
+    }
+  ];
+  for (const stepType of context.stepTypes) {
+    commands.push({
+      id: `add.step.${stepType.nodeType}`,
+      group: "add",
+      label: labels.addStep(stepType.typeLabel),
+      disabled: readOnly,
+      run: () => actions.addStep(stepType.nodeType)
+    });
+  }
+  commands.push(
+    { id: "add.note", group: "add", label: labels.addNote, disabled: readOnly, run: actions.addNote },
+    { id: "add.group", group: "add", label: labels.addGroup, disabled: readOnly, run: actions.addGroup }
+  );
+  for (const step of context.steps) {
+    commands.push({
+      id: `navigate.step.${step.id}`,
+      group: "navigate",
+      label: `${labels.goToStep}: ${step.label}`,
+      description: step.typeLabel,
+      disabled: false,
+      run: () => actions.goToStep(step.id)
+    });
+  }
+  commands.push(
+    { id: "view.tidy", group: "view", label: labels.tidy, disabled: readOnly || !context.hasNodes, run: actions.tidy },
+    { id: "view.togglePalette", group: "view", label: labels.togglePalette, disabled: false, run: actions.togglePalette },
+    { id: "view.toggleMetadata", group: "view", label: labels.toggleMetadata, disabled: false, run: actions.toggleMetadata },
+    { id: "view.toggleFocus", group: "view", label: labels.toggleFocus, shortcut: "F", disabled: false, run: actions.toggleFocus },
+    { id: "view.toggleProblems", group: "view", label: labels.toggleProblems, disabled: false, run: actions.toggleProblems },
+    { id: "view.toggleCodeView", group: "view", label: labels.toggleCodeView, disabled: false, run: actions.toggleCodeView },
+    { id: "view.toggleCompensation", group: "view", label: labels.toggleCompensation, disabled: false, run: actions.toggleCompensation },
+    // Prompt-to-draft (spec section 9). Present here for the same reason every
+    // other mutating action is: the palette is the complete non-pointer path,
+    // and a missing entry reads as "unsupported".
+    { id: "add.aiDraft", group: "add", label: labels.aiDraft, disabled: readOnly, run: actions.aiDraft },
+    { id: "run.validate", group: "run", label: labels.validate, disabled: false, run: actions.validate },
+    { id: "run.test", group: "run", label: labels.runTest, disabled: !context.canRunTest, run: actions.runTest },
+    { id: "run.save", group: "run", label: labels.save, shortcut: "Cmd+S", disabled: readOnly, run: actions.save }
+  );
+  return commands;
+}
+function groupWorkflowEditorCommands(commands) {
+  return WORKFLOW_COMMAND_GROUP_ORDER.map((group) => ({ group, commands: commands.filter((command) => command.group === group) })).filter((section) => section.commands.length > 0);
+}
+export {
+  WORKFLOW_COMMAND_GROUP_ORDER,
+  buildWorkflowEditorCommands,
+  groupWorkflowEditorCommands
+};
+//# sourceMappingURL=editor-commands.js.map

package/dist/modules/workflows/lib/editor-commands.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/editor-commands.ts"],
+  "sourcesContent": ["/**\n * The command list behind the Studio's Cmd+K palette (spec section 4.6).\n *\n * \"Every canvas operation is reachable without a pointer: the command palette +\n * inspector + Problems panel + Code view together form a complete non-pointer\n * authoring path, and this is an explicit acceptance criterion.\" The palette is\n * therefore not a convenience layer over the toolbar \u2014 it is the surface that\n * makes the toolbar optional, which is why every mutating action the page\n * exposes appears here and why a command that cannot run right now is DISABLED\n * with its reason rather than hidden (a missing entry reads as \"unsupported\",\n * a disabled one as \"not now\").\n *\n * PURE: descriptors in, descriptors out. The palette component only renders\n * them and the page owns the effects, so dispatch is unit-testable without a\n * dialog, a canvas or a keyboard.\n */\n\nexport type WorkflowCommandGroupId = 'edit' | 'add' | 'navigate' | 'view' | 'run'\n\nexport const WORKFLOW_COMMAND_GROUP_ORDER: WorkflowCommandGroupId[] = ['edit', 'add', 'navigate', 'view', 'run']\n\nexport interface WorkflowEditorCommand {\n  id: string\n  group: WorkflowCommandGroupId\n  label: string\n  description?: string\n  shortcut?: string\n  disabled: boolean\n  run: () => void\n}\n\nexport interface WorkflowCommandStepOption {\n  id: string\n  label: string\n  typeLabel: string\n}\n\nexport interface WorkflowCommandPaletteLabels {\n  undo: string\n  redo: string\n  deleteSelection: string\n  copy: string\n  paste: string\n  duplicate: string\n  addStep: (typeLabel: string) => string\n  addNote: string\n  addGroup: string\n  goToStep: string\n  tidy: string\n  togglePalette: string\n  toggleMetadata: string\n  toggleFocus: string\n  toggleProblems: string\n  toggleCodeView: string\n  toggleCompensation: string\n  validate: string\n  runTest: string\n  save: string\n  aiDraft: string\n}\n\nexport interface WorkflowCommandPaletteActions {\n  undo: () => void\n  redo: () => void\n  deleteSelection: () => void\n  copy: () => void\n  paste: () => void\n  duplicate: () => void\n  addStep: (nodeType: string) => void\n  addNote: () => void\n  addGroup: () => void\n  goToStep: (stepId: string) => void\n  tidy: () => void\n  togglePalette: () => void\n  toggleMetadata: () => void\n  toggleFocus: () => void\n  toggleProblems: () => void\n  toggleCodeView: () => void\n  toggleCompensation: () => void\n  validate: () => void\n  runTest: () => void\n  aiDraft: () => void\n  save: () => void\n}\n\nexport interface WorkflowCommandContext {\n  readOnly: boolean\n  canUndo: boolean\n  canRedo: boolean\n  hasNodes: boolean\n  hasSelection: boolean\n  canRunTest: boolean\n  stepTypes: Array<{ nodeType: string; typeLabel: string }>\n  steps: WorkflowCommandStepOption[]\n  labels: WorkflowCommandPaletteLabels\n  actions: WorkflowCommandPaletteActions\n}\n\nexport function buildWorkflowEditorCommands(context: WorkflowCommandContext): WorkflowEditorCommand[] {\n  const { readOnly, labels, actions } = context\n  const commands: WorkflowEditorCommand[] = [\n    {\n      id: 'edit.undo',\n      group: 'edit',\n      label: labels.undo,\n      shortcut: 'Cmd+Z',\n      disabled: readOnly || !context.canUndo,\n      run: actions.undo,\n    },\n    {\n      id: 'edit.redo',\n      group: 'edit',\n      label: labels.redo,\n      shortcut: 'Cmd+Shift+Z',\n      disabled: readOnly || !context.canRedo,\n      run: actions.redo,\n    },\n    {\n      id: 'edit.delete',\n      group: 'edit',\n      label: labels.deleteSelection,\n      shortcut: 'Del',\n      disabled: readOnly || !context.hasSelection,\n      run: actions.deleteSelection,\n    },\n    {\n      id: 'edit.copy',\n      group: 'edit',\n      label: labels.copy,\n      shortcut: 'Cmd+C',\n      disabled: !context.hasSelection,\n      run: actions.copy,\n    },\n    {\n      id: 'edit.paste',\n      group: 'edit',\n      label: labels.paste,\n      shortcut: 'Cmd+V',\n      disabled: readOnly,\n      run: actions.paste,\n    },\n    {\n      id: 'edit.duplicate',\n      group: 'edit',\n      label: labels.duplicate,\n      shortcut: 'Cmd+D',\n      disabled: readOnly || !context.hasSelection,\n      run: actions.duplicate,\n    },\n  ]\n\n  for (const stepType of context.stepTypes) {\n    commands.push({\n      id: `add.step.${stepType.nodeType}`,\n      group: 'add',\n      label: labels.addStep(stepType.typeLabel),\n      disabled: readOnly,\n      run: () => actions.addStep(stepType.nodeType),\n    })\n  }\n\n  commands.push(\n    { id: 'add.note', group: 'add', label: labels.addNote, disabled: readOnly, run: actions.addNote },\n    { id: 'add.group', group: 'add', label: labels.addGroup, disabled: readOnly, run: actions.addGroup },\n  )\n\n  for (const step of context.steps) {\n    commands.push({\n      id: `navigate.step.${step.id}`,\n      group: 'navigate',\n      label: `${labels.goToStep}: ${step.label}`,\n      description: step.typeLabel,\n      disabled: false,\n      run: () => actions.goToStep(step.id),\n    })\n  }\n\n  commands.push(\n    { id: 'view.tidy', group: 'view', label: labels.tidy, disabled: readOnly || !context.hasNodes, run: actions.tidy },\n    { id: 'view.togglePalette', group: 'view', label: labels.togglePalette, disabled: false, run: actions.togglePalette },\n    { id: 'view.toggleMetadata', group: 'view', label: labels.toggleMetadata, disabled: false, run: actions.toggleMetadata },\n    { id: 'view.toggleFocus', group: 'view', label: labels.toggleFocus, shortcut: 'F', disabled: false, run: actions.toggleFocus },\n    { id: 'view.toggleProblems', group: 'view', label: labels.toggleProblems, disabled: false, run: actions.toggleProblems },\n    { id: 'view.toggleCodeView', group: 'view', label: labels.toggleCodeView, disabled: false, run: actions.toggleCodeView },\n    { id: 'view.toggleCompensation', group: 'view', label: labels.toggleCompensation, disabled: false, run: actions.toggleCompensation },\n    // Prompt-to-draft (spec section 9). Present here for the same reason every\n    // other mutating action is: the palette is the complete non-pointer path,\n    // and a missing entry reads as \"unsupported\".\n    { id: 'add.aiDraft', group: 'add', label: labels.aiDraft, disabled: readOnly, run: actions.aiDraft },\n    { id: 'run.validate', group: 'run', label: labels.validate, disabled: false, run: actions.validate },\n    { id: 'run.test', group: 'run', label: labels.runTest, disabled: !context.canRunTest, run: actions.runTest },\n    { id: 'run.save', group: 'run', label: labels.save, shortcut: 'Cmd+S', disabled: readOnly, run: actions.save },\n  )\n\n  return commands\n}\n\n/** Group commands for rendering, preserving `WORKFLOW_COMMAND_GROUP_ORDER`. */\nexport function groupWorkflowEditorCommands(\n  commands: WorkflowEditorCommand[],\n): Array<{ group: WorkflowCommandGroupId; commands: WorkflowEditorCommand[] }> {\n  return WORKFLOW_COMMAND_GROUP_ORDER\n    .map((group) => ({ group, commands: commands.filter((command) => command.group === group) }))\n    .filter((section) => section.commands.length > 0)\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/workflows/lib/editor-history.js

@@ -0,0 +1,51 @@
+const EDITOR_HISTORY_LIMIT = 100;
+function createEditorHistory() {
+  return { past: [], future: [] };
+}
+function commitEditorHistory(state, previousDocument, label, limit = EDITOR_HISTORY_LIMIT) {
+  const past = [...state.past, { label, document: previousDocument }];
+  return {
+    past: past.length > limit ? past.slice(past.length - limit) : past,
+    future: []
+  };
+}
+function canUndoEditorHistory(state) {
+  return state.past.length > 0;
+}
+function canRedoEditorHistory(state) {
+  return state.future.length > 0;
+}
+function undoEditorHistory(state, currentDocument) {
+  const entry = state.past[state.past.length - 1];
+  if (!entry) return null;
+  return {
+    state: {
+      past: state.past.slice(0, state.past.length - 1),
+      future: [{ label: entry.label, document: currentDocument }, ...state.future]
+    },
+    document: entry.document,
+    label: entry.label
+  };
+}
+function redoEditorHistory(state, currentDocument) {
+  const entry = state.future[0];
+  if (!entry) return null;
+  return {
+    state: {
+      past: [...state.past, { label: entry.label, document: currentDocument }],
+      future: state.future.slice(1)
+    },
+    document: entry.document,
+    label: entry.label
+  };
+}
+export {
+  EDITOR_HISTORY_LIMIT,
+  canRedoEditorHistory,
+  canUndoEditorHistory,
+  commitEditorHistory,
+  createEditorHistory,
+  redoEditorHistory,
+  undoEditorHistory
+};
+//# sourceMappingURL=editor-history.js.map

package/dist/modules/workflows/lib/editor-history.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/editor-history.ts"],
+  "sourcesContent": ["/**\n * Undo/redo command stack for the workflow Studio (spec section 4.5).\n *\n * One stack over the whole editor document \u2014 the canvas and the inspector edit\n * the same `{ nodes, edges, metadata }` object, so a step rename undoes exactly\n * like a deleted route. Entries are SNAPSHOTS rather than diffs: a workflow\n * document is small enough that copying a reference to the already-immutable\n * node/edge arrays costs nothing, and a snapshot cannot drift out of sync with\n * the live state the way an inverse-command log can.\n *\n * The stack stores the document as it was BEFORE each edit, which is what lets\n * callers commit from inside an asynchronous handler: capture the document up\n * front, run the confirmation, and only commit once the edit actually lands.\n *\n * Every entry carries a human label (\"Delete step\", \"Paste\"), so the shortcut\n * can say what it just reverted and a later phase can name AI checkpoints in\n * the same stack.\n *\n * PURE: plain data in, plain data out \u2014 no React, no xyflow runtime.\n */\n\nimport type { Node, Edge } from '@xyflow/react'\n\n/** Spec section 4.5: \"100 steps\". */\nexport const EDITOR_HISTORY_LIMIT = 100\n\n/**\n * The document the stack versions. `metadata` is the definition's editor-owned\n * metadata bag (pinned samples and, from step 3.9, annotations); the\n * definition-panel text fields are deliberately NOT on the stack \u2014 a text input\n * has its own native undo and committing per keystroke would evict real\n * structural edits from a 100-entry stack.\n */\n/**\n * The definition-panel fields the canvas does NOT carry \u2014 triggers, the context\n * schema, the sub-workflow port contract, the interpolation mode and the\n * workflow-level error handler.\n *\n * Kept OPAQUE here on purpose: this module must not learn the definition's\n * vocabulary to version it, and the page is the only thing that reads the\n * shape back. Versioning them matters because the Code view's Apply replaces\n * the WHOLE document \u2014 undoing it without them would restore the graph with\n * somebody else's triggers attached.\n */\nexport interface WorkflowEditorPanelState {\n  triggers: unknown\n  contextSchema: unknown\n  io: unknown\n  interpolation: unknown\n  errorHandler: unknown\n}\n\nexport interface WorkflowEditorDocument {\n  nodes: Node[]\n  edges: Edge[]\n  metadata: Record<string, unknown> | null\n  /**\n   * Absent on entries captured before this field existed, which is why every\n   * reader treats it as optional and simply leaves the panel alone when it is\n   * missing.\n   */\n  panel?: WorkflowEditorPanelState\n}\n\nexport interface EditorHistoryEntry<TDocument> {\n  /** Translated description of the edit this entry reverts. */\n  label: string\n  document: TDocument\n}\n\nexport interface EditorHistoryState<TDocument> {\n  past: EditorHistoryEntry<TDocument>[]\n  future: EditorHistoryEntry<TDocument>[]\n}\n\nexport interface EditorHistoryStep<TDocument> {\n  state: EditorHistoryState<TDocument>\n  document: TDocument\n  label: string\n}\n\nexport function createEditorHistory<TDocument>(): EditorHistoryState<TDocument> {\n  return { past: [], future: [] }\n}\n\n/**\n * Record an edit.\n *\n * `previousDocument` is the state to return to, and `label` names the edit that\n * replaced it. A new edit invalidates the redo branch: once the author has\n * diverged, the abandoned future is unreachable and keeping it would let a redo\n * resurrect a document that never followed from what is on screen.\n */\nexport function commitEditorHistory<TDocument>(\n  state: EditorHistoryState<TDocument>,\n  previousDocument: TDocument,\n  label: string,\n  limit: number = EDITOR_HISTORY_LIMIT,\n): EditorHistoryState<TDocument> {\n  const past = [...state.past, { label, document: previousDocument }]\n  return {\n    past: past.length > limit ? past.slice(past.length - limit) : past,\n    future: [],\n  }\n}\n\nexport function canUndoEditorHistory<TDocument>(state: EditorHistoryState<TDocument>): boolean {\n  return state.past.length > 0\n}\n\nexport function canRedoEditorHistory<TDocument>(state: EditorHistoryState<TDocument>): boolean {\n  return state.future.length > 0\n}\n\n/**\n * Step back one edit. Returns the document to restore plus the next stack\n * state, or `null` when there is nothing to undo. `currentDocument` is what is\n * on screen right now \u2014 it becomes the redo target.\n */\nexport function undoEditorHistory<TDocument>(\n  state: EditorHistoryState<TDocument>,\n  currentDocument: TDocument,\n): EditorHistoryStep<TDocument> | null {\n  const entry = state.past[state.past.length - 1]\n  if (!entry) return null\n  return {\n    state: {\n      past: state.past.slice(0, state.past.length - 1),\n      future: [{ label: entry.label, document: currentDocument }, ...state.future],\n    },\n    document: entry.document,\n    label: entry.label,\n  }\n}\n\n/** Step forward one previously undone edit. */\nexport function redoEditorHistory<TDocument>(\n  state: EditorHistoryState<TDocument>,\n  currentDocument: TDocument,\n): EditorHistoryStep<TDocument> | null {\n  const entry = state.future[0]\n  if (!entry) return null\n  return {\n    state: {\n      past: [...state.past, { label: entry.label, document: currentDocument }],\n      future: state.future.slice(1),\n    },\n    document: entry.document,\n    label: entry.label,\n  }\n}\n"],
+  "mappings": "AAwBO,MAAM,uBAAuB;AAyD7B,SAAS,sBAAgE;AAC9E,SAAO,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE;AAChC;AAUO,SAAS,oBACd,OACA,kBACA,OACA,QAAgB,sBACe;AAC/B,QAAM,OAAO,CAAC,GAAG,MAAM,MAAM,EAAE,OAAO,UAAU,iBAAiB,CAAC;AAClE,SAAO;AAAA,IACL,MAAM,KAAK,SAAS,QAAQ,KAAK,MAAM,KAAK,SAAS,KAAK,IAAI;AAAA,IAC9D,QAAQ,CAAC;AAAA,EACX;AACF;AAEO,SAAS,qBAAgC,OAA+C;AAC7F,SAAO,MAAM,KAAK,SAAS;AAC7B;AAEO,SAAS,qBAAgC,OAA+C;AAC7F,SAAO,MAAM,OAAO,SAAS;AAC/B;AAOO,SAAS,kBACd,OACA,iBACqC;AACrC,QAAM,QAAQ,MAAM,KAAK,MAAM,KAAK,SAAS,CAAC;AAC9C,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO;AAAA,IACL,OAAO;AAAA,MACL,MAAM,MAAM,KAAK,MAAM,GAAG,MAAM,KAAK,SAAS,CAAC;AAAA,MAC/C,QAAQ,CAAC,EAAE,OAAO,MAAM,OAAO,UAAU,gBAAgB,GAAG,GAAG,MAAM,MAAM;AAAA,IAC7E;AAAA,IACA,UAAU,MAAM;AAAA,IAChB,OAAO,MAAM;AAAA,EACf;AACF;AAGO,SAAS,kBACd,OACA,iBACqC;AACrC,QAAM,QAAQ,MAAM,OAAO,CAAC;AAC5B,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO;AAAA,IACL,OAAO;AAAA,MACL,MAAM,CAAC,GAAG,MAAM,MAAM,EAAE,OAAO,MAAM,OAAO,UAAU,gBAAgB,CAAC;AAAA,MACvE,QAAQ,MAAM,OAAO,MAAM,CAAC;AAAA,IAC9B;AAAA,IACA,UAAU,MAAM;AAAA,IAChB,OAAO,MAAM;AAAA,EACf;AACF;",
+  "names": []
+}

package/dist/modules/workflows/lib/endpoint-catalog.js

@@ -0,0 +1,181 @@
+import { ZodType } from "zod";
+import { getApiRouteManifests } from "@open-mercato/shared/modules/registry";
+import { getModules } from "@open-mercato/shared/lib/modules/registry";
+import { attachOpenApiDocsToModules, buildOpenApiDocument } from "@open-mercato/shared/lib/openapi";
+import { findMatchingEndpoint } from "./endpoint-path.js";
+const METHOD_ORDER = ["GET", "POST", "PUT", "PATCH", "DELETE"];
+const PARAM_LOCATIONS = /* @__PURE__ */ new Set(["path", "query", "header"]);
+const UNDECLARED_RESPONSE_DESCRIPTION = "Schema not declared";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function methodRank(method) {
+  const index = METHOD_ORDER.indexOf(method);
+  return index === -1 ? METHOD_ORDER.length : index;
+}
+function compareEndpoints(left, right) {
+  const byPath = left.path.localeCompare(right.path);
+  if (byPath !== 0) return byPath;
+  return methodRank(left.method) - methodRank(right.method);
+}
+function schemaTypeOf(schema) {
+  if (!isRecord(schema)) return "unknown";
+  if (typeof schema.type === "string" && schema.type.length > 0) return schema.type;
+  return "unknown";
+}
+function projectParams(parameters) {
+  if (!Array.isArray(parameters)) return [];
+  const params = [];
+  for (const parameter of parameters) {
+    if (!isRecord(parameter)) continue;
+    const name = parameter.name;
+    const location = parameter.in;
+    if (typeof name !== "string" || name.length === 0) continue;
+    if (typeof location !== "string" || !PARAM_LOCATIONS.has(location)) continue;
+    params.push({
+      name,
+      in: location,
+      required: parameter.required === true,
+      type: schemaTypeOf(parameter.schema)
+    });
+  }
+  return params;
+}
+function jsonContentSchema(container) {
+  if (!isRecord(container)) return void 0;
+  const content = container.content;
+  if (!isRecord(content)) return void 0;
+  const jsonEntry = content["application/json"];
+  if (!isRecord(jsonEntry)) return void 0;
+  const schema = jsonEntry.schema;
+  if (!isRecord(schema) || Object.keys(schema).length === 0) return void 0;
+  return schema;
+}
+function isDeclaredResponseSchema(schema) {
+  if (schema.description !== UNDECLARED_RESPONSE_DESCRIPTION) return true;
+  if (isRecord(schema.properties) && Object.keys(schema.properties).length > 0) return true;
+  return schema.type !== "object";
+}
+function projectSuccessResponseSchema(responses) {
+  if (!isRecord(responses)) return void 0;
+  const successStatuses = Object.keys(responses).map((status) => Number.parseInt(status, 10)).filter((status) => Number.isInteger(status) && status >= 200 && status < 300).sort((left, right) => left - right);
+  for (const status of successStatuses) {
+    const schema = jsonContentSchema(responses[String(status)]);
+    if (schema && isDeclaredResponseSchema(schema)) return schema;
+  }
+  return void 0;
+}
+function buildEndpointCatalog(modules) {
+  const doc = buildOpenApiDocument(modules);
+  const items = [];
+  for (const [docPath, operations] of Object.entries(doc.paths)) {
+    if (!isRecord(operations)) continue;
+    for (const [methodLower, operation] of Object.entries(operations)) {
+      const method = methodLower.toUpperCase();
+      if (methodRank(method) === METHOD_ORDER.length) continue;
+      if (!isRecord(operation)) continue;
+      const requestSchema = jsonContentSchema(operation.requestBody);
+      const responseSchema = projectSuccessResponseSchema(operation.responses);
+      const tags = operation.tags;
+      items.push({
+        path: `/api${docPath}`,
+        method,
+        summary: typeof operation.summary === "string" && operation.summary.length > 0 ? operation.summary : `${method} /api${docPath}`,
+        tag: Array.isArray(tags) && typeof tags[0] === "string" ? tags[0] : "",
+        params: projectParams(operation.parameters),
+        hasRequestSchema: requestSchema !== void 0,
+        ...requestSchema !== void 0 ? { requestSchema } : {},
+        ...responseSchema !== void 0 ? { responseSchema } : {}
+      });
+    }
+  }
+  items.sort(compareEndpoints);
+  return { items };
+}
+function normalizeDocPath(path) {
+  const segments = path.split("/").filter((segment) => segment.length > 0).map((segment) => {
+    const optionalCatchAll = segment.match(/^\[\[\.\.\.(.+)\]\]$/);
+    if (optionalCatchAll) return `{${optionalCatchAll[1]}}`;
+    const catchAll = segment.match(/^\[\.\.\.(.+)\]$/);
+    if (catchAll) return `{${catchAll[1]}}`;
+    const dynamic = segment.match(/^\[(.+)\]$/);
+    if (dynamic) return `{${dynamic[1]}}`;
+    return segment;
+  });
+  return `/${segments.join("/")}`;
+}
+function successResponseZodSchema(methodDoc) {
+  if (!methodDoc || !Array.isArray(methodDoc.responses)) return null;
+  const declaredSuccesses = methodDoc.responses.filter(
+    (response) => typeof response?.status === "number" && response.status >= 200 && response.status < 300 && response.schema instanceof ZodType
+  ).sort((left, right) => left.status - right.status);
+  const schema = declaredSuccesses[0]?.schema;
+  return schema instanceof ZodType ? schema : null;
+}
+function buildResponseSchemaIndex(modules) {
+  const entries = [];
+  for (const moduleEntry of modules) {
+    for (const api of moduleEntry.apis ?? []) {
+      const rawPath = api.path;
+      if (typeof rawPath !== "string" || rawPath.length === 0) continue;
+      const path = `/api${normalizeDocPath(rawPath)}`;
+      if ("handlers" in api) {
+        const handlers = api.handlers ?? {};
+        const docs = api.docs;
+        for (const method of METHOD_ORDER) {
+          if (typeof handlers[method] !== "function") continue;
+          entries.push({ path, method, schema: successResponseZodSchema(docs?.methods?.[method]) });
+        }
+        continue;
+      }
+      const legacyMethod = api.method;
+      if (typeof legacyMethod !== "string" || legacyMethod.length === 0) continue;
+      entries.push({
+        path,
+        method: legacyMethod.toUpperCase(),
+        schema: successResponseZodSchema(api.docs)
+      });
+    }
+  }
+  return entries;
+}
+let catalogPromise = null;
+let responseSchemaIndex = null;
+async function assembleCatalog() {
+  const docModules = await attachOpenApiDocsToModules(getModules(), getApiRouteManifests());
+  responseSchemaIndex = buildResponseSchemaIndex(docModules);
+  return buildEndpointCatalog(docModules);
+}
+async function getWorkflowEndpointCatalog() {
+  if (!catalogPromise) {
+    catalogPromise = assembleCatalog().catch((error) => {
+      catalogPromise = null;
+      throw error;
+    });
+  }
+  return catalogPromise;
+}
+async function ensureWorkflowEndpointCatalog() {
+  try {
+    await getWorkflowEndpointCatalog();
+  } catch {
+    return;
+  }
+}
+function findEndpointResponseSchema(endpoint, method) {
+  if (!responseSchemaIndex) return null;
+  const matched = findMatchingEndpoint(endpoint, method, responseSchemaIndex);
+  return matched ? matched.item.schema : null;
+}
+function clearWorkflowEndpointCatalogForTests() {
+  catalogPromise = null;
+  responseSchemaIndex = null;
+}
+export {
+  buildEndpointCatalog,
+  clearWorkflowEndpointCatalogForTests,
+  ensureWorkflowEndpointCatalog,
+  findEndpointResponseSchema,
+  getWorkflowEndpointCatalog
+};
+//# sourceMappingURL=endpoint-catalog.js.map