@promptbook/cli 0.104.0-3 → 0.104.0-4

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-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/message-providers/email/_common/Email.ts

@@ -0,0 +1,73 @@
+import type { Message, string_email, string_person_fullname } from '@promptbook-local/types';
+
+/**
+ * Single email which was received by the application
+ */
+export type InboundEmail = Email & { direction: 'INBOUND' };
+
+/**
+ * Single email which was sended from the application
+ */
+export type OutboundEmail = Email & { direction: 'OUTBOUND' };
+
+/**
+ * Single email
+ */
+type Email = Message<string_email> & {
+    /**
+     * Channel of the message
+     *
+     * @default 'EMAIL'
+     */
+    readonly channel?: 'EMAIL';
+
+    /**
+     * Carbon copy email addresses
+     *
+     * Note: Not working with BCC (Blind Carbon Copy) because we want to have all emails in the same thread
+     *       and for hidden emails we can just call $sendEmail multiple times
+     */
+    readonly cc: Array<EmailAddress>;
+
+    /**
+     * Email subject
+     */
+    readonly subject: string;
+
+    /**
+     * Email attachments
+     */
+    readonly attachments: Array<File>;
+};
+
+export type EmailAddress = {
+    /**
+     * Everything outside of `<>` in email address
+     *
+     * @example "Pavol Hejný <pavol@hejny.cz>" -> "Pavol Hejný"
+     * @example "\"Pavol Hejný\" <pavol@hejny.cz>" -> "Pavol Hejný"
+     */
+    fullName: string_person_fullname | string | null;
+
+    /**
+     * Everything after `+` in email address
+     *
+     * @example "pavol+spam@webgpt.cz" -> ["spam"]
+     * @example "pavol+spam+debug@webgpt.cz" -> ["spam","debug"]
+     */
+    plus: Array<string>;
+
+    /**
+     * Pure email address
+     *
+     * @example "pavol@webgpt.cz"
+     */
+    baseEmail: string_email;
+
+    /**
+     * Full email address without the name but with +
+     *
+     * @example "pavol+test@webgpt.cz"
+     */
+    fullEmail: string_email;
+};

package/apps/agents-server/src/message-providers/email/_common/utils/TODO.txt

@@ -0,0 +1 @@
+TODO: [🧠][🏰] Maybe move all of theese functions into `@promptbook/utils`

package/apps/agents-server/src/message-providers/email/_common/utils/parseEmailAddress.test.ts.todo

@@ -0,0 +1,108 @@
+import { describe, expect, it } from '@jest/globals';
+import { parseEmailAddress } from './parseEmailAddress';
+
+describe('how parseEmailAddress works', () => {
+    it('should work with simple email', () => {
+        expect(parseEmailAddress('pavol@webgpt.cz')).toEqual({
+            fullName: null,
+            baseEmail: 'pavol@webgpt.cz',
+            fullEmail: 'pavol@webgpt.cz',
+            plus: [],
+        });
+        expect(parseEmailAddress('jirka@webgpt.cz')).toEqual({
+            fullName: null,
+            baseEmail: 'jirka@webgpt.cz',
+            fullEmail: 'jirka@webgpt.cz',
+            plus: [],
+        });
+        expect(parseEmailAddress('tomas@webgpt.cz')).toEqual({
+            fullName: null,
+            baseEmail: 'tomas@webgpt.cz',
+            fullEmail: 'tomas@webgpt.cz',
+            plus: [],
+        });
+    });
+
+    it('should work with fullname', () => {
+        expect(parseEmailAddress('Pavol Hejný <pavol@webgpt.cz>')).toEqual({
+            fullName: 'Pavol Hejný',
+            baseEmail: 'pavol@webgpt.cz',
+            fullEmail: 'pavol@webgpt.cz',
+            plus: [],
+        });
+        expect(parseEmailAddress('Jirka <jirka@webgpt.cz>')).toEqual({
+            fullName: 'Jirka',
+            baseEmail: 'jirka@webgpt.cz',
+            fullEmail: 'jirka@webgpt.cz',
+            plus: [],
+        });
+        expect(parseEmailAddress('"Tomáš Studeník" <tomas@webgpt.cz>')).toEqual({
+            fullName: 'Tomáš Studeník',
+            baseEmail: 'tomas@webgpt.cz',
+            fullEmail: 'tomas@webgpt.cz',
+            plus: [],
+        });
+    });
+
+    it('should work with plus', () => {
+        expect(parseEmailAddress('pavol+test@webgpt.cz')).toEqual({
+            fullName: null,
+            baseEmail: 'pavol@webgpt.cz',
+            fullEmail: 'pavol+test@webgpt.cz',
+            plus: ['test'],
+        });
+        expect(parseEmailAddress('jirka+test@webgpt.cz')).toEqual({
+            fullName: null,
+            baseEmail: 'jirka@webgpt.cz',
+            fullEmail: 'jirka+test@webgpt.cz',
+            plus: ['test'],
+        });
+        expect(parseEmailAddress('tomas+test+ainautes@webgpt.cz')).toEqual({
+            fullName: null,
+            baseEmail: 'tomas@webgpt.cz',
+            fullEmail: 'tomas+test+ainautes@webgpt.cz',
+            plus: ['test', 'ainautes'],
+        });
+    });
+
+    it('should work with both fullname and plus', () => {
+        expect(parseEmailAddress('Pavol Hejný <pavol+foo@webgpt.cz>')).toEqual({
+            fullName: 'Pavol Hejný',
+            baseEmail: 'pavol@webgpt.cz',
+            fullEmail: 'pavol+foo@webgpt.cz',
+            plus: ['foo'],
+        });
+        expect(parseEmailAddress('Jirka <jirka+test@webgpt.cz>')).toEqual({
+            fullName: 'Jirka',
+            baseEmail: 'jirka@webgpt.cz',
+            fullEmail: 'jirka+test@webgpt.cz',
+            plus: ['test'],
+        });
+        expect(parseEmailAddress('"Tomáš Studeník" <tomas+test+ainautes@webgpt.cz>')).toEqual({
+            fullName: 'Tomáš Studeník',
+            baseEmail: 'tomas@webgpt.cz',
+            fullEmail: 'tomas+test+ainautes@webgpt.cz',
+            plus: ['test', 'ainautes'],
+        });
+    });
+
+    it('throws on multiple adresses', () => {
+        expect(() => parseEmailAddress('Pavol <pavol@webgpt.cz>, Jirka <jirka@webgpt.cz>')).toThrowError(
+            /Seems like you are trying to parse multiple email addresses/,
+        );
+    });
+
+    it('throws on invalid email adresses', () => {
+        expect(() => parseEmailAddress('')).toThrowError(/Invalid email address/);
+        expect(() => parseEmailAddress('Pavol Hejný')).toThrowError(/Invalid email address/);
+        expect(() => parseEmailAddress('Pavol Hejný <>')).toThrowError(/Invalid email address/);
+        expect(() => parseEmailAddress('Pavol Hejný <@webgpt.cz>')).toThrowError(/Invalid email address/);
+        expect(() => parseEmailAddress('Pavol Hejný <webgpt.cz>')).toThrowError(/Invalid email address/);
+        expect(() => parseEmailAddress('Pavol Hejný <pavol@>')).toThrowError(/Invalid email address/);
+        expect(() => parseEmailAddress('Pavol Hejný <a@b>')).toThrowError(/Invalid email address/);
+    });
+});
+
+/**
+ * TODO: [🐫] This test fails because of aliased imports `import type { string_emails } from '@promptbook-local/types';`, fix it
+ */

package/apps/agents-server/src/message-providers/email/_common/utils/parseEmailAddress.ts

@@ -0,0 +1,62 @@
+import type { string_email } from '@promptbook-local/types';
+import { isValidEmail, spaceTrim } from '@promptbook-local/utils';
+import { EmailAddress } from '../Email';
+
+/**
+ * Parses the email address into its components
+ */
+export function parseEmailAddress(value: string_email): EmailAddress {
+    if (value.includes(',')) {
+        throw new Error('Seems like you are trying to parse multiple email addresses, use parseEmailAddresses instead');
+    }
+
+    let fullName = value.match(/^(?:"?([^"]+)"?|[^<]+)\s*</)?.[1] ?? null;
+
+    if (fullName !== null) {
+        fullName = fullName.trim();
+    }
+
+    const fullEmail = value.match(/<([^>]+)>/)?.[1] ?? value;
+    const plus: Array<string> = [];
+
+    if (!isValidEmail(fullEmail)) {
+        throw new Error(
+            spaceTrim(
+                (block) => `
+                    Invalid email address "${fullEmail}"
+
+                    Parsed:
+                    ${block(JSON.stringify({ fullName, fullEmail, plus }, null, 4))}
+                
+                `,
+            ),
+        );
+    }
+
+    if (fullEmail.includes('+')) {
+        const [user, domain] = fullEmail.split('@');
+
+        if (!user || !domain) {
+            throw new Error('Can not parse email address');
+            //               <- TODO: ShouldNeverHappenError
+        }
+
+        const userParts = user.split('+');
+        userParts.shift();
+
+        plus.push(...userParts);
+    }
+
+    let baseEmail = fullEmail;
+
+    for (const plusItem of plus) {
+        baseEmail = baseEmail.replace(`+${plusItem}`, '');
+    }
+
+    return {
+        fullName,
+        baseEmail,
+        fullEmail,
+        plus,
+    };
+}

package/apps/agents-server/src/message-providers/email/_common/utils/parseEmailAddresses.test.ts.todo

@@ -0,0 +1,117 @@
+import { describe, expect, it } from '@jest/globals';
+import { parseEmailAddresses } from './parseEmailAddresses';
+
+describe('how parseEmailAddresses works', () => {
+    it('should work with single email', () => {
+        expect(parseEmailAddresses('pavol@webgpt.cz')).toEqual([
+            {
+                fullName: null,
+                baseEmail: 'pavol@webgpt.cz',
+                fullEmail: 'pavol@webgpt.cz',
+                plus: [],
+            },
+        ]);
+    });
+
+    it('should work with simple emails', () => {
+        expect(parseEmailAddresses('pavol@webgpt.cz, jirka@webgpt.cz, tomas@webgpt.cz')).toEqual([
+            {
+                fullName: null,
+                baseEmail: 'pavol@webgpt.cz',
+                fullEmail: 'pavol@webgpt.cz',
+                plus: [],
+            },
+            {
+                fullName: null,
+                baseEmail: 'jirka@webgpt.cz',
+                fullEmail: 'jirka@webgpt.cz',
+                plus: [],
+            },
+            {
+                fullName: null,
+                baseEmail: 'tomas@webgpt.cz',
+                fullEmail: 'tomas@webgpt.cz',
+                plus: [],
+            },
+        ]);
+    });
+
+    it('should work with fullname', () => {
+        expect(
+            parseEmailAddresses(
+                'Pavol Hejný <pavol@webgpt.cz>, Jirka <jirka@webgpt.cz>, "Tomáš Studeník" <tomas@webgpt.cz>',
+            ),
+        ).toEqual([
+            {
+                fullName: 'Pavol Hejný',
+                baseEmail: 'pavol@webgpt.cz',
+                fullEmail: 'pavol@webgpt.cz',
+                plus: [],
+            },
+            {
+                fullName: 'Jirka',
+                baseEmail: 'jirka@webgpt.cz',
+                fullEmail: 'jirka@webgpt.cz',
+                plus: [],
+            },
+            {
+                fullName: 'Tomáš Studeník',
+                baseEmail: 'tomas@webgpt.cz',
+                fullEmail: 'tomas@webgpt.cz',
+                plus: [],
+            },
+        ]);
+    });
+
+    it('not confused by comma', () => {
+        expect(parseEmailAddresses(', pavol@webgpt.cz, ')).toEqual([
+            {
+                fullName: null,
+                fullEmail: 'pavol@webgpt.cz',
+                baseEmail: 'pavol@webgpt.cz',
+                plus: [],
+            },
+        ]);
+    });
+
+    it('works on real-life example', () => {
+        expect(
+            parseEmailAddresses(
+                '"bob" <bob@bot.webgpt.cz>, "pavolto" <pavol+to@ptbk.io>, "Pavol" <pavol@collboard.com>',
+            ),
+        ).toEqual([
+            {
+                fullName: 'bob',
+                fullEmail: 'bob@bot.webgpt.cz',
+                baseEmail: 'bob@bot.webgpt.cz',
+                plus: [],
+            },
+            {
+                fullName: 'pavolto',
+                fullEmail: 'pavol+to@ptbk.io',
+                baseEmail: 'pavol@ptbk.io',
+                plus: ['to'],
+            },
+            {
+                fullName: 'Pavol',
+                fullEmail: 'pavol@collboard.com',
+                baseEmail: 'pavol@collboard.com',
+                plus: [],
+            },
+        ]);
+    });
+
+    it('throws on invalid email adresses', () => {
+        expect(() => parseEmailAddresses('Pavol, Hejný')).toThrowError(/Invalid email address/);
+        expect(() => parseEmailAddresses('Pavol Hejný <>')).toThrowError(/Invalid email address/);
+        expect(() => parseEmailAddresses('Pavol Hejný, <@webgpt.cz>')).toThrowError(/Invalid email address/);
+        expect(() => parseEmailAddresses('Pavol Hejný <webgpt.cz>')).toThrowError(/Invalid email address/);
+        expect(() => parseEmailAddresses('Pavol Hejný <pavol@>')).toThrowError(/Invalid email address/);
+        expect(() => parseEmailAddresses('Pavol Hejný <a@b>,')).toThrowError(/Invalid email address/);
+    });
+});
+
+
+/**
+ * TODO: [🐫] This test fails because of aliased imports `import type { string_emails } from '@promptbook-local/types';`, fix it
+ */

package/apps/agents-server/src/message-providers/email/_common/utils/parseEmailAddresses.ts

@@ -0,0 +1,19 @@
+import type { string_emails } from '@promptbook-local/types';
+import { spaceTrim } from 'spacetrim';
+import type { EmailAddress } from '../Email';
+import { parseEmailAddress } from './parseEmailAddress';
+
+/**
+ * Parses the email addresses into its components
+ */
+export function parseEmailAddresses(value: string_emails): Array<EmailAddress> {
+    const emailAddresses = value
+        .split(',')
+        .map((email) => spaceTrim(email))
+        .filter((email) => email !== '')
+        .map((email) => parseEmailAddress(email));
+
+    // console.log('parseEmailAddresses', value, '->', emailAddresses);
+
+    return emailAddresses;
+}

package/apps/agents-server/src/message-providers/email/_common/utils/stringifyEmailAddress.test.ts.todo

@@ -0,0 +1,119 @@
+import { describe, expect, it } from '@jest/globals';
+import { stringifyEmailAddress } from './stringifyEmailAddress';
+
+describe('how stringifyEmailAddress works', () => {
+    it('should work with simple email', () => {
+        expect(
+            stringifyEmailAddress({
+                fullName: null,
+                baseEmail: 'pavol@webgpt.cz',
+                fullEmail: 'pavol@webgpt.cz',
+                plus: [],
+            }),
+        ).toBe('pavol@webgpt.cz');
+        expect(
+            stringifyEmailAddress({
+                fullName: null,
+                baseEmail: 'jirka@webgpt.cz',
+                fullEmail: 'jirka@webgpt.cz',
+                plus: [],
+            }),
+        ).toBe('jirka@webgpt.cz');
+        expect(
+            stringifyEmailAddress({
+                fullName: null,
+                baseEmail: 'tomas@webgpt.cz',
+                fullEmail: 'tomas@webgpt.cz',
+                plus: [],
+            }),
+        ).toBe('tomas@webgpt.cz');
+    });
+
+    it('should work with fullname', () => {
+        expect(
+            stringifyEmailAddress({
+                fullName: 'Pavol Hejný',
+                baseEmail: 'pavol@webgpt.cz',
+                fullEmail: 'pavol@webgpt.cz',
+                plus: [],
+            }),
+        ).toBe('"Pavol Hejný" <pavol@webgpt.cz>');
+        expect(
+            stringifyEmailAddress({
+                fullName: 'Jirka',
+                baseEmail: 'jirka@webgpt.cz',
+                fullEmail: 'jirka@webgpt.cz',
+                plus: [],
+            }),
+        ).toBe('"Jirka" <jirka@webgpt.cz>');
+        expect(
+            stringifyEmailAddress({
+                fullName: 'Tomáš Studeník',
+                baseEmail: 'tomas@webgpt.cz',
+                fullEmail: 'tomas@webgpt.cz',
+                plus: [],
+            }),
+        ).toBe('"Tomáš Studeník" <tomas@webgpt.cz>');
+    });
+
+    it('should work with plus', () => {
+        expect(
+            stringifyEmailAddress({
+                fullName: null,
+                baseEmail: 'pavol@webgpt.cz',
+                fullEmail: 'pavol+test@webgpt.cz',
+                plus: ['test'],
+            }),
+        ).toBe('pavol+test@webgpt.cz');
+        expect(
+            stringifyEmailAddress({
+                fullName: null,
+                baseEmail: 'jirka@webgpt.cz',
+                fullEmail: 'jirka+test@webgpt.cz',
+                plus: ['test'],
+            }),
+        ).toBe('jirka+test@webgpt.cz');
+        expect(
+            stringifyEmailAddress({
+                fullName: null,
+                baseEmail: 'tomas@webgpt.cz',
+                fullEmail: 'tomas+test+ainautes@webgpt.cz',
+                plus: ['test', 'ainautes'],
+            }),
+        ).toBe('tomas+test+ainautes@webgpt.cz');
+    });
+
+    it('should work with both fullname and plus', () => {
+        expect(
+            stringifyEmailAddress({
+                fullName: 'Pavol Hejný',
+                baseEmail: 'pavol@webgpt.cz',
+                fullEmail: 'pavol+test@webgpt.cz',
+                plus: ['test'],
+            }),
+        ).toBe('"Pavol Hejný" <pavol+test@webgpt.cz>');
+        expect(
+            stringifyEmailAddress({
+                fullName: 'Jirka',
+                baseEmail: 'jirka@webgpt.cz',
+                fullEmail: 'jirka+test@webgpt.cz',
+                plus: ['test'],
+            }),
+        ).toBe('"Jirka" <jirka+test@webgpt.cz>');
+        expect(
+            stringifyEmailAddress({
+                fullName: 'Tomáš Studeník',
+                baseEmail: 'tomas@webgpt.cz',
+                fullEmail: 'tomas+test+ainautes@webgpt.cz',
+                plus: ['test', 'ainautes'],
+            }),
+        ).toBe('"Tomáš Studeník" <tomas+test+ainautes@webgpt.cz>');
+    });
+
+    // TODO: [🎾] Implement and test here escaping
+});
+
+
+/**
+ * TODO: [🐫] This test fails because of aliased imports `import type { string_emails } from '@promptbook-local/types';`, fix it
+ */

package/apps/agents-server/src/message-providers/email/_common/utils/stringifyEmailAddress.ts

@@ -0,0 +1,19 @@
+import type { string_email } from '@promptbook-local/types';
+import type { EmailAddress } from '../Email';
+
+/**
+ * Makes string email from EmailAddress
+ */
+export function stringifyEmailAddress(emailAddress: EmailAddress): string_email {
+    const { fullEmail, fullName } = emailAddress;
+
+    if (fullName !== null) {
+        return `"${fullName}" <${fullEmail}>`;
+    }
+
+    return fullEmail;
+}
+
+/**
+ * TODO: [🎾] Implement and test here escaping
+ */