@talkpilot/core-db 1.3.48 → 1.3.50

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 (231) 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 -777
  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 +6 -1
  8. package/dist/configuration/models/models.constants.js.map +1 -1
  9. package/dist/talkpilot/clients/clients.quota.constants.d.ts +2 -0
  10. package/dist/talkpilot/clients/clients.quota.constants.d.ts.map +1 -0
  11. package/dist/talkpilot/clients/clients.quota.constants.js +5 -0
  12. package/dist/talkpilot/clients/clients.quota.constants.js.map +1 -0
  13. package/dist/talkpilot/clients/clients.quota.utils.d.ts +8 -0
  14. package/dist/talkpilot/clients/clients.quota.utils.d.ts.map +1 -0
  15. package/dist/talkpilot/clients/clients.quota.utils.js +45 -0
  16. package/dist/talkpilot/clients/clients.quota.utils.js.map +1 -0
  17. package/dist/talkpilot/flows/flows.getter.d.ts +4 -1
  18. package/dist/talkpilot/flows/flows.getter.d.ts.map +1 -1
  19. package/dist/talkpilot/flows/flows.getter.js +12 -1
  20. package/dist/talkpilot/flows/flows.getter.js.map +1 -1
  21. package/dist/talkpilot/flows/flows.schema.d.ts +31 -0
  22. package/dist/talkpilot/flows/flows.schema.d.ts.map +1 -1
  23. package/dist/talkpilot/flows/flows.schema.js +25 -0
  24. package/dist/talkpilot/flows/flows.schema.js.map +1 -1
  25. package/dist/talkpilot/flows/flows.types.d.ts +14 -0
  26. package/dist/talkpilot/flows/flows.types.d.ts.map +1 -1
  27. package/dist/talkpilot/flows/index.d.ts +1 -1
  28. package/dist/talkpilot/flows/index.d.ts.map +1 -1
  29. package/dist/talkpilot/flows/index.js +3 -1
  30. package/dist/talkpilot/flows/index.js.map +1 -1
  31. package/jest.config.js +20 -20
  32. package/package.json +46 -46
  33. package/src/__tests__/setup.ts +20 -20
  34. package/src/bulkWrite/__tests__/bulkWrite.spec.ts +65 -65
  35. package/src/bulkWrite/bulkWrite.ops.ts +45 -45
  36. package/src/bulkWrite/bulkWrite.types.ts +4 -4
  37. package/src/bulkWrite/index.ts +2 -2
  38. package/src/config.ts +9 -9
  39. package/src/configuration/index.ts +17 -17
  40. package/src/configuration/internalModels/index.ts +3 -3
  41. package/src/configuration/internalModels/internalModels.constants.ts +1 -1
  42. package/src/configuration/internalModels/internalModels.getters.ts +33 -33
  43. package/src/configuration/internalModels/internalModels.types.ts +12 -12
  44. package/src/configuration/models/index.ts +25 -25
  45. package/src/configuration/models/models.constants.ts +18 -13
  46. package/src/configuration/models/models.getters.ts +53 -53
  47. package/src/configuration/models/models.types.ts +79 -79
  48. package/src/configuration/mongodb-client.ts +62 -62
  49. package/src/configuration/prompts/index.ts +2 -2
  50. package/src/configuration/prompts/prompts.getters.ts +49 -49
  51. package/src/configuration/prompts/prompts.types.ts +11 -11
  52. package/src/connection.ts +81 -81
  53. package/src/index.ts +46 -46
  54. package/src/municipal/__tests__/validation.spec.ts +62 -62
  55. package/src/municipal/cities/cities.getters.ts +50 -50
  56. package/src/municipal/cities/cities.types.ts +11 -11
  57. package/src/municipal/cities/index.ts +2 -2
  58. package/src/municipal/departmentsSubjects/__tests__/departmentsSubjects.spec.ts +272 -272
  59. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +317 -317
  60. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +73 -73
  61. package/src/municipal/departmentsSubjects/index.ts +9 -9
  62. package/src/municipal/index.ts +22 -22
  63. package/src/municipal/mongodb-client.ts +61 -61
  64. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +94 -94
  65. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  66. package/src/municipal/muniIssues/index.ts +17 -17
  67. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  68. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  69. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  70. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  71. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  72. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  73. package/src/municipal/streets/__tests__/streets.spec.ts +253 -253
  74. package/src/municipal/streets/index.ts +2 -2
  75. package/src/municipal/streets/streets.getters.ts +140 -140
  76. package/src/municipal/streets/streets.types.ts +19 -19
  77. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  78. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  79. package/src/municipal/systemInstructions/index.ts +7 -7
  80. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  81. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  82. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  83. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  84. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +99 -99
  85. package/src/municipal/tickets/index.ts +9 -9
  86. package/src/municipal/tickets/tickets.constants.ts +8 -8
  87. package/src/municipal/tickets/tickets.getters.ts +121 -121
  88. package/src/municipal/tickets/tickets.statistics.aggregation.ts +110 -110
  89. package/src/municipal/tickets/tickets.statistics.getters.ts +145 -145
  90. package/src/municipal/tickets/tickets.types.ts +54 -54
  91. package/src/municipal/utils/types.ts +11 -11
  92. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  93. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  94. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  95. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  96. package/src/talkpilot/agents/agents.getters.ts +34 -34
  97. package/src/talkpilot/agents/agents.types.ts +14 -14
  98. package/src/talkpilot/agents/index.ts +2 -2
  99. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  100. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  101. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  102. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  103. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  104. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +229 -229
  105. package/src/talkpilot/calls/__tests__/calls.spec.ts +471 -471
  106. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +483 -483
  107. package/src/talkpilot/calls/calls.constants.ts +49 -49
  108. package/src/talkpilot/calls/calls.getters.ts +277 -277
  109. package/src/talkpilot/calls/calls.statistics.getters.ts +668 -668
  110. package/src/talkpilot/calls/calls.statistics.types.ts +48 -48
  111. package/src/talkpilot/calls/calls.types.ts +149 -149
  112. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +295 -295
  113. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  114. package/src/talkpilot/calls/index.ts +6 -6
  115. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  116. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  117. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  118. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  119. package/src/talkpilot/clients/__tests__/clients.quota.spec.ts +123 -123
  120. package/src/talkpilot/clients/clients.getters.ts +16 -16
  121. package/src/talkpilot/clients/clients.quota.getters.ts +119 -119
  122. package/src/talkpilot/clients/clients.quota.types.ts +27 -27
  123. package/src/talkpilot/clients/clients.types.ts +18 -18
  124. package/src/talkpilot/clients/index.ts +4 -4
  125. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +423 -423
  126. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +212 -212
  127. package/src/talkpilot/clientsConfig/clientsConfig.constants.ts +2 -2
  128. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +247 -247
  129. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +136 -136
  130. package/src/talkpilot/clientsConfig/index.ts +3 -3
  131. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +217 -217
  132. package/src/talkpilot/contextNotes/contextNotes.getters.ts +85 -85
  133. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  134. package/src/talkpilot/contextNotes/index.ts +2 -2
  135. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +124 -99
  136. package/src/talkpilot/flows/flows.getter.ts +34 -14
  137. package/src/talkpilot/flows/flows.schema.ts +180 -155
  138. package/src/talkpilot/flows/flows.types.ts +211 -189
  139. package/src/talkpilot/flows/index.ts +7 -2
  140. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  141. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  142. package/src/talkpilot/groups/groups.getters.ts +30 -30
  143. package/src/talkpilot/groups/groups.types.ts +29 -29
  144. package/src/talkpilot/groups/index.ts +3 -3
  145. package/src/talkpilot/groups/phone.utils.ts +46 -46
  146. package/src/talkpilot/index.ts +31 -31
  147. package/src/talkpilot/leads/index.ts +2 -2
  148. package/src/talkpilot/leads/leads.getter.ts +6 -6
  149. package/src/talkpilot/leads/leads.schema.ts +33 -33
  150. package/src/talkpilot/leads/leads.types.ts +20 -20
  151. package/src/talkpilot/mongodb-client.ts +78 -78
  152. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +282 -282
  153. package/src/talkpilot/phone_numbers/index.ts +2 -2
  154. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +176 -176
  155. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  156. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  157. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  158. package/src/talkpilot/plans/index.ts +2 -2
  159. package/src/talkpilot/plans/plans.getters.ts +132 -132
  160. package/src/talkpilot/plans/plans.types.ts +89 -89
  161. package/src/talkpilot/products/__tests__/products.getters.spec.ts +44 -44
  162. package/src/talkpilot/products/index.ts +2 -2
  163. package/src/talkpilot/products/products.getters.ts +12 -12
  164. package/src/talkpilot/products/products.types.ts +9 -9
  165. package/src/talkpilot/results/index.ts +7 -7
  166. package/src/talkpilot/results/results.getter.ts +39 -39
  167. package/src/talkpilot/results/results.schema.ts +25 -25
  168. package/src/talkpilot/results/results.types.ts +34 -34
  169. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  170. package/src/talkpilot/retry_analyze/index.ts +2 -2
  171. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  172. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  173. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  174. package/src/talkpilot/sessions/index.ts +2 -2
  175. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  176. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  177. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  178. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  179. package/src/talkpilot/subscriptions/index.ts +3 -3
  180. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  181. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  182. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  183. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  184. package/src/talkpilot/utils/query.utils.ts +21 -21
  185. package/src/test-utils/db-utils.ts +33 -33
  186. package/src/test-utils/factories/index.ts +18 -18
  187. package/src/test-utils/factories/municipal/cities.ts +16 -16
  188. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  189. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  190. package/src/test-utils/factories/municipal/streets.ts +22 -22
  191. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  192. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  193. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  194. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  195. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  196. package/src/test-utils/factories/talkpilot/contextNotes.ts +40 -40
  197. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  198. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  199. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  200. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  201. package/src/test-utils/factories/websitalk/knowledgeDocuments.ts +29 -29
  202. package/src/test-utils/factories/websitalk/scanResources.ts +26 -26
  203. package/src/test-utils/factories/websitalk/scans.ts +29 -29
  204. package/src/test-utils/factories/websitalk/websiteUrls.ts +17 -17
  205. package/src/utils/date.utils.ts +126 -126
  206. package/src/utils/shared.types.ts +4 -4
  207. package/src/utils/validation.ts +23 -23
  208. package/src/websitalk/index.ts +18 -18
  209. package/src/websitalk/knowledgeDocuments/__tests__/knowledgeDocuments.spec.ts +186 -186
  210. package/src/websitalk/knowledgeDocuments/index.ts +3 -3
  211. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.constants.ts +17 -17
  212. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.getters.ts +78 -78
  213. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.types.ts +62 -62
  214. package/src/websitalk/mongodb-client.ts +61 -61
  215. package/src/websitalk/scanResources/__tests__/scanResources.spec.ts +193 -193
  216. package/src/websitalk/scanResources/index.ts +4 -4
  217. package/src/websitalk/scanResources/scanResources.constants.ts +47 -47
  218. package/src/websitalk/scanResources/scanResources.getters.ts +102 -102
  219. package/src/websitalk/scanResources/scanResources.types.ts +90 -90
  220. package/src/websitalk/scanResources/scanResources.utils.ts +31 -31
  221. package/src/websitalk/scans/__tests__/scans.spec.ts +313 -313
  222. package/src/websitalk/scans/index.ts +4 -4
  223. package/src/websitalk/scans/scans.constants.ts +15 -15
  224. package/src/websitalk/scans/scans.getters.ts +166 -166
  225. package/src/websitalk/scans/scans.types.ts +54 -54
  226. package/src/websitalk/scans/scans.utils.ts +5 -5
  227. package/src/websitalk/websiteUrls/__tests__/websiteUrls.spec.ts +77 -77
  228. package/src/websitalk/websiteUrls/index.ts +2 -2
  229. package/src/websitalk/websiteUrls/websiteUrls.getters.ts +65 -65
  230. package/src/websitalk/websiteUrls/websiteUrls.types.ts +13 -13
  231. package/tsconfig.json +23 -23
@@ -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
+ };