@iflow-mcp/jkheadley-instar 0.26.2

package/dist/knowledge/TreeGenerator.js

@@ -0,0 +1,527 @@
+/**
+ * TreeGenerator — Auto-generates self-knowledge tree from AGENT.md + config.
+ *
+ * Reads the agent's AGENT.md file and detected capabilities to produce
+ * the initial self-knowledge-tree.json. Not a template copy — structural
+ * analysis of what the agent actually has.
+ *
+ * On regeneration, uses managed/unmanaged merge strategy:
+ * - managed:true nodes are fully regenerated
+ * - managed:false nodes are preserved as-is
+ *
+ * Born from: PROP-XXX (Self-Knowledge Tree for Instar Agents)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+const TREE_FILENAME = 'self-knowledge-tree.json';
+export class TreeGenerator {
+    /**
+     * Generate a new tree config or merge with existing.
+     * If an existing tree has managed:false nodes, they are preserved.
+     */
+    generate(options) {
+        const existing = this.loadExisting(options.stateDir);
+        const agentMdContent = this.readAgentMd(options.projectDir);
+        const agentMdSections = this.parseAgentMdSections(agentMdContent);
+        const layers = this.buildLayers(options, agentMdSections);
+        // Merge: preserve managed:false nodes from existing tree
+        if (existing) {
+            this.mergeUnmanagedNodes(layers, existing.layers);
+        }
+        return {
+            version: '1.0',
+            agentName: options.agentName,
+            budget: {
+                maxLlmCalls: 10,
+                maxSeconds: 30,
+                model: 'haiku',
+            },
+            layers,
+            groundingQuestions: [
+                'What is most relevant about who I am for this context?',
+                'What have I learned that applies here?',
+                'What is my current state that matters?',
+            ],
+        };
+    }
+    /**
+     * Save tree config to state directory.
+     * Uses atomic write (temp + rename) for safety.
+     */
+    save(config, stateDir) {
+        const filePath = path.join(stateDir, TREE_FILENAME);
+        const tempPath = filePath + '.tmp';
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(tempPath, JSON.stringify(config, null, 2));
+        fs.renameSync(tempPath, filePath);
+    }
+    /**
+     * Load existing tree config from state directory.
+     */
+    loadExisting(stateDir) {
+        const filePath = path.join(stateDir, TREE_FILENAME);
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    readAgentMd(projectDir) {
+        const agentMdPath = path.join(projectDir, 'AGENT.md');
+        try {
+            return fs.readFileSync(agentMdPath, 'utf-8');
+        }
+        catch {
+            return '';
+        }
+    }
+    parseAgentMdSections(content) {
+        const sections = new Map();
+        const headings = content.match(/^#{1,3}\s+.+$/gm) ?? [];
+        const lower = content.toLowerCase();
+        // Check for common sections
+        const sectionNames = [
+            'values', 'voice', 'personality', 'identity', 'purpose',
+            'capabilities', 'tools', 'platforms', 'skills',
+            'relationships', 'people', 'connections',
+            'goals', 'growth', 'evolution', 'trajectory',
+            'lessons', 'learnings', 'experience',
+        ];
+        for (const name of sectionNames) {
+            sections.set(name, headings.some(h => h.toLowerCase().includes(name)) || lower.includes(name));
+        }
+        return sections;
+    }
+    buildLayers(options, sections) {
+        const layers = [];
+        // 1. Identity layer
+        layers.push(this.buildIdentityLayer(options, sections));
+        // 2. Experience layer
+        layers.push(this.buildExperienceLayer(options, sections));
+        // 3. Capabilities layer
+        layers.push(this.buildCapabilitiesLayer(options));
+        // 4. State layer
+        layers.push(this.buildStateLayer(options));
+        // 5. Evolution layer
+        layers.push(this.buildEvolutionLayer(options, sections));
+        return layers;
+    }
+    buildIdentityLayer(options, sections) {
+        const children = [
+            {
+                id: 'identity.core',
+                name: 'Core Identity',
+                alwaysInclude: true,
+                managed: true,
+                depth: 'shallow',
+                maxTokens: 500,
+                sensitivity: 'public',
+                sources: [{ type: 'file', path: 'AGENT.md' }],
+                description: 'Agent name, purpose, and core identity',
+            },
+        ];
+        if (sections.get('values')) {
+            children.push({
+                id: 'identity.values',
+                name: 'Values & Principles',
+                alwaysInclude: true,
+                managed: true,
+                depth: 'shallow',
+                maxTokens: 400,
+                sensitivity: 'public',
+                sources: [{ type: 'file_section', path: 'AGENT.md', section: 'Values' }],
+                description: 'Core values and operating principles',
+            });
+        }
+        // Soul.md — self-authored identity (Being layer)
+        if (sections.get('soul') || fs.existsSync(path.join(options.stateDir, 'soul.md'))) {
+            children.push({
+                id: 'identity.soul',
+                name: 'Soul — Self-Authored Identity',
+                alwaysInclude: false,
+                managed: true,
+                depth: 'medium',
+                maxTokens: 800,
+                sensitivity: 'internal',
+                sources: [{ type: 'file', path: 'soul.md' }],
+                description: 'Self-authored values, convictions, growth edges, and open questions. The agent\'s reflective identity.',
+            });
+        }
+        if (sections.get('voice') || sections.get('personality')) {
+            children.push({
+                id: 'identity.voice',
+                name: 'Voice & Personality',
+                alwaysInclude: false,
+                managed: true,
+                depth: 'medium',
+                maxTokens: 400,
+                sensitivity: 'public',
+                sources: [
+                    { type: 'file_section', path: 'AGENT.md', section: 'Voice' },
+                    ...(options.hasMemory
+                        ? [{ type: 'memory_search', query: 'voice personality style communication', topK: 3 }]
+                        : []),
+                ],
+                description: 'Communication style and personality traits',
+            });
+        }
+        if (sections.get('relationships') || sections.get('people')) {
+            children.push({
+                id: 'identity.relationships',
+                name: 'Relationships',
+                alwaysInclude: false,
+                managed: true,
+                depth: 'medium',
+                maxTokens: 500,
+                sensitivity: 'internal',
+                sources: [
+                    { type: 'state_file', key: 'relationships' },
+                ],
+                description: 'Known people and relationship context',
+            });
+        }
+        return {
+            id: 'identity',
+            name: 'Identity',
+            description: 'Who the agent is, values, voice, relationships',
+            children,
+        };
+    }
+    buildExperienceLayer(options, sections) {
+        const children = [];
+        if (options.hasMemory) {
+            children.push({
+                id: 'experience.lessons',
+                name: 'Lessons Learned',
+                alwaysInclude: false,
+                managed: true,
+                depth: 'deep',
+                maxTokens: 600,
+                sensitivity: 'internal',
+                sources: [
+                    { type: 'memory_search', query: 'lesson learned realization insight', topK: 5 },
+                ],
+                description: 'Key learnings and realizations from experience',
+            });
+        }
+        if (options.hasDecisionJournal) {
+            children.push({
+                id: 'experience.decisions',
+                name: 'Decision Patterns',
+                alwaysInclude: false,
+                managed: true,
+                depth: 'medium',
+                maxTokens: 500,
+                sensitivity: 'internal',
+                sources: [
+                    { type: 'decision_journal', query: 'decision pattern', limit: 10 },
+                ],
+                description: 'Patterns from past dispatch and decision-making',
+            });
+        }
+        if (options.hasKnowledge) {
+            children.push({
+                id: 'experience.knowledge',
+                name: 'Knowledge Base',
+                alwaysInclude: false,
+                managed: true,
+                depth: 'deep',
+                maxTokens: 500,
+                sensitivity: 'public',
+                sources: [
+                    { type: 'knowledge_search', query: '{query}', topK: 5 },
+                ],
+                description: 'Ingested external knowledge and research',
+            });
+        }
+        children.push({
+            id: 'experience.sessions',
+            name: 'Recent Sessions',
+            alwaysInclude: false,
+            managed: true,
+            depth: 'medium',
+            maxTokens: 400,
+            sensitivity: 'internal',
+            sources: [
+                { type: 'state_file', key: 'session-history' },
+            ],
+            description: 'Recent session context and work history',
+        });
+        return {
+            id: 'experience',
+            name: 'Experience',
+            description: 'What the agent has learned, knowledge, decisions',
+            children,
+        };
+    }
+    buildCapabilitiesLayer(options) {
+        const children = [
+            {
+                id: 'capabilities.platforms',
+                name: 'Platform Bindings',
+                alwaysInclude: true,
+                managed: true,
+                depth: 'shallow',
+                maxTokens: 300,
+                sensitivity: 'public',
+                sources: [
+                    { type: 'json_file', path: '.instar/config.json', fields: ['platforms', 'bindings'] },
+                ],
+                description: 'Connected platforms and communication channels',
+            },
+        ];
+        if (options.skills && options.skills.length > 0) {
+            children.push({
+                id: 'capabilities.skills',
+                name: 'Registered Skills',
+                alwaysInclude: false,
+                managed: true,
+                depth: 'shallow',
+                maxTokens: 400,
+                sensitivity: 'public',
+                sources: [
+                    { type: 'state_file', key: 'dispatches' },
+                ],
+                description: 'Available skills and dispatch capabilities',
+            });
+        }
+        children.push({
+            id: 'capabilities.tools',
+            name: 'Available Tools',
+            alwaysInclude: false,
+            managed: true,
+            depth: 'shallow',
+            maxTokens: 300,
+            sensitivity: 'public',
+            sources: [
+                { type: 'file_section', path: 'AGENT.md', section: 'Tools' },
+            ],
+            description: 'MCP servers, CLI tools, and external integrations',
+        });
+        children.push({
+            id: 'capabilities.secrets',
+            name: 'Secret Drop',
+            alwaysInclude: false,
+            managed: true,
+            depth: 'medium',
+            maxTokens: 500,
+            sensitivity: 'public',
+            sources: [
+                { type: 'memory_search', query: 'secret drop password credential token', topK: 3 },
+            ],
+            description: 'Secure secret collection — generate one-time, time-limited URLs for users to submit passwords, API keys, or tokens without exposing them in chat. Use POST /secrets/request to create a link, then share the tunnelUrl with the user. Never ask users to paste secrets in Telegram or chat.',
+        });
+        // Discovery framework — feature surfacing guidance
+        children.push({
+            id: 'capabilities.discovery',
+            name: 'Feature Discovery',
+            alwaysInclude: false,
+            managed: true,
+            depth: 'medium',
+            maxTokens: 600,
+            sensitivity: 'public',
+            sources: [
+                { type: 'probe', name: 'feature-discovery' },
+            ],
+            description: 'Opt-in feature discovery framework — what features exist, their discovery state, surfacing rules, and behavioral contract. Query when the user asks about capabilities or when contextually relevant features should be surfaced.',
+        });
+        if (options.hasDecisionJournal) {
+            children.push({
+                id: 'capabilities.edges',
+                name: 'Known Limitations',
+                alwaysInclude: false,
+                managed: true,
+                depth: 'medium',
+                maxTokens: 400,
+                sensitivity: 'internal',
+                sources: [
+                    { type: 'decision_journal', query: 'limitation edge constraint failure', limit: 5 },
+                ],
+                description: 'Known limitations and capability edges from experience',
+            });
+        }
+        return {
+            id: 'capabilities',
+            name: 'Capabilities',
+            description: 'What the agent can do, tools, platforms, limits',
+            children,
+        };
+    }
+    buildStateLayer(options) {
+        const children = [];
+        if (options.hasJobs) {
+            children.push({
+                id: 'state.active_jobs',
+                name: 'Active Jobs',
+                alwaysInclude: true,
+                managed: true,
+                depth: 'shallow',
+                maxTokens: 300,
+                sensitivity: 'internal',
+                sources: [
+                    { type: 'probe', name: 'active-jobs' },
+                ],
+                description: 'Currently running and scheduled jobs',
+            });
+        }
+        children.push({
+            id: 'state.session',
+            name: 'Current Session',
+            alwaysInclude: false,
+            managed: true,
+            depth: 'shallow',
+            maxTokens: 300,
+            sensitivity: 'internal',
+            sources: [
+                { type: 'probe', name: 'session-context' },
+            ],
+            description: 'Current session metadata and context',
+        });
+        children.push({
+            id: 'state.health',
+            name: 'System Health',
+            alwaysInclude: false,
+            managed: true,
+            depth: 'shallow',
+            maxTokens: 200,
+            sensitivity: 'internal',
+            sources: [
+                { type: 'probe', name: 'server-health' },
+            ],
+            description: 'Server health, process state, resource usage',
+        });
+        // Add platform-specific state nodes
+        for (const platform of options.platforms ?? []) {
+            children.push({
+                id: `state.${platform.toLowerCase()}`,
+                name: `${platform} State`,
+                alwaysInclude: false,
+                managed: true,
+                depth: 'shallow',
+                maxTokens: 200,
+                sensitivity: 'internal',
+                sources: [
+                    { type: 'probe', name: 'platform-activity', args: { platform } },
+                ],
+                description: `Recent activity and state for ${platform}`,
+            });
+        }
+        return {
+            id: 'state',
+            name: 'State',
+            description: 'Current operational state, running jobs, health',
+            children,
+        };
+    }
+    buildEvolutionLayer(options, sections) {
+        const children = [];
+        if (options.hasMemory || sections.get('goals') || sections.get('growth')) {
+            children.push({
+                id: 'evolution.growth_edges',
+                name: 'Growth Edges',
+                alwaysInclude: false,
+                managed: true,
+                depth: 'medium',
+                maxTokens: 500,
+                sensitivity: 'public',
+                sources: [
+                    ...(options.hasMemory
+                        ? [{ type: 'memory_search', query: 'growth improvement goal aspiration', topK: 5 }]
+                        : []),
+                    ...(sections.get('goals')
+                        ? [{ type: 'file_section', path: 'AGENT.md', section: 'Goals' }]
+                        : []),
+                ],
+                description: 'Current growth edges and improvement areas',
+            });
+        }
+        if (options.hasDecisionJournal) {
+            children.push({
+                id: 'evolution.dispatch_patterns',
+                name: 'Dispatch Patterns',
+                alwaysInclude: false,
+                managed: true,
+                depth: 'shallow',
+                maxTokens: 300,
+                sensitivity: 'internal',
+                sources: [
+                    { type: 'probe', name: 'dispatch-trends' },
+                ],
+                description: 'Trending dispatch patterns and acceptance rates',
+            });
+        }
+        if (options.hasAutonomyProfile) {
+            children.push({
+                id: 'evolution.autonomy',
+                name: 'Autonomy Level',
+                alwaysInclude: false,
+                managed: true,
+                depth: 'shallow',
+                maxTokens: 200,
+                sensitivity: 'public',
+                sources: [
+                    { type: 'probe', name: 'autonomy-level' },
+                ],
+                description: 'Current autonomy level and trajectory',
+            });
+        }
+        children.push({
+            id: 'evolution.pending',
+            name: 'Pending Work',
+            alwaysInclude: false,
+            managed: true,
+            depth: 'shallow',
+            maxTokens: 300,
+            sensitivity: 'internal',
+            sources: [
+                { type: 'state_file', key: 'pending-dispatches' },
+            ],
+            description: 'Queued actions and pending dispatches',
+        });
+        return {
+            id: 'evolution',
+            name: 'Evolution',
+            description: 'Growth trajectory, improvement patterns, goals',
+            children,
+        };
+    }
+    /**
+     * Merge unmanaged (agent-evolved) nodes from existing tree into regenerated layers.
+     */
+    mergeUnmanagedNodes(newLayers, existingLayers) {
+        for (const existingLayer of existingLayers) {
+            const newLayer = newLayers.find(l => l.id === existingLayer.id);
+            if (!newLayer) {
+                // Entire custom layer — preserve it
+                const preservedLayer = {
+                    ...existingLayer,
+                    children: existingLayer.children.filter(n => !n.managed),
+                };
+                if (preservedLayer.children.length > 0) {
+                    newLayers.push(preservedLayer);
+                }
+                continue;
+            }
+            // Preserve unmanaged nodes within existing layer
+            for (const existingNode of existingLayer.children) {
+                if (!existingNode.managed) {
+                    // Check for conflict: same ID in new layer
+                    const conflict = newLayer.children.findIndex(n => n.id === existingNode.id);
+                    if (conflict >= 0) {
+                        // Unmanaged wins — replace the managed node
+                        newLayer.children[conflict] = existingNode;
+                    }
+                    else {
+                        newLayer.children.push(existingNode);
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=TreeGenerator.js.map

package/dist/knowledge/TreeGenerator.js.map

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

package/dist/knowledge/TreeSynthesis.d.ts

@@ -0,0 +1,24 @@
+/**
+ * TreeSynthesis — Cross-layer narrative synthesis via Haiku.
+ *
+ * Takes fragments from multiple layers and synthesizes them into a coherent
+ * self-knowledge narrative. Handles token budgets, degraded mode (no LLM),
+ * and fragment validation.
+ *
+ * Born from: PROP-XXX (Self-Knowledge Tree for Instar Agents)
+ */
+import type { IntelligenceProvider } from '../core/types.js';
+import type { SelfKnowledgeFragment } from './types.js';
+export declare class TreeSynthesis {
+    private intelligence;
+    constructor(intelligence: IntelligenceProvider | null);
+    /**
+     * Synthesize fragments into a coherent narrative.
+     * Returns null if LLM unavailable (degraded mode).
+     */
+    synthesize(query: string, fragments: SelfKnowledgeFragment[], agentName: string): Promise<{
+        synthesis: string | null;
+        tokensUsed: number;
+    }>;
+}
+//# sourceMappingURL=TreeSynthesis.d.ts.map

package/dist/knowledge/TreeSynthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSynthesis.d.ts","sourceRoot":"","sources":["../../src/knowledge/TreeSynthesis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAKxD,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAA8B;gBAEtC,YAAY,EAAE,oBAAoB,GAAG,IAAI;IAIrD;;;OAGG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,qBAAqB,EAAE,EAClC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CA+C7D"}

package/dist/knowledge/TreeSynthesis.js

@@ -0,0 +1,61 @@
+/**
+ * TreeSynthesis — Cross-layer narrative synthesis via Haiku.
+ *
+ * Takes fragments from multiple layers and synthesizes them into a coherent
+ * self-knowledge narrative. Handles token budgets, degraded mode (no LLM),
+ * and fragment validation.
+ *
+ * Born from: PROP-XXX (Self-Knowledge Tree for Instar Agents)
+ */
+const MAX_SYNTHESIS_INPUT_CHARS = 8_000; // ~2K tokens
+const DEFAULT_MAX_SYNTHESIS_OUTPUT_TOKENS = 800;
+export class TreeSynthesis {
+    intelligence;
+    constructor(intelligence) {
+        this.intelligence = intelligence;
+    }
+    /**
+     * Synthesize fragments into a coherent narrative.
+     * Returns null if LLM unavailable (degraded mode).
+     */
+    async synthesize(query, fragments, agentName) {
+        if (!this.intelligence || fragments.length === 0) {
+            return { synthesis: null, tokensUsed: 0 };
+        }
+        // Build synthesis input from fragments
+        const fragmentTexts = fragments.map(f => {
+            const label = `[${f.nodeId}] (relevance: ${f.relevance.toFixed(2)})`;
+            return `${label}\n${f.content}`;
+        });
+        let input = fragmentTexts.join('\n\n---\n\n');
+        // Truncate input if too large
+        if (input.length > MAX_SYNTHESIS_INPUT_CHARS) {
+            input = input.slice(0, MAX_SYNTHESIS_INPUT_CHARS) + '\n[input truncated]';
+        }
+        const prompt = `You are synthesizing self-knowledge for an AI agent named "${agentName}".
+
+The agent asked: "${query}"
+
+Here are relevant knowledge fragments from the agent's self-knowledge tree:
+
+${input}
+
+Synthesize these fragments into a coherent, first-person narrative that directly answers the agent's query. Be concise and factual — only include information that is present in the fragments above. Do not invent or extrapolate beyond what the fragments contain.
+
+Write as if the agent is describing itself. Use "I" voice.`;
+        try {
+            const response = await this.intelligence.evaluate(prompt, {
+                model: 'fast',
+                maxTokens: DEFAULT_MAX_SYNTHESIS_OUTPUT_TOKENS,
+                temperature: 0.3,
+            });
+            // Rough token estimate for tracking
+            const tokensUsed = Math.ceil((prompt.length + response.length) / 4);
+            return { synthesis: response, tokensUsed };
+        }
+        catch {
+            return { synthesis: null, tokensUsed: 0 };
+        }
+    }
+}
+//# sourceMappingURL=TreeSynthesis.js.map

package/dist/knowledge/TreeSynthesis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSynthesis.js","sourceRoot":"","sources":["../../src/knowledge/TreeSynthesis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,yBAAyB,GAAG,KAAK,CAAC,CAAC,aAAa;AACtD,MAAM,mCAAmC,GAAG,GAAG,CAAC;AAEhD,MAAM,OAAO,aAAa;IAChB,YAAY,CAA8B;IAElD,YAAY,YAAyC;QACnD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CACd,KAAa,EACb,SAAkC,EAClC,SAAiB;QAEjB,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAC5C,CAAC;QAED,uCAAuC;QACvC,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,MAAM,iBAAiB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;YACrE,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,IAAI,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAE9C,8BAA8B;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;YAC7C,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,yBAAyB,CAAC,GAAG,qBAAqB,CAAC;QAC5E,CAAC;QAED,MAAM,MAAM,GAAG,8DAA8D,SAAS;;oBAEtE,KAAK;;;;EAIvB,KAAK;;;;2DAIoD,CAAC;QAExD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE;gBACxD,KAAK,EAAE,MAAM;gBACb,SAAS,EAAE,mCAAmC;gBAC9C,WAAW,EAAE,GAAG;aACjB,CAAC,CAAC;YAEH,oCAAoC;YACpC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAC1B,CAAC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CACtC,CAAC;YAEF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;CACF"}