openlit 1.12.0 → 1.14.0

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

@@ -0,0 +1,391 @@
+"use strict";
+/**
+ * Cross-Language Trace Comparison Tests for the DigitalOcean Gradient Integration
+ *
+ * These verify that the TypeScript Gradient instrumentation emits the same span
+ * attributes / events as the Python SDK reference
+ * (sdk/python/src/openlit/instrumentation/gradient). Gradient is OpenAI-shaped:
+ * responses carry a `model` field, requests support seed / frequency_penalty /
+ * presence_penalty, and streaming usage arrives on the final chunk as `usage`.
+ * The provider name is `digitalocean` and chat is served from inference.do-ai.run.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const wrapper_1 = __importDefault(require("../gradient/wrapper"));
+const config_1 = __importDefault(require("../../config"));
+const helpers_1 = __importDefault(require("../../helpers"));
+const base_wrapper_1 = __importDefault(require("../base-wrapper"));
+const semantic_convention_1 = __importDefault(require("../../semantic-convention"));
+jest.mock('../../config');
+jest.mock('../../helpers', () => ({
+    __esModule: true,
+    default: {},
+    isFrameworkLlmActive: jest.fn(() => false),
+    getFrameworkParentContext: jest.fn(() => undefined),
+    getCurrentAgentVersion: jest.fn(() => undefined),
+}));
+jest.mock('../base-wrapper');
+const SERVER = { serverAddress: 'inference.do-ai.run', serverPort: 443 };
+const AGENT_SERVER = { serverAddress: 'abc123.agents.do-ai.run', serverPort: 443 };
+describe('Gradient Cross-Language Trace Comparison', () => {
+    let mockSpan;
+    beforeEach(() => {
+        mockSpan = {
+            setAttribute: jest.fn(),
+            addEvent: jest.fn(),
+            end: jest.fn(),
+            setStatus: jest.fn(),
+        };
+        config_1.default.environment = 'openlit-testing';
+        config_1.default.applicationName = 'openlit-test';
+        config_1.default.captureMessageContent = true;
+        config_1.default.pricingInfo = {};
+        config_1.default.disableEvents = false;
+        helpers_1.default.getChatModelCost = jest.fn().mockReturnValue(0.001);
+        helpers_1.default.getImageModelCost = jest.fn().mockReturnValue(0.05);
+        helpers_1.default.openaiTokens = jest.fn().mockReturnValue(5);
+        helpers_1.default.handleException = jest.fn();
+        helpers_1.default.createStreamProxy = jest
+            .fn()
+            .mockImplementation((stream, _generator) => stream);
+        helpers_1.default.buildInputMessages = jest
+            .fn()
+            .mockReturnValue('[{"role":"user","parts":[{"type":"text","content":"Test"}]}]');
+        helpers_1.default.buildOutputMessages = jest
+            .fn()
+            .mockReturnValue('[{"role":"assistant","parts":[{"type":"text","content":"Response"}],"finish_reason":"stop"}]');
+        helpers_1.default.buildSystemInstructionsFromMessages = jest
+            .fn()
+            .mockImplementation((messages) => {
+            const sys = (messages || []).find((m) => m?.role === 'system');
+            return sys ? JSON.stringify([{ type: 'text', content: String(sys.content) }]) : undefined;
+        });
+        helpers_1.default.buildToolDefinitions = jest.fn().mockReturnValue(undefined);
+        helpers_1.default.emitInferenceEvent = jest.fn();
+        helpers_1.default.computeAgentVersionHash = jest
+            .fn()
+            .mockReturnValue('ts-test-version-hash');
+        base_wrapper_1.default.recordMetrics = jest.fn();
+        base_wrapper_1.default.setBaseSpanAttributes = jest
+            .fn()
+            .mockImplementation((span, attrs) => {
+            span.setAttribute(semantic_convention_1.default.GEN_AI_PROVIDER_NAME_OTEL, attrs.aiSystem);
+            span.setAttribute(semantic_convention_1.default.GEN_AI_REQUEST_MODEL, attrs.model);
+            if (attrs.cost !== undefined) {
+                span.setAttribute(semantic_convention_1.default.GEN_AI_USAGE_COST, attrs.cost);
+            }
+            if (attrs.serverAddress) {
+                span.setAttribute(semantic_convention_1.default.SERVER_ADDRESS, attrs.serverAddress);
+            }
+            if (attrs.serverPort !== undefined) {
+                span.setAttribute(semantic_convention_1.default.SERVER_PORT, attrs.serverPort);
+            }
+            span.setAttribute(semantic_convention_1.default.GEN_AI_SDK_VERSION, '1.9.0');
+        });
+    });
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+    const mockResponse = () => ({
+        id: 'gradient-test-id',
+        model: 'llama3.3-70b-instruct',
+        choices: [
+            {
+                index: 0,
+                finish_reason: 'stop',
+                message: { role: 'assistant', content: 'DO says hi', reasoning_content: 'thinking...' },
+            },
+        ],
+        usage: { prompt_tokens: 10, completion_tokens: 20, total_tokens: 30 },
+    });
+    describe('Chat Completion Trace Consistency', () => {
+        it('should set the same core attributes as the Python SDK', async () => {
+            const mockArgs = [
+                {
+                    messages: [{ role: 'user', content: 'What is LLM Observability?' }],
+                    model: 'llama3.3-70b-instruct',
+                    max_tokens: 100,
+                    temperature: 0.7,
+                    stream: false,
+                },
+            ];
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.chat.completions',
+                response: mockResponse(),
+                span: mockSpan,
+                ...SERVER,
+                operationName: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_CHAT,
+                apiType: 'chat',
+            });
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_PROVIDER_NAME_OTEL, 'digitalocean');
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_MODEL, 'llama3.3-70b-instruct');
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_RESPONSE_MODEL, 'llama3.3-70b-instruct');
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_RESPONSE_ID, 'gradient-test-id');
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_USAGE_INPUT_TOKENS, 10);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_USAGE_OUTPUT_TOKENS, 20);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_CLIENT_TOKEN_USAGE, 30);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_TEMPERATURE, 0.7);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_MAX_TOKENS, 100);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_IS_STREAM, false);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_RESPONSE_FINISH_REASON, ['stop']);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_OUTPUT_TYPE, 'text');
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.OPENAI_API_TYPE, 'chat');
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.SERVER_ADDRESS, 'inference.do-ai.run');
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.SERVER_PORT, 443);
+        });
+        it('prefers max_completion_tokens over max_tokens (Python parity)', async () => {
+            const mockArgs = [
+                {
+                    messages: [{ role: 'user', content: 'Test' }],
+                    model: 'llama3.3-70b-instruct',
+                    max_tokens: 50,
+                    max_completion_tokens: 128,
+                    stream: false,
+                },
+            ];
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.chat.completions',
+                response: mockResponse(),
+                span: mockSpan,
+                ...SERVER,
+                operationName: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_CHAT,
+                apiType: 'chat',
+            });
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_MAX_TOKENS, 128);
+        });
+        it('falls back to the "unknown" request model when none is supplied (matches Python)', async () => {
+            const mockArgs = [{ messages: [{ role: 'user', content: 'Test' }], stream: false }];
+            const responseNoModel = { ...mockResponse(), model: '' };
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.chat.completions',
+                response: responseNoModel,
+                span: mockSpan,
+                ...SERVER,
+                operationName: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_CHAT,
+                apiType: 'chat',
+            });
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_MODEL, 'unknown');
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_RESPONSE_MODEL, 'unknown');
+        });
+        it('stamps openlit.agent.version_hash on the chat span', async () => {
+            const mockArgs = [
+                { messages: [{ role: 'user', content: 'Hash me' }], model: 'llama3.3-70b-instruct', stream: false },
+            ];
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.chat.completions',
+                response: mockResponse(),
+                span: mockSpan,
+                ...SERVER,
+                operationName: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_CHAT,
+                apiType: 'chat',
+            });
+            expect(helpers_1.default.computeAgentVersionHash).toHaveBeenCalled();
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.OPENLIT_AGENT_VERSION_HASH, 'ts-test-version-hash');
+        });
+        it('should NOT set total_tokens on the span', async () => {
+            const mockArgs = [
+                { messages: [{ role: 'user', content: 'Test' }], model: 'llama3.3-70b-instruct', stream: false },
+            ];
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.chat.completions',
+                response: mockResponse(),
+                span: mockSpan,
+                ...SERVER,
+                operationName: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_CHAT,
+                apiType: 'chat',
+            });
+            const attributeKeys = mockSpan.setAttribute.mock.calls.map(([key]) => key);
+            expect(attributeKeys).not.toContain(semantic_convention_1.default.GEN_AI_USAGE_TOTAL_TOKENS);
+        });
+        it('omits seed / penalties / optionals when not provided (no sentinel values)', async () => {
+            const mockArgs = [
+                { messages: [{ role: 'user', content: 'Test' }], model: 'llama3.3-70b-instruct', stream: false },
+            ];
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.chat.completions',
+                response: mockResponse(),
+                span: mockSpan,
+                ...SERVER,
+                operationName: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_CHAT,
+                apiType: 'chat',
+            });
+            const attributeKeys = mockSpan.setAttribute.mock.calls.map(([key]) => key);
+            expect(attributeKeys).not.toContain(semantic_convention_1.default.GEN_AI_REQUEST_SEED);
+            expect(attributeKeys).not.toContain(semantic_convention_1.default.GEN_AI_REQUEST_FREQUENCY_PENALTY);
+            expect(attributeKeys).not.toContain(semantic_convention_1.default.GEN_AI_REQUEST_PRESENCE_PENALTY);
+            expect(attributeKeys).not.toContain(semantic_convention_1.default.GEN_AI_REQUEST_MAX_TOKENS);
+            expect(attributeKeys).not.toContain(semantic_convention_1.default.GEN_AI_REQUEST_STOP_SEQUENCES);
+            expect(attributeKeys).not.toContain(semantic_convention_1.default.GEN_AI_REQUEST_CHOICE_COUNT);
+        });
+        it('sets seed / penalties when explicitly provided (Gradient is OpenAI-compatible)', async () => {
+            const mockArgs = [
+                {
+                    messages: [{ role: 'user', content: 'Test' }],
+                    model: 'llama3.3-70b-instruct',
+                    seed: 42,
+                    frequency_penalty: 0.5,
+                    presence_penalty: 0.3,
+                    stop: ['END'],
+                    n: 2,
+                    reasoning_effort: 'high',
+                    stream: false,
+                },
+            ];
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.chat.completions',
+                response: mockResponse(),
+                span: mockSpan,
+                ...SERVER,
+                operationName: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_CHAT,
+                apiType: 'chat',
+            });
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_SEED, 42);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_FREQUENCY_PENALTY, 0.5);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_PRESENCE_PENALTY, 0.3);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_STOP_SEQUENCES, ['END']);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_CHOICE_COUNT, 2);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_REASONING_EFFORT, 'high');
+        });
+        it('does not throw and still records tokens when the response omits usage', async () => {
+            const mockArgs = [
+                { messages: [{ role: 'user', content: 'Test' }], model: 'llama3.3-70b-instruct', stream: false },
+            ];
+            const responseNoUsage = mockResponse();
+            delete responseNoUsage.usage;
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.chat.completions',
+                response: responseNoUsage,
+                span: mockSpan,
+                ...SERVER,
+                operationName: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_CHAT,
+                apiType: 'chat',
+            });
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_USAGE_INPUT_TOKENS, 0);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_USAGE_OUTPUT_TOKENS, 0);
+        });
+        it('should emit an inference event via the LoggerProvider', async () => {
+            const mockArgs = [
+                { messages: [{ role: 'user', content: 'Test' }], model: 'llama3.3-70b-instruct', stream: false },
+            ];
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.chat.completions',
+                response: mockResponse(),
+                span: mockSpan,
+                ...SERVER,
+                operationName: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_CHAT,
+                apiType: 'chat',
+            });
+            expect(helpers_1.default.emitInferenceEvent).toHaveBeenCalled();
+        });
+    });
+    describe('Agent Chat Completion Trace Consistency', () => {
+        it('emits invoke_agent operation in inference events (Python parity)', async () => {
+            const mockArgs = [
+                {
+                    messages: [{ role: 'user', content: 'Run agent' }],
+                    model: 'agent-model',
+                    stream: false,
+                },
+            ];
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.agents.chat.completions',
+                response: mockResponse(),
+                span: mockSpan,
+                ...AGENT_SERVER,
+                operationName: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_AGENT,
+                apiType: 'chat',
+            });
+            expect(helpers_1.default.emitInferenceEvent).toHaveBeenCalledWith(mockSpan, expect.objectContaining({
+                [semantic_convention_1.default.GEN_AI_OPERATION]: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_AGENT,
+            }));
+        });
+    });
+    describe('Image Generation Trace Consistency', () => {
+        it('sets image output type and cost like Python process_image_response', async () => {
+            const mockArgs = [
+                {
+                    prompt: 'A cute otter',
+                    model: 'gpt-image-1',
+                    size: '1024x1024',
+                    quality: 'high',
+                },
+            ];
+            const response = {
+                created: 1710000000,
+                model: 'gpt-image-1',
+                data: [{ b64_json: 'abc', revised_prompt: 'A very cute otter' }],
+            };
+            wrapper_1.default._imageGenerateCommonSetter({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.images.generate',
+                response,
+                span: mockSpan,
+                ...SERVER,
+            });
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_OUTPUT_TYPE, 'image');
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_RESPONSE_ID, String(1710000000));
+            expect(helpers_1.default.getImageModelCost).toHaveBeenCalledWith('gpt-image-1', {}, '1024x1024', 'high');
+        });
+    });
+    describe('Streaming Trace Consistency', () => {
+        async function* mockStream() {
+            yield {
+                id: 'gradient-stream-id',
+                model: 'llama3.3-70b-instruct',
+                choices: [{ index: 0, delta: { role: 'assistant', content: 'Hello' }, finish_reason: null }],
+            };
+            yield {
+                id: 'gradient-stream-id',
+                model: 'llama3.3-70b-instruct',
+                choices: [{ index: 0, delta: { content: ' world' }, finish_reason: 'stop' }],
+            };
+            yield {
+                id: 'gradient-stream-id',
+                model: 'llama3.3-70b-instruct',
+                choices: [],
+                usage: { prompt_tokens: 7, completion_tokens: 11, total_tokens: 18 },
+            };
+        }
+        it('aggregates streamed content and reads usage from the final chunk', async () => {
+            const mockArgs = [
+                {
+                    messages: [{ role: 'user', content: 'Hi' }],
+                    model: 'llama3.3-70b-instruct',
+                    stream: true,
+                },
+            ];
+            const generator = wrapper_1.default._chatCompletionGenerator({
+                args: mockArgs,
+                genAIEndpoint: 'digitalocean.chat.completions',
+                response: mockStream(),
+                span: mockSpan,
+                ...SERVER,
+                operationName: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_CHAT,
+                apiType: 'chat',
+            });
+            let step = await generator.next();
+            while (!step.done) {
+                step = await generator.next();
+            }
+            const final = step.value;
+            expect(final.choices[0].message.content).toBe('Hello world');
+            expect(final.choices[0].finish_reason).toBe('stop');
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_USAGE_INPUT_TOKENS, 7);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_USAGE_OUTPUT_TOKENS, 11);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_REQUEST_IS_STREAM, true);
+        });
+    });
+});
+//# sourceMappingURL=gradient-trace-comparison.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gradient-trace-comparison.test.js","sourceRoot":"","sources":["../../../src/instrumentation/__tests__/gradient-trace-comparison.test.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;AAEH,kEAAkD;AAClD,0DAAyC;AACzC,4DAA0C;AAC1C,mEAA0C;AAC1C,oFAA2D;AAE3D,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAC1B,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAChC,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,EAAE;IACX,oBAAoB,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;IAC1C,yBAAyB,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;IACnD,sBAAsB,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;CACjD,CAAC,CAAC,CAAC;AACJ,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAE7B,MAAM,MAAM,GAAG,EAAE,aAAa,EAAE,qBAAqB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;AACzE,MAAM,YAAY,GAAG,EAAE,aAAa,EAAE,yBAAyB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;AAEnF,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,IAAI,QAAa,CAAC;IAElB,UAAU,CAAC,GAAG,EAAE;QACd,QAAQ,GAAG;YACT,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE;YACvB,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE;YACnB,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;YACd,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE;SACrB,CAAC;QAED,gBAAqB,CAAC,WAAW,GAAG,iBAAiB,CAAC;QACtD,gBAAqB,CAAC,eAAe,GAAG,cAAc,CAAC;QACvD,gBAAqB,CAAC,qBAAqB,GAAG,IAAI,CAAC;QACnD,gBAAqB,CAAC,WAAW,GAAG,EAAE,CAAC;QACvC,gBAAqB,CAAC,aAAa,GAAG,KAAK,CAAC;QAE5C,iBAAqB,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC1E,iBAAqB,CAAC,iBAAiB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1E,iBAAqB,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAClE,iBAAqB,CAAC,eAAe,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAClD,iBAAqB,CAAC,iBAAiB,GAAG,IAAI;aAC5C,EAAE,EAAE;aACJ,kBAAkB,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QACrD,iBAAqB,CAAC,kBAAkB,GAAG,IAAI;aAC7C,EAAE,EAAE;aACJ,eAAe,CAAC,8DAA8D,CAAC,CAAC;QAClF,iBAAqB,CAAC,mBAAmB,GAAG,IAAI;aAC9C,EAAE,EAAE;aACJ,eAAe,CACd,8FAA8F,CAC/F,CAAC;QACH,iBAAqB,CAAC,mCAAmC,GAAG,IAAI;aAC9D,EAAE,EAAE;aACJ,kBAAkB,CAAC,CAAC,QAAe,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC;YACpE,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5F,CAAC,CAAC,CAAC;QACJ,iBAAqB,CAAC,oBAAoB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAClF,iBAAqB,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACrD,iBAAqB,CAAC,uBAAuB,GAAG,IAAI;aAClD,EAAE,EAAE;aACJ,eAAe,CAAC,sBAAsB,CAAC,CAAC;QAE1C,sBAAmB,CAAC,aAAa,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAC9C,sBAAmB,CAAC,qBAAqB,GAAG,IAAI;aAC9C,EAAE,EAAE;aACJ,kBAAkB,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAClC,IAAI,CAAC,YAAY,CAAC,6BAAkB,CAAC,yBAAyB,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YAChF,IAAI,CAAC,YAAY,CAAC,6BAAkB,CAAC,oBAAoB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACxE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,IAAI,CAAC,YAAY,CAAC,6BAAkB,CAAC,iBAAiB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;gBACxB,IAAI,CAAC,YAAY,CAAC,6BAAkB,CAAC,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;YAC5E,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACnC,IAAI,CAAC,YAAY,CAAC,6BAAkB,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,6BAAkB,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,CAAC;QAC1B,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,CAAC;gBACR,aAAa,EAAE,MAAM;gBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE;aACxF;SACF;QACD,KAAK,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;KACtE,CAAC,CAAC;IAEH,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACjD,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;YACrE,MAAM,QAAQ,GAAG;gBACf;oBACE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;oBACnE,KAAK,EAAE,uBAAuB;oBAC9B,UAAU,EAAE,GAAG;oBACf,WAAW,EAAE,GAAG;oBAChB,MAAM,EAAE,KAAK;iBACd;aACF,CAAC;YAEF,MAAM,iBAAe,CAAC,eAAe,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,+BAA+B;gBAC9C,QAAQ,EAAE,YAAY,EAAE;gBACxB,IAAI,EAAE,QAAQ;gBACd,GAAG,MAAM;gBACT,aAAa,EAAE,6BAAkB,CAAC,0BAA0B;gBAC5D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAChD,6BAAkB,CAAC,yBAAyB,EAC5C,cAAc,CACf,CAAC;YACF,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAChD,6BAAkB,CAAC,oBAAoB,EACvC,uBAAuB,CACxB,CAAC;YACF,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAChD,6BAAkB,CAAC,qBAAqB,EACxC,uBAAuB,CACxB,CAAC;YACF,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAChD,6BAAkB,CAAC,kBAAkB,EACrC,kBAAkB,CACnB,CAAC;YACF,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;YACrG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;YACtG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;YACrG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;YACvG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;YACtG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;YACvG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,6BAA6B,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;YAC/G,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;YAClG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YAC/F,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC;YAC7G,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;YAC7E,MAAM,QAAQ,GAAG;gBACf;oBACE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;oBAC7C,KAAK,EAAE,uBAAuB;oBAC9B,UAAU,EAAE,EAAE;oBACd,qBAAqB,EAAE,GAAG;oBAC1B,MAAM,EAAE,KAAK;iBACd;aACF,CAAC;YAEF,MAAM,iBAAe,CAAC,eAAe,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,+BAA+B;gBAC9C,QAAQ,EAAE,YAAY,EAAE;gBACxB,IAAI,EAAE,QAAQ;gBACd,GAAG,MAAM;gBACT,aAAa,EAAE,6BAAkB,CAAC,0BAA0B;gBAC5D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;QACxG,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kFAAkF,EAAE,KAAK,IAAI,EAAE;YAChG,MAAM,QAAQ,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACpF,MAAM,eAAe,GAAG,EAAE,GAAG,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YAEzD,MAAM,iBAAe,CAAC,eAAe,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,+BAA+B;gBAC9C,QAAQ,EAAE,eAAe;gBACzB,IAAI,EAAE,QAAQ;gBACd,GAAG,MAAM;gBACT,aAAa,EAAE,6BAAkB,CAAC,0BAA0B;gBAC5D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;YACvG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;QAC1G,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,QAAQ,GAAG;gBACf,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,KAAK,EAAE;aACpG,CAAC;YAEF,MAAM,iBAAe,CAAC,eAAe,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,+BAA+B;gBAC9C,QAAQ,EAAE,YAAY,EAAE;gBACxB,IAAI,EAAE,QAAQ;gBACd,GAAG,MAAM;gBACT,aAAa,EAAE,6BAAkB,CAAC,0BAA0B;gBAC5D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,MAAM,CAAE,iBAAqB,CAAC,uBAAuB,CAAC,CAAC,gBAAgB,EAAE,CAAC;YAC1E,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAChD,6BAAkB,CAAC,0BAA0B,EAC7C,sBAAsB,CACvB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACvD,MAAM,QAAQ,GAAG;gBACf,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,KAAK,EAAE;aACjG,CAAC;YAEF,MAAM,iBAAe,CAAC,eAAe,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,+BAA+B;gBAC9C,QAAQ,EAAE,YAAY,EAAE;gBACxB,IAAI,EAAE,QAAQ;gBACd,GAAG,MAAM;gBACT,aAAa,EAAE,6BAAkB,CAAC,0BAA0B;gBAC5D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,MAAM,aAAa,GAAI,QAAQ,CAAC,YAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAW,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YACpG,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,6BAAkB,CAAC,yBAAyB,CAAC,CAAC;QACpF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;YACzF,MAAM,QAAQ,GAAG;gBACf,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,KAAK,EAAE;aACjG,CAAC;YAEF,MAAM,iBAAe,CAAC,eAAe,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,+BAA+B;gBAC9C,QAAQ,EAAE,YAAY,EAAE;gBACxB,IAAI,EAAE,QAAQ;gBACd,GAAG,MAAM;gBACT,aAAa,EAAE,6BAAkB,CAAC,0BAA0B;gBAC5D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,MAAM,aAAa,GAAI,QAAQ,CAAC,YAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAW,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YACpG,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,6BAAkB,CAAC,mBAAmB,CAAC,CAAC;YAC5E,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,6BAAkB,CAAC,gCAAgC,CAAC,CAAC;YACzF,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,6BAAkB,CAAC,+BAA+B,CAAC,CAAC;YACxF,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,6BAAkB,CAAC,yBAAyB,CAAC,CAAC;YAClF,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,6BAAkB,CAAC,6BAA6B,CAAC,CAAC;YACtF,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,6BAAkB,CAAC,2BAA2B,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;YAC9F,MAAM,QAAQ,GAAG;gBACf;oBACE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;oBAC7C,KAAK,EAAE,uBAAuB;oBAC9B,IAAI,EAAE,EAAE;oBACR,iBAAiB,EAAE,GAAG;oBACtB,gBAAgB,EAAE,GAAG;oBACrB,IAAI,EAAE,CAAC,KAAK,CAAC;oBACb,CAAC,EAAE,CAAC;oBACJ,gBAAgB,EAAE,MAAM;oBACxB,MAAM,EAAE,KAAK;iBACd;aACF,CAAC;YAEF,MAAM,iBAAe,CAAC,eAAe,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,+BAA+B;gBAC9C,QAAQ,EAAE,YAAY,EAAE;gBACxB,IAAI,EAAE,QAAQ;gBACd,GAAG,MAAM;gBACT,aAAa,EAAE,6BAAkB,CAAC,0BAA0B;gBAC5D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;YAC/F,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;YAC7G,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;YAC5G,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,6BAA6B,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9G,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,2BAA2B,EAAE,CAAC,CAAC,CAAC;YACtG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAChD,6BAAkB,CAAC,+BAA+B,EAClD,MAAM,CACP,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;YACrF,MAAM,QAAQ,GAAG;gBACf,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,KAAK,EAAE;aACjG,CAAC;YACF,MAAM,eAAe,GAAQ,YAAY,EAAE,CAAC;YAC5C,OAAO,eAAe,CAAC,KAAK,CAAC;YAE7B,MAAM,iBAAe,CAAC,eAAe,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,+BAA+B;gBAC9C,QAAQ,EAAE,eAAe;gBACzB,IAAI,EAAE,QAAQ;gBACd,GAAG,MAAM;gBACT,aAAa,EAAE,6BAAkB,CAAC,0BAA0B;gBAC5D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC;YACpG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,0BAA0B,EAAE,CAAC,CAAC,CAAC;QACvG,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;YACrE,MAAM,QAAQ,GAAG;gBACf,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,KAAK,EAAE;aACjG,CAAC;YAEF,MAAM,iBAAe,CAAC,eAAe,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,+BAA+B;gBAC9C,QAAQ,EAAE,YAAY,EAAE;gBACxB,IAAI,EAAE,QAAQ;gBACd,GAAG,MAAM;gBACT,aAAa,EAAE,6BAAkB,CAAC,0BAA0B;gBAC5D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,MAAM,CAAE,iBAAqB,CAAC,kBAAkB,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACvD,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;YAChF,MAAM,QAAQ,GAAG;gBACf;oBACE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;oBAClD,KAAK,EAAE,aAAa;oBACpB,MAAM,EAAE,KAAK;iBACd;aACF,CAAC;YAEF,MAAM,iBAAe,CAAC,eAAe,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,sCAAsC;gBACrD,QAAQ,EAAE,YAAY,EAAE;gBACxB,IAAI,EAAE,QAAQ;gBACd,GAAG,YAAY;gBACf,aAAa,EAAE,6BAAkB,CAAC,2BAA2B;gBAC7D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,MAAM,CAAE,iBAAqB,CAAC,kBAAkB,CAAC,CAAC,oBAAoB,CACpE,QAAQ,EACR,MAAM,CAAC,gBAAgB,CAAC;gBACtB,CAAC,6BAAkB,CAAC,gBAAgB,CAAC,EAAE,6BAAkB,CAAC,2BAA2B;aACtF,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAClD,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;YAClF,MAAM,QAAQ,GAAG;gBACf;oBACE,MAAM,EAAE,cAAc;oBACtB,KAAK,EAAE,aAAa;oBACpB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,MAAM;iBAChB;aACF,CAAC;YACF,MAAM,QAAQ,GAAG;gBACf,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE,aAAa;gBACpB,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC;aACjE,CAAC;YAEF,iBAAe,CAAC,0BAA0B,CAAC;gBACzC,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,8BAA8B;gBAC7C,QAAQ;gBACR,IAAI,EAAE,QAAQ;gBACd,GAAG,MAAM;aACV,CAAC,CAAC;YAEH,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YACnG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAChD,6BAAkB,CAAC,kBAAkB,EACrC,MAAM,CAAC,UAAU,CAAC,CACnB,CAAC;YACF,MAAM,CAAE,iBAAqB,CAAC,iBAAiB,CAAC,CAAC,oBAAoB,CACnE,aAAa,EACb,EAAE,EACF,WAAW,EACX,MAAM,CACP,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;QAC3C,KAAK,SAAS,CAAC,CAAC,UAAU;YACxB,MAAM;gBACJ,EAAE,EAAE,oBAAoB;gBACxB,KAAK,EAAE,uBAAuB;gBAC9B,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC7F,CAAC;YACF,MAAM;gBACJ,EAAE,EAAE,oBAAoB;gBACxB,KAAK,EAAE,uBAAuB;gBAC9B,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;aAC7E,CAAC;YACF,MAAM;gBACJ,EAAE,EAAE,oBAAoB;gBACxB,KAAK,EAAE,uBAAuB;gBAC9B,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;aACrE,CAAC;QACJ,CAAC;QAED,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;YAChF,MAAM,QAAQ,GAAG;gBACf;oBACE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;oBAC3C,KAAK,EAAE,uBAAuB;oBAC9B,MAAM,EAAE,IAAI;iBACb;aACF,CAAC;YAEF,MAAM,SAAS,GAAG,iBAAe,CAAC,wBAAwB,CAAC;gBACzD,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,+BAA+B;gBAC9C,QAAQ,EAAE,UAAU,EAAE;gBACtB,IAAI,EAAE,QAAQ;gBACd,GAAG,MAAM;gBACT,aAAa,EAAE,6BAAkB,CAAC,0BAA0B;gBAC5D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,IAAI,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;YAChC,CAAC;YACD,MAAM,KAAK,GAAQ,IAAI,CAAC,KAAK,CAAC;YAE9B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC7D,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpD,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC;YACpG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;YACtG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,6BAAkB,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;QACxG,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -41,7 +41,30 @@ describe('Groq Cross-Language Trace Comparison', () => {
         helpers_1.default.createStreamProxy = jest.fn().mockImplementation((stream, _generator) => stream);
         helpers_1.default.buildInputMessages = jest.fn().mockReturnValue('[{"role":"user","parts":[{"type":"text","content":"Test"}]}]');
         helpers_1.default.buildOutputMessages = jest.fn().mockReturnValue('[{"role":"assistant","parts":[{"type":"text","content":"Response"}],"finish_reason":"stop"}]');
+        helpers_1.default.buildSystemInstructionsFromMessages = jest.fn().mockImplementation((messages) => {
+            const sys = (messages || []).find((m) => m?.role === 'system');
+            return sys ? JSON.stringify([{ type: 'text', content: String(sys.content) }]) : undefined;
+        });
+        helpers_1.default.buildToolDefinitions = jest.fn().mockImplementation((tools) => {
+            if (!Array.isArray(tools) || tools.length === 0)
+                return undefined;
+            return JSON.stringify(tools
+                .filter((t) => t?.function?.name || t?.name)
+                .map((t) => ({
+                type: 'function',
+                name: t.function?.name ?? t.name,
+                description: t.function?.description ?? t.description ?? '',
+                parameters: t.function?.parameters ?? t.parameters ?? {},
+            })));
+        });
         helpers_1.default.emitInferenceEvent = jest.fn();
+        // Stamp a deterministic agent version hash so the assertions below can
+        // pin the exact attribute value. The real helper would canonicalise the
+        // prompt + tools + model + runtime config — none of which matters for
+        // verifying the wrapper *plumbs* the result onto the span.
+        helpers_1.default.computeAgentVersionHash = jest
+            .fn()
+            .mockReturnValue('ts-test-version-hash');
         base_wrapper_1.default.recordMetrics = jest.fn();
         base_wrapper_1.default.setBaseSpanAttributes = jest.fn().mockImplementation((span, attrs) => {
             span.setAttribute(semantic_convention_1.default.GEN_AI_PROVIDER_NAME_OTEL, attrs.aiSystem);
@@ -110,6 +133,32 @@ describe('Groq Cross-Language Trace Comparison', () => {
             expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.SERVER_PORT, 443);
             expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_SDK_VERSION, '1.9.0');
         });
+        it('stamps openlit.agent.version_hash on the chat span', async () => {
+            const mockArgs = [
+                {
+                    messages: [{ role: 'user', content: 'Hash me' }],
+                    model: 'llama-3.1-8b-instant',
+                    stream: false,
+                },
+            ];
+            const mockResponse = {
+                id: 'hash-id',
+                created: Date.now(),
+                model: 'llama-3.1-8b-instant',
+                choices: [
+                    { index: 0, finish_reason: 'stop', message: { role: 'assistant', content: 'ok' } },
+                ],
+                usage: { prompt_tokens: 1, completion_tokens: 1, total_tokens: 2 },
+            };
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'groq.chat.completions',
+                response: mockResponse,
+                span: mockSpan,
+            });
+            expect(helpers_1.default.computeAgentVersionHash).toHaveBeenCalled();
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.OPENLIT_AGENT_VERSION_HASH, 'ts-test-version-hash');
+        });
         it('should NOT set total_tokens or client.token.usage on span', async () => {
             const mockArgs = [
                 {
@@ -533,5 +582,106 @@ describe('Groq Cross-Language Trace Comparison', () => {
             expect(wrapper_1.default.serverPort).toBe(443);
         });
     });
+    describe('GenAI semantic conventions: system_instructions + tool_definitions', () => {
+        const buildResponse = () => ({
+            id: 'sys-tools-test',
+            created: Date.now(),
+            model: 'llama-3.1-8b-instant',
+            choices: [
+                {
+                    index: 0,
+                    finish_reason: 'stop',
+                    message: { role: 'assistant', content: 'ok' },
+                },
+            ],
+            usage: { prompt_tokens: 5, completion_tokens: 5, total_tokens: 10 },
+        });
+        it('writes gen_ai.system_instructions on the span and emitted event when a system message is present', async () => {
+            const mockArgs = [
+                {
+                    messages: [
+                        { role: 'system', content: 'You are a helpful assistant.' },
+                        { role: 'user', content: 'hi' },
+                    ],
+                    model: 'llama-3.1-8b-instant',
+                    stream: false,
+                },
+            ];
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'groq.chat.completions',
+                response: buildResponse(),
+                span: mockSpan,
+            });
+            const expectedSysJson = JSON.stringify([
+                { type: 'text', content: 'You are a helpful assistant.' },
+            ]);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_SYSTEM_INSTRUCTIONS, expectedSysJson);
+            const emit = helpers_1.default.emitInferenceEvent;
+            expect(emit).toHaveBeenCalled();
+            const eventAttrs = emit.mock.calls[0][1];
+            expect(eventAttrs[semantic_convention_1.default.GEN_AI_SYSTEM_INSTRUCTIONS]).toBe(expectedSysJson);
+        });
+        it('writes gen_ai.tool.definitions on the span and emitted event when tools are present', async () => {
+            const mockArgs = [
+                {
+                    messages: [{ role: 'user', content: 'use a tool' }],
+                    model: 'llama-3.1-8b-instant',
+                    stream: false,
+                    tools: [
+                        {
+                            type: 'function',
+                            function: {
+                                name: 'get_weather',
+                                description: 'Get current weather',
+                                parameters: { type: 'object', properties: {} },
+                            },
+                        },
+                    ],
+                },
+            ];
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'groq.chat.completions',
+                response: buildResponse(),
+                span: mockSpan,
+            });
+            const expectedToolJson = JSON.stringify([
+                {
+                    type: 'function',
+                    name: 'get_weather',
+                    description: 'Get current weather',
+                    parameters: { type: 'object', properties: {} },
+                },
+            ]);
+            expect(mockSpan.setAttribute).toHaveBeenCalledWith(semantic_convention_1.default.GEN_AI_TOOL_DEFINITIONS, expectedToolJson);
+            const emit = helpers_1.default.emitInferenceEvent;
+            expect(emit).toHaveBeenCalled();
+            const eventAttrs = emit.mock.calls[0][1];
+            expect(eventAttrs[semantic_convention_1.default.GEN_AI_TOOL_DEFINITIONS]).toBe(expectedToolJson);
+        });
+        it('omits both attributes when neither system messages nor tools are provided', async () => {
+            const mockArgs = [
+                {
+                    messages: [{ role: 'user', content: 'hi' }],
+                    model: 'llama-3.1-8b-instant',
+                    stream: false,
+                },
+            ];
+            await wrapper_1.default._chatCompletion({
+                args: mockArgs,
+                genAIEndpoint: 'groq.chat.completions',
+                response: buildResponse(),
+                span: mockSpan,
+            });
+            const setAttrKeys = mockSpan.setAttribute.mock.calls.map(([k]) => k);
+            expect(setAttrKeys).not.toContain(semantic_convention_1.default.GEN_AI_SYSTEM_INSTRUCTIONS);
+            expect(setAttrKeys).not.toContain(semantic_convention_1.default.GEN_AI_TOOL_DEFINITIONS);
+            const emit = helpers_1.default.emitInferenceEvent;
+            const eventAttrs = emit.mock.calls[0][1];
+            expect(eventAttrs[semantic_convention_1.default.GEN_AI_SYSTEM_INSTRUCTIONS]).toBeUndefined();
+            expect(eventAttrs[semantic_convention_1.default.GEN_AI_TOOL_DEFINITIONS]).toBeUndefined();
+        });
+    });
 });
 //# sourceMappingURL=groq-trace-comparison.test.js.map