@calliopelabs/cli 2.2.0 → 2.5.0

package/dist/scuttlebot/irc-client.js

@@ -0,0 +1,599 @@
+/**
+ * Scuttlebot IRC Client
+ *
+ * Zero-dependency IRC client using Node.js net.Socket.
+ * Connects directly to Ergo IRC server with SASL PLAIN auth.
+ * Handles the scuttlebot envelope protocol (JSON over PRIVMSG).
+ */
+import * as net from 'node:net';
+import * as tls from 'node:tls';
+import * as crypto from 'node:crypto';
+/** Well-known message types. */
+export const MessageTypes = {
+    AgentHello: 'agent.hello',
+    AgentBye: 'agent.bye',
+    TaskCreate: 'task.create',
+    TaskUpdate: 'task.update',
+    TaskComplete: 'task.complete',
+};
+/**
+ * Check whether an envelope is addressed to `nick` with `agentType`.
+ *
+ * Ported from Go's protocol.MatchesRecipient:
+ *   - empty/nil to     -> true (broadcast)
+ *   - @all              -> true
+ *   - @workers etc.     -> agentType match
+ *   - @prefix-*         -> nick starts with prefix-
+ *   - bare string       -> exact nick match
+ */
+export function matchesRecipient(env, nick, agentType) {
+    if (!env.to || env.to.length === 0) {
+        return true;
+    }
+    for (const token of env.to) {
+        switch (token) {
+            case '@all':
+                return true;
+            case '@operators':
+                if (agentType === 'operator')
+                    return true;
+                break;
+            case '@orchestrators':
+                if (agentType === 'orchestrator')
+                    return true;
+                break;
+            case '@workers':
+                if (agentType === 'worker')
+                    return true;
+                break;
+            case '@observers':
+                if (agentType === 'observer')
+                    return true;
+                break;
+            default:
+                if (token.startsWith('@')) {
+                    // @prefix-* glob: strip @ and trailing *
+                    const body = token.slice(1);
+                    if (body.endsWith('-*')) {
+                        const prefix = body.slice(0, -1); // keep the trailing dash
+                        if (nick.startsWith(prefix))
+                            return true;
+                    }
+                }
+                else if (token === nick) {
+                    return true;
+                }
+        }
+    }
+    return false;
+}
+/** Create a new envelope with a generated ID and current timestamp. */
+export function newEnvelope(type, from, opts) {
+    return {
+        v: 1,
+        type,
+        id: crypto.randomUUID(),
+        from,
+        ts: Date.now(),
+        ...(opts?.to ? { to: opts.to } : {}),
+        ...(opts?.payload !== undefined ? { payload: opts.payload } : {}),
+    };
+}
+/** Validate that a parsed object looks like a valid Envelope. */
+function isEnvelope(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const e = obj;
+    return (e.v === 1 &&
+        typeof e.type === 'string' && e.type !== '' &&
+        typeof e.id === 'string' && e.id !== '' &&
+        typeof e.from === 'string' && e.from !== '' &&
+        typeof e.ts === 'number');
+}
+// ── IRC Client ───────────────────────────────────────────────────────
+/** Agent nick prefixes that indicate non-human senders. */
+const AGENT_PREFIXES = ['claude-', 'codex-', 'gemini-', 'calliope-'];
+/** Known service bots to ignore for instruction delivery. */
+const SERVICE_BOTS = new Set([
+    'bridge', 'oracle', 'sentinel', 'steward', 'scribe',
+    'warden', 'snitch', 'herald', 'scroll', 'systembot', 'auditbot',
+]);
+export class ScuttlebotIRCClient {
+    opts;
+    agentType;
+    socket = null;
+    connected = false;
+    destroyed = false;
+    envelopeHandlers = [];
+    instructionHandlers = [];
+    // Reconnect state
+    reconnectTimer = null;
+    reconnectDelay = 2000; // ms, doubles up to 60s
+    shouldReconnect = true;
+    // Incoming data buffer (IRC lines are \r\n delimited)
+    buffer = '';
+    // SASL / registration state machine
+    saslState = 'none';
+    connectResolve = null;
+    connectReject = null;
+    connectTimeout = null;
+    // Client-initiated PING keepalive — detects dead TCP connections
+    static PING_INTERVAL_MS = 30_000;
+    static PING_TIMEOUT_MS = 30_000;
+    pingTimer = null;
+    pongTimer = null;
+    pendingPing = false;
+    // Signal handler registered for clean exit
+    exitHandler = null;
+    constructor(opts) {
+        this.opts = opts;
+        this.agentType = opts.agentType || 'worker';
+    }
+    /** Register a handler for incoming JSON envelopes. */
+    onEnvelope(handler) {
+        this.envelopeHandlers.push(handler);
+    }
+    /** Register a handler for human instructions (non-JSON PRIVMSG that mention our nick). */
+    onInstruction(handler) {
+        this.instructionHandlers.push(handler);
+    }
+    /**
+     * Connect to the IRC server. Resolves once fully registered (numeric 001 received).
+     * Rejects on timeout (30s) or fatal connection error during initial connect.
+     */
+    async connect() {
+        if (this.connected)
+            return;
+        this.destroyed = false;
+        this.shouldReconnect = true;
+        return new Promise((resolve, reject) => {
+            this.connectResolve = resolve;
+            this.connectReject = reject;
+            this.connectTimeout = setTimeout(() => {
+                if (!this.connected) {
+                    const err = new Error('IRC connection timeout (30s)');
+                    this.connectReject?.(err);
+                    this.connectReject = null;
+                    this.connectResolve = null;
+                    this.cleanupSocket();
+                }
+            }, 30000);
+            this.createConnection();
+        });
+    }
+    /** Disconnect gracefully. Sends QUIT and closes the socket. */
+    async disconnect() {
+        this.shouldReconnect = false;
+        this.destroyed = true;
+        this.stopPingKeepalive();
+        this.unregisterExitHandler();
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.connectTimeout) {
+            clearTimeout(this.connectTimeout);
+            this.connectTimeout = null;
+        }
+        if (this.socket && !this.socket.destroyed) {
+            this.sendRawLine('QUIT :Session ended');
+            // Give the server a moment to process QUIT before destroying
+            await new Promise((resolve) => {
+                const timer = setTimeout(() => {
+                    this.cleanupSocket();
+                    resolve();
+                }, 500);
+                this.socket?.once('close', () => {
+                    clearTimeout(timer);
+                    resolve();
+                });
+            });
+        }
+        this.connected = false;
+    }
+    /** Send a JSON envelope as PRIVMSG to a channel. */
+    sendEnvelope(channel, env) {
+        const full = newEnvelope(env.type, env.from, {
+            to: env.to,
+            payload: env.payload,
+        });
+        const json = JSON.stringify(full);
+        this.sendPrivmsg(channel, json);
+    }
+    /** Send a plain text PRIVMSG to a channel. */
+    sendRaw(channel, text) {
+        this.sendPrivmsg(channel, text);
+    }
+    /** Whether we are currently connected and registered on IRC. */
+    isConnected() {
+        return this.connected;
+    }
+    // ── Private: connection ──────────────────────────────────────────
+    createConnection() {
+        const [host, portStr] = parseHostPort(this.opts.serverAddr);
+        const port = parseInt(portStr, 10);
+        const useTLS = this.opts.tls ?? port === 6697;
+        this.buffer = '';
+        this.saslState = 'none';
+        const onConnect = () => {
+            // TCP/TLS connected — begin IRC handshake
+            this.saslState = 'cap-req';
+            this.sendRawLine('CAP REQ :sasl');
+            this.sendRawLine(`NICK ${this.opts.nick}`);
+            this.sendRawLine(`USER ${this.opts.nick} 0 * :${this.opts.nick}`);
+        };
+        const socket = useTLS
+            ? tls.connect({ host, port, servername: host, rejectUnauthorized: true }, onConnect)
+            : net.createConnection({ host, port }, onConnect);
+        socket.setEncoding('utf8');
+        socket.on('data', (data) => {
+            this.buffer += data;
+            this.processBuffer();
+        });
+        socket.on('error', (err) => {
+            if (this.connectReject) {
+                this.connectReject(err);
+                this.connectReject = null;
+                this.connectResolve = null;
+                if (this.connectTimeout) {
+                    clearTimeout(this.connectTimeout);
+                    this.connectTimeout = null;
+                }
+            }
+            this.connected = false;
+        });
+        socket.on('close', () => {
+            this.connected = false;
+            this.socket = null;
+            this.stopPingKeepalive();
+            this.scheduleReconnect();
+        });
+        this.socket = socket;
+    }
+    processBuffer() {
+        let idx;
+        while ((idx = this.buffer.indexOf('\r\n')) !== -1) {
+            const line = this.buffer.slice(0, idx);
+            this.buffer = this.buffer.slice(idx + 2);
+            if (line.length > 0) {
+                this.handleLine(line);
+            }
+        }
+        // Also handle \n-only line endings (some servers)
+        while ((idx = this.buffer.indexOf('\n')) !== -1) {
+            const line = this.buffer.slice(0, idx).replace(/\r$/, '');
+            this.buffer = this.buffer.slice(idx + 1);
+            if (line.length > 0) {
+                this.handleLine(line);
+            }
+        }
+    }
+    // ── Private: IRC line handling ───────────────────────────────────
+    handleLine(raw) {
+        // Strip IRCv3 message tags (we don't need them for now)
+        let line = raw;
+        if (line.startsWith('@')) {
+            const spaceIdx = line.indexOf(' ');
+            if (spaceIdx === -1)
+                return;
+            line = line.slice(spaceIdx + 1);
+        }
+        // PING must be answered immediately
+        if (line.startsWith('PING')) {
+            const payload = line.slice(5); // after "PING "
+            this.sendRawLine(`PONG ${payload}`);
+            return;
+        }
+        const parsed = parseIRCMessage(line);
+        if (!parsed)
+            return;
+        const { prefix, command, params } = parsed;
+        switch (command) {
+            // CAP negotiation
+            case 'CAP': {
+                // :server CAP * ACK :sasl
+                const subCommand = params.length >= 2 ? params[1] : '';
+                if (subCommand === 'ACK' && this.saslState === 'cap-req') {
+                    this.saslState = 'cap-ack';
+                    this.sendRawLine('AUTHENTICATE PLAIN');
+                }
+                else if (subCommand === 'NAK') {
+                    // Server rejected SASL — try without it
+                    this.sendRawLine('CAP END');
+                }
+                break;
+            }
+            case 'AUTHENTICATE': {
+                // Server sends "AUTHENTICATE +" to request the credentials
+                if (params[0] === '+' && this.saslState === 'cap-ack') {
+                    const credentials = `\0${this.opts.nick}\0${this.opts.passphrase}`;
+                    const encoded = Buffer.from(credentials).toString('base64');
+                    this.sendRawLine(`AUTHENTICATE ${encoded}`);
+                    this.saslState = 'auth-sent';
+                }
+                break;
+            }
+            // 903 = SASL auth successful
+            case '903': {
+                this.saslState = 'authenticated';
+                this.sendRawLine('CAP END');
+                break;
+            }
+            // 904/905 = SASL auth failed
+            case '904':
+            case '905': {
+                const errMsg = params.length > 1 ? params.slice(1).join(' ') : 'SASL authentication failed';
+                if (this.connectReject) {
+                    this.connectReject(new Error(errMsg));
+                    this.connectReject = null;
+                    this.connectResolve = null;
+                    if (this.connectTimeout) {
+                        clearTimeout(this.connectTimeout);
+                        this.connectTimeout = null;
+                    }
+                }
+                this.cleanupSocket();
+                break;
+            }
+            // 001 = RPL_WELCOME — fully registered
+            case '001': {
+                this.connected = true;
+                this.saslState = 'registered';
+                this.reconnectDelay = 2000; // reset backoff on successful connect
+                // Join channels
+                for (const ch of this.opts.channels) {
+                    const channelName = ch.startsWith('#') ? ch : `#${ch}`;
+                    this.sendRawLine(`JOIN ${channelName}`);
+                }
+                // Resolve the connect() promise
+                if (this.connectTimeout) {
+                    clearTimeout(this.connectTimeout);
+                    this.connectTimeout = null;
+                }
+                if (this.connectResolve) {
+                    this.connectResolve();
+                    this.connectResolve = null;
+                    this.connectReject = null;
+                }
+                // Start client-side PING keepalive and register clean-exit handler
+                this.startPingKeepalive();
+                this.registerExitHandler();
+                break;
+            }
+            // PONG — server responded to our keepalive PING
+            case 'PONG': {
+                if (this.pongTimer) {
+                    clearTimeout(this.pongTimer);
+                    this.pongTimer = null;
+                }
+                this.pendingPing = false;
+                break;
+            }
+            // PRIVMSG — the main message handler
+            case 'PRIVMSG': {
+                if (params.length < 2)
+                    break;
+                const channel = params[0];
+                const text = params.slice(1).join(' ').replace(/^:/, '');
+                const senderNick = extractNick(prefix);
+                // Ignore our own messages
+                if (senderNick === this.opts.nick)
+                    break;
+                // Try to parse as JSON envelope
+                try {
+                    const obj = JSON.parse(text);
+                    if (isEnvelope(obj)) {
+                        // Valid envelope — check recipient addressing
+                        if (matchesRecipient(obj, this.opts.nick, this.agentType)) {
+                            for (const handler of this.envelopeHandlers) {
+                                handler(obj, channel);
+                            }
+                        }
+                        break;
+                    }
+                }
+                catch {
+                    // Not JSON — fall through to human chat handling
+                }
+                // Non-JSON PRIVMSG: potential human instruction
+                this.handleHumanChat(senderNick, channel, text);
+                break;
+            }
+            // NOTICE — system/human commentary, silently ignored per protocol spec
+            case 'NOTICE':
+                break;
+            // Other numerics we can safely ignore
+            default:
+                break;
+        }
+    }
+    /**
+     * Handle non-JSON PRIVMSG as potential human instructions.
+     * Delivers to instruction handlers if:
+     * - Message mentions our nick
+     * - Sender is not a service bot
+     * - Sender is not an agent (claude-/codex-/gemini-/calliope- prefix)
+     */
+    handleHumanChat(senderNick, channel, text) {
+        if (this.instructionHandlers.length === 0)
+            return;
+        // Skip service bots
+        if (SERVICE_BOTS.has(senderNick))
+            return;
+        // Skip agent nicks
+        for (const prefix of AGENT_PREFIXES) {
+            if (senderNick.startsWith(prefix))
+                return;
+        }
+        // Must mention our nick (case-insensitive)
+        if (!text.toLowerCase().includes(this.opts.nick.toLowerCase()))
+            return;
+        for (const handler of this.instructionHandlers) {
+            handler(text, senderNick, channel);
+        }
+    }
+    // ── Private: sending ─────────────────────────────────────────────
+    sendRawLine(line) {
+        if (this.socket && !this.socket.destroyed) {
+            this.socket.write(line + '\r\n');
+        }
+    }
+    sendPrivmsg(channel, text) {
+        if (!this.connected || !this.socket)
+            return;
+        const channelName = channel.startsWith('#') ? channel : `#${channel}`;
+        // IRC PRIVMSG has a ~512 byte line limit, but modern servers (Ergo) allow more.
+        // Split on newlines to avoid sending multiline as one IRC message.
+        const lines = text.split('\n');
+        for (const line of lines) {
+            if (line.length > 0) {
+                this.sendRawLine(`PRIVMSG ${channelName} :${line}`);
+            }
+        }
+    }
+    // ── Private: keepalive ───────────────────────────────────────────
+    startPingKeepalive() {
+        this.stopPingKeepalive();
+        this.pingTimer = setInterval(() => {
+            if (!this.connected || this.pendingPing)
+                return;
+            this.pendingPing = true;
+            this.sendRawLine('PING :calliope');
+            // If no PONG arrives within PING_TIMEOUT_MS, declare the connection dead
+            this.pongTimer = setTimeout(() => {
+                this.pongTimer = null;
+                this.pendingPing = false;
+                this.connected = false;
+                this.cleanupSocket();
+                this.scheduleReconnect();
+            }, ScuttlebotIRCClient.PING_TIMEOUT_MS);
+        }, ScuttlebotIRCClient.PING_INTERVAL_MS);
+    }
+    stopPingKeepalive() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        if (this.pongTimer) {
+            clearTimeout(this.pongTimer);
+            this.pongTimer = null;
+        }
+        this.pendingPing = false;
+    }
+    /**
+     * Register SIGINT/SIGTERM handlers so we send QUIT before the process exits.
+     * Uses a synchronous write — the OS TCP stack will flush it even if the
+     * event loop drains immediately afterward.
+     */
+    registerExitHandler() {
+        this.unregisterExitHandler();
+        this.exitHandler = () => {
+            if (this.socket && !this.socket.destroyed) {
+                try {
+                    this.socket.write('QUIT :Session ended\r\n');
+                }
+                catch { /* ignore */ }
+                try {
+                    this.socket.destroy();
+                }
+                catch { /* ignore */ }
+            }
+        };
+        process.once('SIGINT', this.exitHandler);
+        process.once('SIGTERM', this.exitHandler);
+    }
+    unregisterExitHandler() {
+        if (this.exitHandler) {
+            process.off('SIGINT', this.exitHandler);
+            process.off('SIGTERM', this.exitHandler);
+            this.exitHandler = null;
+        }
+    }
+    // ── Private: reconnection ────────────────────────────────────────
+    scheduleReconnect() {
+        if (!this.shouldReconnect || this.destroyed)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            if (!this.shouldReconnect || this.destroyed)
+                return;
+            this.buffer = '';
+            this.saslState = 'none';
+            this.createConnection();
+        }, this.reconnectDelay);
+        // Exponential backoff: 2s, 4s, 8s, 16s, 32s, 60s max
+        this.reconnectDelay = Math.min(this.reconnectDelay * 2, 60000);
+    }
+    cleanupSocket() {
+        if (this.socket) {
+            this.socket.removeAllListeners();
+            if (!this.socket.destroyed) {
+                this.socket.destroy();
+            }
+            this.socket = null;
+        }
+        this.connected = false;
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────────
+function parseHostPort(addr) {
+    const lastColon = addr.lastIndexOf(':');
+    if (lastColon === -1) {
+        return [addr, '6667'];
+    }
+    return [addr.slice(0, lastColon), addr.slice(lastColon + 1)];
+}
+/** Extract nick from an IRC prefix like "nick!user@host" or just "nick". */
+function extractNick(prefix) {
+    const bang = prefix.indexOf('!');
+    return bang === -1 ? prefix : prefix.slice(0, bang);
+}
+/**
+ * Parse a single IRC protocol line into prefix, command, and params.
+ * Handles the :prefix, trailing :param, and standard space-separated params.
+ */
+function parseIRCMessage(line) {
+    let idx = 0;
+    let prefix = '';
+    // Optional prefix
+    if (line[0] === ':') {
+        const spaceIdx = line.indexOf(' ', 1);
+        if (spaceIdx === -1)
+            return null;
+        prefix = line.slice(1, spaceIdx);
+        idx = spaceIdx + 1;
+    }
+    // Skip whitespace
+    while (idx < line.length && line[idx] === ' ')
+        idx++;
+    // Command
+    const cmdEnd = line.indexOf(' ', idx);
+    if (cmdEnd === -1) {
+        return { prefix, command: line.slice(idx).toUpperCase(), params: [] };
+    }
+    const command = line.slice(idx, cmdEnd).toUpperCase();
+    idx = cmdEnd + 1;
+    // Skip whitespace
+    while (idx < line.length && line[idx] === ' ')
+        idx++;
+    // Parameters
+    const params = [];
+    while (idx < line.length) {
+        if (line[idx] === ':') {
+            // Trailing parameter — rest of the line
+            params.push(line.slice(idx + 1));
+            break;
+        }
+        const nextSpace = line.indexOf(' ', idx);
+        if (nextSpace === -1) {
+            params.push(line.slice(idx));
+            break;
+        }
+        params.push(line.slice(idx, nextSpace));
+        idx = nextSpace + 1;
+        while (idx < line.length && line[idx] === ' ')
+            idx++;
+    }
+    return { prefix, command, params };
+}
+//# sourceMappingURL=irc-client.js.map

package/dist/scuttlebot/irc-client.js.map

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

package/dist/skills.d.ts

@@ -28,6 +28,25 @@ export interface SkillReference {
     path: string;
     content?: string;
 }
+/**
+ * Confirmation request shown to the user before a network skill is installed (#137).
+ */
+export interface SkillInstallConfirmation {
+    name: string;
+    source: 'registry' | 'github';
+    sourceUrl: string;
+    description: string;
+}
+/**
+ * Reject skill names that could escape SKILLS_DIR via path traversal (#136).
+ * Mirrors the plugin loader guard in plugins.ts.
+ */
+export declare function assertSafeSkillName(name: string): void;
+/**
+ * Register a confirmation handler invoked before installing a network skill (#137).
+ * Returning false aborts the install. Pass null to clear.
+ */
+export declare function setSkillInstallConfirmHandler(handler: ((info: SkillInstallConfirmation) => boolean | Promise<boolean>) | null): void;
 /**
  * Load a skill from a directory
  */

package/dist/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACvE;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsHD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAoB1D;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,KAAK,EAAE,CAenC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAWnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,EAAE,CAmBjE;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAmB3D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CA2C1E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CA+ClF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAepD;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAezC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhE"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACvE;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAItD;AAyBD;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,wBAAwB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GAC/E,IAAI,CAEN;AA8HD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAoB1D;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,KAAK,EAAE,CAqBnC;AAcD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAiBnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,EAAE,CAmBjE;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAqB3D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAqD1E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAyDlF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAepD;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAezC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhE"}