@promptbook/wizard 0.100.0-6 → 0.100.0-61

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

@@ -1,4 +1,5 @@
 import type { Promisable } from 'type-fest';
+import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
 import type { Prompt } from '../types/Prompt';
 import type { string_markdown } from '../types/typeAliases';
 import type { string_markdown_text } from '../types/typeAliases';
@@ -27,6 +28,13 @@ export type LlmExecutionTools = {
      * @example "Use all models from OpenAI"
      */
     readonly description?: string_markdown;
+    /**
+     * Profile representing the model as a virtual persona for chat interfaces
+     * This includes visual identity like avatar, colors, and display information
+     *
+     * @example { name: 'OPENAI', fullname: 'OpenAI GPT', color: '#10a37f', avatarSrc: '/openai-logo.png' }
+     */
+    readonly profile?: ChatParticipant;
     /**
      * Check comfiguration
      *

package/esm/typings/src/execution/createPipelineExecutor/40-executeAttempts.d.ts

@@ -1,10 +1,11 @@
-import type { ReadonlyDeep, WritableDeep } from 'type-fest';
+import type { PartialDeep, Promisable, ReadonlyDeep, WritableDeep } from 'type-fest';
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
 import type { Parameters } from '../../types/typeAliases';
 import type { string_parameter_name } from '../../types/typeAliases';
 import type { TODO_string } from '../../utils/organization/TODO_string';
 import type { ExecutionReportJson } from '../execution-report/ExecutionReportJson';
+import type { PipelineExecutorResult } from '../PipelineExecutorResult';
 import type { CreatePipelineExecutorOptions } from './00-CreatePipelineExecutorOptions';
 /**
  * Options for executing attempts of a pipeline task, including configuration for jokers, priority,
@@ -46,6 +47,10 @@ export type ExecuteAttemptsOptions = Required<Omit<CreatePipelineExecutorOptions
      * The pipeline structure prepared for execution, as a deeply immutable PipelineJson object.
      */
     readonly preparedPipeline: ReadonlyDeep<PipelineJson>;
+    /**
+     * Callback invoked with partial results as the execution progresses.
+     */
+    onProgress(newOngoingResult: PartialDeep<PipelineExecutorResult>): Promisable<void>;
     /**
      * The execution report object, which is updated during execution.
      */

package/esm/typings/src/llm-providers/_common/filterModels.d.ts

@@ -10,6 +10,3 @@ import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
  * @public exported from `@promptbook/core`
  */
 export declare function filterModels<TLlmTools extends LlmExecutionTools>(llmTools: TLlmTools, predicate: (model: AvailableModel) => boolean): TLlmTools;
-/**
- * TODO: !!! [models] Test that this is working
- */

package/esm/typings/src/llm-providers/_common/profiles/llmProviderProfiles.d.ts

@@ -0,0 +1,81 @@
+import type { ChatParticipant } from '../../../book-components/Chat/types/ChatParticipant';
+/**
+ * Predefined profiles for LLM providers to maintain consistency across the application
+ * These profiles represent each provider as a virtual persona in chat interfaces
+ *
+ * @private !!!!
+ */
+export declare const LLM_PROVIDER_PROFILES: {
+    readonly OPENAI: {
+        name: string;
+        fullname: string;
+        color: string;
+    };
+    readonly ANTHROPIC: {
+        name: string;
+        fullname: string;
+        color: string;
+    };
+    readonly AZURE_OPENAI: {
+        name: string;
+        fullname: string;
+        color: string;
+    };
+    readonly GOOGLE: {
+        name: string;
+        fullname: string;
+        color: string;
+    };
+    readonly DEEPSEEK: {
+        name: string;
+        fullname: string;
+        color: string;
+    };
+    readonly OLLAMA: {
+        name: string;
+        fullname: string;
+        color: string;
+    };
+    readonly REMOTE: {
+        name: string;
+        fullname: string;
+        color: string;
+    };
+    readonly MOCKED_ECHO: {
+        name: string;
+        fullname: string;
+        color: string;
+    };
+    readonly MOCKED_FAKE: {
+        name: string;
+        fullname: string;
+        color: string;
+    };
+    readonly VERCEL: {
+        name: string;
+        fullname: string;
+        color: string;
+    };
+    readonly MULTIPLE: {
+        name: string;
+        fullname: string;
+        color: string;
+    };
+};
+/**
+ * Helper function to get a profile by provider name with fallback
+ *
+ * @private !!!!
+ */
+export declare function getLlmProviderProfile(providerKey: keyof typeof LLM_PROVIDER_PROFILES): ChatParticipant;
+/**
+ * Creates a custom profile based on a provider profile but with custom properties
+ *
+ * @private !!!!
+ */
+export declare function createCustomLlmProfile(baseProfile: ChatParticipant, overrides: Partial<ChatParticipant>): ChatParticipant;
+/**
+ * TODO: Refactor this - each profile must be alongside the provider definition
+ * TODO: Unite `AvatarProfileProps` and `ChatParticipant`
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/llm-providers/_common/profiles/test/llmProviderProfiles.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/typings/src/llm-providers/_multiple/MultipleLlmExecutionTools.d.ts

@@ -28,6 +28,11 @@ export declare class MultipleLlmExecutionTools implements LlmExecutionTools {
     constructor(...llmExecutionTools: ReadonlyArray<LlmExecutionTools>);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
+    get profile(): {
+        name: string;
+        fullname: string;
+        color: string;
+    };
     /**
      * Check the configuration of all execution tools
      */

package/esm/typings/src/llm-providers/anthropic-claude/AnthropicClaudeExecutionTools.d.ts

@@ -2,7 +2,6 @@ import Anthropic from '@anthropic-ai/sdk';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
-import type { CompletionPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
 import type { string_markdown } from '../../types/typeAliases';
 import type { string_markdown_text } from '../../types/typeAliases';
@@ -29,6 +28,11 @@ export declare class AnthropicClaudeExecutionTools implements LlmExecutionTools
     constructor(options?: AnthropicClaudeExecutionToolsNonProxiedOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
+    get profile(): {
+        name: string;
+        fullname: string;
+        color: string;
+    };
     getClient(): Promise<Anthropic>;
     /**
      * Check the `options` passed to `constructor`
@@ -42,10 +46,6 @@ export declare class AnthropicClaudeExecutionTools implements LlmExecutionTools
      * Calls Anthropic Claude API to use a chat model.
      */
     callChatModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements'>): Promise<ChatPromptResult>;
-    /**
-     * Calls Anthropic Claude API to use a completion model.
-     */
-    callCompletionModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements'>): Promise<CompletionPromptResult>;
     /**
      * Get the model that should be used as default
      */

package/esm/typings/src/llm-providers/anthropic-claude/anthropic-claude-models.d.ts

@@ -3,7 +3,7 @@ import type { number_usd } from '../../types/typeAliases';
 /**
  * List of available Anthropic Claude models with pricing
  *
- * Note: Done at 2025-05-06
+ * Note: Synced with official API docs at 2025-08-20
  *
  * @see https://docs.anthropic.com/en/docs/models-overview
  * @public exported from `@promptbook/anthropic-claude`

package/esm/typings/src/llm-providers/deepseek/deepseek-models.d.ts

@@ -3,7 +3,7 @@ import type { number_usd } from '../../types/typeAliases';
 /**
  * List of available Deepseek models with descriptions
  *
- * Note: Done at 2025-05-06
+ * Note: Synced with official API docs at 2025-08-20
  *
  * @see https://www.deepseek.com/models
  * @public exported from `@promptbook/deepseek`

package/esm/typings/src/llm-providers/google/google-models.d.ts

@@ -3,7 +3,7 @@ import type { number_usd } from '../../types/typeAliases';
 /**
  * List of available Google models with descriptions
  *
- * Note: Done at 2025-05-06
+ * Note: Synced with official API docs at 2025-08-20
  *
  * @see https://ai.google.dev/models/gemini
  * @public exported from `@promptbook/google`

package/esm/typings/src/llm-providers/mocked/MockedEchoLlmExecutionTools.d.ts

@@ -17,6 +17,11 @@ export declare class MockedEchoLlmExecutionTools implements LlmExecutionTools {
     constructor(options?: CommonToolsOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
+    get profile(): {
+        name: string;
+        fullname: string;
+        color: string;
+    };
     /**
      * Does nothing, just to implement the interface
      */

package/esm/typings/src/llm-providers/ollama/ollama-models.d.ts

@@ -2,7 +2,7 @@ import type { AvailableModel } from '../../execution/AvailableModel';
 /**
  * List of available models in Ollama library
  *
- * Note: Done at 2025-05-19
+ * Note: Synced with official API docs at 2025-08-20
  *
  * @see https://ollama.com/library
  * @public exported from `@promptbook/ollama`

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/llm-providers/openai/OpenAiExecutionTools.d.ts

@@ -13,6 +13,11 @@ import { OpenAiCompatibleExecutionTools } from './OpenAiCompatibleExecutionTools
 export declare class OpenAiExecutionTools extends OpenAiCompatibleExecutionTools implements LlmExecutionTools {
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
+    get profile(): {
+        name: string;
+        fullname: string;
+        color: string;
+    };
     /**
      * List all available models (non dynamically)
      *

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

@@ -2,7 +2,7 @@ import type { AvailableModel } from '../../execution/AvailableModel';
 /**
  * List of available OpenAI models with pricing
  *
- * Note: Done at 2025-05-06
+ * Note: Synced with official API docs at 2025-08-20
  *
  * @see https://platform.openai.com/docs/models/
  * @see https://openai.com/api/pricing/

package/esm/typings/src/llm-providers/remote/RemoteLlmExecutionTools.d.ts

@@ -24,6 +24,11 @@ export declare class RemoteLlmExecutionTools<TCustomOptions = undefined> impleme
     constructor(options: RemoteClientOptions<TCustomOptions>);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
+    get profile(): {
+        name: string;
+        fullname: string;
+        color: string;
+    };
     /**
      * Check the configuration of all execution tools
      */

package/esm/typings/src/pipeline/book-notation.d.ts

@@ -1,3 +1,4 @@
+import type { string_book } from '../book-2.0/agent-source/string_book';
 import type { PipelineString } from './PipelineString';
 /**
  * Tag function for notating a pipeline with a book\`...\ notation as template literal
@@ -12,7 +13,7 @@ import type { PipelineString } from './PipelineString';
  * @returns the pipeline string
  * @public exported from `@promptbook/core`
  */
-export declare function book(strings: TemplateStringsArray, ...values: Array<string>): PipelineString;
+export declare function book(strings: TemplateStringsArray, ...values: Array<string>): string_book & PipelineString;
 /**
  * TODO: [🧠][🈴] Where is the best location for this file
  * Note: [💞] Ignore a discrepancy between file name and entity name

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/types/ModelRequirements.d.ts

@@ -87,8 +87,6 @@ export type CommonModelRequirements = {
     readonly seed?: number_seed;
     /**
      * Maximum number of tokens that can be generated by the model
-     *
-     * Note: [🌾]
      */
     readonly maxTokens?: number;
 };

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

@@ -136,6 +136,12 @@ export type ReservedParameters = Record<string_reserved_parameter_name, string_p
  * For example `"Ai*nautes"`
  */
 export type string_title = string;
+/**
+ * Semantic helper
+ *
+ * For example `"My AI Assistant"`
+ */
+export type string_agent_name = string;
 /**
  * Unstructured description of the persona
  *

package/esm/typings/src/utils/color/$randomColor.d.ts

@@ -0,0 +1,11 @@
+import { Color } from './Color';
+/**
+ * Creates a random color
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function $randomColor(): Color;
+/**
+ * TODO: !! Use Internally Color.fromValues
+ * TODO: !! randomColorWithAlpha
+ */

package/esm/typings/src/utils/color/Color.d.ts

@@ -0,0 +1,180 @@
+import type { string_color } from '../../types/typeAliases';
+import type { string_url_image } from '../../types/typeAliases';
+import type { WithTake } from '../take/interfaces/ITakeChain';
+import { CSS_COLORS } from './css-colors';
+/**
+ * Color object represents an RGB color with alpha channel
+ *
+ * Note: There is no fromObject/toObject because the most logical way to serialize color is as a hex string (#009edd)
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare class Color {
+    readonly red: number;
+    readonly green: number;
+    readonly blue: number;
+    readonly alpha: number;
+    /**
+     * Creates a new Color instance from miscellaneous formats
+     * - It can receive Color instance and just return the same instance
+     * - It can receive color in string format for example `#009edd`, `rgb(0,158,221)`, `rgb(0%,62%,86.7%)`, `hsl(197.1,100%,43.3%)`
+     *
+     * Note: This is not including fromImage because detecting color from an image is heavy task which requires async stuff and we cannot safely determine with overloading if return value will be a promise
+     *
+     * @param color
+     * @returns Color object
+     */
+    static from(color: string_color | Color): WithTake<Color>;
+    /**
+     * Creates a new Color instance from miscellaneous string formats
+     *
+     * @param color as a string for example `#009edd`, `rgb(0,158,221)`, `rgb(0%,62%,86.7%)`, `hsl(197.1,100%,43.3%)`, `red`, `darkgrey`,...
+     * @returns Color object
+     */
+    static fromString(color: string_color): WithTake<Color>;
+    /**
+     * Gets common color
+     *
+     * @param key as a css string like `midnightblue`
+     * @returns Color object
+     */
+    static get(key: keyof typeof CSS_COLORS): WithTake<Color>;
+    /**
+     * Creates a new Color instance from average color of given image
+     *
+     * @param image as a source for example `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAAXNSR0IArs4c6QAAAA1JREFUGFdjYJh39z8ABJgCe/ZvAS4AAAAASUVORK5CYII=`
+     * @returns Color object
+     */
+    static fromImage(image: string_url_image): Promise<Color>;
+    /**
+     * Creates a new Color instance from color in hex format
+     *
+     * @param color in hex for example `#009edd`, `009edd`, `#555`,...
+     * @returns Color object
+     */
+    static fromHex(hex: string_color): WithTake<Color>;
+    /**
+     * Creates a new Color instance from color in hex format with 3 color digits (without alpha channel)
+     *
+     * @param color in hex for example `09d`
+     * @returns Color object
+     */
+    private static fromHex3;
+    /**
+     * Creates a new Color instance from color in hex format with 6 color digits (without alpha channel)
+     *
+     * @param color in hex for example `009edd`
+     * @returns Color object
+     */
+    private static fromHex6;
+    /**
+     * Creates a new Color instance from color in hex format with 8 color digits (with alpha channel)
+     *
+     * @param color in hex for example `009edd`
+     * @returns Color object
+     */
+    private static fromHex8;
+    /**
+     * Creates a new Color instance from color in hsl format
+     *
+     * @param color as a hsl for example `hsl(197.1,100%,43.3%)`
+     * @returns Color object
+     */
+    static fromHsl(hsl: string_color): WithTake<Color>;
+    /**
+     * Creates a new Color instance from color in rgb format
+     *
+     * @param color as a rgb for example `rgb(0,158,221)`, `rgb(0%,62%,86.7%)`
+     * @returns Color object
+     */
+    static fromRgbString(rgb: string_color): WithTake<Color>;
+    /**
+     * Creates a new Color instance from color in rbga format
+     *
+     * @param color as a rgba for example `rgba(0,158,221,0.5)`, `rgb(0%,62%,86.7%,50%)`
+     * @returns Color object
+     */
+    static fromRgbaString(rgba: string_color): WithTake<Color>;
+    /**
+     * Creates a new Color for color channels values
+     *
+     * @param red number from 0 to 255
+     * @param green number from 0 to 255
+     * @param blue number from 0 to 255
+     * @param alpha number from 0 (transparent) to 255 (opaque = default)
+     * @returns Color object
+     */
+    static fromValues(red: number, green: number, blue: number, alpha?: number): WithTake<Color>;
+    /**
+     * Checks if the given value is a valid Color object.
+     *
+     * @param {unknown} value - The value to check.
+     * @return {value is WithTake<Color>} Returns true if the value is a valid Color object, false otherwise.
+     */
+    static isColor(value: unknown): value is WithTake<Color>;
+    /**
+     * Creates new Color object
+     *
+     * Note: Consider using one of static methods like `from` or `fromString`
+     *
+     * @param red number from 0 to 255
+     * @param green number from 0 to 255
+     * @param blue number from 0 to 255
+     * @param alpha number from 0 (transparent) to 255 (opaque)
+     */
+    private constructor();
+    /**
+     * Shortcut for `red` property
+     * Number from 0 to 255
+     * @alias red
+     */
+    get r(): number;
+    /**
+     * Shortcut for `green` property
+     * Number from 0 to 255
+     * @alias green
+     */
+    get g(): number;
+    /**
+     * Shortcut for `blue` property
+     * Number from 0 to 255
+     * @alias blue
+     */
+    get b(): number;
+    /**
+     * Shortcut for `alpha` property
+     * Number from 0 (transparent) to 255 (opaque)
+     * @alias alpha
+     */
+    get a(): number;
+    /**
+     * Shortcut for `alpha` property
+     * Number from 0 (transparent) to 255 (opaque)
+     * @alias alpha
+     */
+    get opacity(): number;
+    /**
+     * Shortcut for 1-`alpha` property
+     */
+    get transparency(): number;
+    clone(): WithTake<Color>;
+    toString(): string_color;
+    toHex(): string_color;
+    toRgb(): string_color;
+    toHsl(): string_color;
+}
+/**
+ * TODO: For each method a corresponding static method should be created
+ *       Like clone can be done by color.clone() OR Color.clone(color)
+ * TODO: Probably as an independent LIB OR add to LIB xyzt (ask @roseckyj)
+ * TODO: !! Transfer back to Collboard (whole directory)
+ * TODO: Maybe [🏌️‍♂️] change ACRY toString => (toHex) toRgb when there will be toRgb and toRgba united
+ * TODO: Convert getters to methods - getters only for values
+ * TODO: Write tests
+ * TODO: Getters for alpha, opacity, transparency, r, b, g, h, s, l, a,...
+ * TODO: [0] Should be fromRgbString and fromRgbaString one or two functions + one or two regex
+ * TODO: Use rgb, rgba, hsl for testing and parsing with the same regex
+ * TODO: Regex for rgb, rgba, hsl does not support all options like deg, rad, turn,...
+ * TODO: Convolution matrix
+ * TODO: Maybe connect with textures
+ */