@abdasis/agentdeck 2.44.2

package/agent/dist/terminal.js

@@ -0,0 +1,175 @@
+import * as pty from '@homebridge/node-pty-prebuilt-multiarch';
+import { exec, execSync } from 'child_process';
+import { promisify } from 'util';
+import { generateInitScript, writeInitScript, cleanupInitScript, detectUserShell, } from './lib/init-script.js';
+import * as path from 'path';
+const execAsync = promisify(exec);
+export function createTerminal(cwd, sessionName, options = {}) {
+    // Support both old signature (customEnvVars object) and new options object
+    const customEnvVars = 'customEnvVars' in options
+        ? (options.customEnvVars ?? {})
+        : options;
+    // Check if session already exists before spawning
+    let existingSession = false;
+    try {
+        execSync(`tmux has-session -t "${sessionName}" 2>/dev/null`);
+        existingSession = true;
+        console.log(`[Terminal] Session '${sessionName}' exists, will attach`);
+    }
+    catch {
+        existingSession = false;
+        console.log(`[Terminal] Session '${sessionName}' does not exist, will create`);
+    }
+    if (Object.keys(customEnvVars).length > 0) {
+        console.log(`[Terminal] Custom env vars for injection: ${Object.keys(customEnvVars).join(', ')}`);
+    }
+    // Use tmux for session persistence
+    // For existing sessions: use attach-session (more reliable)
+    // For new sessions: use new-session with init script for clean setup
+    let tmuxArgs;
+    let initScriptPath = null;
+    // Detect test/CI environment for animation skipping
+    const isTestEnv = !!(process.env.VITEST || process.env.CI || process.env.JEST_WORKER_ID);
+    if (existingSession) {
+        tmuxArgs = ['attach-session', '-t', sessionName];
+    }
+    else {
+        // Extract project name from cwd (last directory component)
+        const projectName = path.basename(cwd) || 'unknown';
+        // Detect user's preferred shell for the interactive session
+        const userShell = detectUserShell();
+        // Generate and write init script for new sessions
+        // The init script is always sourced by bash (via --init-file)
+        // So we generate it for bash, and it ends with `exec ${userShell} -i`
+        // to switch to the user's preferred interactive shell
+        const scriptContent = generateInitScript({
+            sessionName,
+            projectName,
+            customEnvVars,
+            shell: 'bash', // Always bash since bash sources the init-file
+            targetShell: userShell, // User's preferred shell for interactive session
+        });
+        initScriptPath = writeInitScript(sessionName, scriptContent);
+        console.log(`[Terminal] Init script written to: ${initScriptPath} (target shell: ${userShell})`);
+        // Spawn tmux with bash running the init script
+        // The script sets up env vars, tmux config, then runs `exec ${userShell} -i`
+        // Use -e to pass environment variable for animation skipping in tests
+        tmuxArgs = [
+            'new-session',
+            '-s',
+            sessionName,
+            '-c',
+            cwd,
+            ...(isTestEnv ? ['-e', '_agentdeck_SKIP_ANIMATION=1'] : []),
+            `bash --init-file ${initScriptPath}`,
+        ];
+    }
+    console.log(`[Terminal] Spawning: tmux ${tmuxArgs.join(' ')}`);
+    const shell = pty.spawn('tmux', tmuxArgs, {
+        name: 'xterm-256color',
+        cols: 120,
+        rows: 30,
+        cwd,
+        env: {
+            ...process.env,
+            TERM: 'xterm-256color',
+            AGENTDECK_SESSION: sessionName, // Shared session id for hooks
+            CLAUDE_TMUX_SESSION: sessionName, // Also set at PTY level for hook detection
+            CODEX_TMUX_SESSION: sessionName,
+            PATH: `/opt/homebrew/bin:${process.env.PATH}`,
+            // Ensure UTF-8 encoding for proper accent/unicode support
+            LANG: process.env.LANG || 'en_US.UTF-8',
+            LC_ALL: process.env.LC_ALL || 'en_US.UTF-8',
+            // Suppress macOS bash deprecation warning
+            BASH_SILENCE_DEPRECATION_WARNING: '1',
+            // Pass CI/test detection to init script for animation skipping
+            ...(isTestEnv ? { _agentdeck_SKIP_ANIMATION: '1' } : {}),
+        },
+    });
+    // Debug: log any immediate output or errors
+    let initialOutput = '';
+    const debugHandler = (data) => {
+        initialOutput += data;
+        if (initialOutput.length < 500) {
+            console.log(`[Terminal] Initial output: ${data.substring(0, 100)}`);
+        }
+    };
+    shell.onData(debugHandler);
+    // Remove debug handler after 2 seconds to prevent memory leak
+    setTimeout(() => {
+        shell.removeListener('data', debugHandler);
+    }, 2000);
+    // Debug: log when shell exits
+    shell.onExit(({ exitCode, signal }) => {
+        console.log(`[Terminal] Shell exited: code=${exitCode}, signal=${signal}, session='${sessionName}'`);
+    });
+    // Track terminal readiness state for onReady callback
+    // Existing sessions are ready immediately
+    let isReady = existingSession;
+    const readyCallbacks = [];
+    const fireReadyCallbacks = () => {
+        console.log(`[Terminal] fireReadyCallbacks: firing ${readyCallbacks.length} callbacks for '${sessionName}'`);
+        isReady = true;
+        readyCallbacks.forEach((cb) => cb());
+        readyCallbacks.length = 0; // Clear the array
+    };
+    // Handle session initialization and readiness
+    if (!existingSession) {
+        // For new sessions, the init script handles env vars and tmux config
+        // Fire ready callbacks once shell is likely initialized
+        setTimeout(() => {
+            console.log(`[Terminal] New session '${sessionName}' ready (init script executed)`);
+            fireReadyCallbacks();
+        }, 150);
+        // Cleanup init script after shell has started (give it time to read the file)
+        if (initScriptPath) {
+            setTimeout(() => {
+                cleanupInitScript(sessionName);
+                console.log(`[Terminal] Init script cleaned up for '${sessionName}'`);
+            }, 5000);
+        }
+    }
+    else {
+        // For existing sessions, just ensure mouse is enabled
+        // isReady is already true for existing sessions (set above)
+        setTimeout(() => {
+            exec(`tmux set-option -t "${sessionName}" mouse on`);
+        }, 100);
+    }
+    return {
+        write: (data) => shell.write(data),
+        resize: (cols, rows) => shell.resize(cols, rows),
+        onData: (callback) => shell.onData(callback),
+        onExit: (callback) => shell.onExit(callback),
+        kill: () => shell.kill(),
+        detach: () => {
+            // Send tmux detach command (Ctrl+B, d)
+            shell.write('\x02d');
+        },
+        isExistingSession: () => existingSession,
+        onReady: (callback) => {
+            if (isReady) {
+                console.log(`[Terminal] onReady: already ready, calling callback immediately for '${sessionName}'`);
+                callback();
+            }
+            else {
+                console.log(`[Terminal] onReady: not ready yet, queuing callback for '${sessionName}'`);
+                readyCallbacks.push(callback);
+            }
+        },
+        captureHistory: async (lines = 10000) => {
+            try {
+                // Capture scrollback buffer from tmux
+                // -p = print to stdout
+                // -S -N = start from N lines back (negative = from start of history)
+                // -J = preserve trailing spaces for proper formatting
+                const { stdout } = await execAsync(`tmux capture-pane -t "${sessionName}" -p -S -${lines} -J 2>/dev/null`);
+                return stdout;
+            }
+            catch {
+                return '';
+            }
+        },
+    };
+}
+//# sourceMappingURL=terminal.js.map

package/agent/dist/terminal.js.map

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

package/agent/dist/updater.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Auto-update module for the AgentDeck agent.
+ * Handles version detection and automatic updates when the web dashboard
+ * reports a newer version.
+ */
+/**
+ * Check if an update is currently in progress.
+ */
+export declare function isUpdateInProgress(): boolean;
+/**
+ * Trigger an auto-update to the specified version.
+ * Creates a detached shell script that:
+ * 1. Waits for the agent to exit
+ * 2. Runs npm install -g
+ * 3. Restarts the agent via service manager
+ */
+export declare function triggerUpdate(targetVersion: string): void;
+//# sourceMappingURL=updater.d.ts.map

package/agent/dist/updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../src/updater.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAqGzD"}

package/agent/dist/updater.js

@@ -0,0 +1,122 @@
+/**
+ * Auto-update module for the AgentDeck agent.
+ * Handles version detection and automatic updates when the web dashboard
+ * reports a newer version.
+ */
+import { spawn } from 'child_process';
+import { writeFileSync } from 'fs';
+import { platform } from 'os';
+import { logger } from './logger.js';
+import { broadcastUpdatePending } from './websocket-handlers.js';
+const UPDATE_SCRIPT = '/tmp/agentdeck-update.sh';
+const PACKAGE_NAME = '@agentdeck/cli';
+let updateInProgress = false;
+/**
+ * Check if an update is currently in progress.
+ */
+export function isUpdateInProgress() {
+    return updateInProgress;
+}
+/**
+ * Trigger an auto-update to the specified version.
+ * Creates a detached shell script that:
+ * 1. Waits for the agent to exit
+ * 2. Runs npm install -g
+ * 3. Restarts the agent via service manager
+ */
+export function triggerUpdate(targetVersion) {
+    if (updateInProgress) {
+        logger.main.warn('Update already in progress, ignoring');
+        return;
+    }
+    updateInProgress = true;
+    logger.main.info({ targetVersion }, 'Auto-update triggered');
+    // Broadcast to all connected clients
+    broadcastUpdatePending(targetVersion, `Agent updating to version ${targetVersion}...`);
+    // Determine restart command based on platform
+    const os = platform();
+    let restartCommand;
+    if (os === 'darwin') {
+        // macOS: try launchctl kickstart first, fallback to manual start
+        restartCommand = 'launchctl kickstart -k gui/$(id -u)/com.agentdeck.agent 2>/dev/null || agentdeck start';
+    }
+    else if (os === 'linux') {
+        // Linux: try systemctl first, fallback to manual start
+        restartCommand = 'systemctl --user restart agentdeck-agent 2>/dev/null || agentdeck start';
+    }
+    else {
+        logger.main.error({ os }, 'Unsupported platform for auto-update');
+        updateInProgress = false;
+        return;
+    }
+    // Create update script
+    const script = `#!/bin/bash
+# AgentDeck Auto-Update Script
+# Target version: ${targetVersion}
+
+# Change to /tmp to avoid blocking the agent directory during npm install
+cd /tmp
+
+# Wait for agent to fully exit
+sleep 2
+
+# Load nvm if available (required for Linux VMs using nvm)
+export NVM_DIR="${'$'}{NVM_DIR:-${'$'}HOME/.nvm}"
+if [ -s "${'$'}NVM_DIR/nvm.sh" ]; then
+  source "${'$'}NVM_DIR/nvm.sh"
+  echo "[agentdeck] Loaded nvm from ${'$'}NVM_DIR"
+fi
+
+echo "[agentdeck] Installing version ${targetVersion}..."
+npm install -g ${PACKAGE_NAME}@${targetVersion}
+
+if [ $? -ne 0 ]; then
+  echo "[agentdeck] npm install failed, attempting restart anyway..."
+fi
+
+# Fix executable permissions (npm doesn't always preserve them)
+CLI_BIN="$(npm root -g)/${PACKAGE_NAME}/dist/index.js"
+if [ -f "$CLI_BIN" ]; then
+  chmod +x "$CLI_BIN"
+  echo "[agentdeck] Fixed executable permissions"
+fi
+
+echo "[agentdeck] Restarting agent..."
+${restartCommand}
+
+echo "[agentdeck] Auto-update complete"
+rm -f "${UPDATE_SCRIPT}"
+`;
+    try {
+        writeFileSync(UPDATE_SCRIPT, script, { mode: 0o755 });
+        logger.main.info({ path: UPDATE_SCRIPT }, 'Update script created');
+    }
+    catch (err) {
+        logger.main.error({ err }, 'Failed to write update script');
+        updateInProgress = false;
+        return;
+    }
+    // Build PATH with common locations for npm
+    const nvmPath = process.env.NVM_BIN || '';
+    const basePath = '/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin';
+    const extraPath = process.env.PATH || '';
+    // Spawn detached updater process
+    const updater = spawn('bash', [UPDATE_SCRIPT], {
+        detached: true,
+        stdio: 'ignore',
+        env: {
+            ...process.env,
+            // Ensure npm and agentdeck are in PATH (nvm paths + homebrew + standard)
+            PATH: `${nvmPath}:${basePath}:${extraPath}`,
+            NVM_DIR: process.env.NVM_DIR || `${process.env.HOME}/.nvm`,
+        },
+    });
+    updater.unref();
+    logger.main.info({ pid: updater.pid }, 'Update script spawned');
+    // Exit after short delay to give script time to start
+    setTimeout(() => {
+        logger.main.info('Agent exiting for update...');
+        process.exit(0);
+    }, 1000);
+}
+//# sourceMappingURL=updater.js.map

package/agent/dist/updater.js.map

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

package/agent/dist/version.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Version management module for auto-update functionality.
+ * Reads agent version and provides semver comparison utilities.
+ */
+/**
+ * Get the current agent version from package.json.
+ * Tries multiple paths to support both dev and production (bundled in CLI).
+ */
+export declare function getAgentVersion(): string;
+/**
+ * Compare two semver versions.
+ * @returns positive if a > b, negative if a < b, 0 if equal
+ */
+export declare function compareSemver(a: string, b: string): number;
+/**
+ * Check if the agent needs to update to match the web version.
+ * Only returns true if web version is strictly greater (never downgrade).
+ */
+export declare function needsUpdate(agentVersion: string, webVersion: string): boolean;
+//# sourceMappingURL=version.d.ts.map

package/agent/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAyBxC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE7E"}

package/agent/dist/version.js

@@ -0,0 +1,66 @@
+/**
+ * Version management module for auto-update functionality.
+ * Reads agent version and provides semver comparison utilities.
+ */
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let cachedVersion = null;
+/**
+ * Get the current agent version from package.json.
+ * Tries multiple paths to support both dev and production (bundled in CLI).
+ */
+export function getAgentVersion() {
+    if (cachedVersion)
+        return cachedVersion;
+    // Paths to try in order:
+    // 1. Dev mode: apps/agent/package.json (src -> apps/agent)
+    // 2. Prod mode: CLI's package.json (agent/dist -> agent -> cli)
+    const paths = [
+        join(__dirname, '..', 'package.json'), // dev: src/version.ts -> apps/agent/
+        join(__dirname, '..', '..', 'package.json'), // prod: agent/dist/version.js -> agent -> cli/
+    ];
+    for (const p of paths) {
+        try {
+            const pkg = JSON.parse(readFileSync(p, 'utf-8'));
+            if (pkg.version) {
+                cachedVersion = pkg.version;
+                return cachedVersion;
+            }
+        }
+        catch {
+            // Try next path
+        }
+    }
+    cachedVersion = '0.0.0';
+    return cachedVersion;
+}
+/**
+ * Compare two semver versions.
+ * @returns positive if a > b, negative if a < b, 0 if equal
+ */
+export function compareSemver(a, b) {
+    // Remove 'v' prefix if present
+    const cleanA = a.replace(/^v/, '');
+    const cleanB = b.replace(/^v/, '');
+    const partsA = cleanA.split('.').map((n) => parseInt(n, 10) || 0);
+    const partsB = cleanB.split('.').map((n) => parseInt(n, 10) || 0);
+    // Compare major, minor, patch
+    for (let i = 0; i < 3; i++) {
+        const va = partsA[i] || 0;
+        const vb = partsB[i] || 0;
+        if (va !== vb) {
+            return va - vb;
+        }
+    }
+    return 0;
+}
+/**
+ * Check if the agent needs to update to match the web version.
+ * Only returns true if web version is strictly greater (never downgrade).
+ */
+export function needsUpdate(agentVersion, webVersion) {
+    return compareSemver(webVersion, agentVersion) > 0;
+}
+//# sourceMappingURL=version.js.map

package/agent/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,IAAI,aAAa,GAAkB,IAAI,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,yBAAyB;IACzB,2DAA2D;IAC3D,gEAAgE;IAChE,MAAM,KAAK,GAAG;QACZ,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,qCAAqC;QAC5E,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,+CAA+C;KAC7F,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YACjD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChB,aAAa,GAAG,GAAG,CAAC,OAAiB,CAAC;gBACtC,OAAO,aAAa,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC;IAED,aAAa,GAAG,OAAO,CAAC;IACxB,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,+BAA+B;IAC/B,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAEnC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAElE,8BAA8B;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,GAAG,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,YAAoB,EAAE,UAAkB;IAClE,OAAO,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;AACrD,CAAC"}

package/agent/dist/websocket-handlers.d.ts

@@ -0,0 +1,38 @@
+/**
+ * WebSocket handlers for terminal connections and sessions subscriptions.
+ * Simplified version without status tracking, worktree or execution manager features.
+ */
+import { WebSocket } from 'ws';
+import type { WSSessionInfo } from '@agentdeck/shared';
+/**
+ * Broadcast session removed event to all subscribers
+ */
+export declare function broadcastSessionRemoved(sessionName: string): void;
+/**
+ * Broadcast session archived event to all subscribers
+ */
+export declare function broadcastSessionArchived(sessionName: string, session: WSSessionInfo): void;
+/**
+ * Broadcast session status update to all subscribers
+ * Called when a hook notifies the agent of a status change
+ */
+export declare function broadcastStatusUpdate(session: WSSessionInfo): void;
+/**
+ * Broadcast the full current sessions list to all /sessions subscribers.
+ * Called after a session is created so the sidebar updates without a reload
+ * (the WS /sessions stream is the source of truth, not the 30s HTTP poll).
+ */
+export declare function broadcastSessionsList(): Promise<void>;
+/**
+ * Handle terminal WebSocket connections
+ */
+export declare function handleTerminalConnection(ws: WebSocket, url: URL): void;
+/**
+ * Broadcast update-pending message to all sessions subscribers
+ */
+export declare function broadcastUpdatePending(targetVersion: string, message: string): void;
+/**
+ * Handle sessions WebSocket connections (real-time session list updates)
+ */
+export declare function handleSessionsConnection(ws: WebSocket, url?: URL): void;
+//# sourceMappingURL=websocket-handlers.d.ts.map

package/agent/dist/websocket-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-handlers.d.ts","sourceRoot":"","sources":["../src/websocket-handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAK/B,OAAO,KAAK,EAAoB,aAAa,EAA8B,MAAM,mBAAmB,CAAC;AA4BrG;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAYjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAa1F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAgBlE;AAuCD;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgB3D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,CAyKtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAanF;AAyCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CA4DvE"}