@cotal-ai/core 0.22.0 → 0.24.0

package/dist/run-journal.js.map

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

package/dist/run-migration.d.ts

@@ -0,0 +1,85 @@
+import type { KV } from "@nats-io/kv";
+/** One journal entry the new source no longer reaches, as the record keeps it. */
+export interface MigrationOrphanValue {
+    readonly step: string;
+    readonly kind: string;
+    readonly verdict: "ignored" | "kept" | "rejected";
+    readonly code?: string;
+}
+export interface RunMigrationSpecValue {
+    readonly v: 1;
+    readonly run: string;
+    /**
+     * The program hash the run was on, as the CALLER states it.
+     *
+     * Optional, and the reason is a gap rather than a preference: a program-hash pin on the run
+     * record is declared and unbuilt, and `RunSpecValue` deliberately never invented one, so nothing
+     * here can VERIFY this. Recorded as the caller's claim when supplied and absent when not — an
+     * unverifiable field labelled as such beats one this file computes from a source it was never
+     * given.
+     */
+    readonly fromHash?: string;
+    /** The hash of the source the run is moving TO. Computed from that source, so not a claim. */
+    readonly toHash: string;
+    readonly at: number;
+    /** How many recorded entries the walk accounted for. */
+    readonly consumedThrough: number;
+    readonly orphans: readonly MigrationOrphanValue[];
+    /** What the caller overrode, verbatim, because an override is a person's decision. */
+    readonly overrides: readonly string[];
+    readonly actor: string;
+}
+export interface RunMigrationStatusValue {
+    readonly v: 1;
+    /** When the run actually advanced. */
+    readonly appliedAt: number;
+    /** WHICH driver advanced it, so an application can be traced to the holder that made it. */
+    readonly by: string;
+    readonly observedSpecRevision: number;
+}
+/**
+ * The id one migration is filed under: a digest of the report itself.
+ *
+ * Everything the decision consists of goes in, so a re-run of the same check over the same journal
+ * re-derives the same id and its create-only write lands on its own record. Change what was found
+ * or what was overridden and it is a different migration, which is exactly right — it is.
+ */
+export declare function runMigrationId(value: Omit<RunMigrationSpecValue, "at">): string;
+/**
+ * File one migration's report, create-only.
+ *
+ * An identical retry is this attempt's own earlier write and is not a conflict. Differing content
+ * under one id would mean two decisions claiming one identity, which is refused rather than
+ * overwritten: a migration that could be rewritten would be a draft, and what it records is what a
+ * person authorised to discard.
+ */
+export declare function writeRunMigration(kv: KV, endpoint: string, migrationId: string, value: RunMigrationSpecValue): Promise<{
+    key: string;
+    created: boolean;
+}>;
+export interface RunMigrationRead {
+    readonly migrationId: string;
+    readonly spec: RunMigrationSpecValue;
+    readonly specRevision: number;
+    readonly applied?: RunMigrationStatusValue;
+}
+/** Read one migration with its application, or `undefined` when nothing was filed under this id. */
+export declare function readRunMigration(kv: KV, endpoint: string, runId: string, migrationId: string): Promise<RunMigrationRead | undefined>;
+/**
+ * Every migration filed on one run, oldest first.
+ *
+ * ORDER IS THE POINT of an append-only history: a run's second migration is only interpretable
+ * beside its first. `at` decides, then the id, so two filed in the same millisecond still come back
+ * in one fixed order rather than in whatever order the store enumerated its keys.
+ */
+export declare function listRunMigrations(kv: KV, endpoint: string, runId: string): Promise<RunMigrationRead[]>;
+/**
+ * Record that a driver applied this migration.
+ *
+ * **The create-only CAS is the arbiter and it is the only one.** Two drivers racing to apply one
+ * migration both read no status and both write; the store decides, and the loser gets a loud
+ * conflict rather than a second belief about a run that moved once. A "has it been applied?" read
+ * before the write would be a fast path that lies under exactly the race it looks like it prevents.
+ */
+export declare function markRunMigrationApplied(kv: KV, endpoint: string, runId: string, migrationId: string, by: string, at: number): Promise<void>;
+//# sourceMappingURL=run-migration.d.ts.map

package/dist/run-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-migration.d.ts","sourceRoot":"","sources":["../src/run-migration.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAatC,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,sFAAsF;IACtF,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IACd,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAcD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,GAAG,MAAM,CAE/E;AAkDD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAgB5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAED,oGAAoG;AACpG,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAcvC;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkB7B;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/run-migration.js

@@ -0,0 +1,201 @@
+/**
+ * The MIGRATION record: a run's move onto edited source, and who authorised what it discarded.
+ *
+ * **Why it is its own kind rather than a field on the run.** A records-KV record has two halves and
+ * a migration fits neither. The spec half is what a thing IS, decided once and never re-decided —
+ * a run's pins. The status half is what it is DOING, last-value-wins, rewritten by the driver on
+ * every state change. A migration is append-only HISTORY with an actor on it, and a run can be
+ * migrated more than once: putting it in the status half would let the second migration erase the
+ * first, and putting it in the spec half would collide with what the spec already says.
+ *
+ * **The id is derived from the report's own content.** A migration is decided by a dry walk that a
+ * crash can force to be re-run, so the same decision must land on the same record instead of filing
+ * a second one — and a counter would need somebody to allocate it, which is a second arbiter for a
+ * fact the content already determines. Identical retry, identical id, create-only write: the same
+ * shape as a notice, for the same reason.
+ *
+ * **Deciding and applying are separate, and the CAS is the arbiter of the second.** The spec is the
+ * report — what the check found, immutable. The status is the COMMIT: which driver actually
+ * advanced the run. Two drivers racing to apply one migration both find no status and both write;
+ * the store decides and the loser gets a conflict rather than a second belief.
+ */
+import { createHash } from "node:crypto";
+import { EpEnvelopeError } from "./endpoint-envelope.js";
+import { assertIdToken } from "./endpoint-subjects.js";
+import { RECORD_KINDS, createRecordEntry, readRecord, recordSpecKey, recordStatusKey, assertStatusValue, } from "./endpoint-records.js";
+import { canonicalJson } from "./canonical.js";
+const SPEC_KEYS = ["v", "run", "fromHash", "toHash", "at", "consumedThrough", "orphans", "overrides", "actor"];
+const STATUS_KEYS = ["v", "appliedAt", "by", "observedSpecRevision"];
+function qualifiers(endpoint, runId, migrationId) {
+    return [endpoint, runId, migrationId];
+}
+/** base64url of the sha256, truncated to 43 — an `<id-token>` by construction, as elsewhere. */
+function digestId(canonical) {
+    return createHash("sha256").update(canonical, "utf8").digest("base64url").slice(0, 43);
+}
+/**
+ * The id one migration is filed under: a digest of the report itself.
+ *
+ * Everything the decision consists of goes in, so a re-run of the same check over the same journal
+ * re-derives the same id and its create-only write lands on its own record. Change what was found
+ * or what was overridden and it is a different migration, which is exactly right — it is.
+ */
+export function runMigrationId(value) {
+    return digestId(canonicalJson(value));
+}
+function parseSpec(raw, key) {
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw))
+        throw new EpEnvelopeError("internal", `migration ${key} is not an object; garbled state never authorizes`);
+    const o = raw;
+    for (const k of Object.keys(o))
+        if (!SPEC_KEYS.includes(k))
+            throw new EpEnvelopeError("internal", `migration ${key} carries the unknown field "${k}"; record schemas are closed`);
+    if (o.v !== 1 || typeof o.run !== "string" || typeof o.toHash !== "string" || o.toHash.length === 0
+        || typeof o.actor !== "string" || o.actor.length === 0
+        || typeof o.at !== "number" || !Number.isSafeInteger(o.at) || o.at < 0
+        || typeof o.consumedThrough !== "number" || !Number.isSafeInteger(o.consumedThrough) || o.consumedThrough < 0
+        || !Array.isArray(o.orphans) || !Array.isArray(o.overrides)
+        || (o.fromHash !== undefined && typeof o.fromHash !== "string")) {
+        throw new EpEnvelopeError("internal", `migration ${key} is malformed; garbled state never authorizes`);
+    }
+    return {
+        v: 1,
+        run: o.run,
+        ...(o.fromHash !== undefined ? { fromHash: o.fromHash } : {}),
+        toHash: o.toHash,
+        at: o.at,
+        consumedThrough: o.consumedThrough,
+        orphans: o.orphans,
+        overrides: o.overrides,
+        actor: o.actor,
+    };
+}
+function parseStatus(raw, key) {
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw))
+        throw new EpEnvelopeError("internal", `migration status ${key} is not an object; garbled state never authorizes`);
+    const o = raw;
+    for (const k of Object.keys(o))
+        if (!STATUS_KEYS.includes(k))
+            throw new EpEnvelopeError("internal", `migration status ${key} carries the unknown field "${k}"; record schemas are closed`);
+    if (o.v !== 1 || typeof o.appliedAt !== "number" || !Number.isSafeInteger(o.appliedAt) || o.appliedAt < 0
+        || typeof o.by !== "string" || o.by.length === 0)
+        throw new EpEnvelopeError("internal", `migration status ${key} is malformed; garbled state never authorizes`);
+    return {
+        v: 1,
+        appliedAt: o.appliedAt,
+        by: o.by,
+        observedSpecRevision: o.observedSpecRevision,
+    };
+}
+/**
+ * File one migration's report, create-only.
+ *
+ * An identical retry is this attempt's own earlier write and is not a conflict. Differing content
+ * under one id would mean two decisions claiming one identity, which is refused rather than
+ * overwritten: a migration that could be rewritten would be a draft, and what it records is what a
+ * person authorised to discard.
+ */
+export async function writeRunMigration(kv, endpoint, migrationId, value) {
+    assertIdToken(migrationId, "migrationId");
+    const key = recordSpecKey(RECORD_KINDS.migration, qualifiers(endpoint, value.run, migrationId));
+    try {
+        await createRecordEntry(kv, key, value);
+        return { key, created: true };
+    }
+    catch (e) {
+        if (!(e instanceof EpEnvelopeError && e.code === "conflict"))
+            throw e;
+        const existing = await kv.get(key);
+        if (!existing || existing.operation !== "PUT")
+            throw new EpEnvelopeError("internal", `migration ${key} lost its create CAS but is not readable; reconcile the store`);
+        const parsed = parseSpec(JSON.parse(new TextDecoder().decode(existing.value)), key);
+        if (canonicalJson(parsed) !== canonicalJson(value))
+            throw new EpEnvelopeError("conflict", `migration ${key} already exists with a different report; a migration id is derived from what the check found, so a differing one under the same id is never overwritten`);
+        return { key, created: false };
+    }
+}
+/** Read one migration with its application, or `undefined` when nothing was filed under this id. */
+export async function readRunMigration(kv, endpoint, runId, migrationId) {
+    const q = qualifiers(endpoint, runId, migrationId);
+    const merged = await readRecord(kv, RECORD_KINDS.migration, q);
+    if (merged === undefined)
+        return undefined;
+    const spec = parseSpec(merged.spec.value, recordSpecKey(RECORD_KINDS.migration, q));
+    const status = merged.status === undefined
+        ? undefined
+        : parseStatus(merged.status.value, recordStatusKey(RECORD_KINDS.migration, q));
+    return {
+        migrationId,
+        spec,
+        specRevision: merged.spec.revision,
+        ...(status !== undefined ? { applied: status } : {}),
+    };
+}
+/**
+ * Every migration filed on one run, oldest first.
+ *
+ * ORDER IS THE POINT of an append-only history: a run's second migration is only interpretable
+ * beside its first. `at` decides, then the id, so two filed in the same millisecond still come back
+ * in one fixed order rather than in whatever order the store enumerated its keys.
+ */
+export async function listRunMigrations(kv, endpoint, runId) {
+    const prefix = recordSpecKey(RECORD_KINDS.migration, qualifiers(endpoint, runId, "m")).slice(0, -"m.spec".length);
+    // ONE wildcard token: only the migration id varies under this prefix, and a KV filter's `*`
+    // matches exactly one token — one too few matches a key shape that does not exist and silently
+    // returns nothing.
+    const seen = await kv.keys(`${prefix}*.spec`);
+    const ids = [];
+    for await (const key of seen) {
+        const parts = key.split(".");
+        ids.push(parts[parts.length - 2]);
+    }
+    const found = [];
+    for (const id of ids) {
+        const one = await readRunMigration(kv, endpoint, runId, id);
+        if (one !== undefined)
+            found.push(one);
+    }
+    found.sort((a, b) => (a.spec.at - b.spec.at) || (a.migrationId < b.migrationId ? -1 : a.migrationId > b.migrationId ? 1 : 0));
+    return found;
+}
+/**
+ * Record that a driver applied this migration.
+ *
+ * **The create-only CAS is the arbiter and it is the only one.** Two drivers racing to apply one
+ * migration both read no status and both write; the store decides, and the loser gets a loud
+ * conflict rather than a second belief about a run that moved once. A "has it been applied?" read
+ * before the write would be a fast path that lies under exactly the race it looks like it prevents.
+ */
+export async function markRunMigrationApplied(kv, endpoint, runId, migrationId, by, at) {
+    const q = qualifiers(endpoint, runId, migrationId);
+    const specKey = recordSpecKey(RECORD_KINDS.migration, q);
+    const statusKey = recordStatusKey(RECORD_KINDS.migration, q);
+    const merged = await readRecord(kv, RECORD_KINDS.migration, q);
+    if (merged === undefined)
+        throw new EpEnvelopeError("failed-precondition", `no migration is filed at ${specKey}; an application names the migration it applied`);
+    const value = assertStatusValue({
+        v: 1,
+        appliedAt: at,
+        by,
+        observedSpecRevision: merged.spec.revision,
+    });
+    try {
+        await createRecordEntry(kv, statusKey, value);
+    }
+    catch (e) {
+        if (!(e instanceof EpEnvelopeError && e.code === "conflict"))
+            throw e;
+        // The CAS lost, and only NOW is anything read — the same shape as the notice writer, and for
+        // the same reason: a "has it been applied?" check before the write would be a fast path that
+        // lies under exactly the race it looks like it prevents. What the read decides is who lost. A
+        // driver that finds its OWN application is looking at its own earlier attempt, which is the
+        // retry a crash between the two writes forces, and that is not a conflict. A different driver
+        // is the real race, and it hears about it.
+        const existing = await readRecord(kv, RECORD_KINDS.migration, q);
+        const already = existing?.status === undefined ? undefined : parseStatus(existing.status.value, statusKey);
+        if (already?.by === by)
+            return;
+        throw new EpEnvelopeError("conflict", `migration ${specKey} was already applied by ${already?.by ?? "another driver"}; a run moves once, and the store decides which driver moved it`);
+    }
+}
+//# sourceMappingURL=run-migration.js.map

package/dist/run-migration.js.map

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

package/dist/run-notice.d.ts

@@ -0,0 +1,84 @@
+import type { KV } from "@nats-io/kv";
+/** The bounded decision itself. The bound is the language's (L3043) and is enforced before a
+ *  notice is ever written; this type is the shape it arrives in. */
+export interface RunNoticeFact {
+    readonly decision: string;
+    readonly outcome: string;
+    readonly detail?: Readonly<Record<string, string | number | boolean>>;
+}
+export interface RunNoticeSpecValue {
+    readonly v: 1;
+    readonly run: string;
+    /** The step that decided it, in the journal's own key vocabulary (`/notify:told#0`). */
+    readonly step: string;
+    /** The addressee's agent NAME, kept in the value because the key holds only its digest. */
+    readonly addressee: string;
+    readonly fact: RunNoticeFact;
+    readonly at: number;
+}
+export interface RunNoticeStatusValue {
+    readonly v: 1;
+    /** When the addressee's turn actually carried it. */
+    readonly consumedAt: number;
+    /** WHICH turn carried it, so a consumption can be traced to the goal that did it. */
+    readonly by: string;
+    readonly observedSpecRevision: number;
+}
+/** The key token standing for an agent. Derived from the name, never the name itself. */
+export declare function noticeAddresseeId(agent: string): string;
+/**
+ * The id one notice is filed under.
+ *
+ * Derived from the step's own request id and the addressee, so the same `notify` call re-run after
+ * a crash re-derives exactly the same ids and its create-only writes land on their own records. One
+ * call to N agents writes N notices, and the addressee is what separates them.
+ */
+export declare function runNoticeId(requestId: string, addressee: string): string;
+/**
+ * File one notice, create-only.
+ *
+ * A retry of the same notice is not a conflict: the id is derived from the step's request id and
+ * the addressee, so an existing record with identical bytes is this run's own earlier attempt.
+ * Different bytes under the same id would mean two different decisions claiming one identity, which
+ * is refused rather than overwritten — a notice that could be rewritten would be a message.
+ */
+export declare function writeRunNotice(kv: KV, endpoint: string, noticeId: string, value: RunNoticeSpecValue): Promise<{
+    key: string;
+    created: boolean;
+}>;
+export interface RunNoticeRead {
+    readonly noticeId: string;
+    readonly spec: RunNoticeSpecValue;
+    readonly specRevision: number;
+    readonly consumed?: RunNoticeStatusValue;
+}
+/** Read one notice with its consumption, or `undefined` when nothing was filed under this id. */
+export declare function readRunNotice(kv: KV, endpoint: string, runId: string, addressee: string, noticeId: string): Promise<RunNoticeRead | undefined>;
+/**
+ * Every notice addressed to one agent on one run, oldest first.
+ *
+ * ORDER IS PART OF THE CONTRACT, because the render is a table a person or an agent reads top to
+ * bottom: `at` first, then the notice id, so two notices filed in the same millisecond still come
+ * back in one fixed order rather than in whatever order the store enumerated its keys.
+ */
+export declare function listRunNotices(kv: KV, endpoint: string, runId: string, addressee: string): Promise<RunNoticeRead[]>;
+/**
+ * Every notice filed on one RUN, whoever it was addressed to, oldest first.
+ *
+ * The migrate rule asks a question the journal cannot answer on its own: a `notify` entry
+ * records an input HASH, not the agents it addressed, so "has this orphaned notify been consumed?"
+ * cannot be asked per addressee. It is asked per RUN, and each notice's own `step` says which entry
+ * it came from — which is why the step is in the value rather than only in the key.
+ */
+export declare function listRunNoticesForRun(kv: KV, endpoint: string, runId: string): Promise<RunNoticeRead[]>;
+/**
+ * Record that a turn carried this notice.
+ *
+ * **The create-only CAS is the arbiter, and it is the only one.** Two turns racing to claim one
+ * notice both read no status and both write; the store decides, and the loser gets a loud conflict.
+ * A "has it been consumed already?" check before the write would be a fast path that lies under
+ * exactly the race it looks like it is preventing, so there is one gate rather than two — which
+ * turn delivered a notice is a fact about something that happened once.
+ */
+export declare function markRunNoticeConsumed(kv: KV, endpoint: string, runId: string, addressee: string, noticeId: string, by: string, at: number): Promise<void>;
+//# sourceMappingURL=run-notice.d.ts.map

package/dist/run-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-notice.d.ts","sourceRoot":"","sources":["../src/run-notice.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAatC;oEACoE;AACpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IACd,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAeD,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AA6CD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAiB5C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC1C;AAED,iGAAiG;AACjG,wBAAsB,aAAa,CACjC,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAEpC;AAkBD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,EAAE,CAAC,CAK1B;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,EAAE,CAAC,CAK1B;AAsBD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAcf"}