@intrect/openswarm 0.2.0

package/dist/agents/agentBus.js

@@ -0,0 +1,350 @@
+// ============================================
+// OpenSwarm - Agent Message Bus
+// Inter-agent context sharing system
+// ============================================
+import { resolve } from 'path';
+import { homedir } from 'os';
+import * as fs from 'fs/promises';
+import { existsSync } from 'fs';
+// Bus Implementation (File-based)
+const BUS_DIR = resolve(homedir(), '.openswarm/bus');
+/**
+ * Message bus class
+ */
+export class AgentBus {
+    executionId;
+    contextPath;
+    messagesPath;
+    listeners = new Map();
+    pollInterval = null;
+    lastMessageId = '';
+    constructor(executionId) {
+        this.executionId = executionId;
+        this.contextPath = resolve(BUS_DIR, executionId, 'context.json');
+        this.messagesPath = resolve(BUS_DIR, executionId, 'messages');
+    }
+    /**
+     * Initialize bus
+     */
+    async init(workflowId) {
+        await fs.mkdir(resolve(BUS_DIR, this.executionId, 'messages'), { recursive: true });
+        // Create initial context
+        const context = {
+            executionId: this.executionId,
+            workflowId,
+            startedAt: Date.now(),
+            stepOutputs: {},
+            changedFiles: [],
+            errors: [],
+            data: {},
+        };
+        await this.saveContext(context);
+        console.log(`[AgentBus] Initialized for execution: ${this.executionId}`);
+    }
+    /**
+     * Publish message
+     */
+    async publish(type, sender, payload, recipient) {
+        const message = {
+            id: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            timestamp: Date.now(),
+            type,
+            sender,
+            recipient,
+            executionId: this.executionId,
+            payload,
+        };
+        // Save message
+        const messagePath = resolve(this.messagesPath, `${message.id}.json`);
+        await fs.writeFile(messagePath, JSON.stringify(message, null, 2));
+        // Handle special message types
+        if (type === 'step_completed') {
+            await this.handleStepCompleted(payload);
+        }
+        else if (type === 'context_update') {
+            await this.handleContextUpdate(payload);
+        }
+        else if (type === 'file_changed') {
+            await this.handleFileChanged(payload);
+        }
+        else if (type === 'error') {
+            await this.handleError(sender, payload);
+        }
+        console.log(`[AgentBus] Published ${type} from ${sender}`);
+        return message.id;
+    }
+    /**
+     * Handle step completion
+     */
+    async handleStepCompleted(payload) {
+        const context = await this.getContext();
+        if (!context)
+            return;
+        context.stepOutputs[payload.stepId] = payload.output;
+        if (payload.changedFiles) {
+            for (const file of payload.changedFiles) {
+                if (!context.changedFiles.includes(file)) {
+                    context.changedFiles.push(file);
+                }
+            }
+        }
+        await this.saveContext(context);
+    }
+    /**
+     * Handle context update
+     */
+    async handleContextUpdate(payload) {
+        const context = await this.getContext();
+        if (!context)
+            return;
+        switch (payload.operation) {
+            case 'set':
+                context.data[payload.key] = payload.value;
+                break;
+            case 'append':
+                if (!Array.isArray(context.data[payload.key])) {
+                    context.data[payload.key] = [];
+                }
+                context.data[payload.key].push(payload.value);
+                break;
+            case 'delete':
+                delete context.data[payload.key];
+                break;
+        }
+        await this.saveContext(context);
+    }
+    /**
+     * Handle file change
+     */
+    async handleFileChanged(payload) {
+        const context = await this.getContext();
+        if (!context)
+            return;
+        if (!context.changedFiles.includes(payload.path)) {
+            context.changedFiles.push(payload.path);
+        }
+        await this.saveContext(context);
+    }
+    /**
+     * Handle error
+     */
+    async handleError(stepId, message) {
+        const context = await this.getContext();
+        if (!context)
+            return;
+        context.errors.push({
+            stepId,
+            message,
+            timestamp: Date.now(),
+        });
+        await this.saveContext(context);
+    }
+    /**
+     * Get context
+     */
+    async getContext() {
+        try {
+            const content = await fs.readFile(this.contextPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Save context
+     */
+    async saveContext(context) {
+        await fs.writeFile(this.contextPath, JSON.stringify(context, null, 2));
+    }
+    /**
+     * Get output from specific step
+     */
+    async getStepOutput(stepId) {
+        const context = await this.getContext();
+        return context?.stepOutputs[stepId] ?? null;
+    }
+    /**
+     * Get all changed files
+     */
+    async getChangedFiles() {
+        const context = await this.getContext();
+        return context?.changedFiles ?? [];
+    }
+    /**
+     * Get custom data
+     */
+    async getData(key) {
+        const context = await this.getContext();
+        return context?.data[key] ?? null;
+    }
+    /**
+     * Set custom data
+     */
+    async setData(key, value) {
+        await this.publish('context_update', 'system', {
+            key,
+            value,
+            operation: 'set',
+        });
+    }
+    /**
+     * Register message listener
+     */
+    on(type, callback) {
+        if (!this.listeners.has(type)) {
+            this.listeners.set(type, []);
+        }
+        this.listeners.get(type).push(callback);
+    }
+    /**
+     * Start polling (detect new messages)
+     */
+    startPolling(intervalMs = 1000) {
+        if (this.pollInterval)
+            return;
+        this.pollInterval = setInterval(async () => {
+            await this.checkNewMessages();
+        }, intervalMs);
+    }
+    /**
+     * Stop polling
+     */
+    stopPolling() {
+        if (this.pollInterval) {
+            clearInterval(this.pollInterval);
+            this.pollInterval = null;
+        }
+    }
+    /**
+     * Check for new messages
+     */
+    async checkNewMessages() {
+        try {
+            const files = await fs.readdir(this.messagesPath);
+            const newFiles = files
+                .filter(f => f.endsWith('.json') && f > this.lastMessageId)
+                .sort();
+            for (const file of newFiles) {
+                const content = await fs.readFile(resolve(this.messagesPath, file), 'utf-8');
+                const message = JSON.parse(content);
+                // Invoke listeners
+                const callbacks = this.listeners.get(message.type);
+                if (callbacks) {
+                    for (const cb of callbacks) {
+                        cb(message);
+                    }
+                }
+                this.lastMessageId = file;
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    /**
+     * Get all messages
+     */
+    async getAllMessages() {
+        try {
+            const files = await fs.readdir(this.messagesPath);
+            const messages = [];
+            for (const file of files.filter(f => f.endsWith('.json')).sort()) {
+                const content = await fs.readFile(resolve(this.messagesPath, file), 'utf-8');
+                messages.push(JSON.parse(content));
+            }
+            return messages;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Create step context (including previous step results)
+     */
+    async createStepContext(stepId, dependsOn) {
+        const context = await this.getContext();
+        if (!context)
+            return '';
+        const parts = [
+            '## Workflow Context',
+            '',
+            `Execution ID: ${context.executionId}`,
+            `Started: ${new Date(context.startedAt).toISOString()}`,
+            '',
+        ];
+        // Previous step results
+        if (dependsOn && dependsOn.length > 0) {
+            parts.push('### Previous Step Results');
+            for (const depId of dependsOn) {
+                const output = context.stepOutputs[depId];
+                if (output) {
+                    parts.push(`\n#### ${depId}:`);
+                    parts.push(output.slice(0, 2000)); // Truncate if too long
+                }
+            }
+            parts.push('');
+        }
+        // Changed files
+        if (context.changedFiles.length > 0) {
+            parts.push('### Changed Files So Far');
+            parts.push(context.changedFiles.map(f => `- ${f}`).join('\n'));
+            parts.push('');
+        }
+        // Error log
+        if (context.errors.length > 0) {
+            parts.push('### Previous Errors');
+            for (const err of context.errors) {
+                parts.push(`- [${err.stepId}] ${err.message}`);
+            }
+            parts.push('');
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Clean up bus
+     */
+    async cleanup() {
+        this.stopPolling();
+        // Clean up files if needed
+    }
+}
+// Helper Functions
+/**
+ * Create new bus instance
+ */
+export function createBus(executionId) {
+    const id = executionId || `exec-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    return new AgentBus(id);
+}
+/**
+ * Connect to existing bus
+ */
+export async function connectToBus(executionId) {
+    const contextPath = resolve(BUS_DIR, executionId, 'context.json');
+    if (!existsSync(contextPath)) {
+        return null;
+    }
+    return new AgentBus(executionId);
+}
+/**
+ * List active buses
+ */
+export async function listActiveBuses() {
+    try {
+        await fs.mkdir(BUS_DIR, { recursive: true });
+        const dirs = await fs.readdir(BUS_DIR);
+        const active = [];
+        for (const dir of dirs) {
+            const contextPath = resolve(BUS_DIR, dir, 'context.json');
+            if (existsSync(contextPath)) {
+                active.push(dir);
+            }
+        }
+        return active;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=agentBus.js.map

package/dist/agents/agentBus.js.map

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

package/dist/agents/agentPair.d.ts

@@ -0,0 +1,210 @@
+import type { CostInfo } from '../support/costTracker.js';
+/**
+ * Confidence level for execution results (legacy)
+ * 0 = failed, 1 = low, 2 = medium, 3 = high
+ */
+export type ConfidenceLevel = 0 | 1 | 2 | 3;
+/**
+ * Confidence as a 0-100 percentage
+ */
+export type ConfidencePercent = number;
+export declare const CONFIDENCE_THRESHOLDS: {
+    readonly PROCEED: 80;
+    readonly CAUTIOUS: 60;
+    readonly HALT: 60;
+};
+/**
+ * Worker execution result
+ */
+export interface WorkerResult {
+    success: boolean;
+    summary: string;
+    filesChanged: string[];
+    commands: string[];
+    output: string;
+    error?: string;
+    confidence?: ConfidenceLevel;
+    confidencePercent?: number;
+    haltReason?: string;
+    uncertaintySignals?: string[];
+    costInfo?: CostInfo;
+}
+/**
+ * Confidence tracking for detecting degradation
+ */
+export interface ConfidenceTracker {
+    history: Array<{
+        attempt: number;
+        confidence: ConfidencePercent;
+        timestamp: number;
+        action: string;
+        haltTriggered?: boolean;
+    }>;
+    streakCount: number;
+    lastConfidence: ConfidencePercent;
+}
+/**
+ * Reviewer decision
+ */
+export type ReviewDecision = 'approve' | 'revise' | 'reject';
+/**
+ * Reviewer result
+ */
+export interface ReviewResult {
+    decision: ReviewDecision;
+    feedback: string;
+    issues?: string[];
+    suggestions?: string[];
+    costInfo?: CostInfo;
+}
+/**
+ * Pair message
+ */
+export interface PairMessage {
+    role: 'worker' | 'reviewer' | 'system';
+    content: string;
+    timestamp: number;
+}
+/**
+ * Pair session status
+ */
+export type PairSessionStatus = 'pending' | 'working' | 'reviewing' | 'revising' | 'approved' | 'rejected' | 'failed' | 'cancelled';
+/**
+ * Pair session
+ */
+export interface PairSession {
+    id: string;
+    taskId: string;
+    taskTitle: string;
+    taskDescription: string;
+    projectPath: string;
+    threadId?: string;
+    webhookUrl?: string;
+    models?: PairModelConfig;
+    status: PairSessionStatus;
+    worker: {
+        result?: WorkerResult;
+        attempts: number;
+        maxAttempts: number;
+        freshContextAfter?: number;
+        failureStreak: number;
+        useFreshContext?: boolean;
+    };
+    reviewer: {
+        feedback?: ReviewResult;
+    };
+    messages: PairMessage[];
+    confidenceTracker?: ConfidenceTracker;
+    startedAt: number;
+    finishedAt?: number;
+}
+/**
+ * Model configuration
+ */
+export interface PairModelConfig {
+    worker?: string;
+    reviewer?: string;
+}
+/**
+ * Pair session creation options
+ */
+export interface CreatePairSessionOptions {
+    taskId: string;
+    taskTitle: string;
+    taskDescription: string;
+    projectPath: string;
+    maxAttempts?: number;
+    webhookUrl?: string;
+    models?: PairModelConfig;
+}
+/**
+ * Create a new pair session
+ */
+export declare function createPairSession(options: CreatePairSessionOptions): PairSession;
+/**
+ * Get session by ID
+ */
+export declare function getPairSession(sessionId: string): PairSession | undefined;
+/**
+ * List active sessions
+ */
+export declare function getActiveSessions(): PairSession[];
+/**
+ * Update session status
+ */
+export declare function updateSessionStatus(sessionId: string, status: PairSessionStatus): PairSession | undefined;
+/**
+ * Set Discord thread ID
+ */
+export declare function setSessionThreadId(sessionId: string, threadId: string): PairSession | undefined;
+/**
+ * Save Worker result
+ */
+export declare function saveWorkerResult(sessionId: string, result: WorkerResult): PairSession | undefined;
+/**
+ * Save Reviewer result
+ */
+export declare function saveReviewerResult(sessionId: string, result: ReviewResult): PairSession | undefined;
+/**
+ * Add message
+ */
+export declare function addMessage(sessionId: string, role: PairMessage['role'], content: string): void;
+/**
+ * Cancel session
+ */
+export declare function cancelSession(sessionId: string): boolean;
+/**
+ * Check if Worker can retry
+ */
+export declare function canRetry(sessionId: string): boolean;
+/**
+ * Get session history
+ */
+export declare function getSessionHistory(limit?: number): PairSession[];
+/**
+ * Clear all sessions (for testing)
+ */
+export declare function clearAllSessions(): void;
+/**
+ * Format session status summary
+ */
+export declare function formatSessionSummary(session: PairSession): string;
+/**
+ * Format full discussion history
+ */
+export declare function formatDiscussion(session: PairSession): string;
+/**
+ * Calculate confidence as a 0-100 percentage based on worker result
+ */
+export declare function calculateConfidence(result: WorkerResult): ConfidencePercent;
+/**
+ * Update confidence tracker with new result
+ */
+export declare function updateConfidenceTracker(sessionId: string, result: WorkerResult, attempt: number): void;
+/**
+ * Check if confidence has degraded significantly
+ * Returns true if intervention is needed
+ */
+export declare function needsConfidenceIntervention(sessionId: string): boolean;
+/**
+ * Get confidence summary for reporting
+ */
+export declare function getConfidenceSummary(sessionId: string): string;
+/**
+ * Track failure and decide if fresh context is needed
+ * Call this when worker/reviewer iteration fails
+ */
+export declare function trackFailure(sessionId: string): void;
+/**
+ * Reset failure streak on success
+ */
+export declare function resetFailureStreak(sessionId: string): void;
+/**
+ * Check if fresh context should be used
+ */
+export declare function shouldUseFreshContext(sessionId: string): boolean;
+/**
+ * Mark that fresh context was consumed (reset flag)
+ */
+export declare function consumeFreshContext(sessionId: string): void;
+//# sourceMappingURL=agentPair.d.ts.map

package/dist/agents/agentPair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentPair.d.ts","sourceRoot":"","sources":["../../src/agents/agentPair.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAI1D;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEvC,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,iBAAiB,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,iBAAiB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,SAAS,GACT,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,QAAQ,GACR,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE;QACN,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,QAAQ,EAAE;QACR,QAAQ,CAAC,EAAE,YAAY,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAYD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,WAAW,CAwBhF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,EAAE,CAIjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,iBAAiB,GACxB,WAAW,GAAG,SAAS,CAazB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,WAAW,GAAG,SAAS,CAMzB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,GACnB,WAAW,GAAG,SAAS,CASzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,GACnB,WAAW,GAAG,SAAS,CAQzB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EACzB,OAAO,EAAE,MAAM,GACd,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAWxD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAKnD;AAaD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,MAAW,GAAG,WAAW,EAAE,CAEnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAoDD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAsBjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAoB7D;AAYD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB,CA0C3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,GACd,IAAI,CAoCN;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAsBtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAiB9D;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAcpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAM1D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAKhE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAM3D"}