@promptbook/vercel 0.103.0-42 → 0.103.0-43

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