@talkpilot/core-db 1.0.26 → 1.1.0

package/README.md

@@ -147,5 +147,7 @@ MIT
 
 - Added to Moked106Config this param: withNeedAttentionCalls
 - withNeedAttentionCalls?: boolean
-  
+
+### 1.0.27
+- Added an optional `language` field to `ClientConfig` (e.g. Hebrew/English/Russian/French/Spanish) and updated tests.
 

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

@@ -1,7 +1,4 @@
 import { WithId } from 'mongodb';
-/**
- * Configuration for initiating a call for short SLA
- */
 export type InitiateCallForShortSlaConfig = {
     active: boolean;
     max_hours: number;
@@ -11,18 +8,12 @@ export type InitiateCallForShortSlaConfig = {
     }[];
     flow_id?: string | string[];
 };
-/**
- * Moked 106 configuration structure
- */
 export type Moked106Config = {
     initiate_call_for_short_sla?: InitiateCallForShortSlaConfig;
     avoidSaveTickets?: boolean;
     withUploadImagesSms?: boolean;
     withNeedAttentionCalls?: boolean;
 };
-/**
- * Municipal products structure
- */
 export type MunicipalProduct = {
     moked_106?: Moked106Config;
     cityName: string;
@@ -34,22 +25,30 @@ export type MunicipalProduct = {
     isProductionReady?: boolean;
     municipalDisplayName?: string;
 };
-/**
- * Products structure
- */
 export type Products = {
     municipal?: MunicipalProduct;
     [key: string]: unknown;
 };
-/**
- * Client configuration type
- * @template P - Products type (defaults to Products for type safety)
- */
+export type ClientLanguageName = 'Hebrew' | 'English' | 'Russian' | 'French' | 'Spanish' | (string & {});
+export type SendGridConfig = {
+    emailTo: string[];
+    templateId?: string;
+    senderId?: string;
+};
+export type SmsConfig = {};
+export type WhatsappConfig = {};
+export type CommunicationsConfig = {
+    sendGrid?: SendGridConfig;
+    sms: SmsConfig;
+    whatsapp: WhatsappConfig;
+};
 export type ClientConfig<P extends Products = Products> = {
     clientId: string;
     phoneNumber?: string;
+    language?: ClientLanguageName;
     products: P;
     timezone?: string;
+    communications?: CommunicationsConfig;
 };
 export type ClientConfigDoc<P extends Products = Products> = WithId<ClientConfig<P>>;
 //# sourceMappingURL=clientsConfig.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"clientsConfig.types.d.ts","sourceRoot":"","sources":["../../../src/talkpilot/clientsConfig/clientsConfig.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,2BAA2B,CAAC,EAAE,6BAA6B,CAAC;IAC5D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"clientsConfig.types.d.ts","sourceRoot":"","sources":["../../../src/talkpilot/clientsConfig/clientsConfig.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,2BAA2B,CAAC,EAAE,6BAA6B,CAAC;IAC5D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,SAAS,GACT,SAAS,GACT,QAAQ,GACR,SAAS,GACT,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,EAAE,CAAC;AAE3B,MAAM,MAAM,cAAc,GAAG,EAAE,CAAC;AAEhC,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,GAAG,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/talkpilot/index.d.ts

@@ -12,6 +12,7 @@ export * from './groups';
 export * from './calls';
 export * from './clientAudioBuffers';
 export * from './clientsConfig';
+export * from './backgroundToolResults';
 export { mongodbClient } from './mongodb-client';
 export declare const setDb: (d: Db) => void;
 export declare const getDb: () => Db;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/talkpilot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,eAAO,MAAM,KAAK,GAAI,GAAG,EAAE,SAE1B,CAAC;AACF,eAAO,MAAM,KAAK,QAAO,EAGxB,CAAC;AAEF,eAAO,MAAM,QAAQ,sBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/talkpilot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,eAAO,MAAM,KAAK,GAAI,GAAG,EAAE,SAE1B,CAAC;AACF,eAAO,MAAM,KAAK,QAAO,EAGxB,CAAC;AAEF,eAAO,MAAM,QAAQ,sBAAgB,CAAC"}

package/dist/talkpilot/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./groups"), exports);
 __exportStar(require("./calls"), exports);
 __exportStar(require("./clientAudioBuffers"), exports);
 __exportStar(require("./clientsConfig"), exports);
+__exportStar(require("./backgroundToolResults"), exports);
 var mongodb_client_1 = require("./mongodb-client");
 Object.defineProperty(exports, "mongodbClient", { enumerable: true, get: function () { return mongodb_client_1.mongodbClient; } });
 let db;

package/dist/talkpilot/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/talkpilot/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qCAAwD;AAExD,0CAAwB;AACxB,4CAA0B;AAC1B,6CAA2B;AAC3B,kDAAgC;AAChC,0CAAwB;AACxB,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AACxB,kDAAgC;AAChC,2CAAyB;AACzB,0CAAwB;AACxB,uDAAqC;AACrC,kDAAgC;AAChC,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAEtB,IAAI,EAAM,CAAC;AACJ,MAAM,KAAK,GAAG,CAAC,CAAK,EAAE,EAAE;IAC7B,EAAE,GAAG,CAAC,CAAC;AACT,CAAC,CAAC;AAFW,QAAA,KAAK,SAEhB;AACK,MAAM,KAAK,GAAG,GAAO,EAAE;IAC5B,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC/C,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAHW,QAAA,KAAK,SAGhB;AAEW,QAAA,QAAQ,GAAG,kBAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/talkpilot/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qCAAwD;AAExD,0CAAwB;AACxB,4CAA0B;AAC1B,6CAA2B;AAC3B,kDAAgC;AAChC,0CAAwB;AACxB,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AACxB,kDAAgC;AAChC,2CAAyB;AACzB,0CAAwB;AACxB,uDAAqC;AACrC,kDAAgC;AAChC,0DAAwC;AACxC,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAEtB,IAAI,EAAM,CAAC;AACJ,MAAM,KAAK,GAAG,CAAC,CAAK,EAAE,EAAE;IAC7B,EAAE,GAAG,CAAC,CAAC;AACT,CAAC,CAAC;AAFW,QAAA,KAAK,SAEhB;AACK,MAAM,KAAK,GAAG,GAAO,EAAE;IAC5B,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC/C,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAHW,QAAA,KAAK,SAGhB;AAEW,QAAA,QAAQ,GAAG,kBAAa,CAAC"}

package/dist/talkpilot/subscriptions/subscriptions.utils.d.ts

@@ -0,0 +1,4 @@
+import { Filter } from 'mongodb';
+import { Subscription, SimpleSubscriptionFilter } from '../index';
+export declare const buildSimpleQuery: (filter: SimpleSubscriptionFilter) => Filter<Subscription>;
+//# sourceMappingURL=subscriptions.utils.d.ts.map

package/dist/talkpilot/subscriptions/subscriptions.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.utils.d.ts","sourceRoot":"","sources":["../../../src/talkpilot/subscriptions/subscriptions.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAA6B,MAAM,UAAU,CAAC;AAE7F,eAAO,MAAM,gBAAgB,GAAI,QAAQ,wBAAwB,KAAG,MAAM,CAAC,YAAY,CAetF,CAAC"}

package/dist/talkpilot/subscriptions/subscriptions.utils.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSimpleQuery = void 0;
+const mongodb_1 = require("mongodb");
+const index_1 = require("../index");
+const buildSimpleQuery = (filter) => {
+    const query = {};
+    if (filter._id) {
+        query._id = new mongodb_1.ObjectId(filter._id);
+    }
+    index_1.simpleFields.forEach((field) => {
+        const val = filter[field];
+        if (val !== undefined) {
+            query[field] = val;
+        }
+    });
+    return query;
+};
+exports.buildSimpleQuery = buildSimpleQuery;
+//# sourceMappingURL=subscriptions.utils.js.map

package/dist/talkpilot/subscriptions/subscriptions.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.utils.js","sourceRoot":"","sources":["../../../src/talkpilot/subscriptions/subscriptions.utils.ts"],"names":[],"mappings":";;;AAAA,qCAA2C;AAC3C,oCAA6F;AAEtF,MAAM,gBAAgB,GAAG,CAAC,MAAgC,EAAwB,EAAE;IACzF,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,KAAK,CAAC,GAAG,GAAG,IAAI,kBAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,oBAAY,CAAC,OAAO,CAAC,CAAC,KAAkB,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,KAAK,CAAC,KAAK,CAAC,GAAG,GAAU,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAfW,QAAA,gBAAgB,oBAe3B"}

package/package.json

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

package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts

@@ -0,0 +1,136 @@
+import {
+  getBackgroundToolResultsCollection,
+  upsertBackgroundToolResult,
+  findBackgroundToolResult,
+  findBackgroundToolResultsByCallSid,
+} from '../backgroundToolResults.getters';
+import { BackgroundToolStatus } from '../backgroundToolResults.types';
+
+describe('backgroundToolResults getters', () => {
+  it('should return the "backgroundToolResults" collection', () => {
+    const collection = getBackgroundToolResultsCollection();
+    expect(collection.collectionName).toBe('backgroundToolResults');
+  });
+
+  it('should create a new background tool result with correct fields and default TTL', async () => {
+    const callSid = 'CA-background-call-1';
+    const toolName = 'exampleTool';
+    const status: BackgroundToolStatus = 'pending';
+    const result = null;
+
+    const before = new Date();
+    const doc = await upsertBackgroundToolResult({ callSid, toolName, status, result });
+    const after = new Date();
+
+    expect(doc).not.toBeNull();
+    expect(doc?.callSid).toBe(callSid);
+    expect(doc?.toolName).toBe(toolName);
+    expect(doc?.status).toBe(status);
+    expect(doc?.result).toBe(result);
+    expect(doc?.createdAt).toBeInstanceOf(Date);
+    expect(doc?.updatedAt).toBeInstanceOf(Date);
+    expect(doc?.expiredAt).toBeInstanceOf(Date);
+
+    const createdAt = doc!.createdAt.getTime();
+    const expiredAt = doc!.expiredAt.getTime();
+    const ttlMs = expiredAt - createdAt;
+
+    expect(ttlMs).toBeGreaterThanOrEqual(60 * 60_000 - 1000);
+    expect(ttlMs).toBeLessThanOrEqual(60 * 60_000 + 1000);
+
+    expect(doc!.createdAt.getTime()).toBeGreaterThanOrEqual(before.getTime());
+    expect(doc!.updatedAt.getTime()).toBeLessThanOrEqual(after.getTime());
+  });
+
+  it('should upsert by callSid + toolName and keep createdAt while updating other fields', async () => {
+    const callSid = 'CA-background-call-2';
+    const toolName = 'aggregationTool';
+
+    const first = await upsertBackgroundToolResult({
+      callSid,
+      toolName,
+      status: 'pending',
+      result: null,
+    });
+
+    expect(first).not.toBeNull();
+
+    const firstCreatedAt = first!.createdAt;
+    const firstUpdatedAt = first!.updatedAt;
+    const firstExpiredAt = first!.expiredAt;
+
+    const customTtlMs = 5 * 60_000;
+    const secondResultPayload = { value: 42 };
+
+    const second = await upsertBackgroundToolResult({
+      callSid,
+      toolName,
+      status: 'success',
+      result: secondResultPayload,
+      ttlMs: customTtlMs,
+    });
+
+    expect(second).not.toBeNull();
+    expect(second!._id.toHexString()).toBe(first!._id.toHexString());
+    expect(second!.callSid).toBe(callSid);
+    expect(second!.toolName).toBe(toolName);
+    expect(second!.status).toBe('success');
+    expect(second!.result).toEqual(secondResultPayload);
+
+    expect(second!.createdAt.getTime()).toBe(firstCreatedAt.getTime());
+
+    expect(second!.updatedAt.getTime()).toBeGreaterThanOrEqual(firstUpdatedAt.getTime());
+    expect(second!.expiredAt.getTime()).not.toBe(firstExpiredAt.getTime());
+
+    const ttlMs = second!.expiredAt.getTime() - second!.updatedAt.getTime();
+    expect(ttlMs).toBeGreaterThanOrEqual(customTtlMs - 1000);
+    expect(ttlMs).toBeLessThanOrEqual(customTtlMs + 1000);
+  });
+
+  it('should find background tool result by callSid and toolName', async () => {
+    const callSid = 'CA-background-call-3';
+    const toolName = 'fetchUserData';
+
+    await upsertBackgroundToolResult({
+      callSid,
+      toolName,
+      status: 'success',
+      result: { foo: 'bar' },
+    });
+
+    const found = await findBackgroundToolResult(callSid, toolName);
+    expect(found).not.toBeNull();
+    expect(found?.callSid).toBe(callSid);
+    expect(found?.toolName).toBe(toolName);
+  });
+
+  it('should return null when background tool result does not exist', async () => {
+    const found = await findBackgroundToolResult('non-existing-callSid', 'nonExistingTool');
+    expect(found).toBeNull();
+  });
+
+  it('should return all background tool results for a callSid ordered by createdAt', async () => {
+    const callSid = 'CA-background-call-4';
+
+    await upsertBackgroundToolResult({
+      callSid,
+      toolName: 'toolA',
+      status: 'pending',
+      result: null,
+    });
+
+    await new Promise((resolve) => setTimeout(resolve, 10));
+
+    await upsertBackgroundToolResult({
+      callSid,
+      toolName: 'toolB',
+      status: 'success',
+      result: { ok: true },
+    });
+
+    const results = await findBackgroundToolResultsByCallSid(callSid);
+    expect(results).toHaveLength(2);
+    expect(results[0].createdAt.getTime()).toBeLessThanOrEqual(results[1].createdAt.getTime());
+  });
+});
+

package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts

@@ -0,0 +1,65 @@
+import { Collection } from 'mongodb';
+import { getDb } from '../index';
+import {
+  BackgroundToolResult,
+  BackgroundToolResultDoc,
+  UpsertBackgroundToolResultInput,
+} from './backgroundToolResults.types';
+
+const getBackgroundToolResultsCollection = (): Collection<BackgroundToolResult> => {
+  return getDb().collection<BackgroundToolResult>('backgroundToolResults');
+};
+
+const upsertBackgroundToolResult = async (
+  input: UpsertBackgroundToolResultInput
+): Promise<BackgroundToolResultDoc | null> => {
+  const collection = getBackgroundToolResultsCollection();
+  const now = new Date();
+  const ttlMs = input.ttlMs ?? 60 * 60_000;
+  const expiredAt = new Date(now.getTime() + ttlMs);
+
+  const filter = { callSid: input.callSid, toolName: input.toolName };
+
+  await collection.updateOne(
+    filter,
+    {
+      $set: {
+        result: input.result,
+        status: input.status,
+        updatedAt: now,
+        expiredAt,
+      },
+      $setOnInsert: {
+        callSid: input.callSid,
+        toolName: input.toolName,
+        createdAt: now,
+      },
+    },
+    { upsert: true }
+  );
+
+  return collection.findOne(filter);
+};
+
+const findBackgroundToolResult = async (
+  callSid: string,
+  toolName: string
+): Promise<BackgroundToolResultDoc | null> => {
+  const collection = getBackgroundToolResultsCollection();
+  return collection.findOne({ callSid, toolName });
+};
+
+const findBackgroundToolResultsByCallSid = async (
+  callSid: string
+): Promise<BackgroundToolResultDoc[]> => {
+  const collection = getBackgroundToolResultsCollection();
+  return collection.find({ callSid }).sort({ createdAt: 1 }).toArray();
+};
+
+export {
+  getBackgroundToolResultsCollection,
+  upsertBackgroundToolResult,
+  findBackgroundToolResult,
+  findBackgroundToolResultsByCallSid,
+};
+

package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts

@@ -0,0 +1,24 @@
+import { WithId } from 'mongodb';
+
+export type BackgroundToolStatus = 'success' | 'pending' | 'error';
+
+export interface BackgroundToolResult {
+  callSid: string;
+  toolName: string;
+  result: unknown | null;
+  status: BackgroundToolStatus;
+  createdAt: Date;
+  updatedAt: Date;
+  expiredAt: Date;
+}
+
+export type BackgroundToolResultDoc = WithId<BackgroundToolResult>;
+
+export interface UpsertBackgroundToolResultInput {
+  callSid: string;
+  toolName: string;
+  result: unknown | null;
+  status: BackgroundToolStatus;
+  ttlMs?: number;
+}
+

package/src/talkpilot/backgroundToolResults/index.ts

@@ -0,0 +1,2 @@
+export * from './backgroundToolResults.getters';
+export type * from './backgroundToolResults.types';

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

@@ -7,6 +7,7 @@ describe('db.clientsConfig', () => {
       const clientId = 'test-client-id';
       const clientConfig = createClientConfig({
         clientId,
+        language: 'Hebrew',
         products: { feature1: true, feature2: false } as any,
       });
 
@@ -16,6 +17,7 @@ describe('db.clientsConfig', () => {
 
       expect(result).toMatchObject({
         clientId,
+        language: 'Hebrew',
         products: { feature1: true, feature2: false },
       });
     });
@@ -24,5 +26,38 @@ describe('db.clientsConfig', () => {
       const result = await getClientConfig('non-existent-client');
       expect(result).toBeNull();
     });
+
+    it('should support communications config', async () => {
+      const clientId = 'communications-test';
+      const clientConfig = createClientConfig({
+        clientId,
+        communications: {
+          sendGrid: {
+            emailTo: ['test@example.com'],
+            templateId: 'temp-123',
+            senderId: 'sender-123',
+          },
+          sms: {},
+          whatsapp: {},
+        },
+      });
+
+      await createClientConfigDoc(clientConfig);
+
+      const result = await getClientConfig(clientId);
+
+      expect(result).toMatchObject({
+        clientId,
+        communications: {
+          sendGrid: {
+            emailTo: ['test@example.com'],
+            templateId: 'temp-123',
+            senderId: 'sender-123',
+          },
+          sms: {},
+          whatsapp: {},
+        },
+      });
+    });
   });
 });

package/src/talkpilot/clientsConfig/clientsConfig.types.ts

@@ -1,8 +1,5 @@
 import { WithId } from 'mongodb';
 
-/**
- * Configuration for initiating a call for short SLA
- */
 export type InitiateCallForShortSlaConfig = {
   active: boolean;
   max_hours: number;
@@ -10,9 +7,6 @@ export type InitiateCallForShortSlaConfig = {
   flow_id?: string | string[];
 };
 
-/**
- * Moked 106 configuration structure
- */
 export type Moked106Config = {
   initiate_call_for_short_sla?: InitiateCallForShortSlaConfig;
   avoidSaveTickets?: boolean;
@@ -20,9 +14,6 @@ export type Moked106Config = {
   withNeedAttentionCalls?: boolean;
 };
 
-/**
- * Municipal products structure
- */
 export type MunicipalProduct = {
   moked_106?: Moked106Config;
   cityName: string;
@@ -35,23 +26,42 @@ export type MunicipalProduct = {
   municipalDisplayName?: string;
 };
 
-/**
- * Products structure
- */
 export type Products = {
   municipal?: MunicipalProduct;
-  [key: string]: unknown; // Allow other products
+  [key: string]: unknown;
+};
+
+export type ClientLanguageName =
+  | 'Hebrew'
+  | 'English'
+  | 'Russian'
+  | 'French'
+  | 'Spanish'
+  | (string & {});
+
+export type SendGridConfig = {
+  emailTo: string[];
+  templateId?: string;
+  senderId?: string;
+};
+
+export type SmsConfig = {};
+
+export type WhatsappConfig = {};
+
+export type CommunicationsConfig = {
+  sendGrid?: SendGridConfig;
+  sms: SmsConfig;
+  whatsapp: WhatsappConfig;
 };
 
-/**
- * Client configuration type
- * @template P - Products type (defaults to Products for type safety)
- */
 export type ClientConfig<P extends Products = Products> = {
   clientId: string;
   phoneNumber?: string;
+  language?: ClientLanguageName;
   products: P;
   timezone?: string;
+  communications?: CommunicationsConfig;
 };
 
 export type ClientConfigDoc<P extends Products = Products> = WithId<ClientConfig<P>>;

package/src/talkpilot/index.ts

@@ -13,6 +13,7 @@ export * from './groups';
 export * from './calls';
 export * from './clientAudioBuffers';
 export * from './clientsConfig';
+export * from './backgroundToolResults';
 export { mongodbClient } from './mongodb-client';
 
 let db: Db;