@burtson-labs/agent-core 1.6.13

package/dist/tools/skills/mail-search-skill.js

@@ -0,0 +1,343 @@
+"use strict";
+/**
+ * Mail-search skill — macOS only.
+ *
+ * Lets the agent answer "find my email thread with X about Y" without the
+ * AppleScript trial-and-error pattern (16 iterations,
+ * six 30s `whose subject contains …` timeouts on a large inbox). Two tools:
+ *
+ * mail_search — Spotlight-indexed search over ~/Library/Mail. mdfind
+ * walks the kMD index in milliseconds even on inboxes
+ * with tens of thousands of messages. Returns top hits
+ * with subject / from / date / .emlx path.
+ * mail_read — read a single .emlx by absolute path. Strips the Apple
+ * envelope (byte-count prefix line + trailing plist) and
+ * returns the RFC822 message — headers + body — so the
+ * agent can quote, summarise, or extract a thread.
+ *
+ * Auto-activates when the user mentions email, inbox, or Mail.app —
+ * triggers stay broad because the keyword set is tiny ("email"/"inbox"
+ * are unambiguous). Manifest-level activation is `auto`; per-tool
+ * platform gating happens inside `execute()` so the tool descriptor is
+ * always present in the catalogue but fails cleanly on Linux/Windows.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mailSearchSkill = void 0;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+// Lazily resolved: `os.homedir()` / `path.join` are externalized to
+// `undefined` in browser bundles, so a top-level call here crashed the
+// Stealth Web app on import. This skill is macOS-only and gated behind
+// `darwinGuard()` at execute time, so the path is only ever needed on a
+// real Node host.
+let cachedMailRoot;
+function mailRoot() {
+    if (cachedMailRoot === undefined) {
+        cachedMailRoot = path.join(os.homedir(), 'Library', 'Mail');
+    }
+    return cachedMailRoot;
+}
+const DEFAULT_LIMIT = 20;
+const MAX_LIMIT = 50;
+const READ_BYTE_CAP = 80000;
+function darwinGuard() {
+    if (process.platform !== 'darwin') {
+        return {
+            output: 'mail_search / mail_read are macOS-only — they read Mail.app\'s Spotlight index and ' +
+                '~/Library/Mail .emlx files. On this platform the tool cannot run.',
+            isError: true
+        };
+    }
+    return null;
+}
+/**
+ * Mail.app's data directory sits under macOS TCC (Transparency, Consent,
+ * Control) — the parent process running bandit needs Full Disk Access in
+ * System Settings → Privacy & Security → Full Disk Access. Without it,
+ * `mdfind -onlyin ~/Library/Mail` silently returns ZERO hits even though
+ * the inbox has thousands of messages, which would look identical to a
+ * legitimate "no matches" — a classic source of agent confusion. Probe
+ * once: if we can't readdir ~/Library/Mail, report the permission gap
+ * with the exact remediation step the user needs.
+ */
+function fullDiskAccessGuard() {
+    try {
+        fs.readdirSync(mailRoot());
+        return null;
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 'EPERM' || code === 'EACCES') {
+            return {
+                output: 'macOS Full Disk Access required to read Mail.app data.\n\n' +
+                    'Open System Settings → Privacy & Security → Full Disk Access, click + and add the ' +
+                    'application that launched bandit (Terminal.app, iTerm.app, Ghostty, your VS Code build, etc.). ' +
+                    'Then quit and relaunch that application — TCC permissions only apply to processes started ' +
+                    'AFTER the grant. After that, mail_search / mail_read will work.',
+                isError: true
+            };
+        }
+        if (code === 'ENOENT') {
+            return {
+                output: 'Mail.app data directory not found at ~/Library/Mail. Is Apple Mail set up on this Mac?',
+                isError: true
+            };
+        }
+        return {
+            output: `Could not access ~/Library/Mail: ${err instanceof Error ? err.message : String(err)}`,
+            isError: true
+        };
+    }
+}
+/**
+ * Build the mdfind query from user-supplied filters. Spotlight syntax:
+ * kMDItemKind == 'Mail Message' -- restrict to email
+ * kMDItemAuthors == '*alex*'cd -- author contains
+ * kMDItemSubject == '*DFS*'cd -- subject contains
+ * kMDItemTextContent == '*open api*'cd -- body contains
+ * kMDItemContentCreationDate >= $time.iso(2026-04-01) -- after date
+ *
+ * The 'cd' flags = case-insensitive + diacritic-insensitive. We keep the
+ * query free-text and treat it as a body/subject/author OR-match so a
+ * single string like "alex dfs" finds messages where any of those terms
+ * appear anywhere — that's the usual user intent.
+ */
+function buildQuery(opts) {
+    const clauses = [`kMDItemKind == 'Mail Message'`];
+    if (opts.from) {
+        const escaped = opts.from.replace(/'/g, "\\'");
+        clauses.push(`kMDItemAuthors == '*${escaped}*'cd`);
+    }
+    if (opts.subject) {
+        const escaped = opts.subject.replace(/'/g, "\\'");
+        clauses.push(`kMDItemSubject == '*${escaped}*'cd`);
+    }
+    if (opts.query) {
+        const escaped = opts.query.replace(/'/g, "\\'");
+        // Free-text: match in author OR subject OR body. Spotlight evaluates
+        // the inner OR before AND-ing with the kind/from/subject/since
+        // clauses.
+        clauses.push(`(kMDItemAuthors == '*${escaped}*'cd || kMDItemSubject == '*${escaped}*'cd || kMDItemTextContent == '*${escaped}*'cd)`);
+    }
+    if (opts.since) {
+        // Trust the model to pass an ISO date (YYYY-MM-DD or full ISO).
+        // Spotlight's $time.iso() accepts both.
+        const iso = opts.since.replace(/'/g, '');
+        clauses.push(`kMDItemContentCreationDate >= $time.iso(${iso})`);
+    }
+    return clauses.join(' && ');
+}
+/**
+ * Pull the metadata fields we surface in the search result list. mdls
+ * output looks like:
+ * kMDItemSubject = "FW: DFS Open API"
+ * kMDItemAuthors = ("Chris VanMeerhaeghe <chris@rwtcompany.com>")
+ * kMDItemContentCreationDate = 2026-04-29 16:01:30 +0000
+ * Parse the right-hand side per key, falling back to '' on missing.
+ */
+function parseMdlsOutput(stdout) {
+    const result = { subject: '', from: '', date: '' };
+    for (const line of stdout.split('\n')) {
+        const m = line.match(/^(\w+)\s*=\s*(.*)$/);
+        if (!m)
+            continue;
+        const key = m[1];
+        let value = m[2].trim();
+        // Strip surrounding quotes / parens / array braces.
+        value = value.replace(/^["(]+|[")]+$/g, '').trim();
+        // Multi-author array becomes "a", "b" — keep the first one for
+        // display; the full list is rarely useful in a card-style listing.
+        if (value.includes('","'))
+            value = value.split('","')[0].replace(/^"|"$/g, '');
+        if (key === 'kMDItemSubject')
+            result.subject = value;
+        else if (key === 'kMDItemAuthors')
+            result.from = value;
+        else if (key === 'kMDItemContentCreationDate')
+            result.date = value;
+    }
+    return result;
+}
+const mailSearchTool = {
+    name: 'mail_search',
+    description: 'Search Apple Mail.app via Spotlight. Returns up to N matching messages with subject, sender, ' +
+        'date, and absolute .emlx path you can pass to mail_read. Use this instead of `osascript ... whose ...` ' +
+        '— Spotlight is indexed and returns in <1s even on large inboxes; AppleScript `whose` does a linear ' +
+        'scan and times out at 30s on inboxes with thousands of messages. macOS only.',
+    parameters: [
+        { name: 'query', description: 'Free-text search (matches in author, subject, or body).' },
+        { name: 'from', description: 'Filter by sender substring (e.g. "alex" or "rwtcompany.com").' },
+        { name: 'subject', description: 'Filter by subject substring (e.g. "DFS").' },
+        { name: 'since', description: 'ISO date (YYYY-MM-DD); only messages after this date.' },
+        { name: 'limit', description: 'Max messages to return. Default 20, capped at 50.' }
+    ],
+    async execute(params, ctx) {
+        const guarded = darwinGuard() ?? fullDiskAccessGuard();
+        if (guarded)
+            return guarded;
+        const limit = Math.min(MAX_LIMIT, Math.max(1, parseInt(params.limit ?? '', 10) || DEFAULT_LIMIT));
+        const query = buildQuery({
+            query: params.query?.trim(),
+            from: params.from?.trim(),
+            subject: params.subject?.trim(),
+            since: params.since?.trim()
+        });
+        if (query === `kMDItemKind == 'Mail Message'`) {
+            return {
+                output: 'Refusing to list every message in your inbox — pass at least one of `query`, `from`, ' +
+                    '`subject`, or `since` to narrow the search.',
+                isError: true
+            };
+        }
+        const findResult = await ctx.runCommand('mdfind', ['-onlyin', mailRoot(), query], ctx.workspaceRoot);
+        if (findResult.exitCode !== 0) {
+            return {
+                output: `mdfind failed: ${findResult.stderr.trim() || 'exit ' + findResult.exitCode}`,
+                isError: true
+            };
+        }
+        const paths = findResult.stdout.split('\n').map(s => s.trim()).filter(Boolean).slice(0, limit);
+        if (paths.length === 0) {
+            return { output: '(no matching messages)' };
+        }
+        // Pull metadata per hit. mdls is fast (≤5ms each) so we don't bother
+        // batching — keeps the code simple and per-message failures don't
+        // poison the whole result set.
+        const rows = [];
+        for (const p of paths) {
+            try {
+                const meta = await ctx.runCommand('mdls', ['-name', 'kMDItemSubject', '-name', 'kMDItemAuthors', '-name', 'kMDItemContentCreationDate', p], ctx.workspaceRoot);
+                const parsed = parseMdlsOutput(meta.stdout);
+                rows.push({ ...parsed, path: p });
+            }
+            catch {
+                rows.push({ subject: '(metadata read failed)', from: '', date: '', path: p });
+            }
+        }
+        const lines = rows.map((r, i) => {
+            const subj = r.subject || '(no subject)';
+            const from = r.from || '(unknown sender)';
+            const date = r.date || '(no date)';
+            return `${i + 1}. [${date}] ${from}\n   ${subj}\n   path: ${r.path}`;
+        });
+        const truncatedNote = paths.length === limit
+            ? `\n\n(showing first ${limit} hits — narrow the search if you need more.)`
+            : '';
+        return { output: `Found ${rows.length} message${rows.length === 1 ? '' : 's'}:\n\n${lines.join('\n\n')}${truncatedNote}` };
+    }
+};
+const mailReadTool = {
+    name: 'mail_read',
+    description: 'Read a single Mail.app message by its .emlx file path (from mail_search). Returns the RFC822 ' +
+        'message — headers + body. Strips Apple\'s envelope (byte-count prefix + trailing plist). macOS only.',
+    parameters: [
+        { name: 'path', description: 'Absolute path to a .emlx file (use the path field from a mail_search row).', required: true }
+    ],
+    async execute(params) {
+        const guarded = darwinGuard() ?? fullDiskAccessGuard();
+        if (guarded)
+            return guarded;
+        const filePath = params.path?.trim();
+        if (!filePath) {
+            return { output: 'mail_read requires `path` (the .emlx file from a mail_search row).', isError: true };
+        }
+        // Path safety: only allow absolute paths under ~/Library/Mail with
+        // a recognised .emlx-family extension. Prevents the model from
+        // accidentally aiming this at /etc/passwd or similar.
+        const abs = path.resolve(filePath);
+        const root = mailRoot();
+        if (!abs.startsWith(root + path.sep)) {
+            return {
+                output: `mail_read can only open files under ${root}. Got: ${abs}`,
+                isError: true
+            };
+        }
+        if (!/\.(emlx|partial\.emlx|emlxpart)$/.test(abs)) {
+            return {
+                output: `mail_read expects a .emlx file. Got: ${abs}`,
+                isError: true
+            };
+        }
+        let raw;
+        try {
+            raw = await fs.promises.readFile(abs, 'utf-8');
+        }
+        catch (err) {
+            return {
+                output: `Failed to read ${abs}: ${err instanceof Error ? err.message : String(err)}`,
+                isError: true
+            };
+        }
+        // Apple .emlx layout:
+        // <ascii byte-count>\n
+        // <RFC822 message of exactly that many bytes>
+        // <Apple plist trailer>
+        // Slice out the RFC822 portion using the declared byte count.
+        const firstNewline = raw.indexOf('\n');
+        const byteCount = parseInt(raw.slice(0, firstNewline).trim(), 10);
+        let rfc822 = Number.isFinite(byteCount) && byteCount > 0
+            ? raw.slice(firstNewline + 1, firstNewline + 1 + byteCount)
+            : raw;
+        if (rfc822.length > READ_BYTE_CAP) {
+            rfc822 = rfc822.slice(0, READ_BYTE_CAP) + `\n\n[…truncated, ${rfc822.length - READ_BYTE_CAP} more bytes; use a more specific search to narrow the thread]`;
+        }
+        return { output: rfc822 };
+    }
+};
+exports.mailSearchSkill = {
+    id: 'mac/mail-search',
+    name: 'Mail Search (macOS)',
+    version: '1.0.0',
+    description: 'Search and read Apple Mail.app messages via Spotlight + .emlx — no AppleScript timeouts.',
+    instructions: 'When the user asks about an email thread, who emailed them, or to summarise a conversation: ' +
+        '\n1. Call `mail_search` with `query`/`from`/`subject`/`since` filters. Do NOT use `osascript ... whose ...` ' +
+        'on Mail.app — it scans linearly and times out at 30s on large inboxes.\n' +
+        '2. Pick the relevant `path` from the result list.\n' +
+        '3. Call `mail_read(path=...)` to get the message body.\n' +
+        'For a thread you may need to mail_read 2-3 messages. Prefer `from` over generic `query` when you ' +
+        'know the sender — it returns much fewer false positives.',
+    activation: 'auto',
+    triggerPatterns: [
+        /\bemail\b/i,
+        /\binbox\b/i,
+        /\bmail\.?app\b/i,
+        /\bapple mail\b/i,
+        /\bmessage(s)? from\b/i
+    ],
+    tools: [mailSearchTool, mailReadTool]
+};
+//# sourceMappingURL=mail-search-skill.js.map

package/dist/tools/skills/mail-search-skill.js.map

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

package/dist/tools/skills/plan-skill.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Plan skill — auto-activated on complex multi-file tasks.
+ *
+ * Exposes plan generation as a tool within the tool-use loop.
+ * This bridges the plan-based execution path into the agentic loop:
+ * the model decides when to plan (complex tasks) vs. act directly (simple tasks).
+ */
+import type { SkillManifest } from '../skill-types';
+export declare const planSkill: SkillManifest;
+//# sourceMappingURL=plan-skill.d.ts.map

package/dist/tools/skills/plan-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-skill.d.ts","sourceRoot":"","sources":["../../../src/tools/skills/plan-skill.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAsIpD,eAAO,MAAM,SAAS,EAAE,aAiBvB,CAAC"}

package/dist/tools/skills/plan-skill.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * Plan skill — auto-activated on complex multi-file tasks.
+ *
+ * Exposes plan generation as a tool within the tool-use loop.
+ * This bridges the plan-based execution path into the agentic loop:
+ * the model decides when to plan (complex tasks) vs. act directly (simple tasks).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planSkill = void 0;
+const createPlanTool = {
+    name: 'create_plan',
+    description: 'Generate a structured execution plan for a complex multi-step task. Use this when the task requires coordinating changes across multiple files or systems. Returns a plan with numbered steps you should follow.',
+    parameters: [
+        { name: 'goal', description: 'Clear description of what needs to be accomplished', required: true },
+        { name: 'context_files', description: 'Comma-separated list of relevant file paths to consider in the plan' }
+    ],
+    async execute(params, ctx) {
+        const goal = params.goal?.trim();
+        if (!goal)
+            return { output: 'Error: goal parameter is required', isError: true };
+        // Gather workspace context for the plan
+        const contextFiles = params.context_files
+            ? params.context_files.split(',').map((f) => f.trim()).filter(Boolean)
+            : [];
+        // Read each context file to give the plan generator information
+        const fileContents = [];
+        for (const file of contextFiles.slice(0, 5)) {
+            try {
+                const absPath = file.startsWith('/') ||
+                    file.startsWith('~') ||
+                    /^[A-Za-z]:[\\/]/.test(file) ||
+                    file.startsWith('\\\\')
+                    ? file
+                    : `${ctx.workspaceRoot}/${file}`;
+                const content = await ctx.readFile(absPath);
+                const lines = content.split('\n').length;
+                const preview = content.slice(0, 2000);
+                fileContents.push(`--- ${file} (${lines} lines) ---\n${preview}${content.length > 2000 ? '\n[truncated]' : ''}`);
+            }
+            catch {
+                fileContents.push(`--- ${file} (could not read) ---`);
+            }
+        }
+        // Build a structured plan using heuristic decomposition
+        const steps = decomposeGoal(goal);
+        const plan = {
+            goal,
+            steps: steps.map((step, i) => ({
+                id: `step-${i + 1}`,
+                title: step,
+                status: 'pending'
+            })),
+            contextFiles,
+            totalSteps: steps.length
+        };
+        const output = [
+            `## Plan: ${goal}`,
+            '',
+            `**${plan.totalSteps} steps identified:**`,
+            '',
+            ...plan.steps.map((s) => `${s.id}. ${s.title}`),
+            '',
+            fileContents.length > 0 ? '**Context files reviewed:**' : '',
+            ...fileContents.slice(0, 3).map((c) => c.split('\n')[0]),
+            '',
+            'Execute each step in order using the available tools (read_file, write_file, search_code, etc.).',
+            'After completing all steps, verify the changes are correct.'
+        ].filter(Boolean).join('\n');
+        return { output };
+    }
+};
+/**
+ * Decompose a goal into actionable steps using simple heuristics.
+ * This gives the model a structured starting point within the tool-use loop.
+ */
+function decomposeGoal(goal) {
+    const lower = goal.toLowerCase();
+    // Check for explicit multi-part goals
+    const delimiters = [/ and then /i, / then /i, /;\s*/, / -> /];
+    for (const delimiter of delimiters) {
+        if (delimiter.test(goal)) {
+            const parts = goal.split(delimiter).map((p) => p.trim()).filter(Boolean);
+            if (parts.length > 1)
+                return parts;
+        }
+    }
+    // Common task patterns → step templates
+    const steps = [];
+    if (/\b(refactor|restructure|extract|split)\b/i.test(lower)) {
+        steps.push('Read the target file(s) to understand current structure', 'Identify the code to extract or restructure', 'Create new file(s) if needed', 'Move or refactor the identified code', 'Update imports and references in dependent files', 'Verify no broken imports with search_code');
+    }
+    else if (/\b(fix|bug|error|broken)\b/i.test(lower)) {
+        steps.push('Read the file containing the bug', 'Search for related error patterns or failing tests', 'Identify the root cause', 'Apply the fix', 'Verify the fix resolves the issue');
+    }
+    else if (/\b(add|implement|create|build|feature)\b/i.test(lower)) {
+        steps.push('Read existing related files to understand patterns', 'Create new file(s) for the feature', 'Implement the core logic', 'Wire up imports and exports', 'Add any necessary configuration or setup');
+    }
+    else if (/\b(test|spec)\b/i.test(lower)) {
+        steps.push('Read the source file to understand what needs testing', 'Find existing test files for patterns', 'Write test cases covering main scenarios', 'Run tests to verify they pass');
+    }
+    else {
+        // Generic decomposition
+        steps.push('Explore relevant files to understand context', 'Plan the specific changes needed', 'Implement the changes', 'Verify the changes are correct');
+    }
+    return steps;
+}
+exports.planSkill = {
+    id: 'agent/plan',
+    name: 'Plan',
+    version: '1.0.0',
+    description: 'Generate structured execution plans for complex multi-step tasks.',
+    instructions: 'For complex tasks that touch multiple files, use create_plan first to break the work into steps. For simple single-file tasks, skip planning and use tools directly.',
+    activation: 'auto',
+    triggerPatterns: [
+        /\brefactor\b/i,
+        /\bmulti.?file\b/i,
+        /\bmigrat/i,
+        /\brestructure\b/i,
+        /\barchitect/i,
+        /\boverhaul\b/i,
+        /\breorganize\b/i
+    ],
+    tools: [createPlanTool]
+};
+//# sourceMappingURL=plan-skill.js.map

package/dist/tools/skills/plan-skill.js.map

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

package/dist/tools/skills/semantic-search-skill.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Semantic search skill — auto-activated when users ask about code concepts,
+ * architecture, or need to find code by meaning rather than literal text.
+ *
+ * Uses Ollama's nomic-embed-text model for local embeddings. Indexes workspace
+ * files on first search and caches vectors in memory for the session.
+ *
+ * Requires Ollama running locally with nomic-embed-text installed:
+ *   ollama pull nomic-embed-text
+ */
+import type { SkillManifest } from '../skill-types';
+export declare const semanticSearchSkill: SkillManifest;
+/**
+ * Configure the Ollama base URL for the embedding client.
+ * Call this before the skill is used if Ollama is not on localhost.
+ */
+export declare function configureSemanticSearchOllamaUrl(url: string): void;
+/**
+ * Reset the in-memory index (e.g. on workspace change).
+ */
+export declare function resetSemanticIndex(): void;
+//# sourceMappingURL=semantic-search-skill.d.ts.map

package/dist/tools/skills/semantic-search-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-search-skill.d.ts","sourceRoot":"","sources":["../../../src/tools/skills/semantic-search-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAuNpD,eAAO,MAAM,mBAAmB,EAAE,aAkBjC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}