@cellaware/utils 3.3.34 → 3.4.35

package/dist/azure/cosmos.d.ts

@@ -1,16 +1,86 @@
+/**
+ * Returns the current date time
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosCurrentDateTime(timeZone?: string): string;
+/**
+ * Returns the record's date time using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosTimestampDateTime(timeZone?: string): string;
+/**
+ * Returns the current year
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosCurrentYear(timeZone?: string): string;
+/**
+ * Returns the record's year using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosTimestampYear(timeZone?: string): string;
+/**
+ * Returns the current month
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosCurrentMonth(timeZone?: string): string;
+/**
+ * Returns the record's month using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosTimestampMonth(timeZone?: string): string;
+/**
+ * Returns the current day
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosCurrentDay(timeZone?: string): string;
+/**
+ * Returns the record's day using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosTimestampDay(timeZone?: string): string;
+/**
+ * Returns the record's hour using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosTimestampHour(timeZone?: string): string;
+/**
+ * Returns the record's minute using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosTimestampMinute(timeZone?: string): string;
+/**
+ * Returns the record's second using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosTimestampSecond(timeZone?: string): string;
+/**
+ * Returns a `WHERE` clause to retrieve records with a `_ts` of today
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosCurrentDayWhereClause(timeZone?: string): string;
+/**
+ * Returns a `WHERE` clause to retrieve records with a `_ts` of this month
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosCurrentMonthWhereClause(timeZone?: string): string;
+/**
+ * Returns a `WHERE` clause to retrieve records with a `_ts` of this year
+ *
+ * NOTE: default time zone is UTC
+ */
 export declare function getCosmosCurrentYearWhereClause(timeZone?: string): string;
 export declare function cosmosSelect(databaseId: string, collectionId: string, partitionKey: string, query: string): Promise<any[]>;
 export declare function cosmosInsert(databaseId: string, collectionId: string, partitionKey: string, data: any): Promise<boolean>;

package/dist/azure/cosmos.js

@@ -28,45 +28,115 @@ function getCosmosTimeZoneHourDiff(timeZone) {
     }
     return diff;
 }
+/**
+ * Returns the current date time
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosCurrentDateTime(timeZone) {
     return `DateTimeAdd("hh", ${getCosmosTimeZoneHourDiff(timeZone)}, ${COSMOS_CURRENT_DATETIME})`;
 }
+/**
+ * Returns the record's date time using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosTimestampDateTime(timeZone) {
     return `DateTimeAdd("hh", ${getCosmosTimeZoneHourDiff(timeZone)}, ${COSMOS_TIMESTAMP_DATETIME})`;
 }
+/**
+ * Returns the current year
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosCurrentYear(timeZone) {
     return `DateTimePart('yyyy', ${getCosmosCurrentDateTime(timeZone)})`;
 }
+/**
+ * Returns the record's year using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosTimestampYear(timeZone) {
     return `DateTimePart('yyyy', ${getCosmosTimestampDateTime(timeZone)})`;
 }
+/**
+ * Returns the current month
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosCurrentMonth(timeZone) {
     return `DateTimePart('mm', ${getCosmosCurrentDateTime(timeZone)})`;
 }
+/**
+ * Returns the record's month using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosTimestampMonth(timeZone) {
     return `DateTimePart('mm', ${getCosmosTimestampDateTime(timeZone)})`;
 }
+/**
+ * Returns the current day
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosCurrentDay(timeZone) {
     return `DateTimePart('dd', ${getCosmosCurrentDateTime(timeZone)})`;
 }
+/**
+ * Returns the record's day using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosTimestampDay(timeZone) {
     return `DateTimePart('dd', ${getCosmosTimestampDateTime(timeZone)})`;
 }
+/**
+ * Returns the record's hour using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosTimestampHour(timeZone) {
     return `DateTimePart('hh', ${getCosmosTimestampDateTime(timeZone)})`;
 }
+/**
+ * Returns the record's minute using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosTimestampMinute(timeZone) {
     return `DateTimePart('mi', ${getCosmosTimestampDateTime(timeZone)})`;
 }
+/**
+ * Returns the record's second using the `_ts` field
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosTimestampSecond(timeZone) {
     return `DateTimePart('ss', ${getCosmosTimestampDateTime(timeZone)})`;
 }
+/**
+ * Returns a `WHERE` clause to retrieve records with a `_ts` of today
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosCurrentDayWhereClause(timeZone) {
     return `DateTimeDiff('dd', ${getCosmosTimestampDateTime(timeZone)}, ${getCosmosCurrentDateTime(timeZone)}) = 0`;
 }
+/**
+ * Returns a `WHERE` clause to retrieve records with a `_ts` of this month
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosCurrentMonthWhereClause(timeZone) {
     return `DateTimeDiff('mm', ${getCosmosTimestampDateTime(timeZone)}, ${getCosmosCurrentDateTime(timeZone)}) = 0`;
 }
+/**
+ * Returns a `WHERE` clause to retrieve records with a `_ts` of this year
+ *
+ * NOTE: default time zone is UTC
+ */
 export function getCosmosCurrentYearWhereClause(timeZone) {
     return `DateTimeDiff('yyyy', ${getCosmosTimestampDateTime(timeZone)}, ${getCosmosCurrentDateTime(timeZone)}) = 0`;
 }

package/dist/llm/chain-store.d.ts

@@ -1,5 +1,5 @@
 import { BaseChain } from 'langchain/chains';
-import { ModelName } from './model.js';
+import { ModelName, ModelOptions } from './model.js';
 /**
  * `SingleActionChain` only supports single interaction with LLM, and only 1
  * output key is allowed. Output key is defaulted to `answer`.
@@ -38,11 +38,10 @@ export declare class ChainStore {
     /**
      * - `name`: Chain name
      * - `template`: Template chain name to copy prompt from
-     * - `modelName`: OpenAI model name
-     * - `temperature`: OpenAI model temperature
+     * - `options`: LLM options
      * - `verbose`: OpenAI verbose parameter
      */
-    addChain(name: string, template: string | null, modelName: ModelName, temperature?: number, verbose?: boolean): void;
+    addChain(name: string, template: string | null, options: ModelOptions, verbose?: boolean): void;
     addExistingChain(chain: SingleActionChain): void;
     callChain(name: string, args: any, tokenUsages: any[]): Promise<import("langchain/dist/schema/index.js").ChainValues>;
     translate(statement: string, language: string, tokenUsages?: any[]): Promise<string>;

package/dist/llm/chain-store.js

@@ -185,18 +185,25 @@ Your translation here:
     /**
      * - `name`: Chain name
      * - `template`: Template chain name to copy prompt from
-     * - `modelName`: OpenAI model name
-     * - `temperature`: OpenAI model temperature
+     * - `options`: LLM options
      * - `verbose`: OpenAI verbose parameter
      */
-    addChain(name, template, modelName, temperature, verbose) {
+    addChain(name, template, options, verbose) {
         const prompt = this.getPrompt(name, template);
-        const llm = new ChatOpenAI({
-            modelName, temperature: temperature ?? 0, configuration: {
+        let llmArgs = {
+            modelName: options.modelName,
+            temperature: options.temperature ?? 0,
+            configuration: {
                 organization: process.env.OPENAI_ORGANIZATION,
                 timeout: CHAIN_TIMEOUT_MS
             }
-        });
+        };
+        if (!!options.openai) {
+            if (!!options.openai.reasoning_effort) {
+                llmArgs.reasoning_effort = options.openai.reasoning_effort;
+            }
+        }
+        const llm = new ChatOpenAI(llmArgs);
         const chain = new SingleActionChain({
             llm,
             prompt: prompt.content,

package/dist/llm/cost.js

@@ -1,4 +1,4 @@
-// https://openai.com/pricing
+// https://openai.com/api/pricing/
 export function getLLMCostPerToken(modelName) {
     let inputCost = 0.0;
     let outputCost = 0.0;
@@ -15,6 +15,10 @@ export function getLLMCostPerToken(modelName) {
             inputCost = 0.003;
             outputCost = 0.012;
             break;
+        case 'o3-mini':
+            inputCost = 0.0011;
+            outputCost = 0.0044;
+            break;
         case 'gpt-4o':
             inputCost = 0.005;
             outputCost = 0.015;

package/dist/llm/model.d.ts

@@ -1 +1,10 @@
-export type ModelName = 'o1' | 'o1-preview' | 'o1-mini' | 'gpt-4o' | 'gpt-4o-2024-08-06' | 'gpt-4o-mini' | 'gpt-4-turbo' | 'gpt-4' | 'gpt-4-32k' | 'gpt-3.5-turbo';
+export type ModelName = 'o1' | 'o1-preview' | 'o1-mini' | 'o3-mini' | 'gpt-4o' | 'gpt-4o-2024-08-06' | 'gpt-4o-mini' | 'gpt-4-turbo' | 'gpt-4' | 'gpt-4-32k' | 'gpt-3.5-turbo';
+export type ReasoningEffort = 'low' | 'medium' | 'high';
+export interface OpenAIModelOptions {
+    reasoning_effort?: ReasoningEffort;
+}
+export interface ModelOptions {
+    modelName: string;
+    temperature?: number;
+    openai?: OpenAIModelOptions;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cellaware/utils",
-    "version": "3.3.34",
+    "version": "3.4.35",
     "description": "Cellaware Utilities for Node.js",
     "author": "Cellaware Technologies",
     "type": "module",