@nodetool-ai/agents 0.7.0-rc.23 → 0.8.2

package/dist/capabilities/documents.specs.js

@@ -0,0 +1,201 @@
+/**
+ * The `documents` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `documents.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `documents.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+export const extractPdfTextSpec = {
+    name: "extract_pdf_text",
+    description: "Extract plain text from a PDF document",
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "Path to the PDF file"
+            },
+            start_page: {
+                type: "integer",
+                description: "First page to extract (0-based index)",
+                default: 0
+            },
+            end_page: {
+                type: "integer",
+                description: "Last page to extract (-1 for last page)",
+                default: -1
+            }
+        },
+        required: ["path"]
+    },
+    category: "read",
+    userMessage: (params) => {
+        const path = params["path"] ?? "a PDF";
+        const msg = `Extracting text from ${path}...`;
+        return msg.length > 80 ? "Extracting text from PDF..." : msg;
+    }
+};
+export const extractPdfTablesSpec = {
+    name: "extract_pdf_tables",
+    description: "Extract tables from a PDF document to a JSON file",
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "Path to the PDF file"
+            },
+            output_file: {
+                type: "string",
+                description: "Path to the output JSON file"
+            },
+            start_page: {
+                type: "integer",
+                description: "First page to extract (0-based index)",
+                default: 0
+            },
+            end_page: {
+                type: "integer",
+                description: "Last page to extract (-1 for last page)",
+                default: -1
+            }
+        },
+        required: ["path", "output_file"]
+    },
+    category: "read",
+    userMessage: (params) => {
+        const path = params["path"] ?? "a PDF";
+        const output = params["output_file"] ?? "output";
+        let msg = `Extracting tables from ${path} to ${output}...`;
+        if (msg.length > 80)
+            msg = `Extracting tables from PDF to ${output}...`;
+        if (msg.length > 80)
+            msg = "Extracting tables from PDF...";
+        return msg;
+    }
+};
+export const convertPdfToMarkdownSpec = {
+    name: "convert_pdf_to_markdown",
+    description: "Convert PDF to Markdown format",
+    inputSchema: {
+        type: "object",
+        properties: {
+            input_file: {
+                type: "string",
+                description: "Path to the input PDF file"
+            },
+            output_file: {
+                type: "string",
+                description: "Path to the output Markdown file"
+            },
+            start_page: {
+                type: "integer",
+                description: "First page to extract (0-based index)",
+                default: 0
+            },
+            end_page: {
+                type: "integer",
+                description: "Last page to extract (-1 for last page)",
+                default: -1
+            }
+        },
+        required: ["input_file", "output_file"]
+    },
+    category: "read",
+    userMessage: (params) => {
+        const inputFile = params["input_file"] ?? "a PDF";
+        const outputFile = params["output_file"] ?? "Markdown";
+        let msg = `Converting ${inputFile} to ${outputFile}...`;
+        if (msg.length > 80)
+            msg = `Converting PDF to ${outputFile}...`;
+        if (msg.length > 80)
+            msg = "Converting PDF to Markdown...";
+        return msg;
+    }
+};
+export const convertMarkdownToPdfSpec = {
+    name: "convert_markdown_to_pdf",
+    description: "Convert Markdown to PDF using Pandoc.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            input_file: {
+                type: "string",
+                description: "Path to the input Markdown file"
+            },
+            output_file: {
+                type: "string",
+                description: "Path to the output PDF file"
+            }
+        },
+        required: ["input_file", "output_file"]
+    },
+    category: "write",
+    userMessage: (params) => {
+        const inputFile = params["input_file"] ?? "Markdown";
+        const outputFile = params["output_file"] ?? "a PDF";
+        let msg = `Converting ${inputFile} to ${outputFile}...`;
+        if (msg.length > 80)
+            msg = `Converting Markdown to ${outputFile}...`;
+        if (msg.length > 80)
+            msg = "Converting Markdown to PDF...";
+        return msg;
+    }
+};
+export const convertDocumentSpec = {
+    name: "convert_document",
+    description: "Convert between document formats using Pandoc, supports markdown, docx, rst, pdf, html, etc.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            input_file: {
+                type: "string",
+                description: "Path to the input file"
+            },
+            output_file: {
+                type: "string",
+                description: "Path to the output file"
+            },
+            from_format: {
+                type: "string",
+                description: "Input format (e.g., markdown, docx, rst)",
+                default: "markdown"
+            },
+            to_format: {
+                type: "string",
+                description: "Output format (e.g., pdf, docx, html)",
+                default: "pdf"
+            },
+            extra_args: {
+                type: "array",
+                description: "Additional Pandoc arguments",
+                items: { type: "string" },
+                default: []
+            }
+        },
+        required: ["input_file", "output_file"]
+    },
+    category: "write",
+    userMessage: (params) => {
+        const inputFile = params["input_file"] ?? "input";
+        const outputFile = params["output_file"] ?? "output";
+        const toFormat = params["to_format"] ?? "target format";
+        let msg = `Converting ${inputFile} to ${outputFile} (${toFormat})...`;
+        if (msg.length > 80)
+            msg = `Converting ${inputFile} to ${toFormat}...`;
+        if (msg.length > 80)
+            msg = `Converting document to ${toFormat}...`;
+        return msg;
+    }
+};
+/** Every spec this module declares, in declaration order. */
+export const documentsSpecs = [
+    extractPdfTextSpec,
+    extractPdfTablesSpec,
+    convertPdfToMarkdownSpec,
+    convertMarkdownToPdfSpec,
+    convertDocumentSpec
+];
+//# sourceMappingURL=documents.specs.js.map

package/dist/capabilities/documents.specs.js.map

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

package/dist/capabilities/email.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The `email` capability module — Gmail over IMAP.
+ *
+ * Three capabilities that used to be three `Tool` subclasses in
+ * `email-tools.ts`. Wire names, descriptions and schemas are unchanged; a
+ * belt builds all three from `email.specs.ts` by name.
+ *
+ * `imapflow` and `mailparser` are imported inside the connection helper and
+ * the parse path rather than at module scope, so a run that never touches
+ * email never loads an IMAP client.
+ *
+ * Design: docs/tool-class-retirement-design.md § "PRs 4–9 — remaining
+ * namespaces".
+ */
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+declare const searchEmail: CapabilityExport;
+declare const archiveEmail: CapabilityExport;
+declare const addLabelToEmail: CapabilityExport;
+/** Every email capability, in the order email-tools.ts declared them. */
+export declare const EMAIL_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { searchEmail, archiveEmail, addLabelToEmail };
+//# sourceMappingURL=email.d.ts.map

package/dist/capabilities/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/capabilities/email.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiErE,QAAA,MAAM,WAAW,EAAE,gBAgFlB,CAAC;AAMF,QAAA,MAAM,YAAY,EAAE,gBAkDnB,CAAC;AAMF,QAAA,MAAM,eAAe,EAAE,gBAgCtB,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAIzD,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/capabilities/email.js

@@ -0,0 +1,226 @@
+/**
+ * The `email` capability module — Gmail over IMAP.
+ *
+ * Three capabilities that used to be three `Tool` subclasses in
+ * `email-tools.ts`. Wire names, descriptions and schemas are unchanged; a
+ * belt builds all three from `email.specs.ts` by name.
+ *
+ * `imapflow` and `mailparser` are imported inside the connection helper and
+ * the parse path rather than at module scope, so a run that never touches
+ * email never loads an IMAP client.
+ *
+ * Design: docs/tool-class-retirement-design.md § "PRs 4–9 — remaining
+ * namespaces".
+ */
+import { stripTags, stripToFixpoint } from "./html-text.js";
+import { searchEmailSpec, archiveEmailSpec, addLabelToEmailSpec } from "./email.specs.js";
+import { isString } from "../utils/type-guards.js";
+function stripHtml(html) {
+    const text = html
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<\/p>/gi, "\n\n")
+        .replace(/<\/div>/gi, "\n");
+    return (stripToFixpoint(text, stripTags)
+        .replace(/&nbsp;/g, " ")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        // Last, so "&amp;lt;" decodes once — to "&lt;", not to "<".
+        .replace(/&amp;/g, "&")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim());
+}
+async function createGmailConnection(context) {
+    const emailAddress = (await context.getSecret("GOOGLE_MAIL_USER")) ??
+        process.env.GOOGLE_MAIL_USER;
+    const appPassword = (await context.getSecret("GOOGLE_APP_PASSWORD")) ??
+        process.env.GOOGLE_APP_PASSWORD;
+    if (!emailAddress) {
+        throw new Error("GOOGLE_MAIL_USER is not set");
+    }
+    if (!appPassword) {
+        throw new Error("GOOGLE_APP_PASSWORD is not set");
+    }
+    const { ImapFlow: ImapFlowClient } = await import("imapflow");
+    const client = new ImapFlowClient({
+        host: "imap.gmail.com",
+        port: 993,
+        secure: true,
+        auth: {
+            user: emailAddress,
+            pass: appPassword
+        },
+        logger: false
+    });
+    await client.connect();
+    return client;
+}
+// ---------------------------------------------------------------------------
+// search_email
+// ---------------------------------------------------------------------------
+const searchEmail = {
+    spec: searchEmailSpec,
+    impl: async (run, params) => {
+        let client = null;
+        try {
+            client = await createGmailConnection(run.context);
+            const lock = await client.getMailboxLock("INBOX");
+            try {
+                const { simpleParser } = await import("mailparser");
+                const searchCriteria = {};
+                if (params.subject) {
+                    searchCriteria.subject = params.subject;
+                }
+                if (params.text) {
+                    searchCriteria.body = params.text;
+                }
+                const sinceHours = params.since_hours_ago ?? 6;
+                const sinceDate = new Date(Date.now() - sinceHours * 60 * 60 * 1000);
+                searchCriteria.since = sinceDate;
+                const uids = await client.search(searchCriteria, { uid: true });
+                if (!uids || uids.length === 0) {
+                    return [];
+                }
+                // Newest first
+                uids.reverse();
+                const maxResults = Math.min(uids.length, params.max_results ?? 50);
+                const selectedUids = uids.slice(0, maxResults);
+                const results = [];
+                for await (const msg of client.fetch(selectedUids.map(String).join(","), { source: true, uid: true }, { uid: true })) {
+                    const parsed = await simpleParser(msg.source ?? Buffer.alloc(0));
+                    let body = "";
+                    if (parsed.html) {
+                        body = stripHtml(parsed.html);
+                    }
+                    else if (parsed.text) {
+                        body = parsed.text;
+                    }
+                    results.push({
+                        message_id: String(msg.uid),
+                        subject: parsed.subject ?? "",
+                        sender: parsed.from?.text ?? "",
+                        body
+                    });
+                }
+                return results;
+            }
+            finally {
+                lock.release();
+            }
+        }
+        catch (e) {
+            return { error: e instanceof Error ? e.message : String(e) };
+        }
+        finally {
+            if (client) {
+                await client.logout().catch(() => {
+                    /* Intentional: best-effort IMAP logout during cleanup */
+                });
+            }
+        }
+    }
+};
+// ---------------------------------------------------------------------------
+// archive_email
+// ---------------------------------------------------------------------------
+const archiveEmail = {
+    spec: archiveEmailSpec,
+    impl: async (run, params) => {
+        let client = null;
+        try {
+            client = await createGmailConnection(run.context);
+            const lock = await client.getMailboxLock("INBOX");
+            try {
+                let messageIds = params.message_ids;
+                if (isString(messageIds)) {
+                    messageIds = [messageIds];
+                }
+                const archivedIds = [];
+                for (const id of messageIds) {
+                    try {
+                        // Archiving in Gmail = removing the message from INBOX. `\Inbox` is
+                        // not an IMAP flag, so messageFlagsRemove was a silent no-op; move
+                        // the message to [Gmail]/All Mail, which drops the Inbox label.
+                        const moved = await client.messageMove(id, "[Gmail]/All Mail", {
+                            uid: true
+                        });
+                        // messageMove resolves even when nothing matched; only report
+                        // messages the server actually moved.
+                        if (moved) {
+                            archivedIds.push(id);
+                        }
+                    }
+                    catch {
+                        // Skip failed messages
+                    }
+                }
+                return {
+                    success: true,
+                    archived_messages: archivedIds
+                };
+            }
+            finally {
+                lock.release();
+            }
+        }
+        catch (e) {
+            return { error: e instanceof Error ? e.message : String(e) };
+        }
+        finally {
+            if (client) {
+                await client.logout().catch(() => {
+                    /* Intentional: best-effort IMAP logout during cleanup */
+                });
+            }
+        }
+    }
+};
+// ---------------------------------------------------------------------------
+// add_label_to_email
+// ---------------------------------------------------------------------------
+const addLabelToEmail = {
+    spec: addLabelToEmailSpec,
+    impl: async (run, params) => {
+        let client = null;
+        try {
+            client = await createGmailConnection(run.context);
+            const lock = await client.getMailboxLock("INBOX");
+            try {
+                const messageId = params.message_id;
+                const label = params.label;
+                await client.messageFlagsAdd(messageId, [label], { uid: true });
+                return {
+                    success: true,
+                    message_id: messageId,
+                    label
+                };
+            }
+            finally {
+                lock.release();
+            }
+        }
+        catch (e) {
+            return { error: e instanceof Error ? e.message : String(e) };
+        }
+        finally {
+            if (client) {
+                await client.logout().catch(() => {
+                    /* Intentional: best-effort IMAP logout during cleanup */
+                });
+            }
+        }
+    }
+};
+/** Every email capability, in the order email-tools.ts declared them. */
+export const EMAIL_CAPABILITIES = [
+    searchEmail,
+    archiveEmail,
+    addLabelToEmail
+];
+export const module = {
+    module: "email",
+    exports: EMAIL_CAPABILITIES
+};
+export { searchEmail, archiveEmail, addLabelToEmail };
+//# sourceMappingURL=email.js.map

package/dist/capabilities/email.js.map

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

package/dist/capabilities/email.specs.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The `email` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `email.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `email.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+import type { CapabilitySpec } from "./types.js";
+export declare const searchEmailSpec: CapabilitySpec;
+export declare const archiveEmailSpec: CapabilitySpec;
+export declare const addLabelToEmailSpec: CapabilitySpec;
+/** Every spec this module declares, in declaration order. */
+export declare const emailSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=email.specs.d.ts.map

package/dist/capabilities/email.specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/email.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,eAAe,EAAE,cAsC7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,cAqB9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAuBjC,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,UAAU,EAAE,SAAS,cAAc,EAI/C,CAAC"}

package/dist/capabilities/email.specs.js

@@ -0,0 +1,102 @@
+/**
+ * The `email` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `email.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `email.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+export const searchEmailSpec = {
+    name: "search_email",
+    description: "Search Gmail by subject, text, and date. Returns a list of emails with message_id, subject, sender, and body.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            subject: {
+                type: "string",
+                description: "Text to search for in email subject"
+            },
+            since_hours_ago: {
+                type: "integer",
+                description: "Number of hours ago to search for",
+                default: 6
+            },
+            text: {
+                type: "string",
+                description: "General text to search for anywhere in the email"
+            },
+            max_results: {
+                type: "integer",
+                description: "Maximum number of emails to return",
+                default: 50
+            }
+        }
+    },
+    category: "read",
+    userMessage: (params) => {
+        const parts = [];
+        if (params.subject)
+            parts.push(`subject: '${params.subject}'`);
+        if (params.text)
+            parts.push(`text: '${params.text}'`);
+        if (params.since_hours_ago)
+            parts.push(`since: ${params.since_hours_ago} hours ago`);
+        const queryStr = parts.length > 0 ? parts.join(", ") : "emails";
+        const msg = `Searching ${queryStr}...`;
+        return msg.length > 80 ? "Searching emails..." : msg;
+    }
+};
+export const archiveEmailSpec = {
+    name: "archive_email",
+    description: "Move specified emails to Gmail archive",
+    inputSchema: {
+        type: "object",
+        properties: {
+            message_ids: {
+                type: "array",
+                items: { type: "string" },
+                description: "List of message IDs to archive"
+            }
+        },
+        required: ["message_ids"]
+    },
+    category: "external",
+    userMessage: (params) => {
+        const ids = params.message_ids ?? [];
+        return ids.length === 1
+            ? `Archiving email ${ids[0]}...`
+            : `Archiving ${ids.length} emails...`;
+    }
+};
+export const addLabelToEmailSpec = {
+    name: "add_label_to_email",
+    description: "Add a label to a Gmail message",
+    inputSchema: {
+        type: "object",
+        properties: {
+            message_id: {
+                type: "string",
+                description: "Message ID to label"
+            },
+            label: {
+                type: "string",
+                description: "Label to add to the message"
+            }
+        },
+        required: ["message_id", "label"]
+    },
+    category: "external",
+    userMessage: (params) => {
+        const label = params.label ?? "a label";
+        const msg = `Adding label '${label}' to email ${params.message_id}...`;
+        return msg.length > 80 ? `Adding label '${label}' to email...` : msg;
+    }
+};
+/** Every spec this module declares, in declaration order. */
+export const emailSpecs = [
+    searchEmailSpec,
+    archiveEmailSpec,
+    addLabelToEmailSpec
+];
+//# sourceMappingURL=email.specs.js.map

package/dist/capabilities/email.specs.js.map

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

package/dist/capabilities/entities.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The `entities` capability module — the ingredients library, headlessly.
+ *
+ * An entity is an ordinary image asset carrying a marker under
+ * `metadata.nodetool_entity`: the kind, the name, and the descriptor that gets
+ * pasted into every prompt naming it. That is what holds a character or a look
+ * steady from shot to shot.
+ *
+ * The browser reads the library through `ui_entity_list` / `ui_entity_apply`,
+ * which need an open app. These six answer the same questions with no
+ * browser: list, read one, season a prompt, tag an asset as an entity,
+ * edit one (its fields, or the picture it shows), and untag one. The injection rule itself is `injectEntities` in
+ * `@nodetool-ai/protocol`, shared with the browser tool and the Director node,
+ * so a prompt seasoned here and one seasoned in the editor come out the same.
+ */
+import { ENTITY_KINDS, ENTITY_METADATA_KEY, type Entity } from "@nodetool-ai/protocol";
+import { entityFromAsset } from "@nodetool-ai/models";
+import type { CapabilityExport, CapabilityModule, CapabilityRun } from "./types.js";
+export { ENTITY_KINDS, ENTITY_METADATA_KEY };
+/**
+ * The marker field naming the image an entity shows, when it is not the marker
+ * asset's own bytes. Swapping the picture writes this rather than moving the
+ * marker, so the entity id — which boards and scripts store — never moves.
+ */
+export declare const REFERENCE_ASSET_KEY = "reference_asset_id";
+type ToolError = {
+    error: string;
+};
+/**
+ * The one reader of an entity's marker, re-exported so callers that already
+ * import this module keep reaching it here. It lives in `@nodetool-ai/models`
+ * because the websocket host serves the same entities to a running graph.
+ */
+export { entityFromAsset };
+/**
+ * Every entity in the caller's library, or only one project's when
+ * `projectId` is given. The library is shared across projects on purpose — an
+ * entity is reusable, and seasoning a prompt must find one wherever it was
+ * made — so nothing here filters unless a caller asks.
+ */
+export declare function loadEntities(run: CapabilityRun, projectId?: string): Promise<Entity[] | ToolError>;
+declare const listEntities: CapabilityExport;
+declare const getEntity: CapabilityExport;
+declare const applyEntities: CapabilityExport;
+declare const createEntity: CapabilityExport;
+declare const updateEntity: CapabilityExport;
+declare const deleteEntity: CapabilityExport;
+/** Every entity capability, in declaration order. */
+export declare const ENTITY_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { listEntities, getEntity, applyEntities, createEntity, updateEntity, deleteEntity };
+//# sourceMappingURL=entities.d.ts.map

package/dist/capabilities/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/capabilities/entities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,KAAK,MAAM,EACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAiBpB,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AAKxD,KAAK,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAOnC;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,aAAa,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAY/B;AAeD,QAAA,MAAM,YAAY,EAAE,gBAoCnB,CAAC;AAEF,QAAA,MAAM,SAAS,EAAE,gBAoBhB,CAAC;AAEF,QAAA,MAAM,aAAa,EAAE,gBA6BpB,CAAC;AAyKF,QAAA,MAAM,YAAY,EAAE,gBA2BnB,CAAC;AAuBF,QAAA,MAAM,YAAY,EAAE,gBAgGnB,CAAC;AAGF,QAAA,MAAM,YAAY,EAAE,gBA8BnB,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAO1D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EACL,YAAY,EACZ,SAAS,EACT,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,CAAC"}