@inspectr/mcplab 0.1.0

package/dist/app-server/runs-store.js

@@ -0,0 +1,84 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { ensureInsideRoot } from './store-utils.js';
+export function listRuns(runsDir) {
+    if (!existsSync(runsDir))
+        return [];
+    const runDirs = readdirSync(runsDir).map((name) => ensureInsideRoot(runsDir, join(runsDir, name)));
+    const summaries = [];
+    for (const dir of runDirs) {
+        const resultsPath = join(dir, 'results.json');
+        if (!existsSync(resultsPath))
+            continue;
+        try {
+            const results = JSON.parse(readFileSync(resultsPath, 'utf8'));
+            summaries.push({
+                runId: results.metadata.run_id,
+                path: dir,
+                timestamp: results.metadata.timestamp,
+                configHash: results.metadata.config_hash,
+                totalScenarios: results.summary.total_scenarios,
+                totalRuns: results.summary.total_runs,
+                passRate: results.summary.pass_rate,
+                avgToolCalls: results.summary.avg_tool_calls_per_run,
+                avgLatencyMs: results.summary.avg_tool_latency_ms ?? 0
+            });
+        }
+        catch {
+            // Ignore malformed runs.
+        }
+    }
+    return summaries.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+}
+export function getRunResults(runId, runsDir) {
+    const runDir = ensureInsideRoot(runsDir, join(runsDir, runId));
+    const resultsPath = ensureInsideRoot(runsDir, join(runDir, 'results.json'));
+    if (!existsSync(resultsPath))
+        throw new Error(`Run not found: ${runId}`);
+    return JSON.parse(readFileSync(resultsPath, 'utf8'));
+}
+export function selectScenarioIds(config, requestedScenarioIds) {
+    if (!requestedScenarioIds || requestedScenarioIds.length === 0)
+        return config;
+    const requested = requestedScenarioIds.map((id) => id.trim()).filter(Boolean);
+    if (requested.length === 0)
+        return config;
+    const requestedSet = new Set(requested);
+    const scenarios = config.scenarios.filter((scenario) => requestedSet.has(scenario.id));
+    const foundSet = new Set(scenarios.map((scenario) => scenario.id));
+    const missing = requested.filter((id) => !foundSet.has(id));
+    if (missing.length > 0) {
+        throw new Error(`Unknown scenarios: ${missing.join(', ')}. Available: ${config.scenarios
+            .map((s) => s.id)
+            .join(', ')}`);
+    }
+    return { ...config, scenarios };
+}
+export function getScenarioRunTraceRecords(runId, runsDir) {
+    const runDir = ensureInsideRoot(runsDir, join(runsDir, runId));
+    const tracePath = ensureInsideRoot(runsDir, join(runDir, 'trace.jsonl'));
+    if (!existsSync(tracePath))
+        return [];
+    const lines = readFileSync(tracePath, 'utf8')
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const records = [];
+    for (const line of lines) {
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed &&
+                parsed.type === 'scenario_run' &&
+                parsed.trace_version === 3 &&
+                typeof parsed.scenario_id === 'string' &&
+                typeof parsed.agent === 'string') {
+                records.push(parsed);
+            }
+        }
+        catch {
+            // Ignore malformed lines.
+        }
+    }
+    return records;
+}
+//# sourceMappingURL=runs-store.js.map

package/dist/app-server/runs-store.js.map

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

package/dist/app-server/scenario-assistant-domain.d.ts

@@ -0,0 +1,162 @@
+import type { AgentConfig, EvalConfig, LlmMessage, ToolDef } from '@inspectr/mcplab-core';
+import { McpClientManager } from '@inspectr/mcplab-core';
+import { readLibraries } from './libraries-store.js';
+export { truncateJson } from './assistant-common.js';
+interface ScenarioAssistantContextInput {
+  configSnapshotPolicy?: {
+    enabled?: boolean;
+    mode?: 'warn' | 'fail_on_drift';
+    baselineSnapshotId?: string;
+  };
+  scenario: {
+    id: string;
+    name?: string;
+    prompt: string;
+    serverNames: string[];
+    evalRules: Array<{
+      type: string;
+      value: string;
+    }>;
+    extractRules: Array<{
+      name: string;
+      pattern: string;
+    }>;
+    snapshotEval?: {
+      enabled?: boolean;
+      baselineSnapshotId?: string;
+    };
+  };
+  availableServers?: Array<{
+    name: string;
+    url?: string;
+  }>;
+  availableAgents?: Array<{
+    name: string;
+    provider: string;
+    model: string;
+  }>;
+}
+interface ScenarioAssistantSuggestionBundle {
+  prompt?: {
+    replacement: string;
+    rationale?: string;
+  };
+  evalRules?: {
+    replacement: Array<{
+      type: string;
+      value: string;
+    }>;
+    rationale?: string;
+  };
+  extractRules?: {
+    replacement: Array<{
+      name: string;
+      pattern: string;
+    }>;
+    rationale?: string;
+  };
+  snapshotEval?: {
+    patch: {
+      enabled?: boolean;
+      baselineSnapshotId?: string;
+    };
+    rationale?: string;
+  };
+  notes?: string[];
+}
+interface AssistantPendingToolCall {
+  id: string;
+  server: string;
+  tool: string;
+  publicToolName: string;
+  arguments: unknown;
+  status: 'pending' | 'approved' | 'denied' | 'error';
+  createdAt: string;
+  resultPreview?: string;
+  error?: string;
+}
+interface AssistantChatMessage {
+  id: string;
+  role: 'user' | 'assistant' | 'tool' | 'system';
+  text: string;
+  createdAt: string;
+  suggestions?: ScenarioAssistantSuggestionBundle;
+  pendingToolCallId?: string;
+  toolRequestServer?: string;
+  toolRequestName?: string;
+  toolRequestPublicName?: string;
+}
+export interface ScenarioAssistantSession {
+  id: string;
+  createdAt: number;
+  lastTouchedAt: number;
+  configPath?: string;
+  selectedAssistantAgentName: string;
+  context: ScenarioAssistantContextInput;
+  agentConfig: AgentConfig;
+  mcp: McpClientManager;
+  tools: ToolDef[];
+  toolPublicMap: Map<
+    string,
+    {
+      server: string;
+      tool: string;
+    }
+  >;
+  pendingToolCalls: AssistantPendingToolCall[];
+  chatMessages: AssistantChatMessage[];
+  llmMessages: LlmMessage[];
+  warnings: string[];
+  systemPromptCache?: string;
+}
+export declare function cleanupAssistantSessions(
+  sessions: Map<string, ScenarioAssistantSession>,
+  now?: number
+): void;
+export declare function touchAssistantSession(session: ScenarioAssistantSession): void;
+export declare function assistantSessionView(session: ScenarioAssistantSession): {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  selectedAssistantAgentName: string;
+  model: string;
+  provider: 'openai' | 'anthropic' | 'azure_openai';
+  warnings: string[];
+  toolsLoaded: number;
+  toolServers: string[];
+  messages: AssistantChatMessage[];
+  pendingToolCalls: AssistantPendingToolCall[];
+};
+export declare function preloadAssistantTools(
+  session: ScenarioAssistantSession,
+  serversByName: Record<string, EvalConfig['servers'][string]>,
+  selectedServerNames: string[]
+): Promise<void>;
+export declare function continueAssistantTurn(session: ScenarioAssistantSession): Promise<{
+  session: ReturnType<typeof assistantSessionView>;
+  response: {
+    type: 'assistant_message' | 'tool_call_request';
+    text: string;
+    suggestions?: ScenarioAssistantSuggestionBundle;
+    pendingToolCall?: AssistantPendingToolCall;
+  };
+}>;
+export declare function executeAssistantToolCall(
+  session: ScenarioAssistantSession,
+  pending: AssistantPendingToolCall
+): Promise<unknown>;
+export declare function summarizeToolResultForAssistant(result: unknown): string;
+export declare function resolveAssistantAgentFromConfig(
+  config: EvalConfig,
+  selectedAssistantAgentName: string
+): AgentConfig;
+export declare function resolveAssistantAgentFromLibraries(
+  libraries: ReturnType<typeof readLibraries>,
+  selectedAssistantAgentName: string
+): AgentConfig;
+export declare function pickDefaultAssistantAgentName(params: {
+  requested?: string;
+  settingsDefault?: string;
+  agentNames: string[];
+}): string;
+//# sourceMappingURL=scenario-assistant-domain.d.ts.map

package/dist/app-server/scenario-assistant-domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-assistant-domain.d.ts","sourceRoot":"","sources":["../../src/app-server/scenario-assistant-domain.ts"],"names":[],"mappings":"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"}

package/dist/app-server/scenario-assistant-domain.js

@@ -0,0 +1,269 @@
+import { chatWithJsonRetry, cleanupSessionsByTtl, makeAssistantToolPublicName, newAssistantEntityId, touchSession, truncateJson, withTimeout } from './assistant-common.js';
+export { truncateJson } from './assistant-common.js';
+const SCENARIO_ASSISTANT_SESSION_TTL_MS = 30 * 60 * 1000;
+const SCENARIO_ASSISTANT_MAX_TOOL_CALLS_PER_TURN = 3;
+const SCENARIO_ASSISTANT_TOOL_RESULT_PREVIEW_CHARS = 4000;
+export function cleanupAssistantSessions(sessions, now = Date.now()) {
+    cleanupSessionsByTtl(sessions, SCENARIO_ASSISTANT_SESSION_TTL_MS, now);
+}
+export function touchAssistantSession(session) {
+    touchSession(session);
+}
+export function assistantSessionView(session) {
+    return {
+        id: session.id,
+        createdAt: new Date(session.createdAt).toISOString(),
+        updatedAt: new Date(session.lastTouchedAt).toISOString(),
+        selectedAssistantAgentName: session.selectedAssistantAgentName,
+        model: session.agentConfig.model,
+        provider: session.agentConfig.provider,
+        warnings: session.warnings,
+        toolsLoaded: session.tools.length,
+        toolServers: Array.from(new Set(session.tools.map((tool) => tool.name.split('__')[0]))),
+        messages: session.chatMessages,
+        pendingToolCalls: session.pendingToolCalls.filter((call) => call.status === 'pending')
+    };
+}
+function assistantSystemPrompt(session) {
+    if (session.systemPromptCache)
+        return session.systemPromptCache;
+    const { scenario, configSnapshotPolicy } = session.context;
+    const toolLines = session.tools.map((tool) => {
+        const mapping = session.toolPublicMap.get(tool.name);
+        const schemaText = tool.inputSchema ? truncateJson(tool.inputSchema, 500) : '{}';
+        return `- ${tool.name} (server=${mapping?.server ?? 'unknown'}, tool=${mapping?.tool ?? tool.name}) schema=${schemaText}`;
+    });
+    const prompt = [
+        'You are a Scenario Authoring Assistant for MCP evaluation scenarios.',
+        'Goal: help the user author deterministic scenario prompt, Checks (pass/fail), Value Capture Rules, and snapshot settings.',
+        'Use the available MCP tools and schemas to ground suggestions.',
+        'If you need live MCP information, call a tool and wait for approval.',
+        'Use user-facing terminology in your text responses: "Checks" and "Value Capture Rules" (not "eval rules" / "extract rules").',
+        'Respond ONLY as JSON with one of these envelopes:',
+        `{"type":"assistant_message","text":"...","suggestions":{...optional...}}`,
+        `{"type":"tool_call_request","text":"...","toolCall":{"name":"PUBLIC_TOOL_NAME","arguments":{}},"suggestions":{...optional...}}`,
+        'For suggestions, use keys: prompt, evalRules, extractRules, snapshotEval, notes.',
+        'prompt: { replacement: string, rationale?: string }',
+        'evalRules: { replacement: [{ type, value }...], rationale?: string }',
+        'extractRules: { replacement: [{ name, pattern }...], rationale?: string }',
+        'snapshotEval: { patch: { enabled?: boolean, baselineSnapshotId?: string }, rationale?: string }',
+        'If you propose any edits to the scenario (prompt, Checks, Value Capture Rules, or snapshot settings), you MUST include the corresponding structured suggestions payload.',
+        'Do not describe "suggested updates" in text only. Include suggestions so the UI can render Apply actions.',
+        'Keep rule types limited to: required_tool, forbidden_tool, response_contains, response_not_contains.',
+        'Ask clarifying questions if the scenario intent is unclear.',
+        `Scenario context: ${JSON.stringify({
+            id: scenario.id,
+            name: scenario.name ?? '',
+            prompt: scenario.prompt,
+            serverNames: scenario.serverNames,
+            evalRules: scenario.evalRules,
+            extractRules: scenario.extractRules,
+            snapshotEval: scenario.snapshotEval ?? null,
+            configSnapshotPolicy: configSnapshotPolicy ?? null
+        })}`,
+        toolLines.length > 0
+            ? `Available MCP tools:\n${toolLines.join('\n')}`
+            : 'No MCP tools available.'
+    ].join('\n');
+    session.systemPromptCache = prompt;
+    return prompt;
+}
+function formatAssistantMcpPreloadError(serverName, error) {
+    const raw = error instanceof Error ? error.message : String(error);
+    const htmlErrorMatch = raw.match(/Error code\s+(\d{3})/i) ??
+        raw.match(/<title>[^<]*\b(\d{3})\b[^<]*<\/title>/i) ??
+        raw.match(/\b(502|503|504)\b/);
+    const cloudflare = /cloudflare/i.test(raw);
+    if (/<html/i.test(raw) || /<!doctype html/i.test(raw)) {
+        const code = htmlErrorMatch?.[1];
+        const provider = cloudflare ? ' (Cloudflare)' : '';
+        return `Scenario Assistant MCP preload failed for server '${serverName}': Upstream MCP endpoint returned an HTML error page${code ? ` (${code})` : ''}${provider}. Check that the MCP server is reachable and healthy.`;
+    }
+    return `Scenario Assistant MCP preload failed for server '${serverName}': ${raw}`;
+}
+export async function preloadAssistantTools(session, serversByName, selectedServerNames) {
+    const usedNames = new Set();
+    for (const serverName of selectedServerNames) {
+        const server = serversByName[serverName];
+        if (!server) {
+            session.warnings.push(`Scenario Assistant: server '${serverName}' not found in config.`);
+            continue;
+        }
+        try {
+            await session.mcp.connectAll({ [serverName]: server });
+            const tools = await session.mcp.listTools(serverName);
+            for (const tool of tools) {
+                const publicName = makeAssistantToolPublicName(serverName, tool.name, usedNames);
+                session.toolPublicMap.set(publicName, { server: serverName, tool: tool.name });
+                session.tools.push({
+                    ...tool,
+                    name: publicName,
+                    description: `${tool.description ?? ''}\n[server=${serverName} tool=${tool.name}]`.trim()
+                });
+            }
+        }
+        catch (error) {
+            session.warnings.push(formatAssistantMcpPreloadError(serverName, error));
+        }
+    }
+}
+function parseAssistantModelOutput(text) {
+    const cleaned = text.trim();
+    let parsed;
+    try {
+        parsed = JSON.parse(cleaned);
+    }
+    catch {
+        const fenced = cleaned.match(/```json\s*([\s\S]+?)```/i) ?? cleaned.match(/```\s*([\s\S]+?)```/i);
+        if (fenced) {
+            parsed = JSON.parse(fenced[1]);
+        }
+        else {
+            throw new Error('Assistant returned invalid JSON');
+        }
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error('Assistant response must be a JSON object');
+    }
+    const parsedObj = parsed;
+    if (parsedObj.type !== 'assistant_message' && parsedObj.type !== 'tool_call_request') {
+        throw new Error("Assistant response type must be 'assistant_message' or 'tool_call_request'");
+    }
+    if (typeof parsedObj.text !== 'string') {
+        throw new Error('Assistant response missing text');
+    }
+    if (parsedObj.type === 'tool_call_request') {
+        if (!parsedObj.toolCall || typeof parsedObj.toolCall !== 'object') {
+            throw new Error('Assistant tool_call_request missing toolCall');
+        }
+        if (typeof parsedObj.toolCall.name !== 'string' || !parsedObj.toolCall.name.trim()) {
+            throw new Error('Assistant toolCall.name must be a non-empty string');
+        }
+    }
+    return parsedObj;
+}
+function safeAssistantTextFromResponse(rawText) {
+    try {
+        return parseAssistantModelOutput(rawText).text;
+    }
+    catch {
+        return rawText.trim();
+    }
+}
+async function assistantChatModel(session) {
+    return chatWithJsonRetry({
+        agent: session.agentConfig,
+        messages: session.llmMessages,
+        tools: session.tools,
+        system: assistantSystemPrompt(session),
+        parse: parseAssistantModelOutput,
+        toolCallFallbackText: (toolName) => `I need to call '${toolName}' to help answer.`
+    });
+}
+export async function continueAssistantTurn(session) {
+    const pendingCountForTurn = session.pendingToolCalls.filter((c) => c.status === 'pending').length;
+    if (pendingCountForTurn > SCENARIO_ASSISTANT_MAX_TOOL_CALLS_PER_TURN) {
+        throw new Error('Scenario Assistant exceeded maximum pending tool calls for this turn');
+    }
+    const modelOutput = await assistantChatModel(session);
+    if (modelOutput.type === 'tool_call_request') {
+        const requested = modelOutput.toolCall;
+        const mapping = session.toolPublicMap.get(requested.name);
+        if (!mapping) {
+            throw new Error(`Scenario Assistant requested unknown tool '${requested.name}'. Available tools: ${session.tools.map((t) => t.name).join(', ')}`);
+        }
+        const pending = {
+            id: newAssistantEntityId('satc'),
+            server: mapping.server,
+            tool: mapping.tool,
+            publicToolName: requested.name,
+            arguments: requested.arguments ?? {},
+            status: 'pending',
+            createdAt: new Date().toISOString()
+        };
+        session.pendingToolCalls.push(pending);
+        session.chatMessages.push({
+            id: newAssistantEntityId('msg'),
+            role: 'assistant',
+            text: modelOutput.text,
+            createdAt: new Date().toISOString(),
+            suggestions: modelOutput.suggestions,
+            pendingToolCallId: pending.id,
+            toolRequestServer: pending.server,
+            toolRequestName: pending.tool,
+            toolRequestPublicName: pending.publicToolName
+        });
+        session.llmMessages.push({
+            role: 'assistant',
+            content: modelOutput.text,
+            tool_calls: [
+                {
+                    id: pending.id,
+                    name: pending.publicToolName,
+                    arguments: pending.arguments
+                }
+            ]
+        });
+        touchAssistantSession(session);
+        return {
+            session: assistantSessionView(session),
+            response: {
+                type: 'tool_call_request',
+                text: modelOutput.text,
+                suggestions: modelOutput.suggestions,
+                pendingToolCall: pending
+            }
+        };
+    }
+    session.chatMessages.push({
+        id: newAssistantEntityId('msg'),
+        role: 'assistant',
+        text: modelOutput.text,
+        createdAt: new Date().toISOString(),
+        suggestions: modelOutput.suggestions
+    });
+    session.llmMessages.push({
+        role: 'assistant',
+        content: JSON.stringify(modelOutput)
+    });
+    touchAssistantSession(session);
+    return {
+        session: assistantSessionView(session),
+        response: {
+            type: 'assistant_message',
+            text: modelOutput.text,
+            suggestions: modelOutput.suggestions
+        }
+    };
+}
+export async function executeAssistantToolCall(session, pending) {
+    const timeoutMs = 10_000;
+    return withTimeout(() => session.mcp.callTool(pending.server, pending.tool, pending.arguments), timeoutMs, `Tool call timed out after ${timeoutMs}ms`);
+}
+export function summarizeToolResultForAssistant(result) {
+    return truncateJson(result, SCENARIO_ASSISTANT_TOOL_RESULT_PREVIEW_CHARS);
+}
+export function resolveAssistantAgentFromConfig(config, selectedAssistantAgentName) {
+    const agent = config.agents[selectedAssistantAgentName];
+    if (!agent) {
+        throw new Error(`Scenario Assistant agent '${selectedAssistantAgentName}' not found in resolved config agents.`);
+    }
+    return agent;
+}
+export function resolveAssistantAgentFromLibraries(libraries, selectedAssistantAgentName) {
+    const agent = libraries.agents[selectedAssistantAgentName];
+    if (!agent) {
+        throw new Error(`Scenario Assistant agent '${selectedAssistantAgentName}' not found in library agents. Configure the central Scenario Assistant Agent in Libraries > Scenarios.`);
+    }
+    return agent;
+}
+export function pickDefaultAssistantAgentName(params) {
+    const requested = params.requested?.trim();
+    if (requested)
+        return requested;
+    const settingsDefault = params.settingsDefault?.trim();
+    if (settingsDefault)
+        return settingsDefault;
+    return params.agentNames[0] ?? '';
+}
+//# sourceMappingURL=scenario-assistant-domain.js.map

package/dist/app-server/scenario-assistant-domain.js.map

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

package/dist/app-server/scenario-assistant.d.ts

@@ -0,0 +1,29 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { AppRouteDeps, AppRouteRequestContext, AssistantSessionsMap } from './app-context.js';
+export type ScenarioAssistantRouteDeps = Pick<
+  AppRouteDeps,
+  | 'parseBody'
+  | 'asJson'
+  | 'cleanupAssistantSessions'
+  | 'touchAssistantSession'
+  | 'assistantSessionView'
+  | 'ensureInsideRoot'
+  | 'readLibraries'
+  | 'pickDefaultAssistantAgentName'
+  | 'resolveAssistantAgentFromConfig'
+  | 'resolveAssistantAgentFromLibraries'
+  | 'preloadAssistantTools'
+  | 'continueAssistantTurn'
+  | 'executeAssistantToolCall'
+  | 'summarizeToolResultForAssistant'
+>;
+export declare function handleScenarioAssistantRoutes(params: {
+  req: IncomingMessage;
+  res: ServerResponse;
+  pathname: string;
+  method: string;
+  settings: AppRouteRequestContext['settings'];
+  assistantSessions: AssistantSessionsMap;
+  deps: ScenarioAssistantRouteDeps;
+}): Promise<boolean>;
+//# sourceMappingURL=scenario-assistant.d.ts.map

package/dist/app-server/scenario-assistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-assistant.d.ts","sourceRoot":"","sources":["../../src/app-server/scenario-assistant.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAQjE,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGnG,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,YAAY,EACV,WAAW,GACX,QAAQ,GACR,0BAA0B,GAC1B,uBAAuB,GACvB,sBAAsB,GACtB,kBAAkB,GAClB,eAAe,GACf,+BAA+B,GAC/B,iCAAiC,GACjC,oCAAoC,GACpC,uBAAuB,GACvB,uBAAuB,GACvB,0BAA0B,GAC1B,iCAAiC,CACpC,CAAC;AAEF,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,GAAG,EAAE,eAAe,CAAC;IACrB,GAAG,EAAE,cAAc,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC7C,iBAAiB,EAAE,oBAAoB,CAAC;IACxC,IAAI,EAAE,0BAA0B,CAAC;CAClC,GAAG,OAAO,CAAC,OAAO,CAAC,CAyRnB"}