aimeat 1.40.0 → 2.0.0

package/dist/src/services/db/generator-state-db-service.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file src/services/db/generator-state-db-service.ts
+ * @description Purpose-built Application DB Service for the Generator **project dashboard** mount — the ONE
+ *   memory read behind GET /v1/generator/:projectId/state. Opening a generator project fired an 11-request
+ *   waterfall, of which EIGHT were separate owner-scope memory scans under the SAME `generator.{id}.`
+ *   prefix: getProject, getInterviewSpec, loadAllComponents (component.* + spec.*), getPendingEdit, then
+ *   getComponentStatuses re-ran loadAllComponents (component.* + spec.* AGAIN), plus a cleanup scan. This
+ *   folds all of those into a SINGLE prefix scan partitioned by key sub-prefix. The three cross-domain
+ *   live-registry reads the status check needs (extensions / cortex / apps) stay separate requests — a
+ *   different subsystem, same boundary discipline as the ledger / skill-bundle slices → the mount goes
+ *   11→4. Single-master: the Generator dashboard mount only. Individual /v1/memory reads stay as fallback +
+ *   interactive re-fetch (save, live-update).
+ *
+ * @structure GeneratorStateService.state(ownerGhii, projectId) → { project, interviewSpec, pendingEdit, componentItems, specItems } | null
+ * @usage const st = await createGeneratorStateService(storage).state(ownerGhii, projectId);
+ * @version-history
+ *   v1.0.0 — 2026-07-16 — Phase 4: fold the Generator dashboard's 8 memory scans into one prefix scan.
+ */
+import type { Storage } from '../../storage/interface.js';
+interface RawItem {
+    key: string;
+    value: unknown;
+    version: number;
+}
+export interface GeneratorState {
+    project: RawItem;
+    interviewSpec: RawItem | null;
+    pendingEdit: RawItem | null;
+    componentItems: RawItem[];
+    specItems: RawItem[];
+}
+export declare class GeneratorStateService {
+    private readonly storage;
+    constructor(storage: Storage);
+    /**
+     * The Generator dashboard mount for one owner project in a single read scope. Reads across the owner's
+     * identities (GHII + agents), mirroring the dashboard's `owner_scope=true` reads — generator data may be
+     * created by the owner's generator agent (device auth), so a single-GHII read would miss it. Returns null
+     * when the project key is absent (the route maps that to 404). Raw records are returned {key, value,
+     * version} so the dashboard parses/merges them with its existing (unchanged) transform logic; version is
+     * preserved for the optimistic-lock writes the editor makes.
+     */
+    state(ownerName: string, ownerGhii: string, projectId: string): Promise<GeneratorState | null>;
+}
+/** Assemble the Generator dashboard state composite over the given storage. */
+export declare function createGeneratorStateService(storage: Storage): GeneratorStateService;
+export {};
+//# sourceMappingURL=generator-state-db-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator-state-db-service.d.ts","sourceRoot":"","sources":["../../../../src/services/db/generator-state-db-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAG1D,UAAU,OAAO;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAElE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CA2B/F;AAED,+EAA+E;AAC/E,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,qBAAqB,CAEnF"}

package/dist/src/services/db/generator-state-db-service.js

@@ -0,0 +1,45 @@
+import { runInReadScope } from '../../storage/uow/unit-of-work.js';
+export class GeneratorStateService {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * The Generator dashboard mount for one owner project in a single read scope. Reads across the owner's
+     * identities (GHII + agents), mirroring the dashboard's `owner_scope=true` reads — generator data may be
+     * created by the owner's generator agent (device auth), so a single-GHII read would miss it. Returns null
+     * when the project key is absent (the route maps that to 404). Raw records are returned {key, value,
+     * version} so the dashboard parses/merges them with its existing (unchanged) transform logic; version is
+     * preserved for the optimistic-lock writes the editor makes.
+     */
+    state(ownerName, ownerGhii, projectId) {
+        return runInReadScope(async () => {
+            const prefix = `generator.${projectId}.`;
+            const agents = await this.storage.getAgentsByOwner(ownerName);
+            const gaiis = [ownerGhii, ...agents.map(a => a.gaii)];
+            const records = await this.storage.listMemoryForOwners(gaiis, { prefix });
+            const pick = (key) => {
+                const r = records.find(m => m.key === key);
+                return r ? { key: r.key, value: r.value, version: r.version } : null;
+            };
+            const project = pick(`${prefix}project`);
+            if (!project)
+                return null;
+            const componentPrefix = `${prefix}component.`;
+            const specPrefix = `${prefix}spec.`;
+            const raw = (r) => ({ key: r.key, value: r.value, version: r.version });
+            return {
+                project,
+                interviewSpec: pick(`${prefix}interview-spec`),
+                pendingEdit: pick(`${prefix}pending-edit`),
+                componentItems: records.filter(m => m.key.startsWith(componentPrefix)).map(raw),
+                specItems: records.filter(m => m.key.startsWith(specPrefix)).map(raw),
+            };
+        });
+    }
+}
+/** Assemble the Generator dashboard state composite over the given storage. */
+export function createGeneratorStateService(storage) {
+    return new GeneratorStateService(storage);
+}
+//# sourceMappingURL=generator-state-db-service.js.map

package/dist/src/services/db/generator-state-db-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-state-db-service.js","sourceRoot":"","sources":["../../../../src/services/db/generator-state-db-service.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAYnE,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEjD;;;;;;;OAOG;IACH,KAAK,CAAC,SAAiB,EAAE,SAAiB,EAAE,SAAiB;QAC3D,OAAO,cAAc,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,MAAM,GAAG,aAAa,SAAS,GAAG,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAC9D,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAE1E,MAAM,IAAI,GAAG,CAAC,GAAW,EAAkB,EAAE;gBAC3C,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;gBAC3C,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACvE,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,MAAM,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;YAE1B,MAAM,eAAe,GAAG,GAAG,MAAM,YAAY,CAAC;YAC9C,MAAM,UAAU,GAAG,GAAG,MAAM,OAAO,CAAC;YACpC,MAAM,GAAG,GAAG,CAAC,CAAmD,EAAW,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAEnI,OAAO;gBACL,OAAO;gBACP,aAAa,EAAE,IAAI,CAAC,GAAG,MAAM,gBAAgB,CAAC;gBAC9C,WAAW,EAAE,IAAI,CAAC,GAAG,MAAM,cAAc,CAAC;gBAC1C,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;gBAC/E,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;aACtE,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,+EAA+E;AAC/E,MAAM,UAAU,2BAA2B,CAAC,OAAgB;IAC1D,OAAO,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/src/services/db/home-dashboard-service.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file src/services/db/home-dashboard-service.ts
+ * @description Composite Application DB Service for the profile Home dashboard — the ONE call that
+ *   replaces the profile shell's 8-request stats-bar fan-out plus the Usage and Agents cards' separate
+ *   polls. It does not re-implement any domain's logic: it COMPOSES the per-domain services/functions
+ *   ({@link ./agent-db-service.js AgentDbService}, the cached usage summary, the work domain) inside ONE
+ *   read scope, so the owner's agent list — which the stats, the agents card AND the work count all need
+ *   — is resolved a SINGLE time via the IdentityMap and served to each. This is the aggregate-over-
+ *   domain-services pattern the redesign calls for (build the domain services once, compose them here,
+ *   don't duplicate).
+ *
+ * @structure
+ *   - HomeDashboardService.load(owner) → { stats, usage, agents } inside runInReadScope
+ *   - HomeStats / HomeDashboard payload types
+ * @usage const home = createHomeDashboardService(config, storage).load(owner);
+ * @version-history
+ *   v1.0.0 — 2026-07-15 — Phase 3: compose AgentDbService + usage summary + work into one home payload.
+ */
+import type { AimeatConfig } from '../../config.js';
+import type { Storage } from '../../storage/interface.js';
+import { type OwnerUsageSummary } from '../usage-summary.js';
+import { AgentDbService, type HomeAgent } from './agent-db-service.js';
+/** The stats-bar counts (the 8 figures the profile shell shows for every authenticated user). Every one
+ *  is derived from data the composite already loads — no figure costs its own extra fan-out. */
+export interface HomeStats {
+    /** Total agents (incl. chat-session agents), matching the old stats bar. */
+    agents: number;
+    chatSessions: number;
+    /** Morsel balance (from the usage summary's morsels block). */
+    balance: number;
+    /** Owner-scope memory keys / files / services / apps (reused from the cached usage summary). */
+    memory: number;
+    files: number;
+    services: number;
+    apps: number;
+    /** Pending work items across the owner's agents. */
+    work: number;
+}
+export interface HomeDashboard {
+    stats: HomeStats;
+    /** The full owner usage summary (quota bars + resource counts) the Usage card renders. */
+    usage: OwnerUsageSummary;
+    /** Real (non-session) agents, most-recently-seen first — the Agents card list. */
+    agents: HomeAgent[];
+}
+export declare class HomeDashboardService {
+    private readonly config;
+    private readonly storage;
+    private readonly agents;
+    constructor(config: AimeatConfig, storage: Storage, agents: AgentDbService);
+    /**
+     * The whole Home dashboard for one owner in a single read scope. usage, the agent overview and the
+     * work count run concurrently; the agent list each of them needs is loaded ONCE (IdentityMap) rather
+     * than three times. usage stays behind its own 60s cache, so a warm visit recomputes nothing.
+     */
+    load(owner: string): Promise<HomeDashboard>;
+    /** Pending work across the owner's agents — the agents list comes from the IdentityMap (0 extra reads),
+     *  then ONE batched count (providerGaii IN (…) AND status IN (…)) instead of a listWorkByProvider per
+     *  agent. This is the fan-out→IN rule (doc-id925fp §6.5): at 100 agents the Home chain drops from ~100
+     *  work queries to 1. */
+    private pendingWorkCount;
+}
+/** Assemble the Home dashboard composite over the given storage. */
+export declare function createHomeDashboardService(config: AimeatConfig, storage: Storage): HomeDashboardService;
+//# sourceMappingURL=home-dashboard-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"home-dashboard-service.d.ts","sourceRoot":"","sources":["../../../../src/services/db/home-dashboard-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAwB,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE7F;gGACgG;AAChG,MAAM,WAAW,SAAS;IACxB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,0FAA0F;IAC1F,KAAK,EAAE,iBAAiB,CAAC;IACzB,kFAAkF;IAClF,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAID,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,cAAc;IAGzC;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB3C;;;6BAGyB;YACX,gBAAgB;CAK/B;AAED,oEAAoE;AACpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAEvG"}

package/dist/src/services/db/home-dashboard-service.js

@@ -0,0 +1,57 @@
+import { runInReadScope } from '../../storage/uow/unit-of-work.js';
+import { getOwnerUsageSummary } from '../usage-summary.js';
+import { createAgentDbService } from './agent-db-service.js';
+const PENDING_WORK = new Set(['pending', 'accepted', 'in_progress']);
+export class HomeDashboardService {
+    config;
+    storage;
+    agents;
+    constructor(config, storage, agents) {
+        this.config = config;
+        this.storage = storage;
+        this.agents = agents;
+    }
+    /**
+     * The whole Home dashboard for one owner in a single read scope. usage, the agent overview and the
+     * work count run concurrently; the agent list each of them needs is loaded ONCE (IdentityMap) rather
+     * than three times. usage stays behind its own 60s cache, so a warm visit recomputes nothing.
+     */
+    load(owner) {
+        return runInReadScope(async () => {
+            const [overview, usage, work] = await Promise.all([
+                this.agents.ownerAgentOverview(owner),
+                getOwnerUsageSummary(this.config, this.storage, owner),
+                this.pendingWorkCount(owner),
+            ]);
+            return {
+                stats: {
+                    agents: overview.stats.total,
+                    chatSessions: overview.stats.chatSessions,
+                    balance: usage.morsels.balance,
+                    memory: usage.memory.used_keys,
+                    files: usage.storage.used_files,
+                    services: usage.counts.services.used,
+                    apps: usage.counts.apps.used,
+                    work,
+                },
+                usage,
+                agents: overview.agents,
+            };
+        });
+    }
+    /** Pending work across the owner's agents — the agents list comes from the IdentityMap (0 extra reads),
+     *  then ONE batched count (providerGaii IN (…) AND status IN (…)) instead of a listWorkByProvider per
+     *  agent. This is the fan-out→IN rule (doc-id925fp §6.5): at 100 agents the Home chain drops from ~100
+     *  work queries to 1. */
+    async pendingWorkCount(owner) {
+        const agents = await this.agents.listOwnerAgents(owner);
+        if (agents.length === 0)
+            return 0;
+        return this.storage.countPendingWorkByProviders(agents.map(a => a.gaii), [...PENDING_WORK]);
+    }
+}
+/** Assemble the Home dashboard composite over the given storage. */
+export function createHomeDashboardService(config, storage) {
+    return new HomeDashboardService(config, storage, createAgentDbService(storage, config));
+}
+//# sourceMappingURL=home-dashboard-service.js.map

package/dist/src/services/db/home-dashboard-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-dashboard-service.js","sourceRoot":"","sources":["../../../../src/services/db/home-dashboard-service.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAA0B,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAkB,oBAAoB,EAAkB,MAAM,uBAAuB,CAAC;AA2B7F,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AAErE,MAAM,OAAO,oBAAoB;IAEZ;IACA;IACA;IAHnB,YACmB,MAAoB,EACpB,OAAgB,EAChB,MAAsB;QAFtB,WAAM,GAAN,MAAM,CAAc;QACpB,YAAO,GAAP,OAAO,CAAS;QAChB,WAAM,GAAN,MAAM,CAAgB;IACtC,CAAC;IAEJ;;;;OAIG;IACH,IAAI,CAAC,KAAa;QAChB,OAAO,cAAc,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChD,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC;gBACrC,oBAAoB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;gBACtD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;aAC7B,CAAC,CAAC;YACH,OAAO;gBACL,KAAK,EAAE;oBACL,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK;oBAC5B,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;oBACzC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO;oBAC9B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;oBAC9B,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU;oBAC/B,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI;oBACpC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;oBAC5B,IAAI;iBACL;gBACD,KAAK;gBACL,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;6BAGyB;IACjB,KAAK,CAAC,gBAAgB,CAAC,KAAa;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAC9F,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,UAAU,0BAA0B,CAAC,MAAoB,EAAE,OAAgB;IAC/E,OAAO,IAAI,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1F,CAAC"}

package/dist/src/services/db/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file src/services/db/index.ts
+ * @description Factory + barrel for the Application DB Service layer. `createMemoryDbService(storage,
+ *   config)` assembles the full stack — wraps the existing `Storage` in a
+ *   {@link ../../storage/adapter/legacy-memory-adapter.js LegacyMemoryAdapter}, layers the
+ *   backend-agnostic {@link ../../storage/repositories-impl/memory-repository.js MemoryRepository}, and
+ *   returns a {@link ./memory-db-service.js MemoryDbService} with owner-identity resolution backed by
+ *   storage. This is the ONE wiring seam the routes migrate onto in Phase 1 (they call the service
+ *   instead of storage); building it here keeps the assembly in a single place and off the request path
+ *   until then.
+ *
+ * @structure createMemoryDbService(storage, config) → MemoryDbService; re-exports of the layer types
+ * @usage const memoryDb = createMemoryDbService(storage, config);
+ * @version-history
+ *   v1.0.0 — 2026-07-15 — Phase 0 scaffolding: assemble adapter → repository → service.
+ */
+import type { AimeatConfig } from '../../config.js';
+import type { Storage } from '../../storage/interface.js';
+import { MemoryDbService } from './memory-db-service.js';
+export { MemoryDbService } from './memory-db-service.js';
+export { MemoryRepository } from '../../storage/repositories-impl/memory-repository.js';
+export { LegacyMemoryAdapter } from '../../storage/adapter/legacy-memory-adapter.js';
+export { AgentDbService, createAgentDbService } from './agent-db-service.js';
+export { HomeDashboardService, createHomeDashboardService } from './home-dashboard-service.js';
+export { MessagingDbService, createMessagingDbService, type OwnerConversation } from './messaging-db-service.js';
+export { MessagesInboxService, createMessagesInboxService, type InboxOverview } from './messages-inbox-db-service.js';
+export { AccessTabService, createAccessTabService, type AccessOverview } from './access-tab-db-service.js';
+export { WalletTabService, createWalletTabService, type WalletOverview } from './wallet-tab-db-service.js';
+export { MemoryTabService, createMemoryTabService, type MemoryTabOverview } from './memory-tab-db-service.js';
+export { PackagesTabService, createPackagesTabService, type PackagesOverview } from './packages-tab-db-service.js';
+export { NotebookService, createNotebookService, type NotebookOverview } from './notebook-db-service.js';
+export { CalibratorDetailService, createCalibratorDetailService, type CalibratorDetail } from './calibrator-detail-db-service.js';
+export { AgentActivityOverviewService, createAgentActivityOverviewService, type AgentActivityOverview } from './agent-activity-overview-db-service.js';
+export { AgentDataAccessOverviewService, createAgentDataAccessOverviewService, type AgentDataAccessOverview } from './agent-data-access-overview-db-service.js';
+export { AgentIntegrationOverviewService, createAgentIntegrationOverviewService, type AgentIntegrationOverview } from './agent-integration-overview-db-service.js';
+export { AgentQualityOverviewService, createAgentQualityOverviewService, type AgentQualityOverview } from './agent-quality-overview-db-service.js';
+export { WorkTabService, createWorkTabService, type WorkOverview } from './work-tab-db-service.js';
+export { DataWalletService, createDataWalletService, type DataWalletOverview } from './data-wallet-db-service.js';
+export { LivingDocsService, createLivingDocsService, type LivingDocsOverview } from './living-docs-db-service.js';
+export { AgentMessagesOverviewService, createAgentMessagesOverviewService, type AgentMessagesOverview } from './agent-messages-overview-db-service.js';
+export { SecurityTabService, createSecurityTabService, type SecurityOverview } from './security-tab-db-service.js';
+export { KnowledgeTabService, createKnowledgeTabService, type KnowledgeOverview } from './knowledge-tab-db-service.js';
+export { loadOwnerAgents, loadOwnerEcoApps, resolveOwnerIdentities } from './owner-identity.js';
+/** Assemble the memory Application-DB-Service over the given storage (Phase 0: LegacyMemoryAdapter). Its
+ *  owner-scope identity resolution is the shared IdentityMap-aware {@link ./owner-identity.js} source —
+ *  the same one AgentDbService and usage-summary use — so the list is built once per operation. */
+export declare function createMemoryDbService(storage: Storage, config: Pick<AimeatConfig, 'nodeId'>): MemoryDbService;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/services/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/db/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC/F,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACjH,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACtH,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC3G,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC3G,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACzG,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,KAAK,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAClI,OAAO,EAAE,4BAA4B,EAAE,kCAAkC,EAAE,KAAK,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACvJ,OAAO,EAAE,8BAA8B,EAAE,oCAAoC,EAAE,KAAK,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAChK,OAAO,EAAE,+BAA+B,EAAE,qCAAqC,EAAE,KAAK,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACnK,OAAO,EAAE,2BAA2B,EAAE,iCAAiC,EAAE,KAAK,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnJ,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAClH,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAClH,OAAO,EAAE,4BAA4B,EAAE,kCAAkC,EAAE,KAAK,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACvJ,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEhG;;mGAEmG;AACnG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,eAAe,CAO7G"}

package/dist/src/services/db/index.js

@@ -0,0 +1,40 @@
+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';
+export { MemoryDbService } from './memory-db-service.js';
+export { MemoryRepository } from '../../storage/repositories-impl/memory-repository.js';
+export { LegacyMemoryAdapter } from '../../storage/adapter/legacy-memory-adapter.js';
+export { AgentDbService, createAgentDbService } from './agent-db-service.js';
+export { HomeDashboardService, createHomeDashboardService } from './home-dashboard-service.js';
+export { MessagingDbService, createMessagingDbService } from './messaging-db-service.js';
+export { MessagesInboxService, createMessagesInboxService } from './messages-inbox-db-service.js';
+export { AccessTabService, createAccessTabService } from './access-tab-db-service.js';
+export { WalletTabService, createWalletTabService } from './wallet-tab-db-service.js';
+export { MemoryTabService, createMemoryTabService } from './memory-tab-db-service.js';
+export { PackagesTabService, createPackagesTabService } from './packages-tab-db-service.js';
+export { NotebookService, createNotebookService } from './notebook-db-service.js';
+export { CalibratorDetailService, createCalibratorDetailService } from './calibrator-detail-db-service.js';
+export { AgentActivityOverviewService, createAgentActivityOverviewService } from './agent-activity-overview-db-service.js';
+export { AgentDataAccessOverviewService, createAgentDataAccessOverviewService } from './agent-data-access-overview-db-service.js';
+export { AgentIntegrationOverviewService, createAgentIntegrationOverviewService } from './agent-integration-overview-db-service.js';
+export { AgentQualityOverviewService, createAgentQualityOverviewService } from './agent-quality-overview-db-service.js';
+export { WorkTabService, createWorkTabService } from './work-tab-db-service.js';
+export { DataWalletService, createDataWalletService } from './data-wallet-db-service.js';
+export { LivingDocsService, createLivingDocsService } from './living-docs-db-service.js';
+export { AgentMessagesOverviewService, createAgentMessagesOverviewService } from './agent-messages-overview-db-service.js';
+export { SecurityTabService, createSecurityTabService } from './security-tab-db-service.js';
+export { KnowledgeTabService, createKnowledgeTabService } from './knowledge-tab-db-service.js';
+export { loadOwnerAgents, loadOwnerEcoApps, resolveOwnerIdentities } from './owner-identity.js';
+/** Assemble the memory Application-DB-Service over the given storage (Phase 0: LegacyMemoryAdapter). Its
+ *  owner-scope identity resolution is the shared IdentityMap-aware {@link ./owner-identity.js} source —
+ *  the same one AgentDbService and usage-summary use — so the list is built once per operation. */
+export function createMemoryDbService(storage, config) {
+    const adapter = new LegacyMemoryAdapter(storage);
+    const repo = new MemoryRepository(adapter);
+    return new MemoryDbService(repo, {
+        nodeId: config.nodeId,
+        resolveOwnerIdentities: (ownerName) => resolveOwnerIdentities(storage, config.nodeId, ownerName),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/src/services/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/db/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC/F,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAA0B,MAAM,2BAA2B,CAAC;AACjH,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAsB,MAAM,gCAAgC,CAAC;AACtH,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAuB,MAAM,4BAA4B,CAAC;AAC3G,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAuB,MAAM,4BAA4B,CAAC;AAC3G,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAA0B,MAAM,4BAA4B,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAyB,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAyB,MAAM,0BAA0B,CAAC;AACzG,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAyB,MAAM,mCAAmC,CAAC;AAClI,OAAO,EAAE,4BAA4B,EAAE,kCAAkC,EAA8B,MAAM,yCAAyC,CAAC;AACvJ,OAAO,EAAE,8BAA8B,EAAE,oCAAoC,EAAgC,MAAM,4CAA4C,CAAC;AAChK,OAAO,EAAE,+BAA+B,EAAE,qCAAqC,EAAiC,MAAM,4CAA4C,CAAC;AACnK,OAAO,EAAE,2BAA2B,EAAE,iCAAiC,EAA6B,MAAM,wCAAwC,CAAC;AACnJ,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAqB,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAA2B,MAAM,6BAA6B,CAAC;AAClH,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAA2B,MAAM,6BAA6B,CAAC;AAClH,OAAO,EAAE,4BAA4B,EAAE,kCAAkC,EAA8B,MAAM,yCAAyC,CAAC;AACvJ,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAyB,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAA0B,MAAM,+BAA+B,CAAC;AACvH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEhG;;mGAEmG;AACnG,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,MAAoC;IAC1F,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,IAAI,eAAe,CAAC,IAAI,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,sBAAsB,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;KACzG,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * @file src/services/db/knowledge-tab-db-service.ts
+ * @description Purpose-built Application DB Service for the profile **Knowledge** tab — the ONE call behind
+ *   GET /v1/knowledge/tab for the tab's OWNER-scoped data: the owner's knowledge packages (a memory read)
+ *   + their consents (from which the tab derives which packages are federated). Composes both in one read
+ *   scope. Two other mount reads stay SEPARATE by the same boundary discipline used elsewhere (ledger / EE
+ *   / federation): public package DISCOVERY (`/v1/knowledge/discover`, cross-user best-effort) and the
+ *   per-organism shared-package list (`/v1/knowledge/organism/:id`, a heavy node-wide consent+manifest scan
+ *   — a future `listKnowledgeForOrgs` primitive, not a mount composite). Single-master: the Knowledge tab
+ *   mount only. The individual endpoints stay for interactive re-fetch (import/delete/federate).
+ *
+ * @structure KnowledgeTabService.overview(ownerGaii) → { packages, consents }
+ * @usage const ov = await createKnowledgeTabService(storage).overview(resolve(req));
+ * @version-history
+ *   v1.0.0 — 2026-07-16 — Phase 4: fold the Knowledge tab's owner packages + consents into one composite.
+ */
+import type { Storage } from '../../storage/interface.js';
+export interface KnowledgeOverview {
+    packages: Array<Record<string, unknown>>;
+    consents: Array<Record<string, unknown>>;
+}
+export declare class KnowledgeTabService {
+    private readonly storage;
+    constructor(storage: Storage);
+    /**
+     * The Knowledge tab's owner-scoped mount for one owner in a single read scope: the owner's knowledge
+     * packages (memory, `packages/` prefix tagged `knowledge-package`, values included — the tab renders each
+     * manifest) + the consent list (the tab extracts the `federation` consents on `packages/…/*` to mark
+     * which packages are shared). Both mirror GET /v1/memory and GET /v1/consent respectively.
+     */
+    overview(ownerGaii: string): Promise<KnowledgeOverview>;
+}
+/** Assemble the Knowledge tab composite over the given storage. */
+export declare function createKnowledgeTabService(storage: Storage): KnowledgeTabService;
+//# sourceMappingURL=knowledge-tab-db-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-tab-db-service.d.ts","sourceRoot":"","sources":["../../../../src/services/db/knowledge-tab-db-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAG1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1C;AAED,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAoBxD;AAED,mEAAmE;AACnE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAE/E"}

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

@@ -0,0 +1,37 @@
+import { runInReadScope } from '../../storage/uow/unit-of-work.js';
+export class KnowledgeTabService {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * The Knowledge tab's owner-scoped mount for one owner in a single read scope: the owner's knowledge
+     * packages (memory, `packages/` prefix tagged `knowledge-package`, values included — the tab renders each
+     * manifest) + the consent list (the tab extracts the `federation` consents on `packages/…/*` to mark
+     * which packages are shared). Both mirror GET /v1/memory and GET /v1/consent respectively.
+     */
+    overview(ownerGaii) {
+        return runInReadScope(async () => {
+            const [pkgRecords, consents] = await Promise.all([
+                this.storage.listMemory(ownerGaii, { prefix: 'packages/', tags: ['knowledge-package'] }),
+                this.storage.listConsents(ownerGaii),
+            ]);
+            return {
+                packages: pkgRecords.map(r => ({
+                    key: r.key, value: r.value, owner_gaii: r.ownerGaii, visibility: r.visibility,
+                    version: r.version, tags: r.tags, created_at: r.createdAt, updated_at: r.updatedAt,
+                })),
+                consents: 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,
+                })),
+            };
+        });
+    }
+}
+/** Assemble the Knowledge tab composite over the given storage. */
+export function createKnowledgeTabService(storage) {
+    return new KnowledgeTabService(storage);
+}
+//# sourceMappingURL=knowledge-tab-db-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-tab-db-service.js","sourceRoot":"","sources":["../../../../src/services/db/knowledge-tab-db-service.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAOnE,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEjD;;;;;OAKG;IACH,QAAQ,CAAC,SAAiB;QACxB,OAAO,cAAc,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBACxF,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC;aACrC,CAAC,CAAC;YAEH,OAAO;gBACL,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC7B,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU;oBAC7E,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC,SAAS;iBACnF,CAAC,CAAC;gBACH,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC3B,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO;oBACjF,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,SAAS;oBAC7E,UAAU,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ;iBAC9C,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/dist/src/services/db/living-docs-db-service.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @file src/services/db/living-docs-db-service.ts
+ * @description Purpose-built Application DB Service for the profile **Living Docs** tab — the ONE call
+ *   behind GET /v1/living-docs. The tab mounted three requests, TWO of which were identical full owner-memory
+ *   scans: listTemplates() and listInstances() each fetched GET /v1/memory and filtered client-side, plus
+ *   listOrganisms(member). This reads owner memory ONCE and partitions it server-side into templates
+ *   (`living.template.*`) and deployed instances (`organism.{org}.w.{ws}.living.{doc}.latest` records of
+ *   type `living-config`), returning only those (not the whole keyspace over the wire), alongside the
+ *   organism list. Single-master: the Living Docs tab mount only. The individual reads stay for interactive
+ *   re-fetch (save/deploy/delete).
+ *
+ * @structure LivingDocsService.overview(ownerName, ownerGhii) → { templates, instances, organisms }
+ * @usage const ov = await createLivingDocsService(storage).overview(ownerName, ownerGhii);
+ * @version-history
+ *   v1.0.0 — 2026-07-16 — Phase 4: fold the Living Docs tab's 2 duplicate memory scans + organisms into one.
+ */
+import type { Storage } from '../../storage/interface.js';
+export interface LivingDocsOverview {
+    templates: unknown[];
+    instances: Array<{
+        loc: {
+            orgId: string;
+            wsId: string;
+            docId: string;
+        };
+        config: unknown;
+        updatedAt: string;
+    }>;
+    organisms: unknown[];
+}
+export declare class LivingDocsService {
+    private readonly storage;
+    constructor(storage: Storage);
+    /**
+     * The Living Docs tab mount for one owner in a single read scope. Templates are sorted by title;
+     * instances (newest first) mirror the client's listInstances partition exactly. Organisms come from the
+     * owner's memberships (the deploy-target picker).
+     */
+    overview(ownerName: string, ownerGhii: string): Promise<LivingDocsOverview>;
+}
+/** Assemble the Living Docs composite over the given storage. */
+export declare function createLivingDocsService(storage: Storage): LivingDocsService;
+//# sourceMappingURL=living-docs-db-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"living-docs-db-service.d.ts","sourceRoot":"","sources":["../../../../src/services/db/living-docs-db-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAQ1D,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,SAAS,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9G,SAAS,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA0B5E;AAED,iEAAiE;AACjE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAE3E"}

package/dist/src/services/db/living-docs-db-service.js

@@ -0,0 +1,45 @@
+import { runInReadScope } from '../../storage/uow/unit-of-work.js';
+const TEMPLATE_PREFIX = 'living.template.';
+// A deployed living instance's config key: organism.{org}.w.{ws}.living.{docId}.latest (mirrors the
+// client's parseConfigKey in public/js/services/living.js).
+const CONFIG_KEY_RE = /^organism\.(.+?)\.w\.(.+?)\.living\.([^.]+)\.latest$/;
+export class LivingDocsService {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * The Living Docs tab mount for one owner in a single read scope. Templates are sorted by title;
+     * instances (newest first) mirror the client's listInstances partition exactly. Organisms come from the
+     * owner's memberships (the deploy-target picker).
+     */
+    overview(ownerName, ownerGhii) {
+        return runInReadScope(async () => {
+            const [records, organisms] = await Promise.all([
+                this.storage.listMemory(ownerGhii),
+                this.storage.listOrganisms({ member: ownerName }),
+            ]);
+            const templates = records
+                .filter(r => typeof r.key === 'string' && r.key.startsWith(TEMPLATE_PREFIX))
+                .map(r => r.value)
+                .filter(v => v && typeof v === 'object')
+                .sort((a, b) => String(a.title || '').localeCompare(String(b.title || '')));
+            const instances = [];
+            for (const r of records) {
+                if (typeof r.key !== 'string')
+                    continue;
+                const m = CONFIG_KEY_RE.exec(r.key);
+                if (m && r.value && r.value.type === 'living-config') {
+                    instances.push({ loc: { orgId: m[1], wsId: m[2], docId: m[3] }, config: r.value, updatedAt: r.updatedAt || r.createdAt });
+                }
+            }
+            instances.sort((a, b) => +new Date(b.updatedAt || 0) - +new Date(a.updatedAt || 0));
+            return { templates, instances, organisms };
+        });
+    }
+}
+/** Assemble the Living Docs composite over the given storage. */
+export function createLivingDocsService(storage) {
+    return new LivingDocsService(storage);
+}
+//# sourceMappingURL=living-docs-db-service.js.map

package/dist/src/services/db/living-docs-db-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"living-docs-db-service.js","sourceRoot":"","sources":["../../../../src/services/db/living-docs-db-service.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAC3C,oGAAoG;AACpG,4DAA4D;AAC5D,MAAM,aAAa,GAAG,sDAAsD,CAAC;AAQ7E,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEjD;;;;OAIG;IACH,QAAQ,CAAC,SAAiB,EAAE,SAAiB;QAC3C,OAAO,cAAc,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC7C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;gBAClC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;aAClD,CAAC,CAAC;YAEH,MAAM,SAAS,GAAG,OAAO;iBACtB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;iBAC3E,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;iBACjB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC;iBACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAE,CAAyB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAE,CAAyB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAEhI,MAAM,SAAS,GAAoC,EAAE,CAAC;YACtD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;oBAAE,SAAS;gBACxC,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAK,CAAC,CAAC,KAA4B,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;oBAC7E,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC5H,CAAC;YACH,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC;YAEpF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}