@genkit-ai/a2ui 0.5.0-rc.0

package/lib/client.d.mts

@@ -0,0 +1,59 @@
+import { A2uiEnvelope, A2uiClientAction, A2uiPart } from './types.mjs';
+export { A2UI_MIME_TYPE, A2UI_VERSION, A2uiComponent, BASIC_CATALOG_ID } from './types.mjs';
+export { a2uiEnvelopesFromParts, a2uiPart, isA2uiPart } from './part.mjs';
+import 'genkit';
+
+/** A single event yielded while streaming an A2UI agent turn. */
+type A2uiStreamEvent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'envelopes';
+    envelopes: A2uiEnvelope[];
+};
+/** Options for {@link streamA2uiAgent}. */
+interface StreamA2uiAgentOptions {
+    /** URL of the Genkit agent/flow endpoint (e.g. `/uiAgent`). */
+    url: string;
+    /** The user message to send (Genkit message data or a plain string). */
+    message: string | Record<string, unknown>;
+    /** Server-managed session id (a UUID). */
+    sessionId?: string;
+    /** Extra HTTP headers. */
+    headers?: Record<string, string>;
+    /** Abort signal to cancel the request. */
+    abortSignal?: AbortSignal;
+}
+/**
+ * Streams an A2UI-enabled Genkit agent, yielding prose text deltas and complete
+ * A2UI envelope batches in the order they arrive. Feed the envelopes to your
+ * renderer's message processor.
+ *
+ * @example
+ * ```ts
+ * import { MessageProcessor } from '@a2ui/web_core/v0_9';
+ * import { basicCatalog } from '@a2ui/lit/v0_9';
+ * import { streamA2uiAgent } from '@genkit-ai/a2ui/client';
+ *
+ * const processor = new MessageProcessor([basicCatalog]);
+ * for await (const ev of streamA2uiAgent({ url: '/uiAgent', message: 'weather in Tokyo' })) {
+ *   if (ev.type === 'text') appendProse(ev.text);
+ *   else processor.processMessages(ev.envelopes);
+ * }
+ * ```
+ */
+declare function streamA2uiAgent(options: StreamA2uiAgentOptions): AsyncGenerator<A2uiStreamEvent, void, unknown>;
+/**
+ * Builds the agent input for sending a rendered surface's user action back to
+ * the agent as the next turn. The action's `name` becomes the user message so
+ * the agent can react to it; the full action object is attached as an a2ui data
+ * part for richer handling.
+ */
+declare function actionToMessage(action: A2uiClientAction): {
+    role: string;
+    content: (A2uiPart | {
+        text: string;
+    })[];
+};
+
+export { A2uiClientAction, A2uiEnvelope, A2uiPart, type A2uiStreamEvent, type StreamA2uiAgentOptions, actionToMessage, streamA2uiAgent };

package/lib/client.d.ts

@@ -0,0 +1,59 @@
+import { A2uiEnvelope, A2uiClientAction, A2uiPart } from './types.js';
+export { A2UI_MIME_TYPE, A2UI_VERSION, A2uiComponent, BASIC_CATALOG_ID } from './types.js';
+export { a2uiEnvelopesFromParts, a2uiPart, isA2uiPart } from './part.js';
+import 'genkit';
+
+/** A single event yielded while streaming an A2UI agent turn. */
+type A2uiStreamEvent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'envelopes';
+    envelopes: A2uiEnvelope[];
+};
+/** Options for {@link streamA2uiAgent}. */
+interface StreamA2uiAgentOptions {
+    /** URL of the Genkit agent/flow endpoint (e.g. `/uiAgent`). */
+    url: string;
+    /** The user message to send (Genkit message data or a plain string). */
+    message: string | Record<string, unknown>;
+    /** Server-managed session id (a UUID). */
+    sessionId?: string;
+    /** Extra HTTP headers. */
+    headers?: Record<string, string>;
+    /** Abort signal to cancel the request. */
+    abortSignal?: AbortSignal;
+}
+/**
+ * Streams an A2UI-enabled Genkit agent, yielding prose text deltas and complete
+ * A2UI envelope batches in the order they arrive. Feed the envelopes to your
+ * renderer's message processor.
+ *
+ * @example
+ * ```ts
+ * import { MessageProcessor } from '@a2ui/web_core/v0_9';
+ * import { basicCatalog } from '@a2ui/lit/v0_9';
+ * import { streamA2uiAgent } from '@genkit-ai/a2ui/client';
+ *
+ * const processor = new MessageProcessor([basicCatalog]);
+ * for await (const ev of streamA2uiAgent({ url: '/uiAgent', message: 'weather in Tokyo' })) {
+ *   if (ev.type === 'text') appendProse(ev.text);
+ *   else processor.processMessages(ev.envelopes);
+ * }
+ * ```
+ */
+declare function streamA2uiAgent(options: StreamA2uiAgentOptions): AsyncGenerator<A2uiStreamEvent, void, unknown>;
+/**
+ * Builds the agent input for sending a rendered surface's user action back to
+ * the agent as the next turn. The action's `name` becomes the user message so
+ * the agent can react to it; the full action object is attached as an a2ui data
+ * part for richer handling.
+ */
+declare function actionToMessage(action: A2uiClientAction): {
+    role: string;
+    content: (A2uiPart | {
+        text: string;
+    })[];
+};
+
+export { A2uiClientAction, A2uiEnvelope, A2uiPart, type A2uiStreamEvent, type StreamA2uiAgentOptions, actionToMessage, streamA2uiAgent };

package/lib/client.js

@@ -0,0 +1,82 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var client_exports = {};
+__export(client_exports, {
+  A2UI_MIME_TYPE: () => import_types.A2UI_MIME_TYPE,
+  A2UI_VERSION: () => import_types.A2UI_VERSION,
+  BASIC_CATALOG_ID: () => import_types.BASIC_CATALOG_ID,
+  a2uiEnvelopesFromParts: () => import_part2.a2uiEnvelopesFromParts,
+  a2uiPart: () => import_part2.a2uiPart,
+  actionToMessage: () => actionToMessage,
+  isA2uiPart: () => import_part2.isA2uiPart,
+  streamA2uiAgent: () => streamA2uiAgent
+});
+module.exports = __toCommonJS(client_exports);
+var import_client = require("genkit/beta/client");
+var import_part = require("./part.js");
+var import_part2 = require("./part.js");
+var import_types = require("./types.js");
+function toMessage(message) {
+  if (typeof message === "string") {
+    return { role: "user", content: [{ text: message }] };
+  }
+  return message;
+}
+async function* streamA2uiAgent(options) {
+  const agent = (0, import_client.remoteAgent)({ url: options.url, headers: options.headers });
+  const chat = agent.chat(
+    options.sessionId ? { sessionId: options.sessionId } : void 0
+  );
+  const turn = chat.sendStream(
+    { message: toMessage(options.message) },
+    { abortSignal: options.abortSignal }
+  );
+  for await (const chunk of turn.stream) {
+    if (chunk.text) {
+      yield { type: "text", text: chunk.text };
+    }
+    const envelopes = (0, import_part.a2uiEnvelopesFromParts)(chunk.raw.modelChunk?.content);
+    if (envelopes.length > 0) {
+      yield { type: "envelopes", envelopes };
+    }
+  }
+  await turn.response;
+}
+function actionToMessage(action) {
+  if (!action) {
+    throw new Error("actionToMessage: action is required");
+  }
+  const summary = `User interacted with the UI (surface "${action.surfaceId}"): action "${action.name}"` + (action.context && Object.keys(action.context).length ? ` with context ${JSON.stringify(action.context)}` : "") + ".";
+  return {
+    role: "user",
+    content: [{ text: summary }, (0, import_part.a2uiPart)([{ action }])]
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  A2UI_MIME_TYPE,
+  A2UI_VERSION,
+  BASIC_CATALOG_ID,
+  a2uiEnvelopesFromParts,
+  a2uiPart,
+  actionToMessage,
+  isA2uiPart,
+  streamA2uiAgent
+});
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["/**\n * Copyright 2026 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Browser-safe client helpers for consuming an A2UI-enabled Genkit agent.\n *\n * This module has NO Node dependencies. It builds on Genkit's agent client\n * (`remoteAgent` from `genkit/beta/client`), filters A2UI parts out of the\n * agent stream, and hands whole envelopes to whatever renderer you use (e.g.\n * `@a2ui/web_core`'s `MessageProcessor`).\n *\n * @module\n */\n\nimport { remoteAgent } from 'genkit/beta/client';\nimport { a2uiEnvelopesFromParts, a2uiPart } from './part.js';\nimport type { A2uiClientAction, A2uiEnvelope } from './types.js';\n\nexport { a2uiEnvelopesFromParts, a2uiPart, isA2uiPart } from './part.js';\nexport {\n  A2UI_MIME_TYPE,\n  A2UI_VERSION,\n  BASIC_CATALOG_ID,\n  type A2uiClientAction,\n  type A2uiComponent,\n  type A2uiEnvelope,\n  type A2uiPart,\n} from './types.js';\n\n/** A single event yielded while streaming an A2UI agent turn. */\nexport type A2uiStreamEvent =\n  | { type: 'text'; text: string }\n  | { type: 'envelopes'; envelopes: A2uiEnvelope[] };\n\n/** Options for {@link streamA2uiAgent}. */\nexport interface StreamA2uiAgentOptions {\n  /** URL of the Genkit agent/flow endpoint (e.g. `/uiAgent`). */\n  url: string;\n  /** The user message to send (Genkit message data or a plain string). */\n  message: string | Record<string, unknown>;\n  /** Server-managed session id (a UUID). */\n  sessionId?: string;\n  /** Extra HTTP headers. */\n  headers?: Record<string, string>;\n  /** Abort signal to cancel the request. */\n  abortSignal?: AbortSignal;\n}\n\n/** Normalizes a string message into a Genkit user message. */\nfunction toMessage(message: string | Record<string, unknown>) {\n  if (typeof message === 'string') {\n    return { role: 'user', content: [{ text: message }] };\n  }\n  return message;\n}\n\n/**\n * Streams an A2UI-enabled Genkit agent, yielding prose text deltas and complete\n * A2UI envelope batches in the order they arrive. Feed the envelopes to your\n * renderer's message processor.\n *\n * @example\n * ```ts\n * import { MessageProcessor } from '@a2ui/web_core/v0_9';\n * import { basicCatalog } from '@a2ui/lit/v0_9';\n * import { streamA2uiAgent } from '@genkit-ai/a2ui/client';\n *\n * const processor = new MessageProcessor([basicCatalog]);\n * for await (const ev of streamA2uiAgent({ url: '/uiAgent', message: 'weather in Tokyo' })) {\n *   if (ev.type === 'text') appendProse(ev.text);\n *   else processor.processMessages(ev.envelopes);\n * }\n * ```\n */\nexport async function* streamA2uiAgent(\n  options: StreamA2uiAgentOptions\n): AsyncGenerator<A2uiStreamEvent, void, unknown> {\n  const agent = remoteAgent({ url: options.url, headers: options.headers });\n  // A server-managed session id (when provided) attaches this turn to an\n  // existing conversation; otherwise the agent starts a fresh session.\n  const chat = agent.chat(\n    options.sessionId ? { sessionId: options.sessionId } : undefined\n  );\n\n  const turn = chat.sendStream(\n    { message: toMessage(options.message) } as Parameters<\n      typeof chat.sendStream\n    >[0],\n    { abortSignal: options.abortSignal }\n  );\n\n  for await (const chunk of turn.stream) {\n    if (chunk.text) {\n      yield { type: 'text', text: chunk.text };\n    }\n    // A2UI rides as data parts on the raw chunk; extract whole envelopes.\n    const envelopes = a2uiEnvelopesFromParts(chunk.raw.modelChunk?.content);\n    if (envelopes.length > 0) {\n      yield { type: 'envelopes', envelopes };\n    }\n  }\n  // Surface any server error / finalize the turn.\n  await turn.response;\n}\n\n/**\n * Builds the agent input for sending a rendered surface's user action back to\n * the agent as the next turn. The action's `name` becomes the user message so\n * the agent can react to it; the full action object is attached as an a2ui data\n * part for richer handling.\n */\nexport function actionToMessage(action: A2uiClientAction) {\n  if (!action) {\n    throw new Error('actionToMessage: action is required');\n  }\n  const summary =\n    `User interacted with the UI (surface \"${action.surfaceId}\"): ` +\n    `action \"${action.name}\"` +\n    (action.context && Object.keys(action.context).length\n      ? ` with context ${JSON.stringify(action.context)}`\n      : '') +\n    '.';\n  return {\n    role: 'user',\n    content: [{ text: summary }, a2uiPart([{ action }])],\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BA,oBAA4B;AAC5B,kBAAiD;AAGjD,IAAAA,eAA6D;AAC7D,mBAQO;AAsBP,SAAS,UAAU,SAA2C;AAC5D,MAAI,OAAO,YAAY,UAAU;AAC/B,WAAO,EAAE,MAAM,QAAQ,SAAS,CAAC,EAAE,MAAM,QAAQ,CAAC,EAAE;AAAA,EACtD;AACA,SAAO;AACT;AAoBA,gBAAuB,gBACrB,SACgD;AAChD,QAAM,YAAQ,2BAAY,EAAE,KAAK,QAAQ,KAAK,SAAS,QAAQ,QAAQ,CAAC;AAGxE,QAAM,OAAO,MAAM;AAAA,IACjB,QAAQ,YAAY,EAAE,WAAW,QAAQ,UAAU,IAAI;AAAA,EACzD;AAEA,QAAM,OAAO,KAAK;AAAA,IAChB,EAAE,SAAS,UAAU,QAAQ,OAAO,EAAE;AAAA,IAGtC,EAAE,aAAa,QAAQ,YAAY;AAAA,EACrC;AAEA,mBAAiB,SAAS,KAAK,QAAQ;AACrC,QAAI,MAAM,MAAM;AACd,YAAM,EAAE,MAAM,QAAQ,MAAM,MAAM,KAAK;AAAA,IACzC;AAEA,UAAM,gBAAY,oCAAuB,MAAM,IAAI,YAAY,OAAO;AACtE,QAAI,UAAU,SAAS,GAAG;AACxB,YAAM,EAAE,MAAM,aAAa,UAAU;AAAA,IACvC;AAAA,EACF;AAEA,QAAM,KAAK;AACb;AAQO,SAAS,gBAAgB,QAA0B;AACxD,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,qCAAqC;AAAA,EACvD;AACA,QAAM,UACJ,yCAAyC,OAAO,SAAS,eAC9C,OAAO,IAAI,OACrB,OAAO,WAAW,OAAO,KAAK,OAAO,OAAO,EAAE,SAC3C,iBAAiB,KAAK,UAAU,OAAO,OAAO,CAAC,KAC/C,MACJ;AACF,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS,CAAC,EAAE,MAAM,QAAQ,OAAG,sBAAS,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAAA,EACrD;AACF;","names":["import_part"]}

package/lib/client.mjs

@@ -0,0 +1,55 @@
+import { remoteAgent } from "genkit/beta/client";
+import { a2uiEnvelopesFromParts, a2uiPart } from "./part.mjs";
+import { a2uiEnvelopesFromParts as a2uiEnvelopesFromParts2, a2uiPart as a2uiPart2, isA2uiPart } from "./part.mjs";
+import {
+  A2UI_MIME_TYPE,
+  A2UI_VERSION,
+  BASIC_CATALOG_ID
+} from "./types.mjs";
+function toMessage(message) {
+  if (typeof message === "string") {
+    return { role: "user", content: [{ text: message }] };
+  }
+  return message;
+}
+async function* streamA2uiAgent(options) {
+  const agent = remoteAgent({ url: options.url, headers: options.headers });
+  const chat = agent.chat(
+    options.sessionId ? { sessionId: options.sessionId } : void 0
+  );
+  const turn = chat.sendStream(
+    { message: toMessage(options.message) },
+    { abortSignal: options.abortSignal }
+  );
+  for await (const chunk of turn.stream) {
+    if (chunk.text) {
+      yield { type: "text", text: chunk.text };
+    }
+    const envelopes = a2uiEnvelopesFromParts(chunk.raw.modelChunk?.content);
+    if (envelopes.length > 0) {
+      yield { type: "envelopes", envelopes };
+    }
+  }
+  await turn.response;
+}
+function actionToMessage(action) {
+  if (!action) {
+    throw new Error("actionToMessage: action is required");
+  }
+  const summary = `User interacted with the UI (surface "${action.surfaceId}"): action "${action.name}"` + (action.context && Object.keys(action.context).length ? ` with context ${JSON.stringify(action.context)}` : "") + ".";
+  return {
+    role: "user",
+    content: [{ text: summary }, a2uiPart([{ action }])]
+  };
+}
+export {
+  A2UI_MIME_TYPE,
+  A2UI_VERSION,
+  BASIC_CATALOG_ID,
+  a2uiEnvelopesFromParts2 as a2uiEnvelopesFromParts,
+  a2uiPart2 as a2uiPart,
+  actionToMessage,
+  isA2uiPart,
+  streamA2uiAgent
+};
+//# sourceMappingURL=client.mjs.map

package/lib/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["/**\n * Copyright 2026 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Browser-safe client helpers for consuming an A2UI-enabled Genkit agent.\n *\n * This module has NO Node dependencies. It builds on Genkit's agent client\n * (`remoteAgent` from `genkit/beta/client`), filters A2UI parts out of the\n * agent stream, and hands whole envelopes to whatever renderer you use (e.g.\n * `@a2ui/web_core`'s `MessageProcessor`).\n *\n * @module\n */\n\nimport { remoteAgent } from 'genkit/beta/client';\nimport { a2uiEnvelopesFromParts, a2uiPart } from './part.mjs';\nimport type { A2uiClientAction, A2uiEnvelope } from './types.mjs';\n\nexport { a2uiEnvelopesFromParts, a2uiPart, isA2uiPart } from './part.mjs';\nexport {\n  A2UI_MIME_TYPE,\n  A2UI_VERSION,\n  BASIC_CATALOG_ID,\n  type A2uiClientAction,\n  type A2uiComponent,\n  type A2uiEnvelope,\n  type A2uiPart,\n} from './types.mjs';\n\n/** A single event yielded while streaming an A2UI agent turn. */\nexport type A2uiStreamEvent =\n  | { type: 'text'; text: string }\n  | { type: 'envelopes'; envelopes: A2uiEnvelope[] };\n\n/** Options for {@link streamA2uiAgent}. */\nexport interface StreamA2uiAgentOptions {\n  /** URL of the Genkit agent/flow endpoint (e.g. `/uiAgent`). */\n  url: string;\n  /** The user message to send (Genkit message data or a plain string). */\n  message: string | Record<string, unknown>;\n  /** Server-managed session id (a UUID). */\n  sessionId?: string;\n  /** Extra HTTP headers. */\n  headers?: Record<string, string>;\n  /** Abort signal to cancel the request. */\n  abortSignal?: AbortSignal;\n}\n\n/** Normalizes a string message into a Genkit user message. */\nfunction toMessage(message: string | Record<string, unknown>) {\n  if (typeof message === 'string') {\n    return { role: 'user', content: [{ text: message }] };\n  }\n  return message;\n}\n\n/**\n * Streams an A2UI-enabled Genkit agent, yielding prose text deltas and complete\n * A2UI envelope batches in the order they arrive. Feed the envelopes to your\n * renderer's message processor.\n *\n * @example\n * ```ts\n * import { MessageProcessor } from '@a2ui/web_core/v0_9';\n * import { basicCatalog } from '@a2ui/lit/v0_9';\n * import { streamA2uiAgent } from '@genkit-ai/a2ui/client';\n *\n * const processor = new MessageProcessor([basicCatalog]);\n * for await (const ev of streamA2uiAgent({ url: '/uiAgent', message: 'weather in Tokyo' })) {\n *   if (ev.type === 'text') appendProse(ev.text);\n *   else processor.processMessages(ev.envelopes);\n * }\n * ```\n */\nexport async function* streamA2uiAgent(\n  options: StreamA2uiAgentOptions\n): AsyncGenerator<A2uiStreamEvent, void, unknown> {\n  const agent = remoteAgent({ url: options.url, headers: options.headers });\n  // A server-managed session id (when provided) attaches this turn to an\n  // existing conversation; otherwise the agent starts a fresh session.\n  const chat = agent.chat(\n    options.sessionId ? { sessionId: options.sessionId } : undefined\n  );\n\n  const turn = chat.sendStream(\n    { message: toMessage(options.message) } as Parameters<\n      typeof chat.sendStream\n    >[0],\n    { abortSignal: options.abortSignal }\n  );\n\n  for await (const chunk of turn.stream) {\n    if (chunk.text) {\n      yield { type: 'text', text: chunk.text };\n    }\n    // A2UI rides as data parts on the raw chunk; extract whole envelopes.\n    const envelopes = a2uiEnvelopesFromParts(chunk.raw.modelChunk?.content);\n    if (envelopes.length > 0) {\n      yield { type: 'envelopes', envelopes };\n    }\n  }\n  // Surface any server error / finalize the turn.\n  await turn.response;\n}\n\n/**\n * Builds the agent input for sending a rendered surface's user action back to\n * the agent as the next turn. The action's `name` becomes the user message so\n * the agent can react to it; the full action object is attached as an a2ui data\n * part for richer handling.\n */\nexport function actionToMessage(action: A2uiClientAction) {\n  if (!action) {\n    throw new Error('actionToMessage: action is required');\n  }\n  const summary =\n    `User interacted with the UI (surface \"${action.surfaceId}\"): ` +\n    `action \"${action.name}\"` +\n    (action.context && Object.keys(action.context).length\n      ? ` with context ${JSON.stringify(action.context)}`\n      : '') +\n    '.';\n  return {\n    role: 'user',\n    content: [{ text: summary }, a2uiPart([{ action }])],\n  };\n}\n"],"mappings":"AA2BA,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB,gBAAgB;AAGjD,SAAS,0BAAAA,yBAAwB,YAAAC,WAAU,kBAAkB;AAC7D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AAsBP,SAAS,UAAU,SAA2C;AAC5D,MAAI,OAAO,YAAY,UAAU;AAC/B,WAAO,EAAE,MAAM,QAAQ,SAAS,CAAC,EAAE,MAAM,QAAQ,CAAC,EAAE;AAAA,EACtD;AACA,SAAO;AACT;AAoBA,gBAAuB,gBACrB,SACgD;AAChD,QAAM,QAAQ,YAAY,EAAE,KAAK,QAAQ,KAAK,SAAS,QAAQ,QAAQ,CAAC;AAGxE,QAAM,OAAO,MAAM;AAAA,IACjB,QAAQ,YAAY,EAAE,WAAW,QAAQ,UAAU,IAAI;AAAA,EACzD;AAEA,QAAM,OAAO,KAAK;AAAA,IAChB,EAAE,SAAS,UAAU,QAAQ,OAAO,EAAE;AAAA,IAGtC,EAAE,aAAa,QAAQ,YAAY;AAAA,EACrC;AAEA,mBAAiB,SAAS,KAAK,QAAQ;AACrC,QAAI,MAAM,MAAM;AACd,YAAM,EAAE,MAAM,QAAQ,MAAM,MAAM,KAAK;AAAA,IACzC;AAEA,UAAM,YAAY,uBAAuB,MAAM,IAAI,YAAY,OAAO;AACtE,QAAI,UAAU,SAAS,GAAG;AACxB,YAAM,EAAE,MAAM,aAAa,UAAU;AAAA,IACvC;AAAA,EACF;AAEA,QAAM,KAAK;AACb;AAQO,SAAS,gBAAgB,QAA0B;AACxD,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,qCAAqC;AAAA,EACvD;AACA,QAAM,UACJ,yCAAyC,OAAO,SAAS,eAC9C,OAAO,IAAI,OACrB,OAAO,WAAW,OAAO,KAAK,OAAO,OAAO,EAAE,SAC3C,iBAAiB,KAAK,UAAU,OAAO,OAAO,CAAC,KAC/C,MACJ;AACF,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS,CAAC,EAAE,MAAM,QAAQ,GAAG,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAAA,EACrD;AACF;","names":["a2uiEnvelopesFromParts","a2uiPart"]}

package/lib/index.d.mts

@@ -0,0 +1,8 @@
+export { A2UI_CATALOG_VALUE_TYPE, A2uiCatalog, A2uiCatalogComponent, DEFAULT_CATALOG_ID, SURFACE_ID_PLACEHOLDER, basicCatalog, renderCatalogInstructions } from './catalog.mjs';
+export { LoadCatalogOptions, loadCatalog } from './loader.mjs';
+export { A2uiOptions, A2uiOptionsSchema, a2ui } from './middleware.mjs';
+export { A2uiParserOptions, A2uiStreamParser, ParseResult } from './parser.mjs';
+export { a2uiEnvelopesFromParts, a2uiPart, isA2uiPart } from './part.mjs';
+export { A2UI_MIME_TYPE, A2UI_VERSION, A2uiClientAction, A2uiComponent, A2uiEnvelope, A2uiPart, BASIC_CATALOG_ID, CreateSurfaceEnvelope, DeleteSurfaceEnvelope, UpdateComponentsEnvelope, UpdateDataModelEnvelope } from './types.mjs';
+import 'genkit/registry';
+import 'genkit';

package/lib/index.d.ts

@@ -0,0 +1,8 @@
+export { A2UI_CATALOG_VALUE_TYPE, A2uiCatalog, A2uiCatalogComponent, DEFAULT_CATALOG_ID, SURFACE_ID_PLACEHOLDER, basicCatalog, renderCatalogInstructions } from './catalog.js';
+export { LoadCatalogOptions, loadCatalog } from './loader.js';
+export { A2uiOptions, A2uiOptionsSchema, a2ui } from './middleware.js';
+export { A2uiParserOptions, A2uiStreamParser, ParseResult } from './parser.js';
+export { a2uiEnvelopesFromParts, a2uiPart, isA2uiPart } from './part.js';
+export { A2UI_MIME_TYPE, A2UI_VERSION, A2uiClientAction, A2uiComponent, A2uiEnvelope, A2uiPart, BASIC_CATALOG_ID, CreateSurfaceEnvelope, DeleteSurfaceEnvelope, UpdateComponentsEnvelope, UpdateDataModelEnvelope } from './types.js';
+import 'genkit/registry';
+import 'genkit';

package/lib/index.js

@@ -0,0 +1,62 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  A2UI_CATALOG_VALUE_TYPE: () => import_catalog.A2UI_CATALOG_VALUE_TYPE,
+  A2UI_MIME_TYPE: () => import_types.A2UI_MIME_TYPE,
+  A2UI_VERSION: () => import_types.A2UI_VERSION,
+  A2uiOptionsSchema: () => import_middleware.A2uiOptionsSchema,
+  A2uiStreamParser: () => import_parser.A2uiStreamParser,
+  BASIC_CATALOG_ID: () => import_types.BASIC_CATALOG_ID,
+  DEFAULT_CATALOG_ID: () => import_catalog.DEFAULT_CATALOG_ID,
+  SURFACE_ID_PLACEHOLDER: () => import_catalog.SURFACE_ID_PLACEHOLDER,
+  a2ui: () => import_middleware.a2ui,
+  a2uiEnvelopesFromParts: () => import_part.a2uiEnvelopesFromParts,
+  a2uiPart: () => import_part.a2uiPart,
+  basicCatalog: () => import_catalog.basicCatalog,
+  isA2uiPart: () => import_part.isA2uiPart,
+  loadCatalog: () => import_loader.loadCatalog,
+  renderCatalogInstructions: () => import_catalog.renderCatalogInstructions
+});
+module.exports = __toCommonJS(index_exports);
+var import_catalog = require("./catalog.js");
+var import_loader = require("./loader.js");
+var import_middleware = require("./middleware.js");
+var import_parser = require("./parser.js");
+var import_part = require("./part.js");
+var import_types = require("./types.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  A2UI_CATALOG_VALUE_TYPE,
+  A2UI_MIME_TYPE,
+  A2UI_VERSION,
+  A2uiOptionsSchema,
+  A2uiStreamParser,
+  BASIC_CATALOG_ID,
+  DEFAULT_CATALOG_ID,
+  SURFACE_ID_PLACEHOLDER,
+  a2ui,
+  a2uiEnvelopesFromParts,
+  a2uiPart,
+  basicCatalog,
+  isA2uiPart,
+  loadCatalog,
+  renderCatalogInstructions
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Copyright 2026 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * `@genkit-ai/a2ui` — A2UI (Agent-to-UI) streaming UI protocol support for\n * Genkit agents.\n *\n * The whole server-side integration is the {@link a2ui} model middleware; add it\n * to `defineAgent({ use: [...] })` or `ai.generate({ use: [...] })`. Pair it with\n * {@link basicCatalog} (or your own catalog) and render on the client with the\n * `@a2ui/lit` renderer plus the helpers in `@genkit-ai/a2ui/client`.\n *\n * @module\n */\n\nexport {\n  A2UI_CATALOG_VALUE_TYPE,\n  DEFAULT_CATALOG_ID,\n  SURFACE_ID_PLACEHOLDER,\n  basicCatalog,\n  renderCatalogInstructions,\n  type A2uiCatalog,\n  type A2uiCatalogComponent,\n} from './catalog.js';\nexport { loadCatalog, type LoadCatalogOptions } from './loader.js';\nexport { A2uiOptionsSchema, a2ui, type A2uiOptions } from './middleware.js';\nexport {\n  A2uiStreamParser,\n  type A2uiParserOptions,\n  type ParseResult,\n} from './parser.js';\nexport { a2uiEnvelopesFromParts, a2uiPart, isA2uiPart } from './part.js';\nexport {\n  A2UI_MIME_TYPE,\n  A2UI_VERSION,\n  BASIC_CATALOG_ID,\n  type A2uiClientAction,\n  type A2uiComponent,\n  type A2uiEnvelope,\n  type A2uiPart,\n  type CreateSurfaceEnvelope,\n  type DeleteSurfaceEnvelope,\n  type UpdateComponentsEnvelope,\n  type UpdateDataModelEnvelope,\n} from './types.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4BA,qBAQO;AACP,oBAAqD;AACrD,wBAA0D;AAC1D,oBAIO;AACP,kBAA6D;AAC7D,mBAYO;","names":[]}

package/lib/index.mjs

@@ -0,0 +1,36 @@
+import {
+  A2UI_CATALOG_VALUE_TYPE,
+  DEFAULT_CATALOG_ID,
+  SURFACE_ID_PLACEHOLDER,
+  basicCatalog,
+  renderCatalogInstructions
+} from "./catalog.mjs";
+import { loadCatalog } from "./loader.mjs";
+import { A2uiOptionsSchema, a2ui } from "./middleware.mjs";
+import {
+  A2uiStreamParser
+} from "./parser.mjs";
+import { a2uiEnvelopesFromParts, a2uiPart, isA2uiPart } from "./part.mjs";
+import {
+  A2UI_MIME_TYPE,
+  A2UI_VERSION,
+  BASIC_CATALOG_ID
+} from "./types.mjs";
+export {
+  A2UI_CATALOG_VALUE_TYPE,
+  A2UI_MIME_TYPE,
+  A2UI_VERSION,
+  A2uiOptionsSchema,
+  A2uiStreamParser,
+  BASIC_CATALOG_ID,
+  DEFAULT_CATALOG_ID,
+  SURFACE_ID_PLACEHOLDER,
+  a2ui,
+  a2uiEnvelopesFromParts,
+  a2uiPart,
+  basicCatalog,
+  isA2uiPart,
+  loadCatalog,
+  renderCatalogInstructions
+};
+//# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Copyright 2026 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * `@genkit-ai/a2ui` — A2UI (Agent-to-UI) streaming UI protocol support for\n * Genkit agents.\n *\n * The whole server-side integration is the {@link a2ui} model middleware; add it\n * to `defineAgent({ use: [...] })` or `ai.generate({ use: [...] })`. Pair it with\n * {@link basicCatalog} (or your own catalog) and render on the client with the\n * `@a2ui/lit` renderer plus the helpers in `@genkit-ai/a2ui/client`.\n *\n * @module\n */\n\nexport {\n  A2UI_CATALOG_VALUE_TYPE,\n  DEFAULT_CATALOG_ID,\n  SURFACE_ID_PLACEHOLDER,\n  basicCatalog,\n  renderCatalogInstructions,\n  type A2uiCatalog,\n  type A2uiCatalogComponent,\n} from './catalog.mjs';\nexport { loadCatalog, type LoadCatalogOptions } from './loader.mjs';\nexport { A2uiOptionsSchema, a2ui, type A2uiOptions } from './middleware.mjs';\nexport {\n  A2uiStreamParser,\n  type A2uiParserOptions,\n  type ParseResult,\n} from './parser.mjs';\nexport { a2uiEnvelopesFromParts, a2uiPart, isA2uiPart } from './part.mjs';\nexport {\n  A2UI_MIME_TYPE,\n  A2UI_VERSION,\n  BASIC_CATALOG_ID,\n  type A2uiClientAction,\n  type A2uiComponent,\n  type A2uiEnvelope,\n  type A2uiPart,\n  type CreateSurfaceEnvelope,\n  type DeleteSurfaceEnvelope,\n  type UpdateComponentsEnvelope,\n  type UpdateDataModelEnvelope,\n} from './types.mjs';\n"],"mappings":"AA4BA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,mBAA4C;AACrD,SAAS,mBAAmB,YAA8B;AAC1D;AAAA,EACE;AAAA,OAGK;AACP,SAAS,wBAAwB,UAAU,kBAAkB;AAC7D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OASK;","names":[]}

package/lib/loader.d.mts

@@ -0,0 +1,70 @@
+import { HasRegistry } from 'genkit/registry';
+import { A2uiCatalog } from './catalog.mjs';
+
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Catalog loading helpers.
+ *
+ * The {@link a2ui} middleware references catalogs by id and looks them up in the
+ * Genkit registry (value type {@link A2UI_CATALOG_VALUE_TYPE}). {@link loadCatalog}
+ * registers a catalog under an id so the middleware — and, in the future, Genkit
+ * tooling — can find it. Provide the catalog inline, or load it from a JSON file.
+ *
+ * This module uses Node's `fs` for the `file` variant, so it is server-only (it
+ * is exported from the main `@genkit-ai/a2ui` entry, not `@genkit-ai/a2ui/client`).
+ *
+ * @module
+ */
+
+/** Options for {@link loadCatalog}. Provide either `catalog` or `file`. */
+type LoadCatalogOptions = {
+    /** The id to register the catalog under (referenced by `a2ui({ catalog })`). */
+    id: string;
+} & ({
+    /** An in-memory catalog to register. */
+    catalog: A2uiCatalog;
+    file?: never;
+} | {
+    /** Path to a JSON file containing a catalog. */
+    file: string;
+    catalog?: never;
+});
+/**
+ * Registers an A2UI catalog under an id so the {@link a2ui} middleware can look
+ * it up (via `a2ui({ catalog: id })`).
+ *
+ * @example
+ * ```ts
+ * // From an in-memory object:
+ * await loadCatalog(ai, { id: 'my-catalog', catalog: myCatalog });
+ *
+ * // From a JSON file:
+ * await loadCatalog(ai, { id: 'my-catalog', file: './my-catalog.json' });
+ * ```
+ *
+ * @returns The registered catalog (with its `id` set to the given id).
+ */
+declare function loadCatalog(ai: HasRegistry, options: LoadCatalogOptions): Promise<A2uiCatalog>;
+/**
+ * Resolves a catalog by id from the registry, falling back to the bundled
+ * {@link basicCatalog} for the default id. Used by the {@link a2ui} middleware.
+ *
+ * @internal
+ */
+declare function resolveCatalog(ai: HasRegistry, id: string): Promise<A2uiCatalog>;
+
+export { type LoadCatalogOptions, loadCatalog, resolveCatalog };

package/lib/loader.d.ts

@@ -0,0 +1,70 @@
+import { HasRegistry } from 'genkit/registry';
+import { A2uiCatalog } from './catalog.js';
+
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Catalog loading helpers.
+ *
+ * The {@link a2ui} middleware references catalogs by id and looks them up in the
+ * Genkit registry (value type {@link A2UI_CATALOG_VALUE_TYPE}). {@link loadCatalog}
+ * registers a catalog under an id so the middleware — and, in the future, Genkit
+ * tooling — can find it. Provide the catalog inline, or load it from a JSON file.
+ *
+ * This module uses Node's `fs` for the `file` variant, so it is server-only (it
+ * is exported from the main `@genkit-ai/a2ui` entry, not `@genkit-ai/a2ui/client`).
+ *
+ * @module
+ */
+
+/** Options for {@link loadCatalog}. Provide either `catalog` or `file`. */
+type LoadCatalogOptions = {
+    /** The id to register the catalog under (referenced by `a2ui({ catalog })`). */
+    id: string;
+} & ({
+    /** An in-memory catalog to register. */
+    catalog: A2uiCatalog;
+    file?: never;
+} | {
+    /** Path to a JSON file containing a catalog. */
+    file: string;
+    catalog?: never;
+});
+/**
+ * Registers an A2UI catalog under an id so the {@link a2ui} middleware can look
+ * it up (via `a2ui({ catalog: id })`).
+ *
+ * @example
+ * ```ts
+ * // From an in-memory object:
+ * await loadCatalog(ai, { id: 'my-catalog', catalog: myCatalog });
+ *
+ * // From a JSON file:
+ * await loadCatalog(ai, { id: 'my-catalog', file: './my-catalog.json' });
+ * ```
+ *
+ * @returns The registered catalog (with its `id` set to the given id).
+ */
+declare function loadCatalog(ai: HasRegistry, options: LoadCatalogOptions): Promise<A2uiCatalog>;
+/**
+ * Resolves a catalog by id from the registry, falling back to the bundled
+ * {@link basicCatalog} for the default id. Used by the {@link a2ui} middleware.
+ *
+ * @internal
+ */
+declare function resolveCatalog(ai: HasRegistry, id: string): Promise<A2uiCatalog>;
+
+export { type LoadCatalogOptions, loadCatalog, resolveCatalog };

package/lib/loader.js

@@ -0,0 +1,92 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var loader_exports = {};
+__export(loader_exports, {
+  loadCatalog: () => loadCatalog,
+  resolveCatalog: () => resolveCatalog
+});
+module.exports = __toCommonJS(loader_exports);
+var import_catalog = require("./catalog.js");
+async function loadCatalog(ai, options) {
+  const { id } = options;
+  if (!id) {
+    throw new Error("loadCatalog(): `id` is required.");
+  }
+  let catalog;
+  if (options.file !== void 0) {
+    catalog = await readCatalogFile(options.file);
+  } else if (options.catalog !== void 0) {
+    catalog = options.catalog;
+  } else {
+    throw new Error("loadCatalog(): provide either `catalog` or `file`.");
+  }
+  if (!catalog || !Array.isArray(catalog.components)) {
+    throw new Error(
+      `loadCatalog(): catalog "${id}" must have a "components" array.`
+    );
+  }
+  const registered = { ...catalog, id: catalog.id || id };
+  ai.registry.registerValue(import_catalog.A2UI_CATALOG_VALUE_TYPE, id, registered);
+  return registered;
+}
+async function readCatalogFile(file) {
+  const { readFile } = await import("node:fs/promises");
+  let raw;
+  try {
+    raw = await readFile(file, "utf8");
+  } catch (e) {
+    throw new Error(
+      `loadCatalog(): failed to read catalog file "${file}": ${e.message}`
+    );
+  }
+  try {
+    return JSON.parse(raw);
+  } catch (e) {
+    throw new Error(
+      `loadCatalog(): catalog file "${file}" is not valid JSON: ${e.message}`
+    );
+  }
+}
+async function resolveCatalog(ai, id) {
+  const found = await ai.registry.lookupValue(
+    import_catalog.A2UI_CATALOG_VALUE_TYPE,
+    id
+  );
+  if (found) return found;
+  if (id === import_catalog.DEFAULT_CATALOG_ID) return import_catalog.basicCatalog;
+  throw new Error(
+    `a2ui(): no catalog registered under id "${id}". Register one with loadCatalog(ai, { id: "${id}", catalog }) or use the default "${import_catalog.DEFAULT_CATALOG_ID}" catalog.`
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadCatalog,
+  resolveCatalog
+});
+//# sourceMappingURL=loader.js.map