agcel 1.0.4 → 2.0.0

package/dist/core/context-hygiene.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+import { deduplicateLines, deduplicateRetrievalBlocks } from './context-hygiene.js';
+describe('deduplicateRetrievalBlocks', () => {
+    it('Given duplicate RAG chunks when deduping then only one copy remains', () => {
+        const dup = 'Same chunk text here.';
+        const text = [dup, dup, 'unique'].join('\n\n---\n\n');
+        const out = deduplicateRetrievalBlocks(text);
+        expect(out.split('\n\n---\n\n').filter(Boolean).length).toBe(2);
+        expect(out).toContain('unique');
+    });
+});
+describe('deduplicateLines', () => {
+    it('Given repeated paragraphs when deduping then order is preserved', () => {
+        const text = 'A\n\nB\n\nA\n\nC';
+        expect(deduplicateLines(text)).toBe('A\n\nB\n\nC');
+    });
+});
+//# sourceMappingURL=context-hygiene.test.js.map

package/dist/core/context-hygiene.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-hygiene.test.js","sourceRoot":"","sources":["../../src/core/context-hygiene.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAE9B,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,GAAG,GAAG,uBAAuB,CAAC;QACpC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAChC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/context.d.ts

@@ -0,0 +1,44 @@
+import { type RagEngineMode } from './build-rag-engine.js';
+import type { IRagEngine } from './rag-types.js';
+import { SummarizationService } from './summarizer.js';
+/**
+ * Context Manager (CM).
+ * Orchestrates what goes into the prompt by querying the RAG engine
+ * and applying summarization when context is too long.
+ * Falls back to MEMORY.md when RAG is not available.
+ */
+export declare class ContextManager {
+    private rag;
+    private readonly summarizer;
+    private readonly memoryPath;
+    private ragEnabled;
+    private ragMode;
+    private readonly basePath;
+    private ragMetadataFilter;
+    constructor(options?: {
+        basePath?: string;
+        maxTokens?: number;
+    });
+    initialize(): Promise<void>;
+    /**
+     * Retrieve relevant context for a given query.
+     */
+    getContext(query: string): Promise<string>;
+    /**
+     * Ingest a document into the knowledge base.
+     */
+    ingest(id: string, content: string, metadata?: Record<string, string>): Promise<void>;
+    /**
+     * Write a summary/memo to MEMORY.md (fallback when RAG is unavailable).
+     */
+    appendToMemory(title: string, content: string): Promise<void>;
+    /**
+     * Read the MEMORY.md fallback file.
+     */
+    readMemoryFile(): Promise<string>;
+    isRagEnabled(): boolean;
+    getRagMode(): RagEngineMode | null;
+    getRag(): IRagEngine | null;
+    getSummarizer(): SummarizationService;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAIvD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,iBAAiB,CAAqC;gBAElD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAMzD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBjC;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBhD;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/F;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAQvC,YAAY,IAAI,OAAO;IAIvB,UAAU,IAAI,aAAa,GAAG,IAAI;IAIlC,MAAM,IAAI,UAAU,GAAG,IAAI;IAI3B,aAAa,IAAI,oBAAoB;CAGtC"}

package/dist/core/context.js

@@ -0,0 +1,114 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { buildRagEngine } from './build-rag-engine.js';
+import { SummarizationService } from './summarizer.js';
+import { readAgcelConfig } from './read-agcel-config.js';
+import { deduplicateRetrievalBlocks } from './context-hygiene.js';
+/**
+ * Context Manager (CM).
+ * Orchestrates what goes into the prompt by querying the RAG engine
+ * and applying summarization when context is too long.
+ * Falls back to MEMORY.md when RAG is not available.
+ */
+export class ContextManager {
+    rag = null;
+    summarizer;
+    memoryPath;
+    ragEnabled = false;
+    ragMode = null;
+    basePath;
+    ragMetadataFilter;
+    constructor(options) {
+        this.basePath = options?.basePath || process.cwd();
+        this.summarizer = new SummarizationService(options?.maxTokens);
+        this.memoryPath = path.join(this.basePath, 'MEMORY.md');
+    }
+    async initialize() {
+        const config = await readAgcelConfig(this.basePath);
+        this.ragMetadataFilter = config.ragQueryMetadataFilter;
+        if (config.ragEnabled === false) {
+            this.ragEnabled = false;
+            this.rag = null;
+            this.ragMode = null;
+            return;
+        }
+        try {
+            const { engine, mode } = await buildRagEngine(this.basePath, config);
+            this.rag = engine;
+            this.ragMode = mode;
+            this.ragEnabled = true;
+        }
+        catch {
+            this.ragEnabled = false;
+            this.rag = null;
+            this.ragMode = null;
+        }
+    }
+    /**
+     * Retrieve relevant context for a given query.
+     */
+    async getContext(query) {
+        if (this.ragEnabled && this.rag) {
+            const filter = this.ragMetadataFilter && Object.keys(this.ragMetadataFilter).length > 0
+                ? this.ragMetadataFilter
+                : undefined;
+            const results = await this.rag.query(query, 5, filter);
+            let context = results.map(r => r.content).join('\n\n---\n\n');
+            context = deduplicateRetrievalBlocks(context);
+            if (this.summarizer.exceedsBudget(context)) {
+                return deduplicateRetrievalBlocks(this.summarizer.summarize(context));
+            }
+            return context;
+        }
+        const mem = await this.readMemoryFile();
+        return mem ? deduplicateRetrievalBlocks(mem) : '';
+    }
+    /**
+     * Ingest a document into the knowledge base.
+     */
+    async ingest(id, content, metadata = {}) {
+        if (this.ragEnabled && this.rag) {
+            await this.rag.addDocument(id, content, metadata);
+        }
+        else {
+            await this.appendToMemory(id, content);
+        }
+    }
+    /**
+     * Write a summary/memo to MEMORY.md (fallback when RAG is unavailable).
+     */
+    async appendToMemory(title, content) {
+        const timestamp = new Date().toISOString();
+        const entry = `\n## ${title}\n_${timestamp}_\n\n${content}\n`;
+        try {
+            await fs.appendFile(this.memoryPath, entry);
+        }
+        catch {
+            await fs.writeFile(this.memoryPath, `# AgCEL Memory\n${entry}`);
+        }
+    }
+    /**
+     * Read the MEMORY.md fallback file.
+     */
+    async readMemoryFile() {
+        try {
+            return await fs.readFile(this.memoryPath, 'utf-8');
+        }
+        catch {
+            return '';
+        }
+    }
+    isRagEnabled() {
+        return this.ragEnabled;
+    }
+    getRagMode() {
+        return this.ragMode;
+    }
+    getRag() {
+        return this.rag;
+    }
+    getSummarizer() {
+        return this.summarizer;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

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

package/dist/core/conversation-routing.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Builds the text used for intent detection and RAG when a conversation
+ * is in progress, so agent selection can change as the topic evolves.
+ */
+export type ConversationTurn = {
+    role: 'user' | 'assistant' | string;
+    content: string;
+};
+export declare function buildRoutingQuery(currentQuery: string, history: ConversationTurn[] | undefined, maxChars?: number): string;
+//# sourceMappingURL=conversation-routing.d.ts.map

package/dist/core/conversation-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-routing.d.ts","sourceRoot":"","sources":["../../src/core/conversation-routing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,gBAAgB,EAAE,GAAG,SAAS,EACvC,QAAQ,GAAE,MAA0B,GACnC,MAAM,CAuBR"}

package/dist/core/conversation-routing.js

@@ -0,0 +1,27 @@
+/**
+ * Builds the text used for intent detection and RAG when a conversation
+ * is in progress, so agent selection can change as the topic evolves.
+ */
+const DEFAULT_MAX_CHARS = 8000;
+export function buildRoutingQuery(currentQuery, history, maxChars = DEFAULT_MAX_CHARS) {
+    const trimmed = currentQuery.trim();
+    if (!history?.length) {
+        return trimmed;
+    }
+    const parts = [];
+    for (const turn of history) {
+        const label = turn.role === 'user'
+            ? 'User'
+            : turn.role === 'assistant'
+                ? 'Assistant'
+                : String(turn.role);
+        parts.push(`${label}: ${turn.content.trim()}`);
+    }
+    parts.push(`User: ${trimmed}`);
+    let combined = parts.join('\n\n');
+    if (combined.length > maxChars) {
+        combined = combined.slice(-maxChars);
+    }
+    return combined;
+}
+//# sourceMappingURL=conversation-routing.js.map

package/dist/core/conversation-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-routing.js","sourceRoot":"","sources":["../../src/core/conversation-routing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,MAAM,UAAU,iBAAiB,CAC/B,YAAoB,EACpB,OAAuC,EACvC,WAAmB,iBAAiB;IAEpC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GACT,IAAI,CAAC,IAAI,KAAK,MAAM;YAClB,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW;gBACzB,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IAE/B,IAAI,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC/B,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/core/conversation-routing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=conversation-routing.test.d.ts.map

package/dist/core/conversation-routing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-routing.test.d.ts","sourceRoot":"","sources":["../../src/core/conversation-routing.test.ts"],"names":[],"mappings":""}

package/dist/core/conversation-routing.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from 'vitest';
+import { buildRoutingQuery } from './conversation-routing.js';
+describe('buildRoutingQuery', () => {
+    it('Given no history when building routing query then returns the current query only', () => {
+        const q = '  fix the bug  ';
+        expect(buildRoutingQuery(q, undefined)).toBe('fix the bug');
+        expect(buildRoutingQuery(q, [])).toBe('fix the bug');
+    });
+    it('Given prior turns when building routing query then concatenates roles and caps length', () => {
+        const history = [
+            { role: 'user', content: 'Need React layout help' },
+            { role: 'assistant', content: 'Here is a wireframe idea.' }
+        ];
+        const out = buildRoutingQuery('Now the Python API returns 500', history);
+        expect(out).toContain('User: Need React layout help');
+        expect(out).toContain('Assistant: Here is a wireframe idea.');
+        expect(out).toContain('User: Now the Python API returns 500');
+    });
+    it('Given combined text exceeds maxChars when building then keeps the suffix', () => {
+        const filler = 'x'.repeat(100);
+        const history = [{ role: 'user', content: filler }];
+        const current = 'END_MARKER_UNIQUE';
+        const max = 200;
+        const out = buildRoutingQuery(current, history, max);
+        expect(out.length).toBeLessThanOrEqual(max);
+        expect(out).toContain('END_MARKER_UNIQUE');
+    });
+});
+//# sourceMappingURL=conversation-routing.test.js.map

package/dist/core/conversation-routing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-routing.test.js","sourceRoot":"","sources":["../../src/core/conversation-routing.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,kFAAkF,EAAE,GAAG,EAAE;QAC1F,MAAM,CAAC,GAAG,iBAAiB,CAAC;QAC5B,MAAM,CAAC,iBAAiB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5D,MAAM,CAAC,iBAAiB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uFAAuF,EAAE,GAAG,EAAE;QAC/F,MAAM,OAAO,GAAG;YACd,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,wBAAwB,EAAE;YAC5D,EAAE,IAAI,EAAE,WAAoB,EAAE,OAAO,EAAE,2BAA2B,EAAE;SACrE,CAAC;QACF,MAAM,GAAG,GAAG,iBAAiB,CAAC,gCAAgC,EAAE,OAAO,CAAC,CAAC;QACzE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,sCAAsC,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,mBAAmB,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,CAAC;QAChB,MAAM,GAAG,GAAG,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/guardrails.d.ts

@@ -0,0 +1,26 @@
+import type { Guardrail } from './schema.js';
+export interface ValidationResult {
+    passed: boolean;
+    violations: Violation[];
+}
+export interface Violation {
+    guardrailId: string;
+    severity: 'error' | 'warning';
+    description: string;
+    detail: string;
+}
+/**
+ * Validates agent output against a set of guardrails.
+ * - 'error' violations cause the validation to fail.
+ * - 'warning' violations are flagged but don't block.
+ */
+export declare class GuardrailValidator {
+    validate(output: string, guardrails: Guardrail[]): ValidationResult;
+    /**
+     * Format violations into a human-readable report.
+     */
+    formatReport(result: ValidationResult): string;
+    private checkPattern;
+    private checkForbiddenTerms;
+}
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/core/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../src/core/guardrails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,gBAAgB;IA6BnE;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IAmB9C,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,mBAAmB;CAa5B"}

package/dist/core/guardrails.js

@@ -0,0 +1,76 @@
+/**
+ * Validates agent output against a set of guardrails.
+ * - 'error' violations cause the validation to fail.
+ * - 'warning' violations are flagged but don't block.
+ */
+export class GuardrailValidator {
+    validate(output, guardrails) {
+        const violations = [];
+        for (const rule of guardrails) {
+            // Pattern check
+            if (rule.pattern) {
+                this.checkPattern(output, rule, violations);
+            }
+            // Forbidden terms check
+            if (rule.forbiddenTerms) {
+                this.checkForbiddenTerms(output, rule, violations);
+            }
+            // Max length check
+            if (rule.maxLength !== undefined && output.length > rule.maxLength) {
+                violations.push({
+                    guardrailId: rule.id,
+                    severity: rule.severity,
+                    description: rule.description,
+                    detail: `Output length (${output.length}) exceeds max (${rule.maxLength}).`
+                });
+            }
+        }
+        const hasErrors = violations.some(v => v.severity === 'error');
+        return { passed: !hasErrors, violations };
+    }
+    /**
+     * Format violations into a human-readable report.
+     */
+    formatReport(result) {
+        if (result.violations.length === 0) {
+            return 'All guardrails passed.';
+        }
+        const lines = [
+            result.passed ? 'Guardrail warnings:' : 'Guardrail violations (output blocked):'
+        ];
+        for (const v of result.violations) {
+            lines.push(`  [${v.severity}] [${v.guardrailId}] ${v.description}`, `     ${v.detail}`);
+        }
+        return lines.join('\n');
+    }
+    checkPattern(output, rule, violations) {
+        if (!rule.pattern)
+            return;
+        const regex = new RegExp(rule.pattern, 'gi');
+        const matches = output.match(regex);
+        if (!matches)
+            return;
+        violations.push({
+            guardrailId: rule.id,
+            severity: rule.severity,
+            description: rule.description,
+            detail: `Pattern "${rule.pattern}" matched ${matches.length} time(s).`
+        });
+    }
+    checkForbiddenTerms(output, rule, violations) {
+        if (!rule.forbiddenTerms)
+            return;
+        const lowerOutput = output.toLowerCase();
+        for (const term of rule.forbiddenTerms) {
+            if (!lowerOutput.includes(term.toLowerCase()))
+                continue;
+            violations.push({
+                guardrailId: rule.id,
+                severity: rule.severity,
+                description: rule.description,
+                detail: `Forbidden term "${term}" detected.`
+            });
+        }
+    }
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/core/guardrails.js.map

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

package/dist/core/guardrails.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=guardrails.test.d.ts.map

package/dist/core/guardrails.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.test.d.ts","sourceRoot":"","sources":["../../src/core/guardrails.test.ts"],"names":[],"mappings":""}

package/dist/core/guardrails.test.js

@@ -0,0 +1,35 @@
+import { describe, expect, it } from 'vitest';
+import { GuardrailValidator } from './guardrails.js';
+describe('GuardrailValidator', () => {
+    it('Given clean output when validating then passes with no violations', () => {
+        const validator = new GuardrailValidator();
+        const guardrails = [
+            { id: 'G1', description: 'No profanity allowed', severity: 'error', forbiddenTerms: ['badword'] }
+        ];
+        const result = validator.validate('All good here.', guardrails);
+        expect(result.passed).toBe(true);
+        expect(result.violations).toHaveLength(0);
+    });
+    it('Given forbidden term when validating then fails with error violation', () => {
+        const validator = new GuardrailValidator();
+        const guardrails = [
+            { id: 'G1', description: 'No profanity allowed', severity: 'error', forbiddenTerms: ['badword'] }
+        ];
+        const result = validator.validate('This contains a badword.', guardrails);
+        expect(result.passed).toBe(false);
+        expect(result.violations).toHaveLength(1);
+        expect(result.violations[0]?.guardrailId).toBe('G1');
+        expect(result.violations[0]?.severity).toBe('error');
+    });
+    it('Given maxLength warning when validating then passes with warning violation', () => {
+        const validator = new GuardrailValidator();
+        const guardrails = [
+            { id: 'G2', description: 'Output must be concise', severity: 'warning', maxLength: 10 }
+        ];
+        const result = validator.validate('This is too long.', guardrails);
+        expect(result.passed).toBe(true);
+        expect(result.violations).toHaveLength(1);
+        expect(result.violations[0]?.severity).toBe('warning');
+    });
+});
+//# sourceMappingURL=guardrails.test.js.map

package/dist/core/guardrails.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.test.js","sourceRoot":"","sources":["../../src/core/guardrails.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAgB;YAC9B,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,SAAS,CAAC,EAAE;SAClG,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;QAEhE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAgB;YAC9B,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,SAAS,CAAC,EAAE;SAClG,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAC;QAE1E,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACpF,MAAM,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAgB;YAC9B,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,wBAAwB,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE;SACxF,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/intent.d.ts

@@ -0,0 +1,22 @@
+import type { Agent } from './schema.js';
+export interface IntentResult {
+    bestAgent: Agent | null;
+    confidence: number;
+    /** When confidence is below threshold, this contains a suggestion */
+    suggestion: string | null;
+}
+/** Score how well `lowerText` matches an agent (lowercased query text). */
+export declare function scoreAgentAgainstText(lowerText: string, agent: Agent): number;
+export declare function agentSemanticProfile(agent: Agent): string;
+export interface DetectIntentOptions {
+    /** Latest user message; weighted extra vs `query` so routing can follow topic shifts. */
+    latestUserTurn?: string;
+    /** Multiplier for `scoreAgentAgainstText(latest, agent)` (default 3). */
+    latestTurnWeight?: number;
+}
+export declare class IntentEngine {
+    private threshold;
+    constructor(threshold?: number);
+    detectIntent(query: string, agents: Agent[], options?: DetectIntentOptions): IntentResult;
+}
+//# sourceMappingURL=intent.d.ts.map

package/dist/core/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/core/intent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAID,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAoB7E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEzD;AAED,MAAM,WAAW,mBAAmB;IAClC,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,GAAE,MAA6B;IAIpD,YAAY,CACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY;CAqDhB"}

package/dist/core/intent.js

@@ -0,0 +1,79 @@
+import { textCosineSimilarity } from './text-similarity.js';
+const CONFIDENCE_THRESHOLD = 0.5;
+/** Score how well `lowerText` matches an agent (lowercased query text). */
+export function scoreAgentAgainstText(lowerText, agent) {
+    let score = 0;
+    if (lowerText.includes(agent.name.toLowerCase()))
+        score += 10;
+    const roleWords = agent.role.toLowerCase().split(/\s+/);
+    for (const word of roleWords) {
+        if (word.length > 3 && lowerText.includes(word))
+            score += 2;
+    }
+    const descWords = agent.description.toLowerCase().split(/\s+/);
+    for (const word of descWords) {
+        if (word.length > 3 && lowerText.includes(word))
+            score += 1;
+    }
+    for (const skill of agent.skills) {
+        if (lowerText.includes(skill.toLowerCase()))
+            score += 5;
+    }
+    return score;
+}
+export function agentSemanticProfile(agent) {
+    return [agent.name, agent.description, agent.role, ...agent.skills].join(' ');
+}
+export class IntentEngine {
+    threshold;
+    constructor(threshold = CONFIDENCE_THRESHOLD) {
+        this.threshold = threshold;
+    }
+    detectIntent(query, agents, options) {
+        if (agents.length === 0) {
+            return {
+                bestAgent: null,
+                confidence: 0,
+                suggestion: 'No agents registered. Run `agcel create-agent` to create one, or provide skill keywords to help AgCEL build one for you.'
+            };
+        }
+        let bestAgent = agents[0];
+        let maxScore = 0;
+        const lowerQuery = query.toLowerCase();
+        const latest = options?.latestUserTurn?.toLowerCase().trim() ?? '';
+        const latestWeight = options?.latestTurnWeight ?? 3;
+        const useRecencyBoost = Boolean(latest && latest !== lowerQuery);
+        for (const agent of agents) {
+            const profile = agentSemanticProfile(agent).toLowerCase();
+            let score = scoreAgentAgainstText(lowerQuery, agent);
+            score += textCosineSimilarity(lowerQuery, profile) * 24;
+            if (useRecencyBoost) {
+                score += scoreAgentAgainstText(latest, agent) * latestWeight;
+                score += textCosineSimilarity(latest, profile) * latestWeight * 8;
+            }
+            if (score > maxScore) {
+                maxScore = score;
+                bestAgent = agent;
+            }
+        }
+        const confidenceDivisor = useRecencyBoost ? 95 : 38;
+        const confidence = Math.min(maxScore / confidenceDivisor, 1);
+        if (confidence < this.threshold) {
+            return {
+                bestAgent: confidence > 0 ? bestAgent : null,
+                confidence,
+                suggestion: [
+                    `Low confidence (${(confidence * 100).toFixed(0)}%) - no agent is a strong match for this query.`,
+                    `Available agents: ${agents.map(a => a.name).join(', ')}`,
+                    `Suggestion: Run \`agcel suggest "<your query>"\` for next steps, \`agcel create-agent --research\` to build a persona with best-practice hints, or \`agcel create-skill\` for a new skill bundle.`
+                ].join('\n')
+            };
+        }
+        return {
+            bestAgent,
+            confidence,
+            suggestion: null
+        };
+    }
+}
+//# sourceMappingURL=intent.js.map

package/dist/core/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../src/core/intent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAS5D,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CAAC,SAAiB,EAAE,KAAY;IACnE,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAAE,KAAK,IAAI,EAAE,CAAC;IAE9D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAY;IAC/C,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChF,CAAC;AASD,MAAM,OAAO,YAAY;IACf,SAAS,CAAS;IAE1B,YAAY,YAAoB,oBAAoB;QAClD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,YAAY,CACV,KAAa,EACb,MAAe,EACf,OAA6B;QAE7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,UAAU,EAAE,CAAC;gBACb,UAAU,EAAE,0HAA0H;aACvI,CAAC;QACJ,CAAC;QAED,IAAI,SAAS,GAAG,MAAM,CAAC,CAAC,CAAU,CAAC;QACnC,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QACnE,MAAM,YAAY,GAAG,OAAO,EAAE,gBAAgB,IAAI,CAAC,CAAC;QACpD,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,KAAK,UAAU,CAAC,CAAC;QAEjE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YAC1D,IAAI,KAAK,GAAG,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YACrD,KAAK,IAAI,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;YACxD,IAAI,eAAe,EAAE,CAAC;gBACpB,KAAK,IAAI,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,YAAY,CAAC;gBAC7D,KAAK,IAAI,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC;YACpE,CAAC;YAED,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;gBACrB,QAAQ,GAAG,KAAK,CAAC;gBACjB,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;QAED,MAAM,iBAAiB,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,iBAAiB,EAAE,CAAC,CAAC,CAAC;QAE7D,IAAI,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,OAAO;gBACL,SAAS,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;gBAC5C,UAAU;gBACV,UAAU,EAAE;oBACV,mBAAmB,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iDAAiD;oBACjG,qBAAqB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACzD,mMAAmM;iBACpM,CAAC,IAAI,CAAC,IAAI,CAAC;aACb,CAAC;QACJ,CAAC;QAED,OAAO;YACL,SAAS;YACT,UAAU;YACV,UAAU,EAAE,IAAI;SACjB,CAAC;IACJ,CAAC;CACF"}

package/dist/core/intent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=intent.test.d.ts.map

package/dist/core/intent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.test.d.ts","sourceRoot":"","sources":["../../src/core/intent.test.ts"],"names":[],"mappings":""}

package/dist/core/intent.test.js

@@ -0,0 +1,43 @@
+import { describe, expect, it } from 'vitest';
+import { IntentEngine, scoreAgentAgainstText } from './intent.js';
+const pythonAgent = {
+    name: 'python-expert',
+    description: 'Python django asyncio debugging',
+    role: 'Python engineer for APIs and servers',
+    skills: ['python']
+};
+const uiAgent = {
+    name: 'ui-expert',
+    description: 'Figma mockups React layout design',
+    role: 'Designer for UI and product visuals',
+    skills: ['design']
+};
+describe('IntentEngine', () => {
+    it('Given only the current query when detecting intent then behavior matches single-shot routing', () => {
+        const engine = new IntentEngine(0.25);
+        const agents = [pythonAgent, uiAgent];
+        const q = 'Need a Figma mockup for onboarding';
+        const combined = q;
+        const withRecency = engine.detectIntent(combined, agents, {
+            latestUserTurn: q
+        });
+        const without = engine.detectIntent(combined, agents);
+        expect(withRecency.bestAgent?.name).toBe(without.bestAgent?.name);
+    });
+    it('Given long prior UI thread when latest turn is Python then best agent follows the latest turn', () => {
+        const engine = new IntentEngine(0.25);
+        const agents = [pythonAgent, uiAgent];
+        const routing = 'User: Build a Figma dashboard mockup\n\nAssistant: Here are frames.\n\nUser: Fix the Django 500 in our Python API';
+        const result = engine.detectIntent(routing, agents, {
+            latestUserTurn: 'Fix the Django 500 in our Python API'
+        });
+        expect(result.bestAgent?.name).toBe('python-expert');
+    });
+});
+describe('scoreAgentAgainstText', () => {
+    it('Given django in text when scoring python agent then returns a positive score', () => {
+        const s = scoreAgentAgainstText('debug django view', pythonAgent);
+        expect(s).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=intent.test.js.map

package/dist/core/intent.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.test.js","sourceRoot":"","sources":["../../src/core/intent.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGlE,MAAM,WAAW,GAAU;IACzB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,iCAAiC;IAC9C,IAAI,EAAE,sCAAsC;IAC5C,MAAM,EAAE,CAAC,QAAQ,CAAC;CACnB,CAAC;AAEF,MAAM,OAAO,GAAU;IACrB,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,mCAAmC;IAChD,IAAI,EAAE,qCAAqC;IAC3C,MAAM,EAAE,CAAC,QAAQ,CAAC;CACnB,CAAC;AAEF,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,8FAA8F,EAAE,GAAG,EAAE;QACtG,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,oCAAoC,CAAC;QAC/C,MAAM,QAAQ,GAAG,CAAC,CAAC;QACnB,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE;YACxD,cAAc,EAAE,CAAC;SAClB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+FAA+F,EAAE,GAAG,EAAE;QACvG,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,OAAO,GACX,mHAAmH,CAAC;QACtH,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE;YAClD,cAAc,EAAE,sCAAsC;SACvD,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,MAAM,CAAC,GAAG,qBAAqB,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;QAClE,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}