@promptbook/wizard 0.111.0-4 → 0.112.0-100

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

@@ -0,0 +1,18 @@
+import type { AvailableModel } from '../../execution/AvailableModel';
+import type { number_usd } from '../../types/number_usd';
+/**
+ * List of available Deepseek models with descriptions
+ *
+ * Note: Synced with official API docs at 2026-03-22
+ *
+ * @see https://www.deepseek.com/models
+ *
+ * @public exported from `@promptbook/deepseek`
+ */
+export declare const DEEPSEEK_MODELS: ReadonlyArray<AvailableModel & {
+    modelDescription?: string;
+    pricing?: {
+        readonly prompt: number_usd;
+        readonly output: number_usd;
+    };
+}>;

package/esm/src/llm-providers/deepseek/register-configuration.d.ts

@@ -0,0 +1,11 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of LLM provider metadata
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
+ *
+ * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _DeepseekMetadataRegistration: Registration;

package/esm/src/llm-providers/deepseek/register-constructor.d.ts

@@ -0,0 +1,11 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of LLM provider
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
+ *
+ * @public exported from `@promptbook/deepseek`
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _DeepseekRegistration: Registration;

package/esm/src/llm-providers/google/GoogleExecutionToolsOptions.d.ts

@@ -0,0 +1,10 @@
+import type { createGoogleGenerativeAI } from '@ai-sdk/google';
+import type { VercelExecutionToolsOptions } from '../vercel/VercelExecutionToolsOptions';
+/**
+ * Options for `createGoogleExecutionTools`
+ *
+ * This combines options for Promptbook, Google and Vercel together
+ *
+ * @public exported from `@promptbook/google`
+ */
+export type GoogleExecutionToolsOptions = Omit<VercelExecutionToolsOptions, 'title' | 'description' | 'vercelProvider' | 'availableModels'> & Parameters<typeof createGoogleGenerativeAI>[0];

package/esm/src/llm-providers/google/createGoogleExecutionTools.d.ts

@@ -0,0 +1,11 @@
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { GoogleExecutionToolsOptions } from './GoogleExecutionToolsOptions';
+/**
+ * Execution Tools for calling Google Gemini API.
+ *
+ * @public exported from `@promptbook/google`
+ */
+export declare const createGoogleExecutionTools: ((options: GoogleExecutionToolsOptions) => LlmExecutionTools) & {
+    packageName: string;
+    className: string;
+};

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

@@ -0,0 +1,18 @@
+import type { AvailableModel } from '../../execution/AvailableModel';
+import type { number_usd } from '../../types/number_usd';
+/**
+ * List of available Google models with descriptions
+ *
+ * Note: Synced with official API docs at 2026-03-22
+ *
+ * @see https://ai.google.dev/models/gemini
+ *
+ * @public exported from `@promptbook/google`
+ */
+export declare const GOOGLE_MODELS: ReadonlyArray<AvailableModel & {
+    modelDescription?: string;
+    pricing?: {
+        readonly prompt: number_usd;
+        readonly output: number_usd;
+    };
+}>;

package/esm/src/llm-providers/google/register-configuration.d.ts

@@ -0,0 +1,11 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of LLM provider metadata
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
+ *
+ * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _GoogleMetadataRegistration: Registration;

package/esm/src/llm-providers/google/register-constructor.d.ts

@@ -0,0 +1,11 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of LLM provider
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
+ *
+ * @public exported from `@promptbook/google`
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _GoogleRegistration: Registration;

package/esm/src/llm-providers/mocked/$fakeTextToExpectations.d.ts

@@ -0,0 +1,12 @@
+import type { Expectations } from '../../pipeline/PipelineJson/Expectations';
+import type { string_postprocessing_function_name } from '../../types/string_person_fullname';
+/**
+ * Gets the expectations and creates a fake text that meets the expectations
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic
+ * Note: You can provide postprocessing functions to modify the text before checking the expectations
+ * The result will be the text BEFORE the postprocessing
+ *
+ * @private internal utility for MockedFackedLlmExecutionTools
+ */
+export declare function $fakeTextToExpectations(expectations: Expectations, postprocessingFunctionNames?: ReadonlyArray<string_postprocessing_function_name>): Promise<string>;

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

@@ -0,0 +1,36 @@
+import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
+import type { AvailableModel } from '../../execution/AvailableModel';
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { ChatPromptResult, CompletionPromptResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
+import type { string_markdown, string_markdown_text } from '../../types/string_markdown';
+import type { string_title } from '../../types/string_title';
+/**
+ * Mocked execution Tools for just echoing the requests for testing purposes.
+ *
+ * @public exported from `@promptbook/fake-llm`
+ */
+export declare class MockedEchoLlmExecutionTools implements LlmExecutionTools {
+    protected readonly options: CommonToolsOptions;
+    constructor(options?: CommonToolsOptions);
+    get title(): string_title & string_markdown_text;
+    get description(): string_markdown;
+    get profile(): ChatParticipant;
+    /**
+     * Does nothing, just to implement the interface
+     */
+    checkConfiguration(): void;
+    /**
+     * List all available mocked-models that can be used
+     */
+    listModels(): ReadonlyArray<AvailableModel>;
+    /**
+     * Mocks chat model
+     */
+    callChatModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements'>): Promise<ChatPromptResult>;
+    /**
+     * Mocks completion model
+     */
+    callCompletionModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements'>): Promise<CompletionPromptResult>;
+}

package/esm/src/llm-providers/mocked/MockedFackedLlmExecutionTools.d.ts

@@ -0,0 +1,40 @@
+import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
+import type { AvailableModel } from '../../execution/AvailableModel';
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { ChatPromptResult, CompletionPromptResult, EmbeddingPromptResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
+import type { string_markdown, string_markdown_text } from '../../types/string_markdown';
+import type { string_title } from '../../types/string_title';
+/**
+ * Mocked execution Tools for just faking expected responses for testing purposes
+ *
+ * @public exported from `@promptbook/fake-llm`
+ */
+export declare class MockedFackedLlmExecutionTools implements LlmExecutionTools {
+    protected readonly options: CommonToolsOptions;
+    constructor(options?: CommonToolsOptions);
+    get title(): string_title & string_markdown_text;
+    get description(): string_markdown;
+    get profile(): ChatParticipant;
+    /**
+     * Does nothing, just to implement the interface
+     */
+    checkConfiguration(): void;
+    /**
+     * List all available fake-models that can be used
+     */
+    listModels(): ReadonlyArray<AvailableModel>;
+    /**
+     * Fakes chat model
+     */
+    callChatModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'expectations' | 'postprocessingFunctionNames'>): Promise<ChatPromptResult & CompletionPromptResult>;
+    /**
+     * Fakes completion model
+     */
+    callCompletionModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'expectations' | 'postprocessingFunctionNames'>): Promise<CompletionPromptResult>;
+    /**
+     * Fakes embedding model
+     */
+    callEmbeddingModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'expectations' | 'postprocessingFunctionNames'>): Promise<EmbeddingPromptResult>;
+}

package/esm/src/llm-providers/ollama/OllamaExecutionTools.d.ts

@@ -0,0 +1,46 @@
+import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
+import type { AvailableModel } from '../../execution/AvailableModel';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { Usage } from '../../execution/Usage';
+import type { string_markdown, string_markdown_text } from '../../types/string_markdown';
+import type { string_title } from '../../types/string_title';
+import { computeOpenAiUsage } from '../openai/computeOpenAiUsage';
+import { OpenAiCompatibleExecutionTools } from '../openai/OpenAiCompatibleExecutionTools';
+import type { OllamaExecutionToolsOptions } from './OllamaExecutionToolsOptions';
+/**
+ * Execution Tools for calling Ollama API
+ *
+ * @public exported from `@promptbook/ollama`
+ */
+export declare class OllamaExecutionTools extends OpenAiCompatibleExecutionTools implements LlmExecutionTools {
+    constructor(ollamaOptions: OllamaExecutionToolsOptions);
+    get title(): string_title & string_markdown_text;
+    get description(): string_markdown;
+    get profile(): ChatParticipant;
+    /**
+     * 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 of the Ollama API based on the response from Ollama
+     */
+    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;
+    /**
+     * Default model for completion variant.
+     */
+    protected getDefaultImageGenerationModel(): AvailableModel;
+}

package/esm/src/llm-providers/ollama/OllamaExecutionToolsOptions.d.ts

@@ -0,0 +1,24 @@
+import type { OpenAiExecutionToolsOptions } from '../openai/OpenAiExecutionToolsOptions';
+/**
+ * Default base URL for Ollama API
+ *
+ * @public exported from `@promptbook/ollama`
+ */
+export declare const DEFAULT_OLLAMA_BASE_URL = "http://localhost:11434/v1";
+/**
+ * Options for `createOllamaExecutionTools`
+ *
+ * This combines options for Promptbook, Google and Vercel together
+ *
+ * @public exported from `@promptbook/ollama`
+ */
+export type OllamaExecutionToolsOptions = {
+    /**
+     * Base URL of Ollama API
+     *
+     * Note: Naming this `baseURL` not `baseUrl` to be consistent with OpenAI API
+     *
+     * @default `DEFAULT_OLLAMA_BASE_URL`
+     */
+    baseURL?: string;
+} & Omit<OpenAiExecutionToolsOptions, 'baseURL' | 'userId'>;

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

@@ -0,0 +1,11 @@
+import type { AvailableModel } from '../../execution/AvailableModel';
+/**
+ * List of available models in Ollama library
+ *
+ * Note: Synced with official API docs at 2025-08-20
+ *
+ * @see https://ollama.com/library
+ *
+ * @public exported from `@promptbook/ollama`
+ */
+export declare const OLLAMA_MODELS: ReadonlyArray<AvailableModel>;

package/esm/src/llm-providers/ollama/playground/playground.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env ts-node
+export {};

package/esm/src/llm-providers/ollama/register-configuration.d.ts

@@ -0,0 +1,11 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of LLM provider metadata
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
+ *
+ * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _OllamaMetadataRegistration: Registration;

package/esm/src/llm-providers/ollama/register-constructor.d.ts

@@ -0,0 +1,11 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of LLM provider
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
+ *
+ * @public exported from `@promptbook/ollama`
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _OllamaRegistration: Registration;

package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts

@@ -0,0 +1,114 @@
+import { Agent as AgentFromKit } from '@openai/agents';
+import type { CallChatModelStreamOptions, LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { ChatPromptResult } from '../../execution/PromptResult';
+import type { ModelRequirements } from '../../types/ModelRequirements';
+import type { Prompt } from '../../types/Prompt';
+import type { string_markdown, string_markdown_text } from '../../types/string_markdown';
+import type { string_title } from '../../types/string_title';
+import type { OpenAiAgentKitExecutionToolsOptions } from './OpenAiAgentKitExecutionToolsOptions';
+import { OpenAiAgentKitExecutionToolsOutputTypeMapper } from './OpenAiAgentKitExecutionToolsOutputTypeMapper';
+import { OpenAiVectorStoreHandler } from './OpenAiVectorStoreHandler';
+/**
+ * Alias for OpenAI AgentKit agent to avoid naming confusion with Promptbook agents.
+ */
+type OpenAiAgentKitAgent = AgentFromKit;
+/**
+ * Prepared AgentKit agent details.
+ */
+type OpenAiAgentKitPreparedAgent = {
+    readonly agent: OpenAiAgentKitAgent;
+    readonly vectorStoreId?: string;
+};
+/**
+ * AgentKit output type returned by the dedicated response-format mapper.
+ */
+type OpenAiAgentKitAgentOutputType = ReturnType<typeof OpenAiAgentKitExecutionToolsOutputTypeMapper.mapResponseFormatToAgentOutputType>;
+/**
+ * Execution tools for OpenAI AgentKit (Agents SDK).
+ *
+ * @public exported from `@promptbook/openai`
+ */
+export declare class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler implements LlmExecutionTools {
+    private preparedAgentKitAgent;
+    private readonly agentKitModelName;
+    private readonly inputBuilder;
+    private readonly toolBuilder;
+    /**
+     * Creates OpenAI AgentKit execution tools.
+     */
+    constructor(options: OpenAiAgentKitExecutionToolsOptions);
+    get title(): string_title & string_markdown_text;
+    get description(): string_markdown;
+    /**
+     * Calls OpenAI AgentKit with a chat prompt (non-streaming).
+     */
+    callChatModel(prompt: Prompt): Promise<ChatPromptResult>;
+    /**
+     * Calls OpenAI AgentKit with a chat prompt (streaming).
+     */
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
+    /**
+     * Returns a prepared AgentKit agent when the server wants to manage caching externally.
+     */
+    getPreparedAgentKitAgent(): OpenAiAgentKitPreparedAgent | null;
+    /**
+     * Stores a prepared AgentKit agent for later reuse by external cache managers.
+     */
+    setPreparedAgentKitAgent(preparedAgent: OpenAiAgentKitPreparedAgent): void;
+    /**
+     * Creates a new tools instance bound to a prepared AgentKit agent.
+     */
+    getPreparedAgentTools(preparedAgent: OpenAiAgentKitPreparedAgent): OpenAiAgentKitExecutionTools;
+    /**
+     * Prepares an AgentKit agent with optional knowledge sources and tool definitions.
+     */
+    prepareAgentKitAgent(options: {
+        readonly name: string_title;
+        readonly instructions: string_markdown;
+        readonly knowledgeSources?: ReadonlyArray<string>;
+        readonly tools?: ModelRequirements['tools'];
+        readonly vectorStoreId?: string;
+        readonly storeAsPrepared?: boolean;
+    }): Promise<OpenAiAgentKitPreparedAgent>;
+    /**
+     * Runs a prepared AgentKit agent and streams results back to the caller.
+     */
+    callChatModelStreamWithPreparedAgent(options: {
+        readonly openAiAgentKitAgent: OpenAiAgentKitAgent;
+        readonly prompt: Prompt;
+        readonly rawPromptContent?: string;
+        readonly onProgress: (chunk: ChatPromptResult & {
+            isFinished?: boolean;
+        }) => void;
+        readonly responseFormatOutputType?: OpenAiAgentKitAgentOutputType;
+        /**
+         * Optional abort signal propagated from chat surfaces so stream generation can be cancelled.
+         */
+        readonly signal?: AbortSignal;
+    }): Promise<ChatPromptResult>;
+    /**
+     * Ensures the AgentKit SDK is wired to the OpenAI client and API key.
+     */
+    private ensureAgentKitDefaults;
+    /**
+     * Builds the tool list for AgentKit while keeping the public facade small.
+     */
+    private buildAgentKitTools;
+    /**
+     * Returns AgentKit-specific options.
+     */
+    private get agentKitOptions();
+    /**
+     * Formats raw prompt content with the AgentKit model injected.
+     */
+    private templatePromptContent;
+    /**
+     * Discriminant for type guards.
+     */
+    protected get discriminant(): string;
+    /**
+     * Type guard to check if given `LlmExecutionTools` are instanceof `OpenAiAgentKitExecutionTools`.
+     */
+    static isOpenAiAgentKitExecutionTools(llmExecutionTools: LlmExecutionTools): llmExecutionTools is OpenAiAgentKitExecutionTools;
+}
+export {};

package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionToolsInputBuilder.d.ts

@@ -0,0 +1,41 @@
+import type { Prompt } from '../../types/Prompt';
+import type { TODO_any } from '../../utils/organization/TODO_any';
+/**
+ * Builds AgentKit input items, including multimodal attachments.
+ *
+ * @private helper of `OpenAiAgentKitExecutionTools`
+ */
+export declare class OpenAiAgentKitExecutionToolsInputBuilder {
+    /**
+     * Builds AgentKit input items from the prompt and optional thread.
+     */
+    buildAgentKitInputItems(prompt: Prompt, rawPromptContent: string): Promise<Array<TODO_any>>;
+    /**
+     * Builds the user message content for AgentKit runs, including file inputs when provided.
+     */
+    private buildAgentKitUserContent;
+    /**
+     * Converts uploaded `File` objects into AgentKit `input_image` entries.
+     */
+    private createAgentKitInputImageItemsFromFiles;
+    /**
+     * Converts image chat attachments into AgentKit `input_image` entries.
+     */
+    private createAgentKitInputImageItemsFromAttachments;
+    /**
+     * Builds AgentKit user content that can include text, uploaded files, and image attachments.
+     */
+    private buildAgentKitUserContentWithAttachments;
+    /**
+     * Checks whether one chat attachment can be sent as an image input.
+     */
+    private isImageAttachment;
+    /**
+     * Returns one lowercase extension extracted from a filename/pathname.
+     */
+    private getLowercaseFilenameExtension;
+    /**
+     * Tries to extract one extension from URL pathname.
+     */
+    private getUrlPathnameExtension;
+}

package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionToolsOptions.d.ts

@@ -0,0 +1,15 @@
+import type { string_model_name } from '../../types/string_model_name';
+import type { OpenAiVectorStoreHandlerOptions } from './OpenAiVectorStoreHandler';
+/**
+ * Options for `OpenAiAgentKitExecutionTools`.
+ *
+ * @public exported from `@promptbook/openai`
+ */
+export type OpenAiAgentKitExecutionToolsOptions = OpenAiVectorStoreHandlerOptions & {
+    /**
+     * Base model name used for AgentKit agents.
+     *
+     * @default gpt-5.2
+     */
+    readonly agentKitModelName?: string_model_name;
+};

package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionToolsOutputTypeMapper.d.ts

@@ -0,0 +1,56 @@
+import type OpenAI from 'openai';
+import type { TODO_any } from '../../utils/organization/TODO_any';
+/**
+ * Type describing Json schema definition entry.
+ */
+type JsonSchemaDefinitionEntry = {
+    type?: string;
+    description?: string;
+    properties?: Record<string, JsonSchemaDefinitionEntry>;
+    required?: Array<string>;
+    items?: JsonSchemaDefinitionEntry;
+    [key: string]: TODO_any;
+};
+/**
+ * Definition of Json schema.
+ */
+type JsonSchemaDefinition = {
+    type: 'json_schema';
+    name: string;
+    strict: boolean;
+    schema: {
+        type: 'object';
+        properties: Record<string, JsonSchemaDefinitionEntry>;
+        required: Array<string>;
+        additionalProperties: boolean;
+        description?: string;
+    };
+};
+/**
+ * Type describing open Ai chat response format.
+ */
+type OpenAiChatResponseFormat = OpenAI.Chat.Completions.ChatCompletionCreateParamsNonStreaming['response_format'];
+/**
+ * Maps OpenAI `response_format` payloads to AgentKit output types.
+ *
+ * @private helper of `OpenAiAgentKitExecutionTools`
+ */
+export declare class OpenAiAgentKitExecutionToolsOutputTypeMapper {
+    /**
+     * Maps one OpenAI `response_format` payload to the AgentKit output type shape.
+     */
+    static mapResponseFormatToAgentOutputType(responseFormat?: OpenAiChatResponseFormat): 'text' | JsonSchemaDefinition | undefined;
+    /**
+     * Determines whether a schema fragment includes meaningful constraints.
+     */
+    private static hasJsonSchemaContent;
+    /**
+     * Normalizes inline OpenAI JSON schema payloads to the AgentKit structure.
+     */
+    private static normalizeJsonSchemaInput;
+    /**
+     * Builds an AgentKit-compatible JSON schema definition from the supplied payload.
+     */
+    private static buildJsonSchemaDefinition;
+}
+export {};

package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionToolsToolBuilder.d.ts

@@ -0,0 +1,99 @@
+import type { Tool as AgentKitTool } from '@openai/agents';
+import type { ToolCallProgressUpdate } from '../../commitments/_common/toolRuntimeContext';
+import type { ModelRequirements } from '../../types/ModelRequirements';
+import type { ToolCall, ToolCallLogEntry, ToolCallState } from '../../types/ToolCall';
+import type { OpenAiAgentKitExecutionToolsOptions } from './OpenAiAgentKitExecutionToolsOptions';
+/**
+ * Builds AgentKit tools and tracks their execution state.
+ *
+ * @private helper of `OpenAiAgentKitExecutionTools`
+ */
+export declare class OpenAiAgentKitExecutionToolsToolBuilder {
+    private readonly context;
+    private readonly agentKitToolResultsByCallId;
+    private readonly agentKitToolSnapshotsByCallId;
+    constructor(context: {
+        readonly options: OpenAiAgentKitExecutionToolsOptions;
+        readonly agentKitModelName: string;
+    });
+    /**
+     * Clears per-run tool state before a new AgentKit stream starts.
+     */
+    clearRunState(): void;
+    /**
+     * Stores one latest tool-call snapshot keyed by AgentKit call id.
+     */
+    storeToolSnapshot(callId: string | undefined, toolCall: ToolCall): void;
+    /**
+     * Returns one latest tool-call snapshot keyed by AgentKit call id.
+     */
+    getToolSnapshot(callId: string | undefined): ToolCall | undefined;
+    /**
+     * Deletes one latest tool-call snapshot keyed by AgentKit call id.
+     */
+    deleteToolSnapshot(callId: string | undefined): void;
+    /**
+     * Builds the tool list for AgentKit, including hosted file search when applicable.
+     */
+    buildAgentKitTools(options: {
+        readonly tools?: ModelRequirements['tools'];
+        readonly vectorStoreId?: string;
+    }): Array<AgentKitTool>;
+    /**
+     * Resolves the stored Promptbook tool result for one AgentKit tool call.
+     */
+    resolveAgentKitToolOutputResult(callId: string | undefined, output: unknown): ToolCall['result'];
+    /**
+     * Creates one structured log entry for streamed tool-call updates.
+     */
+    static createToolCallLogEntry(options: {
+        readonly kind: string;
+        readonly title: string;
+        readonly message: string;
+        readonly level?: ToolCallLogEntry['level'];
+        readonly payload?: unknown;
+    }): ToolCallLogEntry;
+    /**
+     * Appends one incremental progress update to the currently tracked tool-call snapshot.
+     */
+    static applyToolCallProgressUpdate(toolCall: ToolCall, update: ToolCallProgressUpdate): ToolCall;
+    /**
+     * Resolves the final lifecycle state for one AgentKit tool call after execution ends.
+     */
+    static resolveFinalToolCallState(options: {
+        readonly currentState: ToolCallState | undefined;
+        readonly errors: ReadonlyArray<unknown> | undefined;
+    }): ToolCallState;
+    /**
+     * Returns true when one tool definition represents the dedicated DeepSearch capability.
+     */
+    private isDeepSearchToolDefinition;
+    /**
+     * Normalizes Promptbook JSON-schema tool parameters for AgentKit function tools.
+     */
+    private normalizeAgentKitToolParameters;
+    /**
+     * Creates the native Agent SDK tool used for `USE DEEPSEARCH`.
+     */
+    private createDeepSearchAgentKitTool;
+    /**
+     * Creates instructions for the nested DeepSearch specialist agent.
+     */
+    private createDeepSearchAgentInstructions;
+    /**
+     * Builds the nested DeepSearch prompt from structured tool arguments.
+     */
+    private buildDeepSearchToolInput;
+    /**
+     * Resolves the configured script tools for tool execution.
+     */
+    private resolveScriptTools;
+    /**
+     * Resolves the assistant-visible AgentKit tool response while preserving structured tool result data.
+     */
+    private resolveAgentKitToolResponse;
+    /**
+     * Normalizes AgentKit tool outputs into a string for Promptbook tool call results.
+     */
+    private formatAgentKitToolOutput;
+}