@promptbook/cli 0.103.0-50 → 0.103.0-52

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

@@ -96,7 +96,7 @@ export async function middleware(req: NextRequest) {
 
         if (
             potentialAgentName &&
-            !['agents', 'api', '_next', 'favicon.ico'].includes(potentialAgentName) &&
+            !['agents', 'api', 'admin', 'embed', '_next', 'favicon.ico'].includes(potentialAgentName) &&
             !potentialAgentName.startsWith('.') &&
             // Note: Other static files are excluded by the matcher configuration below
             true

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-50';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-52';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -22395,9 +22395,13 @@ const _FormattedBookInMarkdownTranspilerRegistration = $bookTranspilersRegister.
  *
  * @private - TODO: [🧠] Maybe should be public?
  */
-function createCommitmentRegex(commitment) {
-    const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    const keywordPattern = escapedCommitment.split(/\s+/).join('\\s+');
+function createCommitmentRegex(commitment, aliases = []) {
+    const allCommitments = [commitment, ...aliases];
+    const patterns = allCommitments.map((c) => {
+        const escapedCommitment = c.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return escapedCommitment.split(/\s+/).join('\\s+');
+    });
+    const keywordPattern = patterns.join('|');
     const regex = new RegExp(`^\\s*(?<type>${keywordPattern})\\b\\s+(?<contents>.+)$`, 'gim');
     return regex;
 }
@@ -22410,9 +22414,13 @@ function createCommitmentRegex(commitment) {
  *
  * @private
  */
-function createCommitmentTypeRegex(commitment) {
-    const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    const keywordPattern = escapedCommitment.split(/\s+/).join('\\s+');
+function createCommitmentTypeRegex(commitment, aliases = []) {
+    const allCommitments = [commitment, ...aliases];
+    const patterns = allCommitments.map((c) => {
+        const escapedCommitment = c.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return escapedCommitment.split(/\s+/).join('\\s+');
+    });
+    const keywordPattern = patterns.join('|');
     const regex = new RegExp(`^\\s*(?<type>${keywordPattern})\\b`, 'gim');
     return regex;
 }
@@ -22424,22 +22432,23 @@ function createCommitmentTypeRegex(commitment) {
  * @private
  */
 class BaseCommitmentDefinition {
-    constructor(type) {
+    constructor(type, aliases = []) {
         this.type = type;
+        this.aliases = aliases;
     }
     /**
      * Creates a regex pattern to match this commitment in agent source
      * Uses the existing createCommitmentRegex function as internal helper
      */
     createRegex() {
-        return createCommitmentRegex(this.type);
+        return createCommitmentRegex(this.type, this.aliases);
     }
     /**
      * Creates a regex pattern to match just the commitment type
      * Uses the existing createCommitmentTypeRegex function as internal helper
      */
     createTypeRegex() {
-        return createCommitmentTypeRegex(this.type);
+        return createCommitmentTypeRegex(this.type, this.aliases);
     }
     /**
      * Helper method to create a new requirements object with updated system message
@@ -23351,6 +23360,165 @@ class MetaCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * META COLOR commitment definition
+ *
+ * The META COLOR commitment sets the agent's accent color.
+ * 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 COLOR #ff0000
+ * META COLOR #00ff00
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('META COLOR', ['COLOR']);
+    }
+    /**
+     * Short one-line description of META COLOR.
+     */
+    get description() {
+        return "Set the agent's accent color.";
+    }
+    /**
+     * Markdown documentation for META COLOR commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # META COLOR
+
+            Sets the agent's accent color.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - Only one \`META COLOR\` should be used per agent.
+            - If multiple are specified, the last one takes precedence.
+            - Used for visual representation in user interfaces.
+
+            ## Examples
+
+            \`\`\`book
+            Professional Assistant
+
+            META COLOR #3498db
+            PERSONA You are a professional business assistant
+            \`\`\`
+
+            \`\`\`book
+            Creative Helper
+
+            META COLOR #e74c3c
+            PERSONA You are a creative and inspiring assistant
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // META COLOR doesn't modify the system message or model requirements
+        // It's handled separately in the parsing logic for profile color extraction
+        // This method exists for consistency with the CommitmentDefinition interface
+        return requirements;
+    }
+    /**
+     * Extracts the profile color from the content
+     * This is used by the parsing logic
+     */
+    extractProfileColor(content) {
+        const trimmedContent = content.trim();
+        return trimmedContent || null;
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * META IMAGE commitment definition
+ *
+ * The META IMAGE commitment sets the agent's avatar/profile image URL.
+ * 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 IMAGE https://example.com/avatar.jpg
+ * META IMAGE /assets/agent-avatar.png
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('META IMAGE', ['IMAGE']);
+    }
+    /**
+     * Short one-line description of META IMAGE.
+     */
+    get description() {
+        return "Set the agent's profile image URL.";
+    }
+    /**
+     * Markdown documentation for META IMAGE commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # META IMAGE
+
+            Sets the agent's avatar/profile image URL.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - Only one \`META IMAGE\` should be used per agent.
+            - If multiple are specified, the last one takes precedence.
+            - Used for visual representation in user interfaces.
+
+            ## Examples
+
+            \`\`\`book
+            Professional Assistant
+
+            META IMAGE https://example.com/professional-avatar.jpg
+            PERSONA You are a professional business assistant
+            STYLE Maintain a formal and courteous tone
+            \`\`\`
+
+            \`\`\`book
+            Creative Helper
+
+            META IMAGE /assets/creative-bot-avatar.png
+            PERSONA You are a creative and inspiring assistant
+            STYLE Be enthusiastic and encouraging
+            ACTION Can help with brainstorming and ideation
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // META IMAGE doesn't modify the system message or model requirements
+        // It's handled separately in the parsing logic for profile image extraction
+        // This method exists for consistency with the CommitmentDefinition interface
+        return requirements;
+    }
+    /**
+     * Extracts the profile image URL from the content
+     * This is used by the parsing logic
+     */
+    extractProfileImageUrl(content) {
+        const trimmedContent = content.trim();
+        return trimmedContent || null;
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * MODEL commitment definition
  *
@@ -24258,6 +24426,8 @@ const COMMITMENT_REGISTRY = [
     new ModelCommitmentDefinition('MODELS'),
     new ActionCommitmentDefinition('ACTION'),
     new ActionCommitmentDefinition('ACTIONS'),
+    new MetaImageCommitmentDefinition(),
+    new MetaColorCommitmentDefinition(),
     new MetaCommitmentDefinition(),
     new NoteCommitmentDefinition('NOTE'),
     new NoteCommitmentDefinition('NOTES'),
@@ -24710,6 +24880,14 @@ function parseAgentSource(agentSource) {
             links.push(spaceTrim(commitment.content));
             continue;
         }
+        if (commitment.type === 'META IMAGE') {
+            meta.image = spaceTrim(commitment.content);
+            continue;
+        }
+        if (commitment.type === 'META COLOR') {
+            meta.color = spaceTrim(commitment.content);
+            continue;
+        }
         if (commitment.type !== 'META') {
             continue;
         }
@@ -24725,6 +24903,10 @@ function parseAgentSource(agentSource) {
     if (!meta.image) {
         meta.image = generatePlaceholderAgentProfileImageUrl(parseResult.agentName || '!!');
     }
+    // Generate fullname fallback if no meta fullname specified
+    if (!meta.fullname) {
+        meta.fullname = parseResult.agentName || createDefaultAgentName(agentSource);
+    }
     // Parse parameters using unified approach - both @Parameter and {parameter} notations
     // are treated as the same syntax feature with unified representation
     const parameters = parseParameters(agentSource);