@framers/agentos 0.1.126 → 0.1.128

package/dist/memory/io/integration/StandaloneMemoryBridge.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Adapters that let the standalone SQLite-first `Memory`
+ * facade participate in AgentOS long-term memory flows.
+ *
+ * These bridges intentionally use the public `Memory` API so the same memory
+ * instance can power:
+ * - agent-editable memory tools
+ * - prompt-time long-term memory retrieval
+ * - rolling-summary persistence
+ *
+ * @module agentos/memory/integration/StandaloneMemoryBridge
+ */
+import type { ILongTermMemoryRetriever } from '../../../core/conversation/ILongTermMemoryRetriever.js';
+import type { IRollingSummaryMemorySink } from '../../../core/conversation/IRollingSummaryMemorySink.js';
+import type { Memory } from '../../io/facade/Memory.js';
+type RuntimeStandaloneMemory = Pick<Memory, 'remember' | 'forget'> & Partial<Pick<Memory, 'close'>>;
+type FeedbackCapableLongTermMemory = Pick<Memory, 'recall'> & Partial<Pick<Memory, 'feedbackFromResponse'>>;
+export interface StandaloneMemoryLongTermRetrieverOptions {
+    /**
+     * Fallback result limit for scopes that do not have an explicit cap.
+     * @default 4
+     */
+    defaultLimitPerScope?: number;
+    /**
+     * Conversation-scope cap. `topKByScope` only covers user/persona/org.
+     * @default 4
+     */
+    conversationLimit?: number;
+    /**
+     * Include markdown headings for each scope block in the returned context.
+     * @default true
+     */
+    includeScopeHeadings?: boolean;
+}
+export interface StandaloneMemoryRollingSummarySinkOptions {
+    /**
+     * Tags added to every persisted rolling-memory trace.
+     * @default ['agentos', 'long_term_memory']
+     */
+    baseTags?: string[];
+    /**
+     * Importance assigned to summary snapshot traces.
+     * @default 0.9
+     */
+    summaryImportance?: number;
+    /**
+     * Importance assigned to atomic `memory_json` item traces.
+     * @default 1.0
+     */
+    atomicDocImportance?: number;
+}
+export declare function buildStandaloneMemoryPersonaScopeId(userId: string, personaId: string): string;
+export declare function createStandaloneMemoryLongTermRetriever(memory: FeedbackCapableLongTermMemory, options?: StandaloneMemoryLongTermRetrieverOptions): ILongTermMemoryRetriever;
+export declare function createStandaloneMemoryRollingSummarySink(memory: RuntimeStandaloneMemory, options?: StandaloneMemoryRollingSummarySinkOptions): IRollingSummaryMemorySink;
+export {};
+//# sourceMappingURL=StandaloneMemoryBridge.d.ts.map

package/dist/memory/io/integration/StandaloneMemoryBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StandaloneMemoryBridge.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/integration/StandaloneMemoryBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAEV,wBAAwB,EAGzB,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,yDAAyD,CAAC;AAMjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAIxD,KAAK,uBAAuB,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC,GAChE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjC,KAAK,6BAA6B,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;AA4BhD,MAAM,WAAW,wCAAwC;IACvD;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,yCAAyC;IACxD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AA4CD,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7F;AAmGD,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,6BAA6B,EACrC,OAAO,CAAC,EAAE,wCAAwC,GACjD,wBAAwB,CAqH1B;AA4ID,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,yCAAyC,GAClD,yBAAyB,CA+F3B"}

package/dist/memory/io/integration/StandaloneMemoryBridge.js

@@ -0,0 +1,419 @@
+/**
+ * @fileoverview Adapters that let the standalone SQLite-first `Memory`
+ * facade participate in AgentOS long-term memory flows.
+ *
+ * These bridges intentionally use the public `Memory` API so the same memory
+ * instance can power:
+ * - agent-editable memory tools
+ * - prompt-time long-term memory retrieval
+ * - rolling-summary persistence
+ *
+ * @module agentos/memory/integration/StandaloneMemoryBridge
+ */
+import { DEFAULT_LONG_TERM_MEMORY_POLICY, } from '../../../core/conversation/LongTermMemoryPolicy.js';
+const DEFAULT_BASE_TAGS = ['agentos', 'long_term_memory'];
+const CATEGORY_ORDER = [
+    'facts',
+    'preferences',
+    'people',
+    'projects',
+    'decisions',
+    'open_loops',
+    'todo',
+    'tags',
+];
+function nonEmptyString(value) {
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+}
+function normalizeText(value) {
+    return nonEmptyString(value);
+}
+function formatPeopleEntry(person) {
+    if (typeof person !== 'object' || person === null)
+        return null;
+    const name = nonEmptyString(person.name);
+    const notes = nonEmptyString(person.notes);
+    if (!name)
+        return null;
+    return {
+        content: notes ? `Person: ${name}. ${notes}` : `Person: ${name}.`,
+        entities: [name],
+    };
+}
+function formatProjectEntry(project) {
+    if (typeof project !== 'object' || project === null)
+        return null;
+    const name = nonEmptyString(project.name);
+    const status = nonEmptyString(project.status);
+    const notes = nonEmptyString(project.notes);
+    if (!name)
+        return null;
+    const parts = [`Project: ${name}.`];
+    if (status)
+        parts.push(`Status: ${status}.`);
+    if (notes)
+        parts.push(notes);
+    return {
+        content: parts.join(' ').trim(),
+        entities: [name],
+    };
+}
+function unique(items) {
+    return Array.from(new Set(items));
+}
+export function buildStandaloneMemoryPersonaScopeId(userId, personaId) {
+    return `${userId}::${personaId}`;
+}
+function resolveScopeTargets(args) {
+    const targets = [];
+    const { userId, organizationId, conversationId, personaId, policy } = args;
+    if (policy.scopes.conversation && conversationId) {
+        targets.push({
+            key: `thread:${conversationId}`,
+            label: 'conversation',
+            memoryScope: 'thread',
+            scopeId: conversationId,
+        });
+    }
+    if (policy.scopes.persona && userId && personaId) {
+        targets.push({
+            key: `persona:${buildStandaloneMemoryPersonaScopeId(userId, personaId)}`,
+            label: 'persona',
+            memoryScope: 'persona',
+            scopeId: buildStandaloneMemoryPersonaScopeId(userId, personaId),
+        });
+    }
+    if (policy.scopes.user && userId) {
+        targets.push({
+            key: `user:${userId}`,
+            label: 'user',
+            memoryScope: 'user',
+            scopeId: userId,
+        });
+    }
+    if (policy.scopes.organization &&
+        policy.shareWithOrganization &&
+        organizationId) {
+        targets.push({
+            key: `organization:${organizationId}`,
+            label: 'organization',
+            memoryScope: 'organization',
+            scopeId: organizationId,
+        });
+    }
+    return targets;
+}
+function getScopeLimit(target, input, options) {
+    if (target.label === 'conversation') {
+        return options.conversationLimit;
+    }
+    if (target.label === 'user') {
+        return input.topKByScope?.user ?? options.defaultLimitPerScope;
+    }
+    if (target.label === 'persona') {
+        return input.topKByScope?.persona ?? options.defaultLimitPerScope;
+    }
+    if (target.label === 'organization') {
+        return input.topKByScope?.organization ?? options.defaultLimitPerScope;
+    }
+    return options.defaultLimitPerScope;
+}
+function trimContextText(text, maxContextChars) {
+    if (!maxContextChars || maxContextChars <= 0 || text.length <= maxContextChars) {
+        return { contextText: text, truncated: false };
+    }
+    const trimmed = text.slice(0, Math.max(0, maxContextChars - 1)).trimEnd();
+    return {
+        contextText: `${trimmed}…`,
+        truncated: true,
+    };
+}
+function renderScopeHeading(label) {
+    if (label === 'conversation')
+        return 'Conversation Memory';
+    if (label === 'persona')
+        return 'Persona Memory';
+    if (label === 'user')
+        return 'User Memory';
+    return 'Organization Memory';
+}
+export function createStandaloneMemoryLongTermRetriever(memory, options) {
+    const resolvedOptions = {
+        defaultLimitPerScope: options?.defaultLimitPerScope ?? 4,
+        conversationLimit: options?.conversationLimit ?? 4,
+        includeScopeHeadings: options?.includeScopeHeadings ?? true,
+    };
+    return {
+        async retrieveLongTermMemory(input) {
+            const policy = input.memoryPolicy ?? DEFAULT_LONG_TERM_MEMORY_POLICY;
+            const targets = resolveScopeTargets({
+                userId: input.userId,
+                organizationId: input.organizationId,
+                conversationId: input.conversationId,
+                personaId: input.personaId,
+                policy,
+            });
+            if (targets.length === 0) {
+                return null;
+            }
+            const scopeResults = [];
+            for (const target of targets) {
+                const recallOptions = {
+                    limit: getScopeLimit(target, input, resolvedOptions),
+                    scope: target.memoryScope,
+                    scopeId: target.scopeId,
+                };
+                const hits = await memory.recall(input.queryText, recallOptions);
+                if (hits.length > 0) {
+                    scopeResults.push({ target, hits });
+                }
+            }
+            if (scopeResults.length === 0) {
+                return null;
+            }
+            const seenContent = new Set();
+            const seenTraceIds = new Set();
+            const sections = [];
+            const selectedTraces = [];
+            const diagnostics = {
+                totalHits: 0,
+                queryText: input.queryText,
+                scopes: {},
+            };
+            for (const { target, hits } of scopeResults) {
+                const lines = [];
+                for (const hit of hits) {
+                    const content = normalizeText(hit.trace.content);
+                    if (!content)
+                        continue;
+                    if (seenContent.has(content))
+                        continue;
+                    seenContent.add(content);
+                    if (!seenTraceIds.has(hit.trace.id)) {
+                        seenTraceIds.add(hit.trace.id);
+                        selectedTraces.push(hit.trace);
+                    }
+                    lines.push(`- ${content}`);
+                }
+                if (lines.length === 0) {
+                    continue;
+                }
+                diagnostics.scopes[target.label] = lines.length;
+                diagnostics.totalHits = Number(diagnostics.totalHits) + lines.length;
+                if (resolvedOptions.includeScopeHeadings) {
+                    sections.push(`### ${renderScopeHeading(target.label)}`);
+                }
+                sections.push(...lines);
+            }
+            if (sections.length === 0) {
+                return null;
+            }
+            const rendered = sections.join('\n');
+            const { contextText, truncated } = trimContextText(rendered, input.maxContextChars);
+            diagnostics.truncated = truncated;
+            return {
+                contextText,
+                diagnostics,
+                feedbackPayload: selectedTraces.length > 0
+                    ? { traces: selectedTraces }
+                    : undefined,
+            };
+        },
+        async recordRetrievalFeedback(input) {
+            if (typeof memory.feedbackFromResponse !== 'function') {
+                return;
+            }
+            const traces = Array.isArray(input.feedbackPayload?.traces)
+                ? input.feedbackPayload.traces
+                : [];
+            if (!input.responseText.trim() || traces.length === 0) {
+                return;
+            }
+            await memory.feedbackFromResponse(traces, input.responseText, input.queryText);
+        },
+    };
+}
+function categoryAllowed(category, allowedCategories) {
+    if (allowedCategories === null)
+        return true;
+    return allowedCategories.includes(category);
+}
+function buildSummaryContent(update) {
+    return [
+        `Rolling summary for conversation ${update.conversationId} (persona ${update.personaId}).`,
+        update.summaryText.trim(),
+    ]
+        .filter(Boolean)
+        .join('\n\n');
+}
+function collectSummaryEntities(summaryJson) {
+    const entities = [];
+    if (!summaryJson || typeof summaryJson !== 'object') {
+        return entities;
+    }
+    if (Array.isArray(summaryJson.people)) {
+        for (const person of summaryJson.people) {
+            const name = nonEmptyString(person?.name);
+            if (name)
+                entities.push(name);
+        }
+    }
+    if (Array.isArray(summaryJson.projects)) {
+        for (const project of summaryJson.projects) {
+            const name = nonEmptyString(project?.name);
+            if (name)
+                entities.push(name);
+        }
+    }
+    return unique(entities);
+}
+function extractAtomicDocs(summaryJson, allowedCategories, baseTags) {
+    if (!summaryJson || typeof summaryJson !== 'object') {
+        return [];
+    }
+    const docs = [];
+    const pushDoc = (category, key, content, entities = []) => {
+        const normalized = normalizeText(content);
+        if (!normalized || !categoryAllowed(category, allowedCategories)) {
+            return;
+        }
+        docs.push({
+            key: `${category}:${key}`,
+            content: normalized,
+            tags: [...baseTags, 'rolling_memory_item', `category:${category}`],
+            entities: unique(entities),
+        });
+    };
+    if (Array.isArray(summaryJson.facts)) {
+        for (const item of summaryJson.facts) {
+            const text = normalizeText(item?.text);
+            pushDoc('facts', text ?? '', text ? `Fact: ${text}` : null);
+        }
+    }
+    if (Array.isArray(summaryJson.preferences)) {
+        for (const item of summaryJson.preferences) {
+            const text = normalizeText(item?.text);
+            pushDoc('preferences', text ?? '', text ? `Preference: ${text}` : null);
+        }
+    }
+    if (Array.isArray(summaryJson.people)) {
+        for (const person of summaryJson.people) {
+            const formatted = formatPeopleEntry(person);
+            pushDoc('people', formatted?.content ?? '', formatted?.content ?? null, formatted?.entities ?? []);
+        }
+    }
+    if (Array.isArray(summaryJson.projects)) {
+        for (const project of summaryJson.projects) {
+            const formatted = formatProjectEntry(project);
+            pushDoc('projects', formatted?.content ?? '', formatted?.content ?? null, formatted?.entities ?? []);
+        }
+    }
+    if (Array.isArray(summaryJson.decisions)) {
+        for (const item of summaryJson.decisions) {
+            const text = normalizeText(item?.text);
+            pushDoc('decisions', text ?? '', text ? `Decision: ${text}` : null);
+        }
+    }
+    if (Array.isArray(summaryJson.open_loops)) {
+        for (const item of summaryJson.open_loops) {
+            const text = normalizeText(item?.text);
+            pushDoc('open_loops', text ?? '', text ? `Open loop: ${text}` : null);
+        }
+    }
+    if (Array.isArray(summaryJson.todo)) {
+        for (const item of summaryJson.todo) {
+            const text = normalizeText(item?.text);
+            pushDoc('todo', text ?? '', text ? `Todo: ${text}` : null);
+        }
+    }
+    if (Array.isArray(summaryJson.tags) && categoryAllowed('tags', allowedCategories)) {
+        for (const tag of summaryJson.tags) {
+            const normalized = normalizeText(tag);
+            pushDoc('tags', normalized ?? '', normalized ? `Tag: ${normalized}` : null);
+        }
+    }
+    return docs;
+}
+export function createStandaloneMemoryRollingSummarySink(memory, options) {
+    const baseTags = unique(options?.baseTags ?? DEFAULT_BASE_TAGS);
+    const summaryImportance = options?.summaryImportance ?? 0.9;
+    const atomicDocImportance = options?.atomicDocImportance ?? 1.0;
+    const summaryTraceIds = new Map();
+    const atomicTraceIds = new Map();
+    const upsertDocsForScope = async (target, docs) => {
+        const next = new Map();
+        for (const doc of docs) {
+            const trace = await memory.remember(doc.content, {
+                type: 'semantic',
+                scope: target.memoryScope,
+                scopeId: target.scopeId,
+                tags: doc.tags,
+                entities: doc.entities,
+                importance: atomicDocImportance,
+            });
+            next.set(doc.key, trace.id);
+        }
+        const previous = atomicTraceIds.get(target.key);
+        if (previous) {
+            for (const [key, traceId] of previous.entries()) {
+                if (next.get(key) !== traceId) {
+                    await memory.forget(traceId);
+                }
+            }
+        }
+        atomicTraceIds.set(target.key, next);
+    };
+    return {
+        async upsertRollingSummaryMemory(update) {
+            const policy = update.memoryPolicy ?? DEFAULT_LONG_TERM_MEMORY_POLICY;
+            if (!policy.enabled) {
+                return;
+            }
+            const targets = resolveScopeTargets({
+                userId: update.userId,
+                organizationId: update.organizationId,
+                conversationId: update.conversationId,
+                personaId: update.personaId,
+                policy,
+            });
+            if (targets.length === 0) {
+                return;
+            }
+            const summaryTags = unique([
+                ...baseTags,
+                'rolling_summary',
+                ...(Array.isArray(update.summaryJson?.tags)
+                    ? update.summaryJson.tags
+                        .map((tag) => normalizeText(tag))
+                        .filter((tag) => Boolean(tag))
+                    : []),
+            ]);
+            const summaryEntities = collectSummaryEntities(update.summaryJson);
+            const summaryContent = buildSummaryContent(update);
+            const atomicDocs = policy.storeAtomicDocs === true
+                ? extractAtomicDocs(update.summaryJson, policy.allowedCategories, baseTags)
+                : [];
+            for (const target of targets) {
+                const summaryTrace = await memory.remember(summaryContent, {
+                    type: 'semantic',
+                    scope: target.memoryScope,
+                    scopeId: target.scopeId,
+                    tags: summaryTags,
+                    entities: summaryEntities,
+                    importance: summaryImportance,
+                });
+                const previousSummaryTraceId = summaryTraceIds.get(target.key);
+                if (previousSummaryTraceId &&
+                    previousSummaryTraceId !== summaryTrace.id) {
+                    await memory.forget(previousSummaryTraceId);
+                }
+                summaryTraceIds.set(target.key, summaryTrace.id);
+                await upsertDocsForScope(target, atomicDocs);
+            }
+        },
+    };
+}
+//# sourceMappingURL=StandaloneMemoryBridge.js.map

package/dist/memory/io/integration/StandaloneMemoryBridge.js.map

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

package/dist/memory/io/tools/MemoryAddTool.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @fileoverview MemoryAddTool — lets an agent store a new memory trace.
+ *
+ * The agent calls this tool to remember important facts, decisions, or
+ * observations. Each invocation inserts a fresh row into `memory_traces`
+ * with strength 1.0 (full encoding strength at creation time).
+ *
+ * ID format: `mt_<timestamp>_<counter>` — monotonically increasing within a
+ * process, collision-safe across typical agent interaction rates.
+ *
+ * @module memory/tools/MemoryAddTool
+ */
+import type { ITool, ToolExecutionResult, ToolExecutionContext, JSONSchemaObject } from '../../../core/tools/ITool.js';
+import type { SqliteBrain } from '../../retrieval/store/SqliteBrain.js';
+/**
+ * Input arguments for {@link MemoryAddTool}.
+ *
+ * @property content - The text content of the memory to store.
+ * @property type    - Tulving memory type (episodic, semantic, procedural, prospective). Defaults to 'episodic'.
+ * @property scope   - Visibility scope (thread, user, persona, organization). Defaults to 'user'.
+ * @property tags    - Optional array of free-form tag strings for filtering.
+ */
+export interface MemoryAddInput extends Record<string, any> {
+    content: string;
+    type?: string;
+    scope?: string;
+    tags?: string[];
+}
+/**
+ * Output returned by {@link MemoryAddTool} on success.
+ *
+ * @property traceId - The unique ID of the newly stored memory trace.
+ */
+export interface MemoryAddOutput {
+    traceId: string;
+}
+/**
+ * ITool implementation that stores a new memory trace in the agent's
+ * SQLite brain database.
+ *
+ * **Usage:**
+ * ```ts
+ * const tool = new MemoryAddTool(brain);
+ * const result = await tool.execute(
+ *   { content: 'User prefers dark mode.', tags: ['preference', 'ui'] },
+ *   context,
+ * );
+ * // result.output.traceId → 'mt_1711234567890_0'
+ * ```
+ */
+export declare class MemoryAddTool implements ITool<MemoryAddInput, MemoryAddOutput> {
+    private readonly brain;
+    /** Globally unique tool identifier. */
+    readonly id = "memory-add-v1";
+    /** LLM-facing tool name (snake_case, as the LLM will call it). */
+    readonly name = "memory_add";
+    /** Human-readable display name for UIs and logs. */
+    readonly displayName = "Add Memory";
+    /**
+     * Description shown to the LLM when deciding which tool to invoke.
+     * Must be comprehensive enough for the model to understand when to call this.
+     */
+    readonly description = "Store a new memory trace. The agent calls this to remember important facts, decisions, or observations.";
+    /** Logical category for discovery and grouping. */
+    readonly category = "memory";
+    /**
+     * This tool writes to the database.
+     * Callers may request confirmation before execution when `hasSideEffects = true`.
+     */
+    readonly hasSideEffects = true;
+    /**
+     * JSON schema for input validation and LLM tool-call construction.
+     * All optional fields default gracefully inside `execute()`.
+     */
+    readonly inputSchema: JSONSchemaObject;
+    /**
+     * @param brain - The agent's shared SQLite brain database connection.
+     */
+    constructor(brain: SqliteBrain);
+    /**
+     * Insert a new memory trace row into `memory_traces`.
+     *
+     * Defaults applied when optional fields are absent:
+     * - `type`  → `'episodic'`
+     * - `scope` → `'user'`
+     * - `tags`  → `[]`
+     *
+     * The trace is created with `strength = 1.0` (maximum encoding strength)
+     * and `deleted = 0` (active). No embedding is computed here — the background
+     * EmbeddingEncoder will embed it asynchronously.
+     *
+     * @param args    - Memory add input (content, optional type/scope/tags).
+     * @param context - Tool execution context used to resolve the scope ID.
+     * @returns `{ traceId }` on success, or an error result.
+     */
+    execute(args: MemoryAddInput, context: ToolExecutionContext): Promise<ToolExecutionResult<MemoryAddOutput>>;
+}
+//# sourceMappingURL=MemoryAddTool.d.ts.map

package/dist/memory/io/tools/MemoryAddTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryAddTool.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/tools/MemoryAddTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAexE;;;;;;;GAOG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,YAAW,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC;IA2D9D,OAAO,CAAC,QAAQ,CAAC,KAAK;IA1DlC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,mBAAmB;IAE9B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,oDAAoD;IACpD,QAAQ,CAAC,WAAW,gBAAgB;IAEpC;;;OAGG;IACH,QAAQ,CAAC,WAAW,6GACwF;IAE5G,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,YAAY;IAE7B;;;OAGG;IACH,QAAQ,CAAC,cAAc,QAAQ;IAE/B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAwBpC;IAEF;;OAEG;gBAC0B,KAAK,EAAE,WAAW;IAM/C;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CACX,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;CA0CjD"}