@exulu/backend 0.1.6

package/git-conventional-commits.yaml

@@ -0,0 +1,43 @@
+---
+convention:
+  commitTypes:
+  - feat
+  - fix
+  - perf
+  - refactor
+  - style
+  - test
+  - build
+  - ops
+  - docs
+  - chore
+  - merge
+  - revert
+  commitScopes: []
+  releaseTagGlobPattern: v[0-9]*.[0-9]*.[0-9]*
+changelog:
+  commitTypes:
+  - feat
+  - fix
+  - perf
+  - merge
+  includeInvalidCommits: true
+  commitIgnoreRegexPattern: "^WIP "
+  headlines:
+    feat: Features
+    fix: Bug Fixes
+    perf: Performance Improvements
+    merge: Merges
+    breakingChange: BREAKING CHANGES
+
+  ## GitHub
+  # commitUrl: https://github.com/ACCOUNT/REPOSITORY/commit/%commit%
+  # commitRangeUrl: https://github.com/ACCOUNT/REPOSITORY/compare/%from%...%to%?diff=split
+
+  ## GitHub Issues
+  # issueRegexPattern: "#[0-9]+"
+  # issueUrl: https://github.com/ACCOUNT/REPOSITORY/issues/%issue%
+
+  ## Jira Issues
+  # issueRegexPattern: "[A-Z][A-Z0-9]+-[0-9]+"
+  # issueUrl: https://WORKSPACE.atlassian.net/browse/%issue%

package/license.md

@@ -0,0 +1,81 @@
+# Exulu Software License Agreement
+
+**Version 1.0**  
+**Effective Date: [Insert Date]**
+
+This Software License Agreement (the **"Agreement"**) is a legal agreement between **Qventu Bv.**, a company registered in the Netherlands with its registered office at **Lindenlaan 30, 6301 EL Valkenburg aan de Geul**, and registered with the Dutch Chamber of Commerce under number **76483894** (hereinafter "**Qventu**"), and the individual or entity installing, copying, accessing, or otherwise using the **Exulu** software (the "**Licensee**").
+
+By installing, copying, or otherwise using the Exulu software (the "**Software**"), Licensee agrees to be bound by the terms of this Agreement.
+
+---
+
+## 1. Ownership and Intellectual Property
+
+The Software, including all associated intellectual property rights, documentation, and any copies or derivative works, is and shall remain the sole property of **Qventu Bv.**.
+
+Nothing in this Agreement shall be construed as transferring any rights, title, or ownership in or to the Software to the Licensee, except as explicitly set forth herein.
+
+---
+
+## 2. Grant of License
+
+Subject to the terms and conditions of this Agreement, Qventu grants to the Licensee a **non-exclusive, non-transferable, non-sublicensable**, and **revocable license** to use the Software **only while a valid license agreement is in effect** between the Licensee and either:
+
+- **Qventu Bv.**, or
+- an **official partner** of Qventu Bv., authorized to grant such licenses.
+
+---
+
+## 3. License Restrictions
+
+Licensee shall not:
+
+- Use the Software without an active license agreement as specified in Section 2.
+- Distribute, sublicense, lease, rent, lend, or otherwise transfer the Software to any third party.
+- Reverse engineer, decompile, or disassemble the Software, except as permitted by applicable law.
+- Modify or create derivative works based on the Software unless expressly authorized in writing by Qventu.
+
+---
+
+## 4. Term and Termination
+
+This Agreement and the license granted herein shall remain in effect only while there is an active license agreement in place as defined in Section 2.
+
+Qventu may terminate this Agreement immediately upon written notice if the Licensee breaches any provision of this Agreement or uses the Software without a valid license.
+
+Upon termination, Licensee must immediately cease all use of the Software and destroy all copies in their possession or control.
+
+---
+
+## 5. Disclaimer of Warranties
+
+The Software is provided "AS IS" without warranty of any kind, whether express, implied, or statutory, including but not limited to warranties of merchantability, fitness for a particular purpose, and non-infringement.
+
+---
+
+## 6. Limitation of Liability
+
+To the maximum extent permitted by applicable law, in no event shall Qventu be liable for any indirect, incidental, consequential, special, or punitive damages arising out of or related to this Agreement or the use of the Software, even if Qventu has been advised of the possibility of such damages.
+
+---
+
+## 7. Governing Law and Jurisdiction
+
+This Agreement shall be governed by and construed in accordance with the laws of the **Netherlands**. Any disputes arising out of or in connection with this Agreement shall be subject to the exclusive jurisdiction of the competent courts of the Netherlands.
+
+---
+
+## 8. Contact Information
+
+For inquiries regarding this Agreement or licensing of the Software, please contact:
+
+**Qventu Bv.**  
+Lindenlaan 30  
+6301 EL Valkenburg aan de Geul  
+Netherlands  
+KvK: 76483894  
+Email: [Insert Contact Email]
+
+---
+
+© Qventu Bv. All rights reserved.

package/package.json

@@ -0,0 +1,82 @@
+{
+    "name": "@exulu/backend",
+    "author": "Qventu Bv.",
+    "version": "0.1.6",
+    "main": "./dist/index.js",
+    "private": false,
+    "publishConfig": {
+      "access": "restricted"
+    },
+    "module": "./dist/index.mjs",
+    "types": "./dist/index.d.ts",
+    "homepage": "https://exulu.com",
+    "engines": {
+        "node": "20.10.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/Qventu/exulu-core"
+    },
+    "scripts": {
+        "build": "tsup",
+        "dev": "npm link && tsup --watch"
+    },
+    "keywords": [
+        "exulu"
+    ],
+    "type": "module",
+    "devDependencies": {
+        "@types/bun": "latest",
+        "@types/node": "^22.14.0",
+        "@types/pg": "^8.15.1",
+        "mastra": "^0.4.4",
+        "tsup": "^8.5.0",
+        "tsx": "^4.19.3"
+    },
+    "peerDependencies": {
+        "typescript": "^5.8.3"
+    },
+    "dependencies": {
+        "@as-integrations/express5": "^1.0.0",
+        "@aws-sdk/client-s3": "^3.338.0",
+        "@aws-sdk/client-sts": "^3.338.0",
+        "@aws-sdk/s3-request-presigner": "^3.338.0",
+        "@mastra/core": "^0.8.3",
+        "@mastra/memory": "^0.2.10",
+        "@mastra/pg": "^0.2.10",
+        "@mastra/rag": "^0.1.23",
+        "@types/bcrypt": "^5.0.2",
+        "@types/cors": "^2.8.18",
+        "@types/express": "^5.0.1",
+        "@types/graphql-type-json": "^0.3.5",
+        "@types/multer": "^1.4.12",
+        "ai": "^4.3.9",
+        "apollo-server": "^3.13.0",
+        "bcryptjs": "^3.0.2",
+        "body-parser": "^2.2.0",
+        "bullmq": "^5.48.1",
+        "class-validator": "^0.14.2",
+        "cors": "^2.8.5",
+        "csv-parse": "^5.6.0",
+        "dotenv": "^16.0.0",
+        "express": "^5.1.0",
+        "graphql": "^16.11.0",
+        "graphql-tools": "^9.0.18",
+        "graphql-type-json": "^0.3.2",
+        "jose": "^6.0.10",
+        "jsonwebtoken": "^9.0.2",
+        "knex": "^3.1.0",
+        "multer": "^1.4.5-lts.2",
+        "next-auth": "^4.24.11",
+        "openai": "^4.94.0",
+        "papaparse": "^5.5.2",
+        "pgvector": "^0.2.0",
+        "redis": "^4.7.0",
+        "reflect-metadata": "^0.2.2",
+        "type-graphql": "^2.0.0-rc.2",
+        "uninstall": "^0.0.0",
+        "uuid": "^11.1.0",
+        "zod": "^3.24.2",
+        "zodex": "^0.18.2"
+    }
+}

package/types/enums/field-types.ts

@@ -0,0 +1 @@
+export type ExuluFieldTypes = "text" | "longText" | "shortText" | "number" | "boolean" | "code" | "json"

package/types/enums/statistics.ts

@@ -0,0 +1,13 @@
+export type STATISTICS_TYPE = "context.retrieve" | "source.update" | "embedder.upsert" | "embedder.delete" | "workflow.run" | "context.upsert" | "tool.call" | "agent.run";
+
+export const STATISTICS_TYPE_ENUM = {
+    CONTEXT_RETRIEVE: "context.retrieve",
+    SOURCE_UPDATE: "source.update",
+    EMBEDDER_UPSERT: "embedder.upsert",
+    EMBEDDER_GENERATE: "embedder.generate",
+    EMBEDDER_DELETE: "embedder.delete",
+    WORKFLOW_RUN: "workflow.run",
+    CONTEXT_UPSERT: "context.upsert",
+    TOOL_CALL: "tool.call",
+    AGENT_RUN: "agent.run"
+};

package/types/models/agent-backend.ts

@@ -0,0 +1,15 @@
+// Represents an agent backend
+// which is created and run in
+// the agents service. Agents
+// registered in Exulu must have
+// a connected backend agent that
+// does the actual work.
+export interface AgentBackend {
+    id: string
+    name: string
+    description: string
+    enable_batch: boolean
+    inputSchema: any;
+    slug: string
+    type: string
+}

package/types/models/agent-session.ts

@@ -0,0 +1,17 @@
+export interface AgentSession {
+    createdAt: string;
+    updatedAt: string;
+    id: string;
+    metadata: any;
+    agentId: string;
+    resourceId: string;
+    title: string;
+}
+export interface AgentMessage {
+    id: string;
+    thread_id: string;
+    content: string;
+    role: "function" | "data" | "user" | "system" | "assistant" | "tool";
+    type: string;
+    createdAt: Date;
+}

package/types/models/agent.ts

@@ -0,0 +1,23 @@
+export interface Agent {
+    id: string;
+    backend: string;
+    type: "chat" | "flow";
+    extensions: string[];
+    name: string;
+    active?: boolean;
+    public?: boolean;
+    description?: string;
+    slug?: string;
+    tools?: {
+        id: string;
+        description: string;
+        type?: "context";
+    }[];
+    capabilities?: {
+        tools: boolean;
+        images: string[];
+        files: string[];
+        audio: string[];
+        video: string[];
+    }
+}

package/types/models/context.ts

@@ -0,0 +1,35 @@
+import type { ExuluFieldTypes } from "../enums/field-types"
+import type { Agent } from "./agent"
+
+export interface Context {
+    id: string
+    name: string
+    description: string
+    embedder: string
+    active: boolean
+    slug: string
+    fields: {
+      name: string
+      type: ExuluFieldTypes
+    }[]
+    sources: ContextSource[]
+    agents: Agent[]
+  }
+  
+  export interface ContextSource {
+    id: string
+    name: string
+    description: string
+    updaters: Updater[]
+  }
+  
+  export interface Updater {
+    id: string
+    type: string
+    configuration: Configuration
+  }
+  
+  export interface Configuration {
+    query: string
+  }
+  

package/types/models/embedder-backend.ts

@@ -0,0 +1,15 @@
+
+// Represents an embedder backend
+// which is created and run in
+// the agents service. Embedders
+// registered in Exulu must have
+// a connected backend that
+// does the actual work.
+
+export interface EmbedderBackend {
+      id: string
+      name: string
+      slug: string
+      supported: string
+      description: string
+    }

package/types/models/embedding.ts

@@ -0,0 +1,17 @@
+export interface Embedding {
+        collection: string
+        metadata: {
+            certainty: number
+            creation_time?: string
+            distance?: number
+        }
+        uuid: string
+        properties: {
+            chunk_count: string
+            chunk_index: string
+            external_id: string
+            original_content: string
+            original_image: string
+            original_title: string
+        }
+    }

package/types/models/item.ts

@@ -0,0 +1,21 @@
+export interface Item {
+    id?: string;
+    name?: string;
+    description?: string,
+    createdAt?: string;
+    updatedAt?: string;
+    external_id?: string;
+    source?: string;
+    tags?: string[];
+    textLength?: number;
+    chunks?: {
+        id: string;
+        index: number;
+        content: string;
+        source: string;
+        embedding: number;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+    [key: string]: any;
+}

package/types/models/job.ts

@@ -0,0 +1,8 @@
+export type Job = {
+  id: string
+  name: string
+  status: string
+  result?: string
+  date_done?: Date
+  date_started?: Date
+};

package/types/models/tool.ts

@@ -0,0 +1,8 @@
+export interface Tool {
+    id: string;
+    name: string;
+    description: string;
+    type: string;
+    inputSchema: any;
+    outputSchema: any;
+}

package/types/models/user-role.ts

@@ -0,0 +1,6 @@
+export type UserRole = {
+  id: string;
+  name: string;
+  is_admin: boolean;
+  agents?: string[];
+};

package/types/models/user.ts

@@ -0,0 +1,10 @@
+export type User = {
+  id: string;
+  email: string;
+  emailVerified?: string;
+  type?: "api" | "user"
+  roles?: {
+    id: string;
+    role: string;
+  }[];
+};

package/types/models/vector-methods.ts

@@ -0,0 +1,10 @@
+export const VectorMethodEnum = {
+    "cosineDistance": "cosineDistance",
+    "l1Distance": "l1Distance",
+    "l2Distance": "l2Distance",
+    "hammingDistance": "hammingDistance",
+    "jaccardDistance": "jaccardDistance",
+    "maxInnerProduct": "maxInnerProduct"
+} as const;
+
+export type VectorMethod = (typeof VectorMethodEnum)[keyof typeof VectorMethodEnum];