@x12i/ai-gateway 7.9.1

package/dist-cjs/usage-tracker.cjs

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Usage Tracker
+ *
+ * Manages usage tracking for LLM requests including:
+ * - Token counting
+ * - Consumption calculation (RPM/TPM)
+ * - Usage recording
+ *
+ * Note: x-models dependency removed - usage tracking functions are permanently disabled
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageTracker = void 0;
+/**
+ * Manages usage tracking for LLM requests
+ */
+class UsageTracker {
+    enabled;
+    logger;
+    constructor(config) {
+        this.enabled = config.enableUsageTracking;
+        this.logger = config.logger;
+        // x-models removed - usage tracking initialization disabled
+    }
+    /**
+     * Extracts token usage from router response
+     *
+     * @param response - Router response object
+     * @returns Token usage breakdown
+     */
+    extractTokens(response) {
+        return {
+            prompt: response.usage?.promptTokens || 0,
+            completion: response.usage?.completionTokens || 0,
+            total: response.usage?.totalTokens || 0
+        };
+    }
+    /**
+     * Records usage for a request
+     *
+     * @param params - Usage recording parameters
+     */
+    async recordUsage(params) {
+        // x-models removed - usage recording disabled
+        if (!this.enabled || !params.provider) {
+            return;
+        }
+        // No-op: usage tracking permanently disabled
+    }
+    /**
+     * Calculates consumption for a request
+     *
+     * @param params - Consumption calculation parameters
+     * @returns Consumption data or null if tracking is disabled
+     */
+    async calculateConsumption(params) {
+        // x-models removed - consumption calculation disabled
+        if (!this.enabled || !params.provider) {
+            return null;
+        }
+        // Always return null - usage tracking permanently disabled
+        return null;
+    }
+    /**
+     * Logs consumption data for debugging
+     *
+     * @param jobId - Job ID for logging context
+     * @param provider - Provider name
+     * @param consumption - Consumption data
+     */
+    logConsumption(jobId, provider, consumption) {
+        if (!consumption) {
+            return;
+        }
+        this.logger.debug('Usage consumption calculated', {
+            jobId,
+            provider,
+            rpmConsumption: consumption.rpmConsumption.toFixed(2),
+            tpmConsumption: consumption.tpmConsumption.toFixed(2)
+        });
+    }
+}
+exports.UsageTracker = UsageTracker;

package/dist-cjs/usage-tracker.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Usage Tracker
+ *
+ * Manages usage tracking for LLM requests including:
+ * - Token counting
+ * - Consumption calculation (RPM/TPM)
+ * - Usage recording
+ *
+ * Note: x-models dependency removed - usage tracking functions are permanently disabled
+ */
+import type { Logxer } from '@x12i/logxer';
+import type { LLMResponse } from './types.js';
+export interface UsageTrackerConfig {
+    enableUsageTracking: boolean;
+    usageTier?: string;
+    logger: Logxer;
+}
+/**
+ * Manages usage tracking for LLM requests
+ */
+export declare class UsageTracker {
+    private enabled;
+    private logger;
+    constructor(config: UsageTrackerConfig);
+    /**
+     * Extracts token usage from router response
+     *
+     * @param response - Router response object
+     * @returns Token usage breakdown
+     */
+    extractTokens(response: LLMResponse): {
+        prompt: number;
+        completion: number;
+        total: number;
+    };
+    /**
+     * Records usage for a request
+     *
+     * @param params - Usage recording parameters
+     */
+    recordUsage(params: {
+        timestamp: number;
+        duration: number;
+        tokens: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        provider?: string;
+        modelId?: string;
+    }): Promise<void>;
+    /**
+     * Calculates consumption for a request
+     *
+     * @param params - Consumption calculation parameters
+     * @returns Consumption data or null if tracking is disabled
+     */
+    calculateConsumption(params: {
+        latencyMs: number;
+        promptTokens: number;
+        completionTokens: number;
+        provider?: string;
+    }): Promise<{
+        rpmConsumption: number;
+        tpmConsumption: number;
+    } | null>;
+    /**
+     * Logs consumption data for debugging
+     *
+     * @param jobId - Job ID for logging context
+     * @param provider - Provider name
+     * @param consumption - Consumption data
+     */
+    logConsumption(jobId: string, provider: string, consumption: {
+        rpmConsumption: number;
+        tpmConsumption: number;
+    } | null): void;
+}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@x12i/ai-gateway",
+  "version": "7.9.1",
+  "description": "AI Gateway - Unified interface for LLM provider routing and management",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist-cjs/index.cjs"
+    }
+  },
+  "main": "./dist-cjs/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run rename:cjs && npm run verify:cjs && npm run copy:defaults",
+    "build:esm": "tsc",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "rename:cjs": "node scripts/rename-cjs.cjs",
+    "verify:cjs": "node scripts/verify-cjs-deps.cjs",
+    "copy:defaults": "node -e \"const fs=require('fs');const path=require('path');const src=path.join('src','defaults');const dist=path.join('dist','defaults');const distCjs=path.join('dist-cjs','defaults');const testCompiled=path.join('.tests-compiled','src','defaults');[dist,distCjs,testCompiled].forEach(dir=>{if(!fs.existsSync(dir))fs.mkdirSync(dir,{recursive:true});fs.readdirSync(src).filter(f=>f.endsWith('.json')).forEach(f=>fs.copyFileSync(path.join(src,f),path.join(dir,f)));});fs.copyFileSync('config.defaults.json',path.join('dist','config.defaults.json'));fs.copyFileSync('config.defaults.json',path.join('dist-cjs','config.defaults.json'));\n\"",
+    "prepublishOnly": "rimraf dist dist-cjs && npm run build",
+    "prepack": "rimraf dist dist-cjs && npm run build",
+    "test": "node .tests/run-all.js",
+    "test:basic": "node .tests/basic-usage.test.js",
+    "test:prompt": "node .tests/prompt-input.test.js",
+    "test:memory": "node .tests/working-memory.test.js",
+    "test:types": "node .tests/generic-types.test.js",
+    "test:compile": "tsc -p tsconfig.test.json",
+    "test:object-types": "npm run test:compile && node .tests-compiled/.tests/object-types.test.js",
+    "test:real": "npm run test:compile && node .tests-compiled/.tests/test.js",
+    "test:real:comprehensive": "npm run test:real && npm test",
+    "test:custom-instructions": "npm run test:compile && node .tests-compiled/.tests/test-custom-instructions-only.js",
+    "test:diagnostic": "tsc -p tsconfig.test.json && node .tests-compiled/.tests/diagnostic-test.js",
+    "test:config": "node .tests/config-overrides.test.js",
+    "test:multi": "node .tests/multi-provider.test.js",
+    "test:activities": "node .tests/ai-activities.test.js",
+    "test:activities:standalone": "node .tests/test-activities-standalone.js",
+    "test:focused": "npm run test:compile && node .tests-compiled/.tests/focused-scenarios.test.js",
+    "test:compile:db": "npx tsc .tests/database-verification.test.ts --outDir .tests-compiled --module commonjs --target ES2020 --esModuleInterop --skipLibCheck --resolveJsonModule",
+    "test:db-verification": "npm run test:compile:db && cross-env ACTIVITY_TRACKING_ENABLE_LOGGING=true node .tests-compiled/database-verification.test.js",
+    "test:template-parsing": "npm run test:compile && node .tests-compiled/template-parsing-full.test.js",
+    "test:template-features": "npm run test:compile && node .tests-compiled/template-parsing-features.test.js",
+    "test:schema-format": "npm run test:compile && node .tests-compiled/simple-schema-format.test.js",
+    "test:object-enrichment": "npm run test:compile && node .tests-compiled/object-types-enrichment.test.js",
+    "test:erc": "npm run test:compile && node .tests-compiled/.tests/erc-compliance.test.js",
+    "test:flex-md-parsing": "tsx .tests/flex-md-parsing-scenarios.test.ts",
+    "test:flex-md-esm-regression": "npm run build:esm && node .tests/flex-md-esm-regression.test.mjs",
+    "test:openai": "npm run test:compile && node .tests-compiled/.tests/callOpenAI.js",
+    "deps:latest": "npx npm-check-updates -u && npm install"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "gateway",
+    "router",
+    "provider"
+  ],
+  "author": "x12i",
+  "license": "mit",
+  "dependencies": {
+    "@x12i/ai-providers-router": "^4.6.0",
+    "@x12i/rendrix": "^4.2.0",
+    "@aws-sdk/s3-request-presigner": "^3.953.0",
+    "@x12i/env": "^4.0.1",
+    "@x12i/logxer": "^4.0.2",
+    "@x12i/activix": "^6.4.0",
+    "@x12i/flex-md": "^4.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "dotenv": "^17.2.3",
+    "rimraf": "^5.0.0",
+    "tsx": "^4.21.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "dist-cjs",
+    "config.defaults.json",
+    "README.md",
+    "CONTENT_RESOLVER_UPSTREAM_GUIDE.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/x12i/ai-gateway.git"
+  }
+}