@exulu/backend 1.34.0 → 1.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/CHANGELOG.md +2 -2
  2. package/dist/index.cjs +269 -78
  3. package/dist/index.d.cts +25 -11
  4. package/dist/index.d.ts +25 -11
  5. package/dist/index.js +269 -78
  6. package/package.json +1 -1
  7. package/types/models/agent.ts +1 -0
  8. package/types/models/context.ts +9 -1
package/dist/index.d.cts CHANGED
@@ -189,6 +189,7 @@ interface Agent {
189
189
  description: string;
190
190
  }[];
191
191
  maxContextLength?: number;
192
+ authenticationInformation?: string;
192
193
  capabilities?: {
193
194
  text: boolean;
194
195
  images: imageTypes$1[];
@@ -246,7 +247,7 @@ type ExuluAgentConfig = {
246
247
  instructions: string;
247
248
  model: {
248
249
  create: ({ apiKey }: {
249
- apiKey: string;
250
+ apiKey?: string | undefined;
250
251
  }) => LanguageModel;
251
252
  };
252
253
  outputSchema?: z.ZodType;
@@ -276,6 +277,7 @@ interface ExuluAgentParams {
276
277
  config?: ExuluAgentConfig | undefined;
277
278
  queue?: ExuluQueueConfig;
278
279
  maxContextLength?: number;
280
+ authenticationInformation?: string;
279
281
  provider: string;
280
282
  capabilities?: {
281
283
  text: boolean;
@@ -359,13 +361,14 @@ declare class ExuluAgent {
359
361
  slug: string;
360
362
  type: "agent";
361
363
  streaming: boolean;
364
+ authenticationInformation?: string;
362
365
  maxContextLength?: number;
363
366
  queue?: ExuluQueueConfig;
364
367
  rateLimit?: RateLimiterRule;
365
368
  config?: ExuluAgentConfig | undefined;
366
369
  model?: {
367
370
  create: ({ apiKey }: {
368
- apiKey: string;
371
+ apiKey?: string | undefined;
369
372
  }) => LanguageModel;
370
373
  };
371
374
  capabilities: {
@@ -375,7 +378,7 @@ declare class ExuluAgent {
375
378
  audio: string[];
376
379
  video: string[];
377
380
  };
378
- constructor({ id, name, description, config, rateLimit, capabilities, type, maxContextLength, provider, queue }: ExuluAgentParams);
381
+ constructor({ id, name, description, config, rateLimit, capabilities, type, maxContextLength, provider, queue, authenticationInformation }: ExuluAgentParams);
379
382
  get providerName(): string;
380
383
  get modelName(): string;
381
384
  tool: (instance: string, agents: ExuluAgent[]) => Promise<ExuluTool | null>;
@@ -388,7 +391,7 @@ declare class ExuluAgent {
388
391
  allExuluTools?: ExuluTool[];
389
392
  statistics?: ExuluStatisticParams;
390
393
  toolConfigs?: ExuluAgentToolConfig[];
391
- providerapikey: string;
394
+ providerapikey?: string | undefined;
392
395
  contexts?: ExuluContext[] | undefined;
393
396
  exuluConfig?: ExuluConfig;
394
397
  instructions?: string;
@@ -402,7 +405,7 @@ declare class ExuluAgent {
402
405
  currentTools?: ExuluTool[];
403
406
  allExuluTools?: ExuluTool[];
404
407
  toolConfigs?: ExuluAgentToolConfig[];
405
- providerapikey: string;
408
+ providerapikey?: string | undefined;
406
409
  contexts?: ExuluContext[] | undefined;
407
410
  exuluConfig?: ExuluConfig;
408
411
  instructions?: string;
@@ -417,12 +420,12 @@ type VectorOperationResponse = Promise<{
417
420
  results: any;
418
421
  errors?: string[];
419
422
  }>;
420
- type VectorGenerateOperation = (inputs: ChunkerResponse) => VectorGenerationResponse;
423
+ type VectorGenerateOperation = (inputs: ChunkerResponse, settings: Record<string, string>) => VectorGenerationResponse;
421
424
  type ChunkerOperation = (item: Item & {
422
425
  id: string;
423
426
  }, maxChunkSize: number, utils: {
424
427
  storage: ExuluStorage;
425
- }) => Promise<ChunkerResponse>;
428
+ }, config: Record<string, string>) => Promise<ChunkerResponse>;
426
429
  type ChunkerResponse = {
427
430
  item: Item & {
428
431
  id: string;
@@ -440,6 +443,11 @@ type VectorGenerationResponse = Promise<{
440
443
  vector: number[];
441
444
  }[];
442
445
  }>;
446
+ type ExuluEmbedderConfig = {
447
+ name: string;
448
+ description: string;
449
+ default?: string;
450
+ };
443
451
  declare class ExuluEmbedder {
444
452
  id: string;
445
453
  name: string;
@@ -448,23 +456,26 @@ declare class ExuluEmbedder {
448
456
  private generateEmbeddings;
449
457
  description: string;
450
458
  vectorDimensions: number;
459
+ config?: ExuluEmbedderConfig[];
451
460
  maxChunkSize: number;
452
461
  _chunker: ChunkerOperation;
453
- constructor({ id, name, description, generateEmbeddings, queue, vectorDimensions, maxChunkSize, chunker }: {
462
+ constructor({ id, name, description, generateEmbeddings, queue, vectorDimensions, maxChunkSize, chunker, config }: {
454
463
  id: string;
455
464
  name: string;
456
465
  description: string;
466
+ config?: ExuluEmbedderConfig[];
457
467
  generateEmbeddings: VectorGenerateOperation;
458
468
  chunker: ChunkerOperation;
459
469
  queue?: Promise<ExuluQueueConfig>;
460
470
  vectorDimensions: number;
461
471
  maxChunkSize: number;
462
472
  });
463
- chunker: (item: Item & {
473
+ chunker: (context: string, item: Item & {
464
474
  id: string;
465
475
  }, maxChunkSize: number, config: ExuluConfig) => Promise<ChunkerResponse>;
466
- generateFromQuery(query: string, statistics?: ExuluStatisticParams, user?: number, role?: string): VectorGenerationResponse;
467
- generateFromDocument(input: Item, config: ExuluConfig, statistics?: ExuluStatisticParams, user?: number, role?: string): VectorGenerationResponse;
476
+ private hydrateEmbedderConfig;
477
+ generateFromQuery(context: string, query: string, statistics?: ExuluStatisticParams, user?: number, role?: string): VectorGenerationResponse;
478
+ generateFromDocument(context: string, input: Item, config: ExuluConfig, statistics?: ExuluStatisticParams, user?: number, role?: string): VectorGenerationResponse;
468
479
  }
469
480
  declare class ExuluTool {
470
481
  id: string;
@@ -1597,6 +1608,9 @@ declare const ExuluDefaultAgents: {
1597
1608
  sonnet4: ExuluAgent;
1598
1609
  sonnet45: ExuluAgent;
1599
1610
  };
1611
+ google: {
1612
+ vertexGemini25Flash: ExuluAgent;
1613
+ };
1600
1614
  openai: {
1601
1615
  gpt5Mini: ExuluAgent;
1602
1616
  gpt5: ExuluAgent;
package/dist/index.d.ts CHANGED
@@ -189,6 +189,7 @@ interface Agent {
189
189
  description: string;
190
190
  }[];
191
191
  maxContextLength?: number;
192
+ authenticationInformation?: string;
192
193
  capabilities?: {
193
194
  text: boolean;
194
195
  images: imageTypes$1[];
@@ -246,7 +247,7 @@ type ExuluAgentConfig = {
246
247
  instructions: string;
247
248
  model: {
248
249
  create: ({ apiKey }: {
249
- apiKey: string;
250
+ apiKey?: string | undefined;
250
251
  }) => LanguageModel;
251
252
  };
252
253
  outputSchema?: z.ZodType;
@@ -276,6 +277,7 @@ interface ExuluAgentParams {
276
277
  config?: ExuluAgentConfig | undefined;
277
278
  queue?: ExuluQueueConfig;
278
279
  maxContextLength?: number;
280
+ authenticationInformation?: string;
279
281
  provider: string;
280
282
  capabilities?: {
281
283
  text: boolean;
@@ -359,13 +361,14 @@ declare class ExuluAgent {
359
361
  slug: string;
360
362
  type: "agent";
361
363
  streaming: boolean;
364
+ authenticationInformation?: string;
362
365
  maxContextLength?: number;
363
366
  queue?: ExuluQueueConfig;
364
367
  rateLimit?: RateLimiterRule;
365
368
  config?: ExuluAgentConfig | undefined;
366
369
  model?: {
367
370
  create: ({ apiKey }: {
368
- apiKey: string;
371
+ apiKey?: string | undefined;
369
372
  }) => LanguageModel;
370
373
  };
371
374
  capabilities: {
@@ -375,7 +378,7 @@ declare class ExuluAgent {
375
378
  audio: string[];
376
379
  video: string[];
377
380
  };
378
- constructor({ id, name, description, config, rateLimit, capabilities, type, maxContextLength, provider, queue }: ExuluAgentParams);
381
+ constructor({ id, name, description, config, rateLimit, capabilities, type, maxContextLength, provider, queue, authenticationInformation }: ExuluAgentParams);
379
382
  get providerName(): string;
380
383
  get modelName(): string;
381
384
  tool: (instance: string, agents: ExuluAgent[]) => Promise<ExuluTool | null>;
@@ -388,7 +391,7 @@ declare class ExuluAgent {
388
391
  allExuluTools?: ExuluTool[];
389
392
  statistics?: ExuluStatisticParams;
390
393
  toolConfigs?: ExuluAgentToolConfig[];
391
- providerapikey: string;
394
+ providerapikey?: string | undefined;
392
395
  contexts?: ExuluContext[] | undefined;
393
396
  exuluConfig?: ExuluConfig;
394
397
  instructions?: string;
@@ -402,7 +405,7 @@ declare class ExuluAgent {
402
405
  currentTools?: ExuluTool[];
403
406
  allExuluTools?: ExuluTool[];
404
407
  toolConfigs?: ExuluAgentToolConfig[];
405
- providerapikey: string;
408
+ providerapikey?: string | undefined;
406
409
  contexts?: ExuluContext[] | undefined;
407
410
  exuluConfig?: ExuluConfig;
408
411
  instructions?: string;
@@ -417,12 +420,12 @@ type VectorOperationResponse = Promise<{
417
420
  results: any;
418
421
  errors?: string[];
419
422
  }>;
420
- type VectorGenerateOperation = (inputs: ChunkerResponse) => VectorGenerationResponse;
423
+ type VectorGenerateOperation = (inputs: ChunkerResponse, settings: Record<string, string>) => VectorGenerationResponse;
421
424
  type ChunkerOperation = (item: Item & {
422
425
  id: string;
423
426
  }, maxChunkSize: number, utils: {
424
427
  storage: ExuluStorage;
425
- }) => Promise<ChunkerResponse>;
428
+ }, config: Record<string, string>) => Promise<ChunkerResponse>;
426
429
  type ChunkerResponse = {
427
430
  item: Item & {
428
431
  id: string;
@@ -440,6 +443,11 @@ type VectorGenerationResponse = Promise<{
440
443
  vector: number[];
441
444
  }[];
442
445
  }>;
446
+ type ExuluEmbedderConfig = {
447
+ name: string;
448
+ description: string;
449
+ default?: string;
450
+ };
443
451
  declare class ExuluEmbedder {
444
452
  id: string;
445
453
  name: string;
@@ -448,23 +456,26 @@ declare class ExuluEmbedder {
448
456
  private generateEmbeddings;
449
457
  description: string;
450
458
  vectorDimensions: number;
459
+ config?: ExuluEmbedderConfig[];
451
460
  maxChunkSize: number;
452
461
  _chunker: ChunkerOperation;
453
- constructor({ id, name, description, generateEmbeddings, queue, vectorDimensions, maxChunkSize, chunker }: {
462
+ constructor({ id, name, description, generateEmbeddings, queue, vectorDimensions, maxChunkSize, chunker, config }: {
454
463
  id: string;
455
464
  name: string;
456
465
  description: string;
466
+ config?: ExuluEmbedderConfig[];
457
467
  generateEmbeddings: VectorGenerateOperation;
458
468
  chunker: ChunkerOperation;
459
469
  queue?: Promise<ExuluQueueConfig>;
460
470
  vectorDimensions: number;
461
471
  maxChunkSize: number;
462
472
  });
463
- chunker: (item: Item & {
473
+ chunker: (context: string, item: Item & {
464
474
  id: string;
465
475
  }, maxChunkSize: number, config: ExuluConfig) => Promise<ChunkerResponse>;
466
- generateFromQuery(query: string, statistics?: ExuluStatisticParams, user?: number, role?: string): VectorGenerationResponse;
467
- generateFromDocument(input: Item, config: ExuluConfig, statistics?: ExuluStatisticParams, user?: number, role?: string): VectorGenerationResponse;
476
+ private hydrateEmbedderConfig;
477
+ generateFromQuery(context: string, query: string, statistics?: ExuluStatisticParams, user?: number, role?: string): VectorGenerationResponse;
478
+ generateFromDocument(context: string, input: Item, config: ExuluConfig, statistics?: ExuluStatisticParams, user?: number, role?: string): VectorGenerationResponse;
468
479
  }
469
480
  declare class ExuluTool {
470
481
  id: string;
@@ -1597,6 +1608,9 @@ declare const ExuluDefaultAgents: {
1597
1608
  sonnet4: ExuluAgent;
1598
1609
  sonnet45: ExuluAgent;
1599
1610
  };
1611
+ google: {
1612
+ vertexGemini25Flash: ExuluAgent;
1613
+ };
1600
1614
  openai: {
1601
1615
  gpt5Mini: ExuluAgent;
1602
1616
  gpt5: ExuluAgent;