@assemblyline-agents/runtime 0.1.0

package/dist/in-memory-small-stores.d.ts

@@ -0,0 +1,117 @@
+import type { JsonObject, JsonValue, MemoryListInput, MemorySearchInput } from "@assemblyline-agents/core";
+import type { ConversationCursor, ConversationRecord, ConversationStore, FileIndexRecord, FileIndexStore, MemoryDocument, MemoryEmbeddingRecord, MemoryScope, MemorySearchResult, MemoryStateStore, MessageCursor, MessageRecord, ScheduleRecord, ScheduleRunRecord, ScheduleStateStore, RuntimeControlEvent, RuntimeSettingRecord, RuntimeSettingsStore } from "./state.js";
+export declare class InMemoryRuntimeSettingsStore implements RuntimeSettingsStore {
+    private readonly persist;
+    settings: Map<string, RuntimeSettingRecord>;
+    controlEvents: RuntimeControlEvent[];
+    constructor(persist?: () => Promise<void>);
+    getSetting(scope: string, key: string): Promise<RuntimeSettingRecord | undefined>;
+    setSetting(scope: string, key: string, value: JsonValue): Promise<RuntimeSettingRecord>;
+    appendRuntimeControlEvent(scope: string, type: string, data?: JsonObject): Promise<RuntimeControlEvent>;
+    listRuntimeControlEvents(scope: string): Promise<RuntimeControlEvent[]>;
+}
+export declare class InMemoryConversationStore implements ConversationStore {
+    private readonly persist;
+    conversations: Map<string, ConversationRecord>;
+    messages: MessageRecord[];
+    constructor(persist?: () => Promise<void>);
+    upsertConversation(input: {
+        id: string;
+        agentScope?: string;
+        agentRevision: string;
+        channel: string;
+        subject?: string;
+        title?: string;
+        metadata?: JsonObject;
+    }): Promise<ConversationRecord>;
+    getConversation(id: string): Promise<ConversationRecord | undefined>;
+    listConversations(input: {
+        agentScope: string;
+        channel?: string;
+        subject?: string;
+        archived?: boolean;
+        before?: ConversationCursor;
+        limit?: number;
+    }): Promise<ConversationRecord[]>;
+    updateConversation(id: string, patch: {
+        title?: string | null;
+        archivedAt?: string | null;
+        metadata?: JsonObject;
+    }): Promise<ConversationRecord | undefined>;
+    listRecentConversationsBySubject(input: {
+        channel: string;
+        subject: string;
+        since?: string;
+        limit?: number;
+        excludeId?: string;
+    }): Promise<ConversationRecord[]>;
+    appendMessage(input: {
+        conversationId: string;
+        runId?: string;
+        role: MessageRecord["role"];
+        content: JsonObject;
+    }): Promise<MessageRecord>;
+    listRecentMessages(conversationId: string, limit?: number): Promise<MessageRecord[]>;
+    listMessages(input: {
+        conversationId: string;
+        before?: MessageCursor;
+        limit?: number;
+    }): Promise<MessageRecord[]>;
+}
+export declare class InMemoryScheduleStateStore implements ScheduleStateStore {
+    private readonly persist;
+    schedules: Map<string, ScheduleRecord>;
+    scheduleRuns: ScheduleRunRecord[];
+    constructor(persist?: () => Promise<void>);
+    registerSchedule(input: {
+        id: string;
+        name: string;
+        cron: string;
+        timezone?: string;
+        metadata?: JsonObject;
+    }): Promise<ScheduleRecord>;
+    recordScheduleRun(input: {
+        scheduleId: string;
+        runId?: string;
+        runAt: string;
+        idempotencyKey: string;
+        status?: string;
+    }): Promise<ScheduleRunRecord>;
+}
+export declare class InMemoryFileIndexStore implements FileIndexStore {
+    private readonly persist;
+    fileIndexes: FileIndexRecord[];
+    constructor(persist?: () => Promise<void>);
+    recordFileIndex(input: {
+        runId?: string;
+        path: string;
+        kind: FileIndexRecord["kind"];
+        blobKey: string;
+        sha256: string;
+        sizeBytes: number;
+        metadata?: JsonObject;
+    }): Promise<FileIndexRecord>;
+    listFileIndexes(runId?: string): Promise<FileIndexRecord[]>;
+}
+export declare class InMemoryMemoryStateStore implements MemoryStateStore {
+    private readonly persist;
+    memoryDocuments: Map<string, MemoryDocument>;
+    memoryEmbeddings: Map<string, MemoryEmbeddingRecord>;
+    constructor(persist?: () => Promise<void>);
+    supportsMemoryEmbeddings(): boolean;
+    listMemoryDocuments(scope: MemoryScope, input?: MemoryListInput): Promise<MemoryDocument[]>;
+    getMemoryDocument(scope: MemoryScope, path: string): Promise<MemoryDocument | undefined>;
+    upsertMemoryDocument(document: MemoryDocument): Promise<MemoryDocument>;
+    deleteMemoryDocument(scope: MemoryScope, path: string): Promise<void>;
+    listMemoryDocumentsNeedingEmbeddings(scope: MemoryScope, options: {
+        model: string;
+        limit?: number;
+    }): Promise<MemoryDocument[]>;
+    upsertMemoryEmbedding(input: Omit<MemoryEmbeddingRecord, "id" | "createdAt" | "updatedAt">): Promise<MemoryEmbeddingRecord>;
+    searchMemoryEmbeddings(scope: MemoryScope, input: MemorySearchInput, embedding: number[], options: {
+        model: string;
+        limit?: number;
+    }): Promise<MemorySearchResult[]>;
+    markMemoryEmbeddingsStale(scope: MemoryScope, path: string, currentSha256: string): Promise<void>;
+}
+//# sourceMappingURL=in-memory-small-stores.d.ts.map

package/dist/in-memory-small-stores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-small-stores.d.ts","sourceRoot":"","sources":["../src/in-memory-small-stores.ts"],"names":[],"mappings":"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"}

package/dist/in-memory-small-stores.js

@@ -0,0 +1,340 @@
+import { randomUUID } from "node:crypto";
+import { cosineSimilarity, memoryBodyText, memoryEmbeddingKey, memoryKey, memoryScopeMatches, memorySnippet, noPersist, normalizeMemoryPath, positiveLimit, timestamp } from "./state-store-helpers.js";
+export class InMemoryRuntimeSettingsStore {
+    persist;
+    settings = new Map();
+    controlEvents = [];
+    constructor(persist = noPersist) {
+        this.persist = persist;
+    }
+    async getSetting(scope, key) {
+        return this.settings.get(`${scope}:${key}`);
+    }
+    async setSetting(scope, key, value) {
+        const record = { scope, key, value, updatedAt: timestamp() };
+        this.settings.set(`${scope}:${key}`, record);
+        await this.persist();
+        return record;
+    }
+    async appendRuntimeControlEvent(scope, type, data = {}) {
+        const event = { id: randomUUID(), scope, type, timestamp: timestamp(), data };
+        this.controlEvents.push(event);
+        await this.persist();
+        return event;
+    }
+    async listRuntimeControlEvents(scope) {
+        return this.controlEvents.filter((event) => event.scope === scope).sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    }
+}
+export class InMemoryConversationStore {
+    persist;
+    conversations = new Map();
+    messages = [];
+    constructor(persist = noPersist) {
+        this.persist = persist;
+    }
+    async upsertConversation(input) {
+        const now = timestamp();
+        const current = this.conversations.get(input.id);
+        const agentScope = input.agentScope ?? current?.agentScope;
+        const record = {
+            id: input.id,
+            agentRevision: input.agentRevision,
+            channel: input.channel,
+            metadata: { ...(current?.metadata ?? {}), ...(input.metadata ?? {}) },
+            createdAt: current?.createdAt ?? now,
+            updatedAt: now
+        };
+        if (agentScope)
+            record.agentScope = agentScope;
+        const subject = input.subject ?? current?.subject;
+        if (subject)
+            record.subject = subject;
+        const title = input.title ?? current?.title;
+        if (title)
+            record.title = title;
+        if (current?.archivedAt)
+            record.archivedAt = current.archivedAt;
+        this.conversations.set(record.id, record);
+        await this.persist();
+        return record;
+    }
+    async getConversation(id) {
+        return this.conversations.get(id);
+    }
+    async listConversations(input) {
+        const limit = Math.max(0, input.limit ?? 50);
+        return [...this.conversations.values()]
+            .filter((conversation) => (conversation.agentScope ?? conversation.agentRevision) === input.agentScope)
+            .filter((conversation) => !input.channel || conversation.channel === input.channel)
+            .filter((conversation) => !input.subject || conversation.subject === input.subject)
+            .filter((conversation) => input.archived === undefined || Boolean(conversation.archivedAt) === input.archived)
+            .filter((conversation) => !input.before ||
+            conversation.updatedAt < input.before.updatedAt ||
+            (conversation.updatedAt === input.before.updatedAt && conversation.id < input.before.id))
+            .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt) || b.id.localeCompare(a.id))
+            .slice(0, limit);
+    }
+    async updateConversation(id, patch) {
+        const current = this.conversations.get(id);
+        if (!current)
+            return undefined;
+        const updated = {
+            ...current,
+            metadata: { ...current.metadata, ...(patch.metadata ?? {}) },
+            updatedAt: timestamp()
+        };
+        if (patch.title !== undefined) {
+            if (patch.title)
+                updated.title = patch.title;
+            else
+                delete updated.title;
+        }
+        if (patch.archivedAt !== undefined) {
+            if (patch.archivedAt)
+                updated.archivedAt = patch.archivedAt;
+            else
+                delete updated.archivedAt;
+        }
+        this.conversations.set(id, updated);
+        await this.persist();
+        return updated;
+    }
+    async listRecentConversationsBySubject(input) {
+        const since = input.since ? Date.parse(input.since) : undefined;
+        const limit = Math.max(0, input.limit ?? 10);
+        return [...this.conversations.values()]
+            .filter((conversation) => conversation.channel === input.channel && conversation.subject === input.subject)
+            .filter((conversation) => !input.excludeId || conversation.id !== input.excludeId)
+            .filter((conversation) => since === undefined || Date.parse(conversation.updatedAt) >= since)
+            .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
+            .slice(0, limit);
+    }
+    async appendMessage(input) {
+        const record = {
+            id: randomUUID(),
+            conversationId: input.conversationId,
+            role: input.role,
+            content: input.content,
+            createdAt: timestamp()
+        };
+        if (input.runId)
+            record.runId = input.runId;
+        this.messages.push(record);
+        await this.persist();
+        return record;
+    }
+    async listRecentMessages(conversationId, limit = 20) {
+        return this.messages
+            .filter((message) => message.conversationId === conversationId)
+            .sort((a, b) => a.createdAt.localeCompare(b.createdAt))
+            .slice(-Math.max(0, limit));
+    }
+    async listMessages(input) {
+        const limit = Math.max(0, input.limit ?? 50);
+        return this.messages
+            .filter((message) => message.conversationId === input.conversationId)
+            .filter((message) => !input.before ||
+            message.createdAt < input.before.createdAt ||
+            (message.createdAt === input.before.createdAt && message.id < input.before.id))
+            .sort((a, b) => b.createdAt.localeCompare(a.createdAt) || b.id.localeCompare(a.id))
+            .slice(0, limit)
+            .reverse();
+    }
+}
+export class InMemoryScheduleStateStore {
+    persist;
+    schedules = new Map();
+    scheduleRuns = [];
+    constructor(persist = noPersist) {
+        this.persist = persist;
+    }
+    async registerSchedule(input) {
+        const now = timestamp();
+        const current = this.schedules.get(input.id);
+        const record = {
+            id: input.id,
+            name: input.name,
+            cron: input.cron,
+            metadata: input.metadata ?? current?.metadata ?? {},
+            createdAt: current?.createdAt ?? now,
+            updatedAt: now
+        };
+        const timezone = input.timezone ?? current?.timezone;
+        if (timezone)
+            record.timezone = timezone;
+        this.schedules.set(record.id, record);
+        await this.persist();
+        return record;
+    }
+    async recordScheduleRun(input) {
+        const existing = this.scheduleRuns.find((run) => run.idempotencyKey === input.idempotencyKey);
+        if (existing) {
+            const updated = {
+                ...existing,
+                scheduleId: input.scheduleId,
+                runAt: input.runAt,
+                status: input.status ?? existing.status,
+                updatedAt: timestamp()
+            };
+            if (input.runId)
+                updated.runId = input.runId;
+            this.scheduleRuns[this.scheduleRuns.indexOf(existing)] = updated;
+            await this.persist();
+            return updated;
+        }
+        const now = timestamp();
+        const record = {
+            id: randomUUID(),
+            scheduleId: input.scheduleId,
+            status: input.status ?? "ready",
+            runAt: input.runAt,
+            idempotencyKey: input.idempotencyKey,
+            createdAt: now,
+            updatedAt: now
+        };
+        if (input.runId)
+            record.runId = input.runId;
+        this.scheduleRuns.push(record);
+        await this.persist();
+        return record;
+    }
+}
+export class InMemoryFileIndexStore {
+    persist;
+    fileIndexes = [];
+    constructor(persist = noPersist) {
+        this.persist = persist;
+    }
+    async recordFileIndex(input) {
+        const existing = this.fileIndexes.find((record) => record.runId === input.runId &&
+            record.path === input.path &&
+            record.kind === input.kind &&
+            record.sha256 === input.sha256);
+        if (existing)
+            return existing;
+        const record = {
+            id: randomUUID(),
+            path: input.path,
+            kind: input.kind,
+            blobKey: input.blobKey,
+            sha256: input.sha256,
+            sizeBytes: input.sizeBytes,
+            metadata: input.metadata ?? {},
+            createdAt: timestamp()
+        };
+        if (input.runId)
+            record.runId = input.runId;
+        this.fileIndexes.push(record);
+        await this.persist();
+        return record;
+    }
+    async listFileIndexes(runId) {
+        return this.fileIndexes
+            .filter((record) => runId === undefined || record.runId === runId)
+            .sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+}
+export class InMemoryMemoryStateStore {
+    persist;
+    memoryDocuments = new Map();
+    memoryEmbeddings = new Map();
+    constructor(persist = noPersist) {
+        this.persist = persist;
+    }
+    supportsMemoryEmbeddings() {
+        return true;
+    }
+    async listMemoryDocuments(scope, input = {}) {
+        const prefix = normalizeMemoryPath(input.pathPrefix ?? "");
+        const limit = input.limit === undefined ? Number.MAX_SAFE_INTEGER : positiveLimit(input.limit, 50);
+        return [...this.memoryDocuments.values()]
+            .filter((document) => memoryScopeMatches(scope, document.scope))
+            .filter((document) => !prefix || document.path.startsWith(prefix))
+            .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
+            .slice(0, limit);
+    }
+    async getMemoryDocument(scope, path) {
+        const document = this.memoryDocuments.get(memoryKey(scope, normalizeMemoryPath(path)));
+        return document && memoryScopeMatches(scope, document.scope) ? document : undefined;
+    }
+    async upsertMemoryDocument(document) {
+        this.memoryDocuments.set(memoryKey(document.scope, document.path), document);
+        await this.persist();
+        return document;
+    }
+    async deleteMemoryDocument(scope, path) {
+        const normalized = normalizeMemoryPath(path);
+        this.memoryDocuments.delete(memoryKey(scope, normalized));
+        for (const key of [...this.memoryEmbeddings.keys()]) {
+            if (key.startsWith(`${memoryKey(scope, normalized)}:`))
+                this.memoryEmbeddings.delete(key);
+        }
+        await this.persist();
+    }
+    async listMemoryDocumentsNeedingEmbeddings(scope, options) {
+        const limit = positiveLimit(options.limit, 25);
+        return [...this.memoryDocuments.values()]
+            .filter((document) => memoryScopeMatches(scope, document.scope))
+            .filter((document) => {
+            const embedding = this.memoryEmbeddings.get(memoryEmbeddingKey(document.scope, document.path, options.model));
+            return !embedding || embedding.stale || embedding.contentSha256 !== document.sha256;
+        })
+            .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
+            .slice(0, limit);
+    }
+    async upsertMemoryEmbedding(input) {
+        const key = memoryEmbeddingKey(input.scope, input.path, input.model);
+        const current = this.memoryEmbeddings.get(key);
+        const now = timestamp();
+        const record = {
+            ...input,
+            id: current?.id ?? randomUUID(),
+            createdAt: current?.createdAt ?? now,
+            updatedAt: now
+        };
+        this.memoryEmbeddings.set(key, record);
+        await this.persist();
+        return record;
+    }
+    async searchMemoryEmbeddings(scope, input, embedding, options) {
+        const prefix = normalizeMemoryPath(input.pathPrefix ?? "");
+        const limit = positiveLimit(options.limit ?? input.limit, 8);
+        const ranked = [...this.memoryEmbeddings.values()]
+            .filter((record) => record.model === options.model && !record.stale)
+            .filter((record) => memoryScopeMatches(scope, record.scope))
+            .filter((record) => !prefix || record.path.startsWith(prefix))
+            .map((record) => {
+            const document = this.memoryDocuments.get(memoryKey(record.scope, record.path));
+            return document
+                ? { record, document, similarity: cosineSimilarity(embedding, record.embedding) }
+                : undefined;
+        })
+            .filter((entry) => Boolean(entry))
+            .sort((a, b) => b.similarity - a.similarity || b.document.updatedAt.localeCompare(a.document.updatedAt))
+            .slice(0, limit);
+        return ranked.map(({ document, similarity }) => ({
+            path: document.path,
+            ...(document.title ? { title: document.title } : {}),
+            ...(document.summary ? { summary: document.summary } : {}),
+            snippet: memorySnippet(memoryBodyText(document), input.query),
+            revision: document.revision,
+            tags: document.tags,
+            updatedAt: document.updatedAt,
+            rankReason: `semantic similarity ${similarity.toFixed(3)}`
+        }));
+    }
+    async markMemoryEmbeddingsStale(scope, path, currentSha256) {
+        const normalizedPath = normalizeMemoryPath(path);
+        let changed = false;
+        for (const [key, record] of this.memoryEmbeddings.entries()) {
+            if (!memoryScopeMatches(scope, record.scope) || record.path !== normalizedPath || record.contentSha256 === currentSha256)
+                continue;
+            this.memoryEmbeddings.set(key, { ...record, stale: true, updatedAt: timestamp() });
+            changed = true;
+        }
+        if (changed)
+            await this.persist();
+    }
+}
+//# sourceMappingURL=in-memory-small-stores.js.map

package/dist/in-memory-small-stores.js.map

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

package/dist/in-memory-usage-store.d.ts

@@ -0,0 +1,15 @@
+import type { UsageAggregate, UsageQuery, UsageRecord, UsageRecordInput, UsageStore, UsageSummaryQuery } from "./state.js";
+/** In-process reference implementation of the idempotent observational usage ledger. */
+export declare class InMemoryUsageStore implements UsageStore {
+    private readonly persist;
+    usageRecords: UsageRecord[];
+    private serial;
+    constructor(persist?: () => Promise<void>);
+    recordUsage(input: UsageRecordInput): Promise<UsageRecord>;
+    listUsage(runId?: string): Promise<UsageRecord[]>;
+    queryUsage(query: UsageQuery): Promise<UsageRecord[]>;
+    summarizeUsage(query: UsageSummaryQuery): Promise<UsageAggregate[]>;
+    private recordUsageUnsafe;
+    private exclusive;
+}
+//# sourceMappingURL=in-memory-usage-store.d.ts.map

package/dist/in-memory-usage-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-usage-store.d.ts","sourceRoot":"","sources":["../src/in-memory-usage-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAUpB,wFAAwF;AACxF,qBAAa,kBAAmB,YAAW,UAAU;IAIvC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,YAAY,EAAE,WAAW,EAAE,CAAM;IACjC,OAAO,CAAC,MAAM,CAAqB;gBAEN,OAAO,GAAE,MAAM,OAAO,CAAC,IAAI,CAAa;IAErE,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAQpD,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAMjD,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIrD,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAIzE,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,SAAS;CAKlB"}

package/dist/in-memory-usage-store.js

@@ -0,0 +1,49 @@
+import { createUsageRecord, queryUsageRecords, reconcileUsageRecord, summarizeUsageRecords } from "./usage-records.js";
+const noPersist = async () => undefined;
+/** In-process reference implementation of the idempotent observational usage ledger. */
+export class InMemoryUsageStore {
+    persist;
+    usageRecords = [];
+    serial = Promise.resolve();
+    constructor(persist = noPersist) {
+        this.persist = persist;
+    }
+    recordUsage(input) {
+        return this.exclusive(async () => {
+            const record = this.recordUsageUnsafe(input);
+            await this.persist();
+            return record;
+        });
+    }
+    async listUsage(runId) {
+        return this.usageRecords
+            .filter((record) => runId === undefined || record.runId === runId)
+            .sort((a, b) => a.occurredAt.localeCompare(b.occurredAt) || a.id.localeCompare(b.id));
+    }
+    async queryUsage(query) {
+        return queryUsageRecords(this.usageRecords, query);
+    }
+    async summarizeUsage(query) {
+        return summarizeUsageRecords(this.usageRecords, query);
+    }
+    recordUsageUnsafe(input) {
+        if (input.idempotencyKey) {
+            const index = this.usageRecords.findIndex((record) => record.idempotencyKey === input.idempotencyKey);
+            const existing = this.usageRecords[index];
+            if (existing) {
+                const reconciled = reconcileUsageRecord(existing, input);
+                this.usageRecords[index] = reconciled;
+                return reconciled;
+            }
+        }
+        const record = createUsageRecord(input);
+        this.usageRecords.push(record);
+        return record;
+    }
+    exclusive(operation) {
+        const result = this.serial.then(operation, operation);
+        this.serial = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+//# sourceMappingURL=in-memory-usage-store.js.map

package/dist/in-memory-usage-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-usage-store.js","sourceRoot":"","sources":["../src/in-memory-usage-store.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,SAAS,GAAG,KAAK,IAAmB,EAAE,CAAC,SAAS,CAAC;AAEvD,wFAAwF;AACxF,MAAM,OAAO,kBAAkB;IAIA;IAH7B,YAAY,GAAkB,EAAE,CAAC;IACzB,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAEnC,YAA6B,UAA+B,SAAS;QAAxC,YAAO,GAAP,OAAO,CAAiC;IAAG,CAAC;IAEzE,WAAW,CAAC,KAAuB;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC7C,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAc;QAC5B,OAAO,IAAI,CAAC,YAAY;aACrB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC;aACjE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1F,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAiB;QAChC,OAAO,iBAAiB,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAAwB;QAC3C,OAAO,qBAAqB,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAEO,iBAAiB,CAAC,KAAuB;QAC/C,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,KAAK,KAAK,CAAC,cAAc,CAAC,CAAC;YACtG,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,UAAU,GAAG,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACzD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;gBACtC,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,SAAS,CAAI,SAA2B;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}