@uix-ai/adapter-a2ui 0.0.1

package/README.md

@@ -0,0 +1,138 @@
+# @uix-ai/adapter-a2ui
+
+Adapter to convert [Google A2UI](https://github.com/google/A2UI) protocol payloads to UIX Lucid IR format.
+
+> **Experimental.** A2UI is an early-stage protocol and its specification may change. This adapter tracks the latest available version (`v0.10`).
+
+## Install
+
+```bash
+pnpm add @uix-ai/adapter-a2ui
+```
+
+Peer dependency: `@uix-ai/core`
+
+## Quick Start
+
+```typescript
+import { fromA2UIPayload, toA2UIPayload } from '@uix-ai/adapter-a2ui'
+
+// A2UI -> UIX Lucid IR
+const conversation = fromA2UIPayload(a2uiPayload)
+
+// UIX Lucid IR -> A2UI
+const payload = toA2UIPayload(conversation)
+```
+
+## `fromA2UIPayload(payload, options?)`
+
+Converts an A2UI `updateComponents` payload into a `LucidConversation`. The A2UI component tree is flattened into a linear sequence of `LucidBlock` items. Container components (Row, Column, Card, etc.) are traversed but not emitted as blocks.
+
+Returns `null` if the payload does not contain `updateComponents`.
+
+```typescript
+import { fromA2UIPayload } from '@uix-ai/adapter-a2ui'
+import type { A2UIPayload } from '@uix-ai/adapter-a2ui'
+
+const payload: A2UIPayload = {
+  version: 'v0.10',
+  updateComponents: {
+    surfaceId: 'form_1',
+    components: [
+      { id: 'root', component: 'Column', children: ['title', 'img'] },
+      { id: 'title', component: 'Text', text: 'Hello World' },
+      { id: 'img', component: 'Image', url: 'https://example.com/photo.png' },
+    ],
+  },
+}
+
+const conversation = fromA2UIPayload(payload)
+// conversation.blocks[0] -> text block "Hello World"
+// conversation.blocks[1] -> image block
+```
+
+### Batch conversion
+
+```typescript
+import { fromA2UIPayloads } from '@uix-ai/adapter-a2ui'
+
+const conversations = fromA2UIPayloads(payloadArray)
+```
+
+## `toA2UIPayload(conversation, surfaceId?, version?)`
+
+Converts a `LucidConversation` back to an A2UI `updateComponents` payload. All blocks are wrapped in a root `Column` layout.
+
+```typescript
+import { toA2UIPayload } from '@uix-ai/adapter-a2ui'
+
+const payload = toA2UIPayload(conversation)
+// payload.updateComponents.components -> [Column root, Text, Image, ...]
+```
+
+## Supported Component Types
+
+### Display Components
+
+| A2UI Component | UIX Block Type | Notes |
+|----------------|----------------|-------|
+| `Text` | `text` | Direct mapping |
+| `Image` | `image` | Direct mapping |
+| `Icon` | `text` | Rendered as `[Icon: name]` |
+| `Video` | `text` | Rendered as `[Video: url]` |
+| `AudioPlayer` | `text` | Rendered as `[Audio: url]` |
+
+### Container Components (traversed, not emitted)
+
+`Row`, `Column`, `Card`, `List`, `Tabs`, `Modal`
+
+Containers are walked to collect child components but do not produce blocks themselves. `Tabs` children are emitted with bold tab titles.
+
+### Input Components
+
+| A2UI Component | UIX Block Type | Notes |
+|----------------|----------------|-------|
+| `TextField` | `text` | `[TextField: label]` |
+| `CheckBox` | `text` | `[CheckBox: label]` |
+| `DateTimeInput` | `text` | `[DateTimeInput: label]` |
+| `ChoicePicker` | `text` | `[ChoicePicker: label] options=[...]` |
+| `Slider` | `text` | `[Slider: label] range=[min, max]` |
+
+### Interactive Components
+
+| A2UI Component | UIX Block Type | Notes |
+|----------------|----------------|-------|
+| `Button` | `text` | `[Button: label] (action:name)` |
+| `Divider` | `text` | Rendered as `---` |
+
+## Conversion Options
+
+```typescript
+import type { A2UIConversionOptions } from '@uix-ai/adapter-a2ui'
+
+const options: A2UIConversionOptions = {
+  generateConversationId: (surfaceId) => `my-${surfaceId}`,
+  generateBlockId: (componentId) => `blk-${componentId}`,
+  resolveValue: (dynamic) => {
+    // Resolve data-binding expressions against your data model
+    if (typeof dynamic === 'object' && 'path' in dynamic) {
+      return lookupPath(dynamic.path)
+    }
+    return String(dynamic)
+  },
+}
+```
+
+## Dynamic Values
+
+A2UI supports dynamic data bindings. Without a `resolveValue` function, bindings are rendered as placeholders:
+
+- Path binding: `{ path: "user.name" }` renders as `{{user.name}}`
+- Function call: `{ call: "formatDate", args: {...} }` renders as `{{formatDate(...)}}`
+
+Provide a `resolveValue` callback to resolve these against your application's data model.
+
+## Links
+
+- [UIX Repository](https://github.com/Deepractice/UIX)
+- [Google A2UI Protocol](https://github.com/google/A2UI)

package/dist/index.d.ts

@@ -0,0 +1,334 @@
+import { LucidConversation } from '@uix-ai/core';
+
+/**
+ * @uix-ai/adapter-a2ui
+ *
+ * Adapter to convert Google A2UI protocol payloads to UIX Lucid IR format.
+ *
+ * A2UI is a declarative UI protocol where agents generate JSON payloads
+ * describing UI components. Unlike AG-UI (event streaming), A2UI is
+ * snapshot-based - the agent sends a complete UI description as JSON.
+ *
+ * This adapter converts A2UI's component tree into UIX LucidConversation
+ * and LucidBlock structures for rendering with UIX components.
+ *
+ * @see https://github.com/google/A2UI
+ *
+ * @example
+ * ```typescript
+ * import { fromA2UIPayload, toA2UIPayload } from '@uix-ai/adapter-a2ui'
+ *
+ * // Convert A2UI payload to UIX Lucid IR
+ * const conversation = fromA2UIPayload(a2uiPayload)
+ *
+ * // Convert UIX Lucid IR back to A2UI payload
+ * const payload = toA2UIPayload(conversation)
+ * ```
+ */
+
+/**
+ * A2UI protocol version
+ */
+type A2UIVersion = 'v0.8' | 'v0.9' | 'v0.10';
+/**
+ * A2UI display component types
+ */
+type A2UIDisplayComponent = 'Text' | 'Image' | 'Icon' | 'Video' | 'AudioPlayer';
+/**
+ * A2UI container component types
+ */
+type A2UIContainerComponent = 'Row' | 'Column' | 'Card' | 'List' | 'Tabs' | 'Modal';
+/**
+ * A2UI input component types
+ */
+type A2UIInputComponent = 'TextField' | 'CheckBox' | 'DateTimeInput' | 'ChoicePicker' | 'Slider';
+/**
+ * A2UI interactive component types
+ */
+type A2UIInteractiveComponent = 'Button' | 'Divider';
+/**
+ * Union of all A2UI component type names
+ */
+type A2UIComponentType = A2UIDisplayComponent | A2UIContainerComponent | A2UIInputComponent | A2UIInteractiveComponent;
+/**
+ * A2UI dynamic string - either a literal or a data-binding reference
+ */
+type A2UIDynamicString = string | {
+    path: string;
+} | {
+    call: string;
+    args: Record<string, unknown>;
+};
+/**
+ * A2UI dynamic number
+ */
+type A2UIDynamicNumber = number | {
+    path: string;
+} | {
+    call: string;
+    args: Record<string, unknown>;
+};
+/**
+ * A2UI dynamic boolean
+ */
+type A2UIDynamicBoolean = boolean | {
+    path: string;
+} | {
+    call: string;
+    args: Record<string, unknown>;
+};
+/**
+ * A2UI child list - either an array of IDs or a template binding
+ */
+type A2UIChildList = string[] | {
+    path: string;
+    componentId: string;
+};
+/**
+ * A2UI validation check
+ */
+interface A2UICheck {
+    call: string;
+    args: Record<string, unknown>;
+    message: string;
+}
+/**
+ * A2UI event action
+ */
+interface A2UIEventAction {
+    name: string;
+    context?: Record<string, unknown>;
+}
+/**
+ * A2UI function call action
+ */
+interface A2UIFunctionCallAction {
+    name: string;
+    args?: Record<string, unknown>;
+}
+/**
+ * A2UI action - either an event or a function call
+ */
+interface A2UIAction {
+    event?: A2UIEventAction;
+    functionCall?: A2UIFunctionCallAction;
+}
+/**
+ * A2UI component object in the flat adjacency list
+ *
+ * Components are stored as a flat array and reference each other by ID.
+ * The tree structure is built via `children` and `child` properties.
+ */
+interface A2UIComponent {
+    /** Unique identifier for this component */
+    id: string;
+    /** Component type name */
+    component: A2UIComponentType | string;
+    /** Child component IDs (for container components like Row, Column, List) */
+    children?: A2UIChildList;
+    /** Single child component ID (for Card, Modal) */
+    child?: string;
+    /** Text content (for Text, Button) */
+    text?: A2UIDynamicString;
+    /** Label (for input components) */
+    label?: A2UIDynamicString;
+    /** URL (for Image, Video, AudioPlayer) */
+    url?: A2UIDynamicString;
+    /** Icon name (for Icon) */
+    name?: A2UIDynamicString;
+    /** Value binding (for input components) */
+    value?: A2UIDynamicString | A2UIDynamicNumber | A2UIDynamicBoolean;
+    /** Action on interaction (for Button) */
+    action?: A2UIAction;
+    /** Validation checks (for TextField, Button) */
+    checks?: A2UICheck[];
+    /** Button variant */
+    variant?: string;
+    /** Layout alignment */
+    justify?: string;
+    /** Layout cross-axis alignment */
+    align?: string;
+    /** Axis for Divider */
+    axis?: string;
+    /** Tabs configuration */
+    tabs?: Array<{
+        title: A2UIDynamicString;
+        child: string;
+    }>;
+    /** Slider min value */
+    min?: number;
+    /** Slider max value */
+    max?: number;
+    /** Choice picker options */
+    options?: Array<{
+        label: A2UIDynamicString;
+        value: string;
+    }>;
+    /** Any additional properties from custom or extended components */
+    [key: string]: unknown;
+}
+/**
+ * A2UI surface theme configuration
+ */
+interface A2UITheme {
+    primaryColor?: string;
+    [key: string]: unknown;
+}
+/**
+ * createSurface message - initializes a new UI surface
+ */
+interface A2UICreateSurface {
+    surfaceId: string;
+    catalogId?: string;
+    theme?: A2UITheme;
+    sendDataModel?: boolean;
+}
+/**
+ * updateComponents message - adds or updates UI components
+ */
+interface A2UIUpdateComponents {
+    surfaceId: string;
+    components: A2UIComponent[];
+}
+/**
+ * updateDataModel message - modifies data model via JSON pointer
+ */
+interface A2UIUpdateDataModel {
+    surfaceId: string;
+    path?: string;
+    value?: unknown;
+}
+/**
+ * deleteSurface message - removes a surface
+ */
+interface A2UIDeleteSurface {
+    surfaceId: string;
+}
+/**
+ * Top-level A2UI message payload.
+ *
+ * Each message contains exactly one of the four message types:
+ * - `createSurface`: Initialize a new UI surface
+ * - `updateComponents`: Add or update components on a surface
+ * - `updateDataModel`: Modify the surface data model
+ * - `deleteSurface`: Remove a surface
+ */
+interface A2UIPayload {
+    /** A2UI protocol version */
+    version: string;
+    /** Create a new surface */
+    createSurface?: A2UICreateSurface;
+    /** Update components on a surface */
+    updateComponents?: A2UIUpdateComponents;
+    /** Update the data model */
+    updateDataModel?: A2UIUpdateDataModel;
+    /** Delete a surface */
+    deleteSurface?: A2UIDeleteSurface;
+}
+/**
+ * Options for A2UI to Lucid IR conversion
+ */
+interface A2UIConversionOptions {
+    /**
+     * Custom ID generator for conversations
+     * @default () => `a2ui-conv-${surfaceId}`
+     */
+    generateConversationId?: (surfaceId: string) => string;
+    /**
+     * Custom ID generator for blocks
+     * @default () => `a2ui-block-${componentId}`
+     */
+    generateBlockId?: (componentId: string) => string;
+    /**
+     * Resolve dynamic string values against a data model.
+     * If not provided, dynamic bindings are serialized as-is.
+     */
+    resolveValue?: (dynamic: A2UIDynamicString | A2UIDynamicNumber | A2UIDynamicBoolean) => string;
+}
+/**
+ * Convert an A2UI payload (containing updateComponents) to a UIX LucidConversation.
+ *
+ * The A2UI component tree is flattened into a linear sequence of LucidBlocks:
+ * - `Text` components become text blocks
+ * - `Image` components become image blocks
+ * - Input and interactive components become text blocks with structured descriptions
+ * - Container components (Row, Column, Card, etc.) are traversed but not emitted
+ *
+ * @param payload - An A2UI payload message (must contain updateComponents)
+ * @param options - Conversion options
+ * @returns A LucidConversation representing the A2UI surface, or null if the payload
+ *          does not contain updateComponents
+ *
+ * @example
+ * ```typescript
+ * const payload: A2UIPayload = {
+ *   version: 'v0.10',
+ *   updateComponents: {
+ *     surfaceId: 'form_1',
+ *     components: [
+ *       { id: 'root', component: 'Column', children: ['title', 'img'] },
+ *       { id: 'title', component: 'Text', text: 'Hello World' },
+ *       { id: 'img', component: 'Image', url: 'https://example.com/photo.png' }
+ *     ]
+ *   }
+ * }
+ *
+ * const conversation = fromA2UIPayload(payload)
+ * // conversation.blocks[0] -> text block "Hello World"
+ * // conversation.blocks[1] -> image block
+ * ```
+ */
+declare function fromA2UIPayload(payload: A2UIPayload, options?: A2UIConversionOptions): LucidConversation | null;
+/**
+ * Convert multiple A2UI payloads (a stream of messages) to LucidConversations.
+ *
+ * Processes an array of A2UI messages and returns one LucidConversation per
+ * updateComponents message encountered.
+ *
+ * @param payloads - Array of A2UI payload messages
+ * @param options - Conversion options
+ * @returns Array of LucidConversations
+ *
+ * @example
+ * ```typescript
+ * const messages: A2UIPayload[] = [
+ *   { version: 'v0.10', createSurface: { surfaceId: 's1', catalogId: '...' } },
+ *   { version: 'v0.10', updateComponents: { surfaceId: 's1', components: [...] } },
+ * ]
+ *
+ * const conversations = fromA2UIPayloads(messages)
+ * ```
+ */
+declare function fromA2UIPayloads(payloads: A2UIPayload[], options?: A2UIConversionOptions): LucidConversation[];
+/**
+ * Convert a UIX LucidConversation back to an A2UI payload.
+ *
+ * Maps LucidBlocks back to A2UI components wrapped in a Column layout:
+ * - text blocks -> Text components
+ * - image blocks -> Image components
+ * - Other block types -> Text components with type annotation
+ *
+ * @param conversation - A UIX LucidConversation
+ * @param surfaceId - Optional surface ID (defaults to conversation.id)
+ * @param version - A2UI protocol version (defaults to 'v0.10')
+ * @returns An A2UI payload with updateComponents
+ *
+ * @example
+ * ```typescript
+ * const conversation: LucidConversation = {
+ *   id: 'conv-1',
+ *   role: 'assistant',
+ *   status: 'completed',
+ *   blocks: [
+ *     { id: 'b1', type: 'text', status: 'completed', content: { text: 'Hello' } },
+ *     { id: 'b2', type: 'image', status: 'completed', content: { url: 'https://...' } }
+ *   ],
+ *   timestamp: Date.now()
+ * }
+ *
+ * const payload = toA2UIPayload(conversation)
+ * ```
+ */
+declare function toA2UIPayload(conversation: LucidConversation, surfaceId?: string, version?: string): A2UIPayload;
+
+export { type A2UIAction, type A2UICheck, type A2UIChildList, type A2UIComponent, type A2UIComponentType, type A2UIContainerComponent, type A2UIConversionOptions, type A2UICreateSurface, type A2UIDeleteSurface, type A2UIDisplayComponent, type A2UIDynamicBoolean, type A2UIDynamicNumber, type A2UIDynamicString, type A2UIEventAction, type A2UIFunctionCallAction, type A2UIInputComponent, type A2UIInteractiveComponent, type A2UIPayload, type A2UITheme, type A2UIUpdateComponents, type A2UIUpdateDataModel, type A2UIVersion, fromA2UIPayload, fromA2UIPayloads, toA2UIPayload };

package/dist/index.js

@@ -0,0 +1,350 @@
+// src/index.ts
+var blockIdCounter = 0;
+function defaultConversationId(surfaceId) {
+  return `a2ui-conv-${surfaceId}`;
+}
+function defaultBlockId(componentId) {
+  return `a2ui-block-${componentId}-${++blockIdCounter}`;
+}
+function resolveDynamic(value, resolver) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (resolver) return resolver(value);
+  if ("path" in value) return `{{${value.path}}}`;
+  if ("call" in value) return `{{${value.call}(...)}}`;
+  return JSON.stringify(value);
+}
+function buildComponentMap(components) {
+  const map = /* @__PURE__ */ new Map();
+  for (const comp of components) {
+    map.set(comp.id, comp);
+  }
+  return map;
+}
+function findRoot(components) {
+  return components.find((c) => c.id === "root");
+}
+function getChildIds(component) {
+  if (component.child) return [component.child];
+  if (Array.isArray(component.children)) return component.children;
+  return [];
+}
+function componentToBlock(component, options = {}) {
+  const genBlockId = options.generateBlockId ?? defaultBlockId;
+  const blockId = genBlockId(component.id);
+  const resolve = (v) => resolveDynamic(v, options.resolveValue);
+  switch (component.component) {
+    case "Text":
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: resolve(component.text)
+        }
+      };
+    case "Image":
+      return {
+        id: blockId,
+        type: "image",
+        status: "completed",
+        content: {
+          url: resolve(component.url),
+          alt: component.id
+        }
+      };
+    case "Button": {
+      const label = resolve(component.text) || component.id;
+      const actionDesc = component.action?.event ? `action:${component.action.event.name}` : component.action?.functionCall ? `call:${component.action.functionCall.name}` : "";
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: `[Button: ${label}]${actionDesc ? ` (${actionDesc})` : ""}`
+        }
+      };
+    }
+    case "TextField": {
+      const label = resolve(component.label) || component.id;
+      const val = resolve(component.value);
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: `[TextField: ${label}]${val ? ` value="${val}"` : ""}`
+        }
+      };
+    }
+    case "CheckBox": {
+      const label = resolve(component.label) || component.id;
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: `[CheckBox: ${label}]`
+        }
+      };
+    }
+    case "DateTimeInput": {
+      const label = resolve(component.label) || component.id;
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: `[DateTimeInput: ${label}]`
+        }
+      };
+    }
+    case "ChoicePicker": {
+      const label = resolve(component.label) || component.id;
+      const optionLabels = component.options ? component.options.map((o) => resolve(o.label)).join(", ") : "";
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: `[ChoicePicker: ${label}]${optionLabels ? ` options=[${optionLabels}]` : ""}`
+        }
+      };
+    }
+    case "Slider": {
+      const label = resolve(component.label) || component.id;
+      const min = component.min ?? 0;
+      const max = component.max ?? 100;
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: `[Slider: ${label}] range=[${min}, ${max}]`
+        }
+      };
+    }
+    case "Video":
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: `[Video: ${resolve(component.url)}]`
+        }
+      };
+    case "AudioPlayer":
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: `[Audio: ${resolve(component.url)}]`
+        }
+      };
+    case "Icon":
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: `[Icon: ${resolve(component.name)}]`
+        }
+      };
+    case "Divider":
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: "---"
+        }
+      };
+    // Container components (Row, Column, Card, List, Tabs, Modal)
+    // are flattened - their children are emitted as separate blocks.
+    // A container itself does not produce a block.
+    // This default handles any unknown/custom component types.
+    default:
+      return {
+        id: blockId,
+        type: "text",
+        status: "completed",
+        content: {
+          text: `[${component.component}: ${component.id}]`
+        }
+      };
+  }
+}
+var CONTAINER_TYPES = /* @__PURE__ */ new Set(["Row", "Column", "Card", "List", "Tabs", "Modal"]);
+function flattenComponents(rootId, componentMap, options = {}, visited = /* @__PURE__ */ new Set()) {
+  if (visited.has(rootId)) return [];
+  visited.add(rootId);
+  const component = componentMap.get(rootId);
+  if (!component) return [];
+  const isContainer = CONTAINER_TYPES.has(component.component);
+  const childIds = getChildIds(component);
+  if (component.component === "Tabs" && component.tabs) {
+    const blocks2 = [];
+    for (const tab of component.tabs) {
+      const title = resolveDynamic(tab.title, options.resolveValue);
+      const genBlockId = options.generateBlockId ?? defaultBlockId;
+      blocks2.push({
+        id: genBlockId(`${component.id}-tab-${tab.child}`),
+        type: "text",
+        status: "completed",
+        content: { text: `**${title}**` }
+      });
+      blocks2.push(...flattenComponents(tab.child, componentMap, options, visited));
+    }
+    return blocks2;
+  }
+  if (isContainer) {
+    const blocks2 = [];
+    for (const childId of childIds) {
+      blocks2.push(...flattenComponents(childId, componentMap, options, visited));
+    }
+    return blocks2;
+  }
+  const blocks = [componentToBlock(component, options)];
+  for (const childId of childIds) {
+    blocks.push(...flattenComponents(childId, componentMap, options, visited));
+  }
+  return blocks;
+}
+function fromA2UIPayload(payload, options = {}) {
+  const update = payload.updateComponents;
+  if (!update) return null;
+  const { surfaceId, components } = update;
+  const genConvId = options.generateConversationId ?? defaultConversationId;
+  const componentMap = buildComponentMap(components);
+  const root = findRoot(components);
+  let blocks;
+  if (root) {
+    blocks = flattenComponents(root.id, componentMap, options);
+  } else {
+    blocks = components.filter((c) => !CONTAINER_TYPES.has(c.component)).map((c) => componentToBlock(c, options));
+  }
+  return {
+    id: genConvId(surfaceId),
+    role: "assistant",
+    status: "completed",
+    blocks,
+    timestamp: Date.now()
+  };
+}
+function fromA2UIPayloads(payloads, options = {}) {
+  const results = [];
+  for (const payload of payloads) {
+    const conv = fromA2UIPayload(payload, options);
+    if (conv) results.push(conv);
+  }
+  return results;
+}
+function toA2UIPayload(conversation, surfaceId, version = "v0.10") {
+  const sid = surfaceId ?? conversation.id;
+  const components = [];
+  const childIds = [];
+  for (const block of conversation.blocks) {
+    const compId = `comp-${block.id}`;
+    childIds.push(compId);
+    switch (block.type) {
+      case "text": {
+        const content = block.content;
+        components.push({
+          id: compId,
+          component: "Text",
+          text: content.text
+        });
+        break;
+      }
+      case "image": {
+        const content = block.content;
+        components.push({
+          id: compId,
+          component: "Image",
+          url: content.url
+        });
+        break;
+      }
+      case "thinking": {
+        const content = block.content;
+        components.push({
+          id: compId,
+          component: "Text",
+          text: `*Thinking: ${content.reasoning}*`
+        });
+        break;
+      }
+      case "tool": {
+        const content = block.content;
+        const parts = [`**Tool: ${content.name}**`];
+        if (content.input) parts.push(`Input: \`${JSON.stringify(content.input)}\``);
+        if (content.output) parts.push(`Output: \`${JSON.stringify(content.output)}\``);
+        parts.push(`Status: ${content.status}`);
+        components.push({
+          id: compId,
+          component: "Text",
+          text: parts.join("\n\n")
+        });
+        break;
+      }
+      case "error": {
+        const content = block.content;
+        components.push({
+          id: compId,
+          component: "Text",
+          text: `**Error [${content.code}]:** ${content.message}`
+        });
+        break;
+      }
+      case "file": {
+        const content = block.content;
+        components.push({
+          id: compId,
+          component: "Text",
+          text: `[File: ${content.name}](${content.url})`
+        });
+        break;
+      }
+      case "source": {
+        const content = block.content;
+        const text = content.url ? `[Source: ${content.title}](${content.url})` : `Source: ${content.title}`;
+        components.push({
+          id: compId,
+          component: "Text",
+          text: content.excerpt ? `${text}
+
+> ${content.excerpt}` : text
+        });
+        break;
+      }
+      default: {
+        components.push({
+          id: compId,
+          component: "Text",
+          text: `[${block.type}: ${block.id}]`
+        });
+        break;
+      }
+    }
+  }
+  components.unshift({
+    id: "root",
+    component: "Column",
+    children: childIds
+  });
+  return {
+    version,
+    updateComponents: {
+      surfaceId: sid,
+      components
+    }
+  };
+}
+export {
+  fromA2UIPayload,
+  fromA2UIPayloads,
+  toA2UIPayload
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @uix-ai/adapter-a2ui\n *\n * Adapter to convert Google A2UI protocol payloads to UIX Lucid IR format.\n *\n * A2UI is a declarative UI protocol where agents generate JSON payloads\n * describing UI components. Unlike AG-UI (event streaming), A2UI is\n * snapshot-based - the agent sends a complete UI description as JSON.\n *\n * This adapter converts A2UI's component tree into UIX LucidConversation\n * and LucidBlock structures for rendering with UIX components.\n *\n * @see https://github.com/google/A2UI\n *\n * @example\n * ```typescript\n * import { fromA2UIPayload, toA2UIPayload } from '@uix-ai/adapter-a2ui'\n *\n * // Convert A2UI payload to UIX Lucid IR\n * const conversation = fromA2UIPayload(a2uiPayload)\n *\n * // Convert UIX Lucid IR back to A2UI payload\n * const payload = toA2UIPayload(conversation)\n * ```\n */\n\nimport type {\n  LucidConversation,\n  LucidBlock,\n  ContentStatus,\n  BlockType,\n  TextBlockContent,\n  ImageBlockContent,\n  ErrorBlockContent,\n} from '@uix-ai/core'\n\n// ============================================================================\n// A2UI Protocol Types\n// ============================================================================\n\n/**\n * A2UI protocol version\n */\nexport type A2UIVersion = 'v0.8' | 'v0.9' | 'v0.10'\n\n/**\n * A2UI display component types\n */\nexport type A2UIDisplayComponent = 'Text' | 'Image' | 'Icon' | 'Video' | 'AudioPlayer'\n\n/**\n * A2UI container component types\n */\nexport type A2UIContainerComponent = 'Row' | 'Column' | 'Card' | 'List' | 'Tabs' | 'Modal'\n\n/**\n * A2UI input component types\n */\nexport type A2UIInputComponent = 'TextField' | 'CheckBox' | 'DateTimeInput' | 'ChoicePicker' | 'Slider'\n\n/**\n * A2UI interactive component types\n */\nexport type A2UIInteractiveComponent = 'Button' | 'Divider'\n\n/**\n * Union of all A2UI component type names\n */\nexport type A2UIComponentType =\n  | A2UIDisplayComponent\n  | A2UIContainerComponent\n  | A2UIInputComponent\n  | A2UIInteractiveComponent\n\n// ============================================================================\n// A2UI Dynamic Value Types\n// ============================================================================\n\n/**\n * A2UI dynamic string - either a literal or a data-binding reference\n */\nexport type A2UIDynamicString = string | { path: string } | { call: string; args: Record<string, unknown> }\n\n/**\n * A2UI dynamic number\n */\nexport type A2UIDynamicNumber = number | { path: string } | { call: string; args: Record<string, unknown> }\n\n/**\n * A2UI dynamic boolean\n */\nexport type A2UIDynamicBoolean = boolean | { path: string } | { call: string; args: Record<string, unknown> }\n\n/**\n * A2UI child list - either an array of IDs or a template binding\n */\nexport type A2UIChildList = string[] | { path: string; componentId: string }\n\n// ============================================================================\n// A2UI Validation & Actions\n// ============================================================================\n\n/**\n * A2UI validation check\n */\nexport interface A2UICheck {\n  call: string\n  args: Record<string, unknown>\n  message: string\n}\n\n/**\n * A2UI event action\n */\nexport interface A2UIEventAction {\n  name: string\n  context?: Record<string, unknown>\n}\n\n/**\n * A2UI function call action\n */\nexport interface A2UIFunctionCallAction {\n  name: string\n  args?: Record<string, unknown>\n}\n\n/**\n * A2UI action - either an event or a function call\n */\nexport interface A2UIAction {\n  event?: A2UIEventAction\n  functionCall?: A2UIFunctionCallAction\n}\n\n// ============================================================================\n// A2UI Component Definition\n// ============================================================================\n\n/**\n * A2UI component object in the flat adjacency list\n *\n * Components are stored as a flat array and reference each other by ID.\n * The tree structure is built via `children` and `child` properties.\n */\nexport interface A2UIComponent {\n  /** Unique identifier for this component */\n  id: string\n  /** Component type name */\n  component: A2UIComponentType | string\n  /** Child component IDs (for container components like Row, Column, List) */\n  children?: A2UIChildList\n  /** Single child component ID (for Card, Modal) */\n  child?: string\n  /** Text content (for Text, Button) */\n  text?: A2UIDynamicString\n  /** Label (for input components) */\n  label?: A2UIDynamicString\n  /** URL (for Image, Video, AudioPlayer) */\n  url?: A2UIDynamicString\n  /** Icon name (for Icon) */\n  name?: A2UIDynamicString\n  /** Value binding (for input components) */\n  value?: A2UIDynamicString | A2UIDynamicNumber | A2UIDynamicBoolean\n  /** Action on interaction (for Button) */\n  action?: A2UIAction\n  /** Validation checks (for TextField, Button) */\n  checks?: A2UICheck[]\n  /** Button variant */\n  variant?: string\n  /** Layout alignment */\n  justify?: string\n  /** Layout cross-axis alignment */\n  align?: string\n  /** Axis for Divider */\n  axis?: string\n  /** Tabs configuration */\n  tabs?: Array<{ title: A2UIDynamicString; child: string }>\n  /** Slider min value */\n  min?: number\n  /** Slider max value */\n  max?: number\n  /** Choice picker options */\n  options?: Array<{ label: A2UIDynamicString; value: string }>\n  /** Any additional properties from custom or extended components */\n  [key: string]: unknown\n}\n\n// ============================================================================\n// A2UI Theme\n// ============================================================================\n\n/**\n * A2UI surface theme configuration\n */\nexport interface A2UITheme {\n  primaryColor?: string\n  [key: string]: unknown\n}\n\n// ============================================================================\n// A2UI Message Types\n// ============================================================================\n\n/**\n * createSurface message - initializes a new UI surface\n */\nexport interface A2UICreateSurface {\n  surfaceId: string\n  catalogId?: string\n  theme?: A2UITheme\n  sendDataModel?: boolean\n}\n\n/**\n * updateComponents message - adds or updates UI components\n */\nexport interface A2UIUpdateComponents {\n  surfaceId: string\n  components: A2UIComponent[]\n}\n\n/**\n * updateDataModel message - modifies data model via JSON pointer\n */\nexport interface A2UIUpdateDataModel {\n  surfaceId: string\n  path?: string\n  value?: unknown\n}\n\n/**\n * deleteSurface message - removes a surface\n */\nexport interface A2UIDeleteSurface {\n  surfaceId: string\n}\n\n// ============================================================================\n// A2UI Payload (Top-Level Message)\n// ============================================================================\n\n/**\n * Top-level A2UI message payload.\n *\n * Each message contains exactly one of the four message types:\n * - `createSurface`: Initialize a new UI surface\n * - `updateComponents`: Add or update components on a surface\n * - `updateDataModel`: Modify the surface data model\n * - `deleteSurface`: Remove a surface\n */\nexport interface A2UIPayload {\n  /** A2UI protocol version */\n  version: string\n  /** Create a new surface */\n  createSurface?: A2UICreateSurface\n  /** Update components on a surface */\n  updateComponents?: A2UIUpdateComponents\n  /** Update the data model */\n  updateDataModel?: A2UIUpdateDataModel\n  /** Delete a surface */\n  deleteSurface?: A2UIDeleteSurface\n}\n\n// ============================================================================\n// Conversion Options\n// ============================================================================\n\n/**\n * Options for A2UI to Lucid IR conversion\n */\nexport interface A2UIConversionOptions {\n  /**\n   * Custom ID generator for conversations\n   * @default () => `a2ui-conv-${surfaceId}`\n   */\n  generateConversationId?: (surfaceId: string) => string\n\n  /**\n   * Custom ID generator for blocks\n   * @default () => `a2ui-block-${componentId}`\n   */\n  generateBlockId?: (componentId: string) => string\n\n  /**\n   * Resolve dynamic string values against a data model.\n   * If not provided, dynamic bindings are serialized as-is.\n   */\n  resolveValue?: (dynamic: A2UIDynamicString | A2UIDynamicNumber | A2UIDynamicBoolean) => string\n}\n\n// ============================================================================\n// Internal Helpers\n// ============================================================================\n\nlet blockIdCounter = 0\n\nfunction defaultConversationId(surfaceId: string): string {\n  return `a2ui-conv-${surfaceId}`\n}\n\nfunction defaultBlockId(componentId: string): string {\n  return `a2ui-block-${componentId}-${++blockIdCounter}`\n}\n\n/**\n * Resolve a dynamic value to a plain string.\n * Literal values are returned directly; bindings are serialized for display.\n */\nfunction resolveDynamic(\n  value: A2UIDynamicString | A2UIDynamicNumber | A2UIDynamicBoolean | undefined,\n  resolver?: (v: A2UIDynamicString | A2UIDynamicNumber | A2UIDynamicBoolean) => string\n): string {\n  if (value === undefined || value === null) return ''\n  if (typeof value === 'string') return value\n  if (typeof value === 'number' || typeof value === 'boolean') return String(value)\n  if (resolver) return resolver(value)\n  // Fallback: serialize binding as a readable placeholder\n  if ('path' in value) return `{{${value.path}}}`\n  if ('call' in value) return `{{${value.call}(...)}}`\n  return JSON.stringify(value)\n}\n\n/**\n * Build a lookup map from component array\n */\nfunction buildComponentMap(components: A2UIComponent[]): Map<string, A2UIComponent> {\n  const map = new Map<string, A2UIComponent>()\n  for (const comp of components) {\n    map.set(comp.id, comp)\n  }\n  return map\n}\n\n/**\n * Find the root component (id === 'root') in the component list\n */\nfunction findRoot(components: A2UIComponent[]): A2UIComponent | undefined {\n  return components.find((c) => c.id === 'root')\n}\n\n/**\n * Get direct children IDs from a component\n */\nfunction getChildIds(component: A2UIComponent): string[] {\n  if (component.child) return [component.child]\n  if (Array.isArray(component.children)) return component.children\n  // Template children (data-bound) cannot be resolved without a data model\n  return []\n}\n\n// ============================================================================\n// A2UI Component to LucidBlock Mapping\n// ============================================================================\n\n/**\n * Map an A2UI component type to a UIX BlockType.\n *\n * Direct mappings:\n * - Text -> 'text'\n * - Image -> 'image'\n *\n * Components without a direct mapping are represented as 'text' blocks\n * with a structured description of the component.\n */\nfunction mapComponentType(componentType: string): BlockType {\n  switch (componentType) {\n    case 'Text':\n      return 'text'\n    case 'Image':\n      return 'image'\n    default:\n      return 'text'\n  }\n}\n\n/**\n * Convert a single A2UI component to a LucidBlock.\n *\n * For components that map directly to UIX block types (Text, Image),\n * the content is converted to the matching block content type.\n *\n * For other components (Button, TextField, Card, etc.), a text block\n * is produced with a structured markdown representation.\n */\nfunction componentToBlock(\n  component: A2UIComponent,\n  options: A2UIConversionOptions = {}\n): LucidBlock {\n  const genBlockId = options.generateBlockId ?? defaultBlockId\n  const blockId = genBlockId(component.id)\n  const resolve = (v: A2UIDynamicString | A2UIDynamicNumber | A2UIDynamicBoolean | undefined) =>\n    resolveDynamic(v, options.resolveValue)\n\n  switch (component.component) {\n    case 'Text':\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: resolve(component.text),\n        } as TextBlockContent,\n      }\n\n    case 'Image':\n      return {\n        id: blockId,\n        type: 'image',\n        status: 'completed' as ContentStatus,\n        content: {\n          url: resolve(component.url),\n          alt: component.id,\n        } as ImageBlockContent,\n      }\n\n    case 'Button': {\n      const label = resolve(component.text) || component.id\n      const actionDesc = component.action?.event\n        ? `action:${component.action.event.name}`\n        : component.action?.functionCall\n          ? `call:${component.action.functionCall.name}`\n          : ''\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: `[Button: ${label}]${actionDesc ? ` (${actionDesc})` : ''}`,\n        } as TextBlockContent,\n      }\n    }\n\n    case 'TextField': {\n      const label = resolve(component.label) || component.id\n      const val = resolve(component.value)\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: `[TextField: ${label}]${val ? ` value=\"${val}\"` : ''}`,\n        } as TextBlockContent,\n      }\n    }\n\n    case 'CheckBox': {\n      const label = resolve(component.label) || component.id\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: `[CheckBox: ${label}]`,\n        } as TextBlockContent,\n      }\n    }\n\n    case 'DateTimeInput': {\n      const label = resolve(component.label) || component.id\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: `[DateTimeInput: ${label}]`,\n        } as TextBlockContent,\n      }\n    }\n\n    case 'ChoicePicker': {\n      const label = resolve(component.label) || component.id\n      const optionLabels = component.options\n        ? component.options.map((o) => resolve(o.label)).join(', ')\n        : ''\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: `[ChoicePicker: ${label}]${optionLabels ? ` options=[${optionLabels}]` : ''}`,\n        } as TextBlockContent,\n      }\n    }\n\n    case 'Slider': {\n      const label = resolve(component.label) || component.id\n      const min = component.min ?? 0\n      const max = component.max ?? 100\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: `[Slider: ${label}] range=[${min}, ${max}]`,\n        } as TextBlockContent,\n      }\n    }\n\n    case 'Video':\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: `[Video: ${resolve(component.url)}]`,\n        } as TextBlockContent,\n      }\n\n    case 'AudioPlayer':\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: `[Audio: ${resolve(component.url)}]`,\n        } as TextBlockContent,\n      }\n\n    case 'Icon':\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: `[Icon: ${resolve(component.name)}]`,\n        } as TextBlockContent,\n      }\n\n    case 'Divider':\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: '---',\n        } as TextBlockContent,\n      }\n\n    // Container components (Row, Column, Card, List, Tabs, Modal)\n    // are flattened - their children are emitted as separate blocks.\n    // A container itself does not produce a block.\n    // This default handles any unknown/custom component types.\n    default:\n      return {\n        id: blockId,\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: {\n          text: `[${component.component}: ${component.id}]`,\n        } as TextBlockContent,\n      }\n  }\n}\n\n/**\n * Container component types whose children should be traversed\n * but which do not produce blocks themselves.\n */\nconst CONTAINER_TYPES = new Set(['Row', 'Column', 'Card', 'List', 'Tabs', 'Modal'])\n\n/**\n * Recursively flatten the A2UI component tree into LucidBlocks.\n *\n * Container components are traversed but not emitted as blocks.\n * Leaf/display/input/interactive components are converted to blocks.\n */\nfunction flattenComponents(\n  rootId: string,\n  componentMap: Map<string, A2UIComponent>,\n  options: A2UIConversionOptions = {},\n  visited: Set<string> = new Set()\n): LucidBlock[] {\n  if (visited.has(rootId)) return []\n  visited.add(rootId)\n\n  const component = componentMap.get(rootId)\n  if (!component) return []\n\n  const isContainer = CONTAINER_TYPES.has(component.component)\n  const childIds = getChildIds(component)\n\n  // For Tabs, children are defined differently\n  if (component.component === 'Tabs' && component.tabs) {\n    const blocks: LucidBlock[] = []\n    for (const tab of component.tabs) {\n      const title = resolveDynamic(tab.title, options.resolveValue)\n      const genBlockId = options.generateBlockId ?? defaultBlockId\n      blocks.push({\n        id: genBlockId(`${component.id}-tab-${tab.child}`),\n        type: 'text',\n        status: 'completed' as ContentStatus,\n        content: { text: `**${title}**` } as TextBlockContent,\n      })\n      blocks.push(...flattenComponents(tab.child, componentMap, options, visited))\n    }\n    return blocks\n  }\n\n  if (isContainer) {\n    // Recurse into children, skip the container itself\n    const blocks: LucidBlock[] = []\n    for (const childId of childIds) {\n      blocks.push(...flattenComponents(childId, componentMap, options, visited))\n    }\n    return blocks\n  }\n\n  // Leaf component - convert to block, then also traverse any children\n  const blocks: LucidBlock[] = [componentToBlock(component, options)]\n  for (const childId of childIds) {\n    blocks.push(...flattenComponents(childId, componentMap, options, visited))\n  }\n  return blocks\n}\n\n// ============================================================================\n// Public Conversion Functions\n// ============================================================================\n\n/**\n * Convert an A2UI payload (containing updateComponents) to a UIX LucidConversation.\n *\n * The A2UI component tree is flattened into a linear sequence of LucidBlocks:\n * - `Text` components become text blocks\n * - `Image` components become image blocks\n * - Input and interactive components become text blocks with structured descriptions\n * - Container components (Row, Column, Card, etc.) are traversed but not emitted\n *\n * @param payload - An A2UI payload message (must contain updateComponents)\n * @param options - Conversion options\n * @returns A LucidConversation representing the A2UI surface, or null if the payload\n *          does not contain updateComponents\n *\n * @example\n * ```typescript\n * const payload: A2UIPayload = {\n *   version: 'v0.10',\n *   updateComponents: {\n *     surfaceId: 'form_1',\n *     components: [\n *       { id: 'root', component: 'Column', children: ['title', 'img'] },\n *       { id: 'title', component: 'Text', text: 'Hello World' },\n *       { id: 'img', component: 'Image', url: 'https://example.com/photo.png' }\n *     ]\n *   }\n * }\n *\n * const conversation = fromA2UIPayload(payload)\n * // conversation.blocks[0] -> text block \"Hello World\"\n * // conversation.blocks[1] -> image block\n * ```\n */\nexport function fromA2UIPayload(\n  payload: A2UIPayload,\n  options: A2UIConversionOptions = {}\n): LucidConversation | null {\n  const update = payload.updateComponents\n  if (!update) return null\n\n  const { surfaceId, components } = update\n  const genConvId = options.generateConversationId ?? defaultConversationId\n\n  const componentMap = buildComponentMap(components)\n  const root = findRoot(components)\n\n  let blocks: LucidBlock[]\n  if (root) {\n    blocks = flattenComponents(root.id, componentMap, options)\n  } else {\n    // No root found - convert all components linearly\n    blocks = components\n      .filter((c) => !CONTAINER_TYPES.has(c.component))\n      .map((c) => componentToBlock(c, options))\n  }\n\n  return {\n    id: genConvId(surfaceId),\n    role: 'assistant',\n    status: 'completed',\n    blocks,\n    timestamp: Date.now(),\n  }\n}\n\n/**\n * Convert multiple A2UI payloads (a stream of messages) to LucidConversations.\n *\n * Processes an array of A2UI messages and returns one LucidConversation per\n * updateComponents message encountered.\n *\n * @param payloads - Array of A2UI payload messages\n * @param options - Conversion options\n * @returns Array of LucidConversations\n *\n * @example\n * ```typescript\n * const messages: A2UIPayload[] = [\n *   { version: 'v0.10', createSurface: { surfaceId: 's1', catalogId: '...' } },\n *   { version: 'v0.10', updateComponents: { surfaceId: 's1', components: [...] } },\n * ]\n *\n * const conversations = fromA2UIPayloads(messages)\n * ```\n */\nexport function fromA2UIPayloads(\n  payloads: A2UIPayload[],\n  options: A2UIConversionOptions = {}\n): LucidConversation[] {\n  const results: LucidConversation[] = []\n  for (const payload of payloads) {\n    const conv = fromA2UIPayload(payload, options)\n    if (conv) results.push(conv)\n  }\n  return results\n}\n\n/**\n * Convert a UIX LucidConversation back to an A2UI payload.\n *\n * Maps LucidBlocks back to A2UI components wrapped in a Column layout:\n * - text blocks -> Text components\n * - image blocks -> Image components\n * - Other block types -> Text components with type annotation\n *\n * @param conversation - A UIX LucidConversation\n * @param surfaceId - Optional surface ID (defaults to conversation.id)\n * @param version - A2UI protocol version (defaults to 'v0.10')\n * @returns An A2UI payload with updateComponents\n *\n * @example\n * ```typescript\n * const conversation: LucidConversation = {\n *   id: 'conv-1',\n *   role: 'assistant',\n *   status: 'completed',\n *   blocks: [\n *     { id: 'b1', type: 'text', status: 'completed', content: { text: 'Hello' } },\n *     { id: 'b2', type: 'image', status: 'completed', content: { url: 'https://...' } }\n *   ],\n *   timestamp: Date.now()\n * }\n *\n * const payload = toA2UIPayload(conversation)\n * ```\n */\nexport function toA2UIPayload(\n  conversation: LucidConversation,\n  surfaceId?: string,\n  version: string = 'v0.10'\n): A2UIPayload {\n  const sid = surfaceId ?? conversation.id\n  const components: A2UIComponent[] = []\n  const childIds: string[] = []\n\n  for (const block of conversation.blocks) {\n    const compId = `comp-${block.id}`\n    childIds.push(compId)\n\n    switch (block.type) {\n      case 'text': {\n        const content = block.content as TextBlockContent\n        components.push({\n          id: compId,\n          component: 'Text',\n          text: content.text,\n        })\n        break\n      }\n\n      case 'image': {\n        const content = block.content as ImageBlockContent\n        components.push({\n          id: compId,\n          component: 'Image',\n          url: content.url,\n        })\n        break\n      }\n\n      case 'thinking': {\n        const content = block.content as { reasoning: string }\n        components.push({\n          id: compId,\n          component: 'Text',\n          text: `*Thinking: ${content.reasoning}*`,\n        })\n        break\n      }\n\n      case 'tool': {\n        const content = block.content as { name: string; input: unknown; output?: unknown; status: string }\n        const parts = [`**Tool: ${content.name}**`]\n        if (content.input) parts.push(`Input: \\`${JSON.stringify(content.input)}\\``)\n        if (content.output) parts.push(`Output: \\`${JSON.stringify(content.output)}\\``)\n        parts.push(`Status: ${content.status}`)\n        components.push({\n          id: compId,\n          component: 'Text',\n          text: parts.join('\\n\\n'),\n        })\n        break\n      }\n\n      case 'error': {\n        const content = block.content as ErrorBlockContent\n        components.push({\n          id: compId,\n          component: 'Text',\n          text: `**Error [${content.code}]:** ${content.message}`,\n        })\n        break\n      }\n\n      case 'file': {\n        const content = block.content as { name: string; url: string; type: string }\n        components.push({\n          id: compId,\n          component: 'Text',\n          text: `[File: ${content.name}](${content.url})`,\n        })\n        break\n      }\n\n      case 'source': {\n        const content = block.content as { title: string; url?: string; excerpt?: string }\n        const text = content.url\n          ? `[Source: ${content.title}](${content.url})`\n          : `Source: ${content.title}`\n        components.push({\n          id: compId,\n          component: 'Text',\n          text: content.excerpt ? `${text}\\n\\n> ${content.excerpt}` : text,\n        })\n        break\n      }\n\n      default: {\n        components.push({\n          id: compId,\n          component: 'Text',\n          text: `[${block.type}: ${block.id}]`,\n        })\n        break\n      }\n    }\n  }\n\n  // Wrap all components in a root Column\n  components.unshift({\n    id: 'root',\n    component: 'Column',\n    children: childIds,\n  })\n\n  return {\n    version,\n    updateComponents: {\n      surfaceId: sid,\n      components,\n    },\n  }\n}\n"],"mappings":"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","names":["blocks"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@uix-ai/adapter-a2ui",
+  "version": "0.0.1",
+  "description": "Adapter to convert Google A2UI protocol payloads to UIX Lucid IR format",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@uix-ai/core": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "uix",
+    "a2ui",
+    "agent-ui",
+    "adapter",
+    "protocol",
+    "converter",
+    "google"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Deepractice/UIX.git",
+    "directory": "packages/adapter-a2ui"
+  }
+}