@cogitator-ai/swarms 0.4.20 → 0.5.1

package/dist/base-coordinator.js

@@ -0,0 +1,455 @@
+import { nanoid } from 'nanoid';
+import { getLogger } from '@cogitator-ai/core';
+import { ResourceTracker } from './resources/tracker.js';
+import { CircuitBreaker } from './resources/circuit-breaker.js';
+import { buildSwarmAgents } from './agents.js';
+import { runWithConcurrency } from './utils/concurrency.js';
+import { createDelegationTools } from './tools/delegation.js';
+import { createNegotiationTools } from './tools/negotiation.js';
+/**
+ * Shared coordination logic for local and distributed swarms: agent registry, budgets,
+ * circuit breaking, error recovery, pause/abort, parallel scheduling and observability.
+ * Subclasses only decide how a single agent turn is executed.
+ */
+export class BaseSwarmCoordinator {
+    config;
+    swarmId;
+    agents;
+    communication;
+    resourceTracker;
+    saveHistory = true;
+    circuitBreaker;
+    limitedAgents = new Map();
+    injectedTools = new Map();
+    abortController = new AbortController();
+    runScope = {};
+    paused = false;
+    constructor(config, swarmId, communication) {
+        this.config = config;
+        this.swarmId = swarmId;
+        this.communication = communication;
+        this.agents = buildSwarmAgents(config);
+        this.resourceTracker = new ResourceTracker(config.resources ?? {});
+        if (config.errorHandling?.circuitBreaker?.enabled) {
+            this.circuitBreaker = new CircuitBreaker({
+                threshold: config.errorHandling.circuitBreaker.threshold,
+                resetTimeout: config.errorHandling.circuitBreaker.resetTimeout,
+            });
+        }
+        this.wireObservability();
+    }
+    /**
+     * Hook for engines that need asynchronous setup before the first agent run.
+     */
+    async prepare() { }
+    get messageBus() {
+        return this.communication.messageBus;
+    }
+    get blackboard() {
+        return this.communication.blackboard;
+    }
+    get events() {
+        return this.communication.events;
+    }
+    setSaveHistory(value) {
+        this.saveHistory = value;
+    }
+    getSwarmId() {
+        return this.swarmId;
+    }
+    getAgent(name) {
+        return this.agents.get(name);
+    }
+    getAgents() {
+        return Array.from(this.agents.values());
+    }
+    getAgentsByRole(role) {
+        return this.getAgents().filter((a) => a.metadata.role === role);
+    }
+    getResourceUsage() {
+        return this.resourceTracker.getUsage();
+    }
+    /**
+     * Start a new swarm run: resource budgets are per run, so usage counters restart here.
+     */
+    beginRun(scope = {}) {
+        this.runScope = scope;
+        this.resourceTracker.reset();
+    }
+    endRun() {
+        this.runScope = {};
+    }
+    pause() {
+        this.paused = true;
+    }
+    resume() {
+        this.paused = false;
+    }
+    /**
+     * Abort the swarm: pending agent runs are rejected and in-flight runs are cancelled.
+     */
+    abort() {
+        this.abortController.abort(new Error('Swarm execution aborted'));
+    }
+    isAborted() {
+        return this.abortController.signal.aborted;
+    }
+    isPaused() {
+        return this.paused;
+    }
+    reset() {
+        this.abortController = new AbortController();
+        this.paused = false;
+        this.runScope = {};
+        this.resourceTracker.reset();
+        this.circuitBreaker?.reset();
+        for (const agent of this.agents.values()) {
+            agent.state = 'idle';
+            agent.lastResult = undefined;
+            agent.messageCount = 0;
+            agent.tokenCount = 0;
+        }
+        this.messageBus.clear();
+        this.blackboard.clear();
+    }
+    async runAgent(agentName, input, context, options) {
+        return this.runAgentWithRecovery(agentName, input, context, options ?? {}, new Set());
+    }
+    async runAgentsParallel(agents, maxConcurrency) {
+        const concurrency = Math.max(1, maxConcurrency ?? this.config.resources?.maxConcurrency ?? 4);
+        const tolerateFailures = this.config.errorHandling?.onAgentFailure === 'skip' ||
+            this.config.errorHandling?.partialResults === true;
+        const outcomes = await runWithConcurrency(agents, concurrency, ({ name, input, context }) => this.runAgent(name, input, context), { stopOnFailure: !tolerateFailures });
+        const results = new Map();
+        let firstError;
+        let failures = 0;
+        outcomes.forEach((outcome, index) => {
+            if (!outcome)
+                return;
+            if (outcome.status === 'fulfilled') {
+                results.set(agents[index].name, outcome.value);
+            }
+            else {
+                failures++;
+                firstError ??= outcome.reason;
+            }
+        });
+        if (failures > 0 && (!tolerateFailures || results.size === 0)) {
+            throw firstError;
+        }
+        return results;
+    }
+    async runAgentWithRecovery(agentName, input, context, options, failoverChain) {
+        const swarmAgent = this.requireAgent(agentName);
+        await this.ensureRunnable();
+        try {
+            return await this.executeAgent(swarmAgent, input, context, options);
+        }
+        catch (error) {
+            if (!this.config.errorHandling || this.isCancelled()) {
+                throw error;
+            }
+            return this.handleAgentError(swarmAgent, input, context, options, toError(error), failoverChain);
+        }
+    }
+    requireAgent(agentName) {
+        const swarmAgent = this.agents.get(agentName);
+        if (!swarmAgent) {
+            throw new Error(`Agent '${agentName}' not found in swarm`);
+        }
+        return swarmAgent;
+    }
+    async ensureRunnable() {
+        await this.prepare();
+        if (this.circuitBreaker && !this.circuitBreaker.canExecute()) {
+            throw new Error(`Circuit breaker is open for swarm '${this.config.name}'`);
+        }
+        if (!this.resourceTracker.isWithinBudget()) {
+            throw new Error('Swarm resource budget exceeded');
+        }
+        while (this.paused && !this.isCancelled()) {
+            await new Promise((r) => setTimeout(r, 100));
+        }
+        if (this.isCancelled()) {
+            throw new Error('Swarm execution aborted');
+        }
+    }
+    isCancelled() {
+        return this.abortController.signal.aborted || this.runScope.signal?.aborted === true;
+    }
+    currentSignal() {
+        const runSignal = this.runScope.signal;
+        return runSignal
+            ? AbortSignal.any([this.abortController.signal, runSignal])
+            : this.abortController.signal;
+    }
+    async executeAgent(swarmAgent, input, context, options) {
+        const agentName = swarmAgent.agent.name;
+        this.setAgentState(agentName, 'running');
+        this.messageBus.resetTurnCounts(agentName);
+        this.events.emit('agent:start', { agentName, input }, agentName);
+        try {
+            const incomingMessages = this.collectIncomingMessages(agentName);
+            const negotiationContext = this.buildNegotiationContext(agentName);
+            const result = await this.executeRun({
+                swarmAgent,
+                agent: this.getRunnableAgent(swarmAgent, options.maxTokens),
+                input,
+                signal: this.currentSignal(),
+                saveHistory: this.saveHistory,
+                threadId: this.runScope.threadId ? `${this.runScope.threadId}:${agentName}` : undefined,
+                timeout: minDefined(this.config.resources?.perAgent?.timeout, options.timeout),
+                context: {
+                    ...context,
+                    swarmContext: {
+                        swarmId: this.swarmId,
+                        swarmName: this.config.name,
+                        agentRole: swarmAgent.metadata.role,
+                        availableAgents: Array.from(this.agents.keys()).filter((n) => n !== agentName),
+                    },
+                    ...(incomingMessages && { _incomingMessages: incomingMessages }),
+                    ...(negotiationContext && { _negotiation: negotiationContext }),
+                },
+            });
+            this.setAgentState(agentName, 'completed');
+            swarmAgent.lastResult = result;
+            swarmAgent.tokenCount += result.usage.totalTokens;
+            this.resourceTracker.trackAgentRun(agentName, result);
+            this.circuitBreaker?.recordSuccess();
+            this.events.emit('agent:complete', { agentName, result }, agentName);
+            return result;
+        }
+        catch (error) {
+            this.setAgentState(agentName, 'failed');
+            this.circuitBreaker?.recordFailure();
+            this.events.emit('agent:error', { agentName, error }, agentName);
+            throw error;
+        }
+    }
+    /**
+     * Tools a strategy needs an agent to have: the supervisor of a hierarchical swarm gets the
+     * delegation tools, negotiating agents get the negotiation tools. Tools the agent already
+     * defines (by name) are left untouched. Engines that cannot ship tool implementations
+     * (e.g. remote workers) override this.
+     */
+    strategyTools(swarmAgent) {
+        const name = swarmAgent.agent.name;
+        const role = swarmAgent.metadata.role;
+        switch (this.config.strategy) {
+            case 'hierarchical':
+                return role === 'supervisor'
+                    ? Object.values(createDelegationTools(this, this.blackboard, name))
+                    : [];
+            case 'negotiation':
+                return role === 'supervisor' || role === 'moderator'
+                    ? []
+                    : Object.values(createNegotiationTools(this.blackboard, this.events, name, swarmAgent.metadata.weight ?? this.config.negotiation?.weights?.[name] ?? 1));
+            default:
+                return [];
+        }
+    }
+    missingStrategyTools(swarmAgent) {
+        let tools = this.injectedTools.get(swarmAgent.agent.name);
+        if (!tools) {
+            const existing = new Set(swarmAgent.agent.tools.map((t) => t.name));
+            tools = this.strategyTools(swarmAgent).filter((t) => !existing.has(t.name));
+            this.injectedTools.set(swarmAgent.agent.name, tools);
+        }
+        return tools;
+    }
+    /**
+     * The agent actually executed for a turn: a cached clone when strategy tools,
+     * `resources.perAgent` limits or per-turn token caps apply, otherwise the agent itself.
+     */
+    getRunnableAgent(swarmAgent, turnMaxTokens) {
+        const perAgent = this.config.resources?.perAgent;
+        const { maxIterations, maxTokens } = swarmAgent.agent.config;
+        const iterationLimit = minDefined(maxIterations, perAgent?.maxIterations);
+        const tokenLimit = minDefined(maxTokens, perAgent?.maxTokens, turnMaxTokens);
+        const extraTools = this.missingStrategyTools(swarmAgent);
+        const overrides = {};
+        if (iterationLimit !== maxIterations)
+            overrides.maxIterations = iterationLimit;
+        if (tokenLimit !== maxTokens)
+            overrides.maxTokens = tokenLimit;
+        if (extraTools.length > 0)
+            overrides.tools = [...swarmAgent.agent.tools, ...extraTools];
+        if (Object.keys(overrides).length === 0)
+            return swarmAgent.agent;
+        const cacheKey = `${swarmAgent.agent.name}|${iterationLimit ?? ''}|${tokenLimit ?? ''}`;
+        let runnable = this.limitedAgents.get(cacheKey);
+        if (!runnable) {
+            runnable = swarmAgent.agent.clone(overrides);
+            this.limitedAgents.set(cacheKey, runnable);
+        }
+        return runnable;
+    }
+    async handleAgentError(swarmAgent, input, context, options, error, failoverChain) {
+        const errorConfig = this.config.errorHandling;
+        const agentName = swarmAgent.agent.name;
+        switch (errorConfig.onAgentFailure) {
+            case 'retry':
+                if (errorConfig.retry && errorConfig.retry.maxRetries > 0) {
+                    return this.retryAgentRun(swarmAgent, input, context, options, errorConfig.retry, error);
+                }
+                throw error;
+            case 'failover': {
+                failoverChain.add(agentName);
+                const backupAgentName = errorConfig.failover?.[agentName];
+                if (backupAgentName && !failoverChain.has(backupAgentName)) {
+                    return this.runAgentWithRecovery(backupAgentName, input, context, options, failoverChain);
+                }
+                throw error;
+            }
+            case 'skip':
+                return {
+                    output: '',
+                    runId: `run_skipped_${nanoid(8)}`,
+                    agentId: swarmAgent.agent.id,
+                    threadId: '',
+                    usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0, cost: 0, duration: 0 },
+                    toolCalls: [],
+                    messages: [],
+                    trace: { traceId: `trace_${nanoid(12)}`, spans: [] },
+                };
+            case 'abort':
+            default:
+                throw error;
+        }
+    }
+    async retryAgentRun(swarmAgent, input, context, options, retryConfig, initialError) {
+        const { maxRetries, backoff, initialDelay = 1000, maxDelay = 30000 } = retryConfig;
+        let lastError = initialError;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            await sleep(computeBackoffDelay(backoff, attempt, initialDelay, maxDelay));
+            await this.ensureRunnable();
+            try {
+                return await this.executeAgent(swarmAgent, input, context, options);
+            }
+            catch (error) {
+                lastError = toError(error);
+                if (this.isCancelled())
+                    throw lastError;
+            }
+        }
+        throw new Error(`Agent '${swarmAgent.agent.name}' failed after ${maxRetries} retries: ${lastError.message}`, { cause: lastError });
+    }
+    setAgentState(agentName, state) {
+        const agent = this.agents.get(agentName);
+        if (agent) {
+            agent.state = state;
+        }
+    }
+    wireObservability() {
+        const observability = this.config.observability;
+        const logger = getLogger();
+        this.messageBus.onMessage((message) => {
+            const sender = this.agents.get(message.from);
+            if (sender)
+                sender.messageCount++;
+            this.events.emit('message:sent', {
+                id: message.id,
+                from: message.from,
+                to: message.to,
+                type: message.type,
+                channel: message.channel,
+                content: message.content,
+            }, message.from);
+            if (observability?.messageLogging) {
+                logger.info('[Swarm] message', {
+                    swarm: this.config.name,
+                    from: message.from,
+                    to: message.to,
+                    type: message.type,
+                    channel: message.channel,
+                    content: message.content,
+                });
+            }
+        });
+        this.blackboard.onWrite((write) => {
+            this.events.emit('blackboard:write', {
+                section: write.section,
+                version: write.version,
+                writtenBy: write.agentName,
+                deleted: write.deleted ?? false,
+            }, write.agentName);
+            if (observability?.blackboardLogging) {
+                logger.info('[Swarm] blackboard write', {
+                    swarm: this.config.name,
+                    section: write.section,
+                    version: write.version,
+                    writtenBy: write.agentName,
+                    deleted: write.deleted ?? false,
+                });
+            }
+        });
+    }
+    collectIncomingMessages(agentName) {
+        const unread = this.messageBus.getUnreadMessages(agentName);
+        if (unread.length === 0)
+            return null;
+        const ids = unread.map((m) => m.id);
+        this.messageBus.markAsRead(agentName, ids);
+        this.events.emit('message:received', { agentName, count: unread.length, messageIds: ids }, agentName);
+        const formatted = unread.map((m) => {
+            const timestamp = new Date(m.timestamp).toISOString();
+            return `[${timestamp}] ${m.from} → ${m.to}: ${m.content}`;
+        });
+        return `\n--- Incoming Messages ---\n${formatted.join('\n')}\n---`;
+    }
+    buildNegotiationContext(agentName) {
+        if (!this.blackboard.has('negotiation'))
+            return null;
+        const state = this.blackboard.read('negotiation');
+        const pendingOffers = state.offers.filter((o) => o.status === 'pending');
+        const offersToMe = pendingOffers.filter((o) => {
+            const recipients = Array.isArray(o.to) ? o.to : [o.to];
+            return recipients.includes(agentName);
+        });
+        const myOffers = pendingOffers.filter((o) => o.from === agentName);
+        return {
+            phase: state.phase,
+            round: state.round,
+            maxRounds: state.maxRounds,
+            isMyTurn: state.currentTurn === agentName || state.currentTurn === null,
+            currentTurn: state.currentTurn,
+            offersAwaitingMyResponse: offersToMe.map((o) => ({
+                id: o.id,
+                from: o.from,
+                reasoning: o.reasoning,
+                terms: o.terms,
+            })),
+            myPendingOffers: myOffers.map((o) => ({
+                id: o.id,
+                to: o.to,
+                status: o.status,
+            })),
+            myInterests: state.interests[agentName],
+            coalitions: state.coalitions.filter((c) => c.members.includes(agentName) || c.status === 'forming'),
+            hasAgreement: !!state.agreement,
+        };
+    }
+}
+export function computeBackoffDelay(backoff, attempt, initialDelay, maxDelay) {
+    switch (backoff) {
+        case 'exponential':
+            return Math.min(initialDelay * Math.pow(2, attempt - 1), maxDelay);
+        case 'linear':
+            return Math.min(initialDelay * attempt, maxDelay);
+        default:
+            return Math.min(initialDelay, maxDelay);
+    }
+}
+function minDefined(...values) {
+    const defined = values.filter((v) => v !== undefined);
+    return defined.length > 0 ? Math.min(...defined) : undefined;
+}
+function sleep(ms) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+//# sourceMappingURL=base-coordinator.js.map

package/dist/base-coordinator.js.map

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

package/dist/communication/blackboard.d.ts

@@ -2,10 +2,35 @@
  * Blackboard for shared state between agents
  */
 import type { Blackboard, BlackboardConfig, BlackboardSection, BlackboardHistoryEntry } from '@cogitator-ai/types';
-export declare class InMemoryBlackboard implements Blackboard {
+export type BlackboardSectionHandler = (data: unknown, agentName: string) => void;
+export interface BlackboardWrite {
+    section: string;
+    data: unknown;
+    agentName: string;
+    version: number;
+    deleted?: boolean;
+}
+export type BlackboardWriteListener = (write: BlackboardWrite) => void;
+/**
+ * Blackboard that exposes a bus-wide write listener (used for swarm observability).
+ */
+export interface ObservableBlackboard extends Blackboard {
+    onWrite(listener: BlackboardWriteListener): () => void;
+}
+export declare function isObservableBlackboard(blackboard: Blackboard): blackboard is ObservableBlackboard;
+export declare class BlackboardListeners {
+    private readonly label;
+    private sectionHandlers;
+    private writeListeners;
+    constructor(label: string);
+    subscribe(section: string, handler: BlackboardSectionHandler): () => void;
+    onWrite(listener: BlackboardWriteListener): () => void;
+    notify(write: BlackboardWrite): void;
+}
+export declare class InMemoryBlackboard implements ObservableBlackboard {
     private sections;
     private history;
-    private subscriptions;
+    private listeners;
     private config;
     constructor(config: BlackboardConfig);
     read<T = unknown>(section: string): T;
@@ -13,12 +38,17 @@ export declare class InMemoryBlackboard implements Blackboard {
     append<T>(section: string, item: T, agentName: string): void;
     has(section: string): boolean;
     delete(section: string): void;
-    subscribe(section: string, handler: (data: unknown, agentName: string) => void): () => void;
+    subscribe(section: string, handler: BlackboardSectionHandler): () => void;
+    onWrite(listener: BlackboardWriteListener): () => void;
     getSections(): string[];
     getSection<T = unknown>(section: string): BlackboardSection<T> | undefined;
     getHistory(section: string): BlackboardHistoryEntry[];
+    /**
+     * Remove all sections and history. Subscriptions are preserved so listeners
+     * keep working across swarm resets.
+     */
     clear(): void;
-    private notifySubscribers;
+    private assertEnabled;
 }
 export declare function createBlackboard(config?: Partial<BlackboardConfig>): Blackboard;
 //# sourceMappingURL=blackboard.d.ts.map

package/dist/communication/blackboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blackboard.d.ts","sourceRoot":"","sources":["../../src/communication/blackboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,aAAa,CAAsE;IAC3F,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAyBpC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC;IAWrC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAkC3D,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAgB5D,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM7B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAiB3F,WAAW,IAAI,MAAM,EAAE;IAIvB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS;IAI1E,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAIrD,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,iBAAiB;CAU1B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAO/E"}
+{"version":3,"file":"blackboard.d.ts","sourceRoot":"","sources":["../../src/communication/blackboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,MAAM,wBAAwB,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,OAAO,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAAC;CACxD;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,IAAI,oBAAoB,CAEjG;AAED,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,OAAO,CAAC,eAAe,CAAoD;IAC3E,OAAO,CAAC,cAAc,CAAsC;gBAE/B,KAAK,EAAE,MAAM;IAE1C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAkBzE,OAAO,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI;IAOtD,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;CAUrC;AAED,qBAAa,kBAAmB,YAAW,oBAAoB;IAC7D,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,SAAS,CAA2C;IAC5D,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAyBpC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC;IASrC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IA2B3D,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAgB5D,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAe7B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAIzE,OAAO,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI;IAItD,WAAW,IAAI,MAAM,EAAE;IAIvB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS;IAI1E,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAIrD;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,aAAa;CAKtB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAO/E"}