aimeat 1.40.0 → 2.0.0

package/dist/src/services/db/memory-db-service.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @file src/services/db/memory-db-service.ts
+ * @description Application DB Service for the memory domain — the layer the routes/MCP will call
+ *   INSTEAD of touching storage directly (the missing kerros in doc-id925fp). It exposes WHOLE
+ *   operations (owner-scope read as one unit, a keyspace listing, a write, a record-family delete),
+ *   composing the backend-agnostic {@link ../../storage/repositories-impl/memory-repository.js
+ *   MemoryRepository} on top of a {@link ../../storage/adapter/memory-adapter.js MemoryStorageAdapter}.
+ *   Cross-domain identity resolution (an owner's agents + ecosystem apps) is INJECTED as
+ *   `resolveOwnerIdentities`, so the memory service never reaches into the agent/eco domains itself.
+ *
+ *   Phase 0: this service re-homes the owner-scope aggregation (today in services/owner-memory.ts) and
+ *   the core memory reads/writes onto the new stack, byte-for-byte equivalent (proven by the parity
+ *   test). Routes are migrated onto it in Phase 1; until then it coexists unused by the request path.
+ *
+ * @structure
+ *   MemoryDbService — get / write / delete / listForOwner + owner-scope: getOwnerScope /
+ *     listOwnerScope / listOwnerScopeMeta / countOwnerScope / searchOwnerScope / deleteRecordFamily
+ * @usage const svc = createMemoryDbService(storage, config); await svc.listOwnerScope(owner, opts);
+ * @version-history
+ *   v1.0.0 — 2026-07-15 — Phase 0 scaffolding: owner-scope + core memory ops on the new stack.
+ */
+import type { MemoryRecord } from '../../storage/interface.js';
+import type { CountOpts, ListOpts, MemoryMetaRow, MemoryTextHit, MemoryTextSearchOpts } from '../../storage/adapter/memory-adapter.js';
+import { MemoryRepository } from '../../storage/repositories-impl/memory-repository.js';
+/** One entry of a bulk write. Shape mirrors the single POST /v1/memory body (minus protocol fields the
+ *  route handles: agent targeting, group visibility resolution). */
+export interface BulkWriteItem {
+    key: string;
+    value: unknown;
+    visibility?: MemoryRecord['visibility'];
+    tags?: string[];
+    ttlHours?: number | null;
+    groupId?: string;
+    workspaceRef?: string;
+}
+/** Hard quota numbers for a bulk write (same limits the single-write route enforces). Overage-morsel
+ *  charging is NOT applied in bulk — an entry that would exceed the total quota is failed, not charged. */
+export interface BulkWriteQuota {
+    maxKeysPerOwner: number;
+    maxValueSizeBytes: number;
+    totalQuotaBytes: number;
+}
+export interface BulkWriteOptions {
+    /** 'overwrite' (default): an existing key is updated (version bump). 'skip': an existing key is left
+     *  untouched and reported skipped. */
+    mode?: 'overwrite' | 'skip';
+    quota: BulkWriteQuota;
+    /** Per-item schema/write-guard validation (injected by the route so the memory service stays free of
+     *  the schema domain). Returning `{valid:false}` fails just that item — the batch continues. */
+    validate?: (key: string, value: unknown) => Promise<{
+        valid: boolean;
+    }>;
+}
+export interface BulkItemResult {
+    key: string;
+    status: 'created' | 'updated' | 'skipped' | 'failed';
+    reason?: string;
+}
+export interface BulkWriteResult {
+    created: number;
+    updated: number;
+    skipped: number;
+    failed: number;
+    items: BulkItemResult[];
+}
+/** Injected cross-domain resolver: the ordered identity list for an owner-scope operation — the owner's
+ *  GHII first, then each agent's GAII, then each ecosystem app's GEAI (the priority order the GHII-first
+ *  dedup relies on). Backed by storage.getAgentsByOwner + getEcosystemAppsByOwner in the factory. */
+export type OwnerIdentityResolver = (ownerName: string) => Promise<string[]>;
+export interface MemoryDbServiceDeps {
+    nodeId: string;
+    resolveOwnerIdentities: OwnerIdentityResolver;
+}
+export declare class MemoryDbService {
+    private readonly repo;
+    private readonly deps;
+    constructor(repo: MemoryRepository, deps: MemoryDbServiceDeps);
+    private ghii;
+    get(ownerGaii: string, key: string): Promise<MemoryRecord | null>;
+    write(record: MemoryRecord): Promise<MemoryRecord>;
+    /**
+     * Write MANY entries under one owner as ONE batched operation — the structural replacement for N
+     * separate single-write requests. Reads are batched (one `key IN (…)` existing-lookup + one byte-sum
+     * + one key-count, instead of per-entry round-trips) and the valid rows are committed together
+     * (one transaction on a backend with the bulk primitive). Enforces the SAME hard limits as the single
+     * write (per-value size, key count, total-bytes quota) and the injected schema validation; a failing
+     * entry is recorded and skipped without aborting the batch. Overage-morsel charging is not applied in
+     * bulk (an over-quota entry fails). Protocol guards (reserved-key, anonymous namespace, archive,
+     * workspace access) are the route's responsibility and run before this is called.
+     */
+    writeMany(ownerGaii: string, items: BulkWriteItem[], opts: BulkWriteOptions): Promise<BulkWriteResult>;
+    delete(ownerGaii: string, key: string): Promise<boolean>;
+    listForOwner(ownerGaii: string, opts?: ListOpts): Promise<MemoryRecord[]>;
+    /**
+     * The owner-scope union — every key across the owner's GHII + agents + ecosystem apps, deduped by key
+     * (GHII wins). Same set `GET /v1/memory?owner_scope=true` returns. ONE IN read + a pure dedup.
+     */
+    listOwnerScope(ownerName: string, opts?: ListOpts): Promise<MemoryRecord[]>;
+    /** Owner-scope META listing (`?include=meta`) — value-free rows carrying byteSize, deduped GHII-first. */
+    listOwnerScopeMeta(ownerName: string, opts?: ListOpts): Promise<MemoryMetaRow[]>;
+    /**
+     * One key across the owner-scope (GHII first, then agents/eco in order). Reads the GHII copy first
+     * (the common hit) and only fans across the other identities on a miss — the same two-step shape the
+     * current getOwnerScopeMemory uses, so the round-trip count is unchanged.
+     */
+    getOwnerScope(ownerName: string, key: string): Promise<MemoryRecord | null>;
+    /** DISTINCT-key count across the owner-scope identity set. */
+    countOwnerScope(ownerName: string, opts?: CountOpts): Promise<number>;
+    /** Total value bytes across the owner-scope identity set (profile Home usage). */
+    sumBytesOwnerScope(ownerName: string): Promise<number>;
+    /**
+     * Owner-scope full-text search — ONE indexed query across the owner's whole identity set (GHII +
+     * agents + eco apps), ranked best-first. Mirrors the crud.ts search path.
+     */
+    searchOwnerScope(ownerName: string, query: string, opts?: Omit<MemoryTextSearchOpts, 'ownerGaiis'>): Promise<MemoryTextHit[]>;
+    /**
+     * Delete a record's whole family (`base` + `base.*`) under one owner in one operation — the structural
+     * replacement for the key-by-key delete a CADENCE record teardown does today. Returns rows removed.
+     */
+    deleteRecordFamily(ownerGaii: string, baseKey: string): Promise<number>;
+}
+//# sourceMappingURL=memory-db-service.d.ts.map

package/dist/src/services/db/memory-db-service.d.ts.map

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

package/dist/src/services/db/memory-db-service.js

@@ -0,0 +1,171 @@
+import { MemoryRepository } from '../../storage/repositories-impl/memory-repository.js';
+export class MemoryDbService {
+    repo;
+    deps;
+    constructor(repo, deps) {
+        this.repo = repo;
+        this.deps = deps;
+    }
+    ghii(ownerName) {
+        return `${ownerName}@${this.deps.nodeId}`;
+    }
+    // ── Single-identity core ops ───────────────────────────────────────
+    get(ownerGaii, key) {
+        return this.repo.get(ownerGaii, key);
+    }
+    write(record) {
+        return this.repo.write(record);
+    }
+    /**
+     * Write MANY entries under one owner as ONE batched operation — the structural replacement for N
+     * separate single-write requests. Reads are batched (one `key IN (…)` existing-lookup + one byte-sum
+     * + one key-count, instead of per-entry round-trips) and the valid rows are committed together
+     * (one transaction on a backend with the bulk primitive). Enforces the SAME hard limits as the single
+     * write (per-value size, key count, total-bytes quota) and the injected schema validation; a failing
+     * entry is recorded and skipped without aborting the batch. Overage-morsel charging is not applied in
+     * bulk (an over-quota entry fails). Protocol guards (reserved-key, anonymous namespace, archive,
+     * workspace access) are the route's responsibility and run before this is called.
+     */
+    async writeMany(ownerGaii, items, opts) {
+        const now = new Date().toISOString();
+        const mode = opts.mode ?? 'overwrite';
+        const results = [];
+        const staged = [];
+        // Batched reads: one IN-lookup of every incoming key + one byte-sum + one key-count.
+        const keys = items.map(i => i.key).filter((k) => typeof k === 'string' && k.length > 0);
+        const existingRows = keys.length ? await this.repo.getByKeys(ownerGaii, keys) : [];
+        const existingByKey = new Map(existingRows.map(r => [r.key, r]));
+        let runningBytes = await this.repo.sumBytesForOwner(ownerGaii);
+        let runningKeys = await this.repo.countForOwners([ownerGaii]);
+        for (const item of items) {
+            const key = item.key;
+            if (typeof key !== 'string' || !key) {
+                results.push({ key: String(key), status: 'failed', reason: 'missing key' });
+                continue;
+            }
+            const existing = existingByKey.get(key);
+            if (existing && mode === 'skip') {
+                results.push({ key, status: 'skipped' });
+                continue;
+            }
+            // An archived record is read-only (parity with the single POST /v1/memory, which 409s here) — a
+            // bulk write must not silently overwrite it.
+            if (existing?.archived) {
+                results.push({ key, status: 'failed', reason: 'record is archived (read-only)' });
+                continue;
+            }
+            const valueBytes = Buffer.byteLength(JSON.stringify(item.value ?? null), 'utf8');
+            if (valueBytes > opts.quota.maxValueSizeBytes) {
+                results.push({ key, status: 'failed', reason: 'value too large' });
+                continue;
+            }
+            if (!existing && runningKeys >= opts.quota.maxKeysPerOwner) {
+                results.push({ key, status: 'failed', reason: 'key quota reached' });
+                continue;
+            }
+            if (opts.validate) {
+                const v = await opts.validate(key, item.value);
+                if (!v.valid) {
+                    results.push({ key, status: 'failed', reason: 'schema validation failed' });
+                    continue;
+                }
+            }
+            const existingBytes = existing ? Buffer.byteLength(JSON.stringify(existing.value ?? null), 'utf8') : 0;
+            const projected = runningBytes - existingBytes + valueBytes;
+            if (projected > opts.quota.totalQuotaBytes) {
+                results.push({ key, status: 'failed', reason: 'memory quota exceeded' });
+                continue;
+            }
+            staged.push({
+                key,
+                ownerGaii,
+                value: item.value,
+                visibility: item.visibility ?? 'private',
+                tags: Array.isArray(item.tags) ? item.tags : [],
+                ttlHours: item.ttlHours ?? null,
+                version: existing ? existing.version + 1 : 1,
+                createdAt: existing?.createdAt ?? now,
+                updatedAt: now,
+                ...(item.groupId ? { groupId: item.groupId } : {}),
+                ...(item.workspaceRef ? { workspaceRef: item.workspaceRef } : {}),
+            });
+            results.push({ key, status: existing ? 'updated' : 'created' });
+            runningBytes = projected;
+            if (!existing)
+                runningKeys++;
+        }
+        if (staged.length)
+            await this.repo.writeMany(staged);
+        return {
+            created: results.filter(r => r.status === 'created').length,
+            updated: results.filter(r => r.status === 'updated').length,
+            skipped: results.filter(r => r.status === 'skipped').length,
+            failed: results.filter(r => r.status === 'failed').length,
+            items: results,
+        };
+    }
+    delete(ownerGaii, key) {
+        return this.repo.delete(ownerGaii, key);
+    }
+    listForOwner(ownerGaii, opts) {
+        return this.repo.listForOwner(ownerGaii, opts);
+    }
+    // ── Owner-scope whole operations (GHII + agents + eco apps) ────────
+    /**
+     * The owner-scope union — every key across the owner's GHII + agents + ecosystem apps, deduped by key
+     * (GHII wins). Same set `GET /v1/memory?owner_scope=true` returns. ONE IN read + a pure dedup.
+     */
+    async listOwnerScope(ownerName, opts) {
+        const identities = await this.deps.resolveOwnerIdentities(ownerName);
+        const rows = await this.repo.listForOwners(identities, opts);
+        return MemoryRepository.dedupByKey(rows, identities);
+    }
+    /** Owner-scope META listing (`?include=meta`) — value-free rows carrying byteSize, deduped GHII-first. */
+    async listOwnerScopeMeta(ownerName, opts) {
+        const identities = await this.deps.resolveOwnerIdentities(ownerName);
+        const rows = await this.repo.listMetaForOwners(identities, opts);
+        return MemoryRepository.dedupByKey(rows, identities);
+    }
+    /**
+     * One key across the owner-scope (GHII first, then agents/eco in order). Reads the GHII copy first
+     * (the common hit) and only fans across the other identities on a miss — the same two-step shape the
+     * current getOwnerScopeMemory uses, so the round-trip count is unchanged.
+     */
+    async getOwnerScope(ownerName, key) {
+        const ghii = await this.repo.get(this.ghii(ownerName), key);
+        if (ghii)
+            return ghii;
+        const identities = await this.deps.resolveOwnerIdentities(ownerName);
+        const others = identities.filter(id => id !== this.ghii(ownerName));
+        if (others.length === 0)
+            return null;
+        const rows = await this.repo.getAcrossOwners(others, key);
+        return MemoryRepository.firstByPriority(rows, others);
+    }
+    /** DISTINCT-key count across the owner-scope identity set. */
+    async countOwnerScope(ownerName, opts) {
+        const identities = await this.deps.resolveOwnerIdentities(ownerName);
+        return this.repo.countForOwners(identities, opts);
+    }
+    /** Total value bytes across the owner-scope identity set (profile Home usage). */
+    async sumBytesOwnerScope(ownerName) {
+        const identities = await this.deps.resolveOwnerIdentities(ownerName);
+        return this.repo.sumBytesForOwners(identities);
+    }
+    /**
+     * Owner-scope full-text search — ONE indexed query across the owner's whole identity set (GHII +
+     * agents + eco apps), ranked best-first. Mirrors the crud.ts search path.
+     */
+    async searchOwnerScope(ownerName, query, opts) {
+        const identities = await this.deps.resolveOwnerIdentities(ownerName);
+        return this.repo.search(query, { ...opts, ownerGaiis: identities });
+    }
+    /**
+     * Delete a record's whole family (`base` + `base.*`) under one owner in one operation — the structural
+     * replacement for the key-by-key delete a CADENCE record teardown does today. Returns rows removed.
+     */
+    deleteRecordFamily(ownerGaii, baseKey) {
+        return this.repo.deleteSubtree(ownerGaii, baseKey);
+    }
+}
+//# sourceMappingURL=memory-db-service.js.map

package/dist/src/services/db/memory-db-service.js.map

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

package/dist/src/services/db/memory-tab-db-service.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @file src/services/db/memory-tab-db-service.ts
+ * @description Purpose-built Application DB Service for the profile Memory tab — the ONE call behind
+ *   GET /v1/memory/tab. The tab mounts a 6-request fan-out: agents + owner-scope memory (metadata-only) +
+ *   files + consent + sharing-groups + organisms. This composes all six in ONE read scope. The memory
+ *   section is METADATA-ONLY (no values — the tab lists keys/sizes and fetches values per-row on expand),
+ *   reusing MemoryDbService.listOwnerScopeMeta so a keyspace of thousands of keys lists cheaply. The
+ *   memory list is re-fetched interactively (agent filter / archived toggle), so this serves the MOUNT
+ *   default; the individual /v1/memory endpoint stays for those. Single-master: the Memory tab mount only.
+ *
+ * @structure MemoryTabService.overview(ownerName, ownerGhii) → { agents, memory, files, consents, groups, organisms }
+ * @usage const m = await createMemoryTabService(config, storage).overview(owner, `${owner}@${nodeId}`);
+ * @version-history
+ *   v1.0.0 — 2026-07-16 — Phase 4: fold the Memory tab's 6-request fan-out into one composite (meta-only memory).
+ */
+import type { AimeatConfig } from '../../config.js';
+import type { Storage } from '../../storage/interface.js';
+export interface MemoryTabOverview {
+    agents: unknown[];
+    memory: {
+        items: Array<Record<string, unknown>>;
+        total: number;
+        quota: Record<string, number>;
+    };
+    files: {
+        files: Array<Record<string, unknown>>;
+        total: number;
+    };
+    consents: {
+        consents: Array<Record<string, unknown>>;
+        total: number;
+    };
+    groups: {
+        groups: unknown[];
+    };
+    organisms: {
+        organisms: unknown[];
+    };
+}
+export declare class MemoryTabService {
+    private readonly config;
+    private readonly storage;
+    private readonly memoryDb;
+    constructor(config: AimeatConfig, storage: Storage);
+    /**
+     * The Memory tab mount for one owner in a single read scope. The memory section is metadata-only
+     * (owner-scope: GHII + agents + eco apps, via MemoryDbService — the same set the standalone endpoint
+     * returns), so a large keyspace never loads a single value.
+     */
+    overview(ownerName: string, ownerGhii: string): Promise<MemoryTabOverview>;
+}
+/** Assemble the Memory tab composite over the given storage. */
+export declare function createMemoryTabService(config: AimeatConfig, storage: Storage): MemoryTabService;
+//# sourceMappingURL=memory-tab-db-service.d.ts.map

package/dist/src/services/db/memory-tab-db-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tab-db-service.d.ts","sourceRoot":"","sources":["../../../../src/services/db/memory-tab-db-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAQ1D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAChG,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,QAAQ,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAC9B,SAAS,EAAE;QAAE,SAAS,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CACrC;AAED,qBAAa,gBAAgB;IAEf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAgB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAD3E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBACd,MAAM,EAAE,YAAY,EAAmB,OAAO,EAAE,OAAO;IASpF;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAmE3E;AAED,gEAAgE;AAChE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAE/F"}

package/dist/src/services/db/memory-tab-db-service.js

@@ -0,0 +1,94 @@
+import { runInReadScope } from '../../storage/uow/unit-of-work.js';
+import { LegacyMemoryAdapter } from '../../storage/adapter/legacy-memory-adapter.js';
+import { MemoryRepository } from '../../storage/repositories-impl/memory-repository.js';
+import { MemoryDbService } from './memory-db-service.js';
+import { resolveOwnerIdentities } from './owner-identity.js';
+import { visibilityToZone } from '../../routes/memory/shared.js';
+export class MemoryTabService {
+    config;
+    storage;
+    memoryDb;
+    constructor(config, storage) {
+        this.config = config;
+        this.storage = storage;
+        // Assemble the memory service the same way createMemoryDbService does — inline to avoid a circular
+        // import through services/db/index.js (which re-exports this file).
+        this.memoryDb = new MemoryDbService(new MemoryRepository(new LegacyMemoryAdapter(storage)), {
+            nodeId: config.nodeId,
+            resolveOwnerIdentities: (owner) => resolveOwnerIdentities(storage, config.nodeId, owner),
+        });
+    }
+    /**
+     * The Memory tab mount for one owner in a single read scope. The memory section is metadata-only
+     * (owner-scope: GHII + agents + eco apps, via MemoryDbService — the same set the standalone endpoint
+     * returns), so a large keyspace never loads a single value.
+     */
+    overview(ownerName, ownerGhii) {
+        return runInReadScope(async () => {
+            const agents = await this.storage.getAgentsByOwner(ownerName);
+            const gaiis = [ownerGhii, ...agents.map(a => a.gaii)];
+            const [metaRows, filesByOwner, consents, ownedGroups, memberGroups, organisms] = await Promise.all([
+                this.memoryDb.listOwnerScopeMeta(ownerName, {}),
+                this.storage.listStorageFilesForOwners(gaiis),
+                this.storage.listConsents(ownerGhii),
+                this.storage.listSharingGroups(ownerGhii),
+                this.storage.listSharingGroupsByMember(ownerGhii),
+                this.storage.listOrganisms({ member: ownerName }),
+            ]);
+            // memory (mirrors GET /v1/memory?include=meta): metadata rows + quota, no values.
+            let totalBytes = 0;
+            for (const r of metaRows)
+                totalBytes += r.byteSize;
+            const memory = {
+                items: metaRows.map(r => ({
+                    key: r.key, owner_gaii: r.ownerGaii, bytes: r.byteSize, visibility: r.visibility,
+                    zone: visibilityToZone(r.visibility), tags: r.tags, version: r.version,
+                    flagCount: r.flagCount ?? 0, created_at: r.createdAt, updated_at: r.updatedAt,
+                })),
+                total: metaRows.length,
+                quota: {
+                    max_keys: this.config.memoryMaxKeysPerAgent, used_keys: metaRows.length,
+                    max_bytes: this.config.memoryQuotaMb * 1024 * 1024, used_bytes: totalBytes,
+                },
+            };
+            // files (mirrors GET /v1/memory/files owner session: GHII files first, then each agent).
+            const fileRows = [];
+            for (const g of gaiis) {
+                for (const f of (filesByOwner[g] ?? [])) {
+                    fileRows.push({
+                        key: f.key, owner_gaii: f.ownerGaii, size: f.size, mime_type: f.mimeType,
+                        visibility: f.visibility, tags: f.tags || [], created_at: f.createdAt,
+                    });
+                }
+            }
+            // consent (mirrors GET /v1/consent).
+            const consentRows = consents.map(c => ({
+                id: c.id, data_pattern: c.dataPattern, recipient: c.recipient, purpose: c.purpose,
+                scope: c.scope, expires: c.expires, status: c.status, granted_at: c.grantedAt,
+                revoked_at: c.revokedAt, metadata: c.metadata,
+            }));
+            // groups (mirrors GET /v1/groups owner branch: owned + member-of, deduped by id).
+            const seen = new Set();
+            const groupList = [...ownedGroups, ...memberGroups].filter(g => {
+                const id = g.id ?? '';
+                if (seen.has(id))
+                    return false;
+                seen.add(id);
+                return true;
+            });
+            return {
+                agents,
+                memory,
+                files: { files: fileRows, total: fileRows.length },
+                consents: { consents: consentRows, total: consentRows.length },
+                groups: { groups: groupList },
+                organisms: { organisms },
+            };
+        });
+    }
+}
+/** Assemble the Memory tab composite over the given storage. */
+export function createMemoryTabService(config, storage) {
+    return new MemoryTabService(config, storage);
+}
+//# sourceMappingURL=memory-tab-db-service.js.map

package/dist/src/services/db/memory-tab-db-service.js.map

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

package/dist/src/services/db/messages-inbox-db-service.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @file src/services/db/messages-inbox-db-service.ts
+ * @description Purpose-built Application DB Service for the Messages/Inbox view — the ONE call behind
+ *   GET /v1/messages/overview. The inbox mounts a 6-request fan-out (requests + conversations +
+ *   important-flags + tracked-responses + agents + groups); this composes all six in ONE read scope so
+ *   the owner's agent fleet is resolved a single time (IdentityMap) and the conversations composition is
+ *   reused (not re-implemented). Single-master: it serves the inbox mount and nothing else — the
+ *   individual list endpoints stay for interactive re-fetches (filter/live-update).
+ *
+ * @structure MessagesInboxService.overview(ownerGhii, ownerName) → { requests, conversations, important, tracked, agents, groups }
+ * @usage const inbox = await createMessagesInboxService(storage).overview(ghii, owner);
+ * @version-history
+ *   v1.0.0 — 2026-07-16 — Phase 4: fold the inbox mount's 6-request fan-out into one composite.
+ */
+import type { Storage, AgentRecord } from '../../storage/interface.js';
+import { type OwnerConversation } from './messaging-db-service.js';
+export interface InboxRequest {
+    contactId: string;
+    conversationId: string;
+    preview: string;
+    createdAt: string;
+}
+export interface InboxOverview {
+    requests: InboxRequest[];
+    conversations: OwnerConversation[];
+    important: string[];
+    tracked: unknown[];
+    agents: AgentRecord[];
+    groups: unknown[];
+}
+export declare class MessagesInboxService {
+    private readonly storage;
+    private readonly messaging;
+    constructor(storage: Storage);
+    /**
+     * The whole inbox mount for one owner in a single read scope. The six lists load concurrently; the
+     * conversation composition (owner + agents' external threads) is reused from MessagingDbService, and
+     * the agent fleet it resolves is the same one the `agents` list returns.
+     */
+    overview(ownerGhii: string, ownerName: string): Promise<InboxOverview>;
+    /** Pending first-contact requests with their first-message preview — mirrors GET /v1/messages/requests
+     *  (one batched getDirectMessagesByIds read, not getDirectMessage per pending contact). */
+    private pendingRequests;
+}
+/** Assemble the inbox composite over the given storage. */
+export declare function createMessagesInboxService(storage: Storage): MessagesInboxService;
+//# sourceMappingURL=messages-inbox-db-service.d.ts.map

package/dist/src/services/db/messages-inbox-db-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages-inbox-db-service.d.ts","sourceRoot":"","sources":["../../../../src/services/db/messages-inbox-db-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAuB,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI5F,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAMvF,MAAM,WAAW,YAAY;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC/G,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,qBAAa,oBAAoB;IAEnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IADpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAClB,OAAO,EAAE,OAAO;IAI7C;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA+BtE;+FAC2F;YAC7E,eAAe;CAoB9B;AAED,2DAA2D;AAC3D,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAEjF"}

package/dist/src/services/db/messages-inbox-db-service.js

@@ -0,0 +1,76 @@
+import { runInReadScope } from '../../storage/uow/unit-of-work.js';
+import { conversationIdFor, messagePreview } from '../../utils/messaging.js';
+import { listTrackedResponses } from '../tracked-response.js';
+import { MessagingDbService } from './messaging-db-service.js';
+/** The `message-flag.<id>` key prefix marks a message the owner flagged "important" (record-presence =
+ *  flagged; un-flag deletes it). Mirrors public/js/services/tracked-responses.js FLAG_PREFIX. */
+const FLAG_PREFIX = 'message-flag.';
+export class MessagesInboxService {
+    storage;
+    messaging;
+    constructor(storage) {
+        this.storage = storage;
+        this.messaging = new MessagingDbService(storage);
+    }
+    /**
+     * The whole inbox mount for one owner in a single read scope. The six lists load concurrently; the
+     * conversation composition (owner + agents' external threads) is reused from MessagingDbService, and
+     * the agent fleet it resolves is the same one the `agents` list returns.
+     */
+    overview(ownerGhii, ownerName) {
+        return runInReadScope(async () => {
+            const [requests, convos, importantRecs, tracked, agents, ownedGroups, memberGroups] = await Promise.all([
+                this.pendingRequests(ownerGhii),
+                this.messaging.ownerConversations(ownerGhii, ownerName),
+                this.storage.listMemory(ownerGhii, { prefix: FLAG_PREFIX }),
+                listTrackedResponses(this.storage, ownerGhii),
+                this.storage.getAgentsByOwner(ownerName).catch(() => []),
+                this.storage.listSharingGroups(ownerGhii).catch(() => []),
+                this.storage.listSharingGroupsByMember(ownerGhii).catch(() => []),
+            ]);
+            // important = the message ids behind the flag keys (key = `message-flag.<id>`), same as the
+            // frontend's listImportantMessageIds prefix-map.
+            const important = importantRecs
+                .filter(r => r.key.startsWith(FLAG_PREFIX))
+                .map(r => r.key.slice(FLAG_PREFIX.length));
+            // groups: owned + member-of, deduped by id (mirrors the owner branch of GET /v1/groups).
+            const seen = new Set();
+            const groups = [...ownedGroups, ...memberGroups].filter(g => {
+                const id = g.id ?? '';
+                if (seen.has(id))
+                    return false;
+                seen.add(id);
+                return true;
+            });
+            return { requests, conversations: convos.conversations, important, tracked, agents, groups };
+        });
+    }
+    /** Pending first-contact requests with their first-message preview — mirrors GET /v1/messages/requests
+     *  (one batched getDirectMessagesByIds read, not getDirectMessage per pending contact). */
+    async pendingRequests(ownerGhii) {
+        const pending = await this.storage.listContacts(ownerGhii, { state: 'pending' });
+        const firstIds = pending.map(c => c.firstMessageId).filter((x) => !!x);
+        const firstById = new Map();
+        if (firstIds.length) {
+            const msgs = this.storage.getDirectMessagesByIds
+                ? await this.storage.getDirectMessagesByIds(firstIds, ownerGhii)
+                : (await Promise.all(firstIds.map(id => this.storage.getDirectMessage(id, ownerGhii)))).filter((m) => !!m);
+            for (const m of msgs)
+                firstById.set(m.id, m);
+        }
+        return pending.map(c => {
+            const first = c.firstMessageId ? firstById.get(c.firstMessageId) ?? null : null;
+            return {
+                contactId: c.contactId,
+                conversationId: first?.conversationId ?? conversationIdFor(ownerGhii, c.contactId),
+                preview: messagePreview(first?.body ?? ''),
+                createdAt: c.createdAt,
+            };
+        });
+    }
+}
+/** Assemble the inbox composite over the given storage. */
+export function createMessagesInboxService(storage) {
+    return new MessagesInboxService(storage);
+}
+//# sourceMappingURL=messages-inbox-db-service.js.map

package/dist/src/services/db/messages-inbox-db-service.js.map

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