aimeat 2.6.1 → 3.0.0

package/dist/src/services/home-feed.js

@@ -0,0 +1,61 @@
+import { ONBOARDING_KEYS } from './onboarding-funnel.js';
+/**
+ * Build the feed. Newest first.
+ *
+ * `pendingAgents` is passed in rather than read here because "an agent is knocking right now" is
+ * live state, not a marker — it is the one row that disappears again, and it is the one the person
+ * most needs to see.
+ */
+export async function readHomeFeed(storage, config, owner, opts = {}) {
+    const ghii = `${owner}@${config.nodeId}`;
+    const [ghiiRecord, markers] = await Promise.all([
+        storage.getGHIIByOwner(owner),
+        storage.listMemoryForOwners([ghii], { prefix: 'onboarding.' }),
+    ]);
+    const byKey = new Map();
+    for (const m of markers) {
+        byKey.set(m.key, (m.value && typeof m.value === 'object' ? m.value : {}));
+    }
+    const at = (key) => {
+        const v = byKey.get(key)?.at;
+        return typeof v === 'string' ? v : null;
+    };
+    const items = [];
+    // The row that exists before anything else does. An account being created IS an event, and a
+    // feed that starts empty tells a new person their home is broken on the first screen they see.
+    if (ghiiRecord?.createdAt) {
+        items.push({ kind: 'account_created', at: ghiiRecord.createdAt, link: '/v1/home' });
+    }
+    const matMark = byKey.get(ONBOARDING_KEYS.welcomeMatPasted) ?? {};
+    if (matMark.result === 'ok' && typeof matMark.at === 'string') {
+        // Straight to the thing they made, not to a settings page about it.
+        items.push({ kind: 'welcome_mat', at: matMark.at, link: `/v1/portfolio/${encodeURIComponent(owner)}` });
+    }
+    // Live, not a marker: this row is here only while someone is actually waiting at the door.
+    if ((opts.pendingAgents ?? 0) > 0) {
+        items.push({
+            kind: 'agent_knocking',
+            at: new Date().toISOString(),
+            link: '/v1/home',
+            data: { count: String(opts.pendingAgents) },
+        });
+    }
+    const firstAgent = byKey.get(ONBOARDING_KEYS.firstAgentConnected) ?? {};
+    if (typeof firstAgent.at === 'string') {
+        items.push({
+            kind: 'agent_connected',
+            at: firstAgent.at,
+            link: '/v1/home',
+            ...(typeof firstAgent.agentName === 'string' ? { data: { name: firstAgent.agentName } } : {}),
+        });
+    }
+    const initAt = at(ONBOARDING_KEYS.homeInitialized);
+    if (initAt)
+        items.push({ kind: 'home_initialized', at: initAt, link: '/v1/home' });
+    const room = byKey.get(ONBOARDING_KEYS.roomEntered) ?? {};
+    if (typeof room.at === 'string' && typeof room.room === 'string') {
+        items.push({ kind: 'room_entered', at: room.at, link: '/v1/home', data: { room: room.room } });
+    }
+    return items.sort((a, b) => b.at.localeCompare(a.at));
+}
+//# sourceMappingURL=home-feed.js.map

package/dist/src/services/home-feed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-feed.js","sourceRoot":"","sources":["../../../src/services/home-feed.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAgBzD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,OAAgB,EAAE,MAAoB,EAAE,KAAa,EACrD,OAAmC,EAAE;IAErC,MAAM,IAAI,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;IACzC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC;QAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;KACjE,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmC,CAAC;IACzD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC,CAAC;IACzG,CAAC;IACD,MAAM,EAAE,GAAG,CAAC,GAAW,EAAiB,EAAE;QACtC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC,CAAC;IAEF,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,6FAA6F;IAC7F,+FAA+F;IAC/F,IAAI,UAAU,EAAE,SAAS,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IAClE,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC5D,oEAAoE;QACpE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,iBAAiB,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,2FAA2F;IAC3F,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,gBAAgB;YACtB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE;SAC9C,CAAC,CAAC;IACP,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC;IACxE,IAAI,OAAO,UAAU,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,iBAAiB;YACvB,EAAE,EAAE,UAAU,CAAC,EAAE;YACjB,IAAI,EAAE,UAAU;YAChB,GAAG,CAAC,OAAO,UAAU,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChG,CAAC,CAAC;IACP,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;IACnD,IAAI,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAEnF,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnG,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/src/services/home-rooms.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @file src/services/home-rooms.ts
+ * @description The rooms (aimeat_remake/07-nelja-huonetta.md), and the check that decides whether
+ *   each one is actually there.
+ *
+ *   They are ROOMS, not paths. All of them are open at once, the person chooses which to walk into
+ *   first, and no door locks behind them. The word "path" is not used for these anywhere — not in
+ *   the copy and not in the code.
+ *
+ *   E11: **a card is shown only when its room exists.** Two of them (monetising
+ *   and company) are built but not everywhere deployed, and a door into an empty room breaks the
+ *   product's own rule about empty states at the exact moment the person has finally got excited.
+ *   So each room states HOW it is checked, and the two that cannot be inferred are operator flags
+ *   defaulting to closed — see the note on the monetising room for what happens when you guess.
+ * @structure ROOMS (with their destinations) · openRooms(storage, config, ownerGhii?)
+ * @usage
+ *   import { openRooms } from '../services/home-rooms.js';
+ *   const rooms = await openRooms(storage, config, resolveIdentity(req.auth!, config.nodeId));
+ * @version-history
+ *   v1.0.0 — 2026-08-07 — Initial (remake phase 7).
+ *   v1.1.0 — 2026-08-07 — The mailbox room, and with it a presence kind that asks about the
+ *     ACCOUNT rather than the node ('has-content'). openRooms takes the owner GHII to answer it.
+ */
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+import type { OnboardingRoom } from './onboarding-funnel.js';
+export interface RoomDef {
+    id: OnboardingRoom;
+    /** Where the door leads. */
+    url: string;
+    /**
+     * How to tell whether the room is really there.
+     *   'always'      — a core surface every node serves.
+     *   'flag'        — an operator has to say so, because "is it usable?" cannot be inferred.
+     *   'company'     — the company surface has to be usable on this node.
+     *   'has-content' — the room holds THINGS rather than offering an action, so it is only real
+     *                   when this account has some. See the note on the messages room.
+     */
+    presence: 'always' | 'flag' | 'company' | 'has-content';
+}
+/**
+ * The rooms, in the order they are offered. The order is the design's, not a ranking: making is
+ * first because it is the one with the shortest path to something a person can show someone else,
+ * and the mailbox is last because it is not an ambition anyone arrives with — it fills by itself.
+ */
+export declare const ROOMS: readonly RoomDef[];
+/**
+ * The rooms that are actually open for this account, each with its destination.
+ *
+ * Never throws: a failed lookup closes that one door rather than taking down the home. A room that
+ * cannot be confirmed is treated as absent, which is the safe direction — showing a door that
+ * leads nowhere is the failure this check exists to prevent.
+ */
+export declare function openRooms(storage: Storage, config: AimeatConfig, ownerGhii?: string): Promise<Array<{
+    id: OnboardingRoom;
+    url: string;
+}>>;
+//# sourceMappingURL=home-rooms.d.ts.map

package/dist/src/services/home-rooms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-rooms.d.ts","sourceRoot":"","sources":["../../../src/services/home-rooms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,cAAc,CAAC;IACnB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;OAOG;IACH,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;CAC3D;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK,EAAE,SAAS,OAAO,EA2BnC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAC3D,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAgCrD"}

package/dist/src/services/home-rooms.js

@@ -0,0 +1,80 @@
+import { logger } from '../utils/logger.js';
+/**
+ * The rooms, in the order they are offered. The order is the design's, not a ranking: making is
+ * first because it is the one with the shortest path to something a person can show someone else,
+ * and the mailbox is last because it is not an ambition anyone arrives with — it fills by itself.
+ */
+export const ROOMS = [
+    // The catalog is a standalone static page, NOT an SPA route. /v1/app-store answers 200 because
+    // the server serves the SPA shell there, but the SPA has no route for it and silently falls
+    // back to the portal — a door that looks like it works and does not.
+    { id: 'create', url: '/app-catalog.html', presence: 'always' },
+    { id: 'organise', url: '/v1/profile?tab=organisms', presence: 'always' },
+    // Behind an operator flag, default OFF.
+    //
+    // This began as "is the app published on this node?", which turned out to be the wrong
+    // question: on 2026-08-07 that test answered OPEN on a node where walking in landed on a
+    // permanent "Loading…" — the isolated app origin (H-2) has no session for someone arriving
+    // cold, so the app never rendered. A published file is not a working destination, and no
+    // cheap check separates the two. So this is a person's judgement, recorded once, instead of
+    // an inference that is confidently wrong. E11: never open a door into a room with nothing.
+    { id: 'monetise', url: '/app-catalog.html', presence: 'flag' },
+    { id: 'company', url: '/v1/profile?tab=companies', presence: 'company' },
+    // The mailbox, last — and the only room gated on THIS ACCOUNT rather than on this node.
+    //
+    // The other four are DOING rooms: you walk in to make something, so finding them empty is the
+    // point of going. This one is a CONTENTS room: you walk in to read what arrived, so empty is
+    // not a starting state, it is the whole content. E11 forbids exactly that door.
+    //
+    // In practice a new account is never empty — the operator's welcome is delivered at
+    // registration (services/welcome-message.ts), so the card is there from the first render.
+    // The check earns its keep on ACCOUNTS THAT ALREADY EXISTED when this shipped: nobody
+    // welcomed them, and without the check every one of them would get a door into nothing.
+    { id: 'messages', url: '/v1/profile?tab=messages', presence: 'has-content' },
+];
+/**
+ * The rooms that are actually open for this account, each with its destination.
+ *
+ * Never throws: a failed lookup closes that one door rather than taking down the home. A room that
+ * cannot be confirmed is treated as absent, which is the safe direction — showing a door that
+ * leads nowhere is the failure this check exists to prevent.
+ */
+export async function openRooms(storage, config, ownerGhii) {
+    const out = [];
+    for (const room of ROOMS) {
+        let present = false;
+        const url = room.url;
+        try {
+            if (room.presence === 'always') {
+                present = true;
+            }
+            else if (room.presence === 'flag') {
+                present = !!config.homeRoomMonetise;
+            }
+            else if (room.presence === 'company') {
+                // The company surface counts as present when this node actually runs companies —
+                // the company origin being configured is the node operator saying so.
+                present = !!config.coOriginEnabled;
+            }
+            else if (room.presence === 'has-content') {
+                // One indexed count, asking only "is there at least one?" — perPage 1 so a busy
+                // mailbox costs the same as an empty one. No caller id (a node-level listing with
+                // no account to ask about) means the answer is no, which is the safe direction.
+                if (ownerGhii) {
+                    const { total } = await storage.listInbox(ownerGhii, { perPage: 1 });
+                    present = total > 0;
+                }
+            }
+        }
+        catch (err) {
+            logger.warn('home-rooms: presence check failed, treating the room as closed', {
+                room: room.id, error: String(err),
+            });
+            present = false;
+        }
+        if (present && url)
+            out.push({ id: room.id, url });
+    }
+    return out;
+}
+//# sourceMappingURL=home-rooms.js.map

package/dist/src/services/home-rooms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-rooms.js","sourceRoot":"","sources":["../../../src/services/home-rooms.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAiB5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAuB;IACrC,+FAA+F;IAC/F,4FAA4F;IAC5F,qEAAqE;IACrE,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC9D,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,2BAA2B,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACxE,wCAAwC;IACxC,EAAE;IACF,uFAAuF;IACvF,yFAAyF;IACzF,2FAA2F;IAC3F,yFAAyF;IACzF,4FAA4F;IAC5F,2FAA2F;IAC3F,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE;IAC9D,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,2BAA2B,EAAE,QAAQ,EAAE,SAAS,EAAE;IACxE,wFAAwF;IACxF,EAAE;IACF,8FAA8F;IAC9F,6FAA6F;IAC7F,gFAAgF;IAChF,EAAE;IACF,oFAAoF;IACpF,0FAA0F;IAC1F,sFAAsF;IACtF,wFAAwF;IACxF,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,0BAA0B,EAAE,QAAQ,EAAE,aAAa,EAAE;CAC/E,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,OAAgB,EAAE,MAAoB,EAAE,SAAkB;IAE1D,MAAM,GAAG,GAA+C,EAAE,CAAC;IAC3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,IAAI,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC7B,OAAO,GAAG,IAAI,CAAC;YACnB,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;gBAClC,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACxC,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACrC,iFAAiF;gBACjF,sEAAsE;gBACtE,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC;YACvC,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;gBACzC,gFAAgF;gBAChF,kFAAkF;gBAClF,gFAAgF;gBAChF,IAAI,SAAS,EAAE,CAAC;oBACZ,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;oBACrE,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC;gBACxB,CAAC;YACL,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,gEAAgE,EAAE;gBAC1E,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;aACpC,CAAC,CAAC;YACH,OAAO,GAAG,KAAK,CAAC;QACpB,CAAC;QACD,IAAI,OAAO,IAAI,GAAG;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/src/services/home-state.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @file src/services/home-state.ts
+ * @description Where an account stands on the new path (aimeat_remake/06-koti-feed-suostumus.md).
+ *   One computed answer, read by every remake surface — the home view, the welcome-mat endpoint,
+ *   the feed and the funnel — so none of them can disagree about whether a home exists.
+ *
+ *   "Initialized" is DERIVED, never a flag someone sets. Three things must be true at once: the
+ *   welcome mat exists, a first agent is connected, and the Hello MCP proof key has been written
+ *   through that connection. A stored boolean would let a home be initialized by a bug, and the
+ *   whole point of the gate is that it cannot be talked past — an account either has these three
+ *   or it does not.
+ *
+ *   The `onboarding.home_initialized` marker is written the first time the derived state comes out
+ *   true. It is a funnel timestamp, not the source of truth: deleting it would change the numbers
+ *   and not the person's home.
+ * @structure
+ *   - readHomeState(storage, config, owner) → HomeState
+ *   - HOME_STEPS: the three named steps, in order
+ * @usage
+ *   import { readHomeState } from '../services/home-state.js';
+ *   const state = await readHomeState(storage, config, req.auth!.owner);
+ * @version-history
+ *   v1.1.0 — 2026-08-09 — The agent card carries the SAME health verdict the Agents tab shows
+ *     (services/agent-health.ts), plus how many agents there are and how many are in trouble.
+ *     It carried none: the card was derived from agents.length, so the home said "connected and
+ *     at home" about an agent the Agents tab was calling a problem. It also showed agents[0] of
+ *     an unordered list; the shown agent is now the WORST one, and the list is ordered by both
+ *     providers. `initialized` requires a LIVE agent — an account whose every agent was dead
+ *     still read "your home is ready".
+ *   v1.0.0 — 2026-08-07 — Initial (remake phases 2–3).
+ */
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+import { type OnboardingTrack, type OnboardingBranch, type OnboardingRoom } from './onboarding-funnel.js';
+import { type AgentHealth } from './agent-health.js';
+/**
+ * The steps, in the order a person meets them. `better-app` exists only on branch B and is what
+ * pushes the agent connection to step 3 there; on branch A there are two steps, not three. Named
+ * here so no surface invents a fourth.
+ */
+export declare const HOME_STEPS: readonly ["welcome-mat", "better-app", "first-agent"];
+export type HomeStep = typeof HOME_STEPS[number];
+export interface HomeState {
+    owner: string;
+    ghii: string;
+    displayName: string | null;
+    track: OnboardingTrack;
+    switched: number;
+    /** The step the person is ON. `null` once the home is initialized. */
+    step: HomeStep | null;
+    mat: {
+        done: boolean;
+        /** How many pastes it took. Grades the prompt, never the person. */
+        attempts: number;
+        result: 'ok' | 'failed' | null;
+        /** Where the mat can be looked at, once there is one. */
+        url: string | null;
+        standaloneUrl: string | null;
+    };
+    /** What the mat said about the AI that wrote it, or what the person answered. */
+    ai: {
+        model: string | null;
+        vendor: string | null;
+        client: string | null;
+        /** The /v1/ai-tools id the claim resolved to, or null when nothing matched. */
+        resolvedClient: string | null;
+        mcp: 'yes' | 'no' | 'unknown' | null;
+        source: 'meta' | 'asked' | null;
+    } | null;
+    /** How the account ARRIVED — the funnel's value, write-once, historical. */
+    branch: OnboardingBranch | null;
+    /**
+     * Whether the person is STILL waiting on an app that can connect. Recomputed from what is
+     * currently known about their AI, never stored: `branch` is write-once and stays 'B' forever
+     * once they arrive that way, so reading it as "are they stuck?" would trap someone on the
+     * branch-B screen for good the moment they fixed the very thing it asked for.
+     */
+    needsBetterApp: boolean;
+    /**
+     * The agent the card shows, plus how many there are and how many are in trouble.
+     *
+     * `health` is the SAME verdict the Agents tab renders (services/agent-health.ts). The card used
+     * to carry no status at all — it was derived from `agents.length`, so the home said "connected
+     * and at home" about an agent the Agents tab was calling a problem, one click away.
+     */
+    agent: {
+        name: string;
+        gaii: string;
+        connectedAt: string | null;
+        health: AgentHealth;
+        /** How many agents the owner has, so one card cannot imply there is only one. */
+        total: number;
+        /** How many are in the `issue` bucket. A number the card can say out loud. */
+        problems: number;
+    } | null;
+    /** Whether an agent has written the proof key through its own MCP connection. */
+    helloMcp: boolean;
+    /** mat ∧ agent ∧ helloMcp. Derived every time; never trusted from storage. */
+    initialized: boolean;
+    /** The FIRST room entered, once one has been. */
+    room: OnboardingRoom | null;
+}
+declare const val: (rec: {
+    value?: unknown;
+} | null) => Record<string, unknown>;
+declare const str: (o: Record<string, unknown>, k: string) => string | null;
+/**
+ * Read the whole state in one pass.
+ *
+ * Deliberately reads rather than caches: this runs on a page load and a paste, not in a loop, and
+ * a cached onboarding state that lags behind the agent the person just approved is the exact
+ * "nothing happened" moment the remake exists to remove.
+ */
+export declare function readHomeState(storage: Storage, config: AimeatConfig, owner: string): Promise<HomeState>;
+/** `val`/`str` are exported for the sibling home routes that read the same markers. */
+export { val as markerValue, str as markerString };
+//# sourceMappingURL=home-state.d.ts.map

package/dist/src/services/home-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-state.d.ts","sourceRoot":"","sources":["../../../src/services/home-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,OAAO,EACqC,KAAK,eAAe,EAAE,KAAK,gBAAgB,EACnF,KAAK,cAAc,EACtB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAK1F;;;;GAIG;AACH,eAAO,MAAM,UAAU,uDAAwD,CAAC;AAChF,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE;QACD,IAAI,EAAE,OAAO,CAAC;QACd,oEAAoE;QACpE,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC;QAC/B,yDAAyD;QACzD,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,iFAAiF;IACjF,EAAE,EAAE;QACA,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,+EAA+E;QAC/E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;QACrC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;KACnC,GAAG,IAAI,CAAC;IACT,4EAA4E;IAC5E,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC;;;;;OAKG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB;;;;;;OAMG;IACH,KAAK,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,MAAM,EAAE,WAAW,CAAC;QACpB,iFAAiF;QACjF,KAAK,EAAE,MAAM,CAAC;QACd,8EAA8E;QAC9E,QAAQ,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,WAAW,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;CAC/B;AAED,QAAA,MAAM,GAAG,GAAI,KAAK;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAC8B,CAAC;AACpG,QAAA,MAAM,GAAG,GAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,KAAG,MAAM,GAAG,IACA,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAsB,aAAa,CAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GACtD,OAAO,CAAC,SAAS,CAAC,CAEpB;AAmJD,uFAAuF;AACvF,OAAO,EAAE,GAAG,IAAI,WAAW,EAAE,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/src/services/home-state.js

@@ -0,0 +1,160 @@
+import { getOwnerScopeMemory } from './owner-memory.js';
+import { HELLO_MCP_KEY } from './hello-mcp.js';
+import { ONBOARDING_KEYS, recordOnboardingEvent, } from './onboarding-funnel.js';
+import { resolveAiClient, decideBranch } from './ai-tool-setup.js';
+import { portfolioReadGaiis, PORTFOLIO_HTML_KEY, portfolioStandaloneUrl } from '../routes/portfolio.js';
+import { logger } from '../utils/logger.js';
+import { computeAgentHealthMany, isLiveState } from './agent-health.js';
+import { loadOwnerAgents } from './db/owner-identity.js';
+import { runInReadScope } from '../storage/read-scope/read-scope.js';
+/**
+ * The steps, in the order a person meets them. `better-app` exists only on branch B and is what
+ * pushes the agent connection to step 3 there; on branch A there are two steps, not three. Named
+ * here so no surface invents a fourth.
+ */
+export const HOME_STEPS = ['welcome-mat', 'better-app', 'first-agent'];
+const val = (rec) => (rec && rec.value && typeof rec.value === 'object' ? rec.value : {});
+const str = (o, k) => (typeof o[k] === 'string' && o[k] ? o[k] : null);
+/**
+ * Read the whole state in one pass.
+ *
+ * Deliberately reads rather than caches: this runs on a page load and a paste, not in a loop, and
+ * a cached onboarding state that lags behind the agent the person just approved is the exact
+ * "nothing happened" moment the remake exists to remove.
+ */
+export async function readHomeState(storage, config, owner) {
+    return runInReadScope(() => readHomeStateInScope(storage, config, owner));
+}
+/** The body. Split out so the read scope above wraps the WHOLE composite: the agent list is read
+ *  once here and reused by anything else composed into the same request. */
+async function readHomeStateInScope(storage, config, owner) {
+    const ghii = `${owner}@${config.nodeId}`;
+    const [ghiiRecord, agents, markers] = await Promise.all([
+        storage.getGHIIByOwner(owner),
+        loadOwnerAgents(storage, owner),
+        storage.listMemoryForOwners([ghii], { prefix: 'onboarding.' }),
+    ]);
+    const byKey = new Map();
+    for (const m of markers) {
+        byKey.set(m.key, (m.value && typeof m.value === 'object' ? m.value : {}));
+    }
+    const get = (key) => byKey.get(key) ?? {};
+    const track = get(ONBOARDING_KEYS.track);
+    const matMark = get(ONBOARDING_KEYS.welcomeMatPasted);
+    const aiMark = get(ONBOARDING_KEYS.aiModelDetected);
+    const firstAgent = get(ONBOARDING_KEYS.firstAgentConnected);
+    // The mat is a FILE, not a marker: the marker says a paste happened, the file says a page
+    // exists. Reading the file is what keeps a deleted portfolio from leaving a home standing.
+    let matHtmlExists = false;
+    for (const gaii of await portfolioReadGaiis(storage, owner, config.nodeId)) {
+        if (await storage.getStorageFile(gaii, PORTFOLIO_HTML_KEY)) {
+            matHtmlExists = true;
+            break;
+        }
+    }
+    // The proof key is written by the AGENT under its own GAII, so this must read owner-scope.
+    const helloMcp = !!(await getOwnerScopeMemory(storage, config.nodeId, owner, HELLO_MCP_KEY));
+    // Which agent the card shows. The list is ordered by both providers now (createdAt, gaii), so
+    // agents[0] is the FIRST agent rather than whatever the storage engine happened to return —
+    // on Postgres that used to change after every heartbeat.
+    //
+    // The one shown is the worst one, not the first: a card that reports the oldest agent as
+    // healthy while another is broken is the same lie in a different place. `problems` carries the
+    // count so the card never implies the fleet is one agent.
+    const nowMs = Date.now();
+    const onboardings = await Promise.all(agents.map(a => storage.getOnboarding(a.gaii).catch(err => {
+        // A missing onboarding record and a failed read both mean "cannot judge onboarding",
+        // and the verdict degrades to 'new' either way — but a read that FAILED is worth
+        // knowing about, so it is logged rather than swallowed.
+        logger.warn('home-state: continuing after a suppressed onboarding read', {
+            gaii: a.gaii, error: String(err),
+        });
+        return null;
+    })));
+    const onboardingByGaii = {};
+    agents.forEach((a, i) => { onboardingByGaii[a.gaii] = onboardings[i] ?? null; });
+    const healthByGaii = computeAgentHealthMany(agents, onboardingByGaii, nowMs);
+    const worst = agents.length
+        ? agents.reduce((best, a) => healthByGaii[a.gaii].rank < healthByGaii[best.gaii].rank ? a : best, agents[0])
+        : null;
+    const agent = worst
+        ? {
+            name: worst.name,
+            gaii: worst.gaii,
+            connectedAt: str(firstAgent, 'at') ?? worst.createdAt ?? null,
+            health: healthByGaii[worst.gaii],
+            total: agents.length,
+            problems: agents.filter(a => healthByGaii[a.gaii].bucket === 'issue').length,
+        }
+        : null;
+    // An agent EXISTING was enough before, so an account whose every agent was dead still read
+    // "your home is ready". A home is not ready on the strength of a record.
+    const hasLiveAgent = agents.some(a => isLiveState(healthByGaii[a.gaii].state));
+    const initialized = matHtmlExists && hasLiveAgent && helloMcp;
+    const branch = (typeof get(ONBOARDING_KEYS.branchTaken).branch === 'string'
+        ? get(ONBOARDING_KEYS.branchTaken).branch : null);
+    // Are they STILL waiting on an app that can connect? Re-decided from what is currently known
+    // about their AI, using the same function the paste used — so re-pasting with a capable app
+    // moves them on by itself, with no separate "I upgraded" claim to make and nothing to reset.
+    // Reading `branch === 'B'` instead would strand them: that marker is write-once.
+    const paidAnswer = typeof aiMark.has_paid_plan === 'boolean' ? aiMark.has_paid_plan : undefined;
+    const needsBetterApp = matHtmlExists
+        && decideBranch(resolveAiClient(str(aiMark, 'client')), { hasPaidPlan: paidAnswer }).branch === 'B';
+    const state = {
+        owner,
+        ghii,
+        displayName: ghiiRecord?.displayName ?? null,
+        track: track.track === 'remake' ? 'remake' : 'legacy',
+        switched: typeof track.switched === 'number' ? track.switched : 0,
+        step: initialized ? null
+            : !matHtmlExists ? 'welcome-mat'
+                : needsBetterApp ? 'better-app'
+                    : 'first-agent',
+        mat: {
+            done: matHtmlExists,
+            attempts: typeof matMark.attempts === 'number' ? matMark.attempts : 0,
+            result: matMark.result === 'ok' ? 'ok' : matMark.result === 'failed' ? 'failed' : null,
+            url: matHtmlExists ? `/v1/portfolio/${encodeURIComponent(owner)}` : null,
+            standaloneUrl: matHtmlExists ? portfolioStandaloneUrl(config, owner) : null,
+        },
+        ai: Object.keys(aiMark).length
+            ? {
+                model: str(aiMark, 'model'),
+                vendor: str(aiMark, 'vendor'),
+                client: str(aiMark, 'client'),
+                mcp: aiMark.mcp === 'yes' || aiMark.mcp === 'no' || aiMark.mcp === 'unknown' ? aiMark.mcp : null,
+                // Which of the eight their claim resolved to, so a surface can point at THEIR app
+                // rather than re-deriving it from a label and getting a near-miss.
+                resolvedClient: str(aiMark, 'resolved_client'),
+                source: (aiMark.source === 'asked' ? 'asked' : aiMark.source === 'meta' ? 'meta' : null),
+            }
+            : null,
+        branch,
+        needsBetterApp,
+        agent,
+        helloMcp,
+        initialized,
+        room: (typeof get(ONBOARDING_KEYS.roomEntered).room === 'string'
+            ? get(ONBOARDING_KEYS.roomEntered).room : null),
+    };
+    // First time the three conditions line up, stamp the funnel. Fire-and-forget and write-once:
+    // this is a timestamp for the numbers, not the thing that makes the home real.
+    if (initialized && !byKey.has(ONBOARDING_KEYS.homeInitialized)) {
+        void recordOnboardingEvent(storage, config, owner, ONBOARDING_KEYS.homeInitialized, {
+            via: branch ?? 'A',
+        }).catch(err => logger.warn('home-state: home_initialized marker failed', { owner, error: String(err) }));
+        // An account the agent door started reaching a finished home is the door's own result.
+        // Derived here rather than by a job: the outcome is a function of the same three conditions,
+        // and a scheduler that had to guess when a chain "ended" would report abandonment for
+        // people who simply took two days.
+        if (byKey.has(ONBOARDING_KEYS.agentDoorStarted)) {
+            void recordOnboardingEvent(storage, config, owner, ONBOARDING_KEYS.agentDoorResult, {
+                result: 'home_initialized',
+            }).catch(err => logger.warn('home-state: agent_door_result marker failed', { owner, error: String(err) }));
+        }
+    }
+    return state;
+}
+/** `val`/`str` are exported for the sibling home routes that read the same markers. */
+export { val as markerValue, str as markerString };
+//# sourceMappingURL=home-state.js.map

package/dist/src/services/home-state.js.map

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

package/dist/src/services/inactivity-nudge.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @file src/services/inactivity-nudge.ts
+ * @description One friendly email to somebody nobody has seen for a fortnight, carrying a prompt
+ *   they can run the moment they read it.
+ *
+ *   **It adds no storage.** "Last seen" is not a column here, because the node already records
+ *   three timestamps that each mean a person was alive, and the largest of the three is the
+ *   answer: a browser session refreshing, an AI connector calling, or a plain sign-in. A new
+ *   `lastActiveAt` column would have to be back-filled and would still say nothing about the
+ *   fortnight before it existed. The nightly job pays for the reads instead — nightly is exactly
+ *   where that trade is cheap.
+ *
+ *   Deliberately: **an agent that has been working counts as the person being alive.** Emailing
+ *   somebody "we have not seen you" while their AI has been writing to their account all week is
+ *   the failure mode worth designing against, not the one worth optimising.
+ *
+ *   Consent is the switch that already exists. `settings.email_notifications` has been written by
+ *   the profile for a long time and read by nothing — every email footer promised a control that
+ *   governed nothing. This job honours it, and so does the older rescue pass.
+ *
+ *   **Off unless the operator turns it on** (`AIMEAT_INACTIVITY_NUDGE=true`). It is unsolicited
+ *   mail to real people; the default cannot be "starts sending".
+ * @structure
+ *   - lastSeenAt(storage, ghii): the max of the three existing signals
+ *   - runInactivityNudgeJob(config, storage, opts?): the nightly pass
+ *   - nudgeEmailContent(config, locale, prompt): the copy, en + fi
+ * @usage
+ *   // Registered as core handler 'inactivity-nudge' in services/core-jobs.ts.
+ *   await runInactivityNudgeJob(config, storage);
+ * @version-history
+ *   v1.0.0 — 2026-08-07 — Initial.
+ */
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+import type { GHIIRecord } from '../storage/types/identity.js';
+/** How long a silence has to last before it is worth a message. */
+export declare const INACTIVITY_DAYS = 14;
+/**
+ * And how long before the same person may be nudged again. Without it a nightly job mails whoever
+ * is still quiet every single night — the single most likely way this feature turns into spam.
+ */
+export declare const NUDGE_COOLDOWN_DAYS = 60;
+/**
+ * Accounts that went quiet BEFORE this shipped are left alone. Someone who drifted away months ago
+ * getting "we have not seen you in a while" reads as a system that has been watching, not helping
+ * — the same reasoning the onboarding rescue states for its own epoch.
+ */
+export declare const NUDGE_FEATURE_EPOCH = "2026-08-07T00:00:00Z";
+/**
+ * When this person was last demonstrably alive, from signals the node already keeps:
+ *   - a browser session's `lastUsedAt`, bumped on every refresh-token rotation,
+ *   - a chat instance's `lastSeen`, bumped on every MCP call their AI makes,
+ *   - `lastLoginAt`, which alone is far too coarse: with a 30-day idle refresh window a daily user
+ *     can carry a month-old value, so it is the floor rather than the answer.
+ * Returns 0 when nothing is known, which the caller treats as "cannot tell" rather than "gone".
+ */
+export declare function lastSeenAt(storage: Storage, g: GHIIRecord): Promise<number>;
+/**
+ * May the node send this person a non-transactional email?
+ *
+ * Reads `settings.email_notifications`, the key the profile's notification tab has been writing
+ * all along.
+ *
+ * `defaultWhenAbsent` exists because the two callers genuinely differ, and getting it wrong is
+ * visible to the user either way:
+ *
+ *   - The NUDGE passes **false**. The toggle in the profile renders unchecked when nothing is
+ *     stored, so somebody who looks at it sees "off". Sending anyway would make the switch a lie
+ *     in exactly the way this work set out to fix.
+ *   - The onboarding RESCUE passes **true**, preserving what it does today. Flipping it would
+ *     silently switch off a working feature for every account that has never opened the tab, which
+ *     is not a change to make as a side effect.
+ */
+export declare function mayEmailOwner(storage: Storage, ghii: string, defaultWhenAbsent?: boolean): Promise<boolean>;
+interface NudgeCopy {
+    subject: string;
+    heading: string;
+    paragraphs: string[];
+    closing: string;
+}
+/**
+ * The words. Short, not disappointed in anyone, and the prompt is IN the message — the point is
+ * that reading the email and doing the thing are the same action.
+ */
+export declare function nudgeEmailContent(config: AimeatConfig, locale: 'en' | 'fi', displayName: string): NudgeCopy;
+/**
+ * The nightly pass. One email per quiet account, at most once every cooldown.
+ *
+ * Order matters and is the same order the rescue uses, for the same reason: eligibility, then
+ * CONSENT, then send, then marker. Writing the marker before the consent check would mean someone
+ * who later turns notifications back on is never reached again.
+ */
+export declare function runInactivityNudgeJob(config: AimeatConfig, storage: Storage, 
+/** Test seam: freeze the clock and the epoch. Production callers pass nothing. */
+opts?: {
+    now?: number;
+    epoch?: number;
+}): Promise<{
+    sent: number;
+    considered: number;
+}>;
+export {};
+//# sourceMappingURL=inactivity-nudge.d.ts.map

package/dist/src/services/inactivity-nudge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inactivity-nudge.d.ts","sourceRoot":"","sources":["../../../src/services/inactivity-nudge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAO/D,mEAAmE;AACnE,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAe1D;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAejF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAC/B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,UAAQ,GAC1D,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,UAAU,SAAS;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAE/F;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAsB3G;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACvC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO;AAChB,kFAAkF;AAClF,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAwE/C"}