aden-ts 0.1.1 → 0.2.1

package/dist/index.d.mts

@@ -140,6 +140,8 @@ interface BudgetRule {
     alerts: BudgetAlert[];
     /** Notification settings */
     notifications: BudgetNotifications;
+    /** Legacy context_id for backwards compatibility */
+    context_id?: string;
 }
 /**
  * Throttle rule - rate limiting
@@ -285,13 +287,13 @@ interface ControlAgentOptions {
     /**
      * Enable hybrid enforcement (local + server-side validation).
      * When enabled, budgets above the threshold are validated with the server.
-     * Default: false
+     * Default: true
      */
     enableHybridEnforcement?: boolean;
     /**
      * Budget usage threshold (percentage) at which to start server validation.
      * Requests below this threshold use local-only enforcement.
-     * Default: 80
+     * Default: 5
      */
     serverValidationThreshold?: number;
     /**
@@ -308,7 +310,7 @@ interface ControlAgentOptions {
     /**
      * Minimum remaining budget (USD) that triggers forced server validation.
      * Only applies when adaptiveThresholdEnabled is true.
-     * Default: 1.0
+     * Default: 5.0
      */
     adaptiveMinRemainingUsd?: number;
     /**
@@ -2354,7 +2356,26 @@ declare class ControlAgent implements IControlAgent {
      */
     private matchesBlockRule;
     /**
-     * Find budgets that apply to the given request based on budget type
+     * Get action priority for finding most restrictive decision.
+     * Higher priority = more restrictive.
+     */
+    private getActionPriority;
+    /**
+     * Evaluate a single budget using local-only enforcement.
+     * Returns a decision if the budget triggers an action, null otherwise.
+     */
+    private evaluateBudgetLocally;
+    /**
+     * Find budgets that apply to the given request based on budget type.
+     *
+     * Matching logic by budget type:
+     * - global: Matches ALL requests
+     * - agent: Matches if request.metadata.agent == budget.name or budget.id
+     * - tenant: Matches if request.metadata.tenant_id == budget.name or budget.id
+     * - customer: Matches if request.metadata.customer_id == budget.name or budget.id
+     * - feature: Matches if request.metadata.feature == budget.name or budget.id
+     * - tag: Matches if any request.metadata.tags intersect with budget.tags
+     * - legacy (context_id): Matches if request.context_id == budget.context_id
      */
     private findApplicableBudgets;
     /**

package/dist/index.d.ts

@@ -140,6 +140,8 @@ interface BudgetRule {
     alerts: BudgetAlert[];
     /** Notification settings */
     notifications: BudgetNotifications;
+    /** Legacy context_id for backwards compatibility */
+    context_id?: string;
 }
 /**
  * Throttle rule - rate limiting
@@ -285,13 +287,13 @@ interface ControlAgentOptions {
     /**
      * Enable hybrid enforcement (local + server-side validation).
      * When enabled, budgets above the threshold are validated with the server.
-     * Default: false
+     * Default: true
      */
     enableHybridEnforcement?: boolean;
     /**
      * Budget usage threshold (percentage) at which to start server validation.
      * Requests below this threshold use local-only enforcement.
-     * Default: 80
+     * Default: 5
      */
     serverValidationThreshold?: number;
     /**
@@ -308,7 +310,7 @@ interface ControlAgentOptions {
     /**
      * Minimum remaining budget (USD) that triggers forced server validation.
      * Only applies when adaptiveThresholdEnabled is true.
-     * Default: 1.0
+     * Default: 5.0
      */
     adaptiveMinRemainingUsd?: number;
     /**
@@ -2354,7 +2356,26 @@ declare class ControlAgent implements IControlAgent {
      */
     private matchesBlockRule;
     /**
-     * Find budgets that apply to the given request based on budget type
+     * Get action priority for finding most restrictive decision.
+     * Higher priority = more restrictive.
+     */
+    private getActionPriority;
+    /**
+     * Evaluate a single budget using local-only enforcement.
+     * Returns a decision if the budget triggers an action, null otherwise.
+     */
+    private evaluateBudgetLocally;
+    /**
+     * Find budgets that apply to the given request based on budget type.
+     *
+     * Matching logic by budget type:
+     * - global: Matches ALL requests
+     * - agent: Matches if request.metadata.agent == budget.name or budget.id
+     * - tenant: Matches if request.metadata.tenant_id == budget.name or budget.id
+     * - customer: Matches if request.metadata.customer_id == budget.name or budget.id
+     * - feature: Matches if request.metadata.feature == budget.name or budget.id
+     * - tag: Matches if any request.metadata.tags intersect with budget.tags
+     * - legacy (context_id): Matches if request.context_id == budget.context_id
      */
     private findApplicableBudgets;
     /**