project-cpu-mcp 0.7.1

package/dist/map/attention.utils.js

@@ -0,0 +1,191 @@
+import { REVEAL_RETRY_CEILING_SECONDS, REVEAL_RETRY_FLOOR_SECONDS, REVEAL_STUCK_AFTER_MISSED_SWEEPS, REVEAL_STUCK_AFTER_SECONDS, } from './constants.js';
+import { demolishCooldownEnd, isDepleted } from './map.utils.js';
+import { processOutputs } from './process.utils.js';
+import { cellProcessProgress } from './settle.utils.js';
+import { blockedResourceIds, needByResource } from './storage.utils.js';
+import { AttentionReason, AttentionSeverity, CellProcessKind, } from './types.js';
+import { sameAddress } from '../randomness/request.utils.js';
+const { Critical, Warning, Info } = AttentionSeverity;
+// Each reason has a fixed urgency (how time-sensitive the fact is), used only for ordering — the report
+// stays descriptive and suggests no action, leaving what to do to the caller.
+const REASON_SEVERITY = {
+    [AttentionReason.StalledMining]: Critical,
+    [AttentionReason.StalledCraft]: Critical,
+    [AttentionReason.WarehouseNearFull]: Warning,
+    [AttentionReason.DepositDepleted]: Warning,
+    [AttentionReason.ProcessFinished]: Warning,
+    [AttentionReason.DeliveryReady]: Warning,
+    [AttentionReason.Unbuilt]: Info,
+    [AttentionReason.DemolishCooldown]: Info,
+    [AttentionReason.LotFrozen]: Warning,
+    [AttentionReason.LotAtRisk]: Info,
+    [AttentionReason.RevealStuck]: Critical,
+    [AttentionReason.RevealSourceRetired]: Critical,
+};
+const SEVERITY_RANK = { [Critical]: 0, [Warning]: 1, [Info]: 2 };
+// Every item shares this shape; a reason + a few `extra` fields is all that varies.
+export function attentionItem(loc, reason, extra = {}) {
+    return {
+        tokenId: loc.tokenId,
+        severity: REASON_SEVERITY[reason],
+        reason,
+        resourceId: null,
+        used: null,
+        cap: null,
+        fillPct: null,
+        breakdown: null,
+        depositRemaining: null,
+        deliveryId: null,
+        arrivalAt: null,
+        lotId: null,
+        requestId: null,
+        requestedAt: null,
+        message: null,
+        ...extra,
+    };
+}
+function storageFields(resource) {
+    const s = resource.storage;
+    const used = s?.used ?? '0';
+    const cap = s?.cap ?? null;
+    return {
+        resourceId: resource.resourceId,
+        used,
+        cap,
+        fillPct: cap === null || cap === '0' ? null : Number((BigInt(used) * 100n) / BigInt(cap)),
+        breakdown: {
+            liquid: resource.balance,
+            incomingTransport: s?.reserved.incomingTransport ?? '0',
+            lots: s?.reserved.lots ?? '0',
+        },
+    };
+}
+function isOperationalExtractor(cell, extractorTypes) {
+    const building = cell.building;
+    return building !== null && extractorTypes.has(building.type) && cell.ready === true;
+}
+function finishedProcess(cell, input) {
+    const process = cell.process;
+    if (process === null) {
+        return false;
+    }
+    return cellProcessProgress(cell, process, input.serverTime, input).progress.isFinished;
+}
+function cellItems(cell, input) {
+    const items = [];
+    const outputs = cell.process === null ? [] : processOutputs(cell.process, input.craftOutputsByRecipe);
+    const need = needByResource(outputs);
+    const blocked = new Set(blockedResourceIds(outputs, cell.resources));
+    const isCraft = cell.process?.kind === CellProcessKind.Craft;
+    // One pass over the boxes this process feeds: one that can't take a whole cycle stalls it, an
+    // almost-full one warns.
+    for (const resource of cell.resources) {
+        const s = resource.storage;
+        if (!s || s.cap === null || (need.get(resource.resourceId) ?? 0n) === 0n) {
+            continue;
+        }
+        if (blocked.has(resource.resourceId)) {
+            items.push(attentionItem(cell, isCraft ? AttentionReason.StalledCraft : AttentionReason.StalledMining, storageFields(resource)));
+        }
+        else if (BigInt(s.used) * 100n >= BigInt(s.cap) * BigInt(input.nearFullPct)) {
+            items.push(attentionItem(cell, AttentionReason.WarehouseNearFull, storageFields(resource)));
+        }
+    }
+    const minedResourceId = cell.process?.kind === CellProcessKind.Mining ? cell.process.resource : null;
+    if (finishedProcess(cell, input)) {
+        items.push(attentionItem(cell, AttentionReason.ProcessFinished, { resourceId: minedResourceId }));
+    }
+    if (isOperationalExtractor(cell, input.extractorBuildingTypes) && isDepleted(cell)) {
+        items.push(attentionItem(cell, AttentionReason.DepositDepleted, {
+            resourceId: minedResourceId,
+            depositRemaining: '0',
+        }));
+    }
+    if (cell.revealCount > 0 && cell.building === null && !cell.revealPending) {
+        // A just-demolished cell is empty but can't be rebuilt until its cooldown ends — flag the wait, not a
+        // missing building, so the caller isn't told to build somewhere it can't yet.
+        const cooldownEnd = demolishCooldownEnd(cell, input.serverTime);
+        if (cooldownEnd !== null) {
+            items.push(attentionItem(cell, AttentionReason.DemolishCooldown, { arrivalAt: cooldownEnd }));
+        }
+        else {
+            items.push(attentionItem(cell, AttentionReason.Unbuilt));
+        }
+    }
+    return items;
+}
+function countBySeverity(items) {
+    const counts = { [Critical]: 0, [Warning]: 0, [Info]: 0 };
+    for (const item of items) {
+        counts[item.severity] += 1;
+    }
+    return counts;
+}
+// Most-urgent first, then a stable tokenId tiebreak so callers get a deterministic ordering.
+export function sortAttentionItems(items) {
+    return [...items].sort((a, b) => SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity] || a.tokenId.localeCompare(b.tokenId));
+}
+export function meetsSeverity(severity, min) {
+    return min === null || SEVERITY_RANK[severity] <= SEVERITY_RANK[min];
+}
+export function buildAttentionReport(input) {
+    const cells = input.ownedCells;
+    const items = cells === null ? [] : sortAttentionItems(cells.flatMap((cell) => cellItems(cell, input)));
+    return {
+        ownerKnown: cells !== null,
+        version: input.version,
+        serverTime: input.serverTime,
+        counts: countBySeverity(items),
+        items,
+        note: null,
+    };
+}
+function stuckRevealMessage(requestId, waited) {
+    const tail = `Until it settles the cell has no new draw and no further reveal can be requested for it. Background ` +
+        `settlement comes back to it no sooner than every ${REVEAL_RETRY_FLOOR_SECONDS} seconds and waits longer ` +
+        `after each attempt that fails, up to ${REVEAL_RETRY_CEILING_SECONDS} seconds between tries. Settling it ` +
+        `by hand with fulfill_reveal reports what is blocking the draw.`;
+    return waited === null
+        ? `Reveal request ${requestId} is open and carries no open time, so its wait cannot be measured against ` +
+            `the ${REVEAL_STUCK_AFTER_SECONDS}-second mark. ${tail}`
+        : `Reveal request ${requestId} has been open for ${waited} seconds, past the ` +
+            `${REVEAL_STUCK_AFTER_SECONDS}-second mark that spans ${REVEAL_STUCK_AFTER_MISSED_SWEEPS} background ` +
+            `settlement passes. ${tail}`;
+}
+function retiredSourceMessage(request, currentSource) {
+    return (`Reveal request ${request.requestId} was opened at randomness source ${request.source}, while the chain ` +
+        `config now reveals through ${currentSource}. A cell takes its draw only from the source its own request ` +
+        `names, so nothing you can send closes this one: fulfill_reveal refuses a request of a retired source, and ` +
+        `retrying it will never clear the cell. The cell stays locked on this open request until an admin of the ` +
+        `contracts clears it on-chain — that admin cleanup is the only way out.`);
+}
+export function revealAttentionItems(input) {
+    const items = [];
+    for (const request of input.requests) {
+        if (!sameAddress(request.source, input.currentSource)) {
+            items.push(attentionItem(request, AttentionReason.RevealSourceRetired, {
+                requestId: request.requestId,
+                requestedAt: request.requestedAt,
+                message: retiredSourceMessage(request, input.currentSource),
+            }));
+            continue;
+        }
+        const waited = request.requestedAt === null ? null : input.serverTime - request.requestedAt;
+        if (waited !== null && waited < REVEAL_STUCK_AFTER_SECONDS) {
+            continue;
+        }
+        items.push(attentionItem(request, AttentionReason.RevealStuck, {
+            requestId: request.requestId,
+            requestedAt: request.requestedAt,
+            message: stuckRevealMessage(request.requestId, waited),
+        }));
+    }
+    return items;
+}
+// Fold tool-layer items (delivery-ready, sourced from the deliveries endpoint) into a map-derived report,
+// re-sorting and re-counting so the merged result stays ordered and consistent.
+export function withExtraItems(report, extraItems, note) {
+    const items = sortAttentionItems([...report.items, ...extraItems]);
+    return { ...report, items, counts: countBySeverity(items), note };
+}
+//# sourceMappingURL=attention.utils.js.map

package/dist/map/attention.utils.js.map

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

package/dist/map/cell-view.utils.d.ts

@@ -0,0 +1,3 @@
+import { type Cell, type CellProjectionConfig, type UnderivedCell } from './types.js';
+export declare function toCell(raw: UnderivedCell, serverTime: number, config: CellProjectionConfig): Cell;
+//# sourceMappingURL=cell-view.utils.d.ts.map

package/dist/map/cell-view.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-view.utils.d.ts","sourceRoot":"","sources":["../../src/map/cell-view.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,IAAI,EAET,KAAK,oBAAoB,EAOzB,KAAK,aAAa,EACrB,MAAM,YAAY,CAAC;AAuCpB,wBAAgB,MAAM,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAQjG"}

package/dist/map/cell-view.utils.js

@@ -0,0 +1,37 @@
+import { processOutputs } from './process.utils.js';
+import { isProcessStalled } from './storage.utils.js';
+const NO_HUB_MULTIPLIER = 1;
+function cellReady(cell, serverTime) {
+    const building = cell.building;
+    if (building === null) {
+        return null;
+    }
+    return building.buildFinishAt === null || serverTime >= building.buildFinishAt;
+}
+function deriveStorage(storage, multiplier) {
+    if (storage === null) {
+        return null;
+    }
+    if (storage.cap === null) {
+        return { ...storage, full: false };
+    }
+    const cap = BigInt(storage.cap) * BigInt(multiplier);
+    return { ...storage, cap: cap.toString(), full: BigInt(storage.used) >= cap };
+}
+function deriveResource(resource, multiplier) {
+    return { ...resource, storage: deriveStorage(resource.storage, multiplier) };
+}
+function deriveProcess(process, resources, config) {
+    if (process === null) {
+        return null;
+    }
+    const stalled = isProcessStalled(processOutputs(process, config.craftOutputsByRecipe), resources);
+    return { ...process, stalled };
+}
+export function toCell(raw, serverTime, config) {
+    const ready = cellReady(raw, serverTime);
+    const activeHub = ready === true && raw.building !== null && config.hubBuildingTypes.has(raw.building.type);
+    const resources = raw.resources.map((resource) => deriveResource(resource, activeHub ? config.hubStorageMultiplier : NO_HUB_MULTIPLIER));
+    return { ...raw, resources, process: deriveProcess(raw.process, resources, config), ready, activeHub };
+}
+//# sourceMappingURL=cell-view.utils.js.map

package/dist/map/cell-view.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-view.utils.js","sourceRoot":"","sources":["../../src/map/cell-view.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AActD,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,SAAS,SAAS,CAAC,IAAa,EAAE,UAAkB;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,QAAQ,CAAC,aAAa,KAAK,IAAI,IAAI,UAAU,IAAI,QAAQ,CAAC,aAAa,CAAC;AACnF,CAAC;AAED,SAAS,aAAa,CAAC,OAAsC,EAAE,UAAkB;IAC7E,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACrD,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;AAClF,CAAC;AAED,SAAS,cAAc,CAAC,QAAyB,EAAE,UAAkB;IACjE,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,aAAa,CAClB,OAAkC,EAClC,SAA8B,EAC9B,MAA4B;IAE5B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAAE,SAAS,CAAC,CAAC;IAClG,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAkB,EAAE,UAAkB,EAAE,MAA4B;IACvF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5G,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC7C,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CACxF,CAAC;IAEF,OAAO,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC3G,CAAC"}

package/dist/map/constants.d.ts

@@ -0,0 +1,17 @@
+export declare const MAP_HTTP_PATH = "/api/v1/map";
+export declare const MAP_SOCKET_NAMESPACE = "/map";
+export declare const MAP_SOCKET_PATH = "/api/socket.io";
+export declare const CELL_UPDATE_EVENT = "cell_update";
+export declare const SERVER_INITIATED_DISCONNECT_REASON = "io server disconnect";
+export declare const DEFAULT_POLL_INTERVAL_MS = 30000;
+export declare const DEFAULT_RECONNECT_GRACE_MS = 5000;
+export declare const STARTUP_FETCH_RETRY_MS = 10000;
+export declare const DEFAULT_AROUND_RADIUS = 2;
+export declare const MAX_AROUND_RADIUS = 10;
+export declare const WAREHOUSE_NEAR_FULL_PCT = 90;
+export declare const BASIS_POINTS = 10000;
+export declare const REVEAL_STUCK_AFTER_MISSED_SWEEPS = 2;
+export declare const REVEAL_STUCK_AFTER_SECONDS: number;
+export declare const REVEAL_RETRY_FLOOR_SECONDS: number;
+export declare const REVEAL_RETRY_CEILING_SECONDS: number;
+//# sourceMappingURL=constants.d.ts.map

package/dist/map/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/map/constants.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAM3C,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAC3C,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAEhD,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAK/C,eAAO,MAAM,kCAAkC,yBAAyB,CAAC;AAEzE,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAChD,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAG7C,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAGpC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,eAAO,MAAM,YAAY,QAAS,CAAC;AAEnC,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,eAAO,MAAM,0BAA0B,QAC8C,CAAC;AAEtF,eAAO,MAAM,0BAA0B,QAAwC,CAAC;AAEhF,eAAO,MAAM,4BAA4B,QAAgD,CAAC"}

package/dist/map/constants.js

@@ -0,0 +1,29 @@
+import { FULFILMENT_BACKOFF_CEILING_MS, FULFILMENT_BACKOFF_MS, FULFILMENT_SWEEP_INTERVAL_MS, MS_PER_SECOND, } from '../randomness/constants.js';
+// Public world-map read. `?since=<version>` returns only cells changed after that version (a delta),
+// so we can re-sync cheaply instead of re-fetching the whole map.
+export const MAP_HTTP_PATH = '/api/v1/map';
+// Namespace and engine path are distinct socket.io concepts: the namespace is appended to the base
+// URL (`<base>/map`), the path is the engine mount. Conflating them is a classic connection bug.
+// The engine is mounted under `/api` so the WebSocket upgrade rides the same edge route as the HTTP
+// API instead of a separate top-level path; this must match the server's gateway path exactly.
+export const MAP_SOCKET_NAMESPACE = '/map';
+export const MAP_SOCKET_PATH = '/api/socket.io';
+export const CELL_UPDATE_EVENT = 'cell_update';
+// socket.io disconnect reason for a server-initiated namespace disconnect. In this case the client
+// does NOT auto-reconnect (it detaches the socket from its manager), so we must reconnect manually.
+// Must match the string emitted by socket.io-client.
+export const SERVER_INITIATED_DISCONNECT_REASON = 'io server disconnect';
+export const DEFAULT_POLL_INTERVAL_MS = 30_000;
+export const DEFAULT_RECONNECT_GRACE_MS = 5_000;
+export const STARTUP_FETCH_RETRY_MS = 10_000;
+// Input bound for the `around` scope (caps the query, not the response).
+export const DEFAULT_AROUND_RADIUS = 2;
+export const MAX_AROUND_RADIUS = 10;
+// A capped warehouse at or above this fill percentage is flagged as "about to stall" by get_attention.
+export const WAREHOUSE_NEAR_FULL_PCT = 90;
+export const BASIS_POINTS = 10_000;
+export const REVEAL_STUCK_AFTER_MISSED_SWEEPS = 2;
+export const REVEAL_STUCK_AFTER_SECONDS = (FULFILMENT_SWEEP_INTERVAL_MS / MS_PER_SECOND) * REVEAL_STUCK_AFTER_MISSED_SWEEPS;
+export const REVEAL_RETRY_FLOOR_SECONDS = FULFILMENT_BACKOFF_MS / MS_PER_SECOND;
+export const REVEAL_RETRY_CEILING_SECONDS = FULFILMENT_BACKOFF_CEILING_MS / MS_PER_SECOND;
+//# sourceMappingURL=constants.js.map

package/dist/map/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/map/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,aAAa,GAChB,MAAM,4BAA4B,CAAC;AAEpC,qGAAqG;AACrG,kEAAkE;AAClE,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAE3C,mGAAmG;AACnG,iGAAiG;AACjG,oGAAoG;AACpG,+FAA+F;AAC/F,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEhD,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE/C,mGAAmG;AACnG,oGAAoG;AACpG,qDAAqD;AACrD,MAAM,CAAC,MAAM,kCAAkC,GAAG,sBAAsB,CAAC;AAEzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAC/C,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAChD,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,yEAAyE;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,uGAAuG;AACvG,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAE1C,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AAEnC,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,0BAA0B,GACnC,CAAC,4BAA4B,GAAG,aAAa,CAAC,GAAG,gCAAgC,CAAC;AAEtF,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAAqB,GAAG,aAAa,CAAC;AAEhF,MAAM,CAAC,MAAM,4BAA4B,GAAG,6BAA6B,GAAG,aAAa,CAAC"}

package/dist/map/map.utils.d.ts

@@ -0,0 +1,19 @@
+import { type Cell, type MapQuery, MapReadiness, type ParsedSnapshot, type MapSummary, type NeighborRef, type RawCell, type ResourceIndex } from './types.js';
+export declare function isNewer(incoming: RawCell, held: RawCell | null): boolean;
+export declare function parseCell(raw: unknown): RawCell | null;
+export declare function parseSnapshot(raw: unknown): ParsedSnapshot;
+export declare function classifyNeighbors(cell: RawCell, getByTokenId: (tokenId: string) => RawCell | null, ownerAddress: string | null): Array<NeighborRef>;
+export declare function buildResourceIndex(cells: Array<RawCell>): ResourceIndex;
+export declare function filterCells(cells: Iterable<RawCell>, query: MapQuery): Array<RawCell>;
+export declare function isDepleted(cell: RawCell): boolean;
+export declare function demolishCooldownEnd(cell: RawCell, serverTime: number): number | null;
+export interface SummarizeInput {
+    readiness: MapReadiness;
+    socketConnected: boolean;
+    version: number;
+    serverTime: number;
+    totalCells: number;
+    ownedCells: Array<Cell> | null;
+}
+export declare function summarizeMap(input: SummarizeInput): MapSummary;
+//# sourceMappingURL=map.utils.d.ts.map

package/dist/map/map.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.utils.d.ts","sourceRoot":"","sources":["../../src/map/map.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,IAAI,EAGT,KAAK,QAAQ,EACb,YAAY,EAEZ,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAEhB,KAAK,OAAO,EAEZ,KAAK,aAAa,EACrB,MAAM,YAAY,CAAC;AAYpB,wBAAgB,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAExE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAGtD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAa1D;AAMD,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,EACjD,YAAY,EAAE,MAAM,GAAG,IAAI,GAC5B,KAAK,CAAC,WAAW,CAAC,CAepB;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,aAAa,CAqBvE;AAiBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,CAYrF;AAGD,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAEjD;AAID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpF;AAwBD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,YAAY,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAc9D"}

package/dist/map/map.utils.js

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+import { CellProcessKind, MapScope, NeighborRelation, rawCellSchema, } from './types.js';
+import { neighborTokenIds, ringDistances } from '../geometry/token.utils.js';
+// The snapshot envelope is parsed strictly (a malformed serverTime/version is a real protocol error), but each
+// cell is parsed tolerantly below — mirrors the socket path, which already drops rather than throws on one cell.
+const snapshotEnvelopeSchema = z.object({
+    serverTime: z.number(),
+    version: z.number(),
+    cells: z.array(z.unknown()),
+});
+// The single apply-if-newer predicate — shared by every write path so dedup stays consistent.
+export function isNewer(incoming, held) {
+    return held === null || incoming.updated > held.updated;
+}
+export function parseCell(raw) {
+    const result = rawCellSchema.safeParse(raw);
+    return result.success ? result.data : null;
+}
+export function parseSnapshot(raw) {
+    const envelope = snapshotEnvelopeSchema.parse(raw);
+    const cells = [];
+    let dropped = 0;
+    for (const rawCell of envelope.cells) {
+        const cell = parseCell(rawCell);
+        if (cell === null) {
+            dropped += 1;
+        }
+        else {
+            cells.push(cell);
+        }
+    }
+    return { snapshot: { serverTime: envelope.serverTime, version: envelope.version, cells }, dropped };
+}
+function sameAddress(a, b) {
+    return a.toLowerCase() === b.toLowerCase();
+}
+export function classifyNeighbors(cell, getByTokenId, ownerAddress) {
+    return neighborTokenIds(cell.tokenId).map((tokenId) => {
+        const neighbor = getByTokenId(tokenId);
+        if (neighbor === null) {
+            return { tokenId, relation: NeighborRelation.Empty };
+        }
+        const relation = ownerAddress !== null && sameAddress(neighbor.owner, ownerAddress)
+            ? NeighborRelation.Owned
+            : NeighborRelation.Other;
+        return { tokenId, relation };
+    });
+}
+// Groups resources by id while keeping each location, so the agent can answer "where is resource X"
+// without scanning every cell.
+export function buildResourceIndex(cells) {
+    const index = {};
+    for (const cell of cells) {
+        for (const resource of cell.resources) {
+            const key = String(resource.resourceId);
+            const location = {
+                tokenId: cell.tokenId,
+                deposit: resource.deposit,
+                balance: resource.balance,
+            };
+            const existing = index[key];
+            if (existing) {
+                existing.push(location);
+            }
+            else {
+                index[key] = [location];
+            }
+        }
+    }
+    return index;
+}
+function matchesQuery(cell, query, aroundSet) {
+    switch (query.scope) {
+        case MapScope.All:
+            return true;
+        case MapScope.Mine:
+            return query.ownerAddress !== null && sameAddress(cell.owner, query.ownerAddress);
+        case MapScope.Around:
+            return aroundSet !== null && aroundSet.has(cell.tokenId);
+        case MapScope.Cells:
+            return query.tokenIds !== null && query.tokenIds.includes(cell.tokenId);
+        case MapScope.Summary:
+            return false;
+    }
+}
+export function filterCells(cells, query) {
+    const aroundSet = query.scope === MapScope.Around && query.around !== null
+        ? new Set(ringDistances(query.around.tokenId, query.around.radius).keys())
+        : null;
+    const result = [];
+    for (const cell of cells) {
+        if (matchesQuery(cell, query, aroundSet)) {
+            result.push(cell);
+        }
+    }
+    return result;
+}
+// A cell counts as depleted only after a reveal — an unrevealed cell has no deposits yet.
+export function isDepleted(cell) {
+    return cell.revealCount > 0 && cell.resources.length > 0 && cell.resources.every((r) => r.deposit === '0');
+}
+// A just-demolished cell is empty (building === null) but locked from rebuilding until demolishFinishAt. Returns
+// that end timestamp while the cooldown is active, else null — callers get the value without a second null-check.
+export function demolishCooldownEnd(cell, serverTime) {
+    return cell.demolishFinishAt !== null && cell.demolishFinishAt > serverTime ? cell.demolishFinishAt : null;
+}
+function countStatuses(cells) {
+    let idle = 0;
+    let mining = 0;
+    let crafting = 0;
+    for (const cell of cells) {
+        const isMining = cell.process?.kind === CellProcessKind.Mining;
+        const isCrafting = cell.process?.kind === CellProcessKind.Craft;
+        if (isMining) {
+            mining += 1;
+        }
+        if (isCrafting) {
+            crafting += 1;
+        }
+        if (cell.revealCount > 0 && !isMining && !isCrafting) {
+            idle += 1;
+        }
+    }
+    return { idle, mining, crafting };
+}
+export function summarizeMap(input) {
+    const { ownedCells } = input;
+    return {
+        version: input.version,
+        serverTime: input.serverTime,
+        readiness: input.readiness,
+        socketConnected: input.socketConnected,
+        totalCells: input.totalCells,
+        myCells: ownedCells === null ? null : ownedCells.length,
+        myCellsByStatus: ownedCells === null ? null : countStatuses(ownedCells),
+        depletedDeposits: ownedCells === null ? null : ownedCells.filter(isDepleted).length,
+        stalledCells: ownedCells === null ? null : ownedCells.filter((c) => c.process?.stalled === true).length,
+    };
+}
+//# sourceMappingURL=map.utils.js.map

package/dist/map/map.utils.js.map

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

package/dist/map/mode.utils.d.ts

@@ -0,0 +1,9 @@
+import { type BuildingMode, type CatalogBuildingView, type CellOutputView, type ModeCostView, type ModeKey } from '../services/types.js';
+import { type ResourceNames } from '../utils/format.utils.js';
+export declare function buildingMode(building: {
+    modeResource: number | null;
+    modeRecipeId: string | null;
+}): BuildingMode;
+export declare function modeCost(building: CatalogBuildingView | null, stored: ModeKey | null, target: ModeKey): ModeCostView;
+export declare function outputsFor(building: CatalogBuildingView, mode: BuildingMode, resources: ResourceNames): Array<CellOutputView>;
+//# sourceMappingURL=mode.utils.d.ts.map

package/dist/map/mode.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.utils.d.ts","sourceRoot":"","sources":["../../src/map/mode.utils.ts"],"names":[],"mappings":"AACA,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,OAAO,EAIf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE5E,wBAAgB,YAAY,CAAC,QAAQ,EAAE;IAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,YAAY,CAKjH;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,YAAY,CAkBpH;AAED,wBAAgB,UAAU,CACtB,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,aAAa,GACzB,KAAK,CAAC,cAAc,CAAC,CAcvB"}

package/dist/map/mode.utils.js

@@ -0,0 +1,43 @@
+import { ModeCostKind, ModeFreeReason, ModeSwitchKind, } from '../services/types.js';
+import { resourceName } from '../utils/format.utils.js';
+export function buildingMode(building) {
+    return {
+        resourceId: building.modeResource,
+        recipeId: building.modeRecipeId ?? null,
+    };
+}
+export function modeCost(building, stored, target) {
+    if (stored === null) {
+        return { kind: ModeCostKind.Free, why: ModeFreeReason.FirstPick };
+    }
+    if (stored === target) {
+        return { kind: ModeCostKind.Free, why: ModeFreeReason.SameOutput };
+    }
+    if (building === null) {
+        return { kind: ModeCostKind.Unknown };
+    }
+    switch (building.modeSwitch.kind) {
+        case ModeSwitchKind.Possible:
+            return { kind: ModeCostKind.Paid, costCpu: building.modeSwitch.costCpu };
+        case ModeSwitchKind.Unknown:
+            return { kind: ModeCostKind.Unknown };
+        case ModeSwitchKind.Impossible:
+            return { kind: ModeCostKind.Unknown };
+    }
+}
+export function outputsFor(building, mode, resources) {
+    const mined = building.minableResources.map((resourceId) => ({
+        resourceId,
+        resourceName: resourceName(resources, resourceId),
+        recipeId: null,
+        cost: modeCost(building, mode.resourceId, resourceId),
+    }));
+    const crafted = building.recipes.map((recipeId) => ({
+        resourceId: null,
+        resourceName: null,
+        recipeId,
+        cost: modeCost(building, mode.recipeId, recipeId),
+    }));
+    return [...mined, ...crafted];
+}
+//# sourceMappingURL=mode.utils.js.map

package/dist/map/mode.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.utils.js","sourceRoot":"","sources":["../../src/map/mode.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAMH,YAAY,EACZ,cAAc,EACd,cAAc,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAsB,MAAM,0BAA0B,CAAC;AAE5E,MAAM,UAAU,YAAY,CAAC,QAAsE;IAC/F,OAAO;QACH,UAAU,EAAE,QAAQ,CAAC,YAAY;QACjC,QAAQ,EAAG,QAAQ,CAAC,YAAqC,IAAI,IAAI;KACpE,CAAC;AACN,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAoC,EAAE,MAAsB,EAAE,MAAe;IAClG,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,CAAC,SAAS,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,CAAC,UAAU,EAAE,CAAC;IACvE,CAAC;IACD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC;IAC1C,CAAC;IACD,QAAQ,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QAC/B,KAAK,cAAc,CAAC,QAAQ;YACxB,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC7E,KAAK,cAAc,CAAC,OAAO;YACvB,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1C,KAAK,cAAc,CAAC,UAAU;YAC1B,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC;IAC9C,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CACtB,QAA6B,EAC7B,IAAkB,EAClB,SAAwB;IAExB,MAAM,KAAK,GAAG,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACzD,UAAU;QACV,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC;QACjD,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;KACxD,CAAC,CAAC,CAAC;IACJ,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAChD,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;QAClB,QAAQ;QACR,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;KACpD,CAAC,CAAC,CAAC;IACJ,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/map/process.utils.d.ts

@@ -0,0 +1,32 @@
+import { type ProcessOutput, type RawCellProcessView } from './types.js';
+export declare function processOutputs(process: RawCellProcessView, craftOutputsByRecipe: Record<string, Array<ProcessOutput>>): Array<ProcessOutput>;
+export interface BatchScheduleInput {
+    durationSec: number;
+    batches: number;
+    claimedBatches: number;
+    startAtSec: number;
+    nowSec: number;
+}
+export interface BatchSchedule {
+    maturedBatches: number;
+    remainingBatches: number;
+    endsAtSec: number;
+    nextBatchAtSec: number | null;
+}
+export declare function computeBatchSchedule({ durationSec, batches, claimedBatches, startAtSec, nowSec, }: BatchScheduleInput): BatchSchedule;
+export interface ProcessProgressInput {
+    schedule: BatchSchedule;
+    claimedBatches: number;
+    settledBatches: number;
+    depleted: boolean;
+    stalled: boolean;
+}
+export interface ProcessProgress {
+    completedBatches: number;
+    claimableBatches: number;
+    isFinished: boolean;
+    endsAtSec: number;
+    nextBatchAtSec: number | null;
+}
+export declare function toProcessProgress({ schedule, claimedBatches, settledBatches, depleted, stalled, }: ProcessProgressInput): ProcessProgress;
+//# sourceMappingURL=process.utils.d.ts.map

package/dist/map/process.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.utils.d.ts","sourceRoot":"","sources":["../../src/map/process.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1F,wBAAgB,cAAc,CAC1B,OAAO,EAAE,kBAAkB,EAC3B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,GAC3D,KAAK,CAAC,aAAa,CAAC,CAKtB;AAED,MAAM,WAAW,kBAAkB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wBAAgB,oBAAoB,CAAC,EACjC,WAAW,EACX,OAAO,EACP,cAAc,EACd,UAAU,EACV,MAAM,GACT,EAAE,kBAAkB,GAAG,aAAa,CAYpC;AAED,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,aAAa,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wBAAgB,iBAAiB,CAAC,EAC9B,QAAQ,EACR,cAAc,EACd,cAAc,EACd,QAAQ,EACR,OAAO,GACV,EAAE,oBAAoB,GAAG,eAAe,CAUxC"}

package/dist/map/process.utils.js

@@ -0,0 +1,30 @@
+import { CellProcessKind } from './types.js';
+export function processOutputs(process, craftOutputsByRecipe) {
+    if (process.kind === CellProcessKind.Mining) {
+        return [{ resourceId: process.resource, amount: process.yieldPerCycle }];
+    }
+    return craftOutputsByRecipe[process.recipeId] ?? [];
+}
+export function computeBatchSchedule({ durationSec, batches, claimedBatches, startAtSec, nowSec, }) {
+    const remainingBatches = Math.max(0, batches - claimedBatches);
+    const elapsedSec = Math.max(0, nowSec - startAtSec);
+    const elapsedBatches = durationSec > 0 ? Math.floor(elapsedSec / durationSec) : 0;
+    const maturedBatches = Math.min(elapsedBatches, remainingBatches);
+    return {
+        maturedBatches,
+        remainingBatches,
+        endsAtSec: startAtSec + remainingBatches * durationSec,
+        nextBatchAtSec: maturedBatches >= remainingBatches ? null : startAtSec + (maturedBatches + 1) * durationSec,
+    };
+}
+export function toProcessProgress({ schedule, claimedBatches, settledBatches, depleted, stalled, }) {
+    const isFinished = settledBatches >= schedule.remainingBatches || depleted;
+    return {
+        completedBatches: claimedBatches + settledBatches,
+        claimableBatches: settledBatches,
+        isFinished,
+        endsAtSec: schedule.endsAtSec,
+        nextBatchAtSec: isFinished || stalled ? null : schedule.nextBatchAtSec,
+    };
+}
+//# sourceMappingURL=process.utils.js.map

package/dist/map/process.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.utils.js","sourceRoot":"","sources":["../../src/map/process.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA+C,MAAM,YAAY,CAAC;AAE1F,MAAM,UAAU,cAAc,CAC1B,OAA2B,EAC3B,oBAA0D;IAE1D,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,oBAAoB,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AAiBD,MAAM,UAAU,oBAAoB,CAAC,EACjC,WAAW,EACX,OAAO,EACP,cAAc,EACd,UAAU,EACV,MAAM,GACW;IACjB,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;IACpD,MAAM,cAAc,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAElE,OAAO;QACH,cAAc;QACd,gBAAgB;QAChB,SAAS,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW;QACtD,cAAc,EAAE,cAAc,IAAI,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC,GAAG,WAAW;KAC9G,CAAC;AACN,CAAC;AAkBD,MAAM,UAAU,iBAAiB,CAAC,EAC9B,QAAQ,EACR,cAAc,EACd,cAAc,EACd,QAAQ,EACR,OAAO,GACY;IACnB,MAAM,UAAU,GAAG,cAAc,IAAI,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC;IAE3E,OAAO;QACH,gBAAgB,EAAE,cAAc,GAAG,cAAc;QACjD,gBAAgB,EAAE,cAAc;QAChC,UAAU;QACV,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,cAAc,EAAE,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc;KACzE,CAAC;AACN,CAAC"}