@soulcraft/sdk 1.6.2 → 2.0.0

package/dist/server/handlers/search.js

@@ -0,0 +1,237 @@
+/**
+ * @module server/handlers/search
+ * @description Search namespace handler — semantic vector search, unified search with
+ * rich results, and file content highlighting.
+ *
+ * Absorbs Workshop `routes/search.ts`. Uses Brainy's `brain.find()` for semantic
+ * vector search and `brain.highlight()` for in-file content matching.
+ *
+ * Methods:
+ * - `query` — Simple semantic search returning entity matches
+ * - `unified` — Rich search with type grouping, scope filtering, and context
+ * - `highlight` — Find text + semantic matches within a specific file
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Constants
+// ─────────────────────────────────────────────────────────────────────────────
+/** Icon mapping for entity types in unified search results. */
+const TYPE_ICONS = {
+    file: '\u{1F4C4}', folder: '\u{1F4C1}', concept: '\u{1F4A1}',
+    person: '\u{1F464}', organization: '\u{1F3E2}', location: '\u{1F4CD}',
+    event: '\u{1F4C5}', project: '\u{1F3AF}', task: '\u2705',
+    document: '\u{1F4D1}', idea: '\u{1F4AD}', note: '\u{1F4DD}',
+    topic: '\u{1F3F7}\uFE0F', technology: '\u2699\uFE0F', skill: '\u{1F3AF}',
+    tool: '\u{1F527}', product: '\u{1F4E6}', conversation: '\u{1F4AC}',
+    default: '\u25C6',
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Handler factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates the `search` namespace handler.
+ *
+ * @returns A {@link NamespaceProvider} implementing {@link SearchNamespace}.
+ */
+export function createSearchHandler() {
+    return {
+        /**
+         * Simple semantic search.
+         *
+         * @param query - Search query string.
+         * @param options - Search options.
+         * @param ctx - Handler context.
+         * @returns Array of search results with scores.
+         */
+        async query(query, options, ctx) {
+            const { brain } = ctx;
+            const limit = options?.limit ?? 50;
+            const results = await brain.find({ query, limit });
+            const mapped = results.map((r) => ({
+                id: r.id,
+                name: r.data || r.metadata?.name || r.metadata?.label || r.id,
+                type: r.type || r.metadata?.noun || 'concept',
+                score: r.score ?? 0,
+            }));
+            return { query, results: mapped, total: mapped.length };
+        },
+        /**
+         * Unified rich search for Command Palette and advanced search UIs.
+         *
+         * Combines semantic search with post-filters for scope, collection membership,
+         * type, date range, and graph connectivity.
+         *
+         * @param query - Search query string.
+         * @param options - Unified search options.
+         * @param ctx - Handler context.
+         * @returns Rich results grouped by type with context and preview.
+         */
+        async unified(query, options, ctx) {
+            const { brain } = ctx;
+            const limit = options?.limit ?? 50;
+            const scope = options?.scope ?? 'all';
+            const collectionId = options?.collectionId;
+            const typeFilters = options?.types ?? [];
+            const dateFrom = options?.dateFrom;
+            const dateTo = options?.dateTo;
+            const connectedTo = options?.connectedTo;
+            let results = [];
+            const queryTrimmed = query.trim();
+            if (queryTrimmed.length >= 1) {
+                // Determine if we have post-filters requiring over-fetch
+                const hasPostFilters = (scope === 'collection' && collectionId) ||
+                    connectedTo || dateFrom || dateTo || typeFilters.length > 0;
+                const findOptions = {
+                    query: queryTrimmed,
+                    limit: hasPostFilters ? limit * 3 : limit,
+                };
+                if (scope === 'collection')
+                    findOptions.excludeVFS = true;
+                // Pre-fetch collection member IDs
+                let collectionMemberIds = null;
+                if (scope === 'collection' && collectionId) {
+                    try {
+                        const relations = await brain.getRelations({ from: collectionId, type: 'contains' });
+                        collectionMemberIds = new Set(relations.map((r) => r.to));
+                    }
+                    catch {
+                        collectionMemberIds = new Set();
+                    }
+                }
+                // Pre-fetch connected entity IDs
+                let connectedToIds = null;
+                if (connectedTo) {
+                    try {
+                        const outgoing = await brain.getRelations({ from: connectedTo });
+                        const incoming = await brain.getRelations({ to: connectedTo });
+                        connectedToIds = new Set([
+                            ...outgoing.map((r) => r.to),
+                            ...incoming.map((r) => r.from),
+                        ]);
+                    }
+                    catch {
+                        connectedToIds = new Set();
+                    }
+                }
+                const semanticResults = await brain.find(findOptions);
+                // Post-filter
+                for (const result of semanticResults) {
+                    const metadata = result.metadata || {};
+                    const entityType = (result.type || metadata.noun || '').toLowerCase();
+                    const vfsType = (metadata.vfsType || '').toLowerCase();
+                    const isVFS = metadata.isVFS || metadata.isVFSEntity || !!vfsType;
+                    if (scope === 'files' && !isVFS)
+                        continue;
+                    if (scope === 'collection' && collectionMemberIds && !collectionMemberIds.has(result.id))
+                        continue;
+                    if (typeFilters.length > 0 && !typeFilters.includes(entityType))
+                        continue;
+                    if (connectedToIds && !connectedToIds.has(result.id))
+                        continue;
+                    if (dateFrom || dateTo) {
+                        const createdAt = metadata.createdAt || result.createdAt;
+                        if (createdAt) {
+                            const ts = new Date(createdAt).getTime();
+                            if (dateFrom && ts < new Date(dateFrom).getTime())
+                                continue;
+                            if (dateTo && ts > new Date(dateTo).getTime())
+                                continue;
+                        }
+                    }
+                    results.push({ ...result, score: result.score || 0.5 });
+                }
+                results.sort((a, b) => b.score - a.score);
+                results = results.slice(0, limit);
+            }
+            // Normalize scores relative to the top result
+            const topScore = results.length > 0 ? Math.max(...results.map((r) => r.score || 0)) : 1;
+            const scoreScale = topScore > 0 ? 1 / topScore : 1;
+            // Transform to rich format
+            const richResults = results.map((result) => {
+                const metadata = result.metadata || {};
+                const entityType = (result.type || '').toLowerCase();
+                const vfsType = (metadata.vfsType || '').toLowerCase();
+                const isVFS = metadata.isVFS || metadata.isVFSEntity || !!vfsType;
+                const isFile = vfsType === 'file' || (isVFS && entityType === 'document') || entityType === 'file';
+                const isFolder = vfsType === 'directory' || vfsType === 'folder' || entityType === 'folder';
+                let name = metadata.name || metadata.label || metadata.title || result.id;
+                if (typeof name === 'object')
+                    name = name.name || name.label || result.id;
+                if (name === result.id && result.data && typeof result.data === 'string')
+                    name = result.data;
+                let displayType = entityType || 'concept';
+                if (isFile)
+                    displayType = 'file';
+                if (isFolder)
+                    displayType = 'folder';
+                if (metadata._aiDataType)
+                    displayType = metadata._aiDataType;
+                return {
+                    id: result.id,
+                    name: String(name),
+                    type: displayType,
+                    icon: TYPE_ICONS[displayType] || TYPE_ICONS.default,
+                    score: result.score,
+                    scorePercent: Math.round((result.score || 0) * scoreScale * 100),
+                    context: {
+                        path: metadata.path || undefined,
+                        connectionCount: (!isFile && !isFolder) ? metadata.connections : undefined,
+                        subtitle: metadata.subtitle || metadata.description?.slice(0, 100),
+                    },
+                    preview: isFile && (metadata.content || metadata.description || result.data)
+                        ? String(metadata.content || metadata.description || result.data).slice(0, 200).replace(/\n/g, ' ').trim()
+                        : undefined,
+                };
+            });
+            // Group by type
+            const groups = {
+                files: richResults.filter(r => r.type === 'file'),
+                folders: richResults.filter(r => r.type === 'folder'),
+                concepts: richResults.filter(r => ['concept', 'idea', 'topic', 'note'].includes(r.type)),
+                people: richResults.filter(r => r.type === 'person'),
+                organizations: richResults.filter(r => r.type === 'organization'),
+                locations: richResults.filter(r => r.type === 'location'),
+                other: richResults.filter(r => !['file', 'folder', 'concept', 'idea', 'topic', 'note', 'person', 'organization', 'location'].includes(r.type)),
+            };
+            return { query, scope, results: richResults, groups, total: richResults.length };
+        },
+        /**
+         * Highlight search matches within a specific file's content.
+         *
+         * @param query - Search query.
+         * @param filePath - VFS path to the file.
+         * @param options - Highlight options.
+         * @param ctx - Handler context.
+         * @returns Array of highlight positions with scores.
+         */
+        async highlight(query, filePath, options, ctx) {
+            const { brain } = ctx;
+            const granularity = options?.granularity ?? 'word';
+            if (!query.trim() || !filePath.trim()) {
+                return { query, path: filePath, highlights: [], total: 0 };
+            }
+            // Read file content from VFS
+            let fileContent;
+            try {
+                fileContent = await brain.vfs.readFile(filePath);
+            }
+            catch {
+                return { query, path: filePath, highlights: [], total: 0 };
+            }
+            const highlightParams = { query: query.trim(), text: fileContent, granularity };
+            const highlights = await brain.highlight(highlightParams);
+            return {
+                query,
+                path: filePath,
+                highlights: highlights.map((h) => ({
+                    text: h.text,
+                    score: h.score,
+                    position: h.position,
+                    matchType: h.matchType,
+                    contentCategory: h.contentCategory || undefined,
+                })),
+                total: highlights.length,
+            };
+        },
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/server/handlers/search.js.map

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

package/dist/server/handlers/session.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @module server/handlers/session
+ * @description Session namespace handler — collaborative session lifecycle for
+ * Living Links (join, leave, state, history).
+ *
+ * Absorbs Workshop `routes/session.ts`. Sessions are persisted as Brainy
+ * entities (NounType.Collection with sessionType metadata). Each session tracks
+ * participants, start/end times, and an inactivity timer that auto-closes
+ * after 30 minutes.
+ *
+ * Methods:
+ * - `join` — Join or create a collaborative session
+ * - `leave` — Record a participant leaving
+ * - `getState` — Get the current session state
+ * - `getHistory` — Get past sessions for a Living Link
+ */
+import type { NamespaceProvider } from '../namespace-router.js';
+/**
+ * Event emitter interface for broadcasting session state changes.
+ *
+ * Products inject their own emitter — Workshop uses `dataChangeEmitter`,
+ * Venue might use a WebSocket broadcast.
+ */
+export interface SessionEventEmitter {
+    /** Emit a session lifecycle event. */
+    emit(event: string, data: Record<string, unknown>): void;
+}
+/**
+ * Options for {@link createSessionHandler}.
+ */
+export interface SessionHandlerOptions {
+    /** Event emitter for broadcasting session changes. */
+    events?: SessionEventEmitter;
+    /**
+     * Inactivity timeout in milliseconds before a session is auto-closed.
+     * Default: 30 minutes (1,800,000 ms).
+     */
+    inactivityMs?: number;
+}
+/**
+ * Creates the `session` namespace handler.
+ *
+ * @param options - Optional session handler configuration.
+ * @returns A {@link NamespaceProvider} implementing {@link SessionNamespace}.
+ */
+export declare function createSessionHandler(options?: SessionHandlerOptions): NamespaceProvider;
+//# sourceMappingURL=session.d.ts.map

package/dist/server/handlers/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,wBAAwB,CAAA;AAyB/E;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAE5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAkID;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,iBAAiB,CAiMvF"}

package/dist/server/handlers/session.js

@@ -0,0 +1,286 @@
+/**
+ * @module server/handlers/session
+ * @description Session namespace handler — collaborative session lifecycle for
+ * Living Links (join, leave, state, history).
+ *
+ * Absorbs Workshop `routes/session.ts`. Sessions are persisted as Brainy
+ * entities (NounType.Collection with sessionType metadata). Each session tracks
+ * participants, start/end times, and an inactivity timer that auto-closes
+ * after 30 minutes.
+ *
+ * Methods:
+ * - `join` — Join or create a collaborative session
+ * - `leave` — Record a participant leaving
+ * - `getState` — Get the current session state
+ * - `getHistory` — Get past sessions for a Living Link
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Inactivity timer management
+// ─────────────────────────────────────────────────────────────────────────────
+/** Per-session inactivity timers. Key: sessionId. */
+const inactivityTimers = new Map();
+/**
+ * Reset or start the inactivity timer for a session.
+ *
+ * @param sessionId - The session entity ID.
+ * @param brain - Brainy instance for closing the session on timeout.
+ * @param timeoutMs - Inactivity timeout in milliseconds.
+ * @param events - Optional event emitter for broadcasting closure.
+ */
+function resetInactivityTimer(sessionId, brain, timeoutMs, events) {
+    const existing = inactivityTimers.get(sessionId);
+    if (existing)
+        clearTimeout(existing);
+    const timer = setTimeout(async () => {
+        inactivityTimers.delete(sessionId);
+        try {
+            await brain.update(sessionId, {
+                metadata: {
+                    endedAt: new Date().toISOString(),
+                    sessionStatus: 'closed',
+                },
+            });
+            events?.emit('session_closed', { sessionId, reason: 'inactivity' });
+        }
+        catch (err) {
+            console.error('[session] Failed to auto-close session:', err);
+        }
+    }, timeoutMs);
+    inactivityTimers.set(sessionId, timer);
+}
+/**
+ * Cancel any pending inactivity timer.
+ *
+ * @param sessionId - The session entity ID.
+ */
+function cancelInactivityTimer(sessionId) {
+    const existing = inactivityTimers.get(sessionId);
+    if (existing) {
+        clearTimeout(existing);
+        inactivityTimers.delete(sessionId);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Find the currently active session for a given scope (e.g., Living Link slug).
+ *
+ * Sessions are Collection entities with `sessionType: 'collaborative-session'`
+ * and `sessionStatus: 'active'`.
+ *
+ * @param brain - Brainy instance.
+ * @param scope - The scope identifier (Living Link slug or session group).
+ * @returns The active session entity, or `null` if none found.
+ */
+async function findActiveSession(brain, scope) {
+    try {
+        const results = await brain.find({
+            where: { type: 'Collection' },
+            limit: 100,
+        });
+        for (const entity of results) {
+            const meta = entity.metadata || {};
+            if (meta.sessionType === 'collaborative-session' &&
+                meta.sessionStatus === 'active' &&
+                (meta.livingLinkSlug === scope || entity.id === scope)) {
+                return entity;
+            }
+        }
+    }
+    catch {
+        // No sessions found
+    }
+    return null;
+}
+/**
+ * Find all collaborative sessions for a scope (both active and closed).
+ *
+ * @param brain - Brainy instance.
+ * @param scope - The scope identifier.
+ * @returns Array of session entities, newest first.
+ */
+async function findAllSessions(brain, scope) {
+    try {
+        const results = await brain.find({
+            where: { type: 'Collection' },
+            limit: 500,
+        });
+        return results
+            .filter((entity) => {
+            const meta = entity.metadata || {};
+            return (meta.sessionType === 'collaborative-session' &&
+                (meta.livingLinkSlug === scope || entity.id === scope));
+        })
+            .sort((a, b) => {
+            const aTime = new Date(a.metadata?.startedAt || 0).getTime();
+            const bTime = new Date(b.metadata?.startedAt || 0).getTime();
+            return bTime - aTime; // newest first
+        });
+    }
+    catch {
+        return [];
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Handler factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates the `session` namespace handler.
+ *
+ * @param options - Optional session handler configuration.
+ * @returns A {@link NamespaceProvider} implementing {@link SessionNamespace}.
+ */
+export function createSessionHandler(options) {
+    const events = options?.events;
+    const inactivityMs = options?.inactivityMs ?? 30 * 60 * 1000;
+    return {
+        /**
+         * Join a collaborative session.
+         *
+         * Creates a new session if none is currently active for the given scope.
+         * Otherwise, adds the current user as a participant. Resets the inactivity
+         * timer on every join.
+         *
+         * @param sessionId - Session scope (Living Link slug or session group ID).
+         * @param joinOptions - Join options.
+         * @param ctx - Handler context.
+         * @returns The current session state.
+         */
+        async join(sessionId, joinOptions, ctx) {
+            const { brain } = ctx;
+            const displayName = joinOptions?.displayName || ctx.user.name || 'Anonymous';
+            const peerId = ctx.user.id;
+            const participant = {
+                peerId,
+                displayName,
+                joinedAt: new Date().toISOString(),
+            };
+            let activeSession = await findActiveSession(brain, sessionId);
+            if (!activeSession) {
+                // Create a new session entity
+                const newId = await brain.add({
+                    type: 'collection',
+                    data: `Session — ${sessionId} — ${new Date().toLocaleDateString()}`,
+                    metadata: {
+                        name: `Session — ${sessionId}`,
+                        sessionType: 'collaborative-session',
+                        livingLinkSlug: sessionId,
+                        startedAt: new Date().toISOString(),
+                        endedAt: null,
+                        sessionStatus: 'active',
+                        participants: [participant],
+                    },
+                });
+                activeSession = await brain.get(newId);
+                events?.emit('session_created', {
+                    sessionId: newId,
+                    scope: sessionId,
+                    userId: ctx.user.id,
+                });
+            }
+            else {
+                // Add participant if not already present
+                const meta = activeSession.metadata || {};
+                const participants = meta.participants ?? [];
+                const alreadyPresent = participants.some((p) => p.peerId === peerId && !p.leftAt);
+                if (!alreadyPresent) {
+                    participants.push(participant);
+                    await brain.update({ id: activeSession.id, metadata: { participants } });
+                }
+                events?.emit('session_participant_joined', {
+                    sessionId: activeSession.id,
+                    participant: { displayName, peerId },
+                });
+            }
+            // Reset inactivity timer
+            resetInactivityTimer(activeSession.id, brain, inactivityMs, events);
+            // Build response
+            const meta = activeSession.metadata || {};
+            const participants = meta.participants ?? [];
+            const activeParticipants = participants.filter((p) => !p.leftAt);
+            return {
+                sessionId: activeSession.id,
+                participants: activeParticipants.map((p) => ({
+                    userId: p.peerId,
+                    name: p.displayName,
+                    joinedAt: p.joinedAt,
+                })),
+                createdAt: meta.startedAt || new Date().toISOString(),
+            };
+        },
+        /**
+         * Leave a collaborative session.
+         *
+         * Records `leftAt` on the participant entry and resets the inactivity timer.
+         *
+         * @param sessionId - Session scope (Living Link slug or session group ID).
+         * @param ctx - Handler context.
+         */
+        async leave(sessionId, ctx) {
+            const { brain } = ctx;
+            const peerId = ctx.user.id;
+            const now = new Date().toISOString();
+            const activeSession = await findActiveSession(brain, sessionId);
+            if (!activeSession)
+                return;
+            const meta = activeSession.metadata || {};
+            const participants = meta.participants ?? [];
+            // Mark this peer as left
+            const updated = participants.map((p) => p.peerId === peerId && !p.leftAt ? { ...p, leftAt: now } : p);
+            await brain.update({ id: activeSession.id, metadata: { participants: updated } });
+            events?.emit('session_participant_left', {
+                sessionId: activeSession.id,
+                peerId,
+            });
+            // Reset inactivity timer (departures count as activity)
+            resetInactivityTimer(activeSession.id, brain, inactivityMs, events);
+        },
+        /**
+         * Get the current state of a session.
+         *
+         * @param sessionId - Session scope (Living Link slug or session ID).
+         * @param ctx - Handler context.
+         * @returns Session state, or `null` if no active session exists.
+         */
+        async getState(sessionId, ctx) {
+            const activeSession = await findActiveSession(ctx.brain, sessionId);
+            if (!activeSession)
+                return null;
+            const meta = activeSession.metadata || {};
+            const participants = meta.participants ?? [];
+            const activeParticipants = participants.filter((p) => !p.leftAt);
+            return {
+                sessionId: activeSession.id,
+                participants: activeParticipants.map((p) => ({
+                    userId: p.peerId,
+                    name: p.displayName,
+                    joinedAt: p.joinedAt,
+                })),
+                createdAt: meta.startedAt || '',
+            };
+        },
+        /**
+         * Get the history of past sessions.
+         *
+         * @param historyOptions - Pagination options.
+         * @param ctx - Handler context.
+         * @returns Array of past session summaries.
+         */
+        async getHistory(historyOptions, ctx) {
+            const limit = historyOptions?.limit ?? 20;
+            const sessions = await findAllSessions(ctx.brain, ctx.workspaceId);
+            return sessions.slice(0, limit).map((session) => {
+                const meta = session.metadata || {};
+                const participants = meta.participants ?? [];
+                return {
+                    sessionId: session.id,
+                    startedAt: meta.startedAt || '',
+                    endedAt: meta.endedAt || '',
+                    participantCount: participants.length,
+                };
+            });
+        },
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/server/handlers/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/server/handlers/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoDH,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF,qDAAqD;AACrD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAyC,CAAA;AAEzE;;;;;;;GAOG;AACH,SAAS,oBAAoB,CAC3B,SAAiB,EACjB,KAAU,EACV,SAAiB,EACjB,MAA4B;IAE5B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAChD,IAAI,QAAQ;QAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;IAEpC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;QAClC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAClC,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE;gBAC5B,QAAQ,EAAE;oBACR,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACjC,aAAa,EAAE,QAAQ;iBACxB;aACF,CAAC,CAAA;YACF,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAA;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC,EAAE,SAAS,CAAC,CAAA;IAEb,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;AACxC,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,SAAiB;IAC9C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAChD,IAAI,QAAQ,EAAE,CAAC;QACb,YAAY,CAAC,QAAQ,CAAC,CAAA;QACtB,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACpC,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,KAAK,UAAU,iBAAiB,CAAC,KAAU,EAAE,KAAa;IACxD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC;YAC/B,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;YAC7B,KAAK,EAAE,GAAG;SACX,CAAC,CAAA;QAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAA;YAClC,IACE,IAAI,CAAC,WAAW,KAAK,uBAAuB;gBAC5C,IAAI,CAAC,aAAa,KAAK,QAAQ;gBAC/B,CAAC,IAAI,CAAC,cAAc,KAAK,KAAK,IAAI,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,EACtD,CAAC;gBACD,OAAO,MAAM,CAAA;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;IACtB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,eAAe,CAAC,KAAU,EAAE,KAAa;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC;YAC/B,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;YAC7B,KAAK,EAAE,GAAG;SACX,CAAC,CAAA;QAEF,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,MAAW,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAA;YAClC,OAAO,CACL,IAAI,CAAC,WAAW,KAAK,uBAAuB;gBAC5C,CAAC,IAAI,CAAC,cAAc,KAAK,KAAK,IAAI,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,CACvD,CAAA;QACH,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE;YACvB,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;YAC5D,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;YAC5D,OAAO,KAAK,GAAG,KAAK,CAAA,CAAC,eAAe;QACtC,CAAC,CAAC,CAAA;IACN,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAA;IAC9B,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IAE5D,OAAO;QACL;;;;;;;;;;;WAWG;QACH,KAAK,CAAC,IAAI,CACR,SAAiB,EACjB,WAAiD,EACjD,GAAmB;YAEnB,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAA;YACrB,MAAM,WAAW,GAAG,WAAW,EAAE,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW,CAAA;YAC5E,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAA;YAE1B,MAAM,WAAW,GAAuB;gBACtC,MAAM;gBACN,WAAW;gBACX,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACnC,CAAA;YAED,IAAI,aAAa,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YAE7D,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,8BAA8B;gBAC9B,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC;oBAC5B,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,aAAa,SAAS,MAAM,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,EAAE;oBACnE,QAAQ,EAAE;wBACR,IAAI,EAAE,aAAa,SAAS,EAAE;wBAC9B,WAAW,EAAE,uBAAuB;wBACpC,cAAc,EAAE,SAAS;wBACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,OAAO,EAAE,IAAI;wBACb,aAAa,EAAE,QAAQ;wBACvB,YAAY,EAAE,CAAC,WAAW,CAAC;qBAC5B;iBACF,CAAC,CAAA;gBAEF,aAAa,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;gBACtC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE;oBAC9B,SAAS,EAAE,KAAK;oBAChB,KAAK,EAAE,SAAS;oBAChB,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE;iBACpB,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,yCAAyC;gBACzC,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,IAAI,EAAE,CAAA;gBACzC,MAAM,YAAY,GAAyB,IAAI,CAAC,YAAY,IAAI,EAAE,CAAA;gBAClE,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,CACtC,CAAC,CAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM,CAC5D,CAAA;gBAED,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpB,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;oBAC9B,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,EAAE,CAAC,CAAA;gBAC1E,CAAC;gBAED,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE;oBACzC,SAAS,EAAE,aAAa,CAAC,EAAE;oBAC3B,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE;iBACrC,CAAC,CAAA;YACJ,CAAC;YAED,yBAAyB;YACzB,oBAAoB,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;YAEnE,iBAAiB;YACjB,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,IAAI,EAAE,CAAA;YACzC,MAAM,YAAY,GAAyB,IAAI,CAAC,YAAY,IAAI,EAAE,CAAA;YAClE,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;YAEpF,OAAO;gBACL,SAAS,EAAE,aAAa,CAAC,EAAE;gBAC3B,YAAY,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAqB,EAAE,EAAE,CAAC,CAAC;oBAC/D,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,IAAI,EAAE,CAAC,CAAC,WAAW;oBACnB,QAAQ,EAAE,CAAC,CAAC,QAAQ;iBACrB,CAAC,CAAC;gBACH,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtD,CAAA;QACH,CAAC;QAED;;;;;;;WAOG;QACH,KAAK,CAAC,KAAK,CACT,SAAiB,EACjB,GAAmB;YAEnB,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAA;YACrB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAA;YAC1B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;YAEpC,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YAC/D,IAAI,CAAC,aAAa;gBAAE,OAAM;YAE1B,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,IAAI,EAAE,CAAA;YACzC,MAAM,YAAY,GAAyB,IAAI,CAAC,YAAY,IAAI,EAAE,CAAA;YAElE,yBAAyB;YACzB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAqB,EAAE,EAAE,CACzD,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAC7D,CAAA;YAED,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC,CAAA;YAEjF,MAAM,EAAE,IAAI,CAAC,0BAA0B,EAAE;gBACvC,SAAS,EAAE,aAAa,CAAC,EAAE;gBAC3B,MAAM;aACP,CAAC,CAAA;YAEF,wDAAwD;YACxD,oBAAoB,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;QACrE,CAAC;QAED;;;;;;WAMG;QACH,KAAK,CAAC,QAAQ,CACZ,SAAiB,EACjB,GAAmB;YAEnB,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YACnE,IAAI,CAAC,aAAa;gBAAE,OAAO,IAAI,CAAA;YAE/B,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,IAAI,EAAE,CAAA;YACzC,MAAM,YAAY,GAAyB,IAAI,CAAC,YAAY,IAAI,EAAE,CAAA;YAClE,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;YAEpF,OAAO;gBACL,SAAS,EAAE,aAAa,CAAC,EAAE;gBAC3B,YAAY,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAqB,EAAE,EAAE,CAAC,CAAC;oBAC/D,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,IAAI,EAAE,CAAC,CAAC,WAAW;oBACnB,QAAQ,EAAE,CAAC,CAAC,QAAQ;iBACrB,CAAC,CAAC;gBACH,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;aAChC,CAAA;QACH,CAAC;QAED;;;;;;WAMG;QACH,KAAK,CAAC,UAAU,CACd,cAA8C,EAC9C,GAAmB;YAOnB,MAAM,KAAK,GAAG,cAAc,EAAE,KAAK,IAAI,EAAE,CAAA;YACzC,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;YAElE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,OAAY,EAAE,EAAE;gBACnD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAA;gBACnC,MAAM,YAAY,GAAyB,IAAI,CAAC,YAAY,IAAI,EAAE,CAAA;gBAElE,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,EAAE;oBACrB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;oBAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;oBAC3B,gBAAgB,EAAE,YAAY,CAAC,MAAM;iBACtC,CAAA;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}