dsh-a2a-server 0.1.0

package/lib/protocol/normalize.js

@@ -0,0 +1,278 @@
+/**
+ * Dialect normalization between A2A v0.3.0 and v1.0.
+ *
+ * Inbound is permissive, outbound is strict: a request in either spelling is
+ * parsed into the internal v0.3 shape, and the response is rendered back in the
+ * dialect that request declared. Nothing mixes the two spellings in one reply.
+ *
+ * @module dsh-a2a/protocol/normalize
+ */
+import { A2AContextId, A2ATaskId } from "./brand.js";
+/**
+ * Every method spelling this server answers.
+ *
+ * v0.3 is the mainline; the v1.0 PascalCase names are accepted so a peer built
+ * against the newer spec interoperates without a shim on its side.
+ */
+const METHODS = new Map([
+    // — v0.3.0 mainline —
+    ['message/send', { operation: 'send', dialect: 'v0.3' }],
+    ['message/stream', { operation: 'stream', dialect: 'v0.3' }],
+    ['tasks/get', { operation: 'get', dialect: 'v0.3' }],
+    ['tasks/cancel', { operation: 'cancel', dialect: 'v0.3' }],
+    ['tasks/resubscribe', { operation: 'resubscribe', dialect: 'v0.3' }],
+    ['tasks/pushNotificationConfig/set', { operation: 'push_set', dialect: 'v0.3' }],
+    ['tasks/pushNotificationConfig/get', { operation: 'push_get', dialect: 'v0.3' }],
+    ['tasks/pushNotificationConfig/list', { operation: 'push_list', dialect: 'v0.3' }],
+    ['tasks/pushNotificationConfig/delete', { operation: 'push_delete', dialect: 'v0.3' }],
+    // — v1.0 —
+    ['SendMessage', { operation: 'send', dialect: 'v1.0' }],
+    ['SendStreamingMessage', { operation: 'stream', dialect: 'v1.0' }],
+    ['GetTask', { operation: 'get', dialect: 'v1.0' }],
+    ['CancelTask', { operation: 'cancel', dialect: 'v1.0' }],
+    ['SubscribeToTask', { operation: 'resubscribe', dialect: 'v1.0' }],
+    ['CreateTaskPushNotificationConfig', { operation: 'push_set', dialect: 'v1.0' }],
+    ['GetTaskPushNotificationConfig', { operation: 'push_get', dialect: 'v1.0' }],
+    ['ListTaskPushNotificationConfigs', { operation: 'push_list', dialect: 'v1.0' }],
+    ['DeleteTaskPushNotificationConfig', { operation: 'push_delete', dialect: 'v1.0' }],
+    // — pre-0.3 aliases seen in the wild —
+    ['tasks/pushNotification/set', { operation: 'push_set', dialect: 'v0.3' }],
+]);
+/**
+ * Resolve a method name to its operation and implied dialect.
+ * @param method - the raw `method` string from the request.
+ * @returns the entry, or undefined for an unknown method.
+ */
+export function resolveMethod(method) {
+    return METHODS.get(method);
+}
+/** v1.0 spells task states in SCREAMING_SNAKE_CASE. */
+const STATE_TO_V1 = {
+    'submitted': 'TASK_STATE_SUBMITTED',
+    'working': 'TASK_STATE_WORKING',
+    'input-required': 'TASK_STATE_INPUT_REQUIRED',
+    'auth-required': 'TASK_STATE_AUTH_REQUIRED',
+    'completed': 'TASK_STATE_COMPLETED',
+    'canceled': 'TASK_STATE_CANCELED',
+    'failed': 'TASK_STATE_FAILED',
+    'rejected': 'TASK_STATE_REJECTED',
+};
+const ROLE_TO_V1 = {
+    user: 'ROLE_USER',
+    agent: 'ROLE_AGENT',
+};
+/**
+ * Read a `Part` written in any of the three known spellings.
+ *
+ * v0.3 discriminates on `kind`, v1.0 on member presence, and pre-0.3 peers used
+ * `type`. Unknown shapes yield undefined rather than throwing, so one odd part
+ * cannot fail a request whose other parts are usable.
+ * @param raw - one element of a `parts` array.
+ * @returns the normalized part, or undefined when unrecognizable.
+ */
+export function parsePart(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return undefined;
+    const part = raw;
+    const tag = typeof part['kind'] === 'string'
+        ? part['kind']
+        : typeof part['type'] === 'string' ? part['type'] : undefined;
+    if (tag === 'text') {
+        return typeof part['text'] === 'string' ? { kind: 'text', text: part['text'] } : undefined;
+    }
+    if (tag === 'data')
+        return { kind: 'data', data: part['data'] };
+    if (tag === 'file')
+        return parseFilePart(part);
+    if (tag !== undefined)
+        return undefined;
+    // Untagged: v1.0 discriminates a part by which member is present. Order
+    // matters only in that each probe must be specific enough not to claim
+    // another variant's shape.
+    if (typeof part['text'] === 'string')
+        return { kind: 'text', text: part['text'] };
+    const file = parseFilePart(part);
+    if (file !== undefined)
+        return file;
+    if ('data' in part)
+        return { kind: 'data', data: part['data'] };
+    return undefined;
+}
+/**
+ * Read a file part in either the v0.3 nested or the v1.0 flattened spelling.
+ * @param part - the raw part object.
+ * @returns the normalized file part, or undefined when no file member is present.
+ */
+function parseFilePart(part) {
+    const nested = part['file'];
+    if (nested !== null && typeof nested === 'object') {
+        return { kind: 'file', file: nested };
+    }
+    const uri = part['url'] ?? part['uri'];
+    const bytes = part['raw'] ?? part['bytes'];
+    if (typeof uri !== 'string' && typeof bytes !== 'string')
+        return undefined;
+    return {
+        kind: 'file',
+        file: {
+            ...typeof uri === 'string' ? { uri } : {},
+            ...typeof bytes === 'string' ? { bytes } : {},
+            ...typeof part['filename'] === 'string' ? { name: part['filename'] } : {},
+            ...typeof part['name'] === 'string' ? { name: part['name'] } : {},
+            ...typeof part['mediaType'] === 'string' ? { mimeType: part['mediaType'] } : {},
+            ...typeof part['mimeType'] === 'string' ? { mimeType: part['mimeType'] } : {},
+        },
+    };
+}
+/**
+ * Render every part as text the model can read.
+ *
+ * File and data parts become bracketed references rather than being dropped, so
+ * the agent knows something was attached and can ask about it. This is the same
+ * flattening `dsh-acp` applies to baseline resource links.
+ * @param parts - normalized parts, in order.
+ * @returns the joined text, empty when nothing rendered.
+ */
+export function partsToText(parts) {
+    const chunks = [];
+    for (const part of parts) {
+        if (part.kind === 'text') {
+            if (part.text.length > 0)
+                chunks.push(part.text);
+        }
+        else if (part.kind === 'file') {
+            const name = part.file.name ?? part.file.uri ?? 'unnamed';
+            const type = part.file.mimeType === undefined ? '' : ` type=${part.file.mimeType}`;
+            chunks.push(`[file name=${name}${type}]`);
+        }
+        else {
+            chunks.push(`[data ${JSON.stringify(part.data)}]`);
+        }
+    }
+    return chunks.join('\n');
+}
+/**
+ * Parse `message/send` and `message/stream` parameters from either dialect.
+ * @param raw - the request's `params` value.
+ * @returns the normalized parameters, or undefined when the shape is unusable.
+ */
+export function parseSendParams(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return undefined;
+    const params = raw;
+    const rawMessage = params['message'];
+    if (rawMessage === null || typeof rawMessage !== 'object')
+        return undefined;
+    const message = rawMessage;
+    const rawParts = message['parts'];
+    const parts = [];
+    if (Array.isArray(rawParts)) {
+        for (const item of rawParts) {
+            const part = parsePart(item);
+            if (part !== undefined)
+                parts.push(part);
+        }
+    }
+    // v0.3 allows contextId at the top level too; the message wins when both appear.
+    const contextId = firstString(message['contextId'], params['contextId']);
+    const taskId = firstString(message['taskId'], params['taskId']);
+    const normalized = {
+        kind: 'message',
+        messageId: firstString(message['messageId']) ?? '',
+        role: message['role'] === 'ROLE_AGENT' || message['role'] === 'agent' ? 'agent' : 'user',
+        parts,
+        ...contextId === undefined ? {} : { contextId: A2AContextId(contextId) },
+        ...taskId === undefined ? {} : { taskId: A2ATaskId(taskId) },
+    };
+    const configuration = params['configuration'];
+    if (configuration !== null && typeof configuration === 'object') {
+        return {
+            message: normalized,
+            configuration: configuration,
+        };
+    }
+    return { message: normalized };
+}
+/**
+ * Return the first defined non-empty string among the candidates.
+ * @param values - candidate values in precedence order.
+ * @returns the winning string, or undefined.
+ */
+function firstString(...values) {
+    for (const value of values) {
+        if (typeof value === 'string' && value.length > 0)
+            return value;
+    }
+    return undefined;
+}
+/**
+ * Render a task in the requested dialect.
+ * @param task - the internal v0.3-shaped task.
+ * @param dialect - the dialect the peer spoke.
+ * @returns the wire object to serialize.
+ */
+export function renderTask(task, dialect) {
+    if (dialect === 'v0.3')
+        return task;
+    return {
+        ...task,
+        status: renderStatusV1(task.status),
+        ...task.history === undefined ? {} : { history: task.history.map(renderMessageV1) },
+    };
+}
+/**
+ * Render a status-update stream event in the requested dialect.
+ * @param event - the internal event.
+ * @param dialect - the dialect the peer spoke.
+ * @returns the wire object to serialize.
+ */
+export function renderStatusUpdate(event, dialect) {
+    if (dialect === 'v0.3')
+        return event;
+    return { statusUpdate: { ...event, status: renderStatusV1(event.status) } };
+}
+/**
+ * Render an artifact-update stream event in the requested dialect.
+ * @param event - the internal event.
+ * @param dialect - the dialect the peer spoke.
+ * @returns the wire object to serialize.
+ */
+export function renderArtifactUpdate(event, dialect) {
+    return dialect === 'v0.3' ? event : { artifactUpdate: event };
+}
+/**
+ * Render a task status with v1.0 enum spellings.
+ * @param status - the internal status.
+ * @returns the v1.0-shaped status.
+ */
+function renderStatusV1(status) {
+    return {
+        ...status,
+        state: STATE_TO_V1[status.state],
+        ...status.message === undefined ? {} : { message: renderMessageV1(status.message) },
+    };
+}
+/**
+ * Render a message with v1.0 enum spellings and member-presence parts.
+ * @param message - the internal message.
+ * @returns the v1.0-shaped message.
+ */
+function renderMessageV1(message) {
+    return {
+        ...message,
+        role: ROLE_TO_V1[message.role],
+        parts: message.parts.map((part) => {
+            if (part.kind === 'text')
+                return { text: part.text };
+            if (part.kind === 'data')
+                return { data: part.data };
+            return {
+                ...part.file.uri === undefined ? {} : { url: part.file.uri },
+                ...part.file.bytes === undefined ? {} : { raw: part.file.bytes },
+                ...part.file.name === undefined ? {} : { filename: part.file.name },
+                ...part.file.mimeType === undefined ? {} : { mediaType: part.file.mimeType },
+            };
+        }),
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/lib/protocol/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/protocol/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAgCpD;;;;;GAKG;AACH,MAAM,OAAO,GAAqC,IAAI,GAAG,CAAC;IACxD,sBAAsB;IACtB,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACxD,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC5D,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACpD,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC1D,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACpE,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAChF,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAChF,CAAC,mCAAmC,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClF,CAAC,qCAAqC,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACtF,WAAW;IACX,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACvD,CAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClD,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACxD,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClE,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAChF,CAAC,+BAA+B,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7E,CAAC,iCAAiC,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAChF,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACnF,uCAAuC;IACvC,CAAC,4BAA4B,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;CAC3E,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AAC5B,CAAC;AAED,uDAAuD;AACvD,MAAM,WAAW,GAA2C;IAC1D,WAAW,EAAE,sBAAsB;IACnC,SAAS,EAAE,oBAAoB;IAC/B,gBAAgB,EAAE,2BAA2B;IAC7C,eAAe,EAAE,0BAA0B;IAC3C,WAAW,EAAE,sBAAsB;IACnC,UAAU,EAAE,qBAAqB;IACjC,QAAQ,EAAE,mBAAmB;IAC7B,UAAU,EAAE,qBAAqB;CAClC,CAAA;AAED,MAAM,UAAU,GAAsC;IACpD,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,YAAY;CACpB,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC7D,MAAM,IAAI,GAAG,GAA8B,CAAA;IAC3C,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ;QAC1C,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACd,CAAC,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAE/D,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACnB,OAAO,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAC5F,CAAC;IACD,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAA;IAC/D,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,aAAa,CAAC,IAAI,CAAC,CAAA;IAC9C,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAEvC,wEAAwE;IACxE,uEAAuE;IACvE,2BAA2B;IAC3B,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAA;IACjF,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACnC,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAA;IAC/D,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,IAA6B;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IAC3B,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAsB,EAAE,CAAA;IACvD,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAA;IAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC1E,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE;YACJ,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE;YACzC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;YAC7C,GAAG,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YACzE,GAAG,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YACjE,GAAG,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YAC/E,GAAG,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;SAC9E;KACF,CAAA;AACH,CAAC;AASD;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClD,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,SAAS,CAAA;YACzD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;YAClF,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,GAAG,IAAI,GAAG,CAAC,CAAA;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACpD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC7D,MAAM,MAAM,GAAG,GAA8B,CAAA;IAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;IACpC,IAAI,UAAU,KAAK,IAAI,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC3E,MAAM,OAAO,GAAG,UAAqC,CAAA;IAErD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACjC,MAAM,KAAK,GAAc,EAAE,CAAA;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;YAC5B,IAAI,IAAI,KAAK,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IAED,iFAAiF;IACjF,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;IACxE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;IAE/D,MAAM,UAAU,GAAe;QAC7B,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE;QAClD,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;QACxF,KAAK;QACL,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE;QACxE,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE;KAC7D,CAAA;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAA;IAC7C,IAAI,aAAa,KAAK,IAAI,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QAChE,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,aAAa,EAAE,aAAmE;SACnF,CAAA;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;AAChC,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,GAAG,MAAiB;IACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAA;IACjE,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAa,EAAE,OAAmB;IAC3D,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IACnC,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;QACnC,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE;KACpF,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA+B,EAAE,OAAmB;IACrF,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,KAAK,CAAA;IACpC,OAAO,EAAE,YAAY,EAAE,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,CAAA;AAC7E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAiC,EACjC,OAAmB;IAEnB,OAAO,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,CAAA;AAC/D,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,MAAyB;IAC/C,OAAO;QACL,GAAG,MAAM;QACT,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,GAAG,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;KACpF,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,OAAmB;IAC1C,OAAO;QACL,GAAG,OAAO;QACV,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAChC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAA;YACpD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAA;YACpD,OAAO;gBACL,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC5D,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE;gBAChE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBACnE,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;aAC7E,CAAA;QACH,CAAC,CAAC;KACH,CAAA;AACH,CAAC"}

package/lib/protocol/sse.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Server-Sent Events framing for `message/stream` and `tasks/resubscribe`.
+ *
+ * A2A streams JSON-RPC responses, not bare events: each frame carries the same
+ * envelope the unary methods return, correlated by the original request id.
+ *
+ * @module dsh-a2a/protocol/sse
+ */
+/**
+ * Encode one payload as an SSE `data:` frame.
+ *
+ * Newlines inside the JSON would terminate the frame early, so the payload is
+ * serialized compactly (JSON.stringify emits no raw newlines) and terminated
+ * with the blank line SSE requires.
+ * @param id - the JSON-RPC id of the request this stream answers.
+ * @param payload - the already-dialect-rendered event.
+ * @returns the wire text of one frame.
+ */
+export declare function sseFrame(id: string | number | null, payload: unknown): string;
+//# sourceMappingURL=sse.d.ts.map

package/lib/protocol/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/protocol/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAE7E"}

package/lib/protocol/sse.js

@@ -0,0 +1,23 @@
+/**
+ * Server-Sent Events framing for `message/stream` and `tasks/resubscribe`.
+ *
+ * A2A streams JSON-RPC responses, not bare events: each frame carries the same
+ * envelope the unary methods return, correlated by the original request id.
+ *
+ * @module dsh-a2a/protocol/sse
+ */
+import { jsonRpcResult } from "./jsonrpc.js";
+/**
+ * Encode one payload as an SSE `data:` frame.
+ *
+ * Newlines inside the JSON would terminate the frame early, so the payload is
+ * serialized compactly (JSON.stringify emits no raw newlines) and terminated
+ * with the blank line SSE requires.
+ * @param id - the JSON-RPC id of the request this stream answers.
+ * @param payload - the already-dialect-rendered event.
+ * @returns the wire text of one frame.
+ */
+export function sseFrame(id, payload) {
+    return `data: ${JSON.stringify(jsonRpcResult(id, payload))}\n\n`;
+}
+//# sourceMappingURL=sse.js.map

package/lib/protocol/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/protocol/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,EAA0B,EAAE,OAAgB;IACnE,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,MAAM,CAAA;AAClE,CAAC"}

package/lib/protocol/wire.d.ts

@@ -0,0 +1,164 @@
+/**
+ * A2A wire vocabulary, normalized to the v0.3.0 spelling.
+ *
+ * The server speaks one internal shape. Requests in either dialect are parsed
+ * into these types on the way in ({@link ./normalize.ts}), and responses are
+ * rendered back into the caller's dialect on the way out. No plugin module
+ * outside `protocol/` sees a v1.0 spelling.
+ *
+ * @module dsh-a2a/protocol/wire
+ */
+import type { A2AContextId, A2ATaskId } from './brand.ts';
+/** Task lifecycle state, in the v0.3 JSON spelling. */
+export type A2ATaskState = 'submitted' | 'working' | 'input-required' | 'auth-required' | 'completed' | 'canceled' | 'failed' | 'rejected';
+/** States after which a task accepts no further transition. */
+export declare const TERMINAL_STATES: ReadonlySet<A2ATaskState>;
+/**
+ * Whether a state is terminal.
+ * @param state - the state to test.
+ * @returns true when no further transition is accepted.
+ */
+export declare function isTerminal(state: A2ATaskState): boolean;
+/** Message author, in the v0.3 JSON spelling. */
+export type A2ARole = 'user' | 'agent';
+/** Which spelling a peer used; every response echoes the request's dialect. */
+export type A2ADialect = 'v0.3' | 'v1.0';
+/** A text segment of a message or artifact. */
+export interface A2ATextPart {
+    kind: 'text';
+    text: string;
+}
+/** A file reference or inline payload. */
+export interface A2AFilePart {
+    kind: 'file';
+    file: {
+        name?: string;
+        mimeType?: string;
+        uri?: string;
+        bytes?: string;
+    };
+}
+/** Structured JSON carried beside the text. */
+export interface A2ADataPart {
+    kind: 'data';
+    data: unknown;
+}
+/** Any message or artifact segment. */
+export type A2APart = A2ATextPart | A2AFilePart | A2ADataPart;
+/** One message in a task's history. */
+export interface A2AMessage {
+    kind: 'message';
+    messageId: string;
+    role: A2ARole;
+    parts: A2APart[];
+    taskId?: A2ATaskId;
+    contextId?: A2AContextId;
+    metadata?: Record<string, unknown>;
+}
+/** A named output the agent produced for a task. */
+export interface A2AArtifact {
+    artifactId: string;
+    name?: string;
+    description?: string;
+    parts: A2APart[];
+    metadata?: Record<string, unknown>;
+}
+/** Current state plus the message that explains it. */
+export interface A2ATaskStatus {
+    state: A2ATaskState;
+    message?: A2AMessage;
+    timestamp: string;
+}
+/** The unit of work a peer submits and polls. */
+export interface A2ATask {
+    kind: 'task';
+    id: A2ATaskId;
+    contextId: A2AContextId;
+    status: A2ATaskStatus;
+    history?: A2AMessage[];
+    artifacts?: A2AArtifact[];
+    metadata?: Record<string, unknown>;
+}
+/** A streamed state transition. `final` closes the stream. */
+export interface A2ATaskStatusUpdateEvent {
+    kind: 'status-update';
+    taskId: A2ATaskId;
+    contextId: A2AContextId;
+    status: A2ATaskStatus;
+    final: boolean;
+    metadata?: Record<string, unknown>;
+}
+/** A streamed artifact, optionally appended to an earlier chunk. */
+export interface A2ATaskArtifactUpdateEvent {
+    kind: 'artifact-update';
+    taskId: A2ATaskId;
+    contextId: A2AContextId;
+    artifact: A2AArtifact;
+    append?: boolean;
+    lastChunk?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/** Anything the server may push over an SSE stream. */
+export type A2AStreamEvent = A2ATask | A2AMessage | A2ATaskStatusUpdateEvent | A2ATaskArtifactUpdateEvent;
+/** Webhook registration a peer supplies for terminal-state callbacks. */
+export interface A2APushNotificationConfig {
+    id?: string;
+    url: string;
+    token?: string;
+    authentication?: {
+        schemes: string[];
+        credentials?: string;
+    };
+}
+/** Per-request knobs carried beside the message on `message/send`. */
+export interface A2AMessageSendConfiguration {
+    acceptedOutputModes?: string[];
+    historyLength?: number;
+    pushNotificationConfig?: A2APushNotificationConfig;
+    blocking?: boolean;
+}
+/** Parameters of `message/send` and `message/stream`. */
+export interface A2AMessageSendParams {
+    message: A2AMessage;
+    configuration?: A2AMessageSendConfiguration;
+    metadata?: Record<string, unknown>;
+}
+/** One capability this agent advertises on its card. */
+export interface A2AAgentSkill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    examples?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+}
+/** The public description a peer fetches before talking to us. */
+export interface A2AAgentCard {
+    protocolVersion: string;
+    name: string;
+    description: string;
+    version: string;
+    url: string;
+    preferredTransport: string;
+    supportedInterfaces?: {
+        url: string;
+        protocolBinding: string;
+        protocolVersion: string;
+    }[];
+    provider?: {
+        organization: string;
+        url: string;
+    };
+    capabilities: {
+        streaming: boolean;
+        pushNotifications: boolean;
+        stateTransitionHistory: boolean;
+    };
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+    skills: A2AAgentSkill[];
+    securitySchemes?: Record<string, unknown>;
+    security?: Record<string, string[]>[];
+}
+//# sourceMappingURL=wire.d.ts.map

package/lib/protocol/wire.d.ts.map

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

package/lib/protocol/wire.js

@@ -0,0 +1,26 @@
+/**
+ * A2A wire vocabulary, normalized to the v0.3.0 spelling.
+ *
+ * The server speaks one internal shape. Requests in either dialect are parsed
+ * into these types on the way in ({@link ./normalize.ts}), and responses are
+ * rendered back into the caller's dialect on the way out. No plugin module
+ * outside `protocol/` sees a v1.0 spelling.
+ *
+ * @module dsh-a2a/protocol/wire
+ */
+/** States after which a task accepts no further transition. */
+export const TERMINAL_STATES = new Set([
+    'completed',
+    'canceled',
+    'failed',
+    'rejected',
+]);
+/**
+ * Whether a state is terminal.
+ * @param state - the state to test.
+ * @returns true when no further transition is accepted.
+ */
+export function isTerminal(state) {
+    return TERMINAL_STATES.has(state);
+}
+//# sourceMappingURL=wire.js.map

package/lib/protocol/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../src/protocol/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAA8B,IAAI,GAAG,CAAe;IAC9E,WAAW;IACX,UAAU;IACV,QAAQ;IACR,UAAU;CACX,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAmB;IAC5C,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC"}

package/lib/router.d.ts

@@ -0,0 +1,56 @@
+/**
+ * HTTP + JSON-RPC dispatch.
+ *
+ * Deliberately free of Cordis: everything it needs arrives through
+ * {@link RouterDeps}, so the RPC semantics can be unit-tested without booting a
+ * composition or opening a socket. This is the same separation Hermes reached
+ * for when it made its request handler reachable through `server.adapter`.
+ *
+ * @module dsh-a2a/router
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type A2AAgentCard, type A2AArtifact, type A2ATask, type A2ATaskId, type A2ATaskState } from './protocol/index.ts';
+import type { A2AServerConfig } from './config.ts';
+import type { Activation, ContextRegistry } from './contexts.ts';
+import { type PeerIdentity, type RateLimiter, type TurnTracker } from './security.ts';
+import type { TaskSlot } from './tasks.ts';
+/** Everything the router needs from the plugin body. */
+export interface RouterDeps {
+    config: A2AServerConfig;
+    contexts: ContextRegistry;
+    turns: TurnTracker;
+    rateLimiter: RateLimiter;
+    logger: {
+        warn: (message: string) => void;
+        error: (message: string) => void;
+    };
+    assertOpen: () => void;
+    resolvePeerSecrets: () => Promise<Map<PeerIdentity, string>>;
+    identify: (token: string | undefined, secrets: ReadonlyMap<PeerIdentity, string>) => PeerIdentity | undefined;
+    cardFor: (hostHeader: string | undefined) => A2AAgentCard;
+    createActivation: (peer: PeerIdentity) => Promise<Activation>;
+    submit: (activation: Activation, text: string, peer: PeerIdentity) => Promise<TaskSlot>;
+    cancel: (activation: Activation, slot: TaskSlot) => void;
+    taskSnapshot: (activation: Activation, slot: TaskSlot, state: A2ATaskState, artifacts: A2AArtifact[], stopReason?: string) => A2ATask;
+    /**
+     * Read a settled task back from the durable projection.
+     *
+     * Absent when the composition mounts no projection registry, in which case a
+     * settled task is simply unreadable — the pre-projection behavior.
+     */
+    readProjectedTask?: (activation: Activation, taskId: A2ATaskId) => A2ATask | undefined;
+}
+/** The router surface the plugin body wires into routes and teardown. */
+export interface Router {
+    serveCard: (req: IncomingMessage, res: ServerResponse) => void;
+    serveRpc: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    /** Send every open stream its terminal frame, then end it. */
+    closeStreams: () => void;
+}
+/**
+ * Build the router.
+ * @param deps - the injected plugin capabilities.
+ * @returns the route handlers plus stream teardown.
+ */
+export declare function createRouter(deps: RouterDeps): Router;
+//# sourceMappingURL=router.d.ts.map

package/lib/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EAoBL,KAAK,YAAY,EACjB,KAAK,WAAW,EAEhB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAChE,OAAO,EAAiC,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AACpH,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,YAAY,CAAA;AAK1D,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,eAAe,CAAA;IACvB,QAAQ,EAAE,eAAe,CAAA;IACzB,KAAK,EAAE,WAAW,CAAA;IAClB,WAAW,EAAE,WAAW,CAAA;IACxB,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAA;IAC7E,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,kBAAkB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5D,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,YAAY,GAAG,SAAS,CAAA;IAC7G,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,KAAK,YAAY,CAAA;IACzD,gBAAgB,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC7D,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IACvF,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IACxD,YAAY,EAAE,CACZ,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,WAAW,EAAE,EACxB,UAAU,CAAC,EAAE,MAAM,KAChB,OAAO,CAAA;IACZ;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,GAAG,SAAS,CAAA;CACvF;AAWD,yEAAyE;AACzE,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAA;IAC9D,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtE,8DAA8D;IAC9D,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA0brD"}