@promptbook/openai 0.103.0-46 → 0.103.0-48

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

@@ -1,6 +1,9 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { computeAgentHash } from '../book-2.0/agent-source/computeAgentHash';
 import { createAgentModelRequirements } from '../book-2.0/agent-source/createAgentModelRequirements';
 import { createAgentModelRequirementsWithCommitments } from '../book-2.0/agent-source/createAgentModelRequirementsWithCommitments';
+import { createDefaultAgentName } from '../book-2.0/agent-source/createDefaultAgentName';
+import { normalizeAgentName } from '../book-2.0/agent-source/normalizeAgentName';
 import { PADDING_LINES } from '../book-2.0/agent-source/padBook';
 import { padBook } from '../book-2.0/agent-source/padBook';
 import { parseAgentSource } from '../book-2.0/agent-source/parseAgentSource';
@@ -8,13 +11,6 @@ import { parseParameters } from '../book-2.0/agent-source/parseParameters';
 import { isValidBook } from '../book-2.0/agent-source/string_book';
 import { validateBook } from '../book-2.0/agent-source/string_book';
 import { DEFAULT_BOOK } from '../book-2.0/agent-source/string_book';
-import { createEmptyAgentModelRequirements } from '../book-2.0/commitments/_base/createEmptyAgentModelRequirements';
-import { createBasicAgentModelRequirements } from '../book-2.0/commitments/_base/createEmptyAgentModelRequirements';
-import { NotYetImplementedCommitmentDefinition } from '../book-2.0/commitments/_base/NotYetImplementedCommitmentDefinition';
-import { getCommitmentDefinition } from '../book-2.0/commitments/index';
-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';
@@ -22,6 +18,13 @@ import { createPipelineCollectionFromPromise } from '../collection/pipeline-coll
 import { createPipelineCollectionFromUrl } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromUrl';
 import { createPipelineSubcollection } from '../collection/pipeline-collection/constructors/createPipelineSubcollection';
 import { pipelineCollectionToJson } from '../collection/pipeline-collection/pipelineCollectionToJson';
+import { createEmptyAgentModelRequirements } from '../commitments/_base/createEmptyAgentModelRequirements';
+import { createBasicAgentModelRequirements } from '../commitments/_base/createEmptyAgentModelRequirements';
+import { NotYetImplementedCommitmentDefinition } from '../commitments/_base/NotYetImplementedCommitmentDefinition';
+import { getCommitmentDefinition } from '../commitments/index';
+import { getAllCommitmentDefinitions } from '../commitments/index';
+import { getAllCommitmentTypes } from '../commitments/index';
+import { isCommitmentSupported } from '../commitments/index';
 import { NAME } from '../config';
 import { ADMIN_EMAIL } from '../config';
 import { ADMIN_GITHUB_NAME } from '../config';
@@ -138,6 +141,7 @@ import { AgentLlmExecutionTools } from '../llm-providers/agent/AgentLlmExecution
 import { createAgentLlmExecutionTools } from '../llm-providers/agent/createAgentLlmExecutionTools';
 import { _AgentMetadata } from '../llm-providers/agent/register-configuration';
 import { _AgentRegistration } from '../llm-providers/agent/register-constructor';
+import { RemoteAgent } from '../llm-providers/agent/RemoteAgent';
 import { _AnthropicClaudeMetadataRegistration } from '../llm-providers/anthropic-claude/register-configuration';
 import { _AzureOpenAiMetadataRegistration } from '../llm-providers/azure-openai/register-configuration';
 import { _DeepseekMetadataRegistration } from '../llm-providers/deepseek/register-configuration';
@@ -187,8 +191,11 @@ import { aboutPromptbookInformation } from '../utils/misc/aboutPromptbookInforma
 import { $generateBookBoilerplate } from '../utils/random/$generateBookBoilerplate';
 import { REMOTE_SERVER_URLS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { computeAgentHash };
 export { createAgentModelRequirements };
 export { createAgentModelRequirementsWithCommitments };
+export { createDefaultAgentName };
+export { normalizeAgentName };
 export { PADDING_LINES };
 export { padBook };
 export { parseAgentSource };
@@ -196,13 +203,6 @@ export { parseParameters };
 export { isValidBook };
 export { validateBook };
 export { DEFAULT_BOOK };
-export { createEmptyAgentModelRequirements };
-export { createBasicAgentModelRequirements };
-export { NotYetImplementedCommitmentDefinition };
-export { getCommitmentDefinition };
-export { getAllCommitmentDefinitions };
-export { getAllCommitmentTypes };
-export { isCommitmentSupported };
 export { generatePlaceholderAgentProfileImageUrl };
 export { AgentCollectionInSupabase };
 export { createPipelineCollectionFromJson };
@@ -210,6 +210,13 @@ export { createPipelineCollectionFromPromise };
 export { createPipelineCollectionFromUrl };
 export { createPipelineSubcollection };
 export { pipelineCollectionToJson };
+export { createEmptyAgentModelRequirements };
+export { createBasicAgentModelRequirements };
+export { NotYetImplementedCommitmentDefinition };
+export { getCommitmentDefinition };
+export { getAllCommitmentDefinitions };
+export { getAllCommitmentTypes };
+export { isCommitmentSupported };
 export { NAME };
 export { ADMIN_EMAIL };
 export { ADMIN_GITHUB_NAME };
@@ -326,6 +333,7 @@ export { AgentLlmExecutionTools };
 export { createAgentLlmExecutionTools };
 export { _AgentMetadata };
 export { _AgentRegistration };
+export { RemoteAgent };
 export { _AnthropicClaudeMetadataRegistration };
 export { _AzureOpenAiMetadataRegistration };
 export { _DeepseekMetadataRegistration };

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

@@ -2,14 +2,12 @@ import type { BookParameter } from '../book-2.0/agent-source/AgentBasicInformati
 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';
-import type { BookCommitment } from '../book-2.0/commitments/_base/BookCommitment';
-import type { CommitmentDefinition } from '../book-2.0/commitments/_base/CommitmentDefinition';
-import type { ParsedCommitment } from '../book-2.0/commitments/_base/ParsedCommitment';
 import type { AvatarChipProps } from '../book-components/AvatarProfile/AvatarChip/AvatarChip';
 import type { AvatarChipFromSourceProps } from '../book-components/AvatarProfile/AvatarChip/AvatarChipFromSource';
 import type { AvatarProfileProps } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfile';
 import type { AvatarProfileFromSourceProps } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfileFromSource';
 import type { BookEditorProps } from '../book-components/BookEditor/BookEditor';
+import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChatProps';
 import type { ChatProps } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatAutoScrollConfig } from '../book-components/Chat/hooks/useChatAutoScroll';
 import type { SendMessageToLlmChatFunction } from '../book-components/Chat/hooks/useSendMessageToLlmChat';
@@ -55,6 +53,9 @@ import type { SectionCommand } from '../commands/SECTION/SectionCommand';
 import type { UrlCommand } from '../commands/URL/UrlCommand';
 import type { ActionCommand } from '../commands/X_ACTION/ActionCommand';
 import type { InstrumentCommand } from '../commands/X_INSTRUMENT/InstrumentCommand';
+import type { BookCommitment } from '../commitments/_base/BookCommitment';
+import type { CommitmentDefinition } from '../commitments/_base/CommitmentDefinition';
+import type { ParsedCommitment } from '../commitments/_base/ParsedCommitment';
 import type { PrettifyOptions } from '../conversion/prettify/PrettifyOptions';
 import type { renderPipelineMermaidOptions } from '../conversion/prettify/renderPipelineMermaidOptions';
 import type { CallbackInterfaceToolsOptions } from '../dialogs/callback/CallbackInterfaceToolsOptions';
@@ -109,6 +110,7 @@ import type { CacheLlmToolsOptions } from '../llm-providers/_common/utils/cache/
 import type { LlmExecutionToolsWithTotalUsage } from '../llm-providers/_common/utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
 import type { AgentOptions } from '../llm-providers/agent/AgentOptions';
 import type { CreateAgentLlmExecutionToolsOptions } from '../llm-providers/agent/CreateAgentLlmExecutionToolsOptions';
+import type { RemoteAgentOptions } from '../llm-providers/agent/RemoteAgentOptions';
 import type { AnthropicClaudeExecutionToolsOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsNonProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
@@ -217,6 +219,7 @@ 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_agent_hash } 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';
@@ -246,6 +249,7 @@ import type { string_url } from '../types/typeAliases';
 import type { string_promptbook_server_url } from '../types/typeAliases';
 import type { string_base_url } from '../types/typeAliases';
 import type { string_pipeline_root_url } from '../types/typeAliases';
+import type { string_agent_url } from '../types/typeAliases';
 import type { string_pipeline_url } from '../types/typeAliases';
 import type { string_pipeline_url_with_task_hash } from '../types/typeAliases';
 import type { string_data_url } from '../types/typeAliases';
@@ -354,14 +358,12 @@ export type { BookParameter };
 export type { AgentBasicInformation };
 export type { AgentModelRequirements };
 export type { string_book };
-export type { BookCommitment };
-export type { CommitmentDefinition };
-export type { ParsedCommitment };
 export type { AvatarChipProps };
 export type { AvatarChipFromSourceProps };
 export type { AvatarProfileProps };
 export type { AvatarProfileFromSourceProps };
 export type { BookEditorProps };
+export type { AgentChatProps };
 export type { ChatProps };
 export type { ChatAutoScrollConfig };
 export type { SendMessageToLlmChatFunction };
@@ -407,6 +409,9 @@ export type { SectionCommand };
 export type { UrlCommand };
 export type { ActionCommand };
 export type { InstrumentCommand };
+export type { BookCommitment };
+export type { CommitmentDefinition };
+export type { ParsedCommitment };
 export type { PrettifyOptions };
 export type { renderPipelineMermaidOptions };
 export type { CallbackInterfaceToolsOptions };
@@ -461,6 +466,7 @@ export type { CacheLlmToolsOptions };
 export type { LlmExecutionToolsWithTotalUsage };
 export type { AgentOptions };
 export type { CreateAgentLlmExecutionToolsOptions };
+export type { RemoteAgentOptions };
 export type { AnthropicClaudeExecutionToolsOptions };
 export type { AnthropicClaudeExecutionToolsNonProxiedOptions };
 export type { AnthropicClaudeExecutionToolsProxiedOptions };
@@ -569,6 +575,7 @@ export type { ReservedParameters };
 export type { string_title };
 export type { string_agent_name };
 export type { string_agent_name_in_book };
+export type { string_agent_hash };
 export type { string_persona_description };
 export type { string_model_description };
 export type { string_knowledge_source_content };
@@ -598,6 +605,7 @@ export type { string_url };
 export type { string_promptbook_server_url };
 export type { string_base_url };
 export type { string_pipeline_root_url };
+export type { string_agent_url };
 export type { string_pipeline_url };
 export type { string_pipeline_url_with_task_hash };
 export type { string_data_url };

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

@@ -1,4 +1,4 @@
-import type { string_agent_name, string_color, string_url_image } from '../../types/typeAliases';
+import type { string_agent_hash, 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 @
@@ -28,7 +28,11 @@ export type AgentBasicInformation = {
      * Name of the agent
      * This is the first line of the agent source
      */
-    agentName: string_agent_name | null;
+    agentName: string_agent_name;
+    /**
+     * Hash of the agent source for integrity verification
+     */
+    agentHash: string_agent_hash;
     /**
      * Optional description of the agent
      * This is the line starting with "PERSONA"
@@ -53,6 +57,6 @@ export type AgentBasicInformation = {
     parameters: BookParameter[];
 };
 /**
- * TODO: All readonly
+ * TODO: !!!!! Make all properties of `AgentBasicInformation` readonly
  * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
  */

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

@@ -1,3 +1,4 @@
+import type { string_knowledge_source_link } from '../../types/typeAliases';
 import type { TODO_any } from '../../utils/organization/TODO_any';
 /**
  * Model requirements for an agent
@@ -16,7 +17,11 @@ export type AgentModelRequirements = {
     /**
      * Optional list of MCP servers that the agent can connect to
      */
-    readonly mcpServers?: string[];
+    readonly mcpServers?: ReadonlyArray<string>;
+    /**
+     * Optional list of knowledge source links that the agent can use
+     */
+    readonly knowledgeSources?: ReadonlyArray<string_knowledge_source_link>;
     /**
      * Temperature for the agent's responses, controlling randomness
      */

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

@@ -1,4 +1,5 @@
-import type { ParsedCommitment } from '../commitments/_base/ParsedCommitment';
+import type { ParsedCommitment } from '../../commitments/_base/ParsedCommitment';
+import { string_agent_name } from '../../types/typeAliases';
 /**
  * Result of parsing agent source for commitments
  *
@@ -8,7 +9,7 @@ export type AgentSourceParseResult = {
     /**
      * The agent name (first line)
      */
-    agentName: string | null;
+    agentName: string_agent_name | null;
     /**
      * All parsed commitments
      */

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

@@ -0,0 +1,8 @@
+import { string_agent_hash } from '../../types/typeAliases';
+import { string_book } from './string_book';
+/**
+ * Computes SHA-256 hash of the agent source
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function computeAgentHash(agentSource: string_book): string_agent_hash;

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

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

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

@@ -1,4 +1,4 @@
-import type { BookCommitment } from '../commitments/_base/BookCommitment';
+import type { BookCommitment } from '../../commitments/_base/BookCommitment';
 /**
  * Generates a regex pattern to match a specific commitment
  *

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

@@ -0,0 +1,8 @@
+import { string_agent_name } from '../../types/typeAliases';
+import { string_book } from './string_book';
+/**
+ * Creates temporary default agent name based on agent source hash
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function createDefaultAgentName(agentSource: string_book): string_agent_name;

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

@@ -0,0 +1,9 @@
+import { string_agent_name } from '../../types/typeAliases';
+/**
+ * Normalizes agent name from arbitrary string to valid agent name
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function normalizeAgentName(rawAgentName: string): string_agent_name;

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

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

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

@@ -6,4 +6,4 @@ import type { string_book } from './string_book';
  *
  * @private internal utility of `parseAgentSource`
  */
-export declare function parseAgentSourceWithCommitments(agentSource: string_book): AgentSourceParseResult;
+export declare function parseAgentSourceWithCommitments(agentSource: string_book): Omit<AgentSourceParseResult, 'agentHash'>;

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

@@ -0,0 +1,14 @@
+import type { AgentChatProps } from './AgentChatProps';
+/**
+ * AgentChat component that provides chat functionality with LLM integration
+ *
+ * This component internally manages messages, participants, and task progress,
+ * and uses the provided LLM tools to generate responses via `LlmExecutionTools.callChatModel`.
+ *
+ * Note: There are multiple chat components:
+ * - `<Chat/>` renders chat as it is without any logic
+ * - `<AgentChat/>` connected to LLM Execution Tools of Promptbook
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function AgentChat(props: AgentChatProps): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/Chat/AgentChat/AgentChat.test.d.ts

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

package/esm/typings/src/book-components/Chat/AgentChat/AgentChatProps.d.ts

@@ -0,0 +1,13 @@
+import { Agent } from '../../../llm-providers/agent/Agent';
+import type { LlmChatProps } from '../LlmChat/LlmChatProps';
+/**
+ * Props for AgentChat component, derived from LlmChatProps but with Agent-specific modifications
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type AgentChatProps = Omit<LlmChatProps, 'thread' | 'llmTools' | 'initialMessages' | 'userParticipantName' | 'llmParticipantName'> & {
+    /**
+     * The agent to chat with
+     */
+    readonly agent: Agent;
+};

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

@@ -1,5 +1,4 @@
 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';
@@ -23,72 +22,14 @@ export declare class AgentCollectionInSupabase {
      * @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>>;
+    getAgentSource(agentName: string_agent_name): Promise<string_book>;
     /**
      * Creates a new agent in the collection
      *

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

@@ -1,65 +1,90 @@
+/**
+ * AUTO-GENERATED SUBSET TYPES FROM `/apps/agents-server/src/database/schema.ts`
+ * Source of truth: `/apps/agents-server/src/database/schema.sql` *(do not edit table structure here manually)*
+ *
+ * [💽] Prompt:
+ * Re-generate this sub-schema
+ * Generate Supabase TypeScript schema which is a subset of `AgentsServerDatabase`
+ * containing only tables `Agent` and `AgentHistory`
+ *
+ * NOTE: This file intentionally omits all other tables (EnvironmentVariable, ChatHistory, ChatFeedback)
+ *       and any extra schemas (e.g. `graphql_public`) to remain a strict subset.
+ */
 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: {
+            Agent: {
                 Row: {
                     id: number;
                     agentName: string;
-                    agentProfile: Json;
                     createdAt: string;
                     updatedAt: string | null;
-                    agentVersion: number;
+                    agentHash: string;
+                    agentSource: string;
+                    agentProfile: Json;
                     promptbookEngineVersion: string;
                     usage: Json | null;
-                    agentSource: string;
+                    preparedModelRequirements: Json | null;
+                    preparedExternals: Json | null;
                 };
                 Insert: {
                     id?: number;
                     agentName: string;
                     createdAt: string;
                     updatedAt?: string | null;
-                    agentVersion: number;
+                    agentHash: string;
+                    agentSource: string;
+                    agentProfile: Json;
                     promptbookEngineVersion: string;
                     usage?: Json | null;
-                    agentSource: string;
+                    preparedModelRequirements?: Json | null;
+                    preparedExternals?: Json | null;
                 };
                 Update: {
                     id?: number;
                     agentName?: string;
                     createdAt?: string;
                     updatedAt?: string | null;
-                    agentVersion?: number;
+                    agentHash?: string;
+                    agentSource?: string;
+                    agentProfile?: Json;
                     promptbookEngineVersion?: string;
                     usage?: Json | null;
+                    preparedModelRequirements?: Json | null;
+                    preparedExternals?: Json | null;
+                };
+                Relationships: [];
+            };
+            AgentHistory: {
+                Row: {
+                    id: number;
+                    createdAt: string;
+                    agentName: string;
+                    agentHash: string;
+                    previousAgentHash: string | null;
+                    agentSource: string;
+                    promptbookEngineVersion: string;
+                };
+                Insert: {
+                    id?: number;
+                    createdAt: string;
+                    agentName: string;
+                    agentHash: string;
+                    previousAgentHash?: string | null;
+                    agentSource: string;
+                    promptbookEngineVersion: string;
+                };
+                Update: {
+                    id?: number;
+                    createdAt?: string;
+                    agentName?: string;
+                    agentHash?: string;
+                    previousAgentHash?: string | null;
                     agentSource?: string;
+                    promptbookEngineVersion?: string;
                 };
                 Relationships: [];
             };

package/esm/typings/src/{book-2.0/commitments → commitments}/ACTION/ACTION.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * ACTION commitment definition

package/esm/typings/src/{book-2.0/commitments → commitments}/DELETE/DELETE.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * DELETE commitment definition

package/esm/typings/src/{book-2.0/commitments → commitments}/FORMAT/FORMAT.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * FORMAT commitment definition

package/esm/typings/src/{book-2.0/commitments → commitments}/GOAL/GOAL.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * GOAL commitment definition

package/esm/typings/src/{book-2.0/commitments → commitments}/KNOWLEDGE/KNOWLEDGE.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * KNOWLEDGE commitment definition
@@ -29,10 +29,6 @@ export declare class KnowledgeCommitmentDefinition extends BaseCommitmentDefinit
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
-    /**
-     * Check if content is a URL
-     */
-    private isUrl;
 }
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/{book-2.0/commitments → commitments}/MEMORY/MEMORY.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * MEMORY commitment definition

package/esm/typings/src/{book-2.0/commitments → commitments}/MESSAGE/MESSAGE.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * MESSAGE commitment definition

package/esm/typings/src/{book-2.0/commitments → commitments}/META/META.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * META commitment definition

package/esm/typings/src/{book-2.0/commitments → commitments}/META_IMAGE/META_IMAGE.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * META IMAGE commitment definition

package/esm/typings/src/{book-2.0/commitments → commitments}/META_LINK/META_LINK.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * META LINK commitment definition

package/esm/typings/src/{book-2.0/commitments → commitments}/MODEL/MODEL.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * MODEL commitment definition

package/esm/typings/src/{book-2.0/commitments → commitments}/NOTE/NOTE.d.ts

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * NOTE commitment definition