@promptbook/remote-client 0.112.0-72 → 0.112.0-73

package/esm/index.es.js

@@ -20,7 +20,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-72';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-73';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/src/book-components/Chat/save/_common/chatExportRendering.d.ts

@@ -0,0 +1,28 @@
+import type { ChatParticipant } from '../../types/ChatParticipant';
+/**
+ * Minimal participant visuals needed by chat exports.
+ *
+ * @private internal utility of chat save format definitions
+ */
+export type ChatExportParticipantVisuals = {
+    readonly displayName: string;
+    readonly accentColor: string;
+};
+/**
+ * Formats exported timestamps into a compact human-readable label.
+ *
+ * @private internal utility of chat save format definitions
+ */
+export declare function formatChatExportTimestamp(value?: string | Date): string;
+/**
+ * Builds a participant lookup indexed by both raw and upper-cased names.
+ *
+ * @private internal utility of chat save format definitions
+ */
+export declare function buildChatExportParticipantMap(participants: ReadonlyArray<ChatParticipant>): ReadonlyMap<string, ChatParticipant>;
+/**
+ * Resolves the display label and accent color for one message sender.
+ *
+ * @private internal utility of chat save format definitions
+ */
+export declare function resolveChatExportParticipantVisuals(participants: ReadonlyMap<string, ChatParticipant>, sender: string): ChatExportParticipantVisuals;

package/esm/src/book-components/Chat/save/_common/getPromptbookExportBranding.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Promptbook branding metadata embedded into standalone chat exports.
+ */
+type PromptbookExportBranding = {
+    readonly productName: string;
+    readonly creatorTool: string;
+    readonly metadataSummary: string;
+    readonly keywords: ReadonlyArray<string>;
+    readonly commentLines: ReadonlyArray<string>;
+    readonly detailLines: ReadonlyArray<string>;
+};
+/**
+ * Builds shared Promptbook export branding for standalone save formats.
+ *
+ * @private internal utility of chat save format definitions
+ */
+export declare function getPromptbookExportBranding(): PromptbookExportBranding;
+export {};

package/esm/src/book-components/Chat/save/html/htmlSaveFormatDefinition.d.ts

@@ -7,7 +7,7 @@ import type { ChatParticipant } from '../../types/ChatParticipant';
  */
 export declare const htmlSaveFormatDefinition: {
     readonly formatName: "html";
-    readonly label: "Html";
+    readonly label: "HTML";
     readonly getContent: ({ title, messages, participants }: {
         readonly title: string;
         readonly messages: readonly ChatMessage[];

package/esm/src/book-components/Chat/save/html/htmlSaveFormatDefinition.test.d.ts

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

package/esm/src/book-components/Chat/save/index.d.ts

@@ -26,7 +26,7 @@ export declare const CHAT_SAVE_FORMATS: readonly [{
 }, {
     readonly formatName: "md";
     readonly label: "Markdown";
-    readonly getContent: ({ messages }: {
+    readonly getContent: ({ messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
         readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];
@@ -35,7 +35,7 @@ export declare const CHAT_SAVE_FORMATS: readonly [{
     readonly fileExtension: "md";
 }, {
     readonly formatName: "html";
-    readonly label: "Html";
+    readonly label: "HTML";
     readonly getContent: ({ title, messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
@@ -55,8 +55,8 @@ export declare const CHAT_SAVE_FORMATS: readonly [{
     readonly fileExtension: "jsx";
 }, {
     readonly formatName: "pdf";
-    readonly label: "Pdf";
-    readonly getContent: ({ messages, participants }: {
+    readonly label: "PDF";
+    readonly getContent: ({ title, messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
         readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];

package/esm/src/book-components/Chat/save/markdown/mdSaveFormatDefinition.d.ts

@@ -6,7 +6,7 @@
 export declare const mdSaveFormatDefinition: {
     readonly formatName: "md";
     readonly label: "Markdown";
-    readonly getContent: ({ messages }: {
+    readonly getContent: ({ messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
         readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];

package/esm/src/book-components/Chat/save/markdown/mdSaveFormatDefinition.test.d.ts

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

package/esm/src/book-components/Chat/save/pdf/buildChatPdf.d.ts

@@ -1,12 +1,13 @@
 import type { ChatMessage } from '../../types/ChatMessage';
 import type { ChatParticipant } from '../../types/ChatParticipant';
 /**
- * Creates a minimal PDF representation of the provided chat.
+ * Builds a polished PDF representation of the provided chat.
  *
+ * @param title - Title used in the PDF heading and metadata.
  * @param messages - Messages that should be included in the PDF export.
  * @param participants - Optional participant metadata to resolve sender names.
  * @returns Binary data for the generated PDF file.
  *
  * @private Internal helper used by `pdfSaveFormatDefinition`.
  */
-export declare function buildChatPdf(messages: ReadonlyArray<ChatMessage>, participants?: ReadonlyArray<ChatParticipant>): Uint8Array;
+export declare function buildChatPdf(title: string, messages: ReadonlyArray<ChatMessage>, participants?: ReadonlyArray<ChatParticipant>): Uint8Array;

package/esm/src/book-components/Chat/save/pdf/pdfSaveFormatDefinition.d.ts

@@ -5,8 +5,8 @@
  */
 export declare const pdfSaveFormatDefinition: {
     readonly formatName: "pdf";
-    readonly label: "Pdf";
-    readonly getContent: ({ messages, participants }: {
+    readonly label: "PDF";
+    readonly getContent: ({ title, messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
         readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];

package/esm/src/book-components/Chat/save/pdf/pdfSaveFormatDefinition.test.d.ts

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

package/esm/src/book-components/Chat/save/react/reactSaveFormatDefinition.test.d.ts

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

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

@@ -0,0 +1,26 @@
+import type { string_html, string_markdown } from '../../../types/string_markdown';
+/**
+ * Options for markdown rendering.
+ */
+type RenderMarkdownOptions = {
+    readonly citationReferenceClassName?: string;
+};
+/**
+ * Convert markdown content to HTML.
+ *
+ * @param markdown - The markdown content to convert.
+ * @returns HTML string ready for rendering.
+ *
+ * @private internal utility of chat components and exports
+ */
+export declare function renderMarkdown(markdown: string_markdown, options?: RenderMarkdownOptions): string_html;
+/**
+ * Detects whether text appears to contain markdown syntax.
+ *
+ * @param markdown - The text to inspect.
+ * @returns Whether the text contains known markdown markers.
+ *
+ * @private internal utility of chat components and exports
+ */
+export declare function isMarkdownContent(markdown: string_markdown): boolean;
+export {};

package/esm/src/cli/cli-commands/agent/agentRunCliOptions.d.ts

@@ -6,6 +6,7 @@ import type { NormalizedPromptRunnerCliOptions, PromptRunnerCliOptions } from '.
  */
 export type AgentRunCliOptions = PromptRunnerCliOptions & {
     readonly autoClone?: boolean;
+    readonly ignore?: string | readonly string[];
 };
 /**
  * Normalized options passed from `ptbk agent` CLI commands to the message runner.
@@ -14,6 +15,7 @@ export type AgentRunCliOptions = PromptRunnerCliOptions & {
  */
 export type NormalizedAgentRunCliOptions = NormalizedPromptRunnerCliOptions & {
     readonly autoClone: boolean;
+    readonly ignorePatterns: readonly string[];
 };
 /**
  * Converts Commander options into the `scripts/run-agent-messages` option shape.

package/esm/src/cli/cli-commands/agent/initializeAgentRunnerCommand.d.ts

@@ -11,6 +11,7 @@ type InitializeAgentRunnerCommandOptions = {
     readonly aliases?: ReadonlyArray<string>;
     readonly summary: string;
     readonly featureLines: ReadonlyArray<string>;
+    readonly isExitingOnSuccess?: boolean;
     readonly configureCommand?: (command: Program) => void;
     readonly loadExecutor: () => Promise<(runOptions: ReturnType<typeof createAgentRunOptionsFromCliOptions>) => Promise<unknown>>;
 };

package/esm/src/cli/cli-commands/common/handleActionErrors.d.ts

@@ -4,12 +4,17 @@ import type { Command as Program } from 'commander';
  */
 type actionCallbackFunction = Parameters<Program['action']>[0];
 /**
- * Wraps action to handle error console logging and exit process with error code
+ * Options controlling CLI process-exit behavior after one command action finishes.
  *
- * @param action Action to be wrapped in error handling
- * @returns Wrapped action
+ * @private internal helper type for CLI commands
+ */
+type HandleActionErrorsOptions = {
+    readonly isExitingOnSuccess?: boolean;
+};
+/**
+ * Wraps action to handle error console logging and exit process with error code.
  *
  * @private internal helper function for CLI commands
  */
-export declare function handleActionErrors(action: actionCallbackFunction): actionCallbackFunction;
+export declare function handleActionErrors(action: actionCallbackFunction, options?: HandleActionErrorsOptions): actionCallbackFunction;
 export {};

package/esm/src/conversion/pipelineJsonToString/appendMarkdownBlock.d.ts

@@ -0,0 +1,7 @@
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Appends one markdown block to an existing markdown document.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function appendMarkdownBlock(pipelineString: string_markdown, markdownBlock: string_markdown): string_markdown;

package/esm/src/conversion/pipelineJsonToString/createPipelineCommands.d.ts

@@ -0,0 +1,7 @@
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+/**
+ * Collects pipeline-level commands in the existing serialization order.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function createPipelineCommands(pipelineJson: PipelineJson): Array<string>;

package/esm/src/conversion/pipelineJsonToString/createPipelineIntroduction.d.ts

@@ -0,0 +1,8 @@
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Creates the initial markdown heading and description of a pipeline.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function createPipelineIntroduction(pipelineJson: PipelineJson): string_markdown;

package/esm/src/conversion/pipelineJsonToString/createTaskSerialization.d.ts

@@ -0,0 +1,23 @@
+import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
+/**
+ * Code fence language used when stringifying a pipeline task.
+ *
+ * @private internal type of `createTaskSerialization`
+ */
+type PipelineTaskContentLanguage = 'markdown' | 'text' | 'javascript' | 'typescript' | 'python' | '';
+/**
+ * All derived serialization details needed to render one task section.
+ *
+ * @private internal type of `createTaskSerialization`
+ */
+type TaskSerialization = {
+    readonly commands: Array<string>;
+    readonly contentLanguage: PipelineTaskContentLanguage;
+};
+/**
+ * Collects all task-specific serialization details.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function createTaskSerialization(task: TaskJson): TaskSerialization;
+export {};

package/esm/src/conversion/pipelineJsonToString/stringifyCommands.d.ts

@@ -0,0 +1,7 @@
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Renders commands as markdown bullet items.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function stringifyCommands(commands: ReadonlyArray<string>): string_markdown;

package/esm/src/conversion/pipelineJsonToString/stringifyTask.d.ts

@@ -0,0 +1,8 @@
+import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Stringifies one task section of the pipeline.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function stringifyTask(task: TaskJson): string_markdown;

package/esm/src/conversion/pipelineJsonToString.test.d.ts

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

package/esm/src/execution/createPipelineExecutor/executeSingleAttempt.d.ts

@@ -0,0 +1,31 @@
+import type { string_parameter_name } from '../../types/string_name';
+import type { LlmExecutionTools } from '../LlmExecutionTools';
+import type { $OngoingTaskResult } from './$OngoingTaskResult';
+import type { ExecuteAttemptsOptions } from './40-executeAttempts';
+/**
+ * Executes one loop iteration, from joker resolution or task execution through validation.
+ *
+ * @private function of `executeAttempts`
+ */
+export declare function executeSingleAttempt(options: {
+    /**
+     * Metadata describing the current loop iteration.
+     */
+    readonly attempt: {
+        readonly attemptIndex: number;
+        readonly isJokerAttempt: boolean;
+        readonly jokerParameterName?: string_parameter_name;
+    };
+    /**
+     * Immutable executor options shared across all attempts.
+     */
+    readonly options: ExecuteAttemptsOptions;
+    /**
+     * Narrowed LLM execution tools for prompt tasks.
+     */
+    readonly llmTools: LlmExecutionTools;
+    /**
+     * Mutable per-task state accumulated across attempts.
+     */
+    readonly $ongoingTaskResult: $OngoingTaskResult;
+}): Promise<void>;

package/esm/src/execution/createPipelineExecutor/handleAttemptFailure.d.ts

@@ -0,0 +1,40 @@
+import type { PartialDeep, Promisable } from 'type-fest';
+import { ExpectError } from '../../errors/ExpectError';
+import type { PipelineExecutorResult } from '../PipelineExecutorResult';
+import type { $OngoingTaskResult } from './$OngoingTaskResult';
+/**
+ * Stores one failed attempt, reports the expectation error, and throws the aggregated retry error after the final
+ * regular attempt.
+ *
+ * @private function of `executeAttempts`
+ */
+export declare function handleAttemptFailure(options: {
+    /**
+     * Expectation error raised by the current attempt.
+     */
+    readonly error: ExpectError;
+    /**
+     * Zero-based attempt index for the current execution loop.
+     */
+    readonly attemptIndex: number;
+    /**
+     * Maximum number of attempts for the current task type.
+     */
+    readonly maxAttempts: number;
+    /**
+     * Maximum number of model execution attempts for prompt tasks.
+     */
+    readonly maxExecutionAttempts: number;
+    /**
+     * Callback invoked with partial progress updates.
+     */
+    onProgress(newOngoingResult: PartialDeep<PipelineExecutorResult>): Promisable<void>;
+    /**
+     * String identifier for the pipeline, used for error reporting.
+     */
+    readonly pipelineIdentification: string;
+    /**
+     * Mutable per-task execution state.
+     */
+    readonly $ongoingTaskResult: $OngoingTaskResult;
+}): void;

package/esm/src/execution/createPipelineExecutor/reportPromptExecution.d.ts

@@ -0,0 +1,34 @@
+import type { Promisable, ReadonlyDeep, WritableDeep } from 'type-fest';
+import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
+import type { LlmCall } from '../../types/LlmCall';
+import type { ExecutionReportJson } from '../execution-report/ExecutionReportJson';
+import type { $OngoingTaskResult } from './$OngoingTaskResult';
+/**
+ * Appends the prompt execution report for prompt-task attempts.
+ *
+ * @private function of `executeAttempts`
+ */
+export declare function reportPromptExecution(options: {
+    /**
+     * Metadata describing the current loop iteration.
+     */
+    readonly attempt: {
+        readonly isJokerAttempt: boolean;
+    };
+    /**
+     * Task currently being executed.
+     */
+    readonly task: ReadonlyDeep<TaskJson>;
+    /**
+     * Mutable execution report object to append prompt execution data to.
+     */
+    readonly $executionReport: WritableDeep<ExecutionReportJson>;
+    /**
+     * Optional callback invoked with each LLM call.
+     */
+    logLlmCall?(llmCall: LlmCall): Promisable<void>;
+    /**
+     * Mutable per-task execution state.
+     */
+    readonly $ongoingTaskResult: $OngoingTaskResult;
+}): void;

package/esm/src/execution/resolveTaskTldr.d.ts

@@ -0,0 +1,32 @@
+import type { number_percent } from '../types/number_percent';
+import type { chococake } from '../utils/organization/really_any';
+import type { task_status } from './ExecutionTask';
+/**
+ * Shared type for task TLDR information.
+ *
+ * @private internal type of `ExecutionTask`
+ */
+type TaskTldrInfo = {
+    readonly percent: number_percent;
+    readonly message: string;
+};
+/**
+ * Snapshot of the mutable task state needed to resolve the fallback TLDR.
+ *
+ * @private internal type of `ExecutionTask`
+ */
+type ResolveTaskTldrOptions = {
+    readonly customTldr: TaskTldrInfo | null;
+    readonly currentValue: chococake;
+    readonly status: task_status;
+    readonly createdAt: Date;
+    readonly errors: ReadonlyArray<Error>;
+    readonly warnings: ReadonlyArray<Error>;
+};
+/**
+ * Resolves the short task summary shown in the UI.
+ *
+ * @private internal helper function of `ExecutionTask`
+ */
+export declare function resolveTaskTldr(options: ResolveTaskTldrOptions): TaskTldrInfo;
+export {};

package/esm/src/execution/resolveTaskTldr.test.d.ts

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

package/esm/src/llm-providers/agent/AgentLlmExecutionTools.d.ts

@@ -27,50 +27,49 @@ import type { CreateAgentLlmExecutionToolsOptions } from './CreateAgentLlmExecut
 export declare class AgentLlmExecutionTools implements LlmExecutionTools {
     protected readonly options: CreateAgentLlmExecutionToolsOptions;
     /**
-     * Cached AgentKit agents to avoid rebuilding identical instances.
+     * Cached model requirements to avoid re-parsing the agent source.
      */
-    private static agentKitAgentCache;
+    private _cachedModelRequirements;
     /**
-     * Cache of OpenAI assistants to avoid creating duplicates
+     * Cached parsed agent information.
      */
-    private static assistantCache;
+    private _cachedAgentInfo;
     /**
-     * Cache of OpenAI vector stores to avoid creating duplicates
+     * Optional server-precomputed model requirements reused until the source changes.
      */
-    private static vectorStoreCache;
+    private precomputedModelRequirements;
     /**
-     * Cached model requirements to avoid re-parsing the agent source
+     * Dedicated prompt preparation facade used before backend dispatch.
      */
-    private _cachedModelRequirements;
+    private readonly promptPreparer;
     /**
-     * Cached parsed agent information
+     * Dedicated OpenAI AgentKit runner used when the wrapped tools support AgentKit preparation.
      */
-    private _cachedAgentInfo;
+    private readonly agentKitRunner;
     /**
-     * Optional server-precomputed model requirements reused until the source changes.
+     * Dedicated OpenAI Assistant runner used when the wrapped tools use Assistants.
      */
-    private precomputedModelRequirements;
+    private readonly openAiAssistantRunner;
     /**
-     * Creates new AgentLlmExecutionTools
+     * Creates new AgentLlmExecutionTools.
      *
-     * @param llmTools The underlying LLM execution tools to wrap
-     * @param agentSource The agent source string that defines the agent's behavior
+     * @param options - The underlying LLM tools and agent source configuration.
      */
     constructor(options: CreateAgentLlmExecutionToolsOptions);
     /**
-     * Updates the agent source and clears the cache
+     * Updates the agent source and clears the cache.
      *
-     * @param agentSource The new agent source string
+     * @param agentSource - The new agent source string.
      */
     protected updateAgentSource(agentSource: string_book): void;
     /**
-     * Get cached or parse agent information
+     * Returns cached or parsed agent information.
      */
     private getAgentInfo;
     /**
-     * Get cached or create agent model requirements
+     * Returns cached or compiled agent model requirements.
      *
-     * Note: [🐤] This is names `getModelRequirements` *(not `getAgentModelRequirements`)* because in future these two will be united
+     * Note: [🐤] This is named `getModelRequirements` *(not `getAgentModelRequirements`)* because in future these two will be united.
      */
     getModelRequirements(): Promise<AgentModelRequirements>;
     get title(): string_title & string_markdown_text;
@@ -78,62 +77,22 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
     get profile(): ChatParticipant | undefined;
     checkConfiguration(): Promisable<void>;
     /**
-     * Returns a virtual model name representing the agent behavior
+     * Returns a virtual model name representing the agent behavior.
      */
     get modelName(): string_model_name;
     listModels(): Promisable<ReadonlyArray<AvailableModel>>;
     /**
-     * Calls the chat model with agent-specific system prompt and requirements
+     * Calls the chat model with agent-specific system prompt and requirements.
      */
     callChatModel(prompt: Prompt): Promise<ChatPromptResult>;
     /**
-     * Calls the chat model with agent-specific system prompt and requirements with streaming
+     * Calls the chat model with agent-specific system prompt and requirements with streaming.
      */
     callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
-    /**
-     * Ensures the agent wrapper only processes chat prompts.
-     */
-    private requireChatPrompt;
-    /**
-     * Resolves agent requirements, attachments, and runtime overrides into one forwarded chat prompt.
-     */
-    private prepareChatPrompt;
-    /**
-     * Removes bookkeeping-only properties from compiled agent requirements before forwarding them.
-     */
-    private getSanitizedAgentModelRequirements;
     /**
      * Dispatches one prepared agent prompt to the correct underlying LLM backend.
      */
     private callPreparedChatModelStream;
-    /**
-     * Runs one prepared prompt through the OpenAI AgentKit backend.
-     */
-    private callOpenAiAgentKitChatModelStream;
-    /**
-     * Resolves the AgentKit cache state for the current prompt, including external and in-memory caches.
-     */
-    private resolveAgentKitCacheState;
-    /**
-     * Returns a prepared AgentKit agent, creating one only when the cache could not satisfy the request.
-     */
-    private getOrPrepareAgentKitAgent;
-    /**
-     * Stores freshly prepared AgentKit resources back into the in-memory caches when caching is allowed.
-     */
-    private storeAgentKitCache;
-    /**
-     * Runs one prepared prompt through the deprecated OpenAI Assistant backend.
-     */
-    private callOpenAiAssistantChatModelStream;
-    /**
-     * Returns an assistant instance matching the current agent requirements, reusing caches when possible.
-     */
-    private getOrPrepareOpenAiAssistant;
-    /**
-     * Stores one assistant id in the shared assistant cache for this agent title.
-     */
-    private storeAssistantCache;
     /**
      * Runs one prepared prompt through generic LLM tools that do not need special assistant preparation.
      */

package/esm/src/llm-providers/agent/AgentLlmExecutionToolsAgentKitRunner.d.ts

@@ -0,0 +1,51 @@
+import type { CallChatModelStreamOptions } from '../../execution/LlmExecutionTools';
+import type { ChatPromptResult, CommonPromptResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
+import type { string_model_name } from '../../types/string_model_name';
+import type { string_title } from '../../types/string_title';
+import { OpenAiAgentKitExecutionTools } from '../openai/OpenAiAgentKitExecutionTools';
+import type { AgentLlmExecutionToolsPromptPreparer } from './AgentLlmExecutionToolsPromptPreparer';
+/**
+ * Handles OpenAI AgentKit-backed executions for `AgentLlmExecutionTools`.
+ *
+ * @private internal utility of `AgentLlmExecutionTools`
+ */
+export declare class AgentLlmExecutionToolsAgentKitRunner {
+    private readonly context;
+    /**
+     * Cached AgentKit agents to avoid rebuilding identical instances.
+     */
+    private static agentKitAgentCache;
+    /**
+     * Cache of OpenAI vector stores to avoid creating duplicates.
+     */
+    private static vectorStoreCache;
+    constructor(context: {
+        readonly getTitle: () => string_title;
+        readonly getModelName: () => string_model_name;
+        readonly isVerbose?: boolean;
+        readonly assistantPreparationMode?: 'internal' | 'external';
+    });
+    /**
+     * Runs one prepared prompt through the OpenAI AgentKit backend.
+     */
+    callChatModelStream(options: {
+        readonly llmTools: OpenAiAgentKitExecutionTools;
+        readonly originalPrompt: Prompt;
+        readonly preparedChatPrompt: Awaited<ReturnType<AgentLlmExecutionToolsPromptPreparer['prepareChatPrompt']>>;
+        readonly onProgress: (chunk: ChatPromptResult) => void;
+        readonly streamOptions?: CallChatModelStreamOptions;
+    }): Promise<CommonPromptResult>;
+    /**
+     * Resolves the AgentKit cache state for the current prompt, including external and in-memory caches.
+     */
+    private resolveAgentKitCacheState;
+    /**
+     * Returns a prepared AgentKit agent, creating one only when the cache could not satisfy the request.
+     */
+    private getOrPrepareAgentKitAgent;
+    /**
+     * Stores freshly prepared AgentKit resources back into the in-memory caches when caching is allowed.
+     */
+    private storeAgentKitCache;
+}