@talkpilot/core-db 1.3.54 → 1.3.55

package/src/configuration/internalModels/internalModels.getters.ts

@@ -1,33 +1,33 @@
-import { getDb } from "../index";
-import { Collection, Filter } from "mongodb";
-import { InternalModel } from "./internalModels.types";
-import { INTERNAL_MODELS_COLLECTION } from "./internalModels.constants";
-
-export const getInternalModelsCollection = (): Collection<InternalModel> => {
-  return getDb().collection<InternalModel>(INTERNAL_MODELS_COLLECTION);
-};
-
-/**
- * Get an internal model config by its unique name
- */
-export const getInternalModelByName = async (
-  name: string
-): Promise<InternalModel | null> => {
-  return await getInternalModelsCollection().findOne({ name });
-};
-
-/**
- * Find internal models by filter.
- */
-export const findInternalModels = async (
-  filter: Filter<InternalModel> = {}
-): Promise<InternalModel[]> => {
-  return await getInternalModelsCollection().find(filter).toArray();
-};
-
-/**
- * Get all internal models.
- */
-export const getAllInternalModels = async (): Promise<InternalModel[]> => {
-  return await findInternalModels();
-};
+import { getDb } from "../index";
+import { Collection, Filter } from "mongodb";
+import { InternalModel } from "./internalModels.types";
+import { INTERNAL_MODELS_COLLECTION } from "./internalModels.constants";
+
+export const getInternalModelsCollection = (): Collection<InternalModel> => {
+  return getDb().collection<InternalModel>(INTERNAL_MODELS_COLLECTION);
+};
+
+/**
+ * Get an internal model config by its unique name
+ */
+export const getInternalModelByName = async (
+  name: string
+): Promise<InternalModel | null> => {
+  return await getInternalModelsCollection().findOne({ name });
+};
+
+/**
+ * Find internal models by filter.
+ */
+export const findInternalModels = async (
+  filter: Filter<InternalModel> = {}
+): Promise<InternalModel[]> => {
+  return await getInternalModelsCollection().find(filter).toArray();
+};
+
+/**
+ * Get all internal models.
+ */
+export const getAllInternalModels = async (): Promise<InternalModel[]> => {
+  return await findInternalModels();
+};

package/src/configuration/internalModels/internalModels.types.ts

@@ -1,12 +1,12 @@
-import { ObjectId } from "mongodb";
-
-export type InternalModel = {
-  _id: ObjectId;
-  /** Has to be unique between other names in collection */
-  name: string;
-  provider: string;
-  model: string;
-  config?: Record<string, unknown>;
-  createdAt: Date;
-  updatedAt: Date;
-};
+import { ObjectId } from "mongodb";
+
+export type InternalModel = {
+  _id: ObjectId;
+  /** Has to be unique between other names in collection */
+  name: string;
+  provider: string;
+  model: string;
+  config?: Record<string, unknown>;
+  createdAt: Date;
+  updatedAt: Date;
+};

package/src/configuration/models/__tests__/models.getters.spec.ts

@@ -0,0 +1,67 @@
+import { ObjectId } from "mongodb";
+import { MODELS_COLLECTION } from "../models.constants";
+import {
+  getModelsCollection,
+  getModelContextWindow,
+} from "../models.getters";
+import type { RealtimeModelDoc } from "../models.types";
+
+function realtimeModel(
+  overrides: Partial<RealtimeModelDoc> & Pick<RealtimeModelDoc, "modelId">,
+): RealtimeModelDoc {
+  const now = new Date();
+  return {
+    _id: new ObjectId(),
+    name: overrides.modelId,
+    type: "realtime",
+    provider: "openai",
+    available: true,
+    createdAt: now,
+    updatedAt: now,
+    ...overrides,
+  };
+}
+
+describe("getModelContextWindow", () => {
+  it("returns configDefaults.contextWindow for the model", async () => {
+    await getModelsCollection().insertOne(
+      realtimeModel({
+        modelId: "gpt-realtime",
+        configDefaults: { contextWindow: 32_000 },
+      }),
+    );
+
+    await expect(getModelContextWindow("gpt-realtime")).resolves.toBe(32_000);
+  });
+
+  it("returns null when the model is missing", async () => {
+    await expect(getModelContextWindow("missing-model")).resolves.toBeNull();
+  });
+
+  it("returns null when contextWindow is missing or not a positive number", async () => {
+    await getModelsCollection().insertMany([
+      realtimeModel({
+        modelId: "no-window",
+        configDefaults: {},
+      }),
+      realtimeModel({
+        modelId: "zero-window",
+        configDefaults: { contextWindow: 0 },
+      }),
+      realtimeModel({
+        modelId: "string-window",
+        configDefaults: { contextWindow: "64000" },
+      }),
+    ]);
+
+    await expect(getModelContextWindow("no-window")).resolves.toBeNull();
+    await expect(getModelContextWindow("zero-window")).resolves.toBeNull();
+    await expect(getModelContextWindow("string-window")).resolves.toBeNull();
+  });
+});
+
+describe("models collection", () => {
+  it(`uses the "${MODELS_COLLECTION}" collection`, () => {
+    expect(getModelsCollection().collectionName).toBe(MODELS_COLLECTION);
+  });
+});

package/src/configuration/models/index.ts

@@ -1,25 +1,27 @@
-export {
-  MODELS_COLLECTION,
-  MODEL_TYPES,
-  REALTIME_MODEL_PROVIDERS,
-  STT_MODEL_PROVIDERS,
-} from "./models.constants";
-export {
-  getModelsCollection,
-  findModels,
-  getModelByModelId,
-  getModelsByProvider,
-  getModelsByType,
-  getAvailableModelsByType,
-} from "./models.getters";
-export type {
-  ModelType,
-  RealtimeModelProvider,
-  SttModelProvider,
-  SemanticVad,
-  ServerVad,
-  TurnDetection,
-  RealtimeModelDoc,
-  SttModelDoc,
-  ModelDoc,
-} from "./models.types";
+export {
+  MODELS_COLLECTION,
+  MODEL_CONFIG_DEFAULTS_CONTEXT_WINDOW,
+  MODEL_TYPES,
+  REALTIME_MODEL_PROVIDERS,
+  STT_MODEL_PROVIDERS,
+} from "./models.constants";
+export {
+  getModelsCollection,
+  findModels,
+  getModelByModelId,
+  getModelContextWindow,
+  getModelsByProvider,
+  getModelsByType,
+  getAvailableModelsByType,
+} from "./models.getters";
+export type {
+  ModelType,
+  RealtimeModelProvider,
+  SttModelProvider,
+  SemanticVad,
+  ServerVad,
+  TurnDetection,
+  RealtimeModelDoc,
+  SttModelDoc,
+  ModelDoc,
+} from "./models.types";

package/src/configuration/models/models.constants.ts

@@ -1,13 +1,15 @@
-export const MODELS_COLLECTION = "models";
-
-export const MODEL_TYPES = ["realtime", "stt"] as const;
-
-export const REALTIME_MODEL_PROVIDERS = ["openai", "gemini", "xai"] as const;
-export const STT_MODEL_PROVIDERS = [
-  "openai-stt",
-  "google-stt",
-  "deepgram-stt",
-  "deepgram-flux",
-  "elevenlabs-scribe",
-  "gladia-stt",
-] as const;
+export const MODELS_COLLECTION = "models";
+
+export const MODEL_CONFIG_DEFAULTS_CONTEXT_WINDOW = "contextWindow";
+
+export const MODEL_TYPES = ["realtime", "stt"] as const;
+
+export const REALTIME_MODEL_PROVIDERS = ["openai", "gemini", "xai"] as const;
+export const STT_MODEL_PROVIDERS = [
+  "openai-stt",
+  "google-stt",
+  "deepgram-stt",
+  "deepgram-flux",
+  "elevenlabs-scribe",
+  "gladia-stt",
+] as const;

package/src/configuration/models/models.getters.ts

@@ -1,53 +1,71 @@
-import { Collection, Filter } from "mongodb";
-
-import { getDb } from "../index";
-import { MODELS_COLLECTION } from "./models.constants";
-import { ModelDoc, ModelType } from "./models.types";
-
-/** Raw typed handle to the `models` collection. */
-export const getModelsCollection = (): Collection<ModelDoc> => {
-  return getDb().collection<ModelDoc>(MODELS_COLLECTION);
-};
-
-/** Find models by an arbitrary filter. */
-export const findModels = async (
-  filter: Filter<ModelDoc> = {}
-): Promise<ModelDoc[]> => {
-  return await getModelsCollection().find(filter).toArray();
-};
-
-/**
- * Get a single model by its `modelId`, optionally scoped to a `type`.
- * @param modelId e.g. "deepgram-stt-phonecall"
- * @param type optional narrowing filter, since `modelId` isn't guaranteed unique across types
- */
-export const getModelByModelId = async (
-  modelId: string,
-  type?: ModelType
-): Promise<ModelDoc | null> => {
-  const filter = (type ? { modelId, type } : { modelId }) as Filter<ModelDoc>;
-  return await getModelsCollection().findOne(filter);
-};
-
-/**
- * Get all models for a given `provider`, optionally scoped to a `type`.
- */
-export const getModelsByProvider = async (
-  provider: string,
-  type?: ModelType
-): Promise<ModelDoc[]> => {
-  const filter = (type ? { provider, type } : { provider }) as Filter<ModelDoc>;
-  return await findModels(filter);
-};
-
-/** Get all models of a given `type`. */
-export const getModelsByType = async (type: ModelType): Promise<ModelDoc[]> => {
-  return await findModels({ type } as Filter<ModelDoc>);
-};
-
-/** Get all models of a given `type` where `available` is true. */
-export const getAvailableModelsByType = async (
-  type: ModelType
-): Promise<ModelDoc[]> => {
-  return await findModels({ type, available: true } as Filter<ModelDoc>);
-};
+import { Collection, Filter } from "mongodb";
+
+import { getDb } from "../index";
+import {
+  MODELS_COLLECTION,
+  MODEL_CONFIG_DEFAULTS_CONTEXT_WINDOW,
+} from "./models.constants";
+import { ModelDoc, ModelType } from "./models.types";
+
+/** Raw typed handle to the `models` collection. */
+export const getModelsCollection = (): Collection<ModelDoc> => {
+  return getDb().collection<ModelDoc>(MODELS_COLLECTION);
+};
+
+/** Find models by an arbitrary filter. */
+export const findModels = async (
+  filter: Filter<ModelDoc> = {},
+): Promise<ModelDoc[]> => {
+  return await getModelsCollection().find(filter).toArray();
+};
+
+/**
+ * Get a single model by its `modelId`, optionally scoped to a `type`.
+ * @param modelId e.g. "deepgram-stt-phonecall"
+ * @param type optional narrowing filter, since `modelId` isn't guaranteed unique across types
+ */
+export const getModelByModelId = async (
+  modelId: string,
+  type?: ModelType,
+): Promise<ModelDoc | null> => {
+  const filter = (type ? { modelId, type } : { modelId }) as Filter<ModelDoc>;
+  return await getModelsCollection().findOne(filter);
+};
+
+/**
+ * Token context window for a model (`configDefaults.contextWindow`).
+ * `null` when the model is missing or the value is not a positive number.
+ */
+export const getModelContextWindow = async (
+  modelId: string,
+): Promise<number | null> => {
+  const doc = await getModelByModelId(modelId);
+  const value = doc?.configDefaults?.[MODEL_CONFIG_DEFAULTS_CONTEXT_WINDOW];
+  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+    return null;
+  }
+  return Math.floor(value);
+};
+
+/**
+ * Get all models for a given `provider`, optionally scoped to a `type`.
+ */
+export const getModelsByProvider = async (
+  provider: string,
+  type?: ModelType,
+): Promise<ModelDoc[]> => {
+  const filter = (type ? { provider, type } : { provider }) as Filter<ModelDoc>;
+  return await findModels(filter);
+};
+
+/** Get all models of a given `type`. */
+export const getModelsByType = async (type: ModelType): Promise<ModelDoc[]> => {
+  return await findModels({ type } as Filter<ModelDoc>);
+};
+
+/** Get all models of a given `type` where `available` is true. */
+export const getAvailableModelsByType = async (
+  type: ModelType,
+): Promise<ModelDoc[]> => {
+  return await findModels({ type, available: true } as Filter<ModelDoc>);
+};

package/src/configuration/models/models.types.ts

@@ -1,79 +1,80 @@
-import { ObjectId } from "mongodb";
-
-import {
-  MODEL_TYPES,
-  REALTIME_MODEL_PROVIDERS,
-  STT_MODEL_PROVIDERS,
-} from "./models.constants";
-
-export type ModelType = (typeof MODEL_TYPES)[number];
-export type RealtimeModelProvider = (typeof REALTIME_MODEL_PROVIDERS)[number];
-export type SttModelProvider = (typeof STT_MODEL_PROVIDERS)[number];
-
-export type SemanticVad = {
-  type: "semantic_vad";
-  eagerness?: "low" | "medium" | "high" | "auto";
-  create_response?: boolean;
-  interrupt_response?: boolean;
-};
-
-export type ServerVad = {
-  type: "server_vad";
-  threshold: number;
-  prefix_padding_ms: number;
-  silence_duration_ms: number;
-  create_response?: boolean;
-  interrupt_response?: boolean;
-};
-
-export type TurnDetection = SemanticVad | ServerVad;
-
-type BaseModelDoc = {
-  _id: ObjectId;
-  /** Public identifier used by the provider, not to be confused with mongo id */
-  modelId: string;
-  name: string;
-  description?: string;
-  available: boolean;
-  configDefaults?: Record<string, unknown>;
-  createdAt: Date;
-  updatedAt: Date;
-};
-
-/** Realtime speech-to-speech model (OpenAI/Gemini). `features.vad` is turn-detection config. */
-export type RealtimeModelDoc = BaseModelDoc & {
-  type: "realtime";
-  provider: RealtimeModelProvider;
-  features?: {
-    supportsAudio?: boolean;
-    supportsText?: boolean;
-    vad?: TurnDetection;
-  };
-};
-
-/** STT engine/preset (openai-stt, google-stt, deepgram-stt/-flux, elevenlabs-scribe, gladia-stt). */
-export type SttModelDoc = BaseModelDoc & {
-  type: "stt";
-  provider: SttModelProvider;
-  features?: {
-    supportsAudio?: boolean;
-    supportsText?: boolean;
-  };
-};
-
-/**
- * A document in the `models` collection (configuration db). Discriminated by `type`.
- *
- * Common fields (all variants):
- * - `_id` — Mongo-managed ObjectId
- * - `modelId` — model's public identifier
- * - `name` — display name
- * - `description?` — display description
- * - `available` — whether the model should be offered/selectable right now
- * - `configDefaults?` — free-form provider-specific config, e.g. the literal vendor
- *   model string, VAD tuning, language, barge-in timings — shape varies per `provider`
- * - `createdAt` / `updatedAt`
- *
- * Type-specific fields: see {@link RealtimeModelDoc}, {@link SttModelDoc}.
- */
-export type ModelDoc = RealtimeModelDoc | SttModelDoc;
+import { ObjectId } from "mongodb";
+
+import {
+  MODEL_TYPES,
+  REALTIME_MODEL_PROVIDERS,
+  STT_MODEL_PROVIDERS,
+} from "./models.constants";
+
+export type ModelType = (typeof MODEL_TYPES)[number];
+export type RealtimeModelProvider = (typeof REALTIME_MODEL_PROVIDERS)[number];
+export type SttModelProvider = (typeof STT_MODEL_PROVIDERS)[number];
+
+export type SemanticVad = {
+  type: "semantic_vad";
+  eagerness?: "low" | "medium" | "high" | "auto";
+  create_response?: boolean;
+  interrupt_response?: boolean;
+};
+
+export type ServerVad = {
+  type: "server_vad";
+  threshold: number;
+  prefix_padding_ms: number;
+  silence_duration_ms: number;
+  create_response?: boolean;
+  interrupt_response?: boolean;
+};
+
+export type TurnDetection = SemanticVad | ServerVad;
+
+type BaseModelDoc = {
+  _id: ObjectId;
+  /** Public identifier used by the provider, not to be confused with mongo id */
+  modelId: string;
+  name: string;
+  description?: string;
+  available: boolean;
+  configDefaults?: Record<string, unknown>;
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+/** Realtime speech-to-speech model (OpenAI/Gemini). `features.vad` is turn-detection config. */
+export type RealtimeModelDoc = BaseModelDoc & {
+  type: "realtime";
+  provider: RealtimeModelProvider;
+  features?: {
+    supportsAudio?: boolean;
+    supportsText?: boolean;
+    vad?: TurnDetection;
+  };
+};
+
+/** STT engine/preset (openai-stt, google-stt, deepgram-stt/-flux, elevenlabs-scribe, gladia-stt). */
+export type SttModelDoc = BaseModelDoc & {
+  type: "stt";
+  provider: SttModelProvider;
+  features?: {
+    supportsAudio?: boolean;
+    supportsText?: boolean;
+  };
+};
+
+/**
+ * A document in the `models` collection (configuration db). Discriminated by `type`.
+ *
+ * Common fields (all variants):
+ * - `_id` — Mongo-managed ObjectId
+ * - `modelId` — model's public identifier
+ * - `name` — display name
+ * - `description?` — display description
+ * - `available` — whether the model should be offered/selectable right now
+ * - `configDefaults?` — free-form provider-specific config, e.g. the literal vendor
+ *   model string, VAD tuning, language, barge-in timings, `contextWindow` (token
+ *   budget) — shape varies per `provider`
+ * - `createdAt` / `updatedAt`
+ *
+ * Type-specific fields: see {@link RealtimeModelDoc}, {@link SttModelDoc}.
+ */
+export type ModelDoc = RealtimeModelDoc | SttModelDoc;

package/src/configuration/mongodb-client.ts

@@ -1,62 +1,62 @@
-import { MongoClient, Db } from "mongodb";
-import { setDb } from "./index";
-import { validateConfig, validateMongoUri } from "../utils/validation";
-import { configurationDbConfig } from "../config";
-
-class ConfigurationMongoDBClient {
-  private client: MongoClient | null = null;
-  private db: Db | null = null;
-  private readonly defaultDbName = "configuration";
-
-  async connect(uri?: string, dbName?: string): Promise<void> {
-    if (this.client) {
-      return;
-    }
-
-    const mongodbUri = uri || configurationDbConfig.mongoUri;
-    validateConfig("MONGO_URI", mongodbUri);
-    validateMongoUri(mongodbUri!);
-
-    try {
-      this.client = new MongoClient(mongodbUri!);
-      await this.client.connect();
-      const targetDbName =
-        dbName || configurationDbConfig.configurationDbName || this.defaultDbName;
-      this.db = this.client.db(targetDbName);
-      setDb(this.db);
-      console.info(`[core-db] Configuration MongoDB connected: ${targetDbName}`);
-    } catch (error) {
-      console.error("[core-db] Configuration connection failed", error);
-      throw error;
-    }
-  }
-
-  async disconnect(): Promise<void> {
-    if (this.client) {
-      try {
-        await this.client.close();
-        this.client = null;
-        this.db = null;
-        console.info("Configuration MongoDB disconnected successfully");
-      } catch (error) {
-        console.error("[core-db] Configuration disconnection failed", error);
-        throw error;
-      }
-    }
-  }
-
-  getDb(): Db {
-    if (!this.db) {
-      throw new Error(
-        "Configuration database not initialized. Call connect() first.",
-      );
-    }
-    return this.db;
-  }
-
-  isConnected(): boolean {
-    return this.client !== null && this.client !== undefined;
-  }
-}
-
-export const configurationMongodbClient = new ConfigurationMongoDBClient();
+import { MongoClient, Db } from "mongodb";
+import { setDb } from "./index";
+import { validateConfig, validateMongoUri } from "../utils/validation";
+import { configurationDbConfig } from "../config";
+
+class ConfigurationMongoDBClient {
+  private client: MongoClient | null = null;
+  private db: Db | null = null;
+  private readonly defaultDbName = "configuration";
+
+  async connect(uri?: string, dbName?: string): Promise<void> {
+    if (this.client) {
+      return;
+    }
+
+    const mongodbUri = uri || configurationDbConfig.mongoUri;
+    validateConfig("MONGO_URI", mongodbUri);
+    validateMongoUri(mongodbUri!);
+
+    try {
+      this.client = new MongoClient(mongodbUri!);
+      await this.client.connect();
+      const targetDbName =
+        dbName || configurationDbConfig.configurationDbName || this.defaultDbName;
+      this.db = this.client.db(targetDbName);
+      setDb(this.db);
+      console.info(`[core-db] Configuration MongoDB connected: ${targetDbName}`);
+    } catch (error) {
+      console.error("[core-db] Configuration connection failed", error);
+      throw error;
+    }
+  }
+
+  async disconnect(): Promise<void> {
+    if (this.client) {
+      try {
+        await this.client.close();
+        this.client = null;
+        this.db = null;
+        console.info("Configuration MongoDB disconnected successfully");
+      } catch (error) {
+        console.error("[core-db] Configuration disconnection failed", error);
+        throw error;
+      }
+    }
+  }
+
+  getDb(): Db {
+    if (!this.db) {
+      throw new Error(
+        "Configuration database not initialized. Call connect() first.",
+      );
+    }
+    return this.db;
+  }
+
+  isConnected(): boolean {
+    return this.client !== null && this.client !== undefined;
+  }
+}
+
+export const configurationMongodbClient = new ConfigurationMongoDBClient();

package/src/configuration/prompts/index.ts

@@ -1,2 +1,2 @@
-export * from "./prompts.getters";
-export type { Prompt } from "./prompts.types";
+export * from "./prompts.getters";
+export type { Prompt } from "./prompts.types";