@mcp-native/a2ui 0.1.0 → 0.3.0

package/dist/v1/store.js

@@ -0,0 +1,305 @@
+import { parseJsonObject, parseJsonValue } from "@mcp-native/core";
+import { A2uiParseError } from "../errors.js";
+import { parseA2uiV1Envelope } from "./parse.js";
+import { A2UI_V1_MAX_COMPONENTS, A2UI_V1_MAX_SURFACES } from "./types.js";
+import { validateA2uiV1SurfaceState } from "./validate.js";
+/**
+ * Ordered in-memory store for official A2UI v1.0 lifecycle envelopes.
+ * Batches applied through {@link A2uiSurfaceStore.applyAll} are atomic.
+ */
+export class A2uiSurfaceStore {
+    #surfaces = new Map();
+    get size() {
+        return this.#surfaces.size;
+    }
+    has(surfaceId) {
+        return this.#surfaces.has(surfaceId);
+    }
+    get(surfaceId) {
+        const surface = this.#surfaces.get(surfaceId);
+        return surface === undefined ? undefined : freezeSurface(surface);
+    }
+    /** Returns a complete renderer-ready snapshot or fails closed. */
+    getValidated(surfaceId, policy) {
+        const surface = this.get(surfaceId);
+        return surface === undefined ? undefined : validateA2uiV1SurfaceState(surface, policy);
+    }
+    list() {
+        return [...this.#surfaces.values()].map(freezeSurface);
+    }
+    apply(envelope) {
+        this.#applyValidated(parseA2uiV1Envelope(envelope));
+    }
+    #applyValidated(envelope) {
+        if ("createSurface" in envelope) {
+            this.#createSurface(envelope.createSurface);
+            return;
+        }
+        if ("updateComponents" in envelope) {
+            this.#updateComponents(envelope.updateComponents);
+            return;
+        }
+        if ("updateDataModel" in envelope) {
+            this.#updateDataModel(envelope.updateDataModel);
+            return;
+        }
+        if ("deleteSurface" in envelope) {
+            this.#deleteSurface(envelope.deleteSurface.surfaceId);
+            return;
+        }
+        throw new A2uiParseError("Unsupported A2UI v1 envelope for the surface store");
+    }
+    /**
+     * Applies every envelope in order. On failure the store is left unchanged.
+     */
+    applyAll(envelopes) {
+        if (!Array.isArray(envelopes)) {
+            throw new A2uiParseError("Expected an array of A2UI v1 envelopes");
+        }
+        const validated = envelopes.map((envelope) => parseA2uiV1Envelope(envelope));
+        const snapshot = cloneSurfaces(this.#surfaces);
+        try {
+            for (const envelope of validated) {
+                this.#applyValidated(envelope);
+            }
+        }
+        catch (error) {
+            this.#surfaces.clear();
+            for (const [surfaceId, surface] of snapshot) {
+                this.#surfaces.set(surfaceId, surface);
+            }
+            throw error;
+        }
+    }
+    #createSurface(message) {
+        if (this.#surfaces.has(message.surfaceId)) {
+            throw new A2uiParseError(`Cannot create A2UI surface ${JSON.stringify(message.surfaceId)}; it already exists`);
+        }
+        if (this.#surfaces.size >= A2UI_V1_MAX_SURFACES) {
+            throw new A2uiParseError(`A2UI store exceeds maximum of ${A2UI_V1_MAX_SURFACES} surfaces`);
+        }
+        const components = new Map();
+        if (message.components !== undefined) {
+            mergeComponents(components, message.components);
+        }
+        const dataModel = message.dataModel === undefined
+            ? {}
+            : parseJsonObject(message.dataModel, "createSurface.dataModel");
+        const surface = {
+            surfaceId: message.surfaceId,
+            sendDataModel: message.sendDataModel === true,
+            dataModelRevision: 0,
+            components,
+            dataModel,
+        };
+        if (message.catalogId !== undefined) {
+            surface.catalogId = message.catalogId;
+        }
+        if (message.metadata !== undefined) {
+            surface.metadata = parseJsonObject(message.metadata, "createSurface.metadata");
+        }
+        this.#surfaces.set(message.surfaceId, surface);
+    }
+    #updateComponents(message) {
+        const surface = this.#requireSurface(message.surfaceId, "updateComponents");
+        const updatedComponents = cloneComponents(surface.components);
+        mergeComponents(updatedComponents, message.components);
+        surface.components = updatedComponents;
+    }
+    #updateDataModel(message) {
+        const surface = this.#requireSurface(message.surfaceId, "updateDataModel");
+        const updatedDataModel = setJsonPointer(surface.dataModel, message.path, parseJsonValue(message.value, "updateDataModel.value"));
+        try {
+            surface.dataModel = parseJsonObject(updatedDataModel, "updateDataModel.result");
+            surface.dataModelRevision += 1;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Invalid merged data model";
+            throw new A2uiParseError(`Updated A2UI data model is invalid: ${errorMessage}`, {
+                cause: error,
+            });
+        }
+    }
+    #deleteSurface(surfaceId) {
+        if (!this.#surfaces.delete(surfaceId)) {
+            throw new A2uiParseError(`Cannot delete A2UI surface ${JSON.stringify(surfaceId)}; it does not exist`);
+        }
+    }
+    #requireSurface(surfaceId, operation) {
+        const surface = this.#surfaces.get(surfaceId);
+        if (surface === undefined) {
+            throw new A2uiParseError(`Cannot ${operation} A2UI surface ${JSON.stringify(surfaceId)}; it does not exist`);
+        }
+        return surface;
+    }
+}
+function mergeComponents(target, components) {
+    const seen = new Set();
+    for (const [index, component] of components.entries()) {
+        const reconstructed = parseJsonObject(component, `components[${index}]`);
+        if (typeof reconstructed.id !== "string" || reconstructed.id.length === 0) {
+            throw new A2uiParseError("Expected a non-empty component id");
+        }
+        if (typeof reconstructed.component !== "string" || reconstructed.component.length === 0) {
+            throw new A2uiParseError("Expected a non-empty component name");
+        }
+        if (seen.has(reconstructed.id)) {
+            throw new A2uiParseError(`Duplicate A2UI component id ${JSON.stringify(reconstructed.id)} in one update`);
+        }
+        seen.add(reconstructed.id);
+        target.set(reconstructed.id, reconstructed);
+        if (target.size > A2UI_V1_MAX_COMPONENTS) {
+            throw new A2uiParseError(`A2UI surface exceeds maximum of ${A2UI_V1_MAX_COMPONENTS} components`);
+        }
+    }
+}
+function freezeSurface(surface) {
+    return {
+        surfaceId: surface.surfaceId,
+        ...(surface.catalogId === undefined ? {} : { catalogId: surface.catalogId }),
+        sendDataModel: surface.sendDataModel,
+        dataModelRevision: surface.dataModelRevision,
+        components: cloneComponents(surface.components),
+        dataModel: parseJsonObject(surface.dataModel, "surface.dataModel"),
+        ...(surface.metadata === undefined
+            ? {}
+            : { metadata: parseJsonObject(surface.metadata, "surface.metadata") }),
+    };
+}
+function cloneSurfaces(surfaces) {
+    const clone = new Map();
+    for (const [surfaceId, surface] of surfaces) {
+        clone.set(surfaceId, {
+            surfaceId: surface.surfaceId,
+            ...(surface.catalogId === undefined ? {} : { catalogId: surface.catalogId }),
+            sendDataModel: surface.sendDataModel,
+            dataModelRevision: surface.dataModelRevision,
+            components: cloneComponents(surface.components),
+            dataModel: parseJsonObject(surface.dataModel, "surface.dataModel"),
+            ...(surface.metadata === undefined
+                ? {}
+                : { metadata: parseJsonObject(surface.metadata, "surface.metadata") }),
+        });
+    }
+    return clone;
+}
+function cloneComponents(components) {
+    const clone = new Map();
+    for (const [id, component] of components) {
+        clone.set(id, parseJsonObject(component, `components.${id}`));
+    }
+    return clone;
+}
+function setJsonPointer(document, path, value) {
+    if (path === undefined || path === "" || path === "/") {
+        if (value === null || typeof value !== "object" || Array.isArray(value)) {
+            throw new A2uiParseError("Root data model replacement must be a JSON object");
+        }
+        return parseJsonObject(value, "dataModel");
+    }
+    if (!path.startsWith("/")) {
+        throw new A2uiParseError(`Invalid JSON Pointer ${JSON.stringify(path)}`);
+    }
+    const tokens = path
+        .slice(1)
+        .split("/")
+        .map((token) => decodeJsonPointerToken(token, path));
+    const root = parseJsonObject(document, "dataModel");
+    let cursor = root;
+    for (let index = 0; index < tokens.length - 1; index += 1) {
+        const token = tokens[index];
+        if (Array.isArray(cursor)) {
+            const arrayIndex = parseArrayIndex(token, path);
+            if (arrayIndex > cursor.length) {
+                throw new A2uiParseError(`JSON Pointer path missing at ${JSON.stringify(path)}`);
+            }
+            if (arrayIndex === cursor.length) {
+                cursor.push({});
+            }
+            const next = cursor[arrayIndex];
+            if (next === null || typeof next !== "object") {
+                throw new A2uiParseError(`JSON Pointer path is not a container at ${JSON.stringify(path)}`);
+            }
+            cursor = next;
+            continue;
+        }
+        if (cursor === null || typeof cursor !== "object") {
+            throw new A2uiParseError(`JSON Pointer path missing at ${JSON.stringify(path)}`);
+        }
+        const object = cursor;
+        if (!Object.hasOwn(object, token)) {
+            defineJsonProperty(object, token, {});
+        }
+        const next = object[token];
+        if (next === null || typeof next !== "object") {
+            throw new A2uiParseError(`JSON Pointer path is not a container at ${JSON.stringify(path)}`);
+        }
+        cursor = next;
+    }
+    const last = tokens[tokens.length - 1];
+    if (Array.isArray(cursor)) {
+        const arrayIndex = parseArrayIndex(last, path);
+        if (value === null) {
+            if (arrayIndex >= cursor.length) {
+                throw new A2uiParseError(`JSON Pointer path missing at ${JSON.stringify(path)}`);
+            }
+            cursor.splice(arrayIndex, 1);
+        }
+        else if (arrayIndex === cursor.length) {
+            cursor.push(value);
+        }
+        else if (arrayIndex < cursor.length) {
+            cursor[arrayIndex] = value;
+        }
+        else {
+            throw new A2uiParseError(`JSON Pointer path missing at ${JSON.stringify(path)}`);
+        }
+        return root;
+    }
+    if (cursor === null || typeof cursor !== "object") {
+        throw new A2uiParseError(`JSON Pointer path missing at ${JSON.stringify(path)}`);
+    }
+    const object = cursor;
+    if (value === null) {
+        if (!Object.hasOwn(object, last)) {
+            throw new A2uiParseError(`JSON Pointer path missing at ${JSON.stringify(path)}`);
+        }
+        delete object[last];
+    }
+    else {
+        defineJsonProperty(object, last, value);
+    }
+    return root;
+}
+function parseArrayIndex(token, path) {
+    if (!/^(0|[1-9][0-9]*)$/.test(token)) {
+        throw new A2uiParseError(`Invalid JSON Pointer array index in ${JSON.stringify(path)}`);
+    }
+    const index = Number(token);
+    if (!Number.isSafeInteger(index)) {
+        throw new A2uiParseError(`Invalid JSON Pointer array index in ${JSON.stringify(path)}`);
+    }
+    return index;
+}
+function decodeJsonPointerToken(token, path) {
+    for (let index = 0; index < token.length; index += 1) {
+        if (token[index] !== "~") {
+            continue;
+        }
+        const escaped = token[index + 1];
+        if (escaped !== "0" && escaped !== "1") {
+            throw new A2uiParseError(`Invalid JSON Pointer escape in ${JSON.stringify(path)}`);
+        }
+        index += 1;
+    }
+    return token.replaceAll("~1", "/").replaceAll("~0", "~");
+}
+function defineJsonProperty(object, key, value) {
+    Object.defineProperty(object, key, {
+        configurable: true,
+        enumerable: true,
+        value,
+        writable: true,
+    });
+}
+//# sourceMappingURL=store.js.map

package/dist/v1/store.js.map

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

package/dist/v1/types.d.ts

@@ -0,0 +1,109 @@
+import type { JsonObject, JsonValue } from "@mcp-native/core";
+export declare const A2UI_V1_PROTOCOL_VERSION: "v1.0";
+/** Maximum UTF-16 code units accepted in one JSONL resource body. */
+export declare const A2UI_V1_MAX_SOURCE_LENGTH = 1048576;
+/** Maximum number of non-empty JSONL envelopes in one resource batch. */
+export declare const A2UI_V1_MAX_ENVELOPES = 1024;
+/** Maximum surfaces retained by one in-memory store. */
+export declare const A2UI_V1_MAX_SURFACES = 1024;
+/** Maximum retained component definitions in one surface. */
+export declare const A2UI_V1_MAX_COMPONENTS = 1024;
+export type A2uiV1Component = JsonObject & {
+    readonly id: string;
+    readonly component: string;
+};
+export type A2uiV1CreateSurfaceEnvelope = {
+    readonly version: typeof A2UI_V1_PROTOCOL_VERSION;
+    readonly createSurface: {
+        readonly surfaceId: string;
+        readonly catalogId?: string;
+        readonly sendDataModel?: boolean;
+        readonly components?: readonly A2uiV1Component[];
+        readonly dataModel?: JsonObject;
+        readonly metadata?: JsonObject;
+    };
+};
+export type A2uiV1UpdateComponentsEnvelope = {
+    readonly version: typeof A2UI_V1_PROTOCOL_VERSION;
+    readonly updateComponents: {
+        readonly surfaceId: string;
+        readonly components: readonly A2uiV1Component[];
+    };
+};
+export type A2uiV1UpdateDataModelEnvelope = {
+    readonly version: typeof A2UI_V1_PROTOCOL_VERSION;
+    readonly updateDataModel: {
+        readonly surfaceId: string;
+        readonly path?: string;
+        readonly value: JsonValue;
+    };
+};
+export type A2uiV1DeleteSurfaceEnvelope = {
+    readonly version: typeof A2UI_V1_PROTOCOL_VERSION;
+    readonly deleteSurface: {
+        readonly surfaceId: string;
+    };
+};
+/** Lifecycle envelopes supported by the Milestone 3 surface store. */
+export type A2uiV1Envelope = A2uiV1CreateSurfaceEnvelope | A2uiV1UpdateComponentsEnvelope | A2uiV1UpdateDataModelEnvelope | A2uiV1DeleteSurfaceEnvelope;
+export type A2uiV1EnvelopeKind = "createSurface" | "updateComponents" | "updateDataModel" | "deleteSurface";
+export interface A2uiV1SurfaceState {
+    readonly surfaceId: string;
+    readonly catalogId?: string;
+    readonly sendDataModel: boolean;
+    /** Host-owned revision incremented after each accepted agent data-model update. */
+    readonly dataModelRevision?: number;
+    readonly components: ReadonlyMap<string, A2uiV1Component>;
+    readonly dataModel: JsonObject;
+    readonly metadata?: JsonObject;
+}
+export interface A2uiV1Action {
+    readonly name: string;
+    readonly surfaceId: string;
+    readonly sourceComponentId: string;
+    readonly timestamp: string;
+    readonly context: JsonObject;
+    readonly userMessage?: string;
+    readonly metadata?: JsonObject;
+}
+export interface A2uiV1ActionEnvelope {
+    readonly version: typeof A2UI_V1_PROTOCOL_VERSION;
+    readonly action: A2uiV1Action;
+}
+export interface A2uiV1ActionEnvelopeInput {
+    readonly name: string;
+    readonly surfaceId: string;
+    readonly sourceComponentId: string;
+    readonly context: JsonObject;
+    readonly userMessage?: string;
+    readonly metadata?: JsonObject;
+    /** RFC 3339 timestamp. Defaults to the current time when omitted. */
+    readonly timestamp?: string;
+}
+export interface A2uiV1AgentCapabilities {
+    readonly "v1.0": {
+        readonly supportedCatalogIds: readonly string[];
+        readonly acceptsInlineCatalogs: boolean;
+    };
+}
+export interface A2uiV1RendererCapabilities {
+    readonly "v1.0": {
+        readonly supportedCatalogIds: readonly string[];
+    };
+}
+export interface A2uiV1RendererCapabilitiesOptions {
+    /** Catalogs fully implemented and registered by the host renderer. */
+    readonly supportedCatalogIds: readonly string[];
+}
+export type A2uiV1CapabilityNegotiation = {
+    readonly kind: "fallback";
+    readonly protocolVersion: typeof A2UI_V1_PROTOCOL_VERSION;
+    readonly reason: "no-shared-catalog";
+} | {
+    readonly kind: "negotiated";
+    readonly protocolVersion: typeof A2UI_V1_PROTOCOL_VERSION;
+    readonly supportedCatalogIds: readonly string[];
+    /** This implementation never enables untrusted inline catalog definitions. */
+    readonly inlineCatalogsEnabled: false;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/v1/types.d.ts.map

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

package/dist/v1/types.js

@@ -0,0 +1,10 @@
+export const A2UI_V1_PROTOCOL_VERSION = "v1.0";
+/** Maximum UTF-16 code units accepted in one JSONL resource body. */
+export const A2UI_V1_MAX_SOURCE_LENGTH = 1_048_576;
+/** Maximum number of non-empty JSONL envelopes in one resource batch. */
+export const A2UI_V1_MAX_ENVELOPES = 1_024;
+/** Maximum surfaces retained by one in-memory store. */
+export const A2UI_V1_MAX_SURFACES = 1_024;
+/** Maximum retained component definitions in one surface. */
+export const A2UI_V1_MAX_COMPONENTS = 1_024;
+//# sourceMappingURL=types.js.map

package/dist/v1/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/v1/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAe,CAAC;AAExD,qEAAqE;AACrE,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAC;AACnD,yEAAyE;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,wDAAwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAC1C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC"}

package/dist/v1/validate.d.ts

@@ -0,0 +1,26 @@
+import type { A2uiV1SurfaceState } from "./types.js";
+export declare const A2UI_V1_BASIC_CATALOG_ID: "https://a2ui.org/specification/v1_0/catalogs/basic/catalog.json";
+export declare const A2UI_V1_BASIC_COMPONENT_NAMES: readonly string[];
+export declare const A2UI_V1_BASIC_FUNCTION_NAMES: readonly string[];
+export declare const A2UI_V1_SYSTEM_FUNCTION_NAMES: readonly string[];
+export interface A2uiV1SurfaceValidationPolicy {
+    /** Host-bundled basic-catalog components that this surface may instantiate. */
+    readonly allowedComponentNames: readonly string[];
+    /** Agent event names the host is prepared to route after renderer adaptation. */
+    readonly allowedEventNames?: readonly string[];
+    /** Locally registered basic-catalog function names. Empty means deny all functions. */
+    readonly allowedFunctionNames?: readonly string[];
+}
+export interface A2uiV1BasicCatalogPolicyOptions {
+    readonly allowedComponentNames: readonly string[];
+    readonly allowedEventNames?: readonly string[];
+    readonly allowedFunctionNames?: readonly string[];
+}
+/** Creates an explicit host policy for the pinned basic catalog. */
+export declare function createA2uiV1BasicCatalogPolicy(options: A2uiV1BasicCatalogPolicyOptions): A2uiV1SurfaceValidationPolicy;
+/**
+ * Validates a complete surface snapshot before it crosses into a renderer.
+ * Store snapshots may remain incomplete while ordered lifecycle messages arrive.
+ */
+export declare function validateA2uiV1SurfaceState(surface: A2uiV1SurfaceState, policy: A2uiV1SurfaceValidationPolicy): A2uiV1SurfaceState;
+//# sourceMappingURL=validate.d.ts.map

package/dist/v1/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/v1/validate.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAmB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEtE,eAAO,MAAM,wBAAwB,EACnC,iEAA0E,CAAC;AAE7E,eAAO,MAAM,6BAA6B,EAErC,SAAS,MAAM,EAAE,CAAC;AAEvB,eAAO,MAAM,4BAA4B,EAEpC,SAAS,MAAM,EAAE,CAAC;AAEvB,eAAO,MAAM,6BAA6B,EAAgC,SAAS,MAAM,EAAE,CAAC;AAO5F,MAAM,WAAW,6BAA6B;IAC5C,+EAA+E;IAC/E,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IAClD,iFAAiF;IACjF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,uFAAuF;IACvF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IAClD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnD;AAED,oEAAoE;AACpE,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,6BAA6B,CAS/B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,6BAA6B,GACpC,kBAAkB,CA2EpB"}