@seed-ship/mcp-ui-solid 6.19.1 → 6.20.0

package/dist/adapters/connector.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const mcpUiSpec = require("@seed-ship/mcp-ui-spec");
 const zod = require("zod");
+const formatString = require("../utils/format-string.cjs");
 function connectorActionsToActionGroup(actions, options = {}) {
   return {
     id: options.id ?? "connector-actions",
@@ -15,6 +16,11 @@ function connectorActionsToActionGroup(actions, options = {}) {
     }
   };
 }
+const DEFAULT_CONNECTOR_MESSAGES = {
+  degradedNotice: "### Result not rendered\n\nThe connector result could not be interpreted{versionSuffix}. This explicit state replaces a silent disappearance of the rendering.",
+  degradedVersionSuffix: " (schema: `{version}`)",
+  versionWarning: "> ⚠ Unrecognized connector schema (`{version}`, expected `{expected}`). The rendering below is in degraded mode."
+};
 const LenientResultSchema = zod.z.object({
   schemaVersion: zod.z.string(),
   connectorId: zod.z.string().min(1),
@@ -44,6 +50,7 @@ function degradedTextComponent(id, message) {
 }
 function connectorResultToUILayout(result, options = {}) {
   const strict = mcpUiSpec.ConnectorDynamicResultV1Schema.safeParse(result);
+  const messages = { ...DEFAULT_CONNECTOR_MESSAGES, ...options.messages };
   if (!strict.success) {
     const lenient = LenientResultSchema.safeParse(result);
     if (!lenient.success) {
@@ -53,9 +60,9 @@ function connectorResultToUILayout(result, options = {}) {
         components: [
           degradedTextComponent(
             "connector-degraded-notice",
-            `### Résultat non rendu
-
-Le résultat du connecteur n'a pas pu être interprété${typeof version === "string" ? ` (schéma : \`${version}\`)` : ""}. Cet état explicite remplace une disparition silencieuse du rendu.`
+            formatString.formatMCPUIString(messages.degradedNotice, {
+              versionSuffix: typeof version === "string" ? formatString.formatMCPUIString(messages.degradedVersionSuffix, { version }) : ""
+            })
           )
         ],
         grid: { ...DEFAULT_GRID }
@@ -65,7 +72,10 @@ Le résultat du connecteur n'a pas pu être interprété${typeof version === "st
     const components2 = [
       degradedTextComponent(
         "connector-version-warning",
-        `> ⚠ Schéma connecteur non reconnu (\`${r2.schemaVersion}\`, attendu \`${mcpUiSpec.CONNECTOR_DYNAMIC_RESULT_V1}\`). Le rendu ci-dessous est en mode dégradé.`
+        formatString.formatMCPUIString(messages.versionWarning, {
+          version: r2.schemaVersion,
+          expected: mcpUiSpec.CONNECTOR_DYNAMIC_RESULT_V1
+        })
       ),
       ...collectComponents(r2)
     ];
@@ -107,6 +117,7 @@ function collectComponents(r, actionsTitle) {
 function layoutId(connectorId, suffix) {
   return `connector-${connectorId}-${suffix}`;
 }
+exports.DEFAULT_CONNECTOR_MESSAGES = DEFAULT_CONNECTOR_MESSAGES;
 exports.connectorActionsToActionGroup = connectorActionsToActionGroup;
 exports.connectorResultToUILayout = connectorResultToUILayout;
 //# sourceMappingURL=connector.cjs.map

package/dist/adapters/connector.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"connector.cjs","sources":["../../src/adapters/connector.ts"],"sourcesContent":["/**\n * Connector adapters — `ConnectorDynamicResultV1` → MCP-UI render structures.\n *\n * @since v6.6.0 (D5 / D6 of ROADMAP-opendata-macro-mcpui)\n *\n * ## Opt-in, pure\n *\n * These adapters are published under the dedicated subpath\n * `@seed-ship/mcp-ui-solid/adapters` — they are NEVER imported by the core\n * renderer path, so a consumer that does not emit connector results pays\n * nothing for them.\n *\n * Every adapter here is a **pure function** (D5) : same input → same\n * output, no `fetch`, no `localStorage`, no global state, no clock, no\n * randomness. This is what lets a host re-run an adapter deterministically\n * after presentation feedback (D1) and replay fixtures in tests.\n *\n * ## Unknown schema version — never throw (R2)\n *\n * `connectorResultToUILayout()` never throws on the runtime render path.\n * A payload it cannot read becomes an explicit degraded `UILayout` (a\n * visible notice), never a silent disappearance and never an exception.\n */\n\nimport type { UIComponent, UILayout, GridPosition } from '../types'\nimport {\n  ConnectorDynamicResultV1Schema,\n  CONNECTOR_DYNAMIC_RESULT_V1,\n  type ConnectorAction,\n} from '@seed-ship/mcp-ui-spec'\nimport { z } from 'zod'\n\n// ─────────────────────────────────────────────────────────────\n// connectorActionsToActionGroup\n// ─────────────────────────────────────────────────────────────\n\nexport interface ConnectorActionsToActionGroupOptions {\n  /** Component id. Default `'connector-actions'`. */\n  id?: string\n  /** Optional heading shown above the buttons. */\n  title?: string\n  /** Button row layout. Default `'horizontal'`. */\n  layout?: 'horizontal' | 'vertical' | 'space-between' | 'end' | 'center'\n  /** Gap between buttons. Default `'md'`. */\n  gap?: 'none' | 'sm' | 'md' | 'lg'\n  /** Grid position. Default full-width. */\n  position?: GridPosition\n}\n\n/**\n * Wraps a connector's `actions` into an `action-group` `UIComponent`.\n *\n * `ConnectorAction` is the exact `action-group` action shape, so this is a\n * thin, pure envelope — no transformation of the actions themselves.\n */\nexport function connectorActionsToActionGroup(\n  actions: ConnectorAction[],\n  options: ConnectorActionsToActionGroupOptions = {}\n): UIComponent {\n  return {\n    id: options.id ?? 'connector-actions',\n    type: 'action-group',\n    position: options.position ?? { colStart: 1, colSpan: 12 },\n    params: {\n      actions,\n      ...(options.title ? { title: options.title } : {}),\n      layout: options.layout ?? 'horizontal',\n      gap: options.gap ?? 'md',\n    },\n  } as UIComponent\n}\n\n// ─────────────────────────────────────────────────────────────\n// connectorResultToUILayout\n// ─────────────────────────────────────────────────────────────\n\nexport interface ConnectorResultToUILayoutOptions {\n  /** Layout id. Default derived from `connectorId` + `queryHash` / `toolName`. */\n  id?: string\n  /** Heading for the actions `action-group`. */\n  actionsTitle?: string\n}\n\n/**\n * Lenient mirror of `ConnectorDynamicResultV1Schema` — `schemaVersion`\n * relaxed to any string. Used to tell apart \"unknown version but otherwise\n * a usable envelope\" (→ render with a warning, R2) from \"truly unreadable\"\n * (→ explicit error state).\n */\nconst LenientResultSchema = z.object({\n  schemaVersion: z.string(),\n  connectorId: z.string().min(1),\n  toolName: z.string().min(1),\n  query: z.string(),\n  queryHash: z.string().optional(),\n  intent: z.string().optional(),\n  primary: z.record(z.unknown()),\n  supplemental: z.array(z.record(z.unknown())).optional(),\n  actions: z.array(z.record(z.unknown())).optional(),\n})\n\nconst DEFAULT_GRID = { columns: 12, gap: '1rem' } as const\n\nfunction withPosition(component: UIComponent): UIComponent {\n  if (component && component.position) return component\n  return { ...component, position: { colStart: 1, colSpan: 12 } }\n}\n\n/** A component is a UILayout when it carries a `components` array. */\nfunction isLayoutShape(value: Record<string, unknown>): boolean {\n  return Array.isArray((value as { components?: unknown }).components)\n}\n\nfunction degradedTextComponent(id: string, message: string): UIComponent {\n  return {\n    id,\n    type: 'text',\n    position: { colStart: 1, colSpan: 12 },\n    params: { markdown: true, content: message },\n  } as UIComponent\n}\n\n/**\n * Assembles a `ConnectorDynamicResultV1` into a single `UILayout` :\n * `primary` + `supplemental[]` + (`actions` → an `action-group`).\n *\n * - When `primary` is itself a layout, its components are spread in.\n * - Raw data is never sacrificed — every supplied component is kept.\n * - Pure : no side effects, deterministic.\n *\n * ### Degraded behavior (R2)\n *\n * - Valid v1 payload → normal assembled layout.\n * - Unknown `schemaVersion` but an otherwise-usable envelope → the\n *   components are still rendered, prefixed with a visible warning notice.\n * - Unreadable payload → an explicit error `UILayout` (a single `text`\n *   notice). Never throws, never returns an empty layout silently.\n *\n * A degraded layout always has an `id` starting with `connector-degraded`,\n * so a host can detect it (e.g. for telemetry) without inspecting content.\n */\nexport function connectorResultToUILayout(\n  result: unknown,\n  options: ConnectorResultToUILayoutOptions = {}\n): UILayout {\n  const strict = ConnectorDynamicResultV1Schema.safeParse(result)\n\n  // ── Tier 3 : unreadable ───────────────────────────────────\n  if (!strict.success) {\n    const lenient = LenientResultSchema.safeParse(result)\n    if (!lenient.success) {\n      const version =\n        result && typeof result === 'object'\n          ? (result as { schemaVersion?: unknown }).schemaVersion\n          : undefined\n      return {\n        id: 'connector-degraded',\n        components: [\n          degradedTextComponent(\n            'connector-degraded-notice',\n            `### Résultat non rendu\\n\\nLe résultat du connecteur n'a pas pu être interprété${\n              typeof version === 'string' ? ` (schéma : \\`${version}\\`)` : ''\n            }. Cet état explicite remplace une disparition silencieuse du rendu.`\n          ),\n        ],\n        grid: { ...DEFAULT_GRID },\n      }\n    }\n    // ── Tier 2 : usable envelope, unknown version ───────────\n    const r = lenient.data\n    const components: UIComponent[] = [\n      degradedTextComponent(\n        'connector-version-warning',\n        `> ⚠ Schéma connecteur non reconnu (\\`${r.schemaVersion}\\`, attendu \\`${CONNECTOR_DYNAMIC_RESULT_V1}\\`). Le rendu ci-dessous est en mode dégradé.`\n      ),\n      ...collectComponents(r),\n    ]\n    return {\n      id: options.id ?? `connector-degraded-${r.connectorId}`,\n      components: components.map(withPosition),\n      grid: { ...DEFAULT_GRID },\n    }\n  }\n\n  // ── Tier 1 : valid v1 ─────────────────────────────────────\n  const r = strict.data\n  const components = collectComponents(r, options.actionsTitle).map(withPosition)\n  return {\n    id: options.id ?? layoutId(r.connectorId, r.queryHash ?? r.toolName),\n    components,\n    grid: { ...DEFAULT_GRID },\n  }\n}\n\n/**\n * Flattens `primary` + `supplemental` + `actions` into a component list.\n * Shared by the valid and degraded-but-usable paths.\n */\nfunction collectComponents(\n  r: {\n    primary: Record<string, unknown>\n    supplemental?: Record<string, unknown>[]\n    actions?: unknown[]\n  },\n  actionsTitle?: string\n): UIComponent[] {\n  const components: UIComponent[] = []\n\n  if (isLayoutShape(r.primary)) {\n    const inner = (r.primary as { components?: UIComponent[] }).components ?? []\n    components.push(...inner)\n  } else {\n    components.push(r.primary as unknown as UIComponent)\n  }\n\n  if (r.supplemental) {\n    components.push(...(r.supplemental as unknown as UIComponent[]))\n  }\n\n  if (Array.isArray(r.actions) && r.actions.length > 0) {\n    components.push(\n      connectorActionsToActionGroup(r.actions as ConnectorAction[], {\n        id: 'connector-actions',\n        title: actionsTitle,\n      })\n    )\n  }\n\n  return components\n}\n\nfunction layoutId(connectorId: string, suffix: string): string {\n  return `connector-${connectorId}-${suffix}`\n}\n"],"names":["z","ConnectorDynamicResultV1Schema","r","components","CONNECTOR_DYNAMIC_RESULT_V1"],"mappings":"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"}
+{"version":3,"file":"connector.cjs","sources":["../../src/adapters/connector.ts"],"sourcesContent":["/**\n * Connector adapters — `ConnectorDynamicResultV1` → MCP-UI render structures.\n *\n * @since v6.6.0 (D5 / D6 of ROADMAP-opendata-macro-mcpui)\n *\n * ## Opt-in, pure\n *\n * These adapters are published under the dedicated subpath\n * `@seed-ship/mcp-ui-solid/adapters` — they are NEVER imported by the core\n * renderer path, so a consumer that does not emit connector results pays\n * nothing for them.\n *\n * Every adapter here is a **pure function** (D5) : same input → same\n * output, no `fetch`, no `localStorage`, no global state, no clock, no\n * randomness. This is what lets a host re-run an adapter deterministically\n * after presentation feedback (D1) and replay fixtures in tests.\n *\n * ## Unknown schema version — never throw (R2)\n *\n * `connectorResultToUILayout()` never throws on the runtime render path.\n * A payload it cannot read becomes an explicit degraded `UILayout` (a\n * visible notice), never a silent disappearance and never an exception.\n */\n\nimport type { UIComponent, UILayout, GridPosition } from '../types'\nimport {\n  ConnectorDynamicResultV1Schema,\n  CONNECTOR_DYNAMIC_RESULT_V1,\n  type ConnectorAction,\n} from '@seed-ship/mcp-ui-spec'\nimport { z } from 'zod'\nimport { formatMCPUIString } from '../utils/format-string'\n\n// ─────────────────────────────────────────────────────────────\n// connectorActionsToActionGroup\n// ─────────────────────────────────────────────────────────────\n\nexport interface ConnectorActionsToActionGroupOptions {\n  /** Component id. Default `'connector-actions'`. */\n  id?: string\n  /** Optional heading shown above the buttons. */\n  title?: string\n  /** Button row layout. Default `'horizontal'`. */\n  layout?: 'horizontal' | 'vertical' | 'space-between' | 'end' | 'center'\n  /** Gap between buttons. Default `'md'`. */\n  gap?: 'none' | 'sm' | 'md' | 'lg'\n  /** Grid position. Default full-width. */\n  position?: GridPosition\n}\n\n/**\n * Wraps a connector's `actions` into an `action-group` `UIComponent`.\n *\n * `ConnectorAction` is the exact `action-group` action shape, so this is a\n * thin, pure envelope — no transformation of the actions themselves.\n */\nexport function connectorActionsToActionGroup(\n  actions: ConnectorAction[],\n  options: ConnectorActionsToActionGroupOptions = {}\n): UIComponent {\n  return {\n    id: options.id ?? 'connector-actions',\n    type: 'action-group',\n    position: options.position ?? { colStart: 1, colSpan: 12 },\n    params: {\n      actions,\n      ...(options.title ? { title: options.title } : {}),\n      layout: options.layout ?? 'horizontal',\n      gap: options.gap ?? 'md',\n    },\n  } as UIComponent\n}\n\n// ─────────────────────────────────────────────────────────────\n// connectorResultToUILayout\n// ─────────────────────────────────────────────────────────────\n\n/**\n * The visible wording of the two degraded states (R2).\n *\n * These paragraphs are rendered as `text` components, so unlike the payload\n * they are the LIBRARY's own chrome. They cannot go through\n * `MCPUIStrings` — the adapters are runtime-free and never import\n * `solid-js` — so a host localizes them through\n * `ConnectorResultToUILayoutOptions.messages` instead.\n *\n * Every field is a template resolved with `formatMCPUIString`.\n *\n * @since v6.20.0 — the defaults used to be hardcoded French.\n */\nexport interface ConnectorAdapterMessages {\n  /**\n   * Unreadable payload (tier 3). Template — `{versionSuffix}` is\n   * `degradedVersionSuffix` when the payload carried a string\n   * `schemaVersion`, and `''` otherwise.\n   */\n  degradedNotice: string\n  /** Inserted into `degradedNotice`. Template — `{version}`. */\n  degradedVersionSuffix: string\n  /**\n   * Usable envelope, unknown version (tier 2). Template — `{version}` = the\n   * version read, `{expected}` = `CONNECTOR_DYNAMIC_RESULT_V1`.\n   */\n  versionWarning: string\n}\n\n/** English defaults for {@link ConnectorAdapterMessages}. */\nexport const DEFAULT_CONNECTOR_MESSAGES: ConnectorAdapterMessages = {\n  degradedNotice:\n    '### Result not rendered\\n\\nThe connector result could not be interpreted{versionSuffix}. This explicit state replaces a silent disappearance of the rendering.',\n  degradedVersionSuffix: ' (schema: `{version}`)',\n  versionWarning:\n    '> \\u26A0 Unrecognized connector schema (`{version}`, expected `{expected}`). The rendering below is in degraded mode.',\n}\n\nexport interface ConnectorResultToUILayoutOptions {\n  /** Layout id. Default derived from `connectorId` + `queryHash` / `toolName`. */\n  id?: string\n  /** Heading for the actions `action-group`. */\n  actionsTitle?: string\n  /**\n   * Partial override of the degraded-state wording, merged over\n   * {@link DEFAULT_CONNECTOR_MESSAGES}. Hosts that render in another\n   * language pass their own paragraphs here.\n   *\n   * @since v6.20.0\n   */\n  messages?: Partial<ConnectorAdapterMessages>\n}\n\n/**\n * Lenient mirror of `ConnectorDynamicResultV1Schema` — `schemaVersion`\n * relaxed to any string. Used to tell apart \"unknown version but otherwise\n * a usable envelope\" (→ render with a warning, R2) from \"truly unreadable\"\n * (→ explicit error state).\n */\nconst LenientResultSchema = z.object({\n  schemaVersion: z.string(),\n  connectorId: z.string().min(1),\n  toolName: z.string().min(1),\n  query: z.string(),\n  queryHash: z.string().optional(),\n  intent: z.string().optional(),\n  primary: z.record(z.unknown()),\n  supplemental: z.array(z.record(z.unknown())).optional(),\n  actions: z.array(z.record(z.unknown())).optional(),\n})\n\nconst DEFAULT_GRID = { columns: 12, gap: '1rem' } as const\n\nfunction withPosition(component: UIComponent): UIComponent {\n  if (component && component.position) return component\n  return { ...component, position: { colStart: 1, colSpan: 12 } }\n}\n\n/** A component is a UILayout when it carries a `components` array. */\nfunction isLayoutShape(value: Record<string, unknown>): boolean {\n  return Array.isArray((value as { components?: unknown }).components)\n}\n\nfunction degradedTextComponent(id: string, message: string): UIComponent {\n  return {\n    id,\n    type: 'text',\n    position: { colStart: 1, colSpan: 12 },\n    params: { markdown: true, content: message },\n  } as UIComponent\n}\n\n/**\n * Assembles a `ConnectorDynamicResultV1` into a single `UILayout` :\n * `primary` + `supplemental[]` + (`actions` → an `action-group`).\n *\n * - When `primary` is itself a layout, its components are spread in.\n * - Raw data is never sacrificed — every supplied component is kept.\n * - Pure : no side effects, deterministic.\n *\n * ### Degraded behavior (R2)\n *\n * - Valid v1 payload → normal assembled layout.\n * - Unknown `schemaVersion` but an otherwise-usable envelope → the\n *   components are still rendered, prefixed with a visible warning notice.\n * - Unreadable payload → an explicit error `UILayout` (a single `text`\n *   notice). Never throws, never returns an empty layout silently.\n *\n * A degraded layout always has an `id` starting with `connector-degraded`,\n * so a host can detect it (e.g. for telemetry) without inspecting content.\n */\nexport function connectorResultToUILayout(\n  result: unknown,\n  options: ConnectorResultToUILayoutOptions = {}\n): UILayout {\n  const strict = ConnectorDynamicResultV1Schema.safeParse(result)\n  const messages: ConnectorAdapterMessages = { ...DEFAULT_CONNECTOR_MESSAGES, ...options.messages }\n\n  // ── Tier 3 : unreadable ───────────────────────────────────\n  if (!strict.success) {\n    const lenient = LenientResultSchema.safeParse(result)\n    if (!lenient.success) {\n      const version =\n        result && typeof result === 'object'\n          ? (result as { schemaVersion?: unknown }).schemaVersion\n          : undefined\n      return {\n        id: 'connector-degraded',\n        components: [\n          degradedTextComponent(\n            'connector-degraded-notice',\n            formatMCPUIString(messages.degradedNotice, {\n              versionSuffix:\n                typeof version === 'string'\n                  ? formatMCPUIString(messages.degradedVersionSuffix, { version })\n                  : '',\n            })\n          ),\n        ],\n        grid: { ...DEFAULT_GRID },\n      }\n    }\n    // ── Tier 2 : usable envelope, unknown version ───────────\n    const r = lenient.data\n    const components: UIComponent[] = [\n      degradedTextComponent(\n        'connector-version-warning',\n        formatMCPUIString(messages.versionWarning, {\n          version: r.schemaVersion,\n          expected: CONNECTOR_DYNAMIC_RESULT_V1,\n        })\n      ),\n      ...collectComponents(r),\n    ]\n    return {\n      id: options.id ?? `connector-degraded-${r.connectorId}`,\n      components: components.map(withPosition),\n      grid: { ...DEFAULT_GRID },\n    }\n  }\n\n  // ── Tier 1 : valid v1 ─────────────────────────────────────\n  const r = strict.data\n  const components = collectComponents(r, options.actionsTitle).map(withPosition)\n  return {\n    id: options.id ?? layoutId(r.connectorId, r.queryHash ?? r.toolName),\n    components,\n    grid: { ...DEFAULT_GRID },\n  }\n}\n\n/**\n * Flattens `primary` + `supplemental` + `actions` into a component list.\n * Shared by the valid and degraded-but-usable paths.\n */\nfunction collectComponents(\n  r: {\n    primary: Record<string, unknown>\n    supplemental?: Record<string, unknown>[]\n    actions?: unknown[]\n  },\n  actionsTitle?: string\n): UIComponent[] {\n  const components: UIComponent[] = []\n\n  if (isLayoutShape(r.primary)) {\n    const inner = (r.primary as { components?: UIComponent[] }).components ?? []\n    components.push(...inner)\n  } else {\n    components.push(r.primary as unknown as UIComponent)\n  }\n\n  if (r.supplemental) {\n    components.push(...(r.supplemental as unknown as UIComponent[]))\n  }\n\n  if (Array.isArray(r.actions) && r.actions.length > 0) {\n    components.push(\n      connectorActionsToActionGroup(r.actions as ConnectorAction[], {\n        id: 'connector-actions',\n        title: actionsTitle,\n      })\n    )\n  }\n\n  return components\n}\n\nfunction layoutId(connectorId: string, suffix: string): string {\n  return `connector-${connectorId}-${suffix}`\n}\n"],"names":["z","ConnectorDynamicResultV1Schema","formatMCPUIString","r","components","CONNECTOR_DYNAMIC_RESULT_V1"],"mappings":"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"}

package/dist/adapters/connector.d.ts

@@ -42,11 +42,49 @@ export interface ConnectorActionsToActionGroupOptions {
  * thin, pure envelope — no transformation of the actions themselves.
  */
 export declare function connectorActionsToActionGroup(actions: ConnectorAction[], options?: ConnectorActionsToActionGroupOptions): UIComponent;
+/**
+ * The visible wording of the two degraded states (R2).
+ *
+ * These paragraphs are rendered as `text` components, so unlike the payload
+ * they are the LIBRARY's own chrome. They cannot go through
+ * `MCPUIStrings` — the adapters are runtime-free and never import
+ * `solid-js` — so a host localizes them through
+ * `ConnectorResultToUILayoutOptions.messages` instead.
+ *
+ * Every field is a template resolved with `formatMCPUIString`.
+ *
+ * @since v6.20.0 — the defaults used to be hardcoded French.
+ */
+export interface ConnectorAdapterMessages {
+    /**
+     * Unreadable payload (tier 3). Template — `{versionSuffix}` is
+     * `degradedVersionSuffix` when the payload carried a string
+     * `schemaVersion`, and `''` otherwise.
+     */
+    degradedNotice: string;
+    /** Inserted into `degradedNotice`. Template — `{version}`. */
+    degradedVersionSuffix: string;
+    /**
+     * Usable envelope, unknown version (tier 2). Template — `{version}` = the
+     * version read, `{expected}` = `CONNECTOR_DYNAMIC_RESULT_V1`.
+     */
+    versionWarning: string;
+}
+/** English defaults for {@link ConnectorAdapterMessages}. */
+export declare const DEFAULT_CONNECTOR_MESSAGES: ConnectorAdapterMessages;
 export interface ConnectorResultToUILayoutOptions {
     /** Layout id. Default derived from `connectorId` + `queryHash` / `toolName`. */
     id?: string;
     /** Heading for the actions `action-group`. */
     actionsTitle?: string;
+    /**
+     * Partial override of the degraded-state wording, merged over
+     * {@link DEFAULT_CONNECTOR_MESSAGES}. Hosts that render in another
+     * language pass their own paragraphs here.
+     *
+     * @since v6.20.0
+     */
+    messages?: Partial<ConnectorAdapterMessages>;
 }
 /**
  * Assembles a `ConnectorDynamicResultV1` into a single `UILayout` :

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

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/adapters/connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACnE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAA;AAO/B,MAAM,WAAW,oCAAoC;IACnD,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,KAAK,GAAG,QAAQ,CAAA;IACvE,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACjC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,YAAY,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,GAAE,oCAAyC,GACjD,WAAW,CAYb;AAMD,MAAM,WAAW,gCAAgC;IAC/C,gFAAgF;IAChF,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAyCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,gCAAqC,GAC7C,QAAQ,CAgDV"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/adapters/connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACnE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAA;AAQ/B,MAAM,WAAW,oCAAoC;IACnD,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,KAAK,GAAG,QAAQ,CAAA;IACvE,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACjC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,YAAY,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,GAAE,oCAAyC,GACjD,WAAW,CAYb;AAMD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB,8DAA8D;IAC9D,qBAAqB,EAAE,MAAM,CAAA;IAC7B;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B,EAAE,wBAMxC,CAAA;AAED,MAAM,WAAW,gCAAgC;IAC/C,gFAAgF;IAChF,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAA;CAC7C;AAyCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,gCAAqC,GAC7C,QAAQ,CAuDV"}

package/dist/adapters/connector.js

@@ -1,5 +1,6 @@
 import { ConnectorDynamicResultV1Schema, CONNECTOR_DYNAMIC_RESULT_V1 } from "@seed-ship/mcp-ui-spec";
 import { z } from "zod";
+import { formatMCPUIString } from "../utils/format-string.js";
 function connectorActionsToActionGroup(actions, options = {}) {
   return {
     id: options.id ?? "connector-actions",
@@ -13,6 +14,11 @@ function connectorActionsToActionGroup(actions, options = {}) {
     }
   };
 }
+const DEFAULT_CONNECTOR_MESSAGES = {
+  degradedNotice: "### Result not rendered\n\nThe connector result could not be interpreted{versionSuffix}. This explicit state replaces a silent disappearance of the rendering.",
+  degradedVersionSuffix: " (schema: `{version}`)",
+  versionWarning: "> ⚠ Unrecognized connector schema (`{version}`, expected `{expected}`). The rendering below is in degraded mode."
+};
 const LenientResultSchema = z.object({
   schemaVersion: z.string(),
   connectorId: z.string().min(1),
@@ -42,6 +48,7 @@ function degradedTextComponent(id, message) {
 }
 function connectorResultToUILayout(result, options = {}) {
   const strict = ConnectorDynamicResultV1Schema.safeParse(result);
+  const messages = { ...DEFAULT_CONNECTOR_MESSAGES, ...options.messages };
   if (!strict.success) {
     const lenient = LenientResultSchema.safeParse(result);
     if (!lenient.success) {
@@ -51,9 +58,9 @@ function connectorResultToUILayout(result, options = {}) {
         components: [
           degradedTextComponent(
             "connector-degraded-notice",
-            `### Résultat non rendu
-
-Le résultat du connecteur n'a pas pu être interprété${typeof version === "string" ? ` (schéma : \`${version}\`)` : ""}. Cet état explicite remplace une disparition silencieuse du rendu.`
+            formatMCPUIString(messages.degradedNotice, {
+              versionSuffix: typeof version === "string" ? formatMCPUIString(messages.degradedVersionSuffix, { version }) : ""
+            })
           )
         ],
         grid: { ...DEFAULT_GRID }
@@ -63,7 +70,10 @@ Le résultat du connecteur n'a pas pu être interprété${typeof version === "st
     const components2 = [
       degradedTextComponent(
         "connector-version-warning",
-        `> ⚠ Schéma connecteur non reconnu (\`${r2.schemaVersion}\`, attendu \`${CONNECTOR_DYNAMIC_RESULT_V1}\`). Le rendu ci-dessous est en mode dégradé.`
+        formatMCPUIString(messages.versionWarning, {
+          version: r2.schemaVersion,
+          expected: CONNECTOR_DYNAMIC_RESULT_V1
+        })
       ),
       ...collectComponents(r2)
     ];
@@ -106,6 +116,7 @@ function layoutId(connectorId, suffix) {
   return `connector-${connectorId}-${suffix}`;
 }
 export {
+  DEFAULT_CONNECTOR_MESSAGES,
   connectorActionsToActionGroup,
   connectorResultToUILayout
 };

package/dist/adapters/connector.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector.js","sources":["../../src/adapters/connector.ts"],"sourcesContent":["/**\n * Connector adapters — `ConnectorDynamicResultV1` → MCP-UI render structures.\n *\n * @since v6.6.0 (D5 / D6 of ROADMAP-opendata-macro-mcpui)\n *\n * ## Opt-in, pure\n *\n * These adapters are published under the dedicated subpath\n * `@seed-ship/mcp-ui-solid/adapters` — they are NEVER imported by the core\n * renderer path, so a consumer that does not emit connector results pays\n * nothing for them.\n *\n * Every adapter here is a **pure function** (D5) : same input → same\n * output, no `fetch`, no `localStorage`, no global state, no clock, no\n * randomness. This is what lets a host re-run an adapter deterministically\n * after presentation feedback (D1) and replay fixtures in tests.\n *\n * ## Unknown schema version — never throw (R2)\n *\n * `connectorResultToUILayout()` never throws on the runtime render path.\n * A payload it cannot read becomes an explicit degraded `UILayout` (a\n * visible notice), never a silent disappearance and never an exception.\n */\n\nimport type { UIComponent, UILayout, GridPosition } from '../types'\nimport {\n  ConnectorDynamicResultV1Schema,\n  CONNECTOR_DYNAMIC_RESULT_V1,\n  type ConnectorAction,\n} from '@seed-ship/mcp-ui-spec'\nimport { z } from 'zod'\n\n// ─────────────────────────────────────────────────────────────\n// connectorActionsToActionGroup\n// ─────────────────────────────────────────────────────────────\n\nexport interface ConnectorActionsToActionGroupOptions {\n  /** Component id. Default `'connector-actions'`. */\n  id?: string\n  /** Optional heading shown above the buttons. */\n  title?: string\n  /** Button row layout. Default `'horizontal'`. */\n  layout?: 'horizontal' | 'vertical' | 'space-between' | 'end' | 'center'\n  /** Gap between buttons. Default `'md'`. */\n  gap?: 'none' | 'sm' | 'md' | 'lg'\n  /** Grid position. Default full-width. */\n  position?: GridPosition\n}\n\n/**\n * Wraps a connector's `actions` into an `action-group` `UIComponent`.\n *\n * `ConnectorAction` is the exact `action-group` action shape, so this is a\n * thin, pure envelope — no transformation of the actions themselves.\n */\nexport function connectorActionsToActionGroup(\n  actions: ConnectorAction[],\n  options: ConnectorActionsToActionGroupOptions = {}\n): UIComponent {\n  return {\n    id: options.id ?? 'connector-actions',\n    type: 'action-group',\n    position: options.position ?? { colStart: 1, colSpan: 12 },\n    params: {\n      actions,\n      ...(options.title ? { title: options.title } : {}),\n      layout: options.layout ?? 'horizontal',\n      gap: options.gap ?? 'md',\n    },\n  } as UIComponent\n}\n\n// ─────────────────────────────────────────────────────────────\n// connectorResultToUILayout\n// ─────────────────────────────────────────────────────────────\n\nexport interface ConnectorResultToUILayoutOptions {\n  /** Layout id. Default derived from `connectorId` + `queryHash` / `toolName`. */\n  id?: string\n  /** Heading for the actions `action-group`. */\n  actionsTitle?: string\n}\n\n/**\n * Lenient mirror of `ConnectorDynamicResultV1Schema` — `schemaVersion`\n * relaxed to any string. Used to tell apart \"unknown version but otherwise\n * a usable envelope\" (→ render with a warning, R2) from \"truly unreadable\"\n * (→ explicit error state).\n */\nconst LenientResultSchema = z.object({\n  schemaVersion: z.string(),\n  connectorId: z.string().min(1),\n  toolName: z.string().min(1),\n  query: z.string(),\n  queryHash: z.string().optional(),\n  intent: z.string().optional(),\n  primary: z.record(z.unknown()),\n  supplemental: z.array(z.record(z.unknown())).optional(),\n  actions: z.array(z.record(z.unknown())).optional(),\n})\n\nconst DEFAULT_GRID = { columns: 12, gap: '1rem' } as const\n\nfunction withPosition(component: UIComponent): UIComponent {\n  if (component && component.position) return component\n  return { ...component, position: { colStart: 1, colSpan: 12 } }\n}\n\n/** A component is a UILayout when it carries a `components` array. */\nfunction isLayoutShape(value: Record<string, unknown>): boolean {\n  return Array.isArray((value as { components?: unknown }).components)\n}\n\nfunction degradedTextComponent(id: string, message: string): UIComponent {\n  return {\n    id,\n    type: 'text',\n    position: { colStart: 1, colSpan: 12 },\n    params: { markdown: true, content: message },\n  } as UIComponent\n}\n\n/**\n * Assembles a `ConnectorDynamicResultV1` into a single `UILayout` :\n * `primary` + `supplemental[]` + (`actions` → an `action-group`).\n *\n * - When `primary` is itself a layout, its components are spread in.\n * - Raw data is never sacrificed — every supplied component is kept.\n * - Pure : no side effects, deterministic.\n *\n * ### Degraded behavior (R2)\n *\n * - Valid v1 payload → normal assembled layout.\n * - Unknown `schemaVersion` but an otherwise-usable envelope → the\n *   components are still rendered, prefixed with a visible warning notice.\n * - Unreadable payload → an explicit error `UILayout` (a single `text`\n *   notice). Never throws, never returns an empty layout silently.\n *\n * A degraded layout always has an `id` starting with `connector-degraded`,\n * so a host can detect it (e.g. for telemetry) without inspecting content.\n */\nexport function connectorResultToUILayout(\n  result: unknown,\n  options: ConnectorResultToUILayoutOptions = {}\n): UILayout {\n  const strict = ConnectorDynamicResultV1Schema.safeParse(result)\n\n  // ── Tier 3 : unreadable ───────────────────────────────────\n  if (!strict.success) {\n    const lenient = LenientResultSchema.safeParse(result)\n    if (!lenient.success) {\n      const version =\n        result && typeof result === 'object'\n          ? (result as { schemaVersion?: unknown }).schemaVersion\n          : undefined\n      return {\n        id: 'connector-degraded',\n        components: [\n          degradedTextComponent(\n            'connector-degraded-notice',\n            `### Résultat non rendu\\n\\nLe résultat du connecteur n'a pas pu être interprété${\n              typeof version === 'string' ? ` (schéma : \\`${version}\\`)` : ''\n            }. Cet état explicite remplace une disparition silencieuse du rendu.`\n          ),\n        ],\n        grid: { ...DEFAULT_GRID },\n      }\n    }\n    // ── Tier 2 : usable envelope, unknown version ───────────\n    const r = lenient.data\n    const components: UIComponent[] = [\n      degradedTextComponent(\n        'connector-version-warning',\n        `> ⚠ Schéma connecteur non reconnu (\\`${r.schemaVersion}\\`, attendu \\`${CONNECTOR_DYNAMIC_RESULT_V1}\\`). Le rendu ci-dessous est en mode dégradé.`\n      ),\n      ...collectComponents(r),\n    ]\n    return {\n      id: options.id ?? `connector-degraded-${r.connectorId}`,\n      components: components.map(withPosition),\n      grid: { ...DEFAULT_GRID },\n    }\n  }\n\n  // ── Tier 1 : valid v1 ─────────────────────────────────────\n  const r = strict.data\n  const components = collectComponents(r, options.actionsTitle).map(withPosition)\n  return {\n    id: options.id ?? layoutId(r.connectorId, r.queryHash ?? r.toolName),\n    components,\n    grid: { ...DEFAULT_GRID },\n  }\n}\n\n/**\n * Flattens `primary` + `supplemental` + `actions` into a component list.\n * Shared by the valid and degraded-but-usable paths.\n */\nfunction collectComponents(\n  r: {\n    primary: Record<string, unknown>\n    supplemental?: Record<string, unknown>[]\n    actions?: unknown[]\n  },\n  actionsTitle?: string\n): UIComponent[] {\n  const components: UIComponent[] = []\n\n  if (isLayoutShape(r.primary)) {\n    const inner = (r.primary as { components?: UIComponent[] }).components ?? []\n    components.push(...inner)\n  } else {\n    components.push(r.primary as unknown as UIComponent)\n  }\n\n  if (r.supplemental) {\n    components.push(...(r.supplemental as unknown as UIComponent[]))\n  }\n\n  if (Array.isArray(r.actions) && r.actions.length > 0) {\n    components.push(\n      connectorActionsToActionGroup(r.actions as ConnectorAction[], {\n        id: 'connector-actions',\n        title: actionsTitle,\n      })\n    )\n  }\n\n  return components\n}\n\nfunction layoutId(connectorId: string, suffix: string): string {\n  return `connector-${connectorId}-${suffix}`\n}\n"],"names":["r","components"],"mappings":"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"}
+{"version":3,"file":"connector.js","sources":["../../src/adapters/connector.ts"],"sourcesContent":["/**\n * Connector adapters — `ConnectorDynamicResultV1` → MCP-UI render structures.\n *\n * @since v6.6.0 (D5 / D6 of ROADMAP-opendata-macro-mcpui)\n *\n * ## Opt-in, pure\n *\n * These adapters are published under the dedicated subpath\n * `@seed-ship/mcp-ui-solid/adapters` — they are NEVER imported by the core\n * renderer path, so a consumer that does not emit connector results pays\n * nothing for them.\n *\n * Every adapter here is a **pure function** (D5) : same input → same\n * output, no `fetch`, no `localStorage`, no global state, no clock, no\n * randomness. This is what lets a host re-run an adapter deterministically\n * after presentation feedback (D1) and replay fixtures in tests.\n *\n * ## Unknown schema version — never throw (R2)\n *\n * `connectorResultToUILayout()` never throws on the runtime render path.\n * A payload it cannot read becomes an explicit degraded `UILayout` (a\n * visible notice), never a silent disappearance and never an exception.\n */\n\nimport type { UIComponent, UILayout, GridPosition } from '../types'\nimport {\n  ConnectorDynamicResultV1Schema,\n  CONNECTOR_DYNAMIC_RESULT_V1,\n  type ConnectorAction,\n} from '@seed-ship/mcp-ui-spec'\nimport { z } from 'zod'\nimport { formatMCPUIString } from '../utils/format-string'\n\n// ─────────────────────────────────────────────────────────────\n// connectorActionsToActionGroup\n// ─────────────────────────────────────────────────────────────\n\nexport interface ConnectorActionsToActionGroupOptions {\n  /** Component id. Default `'connector-actions'`. */\n  id?: string\n  /** Optional heading shown above the buttons. */\n  title?: string\n  /** Button row layout. Default `'horizontal'`. */\n  layout?: 'horizontal' | 'vertical' | 'space-between' | 'end' | 'center'\n  /** Gap between buttons. Default `'md'`. */\n  gap?: 'none' | 'sm' | 'md' | 'lg'\n  /** Grid position. Default full-width. */\n  position?: GridPosition\n}\n\n/**\n * Wraps a connector's `actions` into an `action-group` `UIComponent`.\n *\n * `ConnectorAction` is the exact `action-group` action shape, so this is a\n * thin, pure envelope — no transformation of the actions themselves.\n */\nexport function connectorActionsToActionGroup(\n  actions: ConnectorAction[],\n  options: ConnectorActionsToActionGroupOptions = {}\n): UIComponent {\n  return {\n    id: options.id ?? 'connector-actions',\n    type: 'action-group',\n    position: options.position ?? { colStart: 1, colSpan: 12 },\n    params: {\n      actions,\n      ...(options.title ? { title: options.title } : {}),\n      layout: options.layout ?? 'horizontal',\n      gap: options.gap ?? 'md',\n    },\n  } as UIComponent\n}\n\n// ─────────────────────────────────────────────────────────────\n// connectorResultToUILayout\n// ─────────────────────────────────────────────────────────────\n\n/**\n * The visible wording of the two degraded states (R2).\n *\n * These paragraphs are rendered as `text` components, so unlike the payload\n * they are the LIBRARY's own chrome. They cannot go through\n * `MCPUIStrings` — the adapters are runtime-free and never import\n * `solid-js` — so a host localizes them through\n * `ConnectorResultToUILayoutOptions.messages` instead.\n *\n * Every field is a template resolved with `formatMCPUIString`.\n *\n * @since v6.20.0 — the defaults used to be hardcoded French.\n */\nexport interface ConnectorAdapterMessages {\n  /**\n   * Unreadable payload (tier 3). Template — `{versionSuffix}` is\n   * `degradedVersionSuffix` when the payload carried a string\n   * `schemaVersion`, and `''` otherwise.\n   */\n  degradedNotice: string\n  /** Inserted into `degradedNotice`. Template — `{version}`. */\n  degradedVersionSuffix: string\n  /**\n   * Usable envelope, unknown version (tier 2). Template — `{version}` = the\n   * version read, `{expected}` = `CONNECTOR_DYNAMIC_RESULT_V1`.\n   */\n  versionWarning: string\n}\n\n/** English defaults for {@link ConnectorAdapterMessages}. */\nexport const DEFAULT_CONNECTOR_MESSAGES: ConnectorAdapterMessages = {\n  degradedNotice:\n    '### Result not rendered\\n\\nThe connector result could not be interpreted{versionSuffix}. This explicit state replaces a silent disappearance of the rendering.',\n  degradedVersionSuffix: ' (schema: `{version}`)',\n  versionWarning:\n    '> \\u26A0 Unrecognized connector schema (`{version}`, expected `{expected}`). The rendering below is in degraded mode.',\n}\n\nexport interface ConnectorResultToUILayoutOptions {\n  /** Layout id. Default derived from `connectorId` + `queryHash` / `toolName`. */\n  id?: string\n  /** Heading for the actions `action-group`. */\n  actionsTitle?: string\n  /**\n   * Partial override of the degraded-state wording, merged over\n   * {@link DEFAULT_CONNECTOR_MESSAGES}. Hosts that render in another\n   * language pass their own paragraphs here.\n   *\n   * @since v6.20.0\n   */\n  messages?: Partial<ConnectorAdapterMessages>\n}\n\n/**\n * Lenient mirror of `ConnectorDynamicResultV1Schema` — `schemaVersion`\n * relaxed to any string. Used to tell apart \"unknown version but otherwise\n * a usable envelope\" (→ render with a warning, R2) from \"truly unreadable\"\n * (→ explicit error state).\n */\nconst LenientResultSchema = z.object({\n  schemaVersion: z.string(),\n  connectorId: z.string().min(1),\n  toolName: z.string().min(1),\n  query: z.string(),\n  queryHash: z.string().optional(),\n  intent: z.string().optional(),\n  primary: z.record(z.unknown()),\n  supplemental: z.array(z.record(z.unknown())).optional(),\n  actions: z.array(z.record(z.unknown())).optional(),\n})\n\nconst DEFAULT_GRID = { columns: 12, gap: '1rem' } as const\n\nfunction withPosition(component: UIComponent): UIComponent {\n  if (component && component.position) return component\n  return { ...component, position: { colStart: 1, colSpan: 12 } }\n}\n\n/** A component is a UILayout when it carries a `components` array. */\nfunction isLayoutShape(value: Record<string, unknown>): boolean {\n  return Array.isArray((value as { components?: unknown }).components)\n}\n\nfunction degradedTextComponent(id: string, message: string): UIComponent {\n  return {\n    id,\n    type: 'text',\n    position: { colStart: 1, colSpan: 12 },\n    params: { markdown: true, content: message },\n  } as UIComponent\n}\n\n/**\n * Assembles a `ConnectorDynamicResultV1` into a single `UILayout` :\n * `primary` + `supplemental[]` + (`actions` → an `action-group`).\n *\n * - When `primary` is itself a layout, its components are spread in.\n * - Raw data is never sacrificed — every supplied component is kept.\n * - Pure : no side effects, deterministic.\n *\n * ### Degraded behavior (R2)\n *\n * - Valid v1 payload → normal assembled layout.\n * - Unknown `schemaVersion` but an otherwise-usable envelope → the\n *   components are still rendered, prefixed with a visible warning notice.\n * - Unreadable payload → an explicit error `UILayout` (a single `text`\n *   notice). Never throws, never returns an empty layout silently.\n *\n * A degraded layout always has an `id` starting with `connector-degraded`,\n * so a host can detect it (e.g. for telemetry) without inspecting content.\n */\nexport function connectorResultToUILayout(\n  result: unknown,\n  options: ConnectorResultToUILayoutOptions = {}\n): UILayout {\n  const strict = ConnectorDynamicResultV1Schema.safeParse(result)\n  const messages: ConnectorAdapterMessages = { ...DEFAULT_CONNECTOR_MESSAGES, ...options.messages }\n\n  // ── Tier 3 : unreadable ───────────────────────────────────\n  if (!strict.success) {\n    const lenient = LenientResultSchema.safeParse(result)\n    if (!lenient.success) {\n      const version =\n        result && typeof result === 'object'\n          ? (result as { schemaVersion?: unknown }).schemaVersion\n          : undefined\n      return {\n        id: 'connector-degraded',\n        components: [\n          degradedTextComponent(\n            'connector-degraded-notice',\n            formatMCPUIString(messages.degradedNotice, {\n              versionSuffix:\n                typeof version === 'string'\n                  ? formatMCPUIString(messages.degradedVersionSuffix, { version })\n                  : '',\n            })\n          ),\n        ],\n        grid: { ...DEFAULT_GRID },\n      }\n    }\n    // ── Tier 2 : usable envelope, unknown version ───────────\n    const r = lenient.data\n    const components: UIComponent[] = [\n      degradedTextComponent(\n        'connector-version-warning',\n        formatMCPUIString(messages.versionWarning, {\n          version: r.schemaVersion,\n          expected: CONNECTOR_DYNAMIC_RESULT_V1,\n        })\n      ),\n      ...collectComponents(r),\n    ]\n    return {\n      id: options.id ?? `connector-degraded-${r.connectorId}`,\n      components: components.map(withPosition),\n      grid: { ...DEFAULT_GRID },\n    }\n  }\n\n  // ── Tier 1 : valid v1 ─────────────────────────────────────\n  const r = strict.data\n  const components = collectComponents(r, options.actionsTitle).map(withPosition)\n  return {\n    id: options.id ?? layoutId(r.connectorId, r.queryHash ?? r.toolName),\n    components,\n    grid: { ...DEFAULT_GRID },\n  }\n}\n\n/**\n * Flattens `primary` + `supplemental` + `actions` into a component list.\n * Shared by the valid and degraded-but-usable paths.\n */\nfunction collectComponents(\n  r: {\n    primary: Record<string, unknown>\n    supplemental?: Record<string, unknown>[]\n    actions?: unknown[]\n  },\n  actionsTitle?: string\n): UIComponent[] {\n  const components: UIComponent[] = []\n\n  if (isLayoutShape(r.primary)) {\n    const inner = (r.primary as { components?: UIComponent[] }).components ?? []\n    components.push(...inner)\n  } else {\n    components.push(r.primary as unknown as UIComponent)\n  }\n\n  if (r.supplemental) {\n    components.push(...(r.supplemental as unknown as UIComponent[]))\n  }\n\n  if (Array.isArray(r.actions) && r.actions.length > 0) {\n    components.push(\n      connectorActionsToActionGroup(r.actions as ConnectorAction[], {\n        id: 'connector-actions',\n        title: actionsTitle,\n      })\n    )\n  }\n\n  return components\n}\n\nfunction layoutId(connectorId: string, suffix: string): string {\n  return `connector-${connectorId}-${suffix}`\n}\n"],"names":["r","components"],"mappings":"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"}

package/dist/adapters/index.d.ts

@@ -13,9 +13,10 @@
  * // → <UIResourceRenderer content={layout} />
  * ```
  */
-export { connectorResultToUILayout, connectorActionsToActionGroup } from './connector';
-export type { ConnectorResultToUILayoutOptions, ConnectorActionsToActionGroupOptions, } from './connector';
-export { macroRunToScratchpadState, macroInterrogationToChatPromptConfig } from './macro-run';
+export { connectorResultToUILayout, connectorActionsToActionGroup, DEFAULT_CONNECTOR_MESSAGES, } from './connector';
+export type { ConnectorResultToUILayoutOptions, ConnectorActionsToActionGroupOptions, ConnectorAdapterMessages, } from './connector';
+export { macroRunToScratchpadState, macroInterrogationToChatPromptConfig, DEFAULT_MACRO_RUN_MESSAGES, } from './macro-run';
+export type { MacroRunAdapterMessages, MacroRunAdapterOptions } from './macro-run';
 export { createComparisonLayout, createGeographyLayout, createEvidenceLayout, } from './presentation';
 export type { ComparisonLayoutInput, GeographyLayoutInput, EvidenceLayoutInput, PresentationComponent, ChartComponent, TableComponent, MapComponent, MetricComponent, TextComponent, LinkComponent, } from './presentation';
 //# 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,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;AAE9F,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gCAAgC,EAChC,oCAAoC,EACpC,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,yBAAyB,EACzB,oCAAoC,EACpC,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/adapters/macro-run.cjs

@@ -90,7 +90,16 @@ function resultSectionType(componentType) {
       return "data";
   }
 }
-function buildError(run) {
+const DEFAULT_MACRO_RUN_MESSAGES = {
+  agentSectionTitle: "Agent",
+  progressSectionTitle: "Progress",
+  resultSectionTitle: "Result",
+  runAborted: "Macro run aborted.",
+  runFailed: "Macro run failed.",
+  confirmDefault: "Please confirm to continue."
+};
+const withMessages = (options = {}) => ({ ...DEFAULT_MACRO_RUN_MESSAGES, ...options.messages });
+function buildError(run, messages) {
   if (run.status !== "failed" && run.status !== "aborted") return void 0;
   const aborted = run.status === "aborted";
   if (run.error) {
@@ -103,15 +112,16 @@ function buildError(run) {
     return err;
   }
   return {
-    message: aborted ? "Macro run aborted." : "Macro run failed.",
+    message: aborted ? messages.runAborted : messages.runFailed,
     retryable: false
   };
 }
-function macroRunToScratchpadState(run) {
+function macroRunToScratchpadState(run, options = {}) {
+  const messages = withMessages(options);
   const sections = [];
   sections.push({
     id: "macro-agent",
-    title: "Agent",
+    title: messages.agentSectionTitle,
     type: "agent_card",
     content: buildAgentCard(run),
     editable: false,
@@ -122,14 +132,14 @@ function macroRunToScratchpadState(run) {
     sections.push(
       hasParallel ? {
         id: "macro-split-stepper",
-        title: "Progress",
+        title: messages.progressSectionTitle,
         type: "split_stepper",
         content: buildSplitStepperContent(run.steps),
         editable: false,
         source: "agent"
       } : {
         id: "macro-stepper",
-        title: "Progress",
+        title: messages.progressSectionTitle,
         type: "stepper",
         content: buildStepperContent(run.steps),
         editable: false,
@@ -142,7 +152,7 @@ function macroRunToScratchpadState(run) {
       id: "macro-prompt",
       title: run.pendingInterrogation.title,
       type: "prompt",
-      content: macroInterrogationToChatPromptConfig(run.pendingInterrogation),
+      content: macroInterrogationToChatPromptConfig(run.pendingInterrogation, options),
       editable: false,
       source: "agent"
     });
@@ -151,7 +161,7 @@ function macroRunToScratchpadState(run) {
   results.forEach((component, index) => {
     sections.push({
       id: `macro-result-${String((component == null ? void 0 : component.id) ?? index)}`,
-      title: "Result",
+      title: messages.resultSectionTitle,
       type: resultSectionType(component == null ? void 0 : component.type),
       content: component,
       editable: false,
@@ -166,7 +176,7 @@ function macroRunToScratchpadState(run) {
     agentMessages: [],
     status: RUN_STATUS_TO_SCRATCHPAD[run.status]
   };
-  const error = buildError(run);
+  const error = buildError(run, messages);
   if (error) state.error = error;
   return state;
 }
@@ -175,11 +185,12 @@ function isElicitationSchema(value) {
   const v = value;
   return v.type === "object" && typeof v.properties === "object" && v.properties !== null;
 }
-function macroInterrogationToChatPromptConfig(q) {
+function macroInterrogationToChatPromptConfig(q, options = {}) {
   var _a, _b, _c;
+  const messages = withMessages(options);
   switch (q.kind) {
     case "choice": {
-      const options = (q.options ?? []).map((o) => {
+      const options2 = (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;
@@ -189,7 +200,7 @@ function macroInterrogationToChatPromptConfig(q) {
       return {
         type: "choice",
         title: q.title,
-        config: { options, layout: "vertical" }
+        config: { options: options2, layout: "vertical" }
       };
     }
     case "confirm": {
@@ -216,11 +227,12 @@ function macroInterrogationToChatPromptConfig(q) {
       return {
         type: "confirm",
         title: q.title,
-        config: { message: q.message ?? "Please confirm to continue." }
+        config: { message: q.message ?? messages.confirmDefault }
       };
     }
   }
 }
+exports.DEFAULT_MACRO_RUN_MESSAGES = DEFAULT_MACRO_RUN_MESSAGES;
 exports.macroInterrogationToChatPromptConfig = macroInterrogationToChatPromptConfig;
 exports.macroRunToScratchpadState = macroRunToScratchpadState;
 //# sourceMappingURL=macro-run.cjs.map

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

@@ -1 +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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"}
+{"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\n/**\n * The English wording this adapter produces on its own — section titles and\n * the fallbacks used when the run (or the interrogation) carries none.\n *\n * The adapter is runtime-free by contract: no `solid-js`, no\n * `MCPUIStringsContext`. Hosts that render in another language pass a\n * partial override through `MacroRunAdapterOptions.messages`, exactly like\n * `ConnectorResultToUILayoutOptions.messages`.\n *\n * @since v6.20.0\n */\nexport interface MacroRunAdapterMessages {\n  /** Title of the always-present `agent_card` section. */\n  agentSectionTitle: string;\n  /** Title of the `stepper` / `split_stepper` section. */\n  progressSectionTitle: string;\n  /** Title of each result section. */\n  resultSectionTitle: string;\n  /** Error message of an aborted run that carries no `error`. */\n  runAborted: string;\n  /** Error message of a failed run that carries no `error`. */\n  runFailed: string;\n  /** Prompt body of an elicitation with no usable schema and no message. */\n  confirmDefault: string;\n}\n\n/** English defaults for {@link MacroRunAdapterMessages}. */\nexport const DEFAULT_MACRO_RUN_MESSAGES: MacroRunAdapterMessages = {\n  agentSectionTitle: 'Agent',\n  progressSectionTitle: 'Progress',\n  resultSectionTitle: 'Result',\n  runAborted: 'Macro run aborted.',\n  runFailed: 'Macro run failed.',\n  confirmDefault: 'Please confirm to continue.',\n};\n\n/** Options shared by the MacroRun adapters. @since v6.20.0 */\nexport interface MacroRunAdapterOptions {\n  /**\n   * Partial override of the adapter's own wording, merged over\n   * {@link DEFAULT_MACRO_RUN_MESSAGES}.\n   */\n  messages?: Partial<MacroRunAdapterMessages>;\n}\n\nconst withMessages = (\n  options: MacroRunAdapterOptions = {}\n): MacroRunAdapterMessages => ({ ...DEFAULT_MACRO_RUN_MESSAGES, ...options.messages });\n\nfunction buildError(\n  run: MacroRunV1,\n  messages: MacroRunAdapterMessages\n): 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 ? messages.runAborted : messages.runFailed,\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(\n  run: MacroRunV1,\n  options: MacroRunAdapterOptions = {}\n): ScratchpadState {\n  const messages = withMessages(options);\n  const sections: ScratchpadSection[] = [];\n\n  // 1. Agent card — always present.\n  sections.push({\n    id: 'macro-agent',\n    title: messages.agentSectionTitle,\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: messages.progressSectionTitle,\n            type: 'split_stepper',\n            content: buildSplitStepperContent(run.steps),\n            editable: false,\n            source: 'agent',\n          }\n        : {\n            id: 'macro-stepper',\n            title: messages.progressSectionTitle,\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, options),\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: messages.resultSectionTitle,\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, messages);\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(\n  q: MacroInterrogationV1,\n  options: MacroRunAdapterOptions = {}\n): ChatPromptConfig {\n  const messages = withMessages(options);\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 ?? messages.confirmDefault },\n      };\n    }\n  }\n}\n"],"names":["options","elicitationToPromptConfig"],"mappings":"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"}

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

@@ -30,6 +30,41 @@
  */
 import type { MacroRunV1, MacroInterrogationV1 } from '@seed-ship/mcp-ui-spec';
 import type { ScratchpadState, ChatPromptConfig } from '../types/chat-bus';
+/**
+ * The English wording this adapter produces on its own — section titles and
+ * the fallbacks used when the run (or the interrogation) carries none.
+ *
+ * The adapter is runtime-free by contract: no `solid-js`, no
+ * `MCPUIStringsContext`. Hosts that render in another language pass a
+ * partial override through `MacroRunAdapterOptions.messages`, exactly like
+ * `ConnectorResultToUILayoutOptions.messages`.
+ *
+ * @since v6.20.0
+ */
+export interface MacroRunAdapterMessages {
+    /** Title of the always-present `agent_card` section. */
+    agentSectionTitle: string;
+    /** Title of the `stepper` / `split_stepper` section. */
+    progressSectionTitle: string;
+    /** Title of each result section. */
+    resultSectionTitle: string;
+    /** Error message of an aborted run that carries no `error`. */
+    runAborted: string;
+    /** Error message of a failed run that carries no `error`. */
+    runFailed: string;
+    /** Prompt body of an elicitation with no usable schema and no message. */
+    confirmDefault: string;
+}
+/** English defaults for {@link MacroRunAdapterMessages}. */
+export declare const DEFAULT_MACRO_RUN_MESSAGES: MacroRunAdapterMessages;
+/** Options shared by the MacroRun adapters. @since v6.20.0 */
+export interface MacroRunAdapterOptions {
+    /**
+     * Partial override of the adapter's own wording, merged over
+     * {@link DEFAULT_MACRO_RUN_MESSAGES}.
+     */
+    messages?: Partial<MacroRunAdapterMessages>;
+}
 /**
  * Convert a `MacroRunV1` snapshot into a `ScratchpadState`.
  *
@@ -45,7 +80,7 @@ import type { ScratchpadState, ChatPromptConfig } from '../types/chat-bus';
  *
  * Pure: no fetch, no SSE, no persistence. The host owns all wiring.
  */
-export declare function macroRunToScratchpadState(run: MacroRunV1): ScratchpadState;
+export declare function macroRunToScratchpadState(run: MacroRunV1, options?: MacroRunAdapterOptions): ScratchpadState;
 /**
  * Convert a `MacroInterrogationV1` into a `ChatPromptConfig`.
  *
@@ -61,5 +96,5 @@ export declare function macroRunToScratchpadState(run: MacroRunV1): ScratchpadSt
  * {@link macroRunToScratchpadState} (which calls it for an embedded
  * `pendingInterrogation`).
  */
-export declare function macroInterrogationToChatPromptConfig(q: MacroInterrogationV1): ChatPromptConfig;
+export declare function macroInterrogationToChatPromptConfig(q: MacroInterrogationV1, options?: MacroRunAdapterOptions): ChatPromptConfig;
 //# sourceMappingURL=macro-run.d.ts.map

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

@@ -1 +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"}
+{"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;AAsI3B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oCAAoC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,4DAA4D;AAC5D,eAAO,MAAM,0BAA0B,EAAE,uBAOxC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC7C;AA6BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,UAAU,EACf,OAAO,GAAE,sBAA2B,GACnC,eAAe,CA8EjB;AAUD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oCAAoC,CAClD,CAAC,EAAE,oBAAoB,EACvB,OAAO,GAAE,sBAA2B,GACnC,gBAAgB,CAiDlB"}