mojentic 1.0.0

package/dist/tracer/eventStore.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Event store for capturing and querying tracer events.
+ */
+import { TracerEvent, TracerEventConstructor } from './tracerEvents';
+/**
+ * Filter options for querying events.
+ */
+export interface FilterOptions {
+    /**
+     * Filter events by this specific event type
+     */
+    eventType?: TracerEventConstructor;
+    /**
+     * Include events with timestamp >= startTime
+     */
+    startTime?: number;
+    /**
+     * Include events with timestamp <= endTime
+     */
+    endTime?: number;
+    /**
+     * Custom filter function to apply to events
+     */
+    filterFunc?: (event: TracerEvent) => boolean;
+}
+/**
+ * Store for capturing and querying events, particularly useful for tracer events.
+ *
+ * @example
+ * ```typescript
+ * const store = new EventStore((event) => {
+ *   console.log('Event stored:', event.constructor.name);
+ * });
+ *
+ * store.store(new LLMCallTracerEvent('gpt-4', [], 0.7));
+ * const events = store.getEvents();
+ * ```
+ */
+export declare class EventStore {
+    private events;
+    private onStoreCallback?;
+    /**
+     * Initialize an EventStore.
+     *
+     * @param onStoreCallback - A callback function that will be called whenever an event is stored.
+     *                         The callback receives the stored event as its argument.
+     */
+    constructor(onStoreCallback?: (event: TracerEvent) => void);
+    /**
+     * Store an event in the event store.
+     *
+     * @param event - The event to store
+     */
+    store(event: TracerEvent): void;
+    /**
+     * Get events from the store, optionally filtered by type, time range, and custom filter function.
+     *
+     * @param options - Filter options for querying events
+     * @returns Events that match the filter criteria
+     *
+     * @example
+     * ```typescript
+     * // Get all LLM call events
+     * const llmCalls = store.getEvents({ eventType: LLMCallTracerEvent });
+     *
+     * // Get events in a time range
+     * const recent = store.getEvents({
+     *   startTime: Date.now() - 60000,
+     *   endTime: Date.now()
+     * });
+     *
+     * // Get events with custom filter
+     * const filtered = store.getEvents({
+     *   filterFunc: (e) => e.correlationId === 'my-id'
+     * });
+     * ```
+     */
+    getEvents(options?: FilterOptions): TracerEvent[];
+    /**
+     * Clear all events from the store.
+     */
+    clear(): void;
+    /**
+     * Get the last N events, optionally filtered by type.
+     *
+     * @param n - Number of events to return
+     * @param eventType - Optional event type to filter by
+     * @returns The last N events that match the filter criteria
+     *
+     * @example
+     * ```typescript
+     * // Get last 10 events
+     * const last10 = store.getLastNEvents(10);
+     *
+     * // Get last 5 LLM response events
+     * const last5Responses = store.getLastNEvents(5, LLMResponseTracerEvent);
+     * ```
+     */
+    getLastNEvents(n: number, eventType?: TracerEventConstructor): TracerEvent[];
+}
+//# sourceMappingURL=eventStore.d.ts.map

package/dist/tracer/eventStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventStore.d.ts","sourceRoot":"","sources":["../../src/tracer/eventStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,sBAAsB,CAAC;IAEnC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC;CAC9C;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,eAAe,CAAC,CAA+B;IAEvD;;;;;OAKG;gBACS,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;IAI1D;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAS/B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,WAAW,EAAE;IA4BrD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,sBAAsB,GAAG,WAAW,EAAE;CAS7E"}

package/dist/tracer/eventStore.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Event store for capturing and querying tracer events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventStore = void 0;
+/**
+ * Store for capturing and querying events, particularly useful for tracer events.
+ *
+ * @example
+ * ```typescript
+ * const store = new EventStore((event) => {
+ *   console.log('Event stored:', event.constructor.name);
+ * });
+ *
+ * store.store(new LLMCallTracerEvent('gpt-4', [], 0.7));
+ * const events = store.getEvents();
+ * ```
+ */
+class EventStore {
+    events = [];
+    onStoreCallback;
+    /**
+     * Initialize an EventStore.
+     *
+     * @param onStoreCallback - A callback function that will be called whenever an event is stored.
+     *                         The callback receives the stored event as its argument.
+     */
+    constructor(onStoreCallback) {
+        this.onStoreCallback = onStoreCallback;
+    }
+    /**
+     * Store an event in the event store.
+     *
+     * @param event - The event to store
+     */
+    store(event) {
+        this.events.push(event);
+        // Call the callback if it exists
+        if (this.onStoreCallback) {
+            this.onStoreCallback(event);
+        }
+    }
+    /**
+     * Get events from the store, optionally filtered by type, time range, and custom filter function.
+     *
+     * @param options - Filter options for querying events
+     * @returns Events that match the filter criteria
+     *
+     * @example
+     * ```typescript
+     * // Get all LLM call events
+     * const llmCalls = store.getEvents({ eventType: LLMCallTracerEvent });
+     *
+     * // Get events in a time range
+     * const recent = store.getEvents({
+     *   startTime: Date.now() - 60000,
+     *   endTime: Date.now()
+     * });
+     *
+     * // Get events with custom filter
+     * const filtered = store.getEvents({
+     *   filterFunc: (e) => e.correlationId === 'my-id'
+     * });
+     * ```
+     */
+    getEvents(options = {}) {
+        let result = [...this.events];
+        // Filter by event type if specified
+        const { eventType } = options;
+        if (eventType) {
+            result = result.filter((e) => e instanceof eventType);
+        }
+        // Filter by time range
+        const { startTime } = options;
+        if (startTime !== undefined) {
+            result = result.filter((e) => e.timestamp >= startTime);
+        }
+        const { endTime } = options;
+        if (endTime !== undefined) {
+            result = result.filter((e) => e.timestamp <= endTime);
+        }
+        // Apply custom filter function if provided
+        if (options.filterFunc) {
+            result = result.filter(options.filterFunc);
+        }
+        return result;
+    }
+    /**
+     * Clear all events from the store.
+     */
+    clear() {
+        this.events = [];
+    }
+    /**
+     * Get the last N events, optionally filtered by type.
+     *
+     * @param n - Number of events to return
+     * @param eventType - Optional event type to filter by
+     * @returns The last N events that match the filter criteria
+     *
+     * @example
+     * ```typescript
+     * // Get last 10 events
+     * const last10 = store.getLastNEvents(10);
+     *
+     * // Get last 5 LLM response events
+     * const last5Responses = store.getLastNEvents(5, LLMResponseTracerEvent);
+     * ```
+     */
+    getLastNEvents(n, eventType) {
+        let filtered = this.events;
+        if (eventType) {
+            filtered = filtered.filter((e) => e instanceof eventType);
+        }
+        return filtered.slice(-n);
+    }
+}
+exports.EventStore = EventStore;
+//# sourceMappingURL=eventStore.js.map

package/dist/tracer/eventStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventStore.js","sourceRoot":"","sources":["../../src/tracer/eventStore.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA6BH;;;;;;;;;;;;GAYG;AACH,MAAa,UAAU;IACb,MAAM,GAAkB,EAAE,CAAC;IAC3B,eAAe,CAAgC;IAEvD;;;;;OAKG;IACH,YAAY,eAA8C;QACxD,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAkB;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExB,iCAAiC;QACjC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,CAAC,UAAyB,EAAE;QACnC,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAE9B,oCAAoC;QACpC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAC9B,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,SAAS,CAAC,CAAC;QACxD,CAAC;QAED,uBAAuB;QACvB,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAC9B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAC5B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC;QACxD,CAAC;QAED,2CAA2C;QAC3C,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,CAAS,EAAE,SAAkC;QAC1D,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,IAAI,SAAS,EAAE,CAAC;YACd,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,SAAS,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;CACF;AA/GD,gCA+GC"}

package/dist/tracer/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tracer system exports
+ */
+export * from './tracerEvents';
+export * from './eventStore';
+export * from './tracerSystem';
+export * from './nullTracer';
+//# sourceMappingURL=index.d.ts.map

package/dist/tracer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracer/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/tracer/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Tracer system exports
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./tracerEvents"), exports);
+__exportStar(require("./eventStore"), exports);
+__exportStar(require("./tracerSystem"), exports);
+__exportStar(require("./nullTracer"), exports);
+//# sourceMappingURL=index.js.map

package/dist/tracer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracer/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,iDAA+B;AAC/B,+CAA6B;AAC7B,iDAA+B;AAC/B,+CAA6B"}

package/dist/tracer/nullTracer.d.ts

@@ -0,0 +1,127 @@
+/**
+ * NullTracer implementation to eliminate conditional checks in the code.
+ *
+ * This module provides a NullTracer that implements the same interface as TracerSystem
+ * but performs no operations, following the Null Object Pattern.
+ */
+import { TracerEvent, TracerEventConstructor } from './tracerEvents';
+import { ToolCall } from '../llm/models';
+import { FilterOptions } from './eventStore';
+/**
+ * A no-op implementation of TracerSystem that silently discards all tracing operations.
+ *
+ * This class follows the Null Object Pattern to eliminate conditional checks in client code.
+ * All record methods are overridden to do nothing, and all query methods return empty results.
+ *
+ * @example
+ * ```typescript
+ * import { nullTracer } from './tracer';
+ *
+ * // Use nullTracer when you don't want any tracing
+ * const broker = new LlmBroker('gpt-4', gateway, nullTracer);
+ *
+ * // All tracer methods are no-ops
+ * nullTracer.recordLlmCall('gpt-4', [], 0.7);
+ * console.log(nullTracer.getEvents()); // []
+ * ```
+ */
+export declare class NullTracer {
+    /**
+     * Always false for NullTracer
+     */
+    readonly enabled: boolean;
+    /**
+     * Always undefined for NullTracer
+     */
+    readonly eventStore: undefined;
+    /**
+     * Do nothing implementation of recordEvent.
+     *
+     * @param _event - The tracer event to record (will be ignored)
+     */
+    recordEvent(_event: TracerEvent): void;
+    /**
+     * Do nothing implementation of recordLlmCall.
+     *
+     * @param _model - The name of the LLM model being called
+     * @param _messages - The messages sent to the LLM
+     * @param _temperature - The temperature setting for the LLM call
+     * @param _tools - The tools available to the LLM, if any
+     * @param _correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param _source - The source of the event
+     */
+    recordLlmCall(_model: string, _messages: unknown[], _temperature?: number, _tools?: Record<string, unknown>[], _correlationId?: string, _source?: string): void;
+    /**
+     * Do nothing implementation of recordLlmResponse.
+     *
+     * @param _model - The name of the LLM model that responded
+     * @param _content - The content of the LLM response
+     * @param _toolCalls - Any tool calls made by the LLM in its response
+     * @param _callDurationMs - The duration of the LLM call in milliseconds
+     * @param _correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param _source - The source of the event
+     */
+    recordLlmResponse(_model: string, _content: string, _toolCalls?: ToolCall[], _callDurationMs?: number, _correlationId?: string, _source?: string): void;
+    /**
+     * Do nothing implementation of recordToolCall.
+     *
+     * @param _toolName - The name of the tool being called
+     * @param _args - The arguments provided to the tool
+     * @param _result - The result returned by the tool
+     * @param _caller - The name of the agent or component calling the tool
+     * @param _callDurationMs - The duration of the tool call in milliseconds
+     * @param _correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param _source - The source of the event
+     */
+    recordToolCall(_toolName: string, _args: Record<string, unknown>, _result: unknown, _caller?: string, _callDurationMs?: number, _correlationId?: string, _source?: string): void;
+    /**
+     * Do nothing implementation of recordAgentInteraction.
+     *
+     * @param _fromAgent - The name of the agent sending the event
+     * @param _toAgent - The name of the agent receiving the event
+     * @param _eventType - The type of event being processed
+     * @param _eventId - A unique identifier for the event
+     * @param _correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param _source - The source of the event
+     */
+    recordAgentInteraction(_fromAgent: string, _toAgent: string, _eventType: string, _eventId?: string, _correlationId?: string, _source?: string): void;
+    /**
+     * Return an empty array for any getEvents request.
+     *
+     * @param _options - Filter options (ignored)
+     * @returns An empty array
+     */
+    getEvents(_options?: FilterOptions): TracerEvent[];
+    /**
+     * Return an empty array for any getLastNTracerEvents request.
+     *
+     * @param _n - Number of events to return (ignored)
+     * @param _eventType - Optional event type to filter by (ignored)
+     * @returns An empty array
+     */
+    getLastNTracerEvents(_n: number, _eventType?: TracerEventConstructor): TracerEvent[];
+    /**
+     * Do nothing implementation of clear method.
+     */
+    clear(): void;
+    /**
+     * No-op method for interface compatibility.
+     */
+    enable(): void;
+    /**
+     * No-op method for interface compatibility.
+     */
+    disable(): void;
+}
+/**
+ * Singleton null tracer instance for convenient use across the application.
+ *
+ * @example
+ * ```typescript
+ * import { nullTracer } from './tracer';
+ *
+ * const broker = new LlmBroker('gpt-4', gateway, nullTracer);
+ * ```
+ */
+export declare const nullTracer: NullTracer;
+//# sourceMappingURL=nullTracer.d.ts.map

package/dist/tracer/nullTracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullTracer.d.ts","sourceRoot":"","sources":["../../src/tracer/nullTracer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAU;IACrB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAS;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,YAAa;IAEhC;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAItC;;;;;;;;;OASG;IACH,aAAa,CACX,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,OAAO,EAAE,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClC,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;IAIP;;;;;;;;;OASG;IACH,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,QAAQ,EAAE,EACvB,eAAe,CAAC,EAAE,MAAM,EACxB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;IAIP;;;;;;;;;;OAUG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,EACxB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;IAIP;;;;;;;;;OASG;IACH,sBAAsB,CACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;IAIP;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,WAAW,EAAE;IAIlD;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,sBAAsB,GAAG,WAAW,EAAE;IAIpF;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/tracer/nullTracer.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * NullTracer implementation to eliminate conditional checks in the code.
+ *
+ * This module provides a NullTracer that implements the same interface as TracerSystem
+ * but performs no operations, following the Null Object Pattern.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nullTracer = exports.NullTracer = void 0;
+/**
+ * A no-op implementation of TracerSystem that silently discards all tracing operations.
+ *
+ * This class follows the Null Object Pattern to eliminate conditional checks in client code.
+ * All record methods are overridden to do nothing, and all query methods return empty results.
+ *
+ * @example
+ * ```typescript
+ * import { nullTracer } from './tracer';
+ *
+ * // Use nullTracer when you don't want any tracing
+ * const broker = new LlmBroker('gpt-4', gateway, nullTracer);
+ *
+ * // All tracer methods are no-ops
+ * nullTracer.recordLlmCall('gpt-4', [], 0.7);
+ * console.log(nullTracer.getEvents()); // []
+ * ```
+ */
+class NullTracer {
+    /**
+     * Always false for NullTracer
+     */
+    enabled = false;
+    /**
+     * Always undefined for NullTracer
+     */
+    eventStore = undefined;
+    /**
+     * Do nothing implementation of recordEvent.
+     *
+     * @param _event - The tracer event to record (will be ignored)
+     */
+    recordEvent(_event) {
+        // Do nothing
+    }
+    /**
+     * Do nothing implementation of recordLlmCall.
+     *
+     * @param _model - The name of the LLM model being called
+     * @param _messages - The messages sent to the LLM
+     * @param _temperature - The temperature setting for the LLM call
+     * @param _tools - The tools available to the LLM, if any
+     * @param _correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param _source - The source of the event
+     */
+    recordLlmCall(_model, _messages, _temperature, _tools, _correlationId, _source) {
+        // Do nothing
+    }
+    /**
+     * Do nothing implementation of recordLlmResponse.
+     *
+     * @param _model - The name of the LLM model that responded
+     * @param _content - The content of the LLM response
+     * @param _toolCalls - Any tool calls made by the LLM in its response
+     * @param _callDurationMs - The duration of the LLM call in milliseconds
+     * @param _correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param _source - The source of the event
+     */
+    recordLlmResponse(_model, _content, _toolCalls, _callDurationMs, _correlationId, _source) {
+        // Do nothing
+    }
+    /**
+     * Do nothing implementation of recordToolCall.
+     *
+     * @param _toolName - The name of the tool being called
+     * @param _args - The arguments provided to the tool
+     * @param _result - The result returned by the tool
+     * @param _caller - The name of the agent or component calling the tool
+     * @param _callDurationMs - The duration of the tool call in milliseconds
+     * @param _correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param _source - The source of the event
+     */
+    recordToolCall(_toolName, _args, _result, _caller, _callDurationMs, _correlationId, _source) {
+        // Do nothing
+    }
+    /**
+     * Do nothing implementation of recordAgentInteraction.
+     *
+     * @param _fromAgent - The name of the agent sending the event
+     * @param _toAgent - The name of the agent receiving the event
+     * @param _eventType - The type of event being processed
+     * @param _eventId - A unique identifier for the event
+     * @param _correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param _source - The source of the event
+     */
+    recordAgentInteraction(_fromAgent, _toAgent, _eventType, _eventId, _correlationId, _source) {
+        // Do nothing
+    }
+    /**
+     * Return an empty array for any getEvents request.
+     *
+     * @param _options - Filter options (ignored)
+     * @returns An empty array
+     */
+    getEvents(_options) {
+        return [];
+    }
+    /**
+     * Return an empty array for any getLastNTracerEvents request.
+     *
+     * @param _n - Number of events to return (ignored)
+     * @param _eventType - Optional event type to filter by (ignored)
+     * @returns An empty array
+     */
+    getLastNTracerEvents(_n, _eventType) {
+        return [];
+    }
+    /**
+     * Do nothing implementation of clear method.
+     */
+    clear() {
+        // Do nothing
+    }
+    /**
+     * No-op method for interface compatibility.
+     */
+    enable() {
+        // Do nothing
+    }
+    /**
+     * No-op method for interface compatibility.
+     */
+    disable() {
+        // Do nothing
+    }
+}
+exports.NullTracer = NullTracer;
+/**
+ * Singleton null tracer instance for convenient use across the application.
+ *
+ * @example
+ * ```typescript
+ * import { nullTracer } from './tracer';
+ *
+ * const broker = new LlmBroker('gpt-4', gateway, nullTracer);
+ * ```
+ */
+exports.nullTracer = new NullTracer();
+//# sourceMappingURL=nullTracer.js.map

package/dist/tracer/nullTracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullTracer.js","sourceRoot":"","sources":["../../src/tracer/nullTracer.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAMH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,UAAU;IACrB;;OAEG;IACM,OAAO,GAAY,KAAK,CAAC;IAElC;;OAEG;IACM,UAAU,GAAG,SAAS,CAAC;IAEhC;;;;OAIG;IACH,WAAW,CAAC,MAAmB;QAC7B,aAAa;IACf,CAAC;IAED;;;;;;;;;OASG;IACH,aAAa,CACX,MAAc,EACd,SAAoB,EACpB,YAAqB,EACrB,MAAkC,EAClC,cAAuB,EACvB,OAAgB;QAEhB,aAAa;IACf,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB,CACf,MAAc,EACd,QAAgB,EAChB,UAAuB,EACvB,eAAwB,EACxB,cAAuB,EACvB,OAAgB;QAEhB,aAAa;IACf,CAAC;IAED;;;;;;;;;;OAUG;IACH,cAAc,CACZ,SAAiB,EACjB,KAA8B,EAC9B,OAAgB,EAChB,OAAgB,EAChB,eAAwB,EACxB,cAAuB,EACvB,OAAgB;QAEhB,aAAa;IACf,CAAC;IAED;;;;;;;;;OASG;IACH,sBAAsB,CACpB,UAAkB,EAClB,QAAgB,EAChB,UAAkB,EAClB,QAAiB,EACjB,cAAuB,EACvB,OAAgB;QAEhB,aAAa;IACf,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,QAAwB;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAU,EAAE,UAAmC;QAClE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,aAAa;IACf,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,aAAa;IACf,CAAC;IAED;;OAEG;IACH,OAAO;QACL,aAAa;IACf,CAAC;CACF;AAnJD,gCAmJC;AAED;;;;;;;;;GASG;AACU,QAAA,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC"}