@promptbook/anthropic-claude 0.66.0 → 0.67.0-0

package/esm/index.es.js

@@ -1,13 +1,13 @@
+import spaceTrim$1, { spaceTrim } from 'spacetrim';
 import Anthropic from '@anthropic-ai/sdk';
 import colors from 'colors';
-import spaceTrim$1, { spaceTrim } from 'spacetrim';
 import { io } from 'socket.io-client';
 
 // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
 /**
  * The version of the Promptbook library
  */
-var PROMPTBOOK_VERSION = '0.66.0-9';
+var PROMPTBOOK_VERSION = '0.66.0';
 // TODO: !!!! List here all the versions and annotate + put into script
 
 /*! *****************************************************************************
@@ -119,6 +119,199 @@ function __read(o, n) {
     return ar;
 }
 
+/**
+ * @@@
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it mutates given object
+ * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+ *
+ * @returns The same object as the input, but deeply frozen
+ * @public exported from `@promptbook/utils`
+ */
+function $deepFreeze(objectValue) {
+    var e_1, _a;
+    var propertyNames = Object.getOwnPropertyNames(objectValue);
+    try {
+        for (var propertyNames_1 = __values(propertyNames), propertyNames_1_1 = propertyNames_1.next(); !propertyNames_1_1.done; propertyNames_1_1 = propertyNames_1.next()) {
+            var propertyName = propertyNames_1_1.value;
+            var value = objectValue[propertyName];
+            if (value && typeof value === 'object') {
+                $deepFreeze(value);
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (propertyNames_1_1 && !propertyNames_1_1.done && (_a = propertyNames_1.return)) _a.call(propertyNames_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return Object.freeze(objectValue);
+}
+/**
+ * TODO: [🧠] Is there a way how to meaningfully test this utility
+ */
+
+/**
+ * This error type indicates that the error should not happen and its last check before crashing with some other error
+ *
+ * @public exported from `@promptbook/core`
+ */
+var UnexpectedError = /** @class */ (function (_super) {
+    __extends(UnexpectedError, _super);
+    function UnexpectedError(message) {
+        var _this = _super.call(this, spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
+        _this.name = 'UnexpectedError';
+        Object.setPrototypeOf(_this, UnexpectedError.prototype);
+        return _this;
+    }
+    return UnexpectedError;
+}(Error));
+
+/**
+ * Checks if the value is [🚉] serializable as JSON
+ * If not, throws an UnexpectedError with a rich error message and tracking
+ *
+ * - Almost all primitives are serializable BUT:
+ * - `undefined` is not serializable
+ * - `NaN` is not serializable
+ * - Objects and arrays are serializable if all their properties are serializable
+ * - Functions are not serializable
+ * - Circular references are not serializable
+ * - `Date` objects are not serializable
+ * - `Map` and `Set` objects are not serializable
+ * - `RegExp` objects are not serializable
+ * - `Error` objects are not serializable
+ * - `Symbol` objects are not serializable
+ * - And much more...
+ *
+ * @throws UnexpectedError if the value is not serializable as JSON
+ * @public exported from `@promptbook/utils`
+ */
+function checkSerializableAsJson(name, value) {
+    var e_1, _a;
+    if (value === undefined) {
+        throw new UnexpectedError("".concat(name, " is undefined"));
+    }
+    else if (value === null) {
+        return;
+    }
+    else if (typeof value === 'boolean') {
+        return;
+    }
+    else if (typeof value === 'number' && !isNaN(value)) {
+        return;
+    }
+    else if (typeof value === 'string') {
+        return;
+    }
+    else if (typeof value === 'symbol') {
+        throw new UnexpectedError("".concat(name, " is symbol"));
+    }
+    else if (typeof value === 'function') {
+        throw new UnexpectedError("".concat(name, " is function"));
+    }
+    else if (typeof value === 'object' && Array.isArray(value)) {
+        for (var i = 0; i < value.length; i++) {
+            checkSerializableAsJson("".concat(name, "[").concat(i, "]"), value[i]);
+        }
+    }
+    else if (typeof value === 'object') {
+        if (value instanceof Date) {
+            throw new UnexpectedError(spaceTrim$1("\n                    ".concat(name, " is Date\n\n                    Use `string_date_iso8601` instead\n                ")));
+        }
+        else if (value instanceof Map) {
+            throw new UnexpectedError("".concat(name, " is Map"));
+        }
+        else if (value instanceof Set) {
+            throw new UnexpectedError("".concat(name, " is Set"));
+        }
+        else if (value instanceof RegExp) {
+            throw new UnexpectedError("".concat(name, " is RegExp"));
+        }
+        else if (value instanceof Error) {
+            throw new UnexpectedError(spaceTrim$1("\n                    ".concat(name, " is unserialized Error\n\n                    Use function `serializeError`\n                ")));
+        }
+        else {
+            try {
+                for (var _b = __values(Object.entries(value)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                    var _d = __read(_c.value, 2), subName = _d[0], subValue = _d[1];
+                    if (subValue === undefined) {
+                        // Note: undefined in object is serializable - it is just omited
+                        continue;
+                    }
+                    checkSerializableAsJson("".concat(name, ".").concat(subName), subValue);
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            try {
+                JSON.stringify(value); // <- TODO: [0]
+            }
+            catch (error) {
+                if (!(error instanceof Error)) {
+                    throw error;
+                }
+                throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                            ".concat(name, " is not serializable\n\n                            ").concat(block(error.toString()), "\n                        "); }));
+            }
+            /*
+            TODO: [0] Is there some more elegant way to check circular references?
+            const seen = new Set();
+            const stack = [{ value }];
+            while (stack.length > 0) {
+                const { value } = stack.pop()!;
+                if (typeof value === 'object' && value !== null) {
+                    if (seen.has(value)) {
+                        throw new UnexpectedError(`${name} has circular reference`);
+                    }
+                    seen.add(value);
+                    if (Array.isArray(value)) {
+                        stack.push(...value.map((value) => ({ value })));
+                    } else {
+                        stack.push(...Object.values(value).map((value) => ({ value })));
+                    }
+                }
+            }
+            */
+            return;
+        }
+    }
+    else {
+        throw new UnexpectedError("".concat(name, " is unknown"));
+    }
+}
+/**
+ * TODO: [🧠][🛣] More elegant way to tracking than passing `name`
+ * TODO: [🧠] !!! In-memory cache of same values to prevent multiple checks
+ * Note: [🐠] This is how `checkSerializableAsJson` + `isSerializableAsJson` together can just retun true/false or rich error message
+ */
+
+/**
+ * @@@
+ * @@@
+ *
+ * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+ *
+ * @param name - Name of the object for debugging purposes
+ * @param objectValue - Object to be deeply frozen
+ * @returns The same object as the input, but deeply frozen
+ * @private this is in comparison to `deepFreeze` a more specific utility and maybe not very good practice to use without specific reason and considerations
+ */
+function $asDeeplyFrozenSerializableJson(name, objectValue) {
+    checkSerializableAsJson(name, objectValue);
+    return $deepFreeze(objectValue);
+}
+/**
+ * TODO: [🧠][🛣] More elegant way to tracking than passing `name`
+ * TODO: [🧠] Is there a way how to meaningfully test this utility
+ */
+
 /**
  * Function computeUsage will create price per one token based on the string value found on openai page
  *
@@ -137,7 +330,7 @@ function computeUsage(value) {
  * @see https://docs.anthropic.com/en/docs/models-overview
  * @public exported from `@promptbook/anthropic-claude`
  */
-var ANTHROPIC_CLAUDE_MODELS = [
+var ANTHROPIC_CLAUDE_MODELS = $asDeeplyFrozenSerializableJson('ANTHROPIC_CLAUDE_MODELS', [
     {
         modelVariant: 'CHAT',
         modelTitle: 'Claude 3.5 Sonnet',
@@ -202,7 +395,7 @@ var ANTHROPIC_CLAUDE_MODELS = [
         },
     },
     // TODO: !!! Claude 1 and 2 has also completion versions - ask Hoagy
-];
+]);
 /**
  * Note: [🤖] Add models of new variant
  * TODO: [🧠] !!! Add embedding models OR Anthropic has only chat+completion models?
@@ -227,22 +420,6 @@ var PipelineExecutionError = /** @class */ (function (_super) {
     return PipelineExecutionError;
 }(Error));
 
-/**
- * This error type indicates that the error should not happen and its last check before crashing with some other error
- *
- * @public exported from `@promptbook/core`
- */
-var UnexpectedError = /** @class */ (function (_super) {
-    __extends(UnexpectedError, _super);
-    function UnexpectedError(message) {
-        var _this = _super.call(this, spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
-        _this.name = 'UnexpectedError';
-        Object.setPrototypeOf(_this, UnexpectedError.prototype);
-        return _this;
-    }
-    return UnexpectedError;
-}(Error));
-
 /**
  * Get current date in ISO 8601 format
  *
@@ -252,40 +429,6 @@ function getCurrentIsoDate() {
     return new Date().toISOString();
 }
 
-/**
- * @@@
- *
- * Note: `$` is used to indicate that this function is not a pure function - it mutates given object
- * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
- *
- * @returns The same object as the input, but deeply frozen
- * @public exported from `@promptbook/utils`
- */
-function $deepFreeze(objectValue) {
-    var e_1, _a;
-    var propertyNames = Object.getOwnPropertyNames(objectValue);
-    try {
-        for (var propertyNames_1 = __values(propertyNames), propertyNames_1_1 = propertyNames_1.next(); !propertyNames_1_1.done; propertyNames_1_1 = propertyNames_1.next()) {
-            var propertyName = propertyNames_1_1.value;
-            var value = objectValue[propertyName];
-            if (value && typeof value === 'object') {
-                $deepFreeze(value);
-            }
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (propertyNames_1_1 && !propertyNames_1_1.done && (_a = propertyNames_1.return)) _a.call(propertyNames_1);
-        }
-        finally { if (e_1) throw e_1.error; }
-    }
-    return Object.freeze(objectValue);
-}
-/**
- * TODO: [🧠] Is there a way how to meaningfully test this utility
- */
-
 // <- TODO: [🧠] Better system for generator warnings - not always "code" and "by `@promptbook/cli`"
 /**
  * The maximum number of iterations for a loops
@@ -304,7 +447,7 @@ var REPLACING_NONCE = 'u$k42k%!V2zo34w7Fu#@QUHYPW';
  *
  * @public exported from `@promptbook/core`
  */
-$deepFreeze([
+$asDeeplyFrozenSerializableJson('RESERVED_PARAMETER_NAMES', [
     'content',
     'context',
     'knowledge',
@@ -964,7 +1107,7 @@ var AnthropicClaudeExecutionTools = /** @class */ (function () {
                         // eslint-disable-next-line prefer-const
                         complete = getCurrentIsoDate();
                         usage = computeAnthropicClaudeUsage(content, '', rawResponse);
-                        return [2 /*return*/, {
+                        return [2 /*return*/, $asDeeplyFrozenSerializableJson('AnthropicClaudeExecutionTools ChatPromptResult', {
                                 content: resultContent,
                                 modelName: rawResponse.model,
                                 timing: {
@@ -976,7 +1119,7 @@ var AnthropicClaudeExecutionTools = /** @class */ (function () {
                                 rawRequest: rawRequest,
                                 rawResponse: rawResponse,
                                 // <- [🗯]
-                            }];
+                            })];
                 }
             });
         });
@@ -985,7 +1128,7 @@ var AnthropicClaudeExecutionTools = /** @class */ (function () {
     TODO: [👏]
     public async callCompletionModel(
         prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements'>,
-    ): Promise<PromptCompletionResult> {
+    ): Promise<CompletionPromptResult> {
 
         if (this.options.isVerbose) {
             console.info('🖋 Anthropic Claude callCompletionModel call');
@@ -1038,7 +1181,7 @@ var AnthropicClaudeExecutionTools = /** @class */ (function () {
 
 
 
-        return {
+        return $asDeeplyFrozenSerializableJson('AnthropicClaudeExecutionTools CompletionPromptResult',{
             content: resultContent,
             modelName: rawResponse.model || model,
             timing: {
@@ -1048,7 +1191,7 @@ var AnthropicClaudeExecutionTools = /** @class */ (function () {
             usage,
             rawResponse,
             // <- [🗯]
-        };
+        });
     }
     */
     // <- Note: [🤖] callXxxModel
@@ -1088,6 +1231,150 @@ var AnthropicClaudeExecutionTools = /** @class */ (function () {
  * TODO: [📅] Maybe instead of `RemoteLlmExecutionToolsOptions` use `proxyWithAnonymousRemoteServer` (if implemented)
  */
 
+/**
+ * This error indicates that the pipeline collection cannot be propperly loaded
+ *
+ * @public exported from `@promptbook/core`
+ */
+var CollectionError = /** @class */ (function (_super) {
+    __extends(CollectionError, _super);
+    function CollectionError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'CollectionError';
+        Object.setPrototypeOf(_this, CollectionError.prototype);
+        return _this;
+    }
+    return CollectionError;
+}(Error));
+
+/**
+ * This error type indicates that you try to use a feature that is not available in the current environment
+ *
+ * @public exported from `@promptbook/core`
+ */
+var EnvironmentMismatchError = /** @class */ (function (_super) {
+    __extends(EnvironmentMismatchError, _super);
+    function EnvironmentMismatchError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'EnvironmentMismatchError';
+        Object.setPrototypeOf(_this, EnvironmentMismatchError.prototype);
+        return _this;
+    }
+    return EnvironmentMismatchError;
+}(Error));
+
+/**
+ * This error indicates that promptbook not found in the collection
+ *
+ * @public exported from `@promptbook/core`
+ */
+var NotFoundError = /** @class */ (function (_super) {
+    __extends(NotFoundError, _super);
+    function NotFoundError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'NotFoundError';
+        Object.setPrototypeOf(_this, NotFoundError.prototype);
+        return _this;
+    }
+    return NotFoundError;
+}(Error));
+
+/**
+ * This error type indicates that some part of the code is not implemented yet
+ *
+ * @public exported from `@promptbook/core`
+ */
+var NotYetImplementedError = /** @class */ (function (_super) {
+    __extends(NotYetImplementedError, _super);
+    function NotYetImplementedError(message) {
+        var _this = _super.call(this, spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This feature is not implemented yet but it will be soon.\n\n                    If you want speed up the implementation or just read more, look here:\n                    https://github.com/webgptorg/promptbook\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
+        _this.name = 'NotYetImplementedError';
+        Object.setPrototypeOf(_this, NotYetImplementedError.prototype);
+        return _this;
+    }
+    return NotYetImplementedError;
+}(Error));
+
+/**
+ * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+ *
+ * @public exported from `@promptbook/core`
+ */
+var ParsingError = /** @class */ (function (_super) {
+    __extends(ParsingError, _super);
+    function ParsingError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'ParsingError';
+        Object.setPrototypeOf(_this, ParsingError.prototype);
+        return _this;
+    }
+    return ParsingError;
+}(Error));
+
+/**
+ * This error indicates that the promptbook object has valid syntax but contains logical errors (like circular dependencies)
+ *
+ * @public exported from `@promptbook/core`
+ */
+var PipelineLogicError = /** @class */ (function (_super) {
+    __extends(PipelineLogicError, _super);
+    function PipelineLogicError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'PipelineLogicError';
+        Object.setPrototypeOf(_this, PipelineLogicError.prototype);
+        return _this;
+    }
+    return PipelineLogicError;
+}(Error));
+
+/**
+ * This error indicates errors in referencing promptbooks between each other
+ *
+ * @public exported from `@promptbook/core`
+ */
+var PipelineUrlError = /** @class */ (function (_super) {
+    __extends(PipelineUrlError, _super);
+    function PipelineUrlError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'PipelineUrlError';
+        Object.setPrototypeOf(_this, PipelineUrlError.prototype);
+        return _this;
+    }
+    return PipelineUrlError;
+}(Error));
+
+/**
+ * Index of all custom errors
+ *
+ * @public exported from `@promptbook/core`
+ */
+var ERRORS = {
+    CollectionError: CollectionError,
+    EnvironmentMismatchError: EnvironmentMismatchError,
+    LimitReachedError: LimitReachedError,
+    NotFoundError: NotFoundError,
+    NotYetImplementedError: NotYetImplementedError,
+    ParsingError: ParsingError,
+    PipelineExecutionError: PipelineExecutionError,
+    PipelineLogicError: PipelineLogicError,
+    PipelineUrlError: PipelineUrlError,
+    UnexpectedError: UnexpectedError,
+    // TODO: [🪑]> VersionMismatchError,
+};
+
+/**
+ * Deserializes the error object
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function deserializeError(error) {
+    if (error.name === 'Error') {
+        return new Error(error.message);
+    }
+    var CustomError = ERRORS[error.name];
+    return new CustomError(error.message);
+}
+
 /**
  * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
  *
@@ -1148,13 +1435,13 @@ var RemoteLlmExecutionTools = /** @class */ (function () {
                             socket.emit('listModels-request', {
                                 isAnonymous: true,
                                 llmToolsConfiguration: this.options.llmToolsConfiguration,
-                            });
+                            } /* <- TODO: [🤛] */);
                         }
                         else {
                             socket.emit('listModels-request', {
                                 isAnonymous: false,
                                 clientId: this.options.clientId,
-                            });
+                            } /* <- TODO: [🤛] */);
                         }
                         return [4 /*yield*/, new Promise(function (resolve, reject) {
                                 socket.on('listModels-response', function (response) {
@@ -1162,7 +1449,7 @@ var RemoteLlmExecutionTools = /** @class */ (function () {
                                     socket.disconnect();
                                 });
                                 socket.on('error', function (error) {
-                                    reject(new Error(error.errorMessage));
+                                    reject(deserializeError(error));
                                     socket.disconnect();
                                 });
                             })];
@@ -1241,16 +1528,14 @@ var RemoteLlmExecutionTools = /** @class */ (function () {
                                 isAnonymous: true,
                                 llmToolsConfiguration: this.options.llmToolsConfiguration,
                                 prompt: prompt,
-                                // <- TODO: [🛫] `prompt` is NOT fully serializable as JSON, it contains functions which are not serializable
-                            });
+                            } /* <- TODO: [🤛] */);
                         }
                         else {
                             socket.emit('prompt-request', {
                                 isAnonymous: false,
                                 clientId: this.options.clientId,
                                 prompt: prompt,
-                                // <- TODO: [🛫] `prompt` is NOT fully serializable as JSON, it contains functions which are not serializable
-                            });
+                            } /* <- TODO: [🤛] */);
                         }
                         return [4 /*yield*/, new Promise(function (resolve, reject) {
                                 socket.on('prompt-response', function (response) {
@@ -1258,7 +1543,7 @@ var RemoteLlmExecutionTools = /** @class */ (function () {
                                     socket.disconnect();
                                 });
                                 socket.on('error', function (error) {
-                                    reject(new PipelineExecutionError(error.errorMessage));
+                                    reject(deserializeError(error));
                                     socket.disconnect();
                                 });
                             })];
@@ -1273,6 +1558,7 @@ var RemoteLlmExecutionTools = /** @class */ (function () {
     return RemoteLlmExecutionTools;
 }());
 /**
+ * TODO: Maybe use `$asDeeplyFrozenSerializableJson`
  * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
  * TODO: [🍓] Allow to list compatible models with each variant
  * TODO: [🗯] RemoteLlmExecutionTools should extend Destroyable and implement IDestroyable
@@ -1314,14 +1600,11 @@ var createAnthropicClaudeExecutionTools = Object.assign(function (options) {
  *
  * Note: `$` is used to indicate that this function is not a pure function - it access global scope
  *
- * @public exported from `@promptbook/utils`
+ *  @private internal function of `$Register`
  */
 function $getGlobalScope() {
     return Function('return this')();
 }
-/***
- * TODO: !!!!! Make private and promptbook registry from this
- */
 
 /**
  * Register is @@@