@promptbook/fake-llm 0.100.0-44 → 0.100.0-46

package/esm/typings/src/book-components/Chat/Chat/Chat.d.ts

@@ -0,0 +1,128 @@
+import type { CSSProperties, ReactNode } from 'react';
+import type { Promisable } from 'type-fest';
+import type { ChatMessage } from '../interfaces/ChatMessage';
+import type { ChatParticipant } from '../interfaces/ChatParticipant';
+/**
+ * @deprecated use `isComplete` instead
+ * @private util of `<Chat />`
+ */
+export declare const LOADING_INTERACTIVE_IMAGE = "Loading...";
+interface ChatProps {
+    /**
+     * Optional callback to create a new agent from the template.
+     * If provided, renders the [Use this template] button.
+     */
+    onUseTemplate?(): void;
+    /**
+     * Messages to render - they are rendered as they are
+     */
+    readonly messages: ReadonlyArray<ChatMessage>;
+    /**
+     * Called every time the user types or dictated a message
+     */
+    onChange?(messageContent: string): void;
+    /**
+     * Called when user sends a message
+     *
+     * Note: You must handle the message yourself and add it to the `messages` array
+     */
+    onMessage(messageContent: string): Promisable<void>;
+    /**
+     * Optional callback, when set, button for resetting chat will be shown
+     */
+    onReset?(): Promisable<void>;
+    /**
+     * Determines whether the voice recognition button is rendered
+     */
+    readonly isVoiceRecognitionButtonShown?: boolean;
+    /**
+     * The language code to use for voice recognition
+     */
+    readonly voiceLanguage?: string;
+    /**
+     * Optional placeholder message for the textarea
+     *
+     * @default "Write a message"
+     */
+    readonly placeholderMessageContent?: string;
+    /**
+     * Optional preset message in chat
+     */
+    readonly defaultMessage?: string;
+    /**
+     * List of tasks that are currently in progress that should be displayed
+     */
+    readonly tasksProgress?: Array<{
+        id: string;
+        name: string;
+        progress?: number;
+    }>;
+    /**
+     * Content to be shown inside the chat bar in head
+     * If not provided, the chat bar will not be rendered
+     */
+    readonly children?: ReactNode;
+    /**
+     * Optional CSS class name which will be added to root <div/> element
+     */
+    readonly className?: string;
+    /**
+     * Optional CSS style which will be added to root <div/> element
+     */
+    readonly style?: CSSProperties;
+    /**
+     * Voice call props - when provided, voice call button will be shown
+     */
+    readonly voiceCallProps?: {
+        selectedModel: string;
+        providerClients: Map<string, unknown>;
+        currentPersonaContent?: string;
+        onVoiceMessage?: (content: string, isVoiceCall: boolean) => void;
+        onAssistantVoiceResponse?: (content: string, isVoiceCall: boolean) => void;
+        onVoiceCallStateChange?: (isVoiceCalling: boolean) => void;
+    };
+    /**
+     * Indicates whether a voice call is currently active
+     */
+    readonly isVoiceCalling?: boolean;
+    /**
+     * Whether experimental features are enabled (required for voice calling)
+     */
+    readonly isExperimental?: boolean;
+    /**
+     * Whether the save button is enabled and shown
+     */
+    readonly isSaveButtonEnabled?: boolean;
+    /**
+     * Optional markdown header to include at the top of exported files.
+     * Example: "## Discussion Topic\n\nSome topic here"
+     */
+    readonly exportHeaderMarkdown?: string;
+    /**
+     * Optional mapping of participant IDs (message.from) to display metadata for exports.
+     * Keys should match ChatMessage.from values (e.g., 'USER', 'AGENT_{id}', etc.)
+     */
+    readonly participants?: ReadonlyArray<ChatParticipant>;
+}
+/**
+ * Renders a chat with messages and input for new messages
+ *
+ * Note: 🔇 This component does NOT have speak functionality, it just allows to trigger voice recognition
+ *
+ * Note: There are multiple chat components:
+ * - <Chat/> renders chat as it is without any logic
+ * - <SimpleChat/> with callback function after each message 🔵->🟢->🔵->🟢->🔵->🟢->...
+ * - <WorkerChat/> with continuously running worker function on background which binds on dialogues queue  🔵->🟢->🔵->🟢->🔵->🟢->...
+ * - <SignalChat/> fully controlled by signal that is passed in 🔵->🟢->🟢->🟢->🔵->🟢->...
+ * - <LlmChat/> connected to LLM Execution Tools of Promptbook
+ * - <AgentChat/> direct OpenAI API integration with streaming responses and model selection
+ * - <ChatbotMiniapp/> Fully working chatbot miniapp created from book
+ * - <AssistantChatPage/> page for assistant chat with welcome message and avatar
+ * - <ModelAwareChat/> wrapper around <Chat/> that provides model-aware avatars
+ *
+ * Use <WorkerChat/> or <SignalChat/> in most cases.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function Chat(props: ChatProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/typings/src/book-components/Chat/interfaces/ChatMessage.d.ts

@@ -0,0 +1,16 @@
+import type { string_markdown } from '../../../types/typeAliases';
+import type { string_name } from '../../../types/typeAliases';
+/**
+ * A message in the chat
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatMessage = {
+    id: string;
+    date: Date;
+    from: string_name;
+    content: string_markdown;
+    isComplete?: boolean;
+    expectedAnswer?: string;
+    isVoiceCall?: boolean;
+};

package/esm/typings/src/book-components/Chat/interfaces/ChatParticipant.d.ts

@@ -0,0 +1,12 @@
+import type { string_name } from '../../../types/typeAliases';
+import type { string_url_image } from '../../../types/typeAliases';
+/**
+ * A participant in the chat
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatParticipant = {
+    name: string_name;
+    avatarUrl?: string_url_image;
+    color: string;
+};

package/esm/typings/src/book-components/Chat/utils/ExportFormat.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @private utility of `<Chat/>` component
+ */
+export type ExportFormat = 'pdf' | 'txt' | 'md' | 'html' | 'json';

package/esm/typings/src/book-components/Chat/utils/addUtmParamsToUrl.d.ts

@@ -0,0 +1,7 @@
+import type { ExportFormat } from './ExportFormat';
+/**
+ * Utility: add UTM parameters to a URL for tracking
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function addUtmParamsToUrl(baseUrl: string, format: ExportFormat): string;

package/esm/typings/src/book-components/Chat/utils/createShortLinkForChat.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Create a short link for chat sharing.
+ * Simplified version without Supabase dependency.
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function createShortLinkForChat(utmUrl: string): Promise<string>;

package/esm/typings/src/book-components/Chat/utils/downloadFile.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Downloads a file with the given content and filename
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function downloadFile(content: string, filename: string, mimeType: string): void;

package/esm/typings/src/book-components/Chat/utils/exportChatHistory.d.ts

@@ -0,0 +1,11 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+import type { ExportFormat } from './ExportFormat';
+/**
+ * Exports chat messages in the specified format
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function exportChatHistory(messages: ChatMessage[], format: ExportFormat, headerMarkdown?: string, participants?: Record<string, {
+    name: string;
+    avatarUrl?: string;
+}>): Promise<void>;

package/esm/typings/src/book-components/Chat/utils/generatePdfContent.d.ts

@@ -0,0 +1,10 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+/**
+ * Generates PDF content using HTML and triggers print dialog
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function generatePdfContent(messages: ChatMessage[], shareUrl: string, qrDataUrl?: string | null, headerMarkdown?: string, participants?: Record<string, {
+    name: string;
+    avatarUrl?: string;
+}>): void;

package/esm/typings/src/book-components/Chat/utils/generateQrDataUrl.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility: generate a QR code data URL for a given text
+ * Simplified version without QR code library dependency
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function generateQrDataUrl(text: string): Promise<string | null>;

package/esm/typings/src/book-components/Chat/utils/getPromptbookBranding.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates Promptbook branding header for exported files
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function getPromptbookBranding(shareUrl: string): string;

package/esm/typings/src/book-components/Chat/utils/messagesToHtml.d.ts

@@ -0,0 +1,10 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+/**
+ * Converts chat messages to HTML format
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function messagesToHtml(messages: ChatMessage[], shareUrl: string, qrDataUrl?: string | null, headerMarkdown?: string, participants?: Record<string, {
+    name: string;
+    avatarUrl?: string;
+}>): string;

package/esm/typings/src/book-components/Chat/utils/messagesToJson.d.ts

@@ -0,0 +1,7 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+/**
+ * Converts chat messages to JSON format
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function messagesToJson(messages: ChatMessage[], shareUrl: string): string;

package/esm/typings/src/book-components/Chat/utils/messagesToMarkdown.d.ts

@@ -0,0 +1,10 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+/**
+ * Converts chat messages to Markdown format
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function messagesToMarkdown(messages: ChatMessage[], shareUrl: string, qrDataUrl?: string | null, headerMarkdown?: string, participants?: Record<string, {
+    name: string;
+    avatarUrl?: string;
+}>): string;

package/esm/typings/src/book-components/Chat/utils/messagesToText.d.ts

@@ -0,0 +1,10 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+/**
+ * Converts chat messages to plain text format
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function messagesToText(messages: ChatMessage[], shareUrl: string, headerMarkdown?: string, participants?: Record<string, {
+    name: string;
+    avatarUrl?: string;
+}>): string;

package/esm/typings/src/config.d.ts

@@ -301,6 +301,19 @@ export declare const DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME = "getPipelin
  * @public exported from `@promptbook/core`
  */
 export declare const DEFAULT_MAX_REQUESTS_PER_MINUTE = 60;
+/**
+ * API request timeout in milliseconds
+ * Can be overridden via API_REQUEST_TIMEOUT environment variable
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const API_REQUEST_TIMEOUT: number;
+/**
+ * URL of the Promptbook logo
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const PROMPTBOOK_LOGO_URL = "https://promptbook.studio/logos/logo-blue-white-256.png";
 /**
  * Indicates whether pipeline logic validation is enabled. When true, the pipeline logic is checked for consistency.
  *

package/esm/typings/src/execution/ExecutionTask.d.ts

@@ -20,7 +20,8 @@ type CreateTaskOptions<TTaskResult extends AbstractTaskResult> = {
     readonly title: AbstractTask<TTaskResult>['title'];
     /**
      * Callback that processes the task and updates the ongoing result
-     * @param ongoingResult The partial result of the task processing
+     * @param updateOngoingResult Function to update the partial result of the task processing
+     * @param updateTldr Function to update tldr progress information
      * @returns The final task result
      */
     taskProcessCallback(updateOngoingResult: (newOngoingResult: PartialDeep<TTaskResult> & {
@@ -28,20 +29,10 @@ type CreateTaskOptions<TTaskResult extends AbstractTaskResult> = {
          * Optional update of the task title
          */
         readonly title?: AbstractTask<TTaskResult>['title'];
-    }) => void): Promise<TTaskResult>;
-    /**
-     * Optional callback to provide custom tldr information
-     * @param createdAt When the task was created
-     * @param status Current task status
-     * @param currentValue Current partial result
-     * @param errors Current errors
-     * @param warnings Current warnings
-     * @returns Custom tldr information
-     */
-    tldrProvider?(createdAt: Date, status: task_status, currentValue: PartialDeep<TTaskResult>, errors: Array<Error>, warnings: Array<Error>): {
+    }) => void, updateTldr: (tldrInfo: {
         readonly percent: number_percent;
         readonly message: string;
-    };
+    }) => void): Promise<TTaskResult>;
 };
 /**
  * Helper to create a new task
@@ -119,6 +110,14 @@ export type AbstractTask<TTaskResult extends AbstractTaskResult> = {
      * Gets a promise that resolves with the task result
      */
     asPromise(options?: {
+        /**
+         * Do the task throws on error
+         *
+         * - If `true` when error occurs the returned promise will rejects
+         * - If `false` the promise will resolve with object with all listed errors and warnings and partial result
+         *
+         * @default true
+         */
         readonly isCrashedOnError?: boolean;
     }): Promise<TTaskResult>;
     /**

package/esm/typings/src/llm-providers/openai/OpenAiCompatibleExecutionTools.d.ts

@@ -82,6 +82,14 @@ export declare abstract class OpenAiCompatibleExecutionTools implements LlmExecu
      * Default model for completion variant.
      */
     protected abstract getDefaultEmbeddingModel(): AvailableModel;
+    /**
+     * Makes a request with retry logic for network errors like ECONNRESET
+     */
+    private makeRequestWithRetry;
+    /**
+     * Determines if an error is retryable (network-related errors)
+     */
+    private isRetryableNetworkError;
 }
 /**
  * TODO: [🛄] Some way how to re-wrap the errors from `OpenAiCompatibleExecutionTools`

package/esm/typings/src/playground/permanent/error-handling-playground.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env ts-node
+export {};
+/**
+ * Note: [⚫] Code in this file should never be published in any package
+ */

package/esm/typings/src/utils/organization/preserve.d.ts

@@ -0,0 +1,21 @@
+import type { really_any } from './really_any';
+/**
+ * Does nothing, but preserves the function in the bundle
+ * Compiler is tricked into thinking the function is used
+ *
+ * @param value any function to preserve
+ * @returns nothing
+ * @private within the repository
+ */
+export declare function $preserve(...value: Array<really_any>): void;
+/**
+ * DO NOT USE THIS FUNCTION
+ * Only purpose of this function is to trick the compiler and javascript engine
+ * that `_preserved` array can be used in the future and should not be garbage collected
+ *
+ * @private internal for `preserve`
+ */
+export declare function __DO_NOT_USE_getPreserved(): Array<really_any>;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.100.0-43`).
+ * It follows semantic versioning (e.g., `0.100.0-45`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/fake-llm",
-    "version": "0.100.0-44",
+    "version": "0.100.0-46",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -96,13 +96,11 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/fake-llm.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.100.0-44"
+        "@promptbook/core": "0.100.0-46"
     },
     "dependencies": {
         "crypto": "1.0.1",
         "lorem-ipsum": "2.0.8",
-        "prettier": "2.8.1",
-        "spacetrim": "0.11.59",
-        "waitasecond": "1.11.83"
+        "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('spacetrim'), require('crypto'), require('lorem-ipsum'), require('path'), require('prettier'), require('prettier/parser-html'), require('waitasecond')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'crypto', 'lorem-ipsum', 'path', 'prettier', 'prettier/parser-html', 'waitasecond'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-fake-llm"] = {}, global.spaceTrim, global.crypto, global.loremIpsum, null, global.prettier, global.parserHtml, global.waitasecond));
-})(this, (function (exports, spaceTrim, crypto, loremIpsum, path, prettier, parserHtml, waitasecond) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('crypto'), require('lorem-ipsum'), require('path'), require('prettier/parser-html'), require('prettier/parser-markdown'), require('prettier/standalone')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'crypto', 'lorem-ipsum', 'path', 'prettier/parser-html', 'prettier/parser-markdown', 'prettier/standalone'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-fake-llm"] = {}, global.spaceTrim, global.crypto, global.loremIpsum, null, global.parserHtml, global.parserMarkdown, global.standalone));
+})(this, (function (exports, spaceTrim, crypto, loremIpsum, path, parserHtml, parserMarkdown, standalone) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
     var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
     var parserHtml__default = /*#__PURE__*/_interopDefaultLegacy(parserHtml);
+    var parserMarkdown__default = /*#__PURE__*/_interopDefaultLegacy(parserMarkdown);
 
     // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
     /**
@@ -23,7 +24,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.100.0-44';
+    const PROMPTBOOK_ENGINE_VERSION = '0.100.0-46';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -202,6 +203,13 @@
         newline: '\n',
         skipEmptyLines: true,
     });
+    /**
+     * API request timeout in milliseconds
+     * Can be overridden via API_REQUEST_TIMEOUT environment variable
+     *
+     * @public exported from `@promptbook/core`
+     */
+    parseInt(process.env.API_REQUEST_TIMEOUT || '90000');
     /**
      * Note: [💞] Ignore a discrepancy between file name and entity name
      * TODO: [🧠][🧜‍♂️] Maybe join remoteServerUrl and path into single value
@@ -1997,9 +2005,9 @@
      */
     function prettifyMarkdown(content) {
         try {
-            return prettier.format(content, {
+            return standalone.format(content, {
                 parser: 'markdown',
-                plugins: [parserHtml__default["default"]],
+                plugins: [parserMarkdown__default["default"], parserHtml__default["default"]],
                 // TODO: DRY - make some import or auto-copy of .prettierrc
                 endOfLine: 'lf',
                 tabWidth: 4,
@@ -2022,31 +2030,23 @@
         }
     }
 
+    /**
+     * @private internal for `preserve`
+     */
+    const _preserved = [];
     /**
      * Does nothing, but preserves the function in the bundle
      * Compiler is tricked into thinking the function is used
      *
      * @param value any function to preserve
      * @returns nothing
-     * @private internal function of `JavascriptExecutionTools` and `JavascriptEvalExecutionTools`
-     */
-    function preserve(func) {
-        // Note: NOT calling the function
-        (async () => {
-            // TODO: [💩] Change to `await forEver` or `forTime(Infinity)`
-            await waitasecond.forTime(100000000);
-            // [1]
-            try {
-                await func();
-            }
-            finally {
-                // do nothing
-            }
-        })();
+     * @private within the repository
+     */
+    function $preserve(...value) {
+        _preserved.push(...value);
     }
     /**
-     * TODO: Probably remove in favour of `keepImported`
-     * TODO: [1] This maybe does memory leak
+     * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
     // Note: [💎]
@@ -2074,25 +2074,25 @@
             // Note: [💎]
             // Note: Using direct eval, following variables are in same scope as eval call so they are accessible from inside the evaluated script:
             const spaceTrim = (_) => spaceTrim__default["default"](_);
-            preserve(spaceTrim);
+            $preserve(spaceTrim);
             const removeQuotes$1 = removeQuotes;
-            preserve(removeQuotes$1);
+            $preserve(removeQuotes$1);
             const unwrapResult$1 = unwrapResult;
-            preserve(unwrapResult$1);
+            $preserve(unwrapResult$1);
             const trimEndOfCodeBlock$1 = trimEndOfCodeBlock;
-            preserve(trimEndOfCodeBlock$1);
+            $preserve(trimEndOfCodeBlock$1);
             const trimCodeBlock$1 = trimCodeBlock;
-            preserve(trimCodeBlock$1);
+            $preserve(trimCodeBlock$1);
             // TODO: DRY [🍯]
             const trim = (str) => str.trim();
-            preserve(trim);
+            $preserve(trim);
             // TODO: DRY [🍯]
             const reverse = (str) => str.split('').reverse().join('');
-            preserve(reverse);
+            $preserve(reverse);
             const removeEmojis$1 = removeEmojis;
-            preserve(removeEmojis$1);
+            $preserve(removeEmojis$1);
             const prettifyMarkdown$1 = prettifyMarkdown;
-            preserve(prettifyMarkdown$1);
+            $preserve(prettifyMarkdown$1);
             //-------[n12:]---
             const capitalize$1 = capitalize;
             const decapitalize$1 = decapitalize;
@@ -2108,18 +2108,18 @@
             // TODO: DRY [🍯]
             Array.from(parseKeywordsFromString(input)).join(', '); /* <- TODO: [🧠] What is the best format comma list, bullet list,...? */
             const normalizeTo_SCREAMING_CASE$1 = normalizeTo_SCREAMING_CASE;
-            preserve(capitalize$1);
-            preserve(decapitalize$1);
-            preserve(nameToUriPart$1);
-            preserve(nameToUriParts$1);
-            preserve(removeDiacritics$1);
-            preserve(normalizeWhitespaces$1);
-            preserve(normalizeToKebabCase$1);
-            preserve(normalizeTo_camelCase$1);
-            preserve(normalizeTo_snake_case$1);
-            preserve(normalizeTo_PascalCase$1);
-            preserve(parseKeywords);
-            preserve(normalizeTo_SCREAMING_CASE$1);
+            $preserve(capitalize$1);
+            $preserve(decapitalize$1);
+            $preserve(nameToUriPart$1);
+            $preserve(nameToUriParts$1);
+            $preserve(removeDiacritics$1);
+            $preserve(normalizeWhitespaces$1);
+            $preserve(normalizeToKebabCase$1);
+            $preserve(normalizeTo_camelCase$1);
+            $preserve(normalizeTo_snake_case$1);
+            $preserve(normalizeTo_PascalCase$1);
+            $preserve(parseKeywords);
+            $preserve(normalizeTo_SCREAMING_CASE$1);
             //-------[/n12]---
             if (!script.includes('return')) {
                 script = `return ${script}`;