@promptbook/cli 0.103.0-49 → 0.103.0-51

package/apps/agents-server/src/components/Homepage/AgentCard.tsx

@@ -0,0 +1,28 @@
+import Link from 'next/link';
+import React from 'react';
+import { AgentBasicInformation } from '../../../../../src/book-2.0/agent-source/AgentBasicInformation';
+import { AvatarProfile } from '../../../../../src/book-components/AvatarProfile/AvatarProfile/AvatarProfile';
+import { Card } from './Card';
+
+type AgentCardProps = {
+    agent: AgentBasicInformation;
+    href: string;
+};
+
+export function AgentCard({ agent, href }: AgentCardProps) {
+    return (
+        <Link href={href}>
+            <Card
+                style={
+                    !agent.meta.color
+                        ? {}
+                        : {
+                              backgroundColor: `${agent.meta.color}22`,
+                          }
+                }
+            >
+                <AvatarProfile agent={agent} />
+            </Card>
+        </Link>
+    );
+}

package/apps/agents-server/src/components/Homepage/Card.tsx

@@ -0,0 +1,18 @@
+import React from 'react';
+
+type CardProps = {
+    children: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+};
+
+export function Card({ children, className = '', style }: CardProps) {
+    return (
+        <div
+            className={`block p-6 bg-white rounded-lg shadow-md hover:shadow-xl transition-shadow duration-300 border border-gray-200 hover:border-blue-400 ${className}`}
+            style={style}
+        >
+            {children}
+        </div>
+    );
+}

package/apps/agents-server/src/components/Homepage/ModelCard.tsx

@@ -0,0 +1,29 @@
+import Link from 'next/link';
+import React from 'react';
+import { Card } from './Card';
+
+type ModelCardProps = {
+    modelName: string;
+    modelTitle: string;
+    modelDescription?: string;
+};
+
+export function ModelCard({ modelName, modelTitle, modelDescription }: ModelCardProps) {
+    return (
+        <Link href={`#[🐱‍🚀]`}>
+            <Card className="h-full flex flex-col">
+                <div className="flex justify-between items-start mb-2">
+                    <h2 className="text-xl font-bold text-gray-900">{modelTitle}</h2>
+                    <span className="inline-block bg-gray-100 text-gray-600 text-xs px-2 py-1 rounded font-mono">
+                        {modelName}
+                    </span>
+                </div>
+                {modelDescription && (
+                    <p className="text-gray-600 text-sm mt-2 flex-grow leading-relaxed">
+                        {modelDescription}
+                    </p>
+                )}
+            </Card>
+        </Link>
+    );
+}

package/apps/agents-server/src/components/Homepage/Section.tsx

@@ -0,0 +1,17 @@
+import React from 'react';
+
+type SectionProps = {
+    title: string;
+    children: React.ReactNode;
+};
+
+export function Section({ title, children }: SectionProps) {
+    return (
+        <section className="mt-16 first:mt-4 mb-4">
+            <h2 className="text-3xl text-gray-900 mb-6 font-light">{title}</h2>
+            <div className="grid gap-6 md:grid-cols-2 lg:grid-cols-3">
+                {children}
+            </div>
+        </section>
+    );
+}

package/apps/agents-server/src/components/Homepage/TechInfoCard.tsx

@@ -0,0 +1,20 @@
+import Link from 'next/link';
+import React from 'react';
+import { Card } from './Card';
+
+type TechInfoCardProps = {
+    title: string;
+    children: React.ReactNode;
+    href?: string;
+};
+
+export function TechInfoCard({ title, children, href = '#' }: TechInfoCardProps) {
+    return (
+        <Link href={href}>
+            <Card>
+                <h2 className="text-2xl font-semibold text-gray-900 mb-2">{title}</h2>
+                {children}
+            </Card>
+        </Link>
+    );
+}

package/apps/agents-server/src/components/UsersList/UsersList.tsx

@@ -1,6 +1,8 @@
 'use client';
 
 import { useState, useEffect } from 'react';
+import { Card } from '../Homepage/Card';
+import { Section } from '../Homepage/Section';
 
 type User = {
     id: number;
@@ -111,13 +113,11 @@ export function UsersList() {
 
     return (
         <div className="space-y-6">
-            <h2 className="text-3xl text-gray-900 mt-16 mb-4">Users ({users.length})</h2>
-            
             {error && <div className="bg-red-100 text-red-700 p-3 rounded">{error}</div>}
 
-            <div className="grid gap-6 md:grid-cols-2 lg:grid-cols-3">
+            <Section title={`Users (${users.length})`}>
                 {users.map((user) => (
-                    <div key={user.id} className="block p-6 bg-white rounded-lg shadow-md border border-gray-200">
+                    <Card key={user.id}>
                         <div className="flex justify-between items-start">
                             <div>
                                 <h3 className="text-xl font-semibold text-gray-900">{user.username}</h3>
@@ -139,7 +139,7 @@ export function UsersList() {
                                 </button>
                             </div>
                         </div>
-                    </div>
+                    </Card>
                 ))}
                 
                 {/* Create User Form */}
@@ -184,7 +184,7 @@ export function UsersList() {
                         </button>
                     </form>
                 </div>
-            </div>
+            </Section>
         </div>
     );
 }

package/apps/agents-server/src/components/VercelDeploymentCard/VercelDeploymentCard.tsx

@@ -16,19 +16,14 @@ import {
     NEXT_PUBLIC_VERCEL_TARGET_ENV,
     NEXT_PUBLIC_VERCEL_URL,
 } from '@/config';
-import Link from 'next/link';
+import { TechInfoCard } from '../Homepage/TechInfoCard';
 
 /**
  * [♐️] Expose Vercel environment variables to indentify the deployment
  */
 export default function VercelDeploymentCard() {
     return (
-        <Link
-            href="#"
-            className="block p-6 bg-white rounded-lg shadow-md hover:shadow-xl transition-shadow duration-300 border border-gray-200 hover:border-blue-400"
-        >
-            <h2 className="text-2xl font-semibold text-gray-900 mb-4">Vercel Deployment</h2>
-
+        <TechInfoCard title="Vercel Deployment">
             <p className="text-gray-600">NEXT_PUBLIC_VERCEL_ENV: {NEXT_PUBLIC_VERCEL_ENV}</p>
             <p className="text-gray-600">NEXT_PUBLIC_VERCEL_TARGET_ENV: {NEXT_PUBLIC_VERCEL_TARGET_ENV}</p>
             <p className="text-gray-600">NEXT_PUBLIC_VERCEL_URL: {NEXT_PUBLIC_VERCEL_URL}</p>
@@ -55,6 +50,6 @@ export default function VercelDeploymentCard() {
             <p className="text-gray-600">
                 NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID: {NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID}
             </p>
-        </Link>
+        </TechInfoCard>
     );
 }

package/apps/agents-server/src/database/metadataDefaults.ts

@@ -29,4 +29,9 @@ export const metadataDefaults = [
         value: '',
         note: 'Comma separated list of allowed IPs or CIDR ranges. If set, only clients from these IPs are allowed to access the server.',
     },
+    {
+        key: 'FEDERATED_SERVERS',
+        value: '',
+        note: 'Comma separated list of federated servers URLs. The server will look to all federated servers and list their agents.',
+    },
 ] as const;

package/apps/agents-server/src/database/migrate.ts

@@ -0,0 +1,131 @@
+import * as dotenv from 'dotenv';
+import * as fs from 'fs';
+import * as path from 'path';
+import { Client } from 'pg';
+
+dotenv.config();
+
+async function migrate() {
+    console.info('🚀 Starting database migration');
+
+    // 1. Get configuration
+    const prefixesEnv = process.env.SUPABASE_MIGRATION_PREFIXES;
+    if (!prefixesEnv) {
+        console.warn('⚠️ SUPABASE_MIGRATION_PREFIXES is not defined. Skipping migration.');
+        return;
+    }
+    const prefixes = prefixesEnv
+        .split(',')
+        .map((p) => p.trim())
+        .filter((p) => p !== '');
+
+    if (prefixes.length === 0) {
+        console.warn('⚠️ No prefixes found in SUPABASE_MIGRATION_PREFIXES. Skipping migration.');
+        return;
+    }
+
+    const connectionString = process.env.POSTGRES_URL || process.env.DATABASE_URL;
+    if (!connectionString) {
+        console.error('❌ POSTGRES_URL or DATABASE_URL is not defined.');
+        process.exit(1);
+    }
+
+    console.info(`📋 Found ${prefixes.length} prefixes to migrate: ${prefixes.join(', ')}`);
+
+    // 2. Connect to database
+    const client = new Client({
+        connectionString,
+        ssl: { rejectUnauthorized: false }, // Required for some Supabase/Heroku connections
+    });
+
+    try {
+        await client.connect();
+        console.info('🔌 Connected to database');
+
+        // 3. Read migration files
+        const migrationsDir = path.join(__dirname, 'migrations');
+        if (!fs.existsSync(migrationsDir)) {
+            console.error(`❌ Migrations directory not found at ${migrationsDir}`);
+            process.exit(1);
+        }
+
+        const migrationFiles = fs
+            .readdirSync(migrationsDir)
+            .filter((file) => file.endsWith('.sql'))
+            .sort(); // Ensure files are processed in order
+
+        console.info(`📂 Found ${migrationFiles.length} migration files`);
+
+        // 4. Iterate over prefixes and apply migrations
+        for (const prefix of prefixes) {
+            console.info(`\n🏗️ Migrating prefix: "${prefix}"`);
+            const migrationsTableName = `${prefix}Migrations`;
+
+            // 4.1 Create migrations table if not exists
+            const createMigrationsTableSql = `
+                CREATE TABLE IF NOT EXISTS "${migrationsTableName}" (
+                    "filename" TEXT PRIMARY KEY,
+                    "appliedAt" TIMESTAMP WITH TIME ZONE DEFAULT now()
+                );
+            `;
+            await client.query(createMigrationsTableSql);
+
+            // Enable RLS for migrations table
+            const enableRlsSql = `ALTER TABLE "${migrationsTableName}" ENABLE ROW LEVEL SECURITY;`;
+            await client.query(enableRlsSql);
+
+            // 4.2 Get applied migrations
+            const { rows: appliedMigrationsRows } = await client.query(
+                `SELECT "filename" FROM "${migrationsTableName}"`,
+            );
+            const appliedMigrations = new Set(appliedMigrationsRows.map((row) => row.filename));
+
+            // 4.3 Apply new migrations in one big transaction
+            let migrationError = null;
+            await client.query('BEGIN');
+            try {
+                for (const file of migrationFiles) {
+                    if (appliedMigrations.has(file)) {
+                        // console.info(`  ⏭️  Skipping ${file} (already applied)`);
+                        continue;
+                    }
+
+                    console.info(`  🚀 Applying ${file}...`);
+                    const filePath = path.join(migrationsDir, file);
+                    let sql = fs.readFileSync(filePath, 'utf-8');
+
+                    // Replace prefix placeholder
+                    sql = sql.replace(/prefix_/g, prefix);
+
+                    try {
+                        await client.query(sql);
+                        await client.query(`INSERT INTO "${migrationsTableName}" ("filename") VALUES ($1)`, [file]);
+                        console.info(`  ✅ Applied ${file}`);
+                    } catch (error) {
+                        console.error(`  ❌ Failed to apply ${file}:`, error);
+                        migrationError = error;
+                        break;
+                    }
+                }
+                if (migrationError) {
+                    await client.query('ROLLBACK');
+                    throw migrationError;
+                } else {
+                    await client.query('COMMIT');
+                }
+            } catch (error) {
+                await client.query('ROLLBACK');
+                throw error;
+            }
+        }
+
+        console.info('\n🎉 All migrations completed successfully');
+    } catch (error) {
+        console.error('\n❌ Migration failed:', error);
+        process.exit(1);
+    } finally {
+        await client.end();
+    }
+}
+
+migrate();

package/apps/agents-server/src/database/{schema.sql → migrations/2025-11-0001-initial-schema.sql}

@@ -1,22 +1,8 @@
-
 -- Note: This is primary source of truth for the database schema
 --       In future we want to be compatible with more then Supabase so we keep SQL as main schema definition
 --       To update, search for [💽]
 
 
-CREATE TABLE IF NOT EXISTS "prefix_Metadata" (
-    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
-    "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
-    "updatedAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
-    "key" TEXT NOT NULL,
-    "value" TEXT NOT NULL,
-    "note" TEXT NULL,
-    CONSTRAINT prefix_Metadata_key_key UNIQUE ("key")
-);
-
-ALTER TABLE "prefix_Metadata" ENABLE ROW LEVEL SECURITY;
-
-
 CREATE TABLE IF NOT EXISTS "prefix_Agent" (
     "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
     "agentName" TEXT NOT NULL,
@@ -36,7 +22,7 @@ CREATE TABLE IF NOT EXISTS "prefix_Agent" (
     "preparedExternals" JSONB NULL
 );
 -- Ensure uniqueness of agentName even on repeated schema application without duplicate constraint creation
-CREATE UNIQUE INDEX IF NOT EXISTS prefix_agent_agentname_key ON "prefix_Agent" ("agentName");
+CREATE UNIQUE INDEX IF NOT EXISTS "prefix_agent_agentname_key" ON "prefix_Agent" ("agentName");
 COMMENT ON COLUMN "prefix_Agent"."agentName" IS 'The unique name of the agent derived from the first line of the `agentSource`, automatically updated on `agentSource` change';
 COMMENT ON COLUMN "prefix_Agent"."agentHash" IS 'The hash of the `agentSource`, automatically updated on `agentSource` change';
 COMMENT ON COLUMN "prefix_Agent"."agentSource" IS 'The source code of the agent';
@@ -175,5 +161,3 @@ ALTER TABLE "prefix_ChatFeedback"
     FOREIGN KEY ("agentName") 
     REFERENCES "prefix_Agent"("agentName") 
     ON DELETE CASCADE;
-
--- TODO: [🐱‍🚀] Create propper database migrations

package/apps/agents-server/src/database/migrations/2025-11-0002-metadata-table.sql

@@ -0,0 +1,16 @@
+-- Note: This is primary source of truth for the database schema
+--       In future we want to be compatible with more then Supabase so we keep SQL as main schema definition
+--       To update, search for [💽]
+
+
+CREATE TABLE IF NOT EXISTS "prefix_Metadata" (
+    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+    "updatedAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+    "key" TEXT NOT NULL,
+    "value" TEXT NOT NULL,
+    "note" TEXT NULL,
+    CONSTRAINT "prefix_Metadata_key_key" UNIQUE ("key")
+);
+
+ALTER TABLE "prefix_Metadata" ENABLE ROW LEVEL SECURITY;

package/apps/agents-server/src/middleware.ts

@@ -72,10 +72,48 @@ export async function middleware(req: NextRequest) {
         }
     }
 
-    const allowedIps = allowedIpsMetadata !== null && allowedIpsMetadata !== undefined ? allowedIpsMetadata : allowedIpsEnv;
+    const allowedIps =
+        allowedIpsMetadata !== null && allowedIpsMetadata !== undefined ? allowedIpsMetadata : allowedIpsEnv;
 
     if (isIpAllowed(ip, allowedIps)) {
-        // 3. Custom Domain Routing
+        // Handle OPTIONS (preflight) requests before any redirects
+        // to avoid CORS issues ("Redirect is not allowed for a preflight request")
+        if (req.method === 'OPTIONS') {
+            return new NextResponse(null, {
+                status: 200,
+                headers: {
+                    'Access-Control-Allow-Origin': '*',
+                    'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+                    'Access-Control-Allow-Headers': 'Content-Type',
+                },
+            });
+        }
+
+        // 3. Redirect /:agentName/* to /agents/:agentName/*
+        //    This enables accessing agents from the root path
+        const pathParts = req.nextUrl.pathname.split('/');
+        const potentialAgentName = pathParts[1];
+
+        if (
+            potentialAgentName &&
+            !['agents', 'api', 'admin', 'embed', '_next', 'favicon.ico'].includes(potentialAgentName) &&
+            !potentialAgentName.startsWith('.') &&
+            // Note: Other static files are excluded by the matcher configuration below
+            true
+        ) {
+            const url = req.nextUrl.clone();
+            url.pathname = `/agents${req.nextUrl.pathname}`;
+            const response = NextResponse.redirect(url);
+
+            // Enable CORS for the redirect
+            response.headers.set('Access-Control-Allow-Origin', '*');
+            response.headers.set('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+            response.headers.set('Access-Control-Allow-Headers', 'Content-Type');
+
+            return response;
+        }
+
+        // 4. Custom Domain Routing
         //    If the host is not one of the configured SERVERS, try to find an agent with a matching META LINK
 
         if (host && SERVERS && !SERVERS.some((server) => server === host)) {
@@ -94,7 +132,7 @@ export async function middleware(req: NextRequest) {
                 // We check all configured servers because the custom domain could point to any of them
                 // (or if they share the database, we need to check the relevant tables)
                 const serversToCheck = SERVERS;
-                
+
                 // TODO: [🧠] If there are many servers, this loop might be slow. Optimize if needed.
                 for (const serverHost of serversToCheck) {
                     let serverName = serverHost;
@@ -105,11 +143,11 @@ export async function middleware(req: NextRequest) {
                     // Search for agent with matching META LINK
                     // agentProfile->links is an array of strings
                     // We check if it contains the host, or https://host, or http://host
-                    
+
                     const searchLinks = [host, `https://${host}`, `http://${host}`];
-                    
+
                     // Construct OR filter: agentProfile.cs.{"links":["link1"]},agentProfile.cs.{"links":["link2"]},...
-                    const orFilter = searchLinks.map(link => `agentProfile.cs.{"links":["${link}"]}`).join(',');
+                    const orFilter = searchLinks.map((link) => `agentProfile.cs.{"links":["${link}"]}`).join(',');
 
                     try {
                         const { data } = await supabase
@@ -123,7 +161,7 @@ export async function middleware(req: NextRequest) {
                             // Found the agent!
                             const url = req.nextUrl.clone();
                             url.pathname = `/${data.agentName}`;
-                            
+
                             // Pass the server context to the app via header
                             const requestHeaders = new Headers(req.headers);
                             requestHeaders.set('x-promptbook-server', serverHost);
@@ -135,8 +173,8 @@ export async function middleware(req: NextRequest) {
                             });
                         }
                     } catch (error) {
-                         // Ignore error (e.g. table not found, or agent not found) and continue to next server
-                         // console.error(`Error checking server ${serverHost} for custom domain ${host}:`, error);
+                        // Ignore error (e.g. table not found, or agent not found) and continue to next server
+                        // console.error(`Error checking server ${serverHost} for custom domain ${host}:`, error);
                     }
                 }
             }

package/apps/agents-server/src/utils/getFederatedAgents.ts

@@ -0,0 +1,66 @@
+import { AgentCollection } from '@promptbook-local/types';
+
+type Agent = Awaited<ReturnType<AgentCollection['listAgents']>>[number];
+
+type AgentWithUrl = Agent & {
+    url: string;
+};
+
+type AgentsApiResponse = {
+    agents: AgentWithUrl[];
+    federatedServers: string[];
+};
+
+/**
+ * Fetches agents from federated servers recursively
+ */
+export async function getFederatedAgents(initialServers: string[]): Promise<AgentWithUrl[]> {
+    const visited = new Set<string>();
+    const queue = [...initialServers];
+    const externalAgentsMap = new Map<string, AgentWithUrl>();
+    const MAX_SERVERS = 20;
+
+    while (queue.length > 0 && visited.size < MAX_SERVERS) {
+        const serverUrl = queue.shift();
+        if (!serverUrl) continue;
+
+        const normalizedUrl = serverUrl.trim().replace(/\/$/, '');
+        if (visited.has(normalizedUrl)) continue;
+        visited.add(normalizedUrl);
+
+        try {
+            // TODO: [🧠] Should we use some shorter timeout?
+            const response = await fetch(`${normalizedUrl}/api/agents`, { 
+                next: { revalidate: 600 } // Cache for 10 minutes
+            });
+            
+            if (!response.ok) {
+                console.warn(`Failed to fetch agents from ${normalizedUrl}: ${response.status} ${response.statusText}`);
+                continue;
+            }
+
+            const data: AgentsApiResponse = await response.json();
+
+            if (data.agents && Array.isArray(data.agents)) {
+                for (const agent of data.agents) {
+                    if (agent.url && !externalAgentsMap.has(agent.url)) {
+                        externalAgentsMap.set(agent.url, agent);
+                    }
+                }
+            }
+
+            if (data.federatedServers && Array.isArray(data.federatedServers)) {
+                for (const server of data.federatedServers) {
+                    const normalizedServer = server.trim().replace(/\/$/, '');
+                    if (!visited.has(normalizedServer) && normalizedServer !== '') {
+                        queue.push(normalizedServer);
+                    }
+                }
+            }
+        } catch (error) {
+            console.error(`Error fetching agents from ${normalizedUrl}:`, error);
+        }
+    }
+
+    return Array.from(externalAgentsMap.values());
+}

package/esm/index.es.js

@@ -47,7 +47,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-49';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-51';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -51,6 +51,7 @@ import { ResetIcon } from '../book-components/icons/ResetIcon';
 import { SaveIcon } from '../book-components/icons/SaveIcon';
 import { SendIcon } from '../book-components/icons/SendIcon';
 import { TemplateIcon } from '../book-components/icons/TemplateIcon';
+import { PromptbookAgent } from '../book-components/PromptbookAgent/PromptbookAgent';
 import { BrandedQrCode } from '../book-components/Qr/BrandedQrCode';
 import { GenericQrCode } from '../book-components/Qr/GenericQrCode';
 import { PromptbookQrCode } from '../book-components/Qr/PromptbookQrCode';
@@ -109,6 +110,7 @@ export { ResetIcon };
 export { SaveIcon };
 export { SendIcon };
 export { TemplateIcon };
+export { PromptbookAgent };
 export { BrandedQrCode };
 export { GenericQrCode };
 export { PromptbookQrCode };

package/esm/typings/src/book-components/PromptbookAgent/PromptbookAgent.d.ts

@@ -0,0 +1,23 @@
+type PromptbookAgentProps = {
+    /**
+     * URL of the agent to connect to
+     *
+     * @example "http://s6.ptbk.io/benjamin-white"
+     */
+    agentUrl: string;
+    /**
+     * Callback when the window is opened or closed
+     */
+    onOpenChange?: (isOpen: boolean) => void;
+};
+/**
+ * Renders a floating agent button that opens a chat window with the remote agent.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function PromptbookAgent(props: PromptbookAgentProps): import("react/jsx-runtime").JSX.Element;
+export {};
+/**
+ * TODO: !!! Load the full branding
+ * TODO: !!! <promptbook-agent> element
+ */

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

@@ -2,6 +2,8 @@ import { BehaviorSubject } from 'rxjs';
 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 { ChatPromptResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
 import type { string_agent_hash, string_agent_name, string_agent_url, string_url_image } from '../../types/typeAliases';
 import { AgentLlmExecutionTools } from './AgentLlmExecutionTools';
 import type { AgentOptions } from './AgentOptions';
@@ -55,6 +57,12 @@ export declare class Agent extends AgentLlmExecutionTools implements LlmExecutio
     get parameters(): BookParameter[];
     readonly agentSource: BehaviorSubject<string_book>;
     constructor(options: AgentOptions);
+    /**
+     * Calls the chat model with agent-specific system prompt and requirements with streaming
+     *
+     * Note: This method also implements the learning mechanism
+     */
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
 }
 /**
  * TODO: [🧠][😰]Agent is not working with the parameters, should it be?

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

@@ -1,4 +1,5 @@
 import type { Promisable } from 'type-fest';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
 import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
@@ -40,6 +41,12 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
      * @param agentSource The agent source string that defines the agent's behavior
      */
     constructor(options: CreateAgentLlmExecutionToolsOptions);
+    /**
+     * Updates the agent source and clears the cache
+     *
+     * @param agentSource The new agent source string
+     */
+    protected updateAgentSource(agentSource: string_book): void;
     /**
      * Get cached or parse agent information
      */

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

@@ -1,5 +1,6 @@
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
+import type { string_agent_hash, string_agent_name } from '../../types/typeAliases';
 import { Agent } from './Agent';
 import type { RemoteAgentOptions } from './RemoteAgentOptions';
 /**
@@ -20,7 +21,11 @@ export declare class RemoteAgent extends Agent {
      * The source of the agent
      */
     private agentUrl;
+    private _remoteAgentName;
+    private _remoteAgentHash;
     private constructor();
+    get agentName(): string_agent_name;
+    get agentHash(): string_agent_hash;
     /**
      * Calls the agent on agents remote server
      */