aimeat 1.25.0 → 1.26.0

package/dist/src/services/federation-book.d.ts

@@ -0,0 +1,70 @@
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+import type { PeerInfo } from './federation.js';
+export declare const FEDERATION_BOOK_GAII = "__federation_book__";
+export declare const FEDERATION_BOOK_KEY = "federation-book.active";
+export interface NodeCardOperator {
+    ghii: string;
+    display_name: string;
+    avatar: string | null;
+}
+export interface NodeCardResources {
+    actions: number;
+    agents: number;
+    boards: number;
+    csms: number;
+    highlights: string[];
+}
+export interface NodeCard {
+    node_id: string;
+    url: string;
+    listed: boolean;
+    software_version?: string;
+    node_type?: string;
+    capabilities?: string[];
+    settings?: Record<string, unknown>;
+    operators?: NodeCardOperator[];
+    resources?: NodeCardResources;
+    node_card_hash?: string;
+    computed_at?: string;
+}
+export interface FederationBook {
+    book_version: number;
+    issued_by: string;
+    issued_at: string;
+    signature?: string;
+    nodes: NodeCard[];
+}
+/** Canonical string the primary signs (and leaves verify) for a book — excludes `signature`. */
+export declare function bookSignString(book: FederationBook): string;
+/**
+ * Build THIS node's card. When the node opts out of listing (config.federationBookListed=false)
+ * the card carries only `{ node_id, url, listed:false }` — no operator identities.
+ */
+export declare function buildNodeCard(config: AimeatConfig, storage: Storage): Promise<NodeCard>;
+/** Read the active book from storage (no module cache — safe across in-process node instances). */
+export declare function getActiveBook(storage: Storage): Promise<FederationBook | null>;
+export declare function storeActiveBook(storage: Storage, book: FederationBook): Promise<void>;
+/**
+ * PRIMARY: assemble the book from active federation peers' node-cards + this node's own card,
+ * sign it, and store it. Bumps book_version only when the node set actually changed (so leaves
+ * don't re-pull unchanged books). Returns the stored book (or the unchanged current one).
+ */
+export declare function assembleBook(config: AimeatConfig, storage: Storage, peers: Map<string, PeerInfo>): Promise<FederationBook>;
+export interface BookPullResult {
+    ok: boolean;
+    status: number;
+    code?: string;
+    message?: string;
+    applied?: boolean;
+    reason?: string;
+    book_version?: number;
+    nodes?: number;
+}
+/**
+ * LEAF: fetch the book from a source (genesis), verify its signature against the issuing peer's
+ * known key (peer record or key cache), version-gate, and store. Shared by the operator pull
+ * endpoint and the leaf auto-sync timer.
+ */
+export declare function pullBook(config: AimeatConfig, storage: Storage, peers: Map<string, PeerInfo>, sourceUrl?: string): Promise<BookPullResult>;
+//# sourceMappingURL=federation-book.d.ts.map

package/dist/src/services/federation-book.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-book.d.ts","sourceRoot":"","sources":["../../../src/services/federation-book.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAQhD,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAC1D,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAC/F,MAAM,WAAW,iBAAiB;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE;AAE1H,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAG3D;AAMD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4C7F;AAED,mGAAmG;AACnG,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAMpF;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAc3F;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAsChI;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA6BhJ"}

package/dist/src/services/federation-book.js

@@ -0,0 +1,198 @@
+/**
+ * @file federation-book.ts
+ * @description The "federation book" — a phone-book of the federation: per node, its operator
+ *   GHIIs, the resources it offers (counts + a few highlights), its AIMEAT version, and curated
+ *   behaviour settings. The PRIMARY (genesis/anchor — a node with no genesisUrl) assembles the book
+ *   from its peers' node-cards + its own, signs it, and serves it; leaf nodes pull + verify + cache
+ *   + serve it, so EVERY node shows the full federation (not just its direct peers).
+ *
+ *   Reuses the signed-doc pattern from network-policy.ts: read straight from storage (no module
+ *   cache → safe for multiple node instances in one test process); sign/verify with the node key.
+ * @structure
+ *   - NodeCard / FederationBook types
+ *   - buildNodeCard(config, storage) — this node's card (or { listed:false } when opted out)
+ *   - bookSignString() · getActiveBook() · storeActiveBook()
+ *   - assembleBook(config, storage, peers) — primary: fetch peer cards + own → sign → store
+ * @usage import { buildNodeCard, assembleBook, getActiveBook } from './federation-book.js';
+ * @version-history
+ *   v1.0.0 — 2026-06-19 — Initial federation book (node-card + primary assembly + signed doc).
+ */
+import { createHash } from 'node:crypto';
+import { buildNodeDescriptor } from '../utils/node-descriptor.js';
+import { computeServiceSummary } from '../utils/service-summary.js';
+import { validateOutboundUrl } from '../utils/url-validator.js';
+import { sign, verify } from '../auth/keypair.js';
+import { peerKeyCache } from './federation-helpers.js';
+import { logger } from '../utils/logger.js';
+export const FEDERATION_BOOK_GAII = '__federation_book__';
+export const FEDERATION_BOOK_KEY = 'federation-book.active';
+/** Canonical string the primary signs (and leaves verify) for a book — excludes `signature`. */
+export function bookSignString(book) {
+    const { signature: _sig, ...rest } = book;
+    return JSON.stringify(rest);
+}
+function sha256(s) {
+    return createHash('sha256').update(s).digest('hex');
+}
+/**
+ * Build THIS node's card. When the node opts out of listing (config.federationBookListed=false)
+ * the card carries only `{ node_id, url, listed:false }` — no operator identities.
+ */
+export async function buildNodeCard(config, storage) {
+    if (!config.federationBookListed) {
+        return { node_id: config.nodeId, url: config.baseUrl, listed: false };
+    }
+    const desc = buildNodeDescriptor(config);
+    const operators = [];
+    try {
+        for (const o of await storage.listOwners()) {
+            if (o.name === 'anonymous' || !o.roles?.includes('operator'))
+                continue;
+            const ghii = await storage.getGHIIByOwner(o.name).catch(() => null);
+            operators.push({
+                ghii: ghii?.ghii ?? `${o.name}@${config.nodeId}`,
+                display_name: ghii?.displayName ?? o.displayName ?? o.name,
+                avatar: ghii?.avatar ?? null,
+            });
+        }
+    }
+    catch { /* operators best-effort */ }
+    let resources = { actions: 0, agents: 0, boards: 0, csms: 0, highlights: [] };
+    try {
+        const s = await computeServiceSummary(config, storage);
+        const highlights = [
+            ...(s.actions ?? []).slice(0, 3).map(a => a.displayName),
+            ...(s.csms ?? []).slice(0, 2).map(c => c.name),
+        ].filter(Boolean).slice(0, 5);
+        resources = { actions: s.actions?.length ?? 0, agents: s.agents?.length ?? 0, boards: s.boards?.length ?? 0, csms: s.csms?.length ?? 0, highlights };
+    }
+    catch { /* resources best-effort */ }
+    const card = {
+        node_id: config.nodeId,
+        url: config.baseUrl,
+        listed: true,
+        software_version: desc.software_version,
+        node_type: desc.node_type,
+        capabilities: desc.capabilities,
+        settings: desc.settings,
+        operators,
+        resources,
+        computed_at: new Date().toISOString(),
+    };
+    const { node_card_hash: _h, computed_at: _c, ...stable } = card;
+    card.node_card_hash = sha256(JSON.stringify(stable));
+    return card;
+}
+/** Read the active book from storage (no module cache — safe across in-process node instances). */
+export async function getActiveBook(storage) {
+    try {
+        const rec = await storage.getMemory(FEDERATION_BOOK_GAII, FEDERATION_BOOK_KEY);
+        if (rec)
+            return rec.value;
+    }
+    catch { /* none */ }
+    return null;
+}
+export async function storeActiveBook(storage, book) {
+    const now = new Date().toISOString();
+    const existing = await storage.getMemory(FEDERATION_BOOK_GAII, FEDERATION_BOOK_KEY).catch(() => null);
+    await storage.setMemory({
+        key: FEDERATION_BOOK_KEY,
+        ownerGaii: FEDERATION_BOOK_GAII,
+        value: book,
+        visibility: 'public',
+        tags: ['federation', 'federation-book'],
+        ttlHours: null,
+        version: (existing?.version ?? 0) + 1,
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+    });
+}
+/**
+ * PRIMARY: assemble the book from active federation peers' node-cards + this node's own card,
+ * sign it, and store it. Bumps book_version only when the node set actually changed (so leaves
+ * don't re-pull unchanged books). Returns the stored book (or the unchanged current one).
+ */
+export async function assembleBook(config, storage, peers) {
+    const nodes = [];
+    const self = await buildNodeCard(config, storage);
+    if (self.listed)
+        nodes.push(self);
+    const active = [...peers.values()].filter(p => p.status === 'active' && p.peerMode !== 'private');
+    for (const peer of active) {
+        try {
+            const check = await validateOutboundUrl(peer.url);
+            if (!check.valid)
+                continue;
+            const resp = await fetch(`${peer.url}/v1/federation/node-card`, { signal: AbortSignal.timeout(config.federationTimeoutMs ?? 5_000) });
+            if (!resp.ok)
+                continue;
+            const body = await resp.json();
+            const card = body?.data;
+            if (card && card.listed) {
+                nodes.push(card);
+                const p = peers.get(peer.nodeId);
+                if (p && card.node_card_hash)
+                    p.nodeCardHash = card.node_card_hash;
+            }
+        }
+        catch { /* skip unreachable peer */ }
+    }
+    nodes.sort((a, b) => a.node_id.localeCompare(b.node_id));
+    const current = await getActiveBook(storage);
+    const contentChanged = !current || JSON.stringify(current.nodes) !== JSON.stringify(nodes);
+    if (!contentChanged)
+        return current;
+    const book = {
+        book_version: (current?.book_version ?? 0) + 1,
+        issued_by: config.nodeId,
+        issued_at: new Date().toISOString(),
+        nodes,
+    };
+    const nodeKey = await storage.getNodeKey();
+    if (nodeKey)
+        book.signature = await sign(nodeKey.privateKey, bookSignString(book));
+    await storeActiveBook(storage, book);
+    logger.info('Federation book assembled', { nodes: nodes.length, version: book.book_version });
+    return book;
+}
+/**
+ * LEAF: fetch the book from a source (genesis), verify its signature against the issuing peer's
+ * known key (peer record or key cache), version-gate, and store. Shared by the operator pull
+ * endpoint and the leaf auto-sync timer.
+ */
+export async function pullBook(config, storage, peers, sourceUrl) {
+    const source = sourceUrl || config.genesisUrl;
+    if (!source)
+        return { ok: false, status: 400, code: 'INVALID_INPUT', message: 'No genesis/source URL configured' };
+    const urlCheck = await validateOutboundUrl(source);
+    if (!urlCheck.valid)
+        return { ok: false, status: 400, code: 'INVALID_URL', message: urlCheck.reason ?? 'source URL failed validation' };
+    let book;
+    try {
+        const resp = await fetch(`${source.replace(/\/+$/, '')}/v1/federation/book`, { signal: AbortSignal.timeout(config.federationTimeoutMs ?? 5_000) });
+        if (!resp.ok)
+            return { ok: false, status: 502, code: 'FETCH_FAILED', message: `Source returned ${resp.status}` };
+        const body = await resp.json();
+        book = body?.data?.book;
+        if (!book || !Array.isArray(book.nodes))
+            return { ok: false, status: 502, code: 'FETCH_FAILED', message: 'Source returned no book' };
+    }
+    catch (e) {
+        return { ok: false, status: 502, code: 'FETCH_FAILED', message: e instanceof Error ? e.message : 'fetch failed' };
+    }
+    const issuer = peers.get(book.issued_by) ?? [...peers.values()].find(p => p.nodeId === book.issued_by);
+    const issuerKey = issuer?.publicKey || peerKeyCache.get(book.issued_by)?.publicKey;
+    if (!issuerKey)
+        return { ok: false, status: 403, code: 'UNKNOWN_ISSUER', message: `Book issuer ${book.issued_by} is not a known peer` };
+    const sigOk = book.signature ? await verify(issuerKey, bookSignString(book), book.signature).catch(() => false) : false;
+    if (!sigOk)
+        return { ok: false, status: 401, code: 'INVALID_SIGNATURE', message: 'Book signature verification failed' };
+    const current = await getActiveBook(storage);
+    if (current && book.book_version <= current.book_version) {
+        return { ok: true, status: 200, applied: false, reason: 'not_newer', book_version: current.book_version };
+    }
+    await storeActiveBook(storage, book);
+    return { ok: true, status: 200, applied: true, book_version: book.book_version, nodes: book.nodes.length };
+}
+//# sourceMappingURL=federation-book.js.map

package/dist/src/services/federation-book.js.map

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

package/dist/src/services/federation-tiers.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @file federation-tiers.ts
+ * @description Single source of truth for federation peer TIERS and the permission
+ *   flags each tier grants. A peer's `tier` decides what it may do on the network;
+ *   `deriveTierFlags(tier)` returns the canonical flag set so the literals live in
+ *   exactly one place (they were previously duplicated across the approve,
+ *   direct-add, and key-exchange paths in federation-peer.ts).
+ *
+ *   Tiers:
+ *   - `visiting` — low-trust self-join tier. Can browse/discover (catalogue read,
+ *     directory, presence) and originate paid work as a REQUESTER, but is never a
+ *     provider-of-record, relay, memory-replication target, or federated-auth
+ *     issuer. This is the "feel the federation immediately" tier.
+ *   - `member` — today's full peer (all flags on except federated auth, which stays
+ *     opt-in). A visiting peer reaches `member` only via a local operator's
+ *     deliberate promotion ("vouch").
+ *   - `genesis` — the anchor/genesis relationship; same capabilities as member,
+ *     tagged distinctly for display.
+ * @structure deriveTierFlags(tier) · coerceTier(raw) · PeerTier type
+ * @usage import { deriveTierFlags, coerceTier } from '../services/federation-tiers.js';
+ * @version-history
+ *   v1.0.0 — 2026-06-19 — Initial tier model (visiting/member/genesis) + flag derivation.
+ */
+export type PeerTier = 'genesis' | 'member' | 'visiting';
+/** The permission flags a tier grants. Mirrors the flag fields on PeerInfo/FederationPeerRecord. */
+export interface TierFlags {
+    shareCatalogue: boolean;
+    replicateMemory: boolean;
+    allowRouting: boolean;
+    peerMode: 'federation' | 'private';
+    allowFederatedAuth: boolean;
+    federationAuthScopes: string[];
+}
+/**
+ * Map a (possibly missing/invalid) tier value to a valid one. Existing peers and
+ * legacy records have no tier → treated as `member` (full capability, back-compat).
+ */
+export declare function coerceTier(raw: unknown): PeerTier;
+/**
+ * Canonical permission flags for a tier. The ONLY place these literals live.
+ * - visiting: discovery + paid-requester only; no provider/relay/replication/auth.
+ * - member/genesis: full federation capability; federated auth stays opt-in.
+ */
+export declare function deriveTierFlags(tier: PeerTier): TierFlags;
+//# sourceMappingURL=federation-tiers.d.ts.map

package/dist/src/services/federation-tiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-tiers.d.ts","sourceRoot":"","sources":["../../../src/services/federation-tiers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzD,oGAAoG;AACpG,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAoBzD"}

package/dist/src/services/federation-tiers.js

@@ -0,0 +1,58 @@
+/**
+ * @file federation-tiers.ts
+ * @description Single source of truth for federation peer TIERS and the permission
+ *   flags each tier grants. A peer's `tier` decides what it may do on the network;
+ *   `deriveTierFlags(tier)` returns the canonical flag set so the literals live in
+ *   exactly one place (they were previously duplicated across the approve,
+ *   direct-add, and key-exchange paths in federation-peer.ts).
+ *
+ *   Tiers:
+ *   - `visiting` — low-trust self-join tier. Can browse/discover (catalogue read,
+ *     directory, presence) and originate paid work as a REQUESTER, but is never a
+ *     provider-of-record, relay, memory-replication target, or federated-auth
+ *     issuer. This is the "feel the federation immediately" tier.
+ *   - `member` — today's full peer (all flags on except federated auth, which stays
+ *     opt-in). A visiting peer reaches `member` only via a local operator's
+ *     deliberate promotion ("vouch").
+ *   - `genesis` — the anchor/genesis relationship; same capabilities as member,
+ *     tagged distinctly for display.
+ * @structure deriveTierFlags(tier) · coerceTier(raw) · PeerTier type
+ * @usage import { deriveTierFlags, coerceTier } from '../services/federation-tiers.js';
+ * @version-history
+ *   v1.0.0 — 2026-06-19 — Initial tier model (visiting/member/genesis) + flag derivation.
+ */
+const VALID_TIERS = new Set(['genesis', 'member', 'visiting']);
+/**
+ * Map a (possibly missing/invalid) tier value to a valid one. Existing peers and
+ * legacy records have no tier → treated as `member` (full capability, back-compat).
+ */
+export function coerceTier(raw) {
+    return VALID_TIERS.has(raw) ? raw : 'member';
+}
+/**
+ * Canonical permission flags for a tier. The ONLY place these literals live.
+ * - visiting: discovery + paid-requester only; no provider/relay/replication/auth.
+ * - member/genesis: full federation capability; federated auth stays opt-in.
+ */
+export function deriveTierFlags(tier) {
+    if (tier === 'visiting') {
+        return {
+            shareCatalogue: true, // may READ our catalogue summary (browse/discover)
+            replicateMemory: false, // not a replication target
+            allowRouting: false, // not a provider-of-record / relay
+            peerMode: 'federation',
+            allowFederatedAuth: false,
+            federationAuthScopes: [],
+        };
+    }
+    // member + genesis: today's full-peer defaults
+    return {
+        shareCatalogue: true,
+        replicateMemory: true,
+        allowRouting: true,
+        peerMode: 'federation',
+        allowFederatedAuth: false, // opt-in even for members (unchanged from today)
+        federationAuthScopes: [],
+    };
+}
+//# sourceMappingURL=federation-tiers.js.map

package/dist/src/services/federation-tiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-tiers.js","sourceRoot":"","sources":["../../../src/services/federation-tiers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAcH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAEzE;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO,WAAW,CAAC,GAAG,CAAC,GAAe,CAAC,CAAC,CAAC,CAAC,GAAe,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAc;IAC5C,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO;YACL,cAAc,EAAE,IAAI,EAAQ,mDAAmD;YAC/E,eAAe,EAAE,KAAK,EAAM,2BAA2B;YACvD,YAAY,EAAE,KAAK,EAAS,mCAAmC;YAC/D,QAAQ,EAAE,YAAY;YACtB,kBAAkB,EAAE,KAAK;YACzB,oBAAoB,EAAE,EAAE;SACzB,CAAC;IACJ,CAAC;IACD,+CAA+C;IAC/C,OAAO;QACL,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,IAAI;QACrB,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,YAAY;QACtB,kBAAkB,EAAE,KAAK,EAAK,iDAAiD;QAC/E,oBAAoB,EAAE,EAAE;KACzB,CAAC;AACJ,CAAC"}

package/dist/src/services/federation.d.ts

@@ -18,6 +18,21 @@ export interface PeerInfo {
     peerMode: 'federation' | 'private';
     allowFederatedAuth: boolean;
     federationAuthScopes: string[];
+    /** Trust tier: 'genesis' | 'member' | 'visiting' (see services/federation-tiers.ts). Absent → 'member'. */
+    tier?: 'genesis' | 'member' | 'visiting';
+    /** Availability label derived from heartbeat uptime (Phase B): 'temporary' | 'permanent' | 'unknown'. */
+    availability?: 'temporary' | 'permanent' | 'unknown';
+    /** Optional expiry for time-limited visiting peers (populated/enforced in Phase B). */
+    expiresAt?: string | null;
+    /** Lifetime successful / attempted heartbeats + windowed availability (Phase B). */
+    heartbeatOk?: number;
+    heartbeatTotal?: number;
+    availabilityWindow?: string | null;
+    availabilityPct?: number | null;
+    /** Peer's AIMEAT software version (from heartbeat) — federation version visibility. */
+    softwareVersion?: string | null;
+    /** Hash of the peer's node-card, for change-detection when assembling the federation book. */
+    nodeCardHash?: string | null;
 }
 /**
  * Resolve which node hosts a GAII. Checks local cache first, then local storage,

package/dist/src/services/federation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"federation.d.ts","sourceRoot":"","sources":["../../../src/services/federation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAUlE,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC7B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAkDrE;AAcD,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAEpE;AAoBD,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC5B,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAC/C,UAAU,CAAC,OAAO,WAAW,CAAC,CAmLhC"}
+{"version":3,"file":"federation.d.ts","sourceRoot":"","sources":["../../../src/services/federation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAKvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAUlE,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,2GAA2G;IAC3G,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IACzC,yGAAyG;IACzG,YAAY,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;IACrD,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,8FAA8F;IAC9F,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC7B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAkDrE;AAcD,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAEpE;AAoBD,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC5B,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAC/C,UAAU,CAAC,OAAO,WAAW,CAAC,CA8LhC"}

package/dist/src/services/federation.js

@@ -5,6 +5,8 @@
 import { createHash } from 'node:crypto';
 import { sign } from '../auth/keypair.js';
 import { computeCatalogueHash } from '../utils/catalogue-hash.js';
+import { recordHeartbeatOutcome } from './federation-availability.js';
+import { getSoftwareVersion } from '../utils/version.js';
 import { logger } from '../utils/logger.js';
 /** Cache of resolved GAIIs to their hosting node URL. TTL: 5 minutes. */
 const gaiiCache = new Map();
@@ -116,6 +118,12 @@ export function startHeartbeatJob(config, storage, peers, networkDirectory) {
         const nodeKey = await storage.getNodeKey();
         const agents = await storage.listAgents();
         const actions = await storage.listActions();
+        // Availability-measurement options (Phase B uptime tracking)
+        const availOpts = {
+            windowDays: config.federationAvailabilityWindowDays,
+            permanentThreshold: config.federationAvailabilityPermanentThreshold,
+            minSamples: config.federationAvailabilityMinSamples,
+        };
         for (const [key, peer] of activePeers) {
             // Per-peer stagger: skip this peer if not yet due
             const stagger = peerStaggerMs(config.nodeId, peer.nodeId, BASE_INTERVAL_MS);
@@ -127,6 +135,7 @@ export function startHeartbeatJob(config, storage, peers, networkDirectory) {
                     node_id: config.nodeId,
                     timestamp: new Date().toISOString(),
                     version: 'v1',
+                    software_version: getSoftwareVersion(),
                     stats: {
                         agents_active: agents.length,
                         actions_published: actions.length,
@@ -150,6 +159,7 @@ export function startHeartbeatJob(config, storage, peers, networkDirectory) {
                     peer.lastSeen = new Date().toISOString();
                     peer.status = 'active';
                     peerFailures.set(key, 0);
+                    recordHeartbeatOutcome(peer, true, new Date(), availOpts);
                     storage.saveFederationPeer(peer).catch(() => { });
                     // Detect catalogue hash mismatch for sync triggering
                     const cachedHash = peerCatalogueHashes.get(key);
@@ -220,6 +230,7 @@ export function startHeartbeatJob(config, storage, peers, networkDirectory) {
                         peer.status = 'degraded';
                         logger.warn(`Peer ${peer.nodeId} degraded after ${failures} consecutive failures`);
                     }
+                    recordHeartbeatOutcome(peer, false, new Date(), availOpts);
                     storage.saveFederationPeer(peer).catch(() => { });
                 }
             }
@@ -235,6 +246,7 @@ export function startHeartbeatJob(config, storage, peers, networkDirectory) {
                 else if (failures >= 3) {
                     peer.status = 'degraded';
                 }
+                recordHeartbeatOutcome(peer, false, new Date(), availOpts);
                 storage.saveFederationPeer(peer).catch(() => { });
             }
         }

package/dist/src/services/federation.js.map

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

package/dist/src/services/librarian.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @file librarian.ts
+ * @description Tier-1 "librarian" retrieval: a single ranked full-text search fanned across ALL of
+ *   a viewer's own memory (their GHII + every agent + every ecosystem app), so one query reaches
+ *   every organism they have contributed to plus their personal notebook content. Built on the
+ *   generic `storage.searchText()` FTS primitive (SQLite FTS5 / MongoDB $text); this service adds
+ *   the fan-across identity set, key→organism/workspace annotation, title extraction and snippeting.
+ *   Auth is implicit: only the viewer's OWN data is searched, so there is no cross-member read to
+ *   gate. (Cross-member organism content readable via consent is a deliberate follow-up — see the
+ *   design doc §5.)
+ * @structure
+ *   - librarianSearch() — resolve identity set → searchText → annotate → LibrarianHit[]
+ *   - annotate()/titleOf()/snippetOf() — presentation helpers
+ * @usage
+ *   const { hits } = await librarianSearch(storage, config, { ownerName, isOwnerSession, viewerGaii, query });
+ * @version-history
+ *   v1.0.0 — 2026-06-19 — Initial: fan-across-organisms full-text librarian over searchText().
+ */
+import type { Storage } from '../storage/interface.js';
+import type { AimeatConfig } from '../config.js';
+export interface LibrarianHit {
+    key: string;
+    ownerGaii: string;
+    title: string;
+    snippet: string;
+    score: number;
+    visibility: string;
+    tags: string[];
+    organismId?: string;
+    workspaceId?: string;
+    space?: string;
+    updatedAt: string;
+    /** Original producer (= ownerGaii); meaningful in the public scope where it is someone else. */
+    producer: string;
+    /** What the hit is, for the badge + the right "open" target. */
+    kind: 'knowledge' | 'document' | 'memory';
+    /** Knowledge-package id (kind==='knowledge'), parsed from the `packages/{id}/…` key. */
+    packageId?: string;
+    /** Knowledge content type (kind==='knowledge'), if present on the manifest. */
+    contentType?: string;
+}
+/**
+ * Run a single ranked full-text query.
+ *   - scope 'own' (default): fanned across every identity the viewer owns (GHII + agents + ecosystem
+ *     apps; an agent session is scoped to itself).
+ *   - scope 'public': across the WHOLE node, restricted to public-visibility content — knowledge
+ *     packages, public workspace documents and public memory — so you can find what others (and
+ *     their agents) have published, with the producer kept on each hit.
+ */
+export declare function librarianSearch(storage: Storage, config: AimeatConfig, opts: {
+    ownerName: string;
+    isOwnerSession: boolean;
+    viewerGaii: string;
+    query: string;
+    limit?: number;
+    keyPrefix?: string;
+    scope?: 'own' | 'public';
+}): Promise<{
+    hits: LibrarianHit[];
+    ownersSearched: number;
+}>;
+//# sourceMappingURL=librarian.d.ts.map

package/dist/src/services/librarian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"librarian.d.ts","sourceRoot":"","sources":["../../../src/services/librarian.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,gGAAgG;IAChG,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1C,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAuED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;CAAE,GACpJ,OAAO,CAAC;IAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CAmD3D"}