@talkpilot/core-db 1.3.88 → 1.3.89

package/README.md

@@ -37,6 +37,7 @@ L1:# @talkpilot/core-db
 - **TalkPilot domain** – Imports like `findAgents`, `getFlows`, `findCalls`, and `vectorSearchCalls` live in `src/talkpilot`. These functions are the canonical access pattern for call history, session metadata, and provider configs.
 - **Municipal domain** – Helpers such as `findStreets`, `getMunicipalCities`, `findDepartmentSubjects`, and `createTicket` live under `src/municipal` and feed MIS workflows (street hints, subject matching, Ash Bina tickets).
 - **Configuration domain** – `getPromptByName`, `findPrompts`, `getAllPrompts`, and `getPromptsByProduct` live under `src/configuration` and back MIS's `moked_106` prompt lookups (defaults, overridable per-client via `clientConfig.toolsPrompts`).
+- **Websitalk domain** (`scans`, `websiteUrls`) – ⚠️ **Not included in `clientExistsInAnyCollection`/`deleteClientDataAcrossDomains`.** Those collections hold the client's URLs, which an external website-talk API uses as a lookup key to clean up its own Mongo collections *and* other, non-Mongo data stores tied to the client. Deleting a client fully requires calling that external API separately — see the warning on `deleteClientDataAcrossDomains` in `src/talkpilot/clients/clients.lifecycle.ts`.
 
 ## Environment variables
 
@@ -178,17 +179,18 @@ Refer to `DEVELOPMENT.md` for the full walkthrough, token instructions, and fact
 | 1.3.47  | Added optional `accountOwnerEmail` field to `WebsiteTalkProduct` (CP-1715): the recipient for the end-of-call summary email, set once from the client's login email and editable in Settings. |
 | 1.3.48  | Fixed `getScanPages` search (CP-1726): user search input was passed unescaped into MongoDB's `$regex`, so a URL/title containing regex-special characters (e.g. `?`) failed to match even when the document existed. Added `escapeRegex()` and applied it before building the `url`/`title` `$regex` filter. No API changes. |
 | 1.3.49  | Internal tools configuration on flows (CP-1723): `Flow.internalTools` keyed by tool name (`enabled`, optional `maxCalls`, per-parameter `description`/`value` overrides) with matching `$jsonSchema` validator, plus `createFlow` / `updateFlowById` mutators and the `FlowUpdateParams` type so consumers stop writing to the `flows` collection directly. |
+| 1.3.52 | Client-lifecycle support for the TalkPilot Dashboard (PE-869): `clientExistsInAnyCollection`/`deleteClientDataAcrossDomains` (dynamic scan across talkpilot/municipal domains only, no hardcoded collection list; `auditLogs` is excluded so a client's own deletion record survives its deletion), new `auditLogs` collection & `insertAuditLog`/`findAuditLogs`/`countAuditLogs`, `getAllClientCredits` on `clients`. Added `results` statistics getters for the dashboard: `aggregateActiveCallsSummary`, `aggregateTodayCallsSummary`, `aggregateClientCallStats`, `aggregateSessionCallStats`, and `findClientIdsByCallSids` (for backOffice-server). On `phone_numbers`: fixed `getClientPhones`/`getAllClientPhoneMappings` to deduplicate append-only history records instead of returning raw duplicate rows per client; added `getDistinctClientPhonePairs`, `findClientsByPhoneNumbers`, and `deletePhoneNumberRecords` (removes every record for a phone number, across all clients, once it's released back to Twilio). website-talk (`scans`/`websiteUrls`) is intentionally NOT touched by `deleteClientDataAcrossDomains` — see the Websitalk domain note above; callers must call the external website-talk deletion API separately. No breaking changes. |
 | 1.3.57  | Phone-number bind getters: list by client, exclusive flow assign, unbind, and `flow_id` match for ObjectId or leftover string. `getClientByClientId`. |
 | 1.3.61  | Optional `activeFlowId` on `WebsiteTalkProduct` (CP-1849). WebsiteTalk updates this flow instead of the flow on a phone number. |
 | 1.3.62  | Pause/Resume support for WebsiteTalk scans (CP-1752): `PAUSED` and `CANCELED` added to `SCAN_STATUSES` (`PAUSED` deliberately excluded from `FINISHED_SCAN_STATUSES` — pausing isn't done, `CANCELED` is). Added `Scan.pausedAt`, tracked across pause/resume so elapsed-time display can freeze correctly instead of counting the paused duration. |
 | 1.3.64  | New `callTokenUsage` collection with `incrementCallTokenUsage` (CP-1810): per-call realtime token usage, one document per `callSid`. |
 | 1.3.65  | `Flow.beforeCallEvent` as an optional HTTP config object (`url` required; `timeoutMs`, `sendUserAuthToken`, `allowedKeys`, `wait`). `afterCallEvent` remains an optional Pub/Sub string. |
+| 1.3.66  | Added `calls`-based stats getters for the dashboard: `aggregateActiveCallsSummary`, `aggregateTodayCallsSummary`, `aggregateClientCallStats`, `aggregateSessionCallStats`, `getAllClientsLastCallDate`, `findClientIdsByCallSids` — read the flat `calls` collection directly instead of unwinding `results.calls[]`, with a full per-status breakdown (`ALL_STATUSES_FOR_BREAKDOWN`) instead of a fixed 5-status set. **Removed** the 1.3.52 `results`-based getters of the same names — they were never released, so this isn't a breaking change for any consumer. |
 | 1.3.69  | Municipal `residents` collection: optional resident fields (`cityName`, `firstName`, `lastName`, `idNumber`, `phoneNumber`, `address`) with exact-match getters by phone, by idNumber, and by phone+idNumber (city-scoped). Schema + indexes exported; collection is created out of band. |
 | 1.3.71  | Who ended a call (CP-1873): optional `Call.endedBy` (`system` / `agent` / `user`), `CallEndedByValues`, and `setCallEndedBy` (first write wins). **Breaking** vs 1.3.69–1.3.70: the value `resident` was replaced by `user`. |
 | 1.3.74  | Added `human` to `CallEndedByValues` (CP-1873): a human agent ended the call, after a transfer or in a conference. |
 | 1.3.82  | Complaint tracking on `muniIssues` (CP-1888): optional `status` / `response` / `updatedAt`; an editable TalkPilot response with up to `MUNI_ISSUE_MAX_RESPONSE_IMAGES` (5) `response.imageUrls` and `response.updatedAt`; `updateMuniIssueStatus`, `setMuniIssueResponse`, `findMuniIssuesByClient`, `countMuniIssuesByClient`, `getMuniIssueByIdForClient`; index `clientId_1_createdAt_-1`. |
-| 1.3.88  | Single-note writes on `contextNotes` (CP-1998): append, update, or remove one entry without replacing the rest of the list. |
-
+| 1.3.89  | Backoffice support: roles (`BACKOFFICE_ROLES`, `getBackofficeRole`, `setBackofficeRole`, `countBackofficeAdmins`), `findClientsPage`, `findClientIdsWithCalls`, `findLastCallDatesByClientIds`, `findPhonesByClientIds`; `deleteClientDataAcrossDomains` returns `auditLogged` / `auditError`; an "Unknown" session bucket (`UNKNOWN_SESSION_ID`). **Breaking vs 1.3.66:** `aggregateClientCallStats` returns `{ rows, total }` and takes `clientIds` / `skip` / `limit`; `getAllClientsLastCallDate`, `getAllClientCredits` and `getAllClientPhoneMappings` are removed (only ever published from this branch, never on `main`). |
 
 ### 1.1.9
 
@@ -777,6 +779,24 @@ No — purely additive.
 
 No API changes. **WTIS** (the only current consumer of `getScanPages`) should upgrade to 1.3.48 or later to pick up the fix.
 
+### 1.3.52 — Client-lifecycle support for the TalkPilot Dashboard (PE-869)
+
+Adds centralized client deletion across the talkpilot/municipal domains, with an audit trail, plus supporting getters for the client-management dashboard.
+
+**Added**
+
+| Area | What |
+| --- | --- |
+| `clients` | `clientExistsInAnyCollection` / `deleteClientDataAcrossDomains` — dynamically scan and delete a client's data across every talkpilot/municipal collection (no hardcoded collection list). `auditLogs` is always excluded, so a client's own deletion record survives its own deletion. `getAllClientCredits`. |
+| `auditLogs` (new collection) | `insertAuditLog`, `findAuditLogs` (paginated), `countAuditLogs`. |
+| `results` | `aggregateActiveCallsSummary`, `aggregateTodayCallsSummary`, `aggregateClientCallStats`, `aggregateSessionCallStats` — call-volume/status dashboards. `findClientIdsByCallSids` — resolves clientId per callSid, added for backOffice-server. |
+| `phone_numbers` | Fixed `getClientPhones`/`getAllClientPhoneMappings` to deduplicate append-only history records. Added `getDistinctClientPhonePairs`, `findClientsByPhoneNumbers`, `deletePhoneNumberRecords` (clears every record for a number once released back to Twilio). |
+
+⚠️ website-talk (`scans`/`websiteUrls`) is intentionally **not** touched by `deleteClientDataAcrossDomains` — see the Websitalk domain note above. Callers must call the external website-talk deletion API separately for a full client delete.
+
+**Do I need to update my app?**
+
+No — purely additive, no breaking changes. Consumers opt in by importing the new getters above.
 ### 1.3.57 — Phone-number bind getters
 
 TalkPilot can bind any owned number to a flow without querying Mongo in the service layer. `flow_id` is matched as ObjectId or as a leftover string.
@@ -811,6 +831,32 @@ Optional `activeFlowId` on `WebsiteTalkProduct`. WTIS reads this field when it u
 
 No — the field is optional. **WTIS** should upgrade to **1.3.61** so the call-script update can use it.
 
+### 1.3.66 — Calls-based stats aggregations
+
+Adds stats getters that read the flat `calls` collection directly instead of unwinding `results.calls[]`, with a full per-status breakdown instead of a fixed 5-status set.
+
+**Added**
+
+| Export | Purpose |
+| --- | --- |
+| `aggregateActiveCallsSummary` | Active-calls-right-now summary, from `calls`. |
+| `aggregateTodayCallsSummary` | Status/type/minutes summary for a date range (or all-time with no range given), from `calls`. |
+| `aggregateClientCallStats` | Per-client breakdown with a full per-status `statusCounts` map and `lastCallDate`, from `calls`. |
+| `aggregateSessionCallStats` | Per-session breakdown with a full per-status `statusCounts` map, from `calls`. |
+| `getAllClientsLastCallDate` | Last call date per client, from `calls`. |
+| `findClientIdsByCallSids` | Resolves clientId per callSid, from `calls`. |
+
+The session breakdown groups by `sessionId` (not `sessionName`) so a renamed session doesn't split its stats across two rows; the name shown is a live lookup against the current `sessions` collection.
+
+⚠️ **Note:** the `calls` collection only reliably covers call volume from around late October 2025 onward (full per-status accuracy from mid-2026) — older history lives only in `results`. An "all time" aggregation on these getters will undercount clients whose history predates that cutover.
+
+**Removed**
+
+The `results`-based getters added in 1.3.52 (`aggregateActiveCallsSummary`, `aggregateTodayCallsSummary`, `aggregateClientCallStats`, `aggregateSessionCallStats`, `findClientIdsByCallSids`) are replaced by the `calls`-based getters above, under the same names. 1.3.52 was never released, so no consumer depended on them.
+
+**Do I need to update my app?**
+
+No — these are new getters, and the 1.3.52 ones they replace were never released, so nothing existing depends on either.
 ### 1.3.71 — Who ended the call (CP-1873)
 
 Records who ended a connected call. Unset for calls that never connected (busy, no-answer) and for calls moved to a conference.
@@ -837,22 +883,29 @@ New `CallEndedByValues.Human` (`"human"`): a human agent ended the call, either
 
 No — purely additive. **TalkPilot Server** should upgrade to **1.3.74** to write it.
 
-### 1.3.85 — Single context-note writes (CP-1998)
-
-Append, update, or remove one note on a client/product document without replacing the rest of the `notes` array. `appendContextNoteEntry` creates the document when none exists yet. `setContextNoteEntries` still replaces the whole list.
+### 1.3.89 — Backoffice support and the "Unknown" session bucket
 
 **Added**
 
-| Export | Purpose |
-| --- | --- |
-| `ContextNoteEntryWrite` | Fields the caller sets: `title`, `content`, `activeFrom`, `expiresAt`. The getter assigns `_id`, `createdAt`, and `updatedAt`. |
-| `appendContextNoteEntry(clientId, product, entry, now?)` | Pushes one note and upserts the document. Returns the stored entry. |
-| `updateContextNoteEntryFields(clientId, product, noteId, entry, now?)` | Replaces one note's writable fields and `updatedAt`. Leaves `createdAt` and the other notes alone. Returns `null` when the note is missing. |
-| `pullContextNoteEntry(clientId, product, noteId)` | Removes one note by id. Returns `false` when nothing changed. |
+- Backoffice roles: `BACKOFFICE_ROLES`, `BackofficeRole`, `getBackofficeRole`, `setBackofficeRole`, `countBackofficeAdmins` (stored in `roles.backoffice`).
+- `findClientsPage`: a page of clients with `total`, filtered by `clientId`, `clientIds`, `excludeClientIds` or a `search` on the clientId or phone numbers.
+- Per-client lookups: `findClientIdsWithCalls`, `findLastCallDatesByClientIds`, `findPhonesByClientIds`.
+- `deleteClientDataAcrossDomains` returns `auditLogged`, and `auditError` when it is `false`.
+- `UNKNOWN_SESSION_ID`.
+
+**Changed**
+
+- `aggregateClientCallStats` accepts `clientIds`, `skip` and `limit` and returns `{ rows, total }` instead of an array. **Breaking vs 1.3.66.**
+- `aggregateSessionCallStats`: only `isIncomingCall: true` calls are "Incoming Call"; non-incoming calls with no session get their own "Unknown" row.
+- `getDistinctClientPhonePairs` takes an optional `clientIds`.
+
+**Removed** (only ever in 1.3.66, never on `main`)
+
+- `getAllClientsLastCallDate` (use `findLastCallDatesByClientIds`), `getAllClientCredits` (use `findClientsPage`, which returns `credits`) and `getAllClientPhoneMappings` (use `getDistinctClientPhonePairs` or `findPhonesByClientIds`).
 
 **Do I need to update my app?**
 
-No — purely additive. Use these instead of `setContextNoteEntries` when only one note changes.
+Only if you use 1.3.66 (the backoffice): adapt to the changes above. **Backoffice** should upgrade to **1.3.89**.
 
 ## 🛠 CI/CD & deployment
 

package/dist/talkpilot/auditLogs/auditLogs.getters.d.ts

@@ -0,0 +1,8 @@
+import { Collection } from "mongodb";
+import { QueryOptions } from "../utils/query.utils";
+import { AuditLogDoc, AuditLogEntry } from "./auditLogs.types";
+export declare const getAuditLogsCollection: () => Collection<AuditLogEntry>;
+export declare const insertAuditLog: (entry: AuditLogEntry) => Promise<void>;
+export declare const findAuditLogs: (options: Pick<QueryOptions, "skip"> & Required<Pick<QueryOptions, "limit">>) => Promise<AuditLogDoc[]>;
+export declare const countAuditLogs: () => Promise<number>;
+//# sourceMappingURL=auditLogs.getters.d.ts.map

package/dist/talkpilot/auditLogs/auditLogs.getters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditLogs.getters.d.ts","sourceRoot":"","sources":["../../../src/talkpilot/auditLogs/auditLogs.getters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAqB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE/D,eAAO,MAAM,sBAAsB,QAAO,UAAU,CAAC,aAAa,CAEjE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAU,OAAO,aAAa,KAAG,OAAO,CAAC,IAAI,CAEvE,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,SAAS,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,KAC1E,OAAO,CAAC,WAAW,EAAE,CAMvB,CAAC;AAEF,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,MAAM,CAErD,CAAC"}

package/dist/talkpilot/auditLogs/auditLogs.getters.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countAuditLogs = exports.findAuditLogs = exports.insertAuditLog = exports.getAuditLogsCollection = void 0;
+const index_1 = require("../index");
+const query_utils_1 = require("../utils/query.utils");
+const getAuditLogsCollection = () => {
+    return (0, index_1.getDb)().collection("auditLogs");
+};
+exports.getAuditLogsCollection = getAuditLogsCollection;
+const insertAuditLog = async (entry) => {
+    await (0, exports.getAuditLogsCollection)().insertOne(entry);
+};
+exports.insertAuditLog = insertAuditLog;
+const findAuditLogs = async (options) => {
+    const cursor = (0, exports.getAuditLogsCollection)().find({});
+    return (0, query_utils_1.applyQueryOptions)(cursor, {
+        sort: { timestamp: -1 },
+        ...options,
+    }).toArray();
+};
+exports.findAuditLogs = findAuditLogs;
+const countAuditLogs = async () => {
+    return (0, exports.getAuditLogsCollection)().countDocuments({});
+};
+exports.countAuditLogs = countAuditLogs;
+//# sourceMappingURL=auditLogs.getters.js.map

package/dist/talkpilot/auditLogs/auditLogs.getters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditLogs.getters.js","sourceRoot":"","sources":["../../../src/talkpilot/auditLogs/auditLogs.getters.ts"],"names":[],"mappings":";;;AACA,oCAAiC;AACjC,sDAAuE;AAGhE,MAAM,sBAAsB,GAAG,GAA8B,EAAE;IACpE,OAAO,IAAA,aAAK,GAAE,CAAC,UAAU,CAAgB,WAAW,CAAC,CAAC;AACxD,CAAC,CAAC;AAFW,QAAA,sBAAsB,0BAEjC;AAEK,MAAM,cAAc,GAAG,KAAK,EAAE,KAAoB,EAAiB,EAAE;IAC1E,MAAM,IAAA,8BAAsB,GAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB;AAEK,MAAM,aAAa,GAAG,KAAK,EAChC,OAA2E,EACnD,EAAE;IAC1B,MAAM,MAAM,GAAG,IAAA,8BAAsB,GAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,OAAO,IAAA,+BAAiB,EAAC,MAAM,EAAE;QAC/B,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE;QACvB,GAAG,OAAO;KACX,CAAC,CAAC,OAAO,EAAE,CAAC;AACf,CAAC,CAAC;AARW,QAAA,aAAa,iBAQxB;AAEK,MAAM,cAAc,GAAG,KAAK,IAAqB,EAAE;IACxD,OAAO,IAAA,8BAAsB,GAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB"}

package/dist/talkpilot/auditLogs/auditLogs.types.d.ts

@@ -0,0 +1,11 @@
+import { WithId } from "mongodb";
+export type AuditLogEntry = {
+    clientId: string;
+    adminEmail: string;
+    action: "delete";
+    timestamp: Date;
+    allSucceeded?: boolean;
+    failedCollections?: string[];
+};
+export type AuditLogDoc = WithId<AuditLogEntry>;
+//# sourceMappingURL=auditLogs.types.d.ts.map

package/dist/talkpilot/auditLogs/auditLogs.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditLogs.types.d.ts","sourceRoot":"","sources":["../../../src/talkpilot/auditLogs/auditLogs.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC"}

package/dist/talkpilot/auditLogs/auditLogs.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=auditLogs.types.js.map

package/dist/talkpilot/auditLogs/auditLogs.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditLogs.types.js","sourceRoot":"","sources":["../../../src/talkpilot/auditLogs/auditLogs.types.ts"],"names":[],"mappings":""}

package/dist/talkpilot/auditLogs/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./auditLogs.types";
+export * from "./auditLogs.getters";
+//# sourceMappingURL=index.d.ts.map

package/dist/talkpilot/auditLogs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/talkpilot/auditLogs/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/talkpilot/auditLogs/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./auditLogs.types"), exports);
+__exportStar(require("./auditLogs.getters"), exports);
+//# sourceMappingURL=index.js.map

package/dist/talkpilot/auditLogs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/talkpilot/auditLogs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,sDAAoC"}

package/dist/talkpilot/calls/calls.constants.d.ts

@@ -6,6 +6,14 @@ export declare const CONFERENCE_ROLE_SUPERVISOR: "supervisor";
 export declare const IN_CALL_STATUSES: readonly ["in-progress", "answered"];
 /** Terminal Twilio call statuses — no further status callbacks expected. */
 export declare const FINAL_STATUSES: readonly ["no-answer", "completed", "busy", "failed", "canceled"];
+/** sessionId used for calls that arrived without an existing session (incoming calls). */
+export declare const INCOMING_SESSION_ID = "incomingCall";
+/** sessionId used in the per-session breakdown for calls with no session that are not incoming. */
+export declare const UNKNOWN_SESSION_ID = "unknownSession";
+/** Twilio call statuses considered "currently active" for the live calls summary. */
+export declare const ACTIVE_STATUSES: string[];
+/** Lookback window for the "active calls right now" summary. */
+export declare const ACTIVE_CALLS_WINDOW_MS: number;
 /** Hours in a single day. */
 export declare const HOURS_PER_DAY = 24;
 /** Max execution time (ms) for calls statistics aggregations. */
@@ -31,7 +39,9 @@ export declare const CallStatusValues: {
     readonly Failed: "failed";
     readonly Canceled: "canceled";
 };
-export declare const ALL_CALL_STATUSES: ("in-progress" | "answered" | "no-answer" | "completed" | "busy" | "failed" | "canceled" | "initiated" | "ringing")[];
+export declare const ALL_CALL_STATUSES: ("failed" | "answered" | "in-progress" | "no-answer" | "completed" | "busy" | "canceled" | "initiated" | "ringing")[];
+/** All statuses shown in the breakdown tables — kept separate so CallStatusValues stays untouched. */
+export declare const ALL_STATUSES_FOR_BREAKDOWN: readonly [...("failed" | "answered" | "in-progress" | "no-answer" | "completed" | "busy" | "canceled" | "initiated" | "ringing")[], "queued"];
 /** Who ended a connected call: our platform, the AI agent (end flow), the caller, or a human agent. */
 export declare const CallEndedByValues: {
     readonly System: "system";

package/dist/talkpilot/calls/calls.constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calls.constants.d.ts","sourceRoot":"","sources":["../../../src/talkpilot/calls/calls.constants.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,wBAAwB,EAAG,UAAmB,CAAC;AAE5D,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,EAAG,YAAqB,CAAC;AAEhE,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,sCAAuC,CAAC;AAErE,4EAA4E;AAC5E,eAAO,MAAM,cAAc,mEAMjB,CAAC;AAEX,6BAA6B;AAC7B,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,eAAO,MAAM,gBAAgB;;;;;;;;;;CAUnB,CAAC;AAEX,eAAO,MAAM,iBAAiB,uHAAkC,CAAC;AAEjE,uGAAuG;AACvG,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC"}
+{"version":3,"file":"calls.constants.d.ts","sourceRoot":"","sources":["../../../src/talkpilot/calls/calls.constants.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,wBAAwB,EAAG,UAAmB,CAAC;AAE5D,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,EAAG,YAAqB,CAAC;AAEhE,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,sCAAuC,CAAC;AAErE,4EAA4E;AAC5E,eAAO,MAAM,cAAc,mEAMjB,CAAC;AAEX,0FAA0F;AAC1F,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD,qFAAqF;AACrF,eAAO,MAAM,eAAe,UAAkB,CAAC;AAE/C,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,QAAqB,CAAC;AAEzD,6BAA6B;AAC7B,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,eAAO,MAAM,gBAAgB;;;;;;;;;;CAUnB,CAAC;AAEX,eAAO,MAAM,iBAAiB,uHAAkC,CAAC;AAEjE,sGAAsG;AACtG,eAAO,MAAM,0BAA0B,+IAA4C,CAAC;AACpF,uGAAuG;AACvG,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC"}

package/dist/talkpilot/calls/calls.constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CallEndedByValues = exports.ALL_CALL_STATUSES = exports.CallStatusValues = exports.TOOL_EXECUTIONS_DEFAULT_LIMIT = exports.TOOL_EXECUTIONS_DEFAULT_SKIP = exports.TREND_WEEK_BUCKET_MIN_MONTHS = exports.TREND_MONTH_BUCKET_MIN_MONTHS = exports.STATS_MAX_TIME_MS = exports.HOURS_PER_DAY = exports.FINAL_STATUSES = exports.IN_CALL_STATUSES = exports.CONFERENCE_ROLE_SUPERVISOR = exports.CONFERENCE_ROLE_CUSTOMER = void 0;
+exports.CallEndedByValues = exports.ALL_STATUSES_FOR_BREAKDOWN = exports.ALL_CALL_STATUSES = exports.CallStatusValues = exports.TOOL_EXECUTIONS_DEFAULT_LIMIT = exports.TOOL_EXECUTIONS_DEFAULT_SKIP = exports.TREND_WEEK_BUCKET_MIN_MONTHS = exports.TREND_MONTH_BUCKET_MIN_MONTHS = exports.STATS_MAX_TIME_MS = exports.HOURS_PER_DAY = exports.ACTIVE_CALLS_WINDOW_MS = exports.ACTIVE_STATUSES = exports.UNKNOWN_SESSION_ID = exports.INCOMING_SESSION_ID = exports.FINAL_STATUSES = exports.IN_CALL_STATUSES = exports.CONFERENCE_ROLE_SUPERVISOR = exports.CONFERENCE_ROLE_CUSTOMER = void 0;
 /** Customer role within a conference call. */
 exports.CONFERENCE_ROLE_CUSTOMER = "customer";
 /** Supervisor role within a conference call. */
@@ -15,6 +15,14 @@ exports.FINAL_STATUSES = [
     "failed",
     "canceled",
 ];
+/** sessionId used for calls that arrived without an existing session (incoming calls). */
+exports.INCOMING_SESSION_ID = "incomingCall";
+/** sessionId used in the per-session breakdown for calls with no session that are not incoming. */
+exports.UNKNOWN_SESSION_ID = "unknownSession";
+/** Twilio call statuses considered "currently active" for the live calls summary. */
+exports.ACTIVE_STATUSES = ["in-progress"];
+/** Lookback window for the "active calls right now" summary. */
+exports.ACTIVE_CALLS_WINDOW_MS = 2 * 60 * 60 * 1000;
 /** Hours in a single day. */
 exports.HOURS_PER_DAY = 24;
 /** Max execution time (ms) for calls statistics aggregations. */
@@ -41,6 +49,8 @@ exports.CallStatusValues = {
     Canceled: "canceled",
 };
 exports.ALL_CALL_STATUSES = Object.values(exports.CallStatusValues);
+/** All statuses shown in the breakdown tables — kept separate so CallStatusValues stays untouched. */
+exports.ALL_STATUSES_FOR_BREAKDOWN = [...exports.ALL_CALL_STATUSES, "queued"];
 /** Who ended a connected call: our platform, the AI agent (end flow), the caller, or a human agent. */
 exports.CallEndedByValues = {
     System: "system",

package/dist/talkpilot/calls/calls.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"calls.constants.js","sourceRoot":"","sources":["../../../src/talkpilot/calls/calls.constants.ts"],"names":[],"mappings":";;;AAAA,8CAA8C;AACjC,QAAA,wBAAwB,GAAG,UAAmB,CAAC;AAE5D,gDAAgD;AACnC,QAAA,0BAA0B,GAAG,YAAqB,CAAC;AAEhE,wEAAwE;AAC3D,QAAA,gBAAgB,GAAG,CAAC,aAAa,EAAE,UAAU,CAAU,CAAC;AAErE,4EAA4E;AAC/D,QAAA,cAAc,GAAG;IAC5B,WAAW;IACX,WAAW;IACX,MAAM;IACN,QAAQ;IACR,UAAU;CACF,CAAC;AAEX,6BAA6B;AAChB,QAAA,aAAa,GAAG,EAAE,CAAC;AAEhC,iEAAiE;AACpD,QAAA,iBAAiB,GAAG,MAAM,CAAC;AAExC;;;;;GAKG;AACU,QAAA,6BAA6B,GAAG,CAAC,CAAC;AAClC,QAAA,4BAA4B,GAAG,CAAC,CAAC;AAEjC,QAAA,4BAA4B,GAAG,CAAC,CAAC;AACjC,QAAA,6BAA6B,GAAG,EAAE,CAAC;AAEnC,QAAA,gBAAgB,GAAG;IAC9B,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,aAAa;IACzB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEE,QAAA,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,wBAAgB,CAAC,CAAC;AAEjE,uGAAuG;AAC1F,QAAA,iBAAiB,GAAG;IAC/B,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;CAChB,CAAC"}
+{"version":3,"file":"calls.constants.js","sourceRoot":"","sources":["../../../src/talkpilot/calls/calls.constants.ts"],"names":[],"mappings":";;;AAAA,8CAA8C;AACjC,QAAA,wBAAwB,GAAG,UAAmB,CAAC;AAE5D,gDAAgD;AACnC,QAAA,0BAA0B,GAAG,YAAqB,CAAC;AAEhE,wEAAwE;AAC3D,QAAA,gBAAgB,GAAG,CAAC,aAAa,EAAE,UAAU,CAAU,CAAC;AAErE,4EAA4E;AAC/D,QAAA,cAAc,GAAG;IAC5B,WAAW;IACX,WAAW;IACX,MAAM;IACN,QAAQ;IACR,UAAU;CACF,CAAC;AAEX,0FAA0F;AAC7E,QAAA,mBAAmB,GAAG,cAAc,CAAC;AAElD,mGAAmG;AACtF,QAAA,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD,qFAAqF;AACxE,QAAA,eAAe,GAAG,CAAC,aAAa,CAAC,CAAC;AAE/C,gEAAgE;AACnD,QAAA,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEzD,6BAA6B;AAChB,QAAA,aAAa,GAAG,EAAE,CAAC;AAEhC,iEAAiE;AACpD,QAAA,iBAAiB,GAAG,MAAM,CAAC;AAExC;;;;;GAKG;AACU,QAAA,6BAA6B,GAAG,CAAC,CAAC;AAClC,QAAA,4BAA4B,GAAG,CAAC,CAAC;AAEjC,QAAA,4BAA4B,GAAG,CAAC,CAAC;AACjC,QAAA,6BAA6B,GAAG,EAAE,CAAC;AAEnC,QAAA,gBAAgB,GAAG;IAC9B,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,aAAa;IACzB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEE,QAAA,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,wBAAgB,CAAC,CAAC;AAEjE,sGAAsG;AACzF,QAAA,0BAA0B,GAAG,CAAC,GAAG,yBAAiB,EAAE,QAAQ,CAAU,CAAC;AACpF,uGAAuG;AAC1F,QAAA,iBAAiB,GAAG;IAC/B,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;CAChB,CAAC"}

package/dist/talkpilot/calls/calls.getters.d.ts

@@ -1,5 +1,5 @@
 import { Call, CallDoc, CallQueryOptions, CallUpdateParams } from "../index";
-import type { CountOpts, DateRange, ToolExecution, CallStatus, CallEndedBy } from "./calls.types";
+import type { CountOpts, DateRange, ToolExecution, CallStatus, ActiveCallsSummary, TodayCallsSummary, ClientCallStatsPage, ClientCallStatsParams, SessionCallStats, StatsDateRangeParams, CallEndedBy } from "./calls.types";
 import { Filter, ObjectId } from "mongodb";
 import { DashboardHeatmapMetric } from "./dashboard/calls.dashboard.types";
 export declare const getCallsCollection: () => import("mongodb").Collection<Call>;
@@ -41,4 +41,11 @@ export declare function getCallsStatsForDateRange(clientId: string, startStr: st
  * Aggregate calls by hour for a given date (createdAt converted to given timezone). Hour format "HH:mm".
  */
 export declare function getCallsHourlyAggregation(clientId: string, dateStr: string, timezone: string): Promise<DashboardHeatmapMetric[]>;
+export declare const findClientIdsWithCalls: ({ dateFrom, dateTo, timezone, }: StatsDateRangeParams) => Promise<string[]>;
+export declare const aggregateActiveCallsSummary: (clientId?: string) => Promise<ActiveCallsSummary>;
+export declare const aggregateTodayCallsSummary: ({ dateFrom, dateTo, clientId, timezone, }: StatsDateRangeParams) => Promise<TodayCallsSummary>;
+export declare const aggregateClientCallStats: ({ dateFrom, dateTo, clientId, clientIds, timezone, skip, limit, }: ClientCallStatsParams) => Promise<ClientCallStatsPage>;
+export declare const aggregateSessionCallStats: ({ dateFrom, dateTo, clientId, timezone, }: StatsDateRangeParams) => Promise<SessionCallStats[]>;
+export declare const findLastCallDatesByClientIds: (clientIds: string[]) => Promise<Map<string, Date>>;
+export declare const findClientIdsByCallSids: (callSids: string[]) => Promise<Map<string, string>>;
 //# sourceMappingURL=calls.getters.d.ts.map

package/dist/talkpilot/calls/calls.getters.d.ts.map

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

package/dist/talkpilot/calls/calls.getters.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.range = exports.countCalls = exports.findCallsByQuery = exports.getCallsByClientAndDateRange = exports.pushToolExecution = exports.setCallEndedBy = exports.updateCallStatusByCallSid = exports.getToolExecutionsByCallSid = exports.updateCallByCallSid = exports.createCallDoc = exports.getCallsByFlow = exports.getCallsByClient = exports.getCallsByPhoneNumber = exports.getCallByCallSid = exports.getCallsCollection = void 0;
+exports.findClientIdsByCallSids = exports.findLastCallDatesByClientIds = exports.aggregateSessionCallStats = exports.aggregateClientCallStats = exports.aggregateTodayCallsSummary = exports.aggregateActiveCallsSummary = exports.findClientIdsWithCalls = exports.range = exports.countCalls = exports.findCallsByQuery = exports.getCallsByClientAndDateRange = exports.pushToolExecution = exports.setCallEndedBy = exports.updateCallStatusByCallSid = exports.getToolExecutionsByCallSid = exports.updateCallByCallSid = exports.createCallDoc = exports.getCallsByFlow = exports.getCallsByClient = exports.getCallsByPhoneNumber = exports.getCallByCallSid = exports.getCallsCollection = void 0;
 exports.countCallsByPhoneInRange = countCallsByPhoneInRange;
 exports.startOfDay = startOfDay;
 exports.addDays = addDays;
@@ -43,6 +43,7 @@ const index_1 = require("../index");
 const calls_constants_1 = require("./calls.constants");
 const process = __importStar(require("node:process"));
 const query_utils_1 = require("../utils/query.utils");
+const date_utils_1 = require("../../utils/date.utils");
 const getCallsCollection = () => {
     return (0, index_1.getDb)().collection("calls");
 };
@@ -246,4 +247,218 @@ async function getCallsHourlyAggregation(clientId, dateStr, timezone) {
         calls: r.calls,
     }));
 }
+// One $sum/$cond accumulator per status in ALL_STATUSES_FOR_BREAKDOWN.
+const buildStatusCountFields = (field) => Object.fromEntries(calls_constants_1.ALL_STATUSES_FOR_BREAKDOWN.map((status) => [
+    status,
+    { $sum: { $cond: [{ $eq: [field, status] }, 1, 0] } },
+]));
+const extractStatusCounts = (row) => Object.fromEntries(calls_constants_1.ALL_STATUSES_FOR_BREAKDOWN.map((status) => [status, row[status] ?? 0]));
+const dateRangeFilter = (dateFrom, dateTo, timezone) => {
+    const today = (0, date_utils_1.formatYmdInTz)(new Date(), timezone);
+    return {
+        start: (0, date_utils_1.startOfCalendarDayInTz)(dateFrom ?? today, timezone),
+        end: (0, date_utils_1.endOfCalendarDayInTz)(dateTo ?? today, timezone),
+    };
+};
+const buildCallsStatsMatch = ({ dateFrom, dateTo, clientId, clientIds, timezone = "UTC", }) => {
+    const range = dateFrom || dateTo ? dateRangeFilter(dateFrom, dateTo, timezone) : null;
+    const clientConditions = [
+        ...(clientId ? [{ clientId }] : []),
+        ...(clientIds ? [{ clientId: { $in: clientIds } }] : []),
+    ];
+    return {
+        ...(range ? { createdAt: { $gte: range.start, $lte: range.end } } : {}),
+        ...(clientConditions.length > 0 ? { $and: clientConditions } : {}),
+    };
+};
+const findClientIdsWithCalls = async ({ dateFrom, dateTo, timezone = "UTC", }) => (0, exports.getCallsCollection)().distinct("clientId", buildCallsStatsMatch({ dateFrom, dateTo, timezone }));
+exports.findClientIdsWithCalls = findClientIdsWithCalls;
+const aggregateActiveCallsSummary = async (clientId) => {
+    const coll = (0, exports.getCallsCollection)();
+    const twoHoursAgo = new Date(Date.now() - calls_constants_1.ACTIVE_CALLS_WINDOW_MS);
+    const match = {
+        status: { $in: calls_constants_1.ACTIVE_STATUSES },
+        updatedAt: { $gte: twoHoursAgo },
+        ...(clientId ? { clientId } : {}),
+    };
+    const facetResult = await coll
+        .aggregate([
+        { $match: match },
+        {
+            $facet: {
+                counts: [
+                    {
+                        $group: {
+                            _id: null,
+                            total: { $sum: 1 },
+                            incoming: { $sum: { $cond: ["$isIncomingCall", 1, 0] } },
+                            outgoing: { $sum: { $cond: ["$isOutgoingCall", 1, 0] } },
+                        },
+                    },
+                ],
+                activeClients: [{ $group: { _id: "$clientId" } }],
+            },
+        },
+    ])
+        .next();
+    const counts = facetResult?.counts?.[0];
+    return {
+        total: counts?.total ?? 0,
+        incoming: counts?.incoming ?? 0,
+        outgoing: counts?.outgoing ?? 0,
+        activeClientIds: (facetResult?.activeClients ?? []).map((d) => d._id || "Unknown"),
+    };
+};
+exports.aggregateActiveCallsSummary = aggregateActiveCallsSummary;
+const aggregateTodayCallsSummary = async ({ dateFrom, dateTo, clientId, timezone = "UTC", }) => {
+    const coll = (0, exports.getCallsCollection)();
+    const match = buildCallsStatsMatch({ dateFrom, dateTo, clientId, timezone });
+    const facetResult = await coll
+        .aggregate([
+        { $match: match },
+        {
+            $facet: {
+                byStatus: [{ $group: { _id: "$status", count: { $sum: 1 } } }],
+                byType: [
+                    {
+                        $group: {
+                            _id: { $cond: ["$isIncomingCall", "incoming", "outgoing"] },
+                            count: { $sum: 1 },
+                        },
+                    },
+                ],
+                total: [{ $group: { _id: null, count: { $sum: 1 } } }],
+                totalSeconds: [{ $group: { _id: null, seconds: { $sum: "$callLength" } } }],
+            },
+        },
+    ])
+        .next();
+    const byStatus = {};
+    (facetResult?.byStatus ?? []).forEach((s) => {
+        byStatus[s._id] = s.count;
+    });
+    const byType = {};
+    (facetResult?.byType ?? []).forEach((t) => {
+        byType[t._id] = t.count;
+    });
+    const totalSeconds = facetResult?.totalSeconds?.[0]?.seconds ?? 0;
+    return {
+        total: facetResult?.total?.[0]?.count ?? 0,
+        incoming: byType.incoming ?? 0,
+        outgoing: byType.outgoing ?? 0,
+        completed: byStatus.completed ?? 0,
+        failed: byStatus.failed ?? 0,
+        busy: byStatus.busy ?? 0,
+        noAnswer: byStatus["no-answer"] ?? 0,
+        totalMinutes: Math.ceil(totalSeconds / 60),
+    };
+};
+exports.aggregateTodayCallsSummary = aggregateTodayCallsSummary;
+const aggregateClientCallStats = async ({ dateFrom, dateTo, clientId, clientIds, timezone = "UTC", skip = 0, limit, }) => {
+    const [result] = await (0, exports.getCallsCollection)()
+        .aggregate([
+        { $match: buildCallsStatsMatch({ dateFrom, dateTo, clientId, clientIds, timezone }) },
+        {
+            $group: {
+                _id: "$clientId",
+                totalCalls: { $sum: 1 },
+                ...buildStatusCountFields("$status"),
+                totalSeconds: { $sum: "$callLength" },
+                lastCallDate: { $max: "$createdAt" },
+            },
+        },
+        {
+            $lookup: {
+                from: (0, index_1.getClientsCollection)().collectionName,
+                localField: "_id",
+                foreignField: "clientId",
+                as: "client",
+            },
+        },
+        { $match: { "client.0": { $exists: true } } },
+        { $project: { client: 0 } },
+        { $sort: { totalCalls: -1, _id: 1 } },
+        {
+            $facet: {
+                rows: [{ $skip: skip }, ...(limit ? [{ $limit: limit }] : [])],
+                total: [{ $count: "count" }],
+            },
+        },
+    ])
+        .toArray();
+    return {
+        rows: (result?.rows ?? []).map((r) => ({
+            clientId: r._id,
+            totalCalls: r.totalCalls,
+            statusCounts: extractStatusCounts(r),
+            totalMinutes: Math.ceil((r.totalSeconds || 0) / 60),
+            lastCallDate: r.lastCallDate,
+        })),
+        total: result?.total[0]?.count ?? 0,
+    };
+};
+exports.aggregateClientCallStats = aggregateClientCallStats;
+const aggregateSessionCallStats = async ({ dateFrom, dateTo, clientId, timezone = "UTC", }) => {
+    const coll = (0, exports.getCallsCollection)();
+    const match = buildCallsStatsMatch({ dateFrom, dateTo, clientId, timezone });
+    const sessionGroupKey = {
+        $cond: [
+            { $eq: ["$isIncomingCall", true] },
+            calls_constants_1.INCOMING_SESSION_ID,
+            { $ifNull: ["$sessionId", calls_constants_1.UNKNOWN_SESSION_ID] },
+        ],
+    };
+    const rows = await coll
+        .aggregate([
+        { $match: match },
+        {
+            $group: {
+                _id: sessionGroupKey,
+                totalCalls: { $sum: 1 },
+                ...buildStatusCountFields("$status"),
+            },
+        },
+        {
+            $lookup: {
+                from: "sessions",
+                localField: "_id",
+                foreignField: "_id",
+                as: "sessionDoc",
+            },
+        },
+        { $sort: { totalCalls: -1 } },
+    ])
+        .toArray();
+    return rows.map((r) => ({
+        sessionId: r._id.toString(),
+        // No session, or a deleted/unnamed one, has no name to look up: that is "Unknown".
+        sessionName: r._id === calls_constants_1.INCOMING_SESSION_ID
+            ? "Incoming Call"
+            : r.sessionDoc[0]?.session_name || "Unknown",
+        totalCalls: r.totalCalls,
+        statusCounts: extractStatusCounts(r),
+    }));
+};
+exports.aggregateSessionCallStats = aggregateSessionCallStats;
+const findLastCallDatesByClientIds = async (clientIds) => {
+    if (clientIds.length === 0)
+        return new Map();
+    const rows = await (0, exports.getCallsCollection)()
+        .aggregate([
+        { $match: { clientId: { $in: clientIds } } },
+        { $group: { _id: "$clientId", lastCallDate: { $max: "$createdAt" } } },
+    ])
+        .toArray();
+    return new Map(rows.map((r) => [r._id, r.lastCallDate]));
+};
+exports.findLastCallDatesByClientIds = findLastCallDatesByClientIds;
+const findClientIdsByCallSids = async (callSids) => {
+    if (callSids.length === 0)
+        return new Map();
+    const docs = await (0, exports.getCallsCollection)()
+        .find({ callSid: { $in: callSids } }, { projection: { _id: 0, clientId: 1, callSid: 1 } })
+        .toArray();
+    return new Map(docs.map((d) => [d.callSid, d.clientId]));
+};
+exports.findClientIdsByCallSids = findClientIdsByCallSids;
 //# sourceMappingURL=calls.getters.js.map