@talkpilot/core-db 1.3.50 → 1.3.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (229) hide show
  1. package/.cursor/rules/development.mdc +65 -65
  2. package/AGENTS.md +49 -49
  3. package/DEVELOPMENT.md +141 -141
  4. package/README.md +778 -778
  5. package/dist/configuration/models/models.constants.d.ts +1 -1
  6. package/dist/configuration/models/models.constants.d.ts.map +1 -1
  7. package/dist/configuration/models/models.constants.js +1 -6
  8. package/dist/configuration/models/models.constants.js.map +1 -1
  9. package/dist/websitalk/scanResources/scanResources.getters.d.ts +1 -0
  10. package/dist/websitalk/scanResources/scanResources.getters.d.ts.map +1 -1
  11. package/dist/websitalk/scanResources/scanResources.getters.js +6 -1
  12. package/dist/websitalk/scanResources/scanResources.getters.js.map +1 -1
  13. package/dist/websitalk/scans/scans.constants.d.ts +1 -0
  14. package/dist/websitalk/scans/scans.constants.d.ts.map +1 -1
  15. package/dist/websitalk/scans/scans.constants.js +1 -0
  16. package/dist/websitalk/scans/scans.constants.js.map +1 -1
  17. package/dist/websitalk/scans/scans.getters.d.ts +1 -0
  18. package/dist/websitalk/scans/scans.getters.d.ts.map +1 -1
  19. package/dist/websitalk/scans/scans.getters.js +6 -1
  20. package/dist/websitalk/scans/scans.getters.js.map +1 -1
  21. package/jest.config.js +20 -20
  22. package/package.json +46 -46
  23. package/src/__tests__/setup.ts +20 -20
  24. package/src/bulkWrite/__tests__/bulkWrite.spec.ts +65 -65
  25. package/src/bulkWrite/bulkWrite.ops.ts +45 -45
  26. package/src/bulkWrite/bulkWrite.types.ts +4 -4
  27. package/src/bulkWrite/index.ts +2 -2
  28. package/src/config.ts +9 -9
  29. package/src/configuration/index.ts +17 -17
  30. package/src/configuration/internalModels/index.ts +3 -3
  31. package/src/configuration/internalModels/internalModels.constants.ts +1 -1
  32. package/src/configuration/internalModels/internalModels.getters.ts +33 -33
  33. package/src/configuration/internalModels/internalModels.types.ts +12 -12
  34. package/src/configuration/models/index.ts +25 -25
  35. package/src/configuration/models/models.constants.ts +13 -18
  36. package/src/configuration/models/models.getters.ts +53 -53
  37. package/src/configuration/models/models.types.ts +79 -79
  38. package/src/configuration/mongodb-client.ts +62 -62
  39. package/src/configuration/prompts/index.ts +2 -2
  40. package/src/configuration/prompts/prompts.getters.ts +49 -49
  41. package/src/configuration/prompts/prompts.types.ts +11 -11
  42. package/src/connection.ts +81 -81
  43. package/src/index.ts +46 -46
  44. package/src/municipal/__tests__/validation.spec.ts +62 -62
  45. package/src/municipal/cities/cities.getters.ts +50 -50
  46. package/src/municipal/cities/cities.types.ts +11 -11
  47. package/src/municipal/cities/index.ts +2 -2
  48. package/src/municipal/departmentsSubjects/__tests__/departmentsSubjects.spec.ts +272 -272
  49. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +317 -317
  50. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +73 -73
  51. package/src/municipal/departmentsSubjects/index.ts +9 -9
  52. package/src/municipal/index.ts +22 -22
  53. package/src/municipal/mongodb-client.ts +61 -61
  54. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +94 -94
  55. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  56. package/src/municipal/muniIssues/index.ts +17 -17
  57. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  58. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  59. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  60. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  61. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  62. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  63. package/src/municipal/streets/__tests__/streets.spec.ts +253 -253
  64. package/src/municipal/streets/index.ts +2 -2
  65. package/src/municipal/streets/streets.getters.ts +140 -140
  66. package/src/municipal/streets/streets.types.ts +19 -19
  67. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  68. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  69. package/src/municipal/systemInstructions/index.ts +7 -7
  70. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  71. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  72. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  73. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  74. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +99 -99
  75. package/src/municipal/tickets/index.ts +9 -9
  76. package/src/municipal/tickets/tickets.constants.ts +8 -8
  77. package/src/municipal/tickets/tickets.getters.ts +121 -121
  78. package/src/municipal/tickets/tickets.statistics.aggregation.ts +110 -110
  79. package/src/municipal/tickets/tickets.statistics.getters.ts +145 -145
  80. package/src/municipal/tickets/tickets.types.ts +54 -54
  81. package/src/municipal/utils/types.ts +11 -11
  82. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  83. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  84. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  85. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  86. package/src/talkpilot/agents/agents.getters.ts +34 -34
  87. package/src/talkpilot/agents/agents.types.ts +14 -14
  88. package/src/talkpilot/agents/index.ts +2 -2
  89. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  90. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  91. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  92. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  93. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  94. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +229 -229
  95. package/src/talkpilot/calls/__tests__/calls.spec.ts +471 -471
  96. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +483 -483
  97. package/src/talkpilot/calls/calls.constants.ts +49 -49
  98. package/src/talkpilot/calls/calls.getters.ts +277 -277
  99. package/src/talkpilot/calls/calls.statistics.getters.ts +668 -668
  100. package/src/talkpilot/calls/calls.statistics.types.ts +48 -48
  101. package/src/talkpilot/calls/calls.types.ts +149 -149
  102. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +295 -295
  103. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  104. package/src/talkpilot/calls/index.ts +6 -6
  105. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  106. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  107. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  108. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  109. package/src/talkpilot/clients/__tests__/clients.quota.spec.ts +123 -123
  110. package/src/talkpilot/clients/clients.getters.ts +16 -16
  111. package/src/talkpilot/clients/clients.quota.getters.ts +119 -119
  112. package/src/talkpilot/clients/clients.quota.types.ts +27 -27
  113. package/src/talkpilot/clients/clients.types.ts +18 -18
  114. package/src/talkpilot/clients/index.ts +4 -4
  115. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +423 -423
  116. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +212 -212
  117. package/src/talkpilot/clientsConfig/clientsConfig.constants.ts +2 -2
  118. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +247 -247
  119. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +136 -136
  120. package/src/talkpilot/clientsConfig/index.ts +3 -3
  121. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +217 -217
  122. package/src/talkpilot/contextNotes/contextNotes.getters.ts +85 -85
  123. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  124. package/src/talkpilot/contextNotes/index.ts +2 -2
  125. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +124 -124
  126. package/src/talkpilot/flows/flows.getter.ts +34 -34
  127. package/src/talkpilot/flows/flows.schema.ts +180 -180
  128. package/src/talkpilot/flows/flows.types.ts +211 -211
  129. package/src/talkpilot/flows/index.ts +7 -7
  130. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  131. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  132. package/src/talkpilot/groups/groups.getters.ts +30 -30
  133. package/src/talkpilot/groups/groups.types.ts +29 -29
  134. package/src/talkpilot/groups/index.ts +3 -3
  135. package/src/talkpilot/groups/phone.utils.ts +46 -46
  136. package/src/talkpilot/index.ts +31 -31
  137. package/src/talkpilot/leads/index.ts +2 -2
  138. package/src/talkpilot/leads/leads.getter.ts +6 -6
  139. package/src/talkpilot/leads/leads.schema.ts +33 -33
  140. package/src/talkpilot/leads/leads.types.ts +20 -20
  141. package/src/talkpilot/mongodb-client.ts +78 -78
  142. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +282 -282
  143. package/src/talkpilot/phone_numbers/index.ts +2 -2
  144. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +176 -176
  145. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  146. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  147. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  148. package/src/talkpilot/plans/index.ts +2 -2
  149. package/src/talkpilot/plans/plans.getters.ts +132 -132
  150. package/src/talkpilot/plans/plans.types.ts +89 -89
  151. package/src/talkpilot/products/__tests__/products.getters.spec.ts +44 -44
  152. package/src/talkpilot/products/index.ts +2 -2
  153. package/src/talkpilot/products/products.getters.ts +12 -12
  154. package/src/talkpilot/products/products.types.ts +9 -9
  155. package/src/talkpilot/results/index.ts +7 -7
  156. package/src/talkpilot/results/results.getter.ts +39 -39
  157. package/src/talkpilot/results/results.schema.ts +25 -25
  158. package/src/talkpilot/results/results.types.ts +34 -34
  159. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  160. package/src/talkpilot/retry_analyze/index.ts +2 -2
  161. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  162. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  163. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  164. package/src/talkpilot/sessions/index.ts +2 -2
  165. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  166. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  167. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  168. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  169. package/src/talkpilot/subscriptions/index.ts +3 -3
  170. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  171. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  172. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  173. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  174. package/src/talkpilot/utils/query.utils.ts +21 -21
  175. package/src/test-utils/db-utils.ts +33 -33
  176. package/src/test-utils/factories/index.ts +18 -18
  177. package/src/test-utils/factories/municipal/cities.ts +16 -16
  178. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  179. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  180. package/src/test-utils/factories/municipal/streets.ts +22 -22
  181. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  182. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  183. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  184. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  185. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  186. package/src/test-utils/factories/talkpilot/contextNotes.ts +40 -40
  187. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  188. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  189. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  190. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  191. package/src/test-utils/factories/websitalk/knowledgeDocuments.ts +29 -29
  192. package/src/test-utils/factories/websitalk/scanResources.ts +26 -26
  193. package/src/test-utils/factories/websitalk/scans.ts +29 -29
  194. package/src/test-utils/factories/websitalk/websiteUrls.ts +17 -17
  195. package/src/utils/date.utils.ts +126 -126
  196. package/src/utils/shared.types.ts +4 -4
  197. package/src/utils/validation.ts +23 -23
  198. package/src/websitalk/index.ts +18 -18
  199. package/src/websitalk/knowledgeDocuments/__tests__/knowledgeDocuments.spec.ts +186 -186
  200. package/src/websitalk/knowledgeDocuments/index.ts +3 -3
  201. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.constants.ts +17 -17
  202. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.getters.ts +78 -78
  203. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.types.ts +62 -62
  204. package/src/websitalk/mongodb-client.ts +61 -61
  205. package/src/websitalk/scanResources/__tests__/scanResources.spec.ts +212 -193
  206. package/src/websitalk/scanResources/index.ts +4 -4
  207. package/src/websitalk/scanResources/scanResources.constants.ts +47 -47
  208. package/src/websitalk/scanResources/scanResources.getters.ts +109 -102
  209. package/src/websitalk/scanResources/scanResources.types.ts +90 -90
  210. package/src/websitalk/scanResources/scanResources.utils.ts +31 -31
  211. package/src/websitalk/scans/__tests__/scans.spec.ts +330 -313
  212. package/src/websitalk/scans/index.ts +4 -4
  213. package/src/websitalk/scans/scans.constants.ts +16 -15
  214. package/src/websitalk/scans/scans.getters.ts +171 -166
  215. package/src/websitalk/scans/scans.types.ts +54 -54
  216. package/src/websitalk/scans/scans.utils.ts +5 -5
  217. package/src/websitalk/websiteUrls/__tests__/websiteUrls.spec.ts +77 -77
  218. package/src/websitalk/websiteUrls/index.ts +2 -2
  219. package/src/websitalk/websiteUrls/websiteUrls.getters.ts +65 -65
  220. package/src/websitalk/websiteUrls/websiteUrls.types.ts +13 -13
  221. package/tsconfig.json +23 -23
  222. package/dist/talkpilot/clients/clients.quota.constants.d.ts +0 -2
  223. package/dist/talkpilot/clients/clients.quota.constants.d.ts.map +0 -1
  224. package/dist/talkpilot/clients/clients.quota.constants.js +0 -5
  225. package/dist/talkpilot/clients/clients.quota.constants.js.map +0 -1
  226. package/dist/talkpilot/clients/clients.quota.utils.d.ts +0 -8
  227. package/dist/talkpilot/clients/clients.quota.utils.d.ts.map +0 -1
  228. package/dist/talkpilot/clients/clients.quota.utils.js +0 -45
  229. package/dist/talkpilot/clients/clients.quota.utils.js.map +0 -1
@@ -1,48 +1,48 @@
1
- export type ResolvedTimeBucket = "day" | "week" | "month";
2
-
3
- export type TicketStatusFilter = "opened" | "not_opened";
4
- export type CallRoutingFilter = "ai_only" | "transferred" | "hijacked";
5
-
6
- export type CallsStatsFilter = {
7
- clientId: string;
8
- startStr: string;
9
- endStr: string;
10
- timezone: string;
11
- hourFrom?: string; // HH:mm
12
- hourTo?: string; // HH:mm
13
- callRouting?: CallRoutingFilter[];
14
- /** @deprecated Use callSidTicketCounts instead. */
15
- callSidsWithTickets?: string[];
16
- callSidTicketCounts?: Map<string, number>;
17
- /** @deprecated Use callSidDraftTicketCounts instead. */
18
- callSidsWithDraftTickets?: string[];
19
- callSidDraftTicketCounts?: Map<string, number>;
20
- ticketStatusFilters?: TicketStatusFilter[];
21
- };
22
-
23
- export type CallsSummaryAggregation = {
24
- totalCalls: number;
25
- avgDurationSeconds: number;
26
- openTickets: number;
27
- draftTickets: number;
28
- callsWithTickets?: number;
29
- };
30
-
31
- export type CallsTrendBucket = {
32
- /** Day: YYYY-MM-DD; week: YYYY-MM-DD/YYYY-MM-DD (inclusive, clipped to filter); month: YYYY-MM-01 */
33
- bucket: string;
34
- totalCalls: number;
35
- openTickets: number;
36
- };
37
-
38
- export type CallsHourlyBucket = {
39
- hour: number;
40
- totalCalls: number;
41
- avgCalls: number;
42
- };
43
-
44
- export type CallsRoutingAggregation = {
45
- aiHandled: number;
46
- transferred: number;
47
- hijacked: number;
48
- };
1
+ export type ResolvedTimeBucket = "day" | "week" | "month";
2
+
3
+ export type TicketStatusFilter = "opened" | "not_opened";
4
+ export type CallRoutingFilter = "ai_only" | "transferred" | "hijacked";
5
+
6
+ export type CallsStatsFilter = {
7
+ clientId: string;
8
+ startStr: string;
9
+ endStr: string;
10
+ timezone: string;
11
+ hourFrom?: string; // HH:mm
12
+ hourTo?: string; // HH:mm
13
+ callRouting?: CallRoutingFilter[];
14
+ /** @deprecated Use callSidTicketCounts instead. */
15
+ callSidsWithTickets?: string[];
16
+ callSidTicketCounts?: Map<string, number>;
17
+ /** @deprecated Use callSidDraftTicketCounts instead. */
18
+ callSidsWithDraftTickets?: string[];
19
+ callSidDraftTicketCounts?: Map<string, number>;
20
+ ticketStatusFilters?: TicketStatusFilter[];
21
+ };
22
+
23
+ export type CallsSummaryAggregation = {
24
+ totalCalls: number;
25
+ avgDurationSeconds: number;
26
+ openTickets: number;
27
+ draftTickets: number;
28
+ callsWithTickets?: number;
29
+ };
30
+
31
+ export type CallsTrendBucket = {
32
+ /** Day: YYYY-MM-DD; week: YYYY-MM-DD/YYYY-MM-DD (inclusive, clipped to filter); month: YYYY-MM-01 */
33
+ bucket: string;
34
+ totalCalls: number;
35
+ openTickets: number;
36
+ };
37
+
38
+ export type CallsHourlyBucket = {
39
+ hour: number;
40
+ totalCalls: number;
41
+ avgCalls: number;
42
+ };
43
+
44
+ export type CallsRoutingAggregation = {
45
+ aiHandled: number;
46
+ transferred: number;
47
+ hijacked: number;
48
+ };
@@ -1,149 +1,149 @@
1
- import { ObjectId, Sort, WithId } from "mongodb";
2
- import { TranscriptionSegment } from "../results";
3
- import { LeadProperty } from "../leads";
4
-
5
- import {
6
- CallStatusValues,
7
- CONFERENCE_ROLE_CUSTOMER,
8
- CONFERENCE_ROLE_SUPERVISOR,
9
- } from "./calls.constants";
10
-
11
- export type ConferenceRole =
12
- | typeof CONFERENCE_ROLE_CUSTOMER
13
- | typeof CONFERENCE_ROLE_SUPERVISOR
14
- | null;
15
-
16
- export type CallStatus = (typeof CallStatusValues)[keyof typeof CallStatusValues];
17
-
18
- export type Call = {
19
- callSid: string;
20
- flowId: ObjectId;
21
- clientId: string;
22
- sessionId: ObjectId | null;
23
- runId?: string;
24
- resultId: ObjectId;
25
- customerPhoneNumber: string;
26
- agentPhoneNumber: string;
27
- isIncomingCall: boolean;
28
- isOutgoingCall: boolean;
29
- callLength: number;
30
- transcription?: TranscriptionSegment[];
31
- status?: CallStatus;
32
- leads?: LeadProperty[];
33
- summary?: string;
34
- recordingUrl?: string;
35
- env: string;
36
- updatedAt: Date;
37
- createdAt: Date;
38
- isAnsweredByAnsweringMachine?: boolean;
39
- agentHungUp?: boolean;
40
- endReason?: string;
41
- conferenceName?: string | null;
42
- conferenceSid?: string | null;
43
- conferenceParticipantSid?: string | null;
44
- isConferenceCall?: boolean;
45
- conferenceRole?: ConferenceRole;
46
- redirectedCall?: boolean;
47
- /** Present only on redirected calls: what the dialled leg did. */
48
- redirectCallLog?: RedirectCallLog;
49
- toolExecutions?: ToolExecution[];
50
- transcriptionComparison?: Record<string, TranscriptionSegment[]>;
51
- };
52
-
53
- /**
54
- * The outcome of the <Dial> that transferred a call, reported by Twilio when the
55
- * dialled leg ends. `durationSeconds` is the bridged time, which is 0 when the
56
- * destination never answered.
57
- */
58
- export type RedirectCallLog = {
59
- childCallSid?: string;
60
- to?: string;
61
- status: CallStatus;
62
- durationSeconds: number;
63
- endedAt: Date;
64
- };
65
-
66
- export type ToolExecution = {
67
- toolName: string;
68
- executedAt: Date;
69
- durationMs: number;
70
- args: Record<string, unknown> | { _redacted: true };
71
- meta: ToolExecutionMeta;
72
- status: "success" | "error";
73
- httpStatus?: number;
74
- response?: Record<string, unknown>;
75
- steps?: ToolExecutionStep[];
76
- };
77
-
78
- export type ToolExecutionStepLevel = "info" | "warn" | "error";
79
-
80
- export type ToolExecutionStep = {
81
- timestamp: Date;
82
- label: string;
83
- level: ToolExecutionStepLevel;
84
- data?: Record<string, unknown> | string;
85
- payload?: Record<string, unknown>;
86
- };
87
-
88
- export type ToolExecutionMeta =
89
- | {
90
- kind: "http";
91
- url: string;
92
- method: string;
93
- flowToolId?: string;
94
- runInBackground?: boolean;
95
- sensitive?: boolean;
96
- }
97
- | { kind: "internal" };
98
-
99
- export type CallQueryOptions = {
100
- sort?: Sort;
101
- skip?: number;
102
- limit?: number;
103
- };
104
-
105
- export type CallsFilterParams = {
106
- clientId: string;
107
- callSid?: string;
108
- startDate?: Date;
109
- endDate?: Date;
110
- status?: CallStatus;
111
- customerPhoneNumber?: string;
112
- agentPhoneNumber?: string;
113
- flowId?: string;
114
- runId?: string;
115
- sessionId?: string;
116
- isIncoming?: boolean;
117
- search?: string;
118
- };
119
-
120
- export type ImmutableCallFields =
121
- | "customerPhoneNumber"
122
- | "agentPhoneNumber"
123
- | "isIncomingCall"
124
- | "isOutgoingCall"
125
- | "sessionId"
126
- | "callSid"
127
- | "flowId"
128
- | "clientId"
129
- | "runId"
130
- | "resultId"
131
- | "env"
132
- | "createdAt";
133
-
134
- export type CallUpdateParams = Partial<Omit<Call, ImmutableCallFields>>;
135
-
136
- export type CallDoc = WithId<Call>;
137
-
138
- /** @deprecated use DashboardHeatmapMetric instead */
139
- export type CallsByHour = { hour: number; calls: number };
140
-
141
- export type CountOpts = {
142
- isOutgoingCall?: boolean;
143
- isIncomingCall?: boolean;
144
- };
145
-
146
- export type DateRange = {
147
- since?: Date;
148
- until?: Date;
149
- };
1
+ import { ObjectId, Sort, WithId } from "mongodb";
2
+ import { TranscriptionSegment } from "../results";
3
+ import { LeadProperty } from "../leads";
4
+
5
+ import {
6
+ CallStatusValues,
7
+ CONFERENCE_ROLE_CUSTOMER,
8
+ CONFERENCE_ROLE_SUPERVISOR,
9
+ } from "./calls.constants";
10
+
11
+ export type ConferenceRole =
12
+ | typeof CONFERENCE_ROLE_CUSTOMER
13
+ | typeof CONFERENCE_ROLE_SUPERVISOR
14
+ | null;
15
+
16
+ export type CallStatus = (typeof CallStatusValues)[keyof typeof CallStatusValues];
17
+
18
+ export type Call = {
19
+ callSid: string;
20
+ flowId: ObjectId;
21
+ clientId: string;
22
+ sessionId: ObjectId | null;
23
+ runId?: string;
24
+ resultId: ObjectId;
25
+ customerPhoneNumber: string;
26
+ agentPhoneNumber: string;
27
+ isIncomingCall: boolean;
28
+ isOutgoingCall: boolean;
29
+ callLength: number;
30
+ transcription?: TranscriptionSegment[];
31
+ status?: CallStatus;
32
+ leads?: LeadProperty[];
33
+ summary?: string;
34
+ recordingUrl?: string;
35
+ env: string;
36
+ updatedAt: Date;
37
+ createdAt: Date;
38
+ isAnsweredByAnsweringMachine?: boolean;
39
+ agentHungUp?: boolean;
40
+ endReason?: string;
41
+ conferenceName?: string | null;
42
+ conferenceSid?: string | null;
43
+ conferenceParticipantSid?: string | null;
44
+ isConferenceCall?: boolean;
45
+ conferenceRole?: ConferenceRole;
46
+ redirectedCall?: boolean;
47
+ /** Present only on redirected calls: what the dialled leg did. */
48
+ redirectCallLog?: RedirectCallLog;
49
+ toolExecutions?: ToolExecution[];
50
+ transcriptionComparison?: Record<string, TranscriptionSegment[]>;
51
+ };
52
+
53
+ /**
54
+ * The outcome of the <Dial> that transferred a call, reported by Twilio when the
55
+ * dialled leg ends. `durationSeconds` is the bridged time, which is 0 when the
56
+ * destination never answered.
57
+ */
58
+ export type RedirectCallLog = {
59
+ childCallSid?: string;
60
+ to?: string;
61
+ status: CallStatus;
62
+ durationSeconds: number;
63
+ endedAt: Date;
64
+ };
65
+
66
+ export type ToolExecution = {
67
+ toolName: string;
68
+ executedAt: Date;
69
+ durationMs: number;
70
+ args: Record<string, unknown> | { _redacted: true };
71
+ meta: ToolExecutionMeta;
72
+ status: "success" | "error";
73
+ httpStatus?: number;
74
+ response?: Record<string, unknown>;
75
+ steps?: ToolExecutionStep[];
76
+ };
77
+
78
+ export type ToolExecutionStepLevel = "info" | "warn" | "error";
79
+
80
+ export type ToolExecutionStep = {
81
+ timestamp: Date;
82
+ label: string;
83
+ level: ToolExecutionStepLevel;
84
+ data?: Record<string, unknown> | string;
85
+ payload?: Record<string, unknown>;
86
+ };
87
+
88
+ export type ToolExecutionMeta =
89
+ | {
90
+ kind: "http";
91
+ url: string;
92
+ method: string;
93
+ flowToolId?: string;
94
+ runInBackground?: boolean;
95
+ sensitive?: boolean;
96
+ }
97
+ | { kind: "internal" };
98
+
99
+ export type CallQueryOptions = {
100
+ sort?: Sort;
101
+ skip?: number;
102
+ limit?: number;
103
+ };
104
+
105
+ export type CallsFilterParams = {
106
+ clientId: string;
107
+ callSid?: string;
108
+ startDate?: Date;
109
+ endDate?: Date;
110
+ status?: CallStatus;
111
+ customerPhoneNumber?: string;
112
+ agentPhoneNumber?: string;
113
+ flowId?: string;
114
+ runId?: string;
115
+ sessionId?: string;
116
+ isIncoming?: boolean;
117
+ search?: string;
118
+ };
119
+
120
+ export type ImmutableCallFields =
121
+ | "customerPhoneNumber"
122
+ | "agentPhoneNumber"
123
+ | "isIncomingCall"
124
+ | "isOutgoingCall"
125
+ | "sessionId"
126
+ | "callSid"
127
+ | "flowId"
128
+ | "clientId"
129
+ | "runId"
130
+ | "resultId"
131
+ | "env"
132
+ | "createdAt";
133
+
134
+ export type CallUpdateParams = Partial<Omit<Call, ImmutableCallFields>>;
135
+
136
+ export type CallDoc = WithId<Call>;
137
+
138
+ /** @deprecated use DashboardHeatmapMetric instead */
139
+ export type CallsByHour = { hour: number; calls: number };
140
+
141
+ export type CountOpts = {
142
+ isOutgoingCall?: boolean;
143
+ isIncomingCall?: boolean;
144
+ };
145
+
146
+ export type DateRange = {
147
+ since?: Date;
148
+ until?: Date;
149
+ };