@hanphone/dsh-a2a 0.1.0

package/lib/types/server/a2a-server.js

@@ -0,0 +1,397 @@
+/**
+ * The inbound A2A server: JSON-RPC dispatch, the task lifecycle, and SSE
+ * streaming. Transport-agnostic — `handle` / `handleStream` take a structural
+ * request and return bytes; the HTTP binding lives in routes.ts.
+ * @module dsh-a2a/server/a2a-server
+ */
+import { A2A_ERROR_CODES, A2A_METHODS, Role, TaskState, isTerminal, partsToText, } from "../protocol.js";
+import { methodNotFound, parseRpc, rpcError, rpcSuccess } from "../jsonrpc.js";
+/** A2A JSON-RPC / SSE server over a structural request. */
+export class A2AServer {
+    opts;
+    card;
+    listeners = new Set();
+    waiters = new Map();
+    running = new Map();
+    constructor(opts) {
+        this.opts = opts;
+        this.card = opts.card;
+    }
+    /**
+     * Abort a running task by control path (facade /a2a task cancel): abort the
+     * executor's signal, settle the task CANCELED, and wake stream waiters.
+     * @returns false when the task is unknown or already terminal.
+     */
+    abort(taskId) {
+        const record = this.opts.store.get(taskId);
+        if (record === undefined || isTerminal(record.state))
+            return false;
+        this.running.get(taskId)?.abort();
+        this.opts.store.setState(taskId, TaskState.CANCELED, { code: 'canceled', text: 'Task canceled' });
+        this.settle(taskId);
+        return true;
+    }
+    /** True when the request carries the configured bearer token. */
+    authorized(req) {
+        const token = this.opts.authToken;
+        if (!token)
+            return true;
+        const header = req.headers?.['authorization'] ?? '';
+        const match = /^Bearer\s+(.+)$/i.exec(header.trim());
+        return match !== null && match[1] === token;
+    }
+    /** Route one inbound HTTP request (GET card, POST JSON-RPC). */
+    async handle(req, body) {
+        const path = (req.url ?? '').split('?')[0] ?? '';
+        if (req.method === 'GET' && path === '/.well-known/agent-card.json') {
+            return { status: 200, contentType: 'application/json', body: JSON.stringify(this.card) };
+        }
+        if (req.method !== 'POST' || path !== endpointOf(this.card)) {
+            return { status: 404, contentType: 'text/plain', body: 'Not Found' };
+        }
+        if (!this.authorized(req)) {
+            return {
+                status: 401,
+                contentType: 'application/json',
+                body: JSON.stringify(rpcError(null, A2A_ERROR_CODES.UNAUTHORIZED, 'Unauthorized')),
+                headers: { 'WWW-Authenticate': 'Bearer' },
+            };
+        }
+        const rpc = parseRpc(body);
+        if (rpc === undefined) {
+            return { status: 200, contentType: 'application/json', body: JSON.stringify(rpcError(null, A2A_ERROR_CODES.INVALID_REQUEST, 'Invalid JSON-RPC request')) };
+        }
+        try {
+            const result = await this.dispatch(rpc);
+            const source = sourceOf(req);
+            this.opts.onInbound?.({
+                method: rpc.method,
+                ...(source !== undefined ? { source } : {}),
+                taskIds: extractTaskIds(result),
+                streaming: false,
+            });
+            return { status: 200, contentType: 'application/json', body: JSON.stringify(rpcSuccess(rpc.id, result)) };
+        }
+        catch (err) {
+            const e = err;
+            return {
+                status: 200,
+                contentType: 'application/json',
+                body: JSON.stringify(rpcError(rpc.id, typeof e.code === 'number' ? e.code : A2A_ERROR_CODES.INTERNAL_ERROR, e.message ?? String(err), e.data)),
+            };
+        }
+    }
+    /**
+     * Route one SSE request (SendStreamingMessage / SubscribeToTask). Frames are
+     * pushed to `onEvent` as they happen; the caller must have checked
+     * `authorized()` before writing 200 headers.
+     */
+    async handleStream(req, body, onEvent) {
+        if (req.method !== 'POST') {
+            onEvent(`event: error\ndata: ${JSON.stringify({ code: 404, message: 'Not Found' })}\n\n`);
+            return { status: 200 };
+        }
+        if (!this.authorized(req)) {
+            return { status: 401, headers: { 'WWW-Authenticate': 'Bearer' } };
+        }
+        const rpc = parseRpc(body);
+        if (rpc === undefined) {
+            onEvent(`event: error\ndata: ${JSON.stringify({ code: A2A_ERROR_CODES.INVALID_REQUEST, message: 'Invalid JSON-RPC request' })}\n\n`);
+            return { status: 200 };
+        }
+        if (rpc.method !== A2A_METHODS.sendStreamingMessage && rpc.method !== A2A_METHODS.subscribeToTask) {
+            onEvent(`event: error\ndata: ${JSON.stringify(methodNotFound(rpc.method ?? ''))}\n\n`);
+            return { status: 200 };
+        }
+        const params = (rpc.params ?? {});
+        let record;
+        if (rpc.method === A2A_METHODS.sendStreamingMessage) {
+            if (params.message === undefined) {
+                onEvent(`event: error\ndata: ${JSON.stringify({ code: A2A_ERROR_CODES.INVALID_PARAMS, message: 'Missing message' })}\n\n`);
+                return { status: 200 };
+            }
+            const gateOutcome = await this.opts.gate(gateInputFrom(params.message, this.remotePeerOf(req)));
+            if (!gateOutcome.ok) {
+                onEvent(`event: error\ndata: ${JSON.stringify({ code: -32000, message: gateOutcome.reason })}\n\n`);
+                return { status: 200 };
+            }
+            record = this.ensureTask(params.message, this.remotePeerOf(req));
+            this.noteInbound(req, rpc.method, [record.taskId], true);
+            // Kick off execution; frames flow through the shared listener set.
+            void this.runTask(record);
+        }
+        else {
+            const id = params.id;
+            if (id === undefined) {
+                onEvent(`event: error\ndata: ${JSON.stringify({ code: A2A_ERROR_CODES.INVALID_PARAMS, message: 'Missing task id' })}\n\n`);
+                return { status: 200 };
+            }
+            record = this.opts.store.get(id);
+            this.noteInbound(req, rpc.method, id ? [id] : [], true);
+            if (record === undefined) {
+                onEvent(`event: error\ndata: ${JSON.stringify({ code: A2A_ERROR_CODES.TASK_NOT_FOUND, message: `Task ${id} not found` })}\n\n`);
+                return { status: 200 };
+            }
+        }
+        const sub = (frame) => onEvent(`data: ${JSON.stringify(frame)}\n\n`);
+        this.listeners.add(sub);
+        try {
+            // Catch the subscriber up: the initial WORKING frame may have been
+            // emitted before this subscription landed, so always deliver the
+            // current status first (a settled task streams its terminal state).
+            const current = this.opts.store.get(record.taskId);
+            if (current !== undefined) {
+                sub({ statusUpdate: { taskId: record.taskId, contextId: record.contextId, status: statusOf(current) } });
+            }
+            await this.waitTerminal(record.taskId);
+            const finalRecord = this.opts.store.get(record.taskId);
+            if (finalRecord !== undefined)
+                onEvent(`data: ${JSON.stringify({ task: toTask(finalRecord) })}\n\n`);
+        }
+        finally {
+            this.listeners.delete(sub);
+        }
+        return { status: 200 };
+    }
+    /** Dispatch one JSON-RPC request; throws {code, message} on errors. */
+    async dispatch(rpc) {
+        const method = rpc.method;
+        const params = (rpc.params ?? {});
+        switch (method) {
+            case A2A_METHODS.sendMessage: {
+                const message = params['message'];
+                if (message === undefined)
+                    throw rpcFault(A2A_ERROR_CODES.INVALID_PARAMS, 'Missing message');
+                const gateOutcome = await this.opts.gate(gateInputFrom(message, null));
+                if (!gateOutcome.ok)
+                    throw rpcFault(A2A_ERROR_CODES.INVALID_PARAMS, gateOutcome.reason);
+                const record = this.ensureTask(message, null);
+                this.noteInbound({ method }, method, [record.taskId], false);
+                await this.runTask(record);
+                const settled = this.opts.store.get(record.taskId);
+                return toTask(settled ?? record);
+            }
+            case A2A_METHODS.getTask: {
+                const id = params['id'];
+                if (id === undefined)
+                    throw rpcFault(A2A_ERROR_CODES.INVALID_PARAMS, 'Missing task id');
+                const record = this.opts.store.get(id);
+                if (record === undefined)
+                    throw rpcFault(A2A_ERROR_CODES.TASK_NOT_FOUND, `Task ${id} not found`);
+                return toTask(record);
+            }
+            case A2A_METHODS.listTasks: {
+                return this.opts.store.list().map(toTask);
+            }
+            case A2A_METHODS.cancelTask: {
+                const id = params['id'];
+                if (id === undefined)
+                    throw rpcFault(A2A_ERROR_CODES.INVALID_PARAMS, 'Missing task id');
+                const record = this.opts.store.get(id);
+                if (record === undefined)
+                    throw rpcFault(A2A_ERROR_CODES.TASK_NOT_FOUND, `Task ${id} not found`);
+                if (isTerminal(record.state))
+                    throw rpcFault(A2A_ERROR_CODES.TASK_CANCEL_NOT_ALLOWED, `Task ${id} already in terminal state ${record.state}`);
+                const controller = this.running.get(id);
+                controller?.abort();
+                this.opts.store.setState(id, TaskState.CANCELED, { code: 'canceled', text: 'Task canceled by caller' });
+                this.settle(id);
+                return toTask(this.opts.store.get(id));
+            }
+            case A2A_METHODS.getExtendedAgentCard:
+                return this.card;
+            default:
+                throw rpcFault(A2A_ERROR_CODES.METHOD_NOT_FOUND, `Unknown method ${method}`);
+        }
+    }
+    /** Create (or continue) the task record for one message. */
+    ensureTask(message, remotePeerId) {
+        if (message.taskId !== undefined) {
+            const existing = this.opts.store.get(message.taskId);
+            if (existing !== undefined) {
+                const created = this.opts.store.create({
+                    contextId: existing.contextId,
+                    skill: existing.skill,
+                    parts: message.parts,
+                    remotePeerId,
+                });
+                return created;
+            }
+        }
+        const contextId = message.contextId ?? crypto.randomUUID();
+        const skill = message.metadata?.['skill'] ?? 'chat';
+        return this.opts.store.create({ contextId, skill, parts: message.parts, remotePeerId });
+    }
+    /** Run one task to a terminal state, emitting status/artifact frames. */
+    async runTask(record) {
+        const controller = new AbortController();
+        this.running.set(record.taskId, controller);
+        this.opts.store.setState(record.taskId, TaskState.WORKING);
+        this.emit({ statusUpdate: { taskId: record.taskId, contextId: record.contextId, status: statusOf(this.opts.store.get(record.taskId)) } });
+        const onEvent = this.eventSink(record.taskId, record.contextId);
+        try {
+            const executor = this.opts.executors.resolve(record.skill);
+            const output = await executor.execute({
+                taskId: record.taskId,
+                contextId: record.contextId,
+                skill: record.skill,
+                prompt: partsToText(record.parts),
+                signal: controller.signal,
+            }, { onEvent });
+            const settled = this.opts.store.get(record.taskId);
+            if (settled !== undefined && settled.state === TaskState.CANCELED) {
+                // Cancel won: keep CANCELED, do not clobber with a completion.
+            }
+            else {
+                this.opts.store.appendArtifact(record.taskId, { artifactId: 'result', parts: output.parts, lastChunk: true });
+                this.opts.store.setState(record.taskId, TaskState.COMPLETED);
+            }
+        }
+        catch (err) {
+            const settled = this.opts.store.get(record.taskId);
+            if (settled !== undefined && settled.state === TaskState.CANCELED) {
+                // Idempotent cancel already settled the task.
+            }
+            else {
+                this.opts.store.setState(record.taskId, TaskState.FAILED, { code: 'executor', text: err.message });
+            }
+        }
+        finally {
+            this.running.delete(record.taskId);
+            const terminal = this.opts.store.get(record.taskId);
+            if (terminal !== undefined)
+                this.emit({ task: toTask(terminal) });
+            this.settle(record.taskId);
+            this.opts.onTaskSettled?.(record.taskId);
+        }
+    }
+    /** Build the event sink that folds executor events into store + frames. */
+    eventSink(taskId, contextId) {
+        return (ev) => {
+            if (ev.type === 'status') {
+                this.opts.store.setState(taskId, ev.state ?? TaskState.WORKING);
+                this.emit({ statusUpdate: { taskId, contextId, status: statusOf(this.opts.store.get(taskId)) } });
+            }
+            else if (ev.type === 'artifact' && ev.artifactId !== undefined && ev.parts !== undefined) {
+                const record = this.opts.store.appendArtifact(taskId, {
+                    artifactId: ev.artifactId,
+                    ...(ev.name !== undefined ? { name: ev.name } : {}),
+                    parts: ev.parts,
+                    ...(ev.lastChunk !== undefined ? { lastChunk: ev.lastChunk } : {}),
+                });
+                const artifact = record.artifacts.find((a) => a.artifactId === ev.artifactId);
+                if (artifact !== undefined) {
+                    this.emit({
+                        artifactUpdate: {
+                            taskId,
+                            contextId,
+                            artifact: {
+                                artifactId: artifact.artifactId,
+                                ...(artifact.name !== undefined ? { name: artifact.name } : {}),
+                                parts: artifact.parts,
+                            },
+                            ...(ev.lastChunk !== undefined ? { lastChunk: ev.lastChunk } : {}),
+                        },
+                    });
+                }
+            }
+        };
+    }
+    emit(frame) {
+        for (const listener of [...this.listeners])
+            listener(frame);
+    }
+    noteInbound(req, method, taskIds, streaming) {
+        const source = sourceOf(req);
+        this.opts.onInbound?.({
+            method,
+            ...(source !== undefined ? { source } : {}),
+            taskIds,
+            streaming,
+        });
+    }
+    remotePeerOf(req) {
+        const source = sourceOf(req);
+        return source ? hashOf(source) : null;
+    }
+    async waitTerminal(taskId) {
+        const current = this.opts.store.get(taskId);
+        if (current !== undefined && isTerminal(current.state))
+            return;
+        await new Promise((resolve) => {
+            this.waiters.set(taskId, resolve);
+        });
+    }
+    settle(taskId) {
+        const waiter = this.waiters.get(taskId);
+        if (waiter !== undefined) {
+            this.waiters.delete(taskId);
+            waiter();
+        }
+    }
+}
+/** Read the JSON-RPC endpoint path off the card's first interface. */
+function endpointOf(card) {
+    const url = card.supportedInterfaces?.[0]?.url;
+    if (!url)
+        return '/a2a';
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        return url;
+    }
+}
+function sourceOf(req) {
+    const s = req.socket;
+    if (!s?.remoteAddress)
+        return undefined;
+    return `${s.remoteAddress}:${s.remotePort ?? ''}`;
+}
+function hashOf(value) {
+    let h = 0;
+    for (let i = 0; i < value.length; i++)
+        h = (h * 31 + value.charCodeAt(i)) >>> 0;
+    return `peer-${h.toString(16)}`;
+}
+function gateInputFrom(message, remotePeerId) {
+    return {
+        contextId: message.contextId ?? 'new',
+        skill: message.metadata?.['skill'] ?? 'chat',
+        parts: message.parts,
+        remotePeerId,
+    };
+}
+function rpcFault(code, message) {
+    return { code, message };
+}
+function statusOf(record) {
+    return {
+        state: record.state,
+        timestamp: record.updatedAt,
+        ...(record.error ? { message: { messageId: `a2a-status-${record.taskId}`, role: Role.AGENT, parts: [{ text: record.error.message }] } } : {}),
+    };
+}
+function toTask(record) {
+    return {
+        id: record.taskId,
+        contextId: record.contextId,
+        status: statusOf(record),
+        artifacts: record.artifacts,
+        metadata: { skill: record.skill },
+    };
+}
+function extractTaskIds(result) {
+    if (result === null || typeof result !== 'object')
+        return [];
+    const value = result;
+    if (typeof value.id === 'string')
+        return [value.id];
+    if (typeof value.task?.id === 'string')
+        return [value.task.id];
+    if (Array.isArray(result)) {
+        return result.map((t) => t.id).filter((id) => typeof id === 'string');
+    }
+    return [];
+}
+//# sourceMappingURL=a2a-server.js.map

package/lib/types/server/a2a-server.js.map

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

package/lib/types/server/card.d.ts

@@ -0,0 +1,48 @@
+/**
+ * AgentCard assembly for the inbound half: skills are DERIVED from the live
+ * tool registry by an explicit id list (never invented), plus a built-in
+ * `chat` skill so a fresh install is immediately exercisable end-to-end.
+ * @module dsh-a2a/server/card
+ */
+import { type AgentCard, type AgentSkill } from '../protocol.ts';
+/** Structural slice of `ctx.tools` used for derivation. */
+export interface ToolGetter {
+    get(name: string): {
+        readonly name: string;
+        readonly description?: string;
+    } | undefined;
+}
+/** Derivation policy for inbound skills. */
+export interface CardSkillPolicy {
+    /** Tool ids (as registered on ctx.tools) exposed as inbound skills. */
+    readonly ids: readonly string[];
+    /** Ids to remove after derivation (defense in depth). */
+    readonly exclude: readonly string[];
+}
+/**
+ * Derive the inbound skill list from the live tool registry.
+ *
+ * Every configured id must resolve to a registered tool — a missing referent
+ * fails the derivation loudly (the plugin's misconfiguration contract) with
+ * all missing ids listed. The built-in `chat` skill is always present so the
+ * server answers before any tool is exposed.
+ *
+ * @param tools - the tool registry getter.
+ * @param policy - explicit-id derivation policy.
+ * @returns the derived skills, `chat` first, configured tools after, excludes applied.
+ */
+export declare function deriveSkills(tools: ToolGetter, policy: CardSkillPolicy): AgentSkill[];
+/** Identity options for the advertised AgentCard. */
+export interface CardOptions {
+    readonly baseUrl: string;
+    readonly endpointPath: string;
+    readonly name: string;
+    readonly description: string;
+    readonly version: string;
+    readonly skills: readonly AgentSkill[];
+    /** Present when inbound bearer auth is configured (env-resolved). */
+    readonly authToken?: string;
+}
+/** Assemble the AgentCard advertised by this DSH. */
+export declare function buildCard(options: CardOptions): AgentCard;
+//# sourceMappingURL=card.d.ts.map

package/lib/types/server/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../src/server/card.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,UAAU,EAChB,MAAM,gBAAgB,CAAA;AAEvB,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CACxF;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,GAAG,UAAU,EAAE,CA6BrF;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;IACtC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,CAuBzD"}

package/lib/types/server/card.js

@@ -0,0 +1,75 @@
+/**
+ * AgentCard assembly for the inbound half: skills are DERIVED from the live
+ * tool registry by an explicit id list (never invented), plus a built-in
+ * `chat` skill so a fresh install is immediately exercisable end-to-end.
+ * @module dsh-a2a/server/card
+ */
+/**
+ * Derive the inbound skill list from the live tool registry.
+ *
+ * Every configured id must resolve to a registered tool — a missing referent
+ * fails the derivation loudly (the plugin's misconfiguration contract) with
+ * all missing ids listed. The built-in `chat` skill is always present so the
+ * server answers before any tool is exposed.
+ *
+ * @param tools - the tool registry getter.
+ * @param policy - explicit-id derivation policy.
+ * @returns the derived skills, `chat` first, configured tools after, excludes applied.
+ */
+export function deriveSkills(tools, policy) {
+    const excluded = new Set(policy.exclude);
+    const skills = [
+        {
+            id: 'chat',
+            name: 'chat',
+            description: 'Conversational assistance over a DSH agent session.',
+            tags: ['chat'],
+        },
+    ];
+    const missing = [];
+    for (const id of policy.ids) {
+        if (excluded.has(id))
+            continue;
+        const tool = tools.get(id);
+        if (tool === undefined) {
+            missing.push(id);
+            continue;
+        }
+        skills.push({
+            id,
+            name: id,
+            description: tool.description ?? `Expose the DSH tool \`${id}\` over A2A.`,
+            tags: ['tool'],
+        });
+    }
+    if (missing.length > 0) {
+        throw new Error(`dsh-a2a: server.skills.ids reference unregistered tools: ${missing.join(', ')}`);
+    }
+    return skills;
+}
+/** Assemble the AgentCard advertised by this DSH. */
+export function buildCard(options) {
+    const iface = {
+        url: `${options.baseUrl.replace(/\/$/, '')}${options.endpointPath}`,
+        protocolBinding: 'JSONRPC',
+        protocolVersion: '1.0',
+    };
+    return {
+        name: options.name,
+        description: options.description,
+        version: options.version,
+        provider: { url: 'https://deepseek.com', organization: 'DeepSeek' },
+        capabilities: { streaming: true, pushNotifications: false, extensions: [] },
+        defaultInputModes: ['text/plain'],
+        defaultOutputModes: ['text/plain'],
+        skills: options.skills,
+        supportedInterfaces: [iface],
+        ...(options.authToken !== undefined
+            ? {
+                securitySchemes: { bearerAuth: { type: 'http', scheme: 'bearer', description: 'Shared bearer token' } },
+                securityRequirements: [{ bearerAuth: [] }],
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=card.js.map

package/lib/types/server/card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../../../src/server/card.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,KAAiB,EAAE,MAAuB;IACrE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACxC,MAAM,MAAM,GAAiB;QAC3B;YACE,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,qDAAqD;YAClE,IAAI,EAAE,CAAC,MAAM,CAAC;SACf;KACF,CAAA;IACD,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAQ;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC1B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAChB,SAAQ;QACV,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,EAAE;YACF,IAAI,EAAE,EAAE;YACR,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,yBAAyB,EAAE,cAAc;YAC1E,IAAI,EAAE,CAAC,MAAM,CAAC;SACf,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,4DAA4D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACnG,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAcD,qDAAqD;AACrD,MAAM,UAAU,SAAS,CAAC,OAAoB;IAC5C,MAAM,KAAK,GAAmB;QAC5B,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE;QACnE,eAAe,EAAE,SAAS;QAC1B,eAAe,EAAE,KAAK;KACvB,CAAA;IACD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,EAAE,GAAG,EAAE,sBAAsB,EAAE,YAAY,EAAE,UAAU,EAAE;QACnE,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE;QAC3E,iBAAiB,EAAE,CAAC,YAAY,CAAC;QACjC,kBAAkB,EAAE,CAAC,YAAY,CAAC;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,mBAAmB,EAAE,CAAC,KAAK,CAAC;QAC5B,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;YACjC,CAAC,CAAC;gBACA,eAAe,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE,EAAE;gBACvG,oBAAoB,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;aAC3C;YACD,CAAC,CAAC,EAAE,CAAC;KACR,CAAA;AACH,CAAC"}