@salimassili/ai-costguard 1.1.3

package/dist/aerl/ExecutionMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionMemory.js","sourceRoot":"","sources":["../../src/aerl/ExecutionMemory.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,mCAAoC;AA+CpC,MAAa,eAAe;IAU1B,YAAY,MAIX;QACC,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,EAAE,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC,gBAAgB,GAAG,IAAI,GAAG,EAAE,CAAC;QAElC,IAAI,CAAC,mBAAmB,GAAG,MAAM,EAAE,mBAAmB,IAAI,GAAG,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,MAAM,EAAE,WAAW,IAAI,IAAI,CAAC;QAC/C,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,EAAE,UAAU,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAEpD,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAqB;QAC/B,IAAI,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,aAAa,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAClD,CAAC;QAED,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE1B,2BAA2B;QAC3B,IAAI,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACpD,aAAa,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,UAAkB,EAAE,UAAoB;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEpD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC3B,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE;gBACjC,MAAM,EAAE,QAAQ,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBAC3C,SAAS;gBACT,YAAY,EAAE,UAAU;gBACxB,eAAe,EAAE,CAAC;gBAClB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC,CAAC;QACL,CAAC;QAED,oCAAoC;QACpC,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAChD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,SAAiB,EAAE,UAAoB,EAAE,OAAe,EAAE,WAAmB;QACjG,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEtD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC3B,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,kBAAkB;YAClB,MAAM,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC;YACnC,QAAQ,CAAC,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9D,QAAQ,CAAC,aAAa,GAAG,CAAC,QAAQ,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE;gBACnC,UAAU,EAAE,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBAC9C,SAAS;gBACT,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC;gBAC3B,OAAO;gBACP,aAAa,EAAE,WAAW;gBAC1B,eAAe,EAAE,CAAC;gBAClB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAiB,EAAE,SAAiB;QAKnD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YACpD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACpC,kDAAkD;gBAClD,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBACpE,OAAO,EAAE,CAAC;oBACV,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,kCAAkC;QAC9E,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtD,OAAO;YACL,SAAS;YACT,eAAe,EAAE,OAAO;YACxB,oBAAoB,EAAE,OAAO;SAC9B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,UAAoB;QAInC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEnD,OAAO;YACL,WAAW,EAAE,CAAC,CAAC,OAAO;YACtB,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,CAAC;SAC/C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,UAAoB;QAMzC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEtD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,iBAAiB,EAAE,KAAK;gBACxB,OAAO,EAAE,CAAC;gBACV,aAAa,EAAE,CAAC;gBAChB,UAAU,EAAE,CAAC;aACd,CAAC;QACJ,CAAC;QAED,uCAAuC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;QAEjE,OAAO;YACL,iBAAiB,EAAE,IAAI;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,UAAU;SACX,CAAC;IACJ,CAAC;IAEO,mBAAmB,CAAC,KAAqB;QAC/C,iDAAiD;QACjD,MAAM,SAAS,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC;aACnC,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;aAChE,MAAM,CAAC,KAAK,CAAC;aACb,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAErD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC3B,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,kBAAkB;YAClB,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAC7D,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;YACpF,MAAM,UAAU,GAAG,aAAa;iBAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;iBAC1C,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAEvC,MAAM,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC;YACnC,QAAQ,CAAC,qBAAqB,GAAG,CAAC,QAAQ,CAAC,qBAAqB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAC9F,QAAQ,CAAC,oBAAoB,GAAG,CAAC,QAAQ,CAAC,oBAAoB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7F,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAC7D,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;YACpF,MAAM,UAAU,GAAG,aAAa;iBAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;iBAC1C,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAEvC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE;gBAClC,SAAS,EAAE,QAAQ,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBAC9C,SAAS;gBACT,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,SAAS;gBAC3C,eAAe,EAAE,CAAC;gBAClB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;gBACpB,oBAAoB,EAAE,UAAU;gBAChC,qBAAqB,EAAE,WAAW;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,UAAoB;QACnC,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC;aACxB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aAC5B,MAAM,CAAC,KAAK,CAAC;aACb,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtB,CAAC;IAEO,YAAY,CAAC,UAAoB;QACvC,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC;aACxB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aAC5B,MAAM,CAAC,KAAK,CAAC;aACb,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtB,CAAC;IAEO,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,sBAAsB;QACtB,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YAClE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAChC,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;IAEO,gBAAgB,CAAC,QAA2C,EAAE,GAAW;QAC/E,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;YACtC,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;gBACxC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAEO,WAAW,CAAoC,GAAc;QACnE,IAAI,MAAM,GAAoC,IAAI,CAAC;QAEnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,MAAM,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;YACzC,CAAC;QACH,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QAON,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC;QAC/B,CAAC;QAED,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YAChC,WAAW;YACX,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI;YAC1C,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI;YACxC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI;SAC7C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAiB;QAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;CACF;AAtUD,0CAsUC;AAEY,QAAA,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/aerl/FailurePrediction.d.ts

@@ -0,0 +1,71 @@
+/**
+ * AERL - Failure Prediction System
+ *
+ * Predicts next-step failure BEFORE execution using:
+ * - Historical execution patterns
+ * - Current graph state
+ * - Reliability scores
+ *
+ * OUTPUTS:
+ * - Failure risk score (0-1)
+ * - Recommended action adjustment:
+ *   - allow
+ *   - block
+ *   - retry strategy
+ *   - tool substitution
+ *   - step skip
+ *
+ * REQUIREMENTS:
+ * - Predicts BEFORE execution
+ * - Uses pattern matching, not ML
+ * - <1ms prediction time
+ * - Explainable recommendations
+ */
+import { GraphAnalysis } from './ExecutionGraph';
+import { ReliabilityAssessment } from './ReliabilityEngine';
+export type FailureAction = 'allow' | 'block' | 'retry_immediate' | 'retry_backoff' | 'substitute_tool' | 'skip_step';
+export interface FailurePrediction {
+    riskScore: number;
+    confidence: number;
+    recommendedAction: FailureAction;
+    alternativeTool?: string;
+    reason: string;
+    warningSignals: string[];
+}
+export interface FailurePattern {
+    name: string;
+    condition: (graph: GraphAnalysis, reliability: ReliabilityAssessment) => boolean;
+    action: FailureAction;
+    alternativeTool?: string;
+    reason: string;
+}
+export declare class FailurePredictionSystem {
+    private patterns;
+    private failureHistory;
+    constructor();
+    private initializePatterns;
+    /**
+     * Predict failure for next execution step
+     */
+    predict(workflowId: string, graph: GraphAnalysis, reliability: ReliabilityAssessment, nextOperation: string): FailurePrediction;
+    private calculatePatternRisk;
+    /**
+     * Get suggested retry strategy based on failure history
+     */
+    getRetryStrategy(workflowId: string, operation: string): {
+        strategy: 'immediate' | 'linear_backoff' | 'exponential_backoff' | 'circuit_break';
+        maxRetries: number;
+        baseDelayMs: number;
+    };
+    private recordPrediction;
+    /**
+     * Record actual failure for pattern learning
+     */
+    recordFailure(workflowId: string, failureType: string): void;
+    /**
+     * Clear history for workflow
+     */
+    clearWorkflow(workflowId: string): void;
+}
+export declare const failurePredictor: FailurePredictionSystem;
+//# sourceMappingURL=FailurePrediction.d.ts.map

package/dist/aerl/FailurePrediction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FailurePrediction.d.ts","sourceRoot":"","sources":["../../src/aerl/FailurePrediction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAkB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,OAAO,GACP,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,WAAW,CAAC;AAEhB,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,aAAa,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,qBAAqB,KAAK,OAAO,CAAC;IACjF,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,cAAc,CAA4D;;IAOlF,OAAO,CAAC,kBAAkB;IA+D1B;;OAEG;IACH,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,qBAAqB,EAClC,aAAa,EAAE,MAAM,GACpB,iBAAiB;IAmCpB,OAAO,CAAC,oBAAoB;IA2B5B;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG;QACvD,QAAQ,EAAE,WAAW,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,eAAe,CAAC;QACnF,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB;IA8BD,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAI5D;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGxC;AAED,eAAO,MAAM,gBAAgB,yBAAgC,CAAC"}

package/dist/aerl/FailurePrediction.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * AERL - Failure Prediction System
+ *
+ * Predicts next-step failure BEFORE execution using:
+ * - Historical execution patterns
+ * - Current graph state
+ * - Reliability scores
+ *
+ * OUTPUTS:
+ * - Failure risk score (0-1)
+ * - Recommended action adjustment:
+ *   - allow
+ *   - block
+ *   - retry strategy
+ *   - tool substitution
+ *   - step skip
+ *
+ * REQUIREMENTS:
+ * - Predicts BEFORE execution
+ * - Uses pattern matching, not ML
+ * - <1ms prediction time
+ * - Explainable recommendations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.failurePredictor = exports.FailurePredictionSystem = void 0;
+class FailurePredictionSystem {
+    constructor() {
+        this.failureHistory = new Map();
+        this.patterns = this.initializePatterns();
+    }
+    initializePatterns() {
+        return [
+            // Pattern 1: Retry storm
+            {
+                name: 'retry_storm',
+                condition: (graph) => graph.retryStorm,
+                action: 'block',
+                reason: 'Retry storm detected - multiple rapid retries indicate systemic issue',
+            },
+            // Pattern 2: Loop detected
+            {
+                name: 'infinite_loop',
+                condition: (graph) => graph.hasLoop,
+                action: 'block',
+                reason: 'Execution loop detected - workflow cycling without progress',
+            },
+            // Pattern 3: Stuck state
+            {
+                name: 'stuck_state',
+                condition: (graph) => graph.stuckSteps > 5,
+                action: 'retry_backoff',
+                reason: 'Stuck state - many steps without success, attempting backoff retry',
+            },
+            // Pattern 4: Redundant branches
+            {
+                name: 'redundant_execution',
+                condition: (graph) => graph.redundantBranches.length > 0,
+                action: 'skip_step',
+                reason: 'Redundant execution detected - similar work already performed',
+            },
+            // Pattern 5: High reliability failure probability
+            {
+                name: 'high_failure_risk',
+                condition: (_, reliability) => reliability.factors.failureProbability > 0.7,
+                action: 'retry_backoff',
+                reason: 'High failure probability detected, suggesting retry with backoff',
+            },
+            // Pattern 6: Cost explosion imminent
+            {
+                name: 'cost_explosion',
+                condition: (_, reliability) => reliability.factors.costExplosionProbability > 0.8,
+                action: 'substitute_tool',
+                alternativeTool: 'cheaper_model',
+                reason: 'Cost explosion risk - switching to cheaper alternative',
+            },
+            // Pattern 7: Goal drift
+            {
+                name: 'goal_drift',
+                condition: (_, reliability) => reliability.factors.goalDriftProbability > 0.6,
+                action: 'block',
+                reason: 'Goal drift detected - agent diverging from objective',
+            },
+            // Pattern 8: Deep graph (complexity risk)
+            {
+                name: 'complexity_risk',
+                condition: (graph) => graph.depth > 50,
+                action: 'substitute_tool',
+                alternativeTool: 'simplified_model',
+                reason: 'Workflow complexity high, suggesting simplified approach',
+            },
+        ];
+    }
+    /**
+     * Predict failure for next execution step
+     */
+    predict(workflowId, graph, reliability, nextOperation) {
+        const warningSignals = [];
+        let highestRiskScore = 0;
+        let bestMatch = null;
+        // Check all patterns
+        for (const pattern of this.patterns) {
+            if (pattern.condition(graph, reliability)) {
+                const riskScore = this.calculatePatternRisk(pattern, graph, reliability);
+                warningSignals.push(`${pattern.name}: ${pattern.reason}`);
+                if (riskScore > highestRiskScore) {
+                    highestRiskScore = riskScore;
+                    bestMatch = pattern;
+                }
+            }
+        }
+        // Base risk from reliability
+        const baseRisk = 1 - reliability.score;
+        const finalRisk = Math.max(baseRisk, highestRiskScore);
+        // Record for learning
+        this.recordPrediction(workflowId, bestMatch?.name || 'none', finalRisk);
+        return {
+            riskScore: finalRisk,
+            confidence: reliability.confidence,
+            recommendedAction: bestMatch?.action || 'allow',
+            alternativeTool: bestMatch?.alternativeTool,
+            reason: bestMatch?.reason || 'No failure patterns detected',
+            warningSignals,
+        };
+    }
+    calculatePatternRisk(pattern, graph, reliability) {
+        switch (pattern.name) {
+            case 'retry_storm':
+                return 0.9;
+            case 'infinite_loop':
+                return 0.95;
+            case 'stuck_state':
+                return 0.6 + (graph.stuckSteps * 0.05);
+            case 'redundant_execution':
+                return 0.5;
+            case 'high_failure_risk':
+                return reliability.factors.failureProbability;
+            case 'cost_explosion':
+                return reliability.factors.costExplosionProbability;
+            case 'goal_drift':
+                return reliability.factors.goalDriftProbability;
+            case 'complexity_risk':
+                return Math.min(0.8, graph.depth / 100);
+            default:
+                return 0.5;
+        }
+    }
+    /**
+     * Get suggested retry strategy based on failure history
+     */
+    getRetryStrategy(workflowId, operation) {
+        const history = this.failureHistory.get(workflowId) || [];
+        const recentFailures = history.slice(-5);
+        // If many recent failures, use circuit breaker
+        if (recentFailures.length >= 3) {
+            return {
+                strategy: 'circuit_break',
+                maxRetries: 0,
+                baseDelayMs: 0,
+            };
+        }
+        // If intermittent failures, use exponential backoff
+        if (recentFailures.length >= 2) {
+            return {
+                strategy: 'exponential_backoff',
+                maxRetries: 3,
+                baseDelayMs: 1000,
+            };
+        }
+        // Default: linear backoff
+        return {
+            strategy: 'linear_backoff',
+            maxRetries: 2,
+            baseDelayMs: 500,
+        };
+    }
+    recordPrediction(workflowId, patternName, riskScore) {
+        const existing = this.failureHistory.get(workflowId) || [];
+        existing.push({
+            failureType: patternName,
+            timestamp: Date.now(),
+        });
+        // Keep last 20
+        if (existing.length > 20) {
+            existing.shift();
+        }
+        this.failureHistory.set(workflowId, existing);
+    }
+    /**
+     * Record actual failure for pattern learning
+     */
+    recordFailure(workflowId, failureType) {
+        this.recordPrediction(workflowId, failureType, 1.0);
+    }
+    /**
+     * Clear history for workflow
+     */
+    clearWorkflow(workflowId) {
+        this.failureHistory.delete(workflowId);
+    }
+}
+exports.FailurePredictionSystem = FailurePredictionSystem;
+exports.failurePredictor = new FailurePredictionSystem();
+//# sourceMappingURL=FailurePrediction.js.map

package/dist/aerl/FailurePrediction.js.map

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

package/dist/aerl/RecoveryEngine.d.ts

@@ -0,0 +1,74 @@
+/**
+ * AERL - Recovery Engine
+ *
+ * When risk is high, suggests alternative execution paths:
+ * - Alternative tool selection
+ * - Retry strategy optimization
+ * - Fallback tool selection
+ * - Minimal intervention correction
+ *
+ * PURPOSE: Ensure agent success even when primary path fails
+ *
+ * REQUIREMENTS:
+ * - Suggest in <1ms
+ * - Multiple recovery levels
+ * - Degrades gracefully
+ * - No external I/O in hot path
+ */
+import { FailureAction } from './FailurePrediction';
+export interface RecoveryPlan {
+    primaryAction: FailureAction;
+    alternatives: RecoveryAlternative[];
+    fallbackAction: FailureAction;
+    estimatedSuccessRate: number;
+    estimatedCost: number;
+    timeToRecoverMs: number;
+}
+export interface RecoveryAlternative {
+    action: FailureAction;
+    tool?: string;
+    parameters?: Record<string, unknown>;
+    estimatedSuccessRate: number;
+    estimatedCost: number;
+    reason: string;
+}
+export interface ToolRegistry {
+    name: string;
+    cost: number;
+    reliability: number;
+    speed: number;
+    capabilities: string[];
+}
+export declare class RecoveryEngine {
+    private toolRegistry;
+    constructor();
+    private initializeDefaultTools;
+    /**
+     * Generate recovery plan for high-risk execution
+     */
+    generateRecovery(primaryTool: string, recommendedAction: FailureAction, alternativeTool?: string): RecoveryPlan;
+    /**
+     * Find cheaper alternative tool
+     */
+    private findCheaperAlternative;
+    /**
+     * Find local/cached fallback
+     */
+    private findLocalFallback;
+    private getToolCost;
+    private getToolReliability;
+    /**
+     * Register custom tool
+     */
+    registerTool(tool: ToolRegistry): void;
+    /**
+     * Get optimal retry delay based on failure count
+     */
+    getRetryDelay(failureCount: number): number;
+    /**
+     * Check if circuit breaker should trip
+     */
+    shouldTripCircuitBreaker(failureCount: number, timeWindowMs: number): boolean;
+}
+export declare const recoveryEngine: RecoveryEngine;
+//# sourceMappingURL=RecoveryEngine.d.ts.map

package/dist/aerl/RecoveryEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryEngine.d.ts","sourceRoot":"","sources":["../../src/aerl/RecoveryEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,cAAc,EAAE,aAAa,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA4B;;IAOhD,OAAO,CAAC,sBAAsB;IAmC9B;;OAEG;IACH,gBAAgB,CACd,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,aAAa,EAChC,eAAe,CAAC,EAAE,MAAM,GACvB,YAAY;IAsEf;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAK3C;;OAEG;IACH,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;CAI9E;AAED,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/aerl/RecoveryEngine.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * AERL - Recovery Engine
+ *
+ * When risk is high, suggests alternative execution paths:
+ * - Alternative tool selection
+ * - Retry strategy optimization
+ * - Fallback tool selection
+ * - Minimal intervention correction
+ *
+ * PURPOSE: Ensure agent success even when primary path fails
+ *
+ * REQUIREMENTS:
+ * - Suggest in <1ms
+ * - Multiple recovery levels
+ * - Degrades gracefully
+ * - No external I/O in hot path
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recoveryEngine = exports.RecoveryEngine = void 0;
+class RecoveryEngine {
+    constructor() {
+        this.toolRegistry = new Map();
+        this.initializeDefaultTools();
+    }
+    initializeDefaultTools() {
+        // Default tool registry - can be extended
+        this.toolRegistry.set('gpt-4', {
+            name: 'gpt-4',
+            cost: 1.0,
+            reliability: 0.95,
+            speed: 0.8,
+            capabilities: ['reasoning', 'coding', 'analysis'],
+        });
+        this.toolRegistry.set('gpt-3.5', {
+            name: 'gpt-3.5',
+            cost: 0.1,
+            reliability: 0.85,
+            speed: 1.0,
+            capabilities: ['reasoning', 'simple_coding'],
+        });
+        this.toolRegistry.set('claude-3', {
+            name: 'claude-3',
+            cost: 0.9,
+            reliability: 0.93,
+            speed: 0.85,
+            capabilities: ['reasoning', 'analysis', 'long_context'],
+        });
+        this.toolRegistry.set('local-llm', {
+            name: 'local-llm',
+            cost: 0.01,
+            reliability: 0.7,
+            speed: 0.6,
+            capabilities: ['simple_reasoning'],
+        });
+    }
+    /**
+     * Generate recovery plan for high-risk execution
+     */
+    generateRecovery(primaryTool, recommendedAction, alternativeTool) {
+        const alternatives = [];
+        // Level 1: Retry with same tool (if failure is transient)
+        if (recommendedAction === 'retry_immediate' || recommendedAction === 'retry_backoff') {
+            alternatives.push({
+                action: recommendedAction,
+                tool: primaryTool,
+                parameters: { retry_count: 1, backoff_ms: 500 },
+                estimatedSuccessRate: 0.7,
+                estimatedCost: this.getToolCost(primaryTool),
+                reason: 'Retry with same tool, transient failure likely',
+            });
+        }
+        // Level 2: Substitute tool
+        if (recommendedAction === 'substitute_tool' || alternativeTool) {
+            const substitute = alternativeTool || this.findCheaperAlternative(primaryTool);
+            if (substitute && substitute !== primaryTool) {
+                alternatives.push({
+                    action: 'substitute_tool',
+                    tool: substitute,
+                    estimatedSuccessRate: this.getToolReliability(substitute) * 0.9,
+                    estimatedCost: this.getToolCost(substitute),
+                    reason: `Substitute ${primaryTool} with cheaper ${substitute}`,
+                });
+            }
+        }
+        // Level 3: Simplify request (use allow with modified parameters)
+        alternatives.push({
+            action: 'allow',
+            tool: primaryTool,
+            parameters: {
+                max_tokens: 1000, // Reduce token count
+                temperature: 0.2, // More deterministic
+            },
+            estimatedSuccessRate: 0.75,
+            estimatedCost: this.getToolCost(primaryTool) * 0.5,
+            reason: 'Simplify request - fewer tokens, more deterministic',
+        });
+        // Level 4: Use local/cached fallback
+        const localTool = this.findLocalFallback(primaryTool);
+        if (localTool) {
+            alternatives.push({
+                action: 'substitute_tool',
+                tool: localTool,
+                estimatedSuccessRate: 0.6,
+                estimatedCost: this.getToolCost(localTool),
+                reason: 'Use local/cached fallback for cost reduction',
+            });
+        }
+        // Calculate aggregate stats
+        const totalCost = alternatives.reduce((sum, alt) => sum + alt.estimatedCost, 0);
+        const avgSuccess = alternatives.length > 0
+            ? alternatives.reduce((sum, alt) => sum + alt.estimatedSuccessRate, 0) / alternatives.length
+            : 0.5;
+        return {
+            primaryAction: recommendedAction,
+            alternatives,
+            fallbackAction: alternatives.length > 0 ? alternatives[alternatives.length - 1].action : 'block',
+            estimatedSuccessRate: Math.max(0.5, avgSuccess),
+            estimatedCost: totalCost,
+            timeToRecoverMs: alternatives.length * 100, // Rough estimate
+        };
+    }
+    /**
+     * Find cheaper alternative tool
+     */
+    findCheaperAlternative(toolName) {
+        const primary = this.toolRegistry.get(toolName);
+        if (!primary)
+            return undefined;
+        let bestAlternative;
+        let bestScore = -1;
+        for (const [name, tool] of this.toolRegistry) {
+            if (name === toolName)
+                continue;
+            // Score based on cost savings + reliability
+            const costSavings = (primary.cost - tool.cost) / primary.cost;
+            const reliabilityRatio = tool.reliability / primary.reliability;
+            const score = costSavings * 0.6 + reliabilityRatio * 0.4;
+            if (score > bestScore && tool.cost < primary.cost) {
+                bestScore = score;
+                bestAlternative = name;
+            }
+        }
+        return bestAlternative;
+    }
+    /**
+     * Find local/cached fallback
+     */
+    findLocalFallback(toolName) {
+        // Prefer local-llm if available
+        if (this.toolRegistry.has('local-llm')) {
+            return 'local-llm';
+        }
+        // Otherwise find cheapest
+        let cheapest;
+        let minCost = Infinity;
+        for (const [name, tool] of this.toolRegistry) {
+            if (tool.cost < minCost) {
+                minCost = tool.cost;
+                cheapest = name;
+            }
+        }
+        return cheapest;
+    }
+    getToolCost(toolName) {
+        return this.toolRegistry.get(toolName)?.cost || 1.0;
+    }
+    getToolReliability(toolName) {
+        return this.toolRegistry.get(toolName)?.reliability || 0.8;
+    }
+    /**
+     * Register custom tool
+     */
+    registerTool(tool) {
+        this.toolRegistry.set(tool.name, tool);
+    }
+    /**
+     * Get optimal retry delay based on failure count
+     */
+    getRetryDelay(failureCount) {
+        // Exponential backoff: 500ms, 1000ms, 2000ms, max 5000ms
+        return Math.min(500 * Math.pow(2, failureCount), 5000);
+    }
+    /**
+     * Check if circuit breaker should trip
+     */
+    shouldTripCircuitBreaker(failureCount, timeWindowMs) {
+        // Trip if >5 failures in last minute
+        return failureCount > 5 && timeWindowMs < 60000;
+    }
+}
+exports.RecoveryEngine = RecoveryEngine;
+exports.recoveryEngine = new RecoveryEngine();
+//# sourceMappingURL=RecoveryEngine.js.map

package/dist/aerl/RecoveryEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryEngine.js","sourceRoot":"","sources":["../../src/aerl/RecoveryEngine.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AA8BH,MAAa,cAAc;IAGzB;QACE,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAChC,CAAC;IAEO,sBAAsB;QAC5B,0CAA0C;QAC1C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE;YAC7B,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,GAAG;YACV,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC;SAClD,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE;YAC/B,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,GAAG;YACV,YAAY,EAAE,CAAC,WAAW,EAAE,eAAe,CAAC;SAC7C,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE;YAChC,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,IAAI;YACX,YAAY,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,cAAc,CAAC;SACxD,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE;YACjC,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,IAAI;YACV,WAAW,EAAE,GAAG;YAChB,KAAK,EAAE,GAAG;YACV,YAAY,EAAE,CAAC,kBAAkB,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,WAAmB,EACnB,iBAAgC,EAChC,eAAwB;QAExB,MAAM,YAAY,GAA0B,EAAE,CAAC;QAE/C,0DAA0D;QAC1D,IAAI,iBAAiB,KAAK,iBAAiB,IAAI,iBAAiB,KAAK,eAAe,EAAE,CAAC;YACrF,YAAY,CAAC,IAAI,CAAC;gBAChB,MAAM,EAAE,iBAAiB;gBACzB,IAAI,EAAE,WAAW;gBACjB,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE;gBAC/C,oBAAoB,EAAE,GAAG;gBACzB,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC;gBAC5C,MAAM,EAAE,gDAAgD;aACzD,CAAC,CAAC;QACL,CAAC;QAED,2BAA2B;QAC3B,IAAI,iBAAiB,KAAK,iBAAiB,IAAI,eAAe,EAAE,CAAC;YAC/D,MAAM,UAAU,GAAG,eAAe,IAAI,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;YAC/E,IAAI,UAAU,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;gBAC7C,YAAY,CAAC,IAAI,CAAC;oBAChB,MAAM,EAAE,iBAAiB;oBACzB,IAAI,EAAE,UAAU;oBAChB,oBAAoB,EAAE,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,GAAG,GAAG;oBAC/D,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;oBAC3C,MAAM,EAAE,cAAc,WAAW,iBAAiB,UAAU,EAAE;iBAC/D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,iEAAiE;QACjE,YAAY,CAAC,IAAI,CAAC;YAChB,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE;gBACV,UAAU,EAAE,IAAI,EAAG,qBAAqB;gBACxC,WAAW,EAAE,GAAG,EAAG,qBAAqB;aACzC;YACD,oBAAoB,EAAE,IAAI;YAC1B,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,GAAG;YAClD,MAAM,EAAE,qDAAqD;SAC9D,CAAC,CAAC;QAEH,qCAAqC;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,IAAI,CAAC;gBAChB,MAAM,EAAE,iBAAiB;gBACzB,IAAI,EAAE,SAAS;gBACf,oBAAoB,EAAE,GAAG;gBACzB,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;gBAC1C,MAAM,EAAE,8CAA8C;aACvD,CAAC,CAAC;QACL,CAAC;QAED,4BAA4B;QAC5B,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAChF,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC;YACxC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,oBAAoB,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM;YAC5F,CAAC,CAAC,GAAG,CAAC;QAER,OAAO;YACL,aAAa,EAAE,iBAAiB;YAChC,YAAY;YACZ,cAAc,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;YAChG,oBAAoB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC;YAC/C,aAAa,EAAE,SAAS;YACxB,eAAe,EAAE,YAAY,CAAC,MAAM,GAAG,GAAG,EAAE,iBAAiB;SAC9D,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,sBAAsB,CAAC,QAAgB;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,IAAI,eAAmC,CAAC;QACxC,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;QAEnB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC7C,IAAI,IAAI,KAAK,QAAQ;gBAAE,SAAS;YAEhC,4CAA4C;YAC5C,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;YAC9D,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;YAChE,MAAM,KAAK,GAAG,WAAW,GAAG,GAAG,GAAG,gBAAgB,GAAG,GAAG,CAAC;YAEzD,IAAI,KAAK,GAAG,SAAS,IAAI,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;gBAClD,SAAS,GAAG,KAAK,CAAC;gBAClB,eAAe,GAAG,IAAI,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,QAAgB;QACxC,gCAAgC;QAChC,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACvC,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,0BAA0B;QAC1B,IAAI,QAA4B,CAAC;QACjC,IAAI,OAAO,GAAG,QAAQ,CAAC;QAEvB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC7C,IAAI,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,CAAC;gBACxB,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;gBACpB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,WAAW,CAAC,QAAgB;QAClC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,IAAI,GAAG,CAAC;IACtD,CAAC;IAEO,kBAAkB,CAAC,QAAgB;QACzC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,WAAW,IAAI,GAAG,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAkB;QAC7B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,YAAoB;QAChC,yDAAyD;QACzD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,wBAAwB,CAAC,YAAoB,EAAE,YAAoB;QACjE,qCAAqC;QACrC,OAAO,YAAY,GAAG,CAAC,IAAI,YAAY,GAAG,KAAK,CAAC;IAClD,CAAC;CACF;AAxMD,wCAwMC;AAEY,QAAA,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC"}

package/dist/aerl/ReliabilityEngine.d.ts

@@ -0,0 +1,74 @@
+/**
+ * AERL - Reliability Scoring Engine
+ *
+ * Computes probability (0-1) for:
+ * - Failure probability
+ * - Cost explosion probability
+ * - Redundant execution probability
+ * - Goal drift probability
+ *
+ * REQUIREMENTS:
+ * - Deterministic (same input = same score)
+ * - Explainable (every factor documented)
+ * - <1ms execution time
+ * - No ML in hot path
+ */
+export interface ReliabilityFactors {
+    failureProbability: number;
+    costExplosionProbability: number;
+    redundancyProbability: number;
+    goalDriftProbability: number;
+    composite: number;
+}
+export interface ReliabilityContext {
+    sessionId: string;
+    workflowId: string;
+    stepNumber: number;
+    recentResults: ('success' | 'failure' | 'partial')[];
+    tokenVelocity: number;
+    costVelocity: number;
+    goal?: string;
+    previousGoals?: string[];
+    toolSwitches: number;
+}
+export interface ReliabilityAssessment {
+    score: number;
+    factors: ReliabilityFactors;
+    explanation: string[];
+    confidence: number;
+    recommendations: string[];
+}
+export declare class ReliabilityEngine {
+    private goalHistory;
+    constructor();
+    /**
+     * Calculate reliability score
+     * Returns 0-1 where 1 = highly reliable
+     */
+    assess(context: ReliabilityContext): ReliabilityAssessment;
+    private calculateFactors;
+    /**
+     * Failure probability based on recent results
+     */
+    private assessFailureProbability;
+    /**
+     * Cost explosion based on velocity
+     */
+    private assessCostExplosion;
+    /**
+     * Redundancy based on recent patterns
+     */
+    private assessRedundancy;
+    /**
+     * Goal drift detection
+     */
+    private assessGoalDrift;
+    private compositeScore;
+    private buildExplanation;
+    private calculateConfidence;
+    private buildRecommendations;
+    private updateGoalHistory;
+    clearSession(sessionId: string): void;
+}
+export declare const reliabilityEngine: ReliabilityEngine;
+//# sourceMappingURL=ReliabilityEngine.d.ts.map

package/dist/aerl/ReliabilityEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReliabilityEngine.d.ts","sourceRoot":"","sources":["../../src/aerl/ReliabilityEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wBAAwB,EAAE,MAAM,CAAC;IACjC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,CAAC,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAAwB;;IAM3C;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,qBAAqB;IAkB1D,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgBhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,oBAAoB;IA0B5B,OAAO,CAAC,iBAAiB;IASzB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAGtC;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}