@promptbook/types 0.103.0-42 → 0.103.0-44

package/README.md

@@ -9,8 +9,8 @@ Turn your company's scattered knowledge into AI ready Books
 
 
 
-[![NPM Version of ![Promptbook logo - cube with letters P and B](./design/logo-h1.png) Promptbook](https://badge.fury.io/js/promptbook.svg)](https://www.npmjs.com/package/promptbook)
-[![Quality of package ![Promptbook logo - cube with letters P and B](./design/logo-h1.png) Promptbook](https://packagequality.com/shield/promptbook.svg)](https://packagequality.com/#?package=promptbook)
+[![NPM Version of ![Promptbook logo](./design/logo-h1.png) Promptbook](https://badge.fury.io/js/promptbook.svg)](https://www.npmjs.com/package/promptbook)
+[![Quality of package ![Promptbook logo](./design/logo-h1.png) Promptbook](https://packagequality.com/shield/promptbook.svg)](https://packagequality.com/#?package=promptbook)
 [![Known Vulnerabilities](https://snyk.io/test/github/webgptorg/promptbook/badge.svg)](https://snyk.io/test/github/webgptorg/promptbook)
 [![🧪 Test Books](https://github.com/webgptorg/promptbook/actions/workflows/test-books.yml/badge.svg)](https://github.com/webgptorg/promptbook/actions/workflows/test-books.yml)
 [![🧪 Test build](https://github.com/webgptorg/promptbook/actions/workflows/test-build.yml/badge.svg)](https://github.com/webgptorg/promptbook/actions/workflows/test-build.yml)
@@ -23,11 +23,7 @@ Turn your company's scattered knowledge into AI ready Books
 
 ## 🌟 New Features
 
--   🚀 **GPT-5 Support** - Now includes OpenAI's most advanced language model with unprecedented reasoning capabilities and 200K context window
--   💡 VS Code support for `.book` files with syntax highlighting and IntelliSense
--   🐳 Official Docker image (`hejny/promptbook`) for seamless containerized usage
--   🔥 Native support for OpenAI `o3-mini`, GPT-4 and other leading LLMs
--   🔍 DeepSeek integration for advanced knowledge search
+-   **Gemini 3 Support**
 
 
 
@@ -362,7 +358,7 @@ Promptbook Engine will automatically enforce this knowledge during interactions.
 Your job is to provide legal advice and support to the company and its employees.<br/>
 You are knowledgeable, professional, and detail-oriented.<br/>
 <br/>
-**KNOWLEDGE**  https://company.com/company-policies.pdf<br/>
+**KNOWLEDGE** https://company.com/company-policies.pdf<br/>
 **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
 
 </td></tr></table>
@@ -384,7 +380,7 @@ You are knowledgeable, professional, and detail-oriented.<br/>
 **RULE** Always ensure compliance with laws and regulations.<br/>
 **RULE** Never provide legal advice outside your area of expertise.<br/>
 **RULE** Never provide legal advice about criminal law.<br/>
-**KNOWLEDGE**  https://company.com/company-policies.pdf<br/>
+**KNOWLEDGE** https://company.com/company-policies.pdf<br/>
 **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
 
 </td></tr></table>
@@ -404,7 +400,7 @@ You are knowledgeable, professional, and detail-oriented.<br/>
 **RULE** Always ensure compliance with laws and regulations.<br/>
 **RULE** Never provide legal advice outside your area of expertise.<br/>
 **RULE** Never provide legal advice about criminal law.<br/>
-**KNOWLEDGE**  https://company.com/company-policies.pdf<br/>
+**KNOWLEDGE** https://company.com/company-policies.pdf<br/>
 **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
 **ACTION** When a user asks about an issue that could be treated as a crime, notify legal@company.com.<br/>
 
@@ -455,14 +451,10 @@ Now you want to use it. There are several ways how to write your first book:
 
 We have written ai asistant in book who can help you with writing your first book.
 
-
-
 #### Your AI twin
 
 Copy your own behavior, personality, and knowledge into book and create your AI twin. It can help you with your work, personal life, or any other task.
 
-
-
 #### AI persona workpool
 
 Or you can pick from our library of pre-written books for various roles and tasks. You can find books for customer support, coding, marketing, sales, HR, legal, and many other roles.
@@ -582,8 +574,6 @@ Join our growing community of developers and users:
 
 
 
-
-
 ## 📚 Documentation
 
 See detailed guides and API reference in the [docs](https://github.com/webgptorg/promptbook/discussions/categories/concepts) or [online](https://discord.gg/x3QWNaa89N).
@@ -660,8 +650,6 @@ The following glossary is used to clarify certain concepts:
 
 _Note: This section is not a complete dictionary, more list of general AI / LLM terms that has connection with Promptbook_
 
-
-
 ### 💯 Core concepts
 
 -   [📚 Collection of pipelines](https://github.com/webgptorg/promptbook/discussions/65)

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

@@ -16,6 +16,7 @@ import { getAllCommitmentDefinitions } from '../book-2.0/commitments/index';
 import { getAllCommitmentTypes } from '../book-2.0/commitments/index';
 import { isCommitmentSupported } from '../book-2.0/commitments/index';
 import { generatePlaceholderAgentProfileImageUrl } from '../book-2.0/utils/generatePlaceholderAgentProfileImageUrl';
+import { AgentCollectionInSupabase } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase';
 import { createPipelineCollectionFromJson } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromJson';
 import { createPipelineCollectionFromPromise } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromPromise';
 import { createPipelineCollectionFromUrl } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromUrl';
@@ -78,6 +79,7 @@ import { PROMPTBOOK_ERRORS } from '../errors/0-index';
 import { AbstractFormatError } from '../errors/AbstractFormatError';
 import { AuthenticationError } from '../errors/AuthenticationError';
 import { CollectionError } from '../errors/CollectionError';
+import { DatabaseError } from '../errors/DatabaseError';
 import { EnvironmentMismatchError } from '../errors/EnvironmentMismatchError';
 import { ExpectError } from '../errors/ExpectError';
 import { KnowledgeScrapeError } from '../errors/KnowledgeScrapeError';
@@ -182,6 +184,7 @@ import { NonTaskSectionTypes } from '../types/SectionType';
 import { SectionTypes } from '../types/SectionType';
 import { TaskTypes } from '../types/TaskType';
 import { aboutPromptbookInformation } from '../utils/misc/aboutPromptbookInformation';
+import { $generateBookBoilerplate } from '../utils/random/$generateBookBoilerplate';
 import { REMOTE_SERVER_URLS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { createAgentModelRequirements };
@@ -201,6 +204,7 @@ export { getAllCommitmentDefinitions };
 export { getAllCommitmentTypes };
 export { isCommitmentSupported };
 export { generatePlaceholderAgentProfileImageUrl };
+export { AgentCollectionInSupabase };
 export { createPipelineCollectionFromJson };
 export { createPipelineCollectionFromPromise };
 export { createPipelineCollectionFromUrl };
@@ -263,6 +267,7 @@ export { PROMPTBOOK_ERRORS };
 export { AbstractFormatError };
 export { AuthenticationError };
 export { CollectionError };
+export { DatabaseError };
 export { EnvironmentMismatchError };
 export { ExpectError };
 export { KnowledgeScrapeError };
@@ -367,4 +372,5 @@ export { NonTaskSectionTypes };
 export { SectionTypes };
 export { TaskTypes };
 export { aboutPromptbookInformation };
+export { $generateBookBoilerplate };
 export { REMOTE_SERVER_URLS };

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

@@ -1,5 +1,4 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
-import { AgentCollectionInDirectory } from '../collection/agent-collection/constructors/AgentCollectionInDirectory';
 import { createPipelineCollectionFromDirectory } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromDirectory';
 import { $provideExecutablesForNode } from '../executables/$provideExecutablesForNode';
 import { $provideExecutionToolsForNode } from '../execution/utils/$provideExecutionToolsForNode';
@@ -12,7 +11,6 @@ import { FileCacheStorage } from '../storage/file-cache-storage/FileCacheStorage
 import { $execCommand } from '../utils/execCommand/$execCommand';
 import { $execCommands } from '../utils/execCommand/$execCommands';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
-export { AgentCollectionInDirectory };
 export { createPipelineCollectionFromDirectory };
 export { $provideExecutablesForNode };
 export { $provideExecutionToolsForNode };

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

@@ -23,6 +23,13 @@ import type { ChatParticipant } from '../book-components/Chat/types/ChatParticip
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
 import type { QrCodeOptions } from '../book-components/Qr/useQrCode';
 import type { AgentCollection } from '../collection/agent-collection/AgentCollection';
+import type { Json } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { AgentsDatabaseSchema } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { Tables } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { TablesInsert } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { TablesUpdate } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { Enums } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { CompositeTypes } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
 import type { PipelineCollection } from '../collection/pipeline-collection/PipelineCollection';
 import type { Command } from '../commands/_common/types/Command';
 import type { CommandParser } from '../commands/_common/types/CommandParser';
@@ -209,6 +216,7 @@ import type { string_reserved_parameter_name } from '../types/typeAliases';
 import type { ReservedParameters } from '../types/typeAliases';
 import type { string_title } from '../types/typeAliases';
 import type { string_agent_name } from '../types/typeAliases';
+import type { string_agent_name_in_book } from '../types/typeAliases';
 import type { string_persona_description } from '../types/typeAliases';
 import type { string_model_description } from '../types/typeAliases';
 import type { string_knowledge_source_content } from '../types/typeAliases';
@@ -267,6 +275,8 @@ import type { string_absolute_dirname } from '../types/typeAliases';
 import type { string_relative_dirname } from '../types/typeAliases';
 import type { string_dirname } from '../types/typeAliases';
 import type { string_person_fullname } from '../types/typeAliases';
+import type { string_person_firstname } from '../types/typeAliases';
+import type { string_person_lastname } from '../types/typeAliases';
 import type { string_person_profile } from '../types/typeAliases';
 import type { string_license } from '../types/typeAliases';
 import type { string_legal_entity } from '../types/typeAliases';
@@ -335,6 +345,7 @@ import type { OrderJsonOptions } from '../utils/normalization/orderJson';
 import type { empty_object } from '../utils/organization/empty_object';
 import type { really_any } from '../utils/organization/really_any';
 import type { TODO_any } from '../utils/organization/TODO_any';
+import type { RandomFullnameWithColorResult } from '../utils/random/$randomFullnameWithColor';
 import type { CheckSerializableAsJsonOptions } from '../utils/serialization/checkSerializableAsJson';
 import type { ExportJsonOptions } from '../utils/serialization/exportJson';
 import type { ITakeChain } from '../utils/take/interfaces/ITakeChain';
@@ -364,6 +375,13 @@ export type { ChatParticipant };
 export type { MessageButton };
 export type { QrCodeOptions };
 export type { AgentCollection };
+export type { Json };
+export type { AgentsDatabaseSchema };
+export type { Tables };
+export type { TablesInsert };
+export type { TablesUpdate };
+export type { Enums };
+export type { CompositeTypes };
 export type { PipelineCollection };
 export type { Command };
 export type { CommandParser };
@@ -550,6 +568,7 @@ export type { string_reserved_parameter_name };
 export type { ReservedParameters };
 export type { string_title };
 export type { string_agent_name };
+export type { string_agent_name_in_book };
 export type { string_persona_description };
 export type { string_model_description };
 export type { string_knowledge_source_content };
@@ -608,6 +627,8 @@ export type { string_absolute_dirname };
 export type { string_relative_dirname };
 export type { string_dirname };
 export type { string_person_fullname };
+export type { string_person_firstname };
+export type { string_person_lastname };
 export type { string_person_profile };
 export type { string_license };
 export type { string_legal_entity };
@@ -676,6 +697,7 @@ export type { OrderJsonOptions };
 export type { empty_object };
 export type { really_any };
 export type { TODO_any };
+export type { RandomFullnameWithColorResult };
 export type { CheckSerializableAsJsonOptions };
 export type { ExportJsonOptions };
 export type { ITakeChain };

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

@@ -11,6 +11,7 @@ import { jsonParse } from '../formats/json/utils/jsonParse';
 import { isValidXmlString } from '../formats/xml/utils/isValidXmlString';
 import { prompt } from '../pipeline/prompt-notation';
 import { promptTemplate } from '../pipeline/prompt-notation';
+import { $detectRuntimeEnvironment } from '../utils/environment/$detectRuntimeEnvironment';
 import { $isRunningInBrowser } from '../utils/environment/$isRunningInBrowser';
 import { $isRunningInJest } from '../utils/environment/$isRunningInJest';
 import { $isRunningInNode } from '../utils/environment/$isRunningInNode';
@@ -96,6 +97,7 @@ export { jsonParse };
 export { isValidXmlString };
 export { prompt };
 export { promptTemplate };
+export { $detectRuntimeEnvironment };
 export { $isRunningInBrowser };
 export { $isRunningInJest };
 export { $isRunningInNode };

package/esm/typings/src/book-2.0/agent-source/AgentBasicInformation.d.ts

@@ -1,4 +1,4 @@
-import type { string_agent_name, string_url_image } from '../../types/typeAliases';
+import type { string_agent_name, string_color, string_url_image } from '../../types/typeAliases';
 /**
  * Unified parameter representation that supports two different notations:
  * 1. @Parameter - single word parameter starting with @
@@ -41,9 +41,7 @@ export type AgentBasicInformation = {
      */
     meta: {
         image?: string_url_image;
-        link?: string;
-        title?: string;
-        description?: string;
+        color?: string_color;
         [key: string]: string | undefined;
     };
     /**

package/esm/typings/src/book-2.0/agent-source/padBook.d.ts

@@ -1,4 +1,4 @@
-import { string_book } from './string_book';
+import type { string_book } from './string_book';
 /**
  *  Number of padding lines to add at the end of the book content
  *

package/esm/typings/src/book-2.0/agent-source/string_book.d.ts

@@ -21,6 +21,7 @@ export declare function validateBook(source: string): string_book;
 /**
  * Default book
  *
+ * @deprecated Use `$generateBookBoilerplate` instead
  * @public exported from `@promptbook/core`
  */
 export declare const DEFAULT_BOOK: string_book;

package/esm/typings/src/book-components/AvatarProfile/AvatarProfile/AvatarProfile.d.ts

@@ -1,3 +1,4 @@
+import { CSSProperties } from 'react';
 import type { AgentBasicInformation } from '../../../book-2.0/agent-source/AgentBasicInformation';
 import type { string_book } from '../../../book-2.0/agent-source/string_book';
 import type { string_css_class } from '../../../types/typeAliases';
@@ -14,11 +15,15 @@ export type AvatarProfileProps = {
     /**
      * The source of the agent, which will be displayed in the BookEditor.
      */
-    readonly agentSource: string_book;
+    readonly agentSource?: string_book;
     /**
      * Optional CSS class name which will be added to root <div> element
      */
     readonly className?: string_css_class;
+    /**
+     * Optional CSS style which will be added to root <div/> element
+     */
+    readonly style?: CSSProperties;
 };
 /**
  * Shows a box with user avatar, name and description

package/esm/typings/src/book-components/BookEditor/BookEditor.d.ts

@@ -1,6 +1,6 @@
 import { CSSProperties } from 'react';
 import type { Promisable } from 'type-fest';
-import { type string_book } from '../../book-2.0/agent-source/string_book';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
 import type { number_percent, number_positive, string_css_value, string_knowledge_source_content } from '../../types/typeAliases';
 /**
  * Default height of the book editor

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

@@ -1,7 +1,7 @@
 import type { Promisable } from 'type-fest';
 import type { string_file_extension, string_mime_type } from '../../../../types/typeAliases';
 import type { ChatMessage } from '../../types/ChatMessage';
-import { ChatParticipant } from '../../types/ChatParticipant';
+import type { ChatParticipant } from '../../types/ChatParticipant';
 /**
  * Plugin contract for chat export formatNames
  *

package/esm/typings/src/book-components/Chat/types/ChatParticipant.d.ts

@@ -1,6 +1,6 @@
+import type { string_book } from '../../../book-2.0/agent-source/string_book';
 import type { id, string_color, string_person_fullname, string_url_image } from '../../../types/typeAliases';
 import { Color } from '../../../utils/color/Color';
-import type { string_book } from '../../../book-2.0/agent-source/string_book';
 /**
  * A participant in the chat
  *

package/esm/typings/src/book-components/Qr/BrandedQrCode.d.ts

@@ -1,4 +1,4 @@
-import { QrCodeOptions } from './useQrCode';
+import type { QrCodeOptions } from './useQrCode';
 type BrandedQrCodeProps = QrCodeOptions & {
     /**
      * Width and height of the QR code canvas

package/esm/typings/src/book-components/Qr/useQrCode.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="react" />
 import type { QRCodeRenderersOptions } from 'qrcode';
-import { string_url_image } from '../../types/typeAliases';
+import type { string_url_image } from '../../types/typeAliases';
 export type QrCodeOptions = QRCodeRenderersOptions & {
     value: string | number;
     logoSrc?: string_url_image;

package/esm/typings/src/cli/cli-commands/_boilerplate.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `boilerplate` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/cli-commands/about.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `about` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/cli-commands/hello.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes testing `hello` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/cli-commands/list-models.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `list-models` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/cli-commands/list-scrapers.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `list-scrapers` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/cli-commands/login.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `login` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/cli-commands/make.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `make` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/cli-commands/prettify.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `prettify` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/cli-commands/run.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `run` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/cli-commands/start-agents-server.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `start-agents-server` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/cli-commands/start-pipelines-server.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `start-pipelines-server` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/cli-commands/test-command.d.ts

@@ -1,5 +1,5 @@
 import type { Command as Program } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `test` command for Promptbook CLI utilities
  *

package/esm/typings/src/cli/common/$addGlobalOptionsToCommand.d.ts

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Note: `$` is used to indicate that this function is not a pure function - it registers an option in the CLI
  *

package/esm/typings/src/collection/agent-collection/AgentCollection.d.ts

@@ -1,7 +1,4 @@
-import type { Promisable } from 'type-fest';
-import { Agent } from '../../_packages/core.index';
-import { string_book } from '../../_packages/types.index';
-import type { string_agent_name } from '../../types/typeAliases';
+import { AgentCollectionInSupabase } from './constructors/agent-collection-in-supabase/AgentCollectionInSupabase';
 /**
  * Collection that groups together multiple AI Agents
  *
@@ -9,31 +6,7 @@ import type { string_agent_name } from '../../types/typeAliases';
  * - `AgentCollection` - which groups together AI Agents
  * - `PipelineCollection` - which groups together *(deprecated)* pipelines
  */
-export type AgentCollection = {
-    /**
-     * Gets all agents in the collection
-     */
-    listAgents(): Promisable<ReadonlyArray<string_agent_name>>;
-    /**
-     * Get one agent by its name
-     *
-     * Note: Agents are existing independently of you getting them or not, you can get the same agent multiple times.
-     * Note: Agents are changed by interacting with `Agent` objects directly. Only creation and deletion is done via the collection.
-     */
-    getAgentByName(agentName: string_agent_name): Promisable<Agent>;
-    /**
-     * Deletes an agent from the collection
-     *
-     * Note: When you want delete an agent by name, first get the agent using `getAgentByName` and then pass it to `deleteAgent`.
-     */
-    deleteAgent(agent: Agent): Promisable<void>;
-    /**
-     * Creates a new agent in the collection
-     *
-     * Note: You can set 'PARENT' in the agent source to inherit from another agent in the collection.
-     */
-    createAgent(agentSource: string_book): Promisable<Agent>;
-};
+export type AgentCollection = AgentCollectionInSupabase;
 /**
  * TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention
  */

package/esm/typings/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts

@@ -0,0 +1,107 @@
+import type { SupabaseClient } from '@supabase/supabase-js';
+import { BehaviorSubject } from 'rxjs';
+import type { AgentBasicInformation } from '../../../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_book } from '../../../../book-2.0/agent-source/string_book';
+import type { CommonToolsOptions } from '../../../../execution/CommonToolsOptions';
+import type { PrepareAndScrapeOptions } from '../../../../prepare/PrepareAndScrapeOptions';
+import type { string_agent_name } from '../../../../types/typeAliases';
+import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
+/**
+ * Agent collection stored in Supabase table
+ *
+ * Note: This object can work both from Node.js and browser environment depending on the Supabase client provided
+ *
+ * @public exported from `@promptbook/core`
+ * <- TODO: !!! Move to `@promptbook/supabase` package
+ */
+export declare class AgentCollectionInSupabase {
+    private readonly supabaseClient;
+    readonly options?: (PrepareAndScrapeOptions & CommonToolsOptions) | undefined;
+    /**
+     * @param rootPath - path to the directory with agents
+     * @param tools - Execution tools to be used in !!! `Agent` itself and listing the agents
+     * @param options - Options for the collection creation
+     */
+    constructor(supabaseClient: SupabaseClient<AgentsDatabaseSchema>, options?: (PrepareAndScrapeOptions & CommonToolsOptions) | undefined);
+    /**
+     * Cached defined execution tools
+     */
+    /**
+     * Gets all agents in the collection
+     */
+    listAgents(): Promise<ReadonlyArray<AgentBasicInformation>>;
+    /**
+     * !!!
+     * /
+    public async spawnAgent(agentName: string_agent_name): Promise<Agent> {
+   
+        // <- TODO: !!! ENOENT: no such file or directory, open 'C:\Users\me\work\ai\promptbook\agents\examples\Asistent pro LŠVP.book
+        const { isVerbose = DEFAULT_IS_VERBOSE } = this.options || {};
+        const tools = await this.getTools();
+
+        const agentSourceValue = validateBook(await tools.fs!.readFile(agentSourcePath, 'utf-8'));
+        const agentSource = new BehaviorSubject(agentSourceValue);
+
+        // Note: Write file whenever agent source changes
+        agentSource.subscribe(async (newSource) => {
+            if (isVerbose) {
+                console.info(colors.cyan(`Writing agent source to file ${agentSourcePath}`));
+            }
+            await forTime(500); // <- TODO: [🙌] !!! Remove
+            await tools.fs!.writeFile(agentSourcePath, newSource, 'utf-8');
+        });
+
+        // Note: Watch file for external changes
+        for await (const event of tools.fs!.watch(agentSourcePath)) {
+            // <- TODO: !!!! Solve the memory freeing when the watching is no longer needed
+
+            if (event.eventType !== 'change') {
+                continue;
+            }
+
+            if (isVerbose) {
+                console.info(
+                    colors.cyan(`Detected external change in agent source file ${agentSourcePath}, reloading`),
+                );
+            }
+            await forTime(500); // <- TODO: [🙌] !!! Remove
+            const newSource = validateBook(await tools.fs!.readFile(agentSourcePath, 'utf-8'));
+            agentSource.next(newSource);
+        }
+
+        // TODO: [🙌] !!!! Debug the infinite loop when file is changed externally and agent source is updated which causes file to be written again
+
+        const agent = new Agent({
+            ...this.options,
+            agentSource,
+            executionTools: this.tools || {},
+        });
+
+        if (isVerbose) {
+            console.info(colors.cyan(`Created agent "${agent.agentName}" from source file ${agentSourcePath}`));
+        }
+
+        return agent;
+        * /
+    }
+    */
+    /**
+     * !!!@@@
+     */
+    getAgentSource(agentName: string_agent_name): Promise<BehaviorSubject<string_book>>;
+    /**
+     * Creates a new agent in the collection
+     *
+     * Note: You can set 'PARENT' in the agent source to inherit from another agent in the collection.
+     */
+    createAgent(agentSource: string_book): Promise<AgentBasicInformation>;
+    /**
+     * Deletes an agent from the collection
+     */
+    deleteAgent(agentName: string_agent_name): Promise<void>;
+}
+/**
+ * TODO: !!!! Implement it here correctly and update JSDoc comments here, and on interface + other implementations
+ * TODO: Write unit test
+ * TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention
+ */