@qduc/term2 0.7.3 → 0.8.0

package/dist/services/subagents/role-loader.js

@@ -0,0 +1,174 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { shouldPreferPatchEditingModel } from '../../lib/tool-selection-policy.js';
+import { getEnvInfo, getAgentsInstructions } from '../../agent.js';
+const BASE_PROMPT_PATH = path.join(import.meta.dirname, '../../prompts');
+export const PROMPTS_DIR = path.join(BASE_PROMPT_PATH, 'subagents');
+const ROLE_MAX_TURNS_DEFAULT = 20;
+export function resolvePrompt(promptPath) {
+    try {
+        return fs.readFileSync(promptPath, 'utf-8').trim();
+    }
+    catch (e) {
+        const relativePromptPath = path.relative(BASE_PROMPT_PATH, promptPath);
+        const sourcePromptPath = path.join(import.meta.dirname, '../../../source/prompts', relativePromptPath.startsWith('..') ? path.basename(promptPath) : relativePromptPath);
+        if (sourcePromptPath !== promptPath && fs.existsSync(sourcePromptPath)) {
+            return fs.readFileSync(sourcePromptPath, 'utf-8').trim();
+        }
+        throw new Error(`Failed to read prompt file at ${promptPath}: ${e.message}`);
+    }
+}
+export function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match) {
+        return { frontmatter: {}, body: content };
+    }
+    const frontmatterText = match[1];
+    const body = match[2];
+    const frontmatter = {};
+    for (const line of frontmatterText.split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        let raw = line.slice(colonIdx + 1).trim();
+        const quoted = raw.length >= 2 && ((raw.startsWith('"') && raw.endsWith('"')) || (raw.startsWith("'") && raw.endsWith("'")));
+        if (quoted) {
+            frontmatter[key] = raw.slice(1, -1);
+            continue;
+        }
+        if (raw === 'true') {
+            frontmatter[key] = true;
+        }
+        else if (raw === 'false') {
+            frontmatter[key] = false;
+        }
+        else if (!isNaN(Number(raw)) && raw !== '') {
+            frontmatter[key] = Number(raw);
+        }
+        else {
+            frontmatter[key] = raw;
+        }
+    }
+    return { frontmatter, body: body.trim() };
+}
+export function loadRoleDefinition(role, settings) {
+    const filePath = path.join(PROMPTS_DIR, `${role}.md`);
+    let content;
+    try {
+        content = resolvePrompt(filePath);
+    }
+    catch (error) {
+        throw new Error(`Unknown subagent role: "${role}". No definition found at ${filePath}. Error: ${error.message}`);
+    }
+    const { frontmatter, body } = parseFrontmatter(content);
+    const subagentPrefix = role === 'mentor' ? 'agent.mentor' : `agent.subagent${role.charAt(0).toUpperCase() + role.slice(1)}`;
+    const resolve = (value, subagentKey, fallbackKey, defaultValue) => {
+        if (value === 'inherit' || value === undefined || value === null || value === '') {
+            const subagentVal = settings.get(subagentKey);
+            if (subagentVal !== undefined && subagentVal !== null) {
+                return subagentVal;
+            }
+            if (fallbackKey) {
+                return settings.get(fallbackKey) ?? defaultValue;
+            }
+            return defaultValue;
+        }
+        return value;
+    };
+    return {
+        role,
+        name: frontmatter.name ?? role,
+        instructions: body,
+        canRead: frontmatter.canRead ?? false,
+        canWrite: frontmatter.canWrite ?? false,
+        canSearchWeb: frontmatter.canSearchWeb ?? false,
+        canRunShell: frontmatter.canRunShell ?? false,
+        maxTurns: frontmatter.maxTurns ?? ROLE_MAX_TURNS_DEFAULT,
+        model: resolve(frontmatter.model, `${subagentPrefix}Model`, 'agent.model', 'gpt-4o'),
+        provider: resolve(frontmatter.provider, `${subagentPrefix}Provider`, 'agent.provider', 'openai'),
+        reasoningEffort: resolve(frontmatter.reasoningEffort, `${subagentPrefix}ReasoningEffort`, undefined, 'default'),
+        description: frontmatter.description ?? '',
+    };
+}
+export function selectSubagentBasePromptFile(model) {
+    const normalizedModel = model.toLowerCase();
+    if (normalizedModel.includes('gpt-5') && normalizedModel.includes('codex')) {
+        return 'base-codex.md';
+    }
+    if (normalizedModel.includes('sonnet') || normalizedModel.includes('haiku')) {
+        return 'base-anthropic.md';
+    }
+    if (normalizedModel.includes('gpt-5')) {
+        return 'base-gpt-5-modern.md';
+    }
+    return 'base-simple.md';
+}
+export function resolveSubagentSearchViaShell(settings, model, canRunShell) {
+    const searchViaShellSetting = settings.get('app.searchViaShell') ?? 'auto';
+    if (searchViaShellSetting === 'on')
+        return canRunShell;
+    if (searchViaShellSetting === 'off')
+        return false;
+    return shouldPreferPatchEditingModel(model) && canRunShell;
+}
+export function buildAvailableToolGuidance(toolDefinitions, searchViaShell) {
+    const toolNames = toolDefinitions.map((tool) => tool.name);
+    const hasTool = (name) => toolNames.includes(name);
+    const lines = [
+        '## Available Tool Guidance',
+        '',
+        `Registered tools: ${toolNames.length > 0 ? toolNames.map((name) => `\`${name}\``).join(', ') : 'none'}.`,
+        '',
+        'Use only these tools. If a tool mentioned elsewhere is not listed here, it is not available.',
+    ];
+    if (searchViaShell && hasTool('shell')) {
+        lines.push('For workspace search, use `shell` with commands like `rg` for text search and `fd` for file search.');
+    }
+    else if (hasTool('grep') || hasTool('find_files')) {
+        const searchTools = ['grep', 'find_files'].filter(hasTool).map((name) => `\`${name}\``);
+        lines.push(`For workspace search, use the dedicated search tools: ${searchTools.join(', ')}.`);
+    }
+    else {
+        lines.push('No dedicated workspace search tool is available. Use `read_file` and provided context where possible.');
+    }
+    if (hasTool('read_code_outline') || hasTool('code_context_search')) {
+        const codeContextTools = ['read_code_outline', 'code_context_search'].filter(hasTool).map((name) => `\`${name}\``);
+        lines.push(`For code structure and symbol context, use: ${codeContextTools.join(', ')}.`);
+    }
+    else {
+        lines.push('Code-context tools are not available in this run.');
+    }
+    if (hasTool('read_file')) {
+        lines.push('Use `read_file` for exact file contents before drawing conclusions or editing.');
+    }
+    if (hasTool('shell')) {
+        lines.push('Use `shell` only for commands that are safe, bounded, and relevant to the assigned task.');
+    }
+    if (hasTool('apply_patch') || hasTool('search_replace') || hasTool('create_file')) {
+        const writeTools = ['apply_patch', 'search_replace', 'create_file'].filter(hasTool).map((name) => `\`${name}\``);
+        lines.push(`For edits, use the registered write tools: ${writeTools.join(', ')}.`);
+    }
+    if (hasTool('web_search') || hasTool('web_fetch')) {
+        lines.push('Use web tools only when current external information or documentation is needed.');
+    }
+    return lines.join('\n');
+}
+export function buildInstructions(definition, toolDefinitions, searchViaShell, settings, executionContext) {
+    const envInfo = getEnvInfo(settings, executionContext);
+    const cwd = executionContext?.getCwd() ?? process.cwd();
+    const agentsInstructions = executionContext?.isRemote() ? '' : getAgentsInstructions(cwd);
+    const modelPrompt = resolvePrompt(path.join(PROMPTS_DIR, selectSubagentBasePromptFile(definition.model)));
+    const worktreeHygiene = resolvePrompt(path.join(PROMPTS_DIR, 'worktree-hygiene.md'));
+    const toolGuidance = buildAvailableToolGuidance(toolDefinitions, searchViaShell);
+    return [
+        modelPrompt,
+        worktreeHygiene,
+        definition.instructions,
+        toolGuidance,
+        `Environment: ${envInfo}${agentsInstructions}`,
+    ]
+        .filter(Boolean)
+        .join('\n\n');
+}
+//# sourceMappingURL=role-loader.js.map

package/dist/services/subagents/role-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-loader.js","sourceRoot":"","sources":["../../../source/services/subagents/role-loader.ts"],"names":[],"mappings":"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"}

package/dist/services/subagents/runtime.d.ts

@@ -0,0 +1,26 @@
+import type { ILoggingService, ISettingsService, ISessionContextService } from '../service-interfaces.js';
+import type { ExecutionContext } from '../execution-context.js';
+import type { ConversationEvent } from '../conversation/conversation-events.js';
+import type { ISubagentClient, ISubagentClientFactory } from './subagent-client-types.js';
+import { SubagentToolPolicy, SubagentToolFactory } from './tool-policy.js';
+import { NestedSubagentRunner } from './nested-runner.js';
+import { ExecutionSubagentRunner } from './execution-runner.js';
+import { MentorRunner } from './mentor-runner.js';
+export interface SubagentRuntimeDeps {
+    logger: ILoggingService;
+    settings: ISettingsService;
+    sessionContextService: ISessionContextService;
+    executionContext?: ExecutionContext;
+    onEvent?: (event: ConversationEvent) => void;
+    agentClient?: ISubagentClient;
+    createClient?: ISubagentClientFactory['createClient'];
+}
+export interface SubagentRuntime {
+    toolPolicy: SubagentToolPolicy;
+    toolFactory: SubagentToolFactory;
+    nestedRunner: NestedSubagentRunner;
+    executionRunner: ExecutionSubagentRunner;
+    mentorRunner: MentorRunner;
+}
+export declare function createSubagentRuntime(deps: SubagentRuntimeDeps): SubagentRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/services/subagents/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../source/services/subagents/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAuB,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,qBAAqB,EAAE,sBAAsB,CAAC;IAC9C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,YAAY,CAAC,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,WAAW,EAAE,mBAAmB,CAAC;IACjC,YAAY,EAAE,oBAAoB,CAAC;IACnC,eAAe,EAAE,uBAAuB,CAAC;IACzC,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe,CAqDhF"}

package/dist/services/subagents/runtime.js

@@ -0,0 +1,53 @@
+import { SubagentToolPolicy, SubagentToolFactory } from './tool-policy.js';
+import { NestedSubagentRunner } from './nested-runner.js';
+import { ExecutionSubagentRunner } from './execution-runner.js';
+import { MentorRunner } from './mentor-runner.js';
+export function createSubagentRuntime(deps) {
+    const toolPolicy = new SubagentToolPolicy({
+        settings: deps.settings,
+        logger: deps.logger,
+        sessionContextService: deps.sessionContextService,
+        executionContext: deps.executionContext,
+        agentClient: deps.agentClient,
+    });
+    const toolFactory = new SubagentToolFactory({
+        settings: deps.settings,
+        logger: deps.logger,
+        executionContext: deps.executionContext,
+        toolPolicy,
+    });
+    const roleToolCache = new Map();
+    const nestedRunner = new NestedSubagentRunner({
+        logger: deps.logger,
+        settings: deps.settings,
+        sessionContextService: deps.sessionContextService,
+        executionContext: deps.executionContext,
+        toolFactory,
+        onEvent: deps.onEvent,
+        roleToolCache,
+    });
+    const executionRunner = new ExecutionSubagentRunner({
+        logger: deps.logger,
+        settings: deps.settings,
+        sessionContextService: deps.sessionContextService,
+        executionContext: deps.executionContext,
+        createClient: deps.createClient,
+        toolFactory,
+        onEvent: deps.onEvent,
+    });
+    const mentorRunner = new MentorRunner({
+        logger: deps.logger,
+        settings: deps.settings,
+        sessionContextService: deps.sessionContextService,
+        executionContext: deps.executionContext,
+        onEvent: deps.onEvent,
+    });
+    return {
+        toolPolicy,
+        toolFactory,
+        nestedRunner,
+        executionRunner,
+        mentorRunner,
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/services/subagents/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../source/services/subagents/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAuB,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAqBlD,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAC7D,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC;QACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;QACjD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,IAAI,mBAAmB,CAAC;QAC1C,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,UAAU;KACX,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAyC,CAAC;IAEvE,MAAM,YAAY,GAAG,IAAI,oBAAoB,CAAC;QAC5C,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;QACjD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,WAAW;QACX,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,aAAa;KACd,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,IAAI,uBAAuB,CAAC;QAClD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;QACjD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW;QACX,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC;QACpC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;QACjD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IAEH,OAAO;QACL,UAAU;QACV,WAAW;QACX,YAAY;QACZ,eAAe;QACf,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/services/subagents/subagent-client-types.d.ts

@@ -0,0 +1,20 @@
+import type { ConversationAgentClient, ShellAutoApprovalAgentClient } from '../conversation-agent-client.js';
+/**
+ * Narrow interface SubagentManager needs from the agent client.
+ * Breaks the circular import between SubagentManager and OpenAIAgentClient.
+ */
+export type ISubagentClient = ShellAutoApprovalAgentClient;
+/**
+ * Factory for creating subagent client instances.
+ * The concrete implementation is supplied by OpenAIAgentClient, but callers
+ * only expose the ConversationSession-facing surface here.
+ */
+export interface ISubagentClientFactory {
+    createClient(opts: {
+        agent: any;
+        provider: string;
+        maxTurns: number;
+        retryAttempts?: number;
+    }): ConversationAgentClient;
+}
+//# sourceMappingURL=subagent-client-types.d.ts.map

package/dist/services/subagents/subagent-client-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-client-types.d.ts","sourceRoot":"","sources":["../../../source/services/subagents/subagent-client-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAE7G;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,IAAI,EAAE;QACjB,KAAK,EAAE,GAAG,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,uBAAuB,CAAC;CAC7B"}

package/dist/services/subagents/subagent-client-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subagent-client-types.js.map

package/dist/services/subagents/subagent-client-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-client-types.js","sourceRoot":"","sources":["../../../source/services/subagents/subagent-client-types.ts"],"names":[],"mappings":""}

package/dist/services/subagents/subagent-manager.d.ts

@@ -1,8 +1,10 @@
+import type { Tool, Agent } from '@openai/agents';
 import type { ILoggingService, ISettingsService, ISessionContextService } from '../service-interfaces.js';
-import { ExecutionContext } from '../execution-context.js';
-import type { SubagentRequest, SubagentResult } from './types.js';
-import type { ConversationEvent } from '../conversation-events.js';
-import type { OpenAIAgentClient } from '../../lib/openai-agent-client.js';
+import type { ExecutionContext } from '../execution-context.js';
+import type { SubagentRequest, SubagentResult, SupportedSubagentRole } from './types.js';
+import type { ConversationEvent } from '../conversation/conversation-events.js';
+import type { ISubagentClient, ISubagentClientFactory } from './subagent-client-types.js';
+import type { SubagentRunContext } from './tool-policy.js';
 export declare class SubagentManager {
     #private;
     constructor(deps: {
@@ -11,9 +13,14 @@ export declare class SubagentManager {
         executionContext?: ExecutionContext;
         sessionContextService: ISessionContextService;
         onEvent?: (event: ConversationEvent) => void;
-        agentClient?: Pick<OpenAIAgentClient, 'chat'>;
+        agentClient?: ISubagentClient;
+        createClient?: ISubagentClientFactory['createClient'];
     });
     resetMentorSession(): void;
+    clearCache(): void;
+    getRoleAgentTool(role: SupportedSubagentRole): Tool<SubagentRunContext>;
+    getRoleAgent(role: SupportedSubagentRole): Agent<SubagentRunContext>;
+    runAsTool(request: SubagentRequest, context?: unknown, details?: unknown): Promise<SubagentResult>;
     run(request: SubagentRequest): Promise<SubagentResult>;
 }
 //# sourceMappingURL=subagent-manager.d.ts.map

package/dist/services/subagents/subagent-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-manager.d.ts","sourceRoot":"","sources":["../../../source/services/subagents/subagent-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAoC,MAAM,YAAY,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AA8BnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AA2X1E,qBAAa,eAAe;;gBASd,IAAI,EAAE;QAChB,MAAM,EAAE,eAAe,CAAC;QACxB,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QACpC,qBAAqB,EAAE,sBAAsB,CAAC;QAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;QAC7C,WAAW,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;KAC/C;IAkBD,kBAAkB,IAAI,IAAI;IAIpB,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAuqB7D"}
+{"version":3,"file":"subagent-manager.d.ts","sourceRoot":"","sources":["../../../source/services/subagents/subagent-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAK1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,qBAAa,eAAe;;gBAMd,IAAI,EAAE;QAChB,MAAM,EAAE,eAAe,CAAC;QACxB,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QACpC,qBAAqB,EAAE,sBAAsB,CAAC;QAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;QAC7C,WAAW,CAAC,EAAE,eAAe,CAAC;QAC9B,YAAY,CAAC,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;KACvD;IAOD,kBAAkB,IAAI,IAAI;IAI1B,UAAU,IAAI,IAAI;IAIlB,gBAAgB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC,kBAAkB,CAAC;IAIvE,YAAY,CAAC,IAAI,EAAE,qBAAqB,GAAG,KAAK,CAAC,kBAAkB,CAAC;IAI9D,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAIlG,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CA4C7D"}