@theihtisham/agent-shadow-brain 7.2.0 → 7.22.1

package/dist/brain/project-kit-inspection.js

@@ -0,0 +1,200 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { GlobalBrain } from './global-brain.js';
+import { projectLocalPath, projectRoot, readProjectFile, skipProjectTreeName } from './project-kit-paths.js';
+const ENTRY_LIMIT = 500;
+const DIRECTORY_DEPTH = 3;
+const MANIFEST_LIMIT = 64 * 1024;
+const EVIDENCE_LIMIT = 80;
+const CHECK_LIMIT = 30;
+const NODE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun'];
+const LOCKS = new Map([
+    ['package-lock.json', 'npm'], ['npm-shrinkwrap.json', 'npm'], ['pnpm-lock.yaml', 'pnpm'], ['yarn.lock', 'yarn'],
+    ['bun.lock', 'bun'], ['bun.lockb', 'bun'], ['composer.lock', 'Composer'], ['poetry.lock', 'Poetry'],
+    ['uv.lock', 'uv'], ['pipfile.lock', 'Pipenv'], ['cargo.lock', 'Cargo'], ['go.sum', 'Go modules'],
+    ['gemfile.lock', 'Bundler'], ['mix.lock', 'Mix'], ['pubspec.lock', 'Pub'],
+]);
+const MANIFESTS = new Map([
+    ['package.json', 'Node.js'], ['composer.json', 'PHP'], ['pyproject.toml', 'Python'], ['requirements.txt', 'Python'],
+    ['pipfile', 'Python'], ['go.mod', 'Go'], ['cargo.toml', 'Rust'], ['gemfile', 'Ruby'], ['mix.exs', 'Elixir'],
+    ['pom.xml', 'Java'], ['build.gradle', 'Gradle'], ['build.gradle.kts', 'Gradle'], ['package.swift', 'Swift'],
+    ['pubspec.yaml', 'Dart'], ['deno.json', 'Deno'], ['deno.jsonc', 'Deno'],
+]);
+const FRAMEWORKS = new Map([
+    ['typescript', 'TypeScript'], ['react', 'React'], ['react-native', 'React Native'], ['next', 'Next.js'],
+    ['vite', 'Vite'], ['vue', 'Vue'], ['nuxt', 'Nuxt'], ['svelte', 'Svelte'], ['@sveltejs/kit', 'SvelteKit'],
+    ['@angular/core', 'Angular'], ['astro', 'Astro'], ['express', 'Express'], ['fastify', 'Fastify'],
+    ['@nestjs/core', 'NestJS'], ['electron', 'Electron'], ['vitest', 'Vitest'], ['jest', 'Jest'],
+    ['@playwright/test', 'Playwright'], ['laravel/framework', 'Laravel'], ['symfony/framework-bundle', 'Symfony'],
+    ['phpunit/phpunit', 'PHPUnit'],
+]);
+const SCRIPTS = new Map([
+    ['test', 'Test'], ['test:unit', 'Unit tests'], ['test:e2e', 'End-to-end tests'], ['lint', 'Lint'],
+    ['typecheck', 'Type check'], ['type-check', 'Type check'], ['check', 'Check'], ['verify', 'Verify'], ['build', 'Build'],
+]);
+function evidenceFor(relative) {
+    const name = path.posix.basename(relative).toLowerCase();
+    const lock = LOCKS.get(name);
+    if (lock)
+        return { path: relative, kind: 'lockfile', signals: [lock] };
+    const manifest = MANIFESTS.get(name);
+    if (manifest)
+        return { path: relative, kind: 'manifest', signals: [manifest] };
+    let marker;
+    if (name === 'tsconfig.json')
+        marker = 'TypeScript';
+    else if (name === 'dockerfile' || /^compose\.ya?ml$/.test(name) || /^docker-compose\.ya?ml$/.test(name))
+        marker = 'Docker';
+    else if (/\.(csproj|fsproj|sln|slnx)$/.test(name))
+        marker = '.NET';
+    else if (relative.toLowerCase() === 'projectsettings/projectversion.txt')
+        marker = 'Unity';
+    else if (name.endsWith('.uproject'))
+        marker = 'Unreal Engine';
+    else if (name === 'project.godot')
+        marker = 'Godot';
+    else if (name.endsWith('.blend'))
+        marker = 'Blender';
+    return marker ? { path: relative, kind: 'marker', signals: [marker] } : undefined;
+}
+function walkProject(root, warnings) {
+    const pending = [{ relative: '', depth: 0 }];
+    const evidence = [];
+    let entries = 0;
+    let truncated = false;
+    for (const directory of pending) {
+        if (entries >= ENTRY_LIMIT) {
+            truncated = true;
+            break;
+        }
+        try {
+            const absolute = directory.relative ? projectLocalPath(root, directory.relative) : root;
+            const handle = fs.opendirSync(absolute);
+            try {
+                for (let child = handle.readSync(); child; child = handle.readSync()) {
+                    if (entries === ENTRY_LIMIT) {
+                        truncated = true;
+                        break;
+                    }
+                    entries++;
+                    if (skipProjectTreeName(child.name) || child.isSymbolicLink())
+                        continue;
+                    const relative = directory.relative ? directory.relative + '/' + child.name : child.name;
+                    if (child.isDirectory()) {
+                        if (directory.depth + 1 < DIRECTORY_DEPTH)
+                            pending.push({ relative, depth: directory.depth + 1 });
+                        else
+                            truncated = true;
+                    }
+                    else if (child.isFile()) {
+                        const item = evidenceFor(relative);
+                        if (!item)
+                            continue;
+                        try {
+                            const stat = fs.lstatSync(projectLocalPath(root, relative), { throwIfNoEntry: false });
+                            if (stat?.isFile() && stat.nlink === 1)
+                                evidence.push(item);
+                        }
+                        catch {
+                            warnings.add('Some project markers were unavailable or linked.');
+                        }
+                    }
+                }
+            }
+            finally {
+                handle.closeSync();
+            }
+        }
+        catch {
+            warnings.add('Some project directories or markers could not be safely inspected.');
+        }
+    }
+    evidence.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+    if (truncated)
+        warnings.add('Inspection reached its depth or entry limit. The profile may omit deeper components.');
+    if (evidence.length > EVIDENCE_LIMIT)
+        warnings.add('Only the first 80 recognized project markers are shown.');
+    return { evidence: evidence.slice(0, EVIDENCE_LIMIT), coverage: { entries, limit: ENTRY_LIMIT, truncated: truncated || evidence.length > EVIDENCE_LIMIT } };
+}
+function object(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function nodeManager(value) {
+    return typeof value === 'string' ? NODE_MANAGERS.find(manager => value.startsWith(manager + '@')) : undefined;
+}
+function observeManifest(root, entry, nearbyLocks, managers, checks, warnings) {
+    const filename = path.posix.basename(entry.path).toLowerCase();
+    if (filename !== 'package.json' && filename !== 'composer.json')
+        return;
+    try {
+        const buffer = readProjectFile(root, entry.path, MANIFEST_LIMIT);
+        if (!buffer)
+            return;
+        const manifest = object(JSON.parse(buffer.toString('utf8').replace(/^\uFEFF/, '')));
+        const node = filename === 'package.json';
+        const dependencies = node ? [manifest.dependencies, manifest.devDependencies, manifest.peerDependencies] :
+            [manifest.require, manifest['require-dev']];
+        for (const [name, label] of FRAMEWORKS) {
+            if (dependencies.some(section => Object.hasOwn(object(section), name)))
+                entry.signals.push(label);
+        }
+        const declared = node ? nodeManager(manifest.packageManager) : 'Composer';
+        if (declared) {
+            managers.add(declared);
+            entry.signals.push(declared);
+        }
+        const scripts = object(manifest.scripts);
+        const locked = nearbyLocks.find(manager => NODE_MANAGERS.some(known => manager === known));
+        const runner = declared ?? locked ?? 'npm';
+        for (const [script, label] of SCRIPTS) {
+            if (!Object.hasOwn(scripts, script))
+                continue;
+            if (node && !declared && !locked)
+                warnings.add('Node checks without a declared or lockfile package manager use npm command syntax.');
+            const command = node ? runner + ' run ' + script : 'composer run-script ' + script;
+            checks.push({ label, command, source: entry.path });
+        }
+    }
+    catch {
+        warnings.add('A recognized JSON manifest could not be read as a regular, bounded JSON file.');
+    }
+}
+/** Inspect one explicit project using only known marker names and allowlisted manifest fields. */
+export function inspectProject(value) {
+    const root = projectRoot(value);
+    const warnings = new Set();
+    const { evidence, coverage } = walkProject(root, warnings);
+    const checks = [];
+    const stack = new Set();
+    const packageManagers = new Set();
+    const localLocks = new Map();
+    for (const entry of evidence) {
+        if (entry.kind === 'lockfile') {
+            const manager = entry.signals[0];
+            const parent = path.posix.dirname(entry.path);
+            localLocks.set(parent, [...localLocks.get(parent) ?? [], manager]);
+            packageManagers.add(manager);
+        }
+    }
+    for (const entry of evidence) {
+        if (entry.kind === 'lockfile')
+            continue;
+        const before = entry.signals[0];
+        stack.add(before);
+        observeManifest(root, entry, localLocks.get(path.posix.dirname(entry.path)) ?? localLocks.get('.') ?? [], packageManagers, checks, warnings);
+        for (const signal of entry.signals.slice(1)) {
+            if (!packageManagers.has(signal))
+                stack.add(signal);
+        }
+    }
+    if (!evidence.length)
+        warnings.add('No recognized stack markers were found in the bounded scan.');
+    if (checks.length > CHECK_LIMIT)
+        warnings.add('Only the first 30 declared checks are shown.');
+    return {
+        schemaVersion: 1, projectId: GlobalBrain.projectIdFor(root), projectName: path.basename(root), root,
+        observedAt: new Date().toISOString(), stack: [...stack].sort(), packageManagers: [...packageManagers].sort(),
+        evidence, checks: checks.slice(0, CHECK_LIMIT), coverage, warnings: [...warnings],
+    };
+}
+//# sourceMappingURL=project-kit-inspection.js.map

package/dist/brain/project-kit-inspection.js.map

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

package/dist/brain/project-kit-paths.d.ts

@@ -0,0 +1,13 @@
+export type ProjectKitErrorCode = 'PROJECT_KIT_UNSAFE_PATH' | 'PROJECT_KIT_CONFLICT' | 'PROJECT_KIT_STALE_PLAN' | 'PROJECT_KIT_WRITE_FAILED';
+export declare class ProjectKitError extends Error {
+    readonly code: ProjectKitErrorCode;
+    constructor(code: ProjectKitErrorCode, message: string);
+}
+export declare function projectRoot(value: string): string;
+/** Check existing project-relative ancestors without creating or opening any files. */
+export declare function projectLocalPath(root: string, relativePath: string): string;
+/** Create only the requested relative directory, checking each component as it is reached. */
+export declare function ensureProjectDirectory(root: string, relativePath: string): string;
+export declare function readProjectFile(root: string, relativePath: string, limit: number): Buffer | undefined;
+export declare function skipProjectTreeName(name: string): boolean;
+//# sourceMappingURL=project-kit-paths.d.ts.map

package/dist/brain/project-kit-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-kit-paths.d.ts","sourceRoot":"","sources":["../../src/brain/project-kit-paths.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,GAAG,sBAAsB,GAAG,wBAAwB,GAAG,0BAA0B,CAAC;AAE7I,qBAAa,eAAgB,SAAQ,KAAK;IAC5B,QAAQ,CAAC,IAAI,EAAE,mBAAmB;gBAAzB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM;CAIhE;AAkBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoCjD;AA8BD,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,8FAA8F;AAC9F,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA4BrG;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzD"}

package/dist/brain/project-kit-paths.js

@@ -0,0 +1,141 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { matchesFileIdentity } from './file-identity.js';
+export class ProjectKitError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ProjectKitError';
+    }
+}
+const PROTECTED = new Set([
+    '.agents', '.aws', '.azure', '.cache', '.claude', '.codex', '.config', '.docker', '.dsh', '.git', '.gnupg',
+    '.kube', '.opencode', '.shadow-brain', '.ssh', 'application support', 'credentials', 'keychains', 'node_modules',
+    'program files', 'program files (x86)', 'secrets', 'system32',
+]);
+const UNSAFE_COMPONENT = /[\u0000-\u001f\u007f<>:"|?*]|[ .]$/u;
+function unsafe(message) {
+    throw new ProjectKitError('PROJECT_KIT_UNSAFE_PATH', message);
+}
+function within(ancestor, child) {
+    const relative = path.relative(ancestor, child);
+    return !path.isAbsolute(relative) && relative !== '..' && !relative.startsWith('..' + path.sep);
+}
+export function projectRoot(value) {
+    if (typeof value !== 'string' || !value.trim() || /[\u0000-\u001f\u007f]/u.test(value)) {
+        throw new TypeError('Select an existing project directory.');
+    }
+    const resolved = path.resolve(value);
+    const inspectAncestors = (directory) => {
+        const drive = path.parse(directory).root;
+        const components = directory.slice(drive.length).split(path.sep);
+        if (!path.relative(drive, directory) || drive.startsWith('\\\\') || components.some(part => PROTECTED.has(part.toLowerCase()))) {
+            unsafe('Select a project outside filesystem, home, and protected configuration roots.');
+        }
+        let current = drive;
+        for (const component of components) {
+            if (UNSAFE_COMPONENT.test(component))
+                unsafe('Project directory contains an unsupported path component.');
+            current = path.join(current, component);
+            const stat = fs.lstatSync(current, { throwIfNoEntry: false });
+            if (!stat?.isDirectory() || stat.isSymbolicLink())
+                unsafe('Project directory and its ancestors must be real directories.');
+        }
+    };
+    inspectAncestors(resolved);
+    const original = fs.statSync(resolved, { bigint: true });
+    const canonical = fs.realpathSync.native(resolved);
+    inspectAncestors(canonical);
+    const home = fs.realpathSync.native(os.homedir());
+    const temp = fs.realpathSync.native(os.tmpdir());
+    const names = canonical.slice(path.parse(canonical).root.length).split(path.sep).map(part => part.toLowerCase());
+    if (!path.relative(canonical, temp) || within(canonical, home) || (names.includes('appdata') && !within(temp, canonical))) {
+        unsafe('Select a project outside filesystem, home, and protected configuration roots.');
+    }
+    const physical = fs.statSync(canonical, { bigint: true });
+    inspectAncestors(resolved);
+    const current = fs.statSync(resolved, { bigint: true });
+    if (original.dev !== physical.dev || original.ino !== physical.ino || current.dev !== original.dev || current.ino !== original.ino) {
+        unsafe('Project directory changed while its physical identity was checked.');
+    }
+    return canonical;
+}
+function componentsOf(relativePath) {
+    if (typeof relativePath !== 'string' || !relativePath || path.isAbsolute(relativePath))
+        unsafe('Use a project-relative path.');
+    const parts = relativePath.split(/[\\/]/u);
+    if (parts.some(part => !part || part === '.' || part === '..' || UNSAFE_COMPONENT.test(part))) {
+        unsafe('Use a project-relative path with ordinary path components.');
+    }
+    return parts;
+}
+function checkedPath(root, relativePath, makeDirectories) {
+    const parts = componentsOf(relativePath);
+    let current = root;
+    for (const [index, part] of parts.entries()) {
+        current = path.join(current, part);
+        let stat = fs.lstatSync(current, { throwIfNoEntry: false });
+        if (!stat && makeDirectories) {
+            try {
+                fs.mkdirSync(current);
+            }
+            catch (error) {
+                if (error.code !== 'EEXIST')
+                    throw error;
+            }
+            stat = fs.lstatSync(current, { throwIfNoEntry: false });
+        }
+        if (!stat)
+            return path.join(current, ...parts.slice(index + 1));
+        const finalFile = !makeDirectories && index === parts.length - 1 && stat.isFile() && stat.nlink === 1;
+        if (stat.isSymbolicLink() || (!stat.isDirectory() && !finalFile))
+            unsafe('Project path contains an unsafe link or file type.');
+    }
+    return current;
+}
+/** Check existing project-relative ancestors without creating or opening any files. */
+export function projectLocalPath(root, relativePath) {
+    return checkedPath(projectRoot(root), relativePath, false);
+}
+/** Create only the requested relative directory, checking each component as it is reached. */
+export function ensureProjectDirectory(root, relativePath) {
+    return checkedPath(projectRoot(root), relativePath, true);
+}
+export function readProjectFile(root, relativePath, limit) {
+    const filename = projectLocalPath(root, relativePath);
+    const before = fs.lstatSync(filename, { throwIfNoEntry: false, bigint: true });
+    if (!before)
+        return undefined;
+    if (!before.isFile() || before.isSymbolicLink() || before.nlink !== 1n || before.size > BigInt(limit)) {
+        unsafe('Project file must be regular, single-linked, and within the size limit.');
+    }
+    const fd = fs.openSync(filename, fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0));
+    try {
+        const opened = fs.fstatSync(fd, { bigint: true });
+        if (!matchesFileIdentity(filename, opened, before) || !opened.isFile() || opened.nlink !== 1n || opened.size > BigInt(limit)) {
+            unsafe('Project file changed before it could be read.');
+        }
+        const buffer = Buffer.allocUnsafe(Number(opened.size) + 1);
+        let size = 0;
+        while (size < buffer.length) {
+            const count = fs.readSync(fd, buffer, size, buffer.length - size, null);
+            if (!count)
+                break;
+            size += count;
+        }
+        const after = fs.fstatSync(fd, { bigint: true });
+        if (BigInt(size) !== opened.size || after.mtimeNs !== opened.mtimeNs || after.ctimeNs !== opened.ctimeNs || after.nlink !== 1n) {
+            unsafe('Project file changed while it was being read.');
+        }
+        return buffer.subarray(0, size);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+export function skipProjectTreeName(name) {
+    return name.startsWith('.') || UNSAFE_COMPONENT.test(name) || PROTECTED.has(name.toLowerCase()) ||
+        ['appdata', 'build', 'coverage', 'dist', 'library', 'target', 'temp', 'vendor'].includes(name.toLowerCase());
+}
+//# sourceMappingURL=project-kit-paths.js.map

package/dist/brain/project-kit-paths.js.map

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

package/dist/brain/project-kit.d.ts

@@ -0,0 +1,51 @@
+import { type ProjectProfile } from './project-kit-inspection.js';
+import { type WorkflowTarget } from './workflow-skills.js';
+export { inspectProject, type ProjectProfile } from './project-kit-inspection.js';
+export { ensureProjectDirectory, projectLocalPath, projectRoot, ProjectKitError } from './project-kit-paths.js';
+export interface ProjectSkillParams {
+    requirement: string;
+    target: WorkflowTarget;
+    name?: string;
+    knowledge?: string | string[];
+}
+export interface ProjectSkillFile {
+    relativePath: string;
+    content: string;
+    status: 'create' | 'update' | 'unchanged' | 'conflict';
+    existingHash?: string;
+    reason?: string;
+}
+export interface ProjectSkillPlan {
+    projectId: string;
+    profile: ProjectProfile;
+    requirement: string;
+    target: WorkflowTarget;
+    name: string;
+    files: ProjectSkillFile[];
+    planHash: string;
+    warnings: string[];
+}
+export interface ProjectSkillApplyResult {
+    projectId: string;
+    planHash: string;
+    files: Array<{
+        relativePath: string;
+        status: 'created' | 'updated' | 'unchanged';
+    }>;
+    warnings: string[];
+}
+export interface ProjectSkillReceipt {
+    schemaVersion: 1;
+    projectId: string;
+    relativePath: string;
+    sha256: string;
+}
+export declare const MAX_PROJECT_SKILL_BYTES: number;
+export declare const PROJECT_SKILL_RECEIPT_DIR = ".shadow-brain/project-kit-skills";
+/** Produce a read-only, root-bound preview. Existing unowned skill bytes are never read. */
+export declare function planProjectSkill(root: string, params: ProjectSkillParams): ProjectSkillPlan;
+export declare function replaceProjectFile(root: string, relative: string, content: string | Buffer, expectedHash?: string): void;
+/** Rebuild the reviewed preview under a project-local write lock, then save only its managed skill and receipt. */
+export declare function applyProjectSkill(root: string, params: ProjectSkillParams, expectedPlanHash: string): Promise<ProjectSkillApplyResult>;
+export declare function withProjectSkillWriteLock<T>(canonical: string, mutate: () => T): T;
+//# sourceMappingURL=project-kit.d.ts.map

package/dist/brain/project-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-kit.d.ts","sourceRoot":"","sources":["../../src/brain/project-kit.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElF,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEhH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAA;KAAE,CAAC,CAAC;IACpF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,CAAC,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,eAAO,MAAM,uBAAuB,QAAY,CAAC;AACjD,eAAO,MAAM,yBAAyB,qCAAqC,CAAC;AAoI5E,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,gBAAgB,CAU3F;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAyBxH;AAWD,mHAAmH;AACnH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAuC5I;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAoBlF"}