@zaalipro/dsh-workflows 0.1.0-rc.12

package/lib/types/run-recorder.js

@@ -0,0 +1,356 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+export const name = 'workflow-run-recorder';
+export const inject = ['workflowSupervisor', 'agents'];
+function renderThrown(error) {
+    try {
+        return error instanceof Error ? error.message : String(error);
+    }
+    catch {
+        return '[unrenderable thrown value]';
+    }
+}
+function officialStopReason(value) {
+    return value === 'completed' ? 'completed' : value === 'cancelled' ? 'cancelled' : value === 'interrupted' ? 'cancelled' : 'error';
+}
+function officialMemberOutcome(value) {
+    return value === 'completed' ? 'completed' : value === 'failed' ? 'failed' : 'cancelled';
+}
+/**
+ * Best-effort durable projection for explicitly attributed top-level launches.
+ * Recording failures never alter execution and disable only the corrupt prefix.
+ */
+export class WorkflowRunRecorder {
+    ctx;
+    attribution = new AsyncLocalStorage();
+    active = new Map();
+    recoveries = new Set();
+    listeners = [];
+    lifetime = new AbortController();
+    disposed = false;
+    disposal;
+    constructor(ctx = {}) {
+        this.ctx = ctx;
+        this.listen('workflows/run-start', (info) => { this.onRunStart(info); });
+        this.listen('workflows/member-start', (info, member) => { this.onMemberStart(info, member); });
+        this.listen('workflows/member-end', (info, member) => { this.onMemberEnd(info, member); });
+        this.listen('workflows/run-end', (info, result) => { this.onRunEnd(info.id, String(result?.stopReason ?? 'error')); });
+        this.listen('agent/created', ({ agent }) => { void this.reconcile(agent); });
+        const existing = ctx?.agents?.list?.();
+        if (existing && Symbol.iterator in Object(existing))
+            for (const agent of existing)
+                void this.reconcile(agent);
+    }
+    listen(event, callback) {
+        const remove = this.ctx?.on?.(event, callback);
+        if (typeof remove === 'function')
+            this.listeners.push(remove);
+    }
+    /** Attribute exactly the first synchronously published logical id. */
+    async launch(session, start) {
+        if (this.disposed)
+            throw new Error('workflow run recorder is disposed');
+        const frame = { session, buffered: new Map() };
+        return this.attribution.run(frame, async () => {
+            const launched = await start();
+            if (frame.runId === undefined) {
+                frame.runId = launched.runId;
+                if (this.append(session, 'tool-workflow/run-start', { runId: launched.runId, name: launched.displayName })) {
+                    this.active.set(launched.runId, this.empty(session));
+                    this.replayBeforePublication(frame, launched.runId);
+                }
+            }
+            else if (frame.runId !== launched.runId) {
+                this.warn('disabled durable record because launch result changed the logical run id');
+                this.active.delete(frame.runId);
+            }
+            frame.buffered.clear();
+            return launched;
+        });
+    }
+    empty(session) {
+        return { session, started: new Set(), open: new Set(), pending: [], recovering: false };
+    }
+    warn(message, error) {
+        const suffix = error === undefined ? '' : `: ${renderThrown(error)}`;
+        this.ctx?.logger?.warn?.(`workflow-run-recorder: ${message}${suffix}`);
+    }
+    append(session, type, data) {
+        try {
+            if (typeof session?.append !== 'function')
+                throw new Error('Session.append is unavailable');
+            session.append(type, data);
+            return true;
+        }
+        catch (error) {
+            this.warn(`disabled durable record after ${type} append failed`, error);
+            return false;
+        }
+    }
+    buffer(runId, operation) {
+        const frame = this.attribution.getStore();
+        if (frame === undefined || frame.runId !== undefined)
+            return false;
+        const pending = frame.buffered.get(runId) ?? [];
+        pending.push(operation);
+        frame.buffered.set(runId, pending);
+        return true;
+    }
+    replayBeforePublication(frame, runId) {
+        const pending = frame.buffered.get(runId) ?? [];
+        frame.buffered.clear();
+        for (const operation of pending)
+            operation();
+    }
+    onRunStart(info) {
+        const frame = this.attribution.getStore();
+        if (frame === undefined || frame.runId !== undefined || this.disposed)
+            return;
+        frame.runId = info.id;
+        if (this.append(frame.session, 'tool-workflow/run-start', { runId: info.id, name: info.displayName })) {
+            this.active.set(info.id, this.empty(frame.session));
+            this.replayBeforePublication(frame, info.id);
+        }
+    }
+    onMemberStart(info, member) {
+        const record = this.active.get(info.id);
+        if (record === undefined) {
+            this.buffer(info.id, () => this.onMemberStart(info, member));
+            return;
+        }
+        if (record.recovering) {
+            record.pending.push({ kind: 'member-start', member });
+            return;
+        }
+        this.appendMemberStart(info.id, record, member);
+    }
+    appendMemberStart(runId, record, member) {
+        if (!Number.isSafeInteger(member.seq) || member.seq < 1 || record.started.has(member.seq)) {
+            this.warn(`disabled durable record after duplicate or invalid member start ${String(member.seq)}`);
+            this.active.delete(runId);
+            return false;
+        }
+        if (typeof member.childSessionId !== 'string' || member.childSessionId.length === 0) {
+            this.warn(`disabled durable record because member start ${String(member.seq)} omitted childId`);
+            this.active.delete(runId);
+            return false;
+        }
+        const data = {
+            runId, seq: member.seq, label: member.label,
+            ...(member.phase === undefined ? {} : { phase: member.phase }),
+            childId: member.childSessionId,
+        };
+        if (!this.append(record.session, 'tool-workflow/agent-start', data)) {
+            this.active.delete(runId);
+            return false;
+        }
+        record.started.add(member.seq);
+        record.open.add(member.seq);
+        return true;
+    }
+    onMemberEnd(info, member) {
+        const record = this.active.get(info.id);
+        if (record === undefined) {
+            this.buffer(info.id, () => this.onMemberEnd(info, member));
+            return;
+        }
+        if (record.recovering) {
+            record.pending.push({ kind: 'member-end', member });
+            return;
+        }
+        this.appendMemberEnd(info.id, record, member);
+    }
+    appendMemberEnd(runId, record, member) {
+        if (!record.started.has(member.seq) || !record.open.has(member.seq) || member.status === 'running') {
+            this.warn(`disabled durable record after unpaired member end ${String(member.seq)}`);
+            this.active.delete(runId);
+            return false;
+        }
+        if (!this.append(record.session, 'tool-workflow/agent-end', {
+            runId, seq: member.seq, outcome: officialMemberOutcome(member.status),
+        })) {
+            this.active.delete(runId);
+            return false;
+        }
+        record.open.delete(member.seq);
+        return true;
+    }
+    onRunEnd(runId, stopReason) {
+        const record = this.active.get(runId);
+        if (record === undefined) {
+            this.buffer(runId, () => this.onRunEnd(runId, stopReason));
+            return;
+        }
+        if (record.recovering) {
+            record.pending.push({ kind: 'run-end', stopReason });
+            return;
+        }
+        if (record.open.size > 0) {
+            this.warn('disabled durable record because run-end left members open');
+            this.active.delete(runId);
+            return;
+        }
+        this.append(record.session, 'tool-workflow/run-end', { runId, stopReason: officialStopReason(stopReason) });
+        this.active.delete(runId);
+    }
+    seed(session) {
+        const open = new Map();
+        const events = session?.events;
+        if (!events || !(Symbol.iterator in Object(events)))
+            return [];
+        for (const event of events) {
+            const type = event?.type;
+            const data = event?.data;
+            if (typeof type !== 'string' || !type.startsWith('tool-workflow/') || typeof data?.runId !== 'string')
+                continue;
+            const runId = data.runId;
+            if (type === 'tool-workflow/run-start') {
+                if (!open.has(runId))
+                    open.set(runId, this.empty(session));
+            }
+            else if (type === 'tool-workflow/agent-start' && Number.isSafeInteger(data.seq)) {
+                open.get(runId)?.started.add(data.seq);
+                open.get(runId)?.open.add(data.seq);
+            }
+            else if (type === 'tool-workflow/agent-end' && Number.isSafeInteger(data.seq))
+                open.get(runId)?.open.delete(data.seq);
+            else if (type === 'tool-workflow/run-end')
+                open.delete(runId);
+        }
+        const ids = [];
+        for (const [runId, record] of open) {
+            if (this.active.has(runId))
+                continue;
+            record.recovering = true;
+            this.active.set(runId, record);
+            ids.push(runId);
+        }
+        return ids;
+    }
+    /** Reconcile unfinished durable Chat prefixes from one atomic supervisor snapshot. */
+    async reconcile(agent) {
+        if (this.disposed || !agent?.session)
+            return;
+        const runIds = this.seed(agent.session);
+        if (runIds.length === 0)
+            return;
+        const operation = (async () => {
+            const recover = this.ctx?.workflowSupervisor?.recoverSession;
+            if (typeof recover === 'function') {
+                try {
+                    await recover.call(this.ctx.workflowSupervisor, agent, this.lifetime.signal);
+                }
+                catch (error) {
+                    if (!this.lifetime.signal.aborted)
+                        this.warn('could not reconcile durable workflow records', error);
+                }
+            }
+            for (const runId of runIds) {
+                try {
+                    this.lifetime.signal.throwIfAborted();
+                    const snapshot = await this.ctx?.workflowSupervisor?.recordingSnapshot?.(agent, runId, this.lifetime.signal);
+                    if (snapshot === undefined)
+                        this.closeMissing(runId);
+                    else
+                        this.reconcileSnapshot(runId, snapshot);
+                }
+                catch (error) {
+                    if (!this.lifetime.signal.aborted) {
+                        this.warn('could not reconcile durable workflow records', error);
+                        this.activate(runId);
+                    }
+                }
+            }
+        })();
+        this.recoveries.add(operation);
+        try {
+            await operation;
+        }
+        finally {
+            this.recoveries.delete(operation);
+        }
+    }
+    reconcileSnapshot(runId, snapshot) {
+        const record = this.active.get(runId);
+        if (record === undefined)
+            return;
+        const members = Array.isArray(snapshot?.members) ? [...snapshot.members].sort((a, b) => Number(a.seq) - Number(b.seq)) : [];
+        for (const member of members)
+            if (!record.started.has(member.seq) && !this.appendMemberStart(runId, record, member))
+                return;
+        for (const member of members)
+            if (member.status !== 'running' && record.open.has(member.seq) && !this.appendMemberEnd(runId, record, member))
+                return;
+        const stopReason = snapshot?.result?.stopReason;
+        if (typeof stopReason !== 'string') {
+            this.activate(runId);
+            return;
+        }
+        this.closeOpenMembers(runId, record);
+        if (!this.active.has(runId))
+            return;
+        this.append(record.session, 'tool-workflow/run-end', { runId, stopReason: officialStopReason(stopReason) });
+        this.active.delete(runId);
+    }
+    closeOpenMembers(runId, record) {
+        for (const seq of [...record.open].sort((a, b) => a - b)) {
+            if (!this.append(record.session, 'tool-workflow/agent-end', { runId, seq, outcome: 'cancelled' })) {
+                this.active.delete(runId);
+                return;
+            }
+            record.open.delete(seq);
+        }
+    }
+    closeMissing(runId) {
+        const record = this.active.get(runId);
+        if (record === undefined)
+            return;
+        this.closeOpenMembers(runId, record);
+        if (!this.active.has(runId))
+            return;
+        this.append(record.session, 'tool-workflow/run-end', { runId, stopReason: 'cancelled' });
+        this.active.delete(runId);
+    }
+    activate(runId) {
+        const record = this.active.get(runId);
+        if (record === undefined)
+            return;
+        record.recovering = false;
+        const pending = record.pending.splice(0);
+        for (const event of pending) {
+            if (!this.active.has(runId))
+                return;
+            if (event.kind === 'member-start') {
+                if (!record.started.has(event.member.seq))
+                    this.appendMemberStart(runId, record, event.member);
+            }
+            else if (event.kind === 'member-end') {
+                if (!record.started.has(event.member.seq) && !this.appendMemberStart(runId, record, event.member))
+                    return;
+                if (record.open.has(event.member.seq))
+                    this.appendMemberEnd(runId, record, event.member);
+            }
+            else
+                this.onRunEnd(runId, event.stopReason);
+        }
+    }
+    async dispose() {
+        if (this.disposal !== undefined)
+            return this.disposal;
+        this.disposed = true;
+        this.lifetime.abort(new Error('workflow run recorder disposed'));
+        for (const remove of this.listeners.splice(0)) {
+            try {
+                remove();
+            }
+            catch { /* contained */ }
+        }
+        this.disposal = (async () => {
+            await Promise.allSettled([...this.recoveries]);
+            this.active.clear();
+            this.attribution.disable();
+        })();
+        return this.disposal;
+    }
+}
+export default WorkflowRunRecorder;
+//# sourceMappingURL=run-recorder.js.map

package/lib/types/run-recorder.js.map

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

package/lib/types/supervisor/canned-validate.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Models often write `{ a: 1; b: 2 }` (JSON/Rhai/TS muscle memory). That is a
+ * SyntaxError in JavaScript. Only rewrite a semicolon that is clearly sitting
+ * between object/array fields (`ident:` or `"key":` follows). Leave
+ * `for (;;)` and ordinary statement separators alone.
+ */
+export declare function repairObjectLiteralSemicolons(script: string): string;
+/** Stock engines have no canned `validate()`. Run one path with stub hooks, never children. */
+export declare function cannedStockValidate(script: string, args?: unknown, options?: {
+    readonly timeoutMs?: number;
+    readonly filename?: string;
+}): Promise<{
+    readonly ok: true;
+    readonly status: 'completed';
+    readonly value: unknown;
+} | {
+    readonly ok: true;
+    readonly status: 'would-pause';
+    readonly value: string;
+} | {
+    readonly ok: false;
+    readonly status: 'error';
+    readonly error: string;
+}>;
+//# sourceMappingURL=canned-validate.d.ts.map

package/lib/types/supervisor/canned-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canned-validate.d.ts","sourceRoot":"","sources":["../../../src/supervisor/canned-validate.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAoCD,+FAA+F;AAC/F,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,OAAY,EAClB,OAAO,GAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACxE,OAAO,CACN;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAC3E,CA6DA"}

package/lib/types/supervisor/canned-validate.js

@@ -0,0 +1,122 @@
+import { Script, createContext } from 'node:vm';
+import { scriptWithJobMapParallel } from './parallel-compat.js';
+const DEFAULT_TIMEOUT_MS = 2_500;
+/**
+ * Models often write `{ a: 1; b: 2 }` (JSON/Rhai/TS muscle memory). That is a
+ * SyntaxError in JavaScript. Only rewrite a semicolon that is clearly sitting
+ * between object/array fields (`ident:` or `"key":` follows). Leave
+ * `for (;;)` and ordinary statement separators alone.
+ */
+export function repairObjectLiteralSemicolons(script) {
+    return script.replace(/;\s*(?=(?:["'][^"']*["']|[A-Za-z_$][\w$]*)\s*:)/gu, ', ');
+}
+function isWouldPause(error) {
+    return error instanceof Error && error.name === 'WorkflowWouldPause';
+}
+function gate(_kind, message) {
+    const error = new Error(String(message ?? ''));
+    error.name = 'WorkflowWouldPause';
+    throw error;
+}
+function asErrorText(error) {
+    try {
+        if (error instanceof Error && error.message) {
+            /* c8 ignore next -- Node always populates Error#stack */
+            return error.stack ?? error.message;
+        }
+        return String(error);
+        /* c8 ignore start -- String() of a hostile throwable */
+    }
+    catch {
+        return '[unrenderable canned validation failure]';
+    }
+    /* c8 ignore stop */
+}
+/** vm context objects use a different Object.prototype; snapshot as host JSON. */
+function hostJson(value) {
+    if (value === undefined)
+        return null;
+    try {
+        return JSON.parse(JSON.stringify(value));
+    }
+    catch {
+        return String(value);
+    }
+}
+/** Stock engines have no canned `validate()`. Run one path with stub hooks, never children. */
+export async function cannedStockValidate(script, args = {}, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const filename = options.filename ?? 'workflow:canned';
+    const body = scriptWithJobMapParallel(script);
+    let compiled;
+    try {
+        compiled = new Script(`(async () => {\n${body}\n})()`, { filename, lineOffset: -1 });
+    }
+    catch (error) {
+        return { ok: false, status: 'error', error: asErrorText(error) };
+    }
+    const context = createContext({
+        agent: async () => null,
+        parallel: async (items) => {
+            if (!Array.isArray(items))
+                return items;
+            const output = [];
+            for (const item of items) {
+                try {
+                    if (typeof item === 'function')
+                        output.push(await item());
+                    /* c8 ignore start -- job-map prelude converts objects to thunks */
+                    else
+                        output.push(item);
+                    /* c8 ignore stop */
+                }
+                catch {
+                    output.push(null);
+                }
+            }
+            return output;
+        },
+        pipeline: async (items, ...stages) => {
+            const list = Array.isArray(items) ? items : [];
+            const output = [];
+            for (let index = 0; index < list.length; index += 1) {
+                let value = list[index];
+                try {
+                    for (const stage of stages)
+                        value = await stage(value, list[index], index);
+                    output.push(value);
+                }
+                catch {
+                    output.push(null);
+                }
+            }
+            return output;
+        },
+        phase: () => undefined,
+        log: () => undefined,
+        args: args ?? {},
+        pause: gate,
+        await_user: gate,
+        budget: () => ({ total: 128, spent: 0, reserved: 0, remaining: 128 }),
+        write_scratch_file: async () => undefined,
+        read_scratch_file: async () => '',
+    });
+    try {
+        const pending = Promise.resolve(compiled.runInContext(context, { timeout: timeoutMs }));
+        const value = await Promise.race([
+            pending,
+            new Promise((_, reject) => {
+                const timer = setTimeout(() => reject(new Error('canned workflow validation timed out')), timeoutMs);
+                /* c8 ignore next -- unref is always present in Node */
+                timer.unref?.();
+            }),
+        ]);
+        return { ok: true, status: 'completed', value: hostJson(value) };
+    }
+    catch (error) {
+        if (isWouldPause(error))
+            return { ok: true, status: 'would-pause', value: error.message };
+        return { ok: false, status: 'error', error: asErrorText(error) };
+    }
+}
+//# sourceMappingURL=canned-validate.js.map

package/lib/types/supervisor/canned-validate.js.map

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

package/lib/types/supervisor/completion-notice.d.ts

@@ -0,0 +1,49 @@
+import type { WorkflowRunValueView } from './types.js';
+import type { WorkflowRunHeadRecord, WorkflowRunStore } from './storage/manifest-types.js';
+export interface WorkflowCompletionNoticeInput {
+    readonly runId: string;
+    readonly sessionId?: string;
+    readonly displayName: string;
+    readonly status: 'completed' | 'failed' | 'cancelled' | 'interrupted';
+    readonly report?: string;
+    readonly result?: WorkflowRunValueView;
+    readonly error?: string;
+    /** Exact process-local owner. It is deliberately never persisted. */
+    readonly parent?: any;
+    /** Claimed terminal row returned by commitTerminalAndClaimNotice. */
+    readonly head?: WorkflowRunHeadRecord;
+    /** Legacy fallback for embedders without a descriptor-backed report read. */
+    readonly scratchDir?: string;
+}
+export interface CompletionNoticeOptions {
+    readonly maxBytes?: number;
+    readonly maxItems?: number;
+    readonly maxCohortBytes?: number;
+}
+/** Render one bounded owner-visible notice while preserving the dashboard footer. */
+export declare function renderWorkflowCompletionNotice(input: WorkflowCompletionNoticeInput, maxBytes?: number, report?: string | undefined): string;
+/**
+ * At-most-once completion outbox. Durable `claimed` state authorizes one
+ * enqueue; this class finalizes that exact claim as delivered or abandoned.
+ */
+export declare class WorkflowCompletionNotifier {
+    private readonly ctx;
+    private readonly store?;
+    private readonly options;
+    private readonly reservations;
+    private readonly attempted;
+    private readonly owners;
+    private disposed;
+    private disposal?;
+    constructor(ctx: any, storeOrOptions?: WorkflowRunStore | CompletionNoticeOptions, maybeOptions?: CompletionNoticeOptions);
+    reserve(key: string | object, parent: any): void;
+    notify(input: WorkflowCompletionNoticeInput): Promise<boolean>;
+    private schedule;
+    private takeCohort;
+    private drainOwner;
+    private finalizeDirect;
+    private finalize;
+    whenOwnerQuiescent(agent: any, signal?: AbortSignal): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=completion-notice.d.ts.map

package/lib/types/supervisor/completion-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-notice.d.ts","sourceRoot":"","sources":["../../../src/supervisor/completion-notice.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAEV,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,6BAA6B,CAAA;AAEpC,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAC,QAAQ,GAAC,WAAW,GAAC,aAAa,CAAA;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAA;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,CAAA;IACrB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,CAAC,EAAE,qBAAqB,CAAA;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AAqED,qFAAqF;AACrF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,6BAA6B,EACpC,QAAQ,SAAS,EACjB,MAAM,qBAAe,GACpB,MAAM,CAQR;AAOD;;;GAGG;AACH,qBAAa,0BAA0B;IAUnC,OAAO,CAAC,QAAQ,CAAC,GAAG;IATtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0C;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAe;gBAGb,GAAG,EAAE,GAAG,EACzB,cAAc,CAAC,EAAE,gBAAgB,GAAG,uBAAuB,EAC3D,YAAY,GAAE,uBAA4B;IAc5C,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI;IAO1C,MAAM,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BpE,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,UAAU;YAgBJ,UAAU;YAkDV,cAAc;YAId,QAAQ;IAiChB,kBAAkB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB/B"}