@promptbook/vercel 0.100.0-6 → 0.100.0-64

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

@@ -0,0 +1,32 @@
+import type { string_color } from '../../../types/typeAliases';
+import type { string_name } from '../../../types/typeAliases';
+import type { string_person_fullname } from '../../../types/typeAliases';
+import type { string_url_image } from '../../../types/typeAliases';
+import { Color } from '../../../utils/color/Color';
+/**
+ * A participant in the chat
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatParticipant = {
+    /**
+     * Identifies the participant by their name, same as `message.from`
+     */
+    name: string_name;
+    /**
+     * Full name of the participant
+     */
+    fullname: string_person_fullname;
+    /**
+     * Am I the participant? (i.e. is this the user)
+     */
+    isMe?: boolean;
+    /**
+     * Profile picture
+     */
+    avatarSrc?: string_url_image;
+    /**
+     * Color associated with the participant
+     */
+    color: string_color | Color;
+};

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

@@ -0,0 +1,25 @@
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Utility functions for persisting chat conversations in localStorage
+ *
+ * @private util of `LlmChat`
+ */
+export declare class ChatPersistence {
+    private static readonly STORAGE_PREFIX;
+    /**
+     * Save messages to localStorage under the given key
+     */
+    static saveMessages(persistenceKey: string, messages: ReadonlyArray<ChatMessage>): void;
+    /**
+     * Load messages from localStorage for the given key
+     */
+    static loadMessages(persistenceKey: string): ChatMessage[];
+    /**
+     * Clear messages from localStorage for the given key
+     */
+    static clearMessages(persistenceKey: string): void;
+    /**
+     * Check if localStorage is available
+     */
+    static isAvailable(): boolean;
+}

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,9 @@
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+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?: ReadonlyArray<ChatParticipant>): Promise<void>;

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

@@ -0,0 +1,8 @@
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+/**
+ * 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?: ReadonlyArray<ChatParticipant>): 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,8 @@
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+/**
+ * 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?: ReadonlyArray<ChatParticipant>): string;

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

@@ -0,0 +1,7 @@
+import type { ChatMessage } from '../types/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,8 @@
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+/**
+ * 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?: ReadonlyArray<ChatParticipant>): string;

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

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

package/esm/typings/src/book-components/_common/react-utils/classNames.d.ts

@@ -0,0 +1,7 @@
+import type { string_css_class } from '../../../types/typeAliases';
+/**
+ * Utility function for joining multiple truthy class names into one string
+ *
+ * @private within the `@promptbook/components`
+ */
+export declare function classNames(...classes: Array<string_css_class | undefined | false | null>): string_css_class;

package/esm/typings/src/book-components/_common/react-utils/collectCssTextsForClass.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Collect matching CSS texts from document stylesheets for a given class.
+ * This will skip cross-origin stylesheets (they throw when accessed).
+ *
+ * @private within the promptbook components <- TODO: Maybe make promptbook util from this
+ */
+export declare function collectCssTextsForClass(className: string): string[];

package/esm/typings/src/book-components/_common/react-utils/escapeHtml.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Escape HTML to safely render user text inside a <pre> with dangerouslySetInnerHTML.
+ *
+ * @private within the promptbook components <- TODO: Maybe make promptbook util from this
+ */
+export declare function escapeHtml(input: string): string;

package/esm/typings/src/book-components/_common/react-utils/escapeRegex.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Escape text for safe use inside a RegExp pattern.
+ *
+ * @private within the promptbook components <- TODO: Maybe make promptbook util from this
+ */
+export declare function escapeRegex(input: string): string;

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

@@ -281,6 +281,12 @@ export declare function SET_IS_VERBOSE(isVerbose: boolean): void;
  * @public exported from `@promptbook/core`
  */
 export declare const DEFAULT_IS_AUTO_INSTALLED = false;
+/**
+ * Default simulated duration for a task in milliseconds (used for progress reporting)
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_TASK_SIMULATED_DURATION_MS: number;
 /**
  * Function name for generated function via `ptbk make` to get the pipeline collection
  *
@@ -295,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/AvailableModel.d.ts

@@ -40,6 +40,10 @@ export type AvailableModel = {
         readonly prompt: number_usd;
         readonly output: number_usd;
     };
+    /**
+     * If the model is deprecated, it should not be used for new tasks
+     */
+    readonly isDeprecated?: boolean;
 };
 /**
  * TODO: [🧠] Maybe rename to something else - like `ModelInformation` or `ModelMetadata`

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

@@ -1,5 +1,6 @@
 import type { Observable } from 'rxjs';
 import { PartialDeep } from 'type-fest';
+import type { number_percent } from '../types/typeAliases';
 import type { task_id } from '../types/typeAliases';
 import type { string_SCREAMING_CASE } from '../utils/normalization/normalizeTo_SCREAMING_CASE';
 import type { string_promptbook_version } from '../version';
@@ -19,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> & {
@@ -27,6 +29,9 @@ type CreateTaskOptions<TTaskResult extends AbstractTaskResult> = {
          * Optional update of the task title
          */
         readonly title?: AbstractTask<TTaskResult>['title'];
+    }) => void, updateTldr: (tldrInfo: {
+        readonly percent: number_percent;
+        readonly message: string;
     }) => void): Promise<TTaskResult>;
 };
 /**
@@ -80,6 +85,19 @@ export type AbstractTask<TTaskResult extends AbstractTaskResult> = {
      * Status of the task
      */
     readonly status: task_status;
+    /**
+     * Short summary of the task status for quick overview in the UI
+     */
+    readonly tldr: {
+        /**
+         * Progress in percentage from 0 to 1 (100%) that can be used to display a progress bar
+         */
+        readonly percent: number_percent;
+        /**
+         * Short summary message of the task status that can be displayed in the UI
+         */
+        readonly message: string;
+    };
     /**
      * Date when the task was created
      */
@@ -92,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/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
  *