@calliopelabs/cli 2.3.0 → 2.5.0

package/dist/scuttlebot/client.js

@@ -0,0 +1,350 @@
+/**
+ * Scuttlebot Integration Client
+ *
+ * Main integration point for scuttlebot. Registers via HTTP API, then connects
+ * directly to IRC for all runtime messaging. No HTTP polling.
+ */
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { ScuttlebotHTTPClient } from './http-client.js';
+import { ScuttlebotIRCClient, MessageTypes } from './irc-client.js';
+import { resolveChannelConfig } from './config.js';
+/**
+ * Load ~/.config/scuttlebot-relay.env as a fallback env source.
+ * Returns a map of KEY → value for SCUTTLEBOT_* variables not already set in process.env.
+ */
+function loadRelayEnv() {
+    const envFile = path.join(os.homedir(), '.config', 'scuttlebot-relay.env');
+    try {
+        const raw = fs.readFileSync(envFile, 'utf8');
+        const result = {};
+        for (const line of raw.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const eq = trimmed.indexOf('=');
+            if (eq === -1)
+                continue;
+            const key = trimmed.slice(0, eq).trim();
+            const val = trimmed.slice(eq + 1).trim();
+            if (key && val && !(key in process.env)) {
+                result[key] = val;
+            }
+        }
+        return result;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Keys that should be picked up from the relay env file.
+ * Project-specific keys (CHANNEL, NICK, PASSPHRASE) are intentionally excluded
+ * so they don't bleed across projects.
+ */
+const RELAY_ENV_KEYS = new Set([
+    'SCUTTLEBOT_URL',
+    'SCUTTLEBOT_TOKEN',
+    'SCUTTLEBOT_IRC_ADDR',
+]);
+/** Get a config value: process.env first, then relay env file fallback (server-level keys only). */
+function getEnv(key, relayEnv) {
+    return process.env[key] ?? (RELAY_ENV_KEYS.has(key) ? relayEnv[key] : undefined);
+}
+/**
+ * Generate an 8-char hex session ID from cwd+pid+time — mirrors the relay's
+ * defaultSessionID(target) which uses CRC32(path|pid|ppid|nanotime).
+ */
+function defaultSessionID(cwd) {
+    const input = `${cwd}|${process.pid}|${Date.now()}`;
+    return crypto.createHash('sha256').update(input).digest('hex').slice(0, 8);
+}
+/**
+ * Strip the addressed nick from the start of a message.
+ * "calliope-calliope-cli-13f9af15: hi there" → "hi there"
+ * Mirrors ircagent.TrimAddressedText from the relay.
+ */
+function trimAddressedText(text, nick) {
+    const trimmed = text.trim();
+    // Match "nick: ", "nick, ", "nick " at start (case-insensitive)
+    const prefix = new RegExp(`^${nick.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&')}[:\\s,]+`, 'i');
+    return trimmed.replace(prefix, '').trim() || trimmed;
+}
+/** Sanitize a string for use as an IRC nick (matches relay's sanitize()). */
+function sanitizeNick(value) {
+    let result = '';
+    for (const ch of value) {
+        if ((ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') ||
+            (ch >= '0' && ch <= '9') || ch === '-' || ch === '_') {
+            result += ch;
+        }
+        else {
+            result += '-';
+        }
+    }
+    result = result.replace(/^-+|-+$/g, '');
+    return result || 'session';
+}
+export class ScuttlebotClient {
+    httpClient = null;
+    ircClient = null;
+    config = null;
+    nick = '';
+    enabled = false;
+    registeredByClient = false; // track if we registered (for delete-on-close)
+    instructionHandler = null;
+    presenceTimer = null;
+    static PRESENCE_INTERVAL_MS = 60_000; // touch every 60s
+    /**
+     * Initialize from environment variables.
+     *
+     * Flow: resolve config -> register via HTTP -> connect IRC -> send agent.hello.
+     */
+    async initialize(sessionId, cwd) {
+        // Load ~/.config/scuttlebot-relay.env as fallback (same source the relay agents use)
+        const relayEnv = loadRelayEnv();
+        // SCUTTLEBOT_PASSPHRASE = pre-registered mode (stable nick, skip HTTP registration)
+        // SCUTTLEBOT_TOKEN      = dynamic registration mode (session nicks via HTTP API)
+        const passphrase = getEnv('SCUTTLEBOT_PASSPHRASE', relayEnv);
+        const token = getEnv('SCUTTLEBOT_TOKEN', relayEnv);
+        if (!passphrase && !token) {
+            this.enabled = false;
+            return false;
+        }
+        const resolved = resolveChannelConfig(cwd, getEnv('SCUTTLEBOT_CHANNEL', relayEnv), getEnv('SCUTTLEBOT_CHANNELS', relayEnv));
+        const { channel, channels } = resolved;
+        // IRC addr: env var > yaml > relay env > local default
+        const ircAddr = getEnv('SCUTTLEBOT_IRC_ADDR', relayEnv) || resolved.ircAddr || '127.0.0.1:6667';
+        const useTLS = resolved.tls ?? ircAddr.endsWith(':6697');
+        // URL: env var > yaml > relay env
+        const url = getEnv('SCUTTLEBOT_URL', relayEnv) || resolved.url || '';
+        this.config = {
+            url,
+            token: token || '',
+            ircAddr,
+            channel,
+            channels,
+            nick: this.nick,
+        };
+        try {
+            let ircNick;
+            let ircPassphrase;
+            if (passphrase) {
+                // Pre-registered mode: use provided nick + passphrase, no HTTP call needed
+                ircNick = getEnv('SCUTTLEBOT_NICK', relayEnv) || resolved.nick || 'calliope';
+                ircPassphrase = passphrase;
+                this.nick = ircNick;
+                // Create HTTP client for presence/touch if URL+token available
+                if (url && token) {
+                    this.httpClient = new ScuttlebotHTTPClient(this.config);
+                }
+            }
+            else {
+                // Dynamic registration mode: get session credentials via HTTP API
+                if (!url || !token) {
+                    this.enabled = false;
+                    return false;
+                }
+                // Generate session nick: calliope-{basename}-{8hex} — matches relay pattern
+                const basename = sanitizeNick(path.basename(cwd));
+                const sessionSuffix = defaultSessionID(cwd);
+                this.nick = sanitizeNick(getEnv('SCUTTLEBOT_NICK', relayEnv) || `calliope-${basename}-${sessionSuffix}`);
+                this.httpClient = new ScuttlebotHTTPClient(this.config);
+                const credentials = await this.httpClient.register(this.nick, 'worker', channels);
+                ircNick = credentials.nick;
+                ircPassphrase = credentials.passphrase;
+                this.nick = ircNick;
+                this.registeredByClient = true;
+            }
+            // Connect to IRC
+            this.ircClient = new ScuttlebotIRCClient({
+                serverAddr: ircAddr,
+                nick: ircNick,
+                passphrase: ircPassphrase,
+                channels: channels.map(c => c.startsWith('#') ? c : `#${c}`),
+                agentType: 'worker',
+                tls: useTLS,
+            });
+            // Wire up envelope handler — deliver task.create to instruction handler
+            this.ircClient.onEnvelope((env, _channel) => {
+                if (env.type === MessageTypes.TaskCreate && this.instructionHandler) {
+                    // Extract instruction text from payload
+                    const payload = env.payload;
+                    const instruction = payload?.instruction ?? payload?.prompt ?? payload?.text ?? JSON.stringify(payload);
+                    this.instructionHandler(String(instruction));
+                }
+            });
+            // Wire up human instruction handler — strip the addressing prefix before delivery
+            // e.g. "calliope-calliope-cli-13f9af15: hi" → "hi"
+            this.ircClient.onInstruction((text, _from, _channel) => {
+                if (this.instructionHandler) {
+                    this.instructionHandler(trimAddressedText(text, this.nick));
+                }
+            });
+            await this.ircClient.connect();
+            // 3. Announce presence — IRC envelope + registry touch
+            this.sendHello();
+            await this.touchPresence();
+            // 4. Heartbeat — keep registry showing agent as online
+            this.presenceTimer = setInterval(() => {
+                void this.touchPresence();
+            }, ScuttlebotClient.PRESENCE_INTERVAL_MS);
+            this.enabled = true;
+            return true;
+        }
+        catch (error) {
+            // eslint-disable-next-line no-console
+            console.error('Failed to initialize scuttlebot:', error instanceof Error ? error.message : String(error));
+            this.enabled = false;
+            return false;
+        }
+    }
+    /**
+     * Post a plain text message to the primary channel.
+     */
+    async postMessage(text) {
+        if (!this.enabled || !this.config || !this.ircClient)
+            return;
+        this.ircClient.sendRaw(this.config.channel, this.sanitizeSecrets(text));
+    }
+    /**
+     * Post online presence (agent.hello envelope).
+     */
+    async postOnline() {
+        this.sendHello();
+    }
+    /**
+     * Post offline presence (agent.bye envelope).
+     */
+    async postOffline() {
+        this.sendBye();
+    }
+    /**
+     * Mirror a tool call as a plain text status message.
+     */
+    async mirrorToolCall(toolName, args) {
+        if (!this.enabled || !this.config || !this.ircClient)
+            return;
+        let text = toolName;
+        if (args && typeof args === 'object') {
+            const argsObj = args;
+            if ('path' in argsObj)
+                text += ` ${argsObj.path}`;
+            if ('command' in argsObj)
+                text += ` ${argsObj.command}`;
+            if ('pattern' in argsObj)
+                text += ` ${argsObj.pattern}`;
+        }
+        this.ircClient.sendRaw(this.config.channel, this.sanitizeSecrets(text));
+    }
+    /**
+     * Mirror assistant message as plain text.
+     */
+    async mirrorAssistant(message) {
+        if (!this.enabled || !this.config || !this.ircClient)
+            return;
+        const truncated = message.length > 200
+            ? message.slice(0, 197) + '...'
+            : message;
+        this.ircClient.sendRaw(this.config.channel, this.sanitizeSecrets(truncated));
+    }
+    /**
+     * Register an instruction handler for incoming tasks/commands.
+     */
+    startPolling(handler) {
+        this.instructionHandler = handler;
+    }
+    /**
+     * Stop listening for instructions.
+     */
+    stopPolling() {
+        this.instructionHandler = null;
+    }
+    /**
+     * Disconnect and cleanup.
+     */
+    async disconnect() {
+        this.stopPolling();
+        if (this.presenceTimer) {
+            clearInterval(this.presenceTimer);
+            this.presenceTimer = null;
+        }
+        if (this.ircClient) {
+            this.sendBye();
+            await this.ircClient.disconnect();
+            this.ircClient = null;
+        }
+        // Delete session registration so it doesn't linger in the registry
+        if (this.registeredByClient && this.httpClient && this.nick) {
+            await this.httpClient.deleteAgent(this.nick);
+        }
+        this.httpClient = null;
+        this.registeredByClient = false;
+        this.enabled = false;
+    }
+    /**
+     * Get integration status.
+     */
+    getStatus() {
+        return {
+            enabled: this.enabled,
+            config: this.config || undefined,
+            nick: this.nick || undefined,
+            connected: this.ircClient?.isConnected() || false,
+        };
+    }
+    /**
+     * Check if enabled.
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+    // ── Private helpers ──────────────────────────────────────────────
+    sendHello() {
+        if (!this.ircClient || !this.config)
+            return;
+        this.ircClient.sendEnvelope(this.config.channel, {
+            v: 1,
+            type: MessageTypes.AgentHello,
+            from: this.nick,
+        });
+    }
+    sendBye() {
+        if (!this.ircClient || !this.config)
+            return;
+        this.ircClient.sendEnvelope(this.config.channel, {
+            v: 1,
+            type: MessageTypes.AgentBye,
+            from: this.nick,
+        });
+    }
+    /**
+     * Touch presence via HTTP API so the registry marks this agent as online.
+     * Best-effort — skipped silently if no URL/token configured.
+     */
+    async touchPresence() {
+        if (!this.httpClient || !this.config?.channel || !this.nick)
+            return;
+        await this.httpClient.touchPresence(this.config.channel, this.nick);
+    }
+    /**
+     * Sanitize secrets from text before posting.
+     */
+    sanitizeSecrets(text) {
+        let sanitized = text;
+        // Hex secrets (32+ chars)
+        sanitized = sanitized.replace(/\b[a-f0-9]{32,}\b/gi, '[REDACTED]');
+        // API keys (sk-...)
+        sanitized = sanitized.replace(/\bsk-[A-Za-z0-9_-]+\b/g, '[REDACTED]');
+        // Bearer tokens
+        sanitized = sanitized.replace(/bearer\s+[A-Za-z0-9._:-]+/gi, 'bearer [REDACTED]');
+        // Environment variable assignments
+        sanitized = sanitized.replace(/\b([A-Z0-9_]*(TOKEN|KEY|SECRET|PASSPHRASE)[A-Z0-9_]*)=([^ \t"'`]+)/gi, '$1=[REDACTED]');
+        return sanitized;
+    }
+}
+// Singleton instance
+export const scuttlebotClient = new ScuttlebotClient();
+//# sourceMappingURL=client.js.map

package/dist/scuttlebot/client.js.map

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

package/dist/scuttlebot/config.d.ts

@@ -0,0 +1,28 @@
+export interface RepoScuttlebotConfig {
+    channel?: string;
+    channels?: string[];
+    /** HTTP API base URL (e.g. "https://scuttlebot.net"). Not a secret — safe in yaml. */
+    url?: string;
+    /** IRC server address "host:port" (e.g. "irc.scuttlebot.net:6667"). */
+    irc_addr?: string;
+    /** Use TLS for IRC. Inferred from port 6697 if not specified. */
+    tls?: boolean;
+    /** Stable pre-registered IRC nick. Overridden by SCUTTLEBOT_NICK env var. */
+    nick?: string;
+}
+export interface ResolvedChannelConfig {
+    channel: string;
+    channels: string[];
+    /** From .scuttlebot.yaml url field (overridden by SCUTTLEBOT_URL env var). */
+    url?: string;
+    /** From .scuttlebot.yaml irc_addr field (overridden by SCUTTLEBOT_IRC_ADDR env var). */
+    ircAddr?: string;
+    /** From .scuttlebot.yaml tls field. */
+    tls?: boolean;
+    /** From .scuttlebot.yaml nick field (overridden by SCUTTLEBOT_NICK env var). */
+    nick?: string;
+}
+export declare function mergeChannels(existing: string[], extra: string[]): string[];
+export declare function loadRepoConfig(dir: string): RepoScuttlebotConfig | null;
+export declare function resolveChannelConfig(cwd: string, channel?: string, channelsEnv?: string): ResolvedChannelConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/scuttlebot/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/scuttlebot/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA0BD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAc3E;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAoCvE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAwB/G"}

package/dist/scuttlebot/config.js

@@ -0,0 +1,91 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { parse as parseYaml } from 'yaml';
+function normalizeChannelName(channel) {
+    return channel.trim().replace(/^#/, '');
+}
+function parseChannels(raw) {
+    if (!raw) {
+        return [];
+    }
+    return raw
+        .split(',')
+        .map(normalizeChannelName)
+        .filter(Boolean);
+}
+function allChannels(config) {
+    const combined = [
+        ...(config.channel ? [config.channel] : []),
+        ...(config.channels ?? []),
+    ];
+    return combined.map(normalizeChannelName).filter(Boolean);
+}
+export function mergeChannels(existing, extra) {
+    const seen = new Set();
+    const merged = [];
+    for (const channel of [...existing, ...extra]) {
+        const normalized = normalizeChannelName(channel);
+        if (!normalized || seen.has(normalized)) {
+            continue;
+        }
+        seen.add(normalized);
+        merged.push(normalized);
+    }
+    return merged;
+}
+export function loadRepoConfig(dir) {
+    let current = path.resolve(dir);
+    for (;;) {
+        const candidate = path.join(current, '.scuttlebot.yaml');
+        if (fs.existsSync(candidate)) {
+            const raw = fs.readFileSync(candidate, 'utf-8');
+            const parsed = parseYaml(raw);
+            if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                return {};
+            }
+            const config = parsed;
+            return {
+                channel: typeof config.channel === 'string' ? config.channel : undefined,
+                channels: Array.isArray(config.channels)
+                    ? config.channels.filter((value) => typeof value === 'string')
+                    : undefined,
+                url: typeof config.url === 'string' ? config.url : undefined,
+                irc_addr: typeof config.irc_addr === 'string' ? config.irc_addr : undefined,
+                tls: typeof config.tls === 'boolean' ? config.tls : undefined,
+                nick: typeof config.nick === 'string' ? config.nick : undefined,
+            };
+        }
+        // Stop once we reach the repo root.
+        if (fs.existsSync(path.join(current, '.git'))) {
+            return null;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+export function resolveChannelConfig(cwd, channel, channelsEnv) {
+    const explicitChannel = channel ? normalizeChannelName(channel) : '';
+    let channels = parseChannels(channelsEnv);
+    if (channels.length === 0 && explicitChannel) {
+        channels = [explicitChannel];
+    }
+    const repoConfig = loadRepoConfig(cwd);
+    if (repoConfig) {
+        channels = mergeChannels(channels, allChannels(repoConfig));
+    }
+    if (channels.length === 0) {
+        channels = ['general'];
+    }
+    return {
+        channel: channels[0],
+        channels,
+        url: repoConfig?.url,
+        ircAddr: repoConfig?.irc_addr,
+        tls: repoConfig?.tls,
+        nick: repoConfig?.nick,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/scuttlebot/config.js.map

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

package/dist/scuttlebot/http-client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Scuttlebot HTTP API Client
+ *
+ * Provides agent registration and health check via the scuttlebot HTTP API.
+ * All runtime messaging goes through IRC (see irc-client.ts).
+ */
+export interface ScuttlebotConfig {
+    /** HTTP API base URL for registration (e.g. "http://localhost:3000"). */
+    url: string;
+    /** API bearer token. */
+    token: string;
+    /** IRC server address, host:port (e.g. "127.0.0.1:6667"). */
+    ircAddr: string;
+    /** Primary channel (no # prefix). */
+    channel: string;
+    /** All channels (no # prefix). */
+    channels: string[];
+    /** Agent nick. */
+    nick?: string;
+}
+export interface AgentCredentials {
+    nick: string;
+    passphrase: string;
+}
+export declare class ScuttlebotHTTPClient {
+    private config;
+    constructor(config: ScuttlebotConfig);
+    /**
+     * Register an agent (or rotate if already registered) and return IRC credentials.
+     *
+     * Mirrors the relay's registerOrRotate logic:
+     *   POST /v1/agents/register → 201 Created: use passphrase
+     *                            → 409 Conflict: rotate instead
+     *   POST /v1/agents/{nick}/rotate → use new passphrase
+     */
+    register(nick: string, agentType?: string, channels?: string[]): Promise<AgentCredentials>;
+    /**
+     * Rotate credentials for an existing agent nick.
+     *
+     * POST /v1/agents/{nick}/rotate
+     */
+    rotate(nick: string): Promise<AgentCredentials>;
+    /**
+     * Delete agent registration on close (session cleanup).
+     *
+     * DELETE /v1/agents/{nick}
+     */
+    deleteAgent(nick: string): Promise<void>;
+    /**
+     * Touch presence for a nick in a channel — marks the agent as online
+     * in the registry. Required for the admin UI to show the agent as live.
+     *
+     * POST /v1/channels/{channel}/presence
+     */
+    touchPresence(channel: string, nick: string): Promise<void>;
+    /**
+     * Check server health.
+     *
+     * GET /v1/status
+     */
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/scuttlebot/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/scuttlebot/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAIpC;;;;;;;OAOG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgChG;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAerD;;;;OAIG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9C;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjE;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CActC"}