@promptbook/wizard 0.98.0-5 → 0.98.0-8

package/esm/typings/src/_packages/anthropic-claude.index.d.ts

@@ -2,7 +2,7 @@ import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
 import { ANTHROPIC_CLAUDE_MODELS } from '../llm-providers/anthropic-claude/anthropic-claude-models';
 import { AnthropicClaudeExecutionTools } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionTools';
 import type { AnthropicClaudeExecutionToolsOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
-import type { AnthropicClaudeExecutionToolsDirectOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
+import type { AnthropicClaudeExecutionToolsNonProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import { createAnthropicClaudeExecutionTools } from '../llm-providers/anthropic-claude/createAnthropicClaudeExecutionTools';
 import { _AnthropicClaudeRegistration } from '../llm-providers/anthropic-claude/register-constructor';
@@ -10,7 +10,7 @@ export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { ANTHROPIC_CLAUDE_MODELS };
 export { AnthropicClaudeExecutionTools };
 export type { AnthropicClaudeExecutionToolsOptions };
-export type { AnthropicClaudeExecutionToolsDirectOptions };
+export type { AnthropicClaudeExecutionToolsNonProxiedOptions };
 export type { AnthropicClaudeExecutionToolsProxiedOptions };
 export { createAnthropicClaudeExecutionTools };
 export { _AnthropicClaudeRegistration };

package/esm/typings/src/_packages/openai.index.d.ts

@@ -7,6 +7,8 @@ import { OpenAiAssistantExecutionTools } from '../llm-providers/openai/OpenAiAss
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import { OpenAiCompatibleExecutionTools } from '../llm-providers/openai/OpenAiCompatibleExecutionTools';
 import type { OpenAiCompatibleExecutionToolsOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
+import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
+import type { OpenAiCompatibleExecutionToolsProxiedOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
 import { OpenAiExecutionTools } from '../llm-providers/openai/OpenAiExecutionTools';
 import type { OpenAiExecutionToolsOptions } from '../llm-providers/openai/OpenAiExecutionToolsOptions';
 import { _OpenAiRegistration } from '../llm-providers/openai/register-constructor';
@@ -21,6 +23,8 @@ export { OpenAiAssistantExecutionTools };
 export type { OpenAiAssistantExecutionToolsOptions };
 export { OpenAiCompatibleExecutionTools };
 export type { OpenAiCompatibleExecutionToolsOptions };
+export type { OpenAiCompatibleExecutionToolsNonProxiedOptions };
+export type { OpenAiCompatibleExecutionToolsProxiedOptions };
 export { OpenAiExecutionTools };
 export type { OpenAiExecutionToolsOptions };
 export { _OpenAiRegistration };

package/esm/typings/src/_packages/types.index.d.ts

@@ -61,6 +61,8 @@ import type { Usage } from '../execution/Usage';
 import type { UsageCounts } from '../execution/Usage';
 import type { UserInterfaceTools } from '../execution/UserInterfaceTools';
 import type { UserInterfaceToolsPromptDialogOptions } from '../execution/UserInterfaceTools';
+import type { ValidatePromptResultOptions } from '../execution/utils/validatePromptResult';
+import type { ValidatePromptResultResult } from '../execution/utils/validatePromptResult';
 import type { FormatSubvalueParser } from '../formats/_common/FormatSubvalueParser';
 import type { FormatSubvalueParserMapValuesOptions } from '../formats/_common/FormatSubvalueParser';
 import type { CsvSettings } from '../formats/csv/CsvSettings';
@@ -74,7 +76,7 @@ import type { CacheItem } from '../llm-providers/_common/utils/cache/CacheItem';
 import type { CacheLlmToolsOptions } from '../llm-providers/_common/utils/cache/CacheLlmToolsOptions';
 import type { LlmExecutionToolsWithTotalUsage } from '../llm-providers/_common/utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
 import type { AnthropicClaudeExecutionToolsOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
-import type { AnthropicClaudeExecutionToolsDirectOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
+import type { AnthropicClaudeExecutionToolsNonProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AzureOpenAiExecutionToolsOptions } from '../llm-providers/azure-openai/AzureOpenAiExecutionToolsOptions';
 import type { DeepseekExecutionToolsOptions } from '../llm-providers/deepseek/DeepseekExecutionToolsOptions';
@@ -82,6 +84,8 @@ import type { GoogleExecutionToolsOptions } from '../llm-providers/google/Google
 import type { OllamaExecutionToolsOptions } from '../llm-providers/ollama/OllamaExecutionToolsOptions';
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import type { OpenAiCompatibleExecutionToolsOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
+import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
+import type { OpenAiCompatibleExecutionToolsProxiedOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
 import type { OpenAiExecutionToolsOptions } from '../llm-providers/openai/OpenAiExecutionToolsOptions';
 import type { VercelExecutionToolsOptions } from '../llm-providers/vercel/VercelExecutionToolsOptions';
 import type { VercelProvider } from '../llm-providers/vercel/VercelProvider';
@@ -361,6 +365,8 @@ export type { Usage };
 export type { UsageCounts };
 export type { UserInterfaceTools };
 export type { UserInterfaceToolsPromptDialogOptions };
+export type { ValidatePromptResultOptions };
+export type { ValidatePromptResultResult };
 export type { FormatSubvalueParser };
 export type { FormatSubvalueParserMapValuesOptions };
 export type { CsvSettings };
@@ -374,7 +380,7 @@ export type { CacheItem };
 export type { CacheLlmToolsOptions };
 export type { LlmExecutionToolsWithTotalUsage };
 export type { AnthropicClaudeExecutionToolsOptions };
-export type { AnthropicClaudeExecutionToolsDirectOptions };
+export type { AnthropicClaudeExecutionToolsNonProxiedOptions };
 export type { AnthropicClaudeExecutionToolsProxiedOptions };
 export type { AzureOpenAiExecutionToolsOptions };
 export type { DeepseekExecutionToolsOptions };
@@ -382,6 +388,8 @@ export type { GoogleExecutionToolsOptions };
 export type { OllamaExecutionToolsOptions };
 export type { OpenAiAssistantExecutionToolsOptions };
 export type { OpenAiCompatibleExecutionToolsOptions };
+export type { OpenAiCompatibleExecutionToolsNonProxiedOptions };
+export type { OpenAiCompatibleExecutionToolsProxiedOptions };
 export type { OpenAiExecutionToolsOptions };
 export type { VercelExecutionToolsOptions };
 export type { VercelProvider };

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

@@ -176,7 +176,7 @@ export declare const DEFAULT_MAX_PARALLEL_COUNT = 5;
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_MAX_EXECUTION_ATTEMPTS = 3;
+export declare const DEFAULT_MAX_EXECUTION_ATTEMPTS = 7;
 /**
  * The maximum depth to which knowledge sources will be scraped when building a knowledge base.
  * This prevents infinite recursion and limits resource usage.

package/esm/typings/src/execution/createPipelineExecutor/$OngoingTaskResult.d.ts

@@ -49,6 +49,7 @@ export type $OngoingTaskResult = {
      * Array of all failed attempts, storing both the result string and the error for each failure
      */
     $failedResults: Array<{
+        attemptIndex: number;
         result: string | null;
         error: ExpectError;
     }>;

package/esm/typings/src/execution/utils/validatePromptResult.d.ts

@@ -0,0 +1,53 @@
+import type { FormatCommand } from '../../commands/FORMAT/FormatCommand';
+import { ExpectError } from '../../errors/ExpectError';
+import type { Expectations } from '../../pipeline/PipelineJson/Expectations';
+import type { string_postprocessing_function_name } from '../../types/typeAliases';
+/**
+ * Options for validating a prompt result
+ */
+export interface ValidatePromptResultOptions {
+    /**
+     * The result string to validate
+     */
+    resultString: string;
+    /**
+     * Expectations for the result (word count, sentence count, etc.)
+     */
+    expectations?: Expectations;
+    /**
+     * Expected format of the result (e.g., 'JSON')
+     */
+    format?: FormatCommand['format'];
+    /**
+     * List of postprocessing function names that should be applied
+     * Note: This is for validation purposes only - postprocessing should be done before calling this function
+     */
+    postprocessingFunctionNames?: ReadonlyArray<string_postprocessing_function_name>;
+}
+/**
+ * Result of prompt result validation
+ */
+export interface ValidatePromptResultResult {
+    /**
+     * Whether the result is valid (passes all expectations and format checks)
+     */
+    isValid: boolean;
+    /**
+     * The processed result string (may be modified if format extraction was needed)
+     */
+    processedResultString: string;
+    /**
+     * Error that occurred during validation, if any
+     */
+    error?: ExpectError;
+}
+/**
+ * Validates a prompt result against expectations and format requirements.
+ * This function provides a common abstraction for result validation that can be used
+ * by both execution logic and caching logic to ensure consistency.
+ *
+ * @param options - The validation options including result string, expectations, and format
+ * @returns Validation result with processed string and validity status
+ * @private internal function of `createPipelineExecutor` and `cacheLlmTools`
+ */
+export declare function validatePromptResult(options: ValidatePromptResultOptions): ValidatePromptResultResult;

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

@@ -7,7 +7,7 @@ import type { Prompt } from '../../types/Prompt';
 import type { string_markdown } from '../../types/typeAliases';
 import type { string_markdown_text } from '../../types/typeAliases';
 import type { string_title } from '../../types/typeAliases';
-import type { AnthropicClaudeExecutionToolsDirectOptions } from './AnthropicClaudeExecutionToolsOptions';
+import type { AnthropicClaudeExecutionToolsNonProxiedOptions } from './AnthropicClaudeExecutionToolsOptions';
 /**
  * Execution Tools for calling Anthropic Claude API.
  *
@@ -15,7 +15,7 @@ import type { AnthropicClaudeExecutionToolsDirectOptions } from './AnthropicClau
  * @deprecated use `createAnthropicClaudeExecutionTools` instead
  */
 export declare class AnthropicClaudeExecutionTools implements LlmExecutionTools {
-    protected readonly options: AnthropicClaudeExecutionToolsDirectOptions;
+    protected readonly options: AnthropicClaudeExecutionToolsNonProxiedOptions;
     /**
      * Anthropic Claude API client.
      */
@@ -26,7 +26,7 @@ export declare class AnthropicClaudeExecutionTools implements LlmExecutionTools
      *
      * @param options which are relevant are directly passed to the Anthropic Claude client
      */
-    constructor(options?: AnthropicClaudeExecutionToolsDirectOptions);
+    constructor(options?: AnthropicClaudeExecutionToolsNonProxiedOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
     getClient(): Promise<Anthropic>;

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

@@ -7,14 +7,14 @@ import type { RemoteClientOptions } from '../../remote-server/types/RemoteClient
  * This extends Anthropic's `ClientOptions` with are directly passed to the Anthropic client.
  * @public exported from `@promptbook/anthropic-claude`
  */
-export type AnthropicClaudeExecutionToolsOptions = AnthropicClaudeExecutionToolsDirectOptions | AnthropicClaudeExecutionToolsProxiedOptions;
+export type AnthropicClaudeExecutionToolsOptions = AnthropicClaudeExecutionToolsNonProxiedOptions | AnthropicClaudeExecutionToolsProxiedOptions;
 /**
  * Options for directly used `AnthropicClaudeExecutionTools`
  *
  * This extends Anthropic's `ClientOptions` with are directly passed to the Anthropic client.
  * @public exported from `@promptbook/anthropic-claude`
  */
-export type AnthropicClaudeExecutionToolsDirectOptions = CommonToolsOptions & ClientOptions & {
+export type AnthropicClaudeExecutionToolsNonProxiedOptions = CommonToolsOptions & ClientOptions & {
     isProxied?: false;
 };
 /**

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

@@ -11,14 +11,14 @@ import type { string_markdown_text } from '../../types/typeAliases';
 import type { string_model_name } from '../../types/typeAliases';
 import type { string_title } from '../../types/typeAliases';
 import { computeOpenAiUsage } from './computeOpenAiUsage';
-import type { OpenAiCompatibleExecutionToolsOptions } from './OpenAiCompatibleExecutionToolsOptions';
+import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from './OpenAiCompatibleExecutionToolsOptions';
 /**
- * Execution Tools for calling OpenAI API or other OpeenAI compatible provider
+ * Execution Tools for calling OpenAI API or other OpenAI compatible provider
  *
  * @public exported from `@promptbook/openai`
  */
 export declare abstract class OpenAiCompatibleExecutionTools implements LlmExecutionTools {
-    protected readonly options: OpenAiCompatibleExecutionToolsOptions;
+    protected readonly options: OpenAiCompatibleExecutionToolsNonProxiedOptions;
     /**
      * OpenAI API client.
      */
@@ -32,7 +32,7 @@ export declare abstract class OpenAiCompatibleExecutionTools implements LlmExecu
      *
      * @param options which are relevant are directly passed to the OpenAI compatible client
      */
-    constructor(options: OpenAiCompatibleExecutionToolsOptions);
+    constructor(options: OpenAiCompatibleExecutionToolsNonProxiedOptions);
     abstract get title(): string_title & string_markdown_text;
     abstract get description(): string_markdown;
     getClient(): Promise<OpenAI>;

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

@@ -1,5 +1,6 @@
 import type { ClientOptions } from 'openai';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { RemoteClientOptions } from '../../remote-server/types/RemoteClientOptions';
 /**
  * Options for `createOpenAiCompatibleExecutionTools` and `OpenAiCompatibleExecutionTools`
  *
@@ -8,4 +9,44 @@ import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
  *
  * @public exported from `@promptbook/openai`
  */
-export type OpenAiCompatibleExecutionToolsOptions = CommonToolsOptions & ClientOptions;
+export type OpenAiCompatibleExecutionToolsOptions = OpenAiCompatibleExecutionToolsNonProxiedOptions | OpenAiCompatibleExecutionToolsProxiedOptions;
+/**
+ * Options for directly used `OpenAiCompatibleExecutionTools`
+ *
+ * This extends OpenAI's `ClientOptions` with are directly passed to the OpenAI client.
+ * @public exported from `@promptbook/openai`
+ */
+export type OpenAiCompatibleExecutionToolsNonProxiedOptions = CommonToolsOptions & ClientOptions & {
+    /**
+     * Base URL for the OpenAI-compatible API endpoint
+     *
+     * This allows connecting to any OpenAI-compatible LLM service by specifying their API endpoint.
+     *
+     * @example 'https://https://promptbook.s5.ptbk.io/' (Promptbook)
+     * @example 'https://api.openai.com/v1' (OpenAI)
+     * @example 'http://localhost:11434/v1' (Ollama)
+     * @example 'https://api.deepseek.com/v1' (DeepSeek)
+     */
+    baseURL?: string;
+    isProxied?: false;
+};
+/**
+ * Options for proxied `OpenAiCompatibleExecutionTools`
+ *
+ * This extends OpenAI's `ClientOptions` with are directly passed to the OpenAI client.
+ * @public exported from `@promptbook/openai`
+ */
+export type OpenAiCompatibleExecutionToolsProxiedOptions = CommonToolsOptions & ClientOptions & {
+    /**
+     * Base URL for the OpenAI-compatible API endpoint
+     *
+     * This allows connecting to any OpenAI-compatible LLM service by specifying their API endpoint.
+     *
+     * @example 'https://https://promptbook.s5.ptbk.io/' (Promptbook)
+     * @example 'https://api.openai.com/v1' (OpenAI)
+     * @example 'http://localhost:11434/v1' (Ollama)
+     * @example 'https://api.deepseek.com/v1' (DeepSeek)
+     */
+    baseURL?: string;
+    isProxied: true;
+} & Pick<RemoteClientOptions<undefined>, 'remoteServerUrl'>;

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

@@ -1,4 +1,14 @@
+import type { AvailableModel } from '../../execution/AvailableModel';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { Usage } from '../../execution/Usage';
+import type { string_markdown } from '../../types/typeAliases';
+import type { string_markdown_text } from '../../types/typeAliases';
+import type { string_model_name } from '../../types/typeAliases';
+import type { string_title } from '../../types/typeAliases';
+import { RemoteLlmExecutionTools } from '../remote/RemoteLlmExecutionTools';
+import { computeOpenAiUsage } from './computeOpenAiUsage';
 import { OpenAiCompatibleExecutionTools } from './OpenAiCompatibleExecutionTools';
+import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from './OpenAiCompatibleExecutionToolsOptions';
 import type { OpenAiCompatibleExecutionToolsOptions } from './OpenAiCompatibleExecutionToolsOptions';
 /**
  * Execution Tools for calling OpenAI compatible API
@@ -7,10 +17,57 @@ import type { OpenAiCompatibleExecutionToolsOptions } from './OpenAiCompatibleEx
  *
  * @public exported from `@promptbook/openai`
  */
-export declare const createOpenAiCompatibleExecutionTools: ((options: OpenAiCompatibleExecutionToolsOptions) => OpenAiCompatibleExecutionTools) & {
+export declare const createOpenAiCompatibleExecutionTools: ((options: OpenAiCompatibleExecutionToolsOptions & {
+    /**
+     * The model name to use for all operations
+     *
+     * This will be the only model available through this LLM provider and it will be a chat model.
+     * Other variants won't be available for now.
+     */
+    defaultModelName: string_model_name;
+}) => OpenAiCompatibleExecutionTools | RemoteLlmExecutionTools) & {
     packageName: string;
     className: string;
 };
+/**
+ * Execution Tools for calling ONE SPECIFIC PRECONFIGURED OpenAI compatible provider
+ *
+ * @private for `createOpenAiCompatibleExecutionTools`
+ */
+export declare class HardcodedOpenAiCompatibleExecutionTools extends OpenAiCompatibleExecutionTools implements LlmExecutionTools {
+    private readonly defaultModelName;
+    protected readonly options: OpenAiCompatibleExecutionToolsNonProxiedOptions;
+    /**
+     * Creates OpenAI compatible Execution Tools.
+     *
+     * @param options which are relevant are directly passed to the OpenAI compatible client
+     */
+    constructor(defaultModelName: string_model_name, options: OpenAiCompatibleExecutionToolsNonProxiedOptions);
+    get title(): string_title & string_markdown_text;
+    get description(): string_markdown;
+    /**
+     * List all available models (non dynamically)
+     *
+     * Note: Purpose of this is to provide more information about models than standard listing from API
+     */
+    protected get HARDCODED_MODELS(): ReadonlyArray<AvailableModel>;
+    /**
+     * Computes the usage
+     */
+    protected computeUsage(...args: Parameters<typeof computeOpenAiUsage>): Usage;
+    /**
+     * Default model for chat variant.
+     */
+    protected getDefaultChatModel(): AvailableModel;
+    /**
+     * Default model for completion variant.
+     */
+    protected getDefaultCompletionModel(): AvailableModel;
+    /**
+     * Default model for completion variant.
+     */
+    protected getDefaultEmbeddingModel(): AvailableModel;
+}
 /**
  * TODO: [🦺] Is there some way how to put `packageName` and `className` on top and function definition on bottom?
  * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"

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.98.0-4`).
+ * It follows semantic versioning (e.g., `0.98.0-7`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/wizard",
-    "version": "0.98.0-5",
+    "version": "0.98.0-8",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -74,7 +74,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/wizard.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.98.0-5"
+        "@promptbook/core": "0.98.0-8"
     },
     "dependencies": {
         "@ai-sdk/deepseek": "0.1.6",