@ouispec/agent-worker 0.1.0

package/dist/openapi/document.js

@@ -0,0 +1,117 @@
+/**
+ * The parts of an OpenAPI 3.0 or 3.1 document the tool loader reads, and the
+ * conversion of its schemas into the JSON Schema a tool declares.
+ */
+export const HTTP_METHODS = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace'];
+/** Thrown for anything the loader refuses; the message names the operation. */
+export class OpenApiToolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'OpenApiToolError';
+    }
+}
+function isReference(value) {
+    return !!value && typeof value === 'object' && typeof value.$ref === 'string';
+}
+/**
+ * Resolves `#/...` references in one document. `where` names the operation in
+ * errors. A reference outside the document, or one that does not resolve, is refused.
+ */
+export function createResolver(doc) {
+    function lookup(ref, where) {
+        if (!ref.startsWith('#/'))
+            throw new OpenApiToolError(`${where}: $ref "${ref}" is not in this document`);
+        let node = doc;
+        for (const raw of ref.slice(2).split('/')) {
+            const key = raw.replace(/~1/g, '/').replace(/~0/g, '~');
+            if (!node || typeof node !== 'object' || !(key in node)) {
+                throw new OpenApiToolError(`${where}: $ref "${ref}" does not resolve`);
+            }
+            node = node[key];
+        }
+        return node;
+    }
+    /** Follow references until a value that is not one. */
+    function deref(value, where) {
+        const seen = new Set();
+        let current = value;
+        while (isReference(current)) {
+            if (seen.has(current.$ref))
+                throw new OpenApiToolError(`${where}: ${current.$ref} refers to itself`);
+            seen.add(current.$ref);
+            current = lookup(current.$ref, where);
+        }
+        return current;
+    }
+    return { deref, lookup };
+}
+/** Keywords OpenAPI adds to a schema that are not JSON Schema, and mean nothing to a tool's input. */
+const OPENAPI_ONLY_KEYWORDS = new Set(['discriminator', 'xml', 'externalDocs', 'example', 'nullable']);
+/** Keywords whose value is one schema. */
+const SUBSCHEMA_KEYWORDS = ['items', 'additionalProperties', 'not', 'contains', 'propertyNames', 'if', 'then', 'else', 'unevaluatedProperties', 'unevaluatedItems', 'additionalItems'];
+/** Keywords whose value is a list of schemas. */
+const SUBSCHEMA_LIST_KEYWORDS = ['allOf', 'anyOf', 'oneOf', 'prefixItems'];
+/** Keywords whose value maps names to schemas. */
+const SUBSCHEMA_MAP_KEYWORDS = ['properties', 'patternProperties', 'dependentSchemas', '$defs', 'definitions'];
+/**
+ * An OpenAPI schema as the JSON Schema of a tool's input: every reference inlined,
+ * 3.0's `nullable` as a `null` type, `example` as `examples`, and properties the
+ * server sets (`readOnly`) left out, since a caller never sends them.
+ *
+ * A schema that refers to itself cannot be inlined and is refused.
+ */
+export function toInputSchema(schema, resolver, where, stack = []) {
+    if (isReference(schema)) {
+        const ref = schema.$ref;
+        if (stack.includes(ref))
+            throw new OpenApiToolError(`${where}: ${ref} refers to itself, so it cannot be inlined into a tool's input`);
+        return toInputSchema(resolver.lookup(ref, where), resolver, where, [...stack, ref]);
+    }
+    if (!schema || typeof schema !== 'object' || Array.isArray(schema)) {
+        return typeof schema === 'boolean' ? (schema ? {} : { not: {} }) : {};
+    }
+    const source = schema;
+    const out = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (OPENAPI_ONLY_KEYWORDS.has(key) || key.startsWith('x-'))
+            continue;
+        if (SUBSCHEMA_KEYWORDS.includes(key) && value && typeof value === 'object') {
+            out[key] = toInputSchema(value, resolver, where, stack);
+        }
+        else if (SUBSCHEMA_LIST_KEYWORDS.includes(key) && Array.isArray(value)) {
+            out[key] = value.map((entry) => toInputSchema(entry, resolver, where, stack));
+        }
+        else if (SUBSCHEMA_MAP_KEYWORDS.includes(key) && value && typeof value === 'object') {
+            out[key] = Object.fromEntries(Object.entries(value).map(([name, entry]) => [name, toInputSchema(entry, resolver, where, stack)]));
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    if (source.example !== undefined && out.examples === undefined)
+        out.examples = [source.example];
+    // 3.0: `nullable: true` beside a type allows null too.
+    if (source.nullable === true && out.type !== undefined) {
+        const types = Array.isArray(out.type) ? out.type : [out.type];
+        if (!types.includes('null'))
+            out.type = [...types, 'null'];
+    }
+    // The server sets read-only properties; a caller never sends them.
+    if (out.properties && typeof out.properties === 'object') {
+        const properties = source.properties;
+        const readOnly = Object.keys(properties).filter((name) => {
+            const entry = isReference(properties[name]) ? resolver.deref(properties[name], where) : properties[name];
+            return !!entry && typeof entry === 'object' && entry.readOnly === true;
+        });
+        if (readOnly.length > 0) {
+            out.properties = Object.fromEntries(Object.entries(out.properties).filter(([name]) => !readOnly.includes(name)));
+            if (Array.isArray(out.required)) {
+                out.required = out.required.filter((name) => !readOnly.includes(name));
+                if (out.required.length === 0)
+                    delete out.required;
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=document.js.map

package/dist/openapi/document.js.map

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

package/dist/openapi/executor.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Calls one OpenAPI operation as the caller the auth seam names.
+ *
+ * The API decides what the caller may do: a permission they lack comes back as the
+ * route's own refusal (a 403), which is returned as the tool's error, with the
+ * status and body, for the model to read. Nothing here widens or checks access.
+ */
+import type { ToolExecutionContext, ToolExecutionResult } from '../tools/types.js';
+import type { HttpMethod } from './document.js';
+/** Where each input property goes in the request. */
+export type InputPlacement = {
+    in: 'path';
+    name: string;
+} | {
+    in: 'query';
+    name: string;
+    style: 'form' | 'spaceDelimited' | 'pipeDelimited' | 'deepObject';
+    explode: boolean;
+}
+/** One field of a JSON object body, flattened beside the parameters. */
+ | {
+    in: 'bodyField';
+    name: string;
+}
+/** The whole JSON body, under the input property `body`. */
+ | {
+    in: 'body';
+};
+export interface OperationRef {
+    operationId: string;
+    method: HttpMethod;
+    path: string;
+}
+/**
+ * Who a call acts as: the headers that make the API treat it as that caller.
+ *
+ * It is required and has no default. A product passes its own mechanism, such as a
+ * signed assertion naming the user (Closure's is ADR-0182's), or the credential an
+ * MCP client authenticated with.
+ */
+export type ActAs = (ctx: ToolExecutionContext, operation: OperationRef) => Record<string, string> | Promise<Record<string, string>>;
+export interface ExecutorPlan extends OperationRef {
+    baseUrl: string;
+    placements: Map<string, InputPlacement>;
+    /** Header parameters the operation requires; only actAs can supply them. */
+    requiredHeaders: string[];
+    actAs: ActAs;
+    fetch: typeof fetch;
+}
+export declare function executeOperation(plan: ExecutorPlan, input: Record<string, unknown>, ctx: ToolExecutionContext): Promise<ToolExecutionResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/openapi/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/openapi/executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,qDAAqD;AACrD,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,eAAe,GAAG,YAAY,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AACpH,wEAAwE;GACtE;IAAE,EAAE,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACnC,4DAA4D;GAC1D;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnB,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG,CAClB,GAAG,EAAE,oBAAoB,EACzB,SAAS,EAAE,YAAY,KACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9D,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,4EAA4E;IAC5E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB;AA2DD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAgE9B"}

package/dist/openapi/executor.js

@@ -0,0 +1,140 @@
+function serialiseQuery(search, placement, value) {
+    const { name, style, explode } = placement;
+    if (Array.isArray(value)) {
+        const items = value.map(String);
+        if (style === 'form' && explode)
+            for (const item of items)
+                search.append(name, item);
+        else
+            search.append(name, items.join(style === 'spaceDelimited' ? ' ' : style === 'pipeDelimited' ? '|' : ','));
+        return;
+    }
+    if (value && typeof value === 'object') {
+        const entries = Object.entries(value);
+        if (style === 'deepObject')
+            for (const [key, v] of entries)
+                search.append(`${name}[${key}]`, String(v));
+        else if (explode)
+            for (const [key, v] of entries)
+                search.append(key, String(v));
+        else
+            search.append(name, entries.flatMap(([key, v]) => [key, String(v)]).join(','));
+        return;
+    }
+    search.append(name, String(value));
+}
+function serialisePath(value) {
+    if (Array.isArray(value))
+        return value.map((v) => encodeURIComponent(String(v))).join(',');
+    if (value && typeof value === 'object') {
+        return Object.entries(value)
+            .flatMap(([key, v]) => [encodeURIComponent(key), encodeURIComponent(String(v))])
+            .join(',');
+    }
+    return encodeURIComponent(String(value));
+}
+/** The API's own words for a refusal, from the common error shapes. */
+function refusalMessage(body) {
+    if (typeof body === 'string')
+        return body.trim() || undefined;
+    if (!body || typeof body !== 'object')
+        return undefined;
+    const b = body;
+    const error = b.error;
+    if (typeof error === 'string')
+        return error;
+    if (error && typeof error === 'object' && typeof error.message === 'string') {
+        return error.message;
+    }
+    if (typeof b.message === 'string')
+        return b.message;
+    if (typeof b.detail === 'string')
+        return b.detail;
+    if (typeof b.title === 'string')
+        return b.title;
+    return undefined;
+}
+async function readResponse(response) {
+    const text = await response.text();
+    if (text === '')
+        return undefined;
+    if (/\bjson\b|\+json/i.test(response.headers.get('content-type') ?? '')) {
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    return text;
+}
+export async function executeOperation(plan, input, ctx) {
+    const ref = { operationId: plan.operationId, method: plan.method, path: plan.path };
+    let identity;
+    try {
+        identity = await plan.actAs(ctx, ref);
+    }
+    catch (err) {
+        return { success: false, error: `${plan.operationId} could not act as the user: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (!identity || typeof identity !== 'object' || Object.values(identity).some((v) => typeof v !== 'string')) {
+        return { success: false, error: `${plan.operationId} could not act as the user: actAs returned no headers` };
+    }
+    const suppliedHeaders = new Set(Object.keys(identity).map((h) => h.toLowerCase()));
+    for (const header of plan.requiredHeaders) {
+        if (!suppliedHeaders.has(header.toLowerCase())) {
+            return { success: false, error: `${plan.operationId} needs the header ${header}, which actAs did not supply` };
+        }
+    }
+    let path = plan.path;
+    const search = new URLSearchParams();
+    let body;
+    const fields = {};
+    let hasFields = false;
+    for (const [key, value] of Object.entries(input)) {
+        const placement = plan.placements.get(key);
+        if (!placement || value === undefined)
+            continue;
+        if (placement.in === 'path')
+            path = path.split(`{${placement.name}}`).join(serialisePath(value));
+        else if (placement.in === 'query')
+            serialiseQuery(search, placement, value);
+        else if (placement.in === 'bodyField') {
+            fields[placement.name] = value;
+            hasFields = true;
+        }
+        else
+            body = value;
+    }
+    if (hasFields)
+        body = fields;
+    const query = search.toString();
+    const url = `${plan.baseUrl}${path}${query ? `?${query}` : ''}`;
+    const headers = { accept: 'application/json' };
+    if (body !== undefined)
+        headers['content-type'] = 'application/json';
+    Object.assign(headers, identity);
+    let response;
+    try {
+        response = await plan.fetch(url, {
+            method: plan.method.toUpperCase(),
+            headers,
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+            ...(ctx.abortSignal ? { signal: ctx.abortSignal } : {}),
+        });
+    }
+    catch (err) {
+        return { success: false, error: `${plan.operationId} could not reach the API: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    const payload = await readResponse(response);
+    if (response.ok)
+        return { success: true, data: payload === undefined ? { status: response.status } : payload };
+    const message = refusalMessage(payload);
+    const status = `${response.status}${response.statusText ? ` ${response.statusText}` : ''}`;
+    return {
+        success: false,
+        error: `${plan.operationId} was refused: ${status}${message ? `: ${message}` : ''}`,
+        data: { status: response.status, ...(payload !== undefined ? { body: payload } : {}) },
+    };
+}
+//# sourceMappingURL=executor.js.map

package/dist/openapi/executor.js.map

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

package/dist/openapi/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * API tools generated from any OpenAPI 3 document (ADR-0181 §2): the loader, the
+ * executor's auth seam, and the input validator every generated tool is checked with.
+ */
+export { loadOpenApiTools } from './loader.js';
+export type { OpenApiTool, OpenApiToolsOptions, OpenApiToolAudience } from './loader.js';
+export type { ActAs, OperationRef } from './executor.js';
+export { OpenApiToolError } from './document.js';
+export type { OpenApiDocument, OpenApiOperation, OpenApiParameter, OpenApiPathItem, OpenApiRequestBody, SecurityRequirement, HttpMethod, } from './document.js';
+export { API_OPERATION_EFFECTS } from './x-agent.js';
+export { createToolInputValidator } from '../tools/input-validation.js';
+export type { ToolInputValidation, ToolInputValidator } from '../tools/input-validation.js';
+export type { RegisteredTool, ToolExecutionContext, ToolExecutionResult } from '../tools/types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openapi/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzF,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/openapi/index.js

@@ -0,0 +1,9 @@
+/**
+ * API tools generated from any OpenAPI 3 document (ADR-0181 §2): the loader, the
+ * executor's auth seam, and the input validator every generated tool is checked with.
+ */
+export { loadOpenApiTools } from './loader.js';
+export { OpenApiToolError } from './document.js';
+export { API_OPERATION_EFFECTS } from './x-agent.js';
+export { createToolInputValidator } from '../tools/input-validation.js';
+//# sourceMappingURL=index.js.map

package/dist/openapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openapi/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAUjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/openapi/loader.d.ts

@@ -0,0 +1,81 @@
+/**
+ * loadOpenApiTools — a product's OpenAPI 3 document becomes its agent tools
+ * (ADR-0181 §2). No second manifest format: the document is read directly.
+ *
+ * - An operation is a tool only when its `x-agent` says `expose: true`.
+ * - Its name is its `operationId`; its description its `summary` and `description`;
+ *   its input its parameters and JSON request body, validated by the worker before
+ *   every call.
+ * - Its effect and `destructive` come from `x-agent`, and are on the tool for
+ *   approvals to key on (ADR-0228).
+ * - Its required permissions are its standard `security` requirement.
+ * - A call runs as the caller the required `actAs` seam names, and the API decides
+ *   what that caller may do.
+ * - The product's own assistant (`audience: 'pa'`) gets only the operations flagged
+ *   `pa: true`, and the flag is refused on anything but a read (ADR-0227 §2.1).
+ * - An operation that starts a job names its declared completion event in
+ *   `x-async-binding` (W9). It is checked against the product's declarations at
+ *   load, and with a waiter the tool waits for the job to settle.
+ *
+ * Anything that cannot become a safe, callable tool is refused at load, naming the
+ * operation.
+ */
+import { type ActionEffect } from '@ouispec/bindings';
+import type { EventCatalog, EventWaiter } from '@ouispec/agent-events';
+import type { RegisteredTool } from '../tools/types.js';
+import { type HttpMethod, type OpenApiDocument, type SecurityRequirement } from './document.js';
+import { type ActAs } from './executor.js';
+/** `agents`: every exposed operation, for backend, MCP and external agents. `pa`: only those flagged `pa: true`. */
+export type OpenApiToolAudience = 'agents' | 'pa';
+export interface OpenApiToolsOptions {
+    /** Where the API is served. Each operation's path is appended to it. */
+    baseUrl: string;
+    /** Who a call acts as. Required; there is no default. */
+    actAs: ActAs;
+    /** Which operations become tools. */
+    audience: OpenApiToolAudience;
+    /** The fetch to call the API with. Default: the global fetch. */
+    fetch?: typeof fetch;
+    /**
+     * The product's event declarations. Required when an exposed operation has an
+     * `x-async-binding`: its completion must be declared there.
+     */
+    events?: EventCatalog;
+    /**
+     * How an async operation's tool waits for its job to settle (for example
+     * `createHttpEventWaiter`). Without one, the tool returns the dispatch.
+     */
+    waiter?: EventWaiter;
+}
+export interface OpenApiTool extends RegisteredTool {
+    kind: 'backend';
+    effect: ActionEffect;
+    destructive: boolean;
+    /** The operation's `summary`, else its id. */
+    title: string;
+    /** What happens when it runs, from `x-agent.consequence`. */
+    consequence?: string;
+    operation: {
+        operationId: string;
+        method: HttpMethod;
+        path: string;
+        /** The operation's `summary`, else its id: a short title for previews. */
+        title: string;
+        /** Its standard security requirement: any one entry, each scheme with the permissions it needs. */
+        security: SecurityRequirement[];
+        /** For an operation that starts a job: the declared events it settles on, and how long it is waited for. */
+        async?: {
+            completion: string;
+            failure?: string;
+            correlation: string;
+            idField: string;
+            timeoutMs: number;
+        };
+    };
+}
+/**
+ * Turn an OpenAPI 3 document into tools. Throws `OpenApiToolError`, naming the
+ * operation, for anything it refuses.
+ */
+export declare function loadOpenApiTools(document: OpenApiDocument, options: OpenApiToolsOptions): OpenApiTool[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/openapi/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/openapi/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAA6C,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAKL,KAAK,UAAU,EAEf,KAAK,eAAe,EAKpB,KAAK,mBAAmB,EACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAoB,KAAK,KAAK,EAA0C,MAAM,eAAe,CAAC;AAGrG,oHAAoH;AACpH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,IAAI,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,EAAE,KAAK,CAAC;IACb,qCAAqC;IACrC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE;QACT,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,UAAU,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,0EAA0E;QAC1E,KAAK,EAAE,MAAM,CAAC;QACd,mGAAmG;QACnG,QAAQ,EAAE,mBAAmB,EAAE,CAAC;QAChC,4GAA4G;QAC5G,KAAK,CAAC,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3G,CAAC;CACH;AA4PD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,GAAG,WAAW,EAAE,CAsHvG"}