@adaptic/utils 0.0.989 → 0.0.991

package/dist/types/__tests__/atr.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atr.test.d.ts.map

package/dist/types/__tests__/atr.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atr.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/atr.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/types/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/risk-metrics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=risk-metrics.test.d.ts.map

package/dist/types/__tests__/risk-metrics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-metrics.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/risk-metrics.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/strategy-metrics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=strategy-metrics.test.d.ts.map

package/dist/types/__tests__/strategy-metrics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-metrics.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/strategy-metrics.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/volatility.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=volatility.test.d.ts.map

package/dist/types/__tests__/volatility.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volatility.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/volatility.test.ts"],"names":[],"mappings":""}

package/dist/types/atr.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Wilder ATR + EWMA-smoothed + multi-timespan variants.
+ *
+ * All functions are pure: same inputs → same output, no I/O, no time-dependence.
+ */
+export interface AtrBar {
+    high: number;
+    low: number;
+    close: number;
+    timespan?: "minute" | "hour" | "day";
+}
+/**
+ * Classic Wilder ATR (single value).
+ * @returns ATR for the most recent `period` bars, or null when insufficient bars.
+ */
+export declare function calculateATR(highs: number[], lows: number[], closes: number[], period: number): number | null;
+/**
+ * Returns the EWMA-smoothed ATR series (one ATR per bar, leading nulls until `period` bars).
+ */
+export declare function calculateATREMA(highs: number[], lows: number[], closes: number[], period: number): Array<number | null>;
+/**
+ * Wrapper that accepts AtrBar[] (timespan-tagged); identical math, the timespan tag is
+ * carried through for consumer-side logic only.
+ *
+ * @param bars - All bars must share the same timespan; the tag is metadata only
+ *               and is not validated. Mixed-timespan input produces a meaningless ATR.
+ * @param period - Wilder lookback period (positive integer).
+ */
+export declare function calculateATRMultiTimespan(bars: AtrBar[], period: number): number | null;
+//# sourceMappingURL=atr.d.ts.map

package/dist/types/atr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atr.d.ts","sourceRoot":"","sources":["../../src/atr.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAyBf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,MAAM,GACb,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CA6BtB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAOf"}

package/dist/types/index.d.ts

@@ -3,6 +3,7 @@ import { AlpacaMarketDataAPI } from "./alpaca-market-data-api";
 import { AlpacaTradingAPI } from "./alpaca-trading-api";
 import * as Alpaca from "./alpaca/legacy";
 import * as av from "./alphavantage";
+import * as atrNs from "./atr";
 import * as crypto from "./crypto";
 import * as ft from "./format-tools";
 import * as mt from "./market-time";
@@ -12,9 +13,12 @@ import * as misc from "./misc-utils";
 import * as pm from "./performance-metrics";
 import * as pu from "./price-utils";
 import { TokenBucketRateLimiter } from "./rate-limiter";
+import * as riskNs from "./risk-metrics";
+import * as strategyNs from "./strategy-metrics";
 import * as ta from "./technical-analysis";
 import * as tu from "./time-utils";
 import * as Types from "./types";
+import * as volatilityNs from "./volatility";
 export { getLogger, resetLogger, setLogger, type Logger } from "./logger";
 export { AdapticUtilsError, AlpacaApiError, AlphaVantageError, AuthenticationError, DataFormatError, HttpClientError, HttpServerError, MassiveApiError, NetworkError, RateLimitError, TimeoutError, ValidationError, WebSocketError, } from "./errors";
 export { validateAlpacaCredentials, validateAlphaVantageApiKey, validateMassiveApiKey, } from "./utils/auth-validator";
@@ -22,6 +26,7 @@ export { MARKET_DATA_API, TRADING_API, WEBSOCKET_STREAMS, getCryptoStreamUrl, ge
 export { DEFAULT_CACHE_OPTIONS, StampedeProtectedCache, createStampedeProtectedCache, type CacheEntry, type CacheLoader, type CacheStats, type StampedeProtectedCacheOptions, } from "./cache/stampede-protected-cache";
 export { TokenBucketRateLimiter, rateLimiters, type RateLimiterConfig, } from "./rate-limiter";
 export { API_RETRY_CONFIGS, isTransientNetworkError, withRetry, type RetryConfig, } from "./utils/retry";
+export { CircuitOpenError } from "./misc-utils";
 export { DEFAULT_TIMEOUTS, createTimeoutSignal, getTimeout, withTimeout, } from "./http-timeout";
 export { AssetAllocationEngine, generateOptimalAllocation, getDefaultRiskProfile, } from "./asset-allocation-algorithm";
 export * from "./types/asset-allocation-types";
@@ -36,12 +41,20 @@ export declare const createAlpacaTradingAPI: (credentials: Types.AlpacaCredentia
 export declare const createAlpacaMarketDataAPI: () => AlpacaMarketDataAPI;
 export * from "./alpaca";
 export * as tradingPolicy from "./trading-policy";
+export * as atr from "./atr";
+export * as volatility from "./volatility";
+export * as risk from "./risk-metrics";
+export * as strategy from "./strategy-metrics";
 export { AutonomyMode, OverlayType, OverlaySeverity, OverlayStatus, DecisionOutcome, DecisionRecordStatus, DecisionMemoryOutcome, LlmProvider, } from "./trading-policy/enums";
 export type { AutonomyPrefs, AssetUniversePrefs, RiskBudgetPrefs, SignalConsumptionPrefs, ExecutionPrefs, PositionManagementPrefs, PortfolioConstructionPrefs, OverlayResponsePrefs, ModelPrefs, AuditNotificationPrefs, PolicyMutation, EffectiveTradingPolicy, } from "./trading-policy/schemas";
 export { DEFAULT_TRADING_POLICY } from "./trading-policy/defaults/default-trading-policy";
 export type { TokenProvider } from "./adaptic";
 export declare const adaptic: {
     types: typeof Types;
+    atr: typeof atrNs;
+    risk: typeof riskNs;
+    strategy: typeof strategyNs;
+    volatility: typeof volatilityNs;
     backend: {
         fetchAssetOverview: (symbol: string) => Promise<Types.AssetOverviewResponse>;
         getApolloClient: () => Promise<import("@apollo/client").ApolloClient<import("@apollo/client").NormalizedCacheObject>>;
@@ -348,7 +361,7 @@ export declare const adaptic: {
             apiKey?: string;
         }) => Promise<Types.MassiveIndicesSnapshotResponse>;
         fetchUniversalSnapshot: (tickers: string[], options?: {
-            apiKey? /** @description Real-time WebSocket streams */: string;
+            apiKey?: string;
             type?: string;
             order?: string;
             limit?: number;
@@ -412,6 +425,17 @@ export declare const adaptic: {
         logIfDebug: (message: string, data?: unknown, type?: "error" | "info" | "warn" | "debug" | "trace") => void;
         fetchWithRetry: typeof misc.fetchWithRetry;
         validateMassiveApiKey: typeof misc.validateMassiveApiKey;
+        /**
+         * Force-close a stuck-open per-host circuit breaker. Operator
+         * runbook utility — see {@link misc.resetCircuitBreaker}.
+         */
+        resetCircuitBreaker: typeof misc.resetCircuitBreaker;
+        /**
+         * Read-only snapshot of all per-host circuit-breaker states for
+         * use in operational-truth endpoints. See
+         * {@link misc.getCircuitBreakerSnapshot}.
+         */
+        getCircuitBreakerSnapshot: typeof misc.getCircuitBreakerSnapshot;
     };
     rateLimiter: {
         TokenBucketRateLimiter: typeof TokenBucketRateLimiter;
@@ -424,6 +448,10 @@ export declare const adaptic: {
 };
 export declare const adptc: {
     types: typeof Types;
+    atr: typeof atrNs;
+    risk: typeof riskNs;
+    strategy: typeof strategyNs;
+    volatility: typeof volatilityNs;
     backend: {
         fetchAssetOverview: (symbol: string) => Promise<Types.AssetOverviewResponse>;
         getApolloClient: () => Promise<import("@apollo/client").ApolloClient<import("@apollo/client").NormalizedCacheObject>>;
@@ -730,7 +758,7 @@ export declare const adptc: {
             apiKey?: string;
         }) => Promise<Types.MassiveIndicesSnapshotResponse>;
         fetchUniversalSnapshot: (tickers: string[], options?: {
-            apiKey? /** @description Real-time WebSocket streams */: string;
+            apiKey?: string;
             type?: string;
             order?: string;
             limit?: number;
@@ -794,6 +822,17 @@ export declare const adptc: {
         logIfDebug: (message: string, data?: unknown, type?: "error" | "info" | "warn" | "debug" | "trace") => void;
         fetchWithRetry: typeof misc.fetchWithRetry;
         validateMassiveApiKey: typeof misc.validateMassiveApiKey;
+        /**
+         * Force-close a stuck-open per-host circuit breaker. Operator
+         * runbook utility — see {@link misc.resetCircuitBreaker}.
+         */
+        resetCircuitBreaker: typeof misc.resetCircuitBreaker;
+        /**
+         * Read-only snapshot of all per-host circuit-breaker states for
+         * use in operational-truth endpoints. See
+         * {@link misc.getCircuitBreakerSnapshot}.
+         */
+        getCircuitBreakerSnapshot: typeof misc.getCircuitBreakerSnapshot;
     };
     rateLimiter: {
         TokenBucketRateLimiter: typeof TokenBucketRateLimiter;

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,OAAO,iBAAiB,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAgB,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,UAAU,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,YAAY,MAAM,cAAc,CAAC;AAM7C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAG1E,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,cAAc,GACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,6BAA6B,GACnC,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,SAAS,EACT,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC,cAAc,gCAAgC,CAAC;AAG/C,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EAEpB,0BAA0B,EAC1B,eAAe,EACf,8BAA8B,EAC9B,kCAAkC,EAClC,8BAA8B,EAC9B,gCAAgC,EAChC,gCAAgC,EAChC,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,oCAAoC,EACpC,oBAAoB,EACpB,0BAA0B,EAC1B,iBAAiB,EACjB,iBAAiB,EAEjB,+BAA+B,EAC/B,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,EAC1B,iCAAiC,EACjC,8BAA8B,EAC9B,kCAAkC,EAClC,uBAAuB,EACvB,kBAAkB,IAAI,qBAAqB,EAC3C,2BAA2B,EAE3B,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,6BAA6B,EAC7B,yBAAyB,EACzB,uCAAuC,EACvC,eAAe,EACf,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,eAAO,MAAM,sBAAsB,GACjC,aAAa,KAAK,CAAC,iBAAiB,qBAGrC,CAAC;AAEF,eAAO,MAAM,yBAAyB,2BAErC,CAAC;AAGF,cAAc,UAAU,CAAC;AAGzB,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,QAAQ,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,UAAU,EACV,sBAAsB,EACtB,cAAc,EACd,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAG1F,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;QAoBhB,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAgK3C,CAAC;;;;;;;;;;;;;;;;;4BA/IrB,CAAC;0BACJ,CAAH;;;;;;;;;;;QAhBC,iFAAiF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEjF,2EAA2E;;QAE3E,6FAA6F;;QAE7F,yFAAyF;;QAIzF,4EAA4E;;;;;;;;;;QAU5E,sEAAsE;;;;;;;;QAQtE,sEAAsE;;QAEtE,mDAAmD;;QAEnD,iDAAiD;;QAEjD,8BAA8B;;QAE9B,+BAA+B;;QAE/B,4CAA4C;;;;;;;QAE5C,mDAAmD;;;;;QAEnD,+CAA+C;;QAI/C,+CAA+C;;;;;;;;QAQ/C,wCAAwC;;QAExC,+DAA+D;;QAE/D,mEAAmE;;QAEnE,sEAAsE;;QAEtE,kDAAkD;;;;QAIlD,4CAA4C;;;;;;;kBA5RnC,CAAC;;;iBA0HC,CAAC;eAAe,CAAC;iBAElB,CAAC;kBAAoB,CAAC;gBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkBvD,CAAA;;;kBAyQujW,CAAC;oBAAsB,CAAC;sBAAyB,CAAC;;;kBA9J5lW,CAAC;;;kBA4Ga,CAAC;;;kBAkDmokB,CAAC;qBAAuB,CAAC;uBAAkC,CAAC;wBAAmC,CAAC;uBAAkC,CAAC;wBAAmC,CAAC;iBAA4B,CAAC;iBAA2B,CAAC;gBAAkB,CAAC;;;;;eAAp/gB,CAAC;;;iBAAiE,CAAC;oBAAsB,CAAC;;kBAAoC,CAAC;;;;;eAA48L,CAAC;;;iBAAiE,CAAC;oBAAsB,CAAC;;kBAAoC,CAAC;;;;;kBAAk0N,CAAC;oBAAsB,CAAC;;;;;;kBA1Yt7d,CAAC;;;kBAwEU,CAAC;;;kBA0DO,CAAC;;;kBAuD7B,CAAC;;;kBA8CuB,CAAC;gBAAkB,CAAC;iBAC3C,CAAC;iBACY,CAAC;gBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8IjC;;;WAGG;;QAEH;;;;WAIG;;;;;;;;;;;CAON,CAAC;AAEF,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;QA9Ld,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAgK3C,CAAC;;;;;;;;;;;;;;;;;4BA/IrB,CAAC;0BACJ,CAAH;;;;;;;;;;;QAhBC,iFAAiF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEjF,2EAA2E;;QAE3E,6FAA6F;;QAE7F,yFAAyF;;QAIzF,4EAA4E;;;;;;;;;;QAU5E,sEAAsE;;;;;;;;QAQtE,sEAAsE;;QAEtE,mDAAmD;;QAEnD,iDAAiD;;QAEjD,8BAA8B;;QAE9B,+BAA+B;;QAE/B,4CAA4C;;;;;;;QAE5C,mDAAmD;;;;;QAEnD,+CAA+C;;QAI/C,+CAA+C;;;;;;;;QAQ/C,wCAAwC;;QAExC,+DAA+D;;QAE/D,mEAAmE;;QAEnE,sEAAsE;;QAEtE,kDAAkD;;;;QAIlD,4CAA4C;;;;;;;kBA5RnC,CAAC;;;iBA0HC,CAAC;eAAe,CAAC;iBAElB,CAAC;kBAAoB,CAAC;gBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkBvD,CAAA;;;kBAyQujW,CAAC;oBAAsB,CAAC;sBAAyB,CAAC;;;kBA9J5lW,CAAC;;;kBA4Ga,CAAC;;;kBAkDmokB,CAAC;qBAAuB,CAAC;uBAAkC,CAAC;wBAAmC,CAAC;uBAAkC,CAAC;wBAAmC,CAAC;iBAA4B,CAAC;iBAA2B,CAAC;gBAAkB,CAAC;;;;;eAAp/gB,CAAC;;;iBAAiE,CAAC;oBAAsB,CAAC;;kBAAoC,CAAC;;;;;eAA48L,CAAC;;;iBAAiE,CAAC;oBAAsB,CAAC;;kBAAoC,CAAC;;;;;kBAAk0N,CAAC;oBAAsB,CAAC;;;;;;kBA1Yt7d,CAAC;;;kBAwEU,CAAC;;;kBA0DO,CAAC;;;kBAuD7B,CAAC;;;kBA8CuB,CAAC;gBAAkB,CAAC;iBAC3C,CAAC;iBACY,CAAC;gBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8IjC;;;WAGG;;QAEH;;;;WAIG;;;;;;;;;;;CASqB,CAAC"}

package/dist/types/misc-utils.d.ts

@@ -1,3 +1,40 @@
+/**
+ * Error thrown by {@link fetchWithRetry} when the per-host circuit
+ * breaker is open and fail-fast suppression is in effect.
+ *
+ * Carries the host, the failure ratio that tripped the breaker, and
+ * the remaining cooldown so callers can render an actionable log.
+ */
+export declare class CircuitOpenError extends Error {
+    readonly code = "MASSIVE_CIRCUIT_OPEN";
+    readonly host: string;
+    readonly tripFailureRatio: number;
+    readonly cooldownRemainingMs: number;
+    constructor(host: string, tripFailureRatio: number, cooldownRemainingMs: number);
+}
+/**
+ * Force-close the breaker for a given host. Exposed for tests and
+ * operator-runbook scripts so a stuck-open breaker can be reset
+ * without bouncing the process. Not intended for hot-path use.
+ *
+ * @param host The hostname whose breaker should be reset.
+ */
+export declare function resetCircuitBreaker(host: string): void;
+/**
+ * Snapshot of all known per-host circuit-breaker states. Intended for
+ * an operational-truth / status endpoint to surface upstream health.
+ *
+ * @returns Map of host → {open, openedAt, recentSamples, failureRatio,
+ *          lastTripFailureRatio}.
+ */
+export declare function getCircuitBreakerSnapshot(): Record<string, {
+    open: boolean;
+    openedAt: number;
+    cooldownRemainingMs: number;
+    recentSamples: number;
+    failureRatio: number;
+    lastTripFailureRatio: number;
+}>;
 declare const _LOG_TYPES: readonly ["info", "warn", "error", "debug", "trace"];
 type LogType = (typeof _LOG_TYPES)[number];
 /**

package/dist/types/misc-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"misc-utils.d.ts","sourceRoot":"","sources":["../../src/misc-utils.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,UAAU,sDAAuD,CAAC;AAExE,KAAK,OAAO,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU,GACrB,SAAS,MAAM,EACf,OAAO,OAAO,EACd,OAAM,OAAgB,SAmCvB,CAAC;AAqBF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBrD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,EACzB,OAAO,GAAE,MAAU,EACnB,cAAc,GAAE,MAAa,GAC5B,OAAO,CAAC,QAAQ,CAAC,CAoDnB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB5E"}
+{"version":3,"file":"misc-utils.d.ts","sourceRoot":"","sources":["../../src/misc-utils.ts"],"names":[],"mappings":"AAkMA;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;gBAGnC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EACxB,mBAAmB,EAAE,MAAM;CAU9B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMtD;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CACjD,MAAM,EACN;IACE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CACF,CAuBA;AAeD,QAAA,MAAM,UAAU,sDAAuD,CAAC;AAExE,KAAK,OAAO,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU,GACrB,SAAS,MAAM,EACf,OAAO,OAAO,EACd,OAAM,OAAgB,SAmCvB,CAAC;AAqBF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBrD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,EACzB,OAAO,GAAE,MAAU,EACnB,cAAc,GAAE,MAAa,GAC5B,OAAO,CAAC,QAAQ,CAAC,CAoGnB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB5E"}

package/dist/types/risk-metrics.d.ts

@@ -0,0 +1,58 @@
+/**
+ * VaR, Expected Shortfall (CVaR), conditional drawdown, rolling drawdown, Sortino, Calmar.
+ *
+ * Convention: VaR and ES are returned as the actual quantile value (typically negative
+ * for losses). Drawdowns from `calculateConditionalDrawdown` are returned as non-negative
+ * magnitudes (e.g., 0.05 = 5% drawdown). Drawdowns from `calculateRollingDrawdown` are
+ * non-positive (e.g., -0.05 = 5% below rolling peak, 0 = at or above peak).
+ *
+ * All public functions reject non-finite inputs (NaN, Infinity) by throwing. Callers
+ * must pre-validate or filter their inputs.
+ */
+/**
+ * Historical-bootstrap VaR at confidence `alpha`.
+ * E.g., alpha=0.95 returns the 5%-quantile of returns (the loss at the 5th percentile).
+ *
+ * @returns The quantile value (typically negative), or null on empty input.
+ */
+export declare function calculateVaRHistorical(returns: number[], alpha: number): number | null;
+/**
+ * Gaussian parametric VaR: μ + zα·σ where zα is the (1-alpha) standard-normal quantile.
+ *
+ * @returns The Gaussian quantile, or null when fewer than 2 samples.
+ */
+export declare function calculateVaRParametric(returns: number[], alpha: number): number | null;
+/**
+ * Expected Shortfall (Conditional VaR): average of returns below the (1-alpha) quantile.
+ *
+ * @returns The mean tail return (typically negative), or null on empty input.
+ */
+export declare function calculateExpectedShortfall(returns: number[], alpha: number): number | null;
+/**
+ * Conditional Drawdown at Risk (CDaR): average of drawdowns in the worst (1-alpha) tail.
+ * Drawdowns are computed as (peak - equity) / peak so they are non-negative.
+ *
+ * @returns A non-negative magnitude (0 = no drawdowns), or null for fewer than 2 samples.
+ */
+export declare function calculateConditionalDrawdown(equity: number[], alpha: number): number | null;
+/**
+ * Rolling-window drawdown series: for each index, drawdown = (current - rollingPeak) / rollingPeak.
+ * Non-positive values; 0 when at or above the rolling peak. Window measured in samples.
+ *
+ * @returns An array the same length as `equity`.
+ */
+export declare function calculateRollingDrawdown(equity: number[], windowSize: number): number[];
+/**
+ * Sortino ratio: (mean excess return) / downside deviation.
+ * Returns +Infinity when there are no downside returns.
+ * Returns null when fewer than 2 samples.
+ */
+export declare function calculateSortino(returns: number[], riskFreeRate: number): number | null;
+/**
+ * Calmar ratio: CAGR / |max drawdown|.
+ *
+ * @returns null when there is no drawdown (division by zero), fewer than 2 samples,
+ *          or `equity[0] <= 0` (CAGR undefined).
+ */
+export declare function calculateCalmar(equity: number[], periodsPerYear: number): number | null;
+//# sourceMappingURL=risk-metrics.d.ts.map

package/dist/types/risk-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-metrics.d.ts","sourceRoot":"","sources":["../../src/risk-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAOf;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAUf;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAQf;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAef;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EAAE,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAWV;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,IAAI,CASf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBvF"}

package/dist/types/strategy-metrics.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Per-strategy rolling metrics and backtest-divergence z-score.
+ *
+ * Conventions:
+ * - tradePnls / tradeReturns is an array of per-trade realised P&L or return
+ *   (positive = win, negative = loss, zero = breakeven).
+ * - All "rolling*" functions return null when fewer than `windowSize` trades exist.
+ * - All public functions reject non-finite inputs (NaN, Infinity) by throwing.
+ *   Callers must pre-validate or filter their inputs.
+ */
+/**
+ * Rolling expectancy: mean P&L over the most-recent `windowSize` trades.
+ *
+ * @param tradePnls - Array of per-trade realised P&L values.
+ * @param windowSize - Number of most-recent trades to include. Must be a positive integer.
+ * @returns Mean P&L of the last `windowSize` trades, or null when fewer than `windowSize` exist.
+ * @throws When `windowSize` is not a positive integer or any input is non-finite.
+ */
+export declare function calculateRollingExpectancy(tradePnls: number[], windowSize: number): number | null;
+/**
+ * Rolling hit-rate: fraction of strictly-positive P&L trades in the most-recent
+ * `windowSize` trades. Zero P&L counts as non-win.
+ *
+ * @param tradePnls - Array of per-trade realised P&L values.
+ * @param windowSize - Number of most-recent trades to include. Must be a positive integer.
+ * @returns Fraction of winning trades in the window, or null when fewer than `windowSize` exist.
+ * @throws When `windowSize` is not a positive integer or any input is non-finite.
+ */
+export declare function calculateRollingHitRate(tradePnls: number[], windowSize: number): number | null;
+/**
+ * Rolling profit factor: sum(wins) / |sum(losses)| over the most-recent `windowSize` trades.
+ *
+ * Edge cases:
+ * - no losses and at least one win → +Infinity
+ * - no wins and no losses (all zeros) → 0
+ * - fewer than windowSize trades → null
+ *
+ * @param tradePnls - Array of per-trade realised P&L values.
+ * @param windowSize - Number of most-recent trades to include. Must be a positive integer.
+ * @returns Profit factor for the rolling window, or null when fewer than `windowSize` exist.
+ * @throws When `windowSize` is not a positive integer or any input is non-finite.
+ */
+export declare function calculateRollingProfitFactor(tradePnls: number[], windowSize: number): number | null;
+/**
+ * Rolling Sortino: delegate to `calculateSortino` over the most-recent `windowSize` returns.
+ *
+ * @param tradeReturns - Array of per-trade return values.
+ * @param windowSize - Number of most-recent trades to include. Must be a positive integer.
+ * @param riskFreeRate - Risk-free rate to subtract from returns (default 0).
+ * @returns Sortino ratio for the rolling window, or null when fewer than `windowSize` exist.
+ * @throws When `windowSize` is not a positive integer or any input is non-finite.
+ */
+export declare function calculateRollingSortino(tradeReturns: number[], windowSize: number, riskFreeRate?: number): number | null;
+/**
+ * Z-score of live-expectancy vs backtest-expectancy, scaled by the backtest stddev.
+ * Positive Z = live outperforming; negative Z = live underperforming.
+ *
+ * @param liveExpectancy - Mean P&L per trade in the live window.
+ * @param backtestExpectancy - Mean P&L per trade from the calibration backtest.
+ * @param backtestStddev - Stddev of per-trade P&L in the backtest. Must be > 0.
+ * @returns Z-score measuring divergence between live and backtest performance.
+ * @throws When any input is non-finite or `backtestStddev` is not positive.
+ */
+export declare function calculateBacktestDivergenceZ(liveExpectancy: number, backtestExpectancy: number, backtestStddev: number): number;
+//# sourceMappingURL=strategy-metrics.d.ts.map

package/dist/types/strategy-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-metrics.d.ts","sourceRoot":"","sources":["../../src/strategy-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAMf;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAOf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CASf;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,YAAY,SAAI,GACf,MAAM,GAAG,IAAI,CAKf;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,EAC1B,cAAc,EAAE,MAAM,GACrB,MAAM,CAQR"}

package/dist/types/trading-policy/schemas/effective-policy.schema.d.ts

@@ -529,7 +529,7 @@ export declare const EffectiveTradingPolicySchema: z.ZodObject<{
         partialFillPolicy: "accept_partial" | "cancel_remainder" | "replace_to_fill";
         sizingMethod: "notional" | "quantity";
         lotRoundingBehavior: "round_down" | "round_nearest" | "round_up";
-        afterHoursExecutionBehavior: "limit_only" | "no_execution" | "normal";
+        afterHoursExecutionBehavior: "normal" | "limit_only" | "no_execution";
         failureBehavior: "fail_safe" | "fail_open";
     }, {
         allowedOrderTypes?: ("limit" | "market" | "stop" | "stop_limit" | "trailing_stop")[] | undefined;
@@ -547,7 +547,7 @@ export declare const EffectiveTradingPolicySchema: z.ZodObject<{
         partialFillPolicy?: "accept_partial" | "cancel_remainder" | "replace_to_fill" | undefined;
         sizingMethod?: "notional" | "quantity" | undefined;
         lotRoundingBehavior?: "round_down" | "round_nearest" | "round_up" | undefined;
-        afterHoursExecutionBehavior?: "limit_only" | "no_execution" | "normal" | undefined;
+        afterHoursExecutionBehavior?: "normal" | "limit_only" | "no_execution" | undefined;
         failureBehavior?: "fail_safe" | "fail_open" | undefined;
     }>>;
     positionManagementPrefs: z.ZodDefault<z.ZodObject<{
@@ -1216,7 +1216,7 @@ export declare const EffectiveTradingPolicySchema: z.ZodObject<{
         partialFillPolicy: "accept_partial" | "cancel_remainder" | "replace_to_fill";
         sizingMethod: "notional" | "quantity";
         lotRoundingBehavior: "round_down" | "round_nearest" | "round_up";
-        afterHoursExecutionBehavior: "limit_only" | "no_execution" | "normal";
+        afterHoursExecutionBehavior: "normal" | "limit_only" | "no_execution";
         failureBehavior: "fail_safe" | "fail_open";
     };
     positionManagementPrefs: {
@@ -1553,7 +1553,7 @@ export declare const EffectiveTradingPolicySchema: z.ZodObject<{
         partialFillPolicy?: "accept_partial" | "cancel_remainder" | "replace_to_fill" | undefined;
         sizingMethod?: "notional" | "quantity" | undefined;
         lotRoundingBehavior?: "round_down" | "round_nearest" | "round_up" | undefined;
-        afterHoursExecutionBehavior?: "limit_only" | "no_execution" | "normal" | undefined;
+        afterHoursExecutionBehavior?: "normal" | "limit_only" | "no_execution" | undefined;
         failureBehavior?: "fail_safe" | "fail_open" | undefined;
     } | undefined;
     positionManagementPrefs?: {

package/dist/types/trading-policy/schemas/execution-prefs.schema.d.ts

@@ -41,7 +41,7 @@ export declare const ExecutionPrefsObjectSchema: z.ZodObject<{
     partialFillPolicy: "accept_partial" | "cancel_remainder" | "replace_to_fill";
     sizingMethod: "notional" | "quantity";
     lotRoundingBehavior: "round_down" | "round_nearest" | "round_up";
-    afterHoursExecutionBehavior: "limit_only" | "no_execution" | "normal";
+    afterHoursExecutionBehavior: "normal" | "limit_only" | "no_execution";
     failureBehavior: "fail_safe" | "fail_open";
 }, {
     allowedOrderTypes?: ("limit" | "market" | "stop" | "stop_limit" | "trailing_stop")[] | undefined;
@@ -59,7 +59,7 @@ export declare const ExecutionPrefsObjectSchema: z.ZodObject<{
     partialFillPolicy?: "accept_partial" | "cancel_remainder" | "replace_to_fill" | undefined;
     sizingMethod?: "notional" | "quantity" | undefined;
     lotRoundingBehavior?: "round_down" | "round_nearest" | "round_up" | undefined;
-    afterHoursExecutionBehavior?: "limit_only" | "no_execution" | "normal" | undefined;
+    afterHoursExecutionBehavior?: "normal" | "limit_only" | "no_execution" | undefined;
     failureBehavior?: "fail_safe" | "fail_open" | undefined;
 }>;
 export declare const ExecutionPrefsSchema: z.ZodDefault<z.ZodObject<{
@@ -96,7 +96,7 @@ export declare const ExecutionPrefsSchema: z.ZodDefault<z.ZodObject<{
     partialFillPolicy: "accept_partial" | "cancel_remainder" | "replace_to_fill";
     sizingMethod: "notional" | "quantity";
     lotRoundingBehavior: "round_down" | "round_nearest" | "round_up";
-    afterHoursExecutionBehavior: "limit_only" | "no_execution" | "normal";
+    afterHoursExecutionBehavior: "normal" | "limit_only" | "no_execution";
     failureBehavior: "fail_safe" | "fail_open";
 }, {
     allowedOrderTypes?: ("limit" | "market" | "stop" | "stop_limit" | "trailing_stop")[] | undefined;
@@ -114,7 +114,7 @@ export declare const ExecutionPrefsSchema: z.ZodDefault<z.ZodObject<{
     partialFillPolicy?: "accept_partial" | "cancel_remainder" | "replace_to_fill" | undefined;
     sizingMethod?: "notional" | "quantity" | undefined;
     lotRoundingBehavior?: "round_down" | "round_nearest" | "round_up" | undefined;
-    afterHoursExecutionBehavior?: "limit_only" | "no_execution" | "normal" | undefined;
+    afterHoursExecutionBehavior?: "normal" | "limit_only" | "no_execution" | undefined;
     failureBehavior?: "fail_safe" | "fail_open" | undefined;
 }>>;
 /** Inferred TypeScript type for execution preferences. */

package/dist/types/trading-policy/schemas/policy-mutation.schema.d.ts

@@ -497,7 +497,7 @@ export declare const PolicyMutationSchema: z.ZodObject<{
         partialFillPolicy?: "accept_partial" | "cancel_remainder" | "replace_to_fill" | undefined;
         sizingMethod?: "notional" | "quantity" | undefined;
         lotRoundingBehavior?: "round_down" | "round_nearest" | "round_up" | undefined;
-        afterHoursExecutionBehavior?: "limit_only" | "no_execution" | "normal" | undefined;
+        afterHoursExecutionBehavior?: "normal" | "limit_only" | "no_execution" | undefined;
         failureBehavior?: "fail_safe" | "fail_open" | undefined;
     }, {
         allowedOrderTypes?: ("limit" | "market" | "stop" | "stop_limit" | "trailing_stop")[] | undefined;
@@ -515,7 +515,7 @@ export declare const PolicyMutationSchema: z.ZodObject<{
         partialFillPolicy?: "accept_partial" | "cancel_remainder" | "replace_to_fill" | undefined;
         sizingMethod?: "notional" | "quantity" | undefined;
         lotRoundingBehavior?: "round_down" | "round_nearest" | "round_up" | undefined;
-        afterHoursExecutionBehavior?: "limit_only" | "no_execution" | "normal" | undefined;
+        afterHoursExecutionBehavior?: "normal" | "limit_only" | "no_execution" | undefined;
         failureBehavior?: "fail_safe" | "fail_open" | undefined;
     }>>;
     positionManagementPrefs: z.ZodOptional<z.ZodObject<{
@@ -1503,7 +1503,7 @@ export declare const PolicyMutationSchema: z.ZodObject<{
         partialFillPolicy?: "accept_partial" | "cancel_remainder" | "replace_to_fill" | undefined;
         sizingMethod?: "notional" | "quantity" | undefined;
         lotRoundingBehavior?: "round_down" | "round_nearest" | "round_up" | undefined;
-        afterHoursExecutionBehavior?: "limit_only" | "no_execution" | "normal" | undefined;
+        afterHoursExecutionBehavior?: "normal" | "limit_only" | "no_execution" | undefined;
         failureBehavior?: "fail_safe" | "fail_open" | undefined;
     }, {
         allowedOrderTypes?: ("limit" | "market" | "stop" | "stop_limit" | "trailing_stop")[] | undefined;
@@ -1521,7 +1521,7 @@ export declare const PolicyMutationSchema: z.ZodObject<{
         partialFillPolicy?: "accept_partial" | "cancel_remainder" | "replace_to_fill" | undefined;
         sizingMethod?: "notional" | "quantity" | undefined;
         lotRoundingBehavior?: "round_down" | "round_nearest" | "round_up" | undefined;
-        afterHoursExecutionBehavior?: "limit_only" | "no_execution" | "normal" | undefined;
+        afterHoursExecutionBehavior?: "normal" | "limit_only" | "no_execution" | undefined;
         failureBehavior?: "fail_safe" | "fail_open" | undefined;
     }>>;
     positionManagementPrefs: z.ZodOptional<z.ZodObject<{
@@ -2509,7 +2509,7 @@ export declare const PolicyMutationSchema: z.ZodObject<{
         partialFillPolicy?: "accept_partial" | "cancel_remainder" | "replace_to_fill" | undefined;
         sizingMethod?: "notional" | "quantity" | undefined;
         lotRoundingBehavior?: "round_down" | "round_nearest" | "round_up" | undefined;
-        afterHoursExecutionBehavior?: "limit_only" | "no_execution" | "normal" | undefined;
+        afterHoursExecutionBehavior?: "normal" | "limit_only" | "no_execution" | undefined;
         failureBehavior?: "fail_safe" | "fail_open" | undefined;
     }, {
         allowedOrderTypes?: ("limit" | "market" | "stop" | "stop_limit" | "trailing_stop")[] | undefined;
@@ -2527,7 +2527,7 @@ export declare const PolicyMutationSchema: z.ZodObject<{
         partialFillPolicy?: "accept_partial" | "cancel_remainder" | "replace_to_fill" | undefined;
         sizingMethod?: "notional" | "quantity" | undefined;
         lotRoundingBehavior?: "round_down" | "round_nearest" | "round_up" | undefined;
-        afterHoursExecutionBehavior?: "limit_only" | "no_execution" | "normal" | undefined;
+        afterHoursExecutionBehavior?: "normal" | "limit_only" | "no_execution" | undefined;
         failureBehavior?: "fail_safe" | "fail_open" | undefined;
     }>>;
     positionManagementPrefs: z.ZodOptional<z.ZodObject<{

package/dist/types/volatility.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Realized and EWMA volatility + regime classifier + annualisation helper.
+ * All functions pure.
+ */
+/**
+ * Volatility regime categorisation: calm (quiet markets), normal (regular trading),
+ * elevated (above-average volatility), crisis (panic/stress regime).
+ */
+export type VolatilityRegime = "calm" | "normal" | "elevated" | "crisis";
+/**
+ * Threshold bands for classifying a volatility value into a {@link VolatilityRegime}.
+ *
+ * Invariant: `calmMax < elevatedMax < crisisMin` (enforced at runtime by
+ * {@link detectVolatilityRegime}).
+ */
+export interface RegimeBands {
+    /** Volatility at or below this is "calm". */
+    calmMax: number;
+    /** Volatility at or above this (but below crisisMin) is "elevated". */
+    elevatedMax: number;
+    /** Volatility at or above this is "crisis". */
+    crisisMin: number;
+}
+/**
+ * Sample standard deviation (Bessel-corrected) of returns over the most recent
+ * `window` samples.
+ * @returns null when fewer than `window` samples.
+ */
+export declare function calculateRealizedVolatility(returns: number[], window: number): number | null;
+/**
+ * EWMA volatility (RiskMetrics-style). λ ∈ (0,1); higher = longer memory.
+ * Default usage: λ = 0.94 for daily returns.
+ *
+ * For a single-element input, the function returns `|returns[0]|` (the seed)
+ * since no smoothing iterations are possible.
+ *
+ * @param returns - Period returns (e.g., log returns or simple returns).
+ * @param lambda - Decay factor in (0,1).
+ * @returns EWMA standard deviation, or null on empty input.
+ * @throws when `lambda` is outside (0,1).
+ */
+export declare function calculateEWMAVolatility(returns: number[], lambda: number): number | null;
+/**
+ * Classify a volatility value into one of four regimes.
+ *
+ * Bands are checked in the order: crisis (≥crisisMin) → elevated (≥elevatedMax)
+ * → calm (≤calmMax) → normal (otherwise).
+ *
+ * @throws when bands are not strictly ordered (calmMax < elevatedMax < crisisMin).
+ */
+export declare function detectVolatilityRegime(volatility: number, bands: RegimeBands): VolatilityRegime;
+/**
+ * Annualise a volatility computed at the given cadence by multiplying by
+ * the square root of the periods per year.
+ *
+ * - daily   → sqrt(252)              (252 trading days per year)
+ * - hourly  → sqrt(252 × 6.5)        (6.5 RTH hours per trading day)
+ * - minute  → sqrt(252 × 6.5 × 60)   (60 minutes per RTH hour)
+ *
+ * @param volatility - Per-period volatility (stddev).
+ * @param cadence - The cadence at which `volatility` was sampled.
+ * @returns The annualised volatility.
+ */
+export declare function annualiseVolatility(volatility: number, cadence: "daily" | "hourly" | "minute"): number;
+//# sourceMappingURL=volatility.d.ts.map

package/dist/types/volatility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volatility.d.ts","sourceRoot":"","sources":["../../src/volatility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAUf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAUf;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,GACjB,gBAAgB,CAUlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GACrC,MAAM,CAMR"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptic/utils",
-  "version": "0.0.989",
+  "version": "0.0.991",
   "author": "Adaptic.ai",
   "description": "Utility functions used in Adaptic app and Lambda functions",
   "always-build-npm": true,