@xenosystem/agent-interface-host 0.1.3

package/dist/session/runtimeEventChannel.d.ts

@@ -0,0 +1,56 @@
+import { type AgentRuntimeEventEnvelope } from '@xenosystem/agent-interface-contract';
+import type { SessionProtocolChannel } from './AgentSessionService.js';
+/**
+ * Makes an `acp` session renderable from the stream that already exists.
+ *
+ * 🔴 **This is the answer to a blocker that was recorded WRONG.**
+ *
+ * The session opener was built and reverted because `AgentSessionService.open`
+ * refuses an `acp` session without a `SessionProtocolChannel`, and the note left
+ * behind said the missing piece was *"the outbound framed half, which no adapter
+ * hands to the host"*. Tracing it found two things wrong with that sentence.
+ *
+ * The half that matters is **inbound** — what the agent says, which is what an
+ * `acp` session renders. And it is not missing at all: `AcpRuntimeEventMapper`
+ * already turns every ACP session update into a runtime event, which the host
+ * already publishes as `runtime.event.appended`. The stream was there the whole
+ * time; nothing had adapted it into the shape the session substrate consumes.
+ *
+ * **Why this stream and not the raw ACP frames.** Feeding
+ * `AcpProcessSupervisor.prompt`'s `onUpdate` straight in was the obvious move
+ * and it is the wrong one:
+ *
+ * - Those frames have not been through `assertRuntimeEventForHost`. Rendering
+ *   them into a terminal a person is watching is a redaction bypass, and the
+ *   redaction exists because these messages carry secrets.
+ * - They are not persisted, so a terminal fed from them could not be resumed
+ *   while the structured view beside it could — the same run disagreeing with
+ *   itself depending on which pane you looked at.
+ * - `onUpdate` is scoped to ONE prompt; a session spans a whole run. Stitching
+ *   turns together would have re-invented the fan-out this bus already is.
+ *
+ * One stream, already redacted, already durable. The terminal becomes a
+ * rendering of the run rather than a second opinion about it.
+ */
+export interface RuntimeEventSessionChannelOptions {
+    /** The run whose events belong in this session. */
+    runId: string;
+    /**
+     * Every runtime event the host publishes, unfiltered.
+     *
+     * A port: the host owns publication, and taking a subscribe function rather
+     * than the host keeps this testable without one.
+     */
+    subscribe: (listener: (event: AgentRuntimeEventEnvelope) => void) => () => void;
+    /**
+     * Which run an event belongs to.
+     *
+     * Injected for exactly one reason: a composition that overrides the host's
+     * `resolveRunId` must be able to override this too, or a session would filter
+     * by a rule the host does not route by. The default is the SHARED
+     * `defaultRunIdOf`, so out of the box they cannot disagree.
+     */
+    runIdOf?: (event: AgentRuntimeEventEnvelope) => string;
+}
+export declare function createRuntimeEventSessionChannel(options: RuntimeEventSessionChannelOptions): SessionProtocolChannel;
+//# sourceMappingURL=runtimeEventChannel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeEventChannel.d.ts","sourceRoot":"","sources":["../../src/session/runtimeEventChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,yBAAyB,EAAE,MAAM,sCAAsC,CAAA;AAErG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,iCAAiC;IAChD,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb;;;;;OAKG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;IAC/E;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,MAAM,CAAA;CACvD;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,iCAAiC,GACzC,sBAAsB,CA+CxB"}

package/dist/session/runtimeEventChannel.js

@@ -0,0 +1,53 @@
+import { defaultRunIdOf } from '@xenosystem/agent-interface-contract';
+export function createRuntimeEventSessionChannel(options) {
+    const runIdOf = options.runIdOf ?? defaultRunIdOf;
+    const listeners = new Set();
+    let stopUpstream;
+    let closed = false;
+    const deliver = (event) => {
+        // 🔴 Another run's events must never reach this terminal. In a fleet that is
+        // a disclosure, not a cosmetic bug — and it would read as a rendering fault
+        // rather than the routing fault it is, which is why it is asserted.
+        if (runIdOf(event) !== options.runId)
+            return;
+        for (const listener of [...listeners]) {
+            // Contained per listener. This runs INSIDE the host's publish loop, so an
+            // escaping error would stop delivery to every other subscriber of the bus
+            // — a renderer fault taking down run observation, say. Nothing is
+            // swallowed that anyone could act on: the only listener is the session
+            // service, which already handles its own rendering failures and, for the
+            // same reason, has nowhere honest to report them to.
+            try {
+                listener(event);
+            }
+            catch { /* one listener's fault, not the bus's */ }
+        }
+    };
+    return {
+        onMessage(listener) {
+            // A closed channel stays closed. Re-subscribing upstream here would
+            // resurrect a session the service has already torn down.
+            if (closed)
+                return () => { };
+            listeners.add(listener);
+            // Subscribed on the FIRST listener, not at construction: a channel built
+            // for a session that is then refused (`protocol_channel_forbidden`, say)
+            // must not leave a live subscription behind for a session that never was.
+            stopUpstream ??= options.subscribe(deliver);
+            return () => {
+                listeners.delete(listener);
+                if (listeners.size === 0) {
+                    stopUpstream?.();
+                    stopUpstream = undefined;
+                }
+            };
+        },
+        close() {
+            closed = true;
+            listeners.clear();
+            stopUpstream?.();
+            stopUpstream = undefined;
+        },
+    };
+}
+//# sourceMappingURL=runtimeEventChannel.js.map

package/dist/session/runtimeEventChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeEventChannel.js","sourceRoot":"","sources":["../../src/session/runtimeEventChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkC,MAAM,sCAAsC,CAAA;AAyDrG,MAAM,UAAU,gCAAgC,CAC9C,OAA0C;IAE1C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAA;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAA;IACvD,IAAI,YAAsC,CAAA;IAC1C,IAAI,MAAM,GAAG,KAAK,CAAA;IAElB,MAAM,OAAO,GAAG,CAAC,KAAgC,EAAQ,EAAE;QACzD,6EAA6E;QAC7E,4EAA4E;QAC5E,oEAAoE;QACpE,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,KAAK;YAAE,OAAM;QAC5C,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;YACtC,0EAA0E;YAC1E,0EAA0E;YAC1E,kEAAkE;YAClE,uEAAuE;YACvE,yEAAyE;YACzE,qDAAqD;YACrD,IAAI,CAAC;gBAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,yCAAyC,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,SAAS,CAAC,QAAQ;YAChB,oEAAoE;YACpE,yDAAyD;YACzD,IAAI,MAAM;gBAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;YAC3B,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACvB,yEAAyE;YACzE,yEAAyE;YACzE,0EAA0E;YAC1E,YAAY,KAAK,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;YAC3C,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;gBAC1B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACzB,YAAY,EAAE,EAAE,CAAA;oBAChB,YAAY,GAAG,SAAS,CAAA;gBAC1B,CAAC;YACH,CAAC,CAAA;QACH,CAAC;QACD,KAAK;YACH,MAAM,GAAG,IAAI,CAAA;YACb,SAAS,CAAC,KAAK,EAAE,CAAA;YACjB,YAAY,EAAE,EAAE,CAAA;YAChB,YAAY,GAAG,SAAS,CAAA;QAC1B,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/state/JsonAgentStateRepository.d.ts

@@ -0,0 +1,29 @@
+import type { AgentConversationStateDeleteRequest, AgentConversationStateDeleteResult, AgentConversationStateLoadResult, AgentConversationStateSaveRequest, AgentConversationStateSaveResult, AgentWorkspaceStateLoadResult, AgentWorkspaceStateSaveRequest, AgentWorkspaceStateSaveResult } from '@xenosystem/agent-interface-contract';
+import type { AgentStateRepository } from '../index.js';
+/**
+ * Transitional durable JSON repository copied from the shipping Hub storage
+ * behavior. It keeps atomic writes and last-known-good recovery while the
+ * separately gated SQLite migration is developed.
+ */
+export declare class JsonAgentStateRepository implements AgentStateRepository {
+    readonly rootDirectory: string;
+    readonly workspaceFile: string;
+    readonly conversationsDirectory: string;
+    constructor(rootDirectory: string, options?: JsonAgentStateRepositoryOptions);
+    loadWorkspaces(): Promise<AgentWorkspaceStateLoadResult>;
+    saveWorkspaces(input: AgentWorkspaceStateSaveRequest): Promise<AgentWorkspaceStateSaveResult>;
+    loadConversations(): Promise<AgentConversationStateLoadResult>;
+    saveConversation(input: AgentConversationStateSaveRequest): Promise<AgentConversationStateSaveResult>;
+    deleteConversation(input: AgentConversationStateDeleteRequest): Promise<AgentConversationStateDeleteResult>;
+    private conversationPath;
+}
+export interface JsonAgentStateRepositoryOptions {
+    /**
+     * Transitional override for the shipping Hub workspace snapshot. The host
+     * remains the only live writer; this does not enable dual-write behavior.
+     */
+    workspaceFile?: string;
+    /** Transitional override for the shipping Hub conversation directory. */
+    conversationsDirectory?: string;
+}
+//# sourceMappingURL=JsonAgentStateRepository.d.ts.map

package/dist/state/JsonAgentStateRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonAgentStateRepository.d.ts","sourceRoot":"","sources":["../../src/state/JsonAgentStateRepository.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,mCAAmC,EACnC,kCAAkC,EAClC,gCAAgC,EAChC,iCAAiC,EACjC,gCAAgC,EAChC,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AASvD;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,oBAAoB;IACnE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAA;gBAE3B,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE,+BAAoC;IAM1E,cAAc,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAcxD,cAAc,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAa7F,iBAAiB,IAAI,OAAO,CAAC,gCAAgC,CAAC;IAqC9D,gBAAgB,CAAC,KAAK,EAAE,iCAAiC,GAAG,OAAO,CAAC,gCAAgC,CAAC;IAWrG,kBAAkB,CAAC,KAAK,EAAE,mCAAmC,GAAG,OAAO,CAAC,kCAAkC,CAAC;IAWjH,OAAO,CAAC,gBAAgB;CAKzB;AAED,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC"}

package/dist/state/JsonAgentStateRepository.js

@@ -0,0 +1,165 @@
+import { closeSync, copyFileSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { safeAgentStateEntityId, safeAgentStateError, sanitizeConversation, sanitizeWorkspaceTree, serializeBoundedAgentState, } from './stateSanitizers.js';
+/**
+ * Transitional durable JSON repository copied from the shipping Hub storage
+ * behavior. It keeps atomic writes and last-known-good recovery while the
+ * separately gated SQLite migration is developed.
+ */
+export class JsonAgentStateRepository {
+    rootDirectory;
+    workspaceFile;
+    conversationsDirectory;
+    constructor(rootDirectory, options = {}) {
+        this.rootDirectory = rootDirectory;
+        this.workspaceFile = options.workspaceFile || join(rootDirectory, 'workspaces.json');
+        this.conversationsDirectory = options.conversationsDirectory || join(rootDirectory, 'conversations');
+    }
+    async loadWorkspaces() {
+        try {
+            ensureDirectory(this.rootDirectory);
+            if (!existsSync(this.workspaceFile))
+                return { success: true, workspaces: [] };
+            const parsed = JSON.parse(readFileSync(this.workspaceFile, 'utf8'));
+            return {
+                success: true,
+                workspaces: sanitizeWorkspaceTree(parsed),
+            };
+        }
+        catch (error) {
+            return { success: false, workspaces: [], error: safeError(error) };
+        }
+    }
+    async saveWorkspaces(input) {
+        try {
+            if (!Array.isArray(input.workspaces)) {
+                return { success: false, error: 'Invalid workspace state: expected an array.' };
+            }
+            const workspaces = sanitizeWorkspaceTree(input.workspaces);
+            atomicWriteJson(this.workspaceFile, workspaces);
+            return { success: true };
+        }
+        catch (error) {
+            return { success: false, error: safeError(error) };
+        }
+    }
+    async loadConversations() {
+        try {
+            ensureDirectory(this.conversationsDirectory);
+            const conversations = [];
+            const recoveredConversationIds = [];
+            const corruptConversationFiles = [];
+            for (const file of readdirSync(this.conversationsDirectory).filter((entry) => entry.endsWith('.json')).sort()) {
+                const path = join(this.conversationsDirectory, file);
+                try {
+                    const conversation = sanitizeConversation(JSON.parse(readFileSync(path, 'utf8')));
+                    if (conversation)
+                        conversations.push(conversation);
+                }
+                catch {
+                    corruptConversationFiles.push(file);
+                    const backupPath = `${path}.bak`;
+                    if (!existsSync(backupPath))
+                        continue;
+                    try {
+                        const recovered = sanitizeConversation(JSON.parse(readFileSync(backupPath, 'utf8')));
+                        if (!recovered)
+                            continue;
+                        restorePrimaryJson(path, recovered);
+                        recoveredConversationIds.push(String(recovered.id));
+                        conversations.push(recovered);
+                    }
+                    catch {
+                        // Both primary and backup are invalid. Report the file and continue.
+                    }
+                }
+            }
+            return {
+                success: true,
+                conversations,
+                recoveredConversationIds,
+                corruptConversationFiles,
+            };
+        }
+        catch (error) {
+            return { success: false, conversations: [], error: safeError(error) };
+        }
+    }
+    async saveConversation(input) {
+        try {
+            const conversation = sanitizeConversation(input.conversation);
+            if (!conversation)
+                return { success: false, error: 'Invalid conversation state.' };
+            atomicWriteJson(this.conversationPath(String(conversation.id)), conversation);
+            return { success: true };
+        }
+        catch (error) {
+            return { success: false, error: safeError(error) };
+        }
+    }
+    async deleteConversation(input) {
+        try {
+            const path = this.conversationPath(input.conversationId);
+            if (existsSync(path))
+                unlinkSync(path);
+            if (existsSync(`${path}.bak`))
+                unlinkSync(`${path}.bak`);
+            return { success: true };
+        }
+        catch (error) {
+            return { success: false, error: safeError(error) };
+        }
+    }
+    conversationPath(id) {
+        const safeId = safeAgentStateEntityId(id);
+        if (!safeId)
+            throw new Error('Invalid conversation ID.');
+        return join(this.conversationsDirectory, `${safeId}.json`);
+    }
+}
+function atomicWriteJson(path, value) {
+    ensureDirectory(dirname(path));
+    const temporaryPath = `${path}.tmp-${process.pid}-${Date.now()}`;
+    try {
+        const compact = serializeBoundedAgentState(value, 'Agent state');
+        writeFileSync(temporaryPath, `${JSON.stringify(JSON.parse(compact), null, 2)}\n`, 'utf8');
+        fsyncFile(temporaryPath);
+        if (existsSync(path)) {
+            copyFileSync(path, `${path}.bak`);
+            fsyncFile(`${path}.bak`);
+        }
+        renameSync(temporaryPath, path);
+    }
+    finally {
+        if (existsSync(temporaryPath))
+            unlinkSync(temporaryPath);
+    }
+}
+function restorePrimaryJson(path, value) {
+    ensureDirectory(dirname(path));
+    const temporaryPath = `${path}.recover-${process.pid}-${Date.now()}`;
+    try {
+        writeFileSync(temporaryPath, JSON.stringify(value, null, 2), 'utf8');
+        fsyncFile(temporaryPath);
+        renameSync(temporaryPath, path);
+    }
+    finally {
+        if (existsSync(temporaryPath))
+            unlinkSync(temporaryPath);
+    }
+}
+function fsyncFile(path) {
+    const handle = openSync(path, 'r+');
+    try {
+        fsyncSync(handle);
+    }
+    finally {
+        closeSync(handle);
+    }
+}
+function ensureDirectory(path) {
+    if (!existsSync(path))
+        mkdirSync(path, { recursive: true });
+}
+const safeError = safeAgentStateError;
+//# sourceMappingURL=JsonAgentStateRepository.js.map

package/dist/state/JsonAgentStateRepository.js.map

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

package/dist/state/SqliteAgentStateRepository.d.ts

@@ -0,0 +1,58 @@
+import type { AgentConversationStateDeleteRequest, AgentConversationStateDeleteResult, AgentConversationStateLoadResult, AgentConversationStateSaveRequest, AgentConversationStateSaveResult, AgentWorkspaceStateLoadResult, AgentWorkspaceStateSaveRequest, AgentWorkspaceStateSaveResult } from '@xenosystem/agent-interface-contract';
+import type { AgentStateRepository } from '../index.js';
+export interface SqliteAgentStateRepositoryOptions {
+    databaseFile: string;
+    backupsDirectory: string;
+    reportsDirectory: string;
+    migrationLockFile: string;
+    legacyWorkspaceFile?: string;
+    legacyConversationsDirectory?: string;
+}
+export interface AgentStateMigrationReport {
+    schemaVersion: 1;
+    migrationId: string;
+    status: 'fresh' | 'migrated' | 'existing' | 'failed';
+    startedAt: string;
+    completedAt: string;
+    databaseFile: string;
+    sourceFingerprint: string | null;
+    backupDirectory: string | null;
+    workspaceCount: number;
+    conversationCount: number;
+    recoveredSources: string[];
+    sourceFiles: AgentStateMigrationFile[];
+    reportFile: string | null;
+    error: string | null;
+}
+export interface AgentStateMigrationFile {
+    source: string;
+    backupRelativePath: string;
+    bytes: number;
+    sha256: string;
+}
+export interface AgentStateRollbackResult {
+    success: boolean;
+    rollbackDirectory: string | null;
+    error: string | null;
+}
+/**
+ * Transactional state authority for both XENO Agent surfaces. Runtime/audit events remain in the
+ * append-only event journal; this database owns mutable workspace and conversation projections.
+ */
+export declare class SqliteAgentStateRepository implements AgentStateRepository {
+    readonly databaseFile: string;
+    readonly migrationReport: AgentStateMigrationReport;
+    private readonly database;
+    private closed;
+    private constructor();
+    static open(options: SqliteAgentStateRepositoryOptions): Promise<SqliteAgentStateRepository>;
+    loadWorkspaces(): Promise<AgentWorkspaceStateLoadResult>;
+    saveWorkspaces(input: AgentWorkspaceStateSaveRequest): Promise<AgentWorkspaceStateSaveResult>;
+    loadConversations(): Promise<AgentConversationStateLoadResult>;
+    saveConversation(input: AgentConversationStateSaveRequest): Promise<AgentConversationStateSaveResult>;
+    deleteConversation(input: AgentConversationStateDeleteRequest): Promise<AgentConversationStateDeleteResult>;
+    close(): void;
+    private assertOpen;
+}
+export declare function rollbackAgentStateMigration(options: SqliteAgentStateRepositoryOptions): Promise<AgentStateRollbackResult>;
+//# sourceMappingURL=SqliteAgentStateRepository.d.ts.map

package/dist/state/SqliteAgentStateRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteAgentStateRepository.d.ts","sourceRoot":"","sources":["../../src/state/SqliteAgentStateRepository.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,mCAAmC,EACnC,kCAAkC,EAClC,gCAAgC,EAChC,iCAAiC,EACjC,gCAAgC,EAChC,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAcvD,MAAM,WAAW,iCAAiC;IAChD,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,4BAA4B,CAAC,EAAE,MAAM,CAAA;CACtC;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,CAAC,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAA;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,WAAW,EAAE,uBAAuB,EAAE,CAAA;IACtC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,kBAAkB,EAAE,MAAM,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,oBAAoB;IACrE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAA;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,MAAM,CAAQ;IAEtB,OAAO;WAUM,IAAI,CAAC,OAAO,EAAE,iCAAiC,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAwB5F,cAAc,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAWxD,cAAc,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAqB7F,iBAAiB,IAAI,OAAO,CAAC,gCAAgC,CAAC;IAsB9D,gBAAgB,CAAC,KAAK,EAAE,iCAAiC,GAAG,OAAO,CAAC,gCAAgC,CAAC;IAqBrG,kBAAkB,CAAC,KAAK,EAAE,mCAAmC,GAAG,OAAO,CAAC,kCAAkC,CAAC;IAejH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,UAAU;CAGnB;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,wBAAwB,CAAC,CA8CnC"}