aimeat 1.40.1 → 2.1.0

package/dist/src/services/db/agent-messages-overview-db-service.js

@@ -0,0 +1,47 @@
+import { runInReadScope } from '../../storage/uow/unit-of-work.js';
+export class AgentMessagesOverviewService {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * The Messages subtab mount for one agent in a single read scope. Threads are enriched with their linked
+     * task's title (task-based threads use the task id as threadId), mirroring GET /messages/threads exactly;
+     * the message page mirrors GET /messages (page 1). Commands come from the agent-authored
+     * `agents.{name}.commands` memory key (its own GAII namespace).
+     */
+    overview(agentGaii, agentName, opts = {}) {
+        const perPage = Math.min(100, Math.max(1, opts.perPage ?? 20));
+        return runInReadScope(async () => {
+            const [commandsRec, threads, msgResult] = await Promise.all([
+                this.storage.getMemory(agentGaii, `agents.${agentName}.commands`),
+                this.storage.listThreads(agentGaii),
+                this.storage.listMessages(agentGaii, { page: 1, perPage }),
+            ]);
+            // Enrich threads with the linked task title (cache so several threads on the same task hit once).
+            const taskCache = new Map();
+            const resolveTaskTitle = async (threadId) => {
+                if (taskCache.has(threadId))
+                    return taskCache.get(threadId) ?? null;
+                const task = await this.storage.getAgentTask(threadId).catch(() => null);
+                const title = task?.title ?? null;
+                taskCache.set(threadId, title);
+                return title;
+            };
+            const enriched = await Promise.all(threads.map(async (thread) => {
+                const title = await resolveTaskTitle(thread.threadId);
+                return { ...thread, title, linkedTaskId: title !== null ? thread.threadId : null };
+            }));
+            return {
+                commands: commandsRec?.value ?? [],
+                threads: enriched,
+                messages: { messages: msgResult.messages, total: msgResult.total, page: 1, per_page: perPage },
+            };
+        });
+    }
+}
+/** Assemble the Messages subtab composite over the given storage. */
+export function createAgentMessagesOverviewService(storage) {
+    return new AgentMessagesOverviewService(storage);
+}
+//# sourceMappingURL=agent-messages-overview-db-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-messages-overview-db-service.js","sourceRoot":"","sources":["../../../../src/services/db/agent-messages-overview-db-service.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAQnE,MAAM,OAAO,4BAA4B;IACV;IAA7B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEjD;;;;;OAKG;IACH,QAAQ,CAAC,SAAiB,EAAE,SAAiB,EAAE,OAA6B,EAAE;QAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAE/D,OAAO,cAAc,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC1D,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,SAAS,WAAW,CAAC;gBACjE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC;gBACnC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;aAC3D,CAAC,CAAC;YAEH,kGAAkG;YAClG,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;YACnD,MAAM,gBAAgB,GAAG,KAAK,EAAE,QAAgB,EAA0B,EAAE;gBAC1E,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAAE,OAAO,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;gBACpE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;gBACzE,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC;gBAClC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC/B,OAAO,KAAK,CAAC;YACf,CAAC,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;gBAC9D,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACtD,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACrF,CAAC,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACL,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE;gBAClC,OAAO,EAAE,QAAQ;gBACjB,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE;aAC/F,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,UAAU,kCAAkC,CAAC,OAAgB;IACjE,OAAO,IAAI,4BAA4B,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC"}

package/dist/src/services/db/agent-quality-overview-db-service.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @file src/services/db/agent-quality-overview-db-service.ts
+ * @description Purpose-built Application DB Service for the agent-card **Quality** subtab — the ONE call
+ *   behind GET /v1/agents/:name/quality/overview. The subtab mounted a 2-request fan-out: getAgentStatistics
+ *   (recompute performance + per-context review rollups from tasks, cache them, read custom metrics) and
+ *   listTasks(status=done). This folds both into one call. NB this composite performs the SAME recompute +
+ *   cache write the /statistics endpoint does — it is a request fold, not a pure read scope. Single-master:
+ *   the Quality subtab mount only. The individual endpoints stay for interactive re-fetch (post-rate,
+ *   live-update).
+ *
+ * @structure AgentQualityOverviewService.overview(agentGaii, agentName, nodeId, opts?) → { statistics, done_tasks }
+ * @usage const ov = await createAgentQualityOverviewService(storage).overview(agentGaii, agentName, nodeId);
+ * @version-history
+ *   v1.0.0 — 2026-07-16 — Phase 4: fold the Quality subtab's statistics + done-tasks reads into one composite.
+ */
+import type { Storage } from '../../storage/interface.js';
+export interface AgentQualityOverview {
+    statistics: {
+        performance: unknown;
+        reviews: unknown;
+        custom: Array<{
+            key: string;
+            value: unknown;
+            updated_at: string;
+        }>;
+    };
+    done_tasks: unknown[];
+}
+export declare class AgentQualityOverviewService {
+    private readonly storage;
+    constructor(storage: Storage);
+    /**
+     * The Quality subtab mount for one agent: the recomputed statistics (performance + reviews + the agent's
+     * custom metrics) and the agent's done tasks, mirroring GET /statistics + GET /tasks?status=done. The
+     * statistics recompute + cache write is identical to the /statistics endpoint's.
+     */
+    overview(agentGaii: string, agentName: string, nodeId: string, opts?: {
+        doneLimit?: number;
+    }): Promise<AgentQualityOverview>;
+}
+/** Assemble the Quality subtab composite over the given storage. */
+export declare function createAgentQualityOverviewService(storage: Storage): AgentQualityOverviewService;
+//# sourceMappingURL=agent-quality-overview-db-service.d.ts.map

package/dist/src/services/db/agent-quality-overview-db-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-quality-overview-db-service.d.ts","sourceRoot":"","sources":["../../../../src/services/db/agent-quality-overview-db-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAG1D,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE;QACV,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACpE,CAAC;IACF,UAAU,EAAE,OAAO,EAAE,CAAC;CACvB;AAED,qBAAa,2BAA2B;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C;;;;OAIG;IACG,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAChC,OAAO,CAAC,oBAAoB,CAAC;CAoBjC;AAED,oEAAoE;AACpE,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,2BAA2B,CAE/F"}

package/dist/src/services/db/agent-quality-overview-db-service.js

@@ -0,0 +1,34 @@
+import { recomputeAndCacheStatistics } from '../agent-statistics.js';
+export class AgentQualityOverviewService {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * The Quality subtab mount for one agent: the recomputed statistics (performance + reviews + the agent's
+     * custom metrics) and the agent's done tasks, mirroring GET /statistics + GET /tasks?status=done. The
+     * statistics recompute + cache write is identical to the /statistics endpoint's.
+     */
+    async overview(agentGaii, agentName, nodeId, opts = {}) {
+        const doneLimit = Math.min(200, Math.max(1, opts.doneLimit ?? 100));
+        const customPrefix = `agents.${agentName}.statistics.custom.`;
+        const [stats, doneTasks, customRecords] = await Promise.all([
+            recomputeAndCacheStatistics(this.storage, agentGaii, nodeId),
+            this.storage.listAgentTasks(agentGaii, { status: 'done', page: 1, perPage: doneLimit }),
+            // Agent-authored custom metrics live under the AGENT's GAII namespace (optional).
+            this.storage.listMemory(agentGaii, { prefix: customPrefix }).catch(() => []),
+        ]);
+        const custom = (customRecords ?? []).map(r => ({
+            key: r.key.slice(customPrefix.length), value: r.value, updated_at: r.updatedAt,
+        }));
+        return {
+            statistics: { performance: stats.performance, reviews: stats.reviews, custom },
+            done_tasks: doneTasks.tasks,
+        };
+    }
+}
+/** Assemble the Quality subtab composite over the given storage. */
+export function createAgentQualityOverviewService(storage) {
+    return new AgentQualityOverviewService(storage);
+}
+//# sourceMappingURL=agent-quality-overview-db-service.js.map

package/dist/src/services/db/agent-quality-overview-db-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-quality-overview-db-service.js","sourceRoot":"","sources":["../../../../src/services/db/agent-quality-overview-db-service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAWrE,MAAM,OAAO,2BAA2B;IACT;IAA7B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEjD;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CACZ,SAAiB,EACjB,SAAiB,EACjB,MAAc,EACd,OAA+B,EAAE;QAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC;QACpE,MAAM,YAAY,GAAG,UAAU,SAAS,qBAAqB,CAAC;QAE9D,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC1D,2BAA2B,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;YAC5D,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;YACvF,kFAAkF;YAClF,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;SAC7E,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7C,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,SAAS;SAC/E,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,UAAU,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE;YAC9E,UAAU,EAAE,SAAS,CAAC,KAAK;SAC5B,CAAC;IACJ,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,UAAU,iCAAiC,CAAC,OAAgB;IAChE,OAAO,IAAI,2BAA2B,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC"}

package/dist/src/services/db/calibrator-detail-db-service.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @file src/services/db/calibrator-detail-db-service.ts
+ * @description Purpose-built Application DB Service for the profile Calibrator "project detail" view — the
+ *   ONE read behind GET /v1/calibrator/:id/detail. Opening a project fired a 4-request waterfall:
+ *   getProject (project + dimensions), listVersions, getVersion(current), and listBatches — each awaited
+ *   before the next, and every one a separate memory scan under the SAME `calibrator.{id}.` prefix. This
+ *   composes all of it from a SINGLE prefix scan for the owner, partitioning the records client-side by key
+ *   sub-prefix (project / dimensions / version.* / batch.*). Single-master: the Calibrator detail mount
+ *   only. The individual endpoints stay for interactive re-fetches (post-version-create, live-update batch
+ *   reload) and for the template-backfill write, which lives in the route where the default templates do.
+ *
+ * @structure CalibratorDetailService.overview(gaii, projectId) → { project, dimensions, versions, currentVersion, batches } | null
+ * @usage const detail = await createCalibratorDetailService(storage).overview(gaii, id);
+ * @version-history
+ *   v1.0.0 — 2026-07-16 — Phase 4: fold the Calibrator detail mount's 4-read waterfall into one prefix scan.
+ */
+import type { Storage } from '../../storage/interface.js';
+export interface CalibratorDetail {
+    project: Record<string, unknown>;
+    dimensions: unknown;
+    versions: Array<{
+        version: unknown;
+        changelog: unknown;
+        createdAt: unknown;
+    }>;
+    currentVersion: unknown;
+    batches: Array<Record<string, unknown>>;
+}
+export declare class CalibratorDetailService {
+    private readonly storage;
+    constructor(storage: Storage);
+    /**
+     * The Calibrator project-detail mount for one owner in a single read scope. Returns null when the project
+     * key is absent (the route maps that to 404). The `project` value is returned as stored — the route
+     * applies the lazy template backfill (it owns the default-template constants).
+     */
+    overview(gaii: string, projectId: string): Promise<CalibratorDetail | null>;
+}
+/** Assemble the Calibrator detail composite over the given storage. */
+export declare function createCalibratorDetailService(storage: Storage): CalibratorDetailService;
+//# sourceMappingURL=calibrator-detail-db-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calibrator-detail-db-service.d.ts","sourceRoot":"","sources":["../../../../src/services/db/calibrator-detail-db-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAU1D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9E,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzC;AAED,qBAAa,uBAAuB;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CAiD5E;AAED,uEAAuE;AACvE,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,CAEvF"}

package/dist/src/services/db/calibrator-detail-db-service.js

@@ -0,0 +1,61 @@
+import { runInReadScope } from '../../storage/uow/unit-of-work.js';
+export class CalibratorDetailService {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * The Calibrator project-detail mount for one owner in a single read scope. Returns null when the project
+     * key is absent (the route maps that to 404). The `project` value is returned as stored — the route
+     * applies the lazy template backfill (it owns the default-template constants).
+     */
+    overview(gaii, projectId) {
+        return runInReadScope(async () => {
+            const prefix = `calibrator.${projectId}.`;
+            const all = await this.storage.listMemory(gaii, { prefix });
+            const projectRec = all.find(m => m.key === `${prefix}project`);
+            if (!projectRec)
+                return null;
+            const project = projectRec.value;
+            const dimensions = all.find(m => m.key === `${prefix}dimensions`)?.value ?? [];
+            const versionPrefix = `${prefix}version.`;
+            const versionRecs = all.filter(m => m.key.startsWith(versionPrefix));
+            const versions = versionRecs
+                .map(m => {
+                const v = m.value;
+                return { version: v.version, changelog: v.changelog, createdAt: v.createdAt };
+            })
+                .sort((a, b) => a.version - b.version);
+            const cur = project.currentVersion || 0;
+            const currentVersion = cur > 0
+                ? (versionRecs.find(m => m.key === `${versionPrefix}${cur}`)?.value ?? null)
+                : null;
+            const batchPrefix = `${prefix}batch.`;
+            const batches = all
+                .filter(m => m.key.startsWith(batchPrefix))
+                .map(m => {
+                const b = m.value;
+                const models = b.models || [];
+                return {
+                    batchId: b.batchId,
+                    createdAt: b.createdAt,
+                    promptVersion: b.promptVersion,
+                    status: b.status,
+                    modelCount: models.length,
+                    scores: models.map(model => ({
+                        modelId: model.modelId,
+                        modelLabel: model.modelLabel,
+                        overallScore: model.step2_analysis?.overallScore ?? null,
+                    })),
+                };
+            })
+                .sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+            return { project, dimensions, versions, currentVersion, batches };
+        });
+    }
+}
+/** Assemble the Calibrator detail composite over the given storage. */
+export function createCalibratorDetailService(storage) {
+    return new CalibratorDetailService(storage);
+}
+//# sourceMappingURL=calibrator-detail-db-service.js.map

package/dist/src/services/db/calibrator-detail-db-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calibrator-detail-db-service.js","sourceRoot":"","sources":["../../../../src/services/db/calibrator-detail-db-service.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAiBnE,MAAM,OAAO,uBAAuB;IACL;IAA7B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEjD;;;;OAIG;IACH,QAAQ,CAAC,IAAY,EAAE,SAAiB;QACtC,OAAO,cAAc,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,MAAM,GAAG,cAAc,SAAS,GAAG,CAAC;YAC1C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAE5D,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,MAAM,SAAS,CAAC,CAAC;YAC/D,IAAI,CAAC,UAAU;gBAAE,OAAO,IAAI,CAAC;YAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,KAAgC,CAAC;YAE5D,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,MAAM,YAAY,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;YAE/E,MAAM,aAAa,GAAG,GAAG,MAAM,UAAU,CAAC;YAC1C,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;YACrE,MAAM,QAAQ,GAAG,WAAW;iBACzB,GAAG,CAAC,CAAC,CAAC,EAAE;gBACP,MAAM,CAAC,GAAG,CAAC,CAAC,KAAgC,CAAC;gBAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;YAChF,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAC,CAAC,OAAkB,GAAI,CAAC,CAAC,OAAkB,CAAC,CAAC;YAEjE,MAAM,GAAG,GAAI,OAAO,CAAC,cAAyB,IAAI,CAAC,CAAC;YACpD,MAAM,cAAc,GAAG,GAAG,GAAG,CAAC;gBAC5B,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,aAAa,GAAG,GAAG,EAAE,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;gBAC5E,CAAC,CAAC,IAAI,CAAC;YAET,MAAM,WAAW,GAAG,GAAG,MAAM,QAAQ,CAAC;YACtC,MAAM,OAAO,GAAG,GAAG;iBAChB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;iBAC1C,GAAG,CAAC,CAAC,CAAC,EAAE;gBACP,MAAM,CAAC,GAAG,CAAC,CAAC,KAAgC,CAAC;gBAC7C,MAAM,MAAM,GAAI,CAAC,CAAC,MAAuB,IAAI,EAAE,CAAC;gBAChD,OAAO;oBACL,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,aAAa,EAAE,CAAC,CAAC,aAAa;oBAC9B,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,UAAU,EAAE,MAAM,CAAC,MAAM;oBACzB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;wBAC3B,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;wBAC5B,YAAY,EAAE,KAAK,CAAC,cAAc,EAAE,YAAY,IAAI,IAAI;qBACzD,CAAC,CAAC;iBACJ,CAAC;YACJ,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAmB,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAmB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAEzG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;QACpE,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,UAAU,6BAA6B,CAAC,OAAgB;IAC5D,OAAO,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC"}

package/dist/src/services/db/data-wallet-db-service.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file src/services/db/data-wallet-db-service.ts
+ * @description Purpose-built Application DB Service for the profile **Data Wallet** tab — the ONE call
+ *   behind GET /v1/data-wallet. The tab mounted three requests: GET /v1/consent (consents), GET
+ *   /v1/consent/audit (audit log + not-yet-flushed buffer), and GET /v1/permissions/summary (which
+ *   independently re-read the active consents + counted memory keys + storage files). This composes all
+ *   three in one read scope, reading the consent list ONCE (the summary derives the active subset from it
+ *   in memory) and counting memory via metadata only (no values loaded). Single-master: the Data Wallet
+ *   mount only. The individual endpoints stay for interactive re-fetch (grant/revoke, audit day-range).
+ *
+ * @structure DataWalletService.overview(ownerGaii, auditDays?) → { consents, audit, permSummary }
+ * @usage const ov = await createDataWalletService(storage).overview(resolve(req), 30);
+ * @version-history
+ *   v1.0.0 — 2026-07-16 — Phase 4: fold the Data Wallet tab's 3 reads into one composite (memory = meta-only).
+ */
+import type { Storage } from '../../storage/interface.js';
+export interface DataWalletOverview {
+    consents: {
+        consents: Array<Record<string, unknown>>;
+        total: number;
+    };
+    audit: {
+        entries: Array<Record<string, unknown>>;
+        total: number;
+        period_days: number;
+    };
+    permSummary: {
+        total_memory_keys: number;
+        total_storage_files: number;
+        active_consents: number;
+        rules_by_recipient_type: Record<string, number>;
+        data_patterns: unknown[];
+    };
+}
+export declare class DataWalletService {
+    private readonly storage;
+    constructor(storage: Storage);
+    /**
+     * The Data Wallet mount for one owner in a single read scope. Mirrors the three folded endpoints' `.data`
+     * exactly. The audit merges the pending (not-yet-flushed) buffer ahead of persisted rows, same as GET
+     * /v1/consent/audit. The permission summary is derived from the SAME consent list (active subset) plus
+     * memory-key and storage-file counts.
+     */
+    overview(ownerGaii: string, auditDays?: number): Promise<DataWalletOverview>;
+}
+/** Assemble the Data Wallet composite over the given storage. */
+export declare function createDataWalletService(storage: Storage): DataWalletService;
+//# sourceMappingURL=data-wallet-db-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-wallet-db-service.d.ts","sourceRoot":"","sources":["../../../../src/services/db/data-wallet-db-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAI1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,KAAK,EAAE;QAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACvF,WAAW,EAAE;QACX,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;QACxB,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChD,aAAa,EAAE,OAAO,EAAE,CAAC;KAC1B,CAAC;CACH;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAoDzE;AAED,iEAAiE;AACjE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAE3E"}

package/dist/src/services/db/data-wallet-db-service.js

@@ -0,0 +1,74 @@
+import { runInReadScope } from '../../storage/uow/unit-of-work.js';
+import { getPendingConsentAudit } from '../consent-audit-buffer.js';
+export class DataWalletService {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * The Data Wallet mount for one owner in a single read scope. Mirrors the three folded endpoints' `.data`
+     * exactly. The audit merges the pending (not-yet-flushed) buffer ahead of persisted rows, same as GET
+     * /v1/consent/audit. The permission summary is derived from the SAME consent list (active subset) plus
+     * memory-key and storage-file counts.
+     */
+    overview(ownerGaii, auditDays = 30) {
+        return runInReadScope(async () => {
+            const [consents, storedAudit, memoryMeta, storageFiles] = await Promise.all([
+                this.storage.listConsents(ownerGaii),
+                this.storage.listConsentAudit(ownerGaii, { days: auditDays }),
+                this.storage.listMemoryMeta(ownerGaii, {}),
+                this.storage.listStorageFiles(ownerGaii),
+            ]);
+            const pending = getPendingConsentAudit(ownerGaii, { days: auditDays })
+                .sort((a, b) => (a.timestamp < b.timestamp ? 1 : a.timestamp > b.timestamp ? -1 : 0));
+            const auditEntries = [...pending, ...storedAudit];
+            // Permission summary — derived from the active subset of the SAME consent list (no re-read).
+            const active = consents.filter(c => c.status === 'active');
+            const byType = { wildcard: 0, gaii: 0, ghii: 0, organism: 0, domain: 0, node: 0 };
+            for (const c of active) {
+                if (c.recipient === '*')
+                    byType.wildcard++;
+                else if (c.recipient.startsWith('ghii:'))
+                    byType.ghii++;
+                else if (c.recipient.startsWith('organism.'))
+                    byType.organism++;
+                else if (c.recipient.startsWith('domain:'))
+                    byType.domain++;
+                else if (c.recipient.startsWith('node:'))
+                    byType.node++;
+                else
+                    byType.gaii++;
+            }
+            return {
+                consents: {
+                    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,
+                    })),
+                    total: consents.length,
+                },
+                audit: {
+                    entries: auditEntries.map(e => ({
+                        id: e.id, consent_id: e.consentId, accessor_gaii: e.accessorGaii, memory_key: e.memoryKey,
+                        action: e.action, timestamp: e.timestamp, allowed: e.allowed,
+                    })),
+                    total: auditEntries.length,
+                    period_days: auditDays,
+                },
+                permSummary: {
+                    total_memory_keys: memoryMeta.length,
+                    total_storage_files: storageFiles.length,
+                    active_consents: active.length,
+                    rules_by_recipient_type: byType,
+                    data_patterns: [...new Set(active.map(c => c.dataPattern))],
+                },
+            };
+        });
+    }
+}
+/** Assemble the Data Wallet composite over the given storage. */
+export function createDataWalletService(storage) {
+    return new DataWalletService(storage);
+}
+//# sourceMappingURL=data-wallet-db-service.js.map

package/dist/src/services/db/data-wallet-db-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-wallet-db-service.js","sourceRoot":"","sources":["../../../../src/services/db/data-wallet-db-service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAcpE,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEjD;;;;;OAKG;IACH,QAAQ,CAAC,SAAiB,EAAE,SAAS,GAAG,EAAE;QACxC,OAAO,cAAc,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC1E,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC;gBACpC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;gBAC7D,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC;gBAC1C,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC;aACzC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,sBAAsB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;iBACnE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxF,MAAM,YAAY,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,WAAW,CAAC,CAAC;YAElD,6FAA6F;YAC7F,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;YAC3D,MAAM,MAAM,GAA2B,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC1G,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,IAAI,CAAC,CAAC,SAAS,KAAK,GAAG;oBAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;qBACtC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC;oBAAE,MAAM,CAAC,IAAI,EAAE,CAAC;qBACnD,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC;oBAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;qBAC3D,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC;oBAAE,MAAM,CAAC,MAAM,EAAE,CAAC;qBACvD,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC;oBAAE,MAAM,CAAC,IAAI,EAAE,CAAC;;oBACnD,MAAM,CAAC,IAAI,EAAE,CAAC;YACrB,CAAC;YAED,OAAO;gBACL,QAAQ,EAAE;oBACR,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;wBAC3B,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO;wBACjF,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,SAAS;wBAC7E,UAAU,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ;qBAC9C,CAAC,CAAC;oBACH,KAAK,EAAE,QAAQ,CAAC,MAAM;iBACvB;gBACD,KAAK,EAAE;oBACL,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;wBAC9B,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC,SAAS;wBACzF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO;qBAC7D,CAAC,CAAC;oBACH,KAAK,EAAE,YAAY,CAAC,MAAM;oBAC1B,WAAW,EAAE,SAAS;iBACvB;gBACD,WAAW,EAAE;oBACX,iBAAiB,EAAE,UAAU,CAAC,MAAM;oBACpC,mBAAmB,EAAE,YAAY,CAAC,MAAM;oBACxC,eAAe,EAAE,MAAM,CAAC,MAAM;oBAC9B,uBAAuB,EAAE,MAAM;oBAC/B,aAAa,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;iBAC5D;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}

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