@promptbook/openai 0.89.0-9 → 0.92.0-10

package/esm/typings/src/storage/env-storage/$EnvStorage.d.ts

@@ -0,0 +1,40 @@
+import type { PromptbookStorage } from '../_common/PromptbookStorage';
+/**
+ * Stores data in .env variables
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file and also writes to `process.env`
+ *
+ * @private within the repository - for CLI utils
+ */
+export declare class $EnvStorage<TItem> implements PromptbookStorage<TItem> {
+    private envFilename;
+    private $provideOrCreateEnvFile;
+    private transformKey;
+    /**
+     * Returns the number of key/value pairs currently present in the list associated with the object.
+     */
+    get length(): number;
+    /**
+     * Empties the list associated with the object of all key/value pairs, if there are any.
+     */
+    clear(): void;
+    /**
+     * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
+     */
+    getItem(key: string): Promise<TItem | null>;
+    /**
+     * Returns the name of the nth key in the list, or null if n is greater than or equal to the number of key/value pairs in the object.
+     */
+    key(index: number): string | null;
+    /**
+     * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+     */
+    setItem(key: string, value: TItem): Promise<void>;
+    /**
+     * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
+     */
+    removeItem(key: string): void;
+}
+/**
+ * TODO: Write file more securely - ensure that there can be no accidental overwriting of existing variables and other content
+ */

package/esm/typings/src/types/typeAliases.d.ts

@@ -325,6 +325,12 @@ export type string_css_selector = string;
  * For example `"https://collboard.com/9SeSQTupmQHwuSrLi"`
  */
 export type string_url = string;
+/**
+ * Semantic helper
+ *
+ * For example `"https://s1.ptbk.io/promptbook"`
+ */
+export type string_promptbook_server_url = string;
 /**
  * Semantic helper
  *
@@ -408,6 +414,13 @@ export type string_host = string;
  * Semantic helper
  */
 export type string_protocol = 'http:' | 'https:';
+/**
+ * Semantic helper
+ *
+ * For example `"192.168.1.1"` (IPv4)
+ * For example `"2001:0db8:85a3:0000:0000:8a2e:0370:7334"` (IPv6)
+ */
+export type string_ip_address = string;
 /**
  * Semantic helper
  *
@@ -521,6 +534,13 @@ export type string_person_profile = string;
  * For example `"MIT"`
  */
 export type string_license = string;
+/**
+ * Semantic helper
+ *
+ * For example `"Pavol Hejný <pavol@ptbk.io> (https://www.pavolhejny.com/)"`
+ * For example `"AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)"`
+ */
+export type string_legal_entity = string | string_person_profile | string_title;
 /**
  * Semantic helper for attributes
  *
@@ -570,6 +590,12 @@ export type string_postprocessing_function_name = string;
 export type id = string | number;
 export type task_id = string;
 export type string_token = string;
+/**
+ * Semantic helper
+ *
+ * Made by `identificationToPromptbookToken` exported from `@promptbook/core`
+ */
+export type string_promptbook_token = string_token;
 export type string_license_token = string_token;
 export type string_password = string;
 export type string_ssh_key = string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/openai",
-    "version": "0.89.0-9",
+    "version": "0.92.0-10",
     "description": "It's time for a paradigm shift. The future of software in plain English, French or Latin",
     "private": false,
     "sideEffects": false,
@@ -43,15 +43,20 @@
         "url": "https://github.com/webgptorg/promptbook/issues"
     },
     "homepage": "https://ptbk.io/",
+    "engines": {
+        "node": ">=16.0.0",
+        "npm": ">=8.0.0"
+    },
     "main": "./umd/index.umd.js",
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/openai.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.89.0-9"
+        "@promptbook/core": "0.92.0-10"
     },
     "dependencies": {
+        "bottleneck": "^2.19.5",
         "colors": "1.4.0",
-        "crypto": "^1.0.1",
+        "crypto": "1.0.1",
         "openai": "4.63.0",
         "spacetrim": "0.11.59"
     }

package/umd/index.umd.js

@@ -1,13 +1,14 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('spacetrim'), require('crypto'), require('openai')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'spacetrim', 'crypto', 'openai'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-openai"] = {}, global.colors, global.spaceTrim, global.crypto, global.OpenAI));
-})(this, (function (exports, colors, spaceTrim, crypto, OpenAI) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('spacetrim'), require('crypto'), require('bottleneck'), require('openai')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'spacetrim', 'crypto', 'bottleneck', 'openai'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-openai"] = {}, global.colors, global.spaceTrim, global.crypto, global.Bottleneck, global.OpenAI));
+})(this, (function (exports, colors, spaceTrim, crypto, Bottleneck, OpenAI) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
     var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
     var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
+    var Bottleneck__default = /*#__PURE__*/_interopDefaultLegacy(Bottleneck);
     var OpenAI__default = /*#__PURE__*/_interopDefaultLegacy(OpenAI);
 
     // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
@@ -24,7 +25,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.89.0-9';
+    const PROMPTBOOK_ENGINE_VERSION = '0.92.0-10';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -124,7 +125,7 @@
         }
     }
     /**
-     * TODO: !!!!!! Add id to all errors
+     * TODO: [🧠][🌂] Add id to all errors
      */
 
     /**
@@ -274,6 +275,7 @@
         infinity: '(infinity; ∞)',
         negativeInfinity: '(negative infinity; -∞)',
         unserializable: '(unserializable value)',
+        circular: '(circular JSON)',
     };
     /**
      * Small number limit
@@ -381,6 +383,54 @@
         }
     }
 
+    /**
+     * This error type indicates that somewhere in the code non-Error object was thrown and it was wrapped into the `WrappedError`
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class WrappedError extends Error {
+        constructor(whatWasThrown) {
+            const tag = `[🤮]`;
+            console.error(tag, whatWasThrown);
+            super(spaceTrim.spaceTrim(`
+                Non-Error object was thrown
+
+                Note: Look for ${tag} in the console for more details
+                Please report issue on ${ADMIN_EMAIL}
+            `));
+            this.name = 'WrappedError';
+            Object.setPrototypeOf(this, WrappedError.prototype);
+        }
+    }
+
+    /**
+     * Helper used in catch blocks to assert that the error is an instance of `Error`
+     *
+     * @param whatWasThrown Any object that was thrown
+     * @returns Nothing if the error is an instance of `Error`
+     * @throws `WrappedError` or `UnexpectedError` if the error is not standard
+     *
+     * @private within the repository
+     */
+    function assertsError(whatWasThrown) {
+        // Case 1: Handle error which was rethrown as `WrappedError`
+        if (whatWasThrown instanceof WrappedError) {
+            const wrappedError = whatWasThrown;
+            throw wrappedError;
+        }
+        // Case 2: Handle unexpected errors
+        if (whatWasThrown instanceof UnexpectedError) {
+            const unexpectedError = whatWasThrown;
+            throw unexpectedError;
+        }
+        // Case 3: Handle standard errors - keep them up to consumer
+        if (whatWasThrown instanceof Error) {
+            return;
+        }
+        // Case 4: Handle non-standard errors - wrap them into `WrappedError` and throw
+        throw new WrappedError(whatWasThrown);
+    }
+
     /**
      * Checks if the value is [🚉] serializable as JSON
      * If not, throws an UnexpectedError with a rich error message and tracking
@@ -472,9 +522,7 @@
                     JSON.stringify(value); // <- TODO: [0]
                 }
                 catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
+                    assertsError(error);
                     throw new UnexpectedError(spaceTrim__default["default"]((block) => `
                             \`${name}\` is not serializable
 
@@ -696,13 +744,19 @@
                 return value.toISOString();
             }
             else {
-                return JSON.stringify(value);
+                try {
+                    return JSON.stringify(value);
+                }
+                catch (error) {
+                    if (error instanceof TypeError && error.message.includes('circular structure')) {
+                        return VALUE_STRINGS.circular;
+                    }
+                    throw error;
+                }
             }
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             console.error(error);
             return VALUE_STRINGS.unserializable;
         }
@@ -1226,9 +1280,10 @@
                 modelVariant: 'COMPLETION',
                 modelTitle: 'davinci-002',
                 modelName: 'davinci-002',
+                modelDescription: 'Legacy completion model with strong performance on text generation tasks. Optimized for complex instructions and longer outputs.',
                 pricing: {
                     prompt: computeUsage(`$2.00 / 1M tokens`),
-                    output: computeUsage(`$2.00 / 1M tokens`), // <- not sure
+                    output: computeUsage(`$2.00 / 1M tokens`),
                 },
             },
             /**/
@@ -1243,6 +1298,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-16k',
                 modelName: 'gpt-3.5-turbo-16k',
+                modelDescription: 'GPT-3.5 Turbo with extended 16k token context length for handling longer conversations and documents.',
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$4.00 / 1M tokens`),
@@ -1266,6 +1322,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4',
                 modelName: 'gpt-4',
+                modelDescription: 'GPT-4 is a powerful language model with enhanced reasoning, instruction-following capabilities, and 8K context window. Optimized for complex tasks requiring deep understanding.',
                 pricing: {
                     prompt: computeUsage(`$30.00 / 1M tokens`),
                     output: computeUsage(`$60.00 / 1M tokens`),
@@ -1277,6 +1334,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-32k',
                 modelName: 'gpt-4-32k',
+                modelDescription: 'Extended context version of GPT-4 with a 32K token window for processing very long inputs and generating comprehensive responses for complex tasks.',
                 pricing: {
                     prompt: computeUsage(`$60.00 / 1M tokens`),
                     output: computeUsage(`$120.00 / 1M tokens`),
@@ -1299,6 +1357,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-turbo-2024-04-09',
                 modelName: 'gpt-4-turbo-2024-04-09',
+                modelDescription: 'Latest stable GPT-4 Turbo model from April 2024 with enhanced reasoning and context handling capabilities. Offers 128K context window and improved performance.',
                 pricing: {
                     prompt: computeUsage(`$10.00 / 1M tokens`),
                     output: computeUsage(`$30.00 / 1M tokens`),
@@ -1310,6 +1369,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-1106',
                 modelName: 'gpt-3.5-turbo-1106',
+                modelDescription: 'November 2023 version of GPT-3.5 Turbo with improved instruction following and a 16K token context window.',
                 pricing: {
                     prompt: computeUsage(`$1.00 / 1M tokens`),
                     output: computeUsage(`$2.00 / 1M tokens`),
@@ -1321,6 +1381,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-turbo',
                 modelName: 'gpt-4-turbo',
+                modelDescription: 'More capable model than GPT-4 with improved instruction following, function calling and a 128K token context window for handling very large documents.',
                 pricing: {
                     prompt: computeUsage(`$10.00 / 1M tokens`),
                     output: computeUsage(`$30.00 / 1M tokens`),
@@ -1332,6 +1393,7 @@
                 modelVariant: 'COMPLETION',
                 modelTitle: 'gpt-3.5-turbo-instruct-0914',
                 modelName: 'gpt-3.5-turbo-instruct-0914',
+                modelDescription: 'September 2023 version of GPT-3.5 Turbo optimized for completion-style instruction following with a 4K context window.',
                 pricing: {
                     prompt: computeUsage(`$1.50  / 1M tokens`),
                     output: computeUsage(`$2.00 / 1M tokens`), // <- For gpt-3.5-turbo-instruct
@@ -1343,6 +1405,7 @@
                 modelVariant: 'COMPLETION',
                 modelTitle: 'gpt-3.5-turbo-instruct',
                 modelName: 'gpt-3.5-turbo-instruct',
+                modelDescription: 'Optimized version of GPT-3.5 for completion-style API with good instruction following and a 4K token context window.',
                 pricing: {
                     prompt: computeUsage(`$1.50  / 1M tokens`),
                     output: computeUsage(`$2.00 / 1M tokens`),
@@ -1360,9 +1423,10 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo',
                 modelName: 'gpt-3.5-turbo',
+                modelDescription: 'Latest version of GPT-3.5 Turbo with improved performance and instruction following capabilities. Default 4K context window with options for 16K.',
                 pricing: {
-                    prompt: computeUsage(`$3.00 / 1M tokens`),
-                    output: computeUsage(`$6.00 / 1M tokens`), // <- Not sure, refer to gpt-3.5-turbo in Fine-tuning models
+                    prompt: computeUsage(`$0.50 / 1M tokens`),
+                    output: computeUsage(`$1.50 / 1M tokens`),
                 },
             },
             /**/
@@ -1371,6 +1435,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-0301',
                 modelName: 'gpt-3.5-turbo-0301',
+                modelDescription: 'March 2023 version of GPT-3.5 Turbo with a 4K token context window. Legacy model maintained for backward compatibility.',
                 pricing: {
                     prompt: computeUsage(`$1.50 / 1M tokens`),
                     output: computeUsage(`$2.00 / 1M tokens`),
@@ -1382,9 +1447,10 @@
                 modelVariant: 'COMPLETION',
                 modelTitle: 'babbage-002',
                 modelName: 'babbage-002',
+                modelDescription: 'Efficient legacy completion model with a good balance of performance and speed. Suitable for straightforward text generation tasks.',
                 pricing: {
                     prompt: computeUsage(`$0.40 / 1M tokens`),
-                    output: computeUsage(`$0.40 / 1M tokens`), // <- Not sure
+                    output: computeUsage(`$0.40 / 1M tokens`),
                 },
             },
             /**/
@@ -1393,6 +1459,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-1106-preview',
                 modelName: 'gpt-4-1106-preview',
+                modelDescription: 'November 2023 preview version of GPT-4 Turbo with improved instruction following and a 128K token context window.',
                 pricing: {
                     prompt: computeUsage(`$10.00 / 1M tokens`),
                     output: computeUsage(`$30.00 / 1M tokens`),
@@ -1404,6 +1471,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-0125-preview',
                 modelName: 'gpt-4-0125-preview',
+                modelDescription: 'January 2024 preview version of GPT-4 Turbo with improved reasoning capabilities and a 128K token context window.',
                 pricing: {
                     prompt: computeUsage(`$10.00 / 1M tokens`),
                     output: computeUsage(`$30.00 / 1M tokens`),
@@ -1421,6 +1489,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-0125',
                 modelName: 'gpt-3.5-turbo-0125',
+                modelDescription: 'January 2024 version of GPT-3.5 Turbo with improved reasoning capabilities and a 16K token context window.',
                 pricing: {
                     prompt: computeUsage(`$0.50 / 1M tokens`),
                     output: computeUsage(`$1.50  / 1M tokens`),
@@ -1432,9 +1501,10 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-turbo-preview',
                 modelName: 'gpt-4-turbo-preview',
+                modelDescription: 'Preview version of GPT-4 Turbo that points to the latest model version. Features improved instruction following, 128K token context window and lower latency.',
                 pricing: {
                     prompt: computeUsage(`$10.00 / 1M tokens`),
-                    output: computeUsage(`$30.00 / 1M tokens`), // <- Not sure, just for gpt-4-turbo
+                    output: computeUsage(`$30.00 / 1M tokens`),
                 },
             },
             /**/
@@ -1443,6 +1513,7 @@
                 modelVariant: 'EMBEDDING',
                 modelTitle: 'text-embedding-3-large',
                 modelName: 'text-embedding-3-large',
+                modelDescription: "OpenAI's most capable text embedding model designed for high-quality embeddings for complex similarity tasks and information retrieval.",
                 pricing: {
                     prompt: computeUsage(`$0.13  / 1M tokens`),
                     // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
@@ -1455,6 +1526,7 @@
                 modelVariant: 'EMBEDDING',
                 modelTitle: 'text-embedding-3-small',
                 modelName: 'text-embedding-3-small',
+                modelDescription: 'Cost-effective embedding model with good performance for simpler tasks like text similarity and retrieval. Good balance of quality and efficiency.',
                 pricing: {
                     prompt: computeUsage(`$0.02 / 1M tokens`),
                     // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
@@ -1467,6 +1539,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-0613',
                 modelName: 'gpt-3.5-turbo-0613',
+                modelDescription: 'June 2023 version of GPT-3.5 Turbo with function calling capabilities and a 4K token context window.',
                 pricing: {
                     prompt: computeUsage(`$1.50 / 1M tokens`),
                     output: computeUsage(`$2.00 / 1M tokens`),
@@ -1478,6 +1551,7 @@
                 modelVariant: 'EMBEDDING',
                 modelTitle: 'text-embedding-ada-002',
                 modelName: 'text-embedding-ada-002',
+                modelDescription: 'Legacy text embedding model suitable for text similarity and retrieval augmented generation use cases. Replaced by newer embedding-3 models.',
                 pricing: {
                     prompt: computeUsage(`$0.1 / 1M tokens`),
                     // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
@@ -1508,11 +1582,11 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4o-2024-05-13',
                 modelName: 'gpt-4o-2024-05-13',
+                modelDescription: 'May 2024 version of GPT-4o with enhanced multimodal capabilities, improved reasoning, and optimized for vision, audio and chat at lower latencies.',
                 pricing: {
                     prompt: computeUsage(`$5.00 / 1M tokens`),
                     output: computeUsage(`$15.00 / 1M tokens`),
                 },
-                //TODO: [main] !!3 Add gpt-4o-mini-2024-07-18 and all others to be up to date
             },
             /**/
             /**/
@@ -1520,6 +1594,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4o',
                 modelName: 'gpt-4o',
+                modelDescription: "OpenAI's most advanced multimodal model optimized for performance, speed, and cost. Capable of vision, reasoning, and high quality text generation.",
                 pricing: {
                     prompt: computeUsage(`$5.00 / 1M tokens`),
                     output: computeUsage(`$15.00 / 1M tokens`),
@@ -1527,10 +1602,23 @@
             },
             /**/
             /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4o-mini',
+                modelName: 'gpt-4o-mini',
+                modelDescription: 'Smaller, more cost-effective version of GPT-4o with good performance across text, vision, and audio tasks at reduced complexity.',
+                pricing: {
+                    prompt: computeUsage(`$3.00 / 1M tokens`),
+                    output: computeUsage(`$9.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
             {
                 modelVariant: 'CHAT',
                 modelTitle: 'o1-preview',
                 modelName: 'o1-preview',
+                modelDescription: 'Advanced reasoning model with exceptional performance on complex logical, mathematical, and analytical tasks. Built for deep reasoning and specialized professional tasks.',
                 pricing: {
                     prompt: computeUsage(`$15.00 / 1M tokens`),
                     output: computeUsage(`$60.00 / 1M tokens`),
@@ -1542,6 +1630,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'o1-preview-2024-09-12',
                 modelName: 'o1-preview-2024-09-12',
+                modelDescription: 'September 2024 version of O1 preview with specialized reasoning capabilities for complex tasks requiring precise analytical thinking.',
                 //             <- TODO: [💩] Some better system to organize theese date suffixes and versions
                 pricing: {
                     prompt: computeUsage(`$15.00 / 1M tokens`),
@@ -1554,6 +1643,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'o1-mini',
                 modelName: 'o1-mini',
+                modelDescription: 'Smaller, cost-effective version of the O1 model with good performance on reasoning tasks while maintaining efficiency for everyday analytical use.',
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$12.00 / 1M tokens`),
@@ -1565,10 +1655,10 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'o1',
                 modelName: 'o1',
+                modelDescription: "OpenAI's advanced reasoning model focused on logic and problem-solving. Designed for complex analytical tasks with rigorous step-by-step reasoning. 128K context window.",
                 pricing: {
-                    prompt: computeUsage(`$3.00 / 1M tokens`),
-                    output: computeUsage(`$12.00 / 1M tokens`),
-                    // <- TODO: !! Unsure, check the pricing
+                    prompt: computeUsage(`$15.00 / 1M tokens`),
+                    output: computeUsage(`$60.00 / 1M tokens`),
                 },
             },
             /**/
@@ -1577,6 +1667,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'o3-mini',
                 modelName: 'o3-mini',
+                modelDescription: 'Cost-effective reasoning model optimized for academic and scientific problem-solving. Efficient performance on STEM tasks with deep mathematical and scientific knowledge. 128K context window.',
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$12.00 / 1M tokens`),
@@ -1589,6 +1680,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'o1-mini-2024-09-12',
                 modelName: 'o1-mini-2024-09-12',
+                modelDescription: "September 2024 version of O1-mini with balanced reasoning capabilities and cost-efficiency. Good for analytical tasks that don't require the full O1 model.",
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$12.00 / 1M tokens`),
@@ -1600,12 +1692,14 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-16k-0613',
                 modelName: 'gpt-3.5-turbo-16k-0613',
+                modelDescription: 'June 2023 version of GPT-3.5 Turbo with extended 16k token context window for processing longer conversations and documents.',
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$4.00 / 1M tokens`),
                 },
             },
             /**/
+            // <- [🕕]
         ],
     });
     /**
@@ -1667,6 +1761,9 @@
      * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
      */
 
+    // Default rate limits (requests per minute) - adjust as needed based on OpenAI tier
+    const DEFAULT_RPM = 60;
+    // <- TODO: !!! Put in some better place
     /**
      * Execution Tools for calling OpenAI API
      *
@@ -1684,6 +1781,10 @@
              * OpenAI API client.
              */
             this.client = null;
+            // TODO: Allow configuring rate limits via options
+            this.limiter = new Bottleneck__default["default"]({
+                minTime: 60000 / (this.options.maxRequestsPerMinute || DEFAULT_RPM),
+            });
         }
         get title() {
             return 'OpenAI';
@@ -1787,7 +1888,10 @@
             if (this.options.isVerbose) {
                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
             }
-            const rawResponse = await client.chat.completions.create(rawRequest).catch((error) => {
+            const rawResponse = await this.limiter
+                .schedule(() => client.chat.completions.create(rawRequest))
+                .catch((error) => {
+                assertsError(error);
                 if (this.options.isVerbose) {
                     console.info(colors__default["default"].bgRed('error'), error);
                 }
@@ -1863,7 +1967,10 @@
             if (this.options.isVerbose) {
                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
             }
-            const rawResponse = await client.completions.create(rawRequest).catch((error) => {
+            const rawResponse = await this.limiter
+                .schedule(() => client.completions.create(rawRequest))
+                .catch((error) => {
+                assertsError(error);
                 if (this.options.isVerbose) {
                     console.info(colors__default["default"].bgRed('error'), error);
                 }
@@ -1926,7 +2033,10 @@
             if (this.options.isVerbose) {
                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
             }
-            const rawResponse = await client.embeddings.create(rawRequest).catch((error) => {
+            const rawResponse = await this.limiter
+                .schedule(() => client.embeddings.create(rawRequest))
+                .catch((error) => {
+                assertsError(error);
                 if (this.options.isVerbose) {
                     console.info(colors__default["default"].bgRed('error'), error);
                 }