@nonoun/native-ai 1.0.21 → 1.0.23

package/dist/a2ui/protocol/a2ui-surface.d.ts

@@ -0,0 +1,34 @@
+/**
+ * A2UI Surface Manager
+ *
+ * Manages A2UI surface lifecycle: create → updateComponents → updateDataModel → delete.
+ * Each surface maps to one UIPlan in the kernel.
+ */
+import type { ReadonlySignal } from '@nonoun/native-ui';
+import type { A2UIServerMessage, A2UIActionMessage, A2UIComponent } from './a2ui-types.ts';
+import type { ComponentRegistry } from './a2ui-component-map.ts';
+import type { A2UIKernelBridge as Kernel } from './kernel-bridge.ts';
+import type { PatchOp } from './kernel-bridge.ts';
+export interface SurfaceState {
+    readonly surfaceId: string;
+    readonly planId: string;
+    readonly catalogId?: string;
+    readonly theme?: Readonly<Record<string, string>>;
+    readonly container: HTMLElement;
+    readonly rendered: boolean;
+}
+export declare function resolveJsonPointer(data: unknown, pointer: string): unknown;
+export declare function setJsonPointer(data: Record<string, unknown>, pointer: string, value: unknown): void;
+export declare class SurfaceManager {
+    #private;
+    readonly surfaceCount: ReadonlySignal<number>;
+    constructor(kernel: Kernel, onAction: (msg: A2UIActionMessage) => void, onRender?: (surfaceId: string, container: HTMLElement) => void, registry?: ComponentRegistry);
+    handleMessage(msg: A2UIServerMessage, container?: HTMLElement): void;
+    getSurface(surfaceId: string): SurfaceState | null;
+    getSurfaceIds(): readonly string[];
+    getDataModel(surfaceId: string): Record<string, unknown> | null;
+    destroy(): void;
+}
+export declare function diffComponents(oldComponents: readonly A2UIComponent[], newComponents: readonly A2UIComponent[], surfaceId: string, registry?: ComponentRegistry): readonly PatchOp[];
+export declare function createSurfaceManager(kernel: Kernel, onAction: (msg: A2UIActionMessage) => void, registry?: ComponentRegistry): SurfaceManager;
+//# sourceMappingURL=a2ui-surface.d.ts.map

package/dist/a2ui/protocol/a2ui-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2ui-surface.d.ts","sourceRoot":"","sources":["../../../src/a2ui/protocol/a2ui-surface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAU,cAAc,EAAW,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EAKd,MAAM,iBAAiB,CAAC;AASzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAkBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAS1E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAiBnG;AAQD,qBAAa,cAAc;;IAQzB,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,MAAM,CAAC,CAA4C;gBAGvF,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,EAC1C,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,KAAK,IAAI,EAC9D,QAAQ,CAAC,EAAE,iBAAiB;IAU9B,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,IAAI;IAmPpE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAalD,aAAa,IAAI,SAAS,MAAM,EAAE;IAIlC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/D,OAAO,IAAI,IAAI;CAKhB;AAkCD,wBAAgB,cAAc,CAC5B,aAAa,EAAE,SAAS,aAAa,EAAE,EACvC,aAAa,EAAE,SAAS,aAAa,EAAE,EACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,SAAS,OAAO,EAAE,CA6FpB;AA+BD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,EAC1C,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,cAAc,CAEhB"}

package/dist/a2ui/protocol/a2ui-transport.d.ts

@@ -0,0 +1,80 @@
+/**
+ * A2UI Transport
+ *
+ * WebSocket and SSE (Server-Sent Events) transport layers for the A2UI protocol.
+ * Connects a remote A2UI server to the local A2UIAdapter, forwarding inbound
+ * messages to receive() and outbound client messages back to the server.
+ */
+import type { A2UIAdapter } from './a2ui-adapter.ts';
+import type { A2UIClientMessage, A2UIServerMessage } from './a2ui-types.ts';
+export type TransportState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'closed';
+export interface TransportEvents {
+    readonly onStateChange?: (state: TransportState) => void;
+    readonly onError?: (error: Error) => void;
+    readonly onMessage?: (msg: A2UIServerMessage) => void;
+}
+export interface WebSocketTransportOptions extends TransportEvents {
+    /** Render container for received surfaces. */
+    readonly container?: HTMLElement;
+    /** Auto-reconnect on disconnect (default: true). */
+    readonly reconnect?: boolean;
+    /** Max reconnect attempts (default: 5). */
+    readonly maxReconnects?: number;
+    /** Base reconnect delay in ms (default: 1000). Doubles each attempt. */
+    readonly reconnectDelay?: number;
+    /** Protocols to pass to WebSocket constructor. */
+    readonly protocols?: string | string[];
+}
+export declare class WebSocketTransport {
+    #private;
+    constructor(adapter: A2UIAdapter, url: string, options?: WebSocketTransportOptions);
+    get state(): TransportState;
+    /**
+     * Open the WebSocket connection.
+     * Messages are forwarded to adapter.receive() as they arrive.
+     */
+    connect(): void;
+    /**
+     * Send a client message (action, error) to the server.
+     */
+    send(msg: A2UIClientMessage): void;
+    /**
+     * Close the connection. No reconnection will be attempted.
+     */
+    close(): void;
+}
+export interface SSETransportOptions extends TransportEvents {
+    /** Render container for received surfaces. */
+    readonly container?: HTMLElement;
+    /** EventSource init options (e.g., withCredentials). */
+    readonly eventSourceInit?: EventSourceInit;
+    /** SSE event name to listen for (default: 'message'). */
+    readonly eventName?: string;
+    /**
+     * URL to POST client messages to (actions, errors).
+     * If not provided, send() will throw.
+     */
+    readonly postUrl?: string;
+}
+export declare class SSETransport {
+    #private;
+    constructor(adapter: A2UIAdapter, url: string, options?: SSETransportOptions);
+    get state(): TransportState;
+    /**
+     * Open the SSE connection.
+     * Messages are forwarded to adapter.receive() as they arrive.
+     */
+    connect(): void;
+    /**
+     * Send a client message to the server via POST.
+     * Requires postUrl to be set in options.
+     */
+    send(msg: A2UIClientMessage): Promise<void>;
+    /**
+     * Close the SSE connection.
+     */
+    close(): void;
+}
+export declare function createWebSocketTransport(adapter: A2UIAdapter, url: string, options?: WebSocketTransportOptions): WebSocketTransport;
+export declare function createSSETransport(adapter: A2UIAdapter, url: string, options?: SSETransportOptions): SSETransport;
+//# sourceMappingURL=a2ui-transport.d.ts.map

package/dist/a2ui/protocol/a2ui-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2ui-transport.d.ts","sourceRoot":"","sources":["../../../src/a2ui/protocol/a2ui-transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAI5E,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,CAAC;AAErG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACvD;AAID,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC;IACjC,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACxC;AAED,qBAAa,kBAAkB;;gBASjB,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAMlF,IAAI,KAAK,IAAI,cAAc,CAAwB;IAEnD;;;OAGG;IACH,OAAO,IAAI,IAAI;IAuCf;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAQlC;;OAEG;IACH,KAAK,IAAI,IAAI;CA+Bd;AAID,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC;IACjC,wDAAwD;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,YAAY;;gBAOX,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAM5E,IAAI,KAAK,IAAI,cAAc,CAAwB;IAEnD;;;OAGG;IACH,OAAO,IAAI,IAAI;IAuCf;;;OAGG;IACG,IAAI,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD;;OAEG;IACH,KAAK,IAAI,IAAI;CAWd;AAID,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,yBAAyB,GAClC,kBAAkB,CAEpB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAEd"}

package/dist/a2ui/protocol/a2ui-types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * A2UI Protocol — Wire Format Types
+ *
+ * Type definitions for Google's A2UI (Agent-to-UI) protocol.
+ * Supports both v0.8 and v0.9 message formats.
+ * No runtime code except type guard functions.
+ */
+export type A2UIProtocolVersion = '0.8' | '0.9';
+export type A2UIServerMessage = A2UICreateSurface | A2UIUpdateComponents | A2UIUpdateDataModel | A2UIDeleteSurface | A2UICatalogRequest;
+export interface A2UICreateSurface {
+    readonly createSurface: {
+        readonly surfaceId: string;
+        readonly catalogId?: string;
+        readonly theme?: Readonly<Record<string, string>>;
+    };
+}
+export interface A2UIUpdateComponents {
+    readonly updateComponents: {
+        readonly surfaceId: string;
+        readonly components: readonly A2UIComponent[];
+    };
+}
+export interface A2UIUpdateDataModel {
+    readonly updateDataModel: {
+        readonly surfaceId: string;
+        readonly path?: string;
+        readonly value?: unknown;
+    };
+}
+export interface A2UIDeleteSurface {
+    readonly deleteSurface: {
+        readonly surfaceId: string;
+    };
+}
+export interface A2UICatalogRequest {
+    readonly requestCatalog: {
+        readonly surfaceId?: string;
+    };
+}
+export interface A2UICatalogResponse {
+    readonly catalog: {
+        readonly surfaceId?: string;
+        readonly supportedTypes: readonly string[];
+        readonly version: string;
+    };
+}
+export type A2UIClientMessage = A2UIActionMessage | A2UIErrorMessage | A2UICatalogResponse;
+export interface A2UIActionMessage {
+    readonly action: {
+        readonly surfaceId: string;
+        readonly sourceComponentId: string;
+        readonly name: string;
+        readonly timestamp: string;
+        readonly context?: Readonly<Record<string, unknown>>;
+    };
+}
+export interface A2UIErrorMessage {
+    readonly error: {
+        readonly surfaceId: string;
+        readonly code: string;
+        readonly message: string;
+    };
+}
+export interface A2UIComponent {
+    readonly id: string;
+    readonly component: string;
+    readonly children?: readonly string[];
+    readonly child?: string;
+    readonly text?: string;
+    readonly label?: string;
+    readonly variant?: string;
+    readonly disabled?: boolean;
+    readonly action?: A2UIComponentAction;
+    readonly accessibility?: {
+        readonly label?: string;
+        readonly description?: string;
+    };
+    readonly [key: string]: unknown;
+}
+export interface A2UIComponentAction {
+    readonly event: {
+        readonly name: string;
+        readonly context?: Readonly<Record<string, unknown>>;
+    };
+}
+export interface A2UIDataBinding {
+    readonly path: string;
+}
+export type A2UIStandardType = 'Text' | 'Button' | 'TextField' | 'TextArea' | 'CheckBox' | 'Switch' | 'ChoicePicker' | 'Slider' | 'DateTimeInput' | 'Row' | 'Column' | 'Card' | 'Modal' | 'Tabs' | 'List' | 'ListItem' | 'Image' | 'Icon' | 'Divider' | 'Badge' | 'Avatar' | 'Select' | 'Video' | 'AudioPlayer';
+export declare function isDataBinding(value: unknown): value is A2UIDataBinding;
+export declare function isCreateSurface(msg: A2UIServerMessage): msg is A2UICreateSurface;
+export declare function isUpdateComponents(msg: A2UIServerMessage): msg is A2UIUpdateComponents;
+export declare function isUpdateDataModel(msg: A2UIServerMessage): msg is A2UIUpdateDataModel;
+export declare function isDeleteSurface(msg: A2UIServerMessage): msg is A2UIDeleteSurface;
+export declare function isCatalogRequest(msg: A2UIServerMessage): msg is A2UICatalogRequest;
+export declare function isActionMessage(msg: A2UIClientMessage): msg is A2UIActionMessage;
+export declare function isErrorMessage(msg: A2UIClientMessage): msg is A2UIErrorMessage;
+export declare function isCatalogResponse(msg: A2UIClientMessage): msg is A2UICatalogResponse;
+/**
+ * Parse a raw JSON string into a typed A2UI server message.
+ * Returns null if the JSON is not a valid A2UI message.
+ */
+export declare function parseServerMessage(json: string): A2UIServerMessage | null;
+//# sourceMappingURL=a2ui-types.d.ts.map

package/dist/a2ui/protocol/a2ui-types.d.ts.map

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

package/dist/a2ui/protocol/index.d.ts

@@ -0,0 +1,15 @@
+export { A2UIAdapter, createA2UIAdapter } from './a2ui-adapter.ts';
+export type { A2UIAdapterOptions } from './a2ui-adapter.ts';
+export { SurfaceManager, createSurfaceManager, resolveJsonPointer, setJsonPointer } from './a2ui-surface.ts';
+export type { SurfaceState } from './a2ui-surface.ts';
+export { a2uiToUINode, uiNodeToA2UI, conversionToPlan } from './a2ui-converter.ts';
+export type { ConversionResult, DataBindingEntry, ToUINodeOptions, ToA2UIOptions } from './a2ui-converter.ts';
+export { ComponentRegistry, defaultRegistry, resolveNativeTag, resolveA2UIType, COMPONENT_MAP, getSupportedTypes, getComponentCategory, getCompatibleTypes, textVariantTag, textFieldInputType, dateTimeInputType } from './a2ui-component-map.ts';
+export type { ComponentMapping, ChildStrategy, RegistrySnapshot, EventSpec, PropertySpec, MethodSpec } from './a2ui-component-map.ts';
+export { CompositionRegistry, defaultCompositionRegistry, COMPOSITION_MAP, resolveComponent } from './a2ui-composition-map.ts';
+export type { CompositionSpec, CompositionTemplate, TemplateNode, PropDelegation, StateProjection, EventBubble, CompositionGap } from './a2ui-composition-map.ts';
+export { isDataBinding, isCreateSurface, isUpdateComponents, isUpdateDataModel, isDeleteSurface, isCatalogRequest, isCatalogResponse, isActionMessage, isErrorMessage, parseServerMessage, } from './a2ui-types.ts';
+export type { A2UIProtocolVersion, A2UIServerMessage, A2UICreateSurface, A2UIUpdateComponents, A2UIUpdateDataModel, A2UIDeleteSurface, A2UICatalogRequest, A2UICatalogResponse, A2UIClientMessage, A2UIActionMessage, A2UIErrorMessage, A2UIComponent, A2UIComponentAction, A2UIDataBinding, A2UIStandardType, } from './a2ui-types.ts';
+export { WebSocketTransport, SSETransport, createWebSocketTransport, createSSETransport } from './a2ui-transport.ts';
+export type { TransportState, TransportEvents, WebSocketTransportOptions, SSETransportOptions } from './a2ui-transport.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/a2ui/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a2ui/protocol/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7G,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9G,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnP,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACtI,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC/H,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAClK,OAAO,EACL,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACrH,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/a2ui/protocol/kernel-bridge.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Kernel Bridge Interface
+ *
+ * Decouples A2UI protocol from the concrete Kernel class.
+ * The real Kernel satisfies this via TypeScript structural typing — no `implements` needed.
+ *
+ * Only the subset of Kernel/types/patch that A2UI actually accesses is duplicated here.
+ */
+import type { Dispose } from '@nonoun/native-ui';
+export interface UINode {
+    readonly id: string;
+    readonly tag: string;
+    readonly attributes?: Readonly<Record<string, string>>;
+    readonly properties?: Readonly<Record<string, unknown>>;
+    readonly children?: readonly UINode[];
+    readonly textContent?: string;
+    readonly events?: Readonly<Record<string, string>>;
+    readonly slot?: string;
+}
+export type CommandSource = 'human' | 'generated' | 'replay';
+export interface UIPlan {
+    readonly id: string;
+    readonly version: number;
+    readonly root: UINode;
+    readonly source: CommandSource;
+    readonly timestamp: number;
+}
+export type PatchOp = {
+    readonly type: 'add';
+    readonly parentId: string;
+    readonly node: UINode;
+    readonly index?: number;
+} | {
+    readonly type: 'remove';
+    readonly targetId: string;
+} | {
+    readonly type: 'replace';
+    readonly targetId: string;
+    readonly node: UINode;
+} | {
+    readonly type: 'set-attribute';
+    readonly targetId: string;
+    readonly name: string;
+    readonly value: string;
+} | {
+    readonly type: 'remove-attribute';
+    readonly targetId: string;
+    readonly name: string;
+} | {
+    readonly type: 'set-property';
+    readonly targetId: string;
+    readonly name: string;
+    readonly value: unknown;
+} | {
+    readonly type: 'set-text';
+    readonly targetId: string;
+    readonly text: string;
+} | {
+    readonly type: 'set-event';
+    readonly targetId: string;
+    readonly event: string;
+    readonly commandType: string;
+} | {
+    readonly type: 'remove-event';
+    readonly targetId: string;
+    readonly event: string;
+};
+export interface UIPatch {
+    readonly planId: string;
+    readonly ops: readonly PatchOp[];
+    readonly source: CommandSource;
+    readonly timestamp: number;
+}
+export interface PlanResult {
+    readonly plan: UIPlan;
+    readonly validation: {
+        readonly valid: boolean;
+        readonly errors: readonly {
+            readonly path: string;
+            readonly code: string;
+            readonly message: string;
+        }[];
+    };
+    readonly accessibility: {
+        readonly violations: readonly unknown[];
+        readonly passes: number;
+    };
+    readonly warnings: readonly string[];
+}
+export interface Command<T = unknown> {
+    readonly type: string;
+    readonly payload: T;
+    readonly id: string;
+    readonly timestamp: number;
+    readonly source: CommandSource;
+}
+export type CommandFilter = (command: Command) => boolean;
+export type CommandHandler<T = unknown> = (command: Command<T>) => void | Promise<void>;
+/**
+ * The subset of the Kernel API that A2UI needs.
+ * Real `Kernel` from `@nonoun/native-ui/kernel` satisfies this structurally.
+ */
+export interface A2UIKernelBridge {
+    readonly bus: {
+        on(typeOrFilter: string | CommandFilter, handler: CommandHandler): Dispose;
+    };
+    readonly executor: {
+        getElements(planId: string): Map<string, HTMLElement> | null;
+    };
+    executePlan(plan: UIPlan, container: HTMLElement): Map<string, HTMLElement>;
+    patchPlan(patch: UIPatch): unknown;
+    teardownPlan(planId: string): void;
+}
+//# sourceMappingURL=kernel-bridge.d.ts.map

package/dist/a2ui/protocol/kernel-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-bridge.d.ts","sourceRoot":"","sources":["../../../src/a2ui/protocol/kernel-bridge.ts"],"names":[],"mappings":"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"}

package/dist/a2ui/register.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Register native-a2ui
+ *
+ * Side-effect module that registers the <native-a2ui> custom element
+ * and all dogfooded n-* components it creates via document.createElement.
+ *
+ * Usage:
+ *   import '@nonoun/native-ai/register';
+ */
+import { NA2UI } from './a2ui-element.ts';
+export { NA2UI };
+//# sourceMappingURL=register.d.ts.map

package/dist/a2ui/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/a2ui/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAK1C,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/a2ui/session/agent-session.d.ts

@@ -0,0 +1,44 @@
+/**
+ * NAgentSession — Per-Agent Session
+ *
+ * Represents a single agent-to-renderer connection. Each session wraps
+ * a dedicated A2UIAdapter (1:1) and validates ownership + catalog
+ * before delegating to the existing protocol layer.
+ */
+import type { A2UIServerMessage } from '../protocol/a2ui-types.ts';
+import type { A2UIKernelBridge } from '../protocol/kernel-bridge.ts';
+import type { NSessionStatus, NInteractionEvent } from './types.ts';
+import { NEventEmitter } from './event-emitter.ts';
+import type { NCatalog } from './catalog.ts';
+import type { NSurfaceRegistry } from './surface-registry.ts';
+interface SessionEventMap {
+    'interaction': (e: NInteractionEvent) => void;
+    'surface-ready': (surfaceId: string) => void;
+    'status-change': (status: NSessionStatus) => void;
+    'catalog-violation': (type: string, componentId: string) => void;
+}
+export interface NAgentSessionConfig {
+    readonly agentId: string;
+    readonly catalog: NCatalog;
+    readonly surfaces?: readonly string[];
+}
+export declare class NAgentSession {
+    #private;
+    readonly id: string;
+    readonly agentId: string;
+    readonly catalog: NCatalog;
+    readonly eventEmitter: NEventEmitter;
+    constructor(kernel: A2UIKernelBridge, registry: NSurfaceRegistry, config: NAgentSessionConfig);
+    get status(): NSessionStatus;
+    /**
+     * Inbound: agent sends A2UI payload.
+     * Validates ownership and catalog before forwarding to the internal adapter.
+     */
+    receive(message: A2UIServerMessage | string): void;
+    /** Subscribe to session events. */
+    on<K extends keyof SessionEventMap>(event: K, handler: SessionEventMap[K]): () => void;
+    /** Terminate the session and clean up. */
+    terminate(): void;
+}
+export {};
+//# sourceMappingURL=agent-session.d.ts.map

package/dist/a2ui/session/agent-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../../src/a2ui/session/agent-session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,2BAA2B,CAAC;AAUnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAiB,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,UAAU,eAAe;IACvB,aAAa,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9C,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,eAAe,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAID,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAID,qBAAa,aAAa;;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;gBAUnC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,mBAAmB;IA4C7B,IAAI,MAAM,IAAI,cAAc,CAAyB;IAErD;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI;IA4ClD,mCAAmC;IACnC,EAAE,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAStF,0CAA0C;IAC1C,SAAS,IAAI,IAAI;CAqBlB"}

package/dist/a2ui/session/catalog.d.ts

@@ -0,0 +1,41 @@
+/**
+ * NCatalog — Per-Session Component Catalog
+ *
+ * Scoped component catalog for security enforcement.
+ * Agents can only render components granted in their session's catalog.
+ * Reads from the existing COMPONENT_MAP in a2ui-component-map.ts.
+ */
+import type { A2UIComponent } from '../protocol/a2ui-types.ts';
+export interface NCatalogEntry {
+    readonly a2uiType: string;
+    readonly tagName: string;
+    readonly properties: readonly string[];
+    readonly events: readonly string[];
+}
+export declare class NCatalog {
+    #private;
+    constructor(entries: readonly NCatalogEntry[]);
+    /** All catalog entries. */
+    get entries(): readonly NCatalogEntry[];
+    /** Check if a component type is in this catalog. */
+    has(a2uiType: string): boolean;
+    /** Get entry for a component type. */
+    get(a2uiType: string): NCatalogEntry | undefined;
+    /**
+     * Serialize to A2UI catalog format for AgentCard / negotiation.
+     */
+    toManifest(): object;
+    /**
+     * Filter an A2UI component array against this catalog.
+     * Returns only components whose type is allowed.
+     * Also strips blocked component IDs from parent children arrays.
+     */
+    filterComponents(components: readonly A2UIComponent[], onViolation?: (type: string, id: string) => void): A2UIComponent[];
+}
+/**
+ * Build a catalog from the existing COMPONENT_MAP.
+ * - `'core-only'`: excludes `native-dashboard-*` elements (recommended default)
+ * - `'full'`: all registered component types
+ */
+export declare function buildCatalogFromRegistry(scope?: 'full' | 'core-only'): NCatalog;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/a2ui/session/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/a2ui/session/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAID,qBAAa,QAAQ;;gBAGP,OAAO,EAAE,SAAS,aAAa,EAAE;IAM7C,2BAA2B;IAC3B,IAAI,OAAO,IAAI,SAAS,aAAa,EAAE,CAEtC;IAED,oDAAoD;IACpD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B,sCAAsC;IACtC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIhD;;OAEG;IACH,UAAU,IAAI,MAAM;IAapB;;;;OAIG;IACH,gBAAgB,CACd,UAAU,EAAE,SAAS,aAAa,EAAE,EACpC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,GAC/C,aAAa,EAAE;CAsBnB;AAiBD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,GAAE,MAAM,GAAG,WAAyB,GAAG,QAAQ,CAO5F"}

package/dist/a2ui/session/event-emitter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * NEventEmitter — Typed Interaction Event Pub/Sub
+ *
+ * Routes user interaction events from rendered surfaces back to agent sessions.
+ * Each NAgentSession creates one NEventEmitter instance.
+ */
+import type { NInteractionEvent } from './types.ts';
+export declare class NEventEmitter {
+    #private;
+    /** Emit an interaction event to all subscribers. */
+    emit(event: NInteractionEvent): void;
+    /** Subscribe to interaction events. Returns an unsubscribe function. */
+    on(handler: (event: NInteractionEvent) => void): () => void;
+    /** Remove all subscribers. */
+    destroy(): void;
+}
+//# sourceMappingURL=event-emitter.d.ts.map

package/dist/a2ui/session/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../../src/a2ui/session/event-emitter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,qBAAa,aAAa;;IAGxB,oDAAoD;IACpD,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAIpC,wEAAwE;IACxE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAK3D,8BAA8B;IAC9B,OAAO,IAAI,IAAI;CAGhB"}

package/dist/a2ui/session/index.d.ts

@@ -0,0 +1,9 @@
+export { NSessionManager } from './session-manager.ts';
+export { NAgentSession } from './agent-session.ts';
+export type { NAgentSessionConfig } from './agent-session.ts';
+export { NSurfaceRegistry } from './surface-registry.ts';
+export { NEventEmitter } from './event-emitter.ts';
+export { NCatalog, buildCatalogFromRegistry } from './catalog.ts';
+export type { NCatalogEntry } from './catalog.ts';
+export type { NSessionConfig, NSessionStatus, NInteractionEvent, NSurfaceState } from './types.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/a2ui/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a2ui/session/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/a2ui/session/session-manager.d.ts

@@ -0,0 +1,33 @@
+/**
+ * NSessionManager — Multi-Session Orchestrator
+ *
+ * Host-facing singleton that manages all active agent sessions.
+ * Creates sessions, resolves catalogs, and controls surface ownership transfers.
+ */
+import type { A2UIKernelBridge } from '../protocol/kernel-bridge.ts';
+import type { NSessionConfig } from './types.ts';
+import { NAgentSession } from './agent-session.ts';
+import { NSurfaceRegistry } from './surface-registry.ts';
+export declare class NSessionManager {
+    #private;
+    readonly surfaces: NSurfaceRegistry;
+    constructor(kernel: A2UIKernelBridge);
+    /** Create a new agent session with the given configuration. */
+    createSession(config: NSessionConfig): NAgentSession;
+    /** Get a session by ID. */
+    getSession(id: string): NAgentSession | undefined;
+    /** Get all active sessions. */
+    getSessions(): readonly NAgentSession[];
+    /**
+     * Transfer surface ownership between sessions.
+     * Only the session manager (orchestrator) can perform transfers.
+     */
+    transferSurfaceOwnership(surfaceId: string, toSessionId: string): void;
+    /** Terminate a single session and clean up. */
+    terminateSession(id: string): void;
+    /** Terminate all sessions. */
+    terminateAll(): void;
+    /** Destroy the session manager and all sessions. */
+    destroy(): void;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/a2ui/session/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/a2ui/session/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,qBAAa,eAAe;;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;gBAIxB,MAAM,EAAE,gBAAgB;IAKpC,+DAA+D;IAC/D,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa;IA+BpD,2BAA2B;IAC3B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIjD,+BAA+B;IAC/B,WAAW,IAAI,SAAS,aAAa,EAAE;IAIvC;;;OAGG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAMtE,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOlC,8BAA8B;IAC9B,YAAY,IAAI,IAAI;IAKpB,oDAAoD;IACpD,OAAO,IAAI,IAAI;CAIhB"}

package/dist/a2ui/session/surface-registry.d.ts

@@ -0,0 +1,32 @@
+/**
+ * NSurfaceRegistry — Cross-Session Surface Coordination
+ *
+ * Tracks surfaces, ownership (single writer), observers (read-only),
+ * mount points, and state snapshots. Provides event notifications
+ * for surface updates and removals.
+ */
+import type { NSurfaceState } from './types.ts';
+import type { NAgentSession } from './agent-session.ts';
+type SurfaceUpdatedHandler = (surfaceId: string, state: NSurfaceState) => void;
+type SurfaceRemovedHandler = (surfaceId: string) => void;
+export declare class NSurfaceRegistry {
+    #private;
+    registerMount(surfaceId: string, element: HTMLElement): void;
+    getMount(surfaceId: string): HTMLElement | undefined;
+    unregisterMount(surfaceId: string): void;
+    setOwner(surfaceId: string, session: NAgentSession): void;
+    getOwner(surfaceId: string): NAgentSession | undefined;
+    clearOwner(surfaceId: string): void;
+    isOwner(surfaceId: string, session: NAgentSession): boolean;
+    transferOwnership(surfaceId: string, to: NAgentSession): void;
+    addObserver(surfaceId: string, session: NAgentSession): void;
+    removeObserver(surfaceId: string, session: NAgentSession): void;
+    getObservers(surfaceId: string): readonly NAgentSession[];
+    updateState(surfaceId: string, state: NSurfaceState): void;
+    getState(surfaceId: string): NSurfaceState | undefined;
+    on(event: 'surface-updated', handler: SurfaceUpdatedHandler): () => void;
+    on(event: 'surface-removed', handler: SurfaceRemovedHandler): () => void;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=surface-registry.d.ts.map

package/dist/a2ui/session/surface-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-registry.d.ts","sourceRoot":"","sources":["../../../src/a2ui/session/surface-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAcxD,KAAK,qBAAqB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAC/E,KAAK,qBAAqB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;AAIzD,qBAAa,gBAAgB;;IAO3B,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAe5D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIpD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASxC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAMzD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAItD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKnC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO;IAI3D,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI;IAQ7D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAM5D,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAI/D,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE;IAOzD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAO1D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAMtD,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI;IACxE,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAcxE,OAAO,IAAI,IAAI;CAKhB"}

package/dist/a2ui/session/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Session Layer — Shared Types
+ *
+ * Core type definitions for multi-session A2A support.
+ */
+import type { A2UIComponent } from '../protocol/a2ui-types.ts';
+export type NSessionStatus = 'connecting' | 'active' | 'suspended' | 'terminated';
+export interface NSessionConfig {
+    readonly agentId: string;
+    readonly catalog: import('./catalog.ts').NCatalog | 'full' | 'core-only';
+    readonly surfaces?: readonly string[];
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface NInteractionEvent {
+    readonly surfaceId: string;
+    readonly componentId: string;
+    readonly eventType: string;
+    readonly payload: Readonly<Record<string, unknown>>;
+    readonly timestamp: number;
+}
+export interface NSurfaceState {
+    readonly surfaceId: string;
+    readonly components: readonly A2UIComponent[];
+    readonly dataModel: Readonly<Record<string, unknown>>;
+    readonly updatedAt: number;
+}
+//# sourceMappingURL=types.d.ts.map