@talkpilot/core-db 1.3.70 → 1.3.71

package/README.md

@@ -182,6 +182,7 @@ Refer to `DEVELOPMENT.md` for the full walkthrough, token instructions, and fact
 | 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.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.1.9
 
@@ -804,6 +805,24 @@ 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.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.
+
+**Added**
+
+| Item | Purpose |
+| --- | --- |
+| `Call.endedBy` | `system` (our platform, e.g. silence timeout), `agent` (the bot ended the flow) or `user` (the caller hung up). |
+| `CallEndedByValues` / `CallEndedBy` | Const object and the type derived from it, same pattern as `CallStatusValues`. |
+| `setCallEndedBy(callSid, endedBy)` | Writes only if `endedBy` is not set yet; returns `true` when this call wrote it. |
+
+`endedBy` is not part of `CallUpdateParams`, so `updateCallByCallSid` cannot overwrite it.
+
+**Do I need to update my app?**
+
+**TalkPilot Server** must upgrade to **1.3.71** to write the field. 1.3.69–1.3.70 used `resident` instead of `user` — don't use them.
+
 ## 🛠 CI/CD & deployment
 
 - This package is consumed by Cloud Build-based services (TalkPilot Server, MIS, CIS) as a dependency when Docker images are built. Keep `dist/` in sync with your builds because the compiled artifact is what downstream services install.

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

@@ -32,4 +32,10 @@ export declare const CallStatusValues: {
     readonly Canceled: "canceled";
 };
 export declare const ALL_CALL_STATUSES: ("in-progress" | "answered" | "no-answer" | "completed" | "busy" | "failed" | "canceled" | "initiated" | "ringing")[];
+/** Who ended a connected call: our platform, the bot (end flow), or the caller. */
+export declare const CallEndedByValues: {
+    readonly System: "system";
+    readonly Agent: "agent";
+    readonly User: "user";
+};
 //# sourceMappingURL=calls.constants.d.ts.map

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"}
+{"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,mFAAmF;AACnF,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC"}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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_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;
 /** Customer role within a conference call. */
 exports.CONFERENCE_ROLE_CUSTOMER = "customer";
 /** Supervisor role within a conference call. */
@@ -41,4 +41,10 @@ exports.CallStatusValues = {
     Canceled: "canceled",
 };
 exports.ALL_CALL_STATUSES = Object.values(exports.CallStatusValues);
+/** Who ended a connected call: our platform, the bot (end flow), or the caller. */
+exports.CallEndedByValues = {
+    System: "system",
+    Agent: "agent",
+    User: "user",
+};
 //# sourceMappingURL=calls.constants.js.map

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"}
+{"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,mFAAmF;AACtE,QAAA,iBAAiB,GAAG;IAC/B,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACJ,CAAC"}

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

@@ -1,10 +1,10 @@
 import { ObjectId, Sort, WithId } from "mongodb";
 import { TranscriptionSegment } from "../results";
 import { LeadProperty } from "../leads";
-import { CallStatusValues, CONFERENCE_ROLE_CUSTOMER, CONFERENCE_ROLE_SUPERVISOR } from "./calls.constants";
+import { CallEndedByValues, CallStatusValues, CONFERENCE_ROLE_CUSTOMER, CONFERENCE_ROLE_SUPERVISOR } from "./calls.constants";
 export type ConferenceRole = typeof CONFERENCE_ROLE_CUSTOMER | typeof CONFERENCE_ROLE_SUPERVISOR | null;
 export type CallStatus = (typeof CallStatusValues)[keyof typeof CallStatusValues];
-export type CallEndedBy = "system" | "resident";
+export type CallEndedBy = (typeof CallEndedByValues)[keyof typeof CallEndedByValues];
 export type Call = {
     callSid: string;
     flowId: ObjectId;

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talkpilot/core-db",
-  "version": "1.3.70",
+  "version": "1.3.71",
   "description": "Core database package for centralized connections and ORM integration.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/talkpilot/calls/__tests__/calls.spec.ts

@@ -1,519 +1,519 @@
-import {
-  createCallDoc,
-  getCallsByFlow,
-  getCallsByClient,
-  getCallsByPhoneNumber,
-  getCallByCallSid,
-  findCallsByQuery,
-  countCalls,
-  getCallsByClientAndDateRange,
-  getCallsCollection,
-  pushToolExecution,
-  getToolExecutionsByCallSid,
-  updateCallStatusByCallSid,
-  setCallEndedBy,
-} from "../calls.getters";
-import type { ToolExecution, ToolExecutionStep } from "../calls.types";
-import { ObjectId } from "mongodb";
-import { createOutGoingCallDoc } from "../../../test-utils/factories";
-
-describe("db.calls", () => {
-  it("should return calls by flow", async () => {
-    const flowId = new ObjectId();
-    const call1 = createOutGoingCallDoc({ flowId });
-    const call2 = createOutGoingCallDoc({ flowId });
-
-    await createCallDoc(call1);
-    await createCallDoc(call2);
-
-    const result = await getCallsByFlow(flowId);
-
-    expect(result.length).toBe(2);
-    expect(result).toMatchObject([
-      { callSid: call1.callSid },
-      { callSid: call2.callSid },
-    ]);
-  });
-
-  it("should get call by callSid", async () => {
-    const call = createOutGoingCallDoc();
-    await createCallDoc(call);
-
-    const result = await getCallByCallSid(call.callSid);
-
-    expect(result).toBeDefined();
-    expect(result?.callSid).toBe(call.callSid);
-  });
-
-  it("should get calls by client", async () => {
-    const call = createOutGoingCallDoc();
-    await createCallDoc(call);
-
-    const result = await getCallsByClient(call.clientId);
-
-    expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
-  });
-
-  it("should get calls by phone number", async () => {
-    const call = createOutGoingCallDoc();
-    await createCallDoc(call);
-
-    const result = await getCallsByPhoneNumber(call.customerPhoneNumber);
-
-    expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
-  });
-
-  it("should set current status only via updateCallStatusByCallSid", async () => {
-    const call = createOutGoingCallDoc({ status: "ringing" });
-    await createCallDoc(call);
-
-    const updated = await updateCallStatusByCallSid(call.callSid, "in-progress");
-
-    expect(updated?.status).toBe("in-progress");
-    expect(await getCallByCallSid(call.callSid)).toMatchObject({
-      status: "in-progress",
-    });
-  });
-
-  describe("setCallEndedBy()", () => {
-    it("should set endedBy when it is not set yet", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-
-      const written = await setCallEndedBy(call.callSid, "resident");
-
-      expect(written).toBe(true);
-      expect(await getCallByCallSid(call.callSid)).toMatchObject({
-        endedBy: "resident",
-      });
-    });
-
-    it("should keep the first value when called again", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-
-      await setCallEndedBy(call.callSid, "resident");
-      const written = await setCallEndedBy(call.callSid, "system");
-
-      expect(written).toBe(false);
-      expect(await getCallByCallSid(call.callSid)).toMatchObject({
-        endedBy: "resident",
-      });
-    });
-
-    it("should let only one of two concurrent writers win", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-
-      const results = await Promise.all([
-        setCallEndedBy(call.callSid, "resident"),
-        setCallEndedBy(call.callSid, "system"),
-      ]);
-
-      expect(results.filter(Boolean)).toHaveLength(1);
-      const stored = await getCallByCallSid(call.callSid);
-      expect(stored?.endedBy).toBe(results[0] ? "resident" : "system");
-    });
-
-    it("should return false when the call does not exist", async () => {
-      await expect(setCallEndedBy("nonexistent-sid", "system")).resolves.toBe(
-        false,
-      );
-    });
-  });
-
-  describe("findCallsByQuery()", () => {
-    it("should find calls by status with limit and sort", async () => {
-      const clientId = "client123";
-      const call1 = createOutGoingCallDoc({ clientId, status: "completed" });
-      const call2 = createOutGoingCallDoc({ clientId, status: "completed" });
-      const call3 = createOutGoingCallDoc({ clientId, status: "busy" });
-
-      // We need to control createdAt to test sort. We'll insert directly.
-      await getCallsCollection().insertOne({
-        ...call1,
-        createdAt: new Date("2023-01-01"),
-        updatedAt: new Date(),
-        env: "test",
-      });
-      await getCallsCollection().insertOne({
-        ...call2,
-        createdAt: new Date("2023-01-02"),
-        updatedAt: new Date(),
-        env: "test",
-      });
-      await getCallsCollection().insertOne({
-        ...call3,
-        createdAt: new Date(),
-        updatedAt: new Date(),
-        env: "test",
-      });
-
-      const result = await findCallsByQuery(
-        { clientId, status: "completed" },
-        { sort: { createdAt: -1 }, limit: 1 },
-      );
-
-      expect(result.length).toBe(1);
-      expect(result[0].callSid).toBe(call2.callSid);
-    });
-  });
-
-  describe("countCalls()", () => {
-    it("should count calls matching query", async () => {
-      const clientId = "countClient";
-      await createCallDoc(
-        createOutGoingCallDoc({ clientId, status: "completed" }),
-      );
-      await createCallDoc(
-        createOutGoingCallDoc({ clientId, status: "completed" }),
-      );
-      await createCallDoc(
-        createOutGoingCallDoc({ clientId, status: "failed" }),
-      );
-
-      const count = await countCalls({ clientId, status: "completed" });
-      expect(count).toBe(2);
-    });
-  });
-
-  describe("pushToolExecution()", () => {
-    let callSid: string;
-
-    beforeEach(async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-      callSid = call.callSid;
-    });
-
-    const makeHttpExecution = (
-      overrides?: Partial<ToolExecution>,
-    ): ToolExecution => ({
-      toolName: "sendSms",
-      executedAt: new Date(),
-      durationMs: 120,
-      args: { to: "+1234567890", message: "hello" },
-      meta: {
-        kind: "http",
-        url: "https://api.example.com/sms",
-        method: "POST",
-      },
-      status: "success",
-      httpStatus: 200,
-      ...overrides,
-    });
-
-    it("should append an execution to a call with none", async () => {
-      const execution = makeHttpExecution();
-      await pushToolExecution(callSid, execution);
-
-      const result = await getCallByCallSid(callSid);
-      expect(result?.toolExecutions).toHaveLength(1);
-      expect(result?.toolExecutions?.[0]).toMatchObject({
-        toolName: "sendSms",
-        status: "success",
-        httpStatus: 200,
-      });
-    });
-
-    it("should maintain insertion order across multiple pushes", async () => {
-      const first = makeHttpExecution({ toolName: "first" });
-      const second = makeHttpExecution({ toolName: "second" });
-      const third = makeHttpExecution({ toolName: "third" });
-
-      await pushToolExecution(callSid, first);
-      await pushToolExecution(callSid, second);
-      await pushToolExecution(callSid, third);
-
-      const result = await getCallByCallSid(callSid);
-      expect(result?.toolExecutions?.map((e) => e.toolName)).toEqual([
-        "first",
-        "second",
-        "third",
-      ]);
-    });
-
-    it("should store an internal tool execution", async () => {
-      const execution: ToolExecution = {
-        toolName: "endFlow",
-        executedAt: new Date(),
-        durationMs: 5,
-        args: {},
-        meta: { kind: "internal" },
-        status: "success",
-      };
-
-      await pushToolExecution(callSid, execution);
-
-      const result = await getCallByCallSid(callSid);
-      expect(result?.toolExecutions?.[0]).toMatchObject({
-        toolName: "endFlow",
-        meta: { kind: "internal" },
-      });
-    });
-
-    it("should store redacted args for sensitive tools", async () => {
-      const execution = makeHttpExecution({ args: { _redacted: true } });
-      await pushToolExecution(callSid, execution);
-
-      const result = await getCallByCallSid(callSid);
-      expect(result?.toolExecutions?.[0].args).toEqual({ _redacted: true });
-    });
-
-    it("should store an error execution", async () => {
-      const execution = makeHttpExecution({ status: "error", httpStatus: 500 });
-      await pushToolExecution(callSid, execution);
-
-      const result = await getCallByCallSid(callSid);
-      expect(result?.toolExecutions?.[0]).toMatchObject({
-        status: "error",
-        httpStatus: 500,
-      });
-    });
-
-    it("should be a no-op for an unknown callSid", async () => {
-      await expect(
-        pushToolExecution("nonexistent-sid", makeHttpExecution()),
-      ).resolves.not.toThrow();
-    });
-
-    it("should store the response body", async () => {
-      const execution = makeHttpExecution({
-        response: { userId: "123", status: "sent" },
-      });
-      await pushToolExecution(callSid, execution);
-
-      const result = await getCallByCallSid(callSid);
-      expect(result?.toolExecutions?.[0].response).toEqual({
-        userId: "123",
-        status: "sent",
-      });
-    });
-  });
-
-  describe("getToolExecutionsByCallSid()", () => {
-    const makeExecution = (
-      overrides?: Partial<ToolExecution>,
-    ): ToolExecution => ({
-      toolName: "testTool",
-      executedAt: new Date(),
-      durationMs: 100,
-      args: { query: "test" },
-      meta: { kind: "http", url: "https://example.com", method: "POST" },
-      status: "success",
-      httpStatus: 200,
-      ...overrides,
-    });
-
-    it("returns all executions for a call", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-      await pushToolExecution(call.callSid, makeExecution({ toolName: "first" }));
-      await pushToolExecution(call.callSid, makeExecution({ toolName: "second" }));
-
-      const result = await getToolExecutionsByCallSid(call.callSid);
-
-      expect(result).toHaveLength(2);
-      expect(result.map((e) => e.toolName)).toEqual(["first", "second"]);
-    });
-
-    it("returns an empty array when the call has no executions", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-
-      const result = await getToolExecutionsByCallSid(call.callSid);
-
-      expect(result).toEqual([]);
-    });
-
-    it("returns an empty array for an unknown callSid", async () => {
-      const result = await getToolExecutionsByCallSid("nonexistent-sid");
-
-      expect(result).toEqual([]);
-    });
-
-    it("respects skip and limit for pagination", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-      for (const name of ["a", "b", "c", "d", "e"]) {
-        await pushToolExecution(call.callSid, makeExecution({ toolName: name }));
-      }
-
-      const page1 = await getToolExecutionsByCallSid(call.callSid, { skip: 0, limit: 2 });
-      const page2 = await getToolExecutionsByCallSid(call.callSid, { skip: 2, limit: 2 });
-      const page3 = await getToolExecutionsByCallSid(call.callSid, { skip: 4, limit: 2 });
-
-      expect(page1.map((e) => e.toolName)).toEqual(["a", "b"]);
-      expect(page2.map((e) => e.toolName)).toEqual(["c", "d"]);
-      expect(page3.map((e) => e.toolName)).toEqual(["e"]);
-    });
-
-    it("includes steps when present", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-      const steps: ToolExecutionStep[] = [
-        { timestamp: new Date("2024-01-01T10:00:00Z"), label: "audio_enrichment", level: "info", data: { audioUsed: true } },
-        { timestamp: new Date("2024-01-01T10:00:01Z"), label: "subject_classification", level: "warn" },
-      ];
-      await pushToolExecution(call.callSid, makeExecution({ steps }));
-
-      const result = await getToolExecutionsByCallSid(call.callSid);
-
-      expect(result[0].steps).toHaveLength(2);
-      const s0 = result[0].steps![0];
-      expect(s0.label).toBe("audio_enrichment");
-      expect(s0.level).toBe("info");
-      expect(new Date(s0.timestamp).toISOString()).toBe("2024-01-01T10:00:00.000Z");
-      expect(s0.data).toEqual({ audioUsed: true });
-      const s1 = result[0].steps![1];
-      expect(s1.label).toBe("subject_classification");
-      expect(s1.level).toBe("warn");
-      expect(s1.data).toBeUndefined();
-    });
-
-    it("includes step payload when present", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-      const steps: ToolExecutionStep[] = [
-        {
-          timestamp: new Date("2024-01-01T10:00:00Z"),
-          label: "subject_classification",
-          level: "info",
-          data: "Classified as: ניקיון / אשפה",
-          payload: { subject: "ניקיון", subSubject: "אשפה", ids: { subject: "abc", subSubject: "def" } },
-        },
-      ];
-      await pushToolExecution(call.callSid, makeExecution({ steps }));
-
-      const result = await getToolExecutionsByCallSid(call.callSid);
-
-      const s0 = result[0].steps![0];
-      expect(s0.data).toBe("Classified as: ניקיון / אשפה");
-      expect(s0.payload).toEqual({ subject: "ניקיון", subSubject: "אשפה", ids: { subject: "abc", subSubject: "def" } });
-    });
-
-    it("does not require step payload to be present", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-      const steps: ToolExecutionStep[] = [
-        { timestamp: new Date(), label: "user_query", level: "info", data: "Query: הרצל" },
-      ];
-      await pushToolExecution(call.callSid, makeExecution({ steps }));
-
-      const result = await getToolExecutionsByCallSid(call.callSid);
-
-      expect(result[0].steps![0].payload).toBeUndefined();
-    });
-
-    it("does not require steps to be present", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-      await pushToolExecution(call.callSid, makeExecution());
-
-      const result = await getToolExecutionsByCallSid(call.callSid);
-
-      expect(result[0].steps).toBeUndefined();
-    });
-
-    it("returns at most 50 executions by default", async () => {
-      const call = createOutGoingCallDoc();
-      await getCallsCollection().insertOne({
-        ...call,
-        createdAt: new Date(),
-        updatedAt: new Date(),
-        env: "test",
-        toolExecutions: Array.from({ length: 51 }, (_, i) =>
-          makeExecution({ toolName: `tool${i}` }),
-        ),
-      });
-
-      const result = await getToolExecutionsByCallSid(call.callSid);
-
-      expect(result).toHaveLength(50);
-      expect(result[0].toolName).toBe("tool0");
-      expect(result[49].toolName).toBe("tool49");
-    });
-
-    it("clamps negative skip to 0", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-      await pushToolExecution(call.callSid, makeExecution({ toolName: "only" }));
-
-      const result = await getToolExecutionsByCallSid(call.callSid, { skip: -5 });
-
-      expect(result).toHaveLength(1);
-      expect(result[0].toolName).toBe("only");
-    });
-
-    it("clamps negative limit to 1", async () => {
-      const call = createOutGoingCallDoc();
-      await createCallDoc(call);
-      await pushToolExecution(call.callSid, makeExecution({ toolName: "first" }));
-      await pushToolExecution(call.callSid, makeExecution({ toolName: "second" }));
-
-      const result = await getToolExecutionsByCallSid(call.callSid, { limit: -1 });
-
-      expect(result).toHaveLength(1);
-    });
-
-    it("returns executions when clientId matches the call's client", async () => {
-      const call = createOutGoingCallDoc({ clientId: "clientA" });
-      await createCallDoc(call);
-      await pushToolExecution(call.callSid, makeExecution({ toolName: "secret" }));
-
-      const result = await getToolExecutionsByCallSid(call.callSid, { clientId: "clientA" });
-
-      expect(result).toHaveLength(1);
-      expect(result[0].toolName).toBe("secret");
-    });
-
-    it("returns empty when clientId does not match the call's client", async () => {
-      const call = createOutGoingCallDoc({ clientId: "clientA" });
-      await createCallDoc(call);
-      await pushToolExecution(call.callSid, makeExecution({ toolName: "secret" }));
-
-      const result = await getToolExecutionsByCallSid(call.callSid, { clientId: "clientB" });
-
-      expect(result).toEqual([]);
-    });
-  });
-
-  describe("getCallsByClientAndDateRange()", () => {
-    it("should return calls within date range", async () => {
-      const clientId = "dateRangeClient";
-      const startDate = new Date("2023-05-01");
-      const endDate = new Date("2023-05-31");
-
-      const callInside = createOutGoingCallDoc({ clientId });
-      const callBefore = createOutGoingCallDoc({ clientId });
-      const callAfter = createOutGoingCallDoc({ clientId });
-
-      await getCallsCollection().insertOne({
-        ...callInside,
-        createdAt: new Date("2023-05-15"),
-        updatedAt: new Date(),
-        env: "test",
-      });
-      await getCallsCollection().insertOne({
-        ...callBefore,
-        createdAt: new Date("2023-04-30"),
-        updatedAt: new Date(),
-        env: "test",
-      });
-      await getCallsCollection().insertOne({
-        ...callAfter,
-        createdAt: new Date("2023-06-01"),
-        updatedAt: new Date(),
-        env: "test",
-      });
-
-      const result = await getCallsByClientAndDateRange(
-        clientId,
-        startDate,
-        endDate,
-      );
-      expect(result.length).toBe(1);
-      expect(result[0].callSid).toBe(callInside.callSid);
-    });
-  });
-});
+import {
+  createCallDoc,
+  getCallsByFlow,
+  getCallsByClient,
+  getCallsByPhoneNumber,
+  getCallByCallSid,
+  findCallsByQuery,
+  countCalls,
+  getCallsByClientAndDateRange,
+  getCallsCollection,
+  pushToolExecution,
+  getToolExecutionsByCallSid,
+  updateCallStatusByCallSid,
+  setCallEndedBy,
+} from "../calls.getters";
+import type { ToolExecution, ToolExecutionStep } from "../calls.types";
+import { ObjectId } from "mongodb";
+import { createOutGoingCallDoc } from "../../../test-utils/factories";
+
+describe("db.calls", () => {
+  it("should return calls by flow", async () => {
+    const flowId = new ObjectId();
+    const call1 = createOutGoingCallDoc({ flowId });
+    const call2 = createOutGoingCallDoc({ flowId });
+
+    await createCallDoc(call1);
+    await createCallDoc(call2);
+
+    const result = await getCallsByFlow(flowId);
+
+    expect(result.length).toBe(2);
+    expect(result).toMatchObject([
+      { callSid: call1.callSid },
+      { callSid: call2.callSid },
+    ]);
+  });
+
+  it("should get call by callSid", async () => {
+    const call = createOutGoingCallDoc();
+    await createCallDoc(call);
+
+    const result = await getCallByCallSid(call.callSid);
+
+    expect(result).toBeDefined();
+    expect(result?.callSid).toBe(call.callSid);
+  });
+
+  it("should get calls by client", async () => {
+    const call = createOutGoingCallDoc();
+    await createCallDoc(call);
+
+    const result = await getCallsByClient(call.clientId);
+
+    expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
+  });
+
+  it("should get calls by phone number", async () => {
+    const call = createOutGoingCallDoc();
+    await createCallDoc(call);
+
+    const result = await getCallsByPhoneNumber(call.customerPhoneNumber);
+
+    expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
+  });
+
+  it("should set current status only via updateCallStatusByCallSid", async () => {
+    const call = createOutGoingCallDoc({ status: "ringing" });
+    await createCallDoc(call);
+
+    const updated = await updateCallStatusByCallSid(call.callSid, "in-progress");
+
+    expect(updated?.status).toBe("in-progress");
+    expect(await getCallByCallSid(call.callSid)).toMatchObject({
+      status: "in-progress",
+    });
+  });
+
+  describe("setCallEndedBy()", () => {
+    it("should set endedBy when it is not set yet", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+
+      const written = await setCallEndedBy(call.callSid, "user");
+
+      expect(written).toBe(true);
+      expect(await getCallByCallSid(call.callSid)).toMatchObject({
+        endedBy: "user",
+      });
+    });
+
+    it("should keep the first value when called again", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+
+      await setCallEndedBy(call.callSid, "user");
+      const written = await setCallEndedBy(call.callSid, "agent");
+
+      expect(written).toBe(false);
+      expect(await getCallByCallSid(call.callSid)).toMatchObject({
+        endedBy: "user",
+      });
+    });
+
+    it("should let only one of two concurrent writers win", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+
+      const results = await Promise.all([
+        setCallEndedBy(call.callSid, "user"),
+        setCallEndedBy(call.callSid, "system"),
+      ]);
+
+      expect(results.filter(Boolean)).toHaveLength(1);
+      const stored = await getCallByCallSid(call.callSid);
+      expect(stored?.endedBy).toBe(results[0] ? "user" : "system");
+    });
+
+    it("should return false when the call does not exist", async () => {
+      await expect(setCallEndedBy("nonexistent-sid", "system")).resolves.toBe(
+        false,
+      );
+    });
+  });
+
+  describe("findCallsByQuery()", () => {
+    it("should find calls by status with limit and sort", async () => {
+      const clientId = "client123";
+      const call1 = createOutGoingCallDoc({ clientId, status: "completed" });
+      const call2 = createOutGoingCallDoc({ clientId, status: "completed" });
+      const call3 = createOutGoingCallDoc({ clientId, status: "busy" });
+
+      // We need to control createdAt to test sort. We'll insert directly.
+      await getCallsCollection().insertOne({
+        ...call1,
+        createdAt: new Date("2023-01-01"),
+        updatedAt: new Date(),
+        env: "test",
+      });
+      await getCallsCollection().insertOne({
+        ...call2,
+        createdAt: new Date("2023-01-02"),
+        updatedAt: new Date(),
+        env: "test",
+      });
+      await getCallsCollection().insertOne({
+        ...call3,
+        createdAt: new Date(),
+        updatedAt: new Date(),
+        env: "test",
+      });
+
+      const result = await findCallsByQuery(
+        { clientId, status: "completed" },
+        { sort: { createdAt: -1 }, limit: 1 },
+      );
+
+      expect(result.length).toBe(1);
+      expect(result[0].callSid).toBe(call2.callSid);
+    });
+  });
+
+  describe("countCalls()", () => {
+    it("should count calls matching query", async () => {
+      const clientId = "countClient";
+      await createCallDoc(
+        createOutGoingCallDoc({ clientId, status: "completed" }),
+      );
+      await createCallDoc(
+        createOutGoingCallDoc({ clientId, status: "completed" }),
+      );
+      await createCallDoc(
+        createOutGoingCallDoc({ clientId, status: "failed" }),
+      );
+
+      const count = await countCalls({ clientId, status: "completed" });
+      expect(count).toBe(2);
+    });
+  });
+
+  describe("pushToolExecution()", () => {
+    let callSid: string;
+
+    beforeEach(async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+      callSid = call.callSid;
+    });
+
+    const makeHttpExecution = (
+      overrides?: Partial<ToolExecution>,
+    ): ToolExecution => ({
+      toolName: "sendSms",
+      executedAt: new Date(),
+      durationMs: 120,
+      args: { to: "+1234567890", message: "hello" },
+      meta: {
+        kind: "http",
+        url: "https://api.example.com/sms",
+        method: "POST",
+      },
+      status: "success",
+      httpStatus: 200,
+      ...overrides,
+    });
+
+    it("should append an execution to a call with none", async () => {
+      const execution = makeHttpExecution();
+      await pushToolExecution(callSid, execution);
+
+      const result = await getCallByCallSid(callSid);
+      expect(result?.toolExecutions).toHaveLength(1);
+      expect(result?.toolExecutions?.[0]).toMatchObject({
+        toolName: "sendSms",
+        status: "success",
+        httpStatus: 200,
+      });
+    });
+
+    it("should maintain insertion order across multiple pushes", async () => {
+      const first = makeHttpExecution({ toolName: "first" });
+      const second = makeHttpExecution({ toolName: "second" });
+      const third = makeHttpExecution({ toolName: "third" });
+
+      await pushToolExecution(callSid, first);
+      await pushToolExecution(callSid, second);
+      await pushToolExecution(callSid, third);
+
+      const result = await getCallByCallSid(callSid);
+      expect(result?.toolExecutions?.map((e) => e.toolName)).toEqual([
+        "first",
+        "second",
+        "third",
+      ]);
+    });
+
+    it("should store an internal tool execution", async () => {
+      const execution: ToolExecution = {
+        toolName: "endFlow",
+        executedAt: new Date(),
+        durationMs: 5,
+        args: {},
+        meta: { kind: "internal" },
+        status: "success",
+      };
+
+      await pushToolExecution(callSid, execution);
+
+      const result = await getCallByCallSid(callSid);
+      expect(result?.toolExecutions?.[0]).toMatchObject({
+        toolName: "endFlow",
+        meta: { kind: "internal" },
+      });
+    });
+
+    it("should store redacted args for sensitive tools", async () => {
+      const execution = makeHttpExecution({ args: { _redacted: true } });
+      await pushToolExecution(callSid, execution);
+
+      const result = await getCallByCallSid(callSid);
+      expect(result?.toolExecutions?.[0].args).toEqual({ _redacted: true });
+    });
+
+    it("should store an error execution", async () => {
+      const execution = makeHttpExecution({ status: "error", httpStatus: 500 });
+      await pushToolExecution(callSid, execution);
+
+      const result = await getCallByCallSid(callSid);
+      expect(result?.toolExecutions?.[0]).toMatchObject({
+        status: "error",
+        httpStatus: 500,
+      });
+    });
+
+    it("should be a no-op for an unknown callSid", async () => {
+      await expect(
+        pushToolExecution("nonexistent-sid", makeHttpExecution()),
+      ).resolves.not.toThrow();
+    });
+
+    it("should store the response body", async () => {
+      const execution = makeHttpExecution({
+        response: { userId: "123", status: "sent" },
+      });
+      await pushToolExecution(callSid, execution);
+
+      const result = await getCallByCallSid(callSid);
+      expect(result?.toolExecutions?.[0].response).toEqual({
+        userId: "123",
+        status: "sent",
+      });
+    });
+  });
+
+  describe("getToolExecutionsByCallSid()", () => {
+    const makeExecution = (
+      overrides?: Partial<ToolExecution>,
+    ): ToolExecution => ({
+      toolName: "testTool",
+      executedAt: new Date(),
+      durationMs: 100,
+      args: { query: "test" },
+      meta: { kind: "http", url: "https://example.com", method: "POST" },
+      status: "success",
+      httpStatus: 200,
+      ...overrides,
+    });
+
+    it("returns all executions for a call", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+      await pushToolExecution(call.callSid, makeExecution({ toolName: "first" }));
+      await pushToolExecution(call.callSid, makeExecution({ toolName: "second" }));
+
+      const result = await getToolExecutionsByCallSid(call.callSid);
+
+      expect(result).toHaveLength(2);
+      expect(result.map((e) => e.toolName)).toEqual(["first", "second"]);
+    });
+
+    it("returns an empty array when the call has no executions", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+
+      const result = await getToolExecutionsByCallSid(call.callSid);
+
+      expect(result).toEqual([]);
+    });
+
+    it("returns an empty array for an unknown callSid", async () => {
+      const result = await getToolExecutionsByCallSid("nonexistent-sid");
+
+      expect(result).toEqual([]);
+    });
+
+    it("respects skip and limit for pagination", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+      for (const name of ["a", "b", "c", "d", "e"]) {
+        await pushToolExecution(call.callSid, makeExecution({ toolName: name }));
+      }
+
+      const page1 = await getToolExecutionsByCallSid(call.callSid, { skip: 0, limit: 2 });
+      const page2 = await getToolExecutionsByCallSid(call.callSid, { skip: 2, limit: 2 });
+      const page3 = await getToolExecutionsByCallSid(call.callSid, { skip: 4, limit: 2 });
+
+      expect(page1.map((e) => e.toolName)).toEqual(["a", "b"]);
+      expect(page2.map((e) => e.toolName)).toEqual(["c", "d"]);
+      expect(page3.map((e) => e.toolName)).toEqual(["e"]);
+    });
+
+    it("includes steps when present", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+      const steps: ToolExecutionStep[] = [
+        { timestamp: new Date("2024-01-01T10:00:00Z"), label: "audio_enrichment", level: "info", data: { audioUsed: true } },
+        { timestamp: new Date("2024-01-01T10:00:01Z"), label: "subject_classification", level: "warn" },
+      ];
+      await pushToolExecution(call.callSid, makeExecution({ steps }));
+
+      const result = await getToolExecutionsByCallSid(call.callSid);
+
+      expect(result[0].steps).toHaveLength(2);
+      const s0 = result[0].steps![0];
+      expect(s0.label).toBe("audio_enrichment");
+      expect(s0.level).toBe("info");
+      expect(new Date(s0.timestamp).toISOString()).toBe("2024-01-01T10:00:00.000Z");
+      expect(s0.data).toEqual({ audioUsed: true });
+      const s1 = result[0].steps![1];
+      expect(s1.label).toBe("subject_classification");
+      expect(s1.level).toBe("warn");
+      expect(s1.data).toBeUndefined();
+    });
+
+    it("includes step payload when present", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+      const steps: ToolExecutionStep[] = [
+        {
+          timestamp: new Date("2024-01-01T10:00:00Z"),
+          label: "subject_classification",
+          level: "info",
+          data: "Classified as: ניקיון / אשפה",
+          payload: { subject: "ניקיון", subSubject: "אשפה", ids: { subject: "abc", subSubject: "def" } },
+        },
+      ];
+      await pushToolExecution(call.callSid, makeExecution({ steps }));
+
+      const result = await getToolExecutionsByCallSid(call.callSid);
+
+      const s0 = result[0].steps![0];
+      expect(s0.data).toBe("Classified as: ניקיון / אשפה");
+      expect(s0.payload).toEqual({ subject: "ניקיון", subSubject: "אשפה", ids: { subject: "abc", subSubject: "def" } });
+    });
+
+    it("does not require step payload to be present", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+      const steps: ToolExecutionStep[] = [
+        { timestamp: new Date(), label: "user_query", level: "info", data: "Query: הרצל" },
+      ];
+      await pushToolExecution(call.callSid, makeExecution({ steps }));
+
+      const result = await getToolExecutionsByCallSid(call.callSid);
+
+      expect(result[0].steps![0].payload).toBeUndefined();
+    });
+
+    it("does not require steps to be present", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+      await pushToolExecution(call.callSid, makeExecution());
+
+      const result = await getToolExecutionsByCallSid(call.callSid);
+
+      expect(result[0].steps).toBeUndefined();
+    });
+
+    it("returns at most 50 executions by default", async () => {
+      const call = createOutGoingCallDoc();
+      await getCallsCollection().insertOne({
+        ...call,
+        createdAt: new Date(),
+        updatedAt: new Date(),
+        env: "test",
+        toolExecutions: Array.from({ length: 51 }, (_, i) =>
+          makeExecution({ toolName: `tool${i}` }),
+        ),
+      });
+
+      const result = await getToolExecutionsByCallSid(call.callSid);
+
+      expect(result).toHaveLength(50);
+      expect(result[0].toolName).toBe("tool0");
+      expect(result[49].toolName).toBe("tool49");
+    });
+
+    it("clamps negative skip to 0", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+      await pushToolExecution(call.callSid, makeExecution({ toolName: "only" }));
+
+      const result = await getToolExecutionsByCallSid(call.callSid, { skip: -5 });
+
+      expect(result).toHaveLength(1);
+      expect(result[0].toolName).toBe("only");
+    });
+
+    it("clamps negative limit to 1", async () => {
+      const call = createOutGoingCallDoc();
+      await createCallDoc(call);
+      await pushToolExecution(call.callSid, makeExecution({ toolName: "first" }));
+      await pushToolExecution(call.callSid, makeExecution({ toolName: "second" }));
+
+      const result = await getToolExecutionsByCallSid(call.callSid, { limit: -1 });
+
+      expect(result).toHaveLength(1);
+    });
+
+    it("returns executions when clientId matches the call's client", async () => {
+      const call = createOutGoingCallDoc({ clientId: "clientA" });
+      await createCallDoc(call);
+      await pushToolExecution(call.callSid, makeExecution({ toolName: "secret" }));
+
+      const result = await getToolExecutionsByCallSid(call.callSid, { clientId: "clientA" });
+
+      expect(result).toHaveLength(1);
+      expect(result[0].toolName).toBe("secret");
+    });
+
+    it("returns empty when clientId does not match the call's client", async () => {
+      const call = createOutGoingCallDoc({ clientId: "clientA" });
+      await createCallDoc(call);
+      await pushToolExecution(call.callSid, makeExecution({ toolName: "secret" }));
+
+      const result = await getToolExecutionsByCallSid(call.callSid, { clientId: "clientB" });
+
+      expect(result).toEqual([]);
+    });
+  });
+
+  describe("getCallsByClientAndDateRange()", () => {
+    it("should return calls within date range", async () => {
+      const clientId = "dateRangeClient";
+      const startDate = new Date("2023-05-01");
+      const endDate = new Date("2023-05-31");
+
+      const callInside = createOutGoingCallDoc({ clientId });
+      const callBefore = createOutGoingCallDoc({ clientId });
+      const callAfter = createOutGoingCallDoc({ clientId });
+
+      await getCallsCollection().insertOne({
+        ...callInside,
+        createdAt: new Date("2023-05-15"),
+        updatedAt: new Date(),
+        env: "test",
+      });
+      await getCallsCollection().insertOne({
+        ...callBefore,
+        createdAt: new Date("2023-04-30"),
+        updatedAt: new Date(),
+        env: "test",
+      });
+      await getCallsCollection().insertOne({
+        ...callAfter,
+        createdAt: new Date("2023-06-01"),
+        updatedAt: new Date(),
+        env: "test",
+      });
+
+      const result = await getCallsByClientAndDateRange(
+        clientId,
+        startDate,
+        endDate,
+      );
+      expect(result.length).toBe(1);
+      expect(result[0].callSid).toBe(callInside.callSid);
+    });
+  });
+});

package/src/talkpilot/calls/calls.constants.ts

@@ -47,3 +47,10 @@ export const CallStatusValues = {
 } as const;
 
 export const ALL_CALL_STATUSES = Object.values(CallStatusValues);
+
+/** Who ended a connected call: our platform, the bot (end flow), or the caller. */
+export const CallEndedByValues = {
+  System: "system",
+  Agent: "agent",
+  User: "user",
+} as const;

package/src/talkpilot/calls/calls.types.ts

@@ -3,6 +3,7 @@ import { TranscriptionSegment } from "../results";
 import { LeadProperty } from "../leads";
 
 import {
+  CallEndedByValues,
   CallStatusValues,
   CONFERENCE_ROLE_CUSTOMER,
   CONFERENCE_ROLE_SUPERVISOR,
@@ -15,7 +16,7 @@ export type ConferenceRole =
 
 export type CallStatus = (typeof CallStatusValues)[keyof typeof CallStatusValues];
 
-export type CallEndedBy = "system" | "resident";
+export type CallEndedBy = (typeof CallEndedByValues)[keyof typeof CallEndedByValues];
 
 export type Call = {
   callSid: string;