@nxisai/agent-harness 0.4.0 → 0.5.0

package/dist/harness/tools/local-context.js

@@ -1,8 +1,101 @@
 var _a;
 /** Set on the instance so a later, real provider can be told apart from ours. */
 export const LOCAL_CONTEXT_FLAG = '__nxisLocalModelContext';
+const TOOL_NAME = /^[A-Za-z0-9_.-]{1,128}$/;
+function domException(message, name) {
+    if (typeof DOMException === 'function')
+        return new DOMException(message, name);
+    return Object.assign(new Error(message), { name });
+}
+/** "Queue a global task": after the current task and its microtasks. */
+const queueTask = (steps) => void setTimeout(steps, 0);
+const isObject = (value) => (typeof value === 'object' && value !== null) || typeof value === 'function';
+/** `JSON.stringify`, with a `TypeError` where it yields nothing, as Infra's serializer has it. */
+function serializeJSON(value) {
+    const json = JSON.stringify(value);
+    if (json === undefined)
+        throw new TypeError('The value cannot be serialized as JSON.');
+    return json;
+}
+function dictionary(value, type) {
+    if (value === undefined || value === null)
+        return {};
+    if (!isObject(value))
+        throw new TypeError(`The provided value is not of type '${type}'.`);
+    return value;
+}
+function required(dict, member, type) {
+    if (dict[member] === undefined) {
+        throw new TypeError(`Failed to read the '${member}' property from '${type}': Required member is undefined.`);
+    }
+    return dict[member];
+}
+function toHints(value) {
+    const dict = dictionary(value, 'ToolAnnotations');
+    const hint = (key) => (dict[key] === undefined ? false : Boolean(dict[key]));
+    return {
+        consequentialHint: hint('consequentialHint'),
+        debugging: hint('debugging'),
+        readOnlyHint: hint('readOnlyHint'),
+        untrustedContentHint: hint('untrustedContentHint'),
+    };
+}
+function toSignal(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof AbortSignal === 'function' && !(value instanceof AbortSignal)) {
+        throw new TypeError("Failed to read the 'signal' property: The provided value is not of type 'AbortSignal'.");
+    }
+    return value;
+}
+const ownWindow = () => (typeof window !== 'undefined' ? window : globalThis);
+const isWindow = (value) => typeof window === 'undefined' ? value === globalThis : isObject(value) && value.window === value;
+/** Outside a browser `http://localhost` stands in: an opaque origin would refuse every call. */
+const ownOrigin = () => (typeof location !== 'undefined' ? location.origin : 'http://localhost');
+function isTrustworthy(url) {
+    if (url.origin === 'null')
+        return false;
+    if (url.protocol === 'https:' || url.protocol === 'wss:')
+        return true;
+    const host = url.hostname;
+    return host === 'localhost' || host.endsWith('.localhost') || /^127(?:\.\d{1,3}){3}$/.test(host) || host === '[::1]';
+}
+/** `SecurityError` for an origin that doesn't parse or isn't potentially trustworthy. */
+function checkOrigins(origins, member) {
+    if (origins === undefined)
+        return;
+    if (!isObject(origins) || typeof origins[Symbol.iterator] !== 'function') {
+        throw new TypeError(`Failed to read the '${member}' property: The provided value cannot be converted to a sequence.`);
+    }
+    for (const origin of origins) {
+        let url;
+        try {
+            url = new URL(`${origin}`);
+        }
+        catch {
+            throw domException(`"${origin}" is not a valid origin.`, 'SecurityError');
+        }
+        if (!isTrustworthy(url))
+            throw domException(`"${origin}" is not a potentially trustworthy origin.`, 'SecurityError');
+    }
+}
+/** The spec's opening checks: an origin-keyed agent cluster, unless the page is a `file:` one. */
+function accessError() {
+    const keyed = globalThis.originAgentCluster;
+    const scheme = typeof location !== 'undefined' ? location.protocol : '';
+    return keyed === false && scheme !== 'file:'
+        ? domException("This page's agent cluster is not origin-keyed.", 'SecurityError')
+        : null;
+}
+/** An event carrying the name of the tool it concerns: `toolactivated`, `toolcancel`. */
+class ToolEvent extends Event {
+    constructor(type, toolName) {
+        super(type);
+        this.toolName = toolName;
+    }
+}
 /**
- * A minimal in-memory tool registry implementing {@link ModelContext}.
+ * An in-memory tool registry built to the WebMCP spec.
  *
  * Installed by {@link ensureModelContext} on pages that have no registry of
  * their own, so that discovered remote tools have somewhere to live.
@@ -12,28 +105,290 @@ export class LocalModelContext extends EventTarget {
         super(...arguments);
         this[_a] = true;
         this._tools = new Map();
+        this._pending = new Map();
+        this._handlers = {};
+        this._listeners = {};
+    }
+    get ontoolchange() {
+        return this._handlers.toolchange ?? null;
+    }
+    set ontoolchange(handler) {
+        this._setHandler('toolchange', handler);
+    }
+    get ontoolactivated() {
+        return this._handlers.toolactivated ?? null;
+    }
+    set ontoolactivated(handler) {
+        this._setHandler('toolactivated', handler);
+    }
+    get ontoolcancel() {
+        return this._handlers.toolcancel ?? null;
+    }
+    set ontoolcancel(handler) {
+        this._setHandler('toolcancel', handler);
+    }
+    registerTool(tool, options = {}) {
+        const type = 'ModelContextTool';
+        let definition;
+        let signal;
+        let schema;
+        let exposedTo;
+        try {
+            // Members in lexicographic order, as WebIDL converts a dictionary.
+            const dict = dictionary(tool, type);
+            const annotations = dict.annotations === undefined ? null : toHints(dict.annotations);
+            const description = `${required(dict, 'description', type)}`;
+            const execute = required(dict, 'execute', type);
+            if (typeof execute !== 'function') {
+                throw new TypeError(`Failed to read the 'execute' property from '${type}': The provided value is not a function.`);
+            }
+            schema = dict.inputSchema;
+            if (schema !== undefined && !isObject(schema)) {
+                throw new TypeError(`Failed to read the 'inputSchema' property from '${type}': The provided value is not of type 'object'.`);
+            }
+            const name = `${required(dict, 'name', type)}`;
+            const title = dict.title === undefined ? null : `${dict.title}`;
+            definition = { name, title, description, inputSchema: '', annotations, execute: execute };
+            const opts = dictionary(options, 'ModelContextRegisterToolOptions');
+            exposedTo = opts.exposedTo;
+            signal = toSignal(opts.signal);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        const denied = accessError();
+        if (denied)
+            return Promise.reject(denied);
+        const { name } = definition;
+        if (this._tools.has(name)) {
+            return Promise.reject(domException(`A tool named "${name}" is already registered.`, 'InvalidStateError'));
+        }
+        if (!TOOL_NAME.test(name)) {
+            return Promise.reject(domException(`"${name}" is not a valid tool name: 1 to 128 ASCII letters, digits, "_", "-" or ".".`, 'InvalidStateError'));
+        }
+        if (definition.description === '') {
+            return Promise.reject(domException("A tool's description must not be empty.", 'InvalidStateError'));
+        }
+        if (schema !== undefined) {
+            try {
+                definition.inputSchema = serializeJSON(schema);
+            }
+            catch (error) {
+                return Promise.reject(error);
+            }
+        }
+        if (signal?.aborted)
+            return Promise.reject(signal.reason);
+        try {
+            checkOrigins(exposedTo, 'exposedTo');
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        let settle;
+        const promise = new Promise((resolve, reject) => (settle = { resolve, reject }));
+        if (signal) {
+            const s = signal;
+            s.addEventListener('abort', () => {
+                if (this._tools.delete(name))
+                    this._notifyToolChange();
+                settle.reject(s.reason);
+            }, { once: true });
+        }
+        this._tools.set(name, definition);
+        this._notifyToolChange();
+        queueTask(() => settle.resolve());
+        return promise;
+    }
+    getTools(options = {}) {
+        try {
+            checkOrigins(dictionary(options, 'ModelContextGetToolOptions').fromOrigins, 'fromOrigins');
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        const denied = accessError();
+        if (denied)
+            return Promise.reject(denied);
+        return new Promise((resolve) => {
+            const origin = ownOrigin();
+            const win = ownWindow();
+            const tools = [...this._tools.values()].map((t) => {
+                // Members in lexicographic order, as WebIDL creates a dictionary; absent ones are left out.
+                const info = {};
+                if (t.annotations)
+                    info.annotations = { ...t.annotations };
+                info.description = t.description;
+                if (t.inputSchema !== '')
+                    info.inputSchema = JSON.parse(t.inputSchema);
+                info.name = t.name;
+                info.origin = origin;
+                info.title = t.title ?? '';
+                info.window = win;
+                return info;
+            });
+            tools.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+            queueTask(() => resolve(tools));
+        });
     }
-    registerTool(tool) {
-        this._tools.set(tool.name, tool);
-        // Tool discovery listens for this rather than polling to its timeout.
-        this.dispatchEvent(new Event('toolchange'));
-    }
-    getTools() {
-        return Promise.resolve([...this._tools.values()].map((t) => ({
-            name: t.name,
-            description: t.description,
-            inputSchema: t.inputSchema,
-            annotations: t.annotations,
-        })));
-    }
-    async executeTool(nameOrTool, input) {
-        const name = typeof nameOrTool === 'string' ? nameOrTool : nameOrTool.name;
-        const tool = this._tools.get(name);
-        if (!tool) {
-            return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
-        }
-        const args = typeof input === 'string' ? JSON.parse(input || '{}') : input ?? {};
-        return tool.execute(args);
+    executeTool(tool, inputObject, options = {}) {
+        const type = 'RegisteredTool';
+        let name;
+        let origin;
+        let win;
+        let signal;
+        try {
+            const dict = dictionary(tool, type);
+            if (dict.annotations !== undefined)
+                toHints(dict.annotations);
+            required(dict, 'description', type);
+            if (dict.inputSchema !== undefined && !isObject(dict.inputSchema)) {
+                throw new TypeError(`Failed to read the 'inputSchema' property from '${type}': The provided value is not of type 'object'.`);
+            }
+            name = `${required(dict, 'name', type)}`;
+            origin = `${required(dict, 'origin', type)}`;
+            win = required(dict, 'window', type);
+            if (!isWindow(win)) {
+                throw new TypeError(`Failed to read the 'window' property from '${type}': The provided value is not of type 'Window'.`);
+            }
+            signal = toSignal(dictionary(options, 'ModelContextExecuteToolOptions').signal);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        const denied = accessError();
+        if (denied)
+            return Promise.reject(denied);
+        let expectedOrigin;
+        try {
+            expectedOrigin = new URL(origin).origin;
+        }
+        catch {
+            return Promise.reject(domException(`"${origin}" is not a valid origin.`, 'NotSupportedError'));
+        }
+        if (expectedOrigin === 'null')
+            return Promise.reject(domException("A tool's origin must not be opaque.", 'NotSupportedError'));
+        if (!isObject(inputObject)) {
+            return Promise.reject(new TypeError("Failed to execute 'executeTool' on 'ModelContext': The input is not an object."));
+        }
+        let inputArguments;
+        try {
+            inputArguments = serializeJSON(inputObject);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        let settle;
+        const promise = new Promise((resolve, reject) => (settle = { resolve, reject }));
+        const uuid = Symbol('tool execution');
+        if (signal) {
+            if (signal.aborted)
+                return Promise.reject(signal.reason);
+            const s = signal;
+            s.addEventListener('abort', () => {
+                settle.reject(s.reason);
+                queueTask(() => this._cancel(uuid));
+            }, { once: true });
+        }
+        const fail = () => queueTask(() => settle.reject(domException('The tool could not be executed.', 'UnknownError')));
+        queueTask(() => {
+            if (win !== ownWindow() || ownOrigin() !== expectedOrigin || !this._tools.has(name))
+                return fail();
+            const execution = {
+                toolName: name,
+                controller: new AbortController(),
+                started: false,
+                complete: (result, success) => {
+                    if (!this._pending.delete(uuid))
+                        return;
+                    queueTask(() => success
+                        ? settle.resolve(result)
+                        : settle.reject(domException("The tool's execution failed.", 'UnknownError')));
+                },
+            };
+            this._pending.set(uuid, execution);
+            queueTask(() => this._runTool(name, inputArguments, execution));
+        });
+        // A string, as the spec resolves it. Typed as a response for the callers that read it through
+        // `asResponse` in webmcp.ts.
+        return promise;
+    }
+    /** The spec's tool execute steps, then its imperative execute steps. */
+    _runTool(name, inputArguments, execution) {
+        const definition = this._tools.get(name);
+        if (!definition)
+            return execution.complete(null, false);
+        let input;
+        try {
+            input = JSON.parse(inputArguments);
+        }
+        catch {
+            return execution.complete(null, false);
+        }
+        if (!isObject(input))
+            return execution.complete(null, false);
+        this.dispatchEvent(new ToolEvent('toolactivated', name));
+        execution.started = true;
+        let toolPromise;
+        try {
+            // A WebIDL callback: `this` undefined, and a synchronous throw is a rejection.
+            toolPromise = Promise.resolve(definition.execute.call(undefined, input, { signal: execution.controller.signal }));
+        }
+        catch (error) {
+            toolPromise = Promise.reject(error);
+        }
+        toolPromise.then((value) => {
+            if (!execution.started)
+                return; // cancelled before the tool settled
+            execution.started = false;
+            let serialized;
+            try {
+                serialized = serializeJSON(value);
+            }
+            catch {
+                return execution.complete(null, false);
+            }
+            execution.complete(serialized, true);
+        }, () => {
+            if (!execution.started)
+                return;
+            execution.started = false;
+            execution.complete(null, false);
+        });
+    }
+    /** The spec's "cancel a pending tool execution". */
+    _cancel(uuid) {
+        const execution = this._pending.get(uuid);
+        if (!execution)
+            return;
+        this._pending.delete(uuid);
+        queueTask(() => {
+            if (!execution.started)
+                return;
+            execution.started = false;
+            execution.controller.abort();
+            this.dispatchEvent(new ToolEvent('toolcancel', execution.toolName));
+        });
+    }
+    _notifyToolChange() {
+        queueTask(() => this.dispatchEvent(new Event('toolchange')));
+    }
+    /** An event handler attribute: one listener, kept in its place however often the handler changes. */
+    _setHandler(type, handler) {
+        const value = typeof handler === 'function' ? handler : null;
+        this._handlers[type] = value;
+        if (value && !this._listeners[type]) {
+            const listener = (event) => {
+                if (this._handlers[type]?.call(this, event) === false)
+                    event.preventDefault();
+            };
+            this._listeners[type] = listener;
+            this.addEventListener(type, listener);
+        }
+        else if (!value && this._listeners[type]) {
+            this.removeEventListener(type, this._listeners[type]);
+            delete this._listeners[type];
+        }
     }
 }
 _a = LOCAL_CONTEXT_FLAG;

package/dist/harness/tools/local-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-context.js","sourceRoot":"","sources":["../../../src/harness/tools/local-context.ts"],"names":[],"mappings":";AAoBA,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAAlD;;QACW,QAAoB,GAAG,IAAI,CAAC;QACpB,WAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IAgChE,CAAC;IA9BC,YAAY,CAAC,IAAsB;QACjC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,sEAAsE;QACtE,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,QAAQ;QACN,OAAO,OAAO,CAAC,OAAO,CACpB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CACf,UAA2B,EAC3B,KAA+C;QAE/C,MAAM,IAAI,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAE,UAA+B,CAAC,IAAI,CAAC;QACjG,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvF,CAAC;QACD,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAA6B,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACnG,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF;KAjCW,kBAAkB;AAmC9B;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,IAAI,SAAS,CAAC,YAAY,IAAI,IAAI,CAAC;IACzE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,GAAG,KAAK,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"local-context.js","sourceRoot":"","sources":["../../../src/harness/tools/local-context.ts"],"names":[],"mappings":"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"}

package/dist/harness/tools/open-page.d.ts

@@ -1,4 +1,5 @@
 import { type SitePage } from './site-pages.js';
+import { type SiteNav } from './site-nav.js';
 import type { ModelContext, ModelContextTool, ModelContextToolInfo } from '../../types.js';
 /** The tool's registered name. */
 export declare const OPEN_PAGE_TOOL = "open_page";
@@ -12,14 +13,59 @@ export interface OpenPageOptions {
     storage?: Storage | null;
     /** How to go to another page. Defaults to assigning `location`. */
     navigate?: (url: string) => void;
+    /** How to return to the previous page. Defaults to `history.back()`. */
+    back?: () => void;
+    /** The page the visitor came from. Defaults to `document.referrer`. Read when the tool runs. */
+    referrer?: () => string;
     /** The conversation to continue on arrival. Read when the tool runs. */
     conversationId?: () => string | undefined;
+    /**
+     * The site's graph, from its breadcrumb trails and page links.
+     *
+     * What makes "up a level" and "the section above" mean something, and what
+     * keeps the tool's list of destinations to the pages near this one rather
+     * than every page on the site.
+     */
+    nav?: SiteNav;
+    /**
+     * Fetch the trails the graph is missing, if they have not been fetched yet.
+     *
+     * Awaited when the tool runs, not at connect: the fetch is a read, and a
+     * site's rate limit counts reads. Going somewhere is what makes it worth one.
+     */
+    loadNav?: () => Promise<SiteNav>;
 }
+/** Where a request to open a page resolves: a page, and whether it is reached by going back. */
+export type Destination = {
+    kind: 'page' | 'home';
+    url: string;
+    label: string;
+} | {
+    kind: 'back';
+    url: string;
+    label: string;
+} | {
+    kind: 'none';
+    reason: string;
+};
+/**
+ * Where a request to open a page goes.
+ *
+ * A page by name or address, and two that no site lists by name: "home", the
+ * site's root, and "back", the page the visitor came from — only when that was
+ * a page of this site, since going back must not leave it.
+ *
+ * @param wanted - What the visitor or model asked for.
+ * @param pages - The site's pages.
+ * @param origin - The site's origin.
+ * @param opts - The referrer seam.
+ */
+export declare function resolveDestination(wanted: string, pages: SitePage[], origin: string, opts?: OpenPageOptions): Destination;
 /**
  * Build the page-opening tool for a site's pages.
  *
  * @param pages - Every page the agent may open.
- * @param opts - Origin, current page, and the navigation seam.
+ * @param opts - Origin, current page, and the navigation seams.
  * @returns The definition to register.
  */
 export declare function buildOpenPageTool(pages: SitePage[], opts?: OpenPageOptions): ModelContextTool;

package/dist/harness/tools/open-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-page.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/open-page.ts"],"names":[],"mappings":"AAcA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAI1D,OAAO,KAAK,EAAc,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAA4B,MAAM,gBAAgB,CAAC;AAEjI,kCAAkC;AAClC,eAAO,MAAM,cAAc,cAAc,CAAC;AAK1C,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC3C;AAaD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,GAAE,eAAoB,GAAG,gBAAgB,CA6CjG;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,EACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,GACZ;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK3C;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,QAAQ,EAAE,EACjB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,OAAO,CAAC,CAelB"}
+{"version":3,"file":"open-page.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/open-page.ts"],"names":[],"mappings":"AAeA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAA0C,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAIrF,OAAO,KAAK,EAAc,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAA4B,MAAM,gBAAgB,CAAC;AAEjI,kCAAkC;AAClC,eAAO,MAAM,cAAc,cAAc,CAAC;AAK1C,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;IAClB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAgBD,gGAAgG;AAChG,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAerC;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,eAAoB,GACzB,WAAW,CAiDb;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,GAAE,eAAoB,GAAG,gBAAgB,CA8CjG;AAeD;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,EACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,GACZ;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK3C;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,QAAQ,EAAE,EACjB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,OAAO,CAAC,CAgBlB"}