@exulu/backend 1.46.1 → 1.48.1

package/mintlify-docs/styles.css

@@ -0,0 +1,207 @@
+/* Custom styles matching Exulu CI from frontend/app/globals.css */
+
+/* Root variables matching brand colors */
+:root {
+  --exulu-primary: hsl(257.9412, 100%, 60%);
+  --exulu-primary-light: hsl(257.9412, 100%, 68%);
+  --exulu-primary-dark: hsl(257.9412, 100%, 52%);
+  --exulu-accent: hsl(208.209, 100%, 73.7255%);
+  --exulu-radius: 0.4rem;
+}
+
+.dark {
+  --exulu-primary: hsl(257.6687, 100%, 68.0392%);
+  --exulu-primary-light: hsl(257.6687, 100%, 76%);
+  --exulu-primary-dark: hsl(257.6687, 100%, 60%);
+  --exulu-accent: hsl(208.209, 100%, 73.7255%);
+}
+
+/* Hero section gradients */
+.hero-gradient {
+  background: linear-gradient(135deg, var(--exulu-primary) 0%, var(--exulu-primary-dark) 100%);
+}
+
+.hero-gradient-light {
+  background: linear-gradient(135deg, var(--exulu-primary-light) 0%, var(--exulu-primary) 100%);
+}
+
+/* Feature cards with hover effects */
+.feature-card {
+  transition: all 0.3s ease;
+  border: 1px solid hsl(257.9412, 100%, 60%, 0.1);
+  border-radius: var(--exulu-radius);
+}
+
+.feature-card:hover {
+  transform: translateY(-4px);
+  box-shadow: 0 12px 24px hsl(257.9412, 100%, 60%, 0.15);
+  border-color: hsl(257.9412, 100%, 60%, 0.3);
+}
+
+/* Stats section */
+.stat-item {
+  text-align: center;
+  padding: 2rem;
+}
+
+.stat-number {
+  font-size: 3rem;
+  font-weight: 700;
+  background: linear-gradient(135deg, var(--exulu-primary) 0%, var(--exulu-primary-light) 100%);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+
+.stat-label {
+  font-size: 1rem;
+  color: #64748b;
+  margin-top: 0.5rem;
+}
+
+/* CTA buttons */
+.cta-primary {
+  background: linear-gradient(135deg, var(--exulu-primary) 0%, var(--exulu-primary-dark) 100%);
+  color: white;
+  padding: 1rem 2rem;
+  border-radius: var(--exulu-radius);
+  font-weight: 600;
+  text-decoration: none;
+  display: inline-block;
+  transition: all 0.3s ease;
+  box-shadow: 0 4px 6px hsl(257.9412, 100%, 60%, 0.2);
+}
+
+.cta-primary:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 6px 12px hsl(257.9412, 100%, 60%, 0.3);
+  color: white;
+}
+
+.cta-secondary {
+  background: transparent;
+  color: var(--exulu-primary);
+  padding: 1rem 2rem;
+  border-radius: var(--exulu-radius);
+  font-weight: 600;
+  text-decoration: none;
+  display: inline-block;
+  border: 2px solid var(--exulu-primary);
+  transition: all 0.3s ease;
+}
+
+.cta-secondary:hover {
+  background: hsl(257.9412, 100%, 60%, 0.1);
+  transform: translateY(-2px);
+}
+
+/* Section spacing */
+.section-padding {
+  padding: 4rem 0;
+}
+
+/* Badge styles */
+.badge {
+  display: inline-block;
+  padding: 0.5rem 1rem;
+  background: hsl(257.9412, 100%, 60%, 0.1);
+  color: var(--exulu-primary);
+  border-radius: 9999px;
+  font-size: 0.875rem;
+  font-weight: 600;
+  margin-bottom: 1rem;
+}
+
+/* Dark mode adjustments */
+.dark .stat-label {
+  color: #94a3b8;
+}
+
+.dark .feature-card {
+  border-color: hsl(257.6687, 100%, 68.0392%, 0.2);
+  background: rgba(15, 23, 42, 0.5);
+}
+
+.dark .feature-card:hover {
+  border-color: hsl(257.6687, 100%, 68.0392%, 0.4);
+  background: rgba(15, 23, 42, 0.8);
+}
+
+/* Testimonial styles */
+.testimonial {
+  padding: 2rem;
+  border-left: 4px solid var(--exulu-primary);
+  background: hsl(257.9412, 100%, 60%, 0.05);
+  border-radius: var(--exulu-radius);
+  margin: 1rem 0;
+}
+
+.dark .testimonial {
+  background: hsl(257.6687, 100%, 68.0392%, 0.1);
+}
+
+/* Logo showcase */
+.logo-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
+  gap: 2rem;
+  align-items: center;
+  justify-items: center;
+  padding: 2rem 0;
+  opacity: 0.6;
+}
+
+.logo-grid img {
+  max-width: 120px;
+  height: auto;
+  filter: grayscale(100%);
+  transition: all 0.3s ease;
+}
+
+.logo-grid img:hover {
+  filter: grayscale(0%);
+  opacity: 1;
+}
+
+/* Animated gradient text */
+.gradient-text {
+  background: linear-gradient(135deg, var(--exulu-primary) 0%, var(--exulu-primary-light) 50%, var(--exulu-primary) 100%);
+  background-size: 200% auto;
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+  animation: gradient 3s ease infinite;
+}
+
+@keyframes gradient {
+  0%, 100% {
+    background-position: 0% center;
+  }
+  50% {
+    background-position: 100% center;
+  }
+}
+
+/* Feature icons */
+.feature-icon {
+  width: 3rem;
+  height: 3rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: linear-gradient(135deg, var(--exulu-primary) 0%, var(--exulu-primary-light) 100%);
+  border-radius: var(--exulu-radius);
+  color: white;
+  font-size: 1.5rem;
+  margin-bottom: 1rem;
+}
+
+/* Font customization matching CI */
+body {
+  font-family: 'Inter', system-ui, sans-serif;
+  letter-spacing: -0.025em;
+}
+
+code, pre {
+  font-family: 'JetBrains Mono', monospace;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@exulu/backend",
   "author": "Qventu Bv.",
-  "version": "1.46.1",
+  "version": "1.48.1",
   "main": "./dist/index.js",
   "private": false,
   "publishConfig": {
@@ -22,7 +22,23 @@
     "build": "tsup",
     "dev": "npm link && tsup --watch",
     "prepare": "husky",
-    "semantic-release": "semantic-release"
+    "semantic-release": "semantic-release",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:errors": "eslint src --ext .ts --quiet",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "type-check": "tsc --noEmit",
+    "validate": "npm run type-check && npm run lint && npm run test",
+    "audit": "npm audit",
+    "audit:prod": "npm audit --omit=dev",
+    "audit:fix": "npm audit fix",
+    "cpd": "jscpd src --reporters console",
+    "cpd:report": "jscpd src --reporters console,html",
+    "cpd:view": "serve cpd-report/html -l 3001"
   },
   "keywords": [
     "exulu"
@@ -37,11 +53,23 @@
     "@types/cors": "^2.8.18",
     "@types/express": "^5.0.1",
     "@types/graphql-type-json": "^0.3.5",
+    "@types/jest": "^29.5.14",
     "@types/node": "^22.14.0",
     "@types/pg": "^8.15.1",
+    "@types/supertest": "^6.0.2",
+    "@typescript-eslint/eslint-plugin": "^8.20.0",
+    "@typescript-eslint/parser": "^8.20.0",
     "conventional-changelog-atom": "^5.0.0",
+    "eslint": "^9.20.0",
     "husky": "^9.1.7",
-    "semantic-release": "^24.2.7",
+    "jest": "^29.7.0",
+    "jscpd": "^4.0.8",
+    "prettier": "^3.4.2",
+    "semantic-release": "24.2.9",
+    "serve": "^14.2.6",
+    "supertest": "^7.0.0",
+    "ts-jest": "^29.2.5",
+    "tsc-alias": "^1.8.16",
     "tsup": "^8.5.0",
     "tsx": "^4.19.3"
   },
@@ -54,6 +82,7 @@
     "@ai-sdk/google-vertex": "^4.0.28",
     "@ai-sdk/openai": "^3.0.18",
     "@anthropic-ai/sdk": "^0.56.0",
+    "@apollo/server": "^5.4.0",
     "@as-integrations/express5": "^1.0.0",
     "@aws-sdk/client-s3": "^3.338.0",
     "@aws-sdk/client-sts": "^3.338.0",
@@ -70,7 +99,6 @@
     "@opentelemetry/winston-transport": "^0.14.1",
     "@perplexity-ai/perplexity_ai": "^0.25.0",
     "ai": "^6.0.49",
-    "apollo-server": "^3.13.0",
     "bcryptjs": "^3.0.2",
     "body-parser": "^2.2.0",
     "bullmq": "^5.48.1",
@@ -94,6 +122,7 @@
     "jsonwebtoken": "^9.0.2",
     "knex": "^3.1.0",
     "link": "^2.1.1",
+    "mammoth": "^1.11.0",
     "natural": "^8.1.0",
     "officeparser": "^5.2.2",
     "openai": "^5.21.0",
@@ -103,9 +132,11 @@
     "redis": "^4.7.0",
     "reflect-metadata": "^0.2.2",
     "tiktoken": "^1.0.21",
+    "turndown": "^7.2.2",
     "uuid": "^11.1.0",
     "wink-nlp": "^2.4.0",
     "winston": "^3.17.0",
+    "word-extractor": "^1.0.4",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.25.1",
     "zodex": "^0.18.2"

package/skills-lock.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "skills": {
+    "mintlify": {
+      "source": "mintlify.com",
+      "sourceType": "well-known",
+      "computedHash": "fc61ab6703f692dc2c215e74327a8998d02987ca9571084440be20e7ecad6b46"
+    }
+  }
+}

package/types/context-processor.ts

@@ -0,0 +1,45 @@
+import type { ExuluStorage } from "@SRC/exulu/storage";
+import type { Item } from "./models/item";
+import type { ExuluConfig } from "@SRC/exulu/app";
+import type { ExuluQueueConfig } from "./queue-config";
+
+export type ExuluContextProcessor = {
+    name: string;
+    description: string;
+    filter: ({
+        item,
+        user,
+        role,
+        utils,
+        exuluConfig,
+    }: {
+        item: Item;
+        user?: number;
+        role?: string;
+        utils: {
+            storage: ExuluStorage;
+        };
+        exuluConfig: ExuluConfig;
+    }) => Promise<Item | undefined | null>;
+    execute: ({
+        item,
+        user,
+        role,
+        utils,
+        exuluConfig,
+    }: {
+        item: Item;
+        user?: number;
+        role?: string;
+        utils: {
+            storage: ExuluStorage;
+        };
+        exuluConfig: ExuluConfig;
+    }) => Promise<Item>;
+    config?: {
+        queue?: Promise<ExuluQueueConfig>;
+        timeoutInSeconds?: number; // 3 minutes default
+        trigger: "manual" | "onUpdate" | "onInsert" | "always";
+        generateEmbeddings?: boolean; // defines if embeddings are generated after the processor finishes executing
+    };
+};

package/types/exulu-table-definition.ts

@@ -0,0 +1,79 @@
+import type { ExuluContextFieldDefinition } from "@SRC/exulu/context";
+import type { ExuluContextProcessor } from "./context-processor";
+
+export type ExuluTableDefinition = {
+    type?:
+    | "feedback"
+    | "test_cases"
+    | "eval_sets"
+    | "eval_runs"
+    | "agent_sessions"
+    | "agent_messages"
+    | "eval_results"
+    | "workflow_templates"
+    | "tracking"
+    | "rbac"
+    | "users"
+    | "variables"
+    | "roles"
+    | "agents"
+    | "items"
+    | "projects"
+    | "project_items"
+    | "platform_configurations"
+    | "job_results"
+    | "prompt_library"
+    | "prompt_favorites"
+    | "embedder_settings";
+    id?: string;
+    name: {
+      plural:
+      | "feedback"
+      | "test_cases"
+      | "eval_sets"
+      | "eval_runs"
+      | "agent_sessions"
+      | "agent_messages"
+      | "eval_results"
+      | "workflow_templates"
+      | "tracking"
+      | "rbac"
+      | "users"
+      | "variables"
+      | "roles"
+      | "agents"
+      | "projects"
+      | "project_items"
+      | "platform_configurations"
+      | "job_results"
+      | "prompt_library"
+      | "prompt_favorites"
+      | "embedder_settings";
+      singular:
+      | "feedback"
+      | "test_case"
+      | "eval_set"
+      | "eval_run"
+      | "agent_session"
+      | "agent_message"
+      | "eval_result"
+      | "workflow_template"
+      | "tracking"
+      | "rbac"
+      | "user"
+      | "variable"
+      | "role"
+      | "agent"
+      | "project"
+      | "project_item"
+      | "platform_configuration"
+      | "job_result"
+      | "prompt_library_item"
+      | "prompt_favorite"
+      | "embedder_setting";
+    };
+    processor?: ExuluContextProcessor;
+    fields: ExuluContextFieldDefinition[];
+    RBAC?: boolean;
+    graphql?: boolean;
+  };

package/types/file-types.ts

@@ -0,0 +1,18 @@
+export type allFileTypes = imageTypes | fileTypes | audioTypes | videoTypes;
+type audioTypes = ".mp3" | ".wav" | ".m4a" | ".mp4" | ".mpeg";
+type videoTypes = ".mp4" | ".m4a" | ".mp3" | ".mpeg" | ".wav";
+type imageTypes = ".png" | ".jpg" | ".jpeg" | ".gif" | ".webp";
+type fileTypes =
+  | ".pdf"
+  | ".docx"
+  | ".doc"
+  | ".xlsx"
+  | ".xls"
+  | ".csv"
+  | ".pptx"
+  | ".ppt"
+  | ".txt"
+  | ".md"
+  | ".json"
+  | ".srt"
+  | ".html";

package/types/models/agent.ts

@@ -1,20 +1,18 @@
-export interface Agent {
+import type { ExuluProviderWorkflowConfig } from "@SRC/exulu/provider";
+
+export interface ExuluAgent {
     id: string;
     modelName?: string;
     providerName?: string;
-    backend: string;
+    provider: string;
+    source: "code" | "database";
     memory?: string;
     welcomemessage?: string;
     type: "agent";
     name: string;
     image?: string;
     providerapikey?: string;
-    workflows?: {
-        enabled: boolean;
-        queue?: {
-            name: string;
-        };
-    };
+    workflows?: ExuluProviderWorkflowConfig;
     firewall?: {
         enabled: boolean;
         scanners?: {
@@ -28,6 +26,7 @@ export interface Agent {
     active?: boolean;
     description?: string;
     instructions?: string;
+    feedback?: boolean;
     slug?: string;
     tools?: {
         id: string;
@@ -51,20 +50,19 @@ export interface Agent {
         video: videoTypes[];
     }
     // New RBAC fields
-    rights_mode?: 'private' | 'users' | 'roles' | 'public' /* | 'projects' */;
-    created_by?: string;
+    rights_mode?: 'private' | 'users' | 'roles' | 'public'
+    created_by?: string | number;
     RBAC?: {
         type?: string;
         users?: Array<{ id: number; rights: 'read' | 'write' }>;
         roles?: Array<{ id: string; rights: 'read' | 'write' }>;
-        /* projects?: Array<{ id: string; rights: 'read' | 'write' }>; */
     };
     createdAt?: string;
     updatedAt?: string;
 }
 
 export type imageTypes = '.png' | '.jpg' | '.jpeg' | '.gif' | '.webp';
-export type fileTypes = '.pdf' | '.docx' | '.xlsx' | '.xls' | '.csv' | '.pptx' | '.ppt';
+export type fileTypes = '.pdf' | '.docx' | '.xlsx' | '.xls' | '.csv' | '.pptx' | '.ppt' | '.txt' | '.md' | '.json';
 export type audioTypes = '.mp3' | '.wav' | '.m4a' | '.mp4' | '.mpeg';
 export type videoTypes = '.mp4' | '.m4a' | '.mp3' | '.mpeg' | '.wav';
 export type allFileTypes = imageTypes | fileTypes | audioTypes | videoTypes;

package/types/models/exulu-agent-tool-config.ts

@@ -0,0 +1,11 @@
+export type ExuluAgentToolConfig = {
+    id: string;
+    type: string;
+    config: {
+      name: string;
+      variable: string | boolean | number; // is a variable name
+      type: "boolean" | "string" | "number" | "variable";
+      value?: any; // fetched on demand from the database based on the variable name
+      default?: string | boolean | number;
+    }[];
+  }

package/types/models/rate-limiter-rules.ts

@@ -0,0 +1,7 @@
+export interface RateLimiterRule {
+    name?: string; // optional, if not provided the rate limiter uses the agent id for the queue name
+    rate_limit: {
+      time: number; // time until usage expires in seconds
+      limit: number;
+    };
+  }

package/types/provider-config.ts

@@ -0,0 +1,21 @@
+import { type LanguageModel } from "ai";
+
+export type ExuluProviderConfig = {
+    name: string;
+    instructions: string;
+    model: {
+        create: ({ apiKey }: { apiKey?: string | undefined }) => LanguageModel;
+    };
+    custom?: {
+        name: string;
+        description: string;
+    }[];
+    memory?: {
+        lastMessages: number;
+        vector: boolean;
+        semanticRecall: {
+            topK: number;
+            messageRange: number;
+        };
+    };
+};

package/types/queue-config.ts

@@ -0,0 +1,16 @@
+import { Queue } from "bullmq";
+
+export type ExuluQueueConfig = {
+    queue: Queue;
+    ratelimit: number;
+    timeoutInSeconds?: number; // 3 minutes default
+    concurrency: {
+        worker: number;
+        queue: number;
+    };
+    retries?: number;
+    backoff?: {
+        type: "exponential" | "linear";
+        delay: number; // in milliseconds
+    };
+};

package/types/rbac-rights-modes.ts

@@ -0,0 +1 @@
+export type ExuluRightsMode = "private" | "users" | "roles" | "public"; /*  | "projects" */

package/types/statistics.ts

@@ -0,0 +1,20 @@
+import type { STATISTICS_TYPE } from "./enums/statistics";
+
+export type ExuluStatisticParams = Omit<ExuluStatistic, "total" | "name" | "type">;
+
+export type ExuluStatistic = {
+    name: string;
+    label: string;
+    type: STATISTICS_TYPE;
+    trigger: STATISTICS_LABELS;
+    total: number;
+};
+
+export type STATISTICS_LABELS =
+    | "tool"
+    | "agent"
+    | "flow"
+    | "api"
+    | "claude-code"
+    | "user"
+    | "processor";

package/types/workflow.ts

@@ -0,0 +1,31 @@
+import type { ExuluRightsMode } from "./rbac-rights-modes";
+
+// Workflows in Exulu are "template conversations"
+// that contain variables that can be set on each
+// invocation. Basically they are a set of UIMessages
+// that get run in the background on invocation instead
+// of manually in a chat session.
+export interface ExuluWorkflow {
+    id: string;
+    name: string;
+    description?: string;
+    rights_mode?: ExuluRightsMode;
+    RBAC?: {
+        users?: Array<{ id: string; rights: "read" | "write" }>;
+        roles?: Array<{ id: string; rights: "read" | "write" }>;
+    };
+    created_by: number;
+    createdAt: string;
+    updatedAt: string;
+    agent: string;
+    steps_json?: WorkflowStep[];
+}
+
+interface WorkflowStep {
+    id: string;
+    type: "user" | "assistant" | "tool";
+    content?: string;
+    contentExample?: string;
+    toolName?: string;
+    variablesUsed?: string[];
+}