@talkpilot/core-db 1.3.81 → 1.3.82

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.81",
+  "version": "1.3.82",
   "description": "Core database package for centralized connections and ORM integration.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/municipal/muniIssues/__tests__/muniIssues.getters.spec.ts

@@ -0,0 +1,66 @@
+import { ObjectId } from "mongodb";
+import { createMuniIssue, setMuniIssueResponse } from "../muniIssues.setters";
+import {
+  countMuniIssuesByClient,
+  findMuniIssuesByClient,
+  generateMuniIssueId,
+  getMuniIssueByIdForClient,
+  getMuniIssuesCollection,
+} from "../muniIssues.getters";
+import { createMuniIssueInput } from "../../../test-utils/factories";
+
+const CLIENT = "client-a";
+
+const createIssue = async (clientId = CLIENT) =>
+  (await createMuniIssue(createMuniIssueInput({ clientId }), generateMuniIssueId())).toString();
+
+describe("muniIssues getters (complaint tracking)", () => {
+  describe("findMuniIssuesByClient / countMuniIssuesByClient", () => {
+    it("should return only the client's tracked issues, newest first", async () => {
+      const older = await createIssue();
+      const newer = await createIssue();
+      // Both can land in the same millisecond; make the order explicit.
+      await getMuniIssuesCollection().updateOne(
+        { _id: new ObjectId(older) },
+        { $set: { createdAt: new Date(Date.now() - 60_000) } },
+      );
+      await createIssue("client-b");
+      // An issue created before complaint tracking has no status.
+      await getMuniIssuesCollection().insertOne({
+        ...createMuniIssueInput({ clientId: CLIENT }),
+        _id: generateMuniIssueId(),
+        jira: { key: "CP-legacy", syncStatus: "created" },
+        createdAt: new Date(),
+      });
+
+      const issues = await findMuniIssuesByClient(CLIENT);
+
+      expect(issues.map((i) => i._id.toString())).toEqual([newer, older]);
+      expect(await countMuniIssuesByClient(CLIENT)).toBe(2);
+    });
+
+    it("should filter by answered and apply skip/limit", async () => {
+      const answered = await createIssue();
+      await createIssue();
+      await createIssue();
+      await setMuniIssueResponse(answered, CLIENT, { status: "resolved", text: "Done" });
+
+      expect(await countMuniIssuesByClient(CLIENT, { answered: true })).toBe(1);
+      expect(await countMuniIssuesByClient(CLIENT, { answered: false })).toBe(2);
+      expect(
+        (await findMuniIssuesByClient(CLIENT, { answered: true }))[0]._id.toString(),
+      ).toBe(answered);
+      expect(await findMuniIssuesByClient(CLIENT, { skip: 1, limit: 1 })).toHaveLength(1);
+    });
+  });
+
+  describe("getMuniIssueByIdForClient", () => {
+    it("should return the issue only for its own client", async () => {
+      const id = await createIssue();
+
+      expect((await getMuniIssueByIdForClient(id, CLIENT))?._id.toString()).toBe(id);
+      expect(await getMuniIssueByIdForClient(id, "client-b")).toBeNull();
+      expect(await getMuniIssueByIdForClient("not-a-valid-id", CLIENT)).toBeNull();
+    });
+  });
+});

package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts

@@ -1,4 +1,8 @@
-import { createMuniIssue } from "../muniIssues.setters";
+import {
+  createMuniIssue,
+  setMuniIssueResponse,
+  updateMuniIssueStatus,
+} from "../muniIssues.setters";
 import {
   generateMuniIssueId,
   getMuniIssueById,
@@ -25,6 +29,18 @@ describe("muniIssues setters", () => {
       expect(saved?.createdAt).toBeInstanceOf(Date);
     });
 
+    it("should start the issue as in_review with updatedAt and no response", async () => {
+      const insertedId = await createMuniIssue(
+        createMuniIssueInput(),
+        generateMuniIssueId(),
+      );
+
+      const saved = await getMuniIssueById(insertedId.toString());
+      expect(saved?.status).toBe("in_review");
+      expect(saved?.updatedAt).toBeInstanceOf(Date);
+      expect(saved?.response).toBeUndefined();
+    });
+
     it("should default jira.syncStatus to created when not provided", async () => {
       const id = generateMuniIssueId();
 
@@ -91,4 +107,93 @@ describe("muniIssues setters", () => {
       expect(await getMuniIssueByJiraKey("CP-nope")).toBeNull();
     });
   });
+
+  describe("updateMuniIssueStatus", () => {
+    it("should change the status of an unanswered issue", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+
+      expect(await updateMuniIssueStatus(id, input.clientId, "in_progress")).toBe(true);
+      expect((await getMuniIssueById(id))?.status).toBe("in_progress");
+    });
+
+    it("should not touch another client's issue or a malformed id", async () => {
+      const id = (
+        await createMuniIssue(createMuniIssueInput(), generateMuniIssueId())
+      ).toString();
+
+      expect(await updateMuniIssueStatus(id, "other-client", "resolved")).toBe(false);
+      expect(await updateMuniIssueStatus("not-a-valid-id", "any", "resolved")).toBe(false);
+      expect((await getMuniIssueById(id))?.status).toBe("in_review");
+    });
+  });
+
+  describe("setMuniIssueResponse", () => {
+    it("should save the response and status", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+
+      const saved = await setMuniIssueResponse(id, input.clientId, {
+        status: "resolved",
+        text: "Fixed",
+        imageUrls: ["https://example.com/a.png", "https://example.com/b.png"],
+      });
+
+      expect(saved).toBe(true);
+      const issue = await getMuniIssueById(id);
+      expect(issue?.status).toBe("resolved");
+      expect(issue?.response).toMatchObject({
+        text: "Fixed",
+        imageUrls: ["https://example.com/a.png", "https://example.com/b.png"],
+      });
+      expect(issue?.response?.createdAt).toBeInstanceOf(Date);
+      expect(issue?.response?.updatedAt).toBeUndefined();
+    });
+
+    it("should let an answered issue be edited, keeping the first-sent date", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+      await setMuniIssueResponse(id, input.clientId, {
+        status: "in_review",
+        text: "First",
+        imageUrls: ["https://example.com/a.png"],
+      });
+      const firstSentAt = (await getMuniIssueById(id))?.response?.createdAt;
+
+      expect(
+        await setMuniIssueResponse(id, input.clientId, { status: "resolved", text: "Second" }),
+      ).toBe(true);
+      expect(await updateMuniIssueStatus(id, input.clientId, "no_issue_found")).toBe(true);
+
+      const issue = await getMuniIssueById(id);
+      expect(issue?.status).toBe("no_issue_found");
+      expect(issue?.response?.text).toBe("Second");
+      expect(issue?.response?.imageUrls).toEqual([]);
+      expect(issue?.response?.createdAt).toEqual(firstSentAt);
+      expect(issue?.response?.updatedAt).toBeInstanceOf(Date);
+    });
+
+    it("should store text starting with $ as plain text", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+
+      await setMuniIssueResponse(id, input.clientId, { status: "resolved", text: "$status" });
+
+      expect((await getMuniIssueById(id))?.response?.text).toBe("$status");
+    });
+
+    it("should not touch another client's issue or a malformed id", async () => {
+      const id = (
+        await createMuniIssue(createMuniIssueInput(), generateMuniIssueId())
+      ).toString();
+
+      expect(
+        await setMuniIssueResponse(id, "other-client", { status: "resolved", text: "X" }),
+      ).toBe(false);
+      expect(
+        await setMuniIssueResponse("not-a-valid-id", "any", { status: "resolved", text: "X" }),
+      ).toBe(false);
+      expect((await getMuniIssueById(id))?.response).toBeUndefined();
+    });
+  });
 });

package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts

@@ -28,6 +28,7 @@ describe("muniIssues setup", () => {
         expect.arrayContaining([
           "callSid_1",
           "createdAt_-1",
+          "clientId_1_createdAt_-1",
           "jira_key_unique",
         ]),
       );

package/src/municipal/muniIssues/index.ts

@@ -3,6 +3,8 @@ export * from "./muniIssues.setters";
 export * from "./muniIssues.setup";
 export {
   MUNI_ISSUES_COLLECTION,
+  MUNI_ISSUE_MAX_RESPONSE_IMAGES,
+  MUNI_ISSUE_STATUSES,
   MUNI_ISSUE_SYNC_STATUSES,
   MUNI_ISSUE_TEXT_MAX_LENGTH,
   MUNI_ISSUE_NAME_MAX_LENGTH,
@@ -13,5 +15,9 @@ export type {
   MuniIssueContent,
   MuniIssueJira,
   MuniIssueSyncStatus,
+  MuniIssueStatus,
+  MuniIssueResponse,
   CreateMuniIssueInput,
+  SetMuniIssueResponseInput,
+  FindMuniIssuesOptions,
 } from "./muniIssues.types";

package/src/municipal/muniIssues/muniIssues.constants.ts

@@ -4,6 +4,17 @@ export const MUNI_ISSUES_COLLECTION = "muniIssues";
 /** Sync state of the issue's Jira ticket at write time. */
 export const MUNI_ISSUE_SYNC_STATUSES = ["created", "failed"] as const;
 
+/** Customer-facing complaint status, set manually by the TalkPilot team. */
+export const MUNI_ISSUE_STATUSES = [
+  "in_review",
+  "in_progress",
+  "resolved",
+  "no_issue_found",
+] as const;
+
+/** Max images on a single TalkPilot response. */
+export const MUNI_ISSUE_MAX_RESPONSE_IMAGES = 5;
+
 /** Max length for the long free-text fields — well above the ~2000-char target. */
 export const MUNI_ISSUE_TEXT_MAX_LENGTH = 5000;
 

package/src/municipal/muniIssues/muniIssues.getters.ts

@@ -1,6 +1,6 @@
-import { Collection, ObjectId } from "mongodb";
+import { Collection, Filter, ObjectId } from "mongodb";
 import { getDb } from "../index";
-import { MuniIssue } from "./muniIssues.types";
+import { FindMuniIssuesOptions, MuniIssue } from "./muniIssues.types";
 import { MUNI_ISSUES_COLLECTION } from "./muniIssues.constants";
 
 export const getMuniIssuesCollection = (): Collection<MuniIssue> => {
@@ -22,3 +22,47 @@ export const getMuniIssueByJiraKey = async (
 ): Promise<MuniIssue | null> => {
   return getMuniIssuesCollection().findOne({ "jira.key": jiraKey });
 };
+
+// Tracked issues of one client. Issues without a status predate complaint tracking and are excluded.
+const clientIssuesFilter = (
+  clientId: string,
+  answered?: boolean,
+): Filter<MuniIssue> => ({
+  clientId,
+  status: { $exists: true },
+  ...(answered !== undefined && { response: { $exists: answered } }),
+});
+
+/** A client's tracked issues, newest first. `limit` 0 means no limit (Mongo). */
+export const findMuniIssuesByClient = async (
+  clientId: string,
+  { answered, skip = 0, limit = 0 }: FindMuniIssuesOptions = {},
+): Promise<MuniIssue[]> => {
+  return getMuniIssuesCollection()
+    .find(clientIssuesFilter(clientId, answered))
+    .sort({ createdAt: -1 })
+    .skip(skip)
+    .limit(limit)
+    .toArray();
+};
+
+export const countMuniIssuesByClient = async (
+  clientId: string,
+  { answered }: Pick<FindMuniIssuesOptions, "answered"> = {},
+): Promise<number> => {
+  return getMuniIssuesCollection().countDocuments(
+    clientIssuesFilter(clientId, answered),
+  );
+};
+
+/** One tracked issue, only if it belongs to the client. */
+export const getMuniIssueByIdForClient = async (
+  id: string,
+  clientId: string,
+): Promise<MuniIssue | null> => {
+  if (!ObjectId.isValid(id)) return null;
+  return getMuniIssuesCollection().findOne({
+    ...clientIssuesFilter(clientId),
+    _id: new ObjectId(id),
+  });
+};

package/src/municipal/muniIssues/muniIssues.schema.ts

@@ -1,5 +1,7 @@
 import type { Document, IndexDescription } from "mongodb";
 import {
+  MUNI_ISSUE_MAX_RESPONSE_IMAGES,
+  MUNI_ISSUE_STATUSES,
   MUNI_ISSUE_SYNC_STATUSES,
   MUNI_ISSUE_TEXT_MAX_LENGTH,
   MUNI_ISSUE_NAME_MAX_LENGTH,
@@ -55,12 +57,30 @@ export const muniIssuesJsonSchema: Document = {
       },
     },
     createdAt: { bsonType: "date" },
+    status: { enum: [...MUNI_ISSUE_STATUSES] },
+    response: {
+      bsonType: "object",
+      required: ["text", "createdAt"],
+      properties: {
+        text: { bsonType: "string", maxLength: MUNI_ISSUE_TEXT_MAX_LENGTH },
+        imageUrls: {
+          bsonType: "array",
+          maxItems: MUNI_ISSUE_MAX_RESPONSE_IMAGES,
+          items: { bsonType: "string" },
+        },
+        createdAt: { bsonType: "date" },
+        updatedAt: { bsonType: "date" },
+      },
+    },
+    updatedAt: { bsonType: "date" },
   },
 };
 
 export const muniIssuesIndexes: IndexDescription[] = [
   { key: { callSid: 1 }, name: "callSid_1" },
   { key: { createdAt: -1 }, name: "createdAt_-1" },
+  // Complaint list: one municipality's issues, newest first.
+  { key: { clientId: 1, createdAt: -1 }, name: "clientId_1_createdAt_-1" },
   // Unique: one stored document per Jira ticket, guarding against duplicate writes.
   { key: { "jira.key": 1 }, name: "jira_key_unique", unique: true },
 ];

package/src/municipal/muniIssues/muniIssues.setters.ts

@@ -1,5 +1,10 @@
-import { ObjectId } from "mongodb";
-import { CreateMuniIssueInput, MuniIssue } from "./muniIssues.types";
+import { Filter, ObjectId } from "mongodb";
+import {
+  CreateMuniIssueInput,
+  MuniIssue,
+  MuniIssueStatus,
+  SetMuniIssueResponseInput,
+} from "./muniIssues.types";
 import { getMuniIssuesCollection } from "./muniIssues.getters";
 import { ensureMuniIssuesCollectionOnce } from "./muniIssues.setup";
 
@@ -10,6 +15,7 @@ export const createMuniIssue = async (
 ): Promise<ObjectId> => {
   await ensureMuniIssuesCollectionOnce();
 
+  const now = new Date();
   const issue: MuniIssue = {
     _id: id,
     ...issueData,
@@ -17,8 +23,71 @@ export const createMuniIssue = async (
       ...issueData.jira,
       syncStatus: issueData.jira.syncStatus ?? "created",
     },
-    createdAt: new Date(),
+    status: "in_review",
+    createdAt: now,
+    updatedAt: now,
   };
   const { insertedId } = await getMuniIssuesCollection().insertOne(issue);
   return insertedId;
 };
+
+// An issue of this client that is tracked (has a status); answered issues stay editable.
+const trackedIssueFilter = (id: string, clientId: string): Filter<MuniIssue> => ({
+  _id: new ObjectId(id),
+  clientId,
+  status: { $exists: true },
+});
+
+/** Changes the status of an issue, answered or not. Returns false if none matched. */
+export const updateMuniIssueStatus = async (
+  id: string,
+  clientId: string,
+  status: MuniIssueStatus,
+): Promise<boolean> => {
+  if (!ObjectId.isValid(id)) return false;
+  await ensureMuniIssuesCollectionOnce();
+
+  const { matchedCount } = await getMuniIssuesCollection().updateOne(
+    trackedIssueFilter(id, clientId),
+    { $set: { status, updatedAt: new Date() } },
+  );
+  return matchedCount > 0;
+};
+
+/**
+ * Saves the TalkPilot response, or replaces an existing one (text and images).
+ * Keeps the original `response.createdAt` and sets `response.updatedAt` on an edit.
+ * Returns false if none matched.
+ */
+export const setMuniIssueResponse = async (
+  id: string,
+  clientId: string,
+  { status, text, imageUrls }: SetMuniIssueResponseInput,
+): Promise<boolean> => {
+  if (!ObjectId.isValid(id)) return false;
+  await ensureMuniIssuesCollectionOnce();
+
+  const now = new Date();
+  // Pipeline update, so the first-sent date can be read from the stored response.
+  // $literal: user text starting with "$" must not be read as a field path.
+  const { matchedCount } = await getMuniIssuesCollection().updateOne(
+    trackedIssueFilter(id, clientId),
+    [
+      {
+        $set: {
+          status: { $literal: status },
+          updatedAt: now,
+          response: {
+            text: { $literal: text },
+            imageUrls: { $literal: imageUrls ?? [] },
+            createdAt: { $ifNull: ["$response.createdAt", now] },
+            updatedAt: {
+              $cond: [{ $ifNull: ["$response.createdAt", false] }, now, "$$REMOVE"],
+            },
+          },
+        },
+      },
+    ],
+  );
+  return matchedCount > 0;
+};

package/src/municipal/muniIssues/muniIssues.types.ts

@@ -1,10 +1,23 @@
 import { ObjectId } from "mongodb";
 
 import { CityName } from "../utils/types";
-import { MUNI_ISSUE_SYNC_STATUSES } from "./muniIssues.constants";
+import {
+  MUNI_ISSUE_STATUSES,
+  MUNI_ISSUE_SYNC_STATUSES,
+} from "./muniIssues.constants";
 
 export type MuniIssueSyncStatus = (typeof MUNI_ISSUE_SYNC_STATUSES)[number];
 
+export type MuniIssueStatus = (typeof MUNI_ISSUE_STATUSES)[number];
+
+/** The TalkPilot response. Editable: `createdAt` is when it was first sent, `updatedAt` the last edit. */
+export type MuniIssueResponse = {
+  text: string;
+  imageUrls?: string[];
+  createdAt: Date;
+  updatedAt?: Date;
+};
+
 export type MuniIssueContent = {
   issuerName: string;
   issuerRole: string;
@@ -25,13 +38,32 @@ export type MuniIssue = {
   issueContent: MuniIssueContent;
   jira: MuniIssueJira;
   createdAt: Date;
+  // Complaint tracking (CP-1888). Optional: issues created before it have none
+  // of these, which is how they are kept out of tracking.
+  status?: MuniIssueStatus;
+  response?: MuniIssueResponse;
+  updatedAt?: Date;
 };
 
-// _id/createdAt are set on insert; jira.syncStatus defaults to "created"
-// because the issue is only stored after its Jira ticket exists (CP-1115).
+// _id/createdAt/status/updatedAt are set on insert, response only later (setMuniIssueResponse);
+// jira.syncStatus defaults to "created" because the issue is only stored after its Jira
+// ticket exists (CP-1115).
 export type CreateMuniIssueInput = Omit<
   MuniIssue,
-  "_id" | "createdAt" | "jira"
+  "_id" | "createdAt" | "jira" | "status" | "response" | "updatedAt"
 > & {
   jira: { key: string; syncStatus?: MuniIssueSyncStatus };
 };
+
+export type SetMuniIssueResponseInput = {
+  status: MuniIssueStatus;
+  text: string;
+  imageUrls?: string[];
+};
+
+/** `answered` filters by whether a TalkPilot response exists; omit it for all issues. */
+export type FindMuniIssuesOptions = {
+  answered?: boolean;
+  skip?: number;
+  limit?: number;
+};

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

@@ -11,7 +11,6 @@ import {
   pushToolExecution,
   getToolExecutionsByCallSid,
   updateCallStatusByCallSid,
-  setCallEndedBy,
 } from "../calls.getters";
 import type { ToolExecution, ToolExecutionStep } from "../calls.types";
 import { ObjectId } from "mongodb";
@@ -75,53 +74,6 @@ describe("db.calls", () => {
     });
   });
 
-  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, "humanAgent"),
-      ]);
-
-      expect(results.filter(Boolean)).toHaveLength(1);
-      const stored = await getCallByCallSid(call.callSid);
-      expect(stored?.endedBy).toBe(results[0] ? "user" : "humanAgent");
-    });
-
-    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";

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

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

package/src/talkpilot/calls/calls.getters.ts

@@ -5,13 +5,7 @@ import {
   CallUpdateParams,
   getDb,
 } from "../index";
-import type {
-  CountOpts,
-  DateRange,
-  ToolExecution,
-  CallStatus,
-  CallEndedBy,
-} from "./calls.types";
+import type { CountOpts, DateRange, ToolExecution, CallStatus } from "./calls.types";
 import {
   TOOL_EXECUTIONS_DEFAULT_LIMIT,
   TOOL_EXECUTIONS_DEFAULT_SKIP,
@@ -95,18 +89,6 @@ export const updateCallStatusByCallSid = async (
     { returnDocument: "after" },
   );
 
-
-export const setCallEndedBy = async (
-  callSid: string,
-  endedBy: CallEndedBy,
-): Promise<boolean> => {
-  const result = await getCallsCollection().updateOne(
-    { callSid, endedBy: { $exists: false } },
-    { $set: { endedBy, updatedAt: new Date() } },
-  );
-  return result.modifiedCount > 0;
-};
-
 export const pushToolExecution = async (
   callSid: string,
   execution: ToolExecution,

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

@@ -3,7 +3,6 @@ import { TranscriptionSegment } from "../results";
 import { LeadProperty } from "../leads";
 
 import {
-  CallEndedByValues,
   CallStatusValues,
   CONFERENCE_ROLE_CUSTOMER,
   CONFERENCE_ROLE_SUPERVISOR,
@@ -16,8 +15,6 @@ export type ConferenceRole =
 
 export type CallStatus = (typeof CallStatusValues)[keyof typeof CallStatusValues];
 
-export type CallEndedBy = (typeof CallEndedByValues)[keyof typeof CallEndedByValues];
-
 /**
  * Represents the call usage information with details about charging segments and quota impact.
  */
@@ -52,7 +49,6 @@ export type Call = {
   isAnsweredByAnsweringMachine?: boolean;
   agentHungUp?: boolean;
   endReason?: string;
-  endedBy?: CallEndedBy;
   conferenceName?: string | null;
   conferenceSid?: string | null;
   conferenceParticipantSid?: string | null;
@@ -150,7 +146,7 @@ export type ImmutableCallFields =
   | "env"
   | "createdAt";
 
-export type CallUpdateParams = Partial<Omit<Call, ImmutableCallFields | "endedBy">>;
+export type CallUpdateParams = Partial<Omit<Call, ImmutableCallFields>>;
 
 export type CallDoc = WithId<Call>;