@soleri/core 2.0.1 → 2.1.0

package/dist/facades/types.d.ts

@@ -32,8 +32,8 @@ export declare const facadeInputSchema: z.ZodObject<{
     op: z.ZodString;
     params: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
 }, "strip", z.ZodTypeAny, {
-    op: string;
     params: Record<string, unknown>;
+    op: string;
 }, {
     op: string;
     params?: Record<string, unknown> | undefined;

package/dist/index.d.ts

@@ -2,8 +2,13 @@ export type { IntelligenceEntry, IntelligenceBundle } from './intelligence/types
 export { loadIntelligenceData } from './intelligence/loader.js';
 export { Vault } from './vault/vault.js';
 export type { SearchResult, VaultStats, ProjectInfo, Memory, MemoryStats } from './vault/vault.js';
+export { tokenize, calculateTf, calculateTfIdf, cosineSimilarity, jaccardSimilarity, } from './text/similarity.js';
+export type { SparseVector } from './text/similarity.js';
+export { Curator } from './curator/curator.js';
+export type { EntryStatus, EntrySource, TagNormalizationResult, CanonicalTag, DuplicateCandidate, DuplicateDetectionResult, Contradiction, ContradictionStatus, GroomResult, GroomAllResult, ConsolidationOptions, ConsolidationResult, ChangelogEntry, HealthMetrics, HealthAuditResult, CuratorStatus, } from './curator/types.js';
 export { Brain } from './brain/brain.js';
-export type { ScoringWeights, ScoreBreakdown, RankedResult, SearchOptions, CaptureResult, BrainStats, QueryContext, } from './brain/brain.js';
+export { BrainIntelligence } from './brain/intelligence.js';
+export type { ScoringWeights, ScoreBreakdown, RankedResult, SearchOptions, CaptureResult, BrainStats, QueryContext, PatternStrength, StrengthsQuery, BrainSession, SessionLifecycleInput, KnowledgeProposal, ExtractionResult, GlobalPattern, DomainProfile, BuildIntelligenceResult, BrainIntelligenceStats, SessionContext, BrainExportData, BrainImportResult, } from './brain/types.js';
 export { CogneeClient } from './cognee/client.js';
 export type { CogneeConfig, CogneeSearchResult, CogneeSearchType, CogneeStatus, CogneeAddResult, CogneeCognifyResult, } from './cognee/types.js';
 export { Planner } from './planning/planner.js';
@@ -16,4 +21,9 @@ export type { KeyPoolFiles } from './llm/key-pool.js';
 export { registerFacade, registerAllFacades } from './facades/facade-factory.js';
 export { facadeInputSchema } from './facades/types.js';
 export type { OpHandler, AuthLevel, OpDefinition, FacadeConfig, FacadeResponse, FacadeInput, } from './facades/types.js';
+export { LLMClient } from './llm/llm-client.js';
+export { createAgentRuntime } from './runtime/runtime.js';
+export { createCoreOps } from './runtime/core-ops.js';
+export { createDomainFacade, createDomainFacades } from './runtime/domain-ops.js';
+export type { AgentRuntimeConfig, AgentRuntime } from './runtime/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGnG,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAG/F,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,SAAS,EACT,UAAU,EACV,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,KAAK,EACL,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,GACZ,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,8 +1,13 @@
 export { loadIntelligenceData } from './intelligence/loader.js';
 // ─── Vault ───────────────────────────────────────────────────────────
 export { Vault } from './vault/vault.js';
+// ─── Text Utilities ─────────────────────────────────────────────────
+export { tokenize, calculateTf, calculateTfIdf, cosineSimilarity, jaccardSimilarity, } from './text/similarity.js';
+// ─── Curator ────────────────────────────────────────────────────────
+export { Curator } from './curator/curator.js';
 // ─── Brain ───────────────────────────────────────────────────────────
 export { Brain } from './brain/brain.js';
+export { BrainIntelligence } from './brain/intelligence.js';
 // ─── Cognee ─────────────────────────────────────────────────────────
 export { CogneeClient } from './cognee/client.js';
 // ─── Planning ────────────────────────────────────────────────────────
@@ -16,4 +21,10 @@ export { KeyPool, loadKeyPoolConfig } from './llm/key-pool.js';
 // ─── Facades ─────────────────────────────────────────────────────────
 export { registerFacade, registerAllFacades } from './facades/facade-factory.js';
 export { facadeInputSchema } from './facades/types.js';
+// ─── LLM Client ─────────────────────────────────────────────────────
+export { LLMClient } from './llm/llm-client.js';
+// ─── Runtime Factory ────────────────────────────────────────────────
+export { createAgentRuntime } from './runtime/runtime.js';
+export { createCoreOps } from './runtime/core-ops.js';
+export { createDomainFacade, createDomainFacades } from './runtime/domain-ops.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,wEAAwE;AACxE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,wEAAwE;AACxE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAWzC,uEAAuE;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUlD,wEAAwE;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,wEAAwE;AACxE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAexD,wEAAwE;AACxE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,KAAK,EACL,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,uEAAuE;AACvE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG/D,wEAAwE;AACxE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,wEAAwE;AACxE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,uEAAuE;AACvE,OAAO,EACL,QAAQ,EACR,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,uEAAuE;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAoB/C,wEAAwE;AACxE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAwB5D,uEAAuE;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUlD,wEAAwE;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,wEAAwE;AACxE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAexD,wEAAwE;AACxE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,KAAK,EACL,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,uEAAuE;AACvE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG/D,wEAAwE;AACxE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAUvD,uEAAuE;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,uEAAuE;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/llm/llm-client.d.ts

@@ -0,0 +1,28 @@
+/**
+ * LLM Client — Unified OpenAI/Anthropic caller with key pool rotation,
+ * circuit breaker, retry, and model routing.
+ *
+ * Anthropic SDK is loaded via dynamic import on first use, keeping it
+ * an optional peer dependency.
+ */
+import type { LLMCallOptions, LLMCallResult, RouteEntry } from './types.js';
+import type { KeyPool } from './key-pool.js';
+export declare class LLMClient {
+    private openaiKeyPool;
+    private anthropicKeyPool;
+    private anthropicClient;
+    private anthropicBreaker;
+    private anthropicKeyFingerprint;
+    private router;
+    constructor(openaiKeyPool: KeyPool, anthropicKeyPool: KeyPool, agentId?: string);
+    complete(options: LLMCallOptions): Promise<LLMCallResult>;
+    isAvailable(): {
+        openai: boolean;
+        anthropic: boolean;
+    };
+    getRoutes(): RouteEntry[];
+    private callOpenAI;
+    private callAnthropic;
+    private getAnthropicClient;
+}
+//# sourceMappingURL=llm-client.d.ts.map

package/dist/llm/llm-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../../src/llm/llm-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AAC3F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AA+G7C,qBAAa,SAAS;IACpB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,gBAAgB,CAAiB;IACzC,OAAO,CAAC,uBAAuB,CAAc;IAC7C,OAAO,CAAC,MAAM,CAAc;gBAEhB,aAAa,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM;IAWzE,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAS/D,WAAW,IAAI;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;IAOtD,SAAS,IAAI,UAAU,EAAE;YAQX,UAAU;YAwEV,aAAa;YA2Cb,kBAAkB;CA0BjC"}

package/dist/llm/llm-client.js

@@ -0,0 +1,226 @@
+/**
+ * LLM Client — Unified OpenAI/Anthropic caller with key pool rotation,
+ * circuit breaker, retry, and model routing.
+ *
+ * Anthropic SDK is loaded via dynamic import on first use, keeping it
+ * an optional peer dependency.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+import { LLMError } from './types.js';
+import { CircuitBreaker, retry, parseRateLimitHeaders } from './utils.js';
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const OPENAI_API_URL = 'https://api.openai.com/v1/chat/completions';
+// =============================================================================
+// MODEL ROUTER
+// =============================================================================
+function loadRoutingConfig(agentId) {
+    const defaultConfig = {
+        routes: [],
+        defaultOpenAIModel: 'gpt-4o-mini',
+        defaultAnthropicModel: 'claude-sonnet-4-20250514',
+    };
+    const configPath = path.join(homedir(), `.${agentId}`, 'model-routing.json');
+    try {
+        if (fs.existsSync(configPath)) {
+            const data = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            if (data.routes && Array.isArray(data.routes)) {
+                defaultConfig.routes = data.routes;
+            }
+            if (data.defaultOpenAIModel) {
+                defaultConfig.defaultOpenAIModel = data.defaultOpenAIModel;
+            }
+            if (data.defaultAnthropicModel) {
+                defaultConfig.defaultAnthropicModel = data.defaultAnthropicModel;
+            }
+        }
+    }
+    catch {
+        // Config not available — use defaults
+    }
+    return defaultConfig;
+}
+function inferProvider(model) {
+    if (model.startsWith('claude-') || model.startsWith('anthropic/')) {
+        return 'anthropic';
+    }
+    return 'openai';
+}
+class ModelRouter {
+    config;
+    constructor(config) {
+        this.config = config ?? {
+            routes: [],
+            defaultOpenAIModel: 'gpt-4o-mini',
+            defaultAnthropicModel: 'claude-sonnet-4-20250514',
+        };
+    }
+    resolve(caller, task, originalModel) {
+        if (task) {
+            const exactMatch = this.config.routes.find((r) => r.caller === caller && r.task === task);
+            if (exactMatch) {
+                return { model: exactMatch.model, provider: exactMatch.provider };
+            }
+        }
+        const callerMatch = this.config.routes.find((r) => r.caller === caller && !r.task);
+        if (callerMatch) {
+            return { model: callerMatch.model, provider: callerMatch.provider };
+        }
+        if (originalModel) {
+            const provider = inferProvider(originalModel);
+            return { model: originalModel, provider };
+        }
+        return { model: this.config.defaultOpenAIModel, provider: 'openai' };
+    }
+    getRoutes() {
+        return [...this.config.routes];
+    }
+}
+export class LLMClient {
+    openaiKeyPool;
+    anthropicKeyPool;
+    anthropicClient = null;
+    anthropicBreaker;
+    anthropicKeyFingerprint = '';
+    router;
+    constructor(openaiKeyPool, anthropicKeyPool, agentId) {
+        this.openaiKeyPool = openaiKeyPool;
+        this.anthropicKeyPool = anthropicKeyPool;
+        this.anthropicBreaker = new CircuitBreaker({
+            name: 'llm-anthropic',
+            failureThreshold: 5,
+            resetTimeoutMs: 60_000,
+        });
+        this.router = new ModelRouter(agentId ? loadRoutingConfig(agentId) : undefined);
+    }
+    async complete(options) {
+        const routed = this.router.resolve(options.caller, options.task, options.model);
+        const resolvedOptions = { ...options, model: routed.model, provider: routed.provider };
+        return resolvedOptions.provider === 'anthropic'
+            ? this.callAnthropic(resolvedOptions)
+            : this.callOpenAI(resolvedOptions);
+    }
+    isAvailable() {
+        return {
+            openai: this.openaiKeyPool.hasKeys,
+            anthropic: this.anthropicKeyPool.hasKeys,
+        };
+    }
+    getRoutes() {
+        return this.router.getRoutes();
+    }
+    // ===========================================================================
+    // OPENAI
+    // ===========================================================================
+    async callOpenAI(options) {
+        const keyPool = this.openaiKeyPool.hasKeys ? this.openaiKeyPool : null;
+        if (!keyPool) {
+            throw new LLMError('OpenAI API key not configured', { retryable: false });
+        }
+        const start = Date.now();
+        const doRequest = async () => {
+            const apiKey = keyPool.getActiveKey().expose();
+            const keyIndex = keyPool.activeKeyIndex;
+            const response = await fetch(OPENAI_API_URL, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: options.model,
+                    messages: [
+                        { role: 'system', content: options.systemPrompt },
+                        { role: 'user', content: options.userPrompt },
+                    ],
+                    temperature: options.temperature ?? 0.3,
+                    max_completion_tokens: options.maxTokens ?? 500,
+                }),
+            });
+            if (response.headers) {
+                const rateLimits = parseRateLimitHeaders(response.headers);
+                if (rateLimits.remaining !== null) {
+                    keyPool.updateQuota(keyIndex, rateLimits.remaining);
+                    keyPool.rotatePreemptive();
+                }
+            }
+            if (!response.ok) {
+                if (response.status === 429 && keyPool.poolSize > 1) {
+                    keyPool.rotateOnError();
+                }
+                const errorBody = await response.text();
+                throw new LLMError(`OpenAI API error: ${response.status} - ${errorBody}`, {
+                    retryable: response.status === 429 || response.status >= 500,
+                    statusCode: response.status,
+                });
+            }
+            const data = (await response.json());
+            return {
+                text: data.choices[0]?.message?.content || '',
+                model: options.model,
+                provider: 'openai',
+                inputTokens: data.usage?.prompt_tokens,
+                outputTokens: data.usage?.completion_tokens,
+                durationMs: Date.now() - start,
+            };
+        };
+        return retry(doRequest, { maxAttempts: 3 });
+    }
+    // ===========================================================================
+    // ANTHROPIC
+    // ===========================================================================
+    async callAnthropic(options) {
+        const client = await this.getAnthropicClient();
+        if (!client) {
+            throw new LLMError('Anthropic API key not configured', { retryable: false });
+        }
+        const start = Date.now();
+        return this.anthropicBreaker.call(() => retry(async () => {
+            const response = await client.messages.create({
+                model: options.model,
+                max_tokens: options.maxTokens ?? 1024,
+                system: options.systemPrompt,
+                messages: [{ role: 'user', content: options.userPrompt }],
+            }, { timeout: 60_000 });
+            const text = response.content
+                .filter((block) => block.type === 'text' && typeof block.text === 'string')
+                .map((block) => block.text)
+                .join('\n');
+            return {
+                text,
+                model: options.model,
+                provider: 'anthropic',
+                inputTokens: response.usage?.input_tokens,
+                outputTokens: response.usage?.output_tokens,
+                durationMs: Date.now() - start,
+            };
+        }, { maxAttempts: 2 }));
+    }
+    async getAnthropicClient() {
+        if (!this.anthropicKeyPool.hasKeys)
+            return null;
+        const currentKey = this.anthropicKeyPool.getActiveKey().expose();
+        const currentFingerprint = currentKey.slice(-8);
+        if (currentFingerprint !== this.anthropicKeyFingerprint) {
+            this.anthropicClient = null;
+            this.anthropicKeyFingerprint = currentFingerprint;
+        }
+        if (this.anthropicClient)
+            return this.anthropicClient;
+        try {
+            // Dynamic import — @anthropic-ai/sdk is an optional peer dep.
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const mod = await Function('return import("@anthropic-ai/sdk")')();
+            this.anthropicClient = new mod.default({ apiKey: currentKey });
+            return this.anthropicClient;
+        }
+        catch {
+            // SDK not installed — Anthropic provider unavailable
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=llm-client.js.map

package/dist/llm/llm-client.js.map

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

package/dist/runtime/core-ops.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Generic core operations factory — 37 ops that every agent gets.
+ *
+ * These ops are agent-agnostic (no persona, no activation).
+ * The 5 agent-specific ops (health, identity, activate, inject_claude_md, setup)
+ * stay in generated code because they reference agent-specific modules.
+ */
+import type { OpDefinition } from '../facades/types.js';
+import type { AgentRuntime } from './types.js';
+/**
+ * Create the 37 generic core operations for an agent runtime.
+ *
+ * Groups: search/vault (4), memory (4), export (1), planning (5),
+ *         brain (4), brain intelligence (11), curator (8).
+ */
+export declare function createCoreOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=core-ops.d.ts.map

package/dist/runtime/core-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/core-ops.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CA2nBnE"}