@promptbook/cli 0.104.0-1 → 0.104.0-11

package/apps/agents-server/src/components/_utils/generateMetaTxt.ts

@@ -1,26 +1,28 @@
 // Utility to generate content for robots.txt, security.txt, and humans.txt [DRY]
 
-import { NEXT_PUBLIC_SITE_URL } from '@/config';
+import { $provideServer } from '@/src/tools/$provideServer';
 
-// Get base URL from environment or config
-const baseUrl = NEXT_PUBLIC_SITE_URL?.href || process.env.PUBLIC_URL || 'https://ptbk.io';
-
-export function generateRobotsTxt(): string {
-    return ['User-agent: *', `Sitemap: ${baseUrl}sitemap.xml`, ''].join('\n');
+export async function generateRobotsTxt(): Promise<string> {
+    const { publicUrl } = await $provideServer();
+    return ['User-agent: *', `Sitemap: ${publicUrl.href}sitemap.xml`, ''].join('\n');
 }
 
-export function generateSecurityTxt(): string {
+export async function generateSecurityTxt(): Promise<string> {
+    const { publicUrl } = await $provideServer();
     // See https://securitytxt.org/ for more fields
     return [
         `Contact: mailto:security@ptbk.io`,
         `Expires: ${new Date(Date.now() + 365 * 24 * 60 * 60 * 1000).toISOString().split('T')[0]}`,
-        `Canonical: ${baseUrl}security.txt`,
+        `Canonical: ${publicUrl.href}security.txt`,
         '',
     ].join('\n');
 }
 
-export function generateHumansTxt(): string {
-    return ['/* TEAM */', 'Developer: Promptbook Team', `Site: https://ptbk.io`, `Instance: ${baseUrl}`].join('\n');
+export async function generateHumansTxt(): Promise<string> {
+    const { publicUrl } = await $provideServer();
+    return ['/* TEAM */', 'Developer: Promptbook Team', `Site: https://ptbk.io`, `Instance: ${publicUrl.href}`].join(
+        '\n',
+    );
 }
 
 /**

package/apps/agents-server/src/components/_utils/headlessParam.tsx

@@ -1,6 +1,6 @@
 // Utility to append ?headless param if present in current URL
-import { usePathname, useSearchParams } from 'next/navigation';
 import Link, { LinkProps } from 'next/link';
+import { useSearchParams } from 'next/navigation';
 import { useMemo } from 'react';
 
 // Returns true if ?headless is present in current search params
@@ -18,7 +18,11 @@ export function appendHeadlessParam(href: string, isHeadless: boolean): string {
 }
 
 // Custom Link that preserves headless param
-export function HeadlessLink({ href, children, ...rest }: LinkProps & { children: React.ReactNode } & React.AnchorHTMLAttributes<HTMLAnchorElement>) {
+export function HeadlessLink({
+    href,
+    children,
+    ...rest
+}: LinkProps & { children: React.ReactNode } & React.AnchorHTMLAttributes<HTMLAnchorElement>) {
     const isHeadless = useIsHeadless();
     const finalHref = useMemo(() => appendHeadlessParam(String(href), isHeadless), [href, isHeadless]);
     return (
@@ -28,7 +32,7 @@ export function HeadlessLink({ href, children, ...rest }: LinkProps & { children
     );
 }
 
-import { useRouter } from "next/navigation";
+import { useRouter } from 'next/navigation';
 
 // Helper for router.push
 export function pushWithHeadless(router: ReturnType<typeof useRouter>, href: string, isHeadless: boolean) {

package/apps/agents-server/src/database/$getTableName.ts

@@ -15,4 +15,5 @@ type string_table_name = keyof AgentsServerDatabase['public']['Tables'];
 export async function $getTableName<TTable extends string_table_name>(tableName: TTable): Promise<TTable> {
     const { tablePrefix } = await $provideServer();
     return `${tablePrefix}${tableName}` as TTable;
+    // <- TODO: [🏧] DRY
 }

package/apps/agents-server/src/database/$provideSupabaseForBrowser.ts

@@ -1,6 +1,6 @@
-import { AgentsDatabaseSchema } from '@promptbook-local/types';
 import { $isRunningInBrowser } from '@promptbook-local/utils';
 import { createClient, SupabaseClient } from '@supabase/supabase-js';
+import { AgentsServerDatabase } from './schema';
 
 /**
  * Internal cache for `$provideSupabaseForBrowser`
@@ -8,7 +8,7 @@ import { createClient, SupabaseClient } from '@supabase/supabase-js';
  * @private
  * @singleton
  */
-let supabase: SupabaseClient<AgentsDatabaseSchema>;
+let supabase: SupabaseClient<AgentsServerDatabase>;
 
 /**
  * Get supabase client
@@ -27,7 +27,7 @@ export function $provideSupabaseForBrowser(): typeof supabase {
 
     if (!supabase) {
         // Create a single supabase client for interacting with your database
-        supabase = createClient<AgentsDatabaseSchema>(
+        supabase = createClient<AgentsServerDatabase>(
             process.env.NEXT_PUBLIC_SUPABASE_URL!,
             process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
         );

package/apps/agents-server/src/database/$provideSupabaseForServer.ts

@@ -18,7 +18,7 @@ let supabase: SupabaseClient<AgentsServerDatabase>;
  *
  * @returns instance of supabase client
  */
-export function $provideSupabaseForServer(): typeof supabase {
+export function $provideSupabaseForServer(): SupabaseClient<AgentsServerDatabase> {
     if (!$isRunningInNode()) {
         throw new Error(
             'Function `$provideSupabaseForServer` can not be used in browser, use `$provideSupabaseForBrowser` instead.',

package/apps/agents-server/src/database/$provideSupabaseForWorker.ts

@@ -1,6 +1,6 @@
-import { AgentsDatabaseSchema } from '@promptbook-local/types';
 import { $isRunningInWebWorker } from '@promptbook-local/utils';
 import { createClient, SupabaseClient } from '@supabase/supabase-js';
+import { AgentsServerDatabase } from './schema';
 
 /**
  * Internal cache for `$provideSupabaseForWorker`
@@ -8,7 +8,7 @@ import { createClient, SupabaseClient } from '@supabase/supabase-js';
  * @private
  * @singleton
  */
-let supabase: SupabaseClient<AgentsDatabaseSchema>;
+let supabase: SupabaseClient<AgentsServerDatabase>;
 
 /**
  * Get supabase client
@@ -27,7 +27,7 @@ export function $provideSupabaseForWorker(): typeof supabase {
 
     if (!supabase) {
         // Create a single supabase client for interacting with your database
-        supabase = createClient<AgentsDatabaseSchema>(
+        supabase = createClient<AgentsServerDatabase>(
             process.env.NEXT_PUBLIC_SUPABASE_URL!,
             process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
         );

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

@@ -38,7 +38,13 @@ export const metadataDefaults = [
         type: 'TEXT',
     },
     {
-        key: 'IS_VOICE_CALLING_ENABLED',
+        key: 'SHOW_FEDERATED_SERVERS_PUBLICLY',
+        value: 'false',
+        note: 'Whether to show federated servers and their agents to anonymous users. When false, federated servers are only visible to authenticated users.',
+        type: 'BOOLEAN',
+    },
+    {
+        key: 'IS_EXPERIMENTAL_VOICE_CALLING_ENABLED',
         value: 'false',
         note: 'Enable or disable voice calling features for agents. When disabled, voice API endpoints will return 403 Forbidden.',
         type: 'BOOLEAN',
@@ -67,6 +73,18 @@ export const metadataDefaults = [
         note: 'Language for generating new agent names. Possible values: ENGLISH, CZECH.',
         type: 'TEXT_SINGLE_LINE',
     },
+    {
+        key: 'ADMIN_EMAIL',
+        value: 'support@ptbk.io',
+        note: 'Administrator email address used for password reset and user registration requests.',
+        type: 'TEXT_SINGLE_LINE',
+    },
+    {
+        key: 'DEFAULT_AGENT_VISIBILITY',
+        value: 'PRIVATE',
+        note: 'Default visibility for new agents. Can be PUBLIC or PRIVATE.',
+        type: 'TEXT_SINGLE_LINE',
+    },
 ] as const satisfies ReadonlyArray<{
     key: string;
     value: string;

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/migrations/2025-12-0830-image-purpose.sql

@@ -0,0 +1,5 @@
+ALTER TABLE "prefix_Image" ADD COLUMN "agentId" BIGINT REFERENCES "prefix_Agent"("id") ON DELETE CASCADE;
+ALTER TABLE "prefix_Image" ADD COLUMN "purpose" TEXT CHECK ("purpose" IN ('AVATAR', 'TESTING'));
+
+COMMENT ON COLUMN "prefix_Image"."agentId" IS 'The agent this image belongs to (nullable for testing images)';
+COMMENT ON COLUMN "prefix_Image"."purpose" IS 'The purpose of the image (AVATAR or TESTING)';

package/apps/agents-server/src/database/migrations/2025-12-0890-file-agent-id.sql

@@ -0,0 +1,5 @@
+-- Add agentId column to associate files with agents
+ALTER TABLE "prefix_File" ADD COLUMN IF NOT EXISTS "agentId" INTEGER NULL;
+
+-- Add foreign key constraint to Agent table
+ALTER TABLE "prefix_File" ADD CONSTRAINT "File_agentId_fkey" FOREIGN KEY ("agentId") REFERENCES "prefix_Agent" ("id") ON DELETE SET NULL;