@promptbook/types 0.103.0-42 → 0.103.0-43

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';
@@ -364,6 +371,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 };

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

@@ -14,7 +14,7 @@ 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
      */

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,6 +1,7 @@
 import type { Promisable } from 'type-fest';
-import { Agent } from '../../_packages/core.index';
-import { string_book } from '../../_packages/types.index';
+import type { AgentBasicInformation } from '../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import { Agent } from '../../llm-providers/agent/Agent';
 import type { string_agent_name } from '../../types/typeAliases';
 /**
  * Collection that groups together multiple AI Agents
@@ -13,26 +14,24 @@ export type AgentCollection = {
     /**
      * Gets all agents in the collection
      */
-    listAgents(): Promisable<ReadonlyArray<string_agent_name>>;
+    listAgents(): Promisable<ReadonlyArray<AgentBasicInformation>>;
     /**
      * 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 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>;
+    spawnAgent(agentName: string_agent_name): Promisable<Agent>;
     /**
      * 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>;
+    createAgent(agentSource: string_book): Promisable<AgentBasicInformation>;
+    /**
+     * Deletes an agent from the collection
+     */
+    deleteAgent(agentName: string_agent_name): Promisable<void>;
 };
 /**
  * TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention

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

@@ -0,0 +1,55 @@
+import type { SupabaseClient } from '@supabase/supabase-js';
+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 { ExecutionTools } from '../../../../execution/ExecutionTools';
+import { Agent } from '../../../../llm-providers/agent/Agent';
+import type { PrepareAndScrapeOptions } from '../../../../prepare/PrepareAndScrapeOptions';
+import type { string_agent_name } from '../../../../types/typeAliases';
+import type { AgentCollection } from '../../AgentCollection';
+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 implements AgentCollection {
+    private readonly supabaseClient;
+    private readonly tools?;
+    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>, tools?: Pick<ExecutionTools, "llm" | "fs" | "scrapers"> | undefined, options?: (PrepareAndScrapeOptions & CommonToolsOptions) | undefined);
+    /**
+     * Cached defined execution tools
+     */
+    private _definedTools;
+    /**
+     * Gets all agents in the collection
+     */
+    listAgents(): Promise<ReadonlyArray<AgentBasicInformation>>;
+    /**
+     * !!!
+     */
+    spawnAgent(agentName: string_agent_name): Promise<Agent>;
+    /**
+     * 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: Write unit test
+ * TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention
+ */

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

@@ -0,0 +1,129 @@
+export type Json = string | number | boolean | null | {
+    [key: string]: Json | undefined;
+} | Json[];
+export type AgentsDatabaseSchema = {
+    graphql_public: {
+        Tables: {
+            [_ in never]: never;
+        };
+        Views: {
+            [_ in never]: never;
+        };
+        Functions: {
+            graphql: {
+                Args: {
+                    operationName?: string;
+                    query?: string;
+                    variables?: Json;
+                    extensions?: Json;
+                };
+                Returns: Json;
+            };
+        };
+        Enums: {
+            [_ in never]: never;
+        };
+        CompositeTypes: {
+            [_ in never]: never;
+        };
+    };
+    public: {
+        Tables: {
+            AgentCollection: {
+                Row: {
+                    id: number;
+                    agentName: string;
+                    agentProfile: Json;
+                    createdAt: string;
+                    updatedAt: string | null;
+                    agentVersion: number;
+                    promptbookEngineVersion: string;
+                    usage: Json | null;
+                    agentSource: string;
+                };
+                Insert: {
+                    id?: number;
+                    agentName: string;
+                    createdAt: string;
+                    updatedAt?: string | null;
+                    agentVersion: number;
+                    promptbookEngineVersion: string;
+                    usage?: Json | null;
+                    agentSource: string;
+                };
+                Update: {
+                    id?: number;
+                    agentName?: string;
+                    createdAt?: string;
+                    updatedAt?: string | null;
+                    agentVersion?: number;
+                    promptbookEngineVersion?: string;
+                    usage?: Json | null;
+                    agentSource?: string;
+                };
+                Relationships: [];
+            };
+        };
+        Views: {
+            [_ in never]: never;
+        };
+        Functions: {
+            [_ in never]: never;
+        };
+        Enums: {
+            [_ in never]: never;
+        };
+        CompositeTypes: {
+            [_ in never]: never;
+        };
+    };
+};
+type PublicSchema = AgentsDatabaseSchema[Extract<keyof AgentsDatabaseSchema, 'public'>];
+export type Tables<PublicTableNameOrOptions extends keyof (PublicSchema['Tables'] & PublicSchema['Views']) | {
+    schema: keyof AgentsDatabaseSchema;
+}, TableName extends PublicTableNameOrOptions extends {
+    schema: keyof AgentsDatabaseSchema;
+} ? keyof (AgentsDatabaseSchema[PublicTableNameOrOptions['schema']]['Tables'] & AgentsDatabaseSchema[PublicTableNameOrOptions['schema']]['Views']) : never = never> = PublicTableNameOrOptions extends {
+    schema: keyof AgentsDatabaseSchema;
+} ? (AgentsDatabaseSchema[PublicTableNameOrOptions['schema']]['Tables'] & AgentsDatabaseSchema[PublicTableNameOrOptions['schema']]['Views'])[TableName] extends {
+    Row: infer R;
+} ? R : never : PublicTableNameOrOptions extends keyof (PublicSchema['Tables'] & PublicSchema['Views']) ? (PublicSchema['Tables'] & PublicSchema['Views'])[PublicTableNameOrOptions] extends {
+    Row: infer R;
+} ? R : never : never;
+export type TablesInsert<PublicTableNameOrOptions extends keyof PublicSchema['Tables'] | {
+    schema: keyof AgentsDatabaseSchema;
+}, TableName extends PublicTableNameOrOptions extends {
+    schema: keyof AgentsDatabaseSchema;
+} ? keyof AgentsDatabaseSchema[PublicTableNameOrOptions['schema']]['Tables'] : never = never> = PublicTableNameOrOptions extends {
+    schema: keyof AgentsDatabaseSchema;
+} ? AgentsDatabaseSchema[PublicTableNameOrOptions['schema']]['Tables'][TableName] extends {
+    Insert: infer I;
+} ? I : never : PublicTableNameOrOptions extends keyof PublicSchema['Tables'] ? PublicSchema['Tables'][PublicTableNameOrOptions] extends {
+    Insert: infer I;
+} ? I : never : never;
+export type TablesUpdate<PublicTableNameOrOptions extends keyof PublicSchema['Tables'] | {
+    schema: keyof AgentsDatabaseSchema;
+}, TableName extends PublicTableNameOrOptions extends {
+    schema: keyof AgentsDatabaseSchema;
+} ? keyof AgentsDatabaseSchema[PublicTableNameOrOptions['schema']]['Tables'] : never = never> = PublicTableNameOrOptions extends {
+    schema: keyof AgentsDatabaseSchema;
+} ? AgentsDatabaseSchema[PublicTableNameOrOptions['schema']]['Tables'][TableName] extends {
+    Update: infer U;
+} ? U : never : PublicTableNameOrOptions extends keyof PublicSchema['Tables'] ? PublicSchema['Tables'][PublicTableNameOrOptions] extends {
+    Update: infer U;
+} ? U : never : never;
+export type Enums<PublicEnumNameOrOptions extends keyof PublicSchema['Enums'] | {
+    schema: keyof AgentsDatabaseSchema;
+}, EnumName extends PublicEnumNameOrOptions extends {
+    schema: keyof AgentsDatabaseSchema;
+} ? keyof AgentsDatabaseSchema[PublicEnumNameOrOptions['schema']]['Enums'] : never = never> = PublicEnumNameOrOptions extends {
+    schema: keyof AgentsDatabaseSchema;
+} ? AgentsDatabaseSchema[PublicEnumNameOrOptions['schema']]['Enums'][EnumName] : PublicEnumNameOrOptions extends keyof PublicSchema['Enums'] ? PublicSchema['Enums'][PublicEnumNameOrOptions] : never;
+export type CompositeTypes<PublicCompositeTypeNameOrOptions extends keyof PublicSchema['CompositeTypes'] | {
+    schema: keyof AgentsDatabaseSchema;
+}, CompositeTypeName extends PublicCompositeTypeNameOrOptions extends {
+    schema: keyof AgentsDatabaseSchema;
+} ? keyof AgentsDatabaseSchema[PublicCompositeTypeNameOrOptions['schema']]['CompositeTypes'] : never = never> = PublicCompositeTypeNameOrOptions extends {
+    schema: keyof AgentsDatabaseSchema;
+} ? AgentsDatabaseSchema[PublicCompositeTypeNameOrOptions['schema']]['CompositeTypes'][CompositeTypeName] : PublicCompositeTypeNameOrOptions extends keyof PublicSchema['CompositeTypes'] ? PublicSchema['CompositeTypes'][PublicCompositeTypeNameOrOptions] : never;
+export {};

package/esm/typings/src/commands/_common/types/CommandParser.d.ts

@@ -3,7 +3,7 @@ import type { PipelineJson } from '../../../pipeline/PipelineJson/PipelineJson';
 import type { TaskJson } from '../../../pipeline/PipelineJson/TaskJson';
 import type { string_markdown_text, string_name, string_promptbook_documentation_url } from '../../../types/typeAliases';
 import type { string_SCREAMING_CASE } from '../../../utils/normalization/normalizeTo_SCREAMING_CASE';
-import { $side_effect } from '../../../utils/organization/$side_effect';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
 import type { ___and___ } from '../../../utils/organization/___and___';
 import type { CommandUsagePlace } from './CommandUsagePlaces';
 /**

package/esm/typings/src/config.d.ts

@@ -1,7 +1,7 @@
-import { Color } from './_packages/color.index';
 import type { CsvSettings } from './formats/csv/CsvSettings';
 import type { IntermediateFilesStrategy } from './types/IntermediateFilesStrategy';
 import type { string_app_id, string_email, string_name, string_promptbook_server_url } from './types/typeAliases';
+import { Color } from './utils/color/Color';
 /**
  * Warning message for the generated sections and files files
  *

package/esm/typings/src/errors/0-index.d.ts

@@ -2,6 +2,7 @@ import { CsvFormatError } from '../formats/csv/CsvFormatError';
 import { AbstractFormatError } from './AbstractFormatError';
 import { AuthenticationError } from './AuthenticationError';
 import { CollectionError } from './CollectionError';
+import { DatabaseError } from './DatabaseError';
 import { EnvironmentMismatchError } from './EnvironmentMismatchError';
 import { ExpectError } from './ExpectError';
 import { KnowledgeScrapeError } from './KnowledgeScrapeError';
@@ -42,6 +43,7 @@ export declare const PROMPTBOOK_ERRORS: {
     readonly UnexpectedError: typeof UnexpectedError;
     readonly WrappedError: typeof WrappedError;
     readonly NotAllowed: typeof NotAllowed;
+    readonly DatabaseError: typeof DatabaseError;
 };
 /**
  * Index of all javascript errors
@@ -91,6 +93,7 @@ export declare const ALL_ERRORS: {
     readonly UnexpectedError: typeof UnexpectedError;
     readonly WrappedError: typeof WrappedError;
     readonly NotAllowed: typeof NotAllowed;
+    readonly DatabaseError: typeof DatabaseError;
 };
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/errors/DatabaseError.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This error indicates error from the database
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class DatabaseError extends Error {
+    readonly name = "DatabaseError";
+    constructor(message: string);
+}

package/esm/typings/src/execution/createPipelineExecutor/40-executeAttempts.d.ts

@@ -1,9 +1,9 @@
 import type { PartialDeep, Promisable, ReadonlyDeep, WritableDeep } from 'type-fest';
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
+import type { LlmCall } from '../../types/LlmCall';
 import type { Parameters, string_parameter_name } from '../../types/typeAliases';
 import type { TODO_string } from '../../utils/organization/TODO_string';
-import type { LlmCall } from '../../types/LlmCall';
 import type { ExecutionReportJson } from '../execution-report/ExecutionReportJson';
 import type { PipelineExecutorResult } from '../PipelineExecutorResult';
 import type { CreatePipelineExecutorOptions } from './00-CreatePipelineExecutorOptions';

package/esm/typings/src/high-level-abstractions/_common/HighLevelAbstraction.d.ts

@@ -1,5 +1,5 @@
 import type { $PipelineJson } from '../../commands/_common/types/CommandParser';
-import { $side_effect } from '../../utils/organization/$side_effect';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Used in `parsePipeline`
  *

package/esm/typings/src/llm-providers/_common/register/$registeredLlmToolsMessage.d.ts

@@ -1,5 +1,5 @@
 import type { string_filename, string_markdown } from '../../../types/typeAliases';
-import { $side_effect } from '../../../utils/organization/$side_effect';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
 /**
  * Pass the `.env` file which was used to configure LLM tools
  *

package/esm/typings/src/llm-providers/_common/register/LlmToolsMetadata.d.ts

@@ -26,7 +26,7 @@ export type LlmToolsMetadata = Registered & {
     /**
      * How is the model provider important and should be sorted in the list of available providers?
      */
-    readonly order: typeof MODEL_ORDERS[keyof typeof MODEL_ORDERS] | number;
+    readonly order: (typeof MODEL_ORDERS)[keyof typeof MODEL_ORDERS] | number;
     /**
      * List of environment variables that can be used to configure the provider
      *

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

@@ -1,6 +1,9 @@
 import { BehaviorSubject } from 'rxjs';
-import { AgentBasicInformation, BookParameter, LlmExecutionTools, string_agent_name, string_book, string_url_image } from '../../_packages/types.index';
-import { AgentOptions } from './AgentOptions';
+import type { AgentBasicInformation, BookParameter } from '../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { string_agent_name, string_url_image } from '../../types/typeAliases';
+import type { AgentOptions } from './AgentOptions';
 /**
  * Represents one AI Agent
  *

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

@@ -5,7 +5,7 @@ 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_model_name, string_title } from '../../types/typeAliases';
-import { CreateAgentLlmExecutionToolsOptions } from './CreateAgentLlmExecutionToolsOptions';
+import type { CreateAgentLlmExecutionToolsOptions } from './CreateAgentLlmExecutionToolsOptions';
 /**
  * Execution Tools for calling LLM models with a predefined agent "soul"
  * This wraps underlying LLM execution tools and applies agent-specific system prompts and requirements

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

@@ -1,5 +1,7 @@
-import { CommonToolsOptions, ExecutionTools, string_book } from '../../_packages/types.index';
-import { Updatable } from '../../types/Updatable';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { Updatable } from '../../types/Updatable';
 /**
  * Options for creating an Agent
  */

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

@@ -1,6 +1,6 @@
-import type { string_book } from '../../_packages/types.index';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
-import type { OpenAiAssistantExecutionTools } from '../openai/OpenAiAssistantExecutionTools';
+import { OpenAiAssistantExecutionTools } from '../openai/OpenAiAssistantExecutionTools';
 /**
  * Options for creating AgentLlmExecutionTools
  */

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

@@ -1,5 +1,5 @@
 import { AgentLlmExecutionTools } from './AgentLlmExecutionTools';
-import { CreateAgentLlmExecutionToolsOptions } from './CreateAgentLlmExecutionToolsOptions';
+import type { CreateAgentLlmExecutionToolsOptions } from './CreateAgentLlmExecutionToolsOptions';
 /**
  * Creates new AgentLlmExecutionTools that wrap underlying LLM tools with agent-specific behavior
  *

package/esm/typings/src/prepare/PrepareAndScrapeOptions.d.ts

@@ -47,5 +47,6 @@ export type PrepareAndScrapeOptions = {
     readonly isVerbose?: boolean;
 };
 /**
+ * TODO: [🧠] Maybe extend from `CommonToolsOptions`
  * TODO: [🧠] Maybe split `PrepareAndScrapeOptions` and `ScrapeOptions` (`ScrapeOptions` should be extended from `PrepareAndScrapeOptions`)
  */

package/esm/typings/src/remote-server/startAgentServer.d.ts

@@ -1,5 +1,5 @@
-import { TODO_any } from '../_packages/types.index';
-import { number_port } from '../types/typeAliases';
+import type { number_port } from '../types/typeAliases';
+import type { TODO_any } from '../utils/organization/TODO_any';
 type AgentsServerOptions = {
     /**
      * !!!

package/esm/typings/src/remote-server/types/RemoteServerOptions.d.ts

@@ -1,6 +1,5 @@
 import type { Request, Response } from 'express';
 import type { Promisable } from 'type-fest';
-import { really_any } from '../../_packages/types.index';
 import type { PipelineCollection } from '../../collection/pipeline-collection/PipelineCollection';
 import { AuthenticationError } from '../../errors/AuthenticationError';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
@@ -27,24 +26,6 @@ export type RemoteServerOptions<TCustomOptions> = CommonToolsOptions & {
      * @property {number} port The port number the server will listen on.
      */
     readonly port: number;
-    /**
-     * CORS options to apply to all endpoints (REST, UI, socket.io, etc.).
-     * Accepts the same options as the `cors` npm package and socket.io's CORS config.
-     * If not provided, defaults to permissive CORS (origin: '*').
-     * @see https://www.npmjs.com/package/cors
-     * @see https://socket.io/docs/v4/server-options/#cors
-     */
-    readonly cors?: {
-        origin?: string | string[] | boolean;
-        methods?: string | string[];
-        allowedHeaders?: string | string[];
-        exposedHeaders?: string | string[];
-        credentials?: boolean;
-        maxAge?: number;
-        preflightContinue?: boolean;
-        optionsSuccessStatus?: number;
-        [key: string]: really_any;
-    };
     /**
      * Enable rich UI (React + Tailwind) at `/` path.
      * Default: true

package/esm/typings/src/storage/env-storage/$EnvStorage.d.ts

@@ -1,5 +1,5 @@
+import type { $side_effect } from '../../utils/organization/$side_effect';
 import type { PromptbookStorage } from '../_common/PromptbookStorage';
-import { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Stores data in .env variables
  *

package/esm/typings/src/transpilers/_common/BookTranspiler.d.ts

@@ -1,5 +1,9 @@
 import { Promisable } from 'type-fest';
-import { BookTranspilerOptions, ExecutionTools, Registered, string_book, string_name, string_script, string_title } from '../../_packages/types.index';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { string_name, string_script, string_title } from '../../types/typeAliases';
+import type { Registered } from '../../utils/misc/$Register';
+import type { BookTranspilerOptions } from './BookTranspilerOptions';
 /**
  * Transpiler takes a book and transpiles it into another format (e.g., Langchain).
  */

package/esm/typings/src/transpilers/_common/BookTranspilerOptions.d.ts

@@ -1,4 +1,4 @@
-import { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 /**
  * Options for the BookTranspiler.
  */

package/esm/typings/src/transpilers/_common/register/$bookTranspilersRegister.d.ts

@@ -1,5 +1,5 @@
 import { $Register } from '../../../utils/misc/$Register';
-import { BookTranspiler } from '../BookTranspiler';
+import type { BookTranspiler } from '../BookTranspiler';
 /**
  * Register for book transpilers.
  *

package/esm/typings/src/transpilers/formatted-book-in-markdown/FormattedBookInMarkdownTranspiler.d.ts

@@ -1,4 +1,7 @@
-import { BookTranspilerOptions, ExecutionTools, string_book, string_markdown } from '../../_packages/types.index';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { string_markdown } from '../../types/typeAliases';
+import type { BookTranspilerOptions } from '../_common/BookTranspilerOptions';
 /**
  * Converts a book into a 1:1 formatted markdown
  *

package/esm/typings/src/transpilers/formatted-book-in-markdown/register.d.ts

@@ -1,4 +1,4 @@
-import { Registration } from '../../_packages/types.index';
+import type { Registration } from '../../utils/misc/$Register';
 /**
  * Registration of transpiler
  *

package/esm/typings/src/transpilers/openai-sdk/OpenAiSdkTranspiler.d.ts

@@ -1,4 +1,7 @@
-import { BookTranspilerOptions, ExecutionTools, string_book, string_script } from '../../_packages/types.index';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { string_script } from '../../types/typeAliases';
+import type { BookTranspilerOptions } from '../_common/BookTranspilerOptions';
 /**
  * Transpiler to Javascript code using OpenAI SDK.
  *

package/esm/typings/src/transpilers/openai-sdk/register.d.ts

@@ -1,4 +1,4 @@
-import { Registration } from '../../_packages/types.index';
+import type { Registration } from '../../utils/misc/$Register';
 /**
  * Registration of transpiler
  *

package/esm/typings/src/utils/color/operators/darken.d.ts

@@ -1,4 +1,4 @@
-import { number_percent } from '../../../types/typeAliases';
+import type { number_percent } from '../../../types/typeAliases';
 import type { ColorTransformer } from './ColorTransformer';
 /**
  * Makes color transformer which darker the given color

package/esm/typings/src/utils/color/operators/grayscale.d.ts

@@ -1,4 +1,4 @@
-import { number_percent } from '../../../types/typeAliases';
+import type { number_percent } from '../../../types/typeAliases';
 import type { ColorTransformer } from './ColorTransformer';
 /**
  * Makes color transformer which returns a grayscale version of the color

package/esm/typings/src/utils/color/operators/lighten.d.ts

@@ -1,5 +1,5 @@
+import type { number_percent } from '../../../types/typeAliases';
 import type { ColorTransformer } from './ColorTransformer';
-import { number_percent } from '../../../types/typeAliases';
 /**
  * Makes color transformer which lighten the given color
  *

package/esm/typings/src/utils/color/operators/mixWithColor.d.ts

@@ -1,6 +1,6 @@
+import type { number_percent } from '../../../types/typeAliases';
 import { Color } from '../Color';
 import type { ColorTransformer } from './ColorTransformer';
-import { number_percent } from '../../../types/typeAliases';
 /**
  * Makes color transformer which returns a mix of two colors based on a ratio
  *

package/esm/typings/src/utils/color/operators/saturate.d.ts

@@ -1,4 +1,4 @@
-import { number_percent } from '../../../types/typeAliases';
+import type { number_percent } from '../../../types/typeAliases';
 import type { ColorTransformer } from './ColorTransformer';
 /**
  * Makes color transformer which saturate the given color

package/esm/typings/src/utils/environment/$detectRuntimeEnvironment.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns information about the current runtime environment
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environments
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function $detectRuntimeEnvironment(): {
+    isRunningInBrowser: any;
+    isRunningInJest: any;
+    isRunningInNode: any;
+    isRunningInWebWorker: any;
+};
+/**
+ * TODO: [🎺] Also detect and report node version here
+ */

package/esm/typings/src/utils/execCommand/$execCommand.d.ts

@@ -1,4 +1,4 @@
-import { $side_effect } from '../organization/$side_effect';
+import type { $side_effect } from '../organization/$side_effect';
 import type { ExecCommandOptions } from './ExecCommandOptions';
 /**
  * Run one command in a shell

package/esm/typings/src/utils/execCommand/$execCommands.d.ts

@@ -1,4 +1,4 @@
-import { $side_effect } from '../organization/$side_effect';
+import type { $side_effect } from '../organization/$side_effect';
 /**
  * Run multiple commands in a shell in sequence
  *

package/esm/typings/src/utils/files/$induceBookDownload.d.ts

@@ -1,5 +1,5 @@
-import { string_book } from '../../_packages/types.index';
-import { $side_effect } from '../organization/$side_effect';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { $side_effect } from '../organization/$side_effect';
 /**
  * Download a Book in a browser
  *

package/esm/typings/src/utils/files/$induceFileDownload.d.ts

@@ -1,5 +1,5 @@
-import { string_url } from '../../types/typeAliases';
-import { $side_effect } from '../organization/$side_effect';
+import type { string_url } from '../../types/typeAliases';
+import type { $side_effect } from '../organization/$side_effect';
 /**
  * Download a File in a browser
  *

package/esm/typings/src/utils/files/ObjectUrl.d.ts

@@ -1,5 +1,5 @@
 import { IDestroyable, Registration } from 'destroyable';
-import { string_mime_type, string_url } from '../../types/typeAliases';
+import type { string_mime_type, string_url } from '../../types/typeAliases';
 /**
  * Converts Blob, File or MediaSource to url using URL.createObjectURL
  *

package/esm/typings/src/utils/misc/aboutPromptbookInformation.d.ts

@@ -6,6 +6,12 @@ export type AboutPromptbookInformationOptions = {
      * @default true
      */
     isServersInfoIncluded?: boolean;
+    /**
+     * Include information about runtime environment
+     *
+     * @default true
+     */
+    isRuntimeEnvironmentInfoIncluded?: boolean;
 };
 /**
  * Provide information about Promptbook, engine version, book language version, servers, ...

package/esm/typings/src/utils/organization/$side_effect.d.ts

@@ -1,4 +1,4 @@
-import { really_any } from './really_any';
+import type { really_any } from './really_any';
 /**
  * Organizational helper to mark a function that produces side effects
  *

package/esm/typings/src/utils/random/$generateBookBoilerplate.d.ts

@@ -0,0 +1,22 @@
+import type { PartialDeep } from 'type-fest';
+import type { AgentBasicInformation } from '../../book-2.0/agent-source/AgentBasicInformation';
+import { string_book } from '../../book-2.0/agent-source/string_book';
+import { string_agent_name } from '../../types/typeAliases';
+type GenerateBookBoilerplateOptions = PartialDeep<Omit<AgentBasicInformation, 'parameters'>> & {
+    /**
+     * Name of the parent agent to inherit from
+     *
+     * @default 'Adam'
+     */
+    parentAgentName?: string_agent_name;
+};
+/**
+ * Generates boilerplate for a new agent book
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic
+ * Note: This function is using cryptographically secure components internally
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function $generateBookBoilerplate(options?: GenerateBookBoilerplateOptions): string_book;
+export {};

package/esm/typings/src/utils/random/$randomToken.d.ts

@@ -2,6 +2,7 @@ import type { string_token } from '../../types/typeAliases';
 /**
  * Generates random token
  *
+ * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic
  * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)
  *
  * @private internal helper function

package/esm/typings/src/utils/serialization/$deepFreeze.d.ts

@@ -1,5 +1,5 @@
 import type { ReadonlyDeep } from 'type-fest';
-import { $side_effect } from '../organization/$side_effect';
+import type { $side_effect } from '../organization/$side_effect';
 /**
  * Freezes the given object and all its nested objects recursively
  *

package/esm/typings/src/utils/serialization/serializeToPromptbookJavascript.d.ts

@@ -1,5 +1,5 @@
-import { string_javascript } from '../../types/typeAliases';
-import { TODO_any } from '../organization/TODO_any';
+import type { string_javascript } from '../../types/typeAliases';
+import type { TODO_any } from '../organization/TODO_any';
 type SerializeToPromptbookJavascriptReturn = {
     /**
      * Array of import statements required for the `value` to work

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.103.0-41`).
+ * It follows semantic versioning (e.g., `0.103.0-42`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/types",
-    "version": "0.103.0-42",
+    "version": "0.103.0-43",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -92,6 +92,6 @@
     },
     "typings": "./esm/typings/src/_packages/types.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.103.0-42"
+        "@promptbook/core": "0.103.0-43"
     }
 }

package/esm/typings/src/collection/agent-collection/constructors/AgentCollectionInDirectory.d.ts

@@ -1,89 +0,0 @@
-import { Agent } from '../../../_packages/core.index';
-import { CommonToolsOptions, string_book } from '../../../_packages/types.index';
-import type { ExecutionTools } from '../../../execution/ExecutionTools';
-import type { PrepareAndScrapeOptions } from '../../../prepare/PrepareAndScrapeOptions';
-import type { string_agent_name, string_dirname } from '../../../types/typeAliases';
-import type { AgentCollection } from '../AgentCollection';
-/**
- * Options for `createAgentCollectionFromDirectory` function
- *
- * Note: `rootDirname` is not needed because it is the folder in which `.book` or `.book` file is located
- *       This is not same as `path` which is the first argument of `createAgentCollectionFromDirectory` - it can be a subfolder
- */
-type CreateAgentCollectionInDirectoryOptions = Omit<PrepareAndScrapeOptions, 'rootDirname'> & CommonToolsOptions & {
-    /**
-     * If true, the directory is searched recursively for pipelines
-     *
-     * @default true
-     */
-    isRecursive?: boolean;
-    /**
-     * If true, directory will be scanned only when needed not during the construction
-     *
-     * @default false
-     */
-    isLazyLoaded?: boolean;
-    /**
-     * If true, whole collection creation crashes on error in any pipeline
-     * If true and isLazyLoaded is true, the error is thrown on first access to the pipeline
-     *
-     * @default true
-     */
-    isCrashedOnError?: boolean;
-};
-/**
- * Agent collection stored in directory
- *
- * Note: Works only in Node.js environment because it reads the file system
- *
- * @public exported from `@promptbook/node`
- */
-export declare class AgentCollectionInDirectory implements AgentCollection {
-    readonly rootPath: string_dirname;
-    private readonly tools?;
-    readonly options?: CreateAgentCollectionInDirectoryOptions | 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(rootPath: string_dirname, tools?: Pick<ExecutionTools, "llm" | "fs" | "scrapers"> | undefined, options?: CreateAgentCollectionInDirectoryOptions | undefined);
-    /**
-     * Cached defined execution tools
-     */
-    private _definedTools;
-    /**
-     * Gets or creates execution tools for the collection
-     */
-    private getTools;
-    /**
-     * Gets all agents in the collection
-     */
-    listAgents(): Promise<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): Promise<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): Promise<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): Promise<Agent>;
-}
-export {};
-/**
- * TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention
- * TODO: [🖇] What about symlinks? Maybe option `isSymlinksFollowed`
- * TODO: [🧠] Maybe add option `isImmutable`
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */

package/esm/typings/src/collection/agent-collection/constructors/AgentCollectionInDirectory.test.d.ts

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

package/esm/typings/src/execution/utils/logLlmCall.d.ts

@@ -1,8 +0,0 @@
-import type { LlmCall } from '../../types/LlmCall';
-import type { ExecutionPromptReportJson } from '../execution-report/ExecutionPromptReportJson';
-/**
- * Logs an LLM call with the given report.
- *
- * @private internal utility of `createPipelineExecutor`
- */
-export declare function logLlmCall(logLlmCall: (llmCall: LlmCall) => void, report: ExecutionPromptReportJson): void;