@x12i/optimixer 0.1.0

package/dist-cjs/pipelines/ai-max-tokens-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-max-tokens-v1.js","sourceRoot":"","sources":["../../src/pipelines/ai-max-tokens-v1.ts"],"names":[],"mappings":"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"}

package/dist-cjs/state/bucket-store.d.ts

@@ -0,0 +1,14 @@
+import { QuantileStats } from './quantile-stats.js';
+export type BucketKeyParts = {
+    actionTypeId: string;
+    provider?: string;
+    model?: string;
+};
+export declare function buildBucketKey(parts: BucketKeyParts): string;
+export declare class BucketStore {
+    private readonly buckets;
+    getOrCreate(key: string): QuantileStats;
+    observe(key: string, completionTokens: number): void;
+    statsFor(key: string): QuantileStats | undefined;
+}
+//# sourceMappingURL=bucket-store.d.ts.map

package/dist-cjs/state/bucket-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucket-store.d.ts","sourceRoot":"","sources":["../../src/state/bucket-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAI5D;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAE5D,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IASvC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAIpD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;CAGjD"}

package/dist-cjs/state/bucket-store.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BucketStore = void 0;
+exports.buildBucketKey = buildBucketKey;
+const quantile_stats_js_1 = require("./quantile-stats.js");
+function buildBucketKey(parts) {
+    const provider = parts.provider?.trim() || '*';
+    const model = parts.model?.trim() || '*';
+    return `${parts.actionTypeId}|${provider}|${model}`;
+}
+class BucketStore {
+    buckets = new Map();
+    getOrCreate(key) {
+        let stats = this.buckets.get(key);
+        if (!stats) {
+            stats = new quantile_stats_js_1.QuantileStats();
+            this.buckets.set(key, stats);
+        }
+        return stats;
+    }
+    observe(key, completionTokens) {
+        this.getOrCreate(key).observe(completionTokens);
+    }
+    statsFor(key) {
+        return this.buckets.get(key);
+    }
+}
+exports.BucketStore = BucketStore;
+//# sourceMappingURL=bucket-store.js.map

package/dist-cjs/state/bucket-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucket-store.js","sourceRoot":"","sources":["../../src/state/bucket-store.ts"],"names":[],"mappings":";;;AAQA,wCAIC;AAZD,2DAAoD;AAQpD,SAAgB,cAAc,CAAC,KAAqB;IAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC;IAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC;IACzC,OAAO,GAAG,KAAK,CAAC,YAAY,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;AACtD,CAAC;AAED,MAAa,WAAW;IACL,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE5D,WAAW,CAAC,GAAW;QACrB,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,IAAI,iCAAa,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,gBAAwB;QAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC;IAED,QAAQ,CAAC,GAAW;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;CACF;AAnBD,kCAmBC"}

package/dist-cjs/state/quantile-stats.d.ts

@@ -0,0 +1,12 @@
+/**
+ * In-memory quantile statistics for completion token observations.
+ */
+export declare class QuantileStats {
+    private readonly values;
+    observe(value: number): void;
+    get count(): number;
+    percentile(p: number): number | undefined;
+    max(): number | undefined;
+}
+export declare function riskToPercentile(risk: import('../contracts/optimixer-types.js').OptimixerAcceptableRisk): number;
+//# sourceMappingURL=quantile-stats.d.ts.map

package/dist-cjs/state/quantile-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quantile-stats.d.ts","sourceRoot":"","sources":["../../src/state/quantile-stats.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ5B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IASzC,GAAG,IAAI,MAAM,GAAG,SAAS;CAM1B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,iCAAiC,EAAE,uBAAuB,GAAG,MAAM,CAgBhH"}

package/dist-cjs/state/quantile-stats.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuantileStats = void 0;
+exports.riskToPercentile = riskToPercentile;
+/**
+ * In-memory quantile statistics for completion token observations.
+ */
+class QuantileStats {
+    values = [];
+    observe(value) {
+        if (!Number.isFinite(value) || value < 0) {
+            return;
+        }
+        this.values.push(value);
+        this.values.sort((a, b) => a - b);
+    }
+    get count() {
+        return this.values.length;
+    }
+    percentile(p) {
+        if (this.values.length === 0) {
+            return undefined;
+        }
+        const clamped = Math.min(1, Math.max(0, p));
+        const idx = Math.ceil(clamped * this.values.length) - 1;
+        return this.values[Math.max(0, idx)];
+    }
+    max() {
+        if (this.values.length === 0) {
+            return undefined;
+        }
+        return this.values[this.values.length - 1];
+    }
+}
+exports.QuantileStats = QuantileStats;
+function riskToPercentile(risk) {
+    if (typeof risk === 'number') {
+        return Math.min(1, Math.max(0, risk));
+    }
+    switch (risk) {
+        case 'very-low':
+            return 0.99;
+        case 'low':
+            return 0.95;
+        case 'medium':
+            return 0.85;
+        case 'high':
+            return 0.7;
+        default:
+            return 0.85;
+    }
+}
+//# sourceMappingURL=quantile-stats.js.map

package/dist-cjs/state/quantile-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quantile-stats.js","sourceRoot":"","sources":["../../src/state/quantile-stats.ts"],"names":[],"mappings":";;;AAmCA,4CAgBC;AAnDD;;GAEG;AACH,MAAa,aAAa;IACP,MAAM,GAAa,EAAE,CAAC;IAEvC,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACzC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,UAAU,CAAC,CAAS;QAClB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,GAAG;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;CACF;AA9BD,sCA8BC;AAED,SAAgB,gBAAgB,CAAC,IAAuE;IACtG,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,OAAO,IAAI,CAAC;QACd,KAAK,KAAK;YACR,OAAO,IAAI,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC;QACd,KAAK,MAAM;YACT,OAAO,GAAG,CAAC;QACb;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@x12i/optimixer",
+  "version": "0.1.0",
+  "description": "Prediction and learning layer for AI max-token optimization, integrated with Activix records",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist-cjs/index.js"
+    }
+  },
+  "scripts": {
+    "build": "node scripts/clean-spurious-dist.js && tsc && tsc -p tsconfig.cjs.json && node scripts/create-cjs-package.js",
+    "build:tests": "tsc -p .tests/tsconfig.json && node scripts/create-tests-package.js",
+    "test:all": "npm run build && npm run build:tests && node .tests-out/optimixer.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@x12i/activix-contracts": "^1.0.0"
+  },
+  "peerDependencies": {
+    "@x12i/activix": "^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@x12i/activix": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@x12i/activix": "^8.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "dist-cjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "optimixer",
+    "activix",
+    "max-tokens",
+    "prediction"
+  ],
+  "author": "x12i",
+  "license": "Athenix License",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/x12i/activix.git",
+    "directory": "packages/optimixer"
+  }
+}