openlit 1.12.0 → 1.14.0

package/dist/instrumentation/__tests__/mem0-trace-comparison.test.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * Cross-Language Trace Comparison Tests for the mem0 Integration
+ *
+ * These verify that the TypeScript mem0 instrumentation emits the same spans /
+ * attributes as the Python SDK reference
+ * (sdk/python/src/openlit/instrumentation/mem0). mem0 is a memory layer, not an LLM
+ * provider: each operation (add / search / get / getAll / update / delete /
+ * deleteAll / history) becomes one CLIENT span named `memory <op>` carrying
+ * `gen_ai.*` attributes. There are no tokens, model, cost, or metrics. The same
+ * wrapper serves both the hosted `MemoryClient` and the OSS `Memory` clients, whose
+ * method surfaces are identical.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const api_1 = require("@opentelemetry/api");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const wrapper_1 = __importDefault(require("../mem0/wrapper"));
+const config_1 = __importDefault(require("../../config"));
+const helpers_1 = __importDefault(require("../../helpers"));
+const semantic_convention_1 = __importDefault(require("../../semantic-convention"));
+jest.mock('../../config');
+jest.mock('../../helpers', () => ({
+    __esModule: true,
+    default: { handleException: jest.fn() },
+    applyCustomSpanAttributes: jest.fn(),
+}));
+describe('mem0 Cross-Language Trace Comparison', () => {
+    let mockSpan;
+    let mockTracer;
+    beforeEach(() => {
+        mockSpan = {
+            setAttribute: jest.fn(),
+            setStatus: jest.fn(),
+            recordException: jest.fn(),
+            end: jest.fn(),
+        };
+        mockTracer = { startSpan: jest.fn(() => mockSpan) };
+        config_1.default.environment = 'openlit-testing';
+        config_1.default.applicationName = 'openlit-test';
+        config_1.default.captureMessageContent = true;
+    });
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+    // Wrap `impl` as the mem0 operation `spanName`, then invoke it with `args`.
+    async function runOp(spanName, impl, args = []) {
+        const wrapped = wrapper_1.default._patchMemoryOperation(mockTracer, spanName)(impl);
+        return wrapped.apply({}, args);
+    }
+    // Snapshot of all setAttribute(key, value) calls as a plain object.
+    function attrs() {
+        return Object.fromEntries(mockSpan.setAttribute.mock.calls);
+    }
+    describe('Core span shape', () => {
+        it('opens a CLIENT span named after the Python endpoint string', async () => {
+            await runOp('memory add', async () => [{ id: 'm1' }], [[{ role: 'user', content: 'hi' }], {}]);
+            expect(mockTracer.startSpan).toHaveBeenCalledWith('memory add', { kind: api_1.SpanKind.CLIENT });
+            expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 1 }); // SpanStatusCode.OK
+            expect(mockSpan.end).toHaveBeenCalledTimes(1);
+        });
+        it('sets the same core attributes as the Python SDK', async () => {
+            await runOp('memory add', async () => [{ id: 'm1' }], [[{ role: 'user', content: 'hi' }], {}]);
+            const a = attrs();
+            expect(a[semantic_conventions_1.ATTR_TELEMETRY_SDK_NAME]).toBe('openlit');
+            // Provider name is stamped on BOTH keys (gen_ai.system + gen_ai.provider.name).
+            expect(a[semantic_convention_1.default.GEN_AI_PROVIDER_NAME]).toBe('mem0');
+            expect(a[semantic_convention_1.default.GEN_AI_PROVIDER_NAME_OTEL]).toBe('mem0');
+            expect(a[semantic_convention_1.default.GEN_AI_ENDPOINT]).toBe('memory add');
+            expect(a[semantic_convention_1.default.GEN_AI_OPERATION]).toBe(semantic_convention_1.default.GEN_AI_OPERATION_TYPE_MEMORY);
+            expect(a[semantic_convention_1.default.ATTR_DEPLOYMENT_ENVIRONMENT]).toBe('openlit-testing');
+            expect(a[semantic_conventions_1.ATTR_SERVICE_NAME]).toBe('openlit-test');
+            // gen_ai.sdk.version is the mem0ai package version (a string); its exact value
+            // comes from the version OTel passes to the patch hook — asserted in the next test.
+            expect(typeof a[semantic_convention_1.default.GEN_AI_SDK_VERSION]).toBe('string');
+            expect(typeof a[semantic_convention_1.default.GEN_AI_CLIENT_OPERATION_DURATION]).toBe('number');
+        });
+        it('stamps the mem0ai version OTel hands to the patch hook', async () => {
+            const wrapped = wrapper_1.default._patchMemoryOperation(mockTracer, 'memory add', '3.0.7')(async () => [{ id: 'm1' }]);
+            await wrapped.apply({}, [[{ role: 'user', content: 'hi' }], {}]);
+            expect(attrs()[semantic_convention_1.default.GEN_AI_SDK_VERSION]).toBe('3.0.7');
+        });
+        it('applies custom span attributes on every memory span', async () => {
+            const { applyCustomSpanAttributes } = jest.requireMock('../../helpers');
+            await runOp('memory get', async () => ({ id: 'm1' }), ['mem-123']);
+            expect(applyCustomSpanAttributes).toHaveBeenCalledWith(mockSpan);
+        });
+    });
+    describe('Operation: add', () => {
+        it('records message count, infer flag, and input content', async () => {
+            const messages = [
+                { role: 'user', content: 'I love coffee' },
+                { role: 'assistant', content: 'Noted' },
+            ];
+            await runOp('memory add', async () => ({ results: [{ id: 'm1' }] }), [
+                messages,
+                { userId: 'alice', infer: false },
+            ]);
+            const a = attrs();
+            expect(a[semantic_convention_1.default.GEN_AI_MEMORY_COUNT]).toBe(2);
+            expect(a[semantic_convention_1.default.GEN_AI_MEMORY_INFER]).toBe(false);
+            expect(a[semantic_convention_1.default.GEN_AI_USER_ID]).toBe('alice');
+            expect(a[semantic_convention_1.default.GEN_AI_INPUT_MESSAGES]).toBe(JSON.stringify(messages));
+        });
+        it('captures user / agent / run scope from the config object', async () => {
+            await runOp('memory add', async () => [{ id: 'm1' }], [
+                [{ role: 'user', content: 'hi' }],
+                { userId: 'u1', agentId: 'a1', runId: 'r1', metadata: { topic: 'food' } },
+            ]);
+            const a = attrs();
+            expect(a[semantic_convention_1.default.GEN_AI_USER_ID]).toBe('u1');
+            expect(a[semantic_convention_1.default.GEN_AI_AGENT_ID]).toBe('a1');
+            expect(a[semantic_convention_1.default.GEN_AI_RUN_ID]).toBe('r1');
+            expect(a[semantic_convention_1.default.GEN_AI_MEMORY_METADATA]).toBe(JSON.stringify({ topic: 'food' }));
+        });
+    });
+    describe('Operation: search', () => {
+        it('records query / limit (topK) / threshold and output content', async () => {
+            const response = { results: [{ id: 'm1', memory: 'likes coffee' }, { id: 'm2', memory: 'likes tea' }] };
+            await runOp('memory search', async () => response, [
+                'what drinks?',
+                { userId: 'alice', topK: 5, threshold: 0.7 },
+            ]);
+            const a = attrs();
+            expect(a[semantic_convention_1.default.GEN_AI_MEMORY_SEARCH_QUERY]).toBe('what drinks?');
+            expect(a[semantic_convention_1.default.GEN_AI_MEMORY_SEARCH_LIMIT]).toBe(5);
+            expect(a[semantic_convention_1.default.GEN_AI_MEMORY_SEARCH_THRESHOLD]).toBe(0.7);
+            expect(a[semantic_convention_1.default.GEN_AI_MEMORY_OPERATION_RESULT_COUNT]).toBe(2);
+            expect(a[semantic_convention_1.default.GEN_AI_DATA_SOURCES]).toBe(2);
+            expect(a[semantic_convention_1.default.GEN_AI_OUTPUT_MESSAGES]).toBe(JSON.stringify(response));
+        });
+        it('reads scope from a nested filters object (camel or snake case)', async () => {
+            await runOp('memory search', async () => ({ results: [] }), [
+                'q',
+                { filters: { user_id: 'snake-user' } },
+            ]);
+            expect(attrs()[semantic_convention_1.default.GEN_AI_USER_ID]).toBe('snake-user');
+        });
+        it('reports result_count 0 for an empty results array (not 1)', async () => {
+            await runOp('memory search', async () => ({ results: [] }), ['q', { filters: { user_id: 'x' } }]);
+            const a = attrs();
+            expect(a[semantic_convention_1.default.GEN_AI_MEMORY_OPERATION_RESULT_COUNT]).toBe(0);
+            expect(a[semantic_convention_1.default.GEN_AI_DATA_SOURCES]).toBe(0);
+        });
+    });
+    describe('Operations carrying a positional memory id', () => {
+        it('get -> db.operation.id', async () => {
+            await runOp('memory get', async () => ({ id: 'mem-1' }), ['mem-1']);
+            expect(attrs()[semantic_convention_1.default.DB_OPERATION_ID]).toBe('mem-1');
+        });
+        it('update -> db.update.id', async () => {
+            await runOp('memory update', async () => ({ message: 'ok' }), ['mem-2', 'new text']);
+            expect(attrs()[semantic_convention_1.default.DB_UPDATE_ID]).toBe('mem-2');
+        });
+        it('delete -> db.delete.id', async () => {
+            await runOp('memory delete', async () => ({ message: 'ok' }), ['mem-3']);
+            expect(attrs()[semantic_convention_1.default.DB_DELETE_ID]).toBe('mem-3');
+        });
+    });
+    describe('Operation: getAll / deleteAll', () => {
+        it('getAll uses the snake_case span name and reads scope from its first-arg config', async () => {
+            await runOp('memory get_all', async () => ({ results: [{ id: 'm1' }, { id: 'm2' }, { id: 'm3' }] }), [
+                { userId: 'bob' },
+            ]);
+            const a = attrs();
+            expect(mockTracer.startSpan).toHaveBeenCalledWith('memory get_all', { kind: api_1.SpanKind.CLIENT });
+            expect(a[semantic_convention_1.default.GEN_AI_USER_ID]).toBe('bob');
+            expect(a[semantic_convention_1.default.GEN_AI_MEMORY_OPERATION_RESULT_COUNT]).toBe(3);
+        });
+        it('deleteAll uses the snake_case span name', async () => {
+            await runOp('memory delete_all', async () => ({ message: 'ok' }), [{ userId: 'bob' }]);
+            expect(mockTracer.startSpan).toHaveBeenCalledWith('memory delete_all', { kind: api_1.SpanKind.CLIENT });
+        });
+        it('reset uses the Python endpoint span name', async () => {
+            await runOp('memory reset', async () => ({ message: 'ok' }), []);
+            expect(mockTracer.startSpan).toHaveBeenCalledWith('memory reset', { kind: api_1.SpanKind.CLIENT });
+            expect(attrs()[semantic_convention_1.default.GEN_AI_ENDPOINT]).toBe('memory reset');
+            expect(attrs()[semantic_convention_1.default.GEN_AI_OPERATION]).toBe(semantic_convention_1.default.GEN_AI_OPERATION_TYPE_MEMORY);
+        });
+    });
+    describe('Content capture toggle', () => {
+        it('omits input/output content when captureMessageContent is false', async () => {
+            config_1.default.captureMessageContent = false;
+            await runOp('memory add', async () => ({ results: [] }), [
+                [{ role: 'user', content: 'secret' }],
+                {},
+            ]);
+            const keys = mockSpan.setAttribute.mock.calls.map(([k]) => k);
+            expect(keys).not.toContain(semantic_convention_1.default.GEN_AI_INPUT_MESSAGES);
+        });
+    });
+    describe('Error path', () => {
+        it('records the exception, still ends the span, and rethrows', async () => {
+            const boom = new Error('mem0 down');
+            await expect(runOp('memory search', async () => {
+                throw boom;
+            }, ['q', { topK: 3 }])).rejects.toThrow('mem0 down');
+            expect(helpers_1.default.handleException).toHaveBeenCalledWith(mockSpan, boom);
+            expect(mockSpan.end).toHaveBeenCalledTimes(1);
+            // Core attributes are still emitted on the error path (best-effort).
+            expect(attrs()[semantic_convention_1.default.GEN_AI_PROVIDER_NAME]).toBe('mem0');
+            expect(typeof attrs()[semantic_convention_1.default.GEN_AI_CLIENT_OPERATION_DURATION]).toBe('number');
+        });
+    });
+});
+//# sourceMappingURL=mem0-trace-comparison.test.js.map

package/dist/instrumentation/__tests__/mem0-trace-comparison.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem0-trace-comparison.test.js","sourceRoot":"","sources":["../../../src/instrumentation/__tests__/mem0-trace-comparison.test.ts"],"names":[],"mappings":"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"}

package/dist/instrumentation/__tests__/pg-trace-comparison.test.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Cross-Language Trace Comparison Tests for PostgreSQL (`pg`) Integration
+ *
+ * Verifies that the TypeScript SDK generates traces consistent with the Python SDK
+ * psycopg instrumentation for PostgreSQL queries.
+ *
+ * Python SDK reference: sdk/python/src/openlit/instrumentation/psycopg/utils.py
+ *
+ * Key alignment:
+ *   - db.system.name = 'postgresql'
+ *   - db.operation.name parsed from the SQL verb (SELECT/INSERT/UPDATE/DELETE/...)
+ *   - db.collection.name = target table
+ *   - db.namespace = database name
+ *   - server.address, server.port (default localhost:5432)
+ *   - db.query.text (when captureMessageContent is enabled)
+ *   - db.query.parameter.<index> (only when captureDbParameters is enabled)
+ *   - db.search.similarity_metric for pgvector operators (<=>, <->, <#>)
+ *   - db.query.summary
+ *   - db.response.returned_rows from result.rowCount
+ */
+export {};