@defai.digital/resilience-domain 13.0.3

package/dist/resource-enforcer.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Resource Enforcer Implementation
+ *
+ * Enforces limits on tokens, time, cost, and concurrency.
+ */
+import { type ResourceLimitsConfig, type ResourceUsage, type ResourceCheckResult, type ResourceRequestInfo } from './_contracts.js';
+/**
+ * Resource enforcer error
+ */
+export declare class ResourceEnforcerError extends Error {
+    readonly code: string;
+    readonly limit: string;
+    readonly current: number;
+    readonly max: number;
+    constructor(code: string, message: string, limit: string, current: number, max: number);
+    static fromCheckResult(result: ResourceCheckResult & {
+        allowed: false;
+    }): ResourceEnforcerError;
+}
+/**
+ * Resource enforcer interface
+ */
+export interface ResourceEnforcer {
+    /** Check if request is within limits */
+    checkLimits(sessionId: string, request?: ResourceRequestInfo): ResourceCheckResult;
+    /** Record resource usage after request */
+    recordUsage(sessionId: string, inputTokens: number, outputTokens: number, durationMs: number): void;
+    /** Start tracking concurrent request */
+    startRequest(sessionId: string): void;
+    /** End tracking concurrent request */
+    endRequest(sessionId: string): void;
+    /** Get current usage for session */
+    getUsage(sessionId: string): ResourceUsage;
+    /** Reset usage for session */
+    resetUsage(sessionId: string): void;
+    /** Get all active sessions */
+    getActiveSessions(): string[];
+}
+/**
+ * Creates a resource enforcer
+ */
+export declare function createResourceEnforcer(config?: Partial<ResourceLimitsConfig>): ResourceEnforcer;
+/**
+ * Creates a strict resource enforcer that throws on limit exceeded
+ */
+export declare function createStrictResourceEnforcer(config?: Partial<ResourceLimitsConfig>): ResourceEnforcer;
+//# sourceMappingURL=resource-enforcer.d.ts.map

package/dist/resource-enforcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-enforcer.d.ts","sourceRoot":"","sources":["../src/resource-enforcer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAKzB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,IAAI,EAAE,MAAM;aAEZ,KAAK,EAAE,MAAM;aACb,OAAO,EAAE,MAAM;aACf,GAAG,EAAE,MAAM;gBAJX,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM;IAM7B,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,mBAAmB,GAAG;QAAE,OAAO,EAAE,KAAK,CAAA;KAAE,GAC/C,qBAAqB;CAiBzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,CAAC;IAEnF,0CAA0C;IAC1C,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,IAAI,CAAC;IAER,wCAAwC;IACxC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC,sCAAsC;IACtC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC;IAE3C,8BAA8B;IAC9B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC,8BAA8B;IAC9B,iBAAiB,IAAI,MAAM,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,gBAAgB,CA2IlB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,gBAAgB,CAkBlB"}

package/dist/resource-enforcer.js

@@ -0,0 +1,156 @@
+/**
+ * Resource Enforcer Implementation
+ *
+ * Enforces limits on tokens, time, cost, and concurrency.
+ */
+import { ResourceLimitsErrorCodes, createDefaultResourceLimitsConfig, createResourceUsage, estimateCost, } from './_contracts.js';
+/**
+ * Resource enforcer error
+ */
+export class ResourceEnforcerError extends Error {
+    code;
+    limit;
+    current;
+    max;
+    constructor(code, message, limit, current, max) {
+        super(message);
+        this.code = code;
+        this.limit = limit;
+        this.current = current;
+        this.max = max;
+        this.name = 'ResourceEnforcerError';
+    }
+    static fromCheckResult(result) {
+        const codeMap = {
+            'tokens-per-request': ResourceLimitsErrorCodes.TOKENS_PER_REQUEST_EXCEEDED,
+            'tokens-per-session': ResourceLimitsErrorCodes.TOKENS_PER_SESSION_EXCEEDED,
+            'duration': ResourceLimitsErrorCodes.DURATION_EXCEEDED,
+            'cost': ResourceLimitsErrorCodes.COST_EXCEEDED,
+            'concurrency': ResourceLimitsErrorCodes.CONCURRENCY_EXCEEDED,
+        };
+        return new ResourceEnforcerError(codeMap[result.limitType] ?? 'RESOURCE_LIMIT_EXCEEDED', result.reason, result.limitType, result.current, result.max);
+    }
+}
+/**
+ * Creates a resource enforcer
+ */
+export function createResourceEnforcer(config) {
+    const cfg = { ...createDefaultResourceLimitsConfig(), ...config };
+    const usageBySession = new Map();
+    function getOrCreateUsage(sessionId) {
+        let usage = usageBySession.get(sessionId);
+        if (!usage) {
+            usage = createResourceUsage(sessionId);
+            usageBySession.set(sessionId, usage);
+        }
+        return usage;
+    }
+    return {
+        checkLimits(sessionId, request) {
+            const usage = getOrCreateUsage(sessionId);
+            // Check concurrency limit
+            if (request?.isConcurrent) {
+                if (usage.concurrentRequests >= cfg.maxConcurrentRequests) {
+                    return {
+                        allowed: false,
+                        reason: `Concurrent request limit exceeded`,
+                        limitType: 'concurrency',
+                        current: usage.concurrentRequests,
+                        max: cfg.maxConcurrentRequests,
+                    };
+                }
+            }
+            // Check tokens per request
+            const estimatedRequestTokens = (request?.estimatedInputTokens ?? 0) +
+                (request?.estimatedOutputTokens ?? 0);
+            if (estimatedRequestTokens > cfg.maxTokensPerRequest) {
+                return {
+                    allowed: false,
+                    reason: `Estimated tokens (${estimatedRequestTokens}) exceeds per-request limit`,
+                    limitType: 'tokens-per-request',
+                    current: estimatedRequestTokens,
+                    max: cfg.maxTokensPerRequest,
+                };
+            }
+            // Check tokens per session
+            const totalSessionTokens = usage.inputTokens + usage.outputTokens + estimatedRequestTokens;
+            if (totalSessionTokens > cfg.maxTokensPerSession) {
+                return {
+                    allowed: false,
+                    reason: `Session token limit would be exceeded`,
+                    limitType: 'tokens-per-session',
+                    current: usage.inputTokens + usage.outputTokens,
+                    max: cfg.maxTokensPerSession,
+                };
+            }
+            // Check cost limit
+            const estimatedNewCost = estimateCost(request?.estimatedInputTokens ?? 0, request?.estimatedOutputTokens ?? 0, cfg);
+            const projectedCost = usage.estimatedCost + estimatedNewCost;
+            if (projectedCost > cfg.maxCostPerSession) {
+                return {
+                    allowed: false,
+                    reason: `Session cost limit would be exceeded`,
+                    limitType: 'cost',
+                    current: usage.estimatedCost,
+                    max: cfg.maxCostPerSession,
+                };
+            }
+            // Check duration limit
+            const elapsed = Date.now() - new Date(usage.startedAt).getTime();
+            if (elapsed > cfg.maxDurationMs) {
+                return {
+                    allowed: false,
+                    reason: `Session duration limit exceeded`,
+                    limitType: 'duration',
+                    current: elapsed,
+                    max: cfg.maxDurationMs,
+                };
+            }
+            return { allowed: true };
+        },
+        recordUsage(sessionId, inputTokens, outputTokens, durationMs) {
+            const usage = getOrCreateUsage(sessionId);
+            usage.inputTokens += inputTokens;
+            usage.outputTokens += outputTokens;
+            usage.totalDurationMs += durationMs;
+            usage.requestCount++;
+            usage.estimatedCost = estimateCost(usage.inputTokens, usage.outputTokens, cfg);
+            usage.lastRequestAt = new Date().toISOString();
+        },
+        startRequest(sessionId) {
+            const usage = getOrCreateUsage(sessionId);
+            usage.concurrentRequests++;
+        },
+        endRequest(sessionId) {
+            const usage = usageBySession.get(sessionId);
+            if (usage && usage.concurrentRequests > 0) {
+                usage.concurrentRequests--;
+            }
+        },
+        getUsage(sessionId) {
+            return getOrCreateUsage(sessionId);
+        },
+        resetUsage(sessionId) {
+            usageBySession.delete(sessionId);
+        },
+        getActiveSessions() {
+            return Array.from(usageBySession.keys());
+        },
+    };
+}
+/**
+ * Creates a strict resource enforcer that throws on limit exceeded
+ */
+export function createStrictResourceEnforcer(config) {
+    const enforcer = createResourceEnforcer(config);
+    const originalCheck = enforcer.checkLimits.bind(enforcer);
+    enforcer.checkLimits = (sessionId, request) => {
+        const result = originalCheck(sessionId, request);
+        if (!result.allowed) {
+            throw ResourceEnforcerError.fromCheckResult(result);
+        }
+        return result;
+    };
+    return enforcer;
+}
+//# sourceMappingURL=resource-enforcer.js.map

package/dist/resource-enforcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-enforcer.js","sourceRoot":"","sources":["../src/resource-enforcer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAKL,wBAAwB,EACxB,iCAAiC,EACjC,mBAAmB,EACnB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAE5B;IAEA;IACA;IACA;IALlB,YACkB,IAAY,EAC5B,OAAe,EACC,KAAa,EACb,OAAe,EACf,GAAW;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAC;QANC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,UAAK,GAAL,KAAK,CAAQ;QACb,YAAO,GAAP,OAAO,CAAQ;QACf,QAAG,GAAH,GAAG,CAAQ;QAG3B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,eAAe,CACpB,MAAgD;QAEhD,MAAM,OAAO,GAA2B;YACtC,oBAAoB,EAAE,wBAAwB,CAAC,2BAA2B;YAC1E,oBAAoB,EAAE,wBAAwB,CAAC,2BAA2B;YAC1E,UAAU,EAAE,wBAAwB,CAAC,iBAAiB;YACtD,MAAM,EAAE,wBAAwB,CAAC,aAAa;YAC9C,aAAa,EAAE,wBAAwB,CAAC,oBAAoB;SAC7D,CAAC;QAEF,OAAO,IAAI,qBAAqB,CAC9B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,yBAAyB,EACtD,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,GAAG,CACX,CAAC;IACJ,CAAC;CACF;AAiCD;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAsC;IAEtC,MAAM,GAAG,GAAG,EAAE,GAAG,iCAAiC,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;IAClE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;IAExD,SAAS,gBAAgB,CAAC,SAAiB;QACzC,IAAI,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;YACvC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,WAAW,CACT,SAAiB,EACjB,OAA6B;YAE7B,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAE1C,0BAA0B;YAC1B,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;gBAC1B,IAAI,KAAK,CAAC,kBAAkB,IAAI,GAAG,CAAC,qBAAqB,EAAE,CAAC;oBAC1D,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,mCAAmC;wBAC3C,SAAS,EAAE,aAAa;wBACxB,OAAO,EAAE,KAAK,CAAC,kBAAkB;wBACjC,GAAG,EAAE,GAAG,CAAC,qBAAqB;qBAC/B,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,2BAA2B;YAC3B,MAAM,sBAAsB,GAC1B,CAAC,OAAO,EAAE,oBAAoB,IAAI,CAAC,CAAC;gBACpC,CAAC,OAAO,EAAE,qBAAqB,IAAI,CAAC,CAAC,CAAC;YAExC,IAAI,sBAAsB,GAAG,GAAG,CAAC,mBAAmB,EAAE,CAAC;gBACrD,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,qBAAqB,sBAAsB,6BAA6B;oBAChF,SAAS,EAAE,oBAAoB;oBAC/B,OAAO,EAAE,sBAAsB;oBAC/B,GAAG,EAAE,GAAG,CAAC,mBAAmB;iBAC7B,CAAC;YACJ,CAAC;YAED,2BAA2B;YAC3B,MAAM,kBAAkB,GACtB,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,YAAY,GAAG,sBAAsB,CAAC;YAElE,IAAI,kBAAkB,GAAG,GAAG,CAAC,mBAAmB,EAAE,CAAC;gBACjD,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,uCAAuC;oBAC/C,SAAS,EAAE,oBAAoB;oBAC/B,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,YAAY;oBAC/C,GAAG,EAAE,GAAG,CAAC,mBAAmB;iBAC7B,CAAC;YACJ,CAAC;YAED,mBAAmB;YACnB,MAAM,gBAAgB,GAAG,YAAY,CACnC,OAAO,EAAE,oBAAoB,IAAI,CAAC,EAClC,OAAO,EAAE,qBAAqB,IAAI,CAAC,EACnC,GAAG,CACJ,CAAC;YACF,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,GAAG,gBAAgB,CAAC;YAE7D,IAAI,aAAa,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;gBAC1C,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,sCAAsC;oBAC9C,SAAS,EAAE,MAAM;oBACjB,OAAO,EAAE,KAAK,CAAC,aAAa;oBAC5B,GAAG,EAAE,GAAG,CAAC,iBAAiB;iBAC3B,CAAC;YACJ,CAAC;YAED,uBAAuB;YACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;YACjE,IAAI,OAAO,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC;gBAChC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,iCAAiC;oBACzC,SAAS,EAAE,UAAU;oBACrB,OAAO,EAAE,OAAO;oBAChB,GAAG,EAAE,GAAG,CAAC,aAAa;iBACvB,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,WAAW,CACT,SAAiB,EACjB,WAAmB,EACnB,YAAoB,EACpB,UAAkB;YAElB,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAE1C,KAAK,CAAC,WAAW,IAAI,WAAW,CAAC;YACjC,KAAK,CAAC,YAAY,IAAI,YAAY,CAAC;YACnC,KAAK,CAAC,eAAe,IAAI,UAAU,CAAC;YACpC,KAAK,CAAC,YAAY,EAAE,CAAC;YACrB,KAAK,CAAC,aAAa,GAAG,YAAY,CAChC,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,YAAY,EAClB,GAAG,CACJ,CAAC;YACF,KAAK,CAAC,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACjD,CAAC;QAED,YAAY,CAAC,SAAiB;YAC5B,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAC1C,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC7B,CAAC;QAED,UAAU,CAAC,SAAiB;YAC1B,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC5C,IAAI,KAAK,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,EAAE,CAAC;gBAC1C,KAAK,CAAC,kBAAkB,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,SAAiB;YACxB,OAAO,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;QAED,UAAU,CAAC,SAAiB;YAC1B,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QAED,iBAAiB;YACf,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAAsC;IAEtC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE1D,QAAQ,CAAC,WAAW,GAAG,CACrB,SAAiB,EACjB,OAA6B,EACR,EAAE;QACvB,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,qBAAqB,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@defai.digital/resilience-domain",
+  "version": "13.0.3",
+  "type": "module",
+  "description": "Resilience patterns: circuit breaker, rate limiter, loop guard, resource limits, metrics",
+  "license": "Apache-2.0",
+  "author": "DEFAI Private Limited",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/defai-digital/automatosx.git",
+    "directory": "packages/core/resilience-domain"
+  },
+  "homepage": "https://github.com/defai-digital/automatosx#readme",
+  "bugs": {
+    "url": "https://github.com/defai-digital/automatosx/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@defai.digital/contracts": "13.0.3"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}