@sisense/sdk-ai-core 0.5.0 → 0.6.0

package/dist/services/llm/llm-consumption-service.d.ts

@@ -0,0 +1,17 @@
+export declare class QuotaExceededError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Captures consumption of LLM tokens.
+ * @param requestOptions - Optional request options (e.g. from withTrackingHeaders()) for user-action tracking headers.
+ * @returns The capture UUID if successful, undefined otherwise.
+ */
+export declare function captureConsumption(requestOptions?: RequestInit): Promise<string | undefined>;
+/**
+ * Reports consumption of LLM tokens to the backend.
+ * Fire-and-forget: failures are non-critical and are silently ignored.
+ * @param quotaId - The capture UUID from captureConsumption.
+ * @param requestOptions - Optional request options (e.g. from withTrackingHeaders()) for user-action tracking headers.
+ */
+export declare function reportConsumption(quotaId: string, requestOptions?: RequestInit): void;
+//# sourceMappingURL=llm-consumption-service.d.ts.map

package/dist/services/llm/llm-consumption-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-consumption-service.d.ts","sourceRoot":"","sources":["../../../src/services/llm/llm-consumption-service.ts"],"names":[],"mappings":"AAMA,qBAAa,kBAAmB,SAAQ,KAAK;gBAChC,OAAO,SAAmB;CAItC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACvC,cAAc,CAAC,EAAE,WAAW,GAC1B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA+B7B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,WAAW,GAC1B,IAAI,CAQN"}

package/dist/utils/create-custom-fetch.d.ts

@@ -0,0 +1,10 @@
+import { HttpClient } from '@sisense/sdk-rest-client';
+/**
+ * Factory function to create a custom fetch function for OpenAI chat completions
+ * This fetch function applies authentication headers from the provided httpClient
+ * and sets the user action tracking headers.
+ * @param httpClient - The HTTP client instance to use for authentication
+ * @returns Custom fetch function
+ */
+export declare function createCustomFetch(httpClient: HttpClient): (url: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+//# sourceMappingURL=create-custom-fetch.d.ts.map

package/dist/utils/create-custom-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-custom-fetch.d.ts","sourceRoot":"","sources":["../../src/utils/create-custom-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAItD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,IAEtD,KAAK,WAAW,GAAG,GAAG,EACtB,OAAO,WAAW,KAChB,OAAO,CAAC,QAAQ,CAAC,CA+BpB"}

package/dist/utils/http-client.d.ts

@@ -24,10 +24,7 @@ export declare function createHttpClientFromAuthenticator(url: string, authentic
  */
 export declare function createHttpClientFromConfig(config: AuthenticatorConfig): HttpClient;
 /**
- * Factory function to create a custom fetch function for OpenAI chat completions
- * This fetch function applies authentication headers from the provided httpClient
- * @param httpClient - The HTTP client instance to use for authentication
- * @returns Custom fetch function
+ * Extracts HTTP status code from various error shapes (Axios, fetch, custom).
  */
-export declare function createCustomFetch(httpClient: HttpClient): (url: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export declare function getHttpErrorStatus(error: unknown): number | undefined;
 //# sourceMappingURL=http-client.d.ts.map

package/dist/utils/http-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EAEb,UAAU,EACV,MAAM,0BAA0B,CAAC;AAUlC,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAChD,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,aAAa,GAC1B,UAAU,CAYZ;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,mBAAmB,GACzB,UAAU,CAQZ;AAOD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,IAEtD,KAAK,WAAW,GAAG,GAAG,EACtB,OAAO,WAAW,KAChB,OAAO,CAAC,QAAQ,CAAC,CAqCpB"}
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EAEb,UAAU,EACV,MAAM,0BAA0B,CAAC;AAKlC,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAChD,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,aAAa,GAC1B,UAAU,CAYZ;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,mBAAmB,GACzB,UAAU,CAQZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOrE"}

package/dist/utils/user-action-tracking.d.ts

@@ -1,33 +1,24 @@
-/**
- * User Action Tracking Utility
- *
- * Provides functionality for generating user action IDs and W3C traceparent headers
- * to enable end-to-end trace visibility across the Assistant, ai-integration, and LLM services.
- *
- * The client generates valid W3C traceparent headers which ai-integration (server-side)
- * uses to create/continue traces in Langfuse. No Langfuse keys are needed on the client.
- */
-export declare const USER_ACTION_ID_HEADER = "x-user-action-id";
-export declare const TRACEPARENT_HEADER = "traceparent";
+import { HEADER_FEATURE_NAME, HEADER_INTERFACE_NAME, HEADER_QUOTA_ID, HEADER_TRACEPARENT, HEADER_USER_ACTION_ID } from '../constants';
 export declare function generateUserActionId(): string;
 export declare function generateTraceparent(): string;
 export interface UserActionHeaders extends Record<string, string> {
-    [USER_ACTION_ID_HEADER]: string;
-    [TRACEPARENT_HEADER]: string;
-}
-declare class UserActionContext {
-    private currentActionId;
-    private currentTraceparent;
-    startAction(): UserActionHeaders;
-    getHeaders(): UserActionHeaders;
-    endAction(): void;
-    hasActiveAction(): boolean;
-    getCurrentActionId(): string | null;
+    [HEADER_USER_ACTION_ID]: string;
+    [HEADER_TRACEPARENT]: string;
+    [HEADER_INTERFACE_NAME]: string;
+    [HEADER_FEATURE_NAME]: string;
+    [HEADER_QUOTA_ID]: string;
 }
-export declare const userActionContext: UserActionContext;
-export declare function startUserAction(): UserActionHeaders;
+export declare const startUserAction: (interfaceName?: string, featureName?: string) => Promise<UserActionHeaders>;
 export declare function getUserActionHeaders(): UserActionHeaders;
 export declare function withTrackingHeaders(options?: RequestInit): RequestInit;
-export declare function endUserAction(): void;
-export {};
+export declare const endUserAction: () => void;
+/**
+ * Wraps an async function with user-action tracking (capture at start, report at end).
+ * Use for standalone engine calls (e.g., from MCP Server) when tracing and consumption tracking are required.
+ * @param interfaceName - e.g. 'MCP'
+ * @param featureName - e.g. 'BUILD-CHART'
+ * @param fn - The async function to execute
+ * @returns The result of fn
+ */
+export declare function runWithUserAction<T>(interfaceName: string, featureName: string, fn: () => Promise<T>): Promise<T>;
 //# sourceMappingURL=user-action-tracking.d.ts.map

package/dist/utils/user-action-tracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-action-tracking.d.ts","sourceRoot":"","sources":["../../src/utils/user-action-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAEhD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAM5C;AAED,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAChE,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAChC,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,cAAM,iBAAiB;IACtB,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,kBAAkB,CAAuB;IAEjD,WAAW,IAAI,iBAAiB;IAMhC,UAAU,IAAI,iBAAiB;IAW/B,SAAS,IAAI,IAAI;IAKjB,eAAe,IAAI,OAAO;IAI1B,kBAAkB,IAAI,MAAM,GAAG,IAAI;CAGnC;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC;AAEzD,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAiCD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,WAAgB,GAAG,WAAW,CAW1E;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}
+{"version":3,"file":"user-action-tracking.d.ts","sourceRoot":"","sources":["../../src/utils/user-action-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,MAAM,aAAa,CAAC;AAOrB,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAM5C;AAED,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAChE,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAChC,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC7B,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAChC,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC9B,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAwED,eAAO,MAAM,eAAe,GAAI,gBAAgB,MAAM,EAAE,cAAc,MAAM,+BAClB,CAAC;AAE3D,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAiCD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,WAAgB,GAAG,WAAW,CAY1E;AAED,eAAO,MAAM,aAAa,YAAsC,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACxC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sisense/sdk-ai-core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "main": "./dist/index.js",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -30,6 +30,7 @@
     "nanoid": "^5.0.9",
     "openai": "^4.86.1",
     "tslib": "^2.8.1",
+    "yaml": "^2.8.2",
     "zod": "^3.24.1",
     "zod-to-json-schema": "^3.24.1"
   },