@0xmaxma/claude-gateway 1.0.0

package/dist/memory/manager.js

@@ -0,0 +1,178 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const p_queue_1 = __importDefault(require("p-queue"));
+const MEMORY_FILE = 'MEMORY.md';
+const DEFAULT_HEADER = '# Memory\n';
+class MemoryManager {
+    constructor(workspaceDir) {
+        this.memoryPath = path.join(workspaceDir, MEMORY_FILE);
+        this.queue = new p_queue_1.default({ concurrency: 1 });
+    }
+    /**
+     * Append a fact under the given section in memory.md.
+     * If the section exists, the fact is appended under it.
+     * If the section does not exist, it is created at the end of the file.
+     */
+    async appendFact(section, fact) {
+        await this.queue.add(async () => {
+            this._ensureFile();
+            const content = fs.readFileSync(this.memoryPath, 'utf-8');
+            const sectionHeader = `## ${section}`;
+            const factLine = `- ${fact}`;
+            if (content.includes(sectionHeader)) {
+                // Find the section and insert after it (before the next ## or end of file)
+                const lines = content.split('\n');
+                const sectionIdx = lines.findIndex((l) => l.trim() === sectionHeader);
+                // Find where this section ends (next ## header or EOF)
+                let insertIdx = lines.length;
+                for (let i = sectionIdx + 1; i < lines.length; i++) {
+                    if (lines[i].startsWith('## ')) {
+                        // Insert before the blank line(s) preceding the next section
+                        insertIdx = i;
+                        // Back up past any trailing blank lines
+                        while (insertIdx > sectionIdx + 1 && lines[insertIdx - 1].trim() === '') {
+                            insertIdx--;
+                        }
+                        break;
+                    }
+                }
+                lines.splice(insertIdx, 0, factLine);
+                const newContent = lines.join('\n');
+                fs.writeFileSync(this.memoryPath, newContent, 'utf-8');
+            }
+            else {
+                // Append new section at end of file
+                const trimmed = content.trimEnd();
+                const newContent = `${trimmed}\n\n${sectionHeader}\n${factLine}\n`;
+                fs.writeFileSync(this.memoryPath, newContent, 'utf-8');
+            }
+        });
+    }
+    /**
+     * Append raw markdown to memory.md.
+     */
+    async appendRaw(markdown) {
+        await this.queue.add(async () => {
+            this._ensureFile();
+            fs.appendFileSync(this.memoryPath, markdown, 'utf-8');
+        });
+    }
+    /**
+     * Read the full memory.md content.
+     */
+    async readMemory() {
+        this._ensureFile();
+        return fs.readFileSync(this.memoryPath, 'utf-8');
+    }
+    /**
+     * Search memory for a keyword (simple string match, case-insensitive).
+     * Returns all matching lines.
+     */
+    async searchMemory(query) {
+        this._ensureFile();
+        const content = fs.readFileSync(this.memoryPath, 'utf-8');
+        const lowerQuery = query.toLowerCase();
+        return content
+            .split('\n')
+            .filter((line) => line.toLowerCase().includes(lowerQuery));
+    }
+    /**
+     * Get memory stats: file size in bytes, line count, section count.
+     */
+    async getStats() {
+        this._ensureFile();
+        const content = fs.readFileSync(this.memoryPath, 'utf-8');
+        const stat = fs.statSync(this.memoryPath);
+        const lines = content.split('\n');
+        const sectionCount = lines.filter((l) => l.startsWith('## ')).length;
+        return {
+            sizeBytes: stat.size,
+            lineCount: lines.length,
+            sectionCount,
+        };
+    }
+    /**
+     * Trim memory.md to at most maxChars by removing oldest lines
+     * (lines from the top of the file, after the first # header line).
+     * Returns the number of lines removed.
+     */
+    async trimToSize(maxChars) {
+        return await this.queue.add(async () => {
+            this._ensureFile();
+            const content = fs.readFileSync(this.memoryPath, 'utf-8');
+            if (content.length <= maxChars) {
+                return { removed: 0 };
+            }
+            const lines = content.split('\n');
+            // Find the first non-header content line to start trimming from
+            // We preserve the # Memory header (first line)
+            let firstBodyLine = 1;
+            for (let i = 1; i < lines.length; i++) {
+                if (lines[i].trim() !== '' && !lines[i].startsWith('#')) {
+                    firstBodyLine = i;
+                    break;
+                }
+            }
+            let removed = 0;
+            let current = content;
+            while (current.length > maxChars && firstBodyLine < lines.length - 1) {
+                lines.splice(firstBodyLine, 1);
+                removed++;
+                current = lines.join('\n');
+            }
+            fs.writeFileSync(this.memoryPath, current, 'utf-8');
+            return { removed };
+        });
+    }
+    /**
+     * Ensure memory.md exists with a default header.
+     */
+    _ensureFile() {
+        if (!fs.existsSync(this.memoryPath)) {
+            const dir = path.dirname(this.memoryPath);
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(this.memoryPath, DEFAULT_HEADER, 'utf-8');
+        }
+    }
+}
+exports.MemoryManager = MemoryManager;
+//# sourceMappingURL=manager.js.map

package/dist/memory/manager.js.map

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

package/dist/session/compactor.d.ts

@@ -0,0 +1,22 @@
+import { SessionStore } from './store';
+export interface CompactionResult {
+    beforeMessages: number;
+    afterMessages: number;
+    beforeTokens: number;
+    afterTokens: number;
+    reductionPct: number;
+    contextPctBefore: number;
+    contextPctAfter: number;
+}
+export declare class NotEnoughMessagesError extends Error {
+    constructor(count: number);
+}
+export declare class SessionCompactor {
+    private readonly sessionStore;
+    constructor(sessionStore: SessionStore);
+    compact(agentId: string, chatId: string, sessionId: string, model: string, contextWindow: number, channel?: 'telegram' | 'discord' | 'api'): Promise<CompactionResult>;
+    private summarizeWithChunking;
+    private splitIntoChunks;
+    private callClaudeForSummary;
+}
+//# sourceMappingURL=compactor.d.ts.map

package/dist/session/compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../../src/session/compactor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,KAAK,EAAE,MAAM;CAI1B;AAqBD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAEjD,OAAO,CACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,UAAU,GAAG,SAAS,GAAG,KAAkB,GACnD,OAAO,CAAC,gBAAgB,CAAC;YA2Cd,qBAAqB;IA0BnC,OAAO,CAAC,eAAe;YAkBT,oBAAoB;CAwBnC"}

package/dist/session/compactor.js

@@ -0,0 +1,151 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionCompactor = exports.NotEnoughMessagesError = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+class NotEnoughMessagesError extends Error {
+    constructor(count) {
+        super(`Not enough messages to compact (${count} messages, minimum 5 required)`);
+        this.name = 'NotEnoughMessagesError';
+    }
+}
+exports.NotEnoughMessagesError = NotEnoughMessagesError;
+// Max characters per chunk sent to claude CLI (~100K chars ≈ ~25K tokens, well within 200K limit)
+const CHUNK_CHARS = 100000;
+// Number of recent messages to keep verbatim; older messages are summarized
+const KEEP_LAST_MESSAGES = 45;
+// Prompt used to merge multiple chunk summaries into one
+const MERGE_SUMMARIES_PROMPT = 'These are summaries of sequential parts of a conversation. Merge them into a single concise summary preserving key facts, decisions, context, and any open tasks.';
+// Default instruction for summarizing a single conversation or chunk
+const SINGLE_SUMMARY_INSTRUCTION = 'Summarize this conversation concisely, preserving key facts, decisions, context the assistant should remember, and any open questions or unfinished tasks.';
+// System prompt prepended to every claude CLI summarization call
+const COMPACTOR_SYSTEM_PROMPT = 'You are a conversation archiver. Your ONLY task is to produce a concise summary of the conversation transcript below. Do NOT respond to the conversation. Do NOT ask questions. Output ONLY the summary.';
+// Rough token estimate: ~4 chars per token
+function estimateTokens(messages) {
+    return Math.round(messages.reduce((acc, m) => acc + m.content.length, 0) / 4);
+}
+class SessionCompactor {
+    constructor(sessionStore) {
+        this.sessionStore = sessionStore;
+    }
+    async compact(agentId, chatId, sessionId, model, contextWindow, channel = 'telegram') {
+        // Load current history
+        const messages = await this.sessionStore.loadTelegramSession(agentId, chatId, sessionId, channel);
+        if (messages.length < 5) {
+            throw new NotEnoughMessagesError(messages.length);
+        }
+        const beforeMessages = messages.length;
+        const beforeTokens = estimateTokens(messages);
+        // Archive original before compaction
+        const agentsBaseDir = this.sessionStore.getAgentsBaseDir();
+        const sessionDir = path.join(agentsBaseDir, agentId, 'sessions', `${channel}-${chatId}`);
+        fs.mkdirSync(sessionDir, { recursive: true });
+        const archivePath = path.join(sessionDir, `${sessionId}.pre-compact-${Date.now()}.json`);
+        fs.writeFileSync(archivePath, JSON.stringify(messages, null, 2), 'utf-8');
+        // Keep last N messages verbatim; summarize only the older portion (or all if < N)
+        const tail = messages.slice(-KEEP_LAST_MESSAGES);
+        const toSummarize = messages.length > KEEP_LAST_MESSAGES ? messages.slice(0, -KEEP_LAST_MESSAGES) : messages;
+        const historyText = toSummarize
+            .map(m => `${m.role === 'user' ? 'User' : 'Assistant'}: ${m.content}`)
+            .join('\n\n');
+        const summaryText = await this.summarizeWithChunking(historyText);
+        const compacted = [
+            { role: 'system', content: `[Conversation Summary]\n${summaryText}`, ts: Date.now() },
+            ...tail,
+        ];
+        // Save compacted history (original already archived above)
+        await this.sessionStore.saveTelegramSession(agentId, chatId, sessionId, compacted, channel);
+        const afterMessages = compacted.length;
+        const afterTokens = estimateTokens(compacted);
+        const reductionPct = beforeTokens > 0 ? Math.max(0, Math.round((1 - afterTokens / beforeTokens) * 100)) : 0;
+        const contextPctBefore = Math.round((beforeTokens / contextWindow) * 100);
+        const contextPctAfter = Math.round((afterTokens / contextWindow) * 100);
+        return { beforeMessages, afterMessages, beforeTokens, afterTokens, reductionPct, contextPctBefore, contextPctAfter };
+    }
+    async summarizeWithChunking(historyText) {
+        // If small enough, summarize directly
+        if (historyText.length <= CHUNK_CHARS) {
+            return this.callClaudeForSummary(historyText);
+        }
+        // Split into chunks and summarize each
+        const chunks = this.splitIntoChunks(historyText, CHUNK_CHARS);
+        const chunkSummaries = [];
+        for (let i = 0; i < chunks.length; i++) {
+            const summary = await this.callClaudeForSummary(chunks[i], `This is part ${i + 1} of ${chunks.length} of a longer conversation. Summarize this segment concisely.`);
+            chunkSummaries.push(`[Part ${i + 1}/${chunks.length}]\n${summary}`);
+        }
+        // Merge chunk summaries into final summary
+        const mergedText = chunkSummaries.join('\n\n');
+        return this.callClaudeForSummary(mergedText, MERGE_SUMMARIES_PROMPT);
+    }
+    splitIntoChunks(text, maxChars) {
+        const chunks = [];
+        let start = 0;
+        while (start < text.length) {
+            let end = start + maxChars;
+            if (end < text.length) {
+                // Break at a newline boundary to avoid splitting mid-message
+                const boundary = text.lastIndexOf('\n\n', end);
+                if (boundary > start)
+                    end = boundary;
+            }
+            chunks.push(text.slice(start, end));
+            start = end;
+        }
+        return chunks;
+    }
+    async callClaudeForSummary(text, instruction = SINGLE_SUMMARY_INSTRUCTION) {
+        // Wrap content in XML tags so claude treats it as data to analyze, not an active conversation
+        const prompt = `${COMPACTOR_SYSTEM_PROMPT}\n\n${instruction}\n\n<transcript>\n${text}\n</transcript>\n\nWrite a concise summary of the above transcript now:`;
+        const result = (0, child_process_1.spawnSync)('claude', ['--print'], {
+            input: prompt,
+            encoding: 'utf-8',
+            timeout: 300000,
+            env: process.env,
+        });
+        if (result.error) {
+            throw new Error(`claude CLI error: ${result.error.message}`);
+        }
+        if (result.status !== 0) {
+            const stderr = result.stderr?.trim() ?? '';
+            throw new Error(`claude CLI exited with status ${result.status}: ${stderr}`);
+        }
+        return result.stdout?.trim() ?? '';
+    }
+}
+exports.SessionCompactor = SessionCompactor;
+//# sourceMappingURL=compactor.js.map

package/dist/session/compactor.js.map

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

package/dist/session/process.d.ts

@@ -0,0 +1,76 @@
+import { EventEmitter } from 'events';
+import { AgentConfig, GatewayConfig } from '../types';
+import { SessionStore } from './store';
+export declare class SessionProcess extends EventEmitter {
+    readonly sessionId: string;
+    readonly chatId: string;
+    readonly source: 'telegram' | 'discord' | 'api';
+    private readonly sessionChannel;
+    lastActivityAt: number;
+    spawnContext: {
+        loadedAtSpawn: number;
+        archivedCount: number;
+        messageCountAtSpawn: number;
+    } | null;
+    private process;
+    private stopping;
+    private restartCount;
+    private restartRequested;
+    private _processing;
+    private _pendingRestart;
+    private restartWatcher;
+    private readonly sessionStore;
+    private readonly agentConfig;
+    private readonly gatewayConfig;
+    private readonly logger;
+    private readonly configPath;
+    private readonly restartSignalPath;
+    queryMode: boolean;
+    private _queryResolve?;
+    private _queryBuffer;
+    private _queryTimer?;
+    private _querySettled;
+    constructor(sessionId: string, source: 'telegram' | 'discord' | 'api', agentConfig: AgentConfig, gatewayConfig: GatewayConfig, sessionStore: SessionStore, chatId?: string);
+    /**
+     * Read model from config.json on disk so restarts pick up changes made after startup.
+     * Falls back to the cached agentConfig.claude.model if config can't be read.
+     */
+    private readFreshModel;
+    start(): Promise<void>;
+    /**
+     * Watch for a restart signal file written by the agent.
+     * When detected, kill the current Claude process — scheduleRestart() will
+     * re-spawn it with the latest model from config.json.
+     */
+    private setupRestartWatcher;
+    private buildInitialPrompt;
+    /**
+     * Read stdio MCP servers from Claude Code's user-scoped config (~/.claude/settings.json).
+     * Returns empty object if file doesn't exist, can't be parsed, or has no mcpServers.
+     */
+    private readUserScopedMcp;
+    /**
+     * Read stdio MCP servers from Claude Code's project-scoped config (~/.claude.json).
+     * Looks up projects[workspace].mcpServers for the agent's workspace path.
+     * Returns empty object if not found or on any error.
+     */
+    private readProjectScopedMcp;
+    private writeMcpConfig;
+    /** Find the first API key that has access to this agent (agents: '*' or includes agentId). */
+    private findApiKeyForAgent;
+    private buildArgs;
+    private static toStreamJsonTurn;
+    private spawnProcess;
+    private scheduleRestart;
+    sendMessage(text: string): void;
+    query(prompt: string, timeoutMs?: number): Promise<string>;
+    get isProcessing(): boolean;
+    setProcessing(active: boolean): void;
+    interrupt(): boolean;
+    markPendingRestart(): void;
+    touch(): void;
+    isIdle(idleMs: number): boolean;
+    isRunning(): boolean;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=process.d.ts.map

package/dist/session/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/session/process.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AASvC,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,cAAc,SAAc;IAC5B,YAAY,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAQ;IAC1G,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,SAAS,UAAS;IAClB,OAAO,CAAC,aAAa,CAAC,CAAyB;IAC/C,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,WAAW,CAAC,CAAgC;IACpD,OAAO,CAAC,aAAa,CAAS;gBAG5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,EACtC,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,YAAY,EAC1B,MAAM,CAAC,EAAE,MAAM;IAoBjB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAYhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;YAiCb,kBAAkB;IA2ChC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,cAAc;IAwDtB,8FAA8F;IAC9F,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,SAAS;IA6BjB,OAAO,CAAC,MAAM,CAAC,gBAAgB;YAOjB,YAAY;IA+S1B,OAAO,CAAC,eAAe;IAyBvB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAqB/B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB1D,IAAI,YAAY,IAAI,OAAO,CAA6B;IAExD,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAUpC,SAAS,IAAI,OAAO;IAOpB,kBAAkB,IAAI,IAAI;IAQ1B,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI/B,SAAS,IAAI,OAAO;IAId,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB5B"}