openlit 1.10.0 → 1.12.0

package/README.md

@@ -202,7 +202,7 @@ Below is a detailed overview of the configuration options available, allowing yo
 | `traceContent`          | Enables tracing of content for deeper insights.                                      | `true`                                                             | No       |
 | `disabledInstrumentations` | List of instrumentations to disable.                                                    | `undefined`                                                             | No       |
 | `instrumentations`        | Object of instrumentation modules for manual patching                                          | `undefined`                                                            | No       |
-| `pricing_json`           | URL or file path of the pricing JSON file.                                           | `https://github.com/openlit/openlit/blob/main/assets/pricing.json` | No       |
+| `pricingJson`           | URL or file path of the pricing JSON file.                                           | `https://github.com/openlit/openlit/blob/main/assets/pricing.json` | No       |
 
 ### OpenLIT Prompt Hub - `Openlit.getPrompt()`
 
@@ -234,6 +234,40 @@ Below are the parameters for use with the SDK for OpenLIT Vault for secret manag
 
 
 
+### OpenLIT Rule Engine - `Openlit.evaluateRule()`
+
+Evaluate trace attributes against the OpenLIT Rule Engine to retrieve matching rules and associated entities (contexts, prompts, evaluation configurations).
+
+| Parameter          | Description                                                                                                                        |
+|--------------------|------------------------------------------------------------------------------------------------------------------------------------|
+| `url`              | Sets the OpenLIT URL. Defaults to the `OPENLIT_URL` environment variable or `http://127.0.0.1:3000`.                               |
+| `apiKey`           | Sets the OpenLIT API Key. Can also be provided via the `OPENLIT_API_KEY` environment variable.                                     |
+| `entityType`       | Type of entity to match: `"context"`, `"prompt"`, or `"evaluation"`.                                                               |
+| `fields`           | Object of trace attributes to evaluate against rules. e.g. `{ "gen_ai.system": "openai" }`                                        |
+| `includeEntityData`| If `true`, include full entity data in the response. Default: `false`. Optional                                                    |
+| `entityInputs`     | Optional object of inputs for entity resolution (e.g. prompt variables).                                                           |
+
+#### Example
+
+```typescript
+import Openlit from 'openlit';
+
+const result = await Openlit.evaluateRule({
+  entityType: 'context',
+  fields: {
+    'gen_ai.system': 'openai',
+    'gen_ai.request.model': 'gpt-4',
+    'service.name': 'my-app',
+  },
+  includeEntityData: true,
+});
+
+if (!('err' in result)) {
+  console.log('Matching rules:', result.matchingRuleIds);
+  console.log('Entities:', result.entities);
+}
+```
+
 ## 🌱 Contributing
 
 Whether it's big or small, we love contributions 💚. Check out our [Contribution guide](../../CONTRIBUTING.md) to get started

package/dist/config.d.ts

@@ -7,8 +7,16 @@ export default class OpenlitConfig {
     static otlpEndpoint?: OpenlitConfigInterface['otlpEndpoint'];
     static otlpHeaders?: OpenlitConfigInterface['otlpHeaders'];
     static disableBatch?: OpenlitConfigInterface['disableBatch'];
-    static traceContent?: OpenlitConfigInterface['traceContent'];
-    static pricing_json?: OpenlitConfigInterface['pricing_json'];
-    static updatePricingJson(pricing_json: any): Promise<PricingObject>;
-    static updateConfig({ environment, applicationName, tracer, otlpEndpoint, otlpHeaders, disableBatch, traceContent, pricing_json, }: OpenlitConfigInterface): void;
+    static captureMessageContent?: OpenlitConfigInterface['captureMessageContent'];
+    static pricingJson?: OpenlitConfigInterface['pricingJson'];
+    static disableMetrics?: boolean;
+    static disableEvents?: boolean;
+    static maxContentLength?: number | null;
+    static customSpanAttributes?: Record<string, string> | null;
+    static updateConfig({ environment, applicationName, tracer, otlpEndpoint, otlpHeaders, disableBatch, captureMessageContent, pricingJson, disableMetrics, disableEvents, maxContentLength, customSpanAttributes, }: Partial<OpenlitConfigInterface> & {
+        disableMetrics?: boolean;
+        disableEvents?: boolean;
+        maxContentLength?: number | null;
+        customSpanAttributes?: Record<string, string> | null;
+    }): void;
 }

package/dist/config.js

@@ -1,29 +1,19 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const helpers_1 = __importDefault(require("./helpers"));
 class OpenlitConfig {
-    static async updatePricingJson(pricing_json) {
-        try {
-            const response = await helpers_1.default.fetchPricingInfo(pricing_json);
-            this.pricingInfo = response;
-        }
-        catch (e) {
-            this.pricingInfo = {};
-        }
-        return this.pricingInfo;
-    }
-    static updateConfig({ environment = 'default', applicationName = 'default', tracer, otlpEndpoint, otlpHeaders, disableBatch = true, traceContent = true, pricing_json, }) {
+    static updateConfig({ environment = 'default', applicationName = 'default', tracer, otlpEndpoint, otlpHeaders, disableBatch = false, captureMessageContent = true, pricingJson, disableMetrics = false, disableEvents = false, maxContentLength = null, customSpanAttributes = null, }) {
         this.environment = environment;
         this.applicationName = applicationName;
         this.tracer = tracer;
         this.otlpEndpoint = otlpEndpoint;
         this.otlpHeaders = otlpHeaders;
         this.disableBatch = disableBatch;
-        this.traceContent = traceContent;
-        this.pricing_json = pricing_json;
+        this.captureMessageContent = captureMessageContent;
+        this.pricingJson = pricingJson;
+        this.disableMetrics = disableMetrics;
+        this.disableEvents = disableEvents;
+        this.maxContentLength = maxContentLength;
+        this.customSpanAttributes = customSpanAttributes;
     }
 }
 exports.default = OpenlitConfig;

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;AAAA,wDAAsC;AAGtC,MAAqB,aAAa;IAWhC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,YAAiB;QAC9C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,iBAAa,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;YACpE,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC;QAC9B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,EAClB,WAAW,GAAG,SAAS,EACvB,eAAe,GAAG,SAAS,EAC3B,MAAM,EACN,YAAY,EACZ,WAAW,EACX,YAAY,GAAG,IAAI,EACnB,YAAY,GAAG,IAAI,EACnB,YAAY,GACW;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAxCD,gCAwCC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AAEA,MAAqB,aAAa;IAehC,MAAM,CAAC,YAAY,CAAC,EAClB,WAAW,GAAG,SAAS,EACvB,eAAe,GAAG,SAAS,EAC3B,MAAM,EACN,YAAY,EACZ,WAAW,EACX,YAAY,GAAG,KAAK,EACpB,qBAAqB,GAAG,IAAI,EAC5B,WAAW,EACX,cAAc,GAAG,KAAK,EACtB,aAAa,GAAG,KAAK,EACrB,gBAAgB,GAAG,IAAI,EACvB,oBAAoB,GAAG,IAAI,GAM5B;QACC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,MAA0C,CAAC;QACzD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,qBAAqB,GAAG,qBAAqB,CAAC;QACnD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;IACnD,CAAC;CACF;AA/CD,gCA+CC"}

package/dist/evals/llm/anthropic.js

@@ -1,12 +1,16 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.llmResponseAnthropic = llmResponseAnthropic;
-const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
 async function llmResponseAnthropic({ prompt, model, apiKey }) {
-    const client = new sdk_1.default({ apiKey });
+    let Anthropic;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        Anthropic = require('@anthropic-ai/sdk').default;
+    }
+    catch {
+        throw new Error("openlit eval features require the '@anthropic-ai/sdk' package. Install it with: npm install @anthropic-ai/sdk");
+    }
+    const client = new Anthropic({ apiKey });
     const usedModel = model || 'claude-3-opus-20240229';
     const response = await client.messages.create({
         model: usedModel,
@@ -30,7 +34,7 @@ async function llmResponseAnthropic({ prompt, model, apiKey }) {
         // Fallback: join all text blocks that have text
         return response.content
             .filter((p) => p.type === 'text' && typeof p.text === 'string')
-            .map(p => p.text)
+            .map((p) => p.text)
             .join(' ');
     }
     return '';

package/dist/evals/llm/anthropic.js.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../src/evals/llm/anthropic.ts"],"names":[],"mappings":";;;;;AAEA,oDAoCC;AAtCD,4DAA0C;AAEnC,KAAK,UAAU,oBAAoB,CAAC,EACzC,MAAM,EACN,KAAK,EACL,MAAM,EAKP;IACC,MAAM,MAAM,GAAG,IAAI,aAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,KAAK,IAAI,wBAAwB,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC5C,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;SAClC;QACD,WAAW,EAAE,GAAG;QAChB,wEAAwE;KACzE,CAAC,CAAC;IACH,gDAAgD;IAChD,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;IAClE,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,gDAAgD;QAChD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9F,OAAO,IAAI,CAAC,IAAI,CAAC;YACnB,CAAC;QACH,CAAC;QACD,gDAAgD;QAChD,OAAO,QAAQ,CAAC,OAAO;aACpB,MAAM,CAAC,CAAC,CAAmC,EAAwC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;aACtI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAChB,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../src/evals/llm/anthropic.ts"],"names":[],"mappings":";;AAAA,oDA6CC;AA7CM,KAAK,UAAU,oBAAoB,CAAC,EACzC,MAAM,EACN,KAAK,EACL,MAAM,EAKP;IACC,IAAI,SAAc,CAAC;IACnB,IAAI,CAAC;QACH,8DAA8D;QAC9D,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,+GAA+G,CAChH,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,KAAK,IAAI,wBAAwB,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC5C,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;SAClC;QACD,WAAW,EAAE,GAAG;QAChB,wEAAwE;KACzE,CAAC,CAAC;IACH,gDAAgD;IAChD,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;IAClE,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,gDAAgD;QAChD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9F,OAAO,IAAI,CAAC,IAAI,CAAC;YACnB,CAAC;QACH,CAAC;QACD,gDAAgD;QAChD,OAAO,QAAQ,CAAC,OAAO;aACpB,MAAM,CAAC,CAAC,CAAmC,EAAwC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;aACtI,GAAG,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aACpC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/evals/llm/openai.js

@@ -1,12 +1,16 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.llmResponseOpenAI = llmResponseOpenAI;
-const openai_1 = __importDefault(require("openai"));
 async function llmResponseOpenAI({ prompt, model, apiKey, baseUrl }) {
-    const client = new openai_1.default({
+    let OpenAI;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        OpenAI = require('openai').default;
+    }
+    catch {
+        throw new Error("openlit eval features require the 'openai' package. Install it with: npm install openai");
+    }
+    const client = new OpenAI({
         apiKey,
         baseURL: baseUrl || 'https://api.openai.com/v1',
     });

package/dist/evals/llm/openai.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/evals/llm/openai.ts"],"names":[],"mappings":";;;;;AAEA,8CAyBC;AA3BD,oDAA4B;AAErB,KAAK,UAAU,iBAAiB,CAAC,EACtC,MAAM,EACN,KAAK,EACL,MAAM,EACN,OAAO,EAMR;IACC,MAAM,MAAM,GAAG,IAAI,gBAAM,CAAC;QACxB,MAAM;QACN,OAAO,EAAE,OAAO,IAAI,2BAA2B;KAChD,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,KAAK,IAAI,QAAQ,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACpD,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;SAClC;QACD,WAAW,EAAE,GAAG;QAChB,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;KACzC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;AACnD,CAAC"}
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/evals/llm/openai.ts"],"names":[],"mappings":";;AAAA,8CAkCC;AAlCM,KAAK,UAAU,iBAAiB,CAAC,EACtC,MAAM,EACN,KAAK,EACL,MAAM,EACN,OAAO,EAMR;IACC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;QACxB,MAAM;QACN,OAAO,EAAE,OAAO,IAAI,2BAA2B;KAChD,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,KAAK,IAAI,QAAQ,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACpD,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;SAClC;QACD,WAAW,EAAE,GAAG;QAChB,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;KACzC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;AACnD,CAAC"}

package/dist/features/__tests__/rule-engine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/__tests__/rule-engine.test.js

@@ -0,0 +1,146 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const rule_engine_1 = __importDefault(require("../rule-engine"));
+// Mock OpenlitConfig
+jest.mock('../../config', () => ({
+    __esModule: true,
+    default: {
+        applicationName: 'test-app',
+        environment: 'test',
+    },
+}));
+// Mock constant
+jest.mock('../../constant', () => ({
+    OPENLIT_URL: 'http://127.0.0.1:3000',
+}));
+// Save original env
+const originalEnv = process.env;
+beforeEach(() => {
+    jest.restoreAllMocks();
+    process.env = { ...originalEnv };
+    delete process.env.OPENLIT_URL;
+    delete process.env.OPENLIT_API_KEY;
+});
+afterAll(() => {
+    process.env = originalEnv;
+});
+describe('RuleEngine.evaluateRule', () => {
+    it('sends correct request to rule-engine evaluate endpoint', async () => {
+        const mockResponse = {
+            matchingRuleIds: ['rule-1'],
+            entities: [{ rule_id: 'rule-1', entity_type: 'context', entity_id: 'ctx-1' }],
+        };
+        global.fetch = jest.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve(mockResponse),
+        });
+        const result = await rule_engine_1.default.evaluateRule({
+            url: 'http://localhost:3000',
+            apiKey: 'test-key',
+            entityType: 'context',
+            fields: { 'gen_ai.system': 'openai' },
+        });
+        expect(global.fetch).toHaveBeenCalledTimes(1);
+        const [url, options] = global.fetch.mock.calls[0];
+        expect(url).toBe('http://localhost:3000/api/rule-engine/evaluate');
+        expect(options.method).toBe('POST');
+        expect(options.headers.Authorization).toBe('Bearer test-key');
+        const body = JSON.parse(options.body);
+        expect(body.entity_type).toBe('context');
+        expect(body.fields).toEqual({ 'gen_ai.system': 'openai' });
+        expect(body.source).toBe('ts-sdk');
+        expect(result).toEqual(mockResponse);
+    });
+    it('returns error object on HTTP error', async () => {
+        global.fetch = jest.fn().mockResolvedValue({
+            ok: false,
+            status: 401,
+        });
+        const result = await rule_engine_1.default.evaluateRule({
+            url: 'http://localhost:3000',
+            apiKey: 'bad-key',
+            entityType: 'context',
+            fields: {},
+        });
+        expect(result).toHaveProperty('err');
+        expect(result.err).toContain('401');
+    });
+    it('returns error object on network failure', async () => {
+        global.fetch = jest.fn().mockRejectedValue(new Error('Network error'));
+        const result = await rule_engine_1.default.evaluateRule({
+            url: 'http://localhost:3000',
+            apiKey: 'test-key',
+            entityType: 'context',
+            fields: {},
+        });
+        expect(result).toHaveProperty('err');
+        expect(result.err).toContain('Network error');
+    });
+    it('uses OPENLIT_URL env var as fallback', async () => {
+        process.env.OPENLIT_URL = 'http://env-host:4000';
+        global.fetch = jest.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ matchingRuleIds: [] }),
+        });
+        await rule_engine_1.default.evaluateRule({
+            apiKey: 'key',
+            entityType: 'context',
+            fields: {},
+        });
+        const [url] = global.fetch.mock.calls[0];
+        expect(url).toBe('http://env-host:4000/api/rule-engine/evaluate');
+    });
+    it('uses OPENLIT_API_KEY env var as fallback', async () => {
+        process.env.OPENLIT_API_KEY = 'env-api-key';
+        global.fetch = jest.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ matchingRuleIds: [] }),
+        });
+        await rule_engine_1.default.evaluateRule({
+            url: 'http://localhost:3000',
+            entityType: 'context',
+            fields: {},
+        });
+        const [, options] = global.fetch.mock.calls[0];
+        expect(options.headers.Authorization).toBe('Bearer env-api-key');
+    });
+    it('passes includeEntityData and entityInputs', async () => {
+        global.fetch = jest.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ matchingRuleIds: [], entity_data: {} }),
+        });
+        await rule_engine_1.default.evaluateRule({
+            url: 'http://localhost:3000',
+            apiKey: 'key',
+            entityType: 'prompt',
+            fields: { key: 'val' },
+            includeEntityData: true,
+            entityInputs: { variables: { name: 'test' } },
+        });
+        const body = JSON.parse(global.fetch.mock.calls[0][1].body);
+        expect(body.include_entity_data).toBe(true);
+        expect(body.entity_inputs).toEqual({ variables: { name: 'test' } });
+        expect(body.entity_type).toBe('prompt');
+    });
+    it('includes metaProperties from OpenlitConfig', async () => {
+        global.fetch = jest.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ matchingRuleIds: [] }),
+        });
+        await rule_engine_1.default.evaluateRule({
+            url: 'http://localhost:3000',
+            apiKey: 'key',
+            entityType: 'context',
+            fields: {},
+        });
+        const body = JSON.parse(global.fetch.mock.calls[0][1].body);
+        expect(body.metaProperties).toEqual({
+            applicationName: 'test-app',
+            environment: 'test',
+        });
+    });
+});
+//# sourceMappingURL=rule-engine.test.js.map

package/dist/features/__tests__/rule-engine.test.js.map

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

package/dist/features/base.d.ts

@@ -1,6 +1,8 @@
 import PromptHub from './prompt-hub';
+import RuleEngine from './rule-engine';
 import Vault from './vault';
 export default class BaseOpenlit {
     static getPrompts: typeof PromptHub.getPrompts;
     static getSecrets: typeof Vault.getSecrets;
+    static evaluateRule: typeof RuleEngine.evaluateRule;
 }

package/dist/features/base.js

@@ -4,10 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const prompt_hub_1 = __importDefault(require("./prompt-hub"));
+const rule_engine_1 = __importDefault(require("./rule-engine"));
 const vault_1 = __importDefault(require("./vault"));
 class BaseOpenlit {
 }
 BaseOpenlit.getPrompts = prompt_hub_1.default.getPrompts;
 BaseOpenlit.getSecrets = vault_1.default.getSecrets;
+BaseOpenlit.evaluateRule = rule_engine_1.default.evaluateRule;
 exports.default = BaseOpenlit;
 //# sourceMappingURL=base.js.map

package/dist/features/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/features/base.ts"],"names":[],"mappings":";;;;;AAAA,8DAAqC;AACrC,oDAA4B;AAE5B,MAAqB,WAAW;;AACvB,sBAAU,GAAG,oBAAS,CAAC,UAAU,CAAC;AAClC,sBAAU,GAAG,eAAK,CAAC,UAAU,CAAC;kBAFlB,WAAW"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/features/base.ts"],"names":[],"mappings":";;;;;AAAA,8DAAqC;AACrC,gEAAuC;AACvC,oDAA4B;AAE5B,MAAqB,WAAW;;AACvB,sBAAU,GAAG,oBAAS,CAAC,UAAU,CAAC;AAClC,sBAAU,GAAG,eAAK,CAAC,UAAU,CAAC;AAC9B,wBAAY,GAAG,qBAAU,CAAC,YAAY,CAAC;kBAH3B,WAAW"}

package/dist/features/rule-engine.d.ts

@@ -0,0 +1,6 @@
+import { RuleEngineOptions, RuleEngineResult } from '../types';
+export default class RuleEngine {
+    static evaluateRule(options: RuleEngineOptions): Promise<RuleEngineResult | {
+        err: string;
+    }>;
+}

package/dist/features/rule-engine.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = __importDefault(require("../config"));
+const constant_1 = require("../constant");
+class RuleEngine {
+    static async evaluateRule(options) {
+        const url = process.env.OPENLIT_URL || options.url || constant_1.OPENLIT_URL;
+        const apiKey = process.env.OPENLIT_API_KEY || options.apiKey || '';
+        const metaProperties = {
+            applicationName: config_1.default.applicationName,
+            environment: config_1.default.environment,
+        };
+        try {
+            const response = await fetch(`${url}/api/rule-engine/evaluate`, {
+                method: 'POST',
+                body: JSON.stringify({
+                    entity_type: options.entityType,
+                    fields: options.fields,
+                    include_entity_data: options.includeEntityData || false,
+                    entity_inputs: options.entityInputs,
+                    metaProperties,
+                    source: 'ts-sdk',
+                }),
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+            })
+                .then(async (response) => {
+                if (!response.ok) {
+                    return {
+                        err: `Openlit Error : HTTP error! Status: ${response.status}`,
+                    };
+                }
+                return response.json();
+            })
+                .then((resp) => {
+                return resp;
+            });
+            return response;
+        }
+        catch (e) {
+            console.log(e);
+            if (e && typeof e.toString === 'function') {
+                return {
+                    err: `Openlit Error : ${e.toString()}`,
+                    data: null,
+                };
+            }
+            return {
+                err: `Openlit Error : ${e}`,
+            };
+        }
+    }
+}
+exports.default = RuleEngine;
+//# sourceMappingURL=rule-engine.js.map

package/dist/features/rule-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine.js","sourceRoot":"","sources":["../../src/features/rule-engine.ts"],"names":[],"mappings":";;;;;AAAA,uDAAsC;AACtC,0CAA0C;AAG1C,MAAqB,UAAU;IAC7B,MAAM,CAAC,KAAK,CAAC,YAAY,CACvB,OAA0B;QAE1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,sBAAW,CAAC;QAClE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QAEnE,MAAM,cAAc,GAAG;YACrB,eAAe,EAAE,gBAAa,CAAC,eAAe;YAC9C,WAAW,EAAE,gBAAa,CAAC,WAAW;SACvC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,2BAA2B,EAAE;gBAC9D,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,WAAW,EAAE,OAAO,CAAC,UAAU;oBAC/B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,mBAAmB,EAAE,OAAO,CAAC,iBAAiB,IAAI,KAAK;oBACvD,aAAa,EAAE,OAAO,CAAC,YAAY;oBACnC,cAAc;oBACd,MAAM,EAAE,QAAQ;iBACjB,CAAC;gBACF,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,MAAM,EAAE;oBACjC,cAAc,EAAE,kBAAkB;iBACnC;aACF,CAAC;iBACC,IAAI,CAAC,KAAK,EAAE,QAAa,EAAE,EAAE;gBAC5B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,OAAO;wBACL,GAAG,EAAE,uCAAuC,QAAQ,CAAC,MAAM,EAAE;qBAC9D,CAAC;gBACJ,CAAC;gBACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;YACzB,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,IAAS,EAAE,EAAE;gBAClB,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YAEL,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAC1C,OAAO;oBACL,GAAG,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,EAAE;oBACtC,IAAI,EAAE,IAAI;iBACJ,CAAC;YACX,CAAC;YAED,OAAO;gBACL,GAAG,EAAE,mBAAmB,CAAC,EAAE;aAC5B,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAvDD,6BAuDC"}

package/dist/features/vault.js

@@ -38,7 +38,7 @@ class Vault {
                 return resp;
             });
             const { res = {} } = vaultResponse;
-            if (!!options.shouldSetEnv) {
+            if (options.shouldSetEnv) {
                 Object.entries(res).forEach(([key, value]) => {
                     process.env[key] = value;
                 });

package/dist/features/vault.js.map

@@ -1 +1 @@
-{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../src/features/vault.ts"],"names":[],"mappings":";;;;;AAAA,uDAAsC;AACtC,0CAA0C;AAG1C,MAAqB,KAAK;IACxB,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAqB;QAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,sBAAW,CAAC;QAClE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QAEnE,MAAM,cAAc,GAAG;YACrB,eAAe,EAAE,gBAAa,CAAC,eAAe;YAC9C,WAAW,EAAE,gBAAa,CAAC,WAAW;SACvC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,wBAAwB,EAAE;gBAChE,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,cAAc;oBACd,MAAM,EAAE,QAAQ;iBACjB,CAAC;gBACF,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,MAAM,EAAE;iBAClC;aACF,CAAC;iBACC,IAAI,CAAC,KAAK,EAAE,QAAa,EAAE,EAAE;gBAC5B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,OAAO;wBACL,GAAG,EAAE,uCAAuC,QAAQ,CAAC,MAAM,EAAE;qBAC9D,CAAC;gBACJ,CAAC;gBACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;YACzB,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,IAAS,EAAE,EAAE;gBAClB,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YAEL,MAAM,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,aAAa,CAAC;YACnC,IAAI,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAC3B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAoB,EAAE,EAAE;oBAC9D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAe,CAAC;gBACrC,CAAC,CAAC,CAAC;YACL,CAAC;YAED,OAAO,aAAa,CAAC;QACvB,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAC1C,OAAO;oBACL,GAAG,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,EAAE;oBACtC,IAAI,EAAE,IAAI;iBACX,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,GAAG,EAAE,mBAAmB,CAAC,EAAE;aAC5B,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAzDD,wBAyDC"}
+{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../src/features/vault.ts"],"names":[],"mappings":";;;;;AAAA,uDAAsC;AACtC,0CAA0C;AAG1C,MAAqB,KAAK;IACxB,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAqB;QAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,sBAAW,CAAC;QAClE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QAEnE,MAAM,cAAc,GAAG;YACrB,eAAe,EAAE,gBAAa,CAAC,eAAe;YAC9C,WAAW,EAAE,gBAAa,CAAC,WAAW;SACvC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,wBAAwB,EAAE;gBAChE,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,cAAc;oBACd,MAAM,EAAE,QAAQ;iBACjB,CAAC;gBACF,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,MAAM,EAAE;iBAClC;aACF,CAAC;iBACC,IAAI,CAAC,KAAK,EAAE,QAAa,EAAE,EAAE;gBAC5B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,OAAO;wBACL,GAAG,EAAE,uCAAuC,QAAQ,CAAC,MAAM,EAAE;qBAC9D,CAAC;gBACJ,CAAC;gBACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;YACzB,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,IAAS,EAAE,EAAE;gBAClB,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YAEL,MAAM,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,aAAa,CAAC;YACnC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;gBACzB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAoB,EAAE,EAAE;oBAC9D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAe,CAAC;gBACrC,CAAC,CAAC,CAAC;YACL,CAAC;YAED,OAAO,aAAa,CAAC;QACvB,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAC1C,OAAO;oBACL,GAAG,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,EAAE;oBACtC,IAAI,EAAE,IAAI;iBACX,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,GAAG,EAAE,mBAAmB,CAAC,EAAE;aAC5B,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAzDD,wBAyDC"}

package/dist/helpers.d.ts

@@ -1,4 +1,90 @@
-import { Span } from '@opentelemetry/api';
+import { Attributes, Context, Span } from '@opentelemetry/api';
+/**
+ * Returns true when a framework instrumentor (LangChain, LiteLLM, etc.)
+ * owns the current LLM span. Provider-level wrappers (OpenAI, Anthropic, …)
+ * must skip their own span creation when this returns true.
+ */
+export declare function isFrameworkLlmActive(): boolean;
+/**
+ * Run `fn` with the framework-LLM-active flag set. All provider wrappers
+ * invoked inside `fn` will see `isFrameworkLlmActive() === true`.
+ */
+export declare function runWithFrameworkLlm<T>(fn: () => T): T;
+/**
+ * Set framework-LLM-active flag in the current execution context.
+ * Used by SpanProcessor-based instrumentations (Strands) where
+ * the processor observes spans rather than controlling execution.
+ * Mirrors Python's ContextVar.set(True) in Strands processor.
+ */
+export declare function setFrameworkLlmActive(): void;
+/**
+ * Reset framework-LLM-active flag in the current execution context.
+ * Mirrors Python's ContextVar.reset(token) in Strands processor.
+ */
+export declare function resetFrameworkLlmActive(): void;
+/**
+ * Returns true when a LangGraph wrapper is controlling execution.
+ * LangChain's callback handler skips its own invoke_workflow span when true.
+ */
+export declare function isLangGraphActive(): boolean;
+export declare function runWithLangGraph<T>(fn: () => T): T;
+/**
+ * Returns true when a create_agent span is already being handled
+ * (prevents duplicate spans between LangChain and LangGraph).
+ */
+export declare function isCreateAgentActive(): boolean;
+export declare function runWithCreateAgent<T>(fn: () => T): T;
+/**
+ * Propagate conversation ID from invoke_workflow to child node spans.
+ * Mirrors Python's set_langgraph_conversation_id / get_langgraph_conversation_id.
+ */
+export declare function getLangGraphConversationId(): string | undefined;
+export declare function runWithLangGraphConversationId<T>(conversationId: string, fn: () => T): T;
+/**
+ * Returns the OTel context set by a framework processor (OpenAI Agents, etc.)
+ * so that provider wrappers can create spans as children of framework spans.
+ * Mirrors Python's context_api.attach(set_span_in_context(span)).
+ */
+export declare function getFrameworkParentContext(): Context | undefined;
+/**
+ * Set the OTel parent context for provider span creation.
+ * Called by processor-based frameworks that cannot use context.with().
+ */
+export declare function setFrameworkParentContext(ctx: Context): void;
+/**
+ * Clear the framework parent context.
+ */
+export declare function clearFrameworkParentContext(): void;
+export declare function getServerAddressForProvider(provider: string): [string, number];
+/**
+ * Apply global (from init) and context-scoped (from usingAttributes /
+ * injectAdditionalAttributes) custom attributes to a span.
+ * Global attributes are applied first; context attributes override on conflict.
+ * Matches Python's _apply_custom_span_attributes().
+ */
+export declare function applyCustomSpanAttributes(span: Span): void;
+/**
+ * Get merged custom attributes (global + context) for use in events.
+ * Returns a flat object; context attributes override global on conflict.
+ */
+export declare function getMergedCustomAttributes(): Record<string, any>;
+/**
+ * Run a function with custom span attributes attached to all
+ * auto-instrumented spans created during its execution.
+ * Matches Python's openlit.inject_additional_attributes().
+ */
+export declare function injectAdditionalAttributes<T>(fn: () => T, attributes: Record<string, any>): T;
+/**
+ * Context wrapper that adds custom attributes to all auto-instrumented
+ * spans created within its callback scope.
+ * Matches Python's openlit.using_attributes() context manager.
+ *
+ * Usage:
+ *   await usingAttributes({"user.id": "u1", "team": "ml"}, async () => {
+ *     await client.chat.completions.create(...);
+ *   });
+ */
+export declare function usingAttributes<T>(attributes: Record<string, any>, fn: () => T): T;
 export default class OpenLitHelper {
     static readonly PROMPT_TOKEN_FACTOR = 1000;
     static openaiTokens(text: string, model: string): number;
@@ -18,6 +104,12 @@ export default class OpenLitHelper {
      * Format: [{"role": "assistant", "parts": [{"type": "text", "content": "..."}], "finish_reason": "stop"}]
      */
     static buildOutputMessages(text: string, finishReason: string, toolCalls?: any[]): string;
+    /**
+     * Emit an inference event via the LoggerProvider, matching Python SDK's
+     * gen_ai.client.inference.operation.details event.
+     * Falls back to span.addEvent if LoggerProvider is not available.
+     */
+    static emitInferenceEvent(span: Span, attrs: Attributes): void;
     static handleException(span: Span, error: Error): void;
     static createStreamProxy(stream: any, generatorFuncResponse: any): Promise<any>;
 }