@exulu/backend 1.27.2 → 1.28.1

package/dist/index.d.cts

@@ -2,9 +2,10 @@ import * as _opentelemetry_sdk_node from '@opentelemetry/sdk-node';
 import * as bullmq from 'bullmq';
 import { Queue } from 'bullmq';
 import { RedisClientType } from 'redis';
+import * as ai from 'ai';
+import { UIMessage, Tool, LanguageModel } from 'ai';
 import { z } from 'zod';
-import { Tool, LanguageModel, UIMessage } from 'ai';
-import { Express, Response, Request } from 'express';
+import { Express } from 'express';
 import { transport } from 'winston';
 import { Knex } from 'knex';
 import { Tiktoken } from 'tiktoken/lite';
@@ -74,7 +75,7 @@ type ExuluConfig = {
     MCP: {
         enabled: boolean;
     };
-    fileUploads: {
+    fileUploads?: {
         s3region: string;
         s3key: string;
         s3secret: string;
@@ -86,15 +87,17 @@ type ExuluConfig = {
 declare class ExuluApp {
     private _agents;
     private _config?;
+    private _evals;
     private _queues;
     private _contexts?;
     private _tools;
     private _expressApp;
     constructor();
-    create: ({ contexts, agents, config, tools }: {
+    create: ({ contexts, agents, config, tools, evals }: {
         contexts?: Record<string, ExuluContext>;
         config: ExuluConfig;
         agents?: ExuluAgent[];
+        evals?: ExuluEval[];
         tools?: ExuluTool[];
     }) => Promise<ExuluApp>;
     express: {
@@ -127,7 +130,7 @@ declare class ExuluApp {
     };
     bullmq: {
         workers: {
-            create: () => Promise<bullmq.Worker<any, any, string>[]>;
+            create: (queues?: string[] | undefined) => Promise<bullmq.Worker<any, any, string>[]>;
         };
     };
     private server;
@@ -152,6 +155,85 @@ type User = {
     };
 };
 
+interface Agent {
+    id: string;
+    modelName?: string;
+    providerName?: string;
+    backend: string;
+    type: "agent";
+    name: string;
+    image?: string;
+    providerapikey?: string;
+    firewall?: {
+        enabled: boolean;
+        scanners?: {
+            promptGuard: boolean;
+            codeShield: boolean;
+            agentAlignment: boolean;
+            hiddenAscii: boolean;
+            piiDetection: boolean;
+        };
+    };
+    active?: boolean;
+    description?: string;
+    instructions?: string;
+    slug?: string;
+    tools?: {
+        id: string;
+        type: string;
+        config: {
+            name: string;
+            variable: string;
+        }[];
+        name: string;
+        description: string;
+    }[];
+    maxContextLength?: number;
+    capabilities?: {
+        text: boolean;
+        images: imageTypes$1[];
+        files: fileTypes$1[];
+        audio: audioTypes$1[];
+        video: videoTypes$1[];
+    };
+    rights_mode?: 'private' | 'users' | 'roles' | 'public' | 'projects';
+    created_by?: string;
+    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;
+}
+type imageTypes$1 = '.png' | '.jpg' | '.jpeg' | '.gif' | '.webp';
+type fileTypes$1 = '.pdf' | '.docx' | '.xlsx' | '.xls' | '.csv' | '.pptx' | '.ppt';
+type audioTypes$1 = '.mp3' | '.wav' | '.m4a' | '.mp4' | '.mpeg';
+type videoTypes$1 = '.mp4' | '.m4a' | '.mp3' | '.mpeg' | '.wav';
+
+interface TestCase {
+    id: string;
+    name: string;
+    description?: string;
+    inputs: UIMessage[];
+    expected_output: string;
+    expected_tools?: string[];
+    expected_knowledge_sources?: string[];
+    expected_agent_tools?: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+
 interface RateLimiterRule {
     name?: string;
     rate_limit: {
@@ -192,6 +274,7 @@ interface ExuluAgentParams {
     type: "agent";
     description: string;
     config?: ExuluAgentConfig | undefined;
+    queue?: ExuluQueueConfig;
     maxContextLength?: number;
     provider: string;
     capabilities?: {
@@ -203,7 +286,6 @@ interface ExuluAgentParams {
     };
     outputSchema?: z.ZodType;
     rateLimit?: RateLimiterRule;
-    evals?: ExuluEval[];
 }
 interface ExuluAgentToolConfig {
     id: string;
@@ -217,7 +299,13 @@ interface ExuluAgentToolConfig {
 type ExuluQueueConfig = {
     queue: Queue;
     ratelimit: number;
+    timeoutInSeconds?: number;
     concurrency: number;
+    retries?: number;
+    backoff?: {
+        type: 'exponential' | 'linear';
+        delay: number;
+    };
 };
 type ExuluEvalTokenMetadata = {
     totalTokens?: number;
@@ -234,29 +322,33 @@ interface ExuluEvalParams {
     id: string;
     name: string;
     description: string;
+    llm: boolean;
     execute: (params: {
+        agent: Agent;
+        backend: ExuluAgent;
         messages: UIMessage[];
-        metadata: ExuluEvalMetadata;
+        testCase: TestCase;
         config?: Record<string, any>;
     }) => Promise<number>;
     config?: {
         name: string;
         description: string;
     }[];
-    queue: ExuluQueueConfig;
+    queue: Promise<ExuluQueueConfig>;
 }
 declare class ExuluEval {
     id: string;
     name: string;
     description: string;
+    llm: boolean;
     private execute;
     config?: {
         name: string;
         description: string;
     }[];
-    queue: ExuluQueueConfig;
-    constructor({ id, name, description, execute, config, queue }: ExuluEvalParams);
-    run(messages: UIMessage[], metadata: ExuluEvalMetadata, config?: Record<string, any>): Promise<number>;
+    queue?: Promise<ExuluQueueConfig>;
+    constructor({ id, name, description, execute, config, queue, llm }: ExuluEvalParams);
+    run(agent: Agent, backend: ExuluAgent, testCase: TestCase, messages: UIMessage[], config?: Record<string, any>): Promise<number>;
 }
 declare class ExuluAgent {
     id: string;
@@ -267,9 +359,9 @@ declare class ExuluAgent {
     type: "agent";
     streaming: boolean;
     maxContextLength?: number;
+    queue?: ExuluQueueConfig;
     rateLimit?: RateLimiterRule;
     config?: ExuluAgentConfig | undefined;
-    evals?: ExuluEval[];
     model?: {
         create: ({ apiKey }: {
             apiKey: string;
@@ -282,15 +374,15 @@ declare class ExuluAgent {
         audio: string[];
         video: string[];
     };
-    constructor({ id, name, description, config, rateLimit, capabilities, type, maxContextLength, evals, provider }: ExuluAgentParams);
+    constructor({ id, name, description, config, rateLimit, capabilities, type, maxContextLength, provider, queue }: ExuluAgentParams);
     get providerName(): string;
     get modelName(): string;
     tool: (instance: string, agents: ExuluAgent[]) => Promise<ExuluTool | null>;
-    generateSync: ({ prompt, user, session, message, currentTools, allExuluTools, statistics, toolConfigs, providerapikey, contexts, exuluConfig, outputSchema, instructions }: {
+    generateSync: ({ prompt, user, session, inputMessages, currentTools, allExuluTools, statistics, toolConfigs, providerapikey, contexts, exuluConfig, outputSchema, instructions }: {
         prompt?: string;
         user?: User;
         session?: string;
-        message?: UIMessage;
+        inputMessages?: UIMessage[];
         currentTools?: ExuluTool[];
         allExuluTools?: ExuluTool[];
         statistics?: ExuluStatisticParams;
@@ -301,23 +393,23 @@ declare class ExuluAgent {
         instructions?: string;
         outputSchema?: z.ZodType;
     }) => Promise<string | any>;
-    generateStream: ({ express, user, session, message, currentTools, allExuluTools, statistics, toolConfigs, providerapikey, contexts, exuluConfig, instructions, }: {
-        express: {
-            res: Response;
-            req: Request;
-        };
+    generateStream: ({ user, session, message, previousMessages, currentTools, allExuluTools, toolConfigs, providerapikey, contexts, exuluConfig, instructions, }: {
         user: User;
-        session: string;
+        session?: string;
         message?: UIMessage;
+        previousMessages?: UIMessage[];
         currentTools?: ExuluTool[];
         allExuluTools?: ExuluTool[];
-        statistics?: ExuluStatisticParams;
         toolConfigs?: ExuluAgentToolConfig[];
         providerapikey: string;
         contexts?: ExuluContext[] | undefined;
         exuluConfig?: ExuluConfig;
         instructions?: string;
-    }) => Promise<void>;
+    }) => Promise<{
+        stream: ai.StreamTextResult<Record<string, Tool>, never>;
+        originalMessages: UIMessage<unknown, ai.UIDataTypes, ai.UITools>[];
+        previousMessages: UIMessage<unknown, ai.UIDataTypes, ai.UITools>[];
+    }>;
 }
 type VectorOperationResponse = Promise<{
     count: number;
@@ -425,6 +517,7 @@ type ExuluContextFieldProcessor = {
     }) => Promise<string>;
     config?: {
         queue?: Promise<ExuluQueueConfig>;
+        timeoutInSeconds?: number;
         trigger: "manual" | "onUpdate" | "onCreate" | "always";
     };
 };
@@ -494,9 +587,18 @@ declare class ExuluContext {
         chunks?: number;
         job?: string;
     }>;
-    private createItem;
-    private updateItem;
-    private deleteItem;
+    createItem: (item: Item, config: ExuluConfig, user?: number, role?: string, upsert?: boolean) => Promise<{
+        item: Item;
+        job?: string;
+    }>;
+    updateItem: (item: Item, config: ExuluConfig, user?: number, role?: string) => Promise<{
+        item: Item;
+        job?: string;
+    }>;
+    deleteItem: (item: Item, user?: number, role?: string) => Promise<{
+        id: string;
+        job?: string;
+    }>;
     embeddings: {
         generate: {
             one: ({ item, user, role, trigger, config }: {
@@ -549,15 +651,46 @@ declare class ExuluQueues {
         concurrency: number;
     }[];
     constructor();
+    list: Map<string, {
+        name: string;
+        concurrency: number;
+        ratelimit: number;
+        use: () => Promise<ExuluQueueConfig>;
+    }>;
     queue(name: string): {
         queue: Queue;
         ratelimit: number;
         concurrency: number;
     } | undefined;
-    use: (name: string, concurrency?: number, ratelimit?: number) => Promise<ExuluQueueConfig>;
+    register: (name: string, concurrency?: number, ratelimit?: number) => {
+        use: () => Promise<ExuluQueueConfig>;
+    };
 }
 declare const queues: ExuluQueues;
 
+/**
+ * Create metadata for console logging that will be used by S3 transport
+ * to group logs by ID and store them in S3 with the ID as prefix
+ *
+ * @param id - The ID to group logs by (e.g., job ID, request ID, etc.)
+ * @param additionalMetadata - Any additional metadata to include with the log
+ * @returns Metadata object to pass as the last argument to console methods
+ *
+ * @example
+ * ```typescript
+ * import { logMetadata } from './registry/log-metadata';
+ *
+ * const jobId = 'job-123';
+ * console.log('Starting job', logMetadata(jobId));
+ * console.log('Processing...', logMetadata(jobId, { step: 'validation' }));
+ * console.error('Job failed', logMetadata(jobId, { error: 'timeout' }));
+ * ```
+ */
+declare function logMetadata(id: string, additionalMetadata?: Record<string, any>): {
+    __logMetadata: boolean;
+    id: string;
+};
+
 /**
  * Represents the data structure for a chunk object.
  *
@@ -1500,4 +1633,4 @@ declare const ExuluChunkers: {
     };
 };
 
-export { type JOB_STATUS as EXULU_JOB_STATUS, JOB_STATUS_ENUM as EXULU_JOB_STATUS_ENUM, type STATISTICS_TYPE as EXULU_STATISTICS_TYPE, STATISTICS_TYPE_ENUM as EXULU_STATISTICS_TYPE_ENUM, ExuluAgent, ExuluApp, authentication as ExuluAuthentication, ExuluChunkers, ExuluContext, ExuluDefaultAgents, ExuluDefaultContexts, ExuluEmbedder, ExuluEval, type ExuluEvalMetadata, type ExuluEvalTokenMetadata, ExuluJobs, ExuluOtel, type ExuluQueueConfig, queues as ExuluQueues, ExuluTool, ExuluUtils, ExuluVariables, db };
+export { type JOB_STATUS as EXULU_JOB_STATUS, JOB_STATUS_ENUM as EXULU_JOB_STATUS_ENUM, type STATISTICS_TYPE as EXULU_STATISTICS_TYPE, STATISTICS_TYPE_ENUM as EXULU_STATISTICS_TYPE_ENUM, ExuluAgent, ExuluApp, authentication as ExuluAuthentication, ExuluChunkers, ExuluContext, ExuluDefaultAgents, ExuluDefaultContexts, ExuluEmbedder, ExuluEval, type ExuluEvalMetadata, type ExuluEvalTokenMetadata, ExuluJobs, ExuluOtel, type ExuluQueueConfig, queues as ExuluQueues, ExuluTool, ExuluUtils, ExuluVariables, db, logMetadata };

package/dist/index.d.ts

@@ -2,9 +2,10 @@ import * as _opentelemetry_sdk_node from '@opentelemetry/sdk-node';
 import * as bullmq from 'bullmq';
 import { Queue } from 'bullmq';
 import { RedisClientType } from 'redis';
+import * as ai from 'ai';
+import { UIMessage, Tool, LanguageModel } from 'ai';
 import { z } from 'zod';
-import { Tool, LanguageModel, UIMessage } from 'ai';
-import { Express, Response, Request } from 'express';
+import { Express } from 'express';
 import { transport } from 'winston';
 import { Knex } from 'knex';
 import { Tiktoken } from 'tiktoken/lite';
@@ -74,7 +75,7 @@ type ExuluConfig = {
     MCP: {
         enabled: boolean;
     };
-    fileUploads: {
+    fileUploads?: {
         s3region: string;
         s3key: string;
         s3secret: string;
@@ -86,15 +87,17 @@ type ExuluConfig = {
 declare class ExuluApp {
     private _agents;
     private _config?;
+    private _evals;
     private _queues;
     private _contexts?;
     private _tools;
     private _expressApp;
     constructor();
-    create: ({ contexts, agents, config, tools }: {
+    create: ({ contexts, agents, config, tools, evals }: {
         contexts?: Record<string, ExuluContext>;
         config: ExuluConfig;
         agents?: ExuluAgent[];
+        evals?: ExuluEval[];
         tools?: ExuluTool[];
     }) => Promise<ExuluApp>;
     express: {
@@ -127,7 +130,7 @@ declare class ExuluApp {
     };
     bullmq: {
         workers: {
-            create: () => Promise<bullmq.Worker<any, any, string>[]>;
+            create: (queues?: string[] | undefined) => Promise<bullmq.Worker<any, any, string>[]>;
         };
     };
     private server;
@@ -152,6 +155,85 @@ type User = {
     };
 };
 
+interface Agent {
+    id: string;
+    modelName?: string;
+    providerName?: string;
+    backend: string;
+    type: "agent";
+    name: string;
+    image?: string;
+    providerapikey?: string;
+    firewall?: {
+        enabled: boolean;
+        scanners?: {
+            promptGuard: boolean;
+            codeShield: boolean;
+            agentAlignment: boolean;
+            hiddenAscii: boolean;
+            piiDetection: boolean;
+        };
+    };
+    active?: boolean;
+    description?: string;
+    instructions?: string;
+    slug?: string;
+    tools?: {
+        id: string;
+        type: string;
+        config: {
+            name: string;
+            variable: string;
+        }[];
+        name: string;
+        description: string;
+    }[];
+    maxContextLength?: number;
+    capabilities?: {
+        text: boolean;
+        images: imageTypes$1[];
+        files: fileTypes$1[];
+        audio: audioTypes$1[];
+        video: videoTypes$1[];
+    };
+    rights_mode?: 'private' | 'users' | 'roles' | 'public' | 'projects';
+    created_by?: string;
+    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;
+}
+type imageTypes$1 = '.png' | '.jpg' | '.jpeg' | '.gif' | '.webp';
+type fileTypes$1 = '.pdf' | '.docx' | '.xlsx' | '.xls' | '.csv' | '.pptx' | '.ppt';
+type audioTypes$1 = '.mp3' | '.wav' | '.m4a' | '.mp4' | '.mpeg';
+type videoTypes$1 = '.mp4' | '.m4a' | '.mp3' | '.mpeg' | '.wav';
+
+interface TestCase {
+    id: string;
+    name: string;
+    description?: string;
+    inputs: UIMessage[];
+    expected_output: string;
+    expected_tools?: string[];
+    expected_knowledge_sources?: string[];
+    expected_agent_tools?: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+
 interface RateLimiterRule {
     name?: string;
     rate_limit: {
@@ -192,6 +274,7 @@ interface ExuluAgentParams {
     type: "agent";
     description: string;
     config?: ExuluAgentConfig | undefined;
+    queue?: ExuluQueueConfig;
     maxContextLength?: number;
     provider: string;
     capabilities?: {
@@ -203,7 +286,6 @@ interface ExuluAgentParams {
     };
     outputSchema?: z.ZodType;
     rateLimit?: RateLimiterRule;
-    evals?: ExuluEval[];
 }
 interface ExuluAgentToolConfig {
     id: string;
@@ -217,7 +299,13 @@ interface ExuluAgentToolConfig {
 type ExuluQueueConfig = {
     queue: Queue;
     ratelimit: number;
+    timeoutInSeconds?: number;
     concurrency: number;
+    retries?: number;
+    backoff?: {
+        type: 'exponential' | 'linear';
+        delay: number;
+    };
 };
 type ExuluEvalTokenMetadata = {
     totalTokens?: number;
@@ -234,29 +322,33 @@ interface ExuluEvalParams {
     id: string;
     name: string;
     description: string;
+    llm: boolean;
     execute: (params: {
+        agent: Agent;
+        backend: ExuluAgent;
         messages: UIMessage[];
-        metadata: ExuluEvalMetadata;
+        testCase: TestCase;
         config?: Record<string, any>;
     }) => Promise<number>;
     config?: {
         name: string;
         description: string;
     }[];
-    queue: ExuluQueueConfig;
+    queue: Promise<ExuluQueueConfig>;
 }
 declare class ExuluEval {
     id: string;
     name: string;
     description: string;
+    llm: boolean;
     private execute;
     config?: {
         name: string;
         description: string;
     }[];
-    queue: ExuluQueueConfig;
-    constructor({ id, name, description, execute, config, queue }: ExuluEvalParams);
-    run(messages: UIMessage[], metadata: ExuluEvalMetadata, config?: Record<string, any>): Promise<number>;
+    queue?: Promise<ExuluQueueConfig>;
+    constructor({ id, name, description, execute, config, queue, llm }: ExuluEvalParams);
+    run(agent: Agent, backend: ExuluAgent, testCase: TestCase, messages: UIMessage[], config?: Record<string, any>): Promise<number>;
 }
 declare class ExuluAgent {
     id: string;
@@ -267,9 +359,9 @@ declare class ExuluAgent {
     type: "agent";
     streaming: boolean;
     maxContextLength?: number;
+    queue?: ExuluQueueConfig;
     rateLimit?: RateLimiterRule;
     config?: ExuluAgentConfig | undefined;
-    evals?: ExuluEval[];
     model?: {
         create: ({ apiKey }: {
             apiKey: string;
@@ -282,15 +374,15 @@ declare class ExuluAgent {
         audio: string[];
         video: string[];
     };
-    constructor({ id, name, description, config, rateLimit, capabilities, type, maxContextLength, evals, provider }: ExuluAgentParams);
+    constructor({ id, name, description, config, rateLimit, capabilities, type, maxContextLength, provider, queue }: ExuluAgentParams);
     get providerName(): string;
     get modelName(): string;
     tool: (instance: string, agents: ExuluAgent[]) => Promise<ExuluTool | null>;
-    generateSync: ({ prompt, user, session, message, currentTools, allExuluTools, statistics, toolConfigs, providerapikey, contexts, exuluConfig, outputSchema, instructions }: {
+    generateSync: ({ prompt, user, session, inputMessages, currentTools, allExuluTools, statistics, toolConfigs, providerapikey, contexts, exuluConfig, outputSchema, instructions }: {
         prompt?: string;
         user?: User;
         session?: string;
-        message?: UIMessage;
+        inputMessages?: UIMessage[];
         currentTools?: ExuluTool[];
         allExuluTools?: ExuluTool[];
         statistics?: ExuluStatisticParams;
@@ -301,23 +393,23 @@ declare class ExuluAgent {
         instructions?: string;
         outputSchema?: z.ZodType;
     }) => Promise<string | any>;
-    generateStream: ({ express, user, session, message, currentTools, allExuluTools, statistics, toolConfigs, providerapikey, contexts, exuluConfig, instructions, }: {
-        express: {
-            res: Response;
-            req: Request;
-        };
+    generateStream: ({ user, session, message, previousMessages, currentTools, allExuluTools, toolConfigs, providerapikey, contexts, exuluConfig, instructions, }: {
         user: User;
-        session: string;
+        session?: string;
         message?: UIMessage;
+        previousMessages?: UIMessage[];
         currentTools?: ExuluTool[];
         allExuluTools?: ExuluTool[];
-        statistics?: ExuluStatisticParams;
         toolConfigs?: ExuluAgentToolConfig[];
         providerapikey: string;
         contexts?: ExuluContext[] | undefined;
         exuluConfig?: ExuluConfig;
         instructions?: string;
-    }) => Promise<void>;
+    }) => Promise<{
+        stream: ai.StreamTextResult<Record<string, Tool>, never>;
+        originalMessages: UIMessage<unknown, ai.UIDataTypes, ai.UITools>[];
+        previousMessages: UIMessage<unknown, ai.UIDataTypes, ai.UITools>[];
+    }>;
 }
 type VectorOperationResponse = Promise<{
     count: number;
@@ -425,6 +517,7 @@ type ExuluContextFieldProcessor = {
     }) => Promise<string>;
     config?: {
         queue?: Promise<ExuluQueueConfig>;
+        timeoutInSeconds?: number;
         trigger: "manual" | "onUpdate" | "onCreate" | "always";
     };
 };
@@ -494,9 +587,18 @@ declare class ExuluContext {
         chunks?: number;
         job?: string;
     }>;
-    private createItem;
-    private updateItem;
-    private deleteItem;
+    createItem: (item: Item, config: ExuluConfig, user?: number, role?: string, upsert?: boolean) => Promise<{
+        item: Item;
+        job?: string;
+    }>;
+    updateItem: (item: Item, config: ExuluConfig, user?: number, role?: string) => Promise<{
+        item: Item;
+        job?: string;
+    }>;
+    deleteItem: (item: Item, user?: number, role?: string) => Promise<{
+        id: string;
+        job?: string;
+    }>;
     embeddings: {
         generate: {
             one: ({ item, user, role, trigger, config }: {
@@ -549,15 +651,46 @@ declare class ExuluQueues {
         concurrency: number;
     }[];
     constructor();
+    list: Map<string, {
+        name: string;
+        concurrency: number;
+        ratelimit: number;
+        use: () => Promise<ExuluQueueConfig>;
+    }>;
     queue(name: string): {
         queue: Queue;
         ratelimit: number;
         concurrency: number;
     } | undefined;
-    use: (name: string, concurrency?: number, ratelimit?: number) => Promise<ExuluQueueConfig>;
+    register: (name: string, concurrency?: number, ratelimit?: number) => {
+        use: () => Promise<ExuluQueueConfig>;
+    };
 }
 declare const queues: ExuluQueues;
 
+/**
+ * Create metadata for console logging that will be used by S3 transport
+ * to group logs by ID and store them in S3 with the ID as prefix
+ *
+ * @param id - The ID to group logs by (e.g., job ID, request ID, etc.)
+ * @param additionalMetadata - Any additional metadata to include with the log
+ * @returns Metadata object to pass as the last argument to console methods
+ *
+ * @example
+ * ```typescript
+ * import { logMetadata } from './registry/log-metadata';
+ *
+ * const jobId = 'job-123';
+ * console.log('Starting job', logMetadata(jobId));
+ * console.log('Processing...', logMetadata(jobId, { step: 'validation' }));
+ * console.error('Job failed', logMetadata(jobId, { error: 'timeout' }));
+ * ```
+ */
+declare function logMetadata(id: string, additionalMetadata?: Record<string, any>): {
+    __logMetadata: boolean;
+    id: string;
+};
+
 /**
  * Represents the data structure for a chunk object.
  *
@@ -1500,4 +1633,4 @@ declare const ExuluChunkers: {
     };
 };
 
-export { type JOB_STATUS as EXULU_JOB_STATUS, JOB_STATUS_ENUM as EXULU_JOB_STATUS_ENUM, type STATISTICS_TYPE as EXULU_STATISTICS_TYPE, STATISTICS_TYPE_ENUM as EXULU_STATISTICS_TYPE_ENUM, ExuluAgent, ExuluApp, authentication as ExuluAuthentication, ExuluChunkers, ExuluContext, ExuluDefaultAgents, ExuluDefaultContexts, ExuluEmbedder, ExuluEval, type ExuluEvalMetadata, type ExuluEvalTokenMetadata, ExuluJobs, ExuluOtel, type ExuluQueueConfig, queues as ExuluQueues, ExuluTool, ExuluUtils, ExuluVariables, db };
+export { type JOB_STATUS as EXULU_JOB_STATUS, JOB_STATUS_ENUM as EXULU_JOB_STATUS_ENUM, type STATISTICS_TYPE as EXULU_STATISTICS_TYPE, STATISTICS_TYPE_ENUM as EXULU_STATISTICS_TYPE_ENUM, ExuluAgent, ExuluApp, authentication as ExuluAuthentication, ExuluChunkers, ExuluContext, ExuluDefaultAgents, ExuluDefaultContexts, ExuluEmbedder, ExuluEval, type ExuluEvalMetadata, type ExuluEvalTokenMetadata, ExuluJobs, ExuluOtel, type ExuluQueueConfig, queues as ExuluQueues, ExuluTool, ExuluUtils, ExuluVariables, db, logMetadata };