npm - @nexus-cortex/executors - Versions diffs - 4.26.0 - Mend

@nexus-cortex/executors 4.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (365) hide show

package/dist/implementations/addon/terminal-client.html ADDED Viewed

@@ -0,0 +1,253 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Terminal Sandbox</title>
+  <!-- xterm.js CSS -->
+  <link rel="stylesheet" href="https://unpkg.com/xterm@5.0.0/css/xterm.css" />
+  <style>
+    * {
+      margin: 0;
+      padding: 0;
+      box-sizing: border-box;
+    }
+    body {
+      background: #1e1e1e;
+      font-family: 'Courier New', Courier, monospace;
+      overflow: hidden;
+    }
+    #terminal-container {
+      width: 100vw;
+      height: 100vh;
+      padding: 10px;
+      display: flex;
+      flex-direction: column;
+    }
+    #terminal {
+      flex: 1;
+      background: #000000;
+    }
+    #status-bar {
+      height: 24px;
+      background: #2d2d2d;
+      color: #fff;
+      padding: 4px 10px;
+      font-size: 12px;
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+    }
+    .status-item {
+      display: flex;
+      gap: 10px;
+    }
+    .indicator {
+      width: 8px;
+      height: 8px;
+      border-radius: 50%;
+      display: inline-block;
+    }
+    .indicator.connected {
+      background: #0f0;
+      box-shadow: 0 0 4px #0f0;
+    }
+    .indicator.disconnected {
+      background: #f00;
+      box-shadow: 0 0 4px #f00;
+    }
+  </style>
+</head>
+<body>
+  <div id="terminal-container">
+    <div id="status-bar">
+      <div class="status-item">
+        <span class="indicator disconnected" id="connection-indicator"></span>
+        <span id="connection-status">Connecting...</span>
+      </div>
+      <div class="status-item">
+        <span id="terminal-info">Terminal Sandbox</span>
+      </div>
+    </div>
+    <div id="terminal"></div>
+  </div>
+  <!-- xterm.js and addons -->
+  <script src="https://unpkg.com/xterm@5.0.0/lib/xterm.js"></script>
+  <script src="https://unpkg.com/xterm-addon-fit@0.6.0/lib/xterm-addon-fit.js"></script>
+  <script src="https://unpkg.com/xterm-addon-web-links@0.7.0/lib/xterm-addon-web-links.js"></script>
+  <script>
+    // Configuration
+    const WS_PORT = 3001;
+    const WS_URL = `ws://localhost:${WS_PORT}`;
+    // UI elements
+    const indicator = document.getElementById('connection-indicator');
+    const statusText = document.getElementById('connection-status');
+    // Create terminal with xterm.js
+    const term = new Terminal({
+      cursorBlink: true,
+      cursorStyle: 'block',
+      fontSize: 14,
+      fontFamily: 'Menlo, Monaco, "Courier New", monospace',
+      fontWeight: 'normal',
+      lineHeight: 1.2,
+      letterSpacing: 0,
+      theme: {
+        background: '#000000',
+        foreground: '#ffffff',
+        cursor: '#ffffff',
+        cursorAccent: '#000000',
+        selection: '#ffffff40',
+        black: '#000000',
+        red: '#e06c75',
+        green: '#98c379',
+        yellow: '#d19a66',
+        blue: '#61afef',
+        magenta: '#c678dd',
+        cyan: '#56b6c2',
+        white: '#abb2bf',
+        brightBlack: '#5c6370',
+        brightRed: '#e06c75',
+        brightGreen: '#98c379',
+        brightYellow: '#d19a66',
+        brightBlue: '#61afef',
+        brightMagenta: '#c678dd',
+        brightCyan: '#56b6c2',
+        brightWhite: '#ffffff'
+      },
+      allowProposedApi: true,
+      scrollback: 1000,
+      tabStopWidth: 4
+    });
+    // Load addons
+    const fitAddon = new FitAddon.FitAddon();
+    const webLinksAddon = new WebLinksAddon.WebLinksAddon();
+    term.loadAddon(fitAddon);
+    term.loadAddon(webLinksAddon);
+    // Open terminal in DOM
+    term.open(document.getElementById('terminal'));
+    // Fit to window
+    fitAddon.fit();
+    // WebSocket connection
+    let ws = null;
+    let reconnectAttempts = 0;
+    const MAX_RECONNECT_ATTEMPTS = 5;
+    function connect() {
+      ws = new WebSocket(WS_URL);
+      ws.onopen = () => {
+        console.log('Connected to terminal server');
+        updateStatus(true);
+        reconnectAttempts = 0;
+        // Terminal welcome message
+        term.writeln('\x1b[32m✓ Connected to terminal server\x1b[0m');
+        term.writeln('');
+      };
+      ws.onmessage = (event) => {
+        // Write server output to terminal
+        term.write(event.data);
+      };
+      ws.onerror = (error) => {
+        console.error('WebSocket error:', error);
+        updateStatus(false, 'Connection error');
+      };
+      ws.onclose = () => {
+        console.log('Disconnected from terminal server');
+        updateStatus(false, 'Disconnected');
+        // Attempt to reconnect
+        if (reconnectAttempts < MAX_RECONNECT_ATTEMPTS) {
+          reconnectAttempts++;
+          setTimeout(() => {
+            console.log(`Reconnecting... (attempt ${reconnectAttempts})`);
+            connect();
+          }, 2000);
+        } else {
+          term.writeln('');
+          term.writeln('\x1b[31m✗ Connection lost. Max reconnect attempts reached.\x1b[0m');
+        }
+      };
+    }
+    // Update connection status
+    function updateStatus(connected, message) {
+      if (connected) {
+        indicator.className = 'indicator connected';
+        statusText.textContent = 'Connected';
+      } else {
+        indicator.className = 'indicator disconnected';
+        statusText.textContent = message || 'Disconnected';
+      }
+    }
+    // Send user input to server
+    term.onData((data) => {
+      if (ws && ws.readyState === WebSocket.OPEN) {
+        ws.send(data);
+      }
+    });
+    // Handle window resize
+    window.addEventListener('resize', () => {
+      fitAddon.fit();
+    });
+    // Handle terminal paste
+    term.onKey((e) => {
+      if (e.domEvent.ctrlKey && e.domEvent.key === 'v') {
+        // Paste from clipboard
+        navigator.clipboard.readText().then((text) => {
+          if (ws && ws.readyState === WebSocket.OPEN) {
+            ws.send(text);
+          }
+        });
+      }
+    });
+    // Focus terminal on load
+    term.focus();
+    // Connect to server
+    connect();
+    // Keyboard shortcuts
+    document.addEventListener('keydown', (e) => {
+      // Ctrl+C: Copy selection
+      if (e.ctrlKey && e.key === 'c' && term.hasSelection()) {
+        e.preventDefault();
+        const selection = term.getSelection();
+        navigator.clipboard.writeText(selection);
+      }
+      // Ctrl+L: Clear terminal
+      if (e.ctrlKey && e.key === 'l') {
+        e.preventDefault();
+        term.clear();
+      }
+    });
+  </script>
+</body>
+</html>

package/dist/implementations/agent/PRAgentTool.d.ts ADDED Viewed

@@ -0,0 +1,37 @@
+/**
+ * PRAgent Tool Executor
+ *
+ * Manages GitHub pull request operations — review, create, list, and post reviews.
+ * Uses the gh CLI for all GitHub interactions.
+ * Returns structured context for the LLM to dispatch Task calls to specialized agents.
+ *
+ * Security: all gh invocations use execFile with an argument array (no shell), and every
+ * repo/prNumber/action is validated through GitPolicy before use. See GitPolicy.ts.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+export interface PRAgentParams {
+    repo: string;
+    mode: 'review' | 'create' | 'list' | 'post-review';
+    prNumber?: number;
+    branch?: string;
+    action?: 'approve' | 'request-changes' | 'comment';
+    body?: string;
+    diffOptions?: {
+        pathFilter?: string;
+        maxLines?: number;
+    };
+}
+export declare class PRAgentToolExecutor extends BaseTool<PRAgentParams, ToolResult> {
+    private readonly policy;
+    constructor(_config: ExecutorConfig);
+    validateToolParams(params: PRAgentParams): string | null;
+    execute(params: PRAgentParams, signal: AbortSignal): Promise<ToolResult>;
+    /** Shared gh invocation: execFile (no shell), policy token/host env, large buffer. */
+    private gh;
+    private reviewPR;
+    private createPR;
+    private listPRs;
+    private postReview;
+}
+//# sourceMappingURL=PRAgentTool.d.ts.map

package/dist/implementations/agent/PRAgentTool.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"PRAgentTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/agent/PRAgentTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAajE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,qBAAa,mBAAoB,SAAQ,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAEvB,OAAO,EAAE,cAAc;IAoCnC,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI;IAiClD,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA4B9E,sFAAsF;IACtF,OAAO,CAAC,EAAE;YASI,QAAQ;IAwEtB,OAAO,CAAC,QAAQ;YAeF,OAAO;YAqCP,UAAU;CAsCzB"}

package/dist/implementations/agent/PRAgentTool.js ADDED Viewed

@@ -0,0 +1,257 @@
+/**
+ * PRAgent Tool Executor
+ *
+ * Manages GitHub pull request operations — review, create, list, and post reviews.
+ * Uses the gh CLI for all GitHub interactions.
+ * Returns structured context for the LLM to dispatch Task calls to specialized agents.
+ *
+ * Security: all gh invocations use execFile with an argument array (no shell), and every
+ * repo/prNumber/action is validated through GitPolicy before use. See GitPolicy.ts.
+ */
+import { BaseTool } from '../../base/index.js';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { GitPolicy } from '../../utils/GitPolicy.js';
+const execFileAsync = promisify(execFile);
+/** Pull the real failure reason out of an execFile rejection (stderr, then message). */
+function subprocessError(error) {
+    const stderr = (error?.stderr || '').toString().trim();
+    return stderr || error?.message || 'unknown subprocess error';
+}
+export class PRAgentToolExecutor extends BaseTool {
+    policy;
+    constructor(_config) {
+        super('PRAgent', 'PRAgent', 'Manage GitHub pull requests — review, create, list, and post reviews', {
+            type: 'object',
+            properties: {
+                repo: { type: 'string', description: 'Repository in "owner/repo" format' },
+                mode: {
+                    type: 'string',
+                    enum: ['review', 'create', 'list', 'post-review'],
+                    description: 'Operation mode',
+                },
+                prNumber: { type: 'number', description: 'PR number' },
+                branch: { type: 'string', description: 'Branch name for create mode' },
+                action: {
+                    type: 'string',
+                    enum: ['approve', 'request-changes', 'comment'],
+                    description: 'Review action',
+                },
+                body: { type: 'string', description: 'Comment body' },
+                diffOptions: {
+                    type: 'object',
+                    properties: {
+                        pathFilter: { type: 'string' },
+                        maxLines: { type: 'number' },
+                    },
+                },
+            },
+            required: ['repo', 'mode'],
+        });
+        this.policy = GitPolicy.fromEnv();
+    }
+    validateToolParams(params) {
+        const repoErr = this.policy.validateRepo(params.repo);
+        if (repoErr)
+            return repoErr;
+        if (!['review', 'create', 'list', 'post-review'].includes(params.mode)) {
+            return 'mode must be one of: review, create, list, post-review';
+        }
+        // Map mode → policy action for the allow-list.
+        const actionForMode = params.mode === 'create' ? 'create' : params.mode;
+        const actionErr = this.policy.assertAction(actionForMode);
+        if (actionErr)
+            return actionErr;
+        if (params.mode === 'review' || params.mode === 'post-review') {
+            const prErr = this.policy.validatePrNumber(params.prNumber);
+            if (prErr)
+                return prErr;
+        }
+        if (params.mode === 'post-review') {
+            if (!params.action)
+                return 'action is required for post-review mode';
+            if ((params.action === 'request-changes' || params.action === 'comment') &&
+                (!params.body || params.body.trim() === '')) {
+                return `body is required for the "${params.action}" action`;
+            }
+        }
+        if (params.branch !== undefined) {
+            const branchErr = this.policy.validateBranch(params.branch);
+            if (branchErr)
+                return branchErr;
+        }
+        return null;
+    }
+    async execute(params, signal) {
+        // Verify gh is available
+        try {
+            await execFileAsync('gh', ['--version'], { signal });
+        }
+        catch {
+            return this.createErrorResult('GitHub CLI (gh) is not installed or not in PATH. Install it: https://cli.github.com/');
+        }
+        try {
+            switch (params.mode) {
+                case 'review':
+                    return await this.reviewPR(params, signal);
+                case 'create':
+                    return this.createPR(params);
+                case 'list':
+                    return await this.listPRs(params, signal);
+                case 'post-review':
+                    return await this.postReview(params, signal);
+                default:
+                    return this.createErrorResult(`Unknown mode: ${params.mode}`);
+            }
+        }
+        catch (error) {
+            return this.createErrorResult(`PRAgent error: ${subprocessError(error)}`);
+        }
+    }
+    /** Shared gh invocation: execFile (no shell), policy token/host env, large buffer. */
+    gh(args, signal) {
+        return execFileAsync('gh', args, {
+            encoding: 'utf-8',
+            maxBuffer: 10 * 1024 * 1024,
+            signal,
+            env: this.policy.subprocessEnv(),
+        });
+    }
+    async reviewPR(params, signal) {
+        const { repo } = params;
+        const prNumber = this.policy.prNumber(params.prNumber);
+        const maxLines = params.diffOptions?.maxLines || 5000;
+        // Get PR metadata
+        const { stdout: metadataRaw } = await this.gh([
+            'pr',
+            'view',
+            String(prNumber),
+            '--repo',
+            repo,
+            '--json',
+            'number,title,author,body,baseRefName,headRefName,labels,reviewDecision,additions,deletions,changedFiles,commits,files',
+        ], signal);
+        const metadata = JSON.parse(metadataRaw);
+        // Get PR diff
+        const { stdout: rawDiff } = await this.gh(['pr', 'diff', String(prNumber), '--repo', repo], signal);
+        let diff = rawDiff;
+        // Apply path filter if specified
+        if (params.diffOptions?.pathFilter) {
+            const filter = params.diffOptions.pathFilter;
+            const sections = diff.split(/^diff --git /m);
+            const filtered = sections.filter((s) => s.includes(filter));
+            diff = filtered.map((s) => 'diff --git ' + s).join('');
+        }
+        // Truncate if needed
+        const lines = diff.split('\n');
+        const truncated = lines.length > maxLines;
+        if (truncated) {
+            diff = lines.slice(0, maxLines).join('\n') + '\n... (truncated)';
+        }
+        const result = {
+            mode: 'review',
+            repo,
+            prNumber,
+            title: metadata.title,
+            author: metadata.author?.login || 'unknown',
+            baseBranch: metadata.baseRefName,
+            headBranch: metadata.headRefName,
+            labels: (metadata.labels || []).map((l) => l.name),
+            reviewDecision: metadata.reviewDecision,
+            stats: {
+                additions: metadata.additions,
+                deletions: metadata.deletions,
+                changedFiles: metadata.changedFiles,
+                commits: metadata.commits?.length || 0,
+            },
+            files: (metadata.files || []).map((f) => ({
+                path: f.path,
+                additions: f.additions,
+                deletions: f.deletions,
+            })),
+            body: metadata.body || '',
+            diff,
+            diffTruncated: truncated,
+        };
+        return this.createSuccessResult(JSON.stringify(result, null, 2), {
+            prNumber,
+            repo,
+            title: metadata.title,
+        });
+    }
+    createPR(params) {
+        const { repo, branch } = params;
+        // Return context for orchestrator to set up workspace and assign agents
+        const result = {
+            mode: 'create',
+            repo,
+            branch: branch || null,
+            instructions: 'Use WorkspaceManager to create a worktree, then dispatch implementer and test-writer agents.',
+        };
+        return this.createSuccessResult(JSON.stringify(result, null, 2));
+    }
+    async listPRs(params, signal) {
+        const { repo } = params;
+        const { stdout } = await this.gh([
+            'pr',
+            'list',
+            '--repo',
+            repo,
+            '--json',
+            'number,title,author,labels,reviewDecision,headRefName,createdAt,isDraft',
+            '--limit',
+            '50',
+        ], signal);
+        const prs = JSON.parse(stdout);
+        const result = {
+            mode: 'list',
+            repo,
+            count: prs.length,
+            pullRequests: prs.map((pr) => ({
+                number: pr.number,
+                title: pr.title,
+                author: pr.author?.login || 'unknown',
+                labels: (pr.labels || []).map((l) => l.name),
+                reviewDecision: pr.reviewDecision,
+                branch: pr.headRefName,
+                createdAt: pr.createdAt,
+                isDraft: pr.isDraft,
+            })),
+        };
+        return this.createSuccessResult(JSON.stringify(result, null, 2));
+    }
+    async postReview(params, signal) {
+        const { repo, action, body } = params;
+        const prNumber = this.policy.prNumber(params.prNumber);
+        // Map action to gh flag
+        const actionFlags = {
+            approve: '--approve',
+            'request-changes': '--request-changes',
+            comment: '--comment',
+        };
+        const flag = actionFlags[action];
+        if (!flag) {
+            return this.createErrorResult(`Invalid action: ${action}`);
+        }
+        // No shell escaping needed — body is a discrete argv element via execFile.
+        const args = ['pr', 'review', String(prNumber), '--repo', repo, flag];
+        if (body) {
+            args.push('--body', body);
+        }
+        try {
+            await this.gh(args, signal);
+            const result = {
+                mode: 'post-review',
+                repo,
+                prNumber,
+                action,
+                posted: true,
+            };
+            return this.createSuccessResult(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            return this.createErrorResult(`Failed to post review: ${subprocessError(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=PRAgentTool.js.map

package/dist/implementations/agent/PRAgentTool.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"PRAgentTool.js","sourceRoot":"","sources":["../../../src/implementations/agent/PRAgentTool.ts"],"names":[],"mappings":"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"}

package/dist/implementations/agent/TaskTool.d.ts ADDED Viewed

@@ -0,0 +1,76 @@
+import { BaseTool } from '../../base/BaseTool.js';
+import type { ToolResult } from '../../base/ToolResult.js';
+/**
+ * Parameters for Task tool
+ */
+export interface TaskParams {
+    description: string;
+    prompt: string;
+    subagent_type: string;
+    model?: string;
+    temperature?: number;
+    strategy?: string;
+    resume?: string;
+}
+/**
+ * TaskTool - Launch specialized sub-agents to handle complex tasks
+ *
+ * Loads agent definitions from .cortex/agents/*.md files and returns
+ * the agent's system prompt and configuration for orchestrator to use.
+ *
+ * Agent files use YAML frontmatter:
+ * ---
+ * name: agent-name
+ * description: When to use this agent
+ * tools: Tool1, Tool2, Tool3
+ * model: sonnet | opus | haiku | inherit
+ * ---
+ *
+ * # Agent System Prompt
+ * ...instructions...
+ */
+export declare class TaskToolExecutor extends BaseTool<TaskParams, ToolResult> {
+    private agentsCache;
+    private projectAgentsDir;
+    private personalAgentsDir;
+    private builtinAgentsDir?;
+    constructor(config: {
+        workingDirectory: string;
+    });
+    validateToolParams(params: TaskParams): string | null;
+    getDescription(params: TaskParams): string;
+    execute(params: TaskParams, signal: AbortSignal): Promise<ToolResult>;
+    /**
+     * Load an agent definition by name
+     */
+    private loadAgent;
+    /**
+     * Load all agents from both project and personal directories
+     */
+    private loadAgents;
+    /**
+     * Load agents from a specific directory
+     */
+    private loadAgentsFromDirectory;
+    /**
+     * Parse an agent definition file
+     */
+    private parseAgentFile;
+    /**
+     * Parse YAML frontmatter into key-value pairs
+     */
+    private parseFrontmatter;
+    /**
+     * Format agent output for LLM consumption
+     */
+    private formatAgentOutput;
+    /**
+     * Format a readable listing of all available agents
+     */
+    private formatAgentListing;
+    /**
+     * Clear the agent cache (for testing or when agents are modified)
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=TaskTool.d.ts.map

package/dist/implementations/agent/TaskTool.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"TaskTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/agent/TaskTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAQ3D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IACpE,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAAC,CAAS;gBAEtB,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE;IAkDhD,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAgDrD,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAKpC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAkF3E;;OAEG;YACW,SAAS;IAsCvB;;OAEG;YACW,UAAU;IA+BxB;;OAEG;YACW,uBAAuB;IAgCrC;;OAEG;YACW,cAAc;IA8C5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;OAEG;IACI,UAAU,IAAI,IAAI;CAG1B"}