@promptbook/javascript 0.110.0-4 → 0.110.0-5

package/esm/index.es.js

@@ -18,7 +18,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.110.0-4';
+const PROMPTBOOK_ENGINE_VERSION = '0.110.0-5';
 /**
  * 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/typings/src/_packages/openai.index.d.ts

@@ -1,10 +1,8 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
-import { createOpenAiAgentExecutionTools } from '../llm-providers/openai/createOpenAiAgentExecutionTools';
 import { createOpenAiAssistantExecutionTools } from '../llm-providers/openai/createOpenAiAssistantExecutionTools';
 import { createOpenAiCompatibleExecutionTools } from '../llm-providers/openai/createOpenAiCompatibleExecutionTools';
 import { createOpenAiExecutionTools } from '../llm-providers/openai/createOpenAiExecutionTools';
 import { OPENAI_MODELS } from '../llm-providers/openai/openai-models';
-import { OpenAiAgentExecutionTools } from '../llm-providers/openai/OpenAiAgentExecutionTools';
 import { OpenAiAssistantExecutionTools } from '../llm-providers/openai/OpenAiAssistantExecutionTools';
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import { OpenAiCompatibleExecutionTools } from '../llm-providers/openai/OpenAiCompatibleExecutionTools';
@@ -17,12 +15,10 @@ import { _OpenAiRegistration } from '../llm-providers/openai/register-constructo
 import { _OpenAiAssistantRegistration } from '../llm-providers/openai/register-constructor';
 import { _OpenAiCompatibleRegistration } from '../llm-providers/openai/register-constructor';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
-export { createOpenAiAgentExecutionTools };
 export { createOpenAiAssistantExecutionTools };
 export { createOpenAiCompatibleExecutionTools };
 export { createOpenAiExecutionTools };
 export { OPENAI_MODELS };
-export { OpenAiAgentExecutionTools };
 export { OpenAiAssistantExecutionTools };
 export type { OpenAiAssistantExecutionToolsOptions };
 export { OpenAiCompatibleExecutionTools };

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

@@ -138,7 +138,6 @@ import type { AzureOpenAiExecutionToolsOptions } from '../llm-providers/azure-op
 import type { DeepseekExecutionToolsOptions } from '../llm-providers/deepseek/DeepseekExecutionToolsOptions';
 import type { GoogleExecutionToolsOptions } from '../llm-providers/google/GoogleExecutionToolsOptions';
 import type { OllamaExecutionToolsOptions } from '../llm-providers/ollama/OllamaExecutionToolsOptions';
-import type { OpenAiAgentExecutionToolsOptions } from '../llm-providers/openai/OpenAiAgentExecutionTools';
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import type { OpenAiCompatibleExecutionToolsOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
 import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
@@ -540,7 +539,6 @@ export type { AzureOpenAiExecutionToolsOptions };
 export type { DeepseekExecutionToolsOptions };
 export type { GoogleExecutionToolsOptions };
 export type { OllamaExecutionToolsOptions };
-export type { OpenAiAgentExecutionToolsOptions };
 export type { OpenAiAssistantExecutionToolsOptions };
 export type { OpenAiCompatibleExecutionToolsOptions };
 export type { OpenAiCompatibleExecutionToolsNonProxiedOptions };

package/esm/typings/src/llm-providers/agent/Agent.d.ts

@@ -14,7 +14,6 @@ import type { AgentOptions } from './AgentOptions';
  * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
  * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
  * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
- * - `OpenAiAgentExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with agent capabilities (using Responses API), recommended for usage in `Agent` or `AgentLlmExecutionTools`
  * - `OpenAiAssistantExecutionTools` - (Deprecated) which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities
  * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
  *

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

@@ -16,7 +16,6 @@ import type { CreateAgentLlmExecutionToolsOptions } from './CreateAgentLlmExecut
  * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
  * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
  * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
- * - `OpenAiAgentExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with agent capabilities (using Responses API), recommended for usage in `Agent` or `AgentLlmExecutionTools`
  * - `OpenAiAssistantExecutionTools` - (Deprecated) which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities
  * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
  *

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

@@ -18,7 +18,6 @@ import { OpenAiExecutionTools } from './OpenAiExecutionTools';
  * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
  *
  * @public exported from `@promptbook/openai`
- * @deprecated Use `OpenAiAgentExecutionTools` instead which uses the new OpenAI Responses API
  */
 export declare class OpenAiAssistantExecutionTools extends OpenAiExecutionTools implements LlmExecutionTools {
     readonly assistantId: string_token;
@@ -43,6 +42,46 @@ export declare class OpenAiAssistantExecutionTools extends OpenAiExecutionTools
      * Get an existing assistant tool wrapper
      */
     getAssistant(assistantId: string_token): OpenAiAssistantExecutionTools;
+    /**
+     * Returns the per-knowledge-source download timeout in milliseconds.
+     */
+    private getKnowledgeSourceDownloadTimeoutMs;
+    /**
+     * Returns the max concurrency for knowledge source uploads.
+     */
+    private getKnowledgeSourceUploadMaxConcurrency;
+    /**
+     * Returns the polling interval in milliseconds for vector store uploads.
+     */
+    private getKnowledgeSourceUploadPollIntervalMs;
+    /**
+     * Returns the overall upload timeout in milliseconds for vector store uploads.
+     */
+    private getKnowledgeSourceUploadTimeoutMs;
+    /**
+     * Returns true if we should continue even if vector store ingestion stalls.
+     */
+    private shouldContinueOnVectorStoreStall;
+    /**
+     * Returns assistant-specific options with extended settings.
+     */
+    private get assistantOptions();
+    /**
+     * Downloads a knowledge source URL into a File for vector store upload.
+     */
+    private downloadKnowledgeSourceFile;
+    /**
+     * Logs vector store file batch diagnostics to help trace ingestion stalls or failures.
+     */
+    private logVectorStoreFileBatchDiagnostics;
+    /**
+     * Uploads knowledge source files to the vector store and polls until processing completes.
+     */
+    private uploadKnowledgeSourceFilesToVectorStore;
+    /**
+     * Creates a vector store and uploads knowledge sources, returning its ID.
+     */
+    private createVectorStoreWithKnowledgeSources;
     createNewAssistant(options: {
         /**
          * Name of the new assistant

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

@@ -17,4 +17,34 @@ export type OpenAiAssistantExecutionToolsOptions = OpenAiCompatibleExecutionTool
      * Which assistant to use
      */
     readonly assistantId: string_token;
+    /**
+     * Per-knowledge-source download timeout in milliseconds when preparing assistants.
+     *
+     * @default 30000
+     */
+    readonly knowledgeSourceDownloadTimeoutMs?: number;
+    /**
+     * Max concurrency for uploading knowledge source files to the vector store.
+     *
+     * @default 5
+     */
+    readonly knowledgeSourceUploadMaxConcurrency?: number;
+    /**
+     * Poll interval in milliseconds when waiting for vector store file batch processing.
+     *
+     * @default 5000
+     */
+    readonly knowledgeSourceUploadPollIntervalMs?: number;
+    /**
+     * Overall timeout in milliseconds for vector store file batch processing.
+     *
+     * @default 900000
+     */
+    readonly knowledgeSourceUploadTimeoutMs?: number;
+    /**
+     * Whether we should continue even if vector store ingestion stalls.
+     *
+     * @default true
+     */
+    readonly shouldContinueOnVectorStoreStall?: boolean;
 };

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/javascript",
-    "version": "0.110.0-4",
+    "version": "0.110.0-5",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -94,7 +94,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/javascript.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.110.0-4"
+        "@promptbook/core": "0.110.0-5"
     },
     "dependencies": {
         "crypto": "1.0.1",

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.110.0-4';
+    const PROMPTBOOK_ENGINE_VERSION = '0.110.0-5';
     /**
      * 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/typings/src/llm-providers/openai/OpenAiAgentExecutionTools.d.ts

@@ -1,43 +0,0 @@
-import OpenAI from 'openai';
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
-import type { ChatPromptResult } from '../../execution/PromptResult';
-import type { Prompt } from '../../types/Prompt';
-import type { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
-import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from './OpenAiCompatibleExecutionToolsOptions';
-import { OpenAiExecutionTools } from './OpenAiExecutionTools';
-/**
- * Options for OpenAiAgentExecutionTools
- */
-export type OpenAiAgentExecutionToolsOptions = OpenAiCompatibleExecutionToolsNonProxiedOptions & {
-    /**
-     * ID of the vector store to use for file search
-     */
-    readonly vectorStoreId?: string;
-};
-/**
- * Execution Tools for calling OpenAI API using the Responses API (Agents)
- *
- * @public exported from `@promptbook/openai`
- */
-export declare class OpenAiAgentExecutionTools extends OpenAiExecutionTools implements LlmExecutionTools {
-    readonly vectorStoreId?: string;
-    constructor(options: OpenAiAgentExecutionToolsOptions);
-    get title(): string_title & string_markdown_text;
-    get description(): string_markdown;
-    /**
-     * Calls OpenAI API to use a chat model with streaming.
-     */
-    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
-    /**
-     * Creates a vector store from knowledge sources
-     */
-    static createVectorStore(client: OpenAI, name: string, knowledgeSources: ReadonlyArray<string>): Promise<string>;
-    /**
-     * Discriminant for type guards
-     */
-    protected get discriminant(): string;
-    /**
-     * Type guard to check if given `LlmExecutionTools` are instanceof `OpenAiAgentExecutionTools`
-     */
-    static isOpenAiAgentExecutionTools(llmExecutionTools: LlmExecutionTools): llmExecutionTools is OpenAiAgentExecutionTools;
-}

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

@@ -1,11 +0,0 @@
-import { OpenAiAgentExecutionTools } from './OpenAiAgentExecutionTools';
-import type { OpenAiAgentExecutionToolsOptions } from './OpenAiAgentExecutionTools';
-/**
- * Execution Tools for calling OpenAI API using Responses API
- *
- * @public exported from `@promptbook/openai`
- */
-export declare const createOpenAiAgentExecutionTools: ((options: OpenAiAgentExecutionToolsOptions) => OpenAiAgentExecutionTools) & {
-    packageName: string;
-    className: string;
-};