@seed-ship/mcp-ui-solid 6.6.0 → 6.7.0

package/CHANGELOG.md

@@ -5,6 +5,68 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [6.7.0] - 2026-05-22
+
+### Added — MacroRun Phase 2 adapters
+
+Pure adapters from the `MacroRunV1` contract (new in
+`@seed-ship/mcp-ui-spec@5.3.0`) to existing MCP-UI primitives. Published on
+the opt-in `@seed-ship/mcp-ui-solid/adapters` subpath — never imported by the
+core renderer path.
+
+- `macroRunToScratchpadState(run: MacroRunV1): ScratchpadState` — builds an
+  `agent_card` section, a `stepper` (or `split_stepper` when steps carry
+  `parallel` branches), a `prompt` section for an embedded
+  `pendingInterrogation`, and one section per `results` entry. Run status
+  maps `pending→loading`, `running→processing`, `awaiting_input→waiting_human`,
+  `completed→complete`, `failed`/`aborted`→`error` (aborted is never
+  retryable). `results` is optional — the adapter works without UI results.
+- `macroInterrogationToChatPromptConfig(q: MacroInterrogationV1): ChatPromptConfig`
+  — maps `choice` / `confirm` / `form` directly, and routes `elicitation`
+  through the existing `elicitationToPromptConfig()` helper. Always returns a
+  `ChatPromptConfig`. Usable standalone or via `macroRunToScratchpadState`.
+
+Both are **pure functions** — no fetch, no SSE listener, no persistence, no
+global state.
+
+**Out of scope (host / runtime responsibility):** the producer runtime that
+emits a `macro-run/v1` snapshot (a later goal on the producing repo), and all
+host-side wiring — SSE listener, fetch, persistence, resume. These adapters
+only translate a snapshot the host already has. The `action:'submit'`
+executors are untouched, and MacroRun is kept separate from the tool-call
+action path.
+
+## [6.6.1] - 2026-05-22
+
+### Fixed — `action: 'submit'` is no longer inert outside a `<form>`
+
+`ActionParamsSchema.action` allows `'tool-call' | 'link' | 'submit'`, but
+at runtime `submit` did nothing : `ActionGroupRenderer` only branched on
+`tool-call` / `link`, and the standalone `action` renderer emitted a
+native `type="submit"` button — which only fires inside a real `<form>`.
+Standalone resources rendered by `<UIResourceRenderer>` have no
+surrounding form, so the click was inert.
+
+`submit` actions now route through the host executor — like `tool-call`,
+but **not treated as a tool call** :
+
+- `<ActionGroupRenderer>` and the standalone `action` renderer both call
+  `executeAction({ action: 'submit', toolName, params })` on click.
+- The action **kind** is preserved : `ActionRequest` gains an optional
+  `action?: 'tool-call' | 'submit' | 'link'` field so a host `executor`
+  can tell a submit apart from a tool call (e.g. POST to
+  `params.submit_url`). The full `params` payload (`submit_url`,
+  `connector_id`, `feedback_value`, `preferred_layout`, …) is passed
+  through intact.
+- The submit button is now `type="button"` (JS-handled) — it works with
+  no surrounding `<form>`, and shows the same loading / disabled state as
+  a `tool-call` button.
+- The `defaultExecutor` `mcp-action` `CustomEvent` detail now carries
+  `action`, so a window-level listener can route submits too.
+
+Backward compatible : `action` is optional everywhere and absent on every
+pre-6.6.1 request — a request without it is still treated as `tool-call`.
+
 ## [6.6.0] - 2026-05-21
 
 Sprint OpenData / macros — cf. `docs/briefs/ROADMAP-opendata-macro-mcpui.md`

package/dist/adapters/index.d.ts

@@ -13,6 +13,7 @@
  * // → <UIResourceRenderer content={layout} />
  * ```
  */
-export { connectorResultToUILayout, connectorActionsToActionGroup, } from './connector';
+export { connectorResultToUILayout, connectorActionsToActionGroup } from './connector';
 export type { ConnectorResultToUILayoutOptions, ConnectorActionsToActionGroupOptions, } from './connector';
+export { macroRunToScratchpadState, macroInterrogationToChatPromptConfig } from './macro-run';
 //# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EACV,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,yBAAyB,EAAE,oCAAoC,EAAE,MAAM,aAAa,CAAC"}

package/dist/adapters/macro-run.cjs

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const chatBus = require("../services/chat-bus.cjs");
+const RUN_STATUS_TO_SCRATCHPAD = {
+  pending: "loading",
+  running: "processing",
+  awaiting_input: "waiting_human",
+  completed: "complete",
+  failed: "error",
+  aborted: "error"
+};
+function runStatusToAgentStatus(status) {
+  switch (status) {
+    case "pending":
+      return "idle";
+    case "running":
+      return "running";
+    case "awaiting_input":
+      return "waiting";
+    case "completed":
+      return "done";
+    case "failed":
+    case "aborted":
+      return "error";
+  }
+}
+function stepToStepperStatus(status) {
+  return status === "failed" ? "error" : status;
+}
+function buildAgentCard(run) {
+  const agent = run.agent;
+  const card = {
+    agentId: (agent == null ? void 0 : agent.id) ?? run.macroId,
+    name: (agent == null ? void 0 : agent.name) ?? run.macroName ?? run.macroId,
+    status: (agent == null ? void 0 : agent.status) ?? runStatusToAgentStatus(run.status)
+  };
+  if (agent == null ? void 0 : agent.avatar) card.avatar = agent.avatar;
+  if (agent == null ? void 0 : agent.capabilities) card.capabilities = agent.capabilities;
+  if (agent == null ? void 0 : agent.currentStep) card.currentStep = agent.currentStep;
+  return card;
+}
+function buildStepperContent(steps) {
+  return {
+    orientation: "horizontal",
+    steps: steps.map((step) => {
+      const out = {
+        id: step.id,
+        label: step.label,
+        status: stepToStepperStatus(step.status)
+      };
+      if (step.summary) out.summary = step.summary;
+      if (typeof step.durationMs === "number") out.duration_ms = step.durationMs;
+      return out;
+    })
+  };
+}
+function laneStatus(subSteps) {
+  if (subSteps.some((s) => s.status === "failed")) return "error";
+  if (subSteps.some((s) => s.status === "active")) return "active";
+  if (subSteps.length > 0 && subSteps.every((s) => s.status === "done" || s.status === "skipped"))
+    return "done";
+  return "pending";
+}
+function buildSplitStepperContent(steps) {
+  return {
+    agents: steps.map((step) => {
+      const subSteps = step.parallel && step.parallel.length > 0 ? step.parallel : [step];
+      return {
+        id: step.id,
+        name: step.label,
+        status: laneStatus(subSteps),
+        steps: subSteps.map((sub) => ({
+          id: sub.id,
+          label: sub.label,
+          status: stepToStepperStatus(sub.status)
+        }))
+      };
+    })
+  };
+}
+function resultSectionType(componentType) {
+  switch (componentType) {
+    case "chart":
+      return "chart";
+    case "map":
+      return "map";
+    case "table":
+      return "data_preview";
+    default:
+      return "data";
+  }
+}
+function buildError(run) {
+  if (run.status !== "failed" && run.status !== "aborted") return void 0;
+  const aborted = run.status === "aborted";
+  if (run.error) {
+    const err = {
+      message: run.error.message,
+      // An aborted run is never retryable, regardless of the producer flag.
+      retryable: aborted ? false : run.error.retryable ?? false
+    };
+    if (run.error.code) err.code = run.error.code;
+    return err;
+  }
+  return {
+    message: aborted ? "Macro run aborted." : "Macro run failed.",
+    retryable: false
+  };
+}
+function macroRunToScratchpadState(run) {
+  const sections = [];
+  sections.push({
+    id: "macro-agent",
+    title: "Agent",
+    type: "agent_card",
+    content: buildAgentCard(run),
+    editable: false,
+    source: "agent"
+  });
+  if (run.steps.length > 0) {
+    const hasParallel = run.steps.some((s) => Array.isArray(s.parallel) && s.parallel.length > 0);
+    sections.push(
+      hasParallel ? {
+        id: "macro-split-stepper",
+        title: "Progress",
+        type: "split_stepper",
+        content: buildSplitStepperContent(run.steps),
+        editable: false,
+        source: "agent"
+      } : {
+        id: "macro-stepper",
+        title: "Progress",
+        type: "stepper",
+        content: buildStepperContent(run.steps),
+        editable: false,
+        source: "agent"
+      }
+    );
+  }
+  if (run.pendingInterrogation) {
+    sections.push({
+      id: "macro-prompt",
+      title: run.pendingInterrogation.title,
+      type: "prompt",
+      content: macroInterrogationToChatPromptConfig(run.pendingInterrogation),
+      editable: false,
+      source: "agent"
+    });
+  }
+  const results = run.results ?? [];
+  results.forEach((component, index) => {
+    sections.push({
+      id: `macro-result-${String((component == null ? void 0 : component.id) ?? index)}`,
+      title: "Result",
+      type: resultSectionType(component == null ? void 0 : component.type),
+      content: component,
+      editable: false,
+      source: "agent"
+    });
+  });
+  const state = {
+    id: run.runId,
+    title: run.title ?? run.macroName ?? run.macroId,
+    sections,
+    filters: {},
+    agentMessages: [],
+    status: RUN_STATUS_TO_SCRATCHPAD[run.status]
+  };
+  const error = buildError(run);
+  if (error) state.error = error;
+  return state;
+}
+function isElicitationSchema(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  return v.type === "object" && typeof v.properties === "object" && v.properties !== null;
+}
+function macroInterrogationToChatPromptConfig(q) {
+  var _a, _b, _c;
+  switch (q.kind) {
+    case "choice": {
+      const options = (q.options ?? []).map((o) => {
+        const opt = { value: o.value, label: o.label };
+        if (o.icon) opt.icon = o.icon;
+        if (o.description) opt.description = o.description;
+        if (o.metadata) opt.metadata = o.metadata;
+        return opt;
+      });
+      return {
+        type: "choice",
+        title: q.title,
+        config: { options, layout: "vertical" }
+      };
+    }
+    case "confirm": {
+      const config = {};
+      if (q.message) config.message = q.message;
+      if ((_a = q.confirm) == null ? void 0 : _a.confirmLabel) config.confirmLabel = q.confirm.confirmLabel;
+      if ((_b = q.confirm) == null ? void 0 : _b.cancelLabel) config.cancelLabel = q.confirm.cancelLabel;
+      if ((_c = q.confirm) == null ? void 0 : _c.variant) config.variant = q.confirm.variant;
+      return { type: "confirm", title: q.title, config };
+    }
+    case "form":
+      return {
+        type: "form",
+        title: q.title,
+        config: { fields: q.fields ?? [] }
+      };
+    case "elicitation": {
+      if (isElicitationSchema(q.elicitationSchema)) {
+        return chatBus.elicitationToPromptConfig({
+          message: q.message ?? q.title,
+          requestedSchema: q.elicitationSchema
+        });
+      }
+      return {
+        type: "confirm",
+        title: q.title,
+        config: { message: q.message ?? "Please confirm to continue." }
+      };
+    }
+  }
+}
+exports.macroInterrogationToChatPromptConfig = macroInterrogationToChatPromptConfig;
+exports.macroRunToScratchpadState = macroRunToScratchpadState;
+//# sourceMappingURL=macro-run.cjs.map

package/dist/adapters/macro-run.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"macro-run.cjs","sources":["../../src/adapters/macro-run.ts"],"sourcesContent":["/**\n * MacroRun adapters — `MacroRunV1` / `MacroInterrogationV1` → MCP-UI render\n * primitives.\n *\n * @since v6.7.0 (MacroRun Phase 2 — contract consolidated in deposium_MCPs\n *   `docs/2026/briefs/2026-05-22-macro-run-runtime-contract-consolidation.md`)\n *\n * ## Opt-in, pure\n *\n * Published under the dedicated subpath `@seed-ship/mcp-ui-solid/adapters` —\n * never imported by the core renderer path. Every function here is a **pure\n * function**: same input → same output, no `fetch`, no SSE listener, no\n * persistence, no global state, no clock, no randomness.\n *\n * ## Scope boundary\n *\n * These adapters only translate the agnostic `MacroRunV1` contract (defined\n * in `@seed-ship/mcp-ui-spec`) into existing MCP-UI primitives — a\n * `ScratchpadState` and a `ChatPromptConfig`. They do NOT:\n *\n * - emit or consume any SSE event (a `macro_run_snapshot` producer is a\n *   separate, later goal on the producing runtime repo);\n * - perform any fetch, persistence or resume;\n * - know anything about a specific runtime, host, corpus or domain;\n * - touch the `action:'submit'` executors, nor mix MacroRun with the\n *   existing tool-call action path.\n *\n * The host owns all of the above — it feeds a `MacroRunV1` snapshot in and\n * decides where to render the result.\n */\n\nimport type { MacroRunV1, MacroStepV1, MacroInterrogationV1 } from '@seed-ship/mcp-ui-spec';\nimport type {\n  ScratchpadState,\n  ScratchpadSection,\n  ChatPromptConfig,\n  ChoiceOption,\n  ConfirmPromptConfig,\n  AgentCardContent,\n  SplitStepperContent,\n  ElicitationRequestedSchema,\n  FormPromptConfig,\n} from '../types/chat-bus';\nimport { elicitationToPromptConfig } from '../services/chat-bus';\n\n// ─── Status mappings ─────────────────────────────────────────\n\n/**\n * Run status → top-level `ScratchpadState` status. `aborted` and `failed`\n * both surface as `error` (an aborted run is additionally non-retryable —\n * see `buildError`).\n */\nconst RUN_STATUS_TO_SCRATCHPAD: Record<MacroRunV1['status'], ScratchpadState['status']> = {\n  pending: 'loading',\n  running: 'processing',\n  awaiting_input: 'waiting_human',\n  completed: 'complete',\n  failed: 'error',\n  aborted: 'error',\n};\n\n/** Run status → `AgentCardContent` status, used when the run carries no agent. */\nfunction runStatusToAgentStatus(status: MacroRunV1['status']): AgentCardContent['status'] {\n  switch (status) {\n    case 'pending':\n      return 'idle';\n    case 'running':\n      return 'running';\n    case 'awaiting_input':\n      return 'waiting';\n    case 'completed':\n      return 'done';\n    case 'failed':\n    case 'aborted':\n      return 'error';\n  }\n}\n\n/**\n * Step status → stepper status. The MCP-UI stepper primitive renders\n * `failed` as `error`; every other value passes through unchanged.\n */\nfunction stepToStepperStatus(\n  status: MacroStepV1['status']\n): 'pending' | 'active' | 'done' | 'skipped' | 'error' {\n  return status === 'failed' ? 'error' : status;\n}\n\n// ─── Section builders ────────────────────────────────────────\n\ninterface StepperSectionContent {\n  steps: Array<{\n    id: string;\n    label: string;\n    status: 'pending' | 'active' | 'done' | 'skipped' | 'error';\n    summary?: string;\n    duration_ms?: number;\n  }>;\n  orientation: 'horizontal' | 'vertical';\n}\n\nfunction buildAgentCard(run: MacroRunV1): AgentCardContent {\n  const agent = run.agent;\n  const card: AgentCardContent = {\n    agentId: agent?.id ?? run.macroId,\n    name: agent?.name ?? run.macroName ?? run.macroId,\n    status: agent?.status ?? runStatusToAgentStatus(run.status),\n  };\n  if (agent?.avatar) card.avatar = agent.avatar;\n  if (agent?.capabilities) card.capabilities = agent.capabilities;\n  if (agent?.currentStep) card.currentStep = agent.currentStep;\n  return card;\n}\n\nfunction buildStepperContent(steps: MacroStepV1[]): StepperSectionContent {\n  return {\n    orientation: 'horizontal',\n    steps: steps.map((step) => {\n      const out: StepperSectionContent['steps'][number] = {\n        id: step.id,\n        label: step.label,\n        status: stepToStepperStatus(step.status),\n      };\n      if (step.summary) out.summary = step.summary;\n      if (typeof step.durationMs === 'number') out.duration_ms = step.durationMs;\n      return out;\n    }),\n  };\n}\n\n/** Collapse a set of sub-step statuses into a single parallel-lane status. */\nfunction laneStatus(subSteps: MacroStepV1[]): 'done' | 'active' | 'pending' | 'error' {\n  if (subSteps.some((s) => s.status === 'failed')) return 'error';\n  if (subSteps.some((s) => s.status === 'active')) return 'active';\n  if (subSteps.length > 0 && subSteps.every((s) => s.status === 'done' || s.status === 'skipped'))\n    return 'done';\n  return 'pending';\n}\n\n/**\n * Build a `split_stepper` content from steps that carry `parallel` branches.\n * Each top-level step becomes a lane: a step with `parallel` sub-steps shows\n * those sub-steps; a step without falls back to a single-step lane.\n */\nfunction buildSplitStepperContent(steps: MacroStepV1[]): SplitStepperContent {\n  return {\n    agents: steps.map((step) => {\n      const subSteps = step.parallel && step.parallel.length > 0 ? step.parallel : [step];\n      return {\n        id: step.id,\n        name: step.label,\n        status: laneStatus(subSteps),\n        steps: subSteps.map((sub) => ({\n          id: sub.id,\n          label: sub.label,\n          status: stepToStepperStatus(sub.status),\n        })),\n      };\n    }),\n  };\n}\n\n/** Component `type` → the closest `ScratchpadSection` type for a result. */\nfunction resultSectionType(componentType: unknown): ScratchpadSection['type'] {\n  switch (componentType) {\n    case 'chart':\n      return 'chart';\n    case 'map':\n      return 'map';\n    case 'table':\n      return 'data_preview';\n    default:\n      return 'data';\n  }\n}\n\nfunction buildError(run: MacroRunV1): ScratchpadState['error'] | undefined {\n  if (run.status !== 'failed' && run.status !== 'aborted') return undefined;\n  const aborted = run.status === 'aborted';\n  if (run.error) {\n    const err: NonNullable<ScratchpadState['error']> = {\n      message: run.error.message,\n      // An aborted run is never retryable, regardless of the producer flag.\n      retryable: aborted ? false : (run.error.retryable ?? false),\n    };\n    if (run.error.code) err.code = run.error.code;\n    return err;\n  }\n  return {\n    message: aborted ? 'Macro run aborted.' : 'Macro run failed.',\n    retryable: false,\n  };\n}\n\n// ─── macroRunToScratchpadState ───────────────────────────────\n\n/**\n * Convert a `MacroRunV1` snapshot into a `ScratchpadState`.\n *\n * Sections produced, in order:\n * 1. `agent_card` — always (derived from `run.agent`, or from the macro\n *    identity when the run carries no agent, e.g. a non-interactive macro).\n * 2. `stepper` — when the run has steps and none carry `parallel` branches.\n *    `split_stepper` instead when any step carries `parallel` (future model).\n * 3. `prompt` — when `run.pendingInterrogation` is set; its content is the\n *    `ChatPromptConfig` produced by {@link macroInterrogationToChatPromptConfig}.\n * 4. one section per `run.results` entry (`chart` / `map` / `data_preview` /\n *    `data`, by component type). Optional — the adapter works without results.\n *\n * Pure: no fetch, no SSE, no persistence. The host owns all wiring.\n */\nexport function macroRunToScratchpadState(run: MacroRunV1): ScratchpadState {\n  const sections: ScratchpadSection[] = [];\n\n  // 1. Agent card — always present.\n  sections.push({\n    id: 'macro-agent',\n    title: 'Agent',\n    type: 'agent_card',\n    content: buildAgentCard(run),\n    editable: false,\n    source: 'agent',\n  });\n\n  // 2. Stepper / split_stepper — when there are steps.\n  if (run.steps.length > 0) {\n    const hasParallel = run.steps.some((s) => Array.isArray(s.parallel) && s.parallel.length > 0);\n    sections.push(\n      hasParallel\n        ? {\n            id: 'macro-split-stepper',\n            title: 'Progress',\n            type: 'split_stepper',\n            content: buildSplitStepperContent(run.steps),\n            editable: false,\n            source: 'agent',\n          }\n        : {\n            id: 'macro-stepper',\n            title: 'Progress',\n            type: 'stepper',\n            content: buildStepperContent(run.steps),\n            editable: false,\n            source: 'agent',\n          }\n    );\n  }\n\n  // 3. Pending interrogation → a `prompt` section.\n  if (run.pendingInterrogation) {\n    sections.push({\n      id: 'macro-prompt',\n      title: run.pendingInterrogation.title,\n      type: 'prompt',\n      content: macroInterrogationToChatPromptConfig(run.pendingInterrogation),\n      editable: false,\n      source: 'agent',\n    });\n  }\n\n  // 4. Result components → one section each (results are optional). A result\n  // is a `UIComponent`-shaped object — passthrough, read loosely (the spec\n  // validates the run envelope, the renderer validates each component).\n  const results = run.results ?? [];\n  results.forEach((component, index) => {\n    sections.push({\n      id: `macro-result-${String(component?.id ?? index)}`,\n      title: 'Result',\n      type: resultSectionType(component?.type),\n      content: component,\n      editable: false,\n      source: 'agent',\n    });\n  });\n\n  const state: ScratchpadState = {\n    id: run.runId,\n    title: run.title ?? run.macroName ?? run.macroId,\n    sections,\n    filters: {},\n    agentMessages: [],\n    status: RUN_STATUS_TO_SCRATCHPAD[run.status],\n  };\n\n  const error = buildError(run);\n  if (error) state.error = error;\n\n  return state;\n}\n\n// ─── macroInterrogationToChatPromptConfig ────────────────────\n\nfunction isElicitationSchema(value: unknown): value is ElicitationRequestedSchema {\n  if (typeof value !== 'object' || value === null) return false;\n  const v = value as { type?: unknown; properties?: unknown };\n  return v.type === 'object' && typeof v.properties === 'object' && v.properties !== null;\n}\n\n/**\n * Convert a `MacroInterrogationV1` into a `ChatPromptConfig`.\n *\n * - `choice` → `{ type: 'choice' }` (vertical layout).\n * - `confirm` → `{ type: 'confirm' }`.\n * - `form` → `{ type: 'form' }` (the opaque `fields` are passed through).\n * - `elicitation` → routed through the existing `elicitationToPromptConfig()`\n *   helper. If the interrogation carries no usable elicitation JSON Schema,\n *   it degrades to a `confirm` prompt rather than throwing.\n *\n * Always returns a `ChatPromptConfig` — never an `ElicitationEvent` — so the\n * host has a single entry point. Usable standalone or via\n * {@link macroRunToScratchpadState} (which calls it for an embedded\n * `pendingInterrogation`).\n */\nexport function macroInterrogationToChatPromptConfig(q: MacroInterrogationV1): ChatPromptConfig {\n  switch (q.kind) {\n    case 'choice': {\n      const options: ChoiceOption[] = (q.options ?? []).map((o) => {\n        const opt: ChoiceOption = { value: o.value, label: o.label };\n        if (o.icon) opt.icon = o.icon;\n        if (o.description) opt.description = o.description;\n        if (o.metadata) opt.metadata = o.metadata;\n        return opt;\n      });\n      return {\n        type: 'choice',\n        title: q.title,\n        config: { options, layout: 'vertical' },\n      };\n    }\n\n    case 'confirm': {\n      const config: ConfirmPromptConfig = {};\n      if (q.message) config.message = q.message;\n      if (q.confirm?.confirmLabel) config.confirmLabel = q.confirm.confirmLabel;\n      if (q.confirm?.cancelLabel) config.cancelLabel = q.confirm.cancelLabel;\n      if (q.confirm?.variant) config.variant = q.confirm.variant;\n      return { type: 'confirm', title: q.title, config };\n    }\n\n    case 'form':\n      return {\n        type: 'form',\n        title: q.title,\n        config: { fields: (q.fields ?? []) as FormPromptConfig['fields'] },\n      };\n\n    case 'elicitation': {\n      if (isElicitationSchema(q.elicitationSchema)) {\n        return elicitationToPromptConfig({\n          message: q.message ?? q.title,\n          requestedSchema: q.elicitationSchema,\n        });\n      }\n      // No usable schema — degrade gracefully instead of crashing.\n      return {\n        type: 'confirm',\n        title: q.title,\n        config: { message: q.message ?? 'Please confirm to continue.' },\n      };\n    }\n  }\n}\n"],"names":["elicitationToPromptConfig"],"mappings":"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"}

package/dist/adapters/macro-run.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MacroRun adapters — `MacroRunV1` / `MacroInterrogationV1` → MCP-UI render
+ * primitives.
+ *
+ * @since v6.7.0 (MacroRun Phase 2 — contract consolidated in deposium_MCPs
+ *   `docs/2026/briefs/2026-05-22-macro-run-runtime-contract-consolidation.md`)
+ *
+ * ## Opt-in, pure
+ *
+ * Published under the dedicated subpath `@seed-ship/mcp-ui-solid/adapters` —
+ * never imported by the core renderer path. Every function here is a **pure
+ * function**: same input → same output, no `fetch`, no SSE listener, no
+ * persistence, no global state, no clock, no randomness.
+ *
+ * ## Scope boundary
+ *
+ * These adapters only translate the agnostic `MacroRunV1` contract (defined
+ * in `@seed-ship/mcp-ui-spec`) into existing MCP-UI primitives — a
+ * `ScratchpadState` and a `ChatPromptConfig`. They do NOT:
+ *
+ * - emit or consume any SSE event (a `macro_run_snapshot` producer is a
+ *   separate, later goal on the producing runtime repo);
+ * - perform any fetch, persistence or resume;
+ * - know anything about a specific runtime, host, corpus or domain;
+ * - touch the `action:'submit'` executors, nor mix MacroRun with the
+ *   existing tool-call action path.
+ *
+ * The host owns all of the above — it feeds a `MacroRunV1` snapshot in and
+ * decides where to render the result.
+ */
+import type { MacroRunV1, MacroInterrogationV1 } from '@seed-ship/mcp-ui-spec';
+import type { ScratchpadState, ChatPromptConfig } from '../types/chat-bus';
+/**
+ * Convert a `MacroRunV1` snapshot into a `ScratchpadState`.
+ *
+ * Sections produced, in order:
+ * 1. `agent_card` — always (derived from `run.agent`, or from the macro
+ *    identity when the run carries no agent, e.g. a non-interactive macro).
+ * 2. `stepper` — when the run has steps and none carry `parallel` branches.
+ *    `split_stepper` instead when any step carries `parallel` (future model).
+ * 3. `prompt` — when `run.pendingInterrogation` is set; its content is the
+ *    `ChatPromptConfig` produced by {@link macroInterrogationToChatPromptConfig}.
+ * 4. one section per `run.results` entry (`chart` / `map` / `data_preview` /
+ *    `data`, by component type). Optional — the adapter works without results.
+ *
+ * Pure: no fetch, no SSE, no persistence. The host owns all wiring.
+ */
+export declare function macroRunToScratchpadState(run: MacroRunV1): ScratchpadState;
+/**
+ * Convert a `MacroInterrogationV1` into a `ChatPromptConfig`.
+ *
+ * - `choice` → `{ type: 'choice' }` (vertical layout).
+ * - `confirm` → `{ type: 'confirm' }`.
+ * - `form` → `{ type: 'form' }` (the opaque `fields` are passed through).
+ * - `elicitation` → routed through the existing `elicitationToPromptConfig()`
+ *   helper. If the interrogation carries no usable elicitation JSON Schema,
+ *   it degrades to a `confirm` prompt rather than throwing.
+ *
+ * Always returns a `ChatPromptConfig` — never an `ElicitationEvent` — so the
+ * host has a single entry point. Usable standalone or via
+ * {@link macroRunToScratchpadState} (which calls it for an embedded
+ * `pendingInterrogation`).
+ */
+export declare function macroInterrogationToChatPromptConfig(q: MacroInterrogationV1): ChatPromptConfig;
+//# sourceMappingURL=macro-run.d.ts.map

package/dist/adapters/macro-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"macro-run.d.ts","sourceRoot":"","sources":["../../src/adapters/macro-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,KAAK,EACV,eAAe,EAEf,gBAAgB,EAOjB,MAAM,mBAAmB,CAAC;AA0J3B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,UAAU,GAAG,eAAe,CA6E1E;AAUD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oCAAoC,CAAC,CAAC,EAAE,oBAAoB,GAAG,gBAAgB,CAgD9F"}

package/dist/adapters/macro-run.js

@@ -0,0 +1,226 @@
+import { elicitationToPromptConfig } from "../services/chat-bus.js";
+const RUN_STATUS_TO_SCRATCHPAD = {
+  pending: "loading",
+  running: "processing",
+  awaiting_input: "waiting_human",
+  completed: "complete",
+  failed: "error",
+  aborted: "error"
+};
+function runStatusToAgentStatus(status) {
+  switch (status) {
+    case "pending":
+      return "idle";
+    case "running":
+      return "running";
+    case "awaiting_input":
+      return "waiting";
+    case "completed":
+      return "done";
+    case "failed":
+    case "aborted":
+      return "error";
+  }
+}
+function stepToStepperStatus(status) {
+  return status === "failed" ? "error" : status;
+}
+function buildAgentCard(run) {
+  const agent = run.agent;
+  const card = {
+    agentId: (agent == null ? void 0 : agent.id) ?? run.macroId,
+    name: (agent == null ? void 0 : agent.name) ?? run.macroName ?? run.macroId,
+    status: (agent == null ? void 0 : agent.status) ?? runStatusToAgentStatus(run.status)
+  };
+  if (agent == null ? void 0 : agent.avatar) card.avatar = agent.avatar;
+  if (agent == null ? void 0 : agent.capabilities) card.capabilities = agent.capabilities;
+  if (agent == null ? void 0 : agent.currentStep) card.currentStep = agent.currentStep;
+  return card;
+}
+function buildStepperContent(steps) {
+  return {
+    orientation: "horizontal",
+    steps: steps.map((step) => {
+      const out = {
+        id: step.id,
+        label: step.label,
+        status: stepToStepperStatus(step.status)
+      };
+      if (step.summary) out.summary = step.summary;
+      if (typeof step.durationMs === "number") out.duration_ms = step.durationMs;
+      return out;
+    })
+  };
+}
+function laneStatus(subSteps) {
+  if (subSteps.some((s) => s.status === "failed")) return "error";
+  if (subSteps.some((s) => s.status === "active")) return "active";
+  if (subSteps.length > 0 && subSteps.every((s) => s.status === "done" || s.status === "skipped"))
+    return "done";
+  return "pending";
+}
+function buildSplitStepperContent(steps) {
+  return {
+    agents: steps.map((step) => {
+      const subSteps = step.parallel && step.parallel.length > 0 ? step.parallel : [step];
+      return {
+        id: step.id,
+        name: step.label,
+        status: laneStatus(subSteps),
+        steps: subSteps.map((sub) => ({
+          id: sub.id,
+          label: sub.label,
+          status: stepToStepperStatus(sub.status)
+        }))
+      };
+    })
+  };
+}
+function resultSectionType(componentType) {
+  switch (componentType) {
+    case "chart":
+      return "chart";
+    case "map":
+      return "map";
+    case "table":
+      return "data_preview";
+    default:
+      return "data";
+  }
+}
+function buildError(run) {
+  if (run.status !== "failed" && run.status !== "aborted") return void 0;
+  const aborted = run.status === "aborted";
+  if (run.error) {
+    const err = {
+      message: run.error.message,
+      // An aborted run is never retryable, regardless of the producer flag.
+      retryable: aborted ? false : run.error.retryable ?? false
+    };
+    if (run.error.code) err.code = run.error.code;
+    return err;
+  }
+  return {
+    message: aborted ? "Macro run aborted." : "Macro run failed.",
+    retryable: false
+  };
+}
+function macroRunToScratchpadState(run) {
+  const sections = [];
+  sections.push({
+    id: "macro-agent",
+    title: "Agent",
+    type: "agent_card",
+    content: buildAgentCard(run),
+    editable: false,
+    source: "agent"
+  });
+  if (run.steps.length > 0) {
+    const hasParallel = run.steps.some((s) => Array.isArray(s.parallel) && s.parallel.length > 0);
+    sections.push(
+      hasParallel ? {
+        id: "macro-split-stepper",
+        title: "Progress",
+        type: "split_stepper",
+        content: buildSplitStepperContent(run.steps),
+        editable: false,
+        source: "agent"
+      } : {
+        id: "macro-stepper",
+        title: "Progress",
+        type: "stepper",
+        content: buildStepperContent(run.steps),
+        editable: false,
+        source: "agent"
+      }
+    );
+  }
+  if (run.pendingInterrogation) {
+    sections.push({
+      id: "macro-prompt",
+      title: run.pendingInterrogation.title,
+      type: "prompt",
+      content: macroInterrogationToChatPromptConfig(run.pendingInterrogation),
+      editable: false,
+      source: "agent"
+    });
+  }
+  const results = run.results ?? [];
+  results.forEach((component, index) => {
+    sections.push({
+      id: `macro-result-${String((component == null ? void 0 : component.id) ?? index)}`,
+      title: "Result",
+      type: resultSectionType(component == null ? void 0 : component.type),
+      content: component,
+      editable: false,
+      source: "agent"
+    });
+  });
+  const state = {
+    id: run.runId,
+    title: run.title ?? run.macroName ?? run.macroId,
+    sections,
+    filters: {},
+    agentMessages: [],
+    status: RUN_STATUS_TO_SCRATCHPAD[run.status]
+  };
+  const error = buildError(run);
+  if (error) state.error = error;
+  return state;
+}
+function isElicitationSchema(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  return v.type === "object" && typeof v.properties === "object" && v.properties !== null;
+}
+function macroInterrogationToChatPromptConfig(q) {
+  var _a, _b, _c;
+  switch (q.kind) {
+    case "choice": {
+      const options = (q.options ?? []).map((o) => {
+        const opt = { value: o.value, label: o.label };
+        if (o.icon) opt.icon = o.icon;
+        if (o.description) opt.description = o.description;
+        if (o.metadata) opt.metadata = o.metadata;
+        return opt;
+      });
+      return {
+        type: "choice",
+        title: q.title,
+        config: { options, layout: "vertical" }
+      };
+    }
+    case "confirm": {
+      const config = {};
+      if (q.message) config.message = q.message;
+      if ((_a = q.confirm) == null ? void 0 : _a.confirmLabel) config.confirmLabel = q.confirm.confirmLabel;
+      if ((_b = q.confirm) == null ? void 0 : _b.cancelLabel) config.cancelLabel = q.confirm.cancelLabel;
+      if ((_c = q.confirm) == null ? void 0 : _c.variant) config.variant = q.confirm.variant;
+      return { type: "confirm", title: q.title, config };
+    }
+    case "form":
+      return {
+        type: "form",
+        title: q.title,
+        config: { fields: q.fields ?? [] }
+      };
+    case "elicitation": {
+      if (isElicitationSchema(q.elicitationSchema)) {
+        return elicitationToPromptConfig({
+          message: q.message ?? q.title,
+          requestedSchema: q.elicitationSchema
+        });
+      }
+      return {
+        type: "confirm",
+        title: q.title,
+        config: { message: q.message ?? "Please confirm to continue." }
+      };
+    }
+  }
+}
+export {
+  macroInterrogationToChatPromptConfig,
+  macroRunToScratchpadState
+};
+//# sourceMappingURL=macro-run.js.map