@exulu/backend 1.31.2 → 1.32.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
-## [1.31.2](https://github.com/Qventu/exulu-backend/compare/v1.31.1...v1.31.2) (2025-11-10)
+# [1.32.0](https://github.com/Qventu/exulu-backend/compare/v1.31.2...v1.32.0) (2025-11-11)
 
 
-### Bug Fixes
+### Features
 
-* minor exulu upgrade for redis connection ([7d20243](https://github.com/Qventu/exulu-backend/commit/7d2024397562e2feff9f3515eafbc46fcfd0ab94))
+* implement scheduled data sources for contexts ([d936754](https://github.com/Qventu/exulu-backend/commit/d9367545fc3dc35b9c2d2ad0820fc7d2fddd4666))

package/dist/index.cjs

@@ -2334,7 +2334,7 @@ function createMutations(table, agents, contexts, tools, config) {
       if (!item) {
         throw new Error("Item not found, or your user does not have access to it.");
       }
-      const { job, result } = await exists.process(
+      const { job, result } = await exists.processField(
         "api",
         context.user.id,
         context.user.role?.id,
@@ -5380,10 +5380,12 @@ var ExuluContext = class {
   resultReranker;
   // todo typings
   configuration;
-  constructor({ id, name, description, embedder, active, rateLimit, fields, queryRewriter, resultReranker, configuration }) {
+  sources = [];
+  constructor({ id, name, description, embedder, active, rateLimit, fields, queryRewriter, resultReranker, configuration, sources }) {
     this.id = id;
     this.name = name;
     this.fields = fields || [];
+    this.sources = sources || [];
     this.configuration = configuration || {
       calculateVectors: "manual",
       language: "english",
@@ -5396,7 +5398,7 @@ var ExuluContext = class {
     this.queryRewriter = queryRewriter;
     this.resultReranker = resultReranker;
   }
-  process = async (trigger, user, role, item, config) => {
+  processField = async (trigger, user, role, item, config) => {
     console.log("[EXULU] processing field", item.field, " in context", this.id);
     console.log("[EXULU] fields", this.fields.map((field2) => field2.name));
     const field = this.fields.find((field2) => field2.name === item.field?.replace("_s3key", ""));
@@ -5458,6 +5460,9 @@ var ExuluContext = class {
       results: []
     };
   };
+  executeSource = async (source, inputs) => {
+    return await source.execute(inputs);
+  };
   tableExists = async () => {
     const { db: db3 } = await postgresClient();
     const tableName = getTableName(this.id);
@@ -6972,6 +6977,49 @@ var createWorkers = async (agents, queues2, config, contexts, evals, tools, trac
                 metadata: {}
               };
             }
+            if (data.type === "source") {
+              console.log("[EXULU] running a source job.", logMetadata(bullmqJob.name));
+              if (!data.source) {
+                throw new Error(`No source id set for source job.`);
+              }
+              if (!data.context) {
+                throw new Error(`No context id set for source job.`);
+              }
+              const context = contexts.find((c) => c.id === data.context);
+              if (!context) {
+                throw new Error(`Context ${data.context} not found in the registry.`);
+              }
+              const source = context.sources.find((s) => s.id === data.source);
+              if (!source) {
+                throw new Error(`Source ${data.source} not found in the context ${context.id}.`);
+              }
+              const result = await source.execute(data.inputs);
+              let jobs = [];
+              let items = [];
+              for (const item of result) {
+                const { item: createdItem, job } = await context.createItem(item, config, data.user, data.role);
+                if (job) {
+                  jobs.push(job);
+                  console.log(`[EXULU] Scheduled job through source update job for item ${createdItem.id} (Job ID: ${job})`, logMetadata(bullmqJob.name, {
+                    item: createdItem,
+                    job
+                  }));
+                }
+                if (createdItem.id) {
+                  items.push(createdItem.id);
+                  console.log(`[EXULU] created item through source update job ${createdItem.id}`, logMetadata(bullmqJob.name, {
+                    item: createdItem
+                  }));
+                }
+              }
+              return {
+                result,
+                metadata: {
+                  jobs,
+                  items
+                }
+              };
+            }
             throw new Error(`Invalid job type: ${data.type} for job ${bullmqJob.name}.`);
           } catch (error) {
             console.error(`[EXULU] job failed.`, error instanceof Error ? error.message : String(error));
@@ -8878,6 +8926,41 @@ var ExuluApp = class {
         if (queues2) {
           filteredQueues = filteredQueues.filter((q) => queues2.includes(q.queue.name));
         }
+        const sources = Object.values(this._contexts ?? {}).flatMap((context) => ({
+          ...context.sources,
+          context: context.id
+        }));
+        if (sources.length > 0) {
+          console.log("[EXULU] Creating ContextSource schedulers for", sources.length, "sources.");
+          for (const source of sources) {
+            const queue = await source.config?.queue;
+            if (queue) {
+              if (!source.config.schedule) {
+                throw new Error("Schedule is required for source when configuring a queue: " + source.name);
+              }
+              console.log("[EXULU] Creating ContextSource scheduler for", source.name, "in queue", queue.queue?.name);
+              await queue.queue?.upsertJobScheduler(source.id, {
+                pattern: source.config?.schedule
+              }, {
+                // default job data
+                name: `${source.id}-job`,
+                data: {
+                  source: source.id,
+                  context: source.context,
+                  type: "source"
+                },
+                opts: {
+                  backoff: {
+                    type: source.config.backoff?.type || "exponential",
+                    delay: source.config.backoff?.delay || 2e3
+                  },
+                  attempts: source.config.retries || 3,
+                  removeOnFail: 200
+                }
+              });
+            }
+          }
+        }
         return await createWorkers(
           this._agents,
           filteredQueues,

package/dist/index.d.cts

@@ -544,6 +544,21 @@ declare class ExuluStorage {
     getPresignedUrl: (key: string) => Promise<string>;
     uploadFile: (user: number, file: Buffer | Uint8Array, key: string, type: string, metadata?: Record<string, string>) => Promise<string>;
 }
+type ExuluContextSource = {
+    id: string;
+    name: string;
+    description: string;
+    config: {
+        schedule: string;
+        queue: Promise<ExuluQueueConfig>;
+        retries?: number;
+        backoff?: {
+            type: 'exponential' | 'linear';
+            delay: number;
+        };
+    };
+    execute: (inputs: any) => Promise<Item[]>;
+};
 declare class ExuluContext {
     id: string;
     name: string;
@@ -559,12 +574,14 @@ declare class ExuluContext {
         defaultRightsMode?: ExuluRightsMode;
         language?: "german" | "english";
     };
-    constructor({ id, name, description, embedder, active, rateLimit, fields, queryRewriter, resultReranker, configuration }: {
+    sources: ExuluContextSource[];
+    constructor({ id, name, description, embedder, active, rateLimit, fields, queryRewriter, resultReranker, configuration, sources }: {
         id: string;
         name: string;
         fields: ExuluContextFieldDefinition[];
         description: string;
         embedder?: ExuluEmbedder;
+        sources: ExuluContextSource[];
         category?: string;
         active: boolean;
         rateLimit?: RateLimiterRule;
@@ -576,13 +593,14 @@ declare class ExuluContext {
             language?: "german" | "english";
         };
     });
-    process: (trigger: STATISTICS_LABELS, user: number, role: string, item: Item & {
+    processField: (trigger: STATISTICS_LABELS, user: number, role: string, item: Item & {
         field: string;
     }, config: ExuluConfig) => Promise<{
         result: string;
         job?: string;
     }>;
     deleteAll: () => Promise<VectorOperationResponse>;
+    executeSource: (source: ExuluContextSource, inputs: any) => Promise<Item[]>;
     tableExists: () => Promise<boolean>;
     chunksTableExists: () => Promise<boolean>;
     createAndUpsertEmbeddings: (item: Item, config: ExuluConfig, user?: number, statistics?: ExuluStatisticParams, role?: string, job?: string) => Promise<{

package/dist/index.d.ts

@@ -544,6 +544,21 @@ declare class ExuluStorage {
     getPresignedUrl: (key: string) => Promise<string>;
     uploadFile: (user: number, file: Buffer | Uint8Array, key: string, type: string, metadata?: Record<string, string>) => Promise<string>;
 }
+type ExuluContextSource = {
+    id: string;
+    name: string;
+    description: string;
+    config: {
+        schedule: string;
+        queue: Promise<ExuluQueueConfig>;
+        retries?: number;
+        backoff?: {
+            type: 'exponential' | 'linear';
+            delay: number;
+        };
+    };
+    execute: (inputs: any) => Promise<Item[]>;
+};
 declare class ExuluContext {
     id: string;
     name: string;
@@ -559,12 +574,14 @@ declare class ExuluContext {
         defaultRightsMode?: ExuluRightsMode;
         language?: "german" | "english";
     };
-    constructor({ id, name, description, embedder, active, rateLimit, fields, queryRewriter, resultReranker, configuration }: {
+    sources: ExuluContextSource[];
+    constructor({ id, name, description, embedder, active, rateLimit, fields, queryRewriter, resultReranker, configuration, sources }: {
         id: string;
         name: string;
         fields: ExuluContextFieldDefinition[];
         description: string;
         embedder?: ExuluEmbedder;
+        sources: ExuluContextSource[];
         category?: string;
         active: boolean;
         rateLimit?: RateLimiterRule;
@@ -576,13 +593,14 @@ declare class ExuluContext {
             language?: "german" | "english";
         };
     });
-    process: (trigger: STATISTICS_LABELS, user: number, role: string, item: Item & {
+    processField: (trigger: STATISTICS_LABELS, user: number, role: string, item: Item & {
         field: string;
     }, config: ExuluConfig) => Promise<{
         result: string;
         job?: string;
     }>;
     deleteAll: () => Promise<VectorOperationResponse>;
+    executeSource: (source: ExuluContextSource, inputs: any) => Promise<Item[]>;
     tableExists: () => Promise<boolean>;
     chunksTableExists: () => Promise<boolean>;
     createAndUpsertEmbeddings: (item: Item, config: ExuluConfig, user?: number, statistics?: ExuluStatisticParams, role?: string, job?: string) => Promise<{

package/dist/index.js

@@ -2282,7 +2282,7 @@ function createMutations(table, agents, contexts, tools, config) {
       if (!item) {
         throw new Error("Item not found, or your user does not have access to it.");
       }
-      const { job, result } = await exists.process(
+      const { job, result } = await exists.processField(
         "api",
         context.user.id,
         context.user.role?.id,
@@ -5347,10 +5347,12 @@ var ExuluContext = class {
   resultReranker;
   // todo typings
   configuration;
-  constructor({ id, name, description, embedder, active, rateLimit, fields, queryRewriter, resultReranker, configuration }) {
+  sources = [];
+  constructor({ id, name, description, embedder, active, rateLimit, fields, queryRewriter, resultReranker, configuration, sources }) {
     this.id = id;
     this.name = name;
     this.fields = fields || [];
+    this.sources = sources || [];
     this.configuration = configuration || {
       calculateVectors: "manual",
       language: "english",
@@ -5363,7 +5365,7 @@ var ExuluContext = class {
     this.queryRewriter = queryRewriter;
     this.resultReranker = resultReranker;
   }
-  process = async (trigger, user, role, item, config) => {
+  processField = async (trigger, user, role, item, config) => {
     console.log("[EXULU] processing field", item.field, " in context", this.id);
     console.log("[EXULU] fields", this.fields.map((field2) => field2.name));
     const field = this.fields.find((field2) => field2.name === item.field?.replace("_s3key", ""));
@@ -5425,6 +5427,9 @@ var ExuluContext = class {
       results: []
     };
   };
+  executeSource = async (source, inputs) => {
+    return await source.execute(inputs);
+  };
   tableExists = async () => {
     const { db: db3 } = await postgresClient();
     const tableName = getTableName(this.id);
@@ -6939,6 +6944,49 @@ var createWorkers = async (agents, queues2, config, contexts, evals, tools, trac
                 metadata: {}
               };
             }
+            if (data.type === "source") {
+              console.log("[EXULU] running a source job.", logMetadata(bullmqJob.name));
+              if (!data.source) {
+                throw new Error(`No source id set for source job.`);
+              }
+              if (!data.context) {
+                throw new Error(`No context id set for source job.`);
+              }
+              const context = contexts.find((c) => c.id === data.context);
+              if (!context) {
+                throw new Error(`Context ${data.context} not found in the registry.`);
+              }
+              const source = context.sources.find((s) => s.id === data.source);
+              if (!source) {
+                throw new Error(`Source ${data.source} not found in the context ${context.id}.`);
+              }
+              const result = await source.execute(data.inputs);
+              let jobs = [];
+              let items = [];
+              for (const item of result) {
+                const { item: createdItem, job } = await context.createItem(item, config, data.user, data.role);
+                if (job) {
+                  jobs.push(job);
+                  console.log(`[EXULU] Scheduled job through source update job for item ${createdItem.id} (Job ID: ${job})`, logMetadata(bullmqJob.name, {
+                    item: createdItem,
+                    job
+                  }));
+                }
+                if (createdItem.id) {
+                  items.push(createdItem.id);
+                  console.log(`[EXULU] created item through source update job ${createdItem.id}`, logMetadata(bullmqJob.name, {
+                    item: createdItem
+                  }));
+                }
+              }
+              return {
+                result,
+                metadata: {
+                  jobs,
+                  items
+                }
+              };
+            }
             throw new Error(`Invalid job type: ${data.type} for job ${bullmqJob.name}.`);
           } catch (error) {
             console.error(`[EXULU] job failed.`, error instanceof Error ? error.message : String(error));
@@ -8845,6 +8893,41 @@ var ExuluApp = class {
         if (queues2) {
           filteredQueues = filteredQueues.filter((q) => queues2.includes(q.queue.name));
         }
+        const sources = Object.values(this._contexts ?? {}).flatMap((context) => ({
+          ...context.sources,
+          context: context.id
+        }));
+        if (sources.length > 0) {
+          console.log("[EXULU] Creating ContextSource schedulers for", sources.length, "sources.");
+          for (const source of sources) {
+            const queue = await source.config?.queue;
+            if (queue) {
+              if (!source.config.schedule) {
+                throw new Error("Schedule is required for source when configuring a queue: " + source.name);
+              }
+              console.log("[EXULU] Creating ContextSource scheduler for", source.name, "in queue", queue.queue?.name);
+              await queue.queue?.upsertJobScheduler(source.id, {
+                pattern: source.config?.schedule
+              }, {
+                // default job data
+                name: `${source.id}-job`,
+                data: {
+                  source: source.id,
+                  context: source.context,
+                  type: "source"
+                },
+                opts: {
+                  backoff: {
+                    type: source.config.backoff?.type || "exponential",
+                    delay: source.config.backoff?.delay || 2e3
+                  },
+                  attempts: source.config.retries || 3,
+                  removeOnFail: 200
+                }
+              });
+            }
+          }
+        }
         return await createWorkers(
           this._agents,
           filteredQueues,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@exulu/backend",
   "author": "Qventu Bv.",
-  "version": "1.31.2",
+  "version": "1.32.0",
   "main": "./dist/index.js",
   "private": false,
   "publishConfig": {