beth-copilot 1.0.14 → 1.0.16

package/dist/core/agents/tools.test.js

@@ -0,0 +1,332 @@
+/**
+ * Agent Tools and Model Validation Tests
+ *
+ * Tests for agent tools array and model field parsing/validation.
+ * Run with: node --test dist/core/agents/tools.test.js
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { join } from 'node:path';
+import { loadAgents, loadAgent } from './loader.js';
+// Test against templates directory for actual agent file tests
+const TEMPLATES_AGENTS_DIR = join(process.cwd(), 'templates', '.github', 'agents');
+/**
+ * All known tools defined in AgentTool type.
+ */
+const KNOWN_TOOLS = [
+    'codebase',
+    'readFile',
+    'editFiles',
+    'createFile',
+    'listDirectory',
+    'fileSearch',
+    'textSearch',
+    'runInTerminal',
+    'getTerminalOutput',
+    'problems',
+    'usages',
+    'runSubagent',
+];
+describe('Tools array validation', () => {
+    it('should accept valid tools array with known tools', () => {
+        const frontmatter = {
+            name: 'test-agent',
+            tools: ['codebase', 'readFile', 'editFiles'],
+        };
+        assert.ok(Array.isArray(frontmatter.tools));
+        assert.strictEqual(frontmatter.tools?.length, 3);
+        assert.ok(frontmatter.tools?.includes('codebase'));
+        assert.ok(frontmatter.tools?.includes('readFile'));
+        assert.ok(frontmatter.tools?.includes('editFiles'));
+    });
+    it('should accept empty tools array as valid', () => {
+        const frontmatter = {
+            name: 'test-agent',
+            tools: [],
+        };
+        assert.ok(Array.isArray(frontmatter.tools));
+        assert.strictEqual(frontmatter.tools?.length, 0);
+    });
+    it('should accept single tool in array', () => {
+        const frontmatter = {
+            name: 'test-agent',
+            tools: ['readFile'],
+        };
+        assert.ok(Array.isArray(frontmatter.tools));
+        assert.strictEqual(frontmatter.tools?.length, 1);
+        assert.strictEqual(frontmatter.tools?.[0], 'readFile');
+    });
+    it('should accept multiple tools in array', () => {
+        const tools = [
+            'codebase',
+            'readFile',
+            'editFiles',
+            'createFile',
+            'listDirectory',
+            'fileSearch',
+            'textSearch',
+            'runInTerminal',
+            'getTerminalOutput',
+            'problems',
+            'usages',
+            'runSubagent',
+        ];
+        const frontmatter = {
+            name: 'test-agent',
+            tools,
+        };
+        assert.strictEqual(frontmatter.tools?.length, 12);
+        assert.deepStrictEqual(frontmatter.tools, KNOWN_TOOLS);
+    });
+    it('should accept unknown/custom tools (MCP tools)', () => {
+        const frontmatter = {
+            name: 'test-agent',
+            tools: [
+                'readFile',
+                'mcp_brave_search', // Custom MCP tool
+                'mcp_azure_deploy', // Custom MCP tool
+                'custom_internal_tool', // Custom internal tool
+                'fetch', // Non-standard tool
+                'githubRepo', // Non-standard tool
+            ],
+        };
+        assert.strictEqual(frontmatter.tools?.length, 6);
+        assert.ok(frontmatter.tools?.includes('mcp_brave_search'));
+        assert.ok(frontmatter.tools?.includes('mcp_azure_deploy'));
+        assert.ok(frontmatter.tools?.includes('custom_internal_tool'));
+    });
+    it('should allow duplicate tools in array (no dedup in loader)', () => {
+        const frontmatter = {
+            name: 'test-agent',
+            tools: ['readFile', 'readFile', 'editFiles', 'editFiles', 'editFiles'],
+        };
+        assert.strictEqual(frontmatter.tools?.length, 5);
+        // Count duplicates
+        const readFileCount = frontmatter.tools?.filter((t) => t === 'readFile').length;
+        const editFilesCount = frontmatter.tools?.filter((t) => t === 'editFiles').length;
+        assert.strictEqual(readFileCount, 2);
+        assert.strictEqual(editFilesCount, 3);
+    });
+});
+describe('Tools validation via loader', () => {
+    it('should fail when tools is not an array', async () => {
+        // Create a mock YAML content where tools is a string instead of array
+        // We test this by directly checking the validateFrontmatter behavior
+        // Since we can't easily create temp files, we verify the loader validates properly
+        // The loader validates in validateFrontmatter that tools must be an array if present
+        // This is documented behavior - tools: "readFile" should fail
+        // We can verify this behavior by checking a successfully loaded agent
+        const result = loadAgent(join(TEMPLATES_AGENTS_DIR, 'developer.agent.md'));
+        assert.ok(!('error' in result), 'Developer agent should load successfully');
+        const { agent } = result;
+        assert.ok(Array.isArray(agent.frontmatter.tools), 'tools should be an array');
+    });
+    it('should convert non-string values in tools array to strings', () => {
+        // The normalizeFrontmatter function in loader.ts does:
+        // frontmatter.tools = data.tools.map(String);
+        // This converts any value to string
+        // Test that the type system allows this and loader handles it
+        // When YAML parses numbers or other types, they get converted to strings
+        // Create frontmatter as if it came from YAML with mixed types
+        const rawData = {
+            name: 'test-agent',
+            tools: [123, true, 'readFile', null],
+        };
+        // Simulate what normalizeFrontmatter does
+        const normalizedTools = rawData.tools.map(String);
+        assert.deepStrictEqual(normalizedTools, ['123', 'true', 'readFile', 'null']);
+        assert.ok(normalizedTools.every((t) => typeof t === 'string'));
+    });
+});
+describe('Model field validation', () => {
+    it('should accept Claude Opus 4.6 model', () => {
+        const frontmatter = {
+            name: 'test-agent',
+            model: 'Claude Opus 4.6',
+        };
+        assert.strictEqual(frontmatter.model, 'Claude Opus 4.6');
+    });
+    it('should accept claude-3-opus model', () => {
+        const frontmatter = {
+            name: 'test-agent',
+            model: 'claude-3-opus',
+        };
+        assert.strictEqual(frontmatter.model, 'claude-3-opus');
+    });
+    it('should accept any arbitrary string as model', () => {
+        const arbitraryModels = [
+            'gpt-4-turbo',
+            'gpt-4o',
+            'claude-3-sonnet',
+            'claude-3-haiku',
+            'gemini-pro',
+            'custom-fine-tuned-model-v2',
+            'my-local-llama',
+            'o1-preview',
+            'claude-3.5-sonnet-20241022',
+        ];
+        for (const model of arbitraryModels) {
+            const frontmatter = {
+                name: 'test-agent',
+                model,
+            };
+            assert.strictEqual(frontmatter.model, model, `Should accept model: ${model}`);
+        }
+    });
+    it('should result in undefined when model field is missing', () => {
+        const frontmatter = {
+            name: 'test-agent',
+            // model is intentionally omitted
+        };
+        assert.strictEqual(frontmatter.model, undefined);
+        assert.ok(!('model' in frontmatter) || frontmatter.model === undefined);
+    });
+    it('should accept empty string as model (edge case)', () => {
+        const frontmatter = {
+            name: 'test-agent',
+            model: '',
+        };
+        assert.strictEqual(frontmatter.model, '');
+    });
+});
+describe('Actual agent files tool configurations', () => {
+    it('should load all template agents without errors', () => {
+        const result = loadAgents(TEMPLATES_AGENTS_DIR);
+        assert.strictEqual(result.errors.length, 0, `Unexpected errors: ${JSON.stringify(result.errors)}`);
+        assert.ok(result.agents.length >= 7, `Expected at least 7 agents, got ${result.agents.length}`);
+    });
+    it('developer agent should have comprehensive tool set', () => {
+        const result = loadAgent(join(TEMPLATES_AGENTS_DIR, 'developer.agent.md'));
+        assert.ok(!('error' in result));
+        const { agent } = result;
+        const tools = agent.frontmatter.tools ?? [];
+        // Developer should have file operations
+        assert.ok(tools.includes('readFile'), 'Developer should have readFile');
+        assert.ok(tools.includes('editFiles'), 'Developer should have editFiles');
+        assert.ok(tools.includes('createFile'), 'Developer should have createFile');
+        // Developer should have search capabilities
+        assert.ok(tools.includes('codebase'), 'Developer should have codebase');
+        assert.ok(tools.includes('fileSearch'), 'Developer should have fileSearch');
+        assert.ok(tools.includes('textSearch'), 'Developer should have textSearch');
+        // Developer should have terminal access
+        assert.ok(tools.includes('runInTerminal'), 'Developer should have runInTerminal');
+        assert.ok(tools.includes('getTerminalOutput'), 'Developer should have getTerminalOutput');
+        // Developer should be able to spawn subagents
+        assert.ok(tools.includes('runSubagent'), 'Developer should have runSubagent');
+    });
+    it('all agents should have tools as arrays', () => {
+        const result = loadAgents(TEMPLATES_AGENTS_DIR);
+        for (const agent of result.agents) {
+            if (agent.frontmatter.tools !== undefined) {
+                assert.ok(Array.isArray(agent.frontmatter.tools), `${agent.id} tools should be an array`);
+            }
+        }
+    });
+    it('all agents should have valid model fields', () => {
+        const result = loadAgents(TEMPLATES_AGENTS_DIR);
+        for (const agent of result.agents) {
+            // Model should either be undefined or a non-empty string
+            if (agent.frontmatter.model !== undefined) {
+                assert.strictEqual(typeof agent.frontmatter.model, 'string', `${agent.id} model should be a string`);
+                assert.ok(agent.frontmatter.model.length > 0, `${agent.id} model should not be empty if specified`);
+            }
+        }
+    });
+    it('tester agent should have testing-specific tools', () => {
+        const result = loadAgent(join(TEMPLATES_AGENTS_DIR, 'tester.agent.md'));
+        assert.ok(!('error' in result));
+        const { agent } = result;
+        const tools = agent.frontmatter.tools ?? [];
+        // Tester should have diagnostic tools
+        assert.ok(tools.includes('problems'), 'Tester should have problems tool');
+        // Tester may have testing-specific tools (custom)
+        // testFailure and runTests are custom tools used by tester
+    });
+    it('security-reviewer should have code analysis tools', () => {
+        const result = loadAgent(join(TEMPLATES_AGENTS_DIR, 'security-reviewer.agent.md'));
+        assert.ok(!('error' in result));
+        const { agent } = result;
+        const tools = agent.frontmatter.tools ?? [];
+        // Security reviewer should have code reading/searching
+        assert.ok(tools.includes('codebase'), 'Security reviewer should have codebase');
+        assert.ok(tools.includes('readFile'), 'Security reviewer should have readFile');
+        assert.ok(tools.includes('textSearch'), 'Security reviewer should have textSearch');
+        assert.ok(tools.includes('usages'), 'Security reviewer should have usages for tracking code usage');
+    });
+});
+describe('runSubagent capability validation', () => {
+    it('agents with runSubagent tool should have infer: true', () => {
+        const result = loadAgents(TEMPLATES_AGENTS_DIR);
+        for (const agent of result.agents) {
+            const tools = agent.frontmatter.tools ?? [];
+            const hasRunSubagent = tools.includes('runSubagent');
+            const hasInfer = agent.frontmatter.infer === true;
+            if (hasRunSubagent) {
+                // An agent with runSubagent should either:
+                // 1. Have infer: true (can be spawned as subagent itself), OR
+                // 2. Have handoffs (can delegate to other agents)
+                const hasHandoffs = (agent.frontmatter.handoffs?.length ?? 0) > 0;
+                assert.ok(hasInfer || hasHandoffs, `${agent.id} has runSubagent but no infer:true or handoffs - may not be able to participate in multi-agent workflows`);
+            }
+        }
+    });
+    it('Beth agent should be able to orchestrate all other agents', () => {
+        const result = loadAgents(TEMPLATES_AGENTS_DIR);
+        const beth = result.agents.find((a) => a.id === 'beth');
+        assert.ok(beth, 'Beth agent should exist');
+        assert.ok(beth?.frontmatter.infer === true, 'Beth should be inferable');
+        // Beth should have handoffs to all specialist agents
+        const handoffs = beth?.frontmatter.handoffs ?? [];
+        const handoffAgents = handoffs.map((h) => h.agent);
+        // Beth should be able to hand off to key specialists
+        assert.ok(handoffAgents.includes('developer'), 'Beth should have developer handoff');
+        assert.ok(handoffAgents.includes('tester'), 'Beth should have tester handoff');
+        assert.ok(handoffAgents.includes('ux-designer'), 'Beth should have ux-designer handoff');
+        assert.ok(handoffAgents.includes('product-manager'), 'Beth should have product-manager handoff');
+        assert.ok(handoffAgents.includes('researcher'), 'Beth should have researcher handoff');
+        assert.ok(handoffAgents.includes('security-reviewer'), 'Beth should have security-reviewer handoff');
+    });
+    it('all inferable agents can be spawned as subagents', () => {
+        const result = loadAgents(TEMPLATES_AGENTS_DIR);
+        const inferableAgents = result.agents.filter((a) => a.frontmatter.infer === true);
+        assert.ok(inferableAgents.length > 0, 'Should have at least one inferable agent');
+        // All inferable agents should have a name (required for subagent invocation)
+        for (const agent of inferableAgents) {
+            assert.ok(agent.frontmatter.name, `${agent.id} should have a name for subagent invocation`);
+            assert.strictEqual(typeof agent.frontmatter.name, 'string', `${agent.id} name should be a string`);
+        }
+    });
+    it('agents with handoffs should reference valid agent names', () => {
+        const result = loadAgents(TEMPLATES_AGENTS_DIR);
+        const agentIds = result.agents.map((a) => a.id);
+        for (const agent of result.agents) {
+            const handoffs = agent.frontmatter.handoffs ?? [];
+            for (const handoff of handoffs) {
+                assert.ok(agentIds.includes(handoff.agent), `${agent.id} has handoff to unknown agent: ${handoff.agent}`);
+            }
+        }
+    });
+});
+describe('Known tools completeness', () => {
+    it('should include all 12 known tools', () => {
+        assert.strictEqual(KNOWN_TOOLS.length, 12);
+        // Verify each known tool
+        assert.ok(KNOWN_TOOLS.includes('codebase'));
+        assert.ok(KNOWN_TOOLS.includes('readFile'));
+        assert.ok(KNOWN_TOOLS.includes('editFiles'));
+        assert.ok(KNOWN_TOOLS.includes('createFile'));
+        assert.ok(KNOWN_TOOLS.includes('listDirectory'));
+        assert.ok(KNOWN_TOOLS.includes('fileSearch'));
+        assert.ok(KNOWN_TOOLS.includes('textSearch'));
+        assert.ok(KNOWN_TOOLS.includes('runInTerminal'));
+        assert.ok(KNOWN_TOOLS.includes('getTerminalOutput'));
+        assert.ok(KNOWN_TOOLS.includes('problems'));
+        assert.ok(KNOWN_TOOLS.includes('usages'));
+        assert.ok(KNOWN_TOOLS.includes('runSubagent'));
+    });
+    it('known tools should have no duplicates', () => {
+        const uniqueTools = new Set(KNOWN_TOOLS);
+        assert.strictEqual(uniqueTools.size, KNOWN_TOOLS.length, 'KNOWN_TOOLS should have no duplicates');
+    });
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/core/agents/tools.test.js.map

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

package/dist/core/context.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Conversation Context Manager
+ *
+ * Manages conversation state for agent interactions:
+ * - Message history with role tracking
+ * - Context window management (token estimation + truncation)
+ * - System prompt construction from agent definitions + skills
+ * - Skill injection when trigger phrases match user input
+ *
+ * Each agent session gets its own ConversationContext. When handoffs occur,
+ * a summary can be extracted and injected into the new agent's context.
+ */
+import type { ChatMessage } from '../providers/types.js';
+import type { AgentDefinition } from './agents/types.js';
+import type { SkillDefinition } from './skills/types.js';
+/**
+ * Options for creating a ConversationContext.
+ */
+export interface ConversationContextOptions {
+    /** Maximum tokens for the context window (default: 128000) */
+    maxTokens?: number;
+    /** Tokens reserved for the model's response (default: 4096) */
+    responseReserve?: number;
+    /** Initial conversation history to restore (e.g., from a handoff) */
+    initialMessages?: ChatMessage[];
+}
+/**
+ * Summary of a conversation for handoff purposes.
+ */
+export interface ConversationSummary {
+    /** The agent that was running this conversation */
+    agentId: string;
+    /** Key points from the conversation */
+    summary: string;
+    /** Number of turns in the original conversation */
+    turnCount: number;
+    /** Any tool calls that were made */
+    toolCallSummary: string[];
+}
+/**
+ * Manages conversation state for a single agent session.
+ *
+ * Handles message accumulation, context window enforcement,
+ * and system prompt construction from agent definitions and skills.
+ *
+ * @example
+ * ```typescript
+ * const ctx = new ConversationContext(developerAgent);
+ * ctx.addUserMessage('Implement the login page');
+ *
+ * const messages = ctx.getMessages(); // system + user message
+ * // Send to LLM...
+ *
+ * ctx.addAssistantMessage('I\'ll create the login component...');
+ * ctx.addAssistantToolCalls([{ id: '1', type: 'function', function: { name: 'editFile', arguments: '...' } }]);
+ * ctx.addToolResult('1', 'File updated successfully');
+ * ```
+ */
+export declare class ConversationContext {
+    /** The agent this context belongs to */
+    private readonly agent;
+    /** Conversation messages (excluding system prompt; it's built dynamically) */
+    private messages;
+    /** Skills injected into this context */
+    private injectedSkills;
+    /** Skill content appended to system prompt */
+    private skillContent;
+    /** Context window configuration */
+    private readonly maxTokens;
+    private readonly responseReserve;
+    /** Custom context additions (handoff summaries, etc.) */
+    private additionalContext;
+    constructor(agent: AgentDefinition, options?: ConversationContextOptions);
+    /**
+     * Add a user message to the conversation.
+     */
+    addUserMessage(content: string): void;
+    /**
+     * Add an assistant text response to the conversation.
+     */
+    addAssistantMessage(content: string): void;
+    /**
+     * Add an assistant message with tool calls.
+     */
+    addAssistantToolCalls(toolCalls: ChatMessage['tool_calls'], content?: string): void;
+    /**
+     * Add a tool result message.
+     */
+    addToolResult(toolCallId: string, result: string): void;
+    /**
+     * Get the full message array for sending to the LLM.
+     * Includes the constructed system prompt as the first message.
+     * Applies truncation if context window is exceeded.
+     */
+    getMessages(): ChatMessage[];
+    /**
+     * Get just the conversation messages (without system prompt).
+     */
+    getRawMessages(): ChatMessage[];
+    /**
+     * Get the number of conversation turns (user messages).
+     */
+    getTurnCount(): number;
+    /**
+     * Get estimated token count for the current context.
+     */
+    getEstimatedTokens(): number;
+    /**
+     * Clear the conversation history, keeping injected skills.
+     */
+    clearHistory(): void;
+    /**
+     * Inject a skill's content into the system prompt.
+     * Each skill is only injected once per context.
+     *
+     * @param skill - The skill to inject
+     * @returns true if the skill was injected, false if already present
+     */
+    injectSkill(skill: SkillDefinition): boolean;
+    /**
+     * Check if a skill has been injected.
+     */
+    hasSkill(skillId: string): boolean;
+    /**
+     * Get the IDs of all injected skills.
+     */
+    getInjectedSkillIds(): string[];
+    /**
+     * Add additional context (e.g., handoff summary from previous agent).
+     */
+    addContext(context: string): void;
+    /**
+     * Generate a summary of this conversation for handoff purposes.
+     */
+    getSummary(): ConversationSummary;
+    /**
+     * Get the agent definition this context belongs to.
+     */
+    getAgent(): AgentDefinition;
+    /**
+     * Build the full system prompt from the agent definition + injected content.
+     */
+    buildSystemPrompt(): string;
+    /**
+     * Estimate token count for a string.
+     */
+    private estimateTokens;
+    /**
+     * Estimate token count for a single message including structure overhead.
+     */
+    private estimateMessageTokens;
+    /**
+     * Truncate messages to fit within the token budget.
+     *
+     * Strategy: Keep the most recent messages. Drop oldest messages first,
+     * but never drop tool results that are paired with a tool call in the
+     * retained messages (to avoid orphaned tool call references).
+     *
+     * @param messages - Messages to truncate
+     * @param maxTokens - Maximum tokens available
+     * @returns Truncated message array
+     */
+    private truncateMessages;
+    /**
+     * Remove orphaned tool results (where the corresponding assistant
+     * tool_calls message was truncated) and orphaned tool calls
+     * (where the results were truncated).
+     */
+    private repairToolCallConsistency;
+}
+//# 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":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAmBzD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,qEAAqE;IACrE,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAEhB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAmB;IAC9B,wCAAwC;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IAExC,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAqB;IAErC,wCAAwC;IACxC,OAAO,CAAC,cAAc,CAA0B;IAEhD,8CAA8C;IAC9C,OAAO,CAAC,YAAY,CAAgB;IAEpC,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEzC,yDAAyD;IACzD,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,0BAA0B;IAcxE;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1C;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,WAAW,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAQnF;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQvD;;;;OAIG;IACH,WAAW,IAAI,WAAW,EAAE;IAY5B;;OAEG;IACH,cAAc,IAAI,WAAW,EAAE;IAI/B;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAU5B;;OAEG;IACH,YAAY,IAAI,IAAI;IAQpB;;;;;;OAMG;IACH,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IAY5C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAQ/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjC;;OAEG;IACH,UAAU,IAAI,mBAAmB;IA4BjC;;OAEG;IACH,QAAQ,IAAI,eAAe;IAQ3B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IA0B3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,gBAAgB;IA6CxB;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;CAgClC"}