@promptbook/cli 0.104.0-1 → 0.104.0-10

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

@@ -8,13 +8,34 @@ dotenv.config();
 async function migrate() {
     console.info('🚀 Starting database migration');
 
+    // Parse CLI arguments for --only flag
+    const args = process.argv.slice(2);
+    let onlyPrefixes: string[] | null = null;
+
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--only' && args[i + 1]) {
+            onlyPrefixes = args[i + 1]
+                .split(',')
+                .map((p) => p.trim())
+                .filter((p) => p !== '');
+            break;
+        } else if (args[i]?.startsWith('--only=')) {
+            onlyPrefixes = args[i]
+                .substring('--only='.length)
+                .split(',')
+                .map((p) => p.trim())
+                .filter((p) => p !== '');
+            break;
+        }
+    }
+
     // 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
+    let prefixes = prefixesEnv
         .split(',')
         .map((p) => p.trim())
         .filter((p) => p !== '');
@@ -24,6 +45,18 @@ async function migrate() {
         return;
     }
 
+    // Filter prefixes if --only flag is provided
+    if (onlyPrefixes !== null) {
+        const invalidPrefixes = onlyPrefixes.filter((p) => !prefixes.includes(p));
+        if (invalidPrefixes.length > 0) {
+            console.error(`❌ Invalid prefixes specified in --only: ${invalidPrefixes.join(', ')}`);
+            console.error(`   Available prefixes: ${prefixes.join(', ')}`);
+            process.exit(1);
+        }
+        prefixes = onlyPrefixes;
+        console.info(`🎯 Running migrations only for: ${prefixes.join(', ')}`);
+    }
+
     const connectionString = process.env.POSTGRES_URL || process.env.DATABASE_URL;
     if (!connectionString) {
         console.error('❌ POSTGRES_URL or DATABASE_URL is not defined.');

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

@@ -1,6 +1,4 @@
--- 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_Agent" (

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

@@ -1,6 +1,4 @@
--- 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" (

package/apps/agents-server/src/database/migrations/2025-12-0240-agent-public-id.sql

@@ -0,0 +1,3 @@
+
+ALTER TABLE "prefix_Agent" ADD COLUMN "permanentId" TEXT;
+CREATE UNIQUE INDEX "prefix_Agent_permanentId_key" ON "prefix_Agent"("permanentId");

package/apps/agents-server/src/database/migrations/2025-12-0360-agent-deleted-at.sql

@@ -0,0 +1 @@
+ALTER TABLE "prefix_Agent" ADD COLUMN "deletedAt" TEXT;

package/apps/agents-server/src/database/migrations/2025-12-0370-image-table.sql

@@ -0,0 +1,19 @@
+CREATE TABLE IF NOT EXISTS "prefix_Image" (
+    "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(),
+
+    "filename" TEXT NOT NULL,
+    "prompt" TEXT NOT NULL,
+    "cdnUrl" TEXT NOT NULL,
+    "cdnKey" TEXT NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS "prefix_Image_filename_idx" ON "prefix_Image" ("filename");
+
+ALTER TABLE "prefix_Image" ENABLE ROW LEVEL SECURITY;
+
+COMMENT ON COLUMN "prefix_Image"."filename" IS 'The original filename requested (e.g., cat-sitting-on-keyboard.png)';
+COMMENT ON COLUMN "prefix_Image"."prompt" IS 'The normalized prompt used to generate the image';
+COMMENT ON COLUMN "prefix_Image"."cdnUrl" IS 'The full URL of the uploaded image in CDN';
+COMMENT ON COLUMN "prefix_Image"."cdnKey" IS 'The key used to identify the image in CDN storage';

package/apps/agents-server/src/database/migrations/2025-12-0380-agent-visibility.sql

@@ -0,0 +1 @@
+ALTER TABLE "prefix_Agent" ADD COLUMN "visibility" TEXT NOT NULL DEFAULT 'PRIVATE' CHECK ("visibility" IN ('PUBLIC', 'PRIVATE'));

package/apps/agents-server/src/database/migrations/2025-12-0390-upload-tracking.sql

@@ -0,0 +1,20 @@
+CREATE TABLE IF NOT EXISTS "prefix_File" (
+    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+    
+    "userId" BIGINT REFERENCES "prefix_User"("id"),
+    "fileName" TEXT NOT NULL,
+    "fileSize" BIGINT NOT NULL,
+    "fileType" TEXT NOT NULL,
+    "cdnUrl" TEXT NOT NULL,
+    "purpose" TEXT NOT NULL
+);
+
+ALTER TABLE "prefix_File" ENABLE ROW LEVEL SECURITY;
+
+COMMENT ON COLUMN "prefix_File"."userId" IS 'Reference to the user who uploaded the file';
+COMMENT ON COLUMN "prefix_File"."fileName" IS 'Original name of the uploaded file';
+COMMENT ON COLUMN "prefix_File"."fileSize" IS 'Size of the file in bytes';
+COMMENT ON COLUMN "prefix_File"."fileType" IS 'MIME type of the file';
+COMMENT ON COLUMN "prefix_File"."cdnUrl" IS 'Public URL of the file in CDN';
+COMMENT ON COLUMN "prefix_File"."purpose" IS 'Purpose of the upload (e.g. KNOWLEDGE, SERVER_FAVICON_URL)';

package/apps/agents-server/src/database/migrations/2025-12-0401-file-upload-status.sql

@@ -0,0 +1,13 @@
+-- Add status column to track file upload progress
+ALTER TABLE "prefix_File" ADD COLUMN IF NOT EXISTS "status" TEXT NOT NULL DEFAULT 'COMPLETED';
+
+-- Add check constraint for valid status values
+-- ALTER TABLE "prefix_File" ADD CONSTRAINT "File_status_check" CHECK ("status" IN ('UPLOADING', 'COMPLETED', 'FAILED'));
+
+-- Drop the column cdnUrl if it exists
+ALTER TABLE "prefix_File" DROP COLUMN IF EXISTS "cdnUrl";
+
+
+-- Add nullable columns storageUrl and shortUrl 
+ALTER TABLE "prefix_File" ADD COLUMN IF NOT EXISTS "storageUrl" TEXT NULL;
+ALTER TABLE "prefix_File" ADD COLUMN IF NOT EXISTS "shortUrl" TEXT NULL;

package/apps/agents-server/src/database/migrations/2025-12-0402-message-table.sql

@@ -0,0 +1,42 @@
+
+-- Table: Message
+CREATE TABLE IF NOT EXISTS "prefix_Message" (
+    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+    "channel" TEXT NOT NULL,
+    "direction" TEXT NOT NULL,
+    "sender" JSONB NOT NULL,
+    "recipients" JSONB,
+    "content" TEXT NOT NULL,
+    "threadId" TEXT,
+    "metadata" JSONB
+);
+
+COMMENT ON TABLE "prefix_Message" IS 'A generic message structure for various communication channels';
+COMMENT ON COLUMN "prefix_Message"."channel" IS 'The communication channel of the message (e.g. EMAIL, PROMPTBOOK_CHAT)';
+COMMENT ON COLUMN "prefix_Message"."direction" IS 'Is the message send from the Promptbook or to the Promptbook';
+COMMENT ON COLUMN "prefix_Message"."sender" IS 'Who sent the message';
+COMMENT ON COLUMN "prefix_Message"."recipients" IS 'Who are the recipients of the message';
+COMMENT ON COLUMN "prefix_Message"."content" IS 'The content of the message as markdown';
+COMMENT ON COLUMN "prefix_Message"."threadId" IS 'The thread identifier the message belongs to';
+
+
+-- Table: MessageSendAttempt
+CREATE TABLE IF NOT EXISTS "prefix_MessageSendAttempt" (
+    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+    
+    "messageId" BIGINT NOT NULL REFERENCES "prefix_Message"("id") ON DELETE CASCADE,
+    "providerName" TEXT NOT NULL,
+    "isSuccessful" BOOLEAN NOT NULL,
+    "raw" JSONB
+);
+
+COMMENT ON TABLE "prefix_MessageSendAttempt" IS 'Stores each attempt to send the message';
+COMMENT ON COLUMN "prefix_MessageSendAttempt"."messageId" IS 'The message that was attempted to be sent';
+COMMENT ON COLUMN "prefix_MessageSendAttempt"."providerName" IS 'The name of the provider used for sending';
+COMMENT ON COLUMN "prefix_MessageSendAttempt"."isSuccessful" IS 'Whether the attempt was successful';
+COMMENT ON COLUMN "prefix_MessageSendAttempt"."raw" IS 'Raw response or error from the provider';
+
+ALTER TABLE "prefix_Message" ENABLE ROW LEVEL SECURITY;
+ALTER TABLE "prefix_MessageSendAttempt" ENABLE ROW LEVEL SECURITY;

package/apps/agents-server/src/database/migrations/2025-12-0403-generation-lock-table.sql

@@ -0,0 +1,15 @@
+CREATE TABLE IF NOT EXISTS "prefix_GenerationLock" (
+    "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(),
+    "lockKey" TEXT NOT NULL,
+    "expiresAt" TIMESTAMP WITH TIME ZONE NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS "prefix_GenerationLock_lockKey_idx" ON "prefix_GenerationLock" ("lockKey");
+
+ALTER TABLE "prefix_GenerationLock" ENABLE ROW LEVEL SECURITY;
+
+COMMENT ON TABLE "prefix_GenerationLock" IS 'Locks to prevent concurrent expensive operations like image generation';
+COMMENT ON COLUMN "prefix_GenerationLock"."lockKey" IS 'Unique key for the lock (e.g. agent-avatar-<hash>)';
+COMMENT ON COLUMN "prefix_GenerationLock"."expiresAt" IS 'When the lock expires and can be overridden';

package/apps/agents-server/src/database/migrations/2025-12-0640-openai-assistant-cache.sql

@@ -0,0 +1,12 @@
+CREATE TABLE IF NOT EXISTS "prefix_OpenAiAssistantCache" (
+    "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(),
+
+    "agentHash" TEXT NOT NULL,
+    "assistantId" TEXT NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS "prefix_OpenAiAssistantCache_agentHash_idx" ON "prefix_OpenAiAssistantCache" ("agentHash");
+
+ALTER TABLE "prefix_OpenAiAssistantCache" ENABLE ROW LEVEL SECURITY;

package/apps/agents-server/src/database/migrations/2025-12-0820-agent-history-permanent-id.sql

@@ -0,0 +1,29 @@
+-- Backfill permanentId in Agent table if missing
+UPDATE "prefix_Agent"
+SET "permanentId" = gen_random_uuid()::text
+WHERE "permanentId" IS NULL;
+
+-- Add permanentId column to AgentHistory
+ALTER TABLE "prefix_AgentHistory" ADD COLUMN "permanentId" TEXT;
+
+-- Backfill permanentId from Agent table
+UPDATE "prefix_AgentHistory" ah
+SET "permanentId" = a."permanentId"
+FROM "prefix_Agent" a
+WHERE ah."agentName" = a."agentName";
+
+-- Make permanentId NOT NULL
+ALTER TABLE "prefix_AgentHistory" ALTER COLUMN "permanentId" SET NOT NULL;
+
+-- Drop old foreign key on agentName
+ALTER TABLE "prefix_AgentHistory" DROP CONSTRAINT "prefix_AgentHistory_agentName_fkey";
+
+-- Add new foreign key on permanentId referencing Agent(permanentId)
+ALTER TABLE "prefix_AgentHistory"
+    ADD CONSTRAINT "prefix_AgentHistory_permanentId_fkey"
+    FOREIGN KEY ("permanentId")
+    REFERENCES "prefix_Agent"("permanentId")
+    ON DELETE CASCADE;
+
+-- Add index for permanentId
+CREATE INDEX "prefix_AgentHistory_permanentId_idx" ON "prefix_AgentHistory" ("permanentId");

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

@@ -3,7 +3,7 @@
  * Source of truth: `schema.sql` *(do not edit table structure here manually)*
  *
  * [💽] Prompt:
- * Re-generate supabase typescript schema from the `./schema.sql`
+ * Re-generate supabase typescript schema from `./migrations/*.sql`
  */
 
 // Json helper (Supabase style)
@@ -47,6 +47,7 @@ export type AgentsServerDatabase = {
                     agentName: string;
                     createdAt: string;
                     updatedAt: string | null;
+                    permanentId: string | null;
                     agentHash: string;
                     agentSource: string;
                     agentProfile: Json;
@@ -54,12 +55,15 @@ export type AgentsServerDatabase = {
                     usage: Json | null;
                     preparedModelRequirements: Json | null;
                     preparedExternals: Json | null;
+                    deletedAt: string | null;
+                    visibility: 'PUBLIC' | 'PRIVATE';
                 };
                 Insert: {
                     id?: number;
                     agentName: string;
                     createdAt: string;
                     updatedAt?: string | null;
+                    permanentId?: string | null;
                     agentHash: string;
                     agentSource: string;
                     agentProfile: Json;
@@ -67,12 +71,15 @@ export type AgentsServerDatabase = {
                     usage?: Json | null;
                     preparedModelRequirements?: Json | null;
                     preparedExternals?: Json | null;
+                    deletedAt?: string | null;
+                    visibility?: 'PUBLIC' | 'PRIVATE';
                 };
                 Update: {
                     id?: number;
                     agentName?: string;
                     createdAt?: string;
                     updatedAt?: string | null;
+                    permanentId?: string | null;
                     agentHash?: string;
                     agentSource?: string;
                     agentProfile?: Json;
@@ -80,6 +87,8 @@ export type AgentsServerDatabase = {
                     usage?: Json | null;
                     preparedModelRequirements?: Json | null;
                     preparedExternals?: Json | null;
+                    deletedAt?: string | null;
+                    visibility?: 'PUBLIC' | 'PRIVATE';
                 };
                 Relationships: [];
             };
@@ -88,6 +97,7 @@ export type AgentsServerDatabase = {
                     id: number;
                     createdAt: string;
                     agentName: string;
+                    permanentId: string;
                     agentHash: string;
                     previousAgentHash: string | null;
                     agentSource: string;
@@ -97,6 +107,7 @@ export type AgentsServerDatabase = {
                     id?: number;
                     createdAt: string;
                     agentName: string;
+                    permanentId: string;
                     agentHash: string;
                     previousAgentHash?: string | null;
                     agentSource: string;
@@ -106,12 +117,20 @@ export type AgentsServerDatabase = {
                     id?: number;
                     createdAt?: string;
                     agentName?: string;
+                    permanentId?: string;
                     agentHash?: string;
                     previousAgentHash?: string | null;
                     agentSource?: string;
                     promptbookEngineVersion?: string;
                 };
-                Relationships: [];
+                Relationships: [
+                    {
+                        foreignKeyName: 'AgentHistory_permanentId_fkey';
+                        columns: ['permanentId'];
+                        referencedRelation: 'Agent';
+                        referencedColumns: ['permanentId'];
+                    },
+                ];
             };
             ChatHistory: {
                 Row: {
@@ -165,7 +184,14 @@ export type AgentsServerDatabase = {
                     source?: 'AGENT_PAGE_CHAT' | 'OPENAI_API_COMPATIBILITY' | null;
                     apiKey?: string | null;
                 };
-                Relationships: [];
+                Relationships: [
+                    {
+                        foreignKeyName: 'ChatHistory_agentName_fkey';
+                        columns: ['agentName'];
+                        referencedRelation: 'Agent';
+                        referencedColumns: ['agentName'];
+                    },
+                ];
             };
             ChatFeedback: {
                 Row: {
@@ -219,7 +245,14 @@ export type AgentsServerDatabase = {
                     language?: string | null;
                     platform?: string | null;
                 };
-                Relationships: [];
+                Relationships: [
+                    {
+                        foreignKeyName: 'ChatFeedback_agentName_fkey';
+                        columns: ['agentName'];
+                        referencedRelation: 'Agent';
+                        referencedColumns: ['agentName'];
+                    },
+                ];
             };
             User: {
                 Row: {
@@ -272,6 +305,30 @@ export type AgentsServerDatabase = {
                 };
                 Relationships: [];
             };
+            OpenAiAssistantCache: {
+                Row: {
+                    id: number;
+                    createdAt: string;
+                    updatedAt: string;
+                    agentHash: string;
+                    assistantId: string;
+                };
+                Insert: {
+                    id?: number;
+                    createdAt?: string;
+                    updatedAt?: string;
+                    agentHash: string;
+                    assistantId: string;
+                };
+                Update: {
+                    id?: number;
+                    createdAt?: string;
+                    updatedAt?: string;
+                    agentHash?: string;
+                    assistantId?: string;
+                };
+                Relationships: [];
+            };
             ApiTokens: {
                 Row: {
                     id: number;
@@ -299,6 +356,176 @@ export type AgentsServerDatabase = {
                 };
                 Relationships: [];
             };
+            GenerationLock: {
+                Row: {
+                    id: number;
+                    createdAt: string;
+                    updatedAt: string;
+                    lockKey: string;
+                    expiresAt: string;
+                };
+                Insert: {
+                    id?: number;
+                    createdAt?: string;
+                    updatedAt?: string;
+                    lockKey: string;
+                    expiresAt: string;
+                };
+                Update: {
+                    id?: number;
+                    createdAt?: string;
+                    updatedAt?: string;
+                    lockKey?: string;
+                    expiresAt?: string;
+                };
+                Relationships: [];
+            };
+            Image: {
+                Row: {
+                    id: number;
+                    createdAt: string;
+                    updatedAt: string;
+                    filename: string;
+                    prompt: string;
+                    cdnUrl: string;
+                    cdnKey: string;
+                };
+                Insert: {
+                    id?: number;
+                    createdAt?: string;
+                    updatedAt?: string;
+                    filename: string;
+                    prompt: string;
+                    cdnUrl: string;
+                    cdnKey: string;
+                };
+                Update: {
+                    id?: number;
+                    createdAt?: string;
+                    updatedAt?: string;
+                    filename?: string;
+                    prompt?: string;
+                    cdnUrl?: string;
+                    cdnKey?: string;
+                };
+                Relationships: [];
+            };
+            File: {
+                Row: {
+                    id: number;
+                    createdAt: string;
+                    userId: number | null;
+                    fileName: string;
+                    fileSize: number;
+                    fileType: string;
+                    storageUrl: string | null;
+                    shortUrl: string | null;
+                    purpose: string;
+                    status: 'UPLOADING' | 'COMPLETED' | 'FAILED';
+                };
+                Insert: {
+                    id?: number;
+                    createdAt?: string;
+                    userId?: number | null;
+                    fileName: string;
+                    fileSize: number;
+                    fileType: string;
+                    storageUrl?: string | null;
+                    shortUrl?: string | null;
+                    purpose: string;
+                    status?: 'UPLOADING' | 'COMPLETED' | 'FAILED';
+                };
+                Update: {
+                    id?: number;
+                    createdAt?: string;
+                    userId?: number | null;
+                    fileName?: string;
+                    fileSize?: number;
+                    fileType?: string;
+                    storageUrl?: string | null;
+                    shortUrl?: string | null;
+                    purpose?: string;
+                    status?: 'UPLOADING' | 'COMPLETED' | 'FAILED';
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: 'File_userId_fkey';
+                        columns: ['userId'];
+                        referencedRelation: 'User';
+                        referencedColumns: ['id'];
+                    },
+                ];
+            };
+            Message: {
+                Row: {
+                    id: number;
+                    createdAt: string;
+                    channel: string;
+                    direction: string;
+                    sender: Json;
+                    recipients: Json | null;
+                    content: string;
+                    threadId: string | null;
+                    metadata: Json | null;
+                };
+                Insert: {
+                    id?: number;
+                    createdAt?: string;
+                    channel: string;
+                    direction: string;
+                    sender: Json;
+                    recipients?: Json | null;
+                    content: string;
+                    threadId?: string | null;
+                    metadata?: Json | null;
+                };
+                Update: {
+                    id?: number;
+                    createdAt?: string;
+                    channel?: string;
+                    direction?: string;
+                    sender?: Json;
+                    recipients?: Json | null;
+                    content?: string;
+                    threadId?: string | null;
+                    metadata?: Json | null;
+                };
+                Relationships: [];
+            };
+            MessageSendAttempt: {
+                Row: {
+                    id: number;
+                    createdAt: string;
+                    messageId: number;
+                    providerName: string;
+                    isSuccessful: boolean;
+                    raw: Json | null;
+                };
+                Insert: {
+                    id?: number;
+                    createdAt?: string;
+                    messageId: number;
+                    providerName: string;
+                    isSuccessful: boolean;
+                    raw?: Json | null;
+                };
+                Update: {
+                    id?: number;
+                    createdAt?: string;
+                    messageId?: number;
+                    providerName?: string;
+                    isSuccessful?: boolean;
+                    raw?: Json | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: 'MessageSendAttempt_messageId_fkey';
+                        columns: ['messageId'];
+                        referencedRelation: 'Message';
+                        referencedColumns: ['id'];
+                    },
+                ];
+            };
         };
         Views: Record<string, never>;
         Functions: Record<string, never>;

package/apps/agents-server/src/generated/reservedPaths.ts

@@ -0,0 +1,32 @@
+/**
+ * Reserved paths that should not be treated as agent names.
+ * This file is auto-generated by scripts/generate-reserved-paths.js
+ *
+ * ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
+ *
+ * @see /apps/agents-server/src/app - source directory for routes
+ * @see /apps/agents-server/public - source directory for static files
+ * @see /apps/agents-server/src/middleware.ts - where this is used
+ */
+export const RESERVED_PATHS: readonly string[] = [
+    "_next",
+    "admin",
+    "agents",
+    "api",
+    "docs",
+    "embed",
+    "favicon.ico",
+    "fonts",
+    "humans.txt",
+    "logo-blue-white-256.png",
+    "manifest.webmanifest",
+    "recycle-bin",
+    "restricted",
+    "robots.txt",
+    "security.txt",
+    "sitemap.xml",
+    "sw.js",
+    "swagger",
+    "swagger.json",
+    "test"
+] as const;