@mcp-native/a2ui 0.1.0 → 0.2.0

package/dist/v1/format-string.js

@@ -0,0 +1,377 @@
+import { JSON_MAX_DEPTH, JSON_MAX_VALUES } from "@mcp-native/core";
+import { A2uiParseError } from "../errors.js";
+const IDENTIFIER = /^[\p{XID_Start}_][\p{XID_Continue}]*$/u;
+const JSON_NUMBER = /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/;
+/** Parses the expression language embedded in one pinned-catalog formatString value. */
+export function parseA2uiV1FormatString(source, path) {
+    const parser = new FormatStringParser(path);
+    return parser.parse(source);
+}
+class FormatStringParser {
+    #path;
+    #expressionCount = 0;
+    constructor(path) {
+        this.#path = path;
+    }
+    parse(source) {
+        const expressions = [];
+        for (let index = 0; index < source.length; index += 1) {
+            if (source[index] !== "$" || source[index + 1] !== "{" || isEscaped(source, index)) {
+                continue;
+            }
+            const interpolation = this.#readInterpolation(source, index);
+            expressions.push(this.#parseExpression(interpolation.content, interpolation.offset, 1));
+            index = interpolation.end - 1;
+        }
+        return {
+            expressionCount: this.#expressionCount,
+            expressions,
+        };
+    }
+    #parseExpression(source, offset, depth) {
+        this.#expressionCount += 1;
+        if (this.#expressionCount > JSON_MAX_VALUES) {
+            this.#fail(`exceeds maximum of ${JSON_MAX_VALUES} interpolation expressions`, offset);
+        }
+        if (depth > JSON_MAX_DEPTH) {
+            this.#fail(`exceeds maximum expression depth of ${JSON_MAX_DEPTH}`, offset);
+        }
+        const expression = source.trim();
+        if (expression.length === 0) {
+            this.#fail("contains an empty interpolation expression", offset);
+        }
+        if (expression.startsWith("${")) {
+            const interpolation = this.#readInterpolation(expression, 0);
+            if (expression.slice(interpolation.end).trim().length !== 0) {
+                this.#fail("contains trailing content after a nested expression", offset);
+            }
+            return this.#parseExpression(interpolation.content, offset + interpolation.offset, depth + 1);
+        }
+        if (expression[0] === '"' || expression[0] === "'") {
+            return parseQuotedLiteral(expression, this.#path, offset);
+        }
+        if (expression === "true") {
+            return true;
+        }
+        if (expression === "false") {
+            return false;
+        }
+        if (expression === "null") {
+            return null;
+        }
+        if (JSON_NUMBER.test(expression)) {
+            const value = Number(expression);
+            if (!Number.isFinite(value)) {
+                this.#fail("contains a non-finite numeric literal", offset);
+            }
+            return value;
+        }
+        const openParenthesis = findFirstParenthesis(expression);
+        if (openParenthesis === -1) {
+            return { path: expression };
+        }
+        const functionName = expression.slice(0, openParenthesis).trim();
+        if (!isFunctionIdentifier(functionName)) {
+            return { path: expression };
+        }
+        const closeParenthesis = findClosingParenthesis(expression, openParenthesis, this.#path);
+        if (expression.slice(closeParenthesis + 1).trim().length !== 0) {
+            this.#fail("contains trailing content after a function call", offset);
+        }
+        const args = this.#parseArguments(expression.slice(openParenthesis + 1, closeParenthesis), offset + openParenthesis + 1, depth);
+        return {
+            call: functionName,
+            ...(Object.keys(args).length === 0 ? {} : { args }),
+        };
+    }
+    #parseArguments(source, offset, depth) {
+        const args = {};
+        if (source.trim().length === 0) {
+            return args;
+        }
+        for (const segment of splitTopLevel(source, ",", this.#path)) {
+            const separator = findTopLevelCharacter(segment.value, ":", this.#path);
+            if (separator === -1) {
+                this.#fail("requires every function argument to be named", offset + segment.offset);
+            }
+            const name = segment.value.slice(0, separator).trim();
+            if (!IDENTIFIER.test(name)) {
+                this.#fail(`contains invalid argument name ${JSON.stringify(name)}`, offset + segment.offset);
+            }
+            if (Object.hasOwn(args, name)) {
+                this.#fail(`contains duplicate argument ${JSON.stringify(name)}`, offset + segment.offset);
+            }
+            const valueSource = segment.value.slice(separator + 1).trim();
+            if (valueSource.length === 0) {
+                this.#fail(`contains an empty value for argument ${JSON.stringify(name)}`, offset + segment.offset);
+            }
+            defineJsonProperty(args, name, this.#parseArgumentValue(valueSource, offset + segment.offset + separator + 1, depth + 1));
+        }
+        return args;
+    }
+    #parseArgumentValue(source, offset, depth) {
+        if (source.startsWith("${")) {
+            const interpolation = this.#readInterpolation(source, 0);
+            if (source.slice(interpolation.end).trim().length !== 0) {
+                this.#fail("contains trailing content after a nested expression", offset);
+            }
+            return this.#parseExpression(interpolation.content, offset + interpolation.offset, depth);
+        }
+        if (source[0] === '"' || source[0] === "'") {
+            return parseQuotedLiteral(source, this.#path, offset);
+        }
+        if (source === "true") {
+            return true;
+        }
+        if (source === "false") {
+            return false;
+        }
+        if (JSON_NUMBER.test(source)) {
+            const value = Number(source);
+            if (!Number.isFinite(value)) {
+                this.#fail("contains a non-finite numeric literal", offset);
+            }
+            return value;
+        }
+        this.#fail(`contains unsupported argument literal ${JSON.stringify(source)}`, offset);
+    }
+    #readInterpolation(source, start) {
+        let nesting = 1;
+        let quote;
+        let escaped = false;
+        for (let index = start + 2; index < source.length; index += 1) {
+            const character = source[index];
+            if (quote !== undefined) {
+                if (escaped) {
+                    escaped = false;
+                }
+                else if (character === "\\") {
+                    escaped = true;
+                }
+                else if (character === quote) {
+                    quote = undefined;
+                }
+                continue;
+            }
+            if (character === '"' || character === "'") {
+                quote = character;
+                continue;
+            }
+            if (character === "$" && source[index + 1] === "{" && !isEscaped(source, index)) {
+                nesting += 1;
+                index += 1;
+                continue;
+            }
+            if (character === "}") {
+                nesting -= 1;
+                if (nesting === 0) {
+                    return {
+                        content: source.slice(start + 2, index),
+                        end: index + 1,
+                        offset: start + 2,
+                    };
+                }
+            }
+        }
+        this.#fail("contains an unterminated interpolation expression", start);
+    }
+    #fail(message, offset) {
+        throw new A2uiParseError(`A2UI formatString at ${this.#path} ${message} near offset ${offset}`);
+    }
+}
+function findFirstParenthesis(source) {
+    for (let index = 0; index < source.length; index += 1) {
+        if (source[index] === "(") {
+            return index;
+        }
+    }
+    return -1;
+}
+function findClosingParenthesis(source, open, path) {
+    let depth = 1;
+    let quote;
+    let escaped = false;
+    for (let index = open + 1; index < source.length; index += 1) {
+        const character = source[index];
+        if (quote !== undefined) {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (character === "\\") {
+                escaped = true;
+            }
+            else if (character === quote) {
+                quote = undefined;
+            }
+            continue;
+        }
+        if (character === '"' || character === "'") {
+            quote = character;
+        }
+        else if (character === "(") {
+            depth += 1;
+        }
+        else if (character === ")") {
+            depth -= 1;
+            if (depth === 0) {
+                return index;
+            }
+        }
+    }
+    throw new A2uiParseError(`A2UI formatString at ${path} contains an unclosed function call`);
+}
+function splitTopLevel(source, separator, path) {
+    const segments = [];
+    let start = 0;
+    walkTopLevel(source, path, (character, index, isTopLevel) => {
+        if (isTopLevel && character === separator) {
+            segments.push({ offset: start, value: source.slice(start, index) });
+            start = index + 1;
+        }
+    });
+    segments.push({ offset: start, value: source.slice(start) });
+    return segments;
+}
+function findTopLevelCharacter(source, target, path) {
+    let result = -1;
+    walkTopLevel(source, path, (character, index, isTopLevel) => {
+        if (result === -1 && isTopLevel && character === target) {
+            result = index;
+        }
+    });
+    return result;
+}
+function walkTopLevel(source, path, visit) {
+    let interpolationDepth = 0;
+    let parenthesisDepth = 0;
+    let quote;
+    let escaped = false;
+    for (let index = 0; index < source.length; index += 1) {
+        const character = source[index];
+        if (quote !== undefined) {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (character === "\\") {
+                escaped = true;
+            }
+            else if (character === quote) {
+                quote = undefined;
+            }
+            visit(character, index, false);
+            continue;
+        }
+        if (character === '"' || character === "'") {
+            quote = character;
+            visit(character, index, false);
+            continue;
+        }
+        if (character === "$" && source[index + 1] === "{") {
+            interpolationDepth += 1;
+            visit(character, index, false);
+            index += 1;
+            continue;
+        }
+        if (character === "}" && interpolationDepth > 0) {
+            interpolationDepth -= 1;
+            visit(character, index, false);
+            continue;
+        }
+        if (character === "(" && interpolationDepth === 0) {
+            parenthesisDepth += 1;
+        }
+        else if (character === ")" && interpolationDepth === 0) {
+            parenthesisDepth -= 1;
+            if (parenthesisDepth < 0) {
+                throw new A2uiParseError(`A2UI formatString at ${path} contains an unmatched ")"`);
+            }
+        }
+        visit(character, index, interpolationDepth === 0 && parenthesisDepth === 0);
+    }
+    if (quote !== undefined || interpolationDepth !== 0 || parenthesisDepth !== 0) {
+        throw new A2uiParseError(`A2UI formatString at ${path} contains unbalanced argument syntax`);
+    }
+}
+function parseQuotedLiteral(source, path, offset) {
+    const quote = source[0];
+    let result = "";
+    for (let index = 1; index < source.length; index += 1) {
+        const character = source[index];
+        if (character === quote) {
+            if (source.slice(index + 1).trim().length !== 0) {
+                throw new A2uiParseError(`A2UI formatString at ${path} contains trailing quoted-literal content near offset ${offset}`);
+            }
+            return result;
+        }
+        if (character.charCodeAt(0) < 0x20) {
+            throw new A2uiParseError(`A2UI formatString at ${path} contains a control character near offset ${offset + index}`);
+        }
+        if (character !== "\\") {
+            result += character;
+            continue;
+        }
+        const escaped = source[index + 1];
+        if (escaped === undefined) {
+            break;
+        }
+        index += 1;
+        switch (escaped) {
+            case "\\":
+            case "/":
+                result += escaped;
+                break;
+            case '"':
+                result += '"';
+                break;
+            case "'":
+                result += "'";
+                break;
+            case "b":
+                result += "\b";
+                break;
+            case "f":
+                result += "\f";
+                break;
+            case "n":
+                result += "\n";
+                break;
+            case "r":
+                result += "\r";
+                break;
+            case "t":
+                result += "\t";
+                break;
+            case "u": {
+                const digits = source.slice(index + 1, index + 5);
+                if (!/^[0-9a-fA-F]{4}$/.test(digits)) {
+                    throw new A2uiParseError(`A2UI formatString at ${path} contains an invalid Unicode escape near offset ${offset + index}`);
+                }
+                result += String.fromCharCode(Number.parseInt(digits, 16));
+                index += 4;
+                break;
+            }
+            default:
+                throw new A2uiParseError(`A2UI formatString at ${path} contains unsupported escape ${JSON.stringify(`\\${escaped}`)} near offset ${offset + index}`);
+        }
+    }
+    throw new A2uiParseError(`A2UI formatString at ${path} contains an unterminated quoted literal near offset ${offset}`);
+}
+function isFunctionIdentifier(value) {
+    return value === "@index" || IDENTIFIER.test(value);
+}
+function isEscaped(source, index) {
+    let backslashes = 0;
+    for (let cursor = index - 1; cursor >= 0 && source[cursor] === "\\"; cursor -= 1) {
+        backslashes += 1;
+    }
+    return backslashes % 2 === 1;
+}
+function defineJsonProperty(object, key, value) {
+    Object.defineProperty(object, key, {
+        configurable: true,
+        enumerable: true,
+        value,
+        writable: true,
+    });
+}
+//# sourceMappingURL=format-string.js.map

package/dist/v1/format-string.js.map

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

package/dist/v1/index.d.ts

@@ -0,0 +1,9 @@
+export { A2UI_V1_MAX_COMPONENTS, A2UI_V1_MAX_ENVELOPES, A2UI_V1_MAX_SURFACES, A2UI_V1_MAX_SOURCE_LENGTH, A2UI_V1_PROTOCOL_VERSION, } from "./types.js";
+export type { A2uiV1Component, A2uiV1CreateSurfaceEnvelope, A2uiV1DeleteSurfaceEnvelope, A2uiV1Envelope, A2uiV1EnvelopeKind, A2uiV1SurfaceState, A2uiV1UpdateComponentsEnvelope, A2uiV1UpdateDataModelEnvelope, } from "./types.js";
+export { parseA2uiV1Envelope, parseA2uiV1Jsonl } from "./parse.js";
+export { A2uiSurfaceStore } from "./store.js";
+export { resolveA2uiV1JsonlFromToolResult } from "./resolve.js";
+export type { ResolvedA2uiV1JsonlResource } from "./resolve.js";
+export { A2UI_V1_BASIC_CATALOG_ID, A2UI_V1_BASIC_COMPONENT_NAMES, A2UI_V1_BASIC_FUNCTION_NAMES, A2UI_V1_SYSTEM_FUNCTION_NAMES, createA2uiV1BasicCatalogPolicy, validateA2uiV1SurfaceState, } from "./validate.js";
+export type { A2uiV1BasicCatalogPolicyOptions, A2uiV1SurfaceValidationPolicy } from "./validate.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,EACf,2BAA2B,EAC3B,2BAA2B,EAC3B,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC"}

package/dist/v1/index.js

@@ -0,0 +1,6 @@
+export { A2UI_V1_MAX_COMPONENTS, A2UI_V1_MAX_ENVELOPES, A2UI_V1_MAX_SURFACES, A2UI_V1_MAX_SOURCE_LENGTH, A2UI_V1_PROTOCOL_VERSION, } from "./types.js";
+export { parseA2uiV1Envelope, parseA2uiV1Jsonl } from "./parse.js";
+export { A2uiSurfaceStore } from "./store.js";
+export { resolveA2uiV1JsonlFromToolResult } from "./resolve.js";
+export { A2UI_V1_BASIC_CATALOG_ID, A2UI_V1_BASIC_COMPONENT_NAMES, A2UI_V1_BASIC_FUNCTION_NAMES, A2UI_V1_SYSTEM_FUNCTION_NAMES, createA2uiV1BasicCatalogPolicy, validateA2uiV1SurfaceState, } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/v1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAWpB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,eAAe,CAAC"}

package/dist/v1/parse.d.ts

@@ -0,0 +1,12 @@
+import type { A2uiV1Envelope } from "./types.js";
+/**
+ * Validates one official A2UI v1.0 agent-to-renderer lifecycle envelope.
+ * Function-call envelopes are rejected in this milestone.
+ */
+export declare function parseA2uiV1Envelope(input: string | unknown): A2uiV1Envelope;
+/**
+ * Parses a UTF-8 JSONL batch of agent-to-renderer envelopes.
+ * Empty lines are skipped. Any invalid line rejects the entire batch.
+ */
+export declare function parseA2uiV1Jsonl(text: string): readonly A2uiV1Envelope[];
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/v1/parse.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,YAAY,CAAC;AAgBrE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,cAAc,CA0D3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,CAiCxE"}

package/dist/v1/parse.js

@@ -0,0 +1,96 @@
+import { parseJsonValue } from "@mcp-native/core";
+import { A2uiParseError } from "../errors.js";
+import { formatAjvErrors, getA2uiV1EnvelopeValidator } from "./schemas.js";
+import { A2UI_V1_MAX_ENVELOPES, A2UI_V1_MAX_SOURCE_LENGTH, A2UI_V1_PROTOCOL_VERSION, } from "./types.js";
+const LIFECYCLE_KEYS = [
+    "createSurface",
+    "updateComponents",
+    "updateDataModel",
+    "deleteSurface",
+];
+const UNSUPPORTED_KEYS = ["callRendererFunction", "agentFunctionResponse"];
+/**
+ * Validates one official A2UI v1.0 agent-to-renderer lifecycle envelope.
+ * Function-call envelopes are rejected in this milestone.
+ */
+export function parseA2uiV1Envelope(input) {
+    let value = input;
+    if (typeof input === "string") {
+        if (input.length > A2UI_V1_MAX_SOURCE_LENGTH) {
+            throw new A2uiParseError(`A2UI v1 envelope exceeds maximum length of ${A2UI_V1_MAX_SOURCE_LENGTH}`);
+        }
+        try {
+            value = JSON.parse(input);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "unknown JSON error";
+            throw new A2uiParseError(`Invalid JSON: ${message}`, { cause: error });
+        }
+    }
+    let reconstructed;
+    try {
+        reconstructed = parseJsonValue(value, "envelope");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Invalid JSON envelope";
+        throw new A2uiParseError(message, { cause: error });
+    }
+    if (reconstructed === null || typeof reconstructed !== "object" || Array.isArray(reconstructed)) {
+        throw new A2uiParseError("Expected an object at envelope");
+    }
+    const envelopeObject = reconstructed;
+    const keys = Object.keys(envelopeObject).filter((key) => key !== "version");
+    for (const key of UNSUPPORTED_KEYS) {
+        if (Object.hasOwn(envelopeObject, key)) {
+            throw new A2uiParseError(`Unsupported A2UI v1 envelope message ${JSON.stringify(key)}; only lifecycle messages are implemented`);
+        }
+    }
+    if (keys.length !== 1 || !isLifecycleKey(keys[0])) {
+        throw new A2uiParseError("Expected exactly one of createSurface, updateComponents, updateDataModel, or deleteSurface");
+    }
+    if (envelopeObject.version !== A2UI_V1_PROTOCOL_VERSION) {
+        throw new A2uiParseError(`Unsupported A2UI protocol version: ${JSON.stringify(envelopeObject.version)}`);
+    }
+    const validate = getA2uiV1EnvelopeValidator();
+    if (!validate(envelopeObject)) {
+        throw new A2uiParseError(`A2UI v1 schema validation failed: ${formatAjvErrors(validate)}`);
+    }
+    return envelopeObject;
+}
+/**
+ * Parses a UTF-8 JSONL batch of agent-to-renderer envelopes.
+ * Empty lines are skipped. Any invalid line rejects the entire batch.
+ */
+export function parseA2uiV1Jsonl(text) {
+    if (typeof text !== "string") {
+        throw new A2uiParseError("Expected a string JSONL body");
+    }
+    if (text.length > A2UI_V1_MAX_SOURCE_LENGTH) {
+        throw new A2uiParseError(`A2UI v1 JSONL source exceeds maximum length of ${A2UI_V1_MAX_SOURCE_LENGTH}`);
+    }
+    const envelopes = [];
+    const lines = text.split(/\r?\n/);
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index];
+        if (line === undefined || line.trim().length === 0) {
+            continue;
+        }
+        if (envelopes.length >= A2UI_V1_MAX_ENVELOPES) {
+            throw new A2uiParseError(`A2UI v1 JSONL exceeds maximum of ${A2UI_V1_MAX_ENVELOPES} envelopes`);
+        }
+        try {
+            envelopes.push(parseA2uiV1Envelope(line));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Invalid envelope";
+            throw new A2uiParseError(`Invalid A2UI v1 JSONL at line ${index + 1}: ${message}`, {
+                cause: error,
+            });
+        }
+    }
+    return envelopes;
+}
+function isLifecycleKey(value) {
+    return value !== undefined && LIFECYCLE_KEYS.includes(value);
+}
+//# sourceMappingURL=parse.js.map

package/dist/v1/parse.js.map

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

package/dist/v1/resolve.d.ts

@@ -0,0 +1,19 @@
+import type { McpToolCallResult } from "@mcp-native/core";
+import type { A2uiMcpBindingNegotiation } from "../binding.js";
+import { A2UI_MIME_TYPE, type A2uiResourceReader } from "../mime.js";
+import type { A2uiV1Envelope } from "./types.js";
+export interface ResolvedA2uiV1JsonlResource {
+    readonly uri: string;
+    readonly mimeType: typeof A2UI_MIME_TYPE;
+    readonly envelopes: readonly A2uiV1Envelope[];
+}
+/**
+ * Resolves the single A2UI resource link in a successful tool result and parses
+ * its text body as an ordered v1 JSONL envelope batch. Does not invoke the
+ * custom `0.1` surface parser.
+ *
+ * Callers must only use this after mutual binding negotiation; MIME type alone
+ * does not grant the transport.
+ */
+export declare function resolveA2uiV1JsonlFromToolResult(reader: A2uiResourceReader, toolResult: McpToolCallResult, negotiation: A2uiMcpBindingNegotiation): Promise<ResolvedA2uiV1JsonlResource>;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/v1/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqC,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG7F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,cAAc,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,kBAAkB,EAC1B,UAAU,EAAE,iBAAiB,EAC7B,WAAW,EAAE,yBAAyB,GACrC,OAAO,CAAC,2BAA2B,CAAC,CAyCtC"}