@telora/daemon 0.12.33

package/dist/spawner-liveness.js

@@ -0,0 +1,99 @@
+/**
+ * Stale agent process detection and liveness checking.
+ *
+ * Detects agents whose processes have disappeared (OOM kill, external kill -9, etc.)
+ * without firing a 'close' event, and cleans up the agent entry and session.
+ */
+import { readFileSync } from 'node:fs';
+import { updateSession } from './supabase.js';
+import { recordSessionCompleted } from './heartbeat.js';
+import { removeWorktree } from './git.js';
+/**
+ * Check if a process is alive. Returns false if the process doesn't exist
+ * or is a zombie on Linux.
+ */
+export function isProcessAlive(pid) {
+    // Check if PID exists
+    try {
+        process.kill(pid, 0);
+    }
+    catch (e) {
+        console.debug(`[spawner] isProcessAlive(${pid}): process not found (ESRCH):`, e.message);
+        return false;
+    }
+    // On Linux, check for zombie state via /proc/{pid}/status
+    if (process.platform === 'linux') {
+        try {
+            const status = readFileSync(`/proc/${pid}/status`, 'utf-8');
+            const stateMatch = status.match(/^State:\s+(\S)/m);
+            if (stateMatch && stateMatch[1] === 'Z') {
+                return false; // Zombie -- won't produce an exit event
+            }
+        }
+        catch (e) {
+            console.debug(`[spawner] isProcessAlive(${pid}): /proc read failed, treating as dead:`, e.message);
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Check all running agents for PID liveness.
+ *
+ * If an agent's process has disappeared (OOM kill, external kill -9, etc.)
+ * without firing a 'close' event, clean up the agent entry and update the
+ * session in the database.
+ *
+ * Guards against double-cleanup by checking runningAgents.has() before acting.
+ */
+export async function checkAgentLiveness(config, runningAgents) {
+    if (runningAgents.size === 0)
+        return;
+    // Snapshot keys to avoid mutating the map while iterating
+    const entries = [...runningAgents.entries()];
+    for (const [sessionId, agent] of entries) {
+        // Guard: agent may have been cleaned up by a normal exit event since we started
+        if (!runningAgents.has(sessionId))
+            continue;
+        if (isProcessAlive(agent.pid))
+            continue;
+        // PID is gone -- stale agent detected
+        const runtime = Math.round((Date.now() - agent.startedAt.getTime()) / 1000);
+        console.error(`[liveness] Stale agent detected: "${agent.deliveryName}" ` +
+            `(session: ${sessionId}, PID: ${agent.pid}, runtime: ${runtime}s). ` +
+            `Process disappeared -- possible OOM or external kill.`);
+        // Clear timeout timers
+        if (agent.warningTimer)
+            clearTimeout(agent.warningTimer);
+        if (agent.timeoutTimer)
+            clearTimeout(agent.timeoutTimer);
+        // Remove from tracking map
+        runningAgents.delete(sessionId);
+        // Update session in database
+        try {
+            await updateSession(sessionId, {
+                status: 'failed',
+                exit_reason: 'Process disappeared -- possible OOM or external kill',
+                ended_at: new Date().toISOString(),
+            });
+        }
+        catch (err) {
+            console.error(`[liveness] Failed to update session ${sessionId}:`, err.message);
+        }
+        // Record session completion for heartbeat counters
+        recordSessionCompleted(0, 0);
+        // Clean up worktree (safety guards in removeWorktree protect uncommitted work)
+        try {
+            removeWorktree(config.repoPath, agent.worktreePath, {
+                branchName: agent.branchName,
+                integrationBranch: config.integrationBranch,
+                deliveryName: agent.deliveryName,
+                mergeSucceeded: false,
+            });
+        }
+        catch (worktreeErr) {
+            console.error(`[liveness] Failed to remove worktree for "${agent.deliveryName}":`, worktreeErr.message);
+        }
+    }
+}
+//# sourceMappingURL=spawner-liveness.js.map

package/dist/spawner-liveness.js.map

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

package/dist/spawner-resolution.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Merge conflict resolution agent spawner.
+ *
+ * Spawns a short-lived, single-purpose Claude Code agent for merge conflict
+ * resolution. Used when no active team exists for a strategy but merge
+ * conflicts need resolution.
+ */
+import type { DaemonConfig } from './types.js';
+/**
+ * Spawn a short-lived, single-purpose Claude Code agent for merge conflict resolution.
+ *
+ * Used when no active team exists for a strategy but merge conflicts need resolution.
+ * The agent receives a focused prompt with conflict details, resolves in the existing
+ * worktree, and exits. No session DB record, no streaming, no team mode.
+ */
+export declare function spawnResolutionAgent(params: {
+    config: DaemonConfig;
+    worktreePath: string;
+    branchName: string;
+    integrationBranch: string;
+    conflictFiles: string[];
+    strategyDescription: string;
+}): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=spawner-resolution.d.ts.map

package/dist/spawner-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawner-resolution.d.ts","sourceRoot":"","sources":["../src/spawner-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO/C;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkFhD"}

package/dist/spawner-resolution.js

@@ -0,0 +1,99 @@
+/**
+ * Merge conflict resolution agent spawner.
+ *
+ * Spawns a short-lived, single-purpose Claude Code agent for merge conflict
+ * resolution. Used when no active team exists for a strategy but merge
+ * conflicts need resolution.
+ */
+import { spawn } from 'node:child_process';
+import { runGitSync } from './git-types.js';
+import { stripClaudeCodeEnvVars } from '@telora/daemon-core';
+/** Timeout for the resolution agent (10 minutes). */
+const RESOLUTION_AGENT_TIMEOUT_MS = 10 * 60 * 1000;
+/**
+ * Spawn a short-lived, single-purpose Claude Code agent for merge conflict resolution.
+ *
+ * Used when no active team exists for a strategy but merge conflicts need resolution.
+ * The agent receives a focused prompt with conflict details, resolves in the existing
+ * worktree, and exits. No session DB record, no streaming, no team mode.
+ */
+export async function spawnResolutionAgent(params) {
+    const { config, worktreePath, branchName, integrationBranch, conflictFiles, strategyDescription } = params;
+    const prompt = [
+        `You are resolving merge conflicts in a git worktree.`,
+        ``,
+        `**Worktree:** ${worktreePath}`,
+        `**Branch:** ${branchName}`,
+        `**Merge source:** origin/${integrationBranch}`,
+        ``,
+        `**Conflicted files:**`,
+        ...conflictFiles.map(f => `- ${f}`),
+        ``,
+        `**Strategy context:** ${strategyDescription}`,
+        ``,
+        `**Instructions:**`,
+        `1. Open each conflicted file and resolve the conflict markers (<<<<<<< / ======= / >>>>>>>)`,
+        `2. Stage each resolved file with: git add <file>`,
+        `3. Commit the merge resolution: git commit --no-edit`,
+        `4. Run: npm run build && npm test`,
+        `5. If build or test fails, fix the issues, commit, and re-run until passing`,
+        ``,
+        `Do NOT run git merge --abort. Your goal is to produce a clean merge commit that passes build and tests.`,
+        `Follow the coding standards in CLAUDE.md.`,
+    ].join('\n');
+    const args = [
+        '--print',
+        '--dangerously-skip-permissions',
+        '--setting-sources', 'project,local',
+        prompt,
+    ];
+    // Build a clean environment (strip Claude Code session vars)
+    const spawnEnv = stripClaudeCodeEnvVars(process.env);
+    console.log(`[spawner] Spawning resolution agent for branch ${branchName} (${conflictFiles.length} conflicts)`);
+    return new Promise((resolve) => {
+        const proc = spawn(config.claudeCodePath, args, {
+            cwd: worktreePath,
+            env: spawnEnv,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // Close stdin immediately -- prompt is passed as CLI arg
+        proc.stdin?.end();
+        // Timeout with escalating shutdown
+        const timeout = setTimeout(() => {
+            console.warn(`[spawner] Resolution agent timed out after ${RESOLUTION_AGENT_TIMEOUT_MS / 1000}s, killing`);
+            try {
+                process.kill(proc.pid, 'SIGTERM');
+            }
+            catch { /* ignore */ }
+            setTimeout(() => {
+                try {
+                    process.kill(proc.pid, 'SIGKILL');
+                }
+                catch { /* ignore */ }
+            }, 10000);
+        }, RESOLUTION_AGENT_TIMEOUT_MS);
+        proc.on('close', (code) => {
+            clearTimeout(timeout);
+            // Verify resolution by checking for remaining unmerged files
+            const unmergedResult = runGitSync(['diff', '--name-only', '--diff-filter=U'], worktreePath);
+            const unmergedFiles = unmergedResult.success
+                ? unmergedResult.output.split('\n').filter(Boolean)
+                : [];
+            if (unmergedFiles.length === 0) {
+                console.log(`[spawner] Resolution agent succeeded for branch ${branchName} (exit code: ${code})`);
+                resolve({ success: true });
+            }
+            else {
+                const msg = `Conflicts remain in: ${unmergedFiles.join(', ')}`;
+                console.warn(`[spawner] Resolution agent failed for branch ${branchName}: ${msg}`);
+                resolve({ success: false, error: msg });
+            }
+        });
+        proc.on('error', (err) => {
+            clearTimeout(timeout);
+            console.error(`[spawner] Resolution agent spawn error: ${err.message}`);
+            resolve({ success: false, error: `Spawn error: ${err.message}` });
+        });
+    });
+}
+//# sourceMappingURL=spawner-resolution.js.map

package/dist/spawner-resolution.js.map

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

package/dist/spawner-timeout.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Timeout enforcement and graceful shutdown for agent sessions.
+ *
+ * Handles per-agent timeout warnings, escalating shutdown sequences
+ * (stdin close -> SIGTERM -> SIGKILL), and graceful completion shutdown.
+ */
+import type { Writable } from 'node:stream';
+import type { DaemonConfig, RunningAgent } from './types.js';
+/**
+ * Safely send a signal to a process, ignoring errors if the process has already exited.
+ */
+export declare function safeSendSignal(pid: number, signal: NodeJS.Signals): void;
+/**
+ * Safely close a writable stdin stream, ignoring errors if already closed.
+ */
+export declare function safeCloseStdin(stdin: Writable): void;
+/**
+ * Set up per-agent timeout enforcement with warning at 80% and escalating shutdown.
+ *
+ * Returns a `timedOut` accessor function (closure over mutable state).
+ */
+export declare function setupTimeoutEnforcement(config: DaemonConfig, runningAgent: RunningAgent, deliveryName: string, sessionId: string, runningAgents: Map<string, RunningAgent>): {
+    getTimedOut: () => boolean;
+};
+/**
+ * Initiate graceful shutdown for an agent session.
+ *
+ * Sends a wrap-up message via stdin, waits for the process to exit,
+ * and escalates to SIGTERM/SIGKILL if needed.
+ */
+export declare function initiateGracefulShutdown(agent: RunningAgent, deliveryName: string, runningAgents: Map<string, RunningAgent>): void;
+//# sourceMappingURL=spawner-timeout.d.ts.map

package/dist/spawner-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawner-timeout.d.ts","sourceRoot":"","sources":["../src/spawner-timeout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG7D;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAMxE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAMpD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACvC;IAAE,WAAW,EAAE,MAAM,OAAO,CAAA;CAAE,CAuChC;AA8BD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACvC,IAAI,CAuCN"}

package/dist/spawner-timeout.js

@@ -0,0 +1,124 @@
+/**
+ * Timeout enforcement and graceful shutdown for agent sessions.
+ *
+ * Handles per-agent timeout warnings, escalating shutdown sequences
+ * (stdin close -> SIGTERM -> SIGKILL), and graceful completion shutdown.
+ */
+import { sendMessage } from '@telora/daemon-core';
+/**
+ * Safely send a signal to a process, ignoring errors if the process has already exited.
+ */
+export function safeSendSignal(pid, signal) {
+    try {
+        process.kill(pid, signal);
+    }
+    catch (e) {
+        console.debug(`[spawner] safeSendSignal(${pid}, ${signal}) failed (process may have exited):`, e.message);
+    }
+}
+/**
+ * Safely close a writable stdin stream, ignoring errors if already closed.
+ */
+export function safeCloseStdin(stdin) {
+    try {
+        stdin.end();
+    }
+    catch (e) {
+        console.debug('[spawner] safeCloseStdin failed (stdin may already be closed):', e.message);
+    }
+}
+/**
+ * Set up per-agent timeout enforcement with warning at 80% and escalating shutdown.
+ *
+ * Returns a `timedOut` accessor function (closure over mutable state).
+ */
+export function setupTimeoutEnforcement(config, runningAgent, deliveryName, sessionId, runningAgents) {
+    let timedOut = false;
+    const timeoutMs = config.sessionTimeoutMs;
+    if (timeoutMs <= 0) {
+        return { getTimedOut: () => timedOut };
+    }
+    // Warning at 80% of timeout -- send warning via stdin
+    const warningMs = Math.floor(timeoutMs * 0.8);
+    runningAgent.warningTimer = setTimeout(() => {
+        const remaining = Math.ceil((timeoutMs - warningMs) / 60000);
+        console.warn(`[timeout] Agent for "${deliveryName}" at 80% of timeout limit. ` +
+            `Sending warning via stdin. ~${remaining} min remaining.`);
+        sendMessage(runningAgent.stdin, `WARNING: You have approximately ${remaining} minutes remaining before the session ` +
+            `is terminated. Please wrap up your current work, commit changes, and prepare to exit.`);
+    }, warningMs);
+    // Hard timeout -- escalating shutdown: message -> close stdin -> SIGTERM -> SIGKILL
+    runningAgent.timeoutTimer = setTimeout(() => {
+        timedOut = true;
+        console.error(`[timeout] Agent for "${deliveryName}" exceeded ${timeoutMs / 60000} min timeout. ` +
+            `Sending shutdown message...`);
+        runningAgent.streamState = 'shutting_down';
+        sendMessage(runningAgent.stdin, `TIMEOUT: Session time limit reached. Stop all work immediately, commit any changes, and exit now.`);
+        scheduleTimeoutEscalation(runningAgent, deliveryName, sessionId, runningAgents);
+    }, timeoutMs);
+    return { getTimedOut: () => timedOut };
+}
+/**
+ * Schedule escalating shutdown steps after the initial timeout message:
+ * stdin close -> SIGTERM -> SIGKILL
+ */
+function scheduleTimeoutEscalation(agent, deliveryName, sessionId, runningAgents) {
+    // Close stdin after a short grace period to signal EOF
+    setTimeout(() => safeCloseStdin(agent.stdin), 10000);
+    // SIGTERM after stdin close grace period
+    setTimeout(() => {
+        if (!runningAgents.has(sessionId))
+            return;
+        console.error(`[timeout] Agent for "${deliveryName}" did not exit after stdin close. Sending SIGTERM...`);
+        safeSendSignal(agent.pid, 'SIGTERM');
+    }, 20000);
+    // SIGKILL as absolute last resort
+    setTimeout(() => {
+        if (!runningAgents.has(sessionId))
+            return;
+        console.error(`[timeout] Agent for "${deliveryName}" still running. Sending SIGKILL...`);
+        safeSendSignal(agent.pid, 'SIGKILL');
+    }, 30000);
+}
+/**
+ * Initiate graceful shutdown for an agent session.
+ *
+ * Sends a wrap-up message via stdin, waits for the process to exit,
+ * and escalates to SIGTERM/SIGKILL if needed.
+ */
+export function initiateGracefulShutdown(agent, deliveryName, runningAgents) {
+    const GRACE_PERIOD_MS = 60000; // 60s for agent to wrap up
+    const ESCALATION_STEP_MS = 10000; // 10s between escalation steps
+    // Send wrap-up message
+    sendMessage(agent.stdin, 'All work is complete. Please commit any remaining changes, clean up, and exit.');
+    // Flat escalation chain using absolute offsets from now
+    // Step 1: Close stdin after grace period
+    const graceTimer = setTimeout(() => {
+        if (!runningAgents.has(agent.sessionId))
+            return;
+        console.warn(`[shutdown] Agent for "${deliveryName}" did not exit within grace period. Closing stdin...`);
+        safeCloseStdin(agent.stdin);
+    }, GRACE_PERIOD_MS);
+    // Step 2: SIGTERM after grace period + one escalation step
+    setTimeout(() => {
+        if (!runningAgents.has(agent.sessionId))
+            return;
+        console.warn(`[shutdown] Agent for "${deliveryName}" did not exit after stdin close. Sending SIGTERM...`);
+        safeSendSignal(agent.pid, 'SIGTERM');
+    }, GRACE_PERIOD_MS + ESCALATION_STEP_MS);
+    // Step 3: SIGKILL after grace period + two escalation steps
+    setTimeout(() => {
+        if (!runningAgents.has(agent.sessionId))
+            return;
+        console.error(`[shutdown] Agent for "${deliveryName}" still running. Sending SIGKILL...`);
+        safeSendSignal(agent.pid, 'SIGKILL');
+    }, GRACE_PERIOD_MS + ESCALATION_STEP_MS * 2);
+    // Clean up timer if process exits before grace period
+    const checkExit = setInterval(() => {
+        if (!runningAgents.has(agent.sessionId)) {
+            clearTimeout(graceTimer);
+            clearInterval(checkExit);
+        }
+    }, 1000);
+}
+//# sourceMappingURL=spawner-timeout.js.map

package/dist/spawner-timeout.js.map

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

package/dist/spawner.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Claude Code spawner - manages spawning and tracking agent processes.
+ *
+ * Spawns agents at delivery level with full context including:
+ * - Product info (name, vision, description)
+ * - Delivery details (name, description, acceptance criteria, tech context)
+ * - All context groups and tasks within the delivery
+ *
+ * Each agent runs in an isolated git worktree created from the integration branch.
+ * On successful completion, the agent's branch is merged into integration.
+ */
+import type { DaemonConfig, AgentRole, RunningAgent } from './types.js';
+import { type ResourceGovernor } from '@telora/daemon-core';
+/** Inject the resource governor for global concurrency limiting. */
+export declare function initGovernor(gov: ResourceGovernor): void;
+/**
+ * Get map of running agents.
+ */
+export declare function getRunningAgents(): Map<string, RunningAgent>;
+/**
+ * Spawn a Claude Code agent to work on a delivery.
+ *
+ * The agent runs in an isolated git worktree created from the integration branch.
+ * On successful completion, the agent's changes are merged back to integration.
+ */
+export declare function spawnAgentForDelivery(config: DaemonConfig, deliveryId: string, role: AgentRole, strategyId: string): Promise<void>;
+/**
+ * Terminate a running agent.
+ * Sends a shutdown message via stdin, then escalates to SIGTERM/SIGKILL.
+ */
+export declare function terminateAgent(sessionId: string): boolean;
+/**
+ * Terminate all running agents.
+ */
+export declare function terminateAllAgents(): void;
+/**
+ * Check if an agent is running for a session.
+ */
+export declare function isAgentRunning(sessionId: string): boolean;
+/**
+ * Get count of running agents.
+ */
+export declare function getRunningAgentCount(): number;
+/**
+ * Spawn a short-lived, single-purpose Claude Code agent for merge conflict resolution.
+ *
+ * Used when no active team exists for a strategy but merge conflicts need resolution.
+ * The agent receives a focused prompt with conflict details, resolves in the existing
+ * worktree, and exits. No session DB record, no streaming, no team mode.
+ */
+export declare function spawnResolutionAgent(params: {
+    config: DaemonConfig;
+    worktreePath: string;
+    branchName: string;
+    integrationBranch: string;
+    conflictFiles: string[];
+    strategyDescription: string;
+}): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Check if a process is alive. Returns false if the process doesn't exist
+ * or is a zombie on Linux.
+ */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * Check all running agents for PID liveness.
+ *
+ * If an agent's process has disappeared (OOM kill, external kill -9, etc.)
+ * without firing a 'close' event, clean up the agent entry and update the
+ * session in the database.
+ *
+ * Guards against double-cleanup by checking runningAgents.has() before acting.
+ */
+export declare function checkAgentLiveness(config: DaemonConfig): Promise<void>;
+//# sourceMappingURL=spawner.d.ts.map

package/dist/spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawner.d.ts","sourceRoot":"","sources":["../src/spawner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAmB,YAAY,EAAY,MAAM,YAAY,CAAC;AAQnG,OAAO,EAA+F,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAczJ,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAE5D;AAsJD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA8Mf;AAmND;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CA2BzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAOD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkFhD;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAwBnD;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqD5E"}