@promptbook/remote-server 0.112.0-39 → 0.112.0-41

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

@@ -40,6 +40,134 @@ export declare class OpenAiAssistantExecutionTools extends OpenAiVectorStoreHand
      * Calls OpenAI API to use a chat model with streaming.
      */
     callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
+    /**
+     * Logs one assistant chat call when verbose output is enabled.
+     */
+    private logAssistantChatCall;
+    /**
+     * Validates the subset of model requirements supported by OpenAI Assistants.
+     */
+    private assertSupportedAssistantModelRequirements;
+    /**
+     * Returns true when the prompt exposes callable tools that require the Runs API flow.
+     */
+    private hasAssistantTools;
+    /**
+     * Resolves the raw user-visible prompt content sent to the assistant.
+     */
+    private createAssistantRawPromptContent;
+    /**
+     * Builds the thread history plus the current user message for one assistant call.
+     */
+    private createAssistantThreadMessages;
+    /**
+     * Converts the existing prompt thread into OpenAI assistant thread messages.
+     */
+    private createAssistantThreadHistoryMessages;
+    /**
+     * Creates the current user message, including uploaded file attachments when present.
+     */
+    private createAssistantCurrentUserMessage;
+    /**
+     * Runs assistant calls with tools through the non-streaming Runs API.
+     */
+    private callChatModelStreamWithTools;
+    /**
+     * Builds the non-streaming assistant request payload used when tool calls are enabled.
+     */
+    private createAssistantToolRunRequest;
+    /**
+     * Starts the assistant run and keeps polling until the run completes or fails.
+     */
+    private executeAssistantToolRun;
+    /**
+     * Polls one assistant run, executing and submitting tool outputs when OpenAI requests them.
+     */
+    private waitForAssistantToolRun;
+    /**
+     * Executes all required assistant tool calls and submits their outputs back to OpenAI.
+     */
+    private submitAssistantRequiredToolOutputs;
+    /**
+     * Waits a bit and then fetches the latest assistant run status.
+     */
+    private retrieveAssistantRunAfterDelay;
+    /**
+     * Executes each function tool requested by the assistant and records progress snapshots.
+     */
+    private executeAssistantRequiredToolCalls;
+    /**
+     * Executes one function tool requested by the assistant.
+     */
+    private executeAssistantRequiredToolCall;
+    /**
+     * Creates the initial pending snapshot for one assistant tool call.
+     */
+    private createPendingAssistantToolCall;
+    /**
+     * Resolves the configured script tools for assistant tool execution.
+     */
+    private resolveAssistantScriptTools;
+    /**
+     * Executes the configured script tool for one assistant-requested function call.
+     */
+    private executeAssistantFunctionTool;
+    /**
+     * Finalizes one assistant tool-call snapshot after execution ends.
+     */
+    private createCompletedAssistantToolCall;
+    /**
+     * Extracts the latest assistant text response from a completed thread.
+     */
+    private extractCompletedAssistantTextContent;
+    /**
+     * Runs assistant calls without tools through the streaming Assistants API.
+     */
+    private callChatModelStreamWithoutTools;
+    /**
+     * Builds the streaming assistant request payload used when no tool execution flow is needed.
+     */
+    private createAssistantStreamingRequest;
+    /**
+     * Registers verbose stream diagnostics plus incremental text progress forwarding.
+     */
+    private attachAssistantStreamListeners;
+    /**
+     * Resolves the final visible assistant text from a streaming response.
+     */
+    private resolveAssistantStreamingResultContent;
+    /**
+     * Extracts the single text content block returned by the assistant stream.
+     */
+    private extractSingleAssistantTextContentBlock;
+    /**
+     * Rewrites file citation markers to use retrieved filenames instead of generic source labels.
+     */
+    private replaceAssistantFileCitationMarkers;
+    /**
+     * Returns one citation filename, caching OpenAI file lookups across annotations.
+     */
+    private retrieveAssistantCitationFilename;
+    /**
+     * Emits one assistant progress chunk with shared timing and prompt metadata.
+     */
+    private emitAssistantProgress;
+    /**
+     * Creates the final assistant prompt result with uncertain usage plus measured duration.
+     */
+    private createAssistantPromptResult;
+    /**
+     * Computes the usage payload for assistant responses.
+     */
+    private createAssistantUsage;
+    /**
+     * Wraps the final assistant prompt result in the standard exported JSON envelope.
+     */
+    private exportAssistantPromptResult;
+    /**
+     * Logs one assistant request payload when verbose output is enabled.
+     */
+    private logVerboseAssistantRequest;
     /**
      * Get an existing assistant tool wrapper
      */

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

@@ -49,11 +49,11 @@ export declare abstract class OpenAiCompatibleExecutionTools implements LlmExecu
     /**
      * Calls OpenAI compatible API to use a chat model with streaming.
      */
-    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, _options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
     /**
-     * Internal method that handles parameter retry for chat model calls
+     * Executes one OpenAI request under the shared rate limiter and network retry policy.
      */
-    private callChatModelWithRetry;
+    private executeRateLimitedRequest;
     /**
      * Calls OpenAI API to use a complete model.
      */

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

@@ -6,6 +6,8 @@ import type { OpenAiCompatibleExecutionToolsOptions } from './OpenAiCompatibleEx
 import { OpenAiExecutionTools } from './OpenAiExecutionTools';
 /**
  * Metadata for uploaded knowledge source files used for vector store diagnostics.
+ *
+ * @private internal utility of `OpenAiVectorStoreHandler`
  */
 type KnowledgeSourceUploadMetadata = {
     readonly fileId: string;
@@ -117,6 +119,58 @@ export declare abstract class OpenAiVectorStoreHandler extends OpenAiExecutionTo
         readonly totalBytes: number;
         readonly logLabel: string;
     }): Promise<TODO_any | null>;
+    /**
+     * Uploads the prepared knowledge-source files with bounded concurrency.
+     */
+    private uploadPreparedKnowledgeSourceFiles;
+    /**
+     * Reuses the shared iterator to upload one slice of knowledge-source files.
+     */
+    private uploadPreparedKnowledgeSourceFilesWorker;
+    /**
+     * Uploads one prepared knowledge-source file to OpenAI and records detailed diagnostics.
+     */
+    private uploadPreparedKnowledgeSourceFile;
+    /**
+     * Creates the OpenAI vector-store file batch for the uploaded knowledge-source files.
+     */
+    private createVectorStoreFileBatch;
+    /**
+     * Logs warnings for unexpected vector-store batch metadata right after creation.
+     */
+    private logCreatedVectorStoreFileBatchIssues;
+    /**
+     * Polls the created vector-store batch until ingestion completes, fails, or times out.
+     */
+    private pollVectorStoreFileBatchUntilSettled;
+    /**
+     * Resolves the next batch id to poll and retrieves the freshest OpenAI batch snapshot.
+     */
+    private retrieveVectorStoreFileBatchForPolling;
+    /**
+     * Normalizes the batch identifier returned by OpenAI and logs unusual id situations once.
+     */
+    private resolveVectorStoreFileBatchId;
+    /**
+     * Tracks observed polling progress and emits throttled verbose status logs.
+     */
+    private trackVectorStoreFileBatchProgress;
+    /**
+     * Emits deeper diagnostics when vector-store ingestion appears stalled for too long.
+     */
+    private maybeLogStalledVectorStoreFileBatch;
+    /**
+     * Handles terminal vector-store batch states that do not require further polling.
+     */
+    private handleVectorStoreFileBatchTerminalState;
+    /**
+     * Stops polling once the batch exceeds the configured timeout and handles optional cancellation.
+     */
+    private handleVectorStoreFileBatchTimeout;
+    /**
+     * Attempts to cancel a timed-out vector-store batch and logs any unusual id situation.
+     */
+    private cancelVectorStoreFileBatchAfterTimeout;
     /**
      * Creates a vector store and uploads knowledge sources, returning its ID.
      */

package/esm/src/llm-providers/openai/utils/OpenAiCompatibleUnsupportedParameterRetrier.d.ts

@@ -0,0 +1,29 @@
+import type { ModelRequirements } from '../../../types/ModelRequirements';
+import type { string_model_name } from '../../../types/typeAliases';
+/**
+ * Tracks unsupported-parameter retries for one OpenAI-compatible model call.
+ *
+ * @private helper of `OpenAiCompatibleExecutionTools`
+ */
+export declare class OpenAiCompatibleUnsupportedParameterRetrier {
+    private readonly isVerbose;
+    private readonly attemptStack;
+    private readonly retriedUnsupportedParameters;
+    constructor(isVerbose: boolean | undefined);
+    /**
+     * Resolves the next retry attempt after an unsupported-parameter failure or rethrows the final error.
+     */
+    resolveRetryOrThrow<TModelRequirements extends ModelRequirements>(options: {
+        readonly error: Error;
+        readonly modelName: string_model_name;
+        readonly currentModelRequirements: TModelRequirements;
+    }): TModelRequirements;
+    /**
+     * Rethrows the original error or wraps it with the collected retry history.
+     */
+    private throwWithAttemptHistory;
+    /**
+     * Creates the retry-history error message shared by all OpenAI-compatible model variants.
+     */
+    private createAttemptHistoryError;
+}

package/esm/src/llm-providers/openai/utils/callOpenAiCompatibleChatModel.d.ts

@@ -0,0 +1,28 @@
+import OpenAI from 'openai';
+import type { AvailableModel } from '../../../execution/AvailableModel';
+import type { ChatPromptResult } from '../../../execution/PromptResult';
+import type { Usage } from '../../../execution/Usage';
+import type { Prompt } from '../../../types/Prompt';
+import type { string_markdown_text, string_title } from '../../../types/typeAliases';
+import type { computeOpenAiUsage } from '../computeOpenAiUsage';
+import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from '../OpenAiCompatibleExecutionToolsOptions';
+/**
+ * Type describing dependencies needed by `callOpenAiCompatibleChatModel`.
+ */
+type CallOpenAiCompatibleChatModelOptions = {
+    readonly prompt: Prompt;
+    readonly onProgress: (chunk: ChatPromptResult) => void;
+    readonly title: string_title & string_markdown_text;
+    readonly executionToolsOptions: OpenAiCompatibleExecutionToolsNonProxiedOptions;
+    readonly getClient: () => Promise<OpenAI>;
+    readonly executeRateLimitedRequest: <T>(requestFn: () => Promise<T>) => Promise<T>;
+    readonly computeUsage: (...args: Parameters<typeof computeOpenAiUsage>) => Usage;
+    readonly getDefaultChatModel: () => AvailableModel;
+};
+/**
+ * Calls the OpenAI-compatible chat model flow, including tool execution and unsupported-parameter retries.
+ *
+ * @private function of `OpenAiCompatibleExecutionTools`
+ */
+export declare function callOpenAiCompatibleChatModel(options: CallOpenAiCompatibleChatModelOptions): Promise<ChatPromptResult>;
+export {};

package/esm/src/types/number_usd.d.ts

@@ -2,7 +2,7 @@
  * Semantic helper for US Dollars
  */
 export type number_usd = number;
-export type { number_bytes, number_gigabytes, number_kilobytes, number_megabytes, number_terabytes } from './number_bytes';
+export type { number_bytes, number_gigabytes, number_kilobytes, number_megabytes, number_terabytes, } from './number_bytes';
 export type { number_id, number_linecol_number, number_tokens } from './number_id';
 export type { number_likeness } from './number_likeness';
 export type { number_days, number_hours, number_milliseconds, number_minutes, number_months, number_seconds, number_weeks, number_years, } from './number_milliseconds';

package/esm/src/types/string_parameter_name.d.ts

@@ -4,10 +4,10 @@
  * The concrete type declarations live in focused modules under `src/types`.
  */
 export type { InputParameters, Parameters, ReservedParameters } from './Parameters';
-export type { string_agent_hash, string_agent_name, string_agent_name_in_book, string_agent_permanent_id } from './string_agent_name';
+export type { string_agent_hash, string_agent_name, string_agent_name_in_book, string_agent_permanent_id, } from './string_agent_name';
 export type { string_business_category_name } from './string_business_category_name';
 export type { string_model_name } from './string_model_name';
-export type { string_name, string_parameter_name, string_parameter_value, string_reserved_parameter_name } from './string_name';
+export type { string_name, string_parameter_name, string_parameter_value, string_reserved_parameter_name, } from './string_name';
 export type { string_page, string_char } from './string_page';
 export type { string_chat_prompt, string_completion_prompt, string_prompt, string_prompt_image, string_system_message, string_template, string_text_prompt, } from './string_prompt';
 export type { string_persona_description, string_model_description } from './string_persona_description';

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

@@ -6,10 +6,10 @@ export type { string_base64, string_base_url, string_data_url, string_domain, st
 export type { string_knowledge_source_content, string_knowledge_source_link } from './string_knowledge_source_content';
 export type { string_attribute, string_attribute_value_scope, string_color, string_javascript_name, string_legal_entity, string_license, string_person_firstname, string_person_fullname, string_person_lastname, string_person_profile, string_postprocessing_function_name, string_translate_language, string_translate_name, string_translate_name_not_normalized, } from './string_person_fullname';
 export type { id, string_app_id, string_date_iso8601, string_language, string_license_token, string_password, string_pgp_key, string_promptbook_token, string_ssh_key, string_token, string_user_id, task_id, } from './string_token';
-export type { number_id, number_linecol_number, number_tokens, } from './number_id';
+export type { number_id, number_linecol_number, number_tokens } from './number_id';
 export type { number_integer, number_negative, number_port, number_positive } from './number_positive';
 export type { number_model_temperature, number_percent, number_seed } from './number_percent';
 export type { number_likeness } from './number_likeness';
 export type { number_weeks, number_days, number_hours, number_milliseconds, number_minutes, number_months, number_seconds, number_years, } from './number_milliseconds';
-export type { number_bytes, number_gigabytes, number_kilobytes, number_megabytes, number_terabytes } from './number_bytes';
+export type { number_bytes, number_gigabytes, number_kilobytes, number_megabytes, number_terabytes, } from './number_bytes';
 export type { number_usd } from './number_usd';

package/esm/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.112.0-38`).
+ * It follows semantic versioning (e.g., `0.112.0-40`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/remote-server",
-    "version": "0.112.0-39",
+    "version": "0.112.0-41",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -98,7 +98,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/remote-server.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.112.0-39"
+        "@promptbook/core": "0.112.0-41"
     },
     "dependencies": {
         "@mozilla/readability": "0.6.0",