@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5685

package/dist/delegation/questions.js

@@ -0,0 +1,56 @@
+import { commandText } from '../home/command.js';
+import { createHash } from 'node:crypto';
+/** A worker's question travels to its owning parent as a conversation request (#505). Its ID
+ * derives from the worker and the ask's event seq, so routing it again after a restart finds
+ * the same message instead of asking twice. */
+export function questionMessage(input) {
+    const id = uuidFrom(`worker-question:${input.workerRunId}:${input.askSeq}`);
+    const text = formatQuestionText(input.workerRunId, id, input.request);
+    const requestHash = createHash('sha256')
+        .update(JSON.stringify({ senderRunId: input.workerRunId, recipientRunId: input.parentRunId, question: input.request }))
+        .digest('hex');
+    // No deadline: a question settles when it is answered or falls back to a human.
+    return { id, senderRunId: input.workerRunId, recipientRunId: input.parentRunId, kind: 'request', text,
+        createdAt: input.now, requestHash, state: 'accepted', question: input.request };
+}
+/** What the parent reads: the context, the questions, their options, and the exact reply command. */
+export function formatQuestionText(workerRunId, messageId, request) {
+    const lines = [`Your worker ${workerRunId} is waiting for your answer:`];
+    // hearsay-tools/cezarion#1458: the draft or findings the question depends on come first.
+    if (request.context !== undefined)
+        lines.push('Context:', request.context, '');
+    request.questions.forEach((question, index) => {
+        // hearsay-tools/cezarion#1234: a question without options is open; multiSelect needs options.
+        const hint = !question.options ? ' (open question: answer in your own words)' : question.multiSelect ? ' (choose one or more)' : '';
+        lines.push(`${index + 1}. [${question.header}] ${question.question}${hint}`);
+        for (const option of question.options ?? [])
+            lines.push(`   - ${option.label}${option.description ? `: ${option.description}` : ''}`);
+    });
+    const format = request.questions.map(question => `${question.header}: ${question.options ? '<option>' : '<your answer>'}`).join('\n');
+    lines.push(`Answer with one line per question, exactly as the worker reads a human answer:\n${format}`);
+    lines.push(commandText(`Send it with: cez message reply ${workerRunId} '<answer>' --id <new-message-UUID> --request-id ${messageId}`));
+    lines.push('If you cannot decide, ask the human with your own question, then reply with their answer.');
+    return lines.join('\n');
+}
+/** Only a reply naming this question answers it; progress and follow-ups never do. */
+export function answersQuestion(message, input) {
+    return !!message.question && input.conversation?.kind === 'reply' && input.conversation.requestId === message.id;
+}
+/** Routed questions still awaiting an answer. Each one holds a reserved conversation slot, and
+ * a slot in its worker's inbox, for its reply: otherwise ordinary traffic could fill both and
+ * leave a question nobody can answer (#505). */
+export function openQuestions(state) {
+    return state.messages.filter(message => message.question && !state.outcomes.some(outcome => outcome.requestId === message.id));
+}
+/** Ledger room the open requests hold for their replies: every accepted request with no outcome,
+ *  a worker's question among them (hearsay-tools/cezarion#1990 review). A reply spends its own. */
+export function reservedReplies(state) {
+    return state.messages.filter(message => message.kind === 'request' && message.state === 'accepted' && !state.outcomes.some(outcome => outcome.requestId === message.id)).length;
+}
+/** A UUID-shaped (version 4 layout) identifier derived from a stable key. */
+export function uuidFrom(key) {
+    const hex = createHash('sha256').update(key).digest('hex');
+    const variant = ((parseInt(hex[16], 16) & 0x3) | 0x8).toString(16);
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-4${hex.slice(13, 16)}-${variant}${hex.slice(17, 20)}-${hex.slice(20, 32)}`;
+}
+//# sourceMappingURL=questions.js.map

package/dist/delegation/questions.js.map

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

package/dist/delegation/readiness.d.ts

@@ -0,0 +1,13 @@
+import type { WorkerCollectedResult } from '../contract/index.js';
+import type { RunRecord } from '../runs/store.ts';
+/** Status alone never attests process exit, and collecting live output never
+ * acknowledges the eventual result even when the revision number is unchanged. */
+export declare function parentReadiness(parent: RunRecord, observations: ReadonlyArray<{
+    workerId: string;
+    run?: RunRecord | undefined;
+    terminated: boolean;
+    result?: WorkerCollectedResult | undefined;
+}>): Array<{
+    workerId: string;
+    reason: 'outstanding' | 'uncollected';
+}>;

package/dist/delegation/readiness.js

@@ -0,0 +1,19 @@
+import { workerRevision } from './results.js';
+/** Status alone never attests process exit, and collecting live output never
+ * acknowledges the eventual result even when the revision number is unchanged. */
+export function parentReadiness(parent, observations) {
+    if (parent.delegation?.role !== 'root')
+        return [];
+    return observations.flatMap(({ workerId, run, terminated, result }) => {
+        if (!run)
+            return result?.settled && result.cleanup === 'complete' ? [] : [{ workerId, reason: 'outstanding' }];
+        if (run.delegation?.role !== 'worker' || run.delegation.parentRunId !== parent.id ||
+            !['review', 'done', 'failed', 'cancelled'].includes(run.status) || !terminated) {
+            return [{ workerId, reason: 'outstanding' }];
+        }
+        return result?.settled && result.parentRunId === parent.id && result.workerId === workerId &&
+            result.revision === workerRevision(run) && result.status === run.status
+            ? [] : [{ workerId, reason: 'uncollected' }];
+    });
+}
+//# sourceMappingURL=readiness.js.map

package/dist/delegation/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../src/delegation/readiness.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;kFACkF;AAClF,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,YAEjD;IACA,IAAI,MAAM,CAAC,UAAU,EAAE,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAClD,OAAO,YAAY,CAAC,OAAO,CAA8D,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE;QACjI,IAAI,CAAC,GAAG;YAAE,OAAO,MAAM,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC,CAAC;QACxH,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,KAAK,MAAM,CAAC,EAAE;YAC/E,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACjF,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,MAAM,EAAE,OAAO,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;YACxF,MAAM,CAAC,QAAQ,KAAK,cAAc,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;YACvE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/delegation/results.d.ts

@@ -0,0 +1,13 @@
+import type { WorkerCollectedResult } from '../contract/index.js';
+import type { RunEvent, RunRecord, RunStore } from '../runs/store.ts';
+export declare const workerRevision: (run: RunRecord) => number;
+/** The text of a top-level assistant message event, v1 `text` or v2 `item.completed`; the newest
+ *  one is what `collect` reports and what a park notice quotes (hearsay-tools/cezarion#1327). */
+export declare function topLevelAssistantText(event: RunEvent): string | undefined;
+/** Snapshot collection is deliberately read-only until the service rechecks lifecycle identity. */
+export declare function collectWorkerEvidence(repoRoot: string, store: RunStore, run: RunRecord): Promise<{
+    result: WorkerCollectedResult;
+    diffSnapshot?: string;
+}>;
+/** History deletion retains observation bytes, not attachment files or live Git refs. */
+export declare function revalidateRetainedWorkerResult(repoRoot: string, previous: WorkerCollectedResult, dataDir?: string): Promise<WorkerCollectedResult>;

package/dist/delegation/results.js

@@ -0,0 +1,153 @@
+import { projectPaths } from '../project-paths.js';
+import { execFile } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { isAttachmentFileName, resolveAttachmentPath } from '../workflows/attachment-path.js';
+import { readOwnedDiff, verifyOwnedWorkspace } from './workspace.js';
+import { artifactDirectory, listArtifacts, readArtifact } from '../artifacts/store.js';
+export const workerRevision = (run) => run.delegation?.role === 'worker' ? run.delegation.executionRevision ?? 0 : 0;
+/** The text of a top-level assistant message event, v1 `text` or v2 `item.completed`; the newest
+ *  one is what `collect` reports and what a park notice quotes (hearsay-tools/cezarion#1327). */
+export function topLevelAssistantText(event) {
+    const item = event.item;
+    const text = event.type === 'text' && !event.parentItemId ? event.text
+        : event.type === 'item.completed' && item?.kind === 'message' && item.role === 'assistant' && item.parentItemId === undefined ? item.text : undefined;
+    return typeof text === 'string' ? text : undefined;
+}
+/** Snapshot collection is deliberately read-only until the service rechecks lifecycle identity. */
+export async function collectWorkerEvidence(repoRoot, store, run) {
+    if (run.delegation?.role !== 'worker')
+        throw Error('missing worker ownership');
+    const delegation = run.delegation;
+    const previous = store.readWorkerResult(delegation.parentRunId, run.id);
+    // One async read (#880): an archived transcript decodes with the async brotli API.
+    const allEvents = await store.readEventsAsync(run.id);
+    const events = allEvents.filter(event => event.seq > (delegation.executionStartSeq ?? -1));
+    const summary = latestAssistantSummary(events);
+    const destroyed = delegation.destroy?.phase === 'complete';
+    const workspaceRemoved = !!delegation.destroy && !delegation.destroy.remaining.includes('worktree');
+    const { lastExecutionOutcome, settled } = executionOutcome(store, run);
+    const head = await readWorkerHead(repoRoot, run, previous, workspaceRemoved);
+    const { diff, diffSnapshot } = await readWorkerDiff(repoRoot, store, run, delegation, { destroyed, workspaceRemoved });
+    const artifacts = await listWorkerArtifacts(store.sourceDataDir(run.id), run, delegation, allEvents);
+    return { result: {
+            workerId: run.id, parentRunId: delegation.parentRunId, revision: workerRevision(run), observedAt: new Date().toISOString(),
+            status: run.status, outcome: destroyed ? 'destroyed' : lastExecutionOutcome, lastExecutionOutcome,
+            partial: !settled || run.status === 'failed' || run.status === 'cancelled', settled,
+            ...(run.error ? { error: run.error.slice(0, 2000) } : {}),
+            ...(run.runner ? { backend: run.runner } : {}), ...(run.model ? { model: run.model } : {}),
+            baselineSha: delegation.workspace.baselineSha, workspace: { ...delegation.workspace, state: workspaceRemoved ? 'deleted' : head.state === 'available' ? 'available' : 'unavailable' }, cleanup: delegation.destroy?.phase ?? 'retained',
+            summary, head, diff, artifacts,
+        }, ...(diffSnapshot === undefined ? {} : { diffSnapshot }) };
+}
+/** The newest non-blank top-level assistant text of this execution, bounded to 4000 characters. */
+function latestAssistantSummary(events) {
+    let summary = { state: 'unavailable', reason: 'no-assistant-output' };
+    for (const event of events) {
+        const text = topLevelAssistantText(event);
+        if (text?.trim())
+            summary = { state: 'available', text: text.slice(0, 4000), source: 'assistant', seq: event.seq, truncated: text.length > 4000 };
+    }
+    return summary;
+}
+/** The public status as an execution outcome; settled only once the private execution record is complete. */
+function executionOutcome(store, run) {
+    const lastExecutionOutcome = run.status === 'review' ? 'review-ready' : run.status === 'done' ? 'completed'
+        : run.status === 'failed' ? 'failed' : run.status === 'cancelled' ? 'cancelled' : 'running';
+    const settled = lastExecutionOutcome !== 'running' && store.readWorkerExecution(run.id)?.phase === 'complete';
+    return { lastExecutionOutcome, settled };
+}
+/** The owned workspace's verified HEAD. A failed read keeps the last collected SHA: `unverified`, or `deleted` once the worktree is removed. */
+async function readWorkerHead(repoRoot, run, previous, workspaceRemoved) {
+    const historicalSha = previous?.head && 'sha' in previous.head ? previous.head.sha : undefined;
+    let head = { state: workspaceRemoved ? 'deleted' : 'unavailable', reason: 'missing', ...(historicalSha ? { sha: historicalSha } : {}) };
+    try {
+        const workspace = await verifyOwnedWorkspace(repoRoot, run);
+        const sha = await new Promise((resolve, reject) => execFile('git', ['rev-parse', '--verify', 'HEAD^{commit}'], { cwd: workspace.path, encoding: 'utf8', timeout: 30_000, maxBuffer: 1024 }, (error, stdout) => error ? reject(error) : resolve(stdout.trim())));
+        if (!/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/.test(sha))
+            throw Error('invalid HEAD');
+        head = { state: 'available', sha };
+    }
+    catch {
+        if (!workspaceRemoved)
+            head = { state: 'unavailable', reason: 'unverified', ...(historicalSha ? { sha: historicalSha } : {}) };
+    }
+    return head;
+}
+/** The owned workspace's diff, or this revision's retained snapshot when the live read fails. */
+async function readWorkerDiff(repoRoot, store, run, delegation, cleanup) {
+    let diff = { state: cleanup.workspaceRemoved ? 'deleted' : 'unavailable', reason: 'missing' };
+    let diffSnapshot;
+    try {
+        const observation = await readOwnedDiff(repoRoot, run);
+        diffSnapshot = observation.diff;
+        const snapshotId = randomUUID();
+        diff = { state: 'available', snapshotId, path: store.workerResultSnapshotPath(delegation.parentRunId, run.id, snapshotId), truncated: observation.truncated };
+    }
+    catch {
+        if (!cleanup.destroyed)
+            diff = { state: 'unavailable', reason: 'unverified' };
+    }
+    // Re-read after the live workspace checks. A concurrent reclaim can commit a
+    // snapshot while this collect still holds a `previous` captured as undefined.
+    if (diffSnapshot === undefined) {
+        const stored = store.readWorkerResult(delegation.parentRunId, run.id);
+        if (stored?.revision === workerRevision(run) && stored.diff.state === 'available') {
+            const retained = store.readWorkerResultDiff(delegation.parentRunId, run.id);
+            if (retained !== undefined) {
+                diffSnapshot = retained;
+                diff = { ...stored.diff, snapshotId: randomUUID() };
+            }
+        }
+    }
+    return { diff, diffSnapshot };
+}
+/** Published artifacts, newest first, then image and parent-attachment descriptors; at most 32. */
+async function listWorkerArtifacts(dataDir, run, delegation, allEvents) {
+    const ids = new Set();
+    for (const event of allEvents) {
+        if (event.type !== 'image' || typeof event.url !== 'string')
+            continue;
+        const match = event.url.match(new RegExp(`^/api/(?:v1/)?runs/${run.id}/images/([^/]+)$`));
+        if (match && isAttachmentFileName(match[1]) && match[1].length <= 255)
+            ids.add(match[1]);
+    }
+    for (const input of delegation.context?.inputs ?? [])
+        if (input.source.kind === 'parent-attachment') {
+            const name = input.path.split('/').at(-1);
+            if (isAttachmentFileName(name))
+                ids.add(name);
+        }
+    const published = await listArtifacts(artifactDirectory(dataDir, run.id), run.id);
+    const publishedItems = published.slice().reverse().map(item => ({ state: 'available', id: `published:${item.id}`, path: join(artifactDirectory(dataDir, run.id), item.id, 'content') }));
+    const items = [...publishedItems, ...[...ids].map((id) => {
+            const path = join(dataDir, 'runs', `${run.id}-images`, id);
+            if (resolveAttachmentPath(dataDir, run.id, id))
+                return { state: 'available', id, path };
+            return existsSync(path) ? { state: 'unavailable', reason: 'unreadable', id, path } : { state: 'deleted', reason: 'missing', id, path };
+        })].slice(0, 32);
+    return { state: 'available', items, truncated: ids.size + published.length > 32 };
+}
+/** History deletion retains observation bytes, not attachment files or live Git refs. */
+export async function revalidateRetainedWorkerResult(repoRoot, previous, dataDir = projectPaths(repoRoot).write) {
+    return { ...previous, observedAt: new Date().toISOString(),
+        head: previous.head.state === 'available' ? { state: 'unavailable', reason: 'unverified', sha: previous.head.sha } : previous.head,
+        diff: previous.diff.state === 'available' ? { ...previous.diff, snapshotId: randomUUID() } : previous.diff,
+        artifacts: previous.artifacts.state !== 'available' ? previous.artifacts : { ...previous.artifacts,
+            items: await Promise.all(previous.artifacts.items.map(async (item) => {
+                if (item.id.startsWith('published:')) {
+                    const available = await readArtifact(artifactDirectory(dataDir, previous.workerId), previous.workerId, item.id.slice('published:'.length));
+                    return available ? { state: 'available', id: item.id, path: item.path }
+                        : { state: 'deleted', reason: 'missing', id: item.id, path: item.path };
+                }
+                return resolveAttachmentPath(dataDir, previous.workerId, item.id)
+                    ? { state: 'available', id: item.id, path: item.path }
+                    : existsSync(join(dataDir, 'runs', `${previous.workerId}-images`, item.id))
+                        ? { state: 'unavailable', reason: 'unreadable', id: item.id, path: item.path }
+                        : { state: 'deleted', reason: 'missing', id: item.id, path: item.path };
+            })),
+        },
+    };
+}
+//# sourceMappingURL=results.js.map

package/dist/delegation/results.js.map

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

package/dist/delegation/retry-backoff.d.ts

@@ -0,0 +1,31 @@
+/**
+ * One retry schedule for the cleanup loops that have no other wake source (hearsay-tools/cezarion#879):
+ * worker destroy, terminal scratch and orphaned-generation reprobes. Each stays at its fast cadence
+ * for `fastCount` attempts, so a holder that exits soon is noticed soon, then doubles up to `capMs`
+ * and stays there. None ever stops: cezar has no exit callback for a process it did not spawn.
+ */
+export type Backoff = {
+    fastMs: number;
+    fastCount: number;
+    capMs: number;
+};
+export declare const DESTROY_BACKOFF: Backoff;
+export declare const SCRATCH_BACKOFF: Backoff;
+/** The orphan reprobe kept 15 s for its first 15 minutes before hearsay-tools/cezarion#879; that window is unchanged. */
+export declare const ORPHAN_BACKOFF: Backoff;
+/**
+ * The wait between automatic attempts to deliver wait results whose session failed
+ * (hearsay-tools/cezarion#1233). Unlike the cleanup loops above it stops: `MAX_WAKE_DELIVERY_ATTEMPTS`
+ * failed attempts settle the run, so only two retries ever wait, 15 s and then 30 s. The results are
+ * owed now, and a transient provider fault (a dropped connection, a rejected submission) usually
+ * clears within seconds; minutes would only delay a delivery that is likely to succeed.
+ */
+export declare const WAKE_RETRY_BACKOFF: Backoff;
+/** For the batched reprobes: ids that probe together keep probing together, so they share a scan. */
+export declare const noJitter: () => number;
+/** Scheduled destroy attempts after which the cockpit says the cleanup needs attention: the first capped delay. */
+export declare const DESTROY_ATTENTION_ATTEMPTS = 10;
+/** Delay before the next attempt, after `attempt` consecutive failed attempts. Past the fast window
+ * the delay is stretched by up to 10 %, never shortened, so stuck items spread out and a capped
+ * delay is never under `capMs`. */
+export declare function retryDelayMs(attempt: number, backoff: Backoff, random?: () => number): number;

package/dist/delegation/retry-backoff.js

@@ -0,0 +1,26 @@
+export const DESTROY_BACKOFF = { fastMs: 60_000, fastCount: 5, capMs: 3_600_000 };
+export const SCRATCH_BACKOFF = { fastMs: 60_000, fastCount: 5, capMs: 3_600_000 };
+/** The orphan reprobe kept 15 s for its first 15 minutes before hearsay-tools/cezarion#879; that window is unchanged. */
+export const ORPHAN_BACKOFF = { fastMs: 15_000, fastCount: 60, capMs: 3_600_000 };
+/**
+ * The wait between automatic attempts to deliver wait results whose session failed
+ * (hearsay-tools/cezarion#1233). Unlike the cleanup loops above it stops: `MAX_WAKE_DELIVERY_ATTEMPTS`
+ * failed attempts settle the run, so only two retries ever wait, 15 s and then 30 s. The results are
+ * owed now, and a transient provider fault (a dropped connection, a rejected submission) usually
+ * clears within seconds; minutes would only delay a delivery that is likely to succeed.
+ */
+export const WAKE_RETRY_BACKOFF = { fastMs: 15_000, fastCount: 1, capMs: 60_000 };
+/** For the batched reprobes: ids that probe together keep probing together, so they share a scan. */
+export const noJitter = () => 0;
+/** Scheduled destroy attempts after which the cockpit says the cleanup needs attention: the first capped delay. */
+export const DESTROY_ATTENTION_ATTEMPTS = 10;
+/** Delay before the next attempt, after `attempt` consecutive failed attempts. Past the fast window
+ * the delay is stretched by up to 10 %, never shortened, so stuck items spread out and a capped
+ * delay is never under `capMs`. */
+export function retryDelayMs(attempt, backoff, random = Math.random) {
+    const n = Math.max(0, Math.floor(attempt));
+    if (n < backoff.fastCount)
+        return backoff.fastMs;
+    return Math.min(backoff.capMs, backoff.fastMs * 2 ** (n - backoff.fastCount + 1)) * (1 + 0.1 * random());
+}
+//# sourceMappingURL=retry-backoff.js.map

package/dist/delegation/retry-backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-backoff.js","sourceRoot":"","sources":["../../src/delegation/retry-backoff.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,eAAe,GAAY,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC3F,MAAM,CAAC,MAAM,eAAe,GAAY,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC3F,yHAAyH;AACzH,MAAM,CAAC,MAAM,cAAc,GAAY,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC3F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAY,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3F,qGAAqG;AACrG,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;AAChC,mHAAmH;AACnH,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C;;mCAEmC;AACnC,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAgB,EAAE,MAAM,GAAiB,IAAI,CAAC,MAAM;IAChG,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG,OAAO,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IACjD,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,MAAM,EAAE,CAAC,CAAC;AAC3G,CAAC"}