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

package/dist/runs/legacy-waits.js

@@ -0,0 +1,335 @@
+/**
+ * Upgrade-on-read of the wait fields an older store wrote (store schemas 3, 6 and 7,
+ * spec 2026-10-17-unified-waits). `parseRunRecords` runs it before validation, and the
+ * public names stay exported from `store.ts`.
+ */
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { ciWaitSchema } from '../contract/index.js';
+import { workerWaitSchema } from '../contract/index.js';
+import { LAST_WAITS_LIMIT, TIMER_MAX_SECONDS, TIMER_MIN_SECONDS } from '../contract/index.js';
+import { applyExit } from './run-exits.js';
+/** The keys an older record used for parks. Schema 4 reads the CI and monitoring ones into
+ *  `waits`; phase 4b (hearsay-tools/cezarion#1236) reads the pending-question summary into a human
+ *  wait. None is written again (spec 2026-10-17-unified-waits, § Compatibility). */
+const LEGACY_WAIT_KEYS = ['ciWait', 'lastCiWait', 'lastCiWaitError', 'monitoringWakeAt', 'monitoringWakeCapReached', 'activity', 'hasPendingHumanAsk'];
+export const UNREADABLE_WAIT = 'Wait unavailable — a saved wait is unreadable; register a new wait.';
+/** A stored `waits`/`lastWaits` entry of kind `ci`, the kind `pr` replaced (hearsay-tools/cezarion#1425). */
+const isCiKindEntry = (entry) => !!entry && typeof entry === 'object' && entry.kind === 'ci';
+function hasCiKindEntries(row) {
+    return ['waits', 'lastWaits'].some((key) => Array.isArray(row[key]) && row[key].some(isCiKindEntry));
+}
+export function hasLegacyWaitFields(row) {
+    return !!row && typeof row === 'object' && (LEGACY_WAIT_KEYS.some((key) => key in row) || hasCiKindEntries(row) || agentWorkerWaits(row).length > 0 || rootCompletion(row) !== undefined);
+}
+/** A root's stored `delegation.completion` (the old completion gate's marker), which schema 7 reads
+ *  into the list and drops (hearsay-tools/cezarion#1301). */
+function rootCompletion(row) {
+    const delegation = row.delegation;
+    if (!delegation || typeof delegation !== 'object' || delegation.role !== 'root')
+        return undefined;
+    const { completion } = delegation;
+    return completion && typeof completion === 'object' ? completion : undefined;
+}
+/** The worker waits a record still holds in `delegation` (store schemas 6 and 7,
+ *  hearsay-tools/cezarion#1235, #1301), in the order they settled: `lastWait`, then `wait`. The
+ *  completion gate's wait, the one `delegation.completion.waitId` names, is flagged `completion`: it
+ *  was Cezar's own, not the agent's. A value that does not parse is left where it is, for the
+ *  delegation schema to quarantine as it always has. */
+function agentWorkerWaits(row) {
+    const delegation = row.delegation;
+    if (!delegation || typeof delegation !== 'object')
+        return [];
+    const { role } = delegation;
+    if (role !== 'root' && role !== 'worker')
+        return [];
+    const waitId = rootCompletion(row)?.waitId;
+    const found = [];
+    for (const key of ['lastWait', 'wait']) {
+        const parsed = workerWaitSchema.safeParse(delegation[key]);
+        if (parsed.success)
+            found.push({ key, wait: parsed.data, completion: waitId === parsed.data.id });
+    }
+    return found;
+}
+/** A legacy `CiWait` as a wait entry. Its wake input's id was the wait's own (`wakeId`, which
+ *  `run.ts` set to the wait id), so the entry keeps that id and delivery still finds the input. */
+export function ciWaitEntry(wait) {
+    const { wakeId: _wakeId, phase, result, deliveredAt, ...identity } = wait;
+    return {
+        ...identity, kind: 'pr', source: 'agent', via: 'cezar_wait_for_ci',
+        phase: phase === 'registered' || phase === 'parked' ? 'open' : phase === 'wake-pending' ? 'resolved' : phase === 'delivered' ? 'delivered' : 'cancelled',
+        ...(result ? { result, resolvedAt: result.observedAt } : {}),
+        ...(deliveredAt ? { deliveredAt } : {}),
+    };
+}
+/** A pending legacy wait with no recorded reason settled on its stored observations:
+ *  satisfied by them is an outcome, anything else its deadline. */
+function inferredLegacyWaitReason(wait) {
+    if (wait.phase !== 'wake-pending' || wait.reason !== undefined)
+        return undefined;
+    const satisfied = (ids, reported) => wait.mode === 'all' ? ids.every((id) => reported.includes(id)) : reported.length > 0;
+    const reported = wait.requestIds
+        ? satisfied(wait.requestIds, (wait.requestOutcomes ?? []).map((outcome) => outcome.requestId))
+        : satisfied(wait.workerIds, (wait.outcomes ?? []).map((outcome) => outcome.workerId));
+    return reported ? 'outcome' : 'timeout';
+}
+/** The recorded reason, else the one the observations imply. A `message` stand-in never reaches here. */
+function legacyWaitReason(wait) {
+    return wait.reason === 'outcome' || wait.reason === 'timeout' ? wait.reason : inferredLegacyWaitReason(wait);
+}
+/** The ids a legacy worker wait watched, worker ids or request ids, as the entry still stores them. */
+function legacyWaitTargets(wait) {
+    return wait.requestIds
+        ? { requestIds: wait.requestIds, requestOutcomes: wait.requestOutcomes ?? [] }
+        : { workerIds: wait.workerIds, revisions: wait.revisions ?? [], outcomes: wait.outcomes };
+}
+/**
+ * A legacy agent `delegation.wait` as a worker wait entry (store schema 6, hearsay-tools/cezarion#1235),
+ * judged from the wait alone: what became of its wake input is `upgradeLegacyWaits`' to apply.
+ * `registered`/`parked` → open; `wake-pending` → resolved with its `outcome`/`timeout` reason, or
+ * cancelled. Undefined for the `message` stand-in, which was never an agent's wait: a message no
+ * longer resolves a wait, and its input still wakes the run on its own.
+ *
+ * Deterministic, never read from the clock: a row is upgraded on every read until open rewrites
+ * it, and two reads must agree. A `WorkerWait` kept no registration time, so `timeoutSeconds` is
+ * the 600 default, `registeredAt` is 600 s before the original deadline (kept as it was), and the
+ * settled stamps come from the wait itself: `resolvedAt` is the latest observation it holds, else
+ * its deadline, and `cancelledAt` is its deadline. `now` is only the fallback for a deadline that
+ * does not read, which the wait schema never admits.
+ */
+export function workerWaitEntry(wait, now) {
+    if (wait.phase === 'wake-pending' && wait.reason === 'message')
+        return undefined;
+    const deadline = Date.parse(wait.deadline);
+    const registeredAt = Number.isFinite(deadline) ? new Date(deadline - 600_000).toISOString() : now;
+    const open = wait.phase !== 'wake-pending';
+    const reason = legacyWaitReason(wait);
+    const observed = [...(wait.outcomes ?? []), ...(wait.requestOutcomes ?? [])].map((outcome) => outcome.observedAt).sort().at(-1);
+    const resolvedAt = reason === 'outcome' && observed ? observed : wait.deadline;
+    return {
+        id: wait.id, kind: 'worker', source: 'agent', via: 'cez-worker-wait', registeredAt, deadline: wait.deadline, timeoutSeconds: 600, turnId: 'upgraded',
+        phase: open ? 'open' : reason ? 'resolved' : 'cancelled',
+        ...(wait.mode ? { mode: wait.mode } : {}),
+        ...legacyWaitTargets(wait),
+        ...(!open && reason ? { result: { reason }, resolvedAt } : {}),
+        ...(!open && !reason ? { cancelledAt: wait.deadline } : {}),
+    };
+}
+/** Whether a record is a root still parked on its workers: an open or resolved worker wait in the
+ *  list. Such a root has its pending human question re-read from the transcript before a manager
+ *  parks it. Every stored `delegation.wait`, the completion gate's included, is read into the list
+ *  on open (store schema 7, hearsay-tools/cezarion#1301), so the list is the only place to look. */
+export function holdsWorkerWait(run) {
+    if (run.delegation?.role !== 'root')
+        return false;
+    return !!run.waits?.some((wait) => wait.kind === 'worker' && (wait.phase === 'open' || wait.phase === 'resolved'));
+}
+/** A stable id for the timer a legacy monitoring park becomes. The row keeps its legacy JSON
+ *  until it is next written, so every read of it must name the same wait. */
+function legacyTimerId(runId, wakeAt) {
+    return legacyWaitId(`legacy-monitoring-timer:${String(runId)}:${wakeAt}`);
+}
+/** The human wait a stored pending-question summary becomes: one per run, the same on every read. */
+function legacyHumanWaitId(runId) {
+    return legacyWaitId(`legacy-pending-ask:${String(runId)}`);
+}
+/** A name-based (version 5 shaped) UUID, so a row read twice upgrades to the same entry. */
+function legacyWaitId(name) {
+    const hex = createHash('sha256').update(name).digest('hex');
+    const variant = (8 | (Number.parseInt(hex[16], 16) & 3)).toString(16);
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-5${hex.slice(13, 16)}-${variant}${hex.slice(17, 20)}-${hex.slice(20, 32)}`;
+}
+/** A live run and its live step move together by `exit`, as every park and resume writes them:
+ *  park from running to waiting, resume from waiting to running. The caller has read the row's status. */
+function setLiveStatus(row, exit) {
+    const [from, to] = exit === 'park' ? ['running', 'waiting'] : ['waiting', 'running'];
+    Object.assign(row, applyExit({ status: row.status, delegation: row.delegation }, exit));
+    if (Array.isArray(row.steps))
+        for (const step of row.steps) {
+            if (step && typeof step === 'object' && step.status === from)
+                step.status = to;
+        }
+}
+const resumeParked = (row) => setLiveStatus(row, 'resume');
+/** Kind `ci` waited for checks and woke on a conflict (hearsay-tools/cezarion#1425). */
+function rewriteCiKindWaits(row) {
+    for (const key of ['waits', 'lastWaits']) {
+        if (Array.isArray(row[key]))
+            row[key] = row[key].map((entry) => isCiKindEntry(entry)
+                ? { ...entry, kind: 'pr', until: 'checks', wakeOnConflict: true } : entry);
+    }
+}
+/** One legacy CI field into the open or settled list. True when the value does not parse. */
+function readLegacyCi(row, key, lists) {
+    const value = row[key];
+    if (value === undefined)
+        return false;
+    const parsed = ciWaitSchema.safeParse(value);
+    if (!parsed.success)
+        return true;
+    const entry = ciWaitEntry(parsed.data);
+    if (key === 'lastCiWait' && entry.phase !== 'delivered')
+        entry.phase = 'cancelled';
+    (entry.phase === 'open' || entry.phase === 'resolved' ? lists.opened : lists.settled).push(entry);
+    return false;
+}
+/** A wake a provider took on a `waiting` run, between the delivery checkpoint and the resume. An
+ *  inbox read starts no provider turn, and a pending question still holds the run. */
+function legacyWakeInterrupted(row, key, input) {
+    return key === 'wait' && row.status === 'waiting' && typeof input?.deliveredAt === 'string' && !input.inboxClaim?.acknowledgedAt && row.hasPendingHumanAsk !== true;
+}
+/** Apply one legacy agent wait to the lists, and resume a parked run whose wake was interrupted. */
+function settleLegacyAgentWait(row, found, currentId, now, inputs, lists) {
+    const { key, wait, completion } = found;
+    // A wait that settles has its copy in `lastWait` too: it is the same wait.
+    if (key === 'lastWait' && currentId === wait.id)
+        return;
+    const input = inputs.find((candidate) => candidate.id === (wait.wakeId ?? wait.id));
+    const entry = workerWaitEntry(wait, now);
+    // Cezar's completion gate wait is its own: no agent registered it (hearsay-tools/cezarion#1301).
+    // It keeps the deadline it always carried, with the 600 s default registration.
+    if (entry && completion)
+        Object.assign(entry, { source: 'cezar', via: 'completion', mode: 'all' });
+    // The `message` stand-in becomes no entry, but its delivered message may be that crash too.
+    if (!entry) {
+        if (legacyWakeInterrupted(row, key, input))
+            resumeParked(row);
+        return;
+    }
+    const deliveredAt = typeof input?.deliveredAt === 'string' ? input.deliveredAt : undefined;
+    if (entry.phase !== 'open' && deliveredAt) {
+        Object.assign(entry, { phase: 'delivered', deliveredAt });
+        if (legacyWakeInterrupted(row, key, input))
+            resumeParked(row);
+    }
+    else if (key === 'lastWait' && entry.phase !== 'cancelled')
+        Object.assign(entry, { phase: 'cancelled', cancelledAt: wait.deadline });
+    else if (entry.phase === 'resolved' && input)
+        entry.wakeInputId = input.id;
+    (entry.phase === 'open' || entry.phase === 'resolved' ? lists.opened : lists.settled).push(entry);
+}
+/** Every stored agent `delegation.wait`/`lastWait` into the lists. */
+function readLegacyAgentWaits(row, lists, agentWaits) {
+    if (!agentWaits.length)
+        return;
+    // The wait's own stamps decide every time the entry carries (`workerWaitEntry`), not the clock.
+    const now = typeof row.createdAt === 'string' ? row.createdAt : new Date(0).toISOString();
+    const inputs = Array.isArray(row.agentInputs) ? row.agentInputs : [];
+    const currentId = agentWaits.find((found) => found.key === 'wait')?.wait.id;
+    for (const found of agentWaits)
+        settleLegacyAgentWait(row, found, currentId, now, inputs, lists);
+}
+/** Live monitoring parks become an open timer when the deadline reads, and a running run parks. */
+function readLegacyMonitoring(row, opened) {
+    const live = row.status === 'running' || row.status === 'queued' || row.status === 'waiting';
+    if (row.activity !== 'monitoring' || !live)
+        return;
+    const wakeAt = row.monitoringWakeAt;
+    // Schema 3 read an unreadable deadline as none (`.catch(undefined)`): no wait.
+    if (typeof wakeAt === 'string' && z.iso.datetime().safeParse(wakeAt).success) {
+        const now = Date.now();
+        const seconds = Math.min(TIMER_MAX_SECONDS, Math.max(TIMER_MIN_SECONDS, Math.round((Date.parse(wakeAt) - now) / 1000)));
+        opened.push({
+            id: legacyTimerId(row.id, wakeAt), kind: 'timer', source: 'agent', via: 'monitoring-line',
+            registeredAt: new Date(now).toISOString(), deadline: wakeAt, phase: 'open', turnId: 'legacy', seconds,
+        });
+    }
+    if (row.status === 'running')
+        setLiveStatus(row, 'park');
+}
+const asksHuman = (entry) => !!entry && typeof entry === 'object' && entry.kind === 'human' && entry.phase === 'open';
+/** `hasPendingHumanAsk` on a waiting run with no open human wait: one open human wait. */
+function readLegacyHumanAsk(row, opened) {
+    if (row.hasPendingHumanAsk !== true || row.status !== 'waiting')
+        return;
+    if ((Array.isArray(row.waits) && row.waits.some(asksHuman)) || opened.some(asksHuman))
+        return;
+    opened.push({
+        id: legacyHumanWaitId(row.id), kind: 'human', source: 'agent', via: 'ask-line',
+        registeredAt: typeof row.createdAt === 'string' && z.iso.datetime().safeParse(row.createdAt).success ? row.createdAt : new Date(0).toISOString(),
+        phase: 'open', turnId: 'legacy',
+    });
+}
+/** Drop the fields schema 4 reads, and the agent waits schema 6 and 7 read. */
+function dropLegacyWaitFields(row, agentWaits) {
+    for (const key of LEGACY_WAIT_KEYS)
+        delete row[key];
+    if (!agentWaits.length && !rootCompletion(row))
+        return;
+    const delegation = { ...row.delegation };
+    for (const { key } of agentWaits)
+        delete delegation[key];
+    delete delegation.completion;
+    row.delegation = delegation;
+}
+/**
+ * Upgrade-on-read (store schema 4, spec 2026-10-17-unified-waits): read a schema-3 record's CI and
+ * monitoring fields into its wait list, then delete them. Mutates `row`, before validation.
+ *
+ * - `ciWait`: `registered`/`parked` → an open `pr` checks wait, `wake-pending` → resolved (resolved when
+ *   its result was observed), `delivered`/`withdrawn` → `lastWaits` as delivered/cancelled.
+ * - `lastCiWait` → `lastWaits`: `delivered` stays delivered, anything else was withdrawn intent and
+ *   reads as cancelled. `lastCiWaitError` → `lastWaitsError`.
+ * - `activity: 'monitoring'` on a live run: with `monitoringWakeAt`, an open timer due then
+ *   (`seconds` is what remains, clamped to a timer's bounds); without one, no wait. Either way a
+ *   `running` run parks as `waiting`, its running step with it, as every waiting park writes it.
+ *   On a finished run the fields are stale and only dropped.
+ * - `hasPendingHumanAsk: true` on a `waiting` run with no open human wait (phase 4b,
+ *   hearsay-tools/cezarion#1236): an open `human` wait, `ask-line`, with no `askSeq`. Recovery shows
+ *   it (`surfaceHumanWait`), which attaches it to the question still pending in the transcript
+ *   instead of raising a second card. Anywhere else the summary is dropped: the human wait it stood
+ *   beside since phase 2 already says the same.
+ *
+ * - `delegation.wait`/`lastWait` registered by the agent (store schema 6, hearsay-tools/cezarion#1235)
+ *   → `workerWaitEntry`, then settled by what became of the wake input (`wakeId`, else the wait's own
+ *   id): a wait whose input was delivered reads as delivered, a `wake-pending` one whose input is
+ *   still queued stays resolved and records it as `wakeInputId`, so it is delivered once, and a
+ *   `lastWait` that was never delivered reads as cancelled. The `message` stand-in is dropped. No
+ *   input is added or removed: a cancelled receipt's undelivered wake stays queued and is delivered
+ *   as an ordinary input. The completion gate's wait (store schema 7, hearsay-tools/cezarion#1301) becomes a
+ *   `source: 'cezar'`, `via: 'completion'` entry the same way, and `delegation.completion` is dropped. A current wait
+ *   (the stand-in included) whose wake a provider took on a `waiting` run is the old engine's crash
+ *   between the delivery checkpoint and the resume: the run reads `running`, so recovery resumes
+ *   it. A wake an inbox read acknowledged, or one beside a pending question, resumes nothing.
+ *
+ * - A `waits`/`lastWaits` entry of kind `ci` (hearsay-tools/cezarion#1425) → kind `pr` with
+ *   `until: 'checks'` and `wakeOnConflict: true`, what a `ci` wait did.
+ *
+ * An unreadable legacy CI wait gets the per-entry salvage `parseRunRecords` gives `waits`: it is
+ * dropped, `lastWaitsError` says so, and the status is left alone. A `waiting` run with no open
+ * wait reads as Needs you, which a human can resume.
+ */
+export function upgradeLegacyWaits(row) {
+    if (!hasLegacyWaitFields(row))
+        return;
+    rewriteCiKindWaits(row);
+    const lists = { opened: [], settled: [] };
+    // The previous wait settled before the current one did, so it goes first. Both fields are
+    // read, and both lists are written: one unreadable side must not skip the other.
+    const previousUnreadable = readLegacyCi(row, 'lastCiWait', lists);
+    const currentUnreadable = readLegacyCi(row, 'ciWait', lists);
+    const agentWaits = agentWorkerWaits(row);
+    readLegacyAgentWaits(row, lists, agentWaits);
+    readLegacyMonitoring(row, lists.opened);
+    readLegacyHumanAsk(row, lists.opened);
+    let unreadable = previousUnreadable || currentUnreadable;
+    if (lists.opened.length) {
+        const current = Array.isArray(row.waits) ? row.waits : [];
+        if (row.waits !== undefined && !Array.isArray(row.waits))
+            unreadable = true;
+        row.waits = [...current, ...lists.opened.filter((wait) => !current.some((entry) => entry?.id === wait.id))];
+    }
+    if (lists.settled.length) {
+        const current = Array.isArray(row.lastWaits) ? row.lastWaits : [];
+        if (row.lastWaits !== undefined && !Array.isArray(row.lastWaits))
+            unreadable = true;
+        row.lastWaits = [...lists.settled, ...current].slice(-LAST_WAITS_LIMIT);
+    }
+    if (typeof row.lastCiWaitError === 'string' && row.lastWaitsError === undefined)
+        row.lastWaitsError = row.lastCiWaitError;
+    if (unreadable)
+        row.lastWaitsError = UNREADABLE_WAIT;
+    dropLegacyWaitFields(row, agentWaits);
+}
+//# sourceMappingURL=legacy-waits.js.map

package/dist/runs/legacy-waits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-waits.js","sourceRoot":"","sources":["../../src/runs/legacy-waits.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5G,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;oFAEoF;AACpF,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,UAAU,EAAE,oBAAoB,CAAU,CAAC;AAChK,MAAM,CAAC,MAAM,eAAe,GAAG,qEAAqE,CAAC;AAMrG,6GAA6G;AAC7G,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,KAA4B,CAAC,IAAI,KAAK,IAAI,CAAC;AAC9H,SAAS,gBAAgB,CAAC,GAA4B;IACpD,OAAQ,CAAC,OAAO,EAAE,WAAW,CAAW,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAK,GAAG,CAAC,GAAG,CAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;AACjI,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO,CAAC,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,gBAAgB,CAAC,GAA8B,CAAC,IAAI,gBAAgB,CAAC,GAA8B,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,CAAC,GAA8B,CAAC,KAAK,SAAS,CAAC,CAAC;AAC7Q,CAAC;AAED;6DAC6D;AAC7D,SAAS,cAAc,CAAC,GAA4B;IAClD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAClC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAK,UAAiC,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IAC1H,MAAM,EAAE,UAAU,EAAE,GAAG,UAAsC,CAAC;IAC9D,OAAO,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/E,CAAC;AAED;;;;wDAIwD;AACxD,SAAS,gBAAgB,CAAC,GAA4B;IACpD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAClC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC7D,MAAM,EAAE,IAAI,EAAE,GAAG,UAAgC,CAAC;IAClD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAC3C,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAU,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAE,UAAsC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxF,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;mGACmG;AACnG,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC1E,OAAO;QACL,GAAG,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,mBAAmB;QAClE,KAAK,EAAE,KAAK,KAAK,YAAY,IAAI,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW;QACxJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC;AAED;mEACmE;AACnE,SAAS,wBAAwB,CAAC,IAAgB;IAChD,IAAI,IAAI,CAAC,KAAK,KAAK,cAAc,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjF,MAAM,SAAS,GAAG,CAAC,GAAsB,EAAE,QAA2B,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAChK,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU;QAC9B,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9F,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxF,OAAO,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC;AAED,yGAAyG;AACzG,SAAS,gBAAgB,CAAC,IAAgB;IACxC,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAC/G,CAAC;AAED,uGAAuG;AACvG,SAAS,iBAAiB,CAAC,IAAgB;IACzC,OAAO,IAAI,CAAC,UAAU;QACpB,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,EAAE,EAAE;QAC9E,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;AAC9F,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB,EAAE,GAAW;IAC3D,IAAI,IAAI,CAAC,KAAK,KAAK,cAAc,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAClG,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,KAAK,cAAc,CAAC;IAC3C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChI,MAAM,UAAU,GAAG,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC/E,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU;QACpJ,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW;QACxD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,iBAAiB,CAAC,IAAI,CAAC;QAC1B,GAAG,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED;;;oGAGoG;AACpG,MAAM,UAAU,eAAe,CAAC,GAA4C;IAC1E,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC;AACrH,CAAC;AAED;6EAC6E;AAC7E,SAAS,aAAa,CAAC,KAAc,EAAE,MAAc;IACnD,OAAO,YAAY,CAAC,2BAA2B,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,qGAAqG;AACrG,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,YAAY,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,4FAA4F;AAC5F,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvE,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;AAC5H,CAAC;AAED;0GAC0G;AAC1G,SAAS,aAAa,CAAC,GAA4B,EAAE,IAAuB;IAC1E,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACrF,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAA8C,EAAE,IAAI,CAAC,CAAC,CAAC;IACpI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC3D,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAK,IAA6B,CAAC,MAAM,KAAK,IAAI;gBAAG,IAA2B,CAAC,MAAM,GAAG,EAAE,CAAC;QACnI,CAAC;AACH,CAAC;AACD,MAAM,YAAY,GAAG,CAAC,GAA4B,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAEpF,wFAAwF;AACxF,SAAS,kBAAkB,CAAC,GAA4B;IACtD,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,CAAU,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAI,GAAG,CAAC,GAAG,CAAe,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC;gBACjG,CAAC,CAAC,EAAE,GAAI,KAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC;AAED,6FAA6F;AAC7F,SAAS,YAAY,CAAC,GAA4B,EAAE,GAA4B,EAAE,KAAgB;IAChG,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,GAAG,KAAK,YAAY,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW;QAAE,KAAK,CAAC,KAAK,GAAG,WAAW,CAAC;IACnF,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClG,OAAO,KAAK,CAAC;AACf,CAAC;AAED;sFACsF;AACtF,SAAS,qBAAqB,CAAC,GAA4B,EAAE,GAAwB,EAAE,KAAiC;IACtH,OAAO,GAAG,KAAK,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,WAAW,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,cAAc,IAAI,GAAG,CAAC,kBAAkB,KAAK,IAAI,CAAC;AACtK,CAAC;AAED,oGAAoG;AACpG,SAAS,qBAAqB,CAAC,GAA4B,EAAE,KAAqB,EAAE,SAAkB,EAAE,GAAW,EAAE,MAAwB,EAAE,KAAgB;IAC7J,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IACxC,2EAA2E;IAC3E,IAAI,GAAG,KAAK,UAAU,IAAI,SAAS,KAAK,IAAI,CAAC,EAAE;QAAE,OAAO;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACzC,iGAAiG;IACjG,gFAAgF;IAChF,IAAI,KAAK,IAAI,UAAU;QAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnG,4FAA4F;IAC5F,IAAI,CAAC,KAAK,EAAE,CAAC;QAAC,IAAI,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACtF,MAAM,WAAW,GAAG,OAAO,KAAK,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3F,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;QAC1D,IAAI,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IAChE,CAAC;SACI,IAAI,GAAG,KAAK,UAAU,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW;QAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;SAChI,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,IAAI,KAAK;QAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,EAAY,CAAC;IACrF,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpG,CAAC;AAED,sEAAsE;AACtE,SAAS,oBAAoB,CAAC,GAA4B,EAAE,KAAgB,EAAE,UAA4B;IACxG,IAAI,CAAC,UAAU,CAAC,MAAM;QAAE,OAAO;IAC/B,gGAAgG;IAChG,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1F,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;IAC5E,KAAK,MAAM,KAAK,IAAI,UAAU;QAAE,qBAAqB,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACnG,CAAC;AAED,mGAAmG;AACnG,SAAS,oBAAoB,CAAC,GAA4B,EAAE,MAAc;IACxE,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC;IAC7F,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI,CAAC,IAAI;QAAE,OAAO;IACnD,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC;IACpC,+EAA+E;IAC/E,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACxH,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB;YACzF,YAAY,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;SACtG,CAAC,CAAC;IACL,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;QAAE,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,KAA4B,CAAC,IAAI,KAAK,OAAO,IAAK,KAA6B,CAAC,KAAK,KAAK,MAAM,CAAC;AAEhL,0FAA0F;AAC1F,SAAS,kBAAkB,CAAC,GAA4B,EAAE,MAAc;IACtE,IAAI,GAAG,CAAC,kBAAkB,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO;IACxE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO;IAC9F,MAAM,CAAC,IAAI,CAAC;QACV,EAAE,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU;QAC9E,YAAY,EAAE,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;QAChJ,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ;KAChC,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,SAAS,oBAAoB,CAAC,GAA4B,EAAE,UAA4B;IACtF,KAAK,MAAM,GAAG,IAAI,gBAAgB;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;QAAE,OAAO;IACvD,MAAM,UAAU,GAAG,EAAE,GAAI,GAAG,CAAC,UAAsC,EAAE,CAAC;IACtE,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;IACzD,OAAO,UAAU,CAAC,UAAU,CAAC;IAC7B,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAA4B;IAC7D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC;QAAE,OAAO;IACtC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,KAAK,GAAc,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACrD,0FAA0F;IAC1F,iFAAiF;IACjF,MAAM,kBAAkB,GAAG,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IAClE,MAAM,iBAAiB,GAAG,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzC,oBAAoB,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC7C,oBAAoB,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,UAAU,GAAG,kBAAkB,IAAI,iBAAiB,CAAC;IACzD,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,UAAU,GAAG,IAAI,CAAC;QAC5E,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,UAAU,GAAG,IAAI,CAAC;QACpF,GAAG,CAAC,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS;QAAE,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,eAAe,CAAC;IAC1H,IAAI,UAAU;QAAE,GAAG,CAAC,cAAc,GAAG,eAAe,CAAC;IACrD,oBAAoB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC"}

package/dist/runs/live-item-snapshots.d.ts

@@ -0,0 +1,15 @@
+import type { RunEvent } from '../contract/index.js';
+/** Latest active item state for finite HTTP readers. No raw delta log or disk writes.
+ * Eviction drops an entire item: never append a suffix to a missing text prefix. A
+ * later full snapshot can seed it again; persisted completion always remains replayable. */
+export declare class LiveItemSnapshots {
+    private readonly items;
+    private bytes;
+    observe(runId: string, event: RunEvent, ephemeral: boolean): void;
+    read(runId: string): RunEvent[];
+    forget(runId: string): void;
+    clear(): void;
+    private forgetSessionStep;
+    private storeSnapshot;
+    private remove;
+}

package/dist/runs/live-item-snapshots.js

@@ -0,0 +1,95 @@
+import { LIVE_BYTE_LIMIT } from '../contract/index.js';
+// A store-wide bound, including items whose runner never emitted completion.
+const MAX_ITEMS = 256;
+const MAX_BYTES = 4 * LIVE_BYTE_LIMIT;
+function liveItemId(event, item) {
+    return event.type === 'item.delta' ? event.itemId :
+        item && typeof item === 'object' && 'id' in item ? item.id : undefined;
+}
+function snapshotFromDelta(prior, event) {
+    const previous = prior?.item;
+    if (!prior || !previous || typeof previous !== 'object' || !('kind' in previous) || typeof event.delta !== 'string')
+        return;
+    const field = previous.kind === 'tool' && event.field === 'output' ? 'output' :
+        previous.kind !== 'tool' && (event.field === 'text' || event.field === 'reasoning') ? 'text' : undefined;
+    if (!field)
+        return;
+    const text = field in previous ? previous[field] : '';
+    return { ...prior, type: 'item.updated', seq: event.seq, ts: event.ts,
+        item: { ...previous, [field]: (typeof text === 'string' ? text : '') + event.delta } };
+}
+function snapshotFromLifecycle(event) {
+    const item = event.item;
+    if (!item || typeof item !== 'object' || !('kind' in item) ||
+        !['message', 'reasoning', 'tool'].includes(String(item.kind)))
+        return;
+    return event;
+}
+function liveItemSnapshot(items, key, event) {
+    if (event.type === 'item.delta')
+        return snapshotFromDelta(items.get(key)?.event, event);
+    if (event.type === 'item.started' || event.type === 'item.updated')
+        return snapshotFromLifecycle(event);
+    return undefined;
+}
+/** Latest active item state for finite HTTP readers. No raw delta log or disk writes.
+ * Eviction drops an entire item: never append a suffix to a missing text prefix. A
+ * later full snapshot can seed it again; persisted completion always remains replayable. */
+export class LiveItemSnapshots {
+    items = new Map();
+    bytes = 0;
+    observe(runId, event, ephemeral) {
+        if (event.type === 'session.started' || event.type === 'session.ended') {
+            this.forgetSessionStep(runId, event.stepId);
+            return;
+        }
+        const item = event.item;
+        const id = liveItemId(event, item);
+        if (typeof id !== 'string')
+            return;
+        const key = JSON.stringify([runId, event.stepId, id]);
+        if (event.type === 'item.completed') {
+            this.remove(key);
+            return;
+        }
+        const snapshot = liveItemSnapshot(this.items, key, event);
+        if (!snapshot)
+            return;
+        this.storeSnapshot(key, runId, snapshot, ephemeral);
+    }
+    read(runId) {
+        return [...this.items.values()].filter(entry => entry.runId === runId && entry.ephemeral)
+            .map(entry => entry.event).sort((a, b) => a.seq - b.seq);
+    }
+    forget(runId) {
+        for (const [key, entry] of this.items)
+            if (entry.runId === runId)
+                this.remove(key);
+    }
+    clear() { this.items.clear(); this.bytes = 0; }
+    forgetSessionStep(runId, stepId) {
+        for (const [key, entry] of this.items) {
+            if (entry.runId === runId && entry.event.stepId === stepId)
+                this.remove(key);
+        }
+    }
+    storeSnapshot(key, runId, snapshot, ephemeral) {
+        this.remove(key);
+        const bytes = Buffer.byteLength(JSON.stringify(snapshot)) + 1;
+        // An individually oversized active item waits for the existing history recovery path.
+        if (bytes > LIVE_BYTE_LIMIT)
+            return;
+        while (this.items.size >= MAX_ITEMS || this.bytes + bytes > MAX_BYTES)
+            this.remove(this.items.keys().next().value);
+        this.items.set(key, { runId, event: structuredClone(snapshot), bytes, ephemeral });
+        this.bytes += bytes;
+    }
+    remove(key) {
+        const entry = this.items.get(key);
+        if (entry) {
+            this.bytes -= entry.bytes;
+            this.items.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=live-item-snapshots.js.map

package/dist/runs/live-item-snapshots.js.map

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

package/dist/runs/loaded-run-exits.d.ts

@@ -0,0 +1,6 @@
+import type { RunRecord } from './store.ts';
+export declare function settleLoadedStop(run: RunRecord): void;
+export declare function restoreLoadedUsageLimitHold(run: RunRecord): void;
+export declare function failLoadedInterruptedRun(run: RunRecord, opts?: {
+    keepLive?: boolean;
+}): void;

package/dist/runs/loaded-run-exits.js

@@ -0,0 +1,32 @@
+/**
+ * The store's load-time status writers (slice S4a of .ai/specs/2026-11-03-run-store-owns-exits.md,
+ * Table C): each applies a run exit to a record just read off disk, so it settles what that exit
+ * settles at runtime (Table B targets B10, B11). `reconcileLoadedRun` (store.ts) runs them in order.
+ */
+import { engineOwnsRun } from '../contract/index.js';
+import { applyExit } from './run-exits.js';
+export function settleLoadedStop(run) {
+    // An accepted Stop is durable intent, never an interrupted run to auto-resume. It can meet a run
+    // that settled before the Stop did (the engine's own late Stop), so it takes `cancel-late`.
+    if (run.stopping)
+        Object.assign(run, applyExit(run, 'cancel-late'));
+    run.stopping = undefined;
+}
+export function restoreLoadedUsageLimitHold(run) {
+    // A usage-limited run is waiting for its resume (hearsay-tools/cezarion#1236, phase 4a). Rows a
+    // schema-7 cezar wrote kept it failed with the appointment; they read as the waiting run they are.
+    if (run.status === 'failed' && run.autoResumeAt !== undefined)
+        Object.assign(run, applyExit(run, 'hold'));
+}
+export function failLoadedInterruptedRun(run, opts) {
+    // A run that was live when the previous process exited can never finish —
+    // surface that instead of a forever-"running" ghost. `review` survives
+    // restarts on purpose: the gate is pure data (worktree + branch + record)
+    // with no live process, so the diff panel, Send back (resume) and Draft PR
+    // all still work.
+    // A usage-limit hold runs no process, so no exit interrupted it: its appointment stands.
+    if (!opts?.keepLive && engineOwnsRun(run)) {
+        Object.assign(run, applyExit(run, 'fail-interrupted'));
+    }
+}
+//# sourceMappingURL=loaded-run-exits.js.map

package/dist/runs/loaded-run-exits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded-run-exits.js","sourceRoot":"","sources":["../../src/runs/loaded-run-exits.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,MAAM,UAAU,gBAAgB,CAAC,GAAc;IAC7C,iGAAiG;IACjG,4FAA4F;IAC5F,IAAI,GAAG,CAAC,QAAQ;QAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC;IACpE,GAAG,CAAC,QAAQ,GAAG,SAAS,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,GAAc;IACxD,gGAAgG;IAChG,mGAAmG;IACnG,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;AAC5G,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAc,EAAE,IAA6B;IACpF,0EAA0E;IAC1E,uEAAuE;IACvE,0EAA0E;IAC1E,2EAA2E;IAC3E,kBAAkB;IAClB,yFAAyF;IACzF,IAAI,CAAC,IAAI,EAAE,QAAQ,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACzD,CAAC;AACH,CAAC"}

package/dist/runs/loaded-run-healing.d.ts

@@ -0,0 +1,3 @@
+import type { RunRecord } from './store.ts';
+/** Heal reference metadata through the store's existing declaration and resolution rules. */
+export declare function restoreLostReferencedPullRequest(run: RunRecord, referencedPrDeclaration: (run: RunRecord) => number | undefined, resolveReferencedRef: (candidates: string[], task: string, declared?: number) => string | undefined): void;

package/dist/runs/loaded-run-healing.js

@@ -0,0 +1,17 @@
+/** Heal reference metadata through the store's existing declaration and resolution rules. */
+export function restoreLostReferencedPullRequest(run, referencedPrDeclaration, resolveReferencedRef) {
+    // Heal a record written before `referencedPrDeclaration` existed: a task that re-declared
+    // `CEZ:PR` with the PR it had just CREATED cleared the PR it was ABOUT, because no candidate
+    // could match the created number. The evidence is all still on the record — only the
+    // conclusion drawn from it was wrong — so re-resolve without that declaration instead of
+    // asking for a migration. Deliberately one-directional: it only runs on a record that HAS no
+    // referenced PR, so it can never take one away from a record written by an older cezar whose
+    // candidate list no longer explains it. `prNumber` is not recoverable this way (the
+    // declaration overwrote it) and is left alone — the restored URL is what paints the chip.
+    if (run.referencedPullRequestUrl === undefined &&
+        run.markerRefs?.pr !== undefined &&
+        referencedPrDeclaration(run) === undefined) {
+        run.referencedPullRequestUrl = resolveReferencedRef(run.referencedPrCandidates ?? [], run.task, undefined);
+    }
+}
+//# sourceMappingURL=loaded-run-healing.js.map

package/dist/runs/loaded-run-healing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded-run-healing.js","sourceRoot":"","sources":["../../src/runs/loaded-run-healing.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,MAAM,UAAU,gCAAgC,CAC9C,GAAc,EACd,uBAA+D,EAC/D,oBAAmG;IAEnG,0FAA0F;IAC1F,6FAA6F;IAC7F,qFAAqF;IACrF,yFAAyF;IACzF,6FAA6F;IAC7F,6FAA6F;IAC7F,oFAAoF;IACpF,0FAA0F;IAC1F,IACE,GAAG,CAAC,wBAAwB,KAAK,SAAS;QAC1C,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,SAAS;QAChC,uBAAuB,CAAC,GAAG,CAAC,KAAK,SAAS,EAC1C,CAAC;QACD,GAAG,CAAC,wBAAwB,GAAG,oBAAoB,CACjD,GAAG,CAAC,sBAAsB,IAAI,EAAE,EAChC,GAAG,CAAC,IAAI,EACR,SAAS,CACV,CAAC;IACJ,CAAC;AACH,CAAC"}