@promptbook/openai 0.103.0-37 → 0.103.0-40

package/README.md

@@ -82,7 +82,7 @@ The package offers three main integration paths:
 ```typescript
 import { createPipelineExecutor } from '@promptbook/core';
 import {
-    createCollectionFromDirectory,
+    createPipelineCollectionFromDirectory,
     $provideExecutionToolsForNode,
     $provideFilesystemForNode,
     $provideScrapersForNode,
@@ -110,7 +110,7 @@ const tools = {
 };
 
 // ▶ Create whole pipeline collection
-const collection = await createCollectionFromDirectory('./books', tools);
+const collection = await createPipelineCollectionFromDirectory('./books', tools);
 
 // ▶ Get single Pipeline
 const pipeline = await collection.getPipelineByUrl(`https://promptbook.studio/my-collection/write-article.book`);
@@ -164,7 +164,7 @@ console.info(joke);
 You can just use `$provideExecutionToolsForNode` function to create all required tools from environment variables like `ANTHROPIC_CLAUDE_API_KEY` and `OPENAI_API_KEY` automatically.
 
 ```typescript
-import { createPipelineExecutor, createCollectionFromDirectory } from '@promptbook/core';
+import { createPipelineExecutor, createPipelineCollectionFromDirectory } from '@promptbook/core';
 import { JavascriptExecutionTools } from '@promptbook/javascript';
 import { $provideExecutionToolsForNode } from '@promptbook/node';
 import { $provideFilesystemForNode } from '@promptbook/node';
@@ -174,7 +174,7 @@ import { $provideFilesystemForNode } from '@promptbook/node';
 const tools = await $provideExecutionToolsForNode();
 
 // ▶ Create whole pipeline collection
-const collection = await createCollectionFromDirectory('./books', tools);
+const collection = await createPipelineCollectionFromDirectory('./books', tools);
 
 // ▶ Get single Pipeline
 const pipeline = await collection.getPipelineByUrl(`https://promptbook.studio/my-collection/write-article.book`);
@@ -202,7 +202,7 @@ You can use multiple LLM providers in one Promptbook execution. The best model w
 ```typescript
 import { createPipelineExecutor } from '@promptbook/core';
 import {
-    createCollectionFromDirectory,
+    createPipelineCollectionFromDirectory,
     $provideExecutionToolsForNode,
     $provideFilesystemForNode,
 } from '@promptbook/node';
@@ -246,7 +246,7 @@ const tools = {
 };
 
 // ▶ Create whole pipeline collection
-const collection = await createCollectionFromDirectory('./books', tools);
+const collection = await createPipelineCollectionFromDirectory('./books', tools);
 
 // ▶ Get single Pipeline
 const pipeline = await collection.getPipelineByUrl(`https://promptbook.studio/my-collection/write-article.book`);
@@ -292,7 +292,7 @@ import { startRemoteServer } from '@promptbook/remote-server';
 // Start the server
 await startRemoteServer({
     port: 3000,
-    collection: await createCollectionFromDirectory('./books'),
+    collection: await createPipelineCollectionFromDirectory('./books'),
     isAnonymousModeAllowed: true,
     isApplicationModeAllowed: true,
 });
@@ -329,8 +329,6 @@ This allows you to:
 -   Integrate Promptbook into existing OpenAI-based applications
 -   Use Promptbook books as models in other AI frameworks
 
-
-
 ## 📦 Exported Entities
 
 ### Version Information

package/esm/index.es.js

@@ -1,4 +1,5 @@
 import colors from 'colors';
+import { forEver } from 'waitasecond';
 import spaceTrim$1, { spaceTrim } from 'spacetrim';
 import { randomBytes } from 'crypto';
 import Bottleneck from 'bottleneck';
@@ -19,7 +20,7 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-37';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-40';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -3626,6 +3627,12 @@ class OpenAiExecutionTools extends OpenAiCompatibleExecutionTools {
  *
  * This is useful for calling OpenAI API with a single assistant, for more wide usage use `OpenAiExecutionTools`.
  *
+ * Note: [🦖] There are several different things in Promptbook:
+ * - `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
+ * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+ *
  * @public exported from `@promptbook/openai`
  */
 class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
@@ -3791,10 +3798,32 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             },
         });
     }
-    async createNewAssistant() {
+    async playground() {
+        const client = await this.getClient();
+        // List all assistants
+        const assistants = await client.beta.assistants.list();
+        console.log('!!! Assistants:', assistants);
+        // Get details of a specific assistant
+        const assistantId = 'asst_MO8fhZf4dGloCfXSHeLcIik0';
+        const assistant = await client.beta.assistants.retrieve(assistantId);
+        console.log('!!! Assistant Details:', assistant);
+        // Update an assistant
+        const updatedAssistant = await client.beta.assistants.update(assistantId, {
+            name: assistant.name + '(M)',
+            description: 'Updated description via Promptbook',
+            metadata: {
+                [Math.random().toString(36).substring(2, 15)]: new Date().toISOString(),
+            },
+        });
+        console.log('!!! Updated Assistant:', updatedAssistant);
+        await forEver();
+    }
+    async createNewAssistant(options) {
         if (!this.isCreatingNewAssistantsAllowed) {
             throw new NotAllowed(`Creating new assistants is not allowed. Set \`isCreatingNewAssistantsAllowed: true\` in options to enable this feature.`);
         }
+        await this.playground();
+        const { name, instructions } = options;
         const client = await this.getClient();
         /*
         TODO: !!!
@@ -3842,21 +3871,20 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             uploadedFiles.push(file.id);
         }
         */
+        alert('!!!! Creating new OpenAI assistant');
         // 3️⃣ Create assistant with uploaded files
         const assistant = await client.beta.assistants.create({
-            name: 'Next.js documentation assistant',
-            description: 'Assistant that can answer questions about Next.js and working with APIs.',
+            name,
+            description: 'Assistant created via Promptbook',
             model: 'gpt-4o',
-            instructions: spaceTrim$1(`
-                Answer clearly and comprehensively.
-                Quote parts from uploaded files if needed.
-            `),
-            // <- TODO: !!!! Generate the `instructions` from passed `agentSource` (generate outside of this class)
-            tools: [{ type: 'code_interpreter' }, { type: 'file_search' }],
+            instructions,
+            tools: [/* TODO: [🧠] Maybe add { type: 'code_interpreter' }, */ { type: 'file_search' }],
             // !!!! file_ids: uploadedFiles,
         });
-        // TODO: !!!! Change Czech to English
         console.log(`✅ Assistant created: ${assistant.id}`);
+        // TODO: !!!! Try listing existing assistants
+        // TODO: !!!! Try marking existing assistants by DISCRIMINANT
+        // TODO: !!!! Allow to update and reconnect to existing assistants
         return new OpenAiAssistantExecutionTools({
             ...this.options,
             isCreatingNewAssistantsAllowed: false,