aimeat 1.40.0 → 2.0.0

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

@@ -0,0 +1,49 @@
+import { loadOwnerAgents, loadOwnerEcoApps, resolveOwnerIdentities } from './owner-identity.js';
+export class AgentDbService {
+    storage;
+    nodeId;
+    constructor(storage, nodeId) {
+        this.storage = storage;
+        this.nodeId = nodeId;
+    }
+    /** The owner's agents — the single source (IdentityMap-shared inside a UoW). */
+    listOwnerAgents(owner) {
+        return loadOwnerAgents(this.storage, owner);
+    }
+    /** The owner's ecosystem apps (IdentityMap-shared inside a UoW). */
+    listOwnerEcoApps(owner) {
+        return loadOwnerEcoApps(this.storage, owner);
+    }
+    /** The canonical owner-scope identity list (GHII → agent GAIIs → eco GEAIs). */
+    resolveOwnerIdentities(owner) {
+        return resolveOwnerIdentities(this.storage, this.nodeId, owner);
+    }
+    /**
+     * The owner's agents split for the Home dashboard: stats (total / chat-sessions / active-today) plus
+     * the real (non-session) agents ordered most-recently-seen first — everything derived from ONE agents
+     * read, so an owner with many agents is one query, not a per-agent fan-out.
+     */
+    async ownerAgentOverview(owner) {
+        const all = await this.listOwnerAgents(owner);
+        const isSession = (a) => String(a.name || '').startsWith('session-');
+        const real = all.filter(a => !isSession(a))
+            .sort((a, b) => String(b.lastSeen || '').localeCompare(String(a.lastSeen || '')));
+        const today = new Date().toDateString();
+        const seenToday = (a) => !!a.lastSeen && new Date(a.lastSeen).toDateString() === today;
+        return {
+            stats: {
+                total: all.length,
+                chatSessions: all.filter(isSession).length,
+                activeToday: real.filter(seenToday).length,
+            },
+            agents: real.map(a => ({
+                gaii: a.gaii, name: a.name, display_name: a.displayName || a.name, last_seen: a.lastSeen ?? null,
+            })),
+        };
+    }
+}
+/** Assemble the agent Application-DB-Service over the given storage. */
+export function createAgentDbService(storage, config) {
+    return new AgentDbService(storage, config.nodeId);
+}
+//# sourceMappingURL=agent-db-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-db-service.js","sourceRoot":"","sources":["../../../../src/services/db/agent-db-service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAqBhG,MAAM,OAAO,cAAc;IACI;IAAmC;IAAhE,YAA6B,OAAgB,EAAmB,MAAc;QAAjD,YAAO,GAAP,OAAO,CAAS;QAAmB,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAElF,gFAAgF;IAChF,eAAe,CAAC,KAAa;QAC3B,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,oEAAoE;IACpE,gBAAgB,CAAC,KAAa;QAC5B,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,gFAAgF;IAChF,sBAAsB,CAAC,KAAa;QAClC,OAAO,sBAAsB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,kBAAkB,CAAC,KAAa;QACpC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,CAAC,CAAc,EAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC3F,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;aACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACpF,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,CAAC,CAAc,EAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,YAAY,EAAE,KAAK,KAAK,CAAC;QAC7G,OAAO;YACL,KAAK,EAAE;gBACL,KAAK,EAAE,GAAG,CAAC,MAAM;gBACjB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM;gBAC1C,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM;aAC3C;YACD,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACrB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;aACjG,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,MAA0B;IAC/E,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AACpD,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * @file src/services/db/agent-integration-overview-db-service.ts
+ * @description Purpose-built Application DB Service for the agent-card **Integration** subtab — the ONE call
+ *   behind GET /v1/agents/:name/integration/overview. The subtab mounted a 4-request fan-out
+ *   (getWebhookConfig, getSkillBundleVersion, getDeliveryLog, getOnboarding). This folds the THREE plain
+ *   reads — webhook config (from the already-loaded agent), the webhook delivery log, and the
+ *   post-onboarding checklist — into one read scope. The fourth, skill-bundle/version, STAYS a separate
+ *   request: it runs a bundle-generation PIPELINE (buildContext + generateBundle), a distinct subsystem,
+ *   not a storage read (same discipline as keeping the ledger / EE / federation calls out of a local
+ *   composite) → the mount goes 4→2, not 4→1. Each sub-object mirrors the exact `.data` of the endpoint it
+ *   replaces so the subtab seeds it as a drop-in. Single-master: the Integration subtab mount only.
+ *
+ * @structure AgentIntegrationOverviewService.overview(agentGaii, agent, agentName, opts?) → { webhook, deliveries, onboarding }
+ * @usage const ov = await createAgentIntegrationOverviewService(storage).overview(agentGaii, agent, agentName);
+ * @version-history
+ *   v1.0.0 — 2026-07-16 — Phase 4: fold the Integration subtab's 3 plain reads into one composite.
+ */
+import type { Storage } from '../../storage/interface.js';
+import type { AgentRecord } from '../../storage/types/identity.js';
+export interface AgentIntegrationOverview {
+    webhook: Record<string, unknown>;
+    deliveries: {
+        deliveries: unknown[];
+    };
+    onboarding: {
+        post_onboarding_checklist: Record<string, unknown> | null;
+    };
+}
+export declare class AgentIntegrationOverviewService {
+    private readonly storage;
+    constructor(storage: Storage);
+    /**
+     * The Integration subtab mount for one already-resolved agent, in a single read scope. Webhook config
+     * comes from the passed-in agent record (no re-read); the delivery log and the post-onboarding checklist
+     * are read here. The checklist is computed only when an onboarding record exists — mirroring GET
+     * /onboarding, which returns no checklist for a not-started agent.
+     */
+    overview(agentGaii: string, agent: AgentRecord, agentName: string, opts?: {
+        deliveryLimit?: number;
+    }): Promise<AgentIntegrationOverview>;
+}
+/** Assemble the Integration subtab composite over the given storage. */
+export declare function createAgentIntegrationOverviewService(storage: Storage): AgentIntegrationOverviewService;
+//# sourceMappingURL=agent-integration-overview-db-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-integration-overview-db-service.d.ts","sourceRoot":"","sources":["../../../../src/services/db/agent-integration-overview-db-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAInE,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE;QAAE,UAAU,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IACtC,UAAU,EAAE;QAAE,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;CAC3E;AAED,qBAAa,+BAA+B;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C;;;;;OAKG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO,GACpC,OAAO,CAAC,wBAAwB,CAAC;CA6BrC;AAED,wEAAwE;AACxE,wBAAgB,qCAAqC,CAAC,OAAO,EAAE,OAAO,GAAG,+BAA+B,CAEvG"}

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

@@ -0,0 +1,44 @@
+import { runInReadScope } from '../../storage/uow/unit-of-work.js';
+import { buildPostOnboardingChecklist } from '../../routes/agent-onboarding.js';
+export class AgentIntegrationOverviewService {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * The Integration subtab mount for one already-resolved agent, in a single read scope. Webhook config
+     * comes from the passed-in agent record (no re-read); the delivery log and the post-onboarding checklist
+     * are read here. The checklist is computed only when an onboarding record exists — mirroring GET
+     * /onboarding, which returns no checklist for a not-started agent.
+     */
+    overview(agentGaii, agent, agentName, opts = {}) {
+        const deliveryLimit = Math.min(100, Math.max(1, opts.deliveryLimit ?? 10));
+        return runInReadScope(async () => {
+            const [deliveries, onboarding] = await Promise.all([
+                this.storage.listDeliveryLog(agentGaii, deliveryLimit),
+                this.storage.getOnboarding(agentGaii),
+            ]);
+            const post_onboarding_checklist = onboarding
+                ? await buildPostOnboardingChecklist(agentGaii, agentName, this.storage)
+                : null;
+            // Webhook — mirrors GET /webhook .data EXACTLY, from the already-loaded agent.
+            const webhook = agent.webhookUrl
+                ? {
+                    configured: true, url: agent.webhookUrl, enabled: agent.webhookEnabled ?? false,
+                    last_success: agent.webhookLastSuccess ?? null, last_failure: agent.webhookLastFailure ?? null,
+                    fail_count: agent.webhookFailCount ?? 0,
+                }
+                : { configured: false };
+            return {
+                webhook,
+                deliveries: { deliveries },
+                onboarding: { post_onboarding_checklist },
+            };
+        });
+    }
+}
+/** Assemble the Integration subtab composite over the given storage. */
+export function createAgentIntegrationOverviewService(storage) {
+    return new AgentIntegrationOverviewService(storage);
+}
+//# sourceMappingURL=agent-integration-overview-db-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-integration-overview-db-service.js","sourceRoot":"","sources":["../../../../src/services/db/agent-integration-overview-db-service.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAQhF,MAAM,OAAO,+BAA+B;IACb;IAA7B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEjD;;;;;OAKG;IACH,QAAQ,CACN,SAAiB,EACjB,KAAkB,EAClB,SAAiB,EACjB,OAAmC,EAAE;QAErC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;QAE3E,OAAO,cAAc,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACjD,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC;gBACtD,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC;aACtC,CAAC,CAAC;YAEH,MAAM,yBAAyB,GAAG,UAAU;gBAC1C,CAAC,CAAC,MAAM,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC;gBACxE,CAAC,CAAC,IAAI,CAAC;YAET,+EAA+E;YAC/E,MAAM,OAAO,GAA4B,KAAK,CAAC,UAAU;gBACvD,CAAC,CAAC;oBACE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK;oBAC/E,YAAY,EAAE,KAAK,CAAC,kBAAkB,IAAI,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,kBAAkB,IAAI,IAAI;oBAC9F,UAAU,EAAE,KAAK,CAAC,gBAAgB,IAAI,CAAC;iBACxC;gBACH,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;YAE1B,OAAO;gBACL,OAAO;gBACP,UAAU,EAAE,EAAE,UAAU,EAAE;gBAC1B,UAAU,EAAE,EAAE,yBAAyB,EAAE;aAC1C,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,UAAU,qCAAqC,CAAC,OAAgB;IACpE,OAAO,IAAI,+BAA+B,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC"}

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

@@ -0,0 +1,40 @@
+/**
+ * @file src/services/db/agent-messages-overview-db-service.ts
+ * @description Purpose-built Application DB Service for the agent-card **Messages** subtab — the ONE call
+ *   behind GET /v1/agents/:name/messages/overview. The subtab mounted three requests: the agent's command
+ *   palette (a memory read), the thread list (with per-thread task-title enrichment), and the message
+ *   history (page 1). This composes all three in one read scope. Single-master: the Messages subtab mount
+ *   only. The individual endpoints stay for interactive re-fetch (thread switch, send, live-update).
+ *
+ * @structure AgentMessagesOverviewService.overview(agentGaii, agentName, opts?) → { commands, threads, messages }
+ * @usage const ov = await createAgentMessagesOverviewService(storage).overview(agentGaii, agentName);
+ * @version-history
+ *   v1.0.0 — 2026-07-16 — Phase 4: fold the Messages subtab's commands + threads + messages reads into one.
+ */
+import type { Storage } from '../../storage/interface.js';
+export interface AgentMessagesOverview {
+    commands: unknown;
+    threads: Array<Record<string, unknown>>;
+    messages: {
+        messages: unknown[];
+        total: number;
+        page: number;
+        per_page: number;
+    };
+}
+export declare class AgentMessagesOverviewService {
+    private readonly storage;
+    constructor(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: string, agentName: string, opts?: {
+        perPage?: number;
+    }): Promise<AgentMessagesOverview>;
+}
+/** Assemble the Messages subtab composite over the given storage. */
+export declare function createAgentMessagesOverviewService(storage: Storage): AgentMessagesOverviewService;
+//# sourceMappingURL=agent-messages-overview-db-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-messages-overview-db-service.d.ts","sourceRoot":"","sources":["../../../../src/services/db/agent-messages-overview-db-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAG1D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxC,QAAQ,EAAE;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAClF;AAED,qBAAa,4BAA4B;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA+BhH;AAED,qEAAqE;AACrE,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,OAAO,GAAG,4BAA4B,CAEjG"}

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":"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"}

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":"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"}