@promptbook/ollama 0.104.0-8 → 0.104.0

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

@@ -29,6 +29,7 @@ import type { GroupedCommitmentDefinition } from '../commitments/index';
 import { getGroupedCommitmentDefinitions } from '../commitments/index';
 import { NAME } from '../config';
 import { ADMIN_EMAIL } from '../config';
+import { PROMPTBOOK_LEGAL_ENTITY } from '../config';
 import { ADMIN_GITHUB_NAME } from '../config';
 import { CLAIM } from '../config';
 import { PROMPTBOOK_COLOR } from '../config';
@@ -191,9 +192,9 @@ import { SectionTypes } from '../types/SectionType';
 import { TaskTypes } from '../types/TaskType';
 import { aboutPromptbookInformation } from '../utils/misc/aboutPromptbookInformation';
 import { $generateBookBoilerplate } from '../utils/random/$generateBookBoilerplate';
-import { CORE_SERVER } from '../../servers';
-import { REMOTE_SERVER_URLS } from '../../servers';
-import { AUTO_FEDERATED_AGENT_SERVER_URLS } from '../../servers';
+import { CORE_AGENTS_SERVER } from '../../servers';
+import { CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES } from '../../servers';
+import { PUBLIC_AGENTS_SERVERS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { computeAgentHash };
 export { createAgentModelRequirements };
@@ -225,6 +226,7 @@ export type { GroupedCommitmentDefinition };
 export { getGroupedCommitmentDefinitions };
 export { NAME };
 export { ADMIN_EMAIL };
+export { PROMPTBOOK_LEGAL_ENTITY };
 export { ADMIN_GITHUB_NAME };
 export { CLAIM };
 export { PROMPTBOOK_COLOR };
@@ -387,6 +389,6 @@ export { SectionTypes };
 export { TaskTypes };
 export { aboutPromptbookInformation };
 export { $generateBookBoilerplate };
-export { CORE_SERVER };
-export { REMOTE_SERVER_URLS };
-export { AUTO_FEDERATED_AGENT_SERVER_URLS };
+export { CORE_AGENTS_SERVER };
+export { CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES };
+export { PUBLIC_AGENTS_SERVERS };

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

@@ -1,4 +1,5 @@
 import type { BookParameter } from '../book-2.0/agent-source/AgentBasicInformation';
+import type { AgentCapability } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentBasicInformation } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentModelRequirements } from '../book-2.0/agent-source/AgentModelRequirements';
 import type { string_book } from '../book-2.0/agent-source/string_book';
@@ -178,6 +179,8 @@ import type { ScraperSourceHandler } from '../scrapers/_common/Scraper';
 import type { ScraperIntermediateSource } from '../scrapers/_common/ScraperIntermediateSource';
 import type { JavascriptExecutionToolsOptions } from '../scripting/javascript/JavascriptExecutionToolsOptions';
 import type { PostprocessingFunction } from '../scripting/javascript/JavascriptExecutionToolsOptions';
+import type { SearchEngine } from '../search-engines/SearchEngine';
+import type { SearchResult } from '../search-engines/SearchResult';
 import type { PromptbookStorage } from '../storage/_common/PromptbookStorage';
 import type { FileCacheStorageOptions } from '../storage/file-cache-storage/FileCacheStorageOptions';
 import type { IndexedDbStorageOptions } from '../storage/local-storage/utils/IndexedDbStorageOptions';
@@ -185,6 +188,7 @@ import type { BookTranspiler } from '../transpilers/_common/BookTranspiler';
 import type { BookTranspilerOptions } from '../transpilers/_common/BookTranspilerOptions';
 import type { IntermediateFilesStrategy } from '../types/IntermediateFilesStrategy';
 import type { LlmCall } from '../types/LlmCall';
+import type { LlmToolDefinition } from '../types/LlmToolDefinition';
 import type { Message } from '../types/Message';
 import type { ModelRequirements } from '../types/ModelRequirements';
 import type { CompletionModelRequirements } from '../types/ModelRequirements';
@@ -367,6 +371,7 @@ import type { ExportJsonOptions } from '../utils/serialization/exportJson';
 import type { ITakeChain } from '../utils/take/interfaces/ITakeChain';
 import type { string_promptbook_version } from '../version';
 export type { BookParameter };
+export type { AgentCapability };
 export type { AgentBasicInformation };
 export type { AgentModelRequirements };
 export type { string_book };
@@ -546,6 +551,8 @@ export type { ScraperSourceHandler };
 export type { ScraperIntermediateSource };
 export type { JavascriptExecutionToolsOptions };
 export type { PostprocessingFunction };
+export type { SearchEngine };
+export type { SearchResult };
 export type { PromptbookStorage };
 export type { FileCacheStorageOptions };
 export type { IndexedDbStorageOptions };
@@ -553,6 +560,7 @@ export type { BookTranspiler };
 export type { BookTranspilerOptions };
 export type { IntermediateFilesStrategy };
 export type { LlmCall };
+export type { LlmToolDefinition };
 export type { Message };
 export type { ModelRequirements };
 export type { CompletionModelRequirements };

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

@@ -83,6 +83,7 @@ import { isValidPromptbookVersion } from '../utils/validators/semanticVersion/is
 import { isValidSemanticVersion } from '../utils/validators/semanticVersion/isValidSemanticVersion';
 import { isHostnameOnPrivateNetwork } from '../utils/validators/url/isHostnameOnPrivateNetwork';
 import { isUrlOnPrivateNetwork } from '../utils/validators/url/isUrlOnPrivateNetwork';
+import { isValidAgentUrl } from '../utils/validators/url/isValidAgentUrl';
 import { isValidPipelineUrl } from '../utils/validators/url/isValidPipelineUrl';
 import { isValidUrl } from '../utils/validators/url/isValidUrl';
 import { isValidUuid } from '../utils/validators/uuid/isValidUuid';
@@ -171,6 +172,7 @@ export { isValidPromptbookVersion };
 export { isValidSemanticVersion };
 export { isHostnameOnPrivateNetwork };
 export { isUrlOnPrivateNetwork };
+export { isValidAgentUrl };
 export { isValidPipelineUrl };
 export { isValidUrl };
 export { isValidUuid };

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

@@ -23,6 +23,24 @@ export type BookParameter = {
      */
     description?: string;
 };
+/**
+ * Capability of the agent
+ * This is parsed from commitments like USE BROWSER, USE SEARCH ENGINE, KNOWLEDGE, etc.
+ */
+export type AgentCapability = {
+    /**
+     * The type of the capability
+     */
+    type: 'browser' | 'search-engine' | 'knowledge';
+    /**
+     * The label to display for this capability
+     */
+    label: string;
+    /**
+     * The name of the icon to display for this capability
+     */
+    iconName: string;
+};
 export type AgentBasicInformation = {
     /**
      * Name of the agent
@@ -55,6 +73,7 @@ export type AgentBasicInformation = {
      */
     meta: {
         fullname?: string;
+        description?: string;
         image?: string_url_image;
         font?: string_fonts;
         color?: string_color;
@@ -72,6 +91,11 @@ export type AgentBasicInformation = {
      * - {parameterName} or {parameter with multiple words} or {parameterName: description text}
      */
     parameters: BookParameter[];
+    /**
+     * Capabilities of the agent
+     * This is parsed from commitments like USE BROWSER, USE SEARCH ENGINE, KNOWLEDGE, etc.
+     */
+    capabilities: AgentCapability[];
 };
 /**
  * TODO: [🐱‍🚀] Make all properties of `AgentBasicInformation` readonly

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

@@ -1,4 +1,5 @@
-import type { string_knowledge_source_link } from '../../types/typeAliases';
+import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
+import type { string_agent_url, string_knowledge_source_link } from '../../types/typeAliases';
 import type { TODO_any } from '../../utils/organization/TODO_any';
 /**
  * Model requirements for an agent
@@ -20,8 +21,13 @@ export type AgentModelRequirements = {
     readonly mcpServers?: ReadonlyArray<string>;
     /**
      * Optional link to the parent agent from which this agent inherits
+     *
+     * Note: [🆓] There are several cases what the agent ancestor could be:
+     * -  1) `parentAgentUrl` is `string_agent_url` valid agent URL
+     * -  2) `parentAgentUrl` is explicitly `null` (forcefully no parent)
+     * -  3) `parentAgentUrl` is not defined `undefined`,  the default ancestor agent, Adam,  will be used
      */
-    readonly parentAgentUrl?: string_knowledge_source_link;
+    readonly parentAgentUrl?: string_agent_url | null;
     /**
      * Optional list of knowledge source links that the agent can use
      */
@@ -45,6 +51,10 @@ export type AgentModelRequirements = {
      * Top-k sampling value for the agent's responses
      */
     readonly topK?: number;
+    /**
+     * Tools available for the agent
+     */
+    readonly tools?: ReadonlyArray<LlmToolDefinition>;
     /**
      * Arbitrary metadata storage for commitments
      * Each commitment can store its own data here

package/esm/typings/src/book-2.0/agent-source/createAgentModelRequirements.tools.test.d.ts

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

package/esm/typings/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.closed.test.d.ts

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

package/esm/typings/src/book-2.0/utils/generatePlaceholderAgentProfileImageUrl.d.ts

@@ -7,7 +7,7 @@ import type { string_agent_name, string_agent_permanent_id, string_url, string_u
  *
  * @public exported from `@promptbook/core`
  */
-export declare function generatePlaceholderAgentProfileImageUrl(agentIdOrName: string_agent_permanent_id | string_agent_name, agentsServerUrl?: URL | string_url): string_url_image;
+export declare function generatePlaceholderAgentProfileImageUrl(agentIdOrName: string_agent_permanent_id | string_agent_name, agentsServerUrl: URL | string_url): string_url_image;
 /**
  * TODO: [🤹] Figure out best placeholder image generator https://i.pravatar.cc/1000?u=568
  */

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

@@ -3,4 +3,4 @@ import { CHAT_SAVE_FORMATS } from '../index';
  * Supported chat export formatNames
  * @public exported from `@promptbook/components`
  */
-export type string_chat_format_name = typeof CHAT_SAVE_FORMATS[number]['formatName'];
+export type string_chat_format_name = (typeof CHAT_SAVE_FORMATS)[number]['formatName'];

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

@@ -1,7 +1,10 @@
 import { Message } from '../../../types/Message';
 import type { id, string_markdown } from '../../../types/typeAliases';
 /**
- * A message in the chat
+ * Represents a single message within a chat interface.
+ *
+ * This type extends the base `Message` type by omitting internal routing fields
+ * and adding chat-specific properties like markdown content and generation status.
  *
  * @public exported from `@promptbook/components`
  */
@@ -23,11 +26,11 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
      */
     isComplete?: boolean;
     /**
-     * @@@
+     * The expected answer for the message (used for testing or validation)
      */
     expectedAnswer?: string;
     /**
-     * @@@
+     * Indicates if the message was sent via a voice call
      */
     isVoiceCall?: boolean;
 };

package/esm/typings/src/book-components/_common/Dropdown/Dropdown.d.ts

@@ -7,8 +7,12 @@ type DropdownProps = {
     }>;
 };
 /**
- * @@@
+ * A dropdown menu component that displays a list of actions.
  *
+ * The menu is toggled by a hamburger menu button. When an action is selected,
+ * the menu automatically closes.
+ *
+ * @param props - Contains an array of actions with icons, names, and click handlers
  * @private internal subcomponent used by various components
  */
 export declare function Dropdown({ actions }: DropdownProps): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/_common/HamburgerMenu/HamburgerMenu.d.ts

@@ -4,8 +4,12 @@ type HamburgerMenuProps = {
     className?: string;
 };
 /**
- * @@@
+ * An animated hamburger menu button component.
  *
+ * This component renders a 3-bar hamburger icon that animates into an "X" when
+ * the menu is open.
+ *
+ * @param props - Contains the open state, an optional click handler, and optional className
  * @private Internal component
  */
 export declare function HamburgerMenu({ isOpen, onClick, className }: HamburgerMenuProps): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/AboutIcon.d.ts

@@ -1,7 +1,11 @@
 import { SVGProps } from 'react';
 /**
- * @@@
+ * Renders an information/about icon.
  *
+ * This icon is typically used in UI elements that provide additional information
+ * or "about" details to the user.
+ *
+ * @param props - SVG properties augmented with an optional `size`
  * @private internal subcomponent used by various components
  */
 export declare function AboutIcon(props: SVGProps<SVGSVGElement> & {

package/esm/typings/src/book-components/icons/AttachmentIcon.d.ts

@@ -3,9 +3,13 @@ type AttachmentIconProps = {
     color?: string;
 };
 /**
- * @@@
+ * Renders an attachment icon.
  *
- * @public exported from `@promptbook/components`
+ * This icon is typically used in chat interfaces to indicate the ability to
+ * upload or view files associated with a message.
+ *
+ * @param props - SVG properties augmented with an optional `size`
+ * @private internal subcomponent used by various components
  */
 export declare function AttachmentIcon({ size, color }: AttachmentIconProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/esm/typings/src/book-components/icons/CameraIcon.d.ts

@@ -3,9 +3,13 @@ type CameraIconProps = {
     color?: string;
 };
 /**
- * @@@
+ * Renders a camera icon.
  *
- * @public exported from `@promptbook/components`
+ * This icon is typically used in buttons or inputs that trigger image capture
+ * or selection.
+ *
+ * @param props - SVG properties augmented with an optional `size`
+ * @private internal subcomponent used by various components
  */
 export declare function CameraIcon({ size, color }: CameraIconProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/esm/typings/src/book-components/icons/DownloadIcon.d.ts

@@ -1,7 +1,11 @@
 import { SVGProps } from 'react';
 /**
- * @@@
+ * Renders a download icon.
  *
+ * This icon is typically used in buttons or links that trigger the downloading
+ * of files or assets.
+ *
+ * @param props - SVG properties augmented with an optional `size`
  * @private internal subcomponent used by various components
  */
 export declare function DownloadIcon(props: SVGProps<SVGSVGElement> & {

package/esm/typings/src/book-components/icons/MenuIcon.d.ts

@@ -1,7 +1,11 @@
 import { SVGProps } from 'react';
 /**
- * @@@
+ * Renders a menu icon.
  *
+ * This icon is typically used in buttons that toggle the visibility of
+ * navigation menus or dropdowns.
+ *
+ * @param props - SVG properties augmented with an optional `size`
  * @private internal subcomponent used by various components
  */
 export declare function MenuIcon(props: SVGProps<SVGSVGElement> & {

package/esm/typings/src/book-components/icons/SaveIcon.d.ts

@@ -1,8 +1,12 @@
 import React from 'react';
 /**
- * @@@
+ * Renders a save icon.
  *
- * @public exported from `@promptbook/components`
+ * This icon is typically used in buttons that trigger the saving of data,
+ * configurations, or agent sources.
+ *
+ * @param props - SVG properties augmented with an optional `size`
+ * @private internal subcomponent used by various components
  */
 export declare function SaveIcon({ size, color, ...props }: {
     size?: number;

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

@@ -1,4 +1,4 @@
-import { AgentCollectionInSupabase } from './constructors/agent-collection-in-supabase/AgentCollectionInSupabase';
+import type { AgentCollectionInSupabase } from './constructors/agent-collection-in-supabase/AgentCollectionInSupabase';
 /**
  * Collection that groups together multiple AI Agents
  *

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

@@ -1,13 +1,16 @@
 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 { string_agent_name } from '../../../../types/typeAliases';
+import type { string_agent_name, string_agent_permanent_id } from '../../../../types/typeAliases';
 import { AgentCollectionInSupabaseOptions } from './AgentCollectionInSupabaseOptions';
 import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
 /**
- * Agent collection stored in Supabase table
+ * Agent collection stored in a Supabase table.
  *
- * Note: This object can work both from Node.js and browser environment depending on the Supabase client provided
+ * This class provides a way to manage a collection of agents (pipelines) using Supabase
+ * as the storage backend. It supports listing, creating, updating, and soft-deleting agents.
+ *
+ * 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
@@ -16,9 +19,8 @@ export declare class AgentCollectionInSupabase {
     private readonly supabaseClient;
     readonly options?: AgentCollectionInSupabaseOptions | 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
+     * @param supabaseClient - The initialized Supabase client
+     * @param options - Configuration options for the collection (e.g., table prefix, verbosity)
      */
     constructor(supabaseClient: SupabaseClient<AgentsDatabaseSchema>, options?: AgentCollectionInSupabaseOptions | undefined);
     /**
@@ -26,9 +28,13 @@ export declare class AgentCollectionInSupabase {
      */
     listAgents(): Promise<ReadonlyArray<AgentBasicInformation>>;
     /**
-     * [🐱‍🚀]@@@
+     * Retrieves the permanent ID of an agent by its name or permanent ID.
+     */
+    getAgentPermanentId(agentNameOrPermanentId: string_agent_name | string_agent_permanent_id): Promise<string_agent_permanent_id>;
+    /**
+     * Retrieves the source code of an agent by its name or permanent ID.
      */
-    getAgentSource(agentName: string_agent_name): Promise<string_book>;
+    getAgentSource(agentNameOrPermanentId: string_agent_name | string_agent_permanent_id): Promise<string_book>;
     /**
      * Creates a new agent in the collection
      *
@@ -38,7 +44,7 @@ export declare class AgentCollectionInSupabase {
     /**
      * Updates an existing agent in the collection
      */
-    updateAgentSource(agentName: string_agent_name, agentSource: string_book): Promise<void>;
+    updateAgentSource(permanentId: string_agent_permanent_id, agentSource: string_book): Promise<void>;
     /**
      * List agents that are soft deleted (deletedAt IS NOT NULL)
      */
@@ -46,7 +52,7 @@ export declare class AgentCollectionInSupabase {
     /**
      * List history of an agent
      */
-    listAgentHistory(agentName: string_agent_name): Promise<ReadonlyArray<{
+    listAgentHistory(permanentId: string_agent_permanent_id): Promise<ReadonlyArray<{
         id: number;
         createdAt: string;
         agentHash: string;
@@ -55,7 +61,7 @@ export declare class AgentCollectionInSupabase {
     /**
      * Restore a soft-deleted agent by setting deletedAt to NULL
      */
-    restoreAgent(agentIdentifier: string): Promise<void>;
+    restoreAgent(permanentId: string_agent_permanent_id): Promise<void>;
     /**
      * Restore an agent from a specific history entry
      *
@@ -65,7 +71,7 @@ export declare class AgentCollectionInSupabase {
     /**
      * Soft delete an agent by setting deletedAt to current timestamp
      */
-    deleteAgent(agentIdentifier: string): Promise<void>;
+    deleteAgent(permanentId: string_agent_permanent_id): Promise<void>;
     /**
      * Get the Supabase table name with prefix
      *

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

@@ -73,6 +73,7 @@ export type AgentsDatabaseSchema = {
                     id: number;
                     createdAt: string;
                     agentName: string;
+                    permanentId: string;
                     agentHash: string;
                     previousAgentHash: string | null;
                     agentSource: string;
@@ -82,6 +83,7 @@ export type AgentsDatabaseSchema = {
                     id?: number;
                     createdAt: string;
                     agentName: string;
+                    permanentId: string;
                     agentHash: string;
                     previousAgentHash?: string | null;
                     agentSource: string;
@@ -91,6 +93,7 @@ export type AgentsDatabaseSchema = {
                     id?: number;
                     createdAt?: string;
                     agentName?: string;
+                    permanentId?: string;
                     agentHash?: string;
                     previousAgentHash?: string | null;
                     agentSource?: string;
@@ -98,10 +101,10 @@ export type AgentsDatabaseSchema = {
                 };
                 Relationships: [
                     {
-                        foreignKeyName: 'AgentHistory_agentName_fkey';
-                        columns: ['agentName'];
+                        foreignKeyName: 'AgentHistory_permanentId_fkey';
+                        columns: ['permanentId'];
                         referencedRelation: 'Agent';
-                        referencedColumns: ['agentName'];
+                        referencedColumns: ['permanentId'];
                     }
                 ];
             };

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

@@ -3,4 +3,4 @@ import { COMMANDS } from '../../index';
  * Command is one piece of the book file section which adds some logic to the task or the whole pipeline.
  * It is parsed from the markdown from ul/ol items - one command per one item.
  */
-export type Command = ReturnType<typeof COMMANDS[number]['parse']>;
+export type Command = ReturnType<(typeof COMMANDS)[number]['parse']>;

package/esm/typings/src/commitments/META/META_DESCRIPTION.d.ts

@@ -0,0 +1,41 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META DESCRIPTION commitment definition
+ *
+ * The META DESCRIPTION commitment sets the agent's meta description for the profile page.
+ * This commitment is special because it doesn't affect the system message,
+ * but is handled separately in the parsing logic.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * META DESCRIPTION An AI assistant specialized in business tasks
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class MetaDescriptionCommitmentDefinition extends BaseCommitmentDefinition<'META DESCRIPTION'> {
+    constructor();
+    /**
+     * Short one-line description of META DESCRIPTION.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for META DESCRIPTION commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Extracts the meta description from the content
+     * This is used by the parsing logic
+     */
+    extractMetaDescription(content: string): string | null;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/commitments/USE_SEARCH_ENGINE/USE_SEARCH_ENGINE.d.ts

@@ -6,13 +6,13 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * The `USE SEARCH ENGINE` commitment indicates that the agent should utilize a search engine tool
  * to access and retrieve up-to-date information from the internet when necessary.
  *
- * The content following `USE SEARCH ENGINE` is ignored (similar to NOTE).
+ * The content following `USE SEARCH ENGINE` is an arbitrary text that the agent should know (e.g. search scope or instructions).
  *
  * Example usage in agent source:
  *
  * ```book
  * USE SEARCH ENGINE
- * USE SEARCH ENGINE This will be ignored
+ * USE SEARCH ENGINE Hledej informace o Přemyslovcích
  * ```
  *
  * @private [🪔] Maybe export the commitments through some package

package/esm/typings/src/commitments/_base/BookCommitment.d.ts

@@ -2,4 +2,4 @@ import { COMMITMENT_REGISTRY } from '../index';
 /**
  * All available book commitment types
  */
-export type BookCommitment = typeof COMMITMENT_REGISTRY[number]['type'];
+export type BookCommitment = (typeof COMMITMENT_REGISTRY)[number]['type'];

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

@@ -1,6 +1,6 @@
 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 type { string_app_id, string_email, string_legal_entity, string_name, string_promptbook_server_url } from './types/typeAliases';
 import { Color } from './utils/color/Color';
 /**
  * Warning message for the generated sections and files files
@@ -22,6 +22,12 @@ export declare const NAME = "Promptbook";
  * @public exported from `@promptbook/core`
  */
 export declare const ADMIN_EMAIL: string_email;
+/**
+ * Email of the responsible person
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const PROMPTBOOK_LEGAL_ENTITY: string_legal_entity;
 /**
  * Name of the responsible person for the Promptbook on GitHub
  *
@@ -295,6 +301,7 @@ export declare const MOMENT_ARG_THRESHOLDS: {
 /**
  * Default remote server URL for the Promptbook
  *
+ * @deprecated TODO: !!! Deprecate all things related to pipelines and pipelines server
  * @public exported from `@promptbook/core`
  */
 export declare const DEFAULT_REMOTE_SERVER_URL: string_promptbook_server_url;

package/esm/typings/src/formfactors/_common/FormfactorDefinition.d.ts

@@ -7,4 +7,4 @@ import { FORMFACTOR_DEFINITIONS } from '../index';
  * Note: [🚉] This is fully serializable as JSON
  * @see https://github.com/webgptorg/promptbook/discussions/172
  */
-export type FormfactorDefinition = typeof FORMFACTOR_DEFINITIONS[number];
+export type FormfactorDefinition = (typeof FORMFACTOR_DEFINITIONS)[number];

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

@@ -21,7 +21,7 @@ export declare function $provideLlmToolsForTestingAndScriptsAndPlayground(option
 export {};
 /**
  * Note: [⚪] This should never be in any released package
- * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ * TODO: [👷‍♂️] Write a comprehensive manual about the construction of LLM tools
  * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
  * TODO: [®] DRY Register logi
  */

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

@@ -51,7 +51,7 @@ export declare function $provideLlmToolsForWizardOrCli(options?: ProvideLlmTools
 export {};
 /**
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ * TODO: [👷‍♂️] Write a comprehensive manual about the construction of LLM tools
  * TODO: [🥃] Allow `ptbk make` without llm tools
  * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
  * TODO: [®] DRY Register logic

package/esm/typings/src/llm-providers/_common/utils/count-total-usage/LlmExecutionToolsWithTotalUsage.d.ts

@@ -17,6 +17,6 @@ export type LlmExecutionToolsWithTotalUsage = LlmExecutionTools & {
     spending(): Observable<Usage>;
 };
 /**
- * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ * TODO: [👷‍♂️] Write a comprehensive manual about the construction of LLM tools
  * Note: [🥫] Not using getter `get totalUsage` but `getTotalUsage` to allow this object to be proxied
  */