@promptbook/cli 0.103.0-46 → 0.103.0-48

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

@@ -0,0 +1,131 @@
+
+-- 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 "EnvironmentVariable" (
+    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    "key" TEXT NOT NULL,
+    "value" TEXT NOT NULL,
+    "note" TEXT NULL,
+    CONSTRAINT EnvironmentVariable_key_key UNIQUE ("key")
+);
+
+
+CREATE TABLE IF NOT EXISTS "Agent" (
+    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    "agentName" TEXT NOT NULL,
+    
+
+    "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+    "updatedAt" TIMESTAMP WITH TIME ZONE NULL DEFAULT NULL,
+
+
+    "agentHash" TEXT NOT NULL,
+    "agentSource" TEXT NOT NULL,
+    "agentProfile" JSONB NOT NULL,   
+    "promptbookEngineVersion" TEXT NOT NULL,
+   
+    "usage" JSONB NULL,
+    "preparedModelRequirements" JSONB NULL,
+    "preparedExternals" JSONB NULL
+);
+-- Ensure uniqueness of agentName even on repeated schema application without duplicate constraint creation
+CREATE UNIQUE INDEX IF NOT EXISTS agent_agentname_key ON "Agent" ("agentName");
+COMMENT ON COLUMN "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 "Agent"."agentHash" IS 'The hash of the `agentSource`, automatically updated on `agentSource` change';
+COMMENT ON COLUMN "Agent"."agentSource" IS 'The source code of the agent';
+COMMENT ON COLUMN "Agent"."agentProfile" IS 'The profile of the agent generated from the `agentSource`, automatically updated on `agentSource` change <- TODO: [🕛]';
+COMMENT ON COLUMN "Agent"."promptbookEngineVersion" IS 'The version of the Promptbook engine used for last update of the agent';
+COMMENT ON COLUMN "Agent"."usage" IS 'Usage and spending statistics for the agent';
+COMMENT ON COLUMN "Agent"."preparedModelRequirements" IS 'The prepared model requirements for the agent, generated from the `agentSource` but not after every change (only on explicit request), there is `agentHash` to identify the version of the `agentSource` this was prepared from';
+COMMENT ON COLUMN "Agent"."preparedExternals" IS 'The prepared externals for the agent, generated from the `agentSource` but not after every change (only on explicit request), there is `agentHash` to identify the version of the `agentSource` this was prepared from';
+
+
+CREATE TABLE IF NOT EXISTS "AgentHistory" (
+    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+
+    "agentName" TEXT NOT NULL,
+    "agentHash" TEXT NOT NULL,
+    "previousAgentHash" TEXT NULL,
+    "agentSource" TEXT NOT NULL,
+    "promptbookEngineVersion" TEXT NOT NULL
+    
+);
+
+CREATE INDEX IF NOT EXISTS "AgentHistory_agentName_idx" ON "AgentHistory" ("agentName");
+CREATE INDEX IF NOT EXISTS "AgentHistory_agentHash_idx" ON "AgentHistory" ("agentHash");
+
+
+CREATE TABLE IF NOT EXISTS "ChatHistory" (
+    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY NOT NULL,
+    "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+
+    "messageHash" TEXT NOT NULL,
+    "previousMessageHash" TEXT NULL,
+    "agentName" TEXT NOT NULL,
+    "agentHash" TEXT NOT NULL,
+    "message" JSONB NOT NULL,
+
+    -- Telemetry:
+    "promptbookEngineVersion" TEXT NULL,
+    "url" TEXT NULL,
+    "ip" TEXT NULL,
+    "userAgent" TEXT NULL,
+    "language" TEXT NULL,
+    "platform" TEXT NULL
+);
+COMMENT ON COLUMN "ChatHistory"."url" IS 'The URL where the chat was happening';
+COMMENT ON COLUMN "ChatHistory"."ip" IS 'The IP address of the user';
+COMMENT ON COLUMN "ChatHistory"."userAgent" IS 'The user agent (browser) of the user';
+COMMENT ON COLUMN "ChatHistory"."language" IS 'The language (from the browser) of the user';
+COMMENT ON COLUMN "ChatHistory"."platform" IS 'The platform of the user';
+
+
+CREATE TABLE IF NOT EXISTS "ChatFeedback" (
+    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+
+    "agentName" TEXT NOT NULL,
+    "agentHash" TEXT NOT NULL,
+    "rating" TEXT NULL,
+    "textRating" TEXT NULL,
+    "chatThread" TEXT NULL,
+    "userNote" TEXT NULL,
+    "expectedAnswer" TEXT NULL,
+
+    -- Telemetry:
+    "promptbookEngineVersion" TEXT NULL,
+    "url" TEXT NULL,
+    "ip" TEXT NULL,
+    "userAgent" TEXT NULL,
+    "language" TEXT NULL,
+    "platform" TEXT NULL
+);
+COMMENT ON COLUMN "ChatFeedback"."url" IS 'The URL where the chat was happening';
+COMMENT ON COLUMN "ChatFeedback"."ip" IS 'The IP address of the user';
+COMMENT ON COLUMN "ChatFeedback"."userAgent" IS 'The user agent (browser) of the user';
+COMMENT ON COLUMN "ChatFeedback"."language" IS 'The language (from the browser) of the user';
+COMMENT ON COLUMN "ChatFeedback"."platform" IS 'The platform of the user';
+
+
+/*
+CREATE TABLE IF NOT EXISTS "AgentActionHistory" (
+id BIGINT GENERATED BY DEFAULT AS IDENTITY NOT NULL,
+createdAt TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+
+);
+*/
+
+
+/*
+CREATE TABLE IF NOT EXISTS "Xxx" (
+id BIGINT GENERATED BY DEFAULT AS IDENTITY NOT NULL,
+);
+*/
+
+
+-- TODO: !!!! Create propper database migrations

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

@@ -0,0 +1,217 @@
+/**
+ * AUTO-GENERATED TYPES FROM `schema.sql`
+ * Source of truth: `schema.sql` *(do not edit table structure here manually)*
+ *
+ * [💽] Prompt:
+ * Re-generate supabase typescript schema from the `./schema.sql`
+ */
+
+// Json helper (Supabase style)
+export type Json = string | number | boolean | null | { [key: string]: Json | undefined } | Json[];
+
+// Public schema database interface (Supabase convention)
+export type AgentsServerDatabase = {
+    public: {
+        Tables: {
+            EnvironmentVariable: {
+                Row: {
+                    id: number;
+                    key: string;
+                    value: string;
+                    note: string | null;
+                };
+                Insert: {
+                    id?: number;
+                    key: string;
+                    value: string;
+                    note?: string | null;
+                };
+                Update: {
+                    id?: number;
+                    key?: string;
+                    value?: string;
+                    note?: string | null;
+                };
+                Relationships: [];
+            };
+            Agent: {
+                Row: {
+                    id: number;
+                    agentName: string;
+                    createdAt: string;
+                    updatedAt: string | null;
+                    agentHash: string;
+                    agentSource: string;
+                    agentProfile: Json;
+                    promptbookEngineVersion: string;
+                    usage: Json | null;
+                    preparedModelRequirements: Json | null;
+                    preparedExternals: Json | null;
+                };
+                Insert: {
+                    id?: number;
+                    agentName: string;
+                    createdAt: string;
+                    updatedAt?: string | null;
+                    agentHash: string;
+                    agentSource: string;
+                    agentProfile: Json;
+                    promptbookEngineVersion: string;
+                    usage?: Json | null;
+                    preparedModelRequirements?: Json | null;
+                    preparedExternals?: Json | null;
+                };
+                Update: {
+                    id?: number;
+                    agentName?: string;
+                    createdAt?: string;
+                    updatedAt?: string | null;
+                    agentHash?: string;
+                    agentSource?: string;
+                    agentProfile?: Json;
+                    promptbookEngineVersion?: string;
+                    usage?: Json | null;
+                    preparedModelRequirements?: Json | null;
+                    preparedExternals?: Json | null;
+                };
+                Relationships: [];
+            };
+            AgentHistory: {
+                Row: {
+                    id: number;
+                    createdAt: string;
+                    agentName: string;
+                    agentHash: string;
+                    previousAgentHash: string | null;
+                    agentSource: string;
+                    promptbookEngineVersion: string;
+                };
+                Insert: {
+                    id?: number;
+                    createdAt: string;
+                    agentName: string;
+                    agentHash: string;
+                    previousAgentHash?: string | null;
+                    agentSource: string;
+                    promptbookEngineVersion: string;
+                };
+                Update: {
+                    id?: number;
+                    createdAt?: string;
+                    agentName?: string;
+                    agentHash?: string;
+                    previousAgentHash?: string | null;
+                    agentSource?: string;
+                    promptbookEngineVersion?: string;
+                };
+                Relationships: [];
+            };
+            ChatHistory: {
+                Row: {
+                    id: number;
+                    createdAt: string;
+                    messageHash: string;
+                    previousMessageHash: string | null;
+                    agentName: string;
+                    agentHash: string;
+                    message: Json;
+                    promptbookEngineVersion: string | null;
+                    url: string | null;
+                    ip: string | null;
+                    userAgent: string | null;
+                    language: string | null;
+                    platform: string | null;
+                };
+                Insert: {
+                    id?: number;
+                    createdAt: string;
+                    messageHash: string;
+                    previousMessageHash?: string | null;
+                    agentName: string;
+                    agentHash: string;
+                    message: Json;
+                    promptbookEngineVersion?: string | null;
+                    url?: string | null;
+                    ip?: string | null;
+                    userAgent?: string | null;
+                    language?: string | null;
+                    platform?: string | null;
+                };
+                Update: {
+                    id?: number;
+                    createdAt?: string;
+                    messageHash?: string;
+                    previousMessageHash?: string | null;
+                    agentName?: string;
+                    agentHash?: string;
+                    message?: Json;
+                    promptbookEngineVersion?: string | null;
+                    url?: string | null;
+                    ip?: string | null;
+                    userAgent?: string | null;
+                    language?: string | null;
+                    platform?: string | null;
+                };
+                Relationships: [];
+            };
+            ChatFeedback: {
+                Row: {
+                    id: number;
+                    createdAt: string;
+                    agentName: string;
+                    agentHash: string;
+                    rating: string | null;
+                    textRating: string | null;
+                    chatThread: string | null;
+                    userNote: string | null;
+                    expectedAnswer: string | null;
+                    promptbookEngineVersion: string | null;
+                    url: string | null;
+                    ip: string | null;
+                    userAgent: string | null;
+                    language: string | null;
+                    platform: string | null;
+                };
+                Insert: {
+                    id?: number;
+                    createdAt: string;
+                    agentName: string;
+                    agentHash: string;
+                    rating?: string | null;
+                    textRating?: string | null;
+                    chatThread?: string | null;
+                    userNote?: string | null;
+                    expectedAnswer?: string | null;
+                    promptbookEngineVersion?: string | null;
+                    url?: string | null;
+                    ip?: string | null;
+                    userAgent?: string | null;
+                    language?: string | null;
+                    platform?: string | null;
+                };
+                Update: {
+                    id?: number;
+                    createdAt?: string;
+                    agentName?: string;
+                    agentHash?: string;
+                    rating?: string | null;
+                    textRating?: string | null;
+                    chatThread?: string | null;
+                    userNote?: string | null;
+                    expectedAnswer?: string | null;
+                    promptbookEngineVersion?: string | null;
+                    url?: string | null;
+                    ip?: string | null;
+                    userAgent?: string | null;
+                    language?: string | null;
+                    platform?: string | null;
+                };
+                Relationships: [];
+            };
+        };
+        Views: Record<string, never>;
+        Functions: Record<string, never>;
+        Enums: Record<string, never>;
+        CompositeTypes: Record<string, never>;
+    };
+};

package/apps/agents-server/src/tools/$provideAgentCollectionForServer.ts

@@ -2,10 +2,11 @@
 
 import { AgentCollectionInSupabase } from '@promptbook-local/core';
 import { AgentCollection } from '@promptbook-local/types';
-import { getSupabaseForServer } from '../supabase/getSupabaseForServer';
+import { $provideSupabaseForServer } from '../database/$provideSupabaseForServer';
 
 /**
  * Cache of provided agent collection
+ *
  * @private internal cache for `$provideAgentCollectionForServer`
  */
 let agentCollection: null | AgentCollection = null;
@@ -39,7 +40,7 @@ export async function $provideAgentCollectionForServer(): Promise<AgentCollectio
     });
     */
 
-    const supabase = getSupabaseForServer();
+    const supabase = $provideSupabaseForServer();
 
     agentCollection = new AgentCollectionInSupabase(supabase, {
         isVerbose,

package/apps/agents-server/src/tools/$provideCdnForServer.ts

@@ -0,0 +1,28 @@
+import { DigitalOceanSpaces } from '../utils/cdn/classes/DigitalOceanSpaces';
+import { IIFilesStorageWithCdn } from '../utils/cdn/interfaces/IFilesStorage';
+
+/**
+ * Cache of CDN instance
+ *
+ * @private internal cache for `$provideCdnForServer`
+ */
+let cdn: IIFilesStorageWithCdn | null = null;
+
+/**
+ * !!!
+ */
+export function $provideCdnForServer(): IIFilesStorageWithCdn {
+    if (!cdn) {
+        cdn = new DigitalOceanSpaces({
+            bucket: process.env.CDN_BUCKET!,
+            pathPrefix: process.env.NEXT_PUBLIC_CDN_PATH_PREFIX!,
+            endpoint: process.env.CDN_ENDPOINT!,
+            accessKeyId: process.env.CDN_ACCESS_KEY_ID!,
+            secretAccessKey: process.env.CDN_SECRET_ACCESS_KEY!,
+            cdnPublicUrl: new URL(process.env.NEXT_PUBLIC_CDN_PUBLIC_URL!),
+            gzip: true,
+        });
+    }
+
+    return cdn;
+}

package/apps/agents-server/src/tools/$provideOpenAiAssistantExecutionToolsForServer.ts

@@ -26,7 +26,7 @@ export async function $provideOpenAiAssistantExecutionToolsForServer(): Promise<
 
     executionTools = new OpenAiAssistantExecutionTools({
         apiKey: process.env.OPENAI_API_KEY,
-        assistantId: '!!!! null',
+        assistantId: 'abstract_assistant', // <- TODO: !!!! In `OpenAiAssistantExecutionTools` Allow to create abstract assistants with `isCreatingNewAssistantsAllowed`
         isCreatingNewAssistantsAllowed: true,
         isVerbose,
     });

package/apps/agents-server/src/utils/cdn/classes/DigitalOceanSpaces.ts

@@ -0,0 +1,119 @@
+import { GetObjectCommand, PutObjectCommand, PutObjectCommandInput, S3Client } from '@aws-sdk/client-s3';
+import { NotYetImplementedError } from '@promptbook-local/core';
+import { gzip, ungzip } from 'node-gzip';
+import { TODO_USE } from '../../../../../../src/utils/organization/TODO_USE';
+import { validateMimeType } from '../../validators/validateMimeType';
+import type { IFile, IIFilesStorageWithCdn } from '../interfaces/IFilesStorage';
+
+type IDigitalOceanSpacesConfig = {
+    readonly bucket: string;
+    readonly pathPrefix: string;
+    readonly endpoint: string;
+    readonly accessKeyId: string;
+    readonly secretAccessKey: string;
+    readonly cdnPublicUrl: URL;
+    readonly gzip: boolean;
+
+    // TODO: [⛳️] Probbably prefix should be in this config not on the consumer side
+};
+
+export class DigitalOceanSpaces implements IIFilesStorageWithCdn {
+    public get cdnPublicUrl() {
+        return this.config.cdnPublicUrl;
+    }
+
+    private s3: S3Client;
+
+    public constructor(private readonly config: IDigitalOceanSpacesConfig) {
+        this.s3 = new S3Client({
+            region: 'auto',
+            endpoint: 'https://' + config.endpoint,
+            credentials: {
+                accessKeyId: config.accessKeyId,
+                secretAccessKey: config.secretAccessKey,
+            },
+        });
+    }
+
+    public getItemUrl(key: string): URL {
+        return new URL(this.config.pathPrefix + '/' + key, this.cdnPublicUrl);
+    }
+
+    public async getItem(key: string): Promise<IFile | null> {
+        const parameters = {
+            Bucket: this.config.bucket,
+            Key: this.config.pathPrefix + '/' + key,
+        };
+
+        try {
+            const { Body, ContentType, ContentEncoding } = await this.s3.send(new GetObjectCommand(parameters));
+
+            // const blob = new Blob([await Body?.transformToByteArray()!]);
+
+            if (ContentEncoding === 'gzip') {
+                return {
+                    type: validateMimeType(ContentType),
+                    data: await ungzip(await Body!.transformToByteArray()),
+                };
+            } else {
+                return {
+                    type: validateMimeType(ContentType),
+                    data: (await Body!.transformToByteArray()) as Buffer,
+                };
+            }
+        } catch (error) {
+            if (error instanceof Error && error.name.match(/^NoSuchKey/)) {
+                return null;
+            } else {
+                throw error;
+            }
+        }
+    }
+
+    public async removeItem(key: string): Promise<void> {
+        TODO_USE(key);
+        throw new NotYetImplementedError(`DigitalOceanSpaces.removeItem is not implemented yet`);
+    }
+
+    public async setItem(key: string, file: IFile): Promise<void> {
+        // TODO: Put putObjectRequestAdditional into processedFile
+        const putObjectRequestAdditional: Partial<PutObjectCommandInput> = {};
+
+        let processedFile: IFile;
+        if (this.config.gzip) {
+            const gzipped = await gzip(file.data);
+            const sizePercentageAfterCompression = gzipped.byteLength / file.data.byteLength;
+            if (sizePercentageAfterCompression < 0.7) {
+                // consolex.log(`Gzipping ${key} (${Math.floor(sizePercentageAfterCompression * 100)}%)`);
+                processedFile = { ...file, data: gzipped };
+                putObjectRequestAdditional.ContentEncoding = 'gzip';
+            } else {
+                processedFile = file;
+                // consolex.log(`NOT Gzipping ${key} (${Math.floor(sizePercentageAfterCompression * 100)}%)`);
+            }
+        } else {
+            processedFile = file;
+        }
+
+        const uploadResult = await this.s3.send(
+            new PutObjectCommand({
+                Bucket: this.config.bucket,
+                Key: this.config.pathPrefix + '/' + key,
+                ContentType: processedFile.type,
+                ...putObjectRequestAdditional,
+                Body: processedFile.data,
+                // TODO: Public read access / just private to extending class
+                ACL: 'public-read',
+            }),
+        );
+
+        if (!uploadResult.ETag) {
+            throw new Error(`Upload result does not contain ETag`);
+        }
+    }
+}
+
+/**
+ * TODO: Implement Read-only mode
+ * TODO: [☹️] Unite with `PromptbookStorage` and move to `/src/...`
+ */

package/apps/agents-server/src/utils/cdn/interfaces/IFilesStorage.ts

@@ -0,0 +1,32 @@
+import type { string_mime_type } from '../../../../../../src/types/typeAliases';
+import type { IStorage } from './IStorage';
+
+export type IFile = {
+    // Maybe TODO name: string_name;
+    type: string_mime_type;
+    data: Buffer;
+};
+
+/**
+ * Represents storage that will store each keypair in a separate file.
+ */
+export type IFilesStorage = Omit<IStorage<IFile>, 'length' | 'clear' | 'key'>;
+
+/**
+ * Represents storage that can give public deterministic  URL for each file
+ */
+export type IIFilesStorageWithCdn = IFilesStorage & {
+    readonly cdnPublicUrl: URL;
+    getItemUrl(key: string): URL;
+};
+
+/**
+ * TODO: Probably not deterministic and async getItemUrl
+ * TODO: Probably just createUrlMaker
+ * TODO: List method
+ * TODO: Glob method
+ * TODO: Subfolder (similar to PrefixStorage) method
+ * TODO: Subscribe, list, sub(folder) should be part of LIB everstorage
+ * TODO: Probably implement observe through RxJS
+ * TODO: [☹️] Unite with `PromptbookStorage` and move to `/src/...`
+ */

package/apps/agents-server/src/utils/cdn/interfaces/IStorage.ts

@@ -0,0 +1,14 @@
+// Note: This is a simplified version of the IStorage interface based on the usage in the project.
+export type IStorage<T> = {
+    readonly length: Promise<number>;
+    clear(): Promise<void>;
+    getItem(key: string): Promise<T | null>;
+    key(index: number): Promise<string | null>;
+    removeItem(key: string): Promise<void>;
+    setItem(key: string, value: T): Promise<void>;
+};
+
+
+/**
+ * TODO: [☹️] Unite with `PromptbookStorage` and move to `/src/...`
+ */

package/apps/agents-server/src/utils/cdn/utils/getUserFileCdnKey.ts

@@ -0,0 +1,28 @@
+import hexEncoder from 'crypto-js/enc-hex';
+import sha256 from 'crypto-js/sha256';
+import type { string_uri } from '../../../../../../src/types/typeAliases';
+import { titleToName } from '../../../../../../src/utils/normalization/titleToName';
+import { nameToSubfolderPath } from './nameToSubfolderPath';
+
+/**
+ * Generates a path for the user content
+ */
+export function getUserFileCdnKey(file: Buffer, originalFilename: string): string_uri {
+    const hash = sha256(hexEncoder.parse(file.toString('hex'))).toString(/* hex */);
+    //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
+
+    const originalFilenameParts = originalFilename.split('.');
+    const extension = originalFilenameParts.pop();
+    const name = titleToName(originalFilenameParts.join('.'));
+
+    const filename = name + '.' + extension;
+    // <- Note: [⛳️] Preserving original file name
+
+    return `user/files/${nameToSubfolderPath(hash).join('/')}/${filename}`;
+}
+
+/**
+ * TODO: [🌍] Unite this logic in one place
+ * TODO: Way to garbage unused uploaded files
+ * TODO: Probably separate util countBufferHash
+ */

package/apps/agents-server/src/utils/cdn/utils/nameToSubfolderPath.ts

@@ -0,0 +1,9 @@
+import type { string_name } from '../../../../../../src/types/typeAliases';
+
+export function nameToSubfolderPath(name: string_name): Array<string> {
+    return [name.substr(0, 2).toLowerCase(), name.substr(2, 5).toLowerCase()];
+}
+
+/**
+ * TODO: !!! Use `nameToSubfolderPath` from src
+ */

package/apps/agents-server/src/utils/cdn/utils/nextRequestToNodeRequest.ts

@@ -0,0 +1,27 @@
+import { TODO_any } from '@promptbook-local/types';
+import { NextRequest } from 'next/server';
+import { Readable } from 'node:stream';
+
+export async function nextRequestToNodeRequest(nextRequest: NextRequest): Promise<Readable> {
+    const reader = nextRequest.body?.getReader();
+
+    if (!reader) {
+        throw new Error(`Can not get nextRequest.body.getReader()`);
+    }
+
+    const nodeStream = new Readable({
+        async read() {
+            const { done, value } = await reader.read();
+            if (done) this.push(null);
+            else this.push(Buffer.from(value));
+        },
+    });
+
+    // Fake IncomingMessage with headers
+    (nodeStream as TODO_any).headers = Object.fromEntries(nextRequest.headers.entries());
+    (nodeStream as TODO_any).method = nextRequest.method;
+    (nodeStream as TODO_any).url = nextRequest.url;
+    (nodeStream as TODO_any).socket = {}; // required by formidable
+
+    return nodeStream;
+}

package/apps/agents-server/src/utils/validators/validateMimeType.ts

@@ -0,0 +1,24 @@
+import type { string_mime_type } from '../../../../../src/types/typeAliases';
+
+/**
+ * Checks if the value is valid mime-type
+ *
+ * @param value candidate for mime-type
+ * @returns the value if it is valid mime-type
+ * @throws TypeError if the value is not valid mime-type
+ */
+export function validateMimeType(value: unknown): string_mime_type {
+    if (typeof value !== 'string') {
+        throw new TypeError(`Mime-type must be string, but it is ${typeof value}`);
+    }
+
+    if (!/^[a-z]+\/(?:[a-z0-9]+[.-])*[a-z0-9]+$/i.test(value)) {
+        throw new TypeError(`Invalid mime-type "${value}"`);
+    }
+
+    return value as string_mime_type;
+}
+
+/**
+ * TODO: [🧠] Move to main Promptbook utils
+ */

package/apps/agents-server/tsconfig.json

@@ -24,6 +24,6 @@
             "@promptbook-local/*": ["../../src/_packages/*.index"]
         }
     },
-    "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+    "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", "../_common/hooks/usePromise.ts"],
     "exclude": ["node_modules"]
 }