@openuidev/a2ui 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2011-2024 Thesys Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# `@openuidev/a2ui`
+
+An experimental A2UI v1.0 profile that keeps the protocol lifecycle and envelopes intact while representing component lists as OpenUI Lang statements.
+
+```json
+{
+  "version": "v1.0",
+  "updateComponents": {
+    "surfaceId": "main",
+    "components": ["root = Stack([title])", "title = TextContent(\"Hello\")"]
+  }
+}
+```
+
+`updateDataModel`, `deleteSurface`, actions, `callRendererFunction`, `agentFunctionResponse`, `callAgentFunction`, `rendererFunctionResponse`, errors, capabilities, and renderer data-model metadata retain their A2UI v1.0 shapes. For v1.0 single-message creation, optional `createSurface.components` uses the same Lang statement array as `updateComponents.components`, so there is exactly one component representation on the wire.
+
+Incoming protocol messages are validated with the exported Zod schemas in the package. The public TypeScript message types are inferred from the same definitions, so runtime validation and static types stay aligned.
+
+## Installation
+
+Install the framework-neutral protocol client with its runtime schema peer:
+
+```bash
+npm install @openuidev/a2ui zod
+```
+
+The React adapter is optional. Install its peers only when importing `@openuidev/a2ui/react`:
+
+```bash
+npm install react @openuidev/react-lang
+```
+
+## How updates work
+
+Each array item is one complete OpenUI Lang statement (a multiline statement block is also accepted). Repeated messages are merged by statement ID and the resulting source is parsed by `@openuidev/lang-core`. A newer assignment replaces the previous statement, and `statementId = null` deletes it. The `root` statement remains the surface root.
+
+## Usage
+
+```tsx
+import { createA2UIClient } from "@openuidev/a2ui";
+import { A2UIRenderer } from "@openuidev/a2ui/react";
+import { openuiLibrary } from "@openuidev/react-ui";
+
+const client = createA2UIClient({
+  schema: openuiLibrary.toJSONSchema(),
+  rootName: openuiLibrary.root,
+  rendererCapabilities: {
+    "v1.0": { supportedCatalogIds: ["com.example:openui"] },
+  },
+  onMessage(message, metadata) {
+    transport.send(message, metadata);
+  },
+});
+
+await client.process({
+  version: "v1.0",
+  createSurface: {
+    surfaceId: "main",
+    catalogId: "com.example:openui",
+    dataModel: { user: { name: "Alice" } },
+  },
+});
+
+await client.process({
+  version: "v1.0",
+  updateComponents: {
+    surfaceId: "main",
+    components: ["root = Stack([greeting])", 'greeting = TextContent("Hello, " + $user.name)'],
+  },
+});
+
+export function Surface() {
+  return (
+    <A2UIRenderer
+      client={client}
+      surfaceId="main"
+      library={openuiLibrary}
+      isStreaming={transport.isStreaming}
+      mapAction={(event) => ({ name: event.type })}
+    />
+  );
+}
+```
+
+The client is framework-neutral: it owns surface lifecycle, runtime envelope validation, Lang parsing and merging, data-model patches, actions, RPC, and protocol errors. `A2UIRenderer` is the React adapter; it subscribes to one surface and delegates the parsed OpenUI Lang UI to `@openuidev/react-lang`.
+
+When `sendDataModel` is enabled, the second `onMessage` argument contains `a2uiRendererDataModel` metadata filtered to opted-in surfaces. Configured renderer capabilities are exposed in the same metadata object. The host transport decides where to attach this metadata.
+
+Renderer functions can be registered as a direct function shorthand or as `{ handler, catalogId, allowedCallers }`. Explicit registrations default to `rendererOnly`; incoming `callRendererFunction` messages are accepted only when the catalog ID matches and `allowedCallers` is `agentOnly` or `rendererOrAgent`.
+
+When no `toolProvider` is passed to `A2UIRenderer`, OpenUI Lang `Query()` and `Mutation()` calls automatically use A2UI `callAgentFunction` and settle from the matching `agentFunctionResponse`. Pass a `toolProvider` to handle those calls locally instead.
+
+Use `mapAction` to provide `sourceComponentId` when the host renderer does not include one in its action event. Otherwise actions fall back to the surface `root` ID.
+
+## Development
+
+The `check:attw` script intentionally ignores the `no-resolution` rule. `./react` is exported through modern package `exports`; `attw` reports `no-resolution` only for legacy Node 10 resolution, which this package does not support.

package/dist/client-D0JsJgUP.d.cts

@@ -0,0 +1,399 @@
+import { ActionEvent, LibraryJSONSchema, OpenUIError, ParseResult } from "@openuidev/lang-core";
+import { z } from "zod/v4";
+
+//#region src/protocol-schema.d.ts
+declare const jsonValueSchema: z.ZodJSONSchema;
+declare const jsonObjectSchema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+declare const messageMetadataSchema: z.ZodObject<{
+  extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+}, z.core.$strict>;
+declare const a2uiFunctionCallSchema: z.ZodObject<{
+  call: z.ZodString;
+  catalogId: z.ZodOptional<z.ZodString>;
+  args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+}, z.core.$strict>;
+declare const a2uiFunctionResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+  functionCallId: z.ZodString;
+  value: z.ZodJSONSchema;
+}, z.core.$strict>, z.ZodObject<{
+  functionCallId: z.ZodString;
+  error: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+  }, z.core.$strict>;
+}, z.core.$strict>]>;
+declare const createSurfaceMessageSchema: z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  createSurface: z.ZodObject<{
+    surfaceId: z.ZodString;
+    catalogId: z.ZodOptional<z.ZodString>;
+    sendDataModel: z.ZodOptional<z.ZodBoolean>;
+    components: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dataModel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+      extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>;
+}, z.core.$strict>;
+declare const updateComponentsMessageSchema: z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  updateComponents: z.ZodObject<{
+    surfaceId: z.ZodString;
+    components: z.ZodArray<z.ZodString>;
+  }, z.core.$strict>;
+}, z.core.$strict>;
+declare const updateDataModelMessageSchema: z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  updateDataModel: z.ZodObject<{
+    surfaceId: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    value: z.ZodJSONSchema;
+  }, z.core.$strict>;
+}, z.core.$strict>;
+declare const deleteSurfaceMessageSchema: z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  deleteSurface: z.ZodObject<{
+    surfaceId: z.ZodString;
+  }, z.core.$strict>;
+}, z.core.$strict>;
+declare const callRendererFunctionMessageSchema: z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  callRendererFunction: z.ZodObject<{
+    functionCallId: z.ZodString;
+    callFunction: z.ZodObject<{
+      call: z.ZodString;
+      args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      catalogId: z.ZodString;
+    }, z.core.$strict>;
+  }, z.core.$strict>;
+}, z.core.$strict>;
+declare const agentFunctionResponseMessageSchema: z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  agentFunctionResponse: z.ZodUnion<readonly [z.ZodObject<{
+    functionCallId: z.ZodString;
+    value: z.ZodJSONSchema;
+  }, z.core.$strict>, z.ZodObject<{
+    functionCallId: z.ZodString;
+    error: z.ZodObject<{
+      code: z.ZodString;
+      message: z.ZodString;
+    }, z.core.$strict>;
+  }, z.core.$strict>]>;
+}, z.core.$strict>;
+declare const agentToRendererMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  createSurface: z.ZodObject<{
+    surfaceId: z.ZodString;
+    catalogId: z.ZodOptional<z.ZodString>;
+    sendDataModel: z.ZodOptional<z.ZodBoolean>;
+    components: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dataModel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+      extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  updateComponents: z.ZodObject<{
+    surfaceId: z.ZodString;
+    components: z.ZodArray<z.ZodString>;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  updateDataModel: z.ZodObject<{
+    surfaceId: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    value: z.ZodJSONSchema;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  deleteSurface: z.ZodObject<{
+    surfaceId: z.ZodString;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  callRendererFunction: z.ZodObject<{
+    functionCallId: z.ZodString;
+    callFunction: z.ZodObject<{
+      call: z.ZodString;
+      args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      catalogId: z.ZodString;
+    }, z.core.$strict>;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  agentFunctionResponse: z.ZodUnion<readonly [z.ZodObject<{
+    functionCallId: z.ZodString;
+    value: z.ZodJSONSchema;
+  }, z.core.$strict>, z.ZodObject<{
+    functionCallId: z.ZodString;
+    error: z.ZodObject<{
+      code: z.ZodString;
+      message: z.ZodString;
+    }, z.core.$strict>;
+  }, z.core.$strict>]>;
+}, z.core.$strict>]>;
+declare const actionMessageSchema: z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  action: z.ZodObject<{
+    name: z.ZodString;
+    userMessage: z.ZodOptional<z.ZodString>;
+    surfaceId: z.ZodString;
+    sourceComponentId: z.ZodString;
+    timestamp: z.ZodISODateTime;
+    context: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    metadata: z.ZodOptional<z.ZodObject<{
+      extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>;
+}, z.core.$strict>;
+declare const callAgentFunctionMessageSchema: z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  callAgentFunction: z.ZodObject<{
+    surfaceId: z.ZodString;
+    functionCallId: z.ZodString;
+    callFunction: z.ZodObject<{
+      call: z.ZodString;
+      catalogId: z.ZodOptional<z.ZodString>;
+      args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$strict>;
+  }, z.core.$strict>;
+}, z.core.$strict>;
+declare const rendererFunctionResponseMessageSchema: z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  rendererFunctionResponse: z.ZodUnion<readonly [z.ZodObject<{
+    functionCallId: z.ZodString;
+    value: z.ZodJSONSchema;
+  }, z.core.$strict>, z.ZodObject<{
+    functionCallId: z.ZodString;
+    error: z.ZodObject<{
+      code: z.ZodString;
+      message: z.ZodString;
+    }, z.core.$strict>;
+  }, z.core.$strict>]>;
+}, z.core.$strict>;
+declare const validationFailedErrorMessageSchema: z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  error: z.ZodObject<{
+    code: z.ZodEnum<{
+      VALIDATION_FAILED: "VALIDATION_FAILED";
+      UNALLOWED_PARENT: "UNALLOWED_PARENT";
+      UNALLOWED_CHILD: "UNALLOWED_CHILD";
+    }>;
+    surfaceId: z.ZodString;
+    path: z.ZodString;
+    message: z.ZodString;
+  }, z.core.$strict>;
+}, z.core.$strict>;
+declare const genericErrorMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  error: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    surfaceId: z.ZodString;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  error: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    functionCallId: z.ZodString;
+  }, z.core.$strict>;
+}, z.core.$strict>]>;
+declare const rendererToAgentMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  action: z.ZodObject<{
+    name: z.ZodString;
+    userMessage: z.ZodOptional<z.ZodString>;
+    surfaceId: z.ZodString;
+    sourceComponentId: z.ZodString;
+    timestamp: z.ZodISODateTime;
+    context: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    metadata: z.ZodOptional<z.ZodObject<{
+      extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  callAgentFunction: z.ZodObject<{
+    surfaceId: z.ZodString;
+    functionCallId: z.ZodString;
+    callFunction: z.ZodObject<{
+      call: z.ZodString;
+      catalogId: z.ZodOptional<z.ZodString>;
+      args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$strict>;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  rendererFunctionResponse: z.ZodUnion<readonly [z.ZodObject<{
+    functionCallId: z.ZodString;
+    value: z.ZodJSONSchema;
+  }, z.core.$strict>, z.ZodObject<{
+    functionCallId: z.ZodString;
+    error: z.ZodObject<{
+      code: z.ZodString;
+      message: z.ZodString;
+    }, z.core.$strict>;
+  }, z.core.$strict>]>;
+}, z.core.$strict>, z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  error: z.ZodObject<{
+    code: z.ZodEnum<{
+      VALIDATION_FAILED: "VALIDATION_FAILED";
+      UNALLOWED_PARENT: "UNALLOWED_PARENT";
+      UNALLOWED_CHILD: "UNALLOWED_CHILD";
+    }>;
+    surfaceId: z.ZodString;
+    path: z.ZodString;
+    message: z.ZodString;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  error: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    surfaceId: z.ZodString;
+  }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  error: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    functionCallId: z.ZodString;
+  }, z.core.$strict>;
+}, z.core.$strict>]>]>;
+declare const rendererCapabilitiesSchema: z.ZodObject<{
+  "v1.0": z.ZodObject<{
+    supportedCatalogIds: z.ZodArray<z.ZodString>;
+    inlineCatalogs: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+  }, z.core.$strict>;
+}, z.core.$strict>;
+declare const agentCapabilitiesSchema: z.ZodObject<{
+  "v1.0": z.ZodObject<{
+    supportedCatalogIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    acceptsInlineCatalogs: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>;
+}, z.core.$strict>;
+declare const rendererDataModelSchema: z.ZodObject<{
+  version: z.ZodLiteral<"v1.0">;
+  surfaces: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+}, z.core.$strict>;
+//#endregion
+//#region src/types.d.ts
+type JsonValue = z.infer<typeof jsonValueSchema>;
+type JsonPrimitive = Extract<JsonValue, string | number | boolean | null>;
+type JsonObject = z.infer<typeof jsonObjectSchema>;
+type A2UIFunctionCall = z.infer<typeof a2uiFunctionCallSchema>;
+type A2UIFunctionResponse = z.infer<typeof a2uiFunctionResponseSchema>;
+type A2UIMessageMetadata = z.infer<typeof messageMetadataSchema>;
+type CreateSurfaceMessage = z.infer<typeof createSurfaceMessageSchema>;
+type UpdateComponentsMessage = z.infer<typeof updateComponentsMessageSchema>;
+type UpdateDataModelMessage = z.infer<typeof updateDataModelMessageSchema>;
+type DeleteSurfaceMessage = z.infer<typeof deleteSurfaceMessageSchema>;
+type CallRendererFunctionMessage = z.infer<typeof callRendererFunctionMessageSchema>;
+type AgentFunctionResponseMessage = z.infer<typeof agentFunctionResponseMessageSchema>;
+type AgentToRendererMessage = z.infer<typeof agentToRendererMessageSchema>;
+type ActionMessage = z.infer<typeof actionMessageSchema>;
+type CallAgentFunctionMessage = z.infer<typeof callAgentFunctionMessageSchema>;
+type RendererFunctionResponseMessage = z.infer<typeof rendererFunctionResponseMessageSchema>;
+type ValidationFailedErrorMessage = z.infer<typeof validationFailedErrorMessageSchema>;
+type GenericErrorMessage = z.infer<typeof genericErrorMessageSchema>;
+type RendererToAgentMessage = z.infer<typeof rendererToAgentMessageSchema>;
+type RendererCapabilities = z.infer<typeof rendererCapabilitiesSchema>;
+type AgentCapabilities = z.infer<typeof agentCapabilitiesSchema>;
+type RendererDataModel = z.infer<typeof rendererDataModelSchema>;
+interface SurfaceSnapshot {
+  surfaceId: string;
+  catalogId?: string;
+  metadata?: A2UIMessageMetadata;
+  sendDataModel: boolean;
+  source: string;
+  dataModel: JsonObject;
+  parseResult: ParseResult | null;
+  errors: OpenUIError[];
+  revision: number;
+}
+type A2UIRendererFunction = (args: JsonObject) => JsonValue | Promise<JsonValue>;
+type A2UIFunctionAllowedCaller = "rendererOnly" | "agentOnly" | "rendererOrAgent";
+interface A2UIRendererFunctionRegistration {
+  handler: A2UIRendererFunction;
+  /** Catalog that defines this function. Required when the agent may call it. */
+  catalogId?: string;
+  /** Matches A2UI catalog allowedCallers semantics. Defaults to rendererOnly. */
+  allowedCallers?: A2UIFunctionAllowedCaller;
+}
+interface A2UIClientOptions {
+  schema: LibraryJSONSchema;
+  rootName?: string;
+  functions?: Record<string, A2UIRendererFunction | A2UIRendererFunctionRegistration>;
+  rendererCapabilities?: RendererCapabilities;
+  onMessage?: (message: RendererToAgentMessage, metadata: RendererMetadata) => void;
+  now?: () => Date;
+  createId?: () => string;
+}
+interface ProtocolValidationIssue {
+  path: string;
+  message: string;
+}
+interface ProcessResult {
+  ok: boolean;
+  outbound: RendererToAgentMessage[];
+  /** Present when malformed input cannot be represented as an A2UI error envelope. */
+  issues?: ProtocolValidationIssue[];
+}
+interface DispatchActionInput {
+  surfaceId: string;
+  sourceComponentId: string;
+  name: string;
+  userMessage?: string;
+  context?: JsonObject;
+  metadata?: A2UIMessageMetadata;
+}
+interface CallAgentFunctionInput {
+  surfaceId: string;
+  call: string;
+  catalogId?: string;
+  args?: JsonObject;
+}
+interface OpenUIActionOptions {
+  name?: string;
+  /** A2UI component ID to report for the action. Defaults to root. */
+  sourceComponentId?: string;
+  userMessage?: string;
+  context?: JsonObject;
+  metadata?: A2UIMessageMetadata;
+}
+type MapOpenUIAction = (event: ActionEvent, surface: SurfaceSnapshot) => OpenUIActionOptions;
+interface RendererMetadata {
+  a2uiRendererCapabilities?: RendererCapabilities;
+  a2uiRendererDataModel?: RendererDataModel;
+}
+//#endregion
+//#region src/client.d.ts
+type SurfaceListener = () => void;
+type MessageListener = (message: RendererToAgentMessage, metadata: RendererMetadata) => void;
+declare class A2UIFunctionError extends Error {
+  readonly code: string;
+  constructor(code: string, message: string);
+}
+declare class A2UIClient {
+  #private;
+  constructor(options: A2UIClientOptions);
+  subscribe(listener: SurfaceListener): () => void;
+  subscribeMessages(listener: MessageListener): () => void;
+  getSurface(surfaceId: string): SurfaceSnapshot | undefined;
+  getSurfaces(): SurfaceSnapshot[];
+  getRendererDataModel(): RendererDataModel | undefined;
+  getRendererMetadata(): RendererMetadata;
+  process(input: unknown): Promise<ProcessResult>;
+  updateSurfaceFromOpenUIState(surfaceId: string, state: Record<string, unknown>): boolean;
+  dispatchOpenUIAction(surfaceId: string, event: ActionEvent, options?: OpenUIActionOptions): void;
+  dispatchAction(input: DispatchActionInput): void;
+  callAgentFunction(input: CallAgentFunctionInput): Promise<JsonValue>;
+  dispose(): void;
+}
+declare function createA2UIClient(options: A2UIClientOptions): A2UIClient;
+//#endregion
+export { rendererDataModelSchema as $, RendererDataModel as A, actionMessageSchema as B, JsonPrimitive as C, ProcessResult as D, OpenUIActionOptions as E, UpdateComponentsMessage as F, callRendererFunctionMessageSchema as G, agentFunctionResponseMessageSchema as H, UpdateDataModelMessage as I, genericErrorMessageSchema as J, createSurfaceMessageSchema as K, ValidationFailedErrorMessage as L, RendererMetadata as M, RendererToAgentMessage as N, ProtocolValidationIssue as O, SurfaceSnapshot as P, rendererCapabilitiesSchema as Q, a2uiFunctionCallSchema as R, JsonObject as S, MapOpenUIAction as T, agentToRendererMessageSchema as U, agentCapabilitiesSchema as V, callAgentFunctionMessageSchema as W, jsonValueSchema as X, jsonObjectSchema as Y, messageMetadataSchema as Z, CallRendererFunctionMessage as _, A2UIFunctionAllowedCaller as a, DispatchActionInput as b, A2UIMessageMetadata as c, ActionMessage as d, rendererFunctionResponseMessageSchema as et, AgentCapabilities as f, CallAgentFunctionMessage as g, CallAgentFunctionInput as h, A2UIClientOptions as i, validationFailedErrorMessageSchema as it, RendererFunctionResponseMessage as j, RendererCapabilities as k, A2UIRendererFunction as l, AgentToRendererMessage as m, A2UIFunctionError as n, updateComponentsMessageSchema as nt, A2UIFunctionCall as o, AgentFunctionResponseMessage as p, deleteSurfaceMessageSchema as q, createA2UIClient as r, updateDataModelMessageSchema as rt, A2UIFunctionResponse as s, A2UIClient as t, rendererToAgentMessageSchema as tt, A2UIRendererFunctionRegistration as u, CreateSurfaceMessage as v, JsonValue as w, GenericErrorMessage as x, DeleteSurfaceMessage as y, a2uiFunctionResponseSchema as z };
+//# sourceMappingURL=client-D0JsJgUP.d.cts.map

package/dist/client-D0JsJgUP.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-D0JsJgUP.d.cts","names":[],"sources":["../src/protocol-schema.ts","../src/types.ts","../src/client.ts"],"mappings":"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"}