@promptbook/openai 0.103.0-42 → 0.103.0-44

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
+ */

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,12 @@
+/**
+ * This error indicates error from the database
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class DatabaseError extends Error {
+    readonly name = "DatabaseError";
+    constructor(message: string);
+}
+/**
+ * TODO: !!!! Explain that NotFoundError (!!! and other specific errors) has priority over DatabaseError in some contexts
+ */